- 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
向列表发送一个ActionEvent
的实例。 当选择列表中的项目时,AWT还会生成一个动作事件,当用户按下返回键时。如果应用程序想要根据用户选择或激活的此列表中的项目执行某些操作,则应根据需要实现
ItemListener
或ActionListener
,并注册新的监听器以从该列表接收事件。对于多选择滚动列表,它被认为是更好的用户界面来使用外部手势(例如单击按钮)来触发动作。
- 从以下版本开始:
- 1.0
- 另请参见:
-
ItemEvent
,ItemListener
,ActionEvent
,ActionListener
, Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class 描述 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
-
-
方法摘要
所有方法 接口方法 具体的方法 弃用的方法 Modifier and Type 方法 描述 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(Class<T> listenerType)
返回当前注册为FooListener
的所有对象的数组,这个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, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate
-
-
-
-
构造方法详细信息
-
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。 - 从以下版本开始:
- 1.1
- 另请参见:
-
GraphicsEnvironment.isHeadless()
-
List
public List(int rows, boolean multipleMode) throws HeadlessException
创建一个初始化的新滚动列表,以显示指定的行数。 请注意,如果指定了零行,则将创建列表,其默认值为四行。 还要注意,列表中可见行的数量在创建后不能更改。 如果multipleMode
值为true
,则用户可以从列表中选择多个项目。 如果是false
,则false
只能选择一个项目。- 参数
-
rows
- 要显示的项目数。 -
multipleMode
- 如果是true
,则允许多个选择; 否则,一次只能选择一个项目。 - 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless()返回true。 - 另请参见:
-
GraphicsEnvironment.isHeadless()
-
-
方法详细信息
-
addNotify
public void addNotify()
创建列表的对等体。 对等体允许我们修改列表的外观而不改变它的功能。
-
removeNotify
public void removeNotify()
删除此列表的对等体。 对等体允许我们修改列表的外观而不改变它的功能。
-
getItemCount
public int getItemCount()
获取列表中的项目数。- 结果
- 列表中的项目数
- 从以下版本开始:
- 1.1
- 另请参见:
-
getItem(int)
-
countItems
@Deprecated public int countItems()
已过时。 从JDK 1.1版开始,由getItemCount()
替代。返回列表中的项目数。- 结果
- 列表中的项目数
-
getItem
public String getItem(int index)
获取与指定索引关联的项目。- 参数
-
index
- 项目的位置 - 结果
- 与指定索引相关联的项目
- 另请参见:
-
getItemCount()
-
getItems
public String[] getItems()
获取列表中的项目。- 结果
- 一个包含列表项的字符串数组
- 从以下版本开始:
- 1.1
- 另请参见:
-
select(int)
,deselect(int)
,isIndexSelected(int)
-
add
public void add(String item)
将指定的项目添加到滚动列表的末尾。- 参数
-
item
- 要添加的项目 - 从以下版本开始:
- 1.1
-
addItem
@Deprecated public void addItem(String item)
已过时。 替换为add(String)
。将指定的项目添加到列表的末尾。- 参数
-
item
- 要添加的项目
-
add
public void add(String item, int index)
在指定的位置将指定的项目添加到滚动列表。 索引为零。 如果索引的值小于零,或者如果索引的值大于或等于列表中的项目数,则将项添加到列表的末尾。- 参数
-
item
- 要添加的项目; 如果此参数为null
则该项目被视为空字符串,""
-
index
- 添加项目的位置 - 从以下版本开始:
- 1.1
-
addItem
@Deprecated public void addItem(String item, int index)
已过时。 替换为add(String, int)
。在索引指示的位置将指定的项目添加到列表中。- 参数
-
item
- 要添加的项目 -
index
- 添加项目的位置
-
replaceItem
public void replaceItem(String newValue, int index)
使用新的字符串替换滚动列表中指定索引处的项目。- 参数
-
newValue
- 用于替换现有项目的新字符串 -
index
- 要更换的项目的位置 - 异常
-
ArrayIndexOutOfBoundsException
- 如果index
超出范围
-
removeAll
public void removeAll()
从此列表中删除所有项目。- 从以下版本开始:
- 1.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
- 如果项目不存在于列表中 - 从以下版本开始:
- 1.1
-
remove
public void remove(int position)
从此滚动列表中移除指定位置的项目。 如果选择了具有指定位置的项目,并且是列表中唯一选择的项目,列表将被设置为不选择。- 参数
-
position
- 要删除的项目的索引 - 异常
-
ArrayIndexOutOfBoundsException
- 如果position
小于0或大于getItemCount()-1
- 从以下版本开始:
- 1.1
- 另请参见:
-
add(String, int)
-
delItem
@Deprecated public void delItem(int position)
已过时。 替换为remove(String)
和remove(int)
。删除指定位置的项目。- 参数
-
position
- 要删除的项目的索引
-
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
- 结果
-
表示此滚动列表上所选项目的数组
Object
s; 如果未选择任何项目,则返回零长度数组。 - 另请参见:
-
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
否则 - 从以下版本开始:
- 1.1
- 另请参见:
-
select(int)
,deselect(int)
-
isSelected
@Deprecated public boolean isSelected(int index)
已过时。 从JDK 1.1版开始,由isIndexSelected(int)
替代。确定列表中指定的项是否被选中。- 参数
-
index
- 指定要检查的项目 - 结果
-
true
如果选择该项目; 否则false
-
getRows
public int getRows()
获取此列表中的可见行数。 注意,一旦创建了这个List
,这个数字就永远不会改变。- 结果
- 此滚动列表中的可见行数
-
isMultipleMode
public boolean isMultipleMode()
确定此列表是否允许多个选择。- 结果
-
true
如果此列表允许多个选择; 否则,false
- 从以下版本开始:
- 1.1
- 另请参见:
-
setMultipleMode(boolean)
-
allowsMultipleSelections
@Deprecated public boolean allowsMultipleSelections()
已过时。 从JDK 1.1版开始,由isMultipleMode()
替代。确定此列表是否允许多个选择。- 结果
-
true
如果此列表允许多个选择; 否则false
-
setMultipleMode
public void setMultipleMode(boolean b)
设置确定此列表是否允许多个选择的标志。 当选择模式从多选择更改为单选时,所选项目将如下更改:如果所选项目具有位置光标,则只会选择该项目。 如果没有选定的项目具有位置光标,则所有项目将被取消选择。- 参数
-
b
- 如果true
则允许多个选择; 否则,只能从列表中选择一个项目 - 从以下版本开始:
- 1.1
- 另请参见:
-
isMultipleMode()
-
setMultipleSelections
@Deprecated public void setMultipleSelections(boolean b)
已过时。 从JDK 1.1版开始,由setMultipleMode(boolean)
替代。启用或禁用此列表的多选模式。- 参数
-
b
-true
启用多模式,否则为false
-
getVisibleIndex
public int getVisibleIndex()
获取方法makeVisible
上次显示的项目的索引。- 结果
- 上次显示的项目的索引
- 另请参见:
-
makeVisible(int)
-
makeVisible
public void makeVisible(int index)
使指定索引处的项目可见。- 参数
-
index
- 项目的位置 - 另请参见:
-
getVisibleIndex()
-
getPreferredSize
public Dimension getPreferredSize(int rows)
获取具有指定行数的列表的首选尺寸。- 参数
-
rows
- 列表中的行数 - 结果
- 给定指定行数必须可见的显示此滚动列表的首选尺寸
- 从以下版本开始:
- 1.1
- 另请参见:
-
Component.getPreferredSize()
-
preferredSize
@Deprecated public Dimension preferredSize(int rows)
已过时。 从JDK 1.1版开始,替换为getPreferredSize(int)
。返回此组件的首选大小,假设它具有指定的行数。- 参数
-
rows
- 行数 - 结果
- 用于显示此列表的首选尺寸
-
getPreferredSize
public Dimension getPreferredSize()
获取此滚动列表的首选大小。- 重写:
-
getPreferredSize
在Component
- 结果
- 用于显示此滚动列表的首选尺寸
- 从以下版本开始:
- 1.1
- 另请参见:
-
Component.getPreferredSize()
-
preferredSize
@Deprecated public Dimension preferredSize()
已过时。 自JDK 1.1版起,由getPreferredSize()
取代。描述从类别复制:Component
返回组件的首选大小。- 重写:
-
preferredSize
在Component
- 结果
- 该组件的首选尺寸
-
getMinimumSize
public Dimension getMinimumSize(int rows)
获取具有指定行数的列表的最小尺寸。- 参数
-
rows
- 列表中的行数 - 结果
- 给定指定行数必须可见的显示此滚动列表的最小尺寸
- 从以下版本开始:
- 1.1
- 另请参见:
-
Component.getMinimumSize()
-
minimumSize
@Deprecated public Dimension minimumSize(int rows)
已过时。 从JDK 1.1版开始,由getMinimumSize(int)
替代。返回具有指定行数的列表的最小尺寸。- 参数
-
rows
- 列表中的行数 - 结果
- 显示此列表的最小尺寸
-
getMinimumSize
public Dimension getMinimumSize()
确定此滚动列表的最小大小。- 重写:
-
getMinimumSize
在Component
- 结果
- 显示此滚动列表所需的最小尺寸
- 从以下版本开始:
- 1.1
- 另请参见:
-
Component.getMinimumSize()
-
minimumSize
@Deprecated public Dimension minimumSize()
已过时。 从JDK 1.1版开始,替换为getMinimumSize()
。描述从类复制:Component
返回此组件的最小大小。- 重写:
-
minimumSize
在Component
- 结果
- 该组件的最小尺寸
-
addItemListener
public void addItemListener(ItemListener l)
添加指定的项目侦听器以从该列表接收项目事件。 项目事件是响应于用户输入发送的,但不响应对select
或deselect
调用。 如果监听器l
为null
,则不会抛出异常并且不执行任何操作。有关AWT线程模型的详细信息,请参阅AWT Threading Issues 。
- Specified by:
-
addItemListener
在接口ItemSelectable
- 参数
-
l
- 项目监听器 - 从以下版本开始:
- 1.1
- 另请参见:
-
removeItemListener(java.awt.event.ItemListener)
,getItemListeners()
,select(int)
,deselect(int)
,ItemEvent
,ItemListener
-
removeItemListener
public void removeItemListener(ItemListener l)
- Specified by:
-
removeItemListener
在接口ItemSelectable
- 参数
-
l
- 项目监听器 - 从以下版本开始:
- 1.1
- 另请参见:
-
addItemListener(java.awt.event.ItemListener)
,getItemListeners()
,ItemEvent
,ItemListener
-
getItemListeners
public ItemListener[] getItemListeners()
返回在此列表中注册的所有项目侦听器的数组。- 结果
-
所有这个列表的
ItemListener
s或一个空数组,如果没有项目监听器当前注册 - 从以下版本开始:
- 1.4
- 另请参见:
-
addItemListener(java.awt.event.ItemListener)
,removeItemListener(java.awt.event.ItemListener)
,ItemEvent
,ItemListener
-
addActionListener
public void addActionListener(ActionListener l)
添加指定的动作侦听器以从此列表接收动作事件。 当用户双击列表项时,会发生动作事件,或者当列表具有键盘焦点时,键入Enter。如果监听器
l
为null
,则不会抛出异常并且不执行任何操作。有关AWT线程模型的详细信息,请参阅AWT Threading Issues 。
- 参数
-
l
- 动作侦听器 - 从以下版本开始:
- 1.1
- 另请参见:
-
removeActionListener(java.awt.event.ActionListener)
,getActionListeners()
,ActionEvent
,ActionListener
-
removeActionListener
public void removeActionListener(ActionListener l)
删除指定的动作侦听器,使其不再从此列表中接收到动作事件。 当用户双击列表项时,会发生操作事件。 如果监听器l
为null
,则不会抛出异常并且不执行任何操作。有关AWT线程模型的详细信息,请参阅AWT Threading Issues 。
- 参数
-
l
- 动作侦听器 - 从以下版本开始:
- 1.1
- 另请参见:
-
addActionListener(java.awt.event.ActionListener)
,getActionListeners()
,ActionEvent
,ActionListener
-
getActionListeners
public ActionListener[] getActionListeners()
返回在此列表中注册的所有动作侦听器的数组。- 结果
-
所有这个列表的
ActionListener
s或一个空数组,如果没有动作侦听器当前注册 - 从以下版本开始:
- 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
方法注册。您可以使用类文字指定
listenerType
参数,如FooListener.class
。 例如,您可以使用以下代码查询List l
其项监听器:ItemListener[] ils = (ItemListener[])(l.getListeners(ItemListener.class));
如果没有这样的侦听器存在,这个方法返回一个空数组。- 重写:
-
getListeners
在Component
- 参数类型
-
T
- 听众的类型 - 参数
-
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
,行为是未指定的,可能会导致异常。- 重写:
-
processEvent
在Component
- 参数
-
e
- 事件 - 从以下版本开始:
- 1.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
- 项目事件 - 从以下版本开始:
- 1.1
- 另请参见:
-
ItemEvent
,ItemListener
,addItemListener(java.awt.event.ItemListener)
,Component.enableEvents(long)
- 一个
-
processActionEvent
protected void processActionEvent(ActionEvent e)
通过将此组件发送到任何已注册的ActionListener
对象来处理此组件上发生的操作事件。除非为此组件启用了操作事件,否则不会调用此方法。 当发生以下情况之一时,启用操作事件:
- 通过
addActionListener
注册一个ActionListener
对象。 - 操作事件通过
enableEvents
启用。
请注意,如果事件参数为
null
则行为未指定,可能会导致异常。- 参数
-
e
- 动作事件 - 从以下版本开始:
- 1.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版开始,未来不会公开使用。 这种方法只能作为一个包私有方法保留。删除指定索引范围内的列表项。- 参数
-
start
- 要删除的范围的开始索引 -
end
- 要删除的范围的结束索引
-
getAccessibleContext
public AccessibleContext getAccessibleContext()
获取AccessibleContext
与此List
相关联。 对于名单中,AccessibleContext
需要一个形式AccessibleAWTList
。 如果需要,将创建一个新的AccessibleAWTList
实例。- Specified by:
-
getAccessibleContext
在接口Accessible
- 重写:
-
getAccessibleContext
在Component
- 结果
-
一个
AccessibleAWTList
,作为AccessibleContext
的这个List
- 从以下版本开始:
- 1.3
-
-