Module java.desktop
Package javax.swing

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

菜单项可以通过 Action 进行配置，并在某种程度上进行控制。使用 Action 与菜单项有许多好处，超出了直接配置菜单项。有关更多详细信息，请参阅支持 Action 的 Swing 组件，您可以在如何使用 Actions中找到更多信息，这是《Java 教程》中的一节。

一些菜单可以有几个带有单选按钮菜单项的按钮组。在这种情况下，点击一个单选按钮菜单项时不关闭菜单是有用的。这种行为可以通过客户端 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 教程》中的一节。

警告: Swing 不是线程安全的。有关更多信息，请参阅Swing 的线程策略。

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

自:
1.2
参见:

  • Constructor Details

    • 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，则按钮最初为选定状态，否则，按钮最初为未选定状态

  • Method Details

    • 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。对于 JRadioButtonMenuItems，AccessibleContext 采用 AccessibleJRadioButtonMenuItem 的形式。如有必要，将创建一个新的 AccessibleJRadioButtonMenuItem 实例。
      指定者:
      getAccessibleContext 在接口 Accessible 中
      覆盖:
      getAccessibleContext 在类 JMenuItem 中
      返回:
      作为此 JRadioButtonMenuItem 的 AccessibleContext 的 AccessibleJRadioButtonMenuItem