JavaTM 2 Platform
Standard Ed. 5.0

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 为容器时,将生成以下滚动列表:

显示一个包含这些项的列表:Venus、Earth、JavaSoft 和 Mars。Javasoft 为选中状态。

如果 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 也将生成一个操作事件。

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

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

从以下版本开始:
JDK1.0
另请参见:
ItemEvent, ItemListener, ActionEvent, ActionListener, 序列化表格

嵌套类摘要
protected  class List.AccessibleAWTList
          此类实现 List 类的可访问性支持。
 
从类 java.awt.Component 继承的嵌套类/接口
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
字段摘要
 
从类 java.awt.Component 继承的字段
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
从接口 java.awt.image.ImageObserver 继承的字段
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
构造方法摘要
List()
          创建新的滚动列表。
List(int rows)
          创建一个用指定可视行数初始化的新滚动列表。
List(int rows, boolean multipleMode)
          创建一个初始化为显示指定行数的新滚动列表。
 
方法摘要
 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 version 1.1 开始,由 isMultipleMode() 取代。
 void clear()
          已过时。 从 JDK version 1.1 开始,由 removeAll() 取代。
 int countItems()
          已过时。 从 JDK version 1.1 开始,由 getItemCount() 取代。
 void delItem(int position)
          已过时。 remove(String)remove(int) 取代。
 void delItems(int start, int end)
          已过时。 从 JDK version 1.1 开始,后来不再公开使用。只有作为一种打包私有方法时,才希望保留此方法。
 void deselect(int index)
          取消选择指定索引处的项。
 AccessibleContext getAccessibleContext()
          获取与此 List 关联的 AccessibleContext
 ActionListener[] getActionListeners()
          返回已在此列表上注册的所有操作侦听器的数组。
 String getItem(int index)
          获取与指定索引关联的项。
 int getItemCount()
          获取列表中的项数。
 ItemListener[] getItemListeners()
          返回已在此列表上注册的所有项侦听器的数组。
 String[] getItems()
          获取列表中的项。
<T extends EventListener>
T[]
getListeners(Class<T> listenerType)
          返回目前已在此 List 上注册为 FooListener 的所有对象的数组。
 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 version 1.1 开始,由 isIndexSelected(int) 取代。
 void makeVisible(int index)
          使指定索引处的项可视。
 Dimension minimumSize()
          已过时。 从 JDK version 1.1 开始,由 getMinimumSize() 取代。
 Dimension minimumSize(int rows)
          已过时。 从 JDK version 1.1 开始,由 getMinimumSize(int) 取代。
protected  String paramString()
          返回表示此滚动列表状态的参数字符串。
 Dimension preferredSize()
          已过时。 从 JDK version 1.1 开始,由 getPreferredSize() 取代。
 Dimension preferredSize(int rows)
          已过时。 从 JDK version 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 version 1.1 开始,由 setMultipleMode(boolean) 取代。
 
从类 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, 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, 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
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

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

@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 version 1.1 开始,由 removeAll() 取代。


remove

public void remove(String item)
从列表中移除项的第一次出现。如果选中了指定的项,并且该项是列表中惟一选中的项,则列表将被设置为无选择。

参数:
item - 从列表中移除的项
抛出:
IllegalArgumentException - 如果列表中不存在该项
从以下版本开始:
JDK1.1

remove

public void remove(int position)
从此滚动列表中移除指定位置处的项。如果选中了指定位置的项,并且该项是列表中惟一选中的项,则列表将被设置为无选择。

参数:
position - 要删除项的索引
抛出:
ArrayIndexOutOfBoundsException - 如果 position 小于零或大于 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()
获取对象数组中此滚动列表的选中项。

指定者:
接口 ItemSelectable 中的 getSelectedObjects
返回:
表示此滚动列表中选中项的 Object 数组;如果没有选中的项,则会返回一个零长度的数组。
另请参见:
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 version 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 version 1.1 开始,由 isMultipleMode() 取代。


setMultipleMode

