概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法

java.awt
類別 MenuItem

java.lang.Object
  繼承者 java.awt.MenuComponent
      繼承者 java.awt.MenuItem
所有已實作的介面：
Serializable, Accessible
直接已知子類別：
CheckboxMenuItem, Menu
public class MenuItem
extends MenuComponent
implements Accessible

選單中的所有項必須屬於類別 MenuItem 或其子類別之一。

預設的 MenuItem 物件包含一個簡單的加標籤的選單項。

此選單欄的圖像顯示五個選單項：以下文本是對此圖像的描述。
前兩項是較簡單的選單項，加有標籤 "Basic" 和 "Simple"。跟在這兩項後面的是一個分隔符，它本身是一個使用標籤 "-" 創建的選單項。接下來是加有 "Check" 標籤的 CheckboxMenuItem 的實例。最後一個選單項是加有 "More Examples" 標籤的子選單，此子選單是 Menu 的一個實例。

選擇選單項時，AWT 發送一個動作事件到該選單項。由於該事件是一個 ActionEvent 實例，processEvent 方法會檢查該事件，並將它傳遞到 processActionEvent。後一方法將該事件重定向到任何 ActionListener 物件，該物件已在由此選單項產生的動作事件中註冊權益。

注意，子類別 Menu 覆寫此行為，且在選擇其中一個子項前不向該框架發送任何事件。

另請參見：
序列化表格

巢狀類別摘要
protected  class MenuItem.AccessibleAWTMenuItem
          用於為可存取性提供預設支持的 MenuItem 的內部類別。
 
從類別 java.awt.MenuComponent 繼承的巢狀類別/介面
MenuComponent.AccessibleAWTMenuComponent
 
建構子摘要
MenuItem()
          建構具有空標籤且沒有鍵盤快捷方式的新選單項。
MenuItem(String label)
          建構具有指定的標籤且沒有鍵盤快捷方式的新選單項。
MenuItem(String label, MenuShortcut s)
          創建具有關聯的鍵盤快捷方式的選單項。
 
方法摘要
 void addActionListener(ActionListener l)
          添加指定的動作偵聽器，以從此選單項接收動作事件。
 void addNotify()
          創建該選單項的同位體。
 void deleteShortcut()
          刪除與此選單項關聯的任何 MenuShortcut 物件。
 void disable()
          已過時。 從 JDK version 1.1 開始，由 setEnabled(boolean) 取代。
protected  void disableEvents(long eventsToDisable)
          禁止將事件提交到將由指定事件遮罩碼參數定義的事件的選單項。
 void enable()
          已過時。 從 JDK version 1.1 開始，由 setEnabled(boolean) 取代。
 void enable(boolean b)
          已過時。 從 JDK version 1.1 開始，由 setEnabled(boolean) 取代。
protected  void enableEvents(long eventsToEnable)
          允許將事件提交到將由指定事件遮罩碼參數定義的事件的選單項。
 AccessibleContext getAccessibleContext()
          獲取與此選單項關聯的 AccessibleContext。
 String getActionCommand()
          獲取由此選單項引發的動作事件的命令名。
 ActionListener[] getActionListeners()
          返回在此選單項上註冊的所有動作偵聽器組成的陣列。
 String getLabel()
          獲取此選單項的標籤。
<T extends EventListener>
T[]
getListeners(Class<T> listenerType)
          返回當前在此 MenuItem 上註冊為 FooListener 的所有物件組成的陣列。
 MenuShortcut getShortcut()
          獲取與此選單項關聯的 MenuShortcut 物件。
 boolean isEnabled()
          檢查是否啟用了此選單項。
 String paramString()
          返回表示此 MenuItem 狀態的字元串。
protected  void processActionEvent(ActionEvent e)
          處理此選單項上發生的動作事件，方法是將其指派給任何已註冊的 ActionListener 物件。
protected  void processEvent(AWTEvent e)
          處理此選單項上的事件。
 void removeActionListener(ActionListener l)
          移除指定的動作偵聽器，使其不再從此選單項中接收動作事件。
 void setActionCommand(String command)
          設置由此選單項引發的動作事件的命令名。
 void setEnabled(boolean b)
          設置是否可以選擇此選單項。
 void setLabel(String label)
          將此選單項的標籤設置為指定標籤。
 void setShortcut(MenuShortcut s)
          設置與此選單項關聯的 MenuShortcut 物件。
 
