モジュール java.desktop
パッケージ javax.swing

クラスJRadioButtonMenuItem

  • すべての実装されたインタフェース:
    ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, MenuElement, SwingConstants
    @JavaBean(description="A component within a group of menu items which can be selected.")
public class JRadioButtonMenuItem
extends JMenuItem
implements Accessible
    ラジオ・ボタン・メニュー項目の実装です。 JRadioButtonMenuItemはメニュー項目のグループの一部となるメニュー項目で、グループ内では項目を1つだけ選択できます。 選択された項目は、選択状態を表示します。 また、この結果、選択されていたほかの項目は選択解除状態に切り替わります。 ラジオ・ボタン・メニュー項目のグループの選択状態を制御するには、ButtonGroupオブジェクトを使用します。

    メニュー項目は構成可能であり、Actionを使用してある程度制御できます。 メニュー項目でActionを使用することは、メニュー項目を直接構成するのと比べて多くの利点があります。 詳細は「ActionをサポートするSwingコンポーネント」を参照してください。さらに、Java チュートリアルのActionsの使用方法のセクションに詳細が説明されています。

    一部のメニューには、ラジオ・ボタン・メニュー項目を含む複数のボタン・グループを含めることができます。 この場合、1つのラジオ・ボタン・メニュー項目をクリックしてもメニューが閉じないと便利です。 このような動作は、クライアントJComponent.putClientProperty(java.lang.Object, java.lang.Object)またはルック・アンド・フィールUIManager.put(java.lang.Object, java.lang.Object)プロパティ"RadioButtonMenuItem.doNotCloseOnMouseClick"によって制御できます。 デフォルト値はfalseです。 プロパティをtrueに設定すると、マウスでクリックしたときにメニューが閉じません。 クライアントプロパティーが設定されている場合は、その値が常に使用されます。それ以外の場合は、L&Fプロパティーが照会されます。 ノート: 一部のL&Fでは、このプロパティが無視されることがあります。 すべての組込みL&Fは、この動作を継承します。

    詳細と使用例については、『The Java Tutorial』のセクション「How to Use Menus」を参照してください。

    警告: Swingはスレッドに対して安全ではありません。 詳細は、「Swing's Threading Policy」を参照してください。

    警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 1.4以降、すべてのJavaBeans™用の長期間の格納サポートがjava.beansパッケージに追加されています。 XMLEncoderを参照してください。

    導入されたバージョン:
    1.2
    関連項目:
    ButtonGroup、直列化された形式

    • コンストラクタの詳細

      • JRadioButtonMenuItem

        public JRadioButtonMenuItem()
        テキストおよびアイコンを指定しないでJRadioButtonMenuItemを作成します。

      • JRadioButtonMenuItem

        public JRadioButtonMenuItem​(Icon icon)
        アイコンを指定してJRadioButtonMenuItemを作成します。
        パラメータ:
        icon - JRadioButtonMenuItemに表示するIcon

      • JRadioButtonMenuItem

        public JRadioButtonMenuItem​(String text)
        テキストを指定してJRadioButtonMenuItemを作成します。
        パラメータ:
        text - JRadioButtonMenuItemのテキスト

      • JRadioButtonMenuItem

        public JRadioButtonMenuItem​(Action a)
        指定されたActionからプロパティを取得するラジオ・ボタン・メニュー項目を作成します。
        パラメータ:
        a - ラジオ・ボタン・メニュー項目のベースとなるAction
        導入されたバージョン:
        1.3

      • JRadioButtonMenuItem

        public JRadioButtonMenuItem​(String text,
                            Icon icon)
        指定されたIconとテキストを使用して、ラジオ・ボタン・メニュー項目を作成します。
        パラメータ:
        text - JRadioButtonMenuItemのテキスト
        icon - JRadioButtonMenuItemに表示するアイコン

      • JRadioButtonMenuItem

        public JRadioButtonMenuItem​(String text,
                            boolean selected)
        ラジオ・ボタン・メニュー項目を、選択状態とテキストを指定して作成します。
        パラメータ:
        text - CheckBoxMenuItemのテキスト
        selected - CheckBoxMenuItemの選択状態

      • JRadioButtonMenuItem

        public JRadioButtonMenuItem​(Icon icon,
                            boolean selected)
        ラジオ・ボタン・メニュー項目を、イメージおよび選択状態を指定し、テキストを指定しないで作成します。
        パラメータ:
        icon - ボタンで表示するイメージ
        selected - trueの場合、初期状態でボタンが選択される。それ以外の場合、初期状態でボタンは選択されない

      • JRadioButtonMenuItem

        public JRadioButtonMenuItem​(String text,
                            Icon icon,
                            boolean selected)
        ラジオ・ボタン・メニュー項目を、テキスト、イメージ、および選択状態を指定して作成します。 ほかのすべてのコンストラクタはこのコンストラクタに集約されます。
        パラメータ:
        text - ラジオ・ボタンに表示する文字列
        icon - ボタンで表示するイメージ
        selected - trueの場合、ボタンは最初に選択されます。それ以外の場合、ボタンは最初は選択されません

    • メソッドの詳細

      • paramString

        protected String paramString()
        このJRadioButtonMenuItemの文字列表現を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、nullにはできません。
        オーバーライド:
        paramString、クラスJMenuItem
        戻り値:
        このJRadioButtonMenuItemの文字列表現

      • getAccessibleContext

        @BeanProperty(bound=false)
public AccessibleContext getAccessibleContext()
        このJRadioButtonMenuItemに関連付けられたAccessibleContextを取得します。 JRadioButtonMenuItemの場合、AccessibleContextはAccessibleJRadioButtonMenuItemの形式を取ります。 必要に応じて新規のAccessibleJRadioButtonMenuItemインスタンスが作成されます。
        定義:
        getAccessibleContext、インタフェースAccessible
        オーバーライド:
        getAccessibleContext、クラスJMenuItem
        戻り値:
        このJRadioButtonMenuItemのAccessibleContextとして機能するAccessibleJRadioButtonMenuItem