Classe de lista AWT

Introdução

A lista representa uma lista de itens de texto. A lista pode ser configurada de forma que o usuário possa escolher um ou vários itens.

Declaração de classe

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

public class List
   extends Component
      implements ItemSelectable, Accessible

Construtores de classe

SN Construtor e descrição
1

List()

Cria uma nova lista de rolagem.
2

List(int rows)

Cria uma nova lista de rolagem inicializada com o número especificado de linhas visíveis.
3

List(int rows, boolean multipleMode)

Cria uma nova lista de rolagem inicializada para exibir o número especificado de linhas.

Métodos de aula

Retorna uma matriz de todos os objetos atualmente registrados como FooListeners nesta Lista.

<T extends EventListener> T [] getListeners (Class <T> listenerType)
SN Método e Descrição
1

void add(String item)

Adiciona o item especificado ao final da lista de rolagem.
2

void add(String item, int index)

Adiciona o item especificado à lista de rolagem na posição indicada pelo índice.
3

void addActionListener(ActionListener l)

Adiciona o ouvinte de ação especificado para receber eventos de ação desta lista.
4

void addItem(String item)

Descontinuada. substituído por add (String).
5

void addItem(String item, int index)

Descontinuada. substituído por add (String, int).
6

void addItemListener(ItemListener l)

Adiciona o ouvinte de item especificado para receber eventos de item desta lista.
7

void addNotify()

Cria o par para a lista.
8

boolean allowsMultipleSelections()

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

void clear()

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

int countItems()

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

void delItem(int position)

Descontinuada. substituído por remove (String) e remove (int).
12

void delItems(int start, int end)

Descontinuada. A partir do JDK versão 1.1, não é para uso público no futuro. Espera-se que esse método seja mantido apenas como um método privado de pacote.
13

void deselect(int index)

Desmarca o item no índice especificado.
14

AccessibleContext getAccessibleContext()

Obtém o AccessibleContext associado a esta lista.
15

ActionListener[] getActionListeners()

Retorna uma matriz de todos os ouvintes de ação registrados nesta lista.
16

String getItem(int index)

Obtém o item associado ao índice especificado.
17

int getItemCount()

Obtém o número de itens da lista.
18

ItemListener[] getItemListeners()

Retorna uma matriz de todos os ouvintes de item registrados nesta lista.
19

String[] getItems()

Obtém os itens da lista.
20

Dimension getMinimumSize()

Determina o tamanho mínimo desta lista de rolagem.
21

Dimension getMinimumSize(int rows)

Obtém as dimensões mínimas de uma lista com o número especificado de linhas.
22

Dimension getPreferredSize()

Obtém o tamanho preferido desta lista de rolagem.
23

Dimension getPreferredSize(int rows)

Obtém as dimensões preferidas para uma lista com o número especificado de linhas.
24

int getRows()

Obtém o número de linhas visíveis nesta lista.
25

int getSelectedIndex()

Obtém o índice do item selecionado na lista,
26

int[] getSelectedIndexes()

Obtém os índices selecionados na lista.
27

String getSelectedItem()

Obtém o item selecionado nesta lista de rolagem.
28

String[] getSelectedItems()

Obtém os itens selecionados nesta lista de rolagem.
29

Object[] getSelectedObjects()

Obtém os itens selecionados nesta lista de rolagem em uma matriz de objetos.
30

int getVisibleIndex()

Obtém o índice do item que ficou visível pela última vez pelo método makeVisible.
31

boolean isIndexSelected(int index)

Determina se o item especificado nesta lista de rolagem está selecionado.
32

boolean isMultipleMode()

Determina se esta lista permite várias seleções.
33

boolean isSelected(int index)

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

void makeVisible(int index)

Torna visível o item no índice especificado.
35

Dimension minimumSize()

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

Dimension minimumSize(int rows)

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

protected String paramString()

Retorna a string de parâmetro que representa o estado desta lista de rolagem.
38

Dimension preferredSize()

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

Dimension preferredSize(int rows)

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

protected void processActionEvent(ActionEvent e)

Processa eventos de ação que ocorrem neste componente, despachando-os para quaisquer objetos ActionListener registrados.
41

protected void processEvent(AWTEvent e)

Processa eventos nesta lista de rolagem.
42

protected void processItemEvent(ItemEvent e)

Processa eventos de item que ocorrem nesta lista, despachando-os para quaisquer objetos ItemListener registrados.
43

void remove(int position)

Remove o item na posição especificada desta lista de rolagem.
44

void remove(String item)

Remove a primeira ocorrência de um item da lista.
45

void removeActionListener(ActionListener l)

Remove o ouvinte de ação especificado para que não receba mais eventos de ação desta lista.
46

void removeAll()

Remove todos os itens desta lista.
47

void removeItemListener(ItemListener l)

Remove o ouvinte de item especificado para que ele não receba mais eventos de item desta lista.
48

void removeNotify()

Remove o par desta lista.
49

void replaceItem(String newValue, int index)

Substitui o item no índice especificado na lista de rolagem pela nova string.
50

void select(int index)

Seleciona o item no índice especificado na lista de rolagem.
51

void setMultipleMode(boolean b)

Define o sinalizador que determina se esta lista permite várias seleções.
52

void setMultipleSelections(boolean b)

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

Métodos herdados

Esta classe herda métodos das seguintes classes:

  • java.awt.Component

  • java.lang.Object

Exemplo de lista

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.showListDemo();
   }

   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 showListDemo(){                                       

      headerLabel.setText("Control in action: List"); 
      final List fruitList = new List(4,false);

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

      final List vegetableList = new List(4,true);
   
      vegetableList.add("Lady Finger");
      vegetableList.add("Onion");
      vegetableList.add("Potato");
      vegetableList.add("Tomato");

      Button showButton = new Button("Show");

      showButton.addActionListener(new ActionListener() {

         public void actionPerformed(ActionEvent e) {     
            String data = "Fruits Selected: " 
               + fruitList.getItem(fruitList.getSelectedIndex());
            data += ", Vegetables selected: ";
            for(String vegetable:vegetableList.getSelectedItems()){
               data += vegetable + " ";
            }
            statusLabel.setText(data);
         }
      }); 

      controlPanel.add(fruitList);
      controlPanel.add(vegetableList);
      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