JavaTM Platform
Standard Ed. 6

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()
メニューのピアを作成します。ピアを使うと、機能性を変えずに、メニューの外観を変更できます。

オーバーライド:
クラス 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 の値が ゼロより小さい場合
導入されたバージョン:
JDK1.1
関連項目:
addSeparator()

remove

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

パラメータ:
index - 削除される項目の位置

remove

public void remove(MenuComponent item)
このメニューから指定されたメニュー項目を削除します。

定義:
インタフェース MenuContainer 内の remove
パラメータ:
item - メニューから削除する項目。 itemnull の場合、 またはこのメニュー内にない場合、 このメソッドは処理を行わない

removeAll

public void removeAll()
このメニューからすべての項目を削除します。

導入されたバージョン:
JDK1.0.

paramString

public String paramString()
この Menu の状態を表す文字列を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

オーバーライド:
クラス MenuItem 内の paramString
戻り値:
このメニューのパラメータ文字列

getAccessibleContext

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

定義:
インタフェース Accessible 内の getAccessibleContext
オーバーライド:
クラス MenuItem 内の getAccessibleContext
戻り値:
この Menu の AccessibleContext として機能する AccessibleAWTMenu
導入されたバージョン:
1.3

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。