Clase de lista AWT

Introducción

La Lista representa una lista de elementos de texto. La lista se puede configurar para que el usuario pueda elegir un elemento o varios elementos.

Declaración de clase

A continuación se muestra la declaración de java.awt.List clase:

public class List
   extends Component
      implements ItemSelectable, Accessible

Constructores de clases

SN Constructor y descripción
1

List()

Crea una nueva lista de desplazamiento.

2

List(int rows)

Crea una nueva lista de desplazamiento inicializada con el número especificado de líneas visibles.

3

List(int rows, boolean multipleMode)

Crea una nueva lista de desplazamiento inicializada para mostrar el número especificado de filas.

Métodos de clase

Devuelve una matriz de todos los objetos registrados actualmente como FooListeners en esta lista.

<T extiende EventListener> T [] getListeners (Class <T> listenerType)
SN Método y descripción
1

void add(String item)

Agrega el elemento especificado al final de la lista de desplazamiento.

2

void add(String item, int index)

Agrega el elemento especificado a la lista de desplazamiento en la posición indicada por el índice.

3

void addActionListener(ActionListener l)

Agrega el oyente de acción especificado para recibir eventos de acción de esta lista.

4

void addItem(String item)

Obsoleto. reemplazado por agregar (Cadena).

5

void addItem(String item, int index)

Obsoleto. reemplazado por add (String, int).

6

void addItemListener(ItemListener l)

Agrega el detector de elementos especificado para recibir eventos de elementos de esta lista.

7

void addNotify()

Crea el par de la lista.

8

boolean allowsMultipleSelections()

Obsoleto. A partir de la versión 1.1 de JDK, reemplazado por isMultipleMode ().

9

void clear()

Obsoleto. A partir de la versión 1.1 de JDK, reemplazado por removeAll ().

10

int countItems()

Obsoleto. A partir de la versión 1.1 de JDK, reemplazado por getItemCount ().

11

void delItem(int position)

Obsoleto. reemplazado por remove (String) y remove (int).

12

void delItems(int start, int end)

Obsoleto. A partir de la versión 1.1 de JDK, no para uso público en el futuro. Se espera que este método se conserve solo como método privado de paquete.

13

void deselect(int index)

Anula la selección del elemento en el índice especificado.

14

AccessibleContext getAccessibleContext()

Obtiene AccessibleContext asociado a esta lista.

15

ActionListener[] getActionListeners()

Devuelve una matriz de todos los oyentes de acciones registrados en esta lista.

dieciséis

String getItem(int index)

Obtiene el elemento asociado con el índice especificado.

17

int getItemCount()

Obtiene el número de elementos de la lista.

18

ItemListener[] getItemListeners()

Devuelve una matriz de todos los oyentes de elementos registrados en esta lista.

19

String[] getItems()

Obtiene los elementos de la lista.

20

Dimension getMinimumSize()

Determina el tamaño mínimo de esta lista de desplazamiento.

21

Dimension getMinimumSize(int rows)

Obtiene las dimensiones mínimas de una lista con el número especificado de filas.

22

Dimension getPreferredSize()

Obtiene el tamaño preferido de esta lista de desplazamiento.

23

Dimension getPreferredSize(int rows)

Obtiene las dimensiones preferidas para una lista con el número especificado de filas.

24

int getRows()

Obtiene el número de líneas visibles en esta lista.

25

int getSelectedIndex()

Obtiene el índice del elemento seleccionado en la lista,

26

int[] getSelectedIndexes()

Obtiene los índices seleccionados en la lista.

27

String getSelectedItem()

Obtiene el elemento seleccionado en esta lista de desplazamiento.

28

String[] getSelectedItems()

Obtiene los elementos seleccionados en esta lista de desplazamiento.

29

Object[] getSelectedObjects()

Obtiene los elementos seleccionados en esta lista de desplazamiento en una matriz de objetos.

30

int getVisibleIndex()

Obtiene el índice del elemento que se hizo visible por última vez mediante el método makeVisible.

31

boolean isIndexSelected(int index)

Determina si está seleccionado el elemento especificado en esta lista de desplazamiento.

32

boolean isMultipleMode()

Determina si esta lista permite múltiples selecciones.

33

boolean isSelected(int index)

Obsoleto. A partir de la versión 1.1 de JDK, reemplazado por isIndexSelected (int).

34

void makeVisible(int index)

Hace visible el elemento en el índice especificado.

35

Dimension minimumSize()

Obsoleto. A partir de la versión 1.1 de JDK, reemplazado por getMinimumSize ().

36

Dimension minimumSize(int rows)

Obsoleto. A partir de la versión 1.1 de JDK, reemplazado por getMinimumSize (int).

37

protected String paramString()

Devuelve la cadena de parámetros que representa el estado de esta lista de desplazamiento.

38

Dimension preferredSize()

Obsoleto. A partir de la versión 1.1 de JDK, reemplazado por getPreferredSize ().

39

Dimension preferredSize(int rows)

Obsoleto. A partir de la versión 1.1 de JDK, reemplazado por getPreferredSize (int).

40

protected void processActionEvent(ActionEvent e)

Procesa eventos de acción que ocurren en este componente enviándolos a cualquier objeto ActionListener registrado.

41

protected void processEvent(AWTEvent e)

Procesa eventos en esta lista de desplazamiento.

42

protected void processItemEvent(ItemEvent e)

Procesa eventos de elementos que ocurren en esta lista enviándolos a cualquier objeto ItemListener registrado.

43

void remove(int position)

Elimina el elemento en la posición especificada de esta lista de desplazamiento.

44

void remove(String item)

Elimina la primera aparición de un elemento de la lista.

45

void removeActionListener(ActionListener l)

Elimina el detector de acciones especificado para que ya no reciba eventos de acción de esta lista.

46

void removeAll()

Elimina todos los elementos de esta lista.

47

void removeItemListener(ItemListener l)

Elimina el detector de elementos especificado para que ya no reciba eventos de elementos de esta lista.

48

void removeNotify()

Elimina el par de esta lista.

49

void replaceItem(String newValue, int index)

Reemplaza el elemento en el índice especificado en la lista de desplazamiento con la nueva cadena.

50

void select(int index)

Selecciona el elemento en el índice especificado en la lista de desplazamiento.

51

void setMultipleMode(boolean b)

Establece la bandera que determina si esta lista permite múltiples selecciones.

52

void setMultipleSelections(boolean b)

Obsoleto. A partir de la versión 1.1 de JDK, reemplazado por setMultipleMode (booleano).

Métodos heredados

Esta clase hereda métodos de las siguientes clases:

  • java.awt.Component

  • java.lang.Object

Ejemplo de lista

Cree el siguiente programa java usando cualquier editor de su elección en digamos 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 el programa usando el símbolo del sistema. IrD:/ > AWT y escriba el siguiente comando.

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

Si no aparece ningún error, eso significa que la compilación se realizó correctamente. Ejecute el programa usando el siguiente comando.

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

Verifique la siguiente salida