public void setMultipleMode(boolean b)
设置确定此列表是否允许多项选择的标志。当选择模式从多项选择更改为单项选择时,选中的项将会发生以下变化:如果选中的项具有位置光标,则只有该项仍保持选中。如果无选中项具有位置光标,则所有项都将取消选中。

参数:
b - 如果为 true,则允许多项选择;否则,只能一次从列表中选择一项。
从以下版本开始:
JDK1.1
另请参见:
isMultipleMode()

setMultipleSelections

@Deprecated
public void setMultipleSelections(boolean b)
已过时。 从 JDK version 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 version 1.1 开始,由 getPreferredSize(int) 取代。


getPreferredSize

public Dimension getPreferredSize()
获取此滚动列表的首选大小。

覆盖:
Component 中的 getPreferredSize
返回:
用于显示此滚动列表的首选维数
从以下版本开始:
JDK1.1
另请参见:
Component.getPreferredSize()

preferredSize

@Deprecated
public Dimension preferredSize()
已过时。 从 JDK version 1.1 开始,由 getPreferredSize() 取代。

覆盖:
Component 中的 preferredSize

getMinimumSize

public Dimension getMinimumSize(int rows)
获取具有指定行数的列表的最少维数。

参数:
rows - 列表的行数
返回:
给出此滚动列表必须可视的指定行数,返回用于显示滚动列表的最少维数
从以下版本开始:
JDK1.1
另请参见:
Component.getMinimumSize()

minimumSize

@Deprecated
public Dimension minimumSize(int rows)
已过时。 从 JDK version 1.1 开始,由 getMinimumSize(int) 取代。


getMinimumSize

public Dimension getMinimumSize()
确定此滚动列表的最小大小。

覆盖:
Component 中的 getMinimumSize
返回:
显示此滚动列表所需的最少维数
从以下版本开始:
JDK1.1
另请参见:
Component.getMinimumSize()

minimumSize

@Deprecated
public Dimension minimumSize()
已过时。 从 JDK version 1.1 开始,由 getMinimumSize() 取代。

覆盖:
Component 中的 minimumSize

addItemListener

public void addItemListener(ItemListener l)
添加指定的项侦听器以接收此列表的项事件。发送项事件以响应用户输入,但不响应对 selectdeselect 的调用。如果侦听器 lnull,则不会抛出异常,并且不执行操作。

指定者:
接口 ItemSelectable 中的 addItemListener
参数:
l - 项侦听器
从以下版本开始:
JDK1.1
另请参见:
removeItemListener(java.awt.event.ItemListener), getItemListeners(), select(int), deselect(int), ItemEvent, ItemListener

removeItemListener

public void removeItemListener(ItemListener l)
移除指定的项侦听器,以便不再从此列表接收项事件。如果侦听器 lnull,则不会抛出异常,并且不执行操作。

指定者:
接口 ItemSelectable 中的 removeItemListener
参数:
l - 项侦听器
从以下版本开始:
JDK1.1
另请参见:
addItemListener(java.awt.event.ItemListener), getItemListeners(), ItemEvent, ItemListener

getItemListeners

public ItemListener[] getItemListeners()
返回已在此列表上注册的所有项侦听器的数组。

返回:
此列表的所有 ItemListener,如果当前没有已注册的项侦听器,则返回一个空数组。
从以下版本开始:
1.4
另请参见:
addItemListener(java.awt.event.ItemListener), removeItemListener(java.awt.event.ItemListener), ItemEvent, ItemListener

addActionListener

public void addActionListener(ActionListener l)
添加指定的操作侦听器以从此列表接收操作事件。当用户双击列表项时或者在此列表具有键盘焦点时按 Enter 键,将发生操作事件。

如果侦听器 lnull,则不会抛出异常,并且不执行操作。

参数:
l - 操作侦听器
从以下版本开始:
JDK1.1
另请参见:
removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListener

removeActionListener

public void removeActionListener(ActionListener l)
移除指定的操作侦听器,以便不再从此列表接收操作事件。当用户双击列表项时,将发生操作事件。如果侦听器 lnull,则不会抛出异常,并且不执行操作。

