モジュール java.desktop

パッケージ 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オブジェクトは、メニュー・バーから展開されるプルダウン・メニュー・コンポーネントです。

メニューはオプションで、ティア・オフ・メニューにすることができます。 ティア・オフ・メニューは、その親メニュー・バーまたはメニューから開いてドラッグできます。 このメニューは、マウス・ボタンを離したあとも画面上に残ります。 ティア・オフ・メニューのLook & Feelはそのピアで指定されるので、メニューをティア・オフする仕組みはプラットフォームに依存します。 ティア・オフ・メニューをサポートしていないプラットフォームでは、ティア・オフ・プロパティは無視されます。

メニュー内の各項目は、MenuItemクラスに属している必要があります。 各項目は、MenuItemのインスタンス、サブメニュー(Menuのインスタンス)、またはチェックボックス(CheckboxMenuItemのインスタンス)です。

導入されたバージョン:

1.0

関連項目:

• MenuItem
• CheckboxMenuItem
• 直列化された形式

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラス	説明
protected class	Menu.AccessibleAWTMenu	アクセシビリティのデフォルト・サポートを提供するために使用されるMenuの内部クラスです。

クラス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()	このMenuに関連付けられた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, 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を返した場合。

導入されたバージョン:

1.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を返した場合。

関連項目:

• GraphicsEnvironment.isHeadless()

メソッドの詳細

addNotify

public void addNotify()

メニューのピアを作成します。 ピアを使うと、機能性を変えずに、メニューの外観を変更できます。

オーバーライド:

addNotify、クラスMenuItem

removeNotify

public void removeNotify()

メニューのピアを削除します。 ピアを使うと、機能性を変えずに、メニューの外観を変更できます。

オーバーライド:

removeNotify、クラスMenuComponent

isTearOff

public boolean isTearOff()

このメニューがティア・オフ・メニューかどうかを示します。

ティア・オフ機能は、AWTのすべての実装によってサポートされるわけではありません。 特定の実装がティア・オフ・メニューをサポートしていない場合、この値はそのまま無視されます。

戻り値:

これがティア・オフ・メニューの場合はtrue、そうでない場合はfalse。

getItemCount

public int getItemCount()

このメニューにある項目の数を返します。

戻り値:

このメニューにある項目数

導入されたバージョン:

1.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の値が0より小さい場合

導入されたバージョン:

1.1

関連項目:

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

insert

public void insert(String label, int index)

指定されたラベルを持つメニュー項目を、このメニューの指定された位置に挿入します。 これはinsert(menuItem, index)の簡易メソッドです。

パラメータ:

label - 項目上のテキスト

index - メニュー項目が挿入される位置

例外:

IllegalArgumentException - indexの値が0より小さい場合

導入されたバージョン:

1.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より小さい場合。

導入されたバージョン:

1.1

関連項目:

• addSeparator()

remove

public void remove(int index)

このメニューから、指定されたインデックスにあるメニュー項目を削除します。

パラメータ:

index - 削除される項目の位置。

remove

public void remove(MenuComponent item)

このメニューから指定されたメニュー項目を削除します。

定義:

remove、インタフェースMenuContainer

パラメータ:

item - メニューから削除する項目。 itemがnullの場合、またはこのメニュー内にない場合、このメソッドは処理を行わない。

removeAll

public void removeAll()

このメニューからすべての項目を削除します。

導入されたバージョン:

1.1

paramString

public String paramString()

このMenuの状態を表す文字列を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、nullにはできません。

オーバーライド:

paramString、クラスMenuItem

戻り値:

このメニューのパラメータ文字列

getAccessibleContext

public AccessibleContext getAccessibleContext()

このMenuに関連付けられたAccessibleContextを取得します。 メニューの場合、AccessibleContextはAccessibleAWTMenuの形式を取ります。 必要に応じて新規のAccessibleAWTMenuインスタンスが作成されます。

定義:

getAccessibleContext、インタフェースAccessible

オーバーライド:

getAccessibleContext、クラスMenuItem

戻り値:

このMenuのAccessibleContextとして機能するAccessibleAWTMenu

導入されたバージョン:

1.3