Module  java.desktop
软件包  javax.swing

Class JRadioButtonMenuItem

  • All Implemented Interfaces:
    ImageObserverItemSelectableMenuContainerSerializableAccessibleMenuElementSwingConstants


    @JavaBean(description="A component within a group of menu items which can be selected.")
    public class JRadioButtonMenuItem
    extends JMenuItem
    implements Accessible
    单选按钮菜单项的实现。 A JRadioButtonMenuItem是菜单项,它是一组菜单项的一部分,其中只能选择组中的一个项目。 所选项显示其所选状态。 选择它将导致任何其他所选项目切换到未选择的状态。 要控制一组单选按钮菜单项的选定状态,请使用ButtonGroup对象。

    菜单项可以配置,并在一定程度上由Action秒控制。 使用带有菜单项的Action除了直接配置菜单项之外,还有很多好处。 有关详细信息,请参阅Swing Components Supporting Action ,您可以在“Java教程”一节中 How to Use Actions中找到更多信息。

    一些菜单可以有多个按钮组,其中包含单选按钮菜单项。 在这种情况下,单击一个单选按钮菜单项不会关闭菜单是有用的。 这种行为可以通过客户端进行控制或者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都继承了这种行为。

    有关进一步的文档和示例,请参阅“Java教程”中的 How to Use Menus ”一节

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

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

    从以下版本开始:
    1.2
    另请参见:
    ButtonGroupSerialized 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 - 如果为真,则初始选择该按钮; 否则,该按钮最初未被选择
      • 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
        重写:
        getAccessibleContextJMenuItem
        结果
        一个AccessibleJRadioButtonMenuItem,用作这个JRadioButtonMenuItem的AccessibleContext