|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.AbstractButton javax.swing.JMenuItem
public class JMenuItem
菜单中的项的实现。菜单项本质上是位于列表中的按钮。当用户选择“按钮”时,则执行与菜单项关联的操作。JPopupMenu
中包含的 JMenuItem
正好执行该功能。
通过 Action
可以配置菜单,并进行一定程度的控制。对菜单项使用 Action
有许多直接配置菜单项所不及的优点。有关更多信息,请参阅支持 Action
的 Swing 组件,可以在 The Java Tutorial 中的 How to Use Actions 一节找到更多信息。
有关更多文档和示例,请参见 The Java Tutorial 中的 How to Use Menus 一节。
警告:Swing 不是线程安全的。有关更多信息,请参阅 Swing's Threading Policy。
警告:此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储,或适用于在运行相同 Swing 版本的应用程序之间进行 RMI(Remote Method Invocation,远程方法调用)。从 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.BaselineResizeBehavior, 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 。 |
方法摘要 | |
---|---|
protected void |
actionPropertyChanged(Action action, String propertyName) 更新按钮的状态以响应相关的操作中的属性更改。 |
void |
addMenuDragMouseListener(MenuDragMouseListener l) 将 MenuDragMouseListener 添加到菜单项。 |
void |
addMenuKeyListener(MenuKeyListener l) 将 MenuKeyListener 添加到菜单项。 |
protected void |
configurePropertiesFromAction(Action a) 在此按钮上设置属性以匹配指定 Action 中的属性。 |
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 |
setModel(ButtonModel newModel) 设置此按钮表示的模型。 |
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
的键盘助记符
方法详细信息 |
---|
public void setModel(ButtonModel newModel)
AbstractButton
中的
setModel
newModel
- 新的
ButtonModel
AbstractButton.getModel()
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
中的属性。有关关于设置了哪些属性的更多信息,请参阅
支持 Action
的 Swing 组件。
AbstractButton
中的
configurePropertiesFromAction
a
- 从中获取属性的
Action
,或为
null
Action
,
AbstractButton.setAction(javax.swing.Action)
protected void actionPropertyChanged(Action action, String propertyName)
createActionPropertyChangeListener
返回的
PropertyChangeListener
中调用此方法。子类通常不需要调用此方法。支持其他
Action
属性的子类应该重写此方法以及
configurePropertiesFromAction
。
有关此方法设置的属性的列表,请参阅支持 Action
的 Swing 组件处的表。
AbstractButton
中的
actionPropertyChanged
action
- 与此按钮关联的
Action
propertyName
- 已更改属性的名称
Action
,
AbstractButton.configurePropertiesFromAction(javax.swing.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;如果此菜单项位于发生更改的菜单路径部分,但该路径的这一特殊部分与更改前相同,则为 false
MenuSelectionManager.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 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。