corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

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

O conteúdo desta página se aplica ao IDE NetBeans 6.9 ou 7.0

Para concluir este tutorial, são necessários os seguintes recursos e softwares:

Software ou recurso Versão necessária
NetBeans IDE com Java ME Versão 6.9 ou superior
Java Development Kit (JDK) Versão 6

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:

  1. Faça o download do arquivo TableItemExample.zip.
  2. Descompacte o arquivo.
  3. No IDE, escolha Arquivo > Abrir projeto e vá para a pasta que contém o arquivo descompactado.
  4. Abra a janela Projetos. Ela deve ser parecida com o seguinte:

    Janela Projeto com o exemplo do Item de tabela

  5. 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.
  6. Na janela Emulador, clique no botão abaixo de "Iniciar." O emulador exibe uma tabela, conforme mostrado:

    O emulador DefaultColorPhone exibindo a amostra do aplicativo de tabela

  7. 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.
  8. 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:

  1. Crie o projeto MyTableExample
  2. Adicione os pacotes e um MIDlet visual ao projeto MyTableExample
  3. Adicione os componentes a MyTableMidlet
  4. Edite o design de SimpleTableModel
  5. Adicione comandos aos componentes Formulário e Caixa de texto
  6. Conectar os componentes para criar um fluxo de aplicativo
  7. Inserindo código-fonte
  8. Executar o projeto

Criando o projeto MyTableExample

  1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Em Categorias, selecione Java ME. Em Projetos, selecione Aplicativo móvel e clique em Próximo.
  2. 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.
  3. Desmarque a caixa de verificação Criar Hello MIDlet. Clique em Próximo.
  4. 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

  1. 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.
  2. Insira tableitemexample no campo Nome do pacote. Clique em Terminar.
  3. 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.
  4. Indique MyTableItemMidlet nos campos Nome do MIDlet e Nome da classe MIDP. Clique em Terminar.

Adicione os componentes a MyTableItemMidlet

  1. 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
  2. Selecione textBox e altere o título do componente para Editar.
  3. Clique duas vezes no componente form para alterar para a visualização Tela.
  4. 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:

    Mostra o Designer de tela com o Item de tabela na tela do dispositivo

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

Editando Modelo de tabela simples

  1. Na visualização Tela, clique duas vezes no componente <No table model specified> para abrir a caixa de diálogo Valores.
  2. Na caixa de diálogo Valores, marque a opção Utilizar cabeçalho.
  3. Clique nos botões Adicionar linha e Adicionar coluna quatro vezes respectivamente para alterar o número de linhas e colunas para 4.
  4. Renomeie os cabeçalhos da tabela com coluna 1, coluna 2, coluna 3 e coluna 4.
  5. Modelo de tabela

  6. Clique em OK para terminar.
  7. Modelo de tabela simples atribuído ao componente TableItem

Adicionando comandos aos componentes Formulário e Caixa de texto

  1. Abra a visualização Fluxo.
  2. 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.
  3. Escolha itemCommand na visualização Tela. Na janela Propriedades, altere o valor da propriedade Rótulo para Editar célula.
  4. Na visualização Fluxo, escolha o comando OK na seção Comandos da Paleta de componentes, e arraste e solte-o no componente texBox.
  5. Mostra a visualização Fluxo com comandos adicionados

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.

Mostra a janela Fluxo com componentes conectados

Inserindo código-fonte

  1. Alterne para a visualização Código-fonte.
  2. 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("");
            } 
  3. Clique no marcador de erros (marcador de erro) da linha 207 e escolha a opção Criar comando Campo no tableitemexample.MyTableItemMidlet no menu pop-up, conforme ilustrado na figura a seguir.
  4. Modificando o código-fonte

  5. 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:

  1. 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.
  2. Clique em Mostrar documentação no ícone do navegador da Web externo (Mostrar documentação no 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