Module  javafx.controls
软件包  javafx.scene.control

Class CheckMenuItem

  • All Implemented Interfaces:
    Styleable ， EventTarget 

    public class CheckMenuItem
extends MenuItem

    A MenuItem可以在选定状态和未选择状态之间切换。 它的目的是将CheckMenuItem与Menu或ContextMenu控件结合使用。

    在菜单中创建和插入一个CheckMenuItem如下所示。 

       final subsystem1 = new CheckMenuItem("Enabled"); subsystem1.setOnAction(new EventHandler<ActionEvent>() { public void handle(ActionEvent e) { System.out.println("subsystem1 #1 Enabled!"); } }); Menu subsystemsMenu = new Menu("Subsystems"); subsystemsMenu.add(subsystem1);

    当然，上面的方法从菜单中分离出CheckMenuItem的定义，但这不一定是这样的。

    要确定CheckMenuItem的当前状态，您应该参考selected布尔值。 示例用例可能是以下示例： 

       final checkMenuItem = new CheckMenuItem("Show Widget"); subsystem1.setOnAction(new EventHandler<ActionEvent>() { public void handle(ActionEvent e) { System.out.println("Show the widget!"); } }); private final BooleanProperty widgetShowing(); public final boolean isWidgetShowing() { return widgetShowing.get(); ) public final void setWidgetShowing(boolean value) { widgetShowingProperty().set(value); } public final BooleanProperty widgetShowingProperty() { if (widgetShowing == null) { widgetShowing = new SimpleBooleanProperty(this, "widgetShowing", true); } return widgetShowing; } widgetShowing.bind(checkMenuItem.selected);

    通常，一个CheckMenuItem将被渲染，使得当被选中时，它在通常为MenuItem图形保留的区域中显示一个检查（或刻度）标记。 当然，这会因皮肤和造型而异。

    从以下版本开始：
    JavaFX 2.0
    另请参见：
    Menu ， MenuItem ， RadioMenuItem

    • Property Detail

      • selected

        public final BooleanProperty selectedProperty
        表示此CheckMenuItem的当前状态。 绑定到这一点，只要用户与CheckMenuItem进行交互（并导致所选状态被切换）。
        Default value:
        假
        另请参见：
        isSelected() ， setSelected(boolean)

    • 构造方法详细信息

      • CheckMenuItem

        public CheckMenuItem​()
        *构造函数* *

      • CheckMenuItem

        public CheckMenuItem​(String text)
        构造一个CheckMenuItem并设置具有指定文本的显示文本。
        参数
        text - 显示文字

      • CheckMenuItem

        public CheckMenuItem​(String text,
                     Node graphic)
        构造一个CheckMenuItem并设置具有指定文本的显示文本，并将图形Node设置为给定节点。
        参数
        text - 显示文字
        graphic - 图形节点

    • 方法详细信息

      • setSelected

        public final void setSelected​(boolean value)
        设置所选属性的值。
        Property description:
        表示此CheckMenuItem的当前状态。 绑定到这一点，只要用户与CheckMenuItem进行交互（并导致所选状态被切换）。
        Default value:
        假

      • isSelected

        public final boolean isSelected​()
        获取所选属性的值。
        Property description:
        表示此CheckMenuItem的当前状态。 绑定到这一点，只要用户与CheckMenuItem进行交互（并导致所选状态被切换）。
        Default value:
        假

      • selectedProperty

        public final BooleanProperty selectedProperty​()
        表示此CheckMenuItem的当前状态。 绑定到这一点，只要用户与CheckMenuItem进行交互（并导致所选状态被切换）。
        Default value:
        假
        另请参见：
        isSelected() ， setSelected(boolean)