AWT Choice Class

Introdução

O controle de escolha é usado para mostrar o menu pop-up de opções. A escolha selecionada é mostrada no topo do menu.

Declaração de classe

A seguir está a declaração para java.awt.Choice classe:

public class Choice
   extends Component
      implements ItemSelectable, Accessible

Construtores de classe

SNConstrutor e descrição
1

Choice() ()

Cria um novo menu de opções.

Métodos de aula

SNMétodo e Descrição
1

void add(String item)

Adiciona um item a este menu de escolha.

2

void addItem(String item)

Obsoleto na plataforma Java 2 v1.1.

3

void addItemListener(ItemListener l)

Adiciona o listener de item especificado para receber eventos de item deste menu Choice.

4

void addNotify()

Cria o par da Choice.

5

int countItems()

Descontinuada. A partir do JDK versão 1.1, substituído por getItemCount ().

6

AccessibleContext getAccessibleContext()

Obtém o AccessibleContext associado a esta escolha.

7

String getItem(int index)

Obtém a string no índice especificado neste menu de escolha.

8

int getItemCount()

Retorna o número de itens neste menu de escolha.

9

ItemListener[] getItemListeners()

Retorna uma matriz de todos os ouvintes de item registrados nesta escolha.

10

<T extends EventListener> T[] getListeners(Class<T> listenerType)

Retorna um array de todos os objetos atualmente registrados como FooListeners nesta Choice.

11

int getSelectedIndex()

Retorna o índice do item atualmente selecionado.

12

String getSelectedItem()

Obtém uma representação da escolha atual como uma string.

13

Object[] getSelectedObjects()

Retorna uma matriz (comprimento 1) contendo o item atualmente selecionado.

14

void insert(String item, int index)

Insere o item nesta escolha na posição especificada.

15

protected String paramString()

Retorna uma string que representa o estado deste menu Choice.

16

protected void processEvent(AWTEvent e)

Processa eventos nesta escolha.

17

protected void processItemEvent(ItemEvent e)

Processa eventos de item que ocorrem neste menu Choice, despachando-os para qualquer objeto ItemListener registrado.

18

void remove(int position)

Remove um item do menu de opções na posição especificada.

19

void remove(String item)

Remove a primeira ocorrência do item do menu Escolha.

20

void removeAll()

Remove todos os itens do menu de opções.

21

void removeItemListener(ItemListener l)

Remove o listener de item especificado para que ele não receba mais eventos de item deste menu Choice.

22

void select(int pos)

Define o item selecionado neste menu de escolha para ser o item na posição especificada.

23

void select(String str)

Define o item selecionado neste menu de escolha para ser o item cujo nome é igual à string especificada.

Métodos herdados

Esta classe herda métodos das seguintes classes:

  • java.awt.Component

  • java.lang.Object

Exemplo de escolha

Crie o seguinte programa java usando qualquer editor de sua escolha em dizer D:/ > AWT > com > tutorialspoint > gui >

AwtControlDemo.java
package com.tutorialspoint.gui;

import java.awt.*;
import java.awt.event.*;

public class AwtControlDemo {

   private Frame mainFrame;
   private Label headerLabel;
   private Label statusLabel;
   private Panel controlPanel;

   public AwtControlDemo(){
      prepareGUI();
   }

   public static void main(String[] args){
      AwtControlDemo  awtControlDemo = new AwtControlDemo();
      awtControlDemo.showChoiceDemo();
   }

   private void prepareGUI(){
      mainFrame = new Frame("Java AWT Examples");
      mainFrame.setSize(400,400);
      mainFrame.setLayout(new GridLayout(3, 1));
      mainFrame.addWindowListener(new WindowAdapter() {
         public void windowClosing(WindowEvent windowEvent){
            System.exit(0);
         }        
      });    
      headerLabel = new Label();
      headerLabel.setAlignment(Label.CENTER);
      statusLabel = new Label();        
      statusLabel.setAlignment(Label.CENTER);
      statusLabel.setSize(350,100);

      controlPanel = new Panel();
      controlPanel.setLayout(new FlowLayout());

      mainFrame.add(headerLabel);
      mainFrame.add(controlPanel);
      mainFrame.add(statusLabel);
      mainFrame.setVisible(true);  
   }

   private void showChoiceDemo(){                                       

      headerLabel.setText("Control in action: Choice"); 
      final Choice fruitChoice = new Choice();

      fruitChoice.add("Apple");
      fruitChoice.add("Grapes");
      fruitChoice.add("Mango");
      fruitChoice.add("Peer");

      Button showButton = new Button("Show");

      showButton.addActionListener(new ActionListener() {
         public void actionPerformed(ActionEvent e) {     
            String data = "Fruit Selected: " 
            + fruitChoice.getItem(fruitChoice.getSelectedIndex());
            statusLabel.setText(data);
         }
      }); 

      controlPanel.add(fruitChoice);
      controlPanel.add(showButton);

      mainFrame.setVisible(true);  
   }
}

Compile o programa usando o prompt de comando. Vamos paraD:/ > AWT e digite o seguinte comando.

D:\AWT>javac com\tutorialspoint\gui\AwtControlDemo.java

Se nenhum erro ocorrer, significa que a compilação foi bem-sucedida. Execute o programa usando o seguinte comando.

D:\AWT>java com.tutorialspoint.gui.AwtControlDemo

Verifique a seguinte saída