List (Java Platform SE 8 )

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

All Implemented Interfaces:

ImageObserver， ItemSelectable， MenuContainer， Serializable， Accessible
```
public class List
extends Component
implements ItemSelectable, Accessible
```
的 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是一个容器，产生下面的滚动列表：

如果列表允许多重选择，然后点击一个项目，已经选择将它。在前面的例子中，从滚动列表只有一个项目可以同时被选择，因为第二个参数创建新的滚动列表时false。如果列表不允许多重选择，选择一个项目造成任何其他选择的项目被取消。

请注意，在示例中的列表显示的是用四个可见行创建的。一旦创建了列表，就不能更改可见行的数目。默认List是四行创建的，所以lst = new List()相当于list = new List(4, false)。

用java 1.1开始，抽象窗口工具包将List对象所有的鼠标，键盘，和焦点事件发生在这。（老AWT事件模型保持只是为了向后兼容，它的使用是气馁。）

当一个项目被选中或取消选中的用户，AWT将ItemEvent实例列表。当用户双击一个项目在一个滚动列表，AWT将ActionEvent实例列表项事件后。AWT也产生动作事件而选择列表中的一个项目是当用户按下回车键。

如果一个应用程序需要执行基于项目列表中选择或由用户启动一些行动，应该实行ItemListener或ActionListener酌情登记从这个列表接收事件的新听众。

对于多个选择滚动列表，它被认为是一个更好的用户界面，使用一个外部的手势（如点击一个按钮）触发动作。
从以下版本开始：

JDK1.0

另请参见：

ItemEvent， ItemListener， ActionEvent， ActionListener， Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`List.AccessibleAWTList` 这个类实现了对 `List`类可访问性支持。

Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary
- Fields inherited from class java.awt.Component
  accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
- Fields inherited from interface java.awt.image.ImageObserver
  ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

构造方法
Constructor and Description
`List()` 创建一个新的滚动列表。
`List(int rows)` 创建一个新的滚动列表，用指定的可见行数初始化。
`List(int rows, boolean multipleMode)` 创建一个新的滚动列表，以显示指定的行数。

方法摘要

