モジュール java.desktop
パッケージ java.awt

クラスCheckboxMenuItem

  • すべての実装されたインタフェース:
    ItemSelectable, Serializable, Accessible
    public class CheckboxMenuItem
extends MenuItem
implements ItemSelectable, Accessible
    このクラスは、メニューに追加できるチェックボックスを表します。 メニュー内のチェックボックスを選択すると、その状態が「オン」から「オフ」へ、または「オフ」から「オン」へ変更されます。

    次の図は、CheckBoxMenuItemのインスタンスが含まれているメニューを表します。

    Basic、Simple、Check、およびMore Examplesという項目を含むExamplesというラベルの付いたメニュー。 Check項目はオフ状態のCheckBoxMenuItemインスタンス。

    Checkというラベルの付いた項目は、「オフ」の状態のチェックボックス・メニュー項目を示します。

    チェックボックス・メニュー項目を選択すると、AWTは項目イベントをその項目に送ります。 イベントはItemEventのインスタンスであるため、processEventメソッドはそのイベントを検査してprocessItemEventに渡します。 後者のメソッドは、このメニュー項目によって生成される項目イベントの通知を登録しているすべてのItemListenerオブジェクトにそのイベントを送ります。

    導入されたバージョン:
    1.0
    関連項目:
    ItemEvent, ItemListener, 直列化された形式

    • コンストラクタの詳細

      • CheckboxMenuItem

        public CheckboxMenuItem()
                 throws HeadlessException
        空のラベルが付いたチェックボックス・メニュー項目を生成します。 項目の初期状態は「オフ」に設定されます。
        例外:
        HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返す場合
        導入されたバージョン:
        1.1
        関連項目:
        GraphicsEnvironment.isHeadless()

      • CheckboxMenuItem

        public CheckboxMenuItem​(String label)
                 throws HeadlessException
        指定されたラベルが付いたチェックボックス・メニュー項目を生成します。 項目の初期状態は「オフ」に設定されます。
        パラメータ:
        label - チェックボックス・メニュー項目の文字列ラベル、またはラベルが付いていないメニュー項目の場合はnull。
        例外:
        HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返す場合
        関連項目:
        GraphicsEnvironment.isHeadless()

      • CheckboxMenuItem

        public CheckboxMenuItem​(String label,
                        boolean state)
                 throws HeadlessException
        指定されたラベルが付いたチェックボックス・メニュー項目を、指定された状態で生成します。
        パラメータ:
        label - チェックボックス・メニュー項目の文字列ラベル、またはラベルが付いていないメニュー項目の場合はnull。
        state - メニュー項目の初期状態。trueは「オン」を、falseは「オフ」を示す
        例外:
        HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返す場合
        導入されたバージョン:
        1.1
        関連項目:
        GraphicsEnvironment.isHeadless()

    • メソッドの詳細

      • addNotify

        public void addNotify()
        チェックボックス項目のピアを生成します。 これにより、チェックボックス項目の機能を変更することなく、その外観を変更することが可能になります。 ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。
        オーバーライド:
        addNotify、クラスMenuItem
        関連項目:
        Component.getToolkit()

      • getState

        public boolean getState()
        このチェックボックス・メニュー項目の状態が「オン」であるか「オフ」であるかを判定します。
        戻り値:
        このチェックボックス・メニュー項目の状態。trueは「オン」を、falseは「オフ」を示す
        関連項目:
        setState(boolean)

      • setState

        public void setState​(boolean b)
        このチェック・ボックス・メニュー項目を指定された状態に設定します。 boolean値trueは「オン」を示し、falseは「オフ」を示します。

        このメソッドは主にチェックボックス・メニュー項目のステータス初期化のために使用してください。 チェックボックス・メニュー項目のステータスをプログラムで設定してもItemEventは開始されません。 ItemEventをトリガーするための唯一の方法は、ユーザーの操作です。

        パラメータ:
        b - チェックボックス・メニュー項目が「オン」の場合はtrue、そうでない場合はfalse
        関連項目:
        getState()

      • getSelectedObjects

        public Object[] getSelectedObjects()
        チェックボックス・メニュー項目のラベルを含む配列(長さ1)を返します。ただし、チェックボックスにチェック・マークが付けられていない場合には、nullを返します。
        定義:
        getSelectedObjects、インタフェースItemSelectable
        戻り値:
        選択されたオブジェクトのリスト、またはnull
        関連項目:
        ItemSelectable

      • getListeners

        public <T extends EventListener> T[] getListeners​(Class<T> listenerType)
        このCheckboxMenuItemにFooListenerとして現在登録されているすべてのオブジェクトの配列を返します。 FooListenerは、addFooListenerメソッドを使用して登録されます。

        FooListener.classなどのクラス・リテラルを使用してlistenerType引数を指定できます。 たとえば、次のコードを使用して、その項目リスナーのCheckboxMenuItem cを照会できます。 

        ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));
        このようなリスナーがない場合は空の配列を返します。

        オーバーライド:
        getListeners、クラスMenuItem
        型パラメータ:
        T - リスナーの型
        パラメータ:
        listenerType - 要求されるリスナーの型; java.util.EventListenerの下位インタフェースを指定
        戻り値:
        このチェックボックス・メニュー項目上でFooListenerとして登録されたすべてのオブジェクトの配列、またはこのようなリスナーが登録されていない場合は空の配列
        例外:
        ClassCastException - listenerTypeで、java.util.EventListenerを実装するクラスまたはインタフェースが指定されなかった場合
        導入されたバージョン:
        1.3
        関連項目:
        getItemListeners()

      • processEvent

        protected void processEvent​(AWTEvent e)
        このチェックボックス・メニュー項目のイベントを処理します。 イベントがItemEventのインスタンスである場合、このメソッドはprocessItemEventメソッドを呼び出します。 イベントが項目イベントでない場合、スーパー・クラスのprocessEventを呼び出します。

        現在、チェックボックス・メニュー項目がサポートしているのは、項目イベントだけです。

        イベント・パラメータがnullである場合は、動作が未指定のため、例外が発生する可能性があります。

        オーバーライド:
        processEvent、クラスMenuItem
        パラメータ:
        e - イベント
        導入されたバージョン:
        1.1
        関連項目:
        ItemEvent, processItemEvent(java.awt.event.ItemEvent)

      • processItemEvent

        protected void processItemEvent​(ItemEvent e)
        このチェックボックス・メニュー項目で発生する項目イベントを、登録されているItemListenerオブジェクトにディスパッチすることによって処理します。

        このメニュー項目で項目イベントが使用可能でない場合、このメソッドは呼び出されません。 項目イベントは、次の項目の1つが発生したときに使用可能になります。

        • ItemListenerオブジェクトがaddItemListenerによって登録されている。
        • enableEventsによって項目イベントが使用可能になっている。

        イベント・パラメータがnullである場合は、動作が未指定のため、例外が発生する可能性があります。

        パラメータ:
        e - 項目イベント
        導入されたバージョン:
        1.1
        関連項目:
        ItemEvent, ItemListener, addItemListener(java.awt.event.ItemListener), MenuItem.enableEvents(long)

      • paramString

        public String paramString()
        このCheckBoxMenuItemの状態を表す文字列を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、nullにはできません。
        オーバーライド:
        paramString、クラスMenuItem
        戻り値:
        このチェックボックス・メニュー項目のパラメータ文字列

      • getAccessibleContext

        public AccessibleContext getAccessibleContext()
        このCheckboxMenuItemに関連付けられたAccessibleContextを取得します。 CheckboxMenuItemの場合、AccessibleContextはAccessibleAWTCheckboxMenuItemの形式を取ります。 必要に応じて新規のAccessibleAWTCheckboxMenuItemが生成されます。
        定義:
        getAccessibleContext、インタフェースAccessible
        オーバーライド:
        getAccessibleContext、クラスMenuItem
        戻り値:
        このCheckboxMenuItemのAccessibleContextとして機能するAccessibleAWTCheckboxMenuItem
        導入されたバージョン:
        1.3