public class RadioMenuItem extends MenuItem implements Toggle
RadioMenuItemは、切替えが可能なMenuItem
です(Toggle
ミックスインが使用されます)。つまり、RadioMenuItemには、RadioButton
やToggleButton
などToggle
を使用する他のコントロールに本質的に非常によく似たAPIがあります。RadioMenuItemは特にMenu
内で使用するように設計されているため、MenuにRadioMenuItemを追加する方法の詳細は、MenuのクラスAPIのドキュメントを参照してください。
グループ化されていない単純なRadioMenuItemを作成するには、次の手順を実行します。
RadioMenuItem radioItem = new RadioMenuItem("radio text");
radioItem.setSelected(false);
radioItem.setOnAction(new EventHandler<ActionEvent>() {
@Override public void handle(ActionEvent e) {
System.out.println("radio toggled");
}
});
前述の例には、通常のMenuItemを使用するよりも多くの利点はないという問題があります。前述のように、RadioMenuItemの目的はユーザーに複数の選択肢を提供し、任意の1つの時点でこれらの選択肢のうち1つのみを選択できるようにすることです(つまり、選択は相互に排他的になります)。これを実現するために、ゼロ個以上のRadioMenuItemをグループに配置できます。グループの場合、そのグループ内で一度に1つのRadioMenuItemのみを選択できます。2つのRadioMenuItemインスタンスを同じグループに配置するには、単にその両方のtoggleGroup
に同じ値を割り当てます。例:
ToggleGroup toggleGroup = new ToggleGroup();
RadioMenuItem radioItem1 = new RadioMenuItem("Option 1");
radioItem.setOnAction(new EventHandler<ActionEvent>() {
@Override public void handle(ActionEvent e) {
System.out.println("radio toggled");
}
});
radioItem1.setToggleGroup(toggleGroup);
RadioMenuItem radioItem2 = new RadioMenuItem("Option 2");
radioItem.setOnAction(new EventHandler<ActionEvent>() {
@Override public void handle(ActionEvent e) {
System.out.println("radio toggled");
}
});
radioItem2.setToggleGroup(toggleGroup);
この例では、両方のRadioMenuItemを同じToggleGroup
に割り当て、任意の1つの時点でアイテムを1つのみ選択できるようにし、選択が変更された場合にはToggleGroupによって前のアイテムの選択が解除されるようにしています。Type | Property and Description |
---|---|
BooleanProperty |
selected
The selected state for this
Toggle . |
ObjectProperty<ToggleGroup> |
toggleGroup
Represents the
ToggleGroup that this RadioMenuItem belongs to. |
accelerator, disable, graphic, id, mnemonicParsing, onAction, onMenuValidation, parentMenu, parentPopup, style, text, visible
MENU_VALIDATION_EVENT
Constructor and Description |
---|
RadioMenuItem()
Constructs a RadioMenuItem with no display text.
|
RadioMenuItem(String text)
Constructs a RadioMenuItem and sets the display text with the specified text.
|
RadioMenuItem(String text,
Node graphic)
Constructs a RadioMenuItem and sets the display text with the specified text
and sets the graphic
Node to the given node. |
Modifier and Type | Method and Description |
---|---|
ToggleGroup |
getToggleGroup()
Gets the value of the property toggleGroup.
|
boolean |
isSelected()
Gets the value of the property selected.
|
BooleanProperty |
selectedProperty()
The selected state for this
Toggle . |
void |
setSelected(boolean value)
Sets the value of the property selected.
|
void |
setToggleGroup(ToggleGroup value)
Sets the value of the property toggleGroup.
|
ObjectProperty<ToggleGroup> |
toggleGroupProperty()
Represents the
ToggleGroup that this RadioMenuItem belongs to. |
acceleratorProperty, addEventHandler, buildEventDispatchChain, disableProperty, fire, getAccelerator, getCssMetaData, getGraphic, getId, getOnAction, getOnMenuValidation, getParentMenu, getParentPopup, getProperties, getPseudoClassStates, getStyle, getStyleableParent, getStyleClass, getText, getTypeSelector, getUserData, graphicProperty, idProperty, isDisable, isMnemonicParsing, isVisible, mnemonicParsingProperty, onActionProperty, onMenuValidationProperty, parentMenuProperty, parentPopupProperty, removeEventHandler, setAccelerator, setDisable, setGraphic, setId, setMnemonicParsing, setOnAction, setOnMenuValidation, setParentMenu, setParentPopup, setStyle, setText, setUserData, setVisible, styleProperty, textProperty, toString, visibleProperty
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
getProperties, getUserData, setUserData
public final ObjectProperty<ToggleGroup> toggleGroupProperty
ToggleGroup
を表します。toggleGroupProperty
、インタフェース: Toggle
getToggleGroup()
、setToggleGroup(ToggleGroup)
public final BooleanProperty selectedProperty
selectedProperty
、インタフェース: Toggle
isSelected()
、setSelected(boolean)
public RadioMenuItem()
public RadioMenuItem(String text)
public final void setToggleGroup(ToggleGroup value)
setToggleGroup
、インタフェース: Toggle
ToggleGroup
を表します。value
- 新しいToggleGroup
。public final ToggleGroup getToggleGroup()
getToggleGroup
、インタフェース: Toggle
ToggleGroup
を表します。Toggle
が属するToggleGroup
。public final ObjectProperty<ToggleGroup> toggleGroupProperty()
ToggleGroup
を表します。toggleGroupProperty
、インタフェース: Toggle
getToggleGroup()
、setToggleGroup(ToggleGroup)
public final void setSelected(boolean value)
setSelected
、インタフェース: Toggle
value
- value - このToggle
を選択するにはtrue
。public final boolean isSelected()
isSelected
、インタフェース: Toggle
Toggle
が選択されている場合はtrue
。public final BooleanProperty selectedProperty()
Toggle
Toggle
の選択された状態。selectedProperty
、インタフェース: Toggle
isSelected()
、setSelected(boolean)
Copyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.