模块  java.desktop
软件包  javax.swing

Class 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是一个菜单项，它是一组菜单项的一部分，其中只能选择组中的一个项目。 所选项目显示其选定状态。 选择它会导致任何其他所选项目切换到未选择状态。 要控制一组单选按钮菜单项的选定状态，请使用ButtonGroup对象。

    菜单项可以通过Action配置，并在某种程度上受到控制。 将Action与菜单项一起使用除了直接配置菜单项之外还有许多其他好处。 有关更多详细信息，请参阅Swing Components Supporting Action ，您可以在How to Use Actions （Java教程中的一节）中找到更多信息。

    某些菜单可以有多个带有单选按钮菜单项的按钮组。 在这种情况下，单击一个单选按钮菜单项并不关闭菜单是有用的。 这种行为可以由客户端JComponent.putClientProperty(java.lang.Object, java.lang.Object)或名为"RadioButtonMenuItem.doNotCloseOnMouseClick"的外观和感觉UIManager.put(java.lang.Object, java.lang.Object)字段"RadioButtonMenuItem.doNotCloseOnMouseClick" 。 默认值为false 。 将属性设置为true阻止菜单在鼠标单击时关闭。 如果设置了client属性，则始终使用其值; 否则查询L＆F财产。 注意：某些L&F可能会忽略此属性。 所有内置的L&F都继承了这种行为。

    有关更多文档和示例，请参阅“Java教程”中的 How to Use Menus部分。

    警告： Swing不是线程安全的。 有关更多信息，请参阅Swing's Threading Policy 。

    警告：此类的序列化对象与以后的Swing版本不兼容。 当前的序列化支持适用于运行相同版本Swing的应用程序之间的短期存储或RMI。 从1.4开始， java.beans软件包中添加了对所有JavaBeans java.beans长期存储的支持。 请参阅XMLEncoder 。

    从以下版本开始：
    1.2
    另请参见：
    ButtonGroup ， Serialized Form

    • 构造方法详细信息

      • JRadioButtonMenuItem

        public JRadioButtonMenuItem()
        创建一个没有设置文本或图标的 JRadioButtonMenuItem 。

      • JRadioButtonMenuItem

        public JRadioButtonMenuItem​(Icon icon)
        使用图标创建 JRadioButtonMenuItem 。
        参数
        icon - Icon显示在 JRadioButtonMenuItem

      • 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的字符串表示JRadioButtonMenuItem 。 此方法仅用于调试目的，返回字符串的内容和格式可能因实现而异。 返回的字符串可能为空，但可能不是null 。
        重写：
        paramString在类 JMenuItem
        结果
        此 JRadioButtonMenuItem的字符串表示 JRadioButtonMenuItem

      • getAccessibleContext

        @BeanProperty(bound=false)
public AccessibleContext getAccessibleContext()
        获取与此JRadioButtonMenuItem关联的AccessibleContext。 对于JRadioButtonMenuItems，AccessibleContext采用AccessibleJRadioButtonMenuItem的形式。 如有必要，将创建一个新的AccessibleJRadioButtonMenuItem实例。
        Specified by:
        getAccessibleContext在界面 Accessible
        重写：
        getAccessibleContext类 JMenuItem
        结果
        一个AccessibleJRadioButtonMenuItem，用作此JRadioButtonMenuItem的AccessibleContext