Gerenciando eventos de componentes

Consulte também

A linguagem de programação Java usa eventos para ativar o comportamento do formulário de GUI. Objetos-fonte podem disparar eventos aos quais um ou mais objetos com ouvintes de eventos reagem através de manipuladores de eventos.

Definindo manipuladores de eventos

Você pode definir manipuladores de eventos usando a folha de propriedade do componente ou o menu contextual. Pode também definir um manipulador de eventos usando o assistente Conexão.

Para definir um manipulador de eventos usando a folha de propriedade:

  1. Selecione o componente na janela Inspetor.
  2. Clique no botão Eventos no alto da janela Propriedades.
  3. Clique no valor do evento desejado na lista. Inicialmente, o valor para todos os eventos é <none>. Quando você clica no campo de valor, <none> é substituído automaticamente pelo nome padrão do evento.
  4. Abra a caixa de diálogo Manipuladores clicando no botão de reticências (...) do evento.
  5. Insira o nome do manipulador do evento clicando no botão Adicionar para adicionar o novo nome à lista de manipuladores. Clique em OK.

    O código para o ouvinte e o corpo vazio do método do manipulador é gerado.

Para definir um manipulador de eventos usando o menu contextual:

  1. Clique com o botão direito do mouse em um componente de formulário na janela Arquivos, Projeto ou Inspetor.
  2. Escolha Eventos no menu contextual e nos submenus deste. Itens de menu em negrito nos submenus de Eventos indicam que manipuladores de eventos já estão definidos.

    O código para o ouvinte e o corpo vazio do método do manipulador é gerado. O nome padrão é atribuído ao manipulador de eventos.

  3. Adicione o código para o novo manipulador de eventos no Editor de código.

Adicionando múltiplos manipuladores para um evento

  1. Na janela Inspetor, selecione o componente ao qual você deseja adicionar múltiplos manipuladores.
  2. Clique no botão Eventos no alto da janela Propriedades.
  3. Selecione o evento na folha de propriedade e clique no botão de reticências (...) para exibir a caixa de diálogo Manipuladores. Repita estas etapas para adicionar manipuladores de eventos adicionais.

Removendo manipuladores de eventos

  1. Na janela Inspetor, selecione o componente cujo manipulador de eventos você deseja remover.
  2. Clique no botão Eventos no alto da janela Propriedades.
  3. Selecione o evento na folha de propriedade e clique no botão de reticências (...) para exibir a caixa de diálogo Manipuladores. Como alternativa, você pode simplesmente excluir o nome do manipulador que deseja remover na janela Propriedades.
  4. Na caixa de diálogo Manipuladores, selecione o manipulador a ser removido da lista e clique em Remover.

Quando você remove um manipulador de eventos, o bloco de códigos correspondente também é excluído. Se mais de um manipulador usar o mesmo nome e o mesmo bloco de código, a exclusão de uma única referência ao código não exclui o código em si. Somente a exclusão de todas as referências excluirá o bloco de código correspondente, e primeiro será exibida uma caixa de diálogo de confirmação.

Para obter mais informações sobre como manipular eventos no programa, inclusive informações sobre o modelo de evento de Java, consulte o tutorial Creating a GUI with JFC/Swing em:

Consulte também
Configurando eventos com o assistente para conexão
Editando propriedades de componente
Modificando o código-fonte de GUI

Notificações legais