Classe de liste AWT

introduction

La liste représente une liste d'éléments de texte. La liste peut être configurée pour que l'utilisateur puisse choisir un ou plusieurs éléments.

Déclaration de classe

Voici la déclaration pour java.awt.List classe:

public class List
   extends Component
      implements ItemSelectable, Accessible

Constructeurs de classe

SNConstructeur et description
1

List()

Crée une nouvelle liste déroulante.

2

List(int rows)

Crée une nouvelle liste déroulante initialisée avec le nombre spécifié de lignes visibles.

3

List(int rows, boolean multipleMode)

Crée une nouvelle liste déroulante initialisée pour afficher le nombre de lignes spécifié.

Méthodes de classe

<T étend EventListener> T [] getListeners (Classe <T> type d'écoute)

Renvoie un tableau de tous les objets actuellement enregistrés comme FooListeners sur cette liste.

SNMéthode et description
1

void add(String item)

Ajoute l'élément spécifié à la fin de la liste déroulante.

2

void add(String item, int index)

Ajoute l'élément spécifié à la liste déroulante à la position indiquée par l'index.

3

void addActionListener(ActionListener l)

Ajoute l'écouteur d'action spécifié pour recevoir les événements d'action de cette liste.

4

void addItem(String item)

Obsolète. remplacé par add (String).

5

void addItem(String item, int index)

Obsolète. remplacé par add (String, int).

6

void addItemListener(ItemListener l)

Ajoute l'écouteur d'élément spécifié pour recevoir les événements d'élément de cette liste.

sept

void addNotify()

Crée le pair pour la liste.

8

boolean allowsMultipleSelections()

Obsolète. À partir de la version 1.1 de JDK, remplacé par isMultipleMode ().

9

void clear()

Obsolète. À partir de la version 1.1 de JDK, remplacé par removeAll ().

dix

int countItems()

Obsolète. À partir de la version 1.1 de JDK, remplacé par getItemCount ().

11

void delItem(int position)

Obsolète. remplacé par remove (String) et remove (int).

12

void delItems(int start, int end)

Obsolète. À partir de la version 1.1 de JDK, ne sera pas utilisé par le public à l'avenir. Cette méthode devrait être conservée uniquement en tant que méthode privée de package.

13

void deselect(int index)

Désélectionne l'élément à l'index spécifié.

14

AccessibleContext getAccessibleContext()

Obtient le AccessibleContext associé à cette List.

15

ActionListener[] getActionListeners()

Renvoie un tableau de tous les écouteurs d'action enregistrés dans cette liste.

16

String getItem(int index)

Obtient l'élément associé à l'index spécifié.

17

int getItemCount()

Obtient le nombre d'éléments de la liste.

18

ItemListener[] getItemListeners()

Renvoie un tableau de tous les écouteurs d'élément enregistrés dans cette liste.

19

String[] getItems()

Obtient les éléments de la liste.

20

Dimension getMinimumSize()

Détermine la taille minimale de cette liste déroulante.

21

Dimension getMinimumSize(int rows)

Obtient les dimensions minimales pour une liste avec le nombre de lignes spécifié.

22

Dimension getPreferredSize()

Obtient la taille préférée de cette liste déroulante.

23

Dimension getPreferredSize(int rows)

Obtient les dimensions préférées pour une liste avec le nombre de lignes spécifié.

24

int getRows()

Obtient le nombre de lignes visibles dans cette liste.

25

int getSelectedIndex()

Obtient l'index de l'élément sélectionné dans la liste,

26

int[] getSelectedIndexes()

Obtient les index sélectionnés dans la liste.

27

String getSelectedItem()

Obtient l'élément sélectionné dans cette liste déroulante.

28

String[] getSelectedItems()

Obtient les éléments sélectionnés dans cette liste déroulante.

29

Object[] getSelectedObjects()

Obtient les éléments sélectionnés sur cette liste déroulante dans un tableau d'objets.

30

int getVisibleIndex()

Obtient l'index de l'élément qui a été rendu visible pour la dernière fois par la méthode makeVisible.

31

boolean isIndexSelected(int index)

Détermine si l'élément spécifié dans cette liste déroulante est sélectionné.

32

boolean isMultipleMode()

Détermine si cette liste autorise plusieurs sélections.

33

boolean isSelected(int index)

Obsolète. À partir de la version 1.1 de JDK, remplacé par isIndexSelected (int).

34

void makeVisible(int index)

Rend l'élément à l'index spécifié visible.

35

Dimension minimumSize()

Obsolète. À partir de la version 1.1 de JDK, remplacé par getMinimumSize ().

36

Dimension minimumSize(int rows)

Obsolète. À partir de la version 1.1 de JDK, remplacé par getMinimumSize (int).

37

protected String paramString()

Renvoie la chaîne de paramètres représentant l'état de cette liste déroulante.

38

Dimension preferredSize()

Obsolète. À partir de la version 1.1 de JDK, remplacé par getPreferredSize ().

39

Dimension preferredSize(int rows)

Obsolète. À partir de la version 1.1 de JDK, remplacé par getPreferredSize (int).

40

protected void processActionEvent(ActionEvent e)

Traite les événements d'action se produisant sur ce composant en les distribuant à tous les objets ActionListener enregistrés.

41

protected void processEvent(AWTEvent e)

Traite les événements de cette liste déroulante.

42

protected void processItemEvent(ItemEvent e)

Traite les événements d'article se produisant sur cette liste en les distribuant à tous les objets ItemListener enregistrés.

43

void remove(int position)

Supprime l'élément à la position spécifiée de cette liste déroulante.

44

void remove(String item)

Supprime la première occurrence d'un élément de la liste.

45

void removeActionListener(ActionListener l)

Supprime l'écouteur d'action spécifié afin qu'il ne reçoive plus d'événements d'action de cette liste.

46

void removeAll()

Supprime tous les éléments de cette liste.

47

void removeItemListener(ItemListener l)

Supprime l'écouteur d'élément spécifié afin qu'il ne reçoive plus les événements d'élément de cette liste.

48

void removeNotify()

Supprime l'homologue de cette liste.

49

void replaceItem(String newValue, int index)

Remplace l'élément à l'index spécifié dans la liste déroulante par la nouvelle chaîne.

50

void select(int index)

Sélectionne l'élément à l'index spécifié dans la liste déroulante.

51

void setMultipleMode(boolean b)

Définit l'indicateur qui détermine si cette liste autorise plusieurs sélections.

52

void setMultipleSelections(boolean b)

Obsolète. À partir de la version 1.1 de JDK, remplacé par setMultipleMode (booléen).

Méthodes héritées

Cette classe hérite des méthodes des classes suivantes:

  • java.awt.Component

  • java.lang.Object

Exemple de liste

Créez le programme Java suivant en utilisant n'importe quel éditeur de votre choix dans say 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);  
   }
}

Compilez le programme à l'aide de l'invite de commande. Aller àD:/ > AWT et tapez la commande suivante.

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

Si aucune erreur ne survient, cela signifie que la compilation est réussie. Exécutez le programme en utilisant la commande suivante.

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

Vérifiez la sortie suivante