|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.AbstractButton javax.swing.JMenuItem
public class JMenuItem
菜单中的项的实现。菜单项本质上是位于列表中的按钮。当用户选择“按钮”时,将执行与菜单项关联的操作。JPopupMenu
中包含的 JMenuItem
正好执行该功能。
有关更多文档和示例,请参见《The Java Tutorial》中的 How to Use Menus 一节。
警告:此类已序列化的对象将不再与以后的 Swing 版本兼容。当前的序列化支持适合于在运行相同 Swing 版本的应用程序之间短期存储或 RMI。从 1.4 版本开始,已在 java.beans
包中添加了支持所有 JavaBeansTM 长期存储的功能。请参阅 XMLEncoder
。
JPopupMenu
,
JMenu
,
JCheckBoxMenuItem
,
JRadioButtonMenuItem
嵌套类摘要 | |
---|---|
protected class |
JMenuItem.AccessibleJMenuItem
此类实现 JMenuItem 类的可访问性支持。 |
从类 javax.swing.AbstractButton 继承的嵌套类/接口 |
---|
AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener |
从类 javax.swing.JComponent 继承的嵌套类/接口 |
---|
JComponent.AccessibleJComponent |
从类 java.awt.Container 继承的嵌套类/接口 |
---|
Container.AccessibleAWTContainer |
从类 java.awt.Component 继承的嵌套类/接口 |
---|
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy |
字段摘要 |
---|
从类 javax.swing.JComponent 继承的字段 |
---|
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW |
从类 java.awt.Component 继承的字段 |
---|
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
从接口 javax.swing.SwingConstants 继承的字段 |
---|
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST |
从接口 java.awt.image.ImageObserver 继承的字段 |
---|
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
构造方法摘要 | |
---|---|
JMenuItem()
创建不带有设置文本或图标的 JMenuItem 。 |
|
JMenuItem(Action a)
创建一个从指定的 Action 获取其属性的菜单项。 |
|
JMenuItem(Icon icon)
创建带有指定图标的 JMenuItem 。 |
|
JMenuItem(String text)
创建带有指定文本的 JMenuItem 。 |
|
JMenuItem(String text,
Icon icon)
创建带有指定文本和图标的 JMenuItem 。 |
|
JMenuItem(String text,
int mnemonic)
创建带有指定文本和键盘助记符的 JMenuItem 。 |
方法摘要 | |
---|---|
void |
addMenuDragMouseListener(MenuDragMouseListener l)
将 MenuDragMouseListener 添加到菜单项。 |
void |
addMenuKeyListener(MenuKeyListener l)
将 MenuKeyListener 添加到菜单项。 |
protected void |
configurePropertiesFromAction(Action a)
该工厂方法根据 Action 实例的值设置 ActionEvent 源的属性。 |
protected PropertyChangeListener |
createActionPropertyChangeListener(Action a)
该工厂方法在 ActionEvent 的 Action 实例上的属性发生更改时创建用于更新 ActionEvent 源的 PropertyChangeListener 。 |
protected void |
fireMenuDragMouseDragged(MenuDragMouseEvent event)
通知所有对此事件类型上的通知感兴趣的已注册侦听器。 |
protected void |
fireMenuDragMouseEntered(MenuDragMouseEvent event)
通知所有对此事件类型上的通知感兴趣的已注册侦听器。 |
protected void |
fireMenuDragMouseExited(MenuDragMouseEvent event)
通知所有对此事件类型上的通知感兴趣的已注册侦听器。 |
protected void |
fireMenuDragMouseReleased(MenuDragMouseEvent event)
通知所有对此事件类型上的通知感兴趣的已注册侦听器。 |
protected void |
fireMenuKeyPressed(MenuKeyEvent event)
通知所有对此事件类型上的通知感兴趣的已注册侦听器。 |
protected void |
fireMenuKeyReleased(MenuKeyEvent event)
通知所有对此事件类型上的通知感兴趣的已注册侦听器。 |
protected void |
fireMenuKeyTyped(MenuKeyEvent event)
通知所有对此事件类型上的通知感兴趣的已注册侦听器。 |
KeyStroke |
getAccelerator()
返回作为菜单项的加速器的 KeyStroke 。 |
AccessibleContext |
getAccessibleContext()
返回与此 JMenuItem 相关的 AccessibleContext 。 |
Component |
getComponent()
返回用于绘制此对象的 java.awt.Component 。 |
MenuDragMouseListener[] |
getMenuDragMouseListeners()
返回利用 addMenuDragMouseListener() 添加到此 JMenuItem 的所有 MenuDragMouseListener 组成的数组。 |
MenuKeyListener[] |
getMenuKeyListeners()
返回利用 addMenuKeyListener() 添加到此 JMenuItem 的所有 MenuKeyListener 的数组。 |
MenuElement[] |
getSubElements()
此方法返回包含此菜单组件的子菜单组件的数组。 |
String |
getUIClassID()
返回用于构造呈现此组件时使用的 L&F 类名称的后缀。 |
protected void |
init(String text,
Icon icon)
利用指定文本和图标初始化菜单项。 |
boolean |
isArmed()
返回菜单项是否被“调出”。 |
void |
menuSelectionChanged(boolean isIncluded)
当选择或取消选择 MenuElement 时由 MenuSelectionManager 调用。 |
protected String |
paramString()
返回此 JMenuItem 的字符串表示形式。 |
void |
processKeyEvent(KeyEvent e,
MenuElement[] path,
MenuSelectionManager manager)
通过使用 MenuSelectionManager 的 API 处理从 MenuSelectionManager 转发的键事件,并在需要时更改菜单选择。 |
void |
processMenuDragMouseEvent(MenuDragMouseEvent e)
处理菜单中的鼠标拖动。 |
void |
processMenuKeyEvent(MenuKeyEvent e)
处理菜单中的快捷键。 |
void |
processMouseEvent(MouseEvent e,
MenuElement[] path,
MenuSelectionManager manager)
通过使用 MenuSelectionManager 的 API 处理从 MenuSelectionManager 转发的鼠标事件,并在需要时更改菜单选择。 |
void |
removeMenuDragMouseListener(MenuDragMouseListener l)
从菜单项中移除 MenuDragMouseListener 。 |
void |
removeMenuKeyListener(MenuKeyListener l)
从菜单项中移除 MenuKeyListener 。 |
void |
setAccelerator(KeyStroke keyStroke)
设置组合键,它能直接调用菜单项的操作侦听器而不必显示菜单的层次结构。 |
void |
setArmed(boolean b)
将菜单项标识为“调出”。 |
void |
setEnabled(boolean b)
启用或禁用菜单项。 |
void |
setUI(MenuItemUI ui)
设置呈现此组件的外观对象。 |
void |
updateUI()
利用当前外观的值重置 UI 属性。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
构造方法详细信息 |
---|
public JMenuItem()
JMenuItem
。
public JMenuItem(Icon icon)
JMenuItem
。
icon
- JMenuItem
的图标public JMenuItem(String text)
JMenuItem
。
text
- JMenuItem
的文本public JMenuItem(Action a)
Action
获取其属性的菜单项。
a
- JMenuItem
的操作public JMenuItem(String text, Icon icon)
JMenuItem
。
text
- JMenuItem
的文本icon
- JMenuItem
图标public JMenuItem(String text, int mnemonic)
JMenuItem
。
text
- JMenuItem
的文本mnemonic
- JMenuItem
的键盘助记符方法详细信息 |
---|
protected void init(String text, Icon icon)
AbstractButton
中的 init
text
- JMenuItem
的文本icon
- JMenuItem
图标public void setUI(MenuItemUI ui)
ui
- JMenuItemUI
L&F 对象UIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
AbstractButton
中的 updateUI
JComponent.updateUI()
public String getUIClassID()
JComponent
中的 getUIClassID
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public void setArmed(boolean b)
b
- true 表示调出菜单项以供选择public boolean isArmed()
setArmed(boolean)
public void setEnabled(boolean b)
AbstractButton
中的 setEnabled
b
- true 表示启用项Component.isEnabled()
,
Component.isLightweight()
public void setAccelerator(KeyStroke keyStroke)
keyStroke
- 将作为加速器的 KeyStroke
public KeyStroke getAccelerator()
KeyStroke
。
KeyStroke
对象protected void configurePropertiesFromAction(Action a)
Action
实例的值设置 ActionEvent
源的属性。对于子类,设置的属性可能不同。默认情况下,此方法设置与 AbstractButton.configurePropertiesFromAction()
相同的属性,加上 Accelerator
。
AbstractButton
中的 configurePropertiesFromAction
a
- 从中获取属性的 Action
,或者为 null
Action
,
AbstractButton.setAction(javax.swing.Action)
protected PropertyChangeListener createActionPropertyChangeListener(Action a)
ActionEvent
的 Action
实例上的属性发生更改时创建用于更新 ActionEvent
源的 PropertyChangeListener
。如果属性集(应该保持最新)不同,则子类可以重写此方法以提供它们自己的 PropertyChangeListener
。
注意,PropertyChangeListener
应该避免保持到 ActionEvent
源的强引用,因为强引用可能影响 ActionEvent
源及其包含层次结构中所有组件的垃圾回收。
AbstractButton
中的 createActionPropertyChangeListener
a
- 从中获取属性的 Action
,或者为 null
Action
public void processMouseEvent(MouseEvent e, MenuElement[] path, MenuSelectionManager manager)
MenuSelectionManager
的 API 处理从 MenuSelectionManager
转发的鼠标事件,并在需要时更改菜单选择。
注:不必将事件转发到子组件。此操作可以通过 MenuSelectionManager
自动完成。
MenuElement
中的 processMouseEvent
e
- MouseEvent
path
- MenuElement
路径数组manager
- MenuSelectionManager
public void processKeyEvent(KeyEvent e, MenuElement[] path, MenuSelectionManager manager)
MenuSelectionManager
的 API 处理从 MenuSelectionManager
转发的键事件,并在需要时更改菜单选择。
注:不必将事件转发到子组件。此操作可以通过 MenuSelectionManager
自动完成。
MenuElement
中的 processKeyEvent
e
- KeyEvent
path
- MenuElement
路径数组manager
- MenuSelectionManager
public void processMenuDragMouseEvent(MenuDragMouseEvent e)
e
- MenuDragMouseEvent
对象public void processMenuKeyEvent(MenuKeyEvent e)
e
- 一个 MenuKeyEvent
对象protected void fireMenuDragMouseEntered(MenuDragMouseEvent event)
event
- MenuMouseDragEvent
EventListenerList
protected void fireMenuDragMouseExited(MenuDragMouseEvent event)
event
- MenuDragMouseEvent
EventListenerList
protected void fireMenuDragMouseDragged(MenuDragMouseEvent event)
event
- MenuDragMouseEvent
EventListenerList
protected void fireMenuDragMouseReleased(MenuDragMouseEvent event)
event
- MenuDragMouseEvent
EventListenerList
protected void fireMenuKeyPressed(MenuKeyEvent event)
event
- MenuKeyEvent
EventListenerList
protected void fireMenuKeyReleased(MenuKeyEvent event)
event
- MenuKeyEvent
EventListenerList
protected void fireMenuKeyTyped(MenuKeyEvent event)
event
- MenuKeyEvent
EventListenerList
public void menuSelectionChanged(boolean isIncluded)
MenuElement
时由 MenuSelectionManager
调用。
MenuElement
中的 menuSelectionChanged
isIncluded
- 如果此菜单项位于发生更改的菜单路径部分,则为 true;如果此菜单项位于发生更改的菜单路径部分,但该路径的这一特殊部分与更改前相同,则为 falseMenuSelectionManager.setSelectedPath(MenuElement[])
public MenuElement[] getSubElements()
MenuElement
中的 getSubElements
MenuElement
的数组public Component getComponent()
java.awt.Component
。返回的组件用于转换事件并检测事件是否位于菜单组件中。
MenuElement
中的 getComponent
Component
public void addMenuDragMouseListener(MenuDragMouseListener l)
MenuDragMouseListener
添加到菜单项。
l
- 要添加的 MenuDragMouseListener
public void removeMenuDragMouseListener(MenuDragMouseListener l)
MenuDragMouseListener
。
l
- 要移除的 MenuDragMouseListener
public MenuDragMouseListener[] getMenuDragMouseListeners()
MenuDragMouseListener
组成的数组。
MenuDragMouseListener
,如果没有添加侦听器,则返回一个空数组public void addMenuKeyListener(MenuKeyListener l)
MenuKeyListener
添加到菜单项。
l
- 要添加的 MenuKeyListener
public void removeMenuKeyListener(MenuKeyListener l)
MenuKeyListener
。
l
- 要移除的 MenuKeyListener
public MenuKeyListener[] getMenuKeyListeners()
MenuKeyListener
的数组。
MenuKeyListener
,如果没有添加侦听器,则返回一个空数组protected String paramString()
JMenuItem
的字符串表示形式。此方法仅在进行调试的时候使用,对于各个实现,所返回字符串的内容和格式可能有所不同。返回的字符串可能为空,但不可能为 null
。
AbstractButton
中的 paramString
JMenuItem
的字符串表示形式public AccessibleContext getAccessibleContext()
JMenuItem
相关的 AccessibleContext
。对于 JMenuItem
,AccessibleContext
采用的是 AccessibleJMenuItem
的形式。必要时要创建新的 AccessibleJMenuItme 实例。
Accessible
中的 getAccessibleContext
JComponent
中的 getAccessibleContext
JMenuItem
的 AccessibleContext
的 AccessibleJMenuItem
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。