モジュール java.desktop
パッケージ 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, 直列化された形式

    • コンストラクタの詳細

      • 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)

      • 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