java.awt
类 List

java.lang.Object
  java.awt.Component
      java.awt.List

所有已实现的接口：

ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible

public class List
     

      extends 
      Component
     
     

      implements 
      ItemSelectable, 
      Accessible
     

List 组件为用户提供了一个可滚动的文本项列表。可设置此 list，使其允许用户进行单项或多项选择。

例如以下代码：

 List lst = new List(4, false);
 lst.add("Mercury");
 lst.add("Venus");
 lst.add("Earth");
 lst.add("JavaSoft");
 lst.add("Mars");
 lst.add("Jupiter");
 lst.add("Saturn");
 lst.add("Uranus");
 lst.add("Neptune");
 lst.add("Pluto");
 cnt.add(lst);
 

当 cnt 为容器时，将生成以下滚动列表：

如果 List 允许进行多项选择，则单击已选中的项时，将取消选中该项。在上面的示例中，一次只能从滚动列表中选择一项，因为创建新的滚动列表时，第二个参数为 false。如果 List 不允许进行多项选择，则选择某一项会导致其他选中的项取消选中。

注意，本示例中显示的列表是用四个可视行创建的。创建该列表之后，不可更改可视行的数量。默认的 List 是用四行创建的，所以 lst = new List() 与 list = new List(4, false) 等效。

从 Java 1.1 开始，AWT（Abstract Window Toolkit，抽象窗口工具包）会把列表上发生的所有鼠标、键盘和焦点事件发送给 List 对象。（维护旧的 AWT 事件模型的目的是为了向后兼容，不推荐使用它。）

当用户选中或取消选中某项时，AWT 将向列表发送一个 ItemEvent 实例。当用户双击滚动列表中的某一项时，AWT 会在紧随项事件后向列表发送一个 ActionEvent 实例。当用户选中列表中的某项，按下 return 键时，AWT 也会生成一个动作事件。

如果应用程序需要基于此列表中用户选中或激活的项执行某个动作，则应该相应地实现 ItemListener 或 ActionListener，并注册新的侦听器，以便在此列表中接收事件。

对于多项选择滚动列表，使用外部动作（如单击按钮）来触发动作被认为是一种更好的用户界面。

从以下版本开始：

JDK1.0

另请参见：

ItemEvent, ItemListener, ActionEvent, ActionListener, 序列化表格

List

public List()
     throws HeadlessException

创建新的滚动列表。默认情况下，有四个可视行，并且不允许进行多项选择。注意，这是 List(0, false) 的一种便捷方法。还要注意，列表中的可视行数一旦创建就不能更改。

抛出：

HeadlessException - 如果为 GraphicsEnvironment.isHeadless()，则返回 true。

另请参见：

GraphicsEnvironment.isHeadless()

List

public List(int rows)
     throws HeadlessException

创建一个用指定可视行数初始化的新滚动列表。默认情况下，不允许进行多项选择。注意，这是 List(rows, false) 的一种便捷方法。还要注意，列表中的可视行数一旦创建就不能更改。

参数：

rows - 要显示的项数。

抛出：

HeadlessException - 如果为 GraphicsEnvironment.isHeadless()，则返回 true。

从以下版本开始：

JDK1.1

另请参见：

GraphicsEnvironment.isHeadless()

List

public List(int rows,
            boolean multipleMode)
     throws HeadlessException

创建一个初始化为显示指定行数的新滚动列表。注意，如果指定了零行，则会按默认的四行创建列表。还要注意，列表中的可视行数一旦创建就不能更改。如果 multipleMode 的值为 true，则用户可从列表中选择多项。如果为 false，则一次只能选择一项。

参数：

rows - 要显示的项数。

multipleMode - 如果为 true，则允许进行多项选择；否则，一次只能选择一项。

抛出：

HeadlessException - 如果为 GraphicsEnvironment.isHeadless()，则返回 true。

另请参见：

GraphicsEnvironment.isHeadless()

addNotify

public void addNotify()

创建列表的同位体。同位体允许我们在不更改列表功能的情况下修改其外观。

覆盖：

类 Component 中的 addNotify

另请参见：

Component.isDisplayable(), Component.removeNotify()

removeNotify

public void removeNotify()

移除此列表的同位体。同位体允许我们在不更改列表功能的情况下修改其外观。

覆盖：

类 Component 中的 removeNotify

另请参见：

Component.isDisplayable(), Component.addNotify()

getItemCount

public int getItemCount()

获取列表中的项数。

返回：

列表中的项数

从以下版本开始：

JDK1.1

另请参见：

getItem(int)

countItems

@Deprecated
public int countItems()

已过时。  从 JDK version 1.1 开始，由 getItemCount() 取代。

getItem

public String getItem(int index)

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

参数：

index - 项的位置

返回：

一个与指定索引关联的项

另请参见：

getItemCount()

getItems

public String[] getItems()

获取列表中的项。

返回：

一个包含列表中项的字符串数组

从以下版本开始：

JDK1.1

另请参见：

select(int), deselect(int), isIndexSelected(int)

add

public void add(String item)

向滚动列表的末尾添加指定的项。

参数：

item - 要添加的项

从以下版本开始：

JDK1.1

addItem