Componentes personalizados do Visual Mobile Designer: Usando itens de tabela em aplicativos Java ME
O Visual Mobile Designer (VMD) permite criar aplicativos Java ME usando componentes de arrastar e soltar. Com ele, você pode determinar o fluxo do aplicativo, bem como a aparência e funcionalidade da IU usando os componentes fornecidos pelo IDE ou usando componentes criados por você. O VMD contém muitos componentes padrão que você pode usar para criar seu aplicativo: Listas, Alertas, Formulários, Imagens, etc. Também inclui componentes personalizados que simplificam a criação de recursos mais complexos, tais como telas de espera, telas de splash, itens de tabela, etc.
O componente Item de tabela permite criar rapidamente tabelas formadas por uma ou mais colunas, cada uma com área de cabeçalho e área de dados que se repetem em cada registro. A tabela pode ser maior que a tela tanto vertical quanto horizontalmente. Os usuários podem usar um cursor para rolar em ambas as direções. A utilização do componente Item de tabela do Visual Mobile Designer (VMD) simplifica a criação e implementação de tabelas de dados no aplicativo Java ME.
Se ainda não estiver familiarizado com o desenvolvimento de aplicativos móveis no NetBeans, antes de continuar seria recomendável ler o Guia de início rápido do NetBeans Java ME MIDP.
Conteúdo
Requisitos
Para concluir este tutorial, você precisa dos seguintes recursos e softwares:
Introdução: Como funciona o componente Item de tabela
Este exemplo mostra como usar os componentes Item de tabela e Modelo de tabela em um aplicativo móvel. Demonstra os recursos básicos dos componentes e também como usá-los para visualizar e manipular os dados em seu aplicativo Java ME dentro do componente Modelo de tabela simples. O componente TableItem personalizado discutido neste tutorial usa uma tabela da interface de Modelo de tabela simples, exibe os dados e permite inclusive que o usuário edite os dados.
Além do componente Item de tabela personalizado, precisamos usar dois outros componentes MIDP: Caixa de texto e Formulário. Para saber mais sobre esse e outros componentes incluídos na paleta do VMD, consulte o Guia da paleta do Visual Mobile Designer
Instalando e executando o aplicativo de amostra
Antes de começar, talvez você queira ver o resultado final do
tutorial. Siga as etapas seguintes para instalar o aplicativo de amostra tableitemexample:
- Faça o download do arquivo TableItem.zip.
- Descompacte o arquivo.
- No IDE, escolha Arquivo > Abrir projeto e vá para a pasta que contém o arquivo descompactado.
- Abra a janela Projeto. Ela deve ser parecida com o seguinte:

- Na janela Projetos, clique com o botão direito do mouse no nó do projeto e escolha Executar projeto (ou pressione a tecla F6). Conforme o aplicativo é executado, uma janela do emulador se abre e exibe o aplicativo que está sendo executado no emulador do dispositivo padrão.
- Na janela Emulador, clique no botão abaixo de
"Iniciar." O emulador exibe uma tabela, conforme mostrado:
- Edite a tabela:
- Mova o cursor de uma célula a outra usando as setas direcionais do botão Selecionar.
- Clique no botão abaixo de "Editar célula" para editar o conteúdo de uma célula.
- Clique no botão abaixo de "Sair" para fechar o aplicativo.
Criando uma tabela com um componente Item de tabela personalizado
Agora que você viu o componente Item de tabela em ação, podemos mostrar como criar esse aplicativo. Para criar o aplicativo, faça o seguinte:
- Crie o projeto MyTableExample
- Adicione os pacotes e um MIDlet visual ao projeto MyTableExample
- Adicione os componentes a MyTableMidlet
- Atribua Modelo de tabela simples a um componente Item de tabela
- Edite o design de Modelo de tabela simples
- Adicione comandos aos componentes Formulário e Caixa de texto
- Conecte os
componentes para criar um fluxo de aplicativo
- Insira uma pré-ação no código-fonte
- Executar o projeto
Criando o projeto MyTableExample
- Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Em Categorias, selecione Java ME. Em Projetos, selecione Aplicativo móvel e clique em Próximo.
- Indique
MyTableExample no campo Nome do projeto. Altere a Localização do projeto para um diretório em seu sistema. A partir de agora, podemos chamar este diretório de $PROJECTHOME.
- Desmarque a caixa de verificação Criar Hello MIDlet. Clique em Próximo.
- Deixe o Sun Java Wireless Toolkit 2.5.2 como a Plataforma de emulador selecionada. Clique em Terminar.
Adicionando pacotes e um
MIDlet visual ao projeto MyTableExample
- Escolha o projeto
MyTableExample na janela Projeto, em seguida, escolha Arquivo > Novo arquivo (Ctrl-N) . Em Categorias, selecione Java. Em Tipos de arquivo,
selecione Pacote Java. Clique em Próximo.
- Insira
tableitemexample no campo Nome do pacote. Clique em Terminar.
- Escolha o pacote
tableitemexample na janela Projeto, em seguida, escolha Arquivo > Novo arquivo (Ctrl-N). Em Categorias, selecione MIDP. Em Tipos de arquivo, selecione
MIDlet visual. Clique em Próximo.
- Indique
MyTableItemMidlet nos campos Nome do MIDlet e Nome da classe MIDP. Clique em Terminar.
Adicione os componentes a MyTableItemMidlet
- Alterne seu MIDlet visual para a visualização Fluxo. Arraste os componentes Tela seguintes da paleta e solte-os no Designer de fluxo:
-
Formulário
-
Caixa de texto
- Clique duas vezes no componente form1 para alterar para a janela Designer de tela.
- Arraste componente Item de tabela na seção Itens do formulário da Paleta e arraste e solte-o no form1. O componente Item de tabela tem a aparência seguinte quando é adicionado ao Designer de tela:

