Siga as etapas seguintes para instalar o aplicativo de amostra waitscreensample:

1. Faça download de WaitScreenExample.zip.
2. Descompacte o arquivo.
3. No IDE, escolha Arquivo > Abrir projeto e vá para a pasta que contém o arquivo descompactado.
4. Clique em Abrir projeto.
   A visualização Projeto deve ter uma aparência semelhante a seguinte:



5. Na janela Projetos, clique com o botão direito do mouse no nó do projeto e escolha Executar (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 o endereço URL do website do NetBeans:: http://netbeans.org.
7. Clique no botão abaixo de "OK." A tela pergunta se está de acordo em usar tempo de conexão.
8. Clique no botão "Sim" abaixo para continuar. Quando o emulador tenta se conectar ao site, ele exibe a Tela de espera.

   

9. Após o emulador se conectar, feche o aplicativo.

Agora que você viu o componente Tela de espera em ação, vamos voltar para o início e criar este aplicativo. Para criar o aplicativo, faça o seguinte:

1. Crie o projeto WaitScreenExample
2. Adicione pacotes e um Visual MIDlet ao projeto MyWaitScreen
3. Adicione componentes ao MyWaitScreenMIDlet
4. Adicione recursos de imagem
5. Adicione os comandos OK, Voltar e Sair nos componentes Caixa de texto e Tela de espera
6. Criar o fluxo do aplicativo
7. Crie uma tarefa em segundo plano para a Tela de espera
8. Executar o projeto

Nota: antes de criar este projeto, certifique-se de que o projeto WaitScreenExample executado nas etapas acima esteja fechado ou tenha sido excluído. O NetBeans IDE não permite que projetos identicamente nomeados sejam abertos ao mesmo tempo.

Criando o projeto WaitScreenExample

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. Insira WaitScreenExample no campo Nome do projeto. Altere a Localização do projeto para um diretório em seu sistema. Este diretório denomina-se $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 do emulador selecionada. Clique em Terminar.

Adicionando pacotes em um Visual MIDlet ao projeto WaitScreenExample

1. Escolha o projeto WaitScreenExample na janela Projetos e, a seguir, escolha Arquivo > Novo arquivo (Ctrl-N). Em Categorias, selecione Java. Em Tipos de arquivo, selecione Pacote Java. Clique em Próximo.
2. Insira waitscreenexample no campo Nome do pacote. Clique em Terminar.
3. Escolha o pacote waitscreenexample na janela Projetos e, a seguir, escolha Novo > Novo arquivo (Ctrl-N). Em Categorias, selecione MIDP. Em Tipos de arquivo, selecione MIDlet visual. Clique em Próximo.
4. Insira MyWaitScreenMidlet nos campos Nome MIDlet e Nome da classe MIDP. Clique em Terminar.

Adicionando componentes ao MyWaitScreenMidlet

Selecionando o Visual MIDlet abre o Visual Mobile Designer (VMD). Ao clicar na visualização Fluxo na parte superior da janela VMD, o Designer de fluxo se abre, onde você projeta o fluxo do aplicativo.

1. Alterne seu Visual MIDlet para a visualização Fluxo. Arraste os seguintes componentes Tela da paleta de componentes e solte-os no Designer de fluxo:
• Caixa de texto
• Tela de espera
• Lista
• Alerta
2. Escolha textBox. Na janela Propriedades (abaixo da paleta de componentes), altere a propriedade Título para Caixa de texto.
3. Use o mesmo processo para alterar os títulos dos seguintes componentes:
   • Altere waitScreen para Tela de espera
   • Altere list para Lista
   • Altere alert para Alerta
4. Use os valores das propriedades em cada um dos componentes seguintes:
   • Altere a propriedade Texto de textBox para http://netbeans.org
   • Altere a propriedade String de alert para Falha de conexão
   • Altere a propriedade Texto de WaitScreen para Aguarde...

A visualização Fluxo deve se parecer com a seguinte imagem:

Adicionando recursos de imagem

Nesta seção, você adiciona imagens que são usadas pela Tela de espera e pela Tela de alerta.

1. Faça o download e copie os arquivos alert.png e sandglass.png na pasta $PROJECTHOME/src/waitscreenexample.
2. Clique com o botão direito do mouse no componente alert e escolha Propriedades no menu pop-up.
3. Na caixa de diálogo Propriedades, clique no botão de reticências () na propriedade Imagem.
4. Na caixa de diálogo Imagem, clique em Adicionar.
   O componente image1 é adicionado.
5. Clique em Procurar e, na caixa de diálogo Abrir, especifique o caminho para o arquivo alert.png copiado.
6. Clique em Abrir.
   A imagem é adicionada.
7. Clique em OK para fechar a caixa de diálogo Imagem.
8. Clique em Fechar para sair da caixa de diálogo Propriedades.
   A imagem alert.png está vinculada ao componente alert.
9. Repita as etapas de 2 a 8 do componente waitScreen, adicione andglass.png como image2, e vincule-a ao componente.

Adicionando os comandos OK, Voltar e Sair nos componentes Caixa de texto e Tela de espera

1. Escolha o comando OK na seção Comandos da Paleta. Arraste e solte-o em textBox.
2. Escolha o comando Voltar na seção Comandos da Paleta. Arraste e solte-o em list.
3. Escolha o comando Sair na seção Comandos da Paleta. Arraste e solte-o em list.

Criando o fluxo do aplicativo

Agora você está pronto para criar o fluxo do aplicativo.

1. Na visualização Fluxo, clique no texto Iniciado no dispositivo móvel e arraste-o para o componente textBox.
2. Da mesma forma, conecte os componentes como mostrado no gráfico seguinte.

   Tela do Designer de fluxo conectada da seguinte forma: dispositivo móvel ao textBox1 ao waitScreen1 ao list ao MobileDevice.

Criando uma tarefa em segundo plano para a Tela de espera

1. Na visualização Fluxo, clique com o botão direito do mouse no componente waitScreen e escolha Propriedades no menu pop-up.
2. Na caixa de diálogo Propriedades, escolha <NewCancellableTask> no menu suspenso Tarefa e clique em Fechar.
   simpleCancellableTask é agora uma tarefa em segundo plano do componente waitScreen.
3. Clique no botão Código-fonte na parte superior Visual Mobile Designer para passar para o código-fonte do aplicativo.
4. Adicione um método da tarefa em segundo plano ao colar o seguinte código no código-fonte MyWaitScreenMIDlet após public void destroyapp(boolean unconditional) { }:

      private void getServerInfo() throws IOException {
      String url = textBox.getString();
      list.deleteAll();
      /**
      * Open an HttpConnection
      */ 
      HttpConnection hc = (HttpConnection) Connector.open(url);

      /**
      * Gets a header field key and header field by index and
      * insert it into list.
      */
      list.setTitle(hc.getURL());   
      for (int i=0;hc.getHeaderFieldKey(i)!=null; i++){
      list.insert(i,hc.getHeaderFieldKey(i)+" :"+hc.getHeaderField(i),null);       
      }     
      /**
      * Closing time ...
      */
      hc.close();
      } 

5. Clique com o botão direito do mouse no código-fonte e escolha Corrigir importações no menu pop-up (como alternativa, pressione Ctrl+Shift+I).
6. Localize a string public class MyWaitScreenMidlet extends MIDlet implements CommandListener { (linha 18) e insira final de modo que fique:

 public final class MyWaitScreenMidlet extends MIDlet implements CommandListener {

7. Localize o método public MyWaitScreenMidlet() no código-fonte (linha 38) e insira o código a seguir depois de public MyWaitScreenMidlet() {:

 List list1 = getList();

8. Clique em Tela para passar para a visualização Tela e selecione SimpleCancellableTask.
9. Na janela Propriedades, clique no botão de reticências () na propriedade Código executável.
10. Clique em Ir para o código na caixa de diálogo Código executável.
    
11. Localize o método getSimpleCancellableTask() no código-fonte (linha 328) e insira o código a seguir depois de public void execute() throws Exception {, onde se lê // write task-execution user code here (escrever aqui o código do usuário para execução de tarefa):

 getServerInfo();

Executando o projeto

Pressione F6 para executar o projeto principal.

Como alternativa, você pode selecionar Executar > Executar projeto principal.

Javadoc para os componentes Tela de espera e Tarefa cancelável simples

O NetBeans IDE oferece Javadocs da API para os componentes WaitScreen e SimpleCancellableTask, bem como para outros componentes que podem ser usados no VMD. Para ler os Javadocs dos componentes WaitScreen e SimpleCancellableTask, complete a etapas abaixo:

1. Coloque o cursor no componente WaitScreen ou SimpleCancellableTask 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 () na janela pop-up para visualizar informações detalhadas sobre o componente WaitScreen ou SimpleCancellableTask no seu navegador.