所有方法接口方法具体的方法弃用的方法
Modifier and Type	Method and Description
`void`	`add(String item)` 将指定的项目添加到滚动列表的结束时。
`void`	`add(String item, int index)` 将指定的项目添加到索引所指示的位置的滚动列表中。
`void`	`addActionListener(ActionListener l)` 添加指定的操作侦听器从该列表中接收动作事件。
`void`	`addItem(String item)` 过时的。取而代之的`add(String)`。
`void`	`addItem(String item, int index)` 过时的。取而代之的`add(String, int)`。
`void`	`addItemListener(ItemListener l)` 将指定的项目侦听器添加到从该列表中接收项目事件。
`void`	`addNotify()` 创建列表的对等体。
`boolean`	`allowsMultipleSelections()` 过时的。作为JDK 1.1版本，取而代之的`isMultipleMode()`。
`void`	`clear()` 过时的。作为JDK 1.1版本，取而代之的`removeAll()`。
`int`	`countItems()` 过时的。作为JDK 1.1版本，取而代之的`getItemCount()`。
`void`	`delItem(int position)` 过时的。通过`remove(String)`和`remove(int)`取代。
`void`	`delItems(int start, int end)` 过时的。作为JDK 1.1版本，不为未来的公共使用。此方法预计将保留仅作为一个包私有方法。
`void`	`deselect(int index)` 将指定索引处的项。
`AccessibleContext`	`getAccessibleContext()` 获取与此相关的 `AccessibleContext` `List`。
`ActionListener[]`	`getActionListeners()` 返回在这个列表上注册的所有操作侦听器的数组。
`String`	`getItem(int index)` 获取与指定索引关联的项目。
`int`	`getItemCount()` 获取列表中的项目数。
`ItemListener[]`	`getItemListeners()` 返回在这个列表上注册的所有项目的数组的数组。
`String[]`	`getItems()` 获取列表中的项目。
`<T extends EventListener> T[]`	`getListeners(类<T> listenerType)` 返回对象的当前注册为 `FooListener`s在这 `List`数组。
`Dimension`	`getMinimumSize()` 确定此滚动列表的最小大小。
`Dimension`	`getMinimumSize(int rows)` 获取具有指定行数的列表的最小尺寸。
`Dimension`	`getPreferredSize()` 获取此滚动列表的首选大小。
`Dimension`	`getPreferredSize(int rows)` 获取具有指定行数的列表的首选尺寸。
`int`	`getRows()` 获取此列表中的可见行数。
`int`	`getSelectedIndex()` 获取列表中选定项的索引，
`int[]`	`getSelectedIndexes()` 获取列表中选定的索引。
`String`	`getSelectedItem()` 获取此滚动列表中的选定项目。
`String[]`	`getSelectedItems()` 获取此滚动列表中的选定项目。
`Object[]`	`getSelectedObjects()` 获取此滚动列表中的选定项目的对象数组。
`int`	`getVisibleIndex()` 获取项的索引，是最后的方法 `makeVisible`可见。
`boolean`	`isIndexSelected(int index)` 确定此滚动列表中指定的项目是否被选中。
`boolean`	`isMultipleMode()` 确定此列表是否允许多个选择。
`boolean`	`isSelected(int index)` 过时的。作为JDK 1.1版本，取而代之的`isIndexSelected(int)`。
`void`	`makeVisible(int index)` 使项目在指定的索引可见。
`Dimension`	`minimumSize()` 过时的。作为JDK 1.1版本，取而代之的`getMinimumSize()`。
`Dimension`	`minimumSize(int rows)` 过时的。作为JDK 1.1版本，取而代之的`getMinimumSize(int)`。
`protected String`	`paramString()` 返回表示此滚动列表状态的参数字符串。
`Dimension`	`preferredSize()` 过时的。作为JDK 1.1版本，取而代之的`getPreferredSize()`。
`Dimension`	`preferredSize(int rows)` 过时的。作为JDK 1.1版本，取而代之的`getPreferredSize(int)`。
`protected void`	`processActionEvent(ActionEvent e)` 过程行动事件发生在这个组件分派他们到任何注册 `ActionListener`对象。
`protected void`	`processEvent(AWTEvent e)` 在这个滚动列表上处理事件。
`protected void`	`processItemEvent(ItemEvent e)` 处理项目上发生的事件列表分派他们到任何注册 `ItemListener`对象。
`void`	`remove(int position)` 从这个滚动列表中移除指定位置上的项目。
`void`	`remove(String item)` 从列表中移除项目的第一个发生。
`void`	`removeActionListener(ActionListener l)` 移除指定的动作侦听器，以便它不再从该列表中接收动作事件。
`void`	`removeAll()` 从这个列表中移除所有项目。
`void`	`removeItemListener(ItemListener l)` 移除指定的项目侦听器，以便它不再从该列表中接收项目事件。
`void`	`removeNotify()` 删除此列表的对等体。
`void`	`replaceItem(String newValue, int index)` 用新字符串替换滚动列表中指定索引处的项目。
`void`	`select(int index)` 在滚动列表中的指定索引中选择项目。
`void`	`setMultipleMode(boolean b)` 设置确定此列表是否允许多个选择的标志。
`void`	`setMultipleSelections(boolean b)` 过时的。作为JDK 1.1版本，取而代之的`setMultipleMode(boolean)`。

Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - 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()
```
    创建列表的对等体。的对等允许我们修改列表的外观，而不改变其功能。
    
    重写：
    
    addNotify 方法重写，继承类 Component
    
    另请参见：
    
    Component.isDisplayable()， Component.removeNotify()， Component.invalidate()
  - removeNotify
```
public void removeNotify()
```
    删除此列表的对等体。的对等允许我们修改列表的外观，而不改变其功能。
    
    重写：
    
    removeNotify 方法重写，继承类 Component
    
    另请参见：
    
    Component.isDisplayable()， Component.addNotify()
  - getItemCount
```
public int getItemCount()
```
    获取列表中的项目数。
    
    结果
    
    列表中的项目数
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    getItem(int)
  - countItems
```
@Deprecated
public int countItems()
```
    过时的。作为JDK 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
```
@Deprecated
public void addItem(String item)
```
    过时的。取而代之的add(String)。
  - add
```
public void add(String item,
                int index)
