Guia do Desenvolvedor - Tekann
Guia do Desenvolvedor - Tekann
Guia do Desenvolvedor - Tekann
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
Rua Guilherme Werlang, 30, Higienópolis<br />
CEP 96825-230 – Santa Cruz <strong>do</strong> Sul/RS – Brasil<br />
Fone: +55 51 21096530<br />
Site: www.tekann.com.br<br />
E-mail: tekann@tekann.com.br<br />
<strong>Guia</strong> <strong>do</strong> Desenvolve<strong>do</strong>r<br />
To<strong>do</strong>s os direitos reserva<strong>do</strong>s. Nenhuma parte deste trabalho pode ser reproduzida em<br />
qualquer forma por qualquer meio gráfico, eletrônico ou mecânico, incluin<strong>do</strong> fotocópia,<br />
gravação, digitação ou qualquer outra forma de armazenamento e recuperação de informações<br />
- sem a prévia autorização expressa da TEKANN Mobile Solutions.<br />
Apesar de todas as precauções tomadas na confecção desta <strong>do</strong>cumentação, a TEKANN<br />
Mobile Solutions não assume responsabilidades por erros ou omissões ou por danos que<br />
resultem pelo uso das informações aqui contidas ou ainda no uso <strong>do</strong>s programas que<br />
acompanham esta <strong>do</strong>cumentação.<br />
Publicação: Janeiro 2012 em Santa Cruz <strong>do</strong> Sul - Brasil<br />
Copyright (c) 2012 – TEKANN Mobile Solutions.
Versão <strong>do</strong> Manual<br />
Versão Data Responsável<br />
1.0 Fev/2010 Marcelo Cella<br />
1.1 Abril/2012 Marcus Rosa
Sumário<br />
1. Introdução .............................................................................................................. 8<br />
1.1. Objetivo ................................................................................................................... 8<br />
1.2. Tecnologia Multiplataforma ....................................................................................... 8<br />
1.3. Diferenças entre versões .......................................................................................... 8<br />
2. Instalação ............................................................................................................... 9<br />
2.1. Pré-requisitos ........................................................................................................... 9<br />
2.2. Recomendações ....................................................................................................... 9<br />
2.3. Instalan<strong>do</strong> o TotalCross Studio Community ................................................................ 9<br />
2.4. Crian<strong>do</strong> Variáveis de Ambiente ................................................................................ 13<br />
2.5. Configuran<strong>do</strong> Java e Ant ......................................................................................... 14<br />
3. A Interface ............................................................................................................ 16<br />
3.1. Página Inicial ......................................................................................................... 16<br />
3.2. Designer ................................................................................................................ 17<br />
3.2.1. Botões de Atalho ............................................................................................. 18<br />
3.2.2. Barra de Ferramentas ...................................................................................... 18<br />
3.2.2.1. Posição ................................................................................................... 19<br />
3.2.2.2. Âncora .................................................................................................... 19<br />
3.2.2.3. Espaçamento entre Componentes (GAP) ................................................... 20<br />
3.2.2.4. Tamanho ................................................................................................ 20<br />
3.2.3. Projetos .......................................................................................................... 21<br />
3.2.4. Arquivos ......................................................................................................... 23<br />
3.2.5. Visualização .................................................................................................... 23<br />
3.2.6. Paleta ............................................................................................................. 24<br />
3.2.7. Propriedades .................................................................................................. 25<br />
3.2.7.1. Propriedades <strong>do</strong> Projeto ........................................................................... 26<br />
3.2.7.2. Propriedades <strong>do</strong>s Containers .................................................................... 28<br />
3.2.7.3. Propriedades da Barra de Menus .............................................................. 29<br />
3.2.7.4. Propriedades <strong>do</strong> Menu ............................................................................. 32<br />
3.2.7.5. Propriedades <strong>do</strong> Item de Menu ................................................................. 32<br />
3.2.8. Saída .............................................................................................................. 33<br />
3.3. Desenvolvimento .................................................................................................... 34<br />
3.3.1. Classes ........................................................................................................... 34<br />
3.3.2. Arquivos ......................................................................................................... 35<br />
3.3.3. Elementos ...................................................................................................... 36<br />
3.3.4. Código Fonte .................................................................................................. 36<br />
4. Componentes ........................................................................................................ 37<br />
4.1. Controles Básicos ................................................................................................... 37<br />
4.1.1. Button ............................................................................................................ 37<br />
4.1.2. Check ............................................................................................................. 39<br />
4.1.3. Combo Box ..................................................................................................... 40<br />
4.1.4. Combo Box Editable ........................................................................................ 41<br />
4.1.5. Edit ................................................................................................................ 43<br />
4.1.6. Grid ............................................................................................................... 45<br />
4.1.7. Image Control................................................................................................. 48<br />
4.1.8. Label .............................................................................................................. 49<br />
4.1.9. List Box .......................................................................................................... 50<br />
4.1.10. Multi Edit ........................................................................................................ 51<br />
4.1.11. Progress Bar ................................................................................................... 53<br />
4.1.12. Push Button Group .......................................................................................... 54<br />
4.1.13. Radio ............................................................................................................. 56<br />
4.1.14. Radio Group Controller .................................................................................... 57
4.1.15. Ruler .............................................................................................................. 57<br />
4.1.16. Scroll Bar ........................................................................................................ 58<br />
4.1.17. Slider ............................................................................................................. 59<br />
4.1.18. Spacer ............................................................................................................ 60<br />
4.1.19. Spin List ......................................................................................................... 61<br />
4.1.20. Spinner .......................................................................................................... 62<br />
4.1.21. Tree ............................................................................................................... 63<br />
4.1.22. Whiteboard ..................................................................................................... 64<br />
4.2. Gráficos ................................................................................................................. 65<br />
4.2.1. Column Chart ................................................................................................. 65<br />
4.2.2. Pie Chart ........................................................................................................ 70<br />
4.2.3. Line Chart....................................................................................................... 73<br />
4.3. Outros Componentes .............................................................................................. 77<br />
4.3.1. Tab Panel ....................................................................................................... 77<br />
4.3.2. Beans ............................................................................................................. 79<br />
5. Configuran<strong>do</strong> Preferências ................................................................................... 80<br />
5.1. Editor .................................................................................................................... 80<br />
5.2. Ferramentas Externas ............................................................................................. 81<br />
6. Selecionan<strong>do</strong> o Dispositivo Móvel Padrão ............................................................ 82<br />
6.1. Adicionan<strong>do</strong> Novo Modelo de Dispositivo Móvel ........................................................ 83<br />
7. Desenvolven<strong>do</strong> Projetos ....................................................................................... 84<br />
7.1. Crian<strong>do</strong> Novo Projeto .............................................................................................. 84<br />
7.2. Crian<strong>do</strong> Novo Container .......................................................................................... 85<br />
7.2.1. Crian<strong>do</strong> Containers com Abas .......................................................................... 87<br />
7.2.1.1. Configuran<strong>do</strong> Nova Aba no TabPanel ........................................................ 88<br />
7.2.2. Tipos de Containers ........................................................................................ 89<br />
7.2.3. Crian<strong>do</strong> Templates para Containers .................................................................. 89<br />
7.2.4. Utilizan<strong>do</strong> um Template ................................................................................... 90<br />
7.2.5. Crian<strong>do</strong> um Componente Customiza<strong>do</strong> (Bean) .................................................. 90<br />
7.3. Incluin<strong>do</strong> Componentes em um Container ................................................................ 92<br />
7.3.1. Incluin<strong>do</strong> um Componente Customiza<strong>do</strong> (Bean) em um Container...................... 92<br />
7.4. Posicionan<strong>do</strong> Componentes ..................................................................................... 93<br />
7.4.1. Posicionan<strong>do</strong> em relação à área <strong>do</strong> container.................................................... 93<br />
7.4.2. Posicionan<strong>do</strong> em relação a outro componente .................................................. 94<br />
7.4.3. Ajustes Finos no Posicionamento ..................................................................... 96<br />
7.5. Dimensionan<strong>do</strong> Componentes ................................................................................. 96<br />
7.5.1. Ajustes Finos no Dimensionamento .................................................................. 97<br />
7.6. Excluin<strong>do</strong> Container ................................................................................................ 97<br />
7.7. Crian<strong>do</strong> Menus ....................................................................................................... 98<br />
7.7.1. Incluin<strong>do</strong> Barra de Menu ................................................................................. 98<br />
7.7.2. Editan<strong>do</strong> Barra de Menu .................................................................................. 99<br />
7.7.3. Excluin<strong>do</strong> Barra de Menu ................................................................................. 99<br />
7.7.4. Incluin<strong>do</strong> Menu ............................................................................................. 100<br />
7.7.5. Editan<strong>do</strong> Menu .............................................................................................. 100<br />
7.7.6. Excluin<strong>do</strong> Menu ............................................................................................ 101<br />
7.7.7. Incluin<strong>do</strong> Item de Menu ................................................................................ 101<br />
7.7.8. Editan<strong>do</strong> Item de Menu ................................................................................. 102<br />
7.7.9. Excluin<strong>do</strong> Item de Menu ................................................................................ 103<br />
7.7.10. Ações de MenuItem ...................................................................................... 103<br />
7.8. Utilizan<strong>do</strong> Bibliotecas ............................................................................................ 104<br />
7.8.1. Incluin<strong>do</strong> Bibliotecas ..................................................................................... 104<br />
Excluin<strong>do</strong> Bibliotecas ................................................................................................... 104
7.9. Excluin<strong>do</strong> Projeto ................................................................................................. 105<br />
8. Preferências Gerais de Interface para os Projetos ............................................. 106<br />
8.1. Crian<strong>do</strong> Preferências Gerais de Interface ............................................................... 106<br />
8.2. Definin<strong>do</strong> a Preferência Padrão para Novos Projetos ............................................... 109<br />
8.2.1. Configuran<strong>do</strong> a Preferência para um Projeto Existente .................................... 109<br />
8.2.2. Aplican<strong>do</strong> as Preferências de Interface em Projetos Existentes ......................... 110<br />
8.2.3. Compartilhan<strong>do</strong> as Preferências Gerais de Interface ........................................ 111<br />
9. Perfil de Atributos Visuais .................................................................................. 112<br />
9.1. Crian<strong>do</strong> um Perfil de Atributos Visuais ................................................................... 112<br />
9.2. Utilizan<strong>do</strong> um Perfil de Atributos Visuais ................................................................ 114<br />
10. Configuran<strong>do</strong> Tooltip para um Componente ...................................................... 114<br />
11. Lista de Ações ..................................................................................................... 116<br />
11.1. Personalizan<strong>do</strong> um Message Box ....................................................................... 117<br />
11.2. Desabilitan<strong>do</strong> um Message Box .......................................................................... 119<br />
12. Tamanho da Tela de Desenvolvimento ............................................................... 120<br />
13. Internacionalizan<strong>do</strong> um Projeto ......................................................................... 121<br />
14. Estrutura Gerada ................................................................................................ 122<br />
14.1. Estrutura <strong>do</strong> Projeto.......................................................................................... 123<br />
14.2. Compilan<strong>do</strong> e executan<strong>do</strong> o projeto ................................................................... 124<br />
14.3. Código gera<strong>do</strong> .................................................................................................. 125<br />
15. Editan<strong>do</strong> o Código Gera<strong>do</strong> .................................................................................. 125<br />
16. Implantan<strong>do</strong> o Projeto ....................................................................................... 127<br />
17. Reportan<strong>do</strong> Bugs ................................................................................................ 128<br />
18. Lista de Palavras Reservadas ............................................................................. 129
1. Introdução<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Com a crescente demanda <strong>do</strong> uso de dispositivos móveis na área corporativa a TEKANN Mobile Solutions disponibiliza<br />
ao merca<strong>do</strong> uma ferramenta robusta, ágil e dinâmica para auxiliar a geração de aplicativos volta<strong>do</strong>s à<br />
mobilidade, como PDA’s, smartphones e tablets.<br />
1.1. Objetivo<br />
O TotalCross Studio Community Edition é uma ferramenta de desenvolvimento (IDE) que tem como objetivo<br />
facilitar o desenvolvimento de aplicativos para dispositivos móveis através de uma interface visual amigável.<br />
1.2. Tecnologia Multiplataforma<br />
Um <strong>do</strong>s principais diferenciais <strong>do</strong> TotalCross Studio Community Edition está em sua capacidade de gerar automaticamente<br />
aplicativos para praticamente todas as plataformas móveis existentes no merca<strong>do</strong>. Além disso, a<br />
ferramenta está disponível para os sistemas operacionais Win<strong>do</strong>ws e Linux.<br />
O TotalCross Studio Community Edition utiliza o framework TotalCross, que serve como máquina virtual para<br />
diversas plataformas móveis como Android, iPhone, BlackBerry, Palm OS, Win<strong>do</strong>ws CE e Win<strong>do</strong>ws. O TotalCross<br />
Studio Community Edition também possui a capacidade de se integrar com o editor <strong>do</strong> Eclipse através de plug-in.<br />
To<strong>do</strong>s os recursos disponíveis na ferramenta garantem aos usuários um deploy eficiente de aplicações para uma<br />
integração estável e segura.<br />
O TotalCross Studio Community Edition:<br />
� Pode ser instala<strong>do</strong> nos sistemas operacionais Win<strong>do</strong>ws e Linux.<br />
� O aplicativo gera<strong>do</strong> pode ser instala<strong>do</strong> em dispositivos com plataforma Android, Win<strong>do</strong>ws Mobile, PalmOS,<br />
IPhone e BlackBerry.<br />
1.3. Diferenças entre versões<br />
O TotalCross Studio Community Edition, apesar de possuir diversos recursos que facilitam o desenvolvimento e o<br />
deploy de aplicações para diversas plataformas móveis, não possui alguns recursos que a versão Professional da<br />
aplicação. Veja a tabela:<br />
Característica<br />
Editor Visual contemplan<strong>do</strong> componentes e propriedades da maioria<br />
<strong>do</strong>s recursos visuais <strong>do</strong> TotalCross<br />
Editor de Tabelas para o Litebase<br />
Editor de Código/Classe<br />
Estrutura para alterações visuais com padrões defini<strong>do</strong>s (Visual<br />
Atribute e Preferências de Interface por componente)<br />
Visão por perspectiva para desenvolvimento<br />
Visão de Perspectiva para Banco de Da<strong>do</strong>s<br />
Suporte a projetos internacionaliza<strong>do</strong>s<br />
Integração com a maioria <strong>do</strong>s bancos de da<strong>do</strong>s de merca<strong>do</strong> como:<br />
Versão Professional<br />
Versão<br />
Community<br />
Pagina 8 de 129
Pagina 9 de 129<br />
Oracle, Sql-Server, MySql, PostGreSql e Firebird<br />
Assistente de carga de da<strong>do</strong>s pela ferramenta (Data Base para PDA<br />
e PDA para Data Base)<br />
Geração <strong>do</strong> Código com estrutura pronta para customizações<br />
Geração automática da camada de persistência para projetos<br />
vincula<strong>do</strong>s a Bancos de Da<strong>do</strong>s e Tabelas - Local ou Remota (web<br />
services <strong>do</strong> cliente e <strong>do</strong> servi<strong>do</strong>r)<br />
Criação de componentes reutilizáveis<br />
Assistente de geração de arquivos de instalação Deploy<br />
Plug-in para importação das classes customizadas para o Eclipse<br />
2. Instalação<br />
2.1. Pré-requisitos<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Para utilizar o TotalCross Studio Community Edition é necessário que alguns softwares estejam previamente<br />
instala<strong>do</strong>s. São eles:<br />
Java SDK (JDK) 1.6 ou superior<br />
http://java.sun.com/products/archive/j2se/6u6/index.html.<br />
Apache Ant 1.7.1 ou superior<br />
http://ant.apache.org/bin<strong>do</strong>wnload.cgi<br />
Para maiores informações, consulte o tópico Configuran<strong>do</strong> Java e Ant.<br />
2.2. Recomendações<br />
Antes de instalar o TotalCross Studio Community Edition não se esqueça de ver os Pré-requisitos da ferramenta. Se<br />
necessário publique suas dúvidas no Fórum (http://forum.totalcross.net/) e assim que possível responderemos as<br />
suas questões.<br />
Para instalação <strong>do</strong> TotalCross Studio Community Edition no Win<strong>do</strong>ws Vista, é importante observar as recomendações<br />
a seguir.<br />
� Desabilite o Controle de Usuários para as instalações neste sistema operacional. Outra sugestão é criar<br />
uma pasta na raiz <strong>do</strong> disco rígi<strong>do</strong>, pois alguns aplicativos podem não funcionar corretamente se instala<strong>do</strong>s<br />
dentro <strong>do</strong> diretório "Arquivos de Programas" e algumas vezes não apresentam mensagens de erros consistentes.<br />
� Também pode ocorrer a não criação de variáveis de ambiente necessárias para executar o TotalCross<br />
Studio Community Edition. Neste caso é necessário criá-las manualmente. Para maiores informações,<br />
consulte o tópico Crian<strong>do</strong> Variáveis de Ambiente.<br />
2.3. Instalan<strong>do</strong> o TotalCross Studio Community<br />
Para instalar o TotalCross Studio Community Edition, siga os passos abaixo:<br />
a. Execute o instala<strong>do</strong>r <strong>do</strong> TotalCross Studio Community Edition.<br />
b. Você visualiza o passo 1 – Bem Vin<strong>do</strong>.
Bem Vin<strong>do</strong> - passo 1<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
c. Clique no botão Avançar. Você visualiza o passo 2 – Acor<strong>do</strong> de Licença. Leia to<strong>do</strong> o acor<strong>do</strong>.<br />
Instalação - passo 2<br />
d. Se você concorda com os termos propostos, selecione a opção Eu aceito os termos <strong>do</strong> acor<strong>do</strong> de licença.<br />
e. Se deseja instalar o TotalCross Studio Community Edition com as opções pré-definidas clique em Instalar.<br />
Esta opção estará disponível nas demais telas também. Caso deseje customizar a sua instalação clique em<br />
Avançar. Você visualiza o passo 3 - Tipo de Instalação.<br />
Pagina 10 de 129
Pagina 11 de 129<br />
Tipo de Instalação - passo 3<br />
f. Selecione o tipo de instalação que deseja realizar.<br />
g. Clique no botão Avançar. Você visualiza o passo 4 – Pasta de Destino.<br />
Pasta de Destino - passo 4<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
h. Especifique o local de instalação deseja<strong>do</strong> para o TotalCross Studio Community Edition.<br />
i. Clique no botão Avançar. Você visualiza o passo 5 – Pasta <strong>do</strong> Programa.
Pasta <strong>do</strong> Programa - passo 5<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
j. Clique no botão Avançar. Você visualiza o passo 6 – Resumo das configurações.<br />
Resumo das configurações - passo 6<br />
k. Verifique se as configurações realizadas estão corretas.<br />
l. Clique no botão Avançar e aguarde a conclusão <strong>do</strong> processo de instalação conforme mostra<strong>do</strong> no passo 7<br />
- Instalação <strong>do</strong> programa.<br />
Pagina 12 de 129
m. Ao final é mostra<strong>do</strong> o resulta<strong>do</strong> da instalação.<br />
Pagina 13 de 129<br />
Instalação <strong>do</strong> programa - passo 7<br />
Final - passo 8<br />
n. Clique no botão Finalizar para fechar o instala<strong>do</strong>r.<br />
2.4. Crian<strong>do</strong> Variáveis de Ambiente<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
É necessária a variável de ambiente TCSTUDIO_HOME2 para executar o TotalCross Studio Community Edition. Por<br />
padrão, essa variável é criada durante a instalação da ferramenta e de seus pré-requisitos. No entanto, pode<br />
ocorrer dessa variável não ser criada (problema detecta<strong>do</strong> no Win<strong>do</strong>ws Vista), sen<strong>do</strong> necessário criá-la manualmente.<br />
Veja a seguir como proceder.<br />
� TCSTUDIO_HOME2: especifica o diretório raiz da instalação <strong>do</strong> TotalCross Studio Community Edition.
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Se a variável não for criada depois de instalada a aplicação, a seguinte mensagem será exibida:<br />
Variável TCSTUDIO_HOME2 não criada.<br />
Para configurar as variáveis necessárias no Win<strong>do</strong>ws XP, siga os passos:<br />
a. Clique com o botão direito <strong>do</strong> mouse sobre o ícone Meu Computa<strong>do</strong>r na área de trabalho <strong>do</strong> sistema<br />
operacional.<br />
b. Clique na opção Propriedades. Você visualiza a janela Propriedades <strong>do</strong> Sistema.<br />
c. Clique na aba Avança<strong>do</strong>.<br />
d. Clique no botão Variáveis de Ambiente. Você visualiza o janela Variáveis de Ambiente.<br />
e. Clique no botão Nova em variáveis <strong>do</strong> usuário.<br />
f. Preencha os campos:<br />
Nome da variável: informe o nome da variável de ambiente TCSTUDIO_HOME2.<br />
Valor da Variável: informe o diretório completo da raiz de instalação to TotalCross Studio. Ex.:<br />
C:\Program Files (x86)\<strong>Tekann</strong> Mobile Solutions\TotalCross Studio Community 1.5.<br />
g. Clique no botão OK.<br />
h. Faça logoff no computa<strong>do</strong>r.<br />
Para configurar as variáveis necessárias no Win<strong>do</strong>ws Vista, siga os passos:<br />
a. Clique com o botão direito <strong>do</strong> mouse sobre o ícone Meu Computa<strong>do</strong>r na área de trabalho <strong>do</strong> sistema<br />
operacional.<br />
b. Clique na opção Propriedades.<br />
c. Na janela que abre, clique na opção Configurações Avançadas <strong>do</strong> Sistema. Você visualiza a janela Propriedades<br />
<strong>do</strong> Sistema.<br />
d. Na aba Avança<strong>do</strong>, clique no botão Variáveis de Ambiente. Você visualiza o janela Variáveis de Ambiente.<br />
e. Clique no botão Nova em variáveis <strong>do</strong> usuário.<br />
f. Preencha os campos:<br />
Nome da variável: informe o nome da variável de ambiente TCSTUDIO_HOME2.<br />
Valor da Variável: informe o diretório completo da raiz de instalação to TotalCross Studio. Ex.:<br />
C:\Program Files (x86)\<strong>Tekann</strong> Mobile Solutions\TotalCross Studio Community 1.5.<br />
g. Clique no botão OK.<br />
h. Faça logoff no computa<strong>do</strong>r.<br />
2.5. Configuran<strong>do</strong> Java e Ant<br />
É necessário configurar os executáveis <strong>do</strong> Java e Ant para compilar e executar os projetos desenvolvi<strong>do</strong>s no<br />
TotalCross Studio Community Edition. Esses executáveis podem ser configura<strong>do</strong>s de duas maneiras: especifican<strong>do</strong><br />
diretamente nas Preferências <strong>do</strong> TotalCross Studio Community Edition o diretório onde se encontram os respectivos<br />
executáveis, ou definin<strong>do</strong>-os como variáveis de ambiente <strong>do</strong> sistema operacional. Veja a seguir como configurar<br />
diretamente na ferramenta.<br />
Se, por algum motivo, as variáveis de ambientes JAVA ou ANT já estejam devidamente declaradas, você pode<br />
deixar a opção “Local Padrão” em quaisquer das três opções da tela de configuração. Caso contrário, informe<br />
manualmente o caminho para cada uma das opções.<br />
Pagina 14 de 129
Pagina 15 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
a. Execute o TotalCross Studio Community Edition.<br />
b. Clique no menu Ferramentas, item Preferências. Você visualiza a janela Preferências – Editor.<br />
Menu Ferramentas, item Preferências.<br />
c. Clique no ícone Ferramentas Externas.<br />
d. No campo Executável JavaC selecione a opção Local customiza<strong>do</strong>.<br />
e. Clique no botão .<br />
f. Encontre em seu computa<strong>do</strong>r o diretório de instalação <strong>do</strong> JAVA.<br />
g. Clique no diretório bin.<br />
h. Selecione o arquivo javac.exe.<br />
i. Clique no botão Abrir.<br />
j. No campo Executável Java selecione a opção Local customiza<strong>do</strong>.<br />
k. Clique no botão .<br />
l. Encontre em seu computa<strong>do</strong>r o diretório de instalação <strong>do</strong> JAVA.<br />
m. Clique no diretório bin.<br />
n. Selecione o arquivo java.exe.<br />
o. Clique no botão Abrir.<br />
p. No campo Executável ANT selecione a opção Local customiza<strong>do</strong>.<br />
q. Clique no botão .<br />
r. Encontre em seu computa<strong>do</strong>r o diretório de instalação <strong>do</strong> ANT.<br />
s. Clique no diretório bin.<br />
t. Selecione o arquivo ant.bat.<br />
u. Clique no botão Abrir.<br />
v. Clique no botão Fechar.
3. A Interface<br />
Configuran<strong>do</strong> os executáveis JAVA e ANT<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
A interface <strong>do</strong> TotalCross Studio Community Edition esta dividida em três perspectivas de visão para proporcionar<br />
uma organização melhor de suas funcionalidades. Essas perspectivas são:<br />
3.1. Página Inicial<br />
É a perspectiva de abertura <strong>do</strong> TotalCross Studio Community Edition e apresenta as seguintes características:<br />
1. Links úteis referentes à ferramenta, como web site da TEKANN e fórum da plataforma TotalCross.<br />
2. Atalhos para os projetos recentes, criação de novos projetos e abertura de outros projetos.<br />
3. Notícias recentes relacionadas com a ferramenta.<br />
Pagina 16 de 129
3.2. Designer<br />
Pagina 17 de 129<br />
A perspectiva Página Inicial<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
É a perspectiva principal <strong>do</strong> TotalCross Studio Community Edition, onde o desenvolve<strong>do</strong>r cria seus projetos.<br />
Concentra grande parte das funcionalidades oferecidas pela ferramenta. A seguir são apresentadas essas funcionalidades.<br />
Interface da perspectiva Designer
3.2.1. Botões de Atalho<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Os botões de atalho apresenta<strong>do</strong>s na interface da perspectiva Designer estão lista<strong>do</strong>s nas imagens abaixo.<br />
1. Novo projeto - Abre a caixa de diálogo Novo projeto onde o usuário poderá informar os da<strong>do</strong>s <strong>do</strong> novo<br />
projeto<br />
2. Salvar - Salva o Container atualmente seleciona<strong>do</strong>.<br />
3. Salvar to<strong>do</strong>s - Salva to<strong>do</strong>s os Containers ainda não salvos.<br />
4. Abrir projeto - Seleciona um projeto já salvo e o abre.<br />
5. Compilar o código - Compila o projeto atual geran<strong>do</strong> todas as classes utilizadas pela futura aplicação.<br />
6. Parar preview - Interrompe o applet <strong>do</strong> projeto em execução.<br />
7. Executar aplicação móvel - Executa o projeto atual (applet), é necessário compilar o projeto primeiro.<br />
8. Compila e executa aplicação móvel - Compila o projeto atual e, caso não haja erros, executa o<br />
projeto.<br />
9. Configurações de Deployment - Abre a caixa de diálogo Configurações de Deployment... onde o<br />
usuário poderá definir a plataforma que receberá a aplicação e gera seu instala<strong>do</strong>r.<br />
3.2.2. Barra de Ferramentas<br />
A barra de ferramentas permite ajustar o posicionamento e tamanho <strong>do</strong>s componentes utiliza<strong>do</strong>s no projeto. Possui<br />
quatros divisões, descritas nos tópicos lista<strong>do</strong>s abaixo.<br />
Pagina 18 de 129
3.2.2.1. Posição<br />
Pagina 19 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
A barra de ferramentas Posição permite especificar a posição de um componente em relação à área <strong>do</strong> container,<br />
utilizan<strong>do</strong> algumas constantes pré-definidas <strong>do</strong> TotalCross. Abaixo, você visualiza os campos de posicionamento:<br />
Barra de ferramentas - Posição<br />
1. Orientação no eixo X: é representada pelo combo à esquerda. Especifica a posição de um componente<br />
no eixo X (horizontal). Utiliza as constantes LEFT, RIGHT e CENTER.<br />
2. Orientação no eixo Y: é representada pelo combo à direita. especifica a posição de um componente no<br />
eixo Y (vertical). Utiliza as constantes TOP, BOTTOM e CENTER.<br />
Para maiores informações consulte o tópico Posicionan<strong>do</strong> Componentes.<br />
3.2.2.2. Âncora<br />
A barra de ferramentas Âncora permite especificar a posição de um componente em relação a outro componente,<br />
usan<strong>do</strong> o segun<strong>do</strong> como âncora. Utiliza as constantes pré-definidas AFTER, BEFORE, SAME, CENTER OF, RIGHT OF<br />
e BOTTOM OF.<br />
Abaixo você visualiza os campos de posicionamento utilizan<strong>do</strong> âncora:<br />
1. Âncora <strong>do</strong> componente seleciona<strong>do</strong>: Mostra em qual componente <strong>do</strong> container o componente seleciona<strong>do</strong><br />
deverá se ancorar.<br />
2. Posição relativa <strong>do</strong> componente ancora<strong>do</strong>: Define 9 tipos de posicionamento diferentes em torno <strong>do</strong>
componente âncora.<br />
Para maiores informações consulte o tópico Posicionan<strong>do</strong> Componentes.<br />
3.2.2.3. Espaçamento entre Componentes (GAP)<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
A barra de ferramentas Espaçamento entre componentes, ou Gap, permite configurar o espaçamento entre os<br />
componentes, realizan<strong>do</strong> assim ajustes finos de posicionamento.<br />
Abaixo você visualiza os campos para configurar o espaçamento entre componentes.<br />
Barra de ferramentas - Gap<br />
1. Espaçamento no eixo X: especifica o valor de espaçamento horizontal para o componente seleciona<strong>do</strong>.<br />
Pode ser negativo ou positivo.<br />
2. Espaçamento no eixo Y: especifica o valor de espaçamento vertical para o componente seleciona<strong>do</strong>.<br />
Pode ser negativo ou positivo.<br />
Para maiores informações consulte o tópico Posicionan<strong>do</strong> Componentes.<br />
3.2.2.4. Tamanho<br />
A barra de ferramentas Tamanho permite configurar o tamanho <strong>do</strong>s componentes inseri<strong>do</strong>s no projeto.<br />
O tamanho é defini<strong>do</strong> através de parâmetros relativos, sem utilizar valores absolutos. Entretanto, valores absolutos<br />
podem ser especifica<strong>do</strong>s para ajustes finos no tamanho.<br />
Barra de ferramentas - Tamanho<br />
Pagina 20 de 129
Pagina 21 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
1. PREFERRED no eixo X: ajusta a largura <strong>do</strong> componente automaticamente conforme seu conteú<strong>do</strong>.<br />
2. FIT no eixo X: ajusta a largura <strong>do</strong> componente estenden<strong>do</strong>-o até o componente indica<strong>do</strong>.<br />
3. FILL no eixo X: ajusta a largura <strong>do</strong> componente estenden<strong>do</strong>-o até o limite direito <strong>do</strong> container.<br />
4. Modifica<strong>do</strong>r de tamanho no eixo X: altera a largura <strong>do</strong> componente seleciona<strong>do</strong> fazen<strong>do</strong>-o crescer ou<br />
diminuir de largura. Podem ser informa<strong>do</strong>s valores positivos ou negativos.<br />
5. PREFERRED no eixo Y: ajusta a altura <strong>do</strong> componente automaticamente.<br />
6. FIT no eixo Y: ajusta a altura <strong>do</strong> componente estenden<strong>do</strong>-o até o componente indica<strong>do</strong>.<br />
7. FILL no eixo Y: ajusta a altura <strong>do</strong> componente estenden<strong>do</strong>-o até o limite direito <strong>do</strong> container.<br />
8. Modifica<strong>do</strong>r de tamanho no eixo Y: altera a altura <strong>do</strong> componente seleciona<strong>do</strong> fazen<strong>do</strong>-o crescer ou<br />
diminuir de altura. Podem ser informa<strong>do</strong>s valores positivos ou negativos.<br />
3.2.3. Projetos<br />
No quadro Projeto você visualiza a estrutura principal <strong>do</strong> projeto, apresentan<strong>do</strong> informações referentes aos<br />
containers, menus, bibliotecas e templates utiliza<strong>do</strong>s.<br />
Na imagem abaixo pode-se observar essa organização.<br />
Explora<strong>do</strong>r <strong>do</strong> projeto<br />
O quadro Projeto também possui uma barra de botões com funções comuns à árvore de componentes.
Barra de ferramentas <strong>do</strong> quadro Projetos<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
1. Expandir tu<strong>do</strong>: Expande to<strong>do</strong>s os no<strong>do</strong>s da árvore de componentes <strong>do</strong>s projetos.<br />
2. Recolher tu<strong>do</strong>: Recolhe to<strong>do</strong>s os no<strong>do</strong>s da árvore de componentes <strong>do</strong>s projetos.<br />
3. Atualizar: Atualiza a árvore de componentes <strong>do</strong>s projetos.<br />
4. Ligação com design: Quan<strong>do</strong> seleciona<strong>do</strong>, esta opção seleciona na árvore de projetos o componente<br />
seleciona<strong>do</strong> no quadro Visualização.<br />
5. Novo container: Abre a caixa de diálogo para criação de um novo container.<br />
6. Adicionar um MenuBar: Abre a caixa de diálogo para criação de um novo MenuBar.<br />
7. Adicionar menu: Adiciona um Menu a uma MenuBar. Essa opção é habilitada quan<strong>do</strong> um ManuBar é<br />
seleciona<strong>do</strong> na árvore de componentes <strong>do</strong> projeto.<br />
8. Adicionar item de menu: Abre a caixa de diálogo para adicionar um Item de Menu a uma MenuBar. esta<br />
opção é habilitada quan<strong>do</strong> um Menu é seleciona na árvore de componentes <strong>do</strong> projeto.<br />
9. Editar item: Abre a caixa de diálogo para editar o MenuBar, Menu ou Item de Menu conforme o que<br />
estiver seleciona<strong>do</strong> na árvore de componentes <strong>do</strong> projeto.<br />
Atualmente são suporta<strong>do</strong>s múltiplos projetos abertos simultaneamente. Cada projeto aberto é exibi<strong>do</strong> na lista de<br />
projetos, conten<strong>do</strong> toda sua estrutura. A seguir serão explicadas as divisões que compõem essa estrutura.<br />
Para alterar qual projeto é o principal siga os passos:<br />
a. Na aba Projeto, clique com o botão direito <strong>do</strong> mouse sobre o nome <strong>do</strong> projeto deseja<strong>do</strong>.<br />
b. Um pop-up menu será exibi<strong>do</strong>. Clique na opção Setar como principal.<br />
c. O projeto seleciona<strong>do</strong> passa a ser o projeto principal.<br />
Veja a seguir o que significa cada divisão <strong>do</strong> quadro Projeto.<br />
Containers<br />
Estrutura organizada em forma de árvore, apresenta os containers <strong>do</strong> projeto e seus componentes. Possui a divisão<br />
interna Design que engloba os componentes que compõem a interface <strong>do</strong> projeto.<br />
Para maiores informações consulte o tópico Tipos de Containers.<br />
Menus<br />
Estrutura organizada em forma de árvore que apresenta os menus <strong>do</strong> projeto. Para maiores informações consulte<br />
o tópico Crian<strong>do</strong> Menus.<br />
Bibliotecas<br />
Estrutura organizada em forma de árvore, que apresenta as bibliotecas adicionadas ao projeto. Para maiores<br />
informações consulte o tópico Utilizan<strong>do</strong> Bibliotecas.<br />
Pagina 22 de 129
Pagina 23 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Templates<br />
Estrutura organizada em forma de árvore, que apresenta os templates cria<strong>do</strong>s para utilização no projeto seleciona<strong>do</strong>.<br />
Para maiores informações consulte o tópico Crian<strong>do</strong> Templates para Containers.<br />
3.2.4. Arquivos<br />
No quadro Arquivos você visualiza a estrutura de diretórios e arquivos cria<strong>do</strong>s pelo TotalCross Studio Community<br />
Edition para o seu projeto.<br />
Veja exemplo na imagem abaixo.<br />
Explora<strong>do</strong>r de arquivos<br />
Para maiores informações veja o tópico Estrutura Gerada.<br />
3.2.5. Visualização<br />
No quadro Visualização é construída a interface <strong>do</strong> projeto, adicionan<strong>do</strong> e posicionan<strong>do</strong> componentes conforme<br />
deseja<strong>do</strong>. Para maiores informações, consulte o tópico Crian<strong>do</strong> Novo Container.<br />
Quadro visualização
3.2.6. Paleta<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
No quadro Paleta apresentam-se as listas de componentes disponíveis que podem ser adiciona<strong>do</strong>s aos containers<br />
<strong>do</strong> seu projeto e também os componentes <strong>do</strong> tipo BEAN cria<strong>do</strong>s pelo usuário. Veja a imagem abaixo.<br />
Componentes básicos da paleta<br />
Na tabela abaixo estão lista<strong>do</strong>s to<strong>do</strong>s os componentes da paleta.<br />
Ícone Nome Descrição<br />
Button Inclui um botão no container. Para maiores informações, consulte o tópico Button.<br />
Check<br />
ComboBox<br />
ComboBoxEditable<br />
Edit<br />
Grid<br />
ImageControl<br />
Inclui um campo para ser marca<strong>do</strong>/desmarca<strong>do</strong> no container. Para maiores informações,<br />
consulte o tópico CheckBox.<br />
Inclui uma lista suspensa de opções no container. Para maiores informações, consulte o<br />
tópico ComboBox.<br />
Inclui uma lista suspensa e editável de opções no container. Para maiores informações,<br />
consulte o tópico ComboBox Editable.<br />
Inclui um campo de preenchimento/apresentação de informações no container. Para<br />
maiores informações, consulte o tópico Edit.<br />
Inclui uma grade no container que permite ao usuário visualizar e/ou manipular da<strong>do</strong>s em<br />
suas células. Para maiores informações, consulte o tópico Grid.<br />
Inclui uma imagem no container. Para maiores informações consulte o tópico Image<br />
Control.<br />
Label Inclui um rótulo no container. Para maiores informações consulte o tópico Label.<br />
ListBox<br />
MultiEdit<br />
ProgressBar<br />
PushButtonGroup<br />
Inclui uma caixa de listagem no container. Para maiores informações, consulte o tópico<br />
List Box.<br />
Inclui um campo de preenchimento/apresentação de informações no container com<br />
suporte para múltiplas linhas. Para maiores informações, consulte o tópico Multi Edit.<br />
Inclui uma barra de progresso no container. Para maiores informações consulte o tópico<br />
Progress Bar.<br />
Inclui um grupo de botões no container. Para maiores informações consulte o tópico Push<br />
Button Group.<br />
Pagina 24 de 129
Radio<br />
Pagina 25 de 129<br />
RadioGroupController<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Inclui um campo de seleção de opção no container. Para maiores informações, consulte<br />
o tópico Radio.<br />
Inclui um componente para agrupamento de campos Radio no container. Para maiores<br />
informações, consulte o tópico Radio Group Controller.<br />
Ruler Inclui uma linha no container. Para maiores informações, consulte o tópico Ruler.<br />
ScrollBar<br />
Slider<br />
Spacer<br />
SpinList<br />
Spinner<br />
Tree<br />
Whiteboard<br />
3.2.7. Propriedades<br />
Inclui uma barra de rolagem no container. Para maiores informações, consulte o tópico<br />
Scroll Bar.<br />
Inclui uma barra com demarcações pré-definidas no container. Para maiores informações,<br />
consulte o tópico Slider.<br />
Inclui um espaça<strong>do</strong>r transparente no container. Para maiores informações, consulte o<br />
tópico Spacer.<br />
Inclui uma lista de opções estilo ComboBox no container que muda suas opções através<br />
de um ponteiro "para cima" e "para baixo". Para maiores informações, consulte o tópico<br />
Spin List.<br />
Inclui uma imagem animada no container. Para maiores informações, consulte o tópico<br />
Spinner.<br />
Inclui uma estrutura em formato de árvore no container. Para maiores informações<br />
consulte o tópico Tree.<br />
Inclui uma área para que seja possível escrever ou desenhar livremente no container.<br />
Para maiores informações, consulte o tópico Whiteboard.<br />
Este quadro apresenta as propriedades <strong>do</strong> projeto, <strong>do</strong>s containers, menus, tabelas e componentes <strong>do</strong> projeto. Para<br />
visualizar as propriedades de um componente:<br />
a. Clique sobre o componente deseja<strong>do</strong>. Você visualiza as configurações no quadro Propriedades.<br />
b. Altere as propriedades desejadas.<br />
Propriedades de um componente Label<br />
A lista de propriedades varia conforme o item seleciona<strong>do</strong>. Nos tópicos abaixo podem ser vistas as propriedades de<br />
cada item.
3.2.7.1. Propriedades <strong>do</strong> Projeto<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
São as propriedades gerais <strong>do</strong> projeto. Na aba Projeto clique no nome <strong>do</strong> projeto deseja<strong>do</strong> para visualizar suas<br />
propriedades. Para maiores informações, consulte o tópico Projeto. No quadro Propriedades você visualiza:<br />
� Propriedades Gerais<br />
Name<br />
Especifica o nome <strong>do</strong> projeto. A propriedade não permite string vazia ou palavras reservadas. Para maiores informações,<br />
consulte o tópico Lista de Palavras Reservadas.<br />
Output Dir<br />
Especifica o diretório onde o projeto está armazena<strong>do</strong>.<br />
Package<br />
Especifica o nome <strong>do</strong> pacote que engloba as classes <strong>do</strong> projeto.<br />
Main Class Name<br />
Especifica o nome da classe <strong>do</strong> container principal <strong>do</strong> projeto, que estende a classe MainWin<strong>do</strong>w <strong>do</strong> TotalCross. A<br />
propriedade não permite string vazia ou palavras reservadas. Para maiores informações, consulte o tópico Lista de<br />
Palavras Reservadas.<br />
Custom Main Class Name<br />
Especifica o nome da classe customizável <strong>do</strong> container principal <strong>do</strong> projeto, que estende a classe <strong>do</strong> container<br />
principal. A propriedade não permite string vazia ou palavras reservadas. Para maiores informações, consulte o<br />
tópico Lista de Palavras Reservadas.<br />
First Swap<br />
Permite especificar o container que deve ser carrega<strong>do</strong> ao iniciar a aplicação. Por padrão essa propriedade é vazia.<br />
Default Date Format<br />
Permite especificar o formato padrão de data utiliza<strong>do</strong> nos formulários <strong>do</strong> projeto.<br />
Thousand separator<br />
Em números, especifica o caractere que separa a casa <strong>do</strong>s milhares.<br />
Decimal separator<br />
Em números, especifica o caractere que separa a casa <strong>do</strong>s decimais.<br />
App Title<br />
Especifica o título da aplicação. Este será o nome <strong>do</strong> executável que aparecerá no dispositivo móvel.<br />
General UI Preferences<br />
Permite especificar se o projeto utiliza alguma preferência padrão de interface. As opções disponíveis correspondem<br />
às configurações criadas nas preferências <strong>do</strong> TotalCross Studio Community Edition. Para maiores informações,<br />
consulte o tópico Editor em Configuran<strong>do</strong> Preferências, e o tópico Preferências Gerais de Interface para<br />
os Projetos.<br />
Full Screen<br />
Permite especificar se a aplicação deve rodar em tela cheia no dispositivo.<br />
Full Screen Plataforms<br />
Especifica em quais plataformas a aplicação deverá rodar em tela cheia.<br />
Pagina 26 de 129
� Propriedades TotalCross<br />
UI Style<br />
Permite especificar o estilo da interface da aplicação.<br />
Pagina 27 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Close Connection<br />
Se true, o TotalCross cria uma nova conexão com o banco de da<strong>do</strong>s fecha a conexão com o banco de da<strong>do</strong>s sempre<br />
que uma ação de insert, delete ou update é realizada. Não aplicável na versão Community da ferramenta.<br />
Generate Events Log<br />
Selecione True para mostrar no output ações relativas a componentes como objetos clica<strong>do</strong>s, arrasta<strong>do</strong>s ou textos<br />
digita<strong>do</strong>s pelo usuário.<br />
Generate TKNMS Log<br />
Selecione True para gerar arquivo de log da aplicação. O arquivo de log é armazena<strong>do</strong> no diretório corrente onde<br />
a aplicação está instalada. Caso a aplicação seja executada dentro <strong>do</strong> TotalCross Studio Community Edition, o<br />
arquivo de log é armazena<strong>do</strong> no diretório <strong>do</strong> projeto, dentro de /pdafiles/bin. Para maiores informações, consulte<br />
o tópico Estrutura <strong>do</strong> Projeto.<br />
Default Locale<br />
Permite definir o idioma utiliza<strong>do</strong> pela aplicação desenvolvida no TotalCross Studio Community Edition. Para<br />
maiores informações, consulte o tópico Internacionalizan<strong>do</strong> um Projeto.<br />
Application ID<br />
Especifica um identifica<strong>do</strong>r único, de 4 bytes, necessário para rodar aplicativos no Palm OS. Não podem existir duas<br />
aplicações rodan<strong>do</strong> no mesmo dispositivo com o mesmo Creator ID, pois a mais recente irá sobrescrever a aplicação<br />
anterior. A Palm disponibiliza em seu site uma base de da<strong>do</strong>s centralizada onde podem ser realiza<strong>do</strong>s<br />
registros de CREATOR ID's disponíveis e consultas sobre os existentes.<br />
App Description<br />
Especifica a descrição da aplicação.<br />
App Version<br />
Especifica a versão atual da aplicação.<br />
App Category<br />
Especifica a categoria da aplicação.<br />
App Location<br />
Da<strong>do</strong>s de instalação requeri<strong>do</strong>s por algumas plataformas apenas.<br />
Conpany Info<br />
Especifica as informações de contato da Empresa que criou a aplicação, por exemplo, o nome da empresa.<br />
Conpany Contact<br />
Especifica o e-mail de contato da empresa.<br />
Disable Screen Rotation<br />
Se true, não reposiciona os componentes da aplicação quan<strong>do</strong> o dispositivo girar.<br />
Font Size<br />
Especifica o tamanho default da fonte usada pela aplicação.<br />
� Propriedades Visual<br />
BackColor
Especifica a cor de fun<strong>do</strong> da MainWin<strong>do</strong>w.<br />
ForeColor<br />
Especifica a cor da fonte da MainWin<strong>do</strong>w.<br />
Font<br />
Especifica a fonte da MainWin<strong>do</strong>w.<br />
Background image<br />
Especifica a imagem de fun<strong>do</strong> da MainWin<strong>do</strong>w.<br />
Background image brightness<br />
Especifica a quantidade de brilho da imagem de fun<strong>do</strong> da MainWin<strong>do</strong>w.<br />
Background image contrast<br />
Especifica a quantidade de contraste da imagem de fun<strong>do</strong> da MainWin<strong>do</strong>w.<br />
Background image transparent color<br />
Especifica a cor de uma imagem que será substituída por transparente.<br />
Border Style<br />
Especifica o tipo de borda da MainWin<strong>do</strong>w<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Gradient Title Start<br />
Especifica a cor inicial <strong>do</strong> degrade, em formato RGB, quan<strong>do</strong> o tipo de borda selecionada for HORIZON-<br />
TAL_GRADIENT ou VERTICAL_GRADIENT.<br />
Gradient Title End<br />
Especifica a cor final <strong>do</strong> degrade, em formato RGB, quan<strong>do</strong> o tipo de borda selecionada for HORIZON-<br />
TAL_GRADIENT ou VERTICAL_GRADIENT.<br />
3.2.7.2. Propriedades <strong>do</strong>s Containers<br />
São as propriedades de cada container. No quadro Projeto, árvore Containers, clique no container que deseja ver<br />
as propriedades. No quadro Propriedades você visualiza:<br />
Class Name<br />
Especifica o nome da classe <strong>do</strong> container. A propriedade não permite string vazia ou palavras reservadas. Para<br />
maiores informações, consulte o tópico Lista de Palavras Reservadas.<br />
Custom Class Name<br />
Especifica o nome da classe customizável <strong>do</strong> container, que entende a classe <strong>do</strong> container. A propriedade não<br />
permite string vazia ou palavras reservadas. Para maiores informações, consulte o tópico Lista de Palavras Reservadas.<br />
Use Application Title:<br />
Especifica se o texto da propriedade App Title deve ser mostrada no alto <strong>do</strong> container ou o nome <strong>do</strong> próprio<br />
container.<br />
Title<br />
Especifica o título <strong>do</strong> container.<br />
Border Style<br />
Especifica o tipo de borda <strong>do</strong> container.<br />
Pagina 28 de 129
Layout<br />
Informa o layout defini<strong>do</strong> para o container.<br />
Font<br />
Especifica a fonte <strong>do</strong> container.<br />
Pagina 29 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Scrollable<br />
Permite especificar se o container possui barra(s) de rolagem (vertical, horizontal, ou ambas, de acor<strong>do</strong> com a<br />
posição <strong>do</strong>s componentes na tela).<br />
Size<br />
Propriedade existente apenas para containers <strong>do</strong> tipo BEAN. Permite especificar as dimensões <strong>do</strong> bean. Para<br />
maiores informações, consulte o tópico Crian<strong>do</strong> um Componente Customiza<strong>do</strong> (Bean).<br />
Transiction Effect<br />
Especifica o tipo de efeito que será mostra<strong>do</strong> quan<strong>do</strong> o container for carrega<strong>do</strong>.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> container.<br />
ForeColor<br />
Especifica a cor da fonte <strong>do</strong> rótulo.<br />
Transparent Background<br />
Permite especificar se o container utiliza cor de fun<strong>do</strong> transparente. Caso sim, a cor de fun<strong>do</strong> <strong>do</strong> container será a<br />
cor de fun<strong>do</strong> da MainWin<strong>do</strong>w.<br />
3.2.7.3. Propriedades da Barra de Menus<br />
Para visualizar as propriedades de uma barra de menus, navegue na aba Projeto árvore Menus, e clique na barra<br />
de menu desejada. No quadro Propriedades você visualiza:<br />
Name<br />
Especifica o nome da barra de menu. A propriedade não permite string vazia ou palavras reservadas. Para maiores<br />
informações, consulte o tópico Lista de Palavras Reservadas.<br />
Items<br />
Permite ordenar os menus da barra de menu. Siga os passos abaixo:<br />
a. Clique no botão . Você visualiza a janela Editor de MenuBar.
Itens da barra de menus<br />
b. Ordene os menus da barra de menus como preferir.<br />
c. Clique no botão OK.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Containers<br />
Permite especificar os containers que irão apresentar a barra de menus selecionada. É possível criar várias barras<br />
de menus e atribuí-las a diferentes containers. Para configurar uma barra de menus a determina<strong>do</strong>s containers,<br />
siga os passos:<br />
a. Clique no botão . Você visualiza a janela Configuran<strong>do</strong> containers para MenuBar.<br />
Pagina 30 de 129
Pagina 31 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Configuran<strong>do</strong> os containers que apresentam a barra de menus selecionada<br />
b. Selecione os containers que irão apresentar a barra de menus na caixa Containers <strong>do</strong> Projeto.<br />
c. Clique no botão . Na caixa Containers MenuBar você visualiza os containers configura<strong>do</strong>s para<br />
exibirem a barra de menus quan<strong>do</strong> a aplicação estiver em execução.<br />
d. Clique no botão OK.<br />
Pop BackColor<br />
Especifica a cor de fun<strong>do</strong> da janela pop-up <strong>do</strong> menu.<br />
Pop ForeColor<br />
Especifica a cor da fonte da janela pop-up <strong>do</strong> menu.<br />
Selection Color<br />
Especifica a cor de seleção da janela pop-up <strong>do</strong> menu.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> da barra de menu.<br />
ForeColor<br />
Especifica a cor da fonte da barra de menu.<br />
Font<br />
Especifica a fonte <strong>do</strong> menu.<br />
Transparent Background<br />
Permite especificar se a barra de menu utiliza cor de fun<strong>do</strong> transparente.
3.2.7.4. Propriedades <strong>do</strong> Menu<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Para visualizar as propriedades de um menu, navegue na aba Projeto árvore Menus, e clique no menu deseja<strong>do</strong>. No<br />
quadro Propriedades você visualiza:<br />
Name<br />
Especifica o nome <strong>do</strong> menu.<br />
Text<br />
Especifica o rótulo exibi<strong>do</strong> no menu.<br />
Items<br />
Permite ordenar os itens <strong>do</strong> menu. Siga os passos:<br />
a. Clique no botão . Você visualiza a janela Editor de menu.<br />
b. Altere as informações desejadas.<br />
c. Clique no botão OK.<br />
Itens <strong>do</strong> menu<br />
3.2.7.5. Propriedades <strong>do</strong> Item de Menu<br />
Para visualizar as propriedades de um item de menu, navegue na aba Projeto árvore Menus, e clique no item de<br />
menu deseja<strong>do</strong>. No quadro Propriedades você visualiza:<br />
Name<br />
Especifica o nome <strong>do</strong> item de menu.<br />
Text<br />
Pagina 32 de 129
Especifica o rótulo exibi<strong>do</strong> para o item de menu.<br />
Pagina 33 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Action<br />
Permite especificar a ação que o item de menu irá executar ao ser pressiona<strong>do</strong>. Siga os passos abaixo:<br />
a. Clique no botão . Você visualiza a janela Editor de MenuItem.<br />
Configuran<strong>do</strong> ação de um item de menu<br />
b. Informe os campos:<br />
Nome: informa o nome <strong>do</strong> item de menu. Modifique se desejar.<br />
Texto: informa o rótulo <strong>do</strong> item de menu. Modifique se desejar.<br />
Action: assinale a ação realizada pelo MenuItem quan<strong>do</strong> pressiona<strong>do</strong>.<br />
c. Clique no botão OK.<br />
Para exibir uma caixa de mensagem antes de executar a ação escolhida:<br />
a. Marque a opção Mostrar MessageBox.<br />
b. Clique no botão para configurar a caixa de mensagem.<br />
Para maiores informações, consulte o tópico Personalizan<strong>do</strong> um Message Box.<br />
3.2.8. Saída<br />
No quadro Saída você visualiza a resposta de saída resultante da compilação ou execução de seu projeto.<br />
Quadro de saída exibin<strong>do</strong> resulta<strong>do</strong> de uma compilação
3.3. Desenvolvimento<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Essa é a perspectiva que permite explorar a estrutura de classes gerada pelo TotalCross Studio Community Edition,<br />
visualizar o código fonte <strong>do</strong>s arquivos gera<strong>do</strong>s e ver a atual árvore de elementos da classe selecionada. Veja a<br />
seguir as funcionalidades que compõem essa perspectiva.<br />
3.3.1. Classes<br />
Interface da perspectiva Desenvolvimento<br />
No quadro Classes são mostradas as classes geradas automaticamente pelo TotalCross Studio Community Edition.<br />
Para cada container monta<strong>do</strong> na perspectiva Designer, o TotalCross Studio Community Edition gera <strong>do</strong>is arquivos:<br />
uma classe java no pacote *.ui que contém todas as propriedades <strong>do</strong> container e uma classe java no pacote<br />
*.custom.ui onde novas implementaões e customizações <strong>do</strong> container podem ser programadas.<br />
Vale ressaltar que não se deve programar nas classes <strong>do</strong> pacote *.ui uma vez que elas são geradas sempre que<br />
ocorrerem modificações no container e recompilação.<br />
Para maiores informações, consulte o tópico Crian<strong>do</strong> Novo Container.<br />
Pagina 34 de 129
Pagina 35 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Quadro Classes da perspectiva Desenvolvimento mostran<strong>do</strong> as classes geradas <strong>do</strong> projeto.<br />
3.3.2. Arquivos<br />
No quadro Arquivos você visualiza a estrutura de diretórios e arquivos cria<strong>do</strong>s pelo TotalCross Studio Community<br />
Edition para o seu projeto. Esse quadro é idêntico ao quadro Arquivos da perspectiva Designer. Veja exemplo na<br />
imagem abaixo. Para maiores informações veja o tópico Estrutura Gerada.<br />
Explora<strong>do</strong>r de arquivos
3.3.3. Elementos<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
No quadro Elementos você visualiza a árvore de elementos da classe selecionada. Nesta árvore é possível ver os<br />
imports da classe, suas variáveis , construtores e funções. Esse quadro também serve de acesso rápi<strong>do</strong> ao código,<br />
uma vez que qualquer elemento clica<strong>do</strong> no quadro será exibi<strong>do</strong> no quadro Código Fonte.<br />
3.3.4. Código Fonte<br />
Árvore de elementos da classe selecionada.<br />
No quadro Código Fonte você visualiza o código gera<strong>do</strong> pelo TotalCross Studio Community Edition. Cada container<br />
cria<strong>do</strong> na perspectiva Designer gera uma classe de mesmo nome e uma classe custom também com o mesmo nome<br />
e precedida da letra "C". Somente classes custom são editáveis aqui. Para abrir o código fonte gera<strong>do</strong> é necessário<br />
dar <strong>do</strong>is cliques na classe desejada. Na imagem abaixo, você vê e editor de código fonte.<br />
Quadro Código Fonte com o código gera<strong>do</strong> para a classe.<br />
Pagina 36 de 129
4. Componentes<br />
Pagina 37 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
O TotalCross Studio Community Edition disponibiliza os principais componentes gráficos para fácil inserção e<br />
manipulação <strong>do</strong>s mesmo na interface <strong>do</strong>s projetos. Esses componentes estão separa<strong>do</strong>s nos grupos abaixo.<br />
Controles básicos: São os componentes básicos disponíveis na ferramenta como botões, labels e campos de<br />
edição.<br />
Gráficos: São gráficos para exibição de da<strong>do</strong>s.<br />
Outros Componentes: São componentes gera<strong>do</strong>s pelo usuário. Dividem-se em Tabs, componentes que organizam<br />
seu conteú<strong>do</strong> em abas, e Beans, componentes customiza<strong>do</strong>s, cria<strong>do</strong>s pelo desenvolve<strong>do</strong>r.<br />
4.1. Controles Básicos<br />
São os componentes básicos disponíveis na ferramenta, sen<strong>do</strong> eles:<br />
4.1.1. Button<br />
Adiciona um botão ao container e possui as seguintes propriedades disponíveis:<br />
Name<br />
Especifica o nome <strong>do</strong> botão.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Text<br />
Especifica o texto exibi<strong>do</strong> como rótulo <strong>do</strong> botão.<br />
Border Style<br />
Permite especificar o estilo de borda utiliza<strong>do</strong> pelo botão. Os estilos 3D gradiente permitem outras configurações,
listadas mais a frente.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Text Position<br />
Propriedade utilizada apenas quan<strong>do</strong> o botão possui texto e imagem. Permite especificar a posição <strong>do</strong> texto em<br />
relação à imagem. São elas:<br />
CENTER - posiciona o texto sobre da imagem.<br />
TOP - posiciona o texto acima da imagem.<br />
BOTTOM - posiciona o texto abaixo da imagem.<br />
LEFT - posiciona o texto à esquerda da imagem.<br />
RIGHT - posiciona o texto à direita da imagem.<br />
Text GAP<br />
Habilita<strong>do</strong> apenas quan<strong>do</strong> o botão possui texto e imagem. Especifica o espaçamento entre o texto e a imagem.<br />
Border Width 3DG<br />
Especifica a largura da borda <strong>do</strong> botão para o estilo de borda 3D Gradient (horizontal ou vertical).<br />
Corner Radius 3DG<br />
Especifica o raio <strong>do</strong>s canto <strong>do</strong> botão para o estilo de borda 3D Gradient (horizontal ou vertical).<br />
Border Color 3DG<br />
Especifica a cor da borda <strong>do</strong> botão para o estilo de borda 3D Gradient (horizontal ou vertical).<br />
Top Color 3DG<br />
Especifica a cor inicial <strong>do</strong> gradiente <strong>do</strong> botão para o estilo de borda 3D Gradient (horizontal ou vertical).<br />
Bottom Color 3DG<br />
Especifica a cor final <strong>do</strong> gradiente <strong>do</strong> botão para o estilo de borda 3D Gradient (horizontal ou vertical).<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> botão quan<strong>do</strong> o estilo de borda não for 3D Gradient (horizontal ou vertical).<br />
ForeColor<br />
Especifica a cor da fonte e a sombra <strong>do</strong> botão quan<strong>do</strong> o estilo de borda não for 3D Gradient (horizontal ou vertical).<br />
Font<br />
Especifica a fonte <strong>do</strong> rótulo.<br />
Image<br />
Permite inserir uma imagem em um botão. Esta imagem deve estar armazenada no diretório Resource dentro da<br />
estrutura de diretórios <strong>do</strong> projeto, para que seja carregada e empacotada corretamente. Para maiores informações,<br />
consulte o tópico Estrutura <strong>do</strong> Projeto. Para remover a imagem <strong>do</strong> botão clique no botão .<br />
Pressed Image<br />
Permite definir uma imagem que aparece quan<strong>do</strong> o botão é manti<strong>do</strong> pressiona<strong>do</strong>. Para remover a imagem <strong>do</strong> botão<br />
clique no botão .<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
Pagina 38 de 129
4.1.2. Check<br />
Pagina 39 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Adiciona ao container uma caixa para ativar ou desativar uma opção e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Text<br />
Especifica o texto que aparece no campo check box.<br />
Checked<br />
Permite especificar se o campo está marca<strong>do</strong> ou desmarca<strong>do</strong> por padrão.<br />
Left Justify<br />
Permite alinhar o texto à esquerda, ao la<strong>do</strong> <strong>do</strong> check box caso true, ou alinhar o texto na borda direita <strong>do</strong> componente,<br />
caso false.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> campo.<br />
ForeColor<br />
Especifica a cor da fonte <strong>do</strong> campo.<br />
Font<br />
Especifica a fonte <strong>do</strong> campo.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.
4.1.3. Combo Box<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Adiciona uma lista suspensa de opções para seleção ao container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable: Permite habilitar ou desabilitar o componente.<br />
Mask Width<br />
Especifica a máscara que define a largura padrão <strong>do</strong> combo quan<strong>do</strong> este usar a opção PREFERRED para largura.<br />
Permite ajustar a largura <strong>do</strong> componente quan<strong>do</strong> este é popula<strong>do</strong> em tempo de execução da aplicação. Para<br />
maiores informações, consulte o tópico Dimensionan<strong>do</strong> Componentes.<br />
Data<br />
Permite incluir e editar valores para o combo. Para adicionar um item:<br />
a. Clique no botão . Você visualiza a janela Editor de ComboBox.<br />
Pagina 40 de 129
Pagina 41 de 129<br />
Editor de da<strong>do</strong>s <strong>do</strong> ComboBox<br />
b. Clique no botão Adicionar.<br />
c. Informe os campos.<br />
Valor: informe o valor que deseja incluir na lista.<br />
Descrição: informe a descrição <strong>do</strong> valor que deseja incluir.<br />
d. Clique no botão Aplicar.<br />
e. Clique no botão OK.<br />
Initial Value<br />
Permite especificar a informação padrão <strong>do</strong> campo.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> combo.<br />
ForeColor<br />
Especifica a cor da fonte <strong>do</strong> combo.<br />
Font<br />
Especifica a fonte <strong>do</strong> combo.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.4. Combo Box Editable<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Adiciona uma lista suspensa de opções para seleção ao container além de permitir a edição dentro <strong>do</strong> container.<br />
Possui as seguintes propriedades:<br />
Name
Especifica o nome <strong>do</strong> componente.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Mask Width<br />
Especifica a máscara que define a largura padrão <strong>do</strong> combo quan<strong>do</strong> este usar a opção PREFERRED para largura.<br />
Permite ajustar a largura <strong>do</strong> componente quan<strong>do</strong> este é popula<strong>do</strong> em tempo de execução da aplicação. Para<br />
maiores informações, consulte o tópico Dimensionan<strong>do</strong> Componentes.<br />
Initial Value<br />
Permite especificar a informação padrão <strong>do</strong> campo.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> combo.<br />
ForeColor<br />
Especifica a cor da fonte <strong>do</strong> combo.<br />
Font<br />
Especifica a fonte <strong>do</strong> combo.<br />
Data<br />
Permite incluir e editar valores para o combo. Para adicionar um item:<br />
a. Clique no botão . Você visualiza a janela Editor de ComboBox.<br />
Pagina 42 de 129
Pagina 43 de 129<br />
Editor de da<strong>do</strong>s <strong>do</strong> ComboBox<br />
b. Clique no botão Adicionar.<br />
c. Informe os campos.<br />
Valor: informe o valor que deseja incluir na lista.<br />
Descrição: informe a descrição <strong>do</strong> valor que deseja incluir.<br />
d. Clique no botão Aplicar.<br />
e. Clique no botão OK.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.5. Edit<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Adiciona um campo para inserção de texto no container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Text<br />
Especifica o texto exibi<strong>do</strong> no campo. Esta propriedade é de preenchimento opcional.<br />
Capitalise<br />
ALL_LOWER - converte to<strong>do</strong>s os caracteres digita<strong>do</strong>s para minúsculo.<br />
ALL_UPPER - converte to<strong>do</strong>s os caracteres digita<strong>do</strong>s para maiúsculo.<br />
ALL_NORMAL - apresenta os caracteres da forma digitada.<br />
Max Length<br />
Informa o tamanho máximo <strong>do</strong> campo.<br />
Valid Chars<br />
Permite especificar os caracteres váli<strong>do</strong>s para inserção no campo. Os caracteres devem ser posta<strong>do</strong>s em sequência<br />
e sem separa<strong>do</strong>r. Se não houver nenhum valor especifica<strong>do</strong> para esta propriedade, to<strong>do</strong>s os caracteres serão<br />
váli<strong>do</strong>s.<br />
Mask<br />
Permite definir uma máscara para o campo.<br />
Mask Enabled<br />
Caso valor da propriedade seja configura<strong>do</strong> como True, a máscara definida na propriedade Mask é aplicada para o<br />
componente. Caso o valor seja False, a máscara definida na propriedade Mask serve apenas para definir o tamanho<br />
<strong>do</strong> componente quan<strong>do</strong> este está configura<strong>do</strong> como PREFERRED.<br />
Editable<br />
Permite habilitar ou desabilitar a edição <strong>do</strong> conteú<strong>do</strong> <strong>do</strong> campo.<br />
Mode<br />
Permite restringir os caracteres aceitos no campo e também criar máscaras para inserção de informações.<br />
NORMAL - permite to<strong>do</strong>s os caracteres.<br />
DATE - restringe os caracteres váli<strong>do</strong>s permitin<strong>do</strong> apenas números e o caractere padrão para separação de data.<br />
Cria máscara para inserção de data.<br />
CURRENCY - restringe os caracteres váli<strong>do</strong>s permitin<strong>do</strong> apenas números e os caracteres + (mais), – (menos) e .<br />
(ponto). Cria máscara para inserção de moedas.<br />
PASSWORD - permite to<strong>do</strong>s os caracteres, converten<strong>do</strong>-os para * (asterisco). Apenas o último caractere digita<strong>do</strong><br />
permanece visível.<br />
PASWORD_ALL - permite to<strong>do</strong>s os caracteres converten<strong>do</strong>-os para * (asterisco).<br />
Pagina 44 de 129
Pagina 45 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Text Align<br />
Especifica o alinhamento <strong>do</strong> texto conti<strong>do</strong> no campo quan<strong>do</strong> o componente não tem foco.<br />
Auto Select<br />
Permite especificar que o conteú<strong>do</strong> <strong>do</strong> componente seja seleciona<strong>do</strong> automaticamente sempre que o componente<br />
receber foco.<br />
Keyboard<br />
Permite definir o tipo de tecla<strong>do</strong> a ser usa<strong>do</strong> para entrada de da<strong>do</strong>s.<br />
KBD_DEFAULT – Utiliza o tecla<strong>do</strong> padrão da plataforma.<br />
KBD_CALENDAR – Utiliza um calendário para inserir da<strong>do</strong>s no campo Edit.<br />
KBD_CALCULATOR – Utiliza uma calcula<strong>do</strong>ra para inserir da<strong>do</strong>s.<br />
KBD_NUMERIC – Utiliza um painel numérico para inserir da<strong>do</strong>s.<br />
KBD_TIME – Utiliza um painel com demarcações de horas para inserir da<strong>do</strong>s.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> campo.<br />
ForeColor<br />
Especifica a cor da fonte <strong>do</strong> campo.<br />
Font<br />
Especifica a fonte <strong>do</strong> rótulo.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.6. Grid<br />
Adiciona uma grade para visualização de da<strong>do</strong>s ao container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Auto Load<br />
Especifica se os da<strong>do</strong>s são carrega<strong>do</strong>s automaticamente na grid quan<strong>do</strong> ela for visualizada.<br />
Visible Lines<br />
Permite especificar o número de linhas visíveis da grid.<br />
Columns<br />
Permite manipular as colunas exibidas na grid. Para adicionar uma coluna:<br />
a. Clique no botão . Você visualiza a janela Editor de coluna.<br />
Editor de colunas da Grid<br />
b. Clique no botão Adicionar.<br />
c. Informe os campos:<br />
Label: informe o nome da coluna que deseja adicionar.<br />
Alinhamento: clique no botão e selecione o alinhamento <strong>do</strong> conteú<strong>do</strong> da coluna.<br />
Largura: Informe a largura da coluna que deseja adicionar. O valor -1 especifica auto ajuste de<br />
acor<strong>do</strong> com o tamanho <strong>do</strong> cabeçalho.<br />
d. Clique no botão Aplicar.<br />
Pagina 46 de 129
e. Clique no botão OK.<br />
Border Style<br />
Especifica a estilo de borda da grid.<br />
Vertical Line Style<br />
Especifica o estilo das linhas verticais que separam as colunas na grid.<br />
Captions Back Color<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> cabeçalho da grid.<br />
Highlight Color<br />
Especifica a cor de seleção da grid.<br />
First Stripe Color<br />
Especifica a cor de fun<strong>do</strong> da primeira linha da grid.<br />
Second Stripe Color<br />
Especifica a cor de fun<strong>do</strong> da segunda linha da grid.<br />
Pagina 47 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Disable Sort<br />
Permite habilitar ou desabilitar a ordenação das colunas quan<strong>do</strong> clica<strong>do</strong> no cabeçalho da grid.<br />
Check Enable<br />
Permite criar coluna de check box na grid.<br />
Bold Check<br />
Desenha o check box em negrito quan<strong>do</strong> o valor da propriedade Check Enable for True.<br />
Draw CheckBox<br />
Especifica se deve ser desenhada a caixa de seleção para o check box quan<strong>do</strong> o valor da propriedade Check Enable<br />
for True.<br />
Can Click Select All<br />
Permite habilitar no cabeçalho da grid opção de seleção de to<strong>do</strong>s check box quan<strong>do</strong> o valor da propriedade Check<br />
Enable for True.<br />
Check Color<br />
Especifica a cor <strong>do</strong> check box quan<strong>do</strong> o valor da propriedade Check Enable for True.<br />
Use Horizontal ScrollBar<br />
Permite especificar se o componente utiliza barra de rolagem horizontal ou botões para rolar as colunas para<br />
esquerda e direita.<br />
BackColor<br />
Especifica a cor da barra de rolagem <strong>do</strong> grid.<br />
ForeColor<br />
Especifica a cor <strong>do</strong> texto e bordas da grid.<br />
Font<br />
Especifica a fonte da grid.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.
4.1.7. Image Control<br />
Adiciona uma imagem ao container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Border Color<br />
Especifica a cor da borda da imagem.<br />
Use Border<br />
Determina se a imagem exibirá borda ou não.<br />
Center Image<br />
Permite centralizar a imagem no componente (caso o tamanho da imagem seja menor que o tamanho <strong>do</strong> componente).<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> componente.<br />
Image<br />
Permite selecionar a imagem para o componente. Esta imagem deve estar armazenada no diretório Resource<br />
dentro da estrutura de diretórios <strong>do</strong> projeto, para que seja carregada e empacotada corretamente. Para maiores<br />
informações, consulte o tópico Estrutura <strong>do</strong> Projeto. Para remover a imagem <strong>do</strong> botão clique no botão .<br />
Transparent Background<br />
Pagina 48 de 129
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.8. Label<br />
Adiciona um rótulo ao container e possui as seguintes propriedades disponíveis:<br />
Name<br />
Especifica o nome <strong>do</strong> rótulo.<br />
Pagina 49 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Text<br />
Especifica o texto que aparece no rótulo.<br />
Text Align<br />
Especifica o alinhamento <strong>do</strong> texto conti<strong>do</strong> no rótulo.<br />
Vertical Text Align<br />
Especifica o alinhamento vertical <strong>do</strong> texto conti<strong>do</strong> no rótulo.<br />
Auto Split<br />
Permite que a Label quebre o texto sempre que sua largura mudar.<br />
Use 3D<br />
Adiciona ao texto da Label um efeito de sombra dan<strong>do</strong> a impressão de relevo.<br />
Border Color<br />
Adiciona uma borda à Label.
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> rótulo.<br />
ForeColor<br />
Especifica a cor da fonte <strong>do</strong> rótulo.<br />
Font<br />
Especifica a fonte <strong>do</strong> rótulo.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.9. List Box<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Adiciona um campo com uma lista de itens ao container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Items<br />
Permite manipular os itens que fazem parte da lista. Para adicionar um item:<br />
a. Clique no botão . Você visualiza a janela Editor de ListBox.<br />
Pagina 50 de 129
Pagina 51 de 129<br />
Editor de itens <strong>do</strong> ListBox<br />
b. Clique no botão Adicionar.<br />
c. Informe o campo:<br />
Valor: informe o valor que deseja incluir na lista.<br />
d. Clique no botão Aplicar.<br />
e. Clique no botão OK.<br />
Simple Border<br />
Permite especificar que o list box possua borda simples.<br />
Enable Horiz Scroll<br />
Permite exibir a barra de rolagem horizontar para o list box.<br />
Back Color<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> list box.<br />
Fore Color<br />
Especifica a cor da fonte <strong>do</strong>s itens <strong>do</strong> list box.<br />
Font<br />
Especifica a fonte <strong>do</strong> list box.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.10. Multi Edit<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Adiciona um campo multilinhas para inserção de texto no container e possui as seguintes propriedades:
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Text<br />
Especifica o texto exibi<strong>do</strong> no campo MultiEdit. Esta propriedade é de preenchimento opcional.<br />
Row Count<br />
Permite especificar o número de linhas que o campo exibe na tela.<br />
Capitalise<br />
ALL_LOWER - converte to<strong>do</strong>s os caracteres digita<strong>do</strong>s para minúsculo.<br />
ALL_UPPER - converte to<strong>do</strong>s os caracteres digita<strong>do</strong>s para maiúsculo.<br />
ALL_NORMAL - apresenta os caracteres da forma digitada.<br />
Max Length<br />
Informa o tamanho máximo <strong>do</strong> campo.<br />
Valid Chars<br />
Permite especificar os caracteres váli<strong>do</strong>s para inserção no campo. Os caracteres devem ser posta<strong>do</strong>s em sequência<br />
e sem separa<strong>do</strong>r. Se não houver nenhum valor especifica<strong>do</strong> para esta propriedade, to<strong>do</strong>s os caracteres serão<br />
váli<strong>do</strong>s.<br />
Mask<br />
Permite definir uma máscara para o campo.<br />
Pagina 52 de 129
Pagina 53 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Draw Dots<br />
Especifica se deve ser desenhada uma linha pontilhada para cada linha de texto <strong>do</strong> componente.<br />
Scroll Always Visible<br />
Especifica se a barra de rolagem <strong>do</strong> componente deve ficar sempre visível.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> campo.<br />
ForeColor<br />
Especifica a cor da fonte e a sombra <strong>do</strong> campo.<br />
Font<br />
Especifica a fonte <strong>do</strong> rótulo.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.11. Progress Bar<br />
Adiciona uma barra de progresso ao container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Min
Especifica o valor mínimo da barra de progresso.<br />
Max<br />
Especifica o valor máximo da barra de progresso.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Prefix<br />
Especifica uma string exibida como prefixo <strong>do</strong> valor da barra de progresso. Exemplo: “Processo em”.<br />
Suffix<br />
Especifica uma string exibida como sufixo <strong>do</strong> valor da barra de progresso. Exemplo: “%”.<br />
Current Value<br />
Especifica o valor inicial da barra de progresso.<br />
Draw Border<br />
Permite especificar se a barra de progresso tem borda ou não.<br />
Text Color<br />
Especifica a cor da fonte e da borda da barra de progresso.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> (parte da barra não preenchida) da barra de progresso.<br />
ForeColor<br />
Especifica a cor da barra (parte da barra preenchida) de progresso.<br />
Font<br />
Especifica a fonte da barra de progresso.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.12. Push Button Group<br />
Adiciona um grupo de botões ao container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Relative<br />
Pagina 54 de 129
Pagina 55 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Button Names<br />
Permite adicionar o editar os botões <strong>do</strong> componente. Para adicionar um botão:<br />
a. Clique no botão . Você visualiza a janela Editor de PushButtonGroup.<br />
Editor de botões <strong>do</strong> PushButtonGroup<br />
b. Clique no botão Adicionar.<br />
c. Informe o campo:<br />
Valor: Informe o rótulo <strong>do</strong> botão que deseja incluir no grupo.<br />
d. Clique no botão Aplicar.<br />
e. Clique no botão OK.<br />
At Least One<br />
Permite especificar que um <strong>do</strong>s botões <strong>do</strong> componente deve ficar sempre seleciona<strong>do</strong>.<br />
Selected<br />
Permite especificar qual botão <strong>do</strong> componente está seleciona<strong>do</strong> ao iniciar a aplicação. A especificação é feita<br />
através <strong>do</strong> índice <strong>do</strong>s botões, começan<strong>do</strong> a partir de zero. O valor -1 especifica que nenhum botão está seleciona<strong>do</strong>.<br />
Gap
Especifica o espaçamento entre os botões.<br />
Inside Gap<br />
Especifica o espaçamento interno, entre o rótulo e a borda de cada botão.<br />
Rows<br />
Especifica em quantas linhas o grupo de botões é exibi<strong>do</strong>.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
All Same Width<br />
Permite especificar se a largura de to<strong>do</strong>s os botões <strong>do</strong> grupo possuem a mesma largura, basean<strong>do</strong>-se na largura <strong>do</strong><br />
botão com o maior rótulo.<br />
Button Type<br />
Especifica o tipo de botão e o comportamento <strong>do</strong>s botões <strong>do</strong> componente. Existem três opções disponíveis:<br />
Button: o botão é seleciona<strong>do</strong> e libera<strong>do</strong> imediatamente, agin<strong>do</strong> como um botão real.<br />
Check: um clique seleciona o botão, e outro clique libera o botão.<br />
Normal: um botão fica seleciona<strong>do</strong> por vez.<br />
Simple Border<br />
Permite especificar se os botões possuem borda simples.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong>s botões <strong>do</strong> componente.<br />
ForeColor<br />
Especifica a cor da fonte e sombra <strong>do</strong>s botões <strong>do</strong> componente.<br />
Font<br />
Especifica a fonte <strong>do</strong> rótulo.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.13. Radio<br />
Adiciona um campo de seleção única ao container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Pagina 56 de 129
Pagina 57 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Text<br />
Especifica o texto que aparece no campo Radio.<br />
Checked<br />
Permite especificar se o campo está marca<strong>do</strong> ou desmarca<strong>do</strong> por padrão.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> campo.<br />
ForeColor<br />
Especifica a cor da fonte e o contorno <strong>do</strong> campo.<br />
Font<br />
Especifica a fonte <strong>do</strong> rótulo.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.14. Radio Group Controller<br />
Esse componente permite agrupar componentes Radio, de forma a obter campo de múltipla escolha.<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
4.1.15. Ruler<br />
Adiciona um componente no estilo de uma linha ao container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position
Informa a posição <strong>do</strong> componente no container.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Invert<br />
Permite inverter as cores <strong>do</strong> efeito 3D <strong>do</strong> componente.<br />
Type<br />
Determina a orientação <strong>do</strong> componente: VERTICAL ou HORIZONTAL.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> campo.<br />
ForeColor<br />
Especifica a cor da fonte e o contorno <strong>do</strong> campo.<br />
Font<br />
Especifica a fonte <strong>do</strong> rótulo.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.16. Scroll Bar<br />
Adiciona uma barra de rolagem ao container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Pagina 58 de 129
Pagina 59 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Orientation<br />
Especifica a direção de rolagem da barra (vertical ou horizontal).<br />
Value<br />
Especifica o valor inicial da barra de rolagem.<br />
Visible Items<br />
Especifica o número de itens visíveis na barra de rolagem.<br />
Minimun Value<br />
Especifica o valor mínimo da barra de rolagem.<br />
Maximum Value<br />
Especifica o valor máximo da barra de rolagem.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> da barra de rolagem.<br />
ForeColor<br />
Especifica a cor da fonte da barra de rolagem.<br />
Font<br />
Especifica a fonte <strong>do</strong> componente.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.17. Slider<br />
Adiciona uma barra com marca<strong>do</strong>r ao container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Orientation<br />
Determina a orientação <strong>do</strong> componente: HORIZONTAL ou VERTICAL.<br />
Value<br />
Determina o valor atual <strong>do</strong> marca<strong>do</strong>r.<br />
Minimun Value<br />
Determina o valor inicial da barra.<br />
Maximum Value<br />
Determina o valor final da barra.<br />
Invert<br />
Permite inverter o marca<strong>do</strong>r.<br />
Draw thicks<br />
Permite mostrar uma marcação com pontos conforme o valor final da barra.<br />
Draw filled area<br />
Determina se a parte da barra à esquerda <strong>do</strong> marca<strong>do</strong>r deve ser preenchida ou não.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> campo.<br />
ForeColor<br />
Especifica a cor da fonte e o contorno <strong>do</strong> campo.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.18. Spacer<br />
Adiciona um espaça<strong>do</strong>r transparente no container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
Pagina 60 de 129
Pagina 61 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Text<br />
Especifica o texto <strong>do</strong> componente. O tamanho <strong>do</strong> spacer leva em consideração esse texto, apesar dele não ser<br />
exibi<strong>do</strong>.<br />
Font<br />
Especifica a fonte <strong>do</strong> texto.<br />
4.1.19. Spin List<br />
Adiciona uma lista de seleção ao container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Choices<br />
Permite incluir e editar valores para o componente. Para adicionar um item:<br />
a. Clique no botão . Você visualiza a janela Editor de ComboBox.
Editor <strong>do</strong> SpinList<br />
b. Clique no botão Adicionar.<br />
c. Informe a descrição com o nome a ser exibi<strong>do</strong> na lista.<br />
d. Clique no botão Aplicar.<br />
e. Clique no botão OK.<br />
Selected<br />
Permite especificar qual item <strong>do</strong> SpinList será seleciona<strong>do</strong> por padrão.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> campo.<br />
ForeColor<br />
Especifica a cor da fonte e o contorno <strong>do</strong> campo.<br />
Font<br />
Especifica a fonte <strong>do</strong> rótulo.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.20. Spinner<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Adiciona um ícone de espera anima<strong>do</strong> ao container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Pagina 62 de 129
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Pagina 63 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Selected<br />
Permite especificar qual item <strong>do</strong> SpinList será seleciona<strong>do</strong> por padrão.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> campo.<br />
ForeColor<br />
Especifica a cor da fonte e o contorno <strong>do</strong> campo.<br />
Font<br />
Especifica a fonte <strong>do</strong> rótulo.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.21. Tree<br />
Adiciona uma árvore ao container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Border Style<br />
Especifica a estilo de borda da tree.<br />
Full Width Selection<br />
Se True, o componente selecionará toda linha <strong>do</strong> no<strong>do</strong> seleciona<strong>do</strong>. Se False, apenas o texto <strong>do</strong> no<strong>do</strong> seleciona<strong>do</strong>.<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> e da barra de rolagem da tree.<br />
ForeColor<br />
Especifica a cor <strong>do</strong> texto e bordas da tree.<br />
Font<br />
Especifica a fonte da tree.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.1.22. Whiteboard<br />
Adiciona uma área para escrita livre, como assinaturas pessoais, ou desenhos à mão no container e possui as<br />
seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Pagina 64 de 129
Informa a posição <strong>do</strong> componente no container.<br />
Pagina 65 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Thick<br />
Determina se a espessura da linha desenhada deve ser grossa, caso true.<br />
Use AA<br />
Determina se a linha deve ser suavizada (antialiase).<br />
BackColor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> campo.<br />
ForeColor<br />
Especifica a cor da fonte e o contorno <strong>do</strong> campo.<br />
Font<br />
Especifica a fonte <strong>do</strong> rótulo.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.2. Gráficos<br />
São os gráficos disponíveis na ferramenta, sen<strong>do</strong> eles:<br />
4.2.1. Column Chart<br />
Adiciona um gráfico de colunas no container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Text<br />
Especifica o texto que aparece no gráfico. Este campo é de preenchimento opcional.<br />
Title<br />
Especifica o título <strong>do</strong> gráfico. Este campo é de preenchimento opcional.<br />
Series<br />
Permite especificar as informações que compõem o gráfico.<br />
a. Clique no botão . Você visualiza a janela Editor de série.<br />
Pagina 66 de 129
Pagina 67 de 129<br />
Editor de série <strong>do</strong> ColumnChart<br />
b. Clique no botão Adicionar.<br />
c. Informe os campos:<br />
Nome da série: informe o nome da série.<br />
Valores: clique no botão e informe os valores da série.<br />
Cor: clique no botão e selecione a cor da barra.<br />
d. Clique no botão Aplicar.<br />
e. Clique no botão Fechar.<br />
Categories<br />
Permite especificar as categorias <strong>do</strong> gráfico.<br />
a. Clique no botão . Você visualiza a janela Editor de categorias.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br
Editor de categorias <strong>do</strong> ColumnChart<br />
b. Clique no botão Adicionar.<br />
c. Informe o campo:<br />
Nome da categoria: informe o nome da categoria.<br />
d. Clique no botão Aplicar.<br />
e. Clique no botão OK.<br />
Y Axis<br />
Permite especificar os valores referentes ao eixo Y <strong>do</strong> gráfico.<br />
a. Clique no botão . Você visualiza a janela Editor <strong>do</strong> eixo Y.<br />
Editor de eixo Y <strong>do</strong> ColumnChart<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Pagina 68 de 129
Pagina 69 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
b. Informe os campos:<br />
Valor min: informe o valor mínimo <strong>do</strong> eixo Y para o gráfico.<br />
Valor máx: informe o valor máximo <strong>do</strong> eixo Y para o gráfico.<br />
Número de passos: informe o número de subdivisões que o eixo Y irá ter.<br />
c. Clique no botão OK.<br />
Is 3D<br />
Permite especificar se o gráfico deve ser exibi<strong>do</strong> em 2D ou 3D.<br />
Gradient Horizontal<br />
Permite apresentar as cores das barras <strong>do</strong> gráfico em gradiente horizontal.<br />
Gradient Vertical<br />
Permite apresentar as cores das barras <strong>do</strong> gráfico em gradiente vertical.<br />
Gradient Dark<br />
Permite apresentar as cores das barras <strong>do</strong> gráfico em gradiente escuro quan<strong>do</strong> o valor de uma das propriedades<br />
Gradient Horizontal ou Gradient Vertical for True.<br />
Gradient Invert<br />
Permite inverter o gradiente nas cores das barras <strong>do</strong> gráfico quan<strong>do</strong> o valor de uma das propriedades Gradient<br />
Horizontal ou Gradient Vertical for True.<br />
Transparent Background<br />
Especifica se o gráfico possui fun<strong>do</strong> transparente.<br />
Show Y Values<br />
Especifica se os valores <strong>do</strong> eixo Y são exibi<strong>do</strong>s no gráfico.<br />
Show Categories<br />
Especifica se as categorias são exibidas no gráfico.<br />
Show Horizontal Grids<br />
Especifica se as linhas horizontais são exibidas no gráfico.<br />
Show Vertical Grids<br />
Especifica se as linhas verticais são exibidas no gráfico.<br />
Show Legend<br />
Especifica se a legenda <strong>do</strong> gráfico é exibida.<br />
Show Title<br />
Especifica se o título <strong>do</strong> gráfico é exibi<strong>do</strong>.<br />
Back Color<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> gráfico.<br />
Fore Color<br />
Especifica a cor da fonte <strong>do</strong> gráfico.<br />
Font<br />
Especifica a fonte <strong>do</strong> gráfico.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.
4.2.2. Pie Chart<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Adiciona um gráfico em forma de torta ao componente e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Text<br />
Especifica o texto que aparece no gráfico. Este campo é de preenchimento opcional.<br />
Title<br />
Especifica o título <strong>do</strong> gráfico. Este campo é de preenchimento opcional.<br />
Series<br />
Permite especificar as informações que compõem o gráfico.<br />
a. Clique no botão . Você visualiza a janela Editor de série.<br />
Pagina 70 de 129
. Clique no botão Adicionar.<br />
c. Informe os campos:<br />
Nome da série: informe o nome da série.<br />
Pagina 71 de 129<br />
Editor de série <strong>do</strong> PieChart<br />
Valores: clique no botão e informe os valores da série.<br />
Cor: clique no botão e selecione a cor da fatia.<br />
d. Clique no botão Aplicar.<br />
e. Clique no botão Fechar.<br />
Y Axis<br />
Permite especificar os valores referentes ao eixo Y <strong>do</strong> gráfico.<br />
a. Clique no botão . Você visualiza a janela Editor <strong>do</strong> eixo Y.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br
Editor de eixo Y <strong>do</strong> PieChart<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
b. Informe os campos:<br />
Valor min: informe o valor mínimo <strong>do</strong> eixo Y para o gráfico.<br />
Valor máx: informe o valor máximo <strong>do</strong> eixo Y para o gráfico.<br />
Número de passos: informe o número de subdivisões que o eixo Y irá ter.<br />
c. Clique no botão OK.<br />
Is 3D<br />
Permite especificar se o gráfico deve ser exibi<strong>do</strong> em 2D ou 3D.<br />
Gradient Horizontal<br />
Permite apresentar as cores <strong>do</strong> gráfico em gradiente horizontal.<br />
Gradient Vertical<br />
Permite apresentar as cores <strong>do</strong> gráfico em gradiente vertical.<br />
Gradient Dark<br />
Permite apresentar as cores <strong>do</strong> gráfico em gradiente escuro quan<strong>do</strong> o valor de uma das propriedades Gradient<br />
Horizontal ou Gradient Vertical for True.<br />
Gradient Invert<br />
Permite inverter o gradiente nas cores <strong>do</strong> gráfico quan<strong>do</strong> o valor de uma das propriedades Gradient Horizontal ou<br />
Gradient Vertical for True.<br />
Transparent Background<br />
Especifica se o gráfico possui fun<strong>do</strong> transparente.<br />
Show Y Values<br />
Especifica se os valores <strong>do</strong> eixo Y são exibi<strong>do</strong>s no gráfico.<br />
Show Categories<br />
Especifica que categorias que são exibidas no gráfico.<br />
Show Horizontal Grids<br />
Especifica se as linhas horizontais são exibidas no gráfico.<br />
Show Vertical Grids<br />
Especifica se as linhas verticais são exibidas no gráfico.<br />
Pagina 72 de 129
Show Legend<br />
Especifica se a legenda <strong>do</strong> gráfico é exibida.<br />
Show Title<br />
Especifica se o título <strong>do</strong> gráfico é exibi<strong>do</strong>.<br />
Distance of Selected Pie<br />
Especifica a distância que a fatia selecionada ficará <strong>do</strong> restante <strong>do</strong> gráfico.<br />
Legend Value Suffix<br />
Especifica um sufixo usa<strong>do</strong> na legenda para exibir os valores.<br />
Selected Series<br />
Especifica a fatia selecionada <strong>do</strong> gráfico.<br />
Show Values On Legend<br />
Permite exibir os valores na legenda.<br />
Back Color<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> gráfico.<br />
Fore Color<br />
Especifica a cor da fonte <strong>do</strong> gráfico.<br />
Font<br />
Especifica a fonte <strong>do</strong> gráfico.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.2.3. Line Chart<br />
Adiciona um gráfico de linhas ao container e possui as seguintes propriedades:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
Pagina 73 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Para maiores informações, consulte o tópico Configuran<strong>do</strong><br />
Tooltip para um Componente.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Relative
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Text<br />
Especifica o texto que aparece no gráfico. Este campo é de preenchimento opcional.<br />
Title<br />
Especifica o título <strong>do</strong> gráfico. Este campo é de preenchimento opcional.<br />
Series<br />
Permite especificar as informações que compõem o gráfico.<br />
a. Clique no botão . Você visualiza a janela Editor de série.<br />
Editor de série <strong>do</strong> LineChart<br />
b. Clique no botão Adicionar.<br />
c. Informe os campos:<br />
Nome da série: informe o nome da série.<br />
Valores: clique no botão e informe os valores da série.<br />
Pagina 74 de 129
Cor: clique no botão e selecione a cor da linha.<br />
d. Clique no botão Aplicar.<br />
e. Clique no botão Fechar.<br />
Categories<br />
Permite especificar as categorias <strong>do</strong> gráfico.<br />
a. Clique no botão . Você visualiza a janela Editor de categorias.<br />
Pagina 75 de 129<br />
Editor de categorias <strong>do</strong> LineChart<br />
b. Clique no botão Adicionar.<br />
c. Informe o campo:<br />
Nome da categoria: informe o nome da categoria.<br />
d. Clique no botão Aplicar.<br />
e. Clique no botão OK.<br />
Y Axis<br />
Permite especificar os valores referentes ao eixo Y <strong>do</strong> gráfico.<br />
a. Clique no botão . Você visualiza a janela Editor <strong>do</strong> eixo Y.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br
Editor de eixo Y <strong>do</strong> LineChart<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
b. Informe os campos:<br />
Valor min: informe o valor mínimo <strong>do</strong> eixo Y para o gráfico.<br />
Valor máx: informe o valor máximo <strong>do</strong> eixo Y para o gráfico.<br />
Número de passos: informe o número de subdivisões que o eixo Y irá ter.<br />
c. Clique no botão OK.<br />
Is 3D<br />
Permite especificar se o gráfico deve ser exibi<strong>do</strong> em 2D ou 3D.<br />
Gradient Horizontal<br />
Permite apresentar as cores <strong>do</strong> gráfico em gradiente horizontal.<br />
Gradient Vertical<br />
Permite apresentar as cores <strong>do</strong> gráfico em gradiente vertical.<br />
Gradient Dark<br />
Permite apresentar as cores <strong>do</strong> gráfico em gradiente escuro quan<strong>do</strong> o valor de uma das propriedades Gradient<br />
Horizontal ou Gradient Vertical for True.<br />
Gradient Invert<br />
Permite inverter o gradiente nas cores <strong>do</strong> gráfico quan<strong>do</strong> o valor de uma das propriedades Gradient Horizontal ou<br />
Gradient Vertical for True.<br />
Transparent Background<br />
Especifica se o gráfico possui fun<strong>do</strong> transparente.<br />
Show Y Values<br />
Especifica se os valores <strong>do</strong> eixo Y são exibi<strong>do</strong>s no gráfico.<br />
Show Categories<br />
Especifica se as categorias são exibidas no gráfico.<br />
Show Horizontal Grids<br />
Especifica se as linhas horizontais são exibidas no gráfico.<br />
Show Vertical Grids<br />
Especifica se as linhas verticais são exibidas no gráfico.<br />
Pagina 76 de 129
Show Legend<br />
Especifica se a legenda <strong>do</strong> gráfico é exibida.<br />
Show Title<br />
Especifica se o título <strong>do</strong> gráfico é exibi<strong>do</strong>.<br />
Line Tickness<br />
Especifica a espessura das linhas <strong>do</strong> gráfico.<br />
Point R<br />
Especifica o raio de cada ponto <strong>do</strong> gráfico.<br />
Show Lines<br />
Especifica se as linhas são exibidas no gráfico.<br />
Show Points<br />
Especifica se os pontos são exibi<strong>do</strong>s no gráfico.<br />
Back Color<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> gráfico.<br />
Fore Color<br />
Especifica a cor da fonte <strong>do</strong> gráfico.<br />
Font<br />
Especifica a fonte <strong>do</strong> gráfico.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.3. Outros Componentes<br />
Pagina 77 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Os componentes abaixo não estão disponíveis na Paleta. Para utilizá-los é necessário criá-los como containers. Para<br />
maiores informações, consulte o tópico Tipos de Containers.<br />
4.3.1. Tab Panel<br />
Este componente inclui um painel para agrupamento de abas. Ele não está disponível na barra de componentes da<br />
ferramenta. Para maiores informações, consulte o tópico Crian<strong>do</strong> Containers com Abas. O componente possui as<br />
seguintes propriedades disponíveis:<br />
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
ToolTip<br />
Permite adicionar uma dica de contexto ao componente. Siga os passos:<br />
d. Clique no botão .<br />
e. Configure o ToolTip. Para maiores informações, consulte o tópico Configuran<strong>do</strong> Tooltip para um Componente.<br />
f. Clique no botão OK.<br />
TabOrder<br />
Permite especificar a ordem de navegação pelos componentes, ou seja, qual componente recebe foco, para
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
dispositivos sem caneta. A navegação ocorre em ordem crescente, começan<strong>do</strong> a partir <strong>do</strong> menor número. Para<br />
facilitar alterações de sequências, permite números negativos.<br />
Size<br />
Informa os valores relativos utiliza<strong>do</strong>s para definir o tamanho <strong>do</strong> componente.<br />
Position<br />
Informa a posição <strong>do</strong> componente no container.<br />
Visual Attribute<br />
Permite especificar um perfil de atributos visuais previamente configura<strong>do</strong> para o componente. Para maiores<br />
informações, consulte o tópico Perfil de Atributos Visuais.<br />
Visible<br />
Permite especificar se o componente é visível na interface <strong>do</strong> projeto ou não.<br />
Enable<br />
Permite habilitar ou desabilitar o componente.<br />
Relative<br />
Informa o componente usa<strong>do</strong> como âncora para o componente seleciona<strong>do</strong>. Para maiores informações, consulte o<br />
tópico Posicionan<strong>do</strong> Componentes.<br />
Tabs<br />
Permite manipular as abas <strong>do</strong> tab panel. Para adicionar uma nova aba siga os passos abaixo.<br />
a. Clique no botão . Você visualiza a janela Editor de TabPanel, com a lista de abas existentes.<br />
Configuran<strong>do</strong> as abas de um TabPanel<br />
Pagina 78 de 129
. Clique no botão Adicionar.<br />
c. Informe os campos:<br />
Título da tab: preencha com o título da nova aba.<br />
Container: selecione um container existente para associar a aba.<br />
d. Clique no botão Aplicar para confirmar a inclusão.<br />
e. Clique no botão OK.<br />
Caption Color<br />
Especifica a cor da fonte e da borda das abas <strong>do</strong> tab panel.<br />
Active Tab<br />
Permite especificar a aba padrão exibida quan<strong>do</strong> o tab panel é acessa<strong>do</strong>.<br />
Tab Placement<br />
Permite especificar a posição das abas no tab panel.<br />
TOP - posiciona as abas no topo <strong>do</strong> tab panel.<br />
BOTTOM - posiciona as aba no rodapé <strong>do</strong> tab panel.<br />
Beep On<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> tab panel.<br />
Border Style<br />
Especifica a tipo de borda da aba.<br />
Arrows Color<br />
Especifica a cor das setas de rolagem.<br />
Active Tab Backcolor<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> tab ativo.<br />
Use Active Tab Backcolor<br />
Usa a cor de fun<strong>do</strong> <strong>do</strong> tab ativo.<br />
Use On Tab The Container Color<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong>s tabs igual à <strong>do</strong> container.<br />
Back Color<br />
Especifica a cor de fun<strong>do</strong> <strong>do</strong> tab panel.<br />
Fore Color<br />
Especifica a cor da fonte <strong>do</strong> tab panel.<br />
Font<br />
Especifica a fonte <strong>do</strong> rótulo <strong>do</strong> tab panel.<br />
Transparent Background<br />
Permite especificar se o componente utiliza cor de fun<strong>do</strong> transparente.<br />
4.3.2. Beans<br />
Pagina 79 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Beans são os componentes customiza<strong>do</strong>s desenvolvi<strong>do</strong>s pelo usuário. Para maiores informações, consulte os<br />
tópicos Crian<strong>do</strong> um Componente Customiza<strong>do</strong> (Bean) e Incluin<strong>do</strong> um Componente Customiza<strong>do</strong> (Bean) em um<br />
Container.
Name<br />
Especifica o nome <strong>do</strong> componente.<br />
Border Style<br />
Permite especificar o estilo de borda utiliza<strong>do</strong> pelo componente customiza<strong>do</strong>.<br />
5. Configuran<strong>do</strong> Preferências<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Permite configurar opção de preferência para o TotalCross Studio Community Edition. Veja os tópicos abaixo para<br />
dúvidas sobre como configurar cada seção.<br />
5.1. Editor<br />
Permite especificar opções de interface <strong>do</strong>s projetos cria<strong>do</strong>s no TotalCross Studio Community Edition.<br />
a. Clique no menu Ferramentas, item Preferências. Você visualiza a janela Preferências – Editor.<br />
b. Você verá as opções <strong>do</strong> Editor.<br />
Menu Ferramentas, item Preferências<br />
Configuran<strong>do</strong> preferências - Editor<br />
Pagina 80 de 129
Pagina 81 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Preferências gerais de interface<br />
Permite configurar, salvar, aplicar e distribuir definições padrões de interface para os projetos desenvolvi<strong>do</strong>s. Para<br />
maiores informações, consulte o tópico Preferências Gerais de Interface para os Projetos.<br />
Idiomas<br />
Permite alterar o idioma da ferramenta.<br />
Applet<br />
Permite alterar o comportamento <strong>do</strong> applet que simula a execução da aplicação.<br />
Mostrar o applet como um dispositivo penless: permite que o applet simule o comportamento de um dispositivo<br />
sem caneta, no qual a navegação pela aplicação deva ser feita através <strong>do</strong> tecla<strong>do</strong> <strong>do</strong> dispositivo.<br />
5.2. Ferramentas Externas<br />
Permite especificar onde estão localiza<strong>do</strong>s os executáveis para compilar, empacotar e executar os projetos desenvolvi<strong>do</strong>s<br />
no TotalCross Studio Community Edition. Estes executáveis devem ser indica<strong>do</strong>s na janela Preferências<br />
– Ferramentas Externas. Para maiores informações, consulte o tópico Configuran<strong>do</strong> Java e Ant.<br />
a. Clique no menu Ferramentas, item Preferências.<br />
b. Clique no item Ferramentas Externas.<br />
Menu Ferramentas, item Preferências<br />
Configuran<strong>do</strong> preferências - Ferramentas externas
c. Informe suas preferências.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Executável JavaC<br />
Assinale a opção Local padrão para utilizar a variável de ambiente configurada. Caso contrário assinale a opção<br />
Local customiza<strong>do</strong> e indique o caminho completo até o executável.<br />
Executável Java<br />
Assinale a opção Local padrão para utilizar a variável de ambiente configurada. Caso contrário assinale a opção<br />
Local customiza<strong>do</strong> e indique o caminho completo até o executável.<br />
Executável Ant<br />
Assinale a opção Local padrão para utilizar a variável de ambiente configurada. Caso contrário assinale a opção<br />
Local customiza<strong>do</strong> e indique o caminho completo até o executável.<br />
6. Selecionan<strong>do</strong> o Dispositivo Móvel Padrão<br />
Para determinar modelo <strong>do</strong> dispositivo móvel padrão para desenvolvimento de projetos, siga os passos abaixo.<br />
a. Clique no item de menu Ferramentas, item Lista de Dispositivos Móveis.<br />
Menu Ferramentas, item Lista de dispositivos móveis<br />
b. Você visualiza a janela Lista de Dispositivos Móveis com algumas configurações mais usuais já previamente<br />
definidas. Essas opções podem ser usadas para definir a resolução de tela de um novo projeto.<br />
Definin<strong>do</strong> o dispositivo móvel padrão de desenvolvimento<br />
c. Selecione o modelo <strong>do</strong> dispositivo móvel deseja<strong>do</strong>.<br />
Pagina 82 de 129
d. Clique no botão Padrão.<br />
e. Clique no botão Fechar.<br />
6.1. Adicionan<strong>do</strong> Novo Modelo de Dispositivo Móvel<br />
Para adicionar um novo dispositivo móvel à lista atual, siga os passos:<br />
a. Clique no menu Ferramentas, item Lista de Dispositivos Móveis.<br />
Pagina 83 de 129<br />
Adicionan<strong>do</strong> novo modelo de dispositivo móvel<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
b. Clique no botão Novo Você visualiza a janela Editor de lista de Dispositivos Móveis.<br />
Adicionan<strong>do</strong> novo modelo de dispositivo móvel
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
c. Informe os campos.<br />
Modelo: informe o modelo <strong>do</strong> dispositivo móvel.<br />
Fabricante: informe o nome <strong>do</strong> fabricante <strong>do</strong> dispositivo móvel.<br />
Largura: informe a largura da tela <strong>do</strong> dispositivo móvel.<br />
Altura: informe a altura da tela <strong>do</strong> dispositivo móvel.<br />
Cores: informe a número de cores (em bits) suporta<strong>do</strong> pelo dispositivo móvel.<br />
d. Clique no botão OK para confirmar a inclusão.<br />
7. Desenvolven<strong>do</strong> Projetos<br />
Neste capítulo serão aborda<strong>do</strong>s os principais tópicos para o desenvolvimento de aplicações utilizan<strong>do</strong> o TotalCross<br />
Studio Community Edition. Esses tópicos são:<br />
7.1. Crian<strong>do</strong> Novo Projeto<br />
Siga os passos abaixo para criar um novo projeto no TotalCross Studio Community Edition.<br />
a. Clique no menu Arquivo, item Novo projeto.<br />
b. Você visualiza a janela Novo projeto.<br />
Menu Arquivo, item Novo projeto.<br />
Crian<strong>do</strong> um novo projeto – passo 1.<br />
c. Informe os campos:<br />
Nome <strong>do</strong> projeto: informe o nome <strong>do</strong> projeto.<br />
Localização <strong>do</strong> projeto: informa o diretório de armazenamento <strong>do</strong> projeto. Caso deseje alterar,<br />
Pagina 84 de 129
Pagina 85 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
clique no botão Procurar.<br />
Pasta <strong>do</strong> projeto: informa o caminho completo <strong>do</strong> diretório raiz <strong>do</strong> projeto.<br />
d. Na seção Tamanho Padrão <strong>do</strong> Dispositivo é apresentada a resolução de tela padrão utilizada para novos<br />
projetos. Clique no botão Escolher para alterar a resolução. Para maiores informações, consulte o tópico<br />
Selecionan<strong>do</strong> o Dispositivo Móvel Padrão.<br />
Largura: informa a largura da tela a ser utilizada.<br />
Altura: informa a altura da tela a ser utilizada.<br />
Bits por pixel: informa a quantidade de cores suportada.<br />
e. Clique no botão Próximo.<br />
Janela Novo projeto - passo 2.<br />
f. Preencha os da<strong>do</strong>s:<br />
ID: A ID consiste em 4 caracteres alfanuméricos que identificam sua aplicação.<br />
Descrição: Uma descrição breve sobre a aplicação.<br />
Versão: Versão atual <strong>do</strong> desenvolvimento.<br />
Categoria: Categoria <strong>do</strong> projeto.<br />
Local de instalação: Da<strong>do</strong>s de instalação requeri<strong>do</strong>s por algumas plataformas apenas.<br />
Informações da companhia: Nome da empresa.=<br />
g. Clique no botão Finalizar.<br />
7.2. Crian<strong>do</strong> Novo Container<br />
Cada tela <strong>do</strong>s projetos desenvolvi<strong>do</strong>s é constituída por um container. Para criar um container siga os passos:<br />
Crie um novo container utilizan<strong>do</strong> uma das seguintes opções:<br />
� No menu Container, clique no item de menu Novo container.<br />
Menu Container, item Novo Container.<br />
� No quadro Projeto, clique no ícone Novo projeto, como mostra<strong>do</strong> na imagem abaixo.
Quadro Projetos com o botão Novo projeto em destaque.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
� Clican<strong>do</strong> com o botão direito <strong>do</strong> mouse no nome <strong>do</strong> projeto, ou em Containers ou no pacote e selecionar<br />
a opção Adicionar e no item Novo container.<br />
Adicionan<strong>do</strong> um novo container pelo menu de contexto.<br />
Pagina 86 de 129
a. Você visualiza a janela Novo container.<br />
Pagina 87 de 129<br />
Crian<strong>do</strong> novo container<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
b. Informe os campos:<br />
Nome <strong>do</strong> container: informe o nome <strong>do</strong> container. O campo não aceita string vazia nem palavras<br />
reservadas. Para maiores informações, consulte o tópico Lista de Palavras Reservadas.<br />
Tipo: clique no botão e selecione o tipo deseja<strong>do</strong> para a criação <strong>do</strong> container.<br />
Template: clique no botão e selecione o template a ser utiliza<strong>do</strong>. Este campo é habilita<strong>do</strong> para<br />
to<strong>do</strong>s os tipos de containers, exceto para tipo FILTER (Não disponível na versão Community da<br />
ferramenta). Os templates disponíveis devem ser previamente cria<strong>do</strong>s para o projeto. Para maiores<br />
informações, consulte o tópico Crian<strong>do</strong> Templates para Containers.<br />
Usar como primeiro swap: marque este campo caso deseje que o novo container seja configura<strong>do</strong><br />
como primeiro a ser carrega<strong>do</strong> ao executar o projeto.<br />
c. A seção Preview indica a resolução de tela que está sen<strong>do</strong> utilizada.<br />
Largura: informa a largura <strong>do</strong> layout a ser utiliza<strong>do</strong>.<br />
Altura: informa a altura <strong>do</strong> layout a ser utiliza<strong>do</strong>.<br />
d. Clique no botão Finalizar.<br />
7.2.1. Crian<strong>do</strong> Containers com Abas<br />
Para criar um container com navegação por abas, deve-se selecionar o tipo TABBED no primeiro passo de criação<br />
<strong>do</strong> container.<br />
Dessa forma cria-se um container utiliza<strong>do</strong> o componente TabPanel. Apesar de ser um componente, o TabPanel<br />
não encontra-se disponível na Paleta como os demais componentes. Para maiores informações, consulte o tópico<br />
Tipos de Containers.<br />
Um container <strong>do</strong> tipo TABBED possui algumas características importantes:
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
� Cada aba <strong>do</strong> TabPanel deve ser associa<strong>do</strong> com um container, desenvolvi<strong>do</strong> separadamente e apenas<br />
associa<strong>do</strong> ao TabPanel.<br />
� Sempre deve existir no mínimo uma aba no TabPanel.<br />
� No momento da criação de um container <strong>do</strong> tipo TABBED, é cria<strong>do</strong> automaticamente um container <strong>do</strong> tipo<br />
FREE, e este é associa<strong>do</strong> à primeira aba. Esse container pode ser deleta<strong>do</strong> <strong>do</strong> projeto posteriormente,<br />
desde que exista outra aba associada a outro container no TabPanel.<br />
7.2.1.1. Configuran<strong>do</strong> Nova Aba no TabPanel<br />
Para configurar as abas <strong>do</strong> TabPanel, siga os passos abaixo.<br />
a. Selecione o container que contém o TabPanel.<br />
b. Selecione o TabPanel no quadro Design ou no quadro Containers <strong>do</strong> Projeto.<br />
c. No quadro Propriedades, clique no botão na propriedade Tabs. Você visualiza a janela Editor de<br />
TabPanel.<br />
Adicionan<strong>do</strong> nova aba no TabPanel<br />
d. Clique no botão Adicionar.<br />
e. Informe os campos:<br />
Título da tab: preencha com o título da nova aba.<br />
Container: selecione um container existente para associar a aba.<br />
f. Clique no botão Aplicar.<br />
g. Clique no botão OK.<br />
Para maiores informações, consulte o tópico TabPanel.<br />
Pagina 88 de 129
7.2.2. Tipos de Containers<br />
Pagina 89 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Existem alguns tipos disponíveis para a criação de containers com características específicas para os projetos.<br />
Tipo Descrição<br />
FREE Cria um container livre vazio.<br />
TABBED<br />
TEMPLATE<br />
BEAN<br />
Cria um container com navegação por abas. Para maiores informações consulte o tópico Crian<strong>do</strong><br />
Containers com Abas.<br />
Permite criar um template para ser utiliza<strong>do</strong> na criação de outros containers. Atualmente os<br />
templates podem ser utiliza<strong>do</strong>s na criação de qualquer tipo de container, exceto tipo FILTER. Para<br />
maiores informações consulte o tópico Crian<strong>do</strong> Templates para Containers.<br />
Permite criar um componente customiza<strong>do</strong> para utilizar em um projeto. Para maiores informações<br />
consulte o tópico Crian<strong>do</strong> um Componente Customiza<strong>do</strong> (Bean).<br />
7.2.3. Crian<strong>do</strong> Templates para Containers<br />
O TotalCross Studio Community Edition permite a criação de modelos de containers, modelos comuns para um<br />
projeto, tornan<strong>do</strong> mais rápida a criação de containers com características semelhantes.<br />
Dessa forma, basta criar o modelo em um primeiro momento, e em seguida utilizá-los nos novos containers. Para<br />
criar um modelo de container, siga os passos abaixo.<br />
a. Clique no menu Container, item Novo container.<br />
Crian<strong>do</strong> um template<br />
b. Preencha os campos:<br />
Nome <strong>do</strong> container: informe o nome <strong>do</strong> modelo.<br />
Tipo: selecione o tipo TEMPLATE.
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Template: se desejar criar um modelo basea<strong>do</strong> em outro cria<strong>do</strong> anteriormente, selecione a opção<br />
desejada, caso contrário deixe o campo vazio.<br />
c. Clique no botão Finalizar. Será cria<strong>do</strong> um novo container que representa o modelo. Ele será adiciona<strong>do</strong> à<br />
lista de modelos na árvore Templates <strong>do</strong> aba Projeto. Para maiores informações, consulte o tópico Projeto.<br />
d. Adicione os componentes e/ou faça as alterações desejadas.<br />
e. Salve as alterações.<br />
7.2.4. Utilizan<strong>do</strong> um Template<br />
Para utilizar um modelo de container previamente cria<strong>do</strong>, siga os passos abaixo. Para maiores informações,<br />
consulte o tópico Crian<strong>do</strong> Templates para Containers.<br />
a. Clique no menu Container, item Novo container.<br />
Crian<strong>do</strong> um template<br />
b. Preencha os campos:<br />
Nome <strong>do</strong> container: informe o nome <strong>do</strong> modelo.<br />
Tipo: selecione o tipo TEMPLATE.<br />
c. No campo Template, selecione o modelo que deseja utilizar. Os modelos disponíveis correspondem aos<br />
cria<strong>do</strong>s previamente para o projeto.<br />
d. Clique no botão Finalizar. Será cria<strong>do</strong> um novo container utilizan<strong>do</strong> o modelo indica<strong>do</strong>.<br />
7.2.5. Crian<strong>do</strong> um Componente Customiza<strong>do</strong> (Bean)<br />
O TotalCross Studio Community Edition permite criar componentes customiza<strong>do</strong>s reutilizáveis. Para criar um Bean,<br />
siga os passos a seguir.<br />
a. Clique no menu Container, item Novo container.<br />
Pagina 90 de 129
Pagina 91 de 129<br />
Crian<strong>do</strong> um componente customizável (Bean)<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
b. Informe os campos:<br />
Nome <strong>do</strong> container: informe o nome <strong>do</strong> Bean. O campo não aceita string vazia nem palavras reservadas.<br />
Para maiores informações, consulte o tópico Lista de Palavras Reservadas.<br />
Tipo: clique no botão e selecione a opção BEAN.<br />
Template: é possível utilizar um template previamente cria<strong>do</strong>. Selecione um se deseja<strong>do</strong>.<br />
A seção Visualização indica as medidas <strong>do</strong> Bean. Altere conforme deseja<strong>do</strong>.<br />
Largura: informe a largura <strong>do</strong> Bean. Esse valor pode ser altera<strong>do</strong> posteriormente, através da propriedade<br />
Size. Por padrão o valor utiliza<strong>do</strong> é a largura <strong>do</strong>s containers <strong>do</strong> projeto.<br />
Altura: informe a altura <strong>do</strong> Bean. Esse valor pode ser altera<strong>do</strong> posteriormente, através da propriedade<br />
Size. Por padrão o valor utiliza<strong>do</strong> é a altura <strong>do</strong>s containers <strong>do</strong> projeto.<br />
c. Clique no botão Finalizar.<br />
d. O Bean será exibi<strong>do</strong> na lista Containers da aba Projeto. Selecione-o.<br />
e. Na seção Propriedades é possível alterar as propriedades <strong>do</strong> Bean listadas abaixo. Para maiores informações,<br />
consulte o tópico Propriedades <strong>do</strong>s Containers.<br />
É possível inserir outros componentes no Bean, a fim de criar um componente customiza<strong>do</strong> reutilizável.<br />
Exemplo de Bean cria<strong>do</strong> para utilizar como rodapé
7.3. Incluin<strong>do</strong> Componentes em um Container<br />
Para incluir um componente a um container siga os passos abaixo:<br />
a. No quadro Projeto, na lista Containers, selecione o container deseja<strong>do</strong>.<br />
b. No quadro Paleta, clique sobre o componente que deseja incluir.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Exemplo de Paleta com componentes comuns, gráficos e customiza<strong>do</strong>s.<br />
Você pode alterar a posição e tamanho <strong>do</strong> componente adiciona<strong>do</strong> através da barra de ferramentas. Para maiores<br />
informações, consulte os tópicos Posicionan<strong>do</strong> Componentes e Dimensionan<strong>do</strong> Componentes.<br />
7.3.1. Incluin<strong>do</strong> um Componente Customiza<strong>do</strong> (Bean) em um Container<br />
Para incluir um componente customiza<strong>do</strong> em um container siga os passos abaixo. Para maiores informações,<br />
consulte o tópico Crian<strong>do</strong> um Componente Customiza<strong>do</strong> (Bean).<br />
a. No quadro Projeto, na lista Containers, selecione o container deseja<strong>do</strong>.<br />
b. No quadro Paleta, clique sobre o grupo Beans. Será expandi<strong>do</strong> o grupo e lista<strong>do</strong> os componentes customiza<strong>do</strong>s<br />
já cria<strong>do</strong>s.<br />
Incluin<strong>do</strong> um componente customiza<strong>do</strong> em um container<br />
Pagina 92 de 129
c. Clique sobre o Bean deseja<strong>do</strong>.<br />
7.4. Posicionan<strong>do</strong> Componentes<br />
Pagina 93 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Existem duas formas de posicionar componentes através <strong>do</strong> TotalCross Studio Community Edition. Consulte os<br />
tópicos abaixo para maiores detalhes.<br />
7.4.1. Posicionan<strong>do</strong> em relação à área <strong>do</strong> container<br />
Utilizan<strong>do</strong> as constantes pré-definidas abaixo, é possível posicionar um componente em relação à área total <strong>do</strong><br />
container. Essas constantes são: TOP, BOTTOM, CENTER, LEFT e RIGHT.<br />
Para posicionar um componente desta forma, siga os passos:<br />
a. Selecione o container deseja<strong>do</strong> no quadro Projeto, lista Containers.<br />
b. Selecione o componente no quadro Design. Abaixo você visualiza um container com um Button seleciona<strong>do</strong>.<br />
Posicionan<strong>do</strong> um componente em relação à área <strong>do</strong> container<br />
c. Pode-se posicioná-lo utilizan<strong>do</strong> as coordenadas Posição X e Posição Y da barra de ferramentas. Abaixo<br />
visualizamos os campos Posição X e Posição Y na barra de ferramentas.<br />
Definin<strong>do</strong> a posição <strong>do</strong> componente em relação à área <strong>do</strong> container<br />
Posição X: é especifica<strong>do</strong> no combo box da esquerda, na barra de ferramentas acima. Indica a posição <strong>do</strong><br />
componente no eixo X, basean<strong>do</strong>-se na largura <strong>do</strong> container.<br />
Posição Y: é especifica<strong>do</strong> no combo box da direita, na barra de ferramentas. Indica a posição <strong>do</strong> componente no<br />
eixo Y, basean<strong>do</strong>-se na altura <strong>do</strong> container.
Exemplo de posicionamento CENTER, BOTTOM<br />
7.4.2. Posicionan<strong>do</strong> em relação a outro componente<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Componentes podem ser posiciona<strong>do</strong>s basean<strong>do</strong>-se em outros componentes já inseri<strong>do</strong>s, utilizan<strong>do</strong>-os como<br />
âncoras. São utilizadas as seguintes constantes pré-definidas: AFTER, BEFORE, SAME, CENTER OF, RIGHT OF e<br />
BOTTOM OF. Para posicionar um componente desta forma, siga os passos:<br />
a. Selecione o container deseja<strong>do</strong> no quadro Projeto, lista Containers.<br />
b. Selecione o componente no quadro Design. Abaixo você visualiza um container com um componente<br />
Button.<br />
Posicionan<strong>do</strong> um componente em relação a outro componente<br />
Pagina 94 de 129
Pagina 95 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
c. Adicione um novo componente. Selecione-o e na barra de ancoragem, especifique o componente que será<br />
a âncora <strong>do</strong> novo seleciona<strong>do</strong>. No exemplo a imagem será a âncora.<br />
Posicionan<strong>do</strong> um componente utilizan<strong>do</strong> âncora<br />
O combo da esquerda apresenta os componentes presentes no container que podem ser utiliza<strong>do</strong>s como âncora <strong>do</strong><br />
componente seleciona<strong>do</strong>.<br />
O combo da direita permite especificar a posição <strong>do</strong> componente seleciona<strong>do</strong> em relação a sua âncora.<br />
d. Após definir a âncora, utilize o combo da direita para definir a posição em relação à âncora. Será exibida a<br />
janela abaixo.<br />
Posicionan<strong>do</strong> um componente utilizan<strong>do</strong> âncora<br />
Na imagem acima o retângulo central indica a âncora e cada retângulo em sua volta é uma posição possível para<br />
o componente. As posições possíveis são combinações, para as coordenadas X e Y, das seguintes constantes:<br />
AFTER, BEFORE, SAME, CENTER OF, RIGHT OF, BOTTOM OF<br />
Nas imagens utilizas como exemplo aqui, o componente Label seleciona<strong>do</strong> utilizou um componente ImageControll<br />
inseri<strong>do</strong> anteriormente como âncora, sen<strong>do</strong> posiciona<strong>do</strong> acima e centraliza<strong>do</strong> no componente imagem (CEN-<br />
TER_OF, BEFORE). Abaixo visualizamos o resulta<strong>do</strong> dessa configuração.<br />
Posicionan<strong>do</strong> um componente usan<strong>do</strong> como âncora uma imagem
7.4.3. Ajustes Finos no Posicionamento<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Podem ser realiza<strong>do</strong>s ajustes finos no posicionamento <strong>do</strong>s componentes. Abaixo visualizamos a barra de ferramentas<br />
com os campos X GAP e Y GAP.<br />
Para realizar ajustes no posicionamento, siga os passos:<br />
Ajustan<strong>do</strong> GAP<br />
a. Selecione o container deseja<strong>do</strong> no quadro Projeto, lista Containers.<br />
b. Selecione o componente deseja<strong>do</strong> no quadro Design.<br />
c. Altere os valores <strong>do</strong>s campos:<br />
X GAP: informe o espaçamento para o componente no eixo X. O valor configura<strong>do</strong> sempre irá criar o<br />
espaço à esquerda <strong>do</strong> componente seleciona<strong>do</strong>, empurran<strong>do</strong>-o para a direita.<br />
Y GAP: informe o espaçamento para o componente no eixo Y. O valor configura<strong>do</strong> sempre irá criar o<br />
espaço acima <strong>do</strong> componente seleciona<strong>do</strong>, empurran<strong>do</strong>-o para baixo.<br />
Abaixo você visualiza um container com um componente Label configura<strong>do</strong> com GAP Y com valor -10 (ou seja, 10<br />
pixels de distância para cima) <strong>do</strong> componente ImageControll.<br />
7.5. Dimensionan<strong>do</strong> Componentes<br />
Componente com GAP ajusta<strong>do</strong><br />
Para alterar as dimensões <strong>do</strong>s componentes inseri<strong>do</strong>s nos containers, siga os passos abaixo:<br />
a. Selecione o container deseja<strong>do</strong> no quadro Projeto, lista Containers.<br />
b. Selecione o componente que deseja modificar no quadro Design.<br />
c. Ajuste o tamanho na barra de ferramentas. Abaixo visualizamos os campos para dimensionar componentes.<br />
Pagina 96 de 129
Pagina 97 de 129<br />
Barra de ferramentas - Tamanho<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
1. PREFERRED no eixo X: ajusta a largura <strong>do</strong> componente automaticamente.<br />
2. FIT no eixo X: ajusta a largura <strong>do</strong> componente estenden<strong>do</strong>-o até o componente indica<strong>do</strong>.<br />
3. FILL no eixo X: ajusta a largura <strong>do</strong> componente estenden<strong>do</strong>-o até o limite direito <strong>do</strong> container.<br />
4. Modifica<strong>do</strong>r de tamanho no eixo X: altera a largura <strong>do</strong> componente seleciona<strong>do</strong> fazen<strong>do</strong>-o crescer ou<br />
diminuir de tamanho. Podem ser informa<strong>do</strong>s valores positivos ou negativos.<br />
5. PREFERRED no eixo Y: ajusta a altura <strong>do</strong> componente automaticamente.<br />
6. FIT no eixo Y: ajusta a altura <strong>do</strong> componente estenden<strong>do</strong>-o até o componente indica<strong>do</strong>.<br />
7. FILL no eixo Y: ajusta a altura <strong>do</strong> componente estenden<strong>do</strong>-o até o limite direito <strong>do</strong> container.<br />
8. Modifica<strong>do</strong>r de tamanho no eixo Y: altera a altura <strong>do</strong> componente seleciona<strong>do</strong> fazen<strong>do</strong>-o crescer ou<br />
diminuir de tamanho. Podem ser informa<strong>do</strong>s valores positivos ou negativos.<br />
7.5.1. Ajustes Finos no Dimensionamento<br />
Podem ser realiza<strong>do</strong>s ajustes finos para dimensionar os componentes. Siga os passos:<br />
a. Selecione o container deseja<strong>do</strong> no quadro Projeto, lista Containers.<br />
b. Selecione o componente deseja<strong>do</strong> no quadro Design.<br />
c. Na barra de ferramentas especifique os valores deseja<strong>do</strong>s. Abaixo visualizamos os campos para dimensionar<br />
componentes.<br />
Realizan<strong>do</strong> ajuste fino nas dimensões de um componente<br />
Tamanho X: informe o valor no campo para realizar ajuste fino na largura <strong>do</strong> componente seleciona<strong>do</strong>.<br />
Tamanho Y: informe o valor no campo para realizar ajuste fino na altura <strong>do</strong> componente seleciona<strong>do</strong>.<br />
7.6. Excluin<strong>do</strong> Container<br />
a. No quadro Projeto, lista Containers, selecione o container deseja<strong>do</strong>.<br />
b. Clique no item de menu Editar, item Deletar. É possível deletar o container também usan<strong>do</strong> o menu de<br />
contexto: botão direito <strong>do</strong> mouse em cima <strong>do</strong> nome <strong>do</strong> container, item Deletar.
Menu Editar, item Deletar<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
c. Será apresentada a mensagem de confirmação de exclusão <strong>do</strong> container. Clique no botão OK.<br />
d. Em seguida, será solicitada confirmação de exclusão <strong>do</strong> código das classes customizáveis, caso você já<br />
tenha gera<strong>do</strong> o código da aplicação ao menos uma vez. Se desejar manter as classes customizáveis, clique<br />
no botão Não. Desta forma a classe customizável será renomeada e preservada, não causan<strong>do</strong> assim, erro<br />
de compilação por quebra de estrutura das classes.<br />
7.7. Crian<strong>do</strong> Menus<br />
Para criar um menu completo, são necessários no mínimo três passos. Criar a barra de menus, os menus, e os itens<br />
de menu para cada menu. Veja os tópicos abaixo para maiores informações sobre cada passo.<br />
7.7.1. Incluin<strong>do</strong> Barra de Menu<br />
Para incluir uma barra de menu no projeto, siga os passos a seguir.<br />
a. Acesse a aba Projeto na perspectiva Designer.<br />
b. Crie uma barra de menu. Para isso, escolha uma das formas a seguir:<br />
� Pela barra de ferramentas <strong>do</strong> quadro Projetos.<br />
Ícone para<br />
� Clique com o botão direito na área vazia da aba Projeto. No pop-up menu que irá abrir, selecione o menu<br />
Adicionar, item Novo Menu Bar. Você visualiza a janela Nome <strong>do</strong> Menu Bar.<br />
c. Informe o nome da barra de menu.<br />
Crian<strong>do</strong> barra de menu<br />
Pagina 98 de 129
d. Clique no botão OK.<br />
7.7.2. Editan<strong>do</strong> Barra de Menu<br />
Para editar uma barra de menu, siga os passos abaixo.<br />
Pagina 99 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
a. Acesse a aba Projeto na perspectiva Designer.<br />
b. Acesse o editor de menu bar utilizan<strong>do</strong> uma das formas abaixo:<br />
� Selecione a barra de menu que deseja editar e clique no ícone Editar menu.<br />
Botão Editar item <strong>do</strong> quadro Projetos.<br />
� Clique com o botão direito <strong>do</strong> mouse sobre o menu bar deseja<strong>do</strong>. No pop-up menu que irá abrir,<br />
selecione a opção Editar. Você visualiza a janela Editor de MenuBar.<br />
Editan<strong>do</strong> barra de menu<br />
c. Realize as alterações desejadas.<br />
Nome: altere o nome <strong>do</strong> menu seleciona<strong>do</strong>.<br />
Menus: altere a ordem <strong>do</strong>s menus <strong>do</strong> MenuBar.<br />
d. Clique no botão OK.<br />
7.7.3. Excluin<strong>do</strong> Barra de Menu<br />
Para excluir uma barra de menu, siga os passos abaixo.
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
a. Acesse o quadro Projeto na perspectiva Designer.<br />
b. Clique com o botão direito <strong>do</strong> mouse sobre a barra de menu desejada. No pop-up menu que irá abrir,<br />
selecione a opção Remover.<br />
7.7.4. Incluin<strong>do</strong> Menu<br />
Para incluir um menu, siga os passos abaixo.<br />
a. Acesse a aba Projeto na perspectiva Designer.<br />
b. Selecione a barra de menu onde deseja criar o menu.<br />
c. Clique no ícone Adicionar menu.<br />
d. Você visualiza a janela Nome <strong>do</strong> Menu.<br />
e. Informe o nome <strong>do</strong> menu.<br />
f. Clique no botão OK.<br />
7.7.5. Editan<strong>do</strong> Menu<br />
Para editar um menu, siga os passos abaixo.<br />
Botão Adicionar menu <strong>do</strong> quadro Projetos<br />
Nome <strong>do</strong> novo menu<br />
a. Acesse a aba Projeto na perspectiva Designer.<br />
b. Acesse o editor de menu utilizan<strong>do</strong> uma das formas abaixo:<br />
� Selecione o menu que deseja editar e clique no ícone Adicionar item de menu.<br />
Ícone Adicionar item de menu <strong>do</strong> quadro Projetos<br />
Pagina 100 de 129
Pagina 101 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
� Clique com o botão direito <strong>do</strong> mouse sobre o menu deseja<strong>do</strong>. No pop-up menu que irá abrir, selecione<br />
a opção Editar.<br />
c. Você visualiza a janela Editor de Menu.<br />
Editan<strong>do</strong> um menu<br />
d. Realize as alterações desejadas.<br />
Nome: altere o nome <strong>do</strong> menu seleciona<strong>do</strong>.<br />
Itens <strong>do</strong> menu: altere a ordem <strong>do</strong>s itens <strong>do</strong> menu como desejar.<br />
e. Clique no botão OK.<br />
7.7.6. Excluin<strong>do</strong> Menu<br />
Para excluir um menu, siga os passos a seguir.<br />
a. Acesse a aba Projeto na perspectiva Designer.<br />
b. Clique com o botão direito <strong>do</strong> mouse sobre o menu deseja<strong>do</strong>. No pop-up menu que irá abrir, selecione a<br />
opção Remover.<br />
7.7.7. Incluin<strong>do</strong> Item de Menu<br />
Para incluir um item de menu, siga os passos a seguir.<br />
a. Acesse a aba Projeto na perspectiva Designer.<br />
b. Selecione o menu que deseja incluir um item.<br />
c. Clique no ícone Adicionar item de menu.
d. Você visualiza a janela Editor de MenuItem.<br />
Ícone Adicionar item de menu <strong>do</strong> quadro Projetos<br />
Incluin<strong>do</strong> um item de menu<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
e. Informe os campos.<br />
Nome: informe o nome <strong>do</strong> item de menu.<br />
Texto: informe o rótulo <strong>do</strong> item de menu.<br />
Ação: selecione a ação que deseja realizar ao clicar no item de menu. Para maiores informações,<br />
consulte o tópico Ações de MenuItem<br />
f. Clique no botão OK.<br />
7.7.8. Editan<strong>do</strong> Item de Menu<br />
Para editar um item de menu, siga os passos abaixo.<br />
a. Acesse a aba Projeto na perspectiva Designer.<br />
b. Acesse o editor de item de menu utilizan<strong>do</strong> uma das formas abaixo:<br />
� Selecione o item de menu que deseja editar e clique no ícone Editar item.<br />
Pagina 102 de 129
Pagina 103 de 129<br />
Ícone Editar item <strong>do</strong> quadro Projetos<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
� Clique com o botão direito <strong>do</strong> mouse sobre o item de menu deseja<strong>do</strong> e no pop-up menu que irá abrir,<br />
selecione a opção Editar.<br />
c. Você visualiza a janela Editor de MenuItem.<br />
d. Realize as alterações desejadas.<br />
Nome: altere, se necessário, o nome <strong>do</strong> item de menu.<br />
Texto: altere, se necessário o rótulo <strong>do</strong> item de menu.<br />
Action: assinale a ação que deseja realizar ao clicar no item de menu. Para maiores informações,<br />
consulte o tópico Ações de MenuItem.<br />
e. Clique no botão OK.<br />
7.7.9. Excluin<strong>do</strong> Item de Menu<br />
Para excluir um item de menu, siga os passos abaixo.<br />
a. Acesse a aba Projeto na perspectiva Designer.<br />
b. Clique com o botão direito <strong>do</strong> mouse sobre o item de menu deseja<strong>do</strong>. No pop-up menu que irá abrir,<br />
selecione a opção Remover.<br />
7.7.10. Ações de MenuItem<br />
Seguem as ações disponíveis para MenuItem:<br />
Ação Descrição
Swap<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
A ação permite navegar para outro container da aplicação. Sempre que for configura<strong>do</strong> a ação SWAP<br />
para um item, deve-se também especificar o container destino da aplicação.<br />
Separa<strong>do</strong>r Cria um separa<strong>do</strong>r de itens no menu.<br />
Sair A ação finaliza a aplicação. Apresenta pedi<strong>do</strong> de confirmação que pode ser customiza<strong>do</strong>.<br />
Custom Cria uma ação customizável.<br />
7.8. Utilizan<strong>do</strong> Bibliotecas<br />
Permite adicionar ao projeto arquivos JAR conten<strong>do</strong> bibliotecas de containers que podem ser utiliza<strong>do</strong>s no projeto,<br />
permitin<strong>do</strong> assim a reutilização de código. Para maiores informações veja os tópicos abaixo:<br />
7.8.1. Incluin<strong>do</strong> Bibliotecas<br />
Para incluir bibliotecas ao projeto, siga os passos:<br />
a. Acesse a aba Projeto na perspectiva Designer.<br />
b. Clique com o botão direito <strong>do</strong> mouse sobre o item Libraries.<br />
c. No menu pop-up que abrir, acesse o menu Adicionar, item Nova Biblioteca.<br />
Adicionan<strong>do</strong> biblioteca no projeto<br />
f. Selecione no seu computa<strong>do</strong>r a biblioteca que deseja adicionar ao projeto.<br />
g. Clique no botão Abrir. Você visualiza a biblioteca adicionada ao projeto.<br />
Excluin<strong>do</strong> Bibliotecas<br />
Para excluir uma biblioteca, siga os passos abaixo.<br />
Biblioteca adicionada ao projeto<br />
Pagina 104 de 129
Pagina 105 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
a. Acesse a aba Projeto na perspectiva Designer.<br />
b. No item Libraries, clique com o botão direito <strong>do</strong> mouse sobre a biblioteca que deseja remover.<br />
c. No pop-up menu que irá abrir, clique na opção Remover.<br />
7.9. Excluin<strong>do</strong> Projeto<br />
Existem duas maneiras de exclusão de um projeto no TotalCross Studio Community Edition.<br />
� Através <strong>do</strong> menu:<br />
a. Na aba Projeto da perspectiva Designer, selecione o projeto que deseja excluir.<br />
b. Clique no menu Editar, item Deletar.<br />
Menu Editar, item Deletar<br />
� Através <strong>do</strong> quadro Projeto.<br />
c. Acesse a aba Projeto na perspectiva Designer.<br />
d. Clique com o botão direito <strong>do</strong> mouse sobre o nome <strong>do</strong> projeto.<br />
e. No pop-up menu que irá abrir, selecione a opção Remover.<br />
Deletan<strong>do</strong> projeto pelo menu de contexto<br />
f. Você visualiza a janela para confirmação de exclusão. Clique no botão Sim.
Excluin<strong>do</strong> um projeto<br />
8. Preferências Gerais de Interface para os Projetos<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Permite configurar, salvar, aplicar e distribuir preferências gerais de interface para os projetos desenvolvi<strong>do</strong>s. As<br />
preferências configuradas definem o valor padrão de algumas propriedades para os componentes, containers e<br />
projetos. Pode-se definir, por exemplo, o valor padrão para as cores de frente e fun<strong>do</strong> <strong>do</strong> componente Button.<br />
Dessa forma, cada Button novo inseri<strong>do</strong> no projeto irá utilizar essas configurações, desde que o projeto esteja<br />
configura<strong>do</strong> para utilizar a preferência criada.<br />
8.1. Crian<strong>do</strong> Preferências Gerais de Interface<br />
Para definir uma nova preferência de interface, siga os passos descritos abaixo.<br />
a. Acesse o menu Ferramentas, item Preferências. Você visualiza a janela Preferências - Editor.<br />
Pagina 106 de 129
Pagina 107 de 129<br />
Crian<strong>do</strong> uma preferência de interface<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
b. Na seção Preferências Gerais de Interface, clique no botão Novo.<br />
c. Na janela que abre, preencha o campo com o nome da nova preferência de interface.<br />
Definin<strong>do</strong> o nome da preferência de interface<br />
d. Clique no botão OK. Você visualiza a janela Preferências Gerais de Interface.
Configuran<strong>do</strong> a preferência de interface<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
e. Navegue pela lista à esquerda e selecione o item que deseja configurar. O item em questão pode ser o<br />
projeto, um tipo de container ou um componente.<br />
f. No espaço à direita serão apresentadas as propriedades que podem ser configuradas para o item seleciona<strong>do</strong>.<br />
Faça as alterações desejadas.<br />
g. Depois de configurar os propriedades de to<strong>do</strong>s os itens deseja<strong>do</strong>s, clique no botão Salvar.<br />
h. Clique no botão Fechar.<br />
Pagina 108 de 129
8.2. Definin<strong>do</strong> a Preferência Padrão para Novos Projetos<br />
Pagina 109 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Para definir a preferência de interface padrão utilizada pelos novos projetos cria<strong>do</strong>s no TotalCross Studio<br />
Community Edition, faça:<br />
a. Acesse o menu Ferramentas, item Preferências. Você visualiza a janela Preferências - Editor.<br />
Definin<strong>do</strong> a preferência de interface padrão para novos projetos<br />
b. Na seção Preferências Gerais de Interface, selecione no combo a preferência desejada.<br />
c. Clique no botão Fechar.<br />
8.2.1. Configuran<strong>do</strong> a Preferência para um Projeto Existente<br />
Para definir a preferência de interface que deve ser utilizada para um projeto existente, faça:<br />
a. Acesse a aba Projeto na perspectiva Designer.<br />
b. Selecione o projeto deseja<strong>do</strong>.<br />
c. No quadro Propriedades, na propriedade General UI Preferences, selecione a preferência desejada.
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
d. Os novos containers e componentes inseri<strong>do</strong>s no projeto irão utilizar as configurações da preferência de<br />
interface selecionada.<br />
8.2.2. Aplican<strong>do</strong> as Preferências de Interface em Projetos Existentes<br />
É possível aplicar as configurações de preferência de interface em um projeto existente onde já existam containers<br />
e componentes. Consideran<strong>do</strong> que os containers e componentes existentes possuam valores para as propriedades<br />
de interface diferentes <strong>do</strong>s valores configura<strong>do</strong>s na preferência que se deseja utilizar, é possível aplicar as configurações<br />
da preferência em massa nos containers/componentes existentes, ajustan<strong>do</strong>-os de forma fácil e rápida.<br />
Para isso, siga os passos abaixo:<br />
a. Acesse a aba Projeto, na perspectiva Designer.<br />
b. Selecione o projeto deseja<strong>do</strong>.<br />
c. No quadro Propriedades, na propriedade General UI Preferences, selecione a preferência desejada.<br />
d. Acesse o menu Ferramentas, item Preferências. Você visualiza a janela Preferências - Editor.<br />
Selecionan<strong>do</strong> a preferência desejada<br />
e. Na seção Preferências Gerais de Interface, selecione a preferência desejada.<br />
f. Clique no botão Editar. Você visualiza a janela Preferências Gerais da Interface.<br />
Pagina 110 de 129
g. Clique no botão Aplicar.<br />
h. Clique no botão Fechar.<br />
i. Feche a janela Preferências.<br />
Pagina 111 de 129<br />
Aplican<strong>do</strong> a preferência no projeto<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
8.2.3. Compartilhan<strong>do</strong> as Preferências Gerais de Interface<br />
É possível compartilhar essas definições para que mais de um desenvolve<strong>do</strong>r trabalhe em diferentes partes de um<br />
mesmo projeto seguin<strong>do</strong> o mesmo padrão de interface. Cada configuração salva é armazenada em um arquivo<br />
XML, que pode ser encontrada no diretório \.TKNMobile\Properties, cria<strong>do</strong> dentro <strong>do</strong> diretório <strong>do</strong> usuário da<br />
máquina.<br />
Exemplos:<br />
C:\Documents and Settings\user\.TCStudioCommunity\Properties\<br />
C:\Users\{nome_<strong>do</strong>_usuario}\.TCStudioCommunity\Properties\<br />
OBS: O caminho <strong>do</strong> diretório <strong>do</strong> usuário pode mudar conforme a versão <strong>do</strong> Win<strong>do</strong>ws utilizada.<br />
Para distribuir com outros desenvolve<strong>do</strong>res uma configuração salva, procure pelo XML o arquivo referente a esta<br />
configuração no diretório descrito acima.<br />
Para os desenvolve<strong>do</strong>res que recebem um arquivo XML de preferências, basta importá-lo no TotalCross Studio<br />
Community Edition. Para isso faça:<br />
a. Acesse o menu Ferramentas, item Preferências. Você visualiza a janela Preferências - Editor.
. Clique no botão Importar.<br />
c. Procure pelo arquivo XML da preferência.<br />
9. Perfil de Atributos Visuais<br />
Importan<strong>do</strong> uma preferência configurada<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Permite criar perfil de atributos visuais, que podem ser utiliza<strong>do</strong>s para configurar de forma rápida alguns atributos<br />
visuais de inúmeros componentes em um projeto. Veja os tópicos a seguir para maiores explicações sobre como<br />
criar e utilizar um perfil de atributos visuais.<br />
9.1. Crian<strong>do</strong> um Perfil de Atributos Visuais<br />
Podem ser cria<strong>do</strong>s quantos atributos visuais são deseja<strong>do</strong>s para cada projeto. A ideia básica é a de ser possível criar<br />
configurações visuais que serão comuns para inúmeros componentes em diferentes telas de um mesmo projeto.<br />
Para criar um perfil de atributos visuais, siga os passos abaixo.<br />
a. No quadro Projeto da perspectiva Designer, selecione o nome <strong>do</strong> projeto deseja<strong>do</strong>.<br />
Pagina 112 de 129
. Clique no menu Projeto, item Visual Attributes.<br />
c. Você visualiza a janela Editor de visual atribute.<br />
Pagina 113 de 129<br />
Menu Projeto, item Visual Attributes<br />
Configuran<strong>do</strong> um novo perfil de atributos visuais<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
d. Clique no ícone para criar um novo perfil. Você visualiza a janela Novo Visual Attribute.<br />
Especifican<strong>do</strong> o nome <strong>do</strong> novo perfil de atributos visuais<br />
e. Informe o campo:<br />
Nome <strong>do</strong> visual attribute: informe o nome <strong>do</strong> novo perfil.<br />
f. Clique no botão OK. Você visualiza a janela Editor de visual atribute com o novo perfil.
Novo perfil cria<strong>do</strong><br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
g. Expanda o perfil cria<strong>do</strong>. Existem três propriedades disponíveis para configuração.<br />
h. Selecione a propriedade que deseja configurar:<br />
Back Color: informe a cor de fun<strong>do</strong> <strong>do</strong> seu perfil de atributos visuais.<br />
Fore Color: informe a cor da fonte/bordas <strong>do</strong> seu perfil de atributos visuais.<br />
Font: informe a fonte, estilo e tamanho <strong>do</strong> seu perfil de atributos visuais<br />
i. Clique no botão Fechar.<br />
9.2. Utilizan<strong>do</strong> um Perfil de Atributos Visuais<br />
É possível utilizar um perfil de atributos visuais em qualquer componente disponível no TotalCross Studio<br />
Community Edition. Para isso siga os passos:<br />
a. Acesse a aba Projeto da perspectiva Designer.<br />
b. Selecione o componente deseja<strong>do</strong> de um container <strong>do</strong> projeto.<br />
c. Procure a propriedade Visual Att. no quadro Propriedades.<br />
d. Selecione o perfil de atributos visuais deseja<strong>do</strong>. Os perfis disponíveis correspondem aos cria<strong>do</strong>s para o<br />
projeto seleciona<strong>do</strong>. Para maiores informações acesse o tópico Crian<strong>do</strong> um Perfil de Atributos Visuais.<br />
Observe que as propriedades Back Color, Fore Color e Font <strong>do</strong>s componentes que estiverem utilizan<strong>do</strong> um perfil de<br />
atributos visuais ficam desabilitadas no quadro Propriedades. Para que as essas propriedades fiquem disponíveis,<br />
o componente seleciona<strong>do</strong> não pode estar utilizan<strong>do</strong> nenhum perfil de atributos visuais.<br />
To<strong>do</strong> componente que utiliza um perfil de atributos visuais mantêm vínculo com ele, ou seja, se você editar um<br />
perfil já utiliza<strong>do</strong>, imediatamente a alteração será refletida nos componentes que o utilizam.<br />
10. Configuran<strong>do</strong> Tooltip para um Componente<br />
Para configurar uma dica de contexto para um componente, siga os passos abaixo.<br />
Pagina 114 de 129
a. Acesse a aba Projeto da perspectiva Designer.<br />
b. Selecione um componente adiciona<strong>do</strong> em um container <strong>do</strong> projeto.<br />
c. No quadro Propriedades, localize a opção ToolTip.<br />
Pagina 115 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
d. Clique no botão . Você visualiza a janela Editor de ToolTip, aba Dica de Contexto.<br />
Editor de ToolTip - aba Dica de Contexto<br />
e. Preencha os campos:<br />
Texto: informe o texto exibi<strong>do</strong> na dica de contexto.<br />
f. Clique na aba Propriedades.<br />
g. Preencha os campos:<br />
Editor de ToolTip - aba Propriedades<br />
Fonte: clique no botão e selecione a fonte da dica de contexto.
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Cor <strong>do</strong> texto: clique no botão e selecione a cor <strong>do</strong> texto da dica de contexto.<br />
Cor de fun<strong>do</strong>: clique no botão e selecione a cor de fun<strong>do</strong> da dica de contexto.<br />
Cor de borda: clique no botão e selecione a cor da borda da dica de contexto.<br />
h. Clique na aba Outras Propriedades.<br />
Editor de ToolTip - aba Outras Propriedades<br />
i. Preencha os campos:<br />
Tempo de espera - abertura (ms): informe quanto tempo demora para exibir a dica de contexto.<br />
Tempo de espera - visualização (ms): informe por quanto tempo a dica de contexto deve ser<br />
exibida.<br />
11. Lista de Ações<br />
Lista de ações disponíveis que determinam o comportamento associa<strong>do</strong> aos botões ou menus <strong>do</strong> projeto. Para<br />
todas as ações pode-se configurar uma mensagem de confirmação de execução. Para maiores informações,<br />
consulte o tópico Personalizan<strong>do</strong> um Message Box.<br />
CLEAR<br />
Limpa os da<strong>do</strong>s preenchi<strong>do</strong>s nos campos de um formulário. Para maiores informações, consulte o tópico Tipos de<br />
Containers.<br />
CUSTOM<br />
Essa opção não executa nenhuma ação. Ela gera o escopo <strong>do</strong> méto<strong>do</strong> no código-fonte <strong>do</strong> projeto, fican<strong>do</strong> a cargo<br />
<strong>do</strong> desenvolve<strong>do</strong>r implementar a ação <strong>do</strong> méto<strong>do</strong>.<br />
EXIT<br />
Finaliza a aplicação. Esta ação pode ser atribuída a um botão inseri<strong>do</strong> em qualquer container.<br />
FILECHOOSER<br />
Abre uma janela para pesquisa de arquivos.<br />
NONE<br />
Pagina 116 de 129
Pagina 117 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Esta opção não executa nenhuma ação e nenhum código-fonte é gera<strong>do</strong>. Toda a implementação fica a cargo <strong>do</strong><br />
desenvolve<strong>do</strong>r.<br />
SWAP<br />
Permite navegar para outro container da aplicação. Sempre que for configurada a ação SWAP para um botão,<br />
deve-se também especificar o container destino da aplicação. Esta ação pode ser atribuída a um botão em qualquer<br />
container.<br />
11.1. Personalizan<strong>do</strong> um Message Box<br />
Todas as ações disponíveis para serem associadas aos botões podem exibir uma caixa de mensagem de aviso,<br />
assim como algumas ações que podem ser associadas aos menus de um projeto. Cada caixa de mensagem pode<br />
ser personalizada para ter aparência ou comportamento específicos. Veja a seguir como configurar uma caixa de<br />
mensagem para um botão.<br />
a. Selecione o componente Button deseja<strong>do</strong>.<br />
b. No quadro Propriedades, na propriedade Action, clique no botão . Você visualiza a janela Editor de<br />
Ação.<br />
Personalizan<strong>do</strong> uma caixa de mensagem<br />
c. No quadro Ações, selecione a ação desejada. Para maiores informações, consulte o tópico Lista de Ações.<br />
d. No quadro Propriedades, marque a opção Mostrar caixa de mensagem.<br />
e. Clique no botão . Você visualiza a janela Editor de Caixa de Mensagem, aba Mensagem.
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Personalizan<strong>do</strong> uma caixa de mensagem – configuran<strong>do</strong> a mensagem<br />
f. Informe os campos:<br />
Título: informe o título da caixa de mensagem.<br />
Mensagem: informe a mensagem exibida na caixa de mensagem.<br />
g. Clique na aba Propriedades.<br />
h. Informe os campos:<br />
Personalizan<strong>do</strong> uma caixa de mensagem - configuran<strong>do</strong> as propriedades<br />
Fonte: clique no botão e altere a fonte <strong>do</strong> texto.<br />
Pagina 118 de 129
Pagina 119 de 129<br />
Cor <strong>do</strong> texto: clique no botão e altere a cor padrão <strong>do</strong> texto.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Cor de fun<strong>do</strong>: clique no botão e altere a cor padrão de fun<strong>do</strong>.<br />
Abrir: Determina se a mensagem deverá aparecer antes ou depois da ação executada.<br />
i. Clique na aba Botões.<br />
Personalizan<strong>do</strong> uma caixa de mensagem- configuran<strong>do</strong> os botões<br />
j. Selecione o botão que deseja editar.<br />
k. Modifique os campos:<br />
Texto: informe o rótulo <strong>do</strong> botão.<br />
Ação: informe a ação para o botão.<br />
l. Clique no botão Aplicar.<br />
m. Clique no botão OK.<br />
11.2. Desabilitan<strong>do</strong> um Message Box<br />
Para desabilitar uma caixa de mensagem em um botão, siga os passos abaixo.<br />
a. Selecione o componente Button deseja<strong>do</strong>.<br />
b. No quadro Propriedades, na propriedade Action, clique no botão . Você visualiza a janela Editor de<br />
ação.
Desabilitan<strong>do</strong> uma caixa de mensagem<br />
c. No quadro Propriedades, desabilite o campo Mostrar caixa de mensagem.<br />
d. Clique no botão OK.<br />
12. Tamanho da Tela de Desenvolvimento<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
A tela de desenvolvimento é onde você visualiza o layout <strong>do</strong> projeto que está crian<strong>do</strong>. Para alterar o tamanho da<br />
tela utilizada em um projeto, siga os passos:<br />
a. Clique no menu Containers, item Redimensionar Containers.<br />
Menu Container, item Redimensionar containers...<br />
b. Você visualiza a janela Lista de Dispositivos Móveis, com o dispositivo um uso e sua resolução de tela.<br />
Pagina 120 de 129
Pagina 121 de 129<br />
Escolhen<strong>do</strong> o novo tamanho <strong>do</strong>s containers<br />
c. Selecione o dispositivo móvel com as dimensões de tela desejadas.<br />
d. Clique no botão Escolher.<br />
13. Internacionalizan<strong>do</strong> um Projeto<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
O TotalCross Studio Community Edition permite que sejam cria<strong>do</strong>s projetos internacionaliza<strong>do</strong>s. Atualmente,<br />
apenas os idiomas Português e Inglês são suporta<strong>do</strong>s. A internacionalização pode ser realizada nos seguintes itens:<br />
� Menu<br />
� Menu Item<br />
� Label<br />
� Button<br />
� Edit<br />
� CheckBox<br />
� Radio<br />
� MultiEdit<br />
� ColumnChart<br />
� PieChart<br />
� LineChart<br />
Para criar um projeto internacionaliza<strong>do</strong>, siga os passos abaixo.<br />
a. Acesse a aba Projeto da perspectiva Designer.<br />
b. Selecione o projeto deseja<strong>do</strong>.<br />
c. No quadro Propriedades, clique no botão na propriedade Default Locale e selecione a localidade<br />
padrão <strong>do</strong> projeto. Para maiores informações, consulte o tópico Propriedades <strong>do</strong> Projeto.
Habilitan<strong>do</strong> a internacionalização no projeto<br />
d. Selecione o componente deseja<strong>do</strong> em um container <strong>do</strong> projeto.<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
e. Quan<strong>do</strong> o Default Locale é escolhi<strong>do</strong>, a propriedade Text ganha um botão . Clique nele e você visualiza<br />
a janela Editor de Internacionalização.<br />
Configuran<strong>do</strong> o texto internacionaliza<strong>do</strong> de um componente<br />
f. No campo Localidades são apresentadas as opção de localidades disponíveis. Por padrão é selecionada a<br />
localidade definida na propriedade Default Locale <strong>do</strong> projeto.<br />
g. No quadro Propriedades são apresentadas as colunas:<br />
Nome: lista as propriedades que podem ser internacionalizadas.<br />
Valor: apresenta o valor atual para a propriedade correspondente.<br />
h. Altere o valor da propriedade Text como deseja<strong>do</strong>.<br />
i. Para configurar o valor da propriedade para outro idioma, altere a localidade no campo Localidades.<br />
j. O componente configura<strong>do</strong> utilizará o valor configura<strong>do</strong> nessa janela para a propriedade Text.<br />
k. Feche a janela.<br />
l. Realize os passos d à k para cada componente que deseja internacionalizar.<br />
14. Estrutura Gerada<br />
Acesse os tópicos abaixo para maiores informações sobre a estrutura gerada pelo TotalCross Studio Community<br />
Pagina 122 de 129
Edition para cada projeto desenvolvi<strong>do</strong>.<br />
14.1. Estrutura <strong>do</strong> Projeto<br />
Pagina 123 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
Para cada projeto é cria<strong>do</strong> um novo diretório com o próprio nome, no qual são armazena<strong>do</strong>s os diretórios e arquivos<br />
<strong>do</strong> projeto. Esses diretórios seguem a seguinte estrutura:<br />
dirProjeto<br />
|- .conf<br />
| |- metadata<br />
| |- sync<br />
| |- templates<br />
| |- ui<br />
| |- project.xml<br />
|- pdafiles<br />
| |- bin<br />
| |- dist<br />
| |- lib<br />
| |- resource<br />
| | | - forms.txt<br />
| | | - tables.txt<br />
| |- src<br />
|- serverfiles<br />
| |- dist<br />
| |- src<br />
|- .tknms_project<br />
Veja na tabela abaixo a descrição da estrutura acima.<br />
Diretório Descrição<br />
.conf Diretório onde são armazena<strong>do</strong>s os arquivos de configuração <strong>do</strong> projeto.<br />
metadata<br />
Diretório onde são armazena<strong>do</strong>s os metada<strong>do</strong>s de cada tabela criada/importada para o<br />
projeto.<br />
sync Diretório reserva<strong>do</strong> para futuras implementações.<br />
templates<br />
ui<br />
project.xml<br />
Diretório onde são armazena<strong>do</strong>s os templates de containers e configurações de atributos<br />
visuais cria<strong>do</strong>s para o projeto.<br />
Diretório onde são armazena<strong>do</strong>s os arquivos de configuração de to<strong>do</strong>s os containers e<br />
menus <strong>do</strong> projeto.<br />
Arquivo que armazena as configurações <strong>do</strong> projeto, como conexão com banco de da<strong>do</strong>s,<br />
configurações de log, etc.<br />
pdafiles Diretório onde são armazena<strong>do</strong>s os arquivos <strong>do</strong> projeto referentes aos dispositivos móveis.<br />
bin<br />
Diretório onde são armazena<strong>do</strong>s os arquivos da base de da<strong>do</strong>s local <strong>do</strong> projeto (arquivos <strong>do</strong><br />
Litebase), log de acesso ao banco de da<strong>do</strong>s local, scripts de importação de da<strong>do</strong>s e arquivos<br />
para executar a aplicação para testes.<br />
dist Diretório onde são cria<strong>do</strong>s os arquivos de instalação <strong>do</strong> projeto.<br />
lib<br />
Diretório onde podem ser coloca<strong>do</strong>s os arquivos .JAR necessários para executar a aplicação<br />
(apenas para executar).
esource<br />
forms.txt<br />
tables.txt<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
To<strong>do</strong>s os arquivos externos inseri<strong>do</strong>s no projeto, como imagens, devem ser posta<strong>do</strong>s nesse<br />
diretório para que sejam empacota<strong>do</strong>s junto no projeto.<br />
Arquivo de mapeamento entre as classes que representam os containers gera<strong>do</strong>s pela<br />
ferramenta e seus arquivos customizáveis.<br />
Arquivo de mapeamento entre as classes que representam as tabelas inseridas no projeto e<br />
seus arquivos customizáveis.<br />
src Diretório onde é gera<strong>do</strong> o código-fonte <strong>do</strong> projeto.<br />
serverfiles<br />
Diretório onde são armazena<strong>do</strong>s os arquivos <strong>do</strong> projeto referentes ao servi<strong>do</strong>r, quan<strong>do</strong> se<br />
trabalha com Web Services.<br />
dist Diretório onde são gera<strong>do</strong>s os arquivos de deploy <strong>do</strong> serviços gera<strong>do</strong>s pela ferramenta.<br />
src Diretório onde são gera<strong>do</strong>s os arquivos <strong>do</strong> código-fonte <strong>do</strong>s serviços.<br />
.tknms_project Arquivo de descrição <strong>do</strong> projeto.<br />
14.2. Compilan<strong>do</strong> e executan<strong>do</strong> o projeto<br />
Compilan<strong>do</strong><br />
Clique no menu Código, item Compilar Código. Você visualiza no quadro Saída o resulta<strong>do</strong> da compilação.<br />
Resulta<strong>do</strong> da compilação de um projeto<br />
Executan<strong>do</strong><br />
Clique no menu Código, item Executar aplicação móvel. Você visualiza a janela com o projeto executan<strong>do</strong>.<br />
Executan<strong>do</strong> um projeto<br />
Pagina 124 de 129
14.3. Código gera<strong>do</strong><br />
Pagina 125 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
O código gera<strong>do</strong> pelo TotalCross Studio Community Edition fica dividi<strong>do</strong> no diretório /pdafiles/src/ <strong>do</strong> projeto,<br />
onde estão organiza<strong>do</strong>s em classes de interface, de persistência e de código customizável, de acor<strong>do</strong> com diretórios<br />
a seguir:<br />
CUSTOM<br />
Diretório onde são geradas as classes que podem ter o código customiza<strong>do</strong> manualmente pelo desenvolve<strong>do</strong>r. Há<br />
duas divisões nesse diretório:<br />
� UI: Diretório onde são armazenadas as classes estendidas das classes de interface.<br />
� BO: Diretório onde são armazenadas as classes estendidas das classes de persistência.<br />
Qualquer alteração no código-fonte <strong>do</strong> projeto deve ser feito diretamente nas classes <strong>do</strong> diretório CUSTOM. Todas<br />
as classes, exceto as existentes dentro <strong>do</strong> diretório CUSTOM, são regeneradas toda vez que o código é compila<strong>do</strong><br />
no TotalCross Studio Community Edition.<br />
DAO<br />
Diretório onde são geradas as classes de acesso às tabelas <strong>do</strong> projeto.<br />
DTO<br />
Diretório onde são geradas as classes que representam a estrutura das tabelas <strong>do</strong> projeto.<br />
UI<br />
Diretório onde são geradas as classes da interface.<br />
O arquivo forms.txt, armazena<strong>do</strong> no diretório RESOURCE, é responsável pelo mapeamento entre as classes de<br />
interface com as classes customizáveis.<br />
15. Editan<strong>do</strong> o Código Gera<strong>do</strong><br />
É possível editar o código-fonte das classes customizáveis <strong>do</strong> projeto diretamente no TotalCross Studio Community<br />
Edition. Para editá-lo, siga os passos abaixo.<br />
a. Acesse a perspectiva Desenvolvimento.<br />
b. Acesse a aba Classes. Você visualiza os pacotes com as classes <strong>do</strong> projeto.
Quadro Classes<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
c. É possível visualizar a seguinte estrutura:<br />
user.ui – pacote com as classe de interface geradas automaticamente.<br />
user.custom.ui – pacote com as classes de interface customizáveis.<br />
d. Implemente o código deseja<strong>do</strong>. Lembre-se que só classes de interface customizáveis podem ser editadas.<br />
e. Salve as alterações realizadas.<br />
Alteran<strong>do</strong> os da<strong>do</strong>s <strong>do</strong> container<br />
Pagina 126 de 129
16. Implantan<strong>do</strong> o Projeto<br />
Para gerar os arquivos de implantação <strong>do</strong> projeto, siga os passos abaixo.<br />
Pagina 127 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
a. Clique no menu Ferramentas, item Deployment. Você visualiza a janela Configurações de Deployment.. .<br />
Tela de configuração de Deployment<br />
b. Clique em<br />
c. Em plataforma, seleciona a plataforma na qual o projeto será instala<strong>do</strong>.<br />
d. Dê um nome para essa configuração no campo ao la<strong>do</strong>.<br />
Configuran<strong>do</strong> a plataforma e atribuin<strong>do</strong> um nome à configuração
e. Configure as demais opções conforme a necessidade.<br />
f. Clique no botão Executar.<br />
17. Reportan<strong>do</strong> Bugs<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
O TotalCross Studio Community Edition permite que sejam reporta<strong>do</strong>s pelos usuários erros que possam vir a ser<br />
encontra<strong>do</strong>s na ferramenta, para que sejam corrigi<strong>do</strong>s.<br />
a. Acesse o menu Ajuda, item Reportar Erros. Você visualiza a janela TCStudioCommunity Reporte <strong>do</strong> erro.<br />
b. Informe o campo:<br />
De: preencha com seu e-mail.<br />
c. Clique no botão Enviar.<br />
Reportan<strong>do</strong> um erro<br />
Pagina 128 de 129
18. Lista de Palavras Reservadas<br />
Pagina 129 de 129<br />
TEKANN TECNOLOGIA DA INFORMAÇÃO LTDA.<br />
www.tekann.com.br<br />
A lista a seguir apresenta as palavras reservadas para o TotalCross Studio Community Edition.<br />
Palavras reservadas no TotalCross Studio Community Edition<br />
abstract else interface super<br />
assert enum long switch<br />
boolean extends native synchronized<br />
break false new this<br />
byte final null throw<br />
case finally package throws<br />
catch float private transient<br />
char for protected true<br />
class goto public try<br />
const if return void<br />
continue implements short volatile<br />
default import static while<br />
<strong>do</strong> instanceof strictfp<br />
<strong>do</strong>uble int string
Change language