corner imagecorner image
FeaturesPluginsDocs & 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 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

O conteúdo desta página se aplica ao IDE NetBeans 6.1, 6.5 e 6.7

Requisitos

Para concluir este tutorial, você precisa dos seguintes recursos e softwares:

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

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:

  1. Faça o download do arquivo TableItem.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 Projeto. 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 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.
  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.

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. Atribua Modelo de tabela simples a um componente Item de tabela
  5. Edite o design de Modelo de tabela simples
  6. Adicione comandos aos componentes Formulário e Caixa de texto
  7. Conecte os componentes para criar um fluxo de aplicativo
  8. Insira uma pré-ação no código-fonte
  9. 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. Clique duas vezes no componente form1 para alterar para a janela Designer de tela.
  3. 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:

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

  4. Clique em tableItem1 e, na janela Propriedades, digite TableItem Example na propriedade Rótulo.
  5. Selecione textBox1 e altere o título do componente para "Editar".
  6. 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

  1. Selecione o componente tableItem1 na visualização Tela.
  2. 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.

    Mostra a tela do dispositivo com a grade Modelo de tabela simples dentro de Item de tabela

Editando Modelo de tabela simples

  1. Clique duas vezes no componente tableItem1 (Designer de tela) para abrir a janela Editor do modelo de tabela.
  2. Na janela Editor do modelo de tabela, altere o número de linhas e colunas para 4.
  3. Marque a opção Usar cabeçalhos.
  4. Renomeie os cabeçalhos da tabela com "coluna 1", "coluna 2", "coluna 3" e "coluna 4".
  5. Clique em OK para terminar.

    Mostra o diagrama de edição do Modelo de tabela

Adicionando comandos aos componentes Formulário e Caixa de texto

  1. Abra a janela de fluxo.
  2. 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.
  3. Escolha itemCommand1[Command] no Designer de tela. Na janela Propriedades, altere o valor da propriedade Rótulo para "Editar célula".

    Mostra o Designer de tela com os comandos atribuídos

  4. Escolha o comando OK na seção Comandos da Paleta do componente e arraste-o e solte no componente texBox1.

Conectando componentes

  1. 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.

    Mostra a janela Fluxo com componentes conectados pelas linhas de comando

Inserindo uma pré-ação no código-fonte

  1. Alterne para a janela Código-fonte.
  2. 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(); 
         
  3. 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

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

  1. Escolha Ajuda > Referências a Javadoc > Componentes MIDP do NetBeans.
  2. Clique em org.netbeans.microedition.lcdui para ver os links das informações do componente.

Tutoriais adicionais sobre componentes personalizados do NetBeans Java ME