|
JavaTM 2 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;如果此選單項位於發生更改的選單路徑部分,但該路徑的這一特殊部分與更改前相同,則為 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. 6 |
|||||||||
上一個類別 下一個類別 | 框架 無框架 | |||||||||
摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 |
版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。