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

クラスJRadioButtonMenuItem

java.lang.Object
すべての実装されたインタフェース:
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に設定すると、マウスでメニューをクリックしたときにメニューが閉じなくなります。 クライアント・プロパティが設定されている場合、その値は常に使用されます。それ以外の場合は、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
関連項目: