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 のインスタンス) です。

導入されたバージョン:

JDK1.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, 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()

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

オーバーライド:

addNotify、クラス: MenuItem

removeNotify

public void removeNotify()

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

オーバーライド:

removeNotify、クラス: MenuComponent

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

導入されたバージョン:

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

導入されたバージョン:

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)

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

定義:

remove、インタフェース: MenuContainer

パラメータ:

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

removeAll

public void removeAll()

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

導入されたバージョン:

JDK1.0.

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