参数:
l - 操作侦听器
从以下版本开始:
JDK1.1
另请参见:
addActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListener

getActionListeners

public ActionListener[] getActionListeners()
返回已在此列表上注册的所有操作侦听器的数组。

返回:
此列表的所有 ActionListener,如果当前没有已注册的动作侦听器,则返回一个空数组。
从以下版本开始:
1.4
另请参见:
addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener), ActionEvent, ActionListener

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)
返回目前已在此 List 上注册为 FooListener 的所有对象的数组。FooListener 是用 addFooListener 方法注册的。

可以使用 class 字面值来指定 listenerType 参数,如 FooListener.class。例如,可以查询其项侦听器具有以下代码的 List l

ItemListener[] ils = (ItemListener[])(l.getListeners(ItemListener.class));
如果不存在这样的侦听器,则此方法将返回一个空数组。

覆盖:
Component 中的 getListeners
参数:
listenerType - 请求的侦听器类型;此参数应该指定一个从 java.util.EventListener 遗传下来的接口
返回:
在此列表上注册为 FooListener 的所有对象的数组
抛出:
ClassCastException - 如果 listenerType 未指定实现 java.util.EventListener 的类或接口。
从以下版本开始:
1.3
另请参见:
getItemListeners()

processEvent

protected void processEvent(AWTEvent e)
此滚动列表的进程事件。如果事件是 ItemEvent 的一个实例,则该事件将调用 processItemEvent 方法。另外,如果事件是 ActionEvent 的一个实例,则它将调用 processActionEvent。如果事件不是一个项事件或操作事件,则它将调用超类的 processEvent

注意,如果事件参数为 null,则行为未指定,并可能抛出异常。

覆盖:
Component 中的 processEvent
参数:
e - 事件
从以下版本开始:
JDK1.1
另请参见:
ActionEvent, ItemEvent, processActionEvent(java.awt.event.ActionEvent), processItemEvent(java.awt.event.ItemEvent)

processItemEvent

protected void processItemEvent(ItemEvent e)
处理发生在此列表上的项事件,方法是将这些事件指派给所有已注册的 ItemListener 对象。

除非此组件启用了项事件,才会调用此方法。当出现以下情况时,将启用项事件:

注意,如果事件参数为 null,则行为未指定,并可能抛出异常。

参数:
e - 项事件
从以下版本开始:
JDK1.1
另请参见:
ItemEvent, ItemListener, addItemListener(java.awt.event.ItemListener), Component.enableEvents(long)

processActionEvent

protected void processActionEvent(ActionEvent e)
处理发生在此列表上的操作事件,方法是将这些事件指派给所有已注册的 ActionListener 对象。

除非此组件启用了操作事件,才会调用此方法。当出现以下情况时,将启用操作事件:

注意,如果事件参数为 null,则行为未指定,并可能导致一个异常。

参数:
e - 操作事件
从以下版本开始:
JDK1.1
另请参见:
ActionEvent, ActionListener, addActionListener(java.awt.event.ActionListener), Component.enableEvents(long)

paramString

protected String paramString()
返回表示此滚动列表状态的参数字符串。此字符串对调试很有用。

覆盖:
Component 中的 paramString
返回:
此滚动列表的参数字符串

delItems

@Deprecated
public void delItems(int start,
                                int end)
已过时。 从 JDK version 1.1 开始,后来不再公开使用。只有作为一种打包私有方法时,才希望保留此方法。


getAccessibleContext

public AccessibleContext getAccessibleContext()
获取与此 List 关联的 AccessibleContext。对于列表,AccessibleContext 采用 AccessibleAWTList 的形式。如有必要,可以创建一个新的 AccessibleAWTList 实例。

指定者:
接口 Accessible 中的 getAccessibleContext
覆盖:
Component 中的 getAccessibleContext
返回:
一个 AccessibleAWTList,它将充当此 ListAccessibleContext

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策