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

クラスJRadioButtonMenuItem

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.AbstractButton
javax.swing.JMenuItem
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)またはLook&Feel UIManager.put(java.lang.Object, java.lang.Object)プロパティ"RadioButtonMenuItem.doNotCloseOnMouseClick"のいずれかによって制御できます。 デフォルト値はfalseです。 プロパティをtrueに設定すると、マウスでクリックしたときにメニューが閉じなくなります。 clientプロパティが設定されている場合、その値は常に使用されます。それ以外の場合は、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
関連項目:

  • コンストラクタの詳細

    • 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の場合、最初にボタンが選択され、そうでない場合、ボタンは最初は選択されません

  • メソッドの詳細

    • getUIClassID

      @BeanProperty(bound=false) public String getUIClassID()
      このコンポーネントをレンダリングするL&Fクラスの名前を返します。
      オーバーライド:
      getUIClassID 、クラス:  JMenuItem
      戻り値:
      文字列「RadioButtonMenuItemUI」
      関連項目:

    • 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