List

优质

小牛编辑

134浏览

2023-12-01

介绍 (Introduction)

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

类声明

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

public class List
   extends Component
      implements ItemSelectable, Accessible

类构造函数

SN	构造函数和描述
1	List() 创建一个新的滚动列表。
2	List(int rows) 创建使用指定数量的可见行初始化的新滚动列表。
3	List(int rows, boolean multipleMode) 创建一个初始化的新滚动列表，以显示指定的行数。

构造函数和描述

List()

创建一个新的滚动列表。

List(int rows)

创建使用指定数量的可见行初始化的新滚动列表。

List(int rows, boolean multipleMode)

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

类方法

T [] getListeners（Class listenerType）

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

SN	方法和描述
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 version 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() 获取与此List关联的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 version 1.1开始，由isIndexSelected（int）取代。
34	void makeVisible(int index) 使指定索引处的项目可见。
35	Dimension minimumSize() 已过时。从JDK 1.1版开始，由getMinimumSize（）取代。
36	Dimension minimumSize(int rows) 已过时。从JDK version 1.1开始，由getMinimumSize（int）取代。
37	protected String paramString() 返回表示此滚动列表状态的参数字符串。
38	Dimension preferredSize() 已过时。从JDK version 1.1开始，由getPreferredSize（）取代。
39	Dimension preferredSize(int rows) 已过时。从JDK version 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 version 1.1开始，由setMultipleMode（boolean）取代。

方法继承

该类继承以下类中的方法:

java.awt.Component
java.lang.Object

列表示例

使用您选择的任何编辑器创建以下java程序，例如D:/ 》 AWT 》 com 》 iowiki 》 gui 》

AwtControlDemo.java

package com.iowiki.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\iowiki\gui\AwtControlDemo.java

如果没有错误，那意味着编译成功。使用以下命令运行程序。

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

验证以下输出