クラス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
関連項目:

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

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

    クラスMenuItemで宣言されたネストされたクラス/インタフェース

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

    クラスMenuComponentで宣言されたネストされたクラス/インタフェース

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

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    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()
    メニューのピアを削除します。

    クラスで宣言されたメソッド MenuItem

    addActionListener, deleteShortcut, disable, disableEvents, enable, enable, enableEvents, getActionCommand, getActionListeners, getLabel, getListeners, getShortcut, isEnabled, processActionEvent, processEvent, removeActionListener, setActionCommand, setEnabled, setLabel, setShortcut
    修飾子と型
    メソッド
    説明
    void
    addActionListener(ActionListener l)
    このメニュー項目からアクション・イベントを受け取るために、指定されたアクション・リスナーを追加します。
    void
    deleteShortcut()
    このメニュー項目に関連付けられたMenuShortcutオブジェクトをすべて削除します。
    void
    disable()
    非推奨。
    JDKバージョン1.1で、setEnabled(boolean)に置き換えられています。
    protected final void
    disableEvents(long eventsToDisable)
    指定されたイベント・マスク・パラメータで定義するイベントについて、このメニュー項目への送信を不可にします。
    void
    enable()
    非推奨。
    JDKバージョン1.1で、setEnabled(boolean)に置き換えられています。
    void
    enable(boolean b)
    非推奨。
    JDKバージョン1.1で、setEnabled(boolean)に置き換えられています。
    protected final void
    enableEvents(long eventsToEnable)
    指定されたイベント・マスク・パラメータで定義されるイベントについて、このメニュー項目への送信を可能にします。
    String
    getActionCommand()
    このメニュー項目によってトリガーされるアクション・イベントのコマンド名を返します。
    ActionListener[]
    getActionListeners()
    このメニュー項目に登録されたすべてのアクション・リスナーの配列を返します。
    String
    getLabel()
    このメニュー項目のラベルを返します。
    <T extends EventListener>
    T[]
    getListeners(Class<T> listenerType)
    このMenuItemにFooListenerとして現在登録されているすべてのオブジェクトの配列を返します。
    MenuShortcut
    getShortcut()
    このメニュー項目に関連付けられたMenuShortcutオブジェクトを取得します。
    boolean
    isEnabled()
    このメニュー項目が使用可能になっているかどうかを判定します。
    protected void
    processActionEvent(ActionEvent e)
    このメニュー項目で発生するアクション・イベントを、登録されているActionListenerオブジェクトにディスパッチすることによって処理します。
    protected void
    processEvent(AWTEvent e)
    このメニュー項目のイベントを処理します。
    void
    removeActionListener(ActionListener l)
    以後このメニュー項目からアクション・イベントを受け取らないように、指定されたアクション・リスナーを削除します。
    void
    setActionCommand(String command)
    このメニュー項目でトリガーされるアクション・イベントのコマンド名を設定します。
    void
    setEnabled(boolean b)
    このメニュー項目を選択可能にするかどうかを設定します。
    void
    setLabel(String label)
    このメニュー項目のラベルを指定されたラベルに設定します。
    void
    setShortcut(MenuShortcut s)
    このメニュー項目に関連付けられたMenuShortcutオブジェクトを設定します。

    クラスで宣言されたメソッド MenuComponent

    dispatchEvent, getFont, getName, getParent, getTreeLock, postEvent, setFont, setName, toString
    修飾子と型
    メソッド
    説明
    final void
    dispatchEvent(AWTEvent e)
    このコンポーネントまたはそのサブコンポーネントの1つにイベントを送ります。
    Font
    getFont()
    このメニュー・コンポーネントに使用するフォントを返します。
    String
    getName()
    メニュー・コンポーネントの名前を返します。
    MenuContainer
    getParent()
    このメニュー・コンポーネントの親コンテナを返します。
    protected final Object
    getTreeLock()
    AWTコンポーネント・ツリーおよびレイアウト操作に対する、このコンポーネントのロック・オブジェクト(スレッド同期化モニターを所有するオブジェクト)を取得します。
    boolean
    postEvent(Event evt)
    非推奨。
    JDKバージョン1.1で、dispatchEventに置き換えられています。
    void
    setFont(Font f)
    このメニュー・コンポーネントに使用するフォントを、指定されたフォントに設定します。
    void
    setName(String name)
    コンポーネントの名前を、指定された文字列に設定します。
    String
    toString()
    このメニュー・コンポーネントの表現を文字列として返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

    インタフェースで宣言されたメソッド MenuContainer

    getFont, postEvent
    修飾子と型
    メソッド
    説明
    Font
    getFont()
    このコンテナで使用されているフォントを返します。
    boolean
    postEvent(Event evt)
    非推奨。
    JDKバージョン1.1で、dispatchEvent(AWTEvent)に置き換えられています。

  • コンストラクタの詳細

    • Menu

      public Menu() throws HeadlessException
      空のラベルを持つ新しいメニューを構築します。 このメニューは、ティア・オフ・メニューではありません。
      スロー:
      HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。
      導入されたバージョン:
      1.1
      関連項目:

    • Menu

      public Menu(String label) throws HeadlessException
      指定されたラベルを持つ新しいメニューを構築します。 このメニューは、ティア・オフ・メニューではありません。
      パラメータ:
      label - メニュー・バー、またはこのメニューがサブメニューになっている別のメニューにあるメニューのラベル。
      スロー:
      HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。
      関連項目:

    • Menu

      public Menu(String label, boolean tearOff) throws HeadlessException
      メニューをティア・オフできるかどうかを指定して、指定されたラベルを持つ新しいメニューを構築します。

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

      パラメータ:
      label - メニュー・バー、またはこのメニューがサブメニューになっている別のメニューにあるメニューのラベル。
      tearOff - trueの場合、メニューはティア・オフ・メニュー。
      スロー:
      HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。
      関連項目:

  • メソッドの詳細

    • 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 - 追加されるメニュー項目
      戻り値:
      追加されたメニュー項目
      関連項目:

    • add

      public void add(String label)
      指定されたラベルを持つ項目をこのメニューに追加します。
      パラメータ:
      label - 項目上のテキスト
      関連項目:

    • insert

      public void insert(MenuItem menuitem, int index)
      このメニューの指定された位置にメニュー項目を挿入します。
      パラメータ:
      menuitem - 挿入されるメニュー項目。
      index - メニュー項目が挿入される位置。
      スロー:
      IllegalArgumentException - indexの値が0より小さい場合
      導入されたバージョン:
      1.1
      関連項目:

    • insert

      public void insert(String label, int index)
      指定されたラベルを持つメニュー項目を、このメニューの指定された位置に挿入します。 これはinsert(menuItem, index)の簡易メソッドです。
      パラメータ:
      label - 項目上のテキスト
      index - メニュー項目が挿入される位置
      スロー:
      IllegalArgumentException - indexの値が0より小さい場合
      導入されたバージョン:
      1.1
      関連項目:

    • addSeparator

      public void addSeparator()
      現在の位置のメニューにセパレータ行またはハイフンを追加します。
      関連項目:

    • insertSeparator

      public void insertSeparator(int index)
      指定された位置にセパレータを挿入します。
      パラメータ:
      index - メニュー・セパレータが挿入される位置。
      スロー:
      IllegalArgumentException - indexの値が0より小さい場合。
      導入されたバージョン:
      1.1
      関連項目:

    • 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