AWT List 类

简介

List 表示文本项列表。可以配置列表,以便用户可以选择一个或多个项。

类声明

以下是 java.awt.List 类的声明:

public class List
   extends Component
      implements ItemSelectable, Accessible

类构造函数

S.N.构造函数 &描述
1

List()

创建一个新的滚动列表。

2

List(int rows)

创建一个新的滚动列表,初始化为指定数量的可见行。

3

List(int rows, boolean multipleMode)

创建一个新的滚动列表,初始化为显示指定数量的行。

类方法

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

返回当前在此 List 上注册为 FooListeners 的所有对象的数组。

S.N.方法& 描述
1

void add(String item)

将指定的项目添加到滚动列表的末尾。

2

void add(String item, int index)

将指定的项目添加到滚动列表中索引指示的位置。

3

void addActionListener(ActionListener l)

添加指定的操作侦听器以从此列表接收操作事件。

4

void addItem(String item)

已弃用。由 add(String) 替换。

5

void addItem(String item, int index)

已弃用。由 add(String, int) 替换。

6

void addItemListener(ItemListener l)

添加指定的项目侦听器以从此列表接收项目事件。

7

void addNotify()

为列表创建对等体。

8

boolean allowingMultipleSelections()

已弃用。从 JDK 1.1 版开始,由 isMultipleMode() 取代。

9

void clear()

已弃用。从 JDK 1.1 版开始,由 removeAll() 取代。

10

int countItems()

已弃用。从 JDK 1.1 版开始,由 getItemCount() 取代。

11

void delItem(int position)

已弃用。由 remove(String) 和 remove(int) 取代。

12

void delItems(int start, int end)

已弃用。从 JDK 1.1 版开始,将来不再供公众使用。该方法预计仅作为包私有方法保留。

13

void deselect(int index)

取消选择指定索引处的项目。

14

AccessibleContext getAccessibleContext()

获取与此列表关联的 AccessibleContext。

15

ActionListener[] getActionListeners()

返回此列表上注册的所有动作侦听器的数组。

16

String getItem(int index)

获取项目与指定索引关联的。

17

int getItemCount()

获取列表中的项目数。

18

ItemListener[] getItemListeners()

返回此列表上注册的所有项目侦听器的数组。

19

String[] getItems()

获取列表中的项目。

20

Dimension getMinimumSize()

确定此滚动列表的最小大小。

21

Dimension getMinimumSize(int rows)

获取具有指定行数的列表的最小尺寸。

22

Dimension getPreferredSize()

获取此滚动列表的首选大小。

23

Dimension getPreferredSize(int rows)

获取具有指定行数的列表的首选尺寸。

24

int getRows()

获取此列表中可见行的数量。

25

int getSelectedIndex()

获取列表中选定项目的索引,

26

int[] getSelectedIndexes()

获取列表中选定的索引。

27

String getSelectedItem()

获取此滚动列表中选定的项目。

28

String[] getSelectedItems()

获取此滚动列表中选定的项目列表。

29

Object[] getSelectedObjects()

获取此滚动列表中对象数组中的选定项。

30

int getVisibleIndex()

获取最后通过方法 makeVisible 可见的项的索引。

31

boolean isIndexSelected(int index)

确定此滚动列表中的指定项是否被选中。

32

boolean isMultipleMode()

确定此列表是否允许多项选择。

33

boolean isSelected(int index)

已弃用。从 JDK 1.1 版开始,由 isIndexSelected(int) 取代。

34

void makeVisible(int index)

使指定索引处的项目可见。

35

Dimension minimumSize()

已弃用。从 JDK 1.1 版开始,由 getMinimumSize() 取代。

36

Dimension minimumSize(int rows)

已弃用。从 JDK 1.1 版开始,由 getMinimumSize(int) 取代。

37

protected String paramString()

返回表示此滚动列表状态的参数字符串。

38

Dimension preferredSize()

已弃用。从 JDK 1.1 版开始,由 getPreferredSize() 取代。

39

Dimension preferredSize(int rows)

已弃用。从 JDK 1.1 版开始,由 getPreferredSize(int) 取代。

40

protected void processActionEvent(ActionEvent e)

通过将发生在此组件上的动作事件分派给任何已注册的 ActionListener 对象来处理它们。

41

protected void processEvent(AWTEvent e)

处理此滚动列表上的事件。

42

protected void processItemEvent(ItemEvent e)

通过将发生在此列表上的项目事件分派给任何已注册的 ItemListener 对象来处理它们。

43

void remove(int position)

从此滚动列表中移除指定位置的项目。

44

void remove(String item)

从列表中移除第一个出现的项目。

45

void removeActionListener(ActionListener l)

移除指定的操作侦听器,使其不再接收来自此列表的操作事件。

46

void removeAll()

从此列表中移除所有项目。

47

void removeItemListener(ItemListener l)

删除指定的项目侦听器,使其不再接收来自此列表的项目事件。

48

void removeNotify()

删除此列表的对等项。

49

void replaceItem(String newValue, int index)

用新字符串替换滚动列表中指定索引处的项目。

50

void select(int index)

选择滚动列表中指定索引处的项目列表。

51

void setMultipleMode(boolean b)

设置确定此列表是否允许多项选择的标志。

52

void setMultipleSelections(boolean b)

已弃用。从 JDK 1.1 版开始,由 setMultipleMode(boolean) 取代。

继承的方法

此类从以下类继承方法:

  • java.awt.Component

  • java.lang.Object

List 示例

使用您选择的任何编辑器在 D:/ > AWT > com > tutorialspoint > gui > 中创建以下 Java 程序

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);  
   }
}

使用命令提示符编译程序。转到 D:/ > AWT 并键入以下命令。

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

如果没有错误,则表示编译成功。使用以下命令运行程序。

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

验证以下输出

AWT List

awt_controls.html