AWT 列表类

介绍

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

类声明

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

public class List
   extends Component
      implements ItemSelectable, Accessible

类构造函数

序号	构造函数 & 描述
1	List() 创建一个新的滚动列表。
2	List(int rows) 创建一个新的滚动列表，并初始化为指定的可见行数。
3	List(int rows, boolean multipleMode) 创建一个新的滚动列表，初始化为显示指定的行数。

序号

构造函数 & 描述

List()

创建一个新的滚动列表。

List(int rows)

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

List(int rows, boolean multipleMode)

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

类方法

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

返回当前在此列表中注册为 FooListeners 的所有对象的数组。

序号	方法 & 描述
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 allowsMultipleSelections() 已弃用。从 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 对象来处理在此组件上发生的 action 事件。
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 例子

使用您选择的任何编辑器创建以下 Java 程序，例如在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);  
   }
}

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

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

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

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

验证以下输出

awt_controls.htm

打印页面