從類別 java.awt.MenuComponent 繼承的方法
dispatchEvent, getFont, getName, getParent, getPeer, getTreeLock, postEvent, removeNotify, setFont, setName, toString
 
從類別 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

建構子詳細資訊

MenuItem

public MenuItem()
         throws HeadlessException
建構具有空標籤且沒有鍵盤快捷方式的新選單項。

拋出：
HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。
從以下版本開始：
JDK1.1
另請參見：
GraphicsEnvironment.isHeadless()

MenuItem

public MenuItem(String label)
         throws HeadlessException
建構具有指定的標籤且沒有鍵盤快捷方式的新選單項。注意，保留標籤中的“-”，用它來指示選單項之間的分隔符。預設情況下，啟用除分隔符之外的所有選單項。

參數：
label - 此選單項的標籤。
拋出：
HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。
從以下版本開始：
JDK1.0
另請參見：
GraphicsEnvironment.isHeadless()

MenuItem

public MenuItem(String label,
                MenuShortcut s)
         throws HeadlessException
創建具有關聯的鍵盤快捷方式的選單項。注意，保留標籤中的“-”，用它來指示選單項之間的分隔符。預設情況下，啟用除分隔符之外的所有選單項。

參數：
label - 此選單項的標籤。
s - 與此選單項關聯的 MenuShortcut 的實例。
拋出：
HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。
從以下版本開始：
JDK1.1
另請參見：
GraphicsEnvironment.isHeadless()
方法詳細資訊

addNotify

public void addNotify()
創建該選單項的同位體。該同位體允許我們修改該選單項的外觀，而不改變其功能。

getLabel

public String getLabel()
獲取此選單項的標籤。

返回：
此選單項的標籤，如果此選單項沒有標籤，則返回 null。
從以下版本開始：
JDK1.0
另請參見：
setLabel(java.lang.String)

setLabel

public void setLabel(String label)
將此選單項的標籤設置為指定標籤。

參數：
label - 新標籤，如果無標籤，則該參數為 null。
從以下版本開始：
JDK1.0
另請參見：
getLabel()

isEnabled

public boolean isEnabled()
檢查是否啟用了此選單項。

從以下版本開始：
JDK1.0
另請參見：
setEnabled(boolean)

setEnabled

public void setEnabled(boolean b)
設置是否可以選擇此選單項。

參數：
b - 如果該參數為 true，則啟用此選單項；如果該參數為 false，則禁用它。
從以下版本開始：
JDK1.1
另請參見：
isEnabled()

enable

@Deprecated
public void enable()
已過時。 從 JDK version 1.1 開始，由 setEnabled(boolean) 取代。

enable

@Deprecated
public void enable(boolean b)
已過時。 從 JDK version 1.1 開始，由 setEnabled(boolean) 取代。

disable

@Deprecated
public void disable()
已過時。 從 JDK version 1.1 開始，由 setEnabled(boolean) 取代。

getShortcut

public MenuShortcut getShortcut()
獲取與此選單項關聯的 MenuShortcut 物件。

返回：
與此選單項關聯的選單快捷方式，如果沒有指定選單快捷方式，則返回 null。
從以下版本開始：
JDK1.1
另請參見：
setShortcut(java.awt.MenuShortcut)

setShortcut

public void setShortcut(MenuShortcut s)
設置與此選單項關聯的 MenuShortcut 物件。如果某一選單快捷方式已經與此選單項關聯，則取代它。

參數：
s - 與此選單項關聯的選單快捷方式。
從以下版本開始：
JDK1.1
另請參見：
getShortcut()

deleteShortcut

public void deleteShortcut()
刪除與此選單項關聯的任何 MenuShortcut 物件。

從以下版本開始：
JDK1.1

enableEvents

protected final void enableEvents(long eventsToEnable)
允許將事件提交到將由指定事件遮罩碼參數定義的事件的選單項。

由於在將事件型別的偵聽器添加到選單項時，會自動啟用該事件型別，所以只需通過 MenuItem 的子類別調用此方法即可，該子類別要具有提交到 processEvent 的指定事件型別，不管偵聽器是否註冊。

參數：
eventsToEnable - 定義事件型別的事件遮罩碼
從以下版本開始：
JDK1.1
另請參見：
processEvent(java.awt.AWTEvent), disableEvents(long), Component.enableEvents(long)

