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 você é novo no desenvolvimento de aplicativos móveis no NetBeans, deveria começar pelo Guia de início rápido do NetBeans Java ME MIDP antes de continuar.
Nota: se estiver utilizando o NetBeans IDE 6.8, consulte o tutorial Usando itens de tabela nos aplicativos Java ME no NetBeans IDE 6.8.
Conteúdo
Para concluir este tutorial, são necessários os seguintes recursos e softwares:
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 TableItemExample.zip.
- Descompacte o arquivo.
- No IDE, escolha Arquivo > Abrir projeto e vá para a pasta que contém o arquivo descompactado.
- Abra a janela Projetos. 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 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.
início
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
- Edite o design de SimpleTableModel
- Adicione comandos aos componentes Formulário e Caixa de texto
- Conectar os componentes para criar um fluxo de aplicativo
- Inserindo 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
- Selecione textBox e altere o título do componente para Editar.
- Clique duas vezes no componente form para alterar para a visualização Tela.
- Arraste componente Item de tabela na seção Itens da Paleta de componentes e solte-o no form. O componente Item de tabela tem a aparência seguinte quando é adicionado ao Designer de tela:

- Selecione tableItem e, na janela Propriedades, digite
TableItem Example no valor da propriedade Rótulo.
- Clique com o botão direito do mouse no componente tableItem e escolha Propriedades no menu pop-up.
- Clique na seta (
) na propriedade Modelo de tabela e escolha <New SimpleTableModel> na lista suspensa.
- Clique em Fechar.
O componente simpleTableModel é adicionado a Recursos.

Editando Modelo de tabela simples
- Na visualização Tela, clique duas vezes no componente <No table model specified> para abrir a caixa de diálogo Valores.
- Na caixa de diálogo Valores, marque a opção Utilizar cabeçalho.
- Clique nos botões Adicionar linha e Adicionar coluna quatro vezes respectivamente para alterar o número de linhas e colunas para 4.
- 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 visualização Fluxo.
- Escolha Comando Sair na seção Comandos da Paleta de componentes. Arraste e solte-o na janela no componente form. Repita esta ação para o comando do item.
- Escolha itemCommand na visualização Tela. Na janela Propriedades, altere o valor da propriedade Rótulo para Editar célula.
- Na visualização Fluxo, escolha o comando OK na seção Comandos da Paleta de componentes, e arraste e solte-o no componente texBox.
Conectando componentes
Na visualização Fluxo, clique no texto Iniciado no dispositivo móvel e arraste-o para o componente form. Da mesma forma, conecte os componentes como mostrado no gráfico seguinte.

Inserindo código-fonte
- Alterne para a visualização Código-fonte.
- Localize o método getOkCommand no código-fonte (linha 198) e insira o seguinte código depois de okCommand = new Command("Ok", Command.OK, 0);, onde se lê // write post-init user code here (escrever aqui o código do usuário para pós-inicialização):
} else if (command == itemCommand) {
/* This part of the code is responsible for
* getting value from the table model
*/
if (textBox != null) {
// Get position of the cursor in the table.
int row = tableItem.getSelectedCellRow();
int column = tableItem.getSelectedCellColumn() ;
// Get value from the table model
Object value = simpleTableModel.getValue(column,row);
// Set textBox string value
if (value != null)
textBox.setString(value.toString());
else
textBox.setString("");
}
- Clique no marcador de erros (
) da linha 207 e escolha a opção Criar comando Campo no tableitemexample.MyTableItemMidlet no menu pop-up, conforme ilustrado na figura a seguir.

- Localize o método getItemCommand no código-fonte (linha 189) e insira o seguinte código depois de itemCommand = new Command("Edit Cell", Command.ITEM, 0);, onde se lê // write post-init user code here (escrever aqui o código do usuário para pós-inicialização):
/* Esta parte do código é responsável por
* obter o valor do modelo de tabela
*/
if (textBox != null) {
// Obter a posição do cursor na tabela.
int row = tableItem.getSelectedCellRow();
int column = tableItem.getSelectedCellColumn();
// Get value from the table model
Object value = simpleTableModel.getValue(column,row);
// Set textBox string value
if (value != null)
textBox.setString(value.toString());
else
textBox.setString("");
}
Executando o projeto
Pressione F6 para executar o projeto principal. Como alternativa, você pode selecionar Executar > Executar projeto principal.
início
Javadoc para os componentes Item de tabela e Modelo de tabela simples
O NetBeans IDE oferece Javadocs da API 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 TableItem ou TableModel, complete a etapas abaixo:
- Coloque o cursor no componente TableItem ou TableModel e pressione Ctrl-Shift-Barra de espaço (ou escolha Código-fonte > Mostrar documentação).
O Javadoc para este elemento é exibido em uma janela suspensa.
- Clique em Mostrar documentação no ícone do navegador da Web externo (
) na janela pop-up para visualizar informações detalhadas sobre o componente TableItem ou TableModel no seu navegador.
início
Veja também
início