```
    将指定的项目添加到索引所指示的位置的滚动列表中。该指数为零的基础。如果该索引的值小于零，或者该索引的值大于或等于列表中的项的数目，则该项将被添加到列表的结尾。
    
    参数
    
    item -要添加的项目；如果该参数为 null然后项目视为一个空字符串， ""
    
    index -在该位置添加项目
    
    从以下版本开始：
    
    JDK1.1
  - addItem
```
@Deprecated
public void addItem(String item,
                                int index)
```
    过时的。取而代之的add(String, int)。
  - replaceItem
```
public void replaceItem(String newValue,
                        int index)
```
    用新字符串替换滚动列表中指定索引处的项目。
    
    参数
    
    newValue来取代现有的项目，一个新的字符串
    
    index -物品的位置来代替
    
    异常
    
    ArrayIndexOutOfBoundsException -如果 index超出范围
  - removeAll
```
public void removeAll()
```
    从这个列表中移除所有项目。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    remove(java.lang.String)， delItems(int, int)
  - clear
```
@Deprecated
public void clear()
```
    过时的。作为JDK 1.1版本，取而代之的removeAll()。
  - remove
```
public void remove(String item)
```
    从列表中移除项目的第一个发生。如果指定了指定的项目，并且是列表中唯一选择的项目，则列表将设置为没有选择。
    
    参数
    
    item -项从列表中删除
    
    异常
    
    IllegalArgumentException如果列表中不存在该项目
    
    从以下版本开始：
    
    JDK1.1
  - remove
```
public void remove(int position)
```
    从这个滚动列表中移除指定位置上的项目。如果选择指定位置的项目，并且是列表中唯一的选择项目，则列表将被设置为没有选择。
    
    参数
    
    position -要删除的项的索引
    
    异常
    
    ArrayIndexOutOfBoundsException -如果 position小于0或大于 getItemCount()-1
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    add(String, int)
  - delItem
```
@Deprecated
public void delItem(int position)
```
    过时的。通过remove(String)和remove(int)取代。
  - getSelectedIndex
```
public int getSelectedIndex()
```
    获取列表中选定项的索引，
    
    结果
    
    选定项的索引；如果没有选中项目，或者选择多个项目， -1返回。
    
    另请参见：
    
    select(int)， deselect(int)， isIndexSelected(int)
  - getSelectedIndexes
```
public int[] getSelectedIndexes()
```
    获取列表中选定的索引。
    
    结果
    
    此滚动列表中选定索引的数组；如果没有选择项，则返回一零个长度数组。
    
    另请参见：
    
    select(int)， deselect(int)， isIndexSelected(int)
  - getSelectedItem
```
public String getSelectedItem()
```
    获取此滚动列表中的选定项目。
    
    结果
    
    选定的项目清单上；如果没有选中项目，或者选择多个项目， null返回。
    
    另请参见：
    
    select(int)， deselect(int)， isIndexSelected(int)
  - getSelectedItems
```
public String[] getSelectedItems()
```
    获取此滚动列表中的选定项目。
    
    结果
    
    此滚动列表中选定项目的数组；如果没有选择项，则返回一零个长度数组。
    
    另请参见：
    
    select(int)， deselect(int)， isIndexSelected(int)
  - getSelectedObjects
```
public Object[] getSelectedObjects()
```
    获取此滚动列表中的选定项目的对象数组。
    
    Specified by:
    
    getSelectedObjects 接口 ItemSelectable
    
    结果
    
    代表选定的项目在这个滚动列表 Objects数组；如果没有选中项目，返回一零数组长度。
    
    另请参见：
    
    getSelectedItems()， ItemSelectable
  - select
```
public void select(int index)
```
    在滚动列表中的指定索引中选择项目。
    请注意，传递的范围参数无效，并将导致未指定的行为。
    
    请注意，此方法应主要用于在该组件中最初选择一个项目。以编程方式调用此方法将空不触发ItemEvent。触发ItemEvent通过用户交互的唯一方式。
    
    参数
    
    index -项目的位置选择
    
    另请参见：
    
    getSelectedItem()， deselect(int)， isIndexSelected(int)
  - deselect
```
public void deselect(int index)
```
    将指定索引处的项。
    请注意，传递的范围参数无效，并将导致未指定的行为。
    
    如果指定索引中的项目未被选中，则忽略该操作。
    
    参数
    
    index -项目的位置选择
    
    另请参见：
    
    select(int)， getSelectedItem()， isIndexSelected(int)
  - isIndexSelected
```
public boolean isIndexSelected(int index)
```
    确定此滚动列表中指定的项目是否被选中。
    
    参数
    
    index -项目进行检查
    
    结果
    
    true如果指定的项被选择； false否则
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    select(int)， deselect(int)
  - isSelected
```
@Deprecated
public boolean isSelected(int index)
```
    过时的。作为JDK 1.1版本，取而代之的isIndexSelected(int)。
  - getRows
```
public int getRows()
```
    获取此列表中的可见行数。注意，一旦 List已经建立，这将永远不会改变。
    
    结果
    
    这个滚动列表中的可见行数
  - isMultipleMode
```
public boolean isMultipleMode()
```
    确定此列表是否允许多个选择。
    
    结果
    
    true如果该列表允许多重选择；否则， false
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    setMultipleMode(boolean)
  - allowsMultipleSelections
```
@Deprecated
public boolean allowsMultipleSelections()
```
    过时的。作为JDK 1.1版本，取而代之的isMultipleMode()。
  - setMultipleMode
```
public void setMultipleMode(boolean b)
```
    设置确定此列表是否允许多个选择的标志。当选择模式由多个选择改变为单一选择时，选择的项目改变如下：如果一个选定的项目有位置光标，只有该项目将继续选择。如果没有选择项具有定位光标，所有项目将被取消。
    
    参数
    
    b -如果 true然后多重选择是允许的；否则，从列表中只有一个项目可以选择一次
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    isMultipleMode()
  - setMultipleSelections
```
@Deprecated
public void setMultipleSelections(boolean b)
```
    过时的。作为JDK 1.1版本，取而代之的setMultipleMode(boolean)。
  - getVisibleIndex
```
public int getVisibleIndex()
```
    获取项的索引，是最后的方法 makeVisible可见。
    
    结果
    
    最后一个被显示的项目的索引
    
    另请参见：
    
    makeVisible(int)
  - makeVisible
```
public void makeVisible(int index)
```
    使项目在指定的索引可见。
    
    参数
    
    index -项目位置
    
    另请参见：
    
    getVisibleIndex()
  - getPreferredSize
```
public Dimension getPreferredSize(int rows)
```
    获取具有指定行数的列表的首选尺寸。
    
    参数
    
    rows -表中的行数
    
    结果
    
    显示此滚动列表的首选尺寸，因为指定的行数必须是可见的
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Component.getPreferredSize()
  - preferredSize
```
@Deprecated
public Dimension preferredSize(int rows)
```
    过时的。作为JDK 1.1版本，取而代之的getPreferredSize(int)。
  - getPreferredSize
```
public Dimension getPreferredSize()
```
    获取此滚动列表的首选大小。
    
    重写：
    
    getPreferredSize 方法重写，继承类 Component
    
    结果
    
    显示此滚动列表的首选尺寸
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Component.getPreferredSize()
  - preferredSize
```
@Deprecated
public Dimension preferredSize()
```
    过时的。作为JDK 1.1版本，取而代之的getPreferredSize()。
    
    重写：
    
    preferredSize 方法重写，继承类 Component
  - getMinimumSize
```
public Dimension getMinimumSize(int rows)
```
    获取具有指定行数的列表的最小尺寸。
    
    参数
    
    rows -表中的行数
    
    结果
    
    给定该滚动列表的最小尺寸，给定指定的行数必须是可见的
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Component.getMinimumSize()
  - minimumSize
```
@Deprecated
public Dimension minimumSize(int rows)
```
    过时的。作为JDK 1.1版本，取而代之的getMinimumSize(int)。
  - getMinimumSize
```
public Dimension getMinimumSize()
```
    确定此滚动列表的最小大小。
    
    重写：
    
    getMinimumSize 方法重写，继承类 Component
    
    结果
    
    显示此滚动列表所需的最小尺寸
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    Component.getMinimumSize()
  - minimumSize
```
@Deprecated
public Dimension minimumSize()
```
    过时的。作为JDK 1.1版本，取而代之的getMinimumSize()。
    
    重写：
    
    minimumSize 方法重写，继承类 Component
  - addItemListener
```
public void addItemListener(ItemListener l)
```
    将指定的项目侦听器添加到从该列表中接收项目事件。项目事件响应用户输入，发送，但不响应呼吁 select或 deselect。如果听众 l是 null，不引发异常，则不执行行动。
    参考AWT Threading Issues对AWT的线程模型的细节。
    
    Specified by:
    
    addItemListener 接口 ItemSelectable
    
    参数
    
    l -项目的倾听者
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    removeItemListener(java.awt.event.ItemListener)， getItemListeners()， select(int)， deselect(int)， ItemEvent， ItemListener
  - removeItemListener
```
public void removeItemListener(ItemListener l)
```
    移除指定的项目侦听器，以便它不再从该列表中接收项目事件。如果听众 l是 null，不引发异常，则不执行行动。
    指对AWT的线程模型的细节AWT Threading Issues。
    
    Specified by:
    
    removeItemListener 接口 ItemSelectable
    
    参数
    
    l -项目的倾听者
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    addItemListener(java.awt.event.ItemListener)， getItemListeners()， ItemEvent， ItemListener
  - getItemListeners
```
public ItemListener[] getItemListeners()
```
    返回在这个列表上注册的所有项目的数组的数组。
    
    结果
    
    这一切的 ItemListeners列表或一个空数组如果没有项目的听众正在注册
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    addItemListener(java.awt.event.ItemListener)， removeItemListener(java.awt.event.ItemListener)， ItemEvent， ItemListener
  - addActionListener
```
public void addActionListener(ActionListener l)
```
    添加指定的操作侦听器从该列表中接收动作事件。当列表中有键盘焦点的用户双击列表项或类型时，会发生操作事件。
    如果听众l是null，不引发异常，则不执行行动。
    
    指对AWT的线程模型的细节AWT Threading Issues。
    
    参数
    
    l的监听行动
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    removeActionListener(java.awt.event.ActionListener)， getActionListeners()， ActionEvent， ActionListener
  - removeActionListener
```
public void removeActionListener(ActionListener l)
```
    移除指定的动作侦听器，以便它不再从该列表中接收动作事件。当用户双击列表项时发生操作事件。如果听众 l是 null，不引发异常，则不执行行动。
    参考AWT Threading Issues对AWT的线程模型的细节。
    
    参数
    
    l的监听行动
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    addActionListener(java.awt.event.ActionListener)， getActionListeners()， ActionEvent， ActionListener
  - getActionListeners
```
public ActionListener[] getActionListeners()
```
    返回在这个列表上注册的所有操作侦听器的数组。
    
    结果
    
    这一切的 ActionListeners列表或一个空数组如果没有行动的听众正在注册
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    addActionListener(java.awt.event.ActionListener)， removeActionListener(java.awt.event.ActionListener)， ActionEvent， ActionListener
  - getListeners
```
public <T extends EventListener> T[] getListeners(类<T> listenerType)
```
    返回对象的当前注册为 FooListeners在这 List数组。 FooListeners使用 addFooListener方法注册。如果没有这样
    您可以指定一个类的listenerType字面的说法，如FooListener.class。例如，你可以查询其产品的听众与下面的代码一List l：
```
itemlistener [] ILS =（itemlistener [ ]）（l.getlisteners（itemlistener。类））；
```
    听众的存在，此方法将返回空数组。
    重写：
    
    getListeners 方法重写，继承类 Component
    
    参数
    
    listenerType -听众的类型要求；这个参数应该指定一个接口，从 java.util.EventListener
    
    结果
    
    所有对象的注册名单上 FooListeners数组，或一个空数组如果没有这样的听众已添加
    
    异常
    
    ClassCastException -如果 listenerType不指定一个类或接口实现 java.util.EventListener
    
    从以下版本开始：
    
    一点三
    
    另请参见：
    
    getItemListeners()
  - processEvent
```
protected void processEvent(AWTEvent e)
```
    在这个滚动列表上处理事件。如果一个事件是 ItemEvent实例，它调用 processItemEvent方法。否则，如果事件是 ActionEvent实例，它调用 processActionEvent。如果事件不是一项事件或行动的事件，它调用父类的 processEvent上。
    注意，如果参数是null行为是不可能导致异常。
    
    重写：
    
    processEvent 方法重写，继承类 Component
    
    参数
    
    e -事件
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    ActionEvent， ItemEvent， processActionEvent(java.awt.event.ActionEvent)， processItemEvent(java.awt.event.ItemEvent)
  - processItemEvent
```
protected void processItemEvent(ItemEvent e)
```
    处理项目上发生的事件列表分派他们到任何注册 ItemListener对象。
    此方法不调用此方法，除非此组件启用了项目事件。当下列情况之一发生时，启用项目事件：
    - 一个ItemListener对象是通过addItemListener注册。
    - 项目活动能够通过enableEvents。
    注意，如果参数是null行为是不可能导致异常。
    参数
    
    e -项目活动
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    ItemEvent， ItemListener， addItemListener(java.awt.event.ItemListener)， Component.enableEvents(long)
  - processActionEvent
```
protected void processActionEvent(ActionEvent e)
```
    过程行动事件发生在这个组件分派他们到任何注册 ActionListener对象。
    此方法不被调用，除非此组件启用了动作事件。当下列情况之一发生时，启用了动作事件：
    - 一个ActionListener对象是通过addActionListener注册。
    - 动作事件能够通过enableEvents。
    注意，如果参数是null行为是不可能导致异常。
    参数
    
    e -动作事件
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    ActionEvent， ActionListener， addActionListener(java.awt.event.ActionListener)， Component.enableEvents(long)
  - paramString
```
protected String paramString()
```
    返回表示此滚动列表状态的参数字符串。此字符串用于调试。
    
    重写：
    
    paramString 方法重写，继承类 Component
    
    结果
    
    此滚动列表的参数字符串
  - delItems
```
@Deprecated
public void delItems(int start,
                                 int end)
