java.awt
類別 Menu

java.lang.Object
  java.awt.MenuComponent
      java.awt.MenuItem
          java.awt.Menu

所有已實作的介面：

MenuContainer, Serializable, Accessible

直接已知子類別：

PopupMenu

public class Menu
extends MenuItem
implements MenuContainer, Accessible

Menu 物件是從選單欄部署的下拉式選單元件。

選單可以是任意分離式 選單。可以打開分離式選單，並從其父選單欄或選單中拖開。釋放鼠標按鈕之後，它仍然在螢幕上。分離選單的機制與平臺有關，因為分離式選單的外觀由其同位體確定。對於不支持分離式選單的平臺，分離屬性會被忽略。

選單中的每一項都必須屬於 MenuItem 類別。它可以是 MenuItem 的一個實例、子選單（Menu 的一個實例）、或複選框（CheckboxMenuItem 的一個實例）。

從以下版本開始：

JDK1.0

另請參見：

MenuItem, CheckboxMenuItem, 序列化表格

巢狀類別摘要

protected class

Menu.AccessibleAWTMenu 選單的內部類別，用於為可存取性提供預設支持。

從類別 java.awt.MenuItem 繼承的巢狀類別/介面

MenuItem.AccessibleAWTMenuItem

從類別 java.awt.MenuComponent 繼承的巢狀類別/介面

MenuComponent.AccessibleAWTMenuComponent

建構子摘要

Menu()
建構具有空標籤的新選單。

Menu(String label)
建構具有指定標籤的新選單。

Menu(String label, boolean tearOff)
建構具有指定標籤的新選單，指示該選單是否可以分離。

方法摘要

MenuItem	add(MenuItem mi) 將指定的選單項添加到此選單。
void	add(String label) 將帶有指定標籤的項添加到此選單。
void	addNotify() 創建該選單的同位體。
void	addSeparator() 將一個分隔線或連字元添加到選單的當前位置。
int	countItems() 已過時。 從 JDK version 1.1 開始，已由 getItemCount() 取代。
AccessibleContext	getAccessibleContext() 獲取與此選單關聯的 AccessibleContext。
MenuItem	getItem(int index) 獲取此選單的指定索引處的項。
int	getItemCount() 獲取此選單中的項數。
void	insert(MenuItem menuitem, int index) 將選單項插入到此選單的指定位置。
void	insert(String label, int index) 將帶有指定標籤的選單項插入到此選單的指定位置。
void	insertSeparator(int index) 在指定的位置插入分隔符。
boolean	isTearOff() 指示此選單是否為分離式選單。
String	paramString() 返回表示此 Menu 狀態的字元串。
void	remove(int index) 從此選單移除指定索引處的選單項。
void	remove(MenuComponent item) 從此選單移除指定的選單項。
void	removeAll() 從此選單移除所有項。
void	removeNotify() 移除該選單的同位體。

從類別 java.awt.MenuItem 繼承的方法

addActionListener, deleteShortcut, disable, disableEvents, enable, enable, enableEvents, getActionCommand, getActionListeners, getLabel, getListeners, getShortcut, isEnabled, processActionEvent, processEvent, removeActionListener, setActionCommand, setEnabled, setLabel, setShortcut

從類別 java.awt.MenuComponent 繼承的方法

dispatchEvent, getFont, getName, getParent, getPeer, getTreeLock, postEvent, setFont, setName, toString

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

從介面 java.awt.MenuContainer 繼承的方法

getFont, postEvent

建構子詳細資訊

Menu

public Menu()
     throws HeadlessException

建構具有空標籤的新選單。此選單不是分離式選單。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

從以下版本開始：

JDK1.1

另請參見：

GraphicsEnvironment.isHeadless()

Menu

public Menu(String label)
     throws HeadlessException

建構具有指定標籤的新選單。此選單不是分離式選單。

參數：

label - 選單欄或其他選單（此選單是其子選單）中選單的標籤。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另請參見：

GraphicsEnvironment.isHeadless()

Menu

public Menu(String label,
            boolean tearOff)
     throws HeadlessException

建構具有指定標籤的新選單，指示該選單是否可以分離。

可能並非 AWT 的所有實作都支持分離功能。如果特定的實作不支持分離式選單，則此值會被預設忽略。

參數：

label - 選單欄或其他選單（此選單是其子選單）中選單的標籤。