disableEvents

protected final void disableEvents(long eventsToDisable)
禁止將事件提交到將由指定事件遮罩碼參數定義的事件的選單項。

參數：
eventsToDisable - 定義事件型別的事件遮罩碼
從以下版本開始：
JDK1.1
另請參見：
processEvent(java.awt.AWTEvent), enableEvents(long), Component.disableEvents(long)

setActionCommand

public void setActionCommand(String command)
設置由此選單項引發的動作事件的命令名。

預設情況下，動作命令設置為選單項的標籤。

參數：
command - 要為此選單項設置的動作命令。
從以下版本開始：
JDK1.1
另請參見：
getActionCommand()

getActionCommand

public String getActionCommand()
獲取由此選單項引發的動作事件的命令名。

從以下版本開始：
JDK1.1
另請參見：
setActionCommand(java.lang.String)

addActionListener

public void addActionListener(ActionListener l)
添加指定的動作偵聽器，以從此選單項接收動作事件。如果 l 為 null，則不拋出異常，也不執行任何動作。

有關 AWT 的執行緒模型的詳細資訊，請參閱 AWT 執行緒問題。

參數：
l - 動作偵聽器。
從以下版本開始：
JDK1.1
另請參見：
removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListener

removeActionListener

public void removeActionListener(ActionListener l)
移除指定的動作偵聽器，使其不再從此選單項中接收動作事件。如果 l 為 null，則不拋出異常，也不執行任何動作。

有關 AWT 的執行緒模型的詳細資訊，請參閱 AWT 執行緒問題。

參數：
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)
返回當前在此 MenuItem 上註冊為 FooListener 的所有物件組成的陣列。FooListener 使用 addFooListener 方法註冊。

可以使用類別文本（如 FooListener.class）指定 listenerType 參數。例如，可以使用下面的程式碼查詢 MenuItem m 的動作偵聽器： 

ActionListener[] als = (ActionListener[])(m.getListeners(ActionListener.class));
如果不存在此類別偵聽器，則此方法返回一個空陣列。

參數：
listenerType - 請求的偵聽器的型別；此參數應指定一個從 java.util.EventListener 繼承的介面
返回：
在此選單項上註冊為 FooListener 的所有物件組成的陣列，如果未添加此偵聽器，則返回一個空陣列
拋出：
ClassCastException - 如果 listenerType 未指定一個類別或者實作 java.util.EventListener 的介面。
從以下版本開始：
1.3
另請參見：
getActionListeners()

processEvent

protected void processEvent(AWTEvent e)
處理此選單項上的事件。如果事件是 ActionEvent 的一個實例，則調用 processActionEvent（通過 MenuItem 定義的另一個方法）。

當前，選單項僅支持動作事件。

注意，如果事件參數為 null，則行為是不確定的，而且可能導致異常。

覆寫：
類別 MenuComponent 中的 processEvent
參數：
e - 事件
從以下版本開始：
JDK1.1
另請參見：
ItemEvent, #processItemEvent

processActionEvent

protected void processActionEvent(ActionEvent e)
處理此選單項上發生的動作事件，方法是將其指派給任何已註冊的 ActionListener 物件。不調用此方法，除非為此元件啟用了動作事件。在發生以下情況之一時啟用動作事件：

注意，如果事件參數為 null，則行為是不確定的，而且可能導致異常。

參數：
e - 動作事件
從以下版本開始：
JDK1.1
另請參見：
ActionEvent, ActionListener, enableEvents(long)

paramString

public String paramString()
返回表示此 MenuItem 狀態的字元串。此方法僅用於除錯目的，對於各個實作，所返回字元串的內容和格式可能有所不同。返回的字元串可以為空，但不可以為 null。

覆寫：
類別 MenuComponent 中的 paramString
返回：
此選單項的參數字元串

getAccessibleContext

public AccessibleContext getAccessibleContext()
獲取與此選單項關聯的 AccessibleContext。對於選單項，AccessibleContext 採用 AccessibleAWTMenuItem 的形式。必要時要創建新的 AccessibleAWTMenuItem 實例。

指定者：
介面 Accessible 中的 getAccessibleContext
覆寫：
類別 MenuComponent 中的 getAccessibleContext
返回：
用作此選單項的 AccessibleContext 的 AccessibleAWTMenuItem
從以下版本開始：
1.3
概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。