- Clique em tableItem1 e, na janela Propriedades, digite
TableItem Example na propriedade Rótulo.
- Selecione textBox1 e altere o título do componente para "Editar"
.
- Clique com o botão direito na pasta Recursos e escolha Adicionar > Modelo de tabela simples.
Atribuindo Modelo de tabela simples a um componente Item de tabela
- Selecione o componente tableItem1 na visualização Tela.
- Na janela Propriedades, clique na propriedade Modelo de tabela e escolha simpleTableModel1 na lista. Agora você pode ver uma grade da tabela dentro do componente Item de tabela.
Editando Modelo de tabela simples
- Clique duas vezes no componente tableItem1 (Designer de tela) para abrir a janela Editor do modelo de tabela.
- Na janela Editor do modelo de tabela, altere o número de linhas e colunas para 4.
- Marque a opção Usar cabeçalhos.
- Renomeie os cabeçalhos da tabela com "coluna 1", "coluna 2", "coluna 3" e "coluna 4".
- Clique em OK para terminar.
Adicionando comandos aos componentes Formulário e Caixa de texto
- Abra a janela de fluxo.
- Escolha o comando Sair na seção
Comandos da Paleta do componente. Arraste-o e solte na janela Fluxo (componente form1). Repita esta ação para o comando do item.
- Escolha itemCommand1[Command] no Designer de tela. Na janela Propriedades, altere o valor da propriedade Rótulo para "Editar célula".
- Escolha o comando OK na seção Comandos da Paleta do componente e arraste-o e solte no componente texBox1.
Conectando componentes
- Na janela Design de fluxo, clique em Ponto de início no Dispositivo móvel e arraste-o para o componente form1. Da mesma
forma, conecte os componentes como mostrado no gráfico seguinte.

Inserindo uma pré-ação no
código-fonte
- Alterne para a janela Código-fonte.
- Localize o método commandAction no código-fonte: Inserir o código seguinte na seção de pré-ação de okCommand1 (logo após:
if (command == okCommand1) {, onde se lê //inserir código de pré-ação aqui):
/* Esta parte do código é responsável por
* salvar os valores no modelo de tabela
*/
// Obter a posição do cursor na tabela
int row = tableItem1.getSelectedCellRow();
int column = tableItem1.getSelectedCellColumn();
// Definir o novo valor do modelo de tabela
simpleTableModel1.setValue(column,row,textBox1.getString());
// Redesenhar o modelo de tabela no dispositivo de tela
simpleTableModel1.fireTableModelChanged();
-
Insira o código seguinte na seção de pré-ação de itemCommand1 (logo após:
} else if (command == itemCommand1) {, onde se lê //inserir código de pré-ação aqui):
/* Esta parte do código é responsável por
* obter o valor do modelo de tabela
*/
if (textBox1 != null) {
// Obter a posição do cursor na tabela.
int row = tableItem1.getSelectedCellRow();
int column = tableItem1.getSelectedCellColumn()
// Obter o valor do modelo de tabela
Object value = simpleTableModel1.getValue(column,row);
// Definir o valor da string de textBox
if (value != null)
textBox1.setString(value.toString());
else
textBox1.setString("");
}
Executando o projeto
-
Pressione <F6> para executar o projeto principal.
Como alternativa, você pode selecionar Executar > Executar projeto principal.
Para saber mais sobre os componentes Item de tabela e Modelo de tabela simples
O NetBeans IDE oferece documentação da API (javadocs) para os componentes Item de tabela e Modelo de tabela simples, bem como para outros componentes que podem ser usados no VMD. Para ler os javadocs dos componentes Item de tabela e Modelo de tabela:
- Escolha Ajuda > Referências a Javadoc > Componentes MIDP do NetBeans.
- Clique em
org.netbeans.microedition.lcdui para ver os links das informações do componente.
Tutoriais adicionais sobre componentes personalizados do NetBeans Java ME