tearOff - 如果為 true，則該選單為分離式選單。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

從以下版本開始：

JDK1.0.

另請參見：

GraphicsEnvironment.isHeadless()

方法詳細資訊

addNotify

public void addNotify()

創建該選單的同位體。該同位體允許我們修改該選單的外觀，而不更改其功能。

覆寫：

類別 MenuItem 中的 addNotify

removeNotify

public void removeNotify()

移除該選單的同位體。該同位體允許我們修改該選單的外觀，而不更改其功能。

覆寫：

類別 MenuComponent 中的 removeNotify

isTearOff

public boolean isTearOff()

指示此選單是否為分離式選單。

AWT 的所有實作都不支持分離功能。如果特定的實作不支持分離式選單，則此值會被預設忽略。

返回：

如果這是一個分離式選單，則返回 true；否則返回 false。

getItemCount

public int getItemCount()

獲取此選單中的項數。

返回：

此選單中的項數。

從以下版本開始：

JDK1.1

countItems

@Deprecated
public int countItems()

已過時。 從 JDK version 1.1 開始，已由 getItemCount() 取代。

getItem

public MenuItem getItem(int index)

獲取此選單的指定索引處的項。

參數：

index - 要返回的項的位置。

返回：

指定索引處的項。

add

public MenuItem add(MenuItem mi)

將指定的選單項添加到此選單。如果該選單項為另一個選單的一部分，則從該選單移除它。

參數：

mi - 要添加的選單項

返回：

已添加的選單項

另請參見：

insert(java.lang.String, int), insert(java.awt.MenuItem, int)

add

public void add(String label)

將帶有指定標籤的項添加到此選單。

參數：

label - 該項上的文本

另請參見：

insert(java.lang.String, int), insert(java.awt.MenuItem, int)

insert

public void insert(MenuItem menuitem,
                   int index)

將選單項插入到此選單的指定位置。

參數：

menuitem - 要插入的選單項。

index - 選單項應插入的位置。

拋出：

IllegalArgumentException - 如果 index 的值小於零

從以下版本開始：

JDK1.1

另請參見：

add(java.lang.String), add(java.awt.MenuItem)

insert

public void insert(String label,
                   int index)

將帶有指定標籤的選單項插入到此選單的指定位置。這是 insert(menuItem, index) 的一個便捷方法。

參數：

label - 項的文本

index - 選單項應插入的位置

拋出：

IllegalArgumentException - 如果 index 的值小於零

從以下版本開始：

JDK1.1

另請參見：

add(java.lang.String), add(java.awt.MenuItem)

addSeparator

public void addSeparator()

將一個分隔線或連字元添加到選單的當前位置。

另請參見：

insertSeparator(int)

insertSeparator

public void insertSeparator(int index)

在指定的位置插入分隔符。

參數：

index - 選單分隔符應插入的位置。

拋出：

IllegalArgumentException - 如果 index 的值小於 0。

從以下版本開始：

JDK1.1

另請參見：

addSeparator()

remove

public void remove(int index)

從此選單移除指定索引處的選單項。

參數：

index - 要移除的項的位置。

remove

public void remove(MenuComponent item)

從此選單移除指定的選單項。

指定者：

介面 MenuContainer 中的 remove

參數：

item - 要從該選單移除的項。如果 item 為 null，或不在此選單中，則此方法不執行任何操作。

removeAll

public void removeAll()

從此選單移除所有項。

從以下版本開始：

JDK1.0.

paramString

public String paramString()

返回表示此 Menu 狀態的字元串。此方法僅用於除錯目的，對於這兩個實作，返回的字元串的內容和格式可能有所不同。返回的字元串可能為空，但不可能為 null。

覆寫：

類別 MenuItem 中的 paramString

返回：

此選單的參數字元串

getAccessibleContext

public AccessibleContext getAccessibleContext()

獲取與此選單關聯的 AccessibleContext。對於選單，AccessibleContext 會採用 AccessibleAWTMenu 的窗體。必要時創建一個新的 AccessibleAWTDialog 實例。

指定者：

介面 Accessible 中的 getAccessibleContext

覆寫：

類別 MenuItem 中的 getAccessibleContext

返回：

用作此選單的 AccessibleContext 的 AccessibleAWTMenu

從以下版本開始：

1.3