```
    过时的。作为JDK 1.1版本，不为未来的公共使用。此方法预计将保留仅作为一个包私有方法。
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    获取与此相关的 AccessibleContext List。对于列表的 AccessibleContext以一个 AccessibleAWTList形式，创造了一个新的 AccessibleAWTList实例，如果必要的话。
    
    Specified by:
    
    getAccessibleContext 接口 Accessible
    
    重写：
    
    getAccessibleContext 方法重写，继承类 Component
    
    结果
    
    一个 AccessibleAWTList作为本 List的 AccessibleContext
    
    从以下版本开始：
    
    一点三

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class List

Nested Class Summary

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class java.awt.Component

Fields inherited from interface java.awt.image.ImageObserver

构造方法摘要

方法摘要

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

Constructor Detail

List

List

List

方法详细信息

addNotify

removeNotify

getItemCount

countItems

getItem

getItems

add

addItem

add

addItem

replaceItem

removeAll

clear

remove

remove

delItem

getSelectedIndex

getSelectedIndexes

getSelectedItem

getSelectedItems

getSelectedObjects

select

deselect

isIndexSelected

isSelected

getRows

isMultipleMode

allowsMultipleSelections

setMultipleMode

setMultipleSelections

getVisibleIndex

makeVisible

getPreferredSize

preferredSize

getPreferredSize

preferredSize

getMinimumSize

minimumSize

getMinimumSize

minimumSize

addItemListener

removeItemListener

getItemListeners

addActionListener

removeActionListener

getActionListeners

getListeners

processEvent

processItemEvent

processActionEvent

paramString

delItems

getAccessibleContext