クラス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バージョン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バージョン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