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つだけです。選択が変更されると、ToggleGroupは前のアイテムの選択を解除します。
| 型 | プロパティと説明 |
|---|---|
BooleanProperty |
selected
この
Toggleの選択された状態。 |
ObjectProperty<ToggleGroup> |
toggleGroup
このRadioMenuItemが属する
ToggleGroupを表します。 |
accelerator, disable, graphic, id, mnemonicParsing, onAction, onMenuValidation, parentMenu, parentPopup, style, text, visibleMENU_VALIDATION_EVENT| コンストラクタと説明 |
|---|
RadioMenuItem()
表示テキストなしでRadioMenuItemを構築します。
|
RadioMenuItem(String text)
RadioMenuItemを構築し、指定されたテキストで表示テキストを設定します。
|
RadioMenuItem(String text, Node graphic)
RadioMenuItemを構築し、指定されたテキストで表示テキストを設定し、グラフィック
Nodeを指定されたノードに設定します。 |
| 修飾子と型 | メソッドと説明 |
|---|---|
ToggleGroup |
getToggleGroup()
プロパティtoggleGroupの値を取得します。
|
boolean |
isSelected()
プロパティselectedの値を取得します。
|
BooleanProperty |
selectedProperty()
この
Toggleの選択された状態。 |
void |
setSelected(boolean value)
プロパティselectedの値を設定します。
|
void |
setToggleGroup(ToggleGroup value)
プロパティtoggleGroupの値を設定します。
|
ObjectProperty<ToggleGroup> |
toggleGroupProperty()
このRadioMenuItemが属する
ToggleGroupを表します。 |
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, visiblePropertyclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitgetProperties, getUserData, setUserDatapublic final ObjectProperty<ToggleGroup> toggleGroupProperty
ToggleGroupを表します。toggleGroupProperty、インタフェースTogglegetToggleGroup()、setToggleGroup(ToggleGroup)public final BooleanProperty selectedProperty
selectedProperty、インタフェースToggleisSelected()、setSelected(boolean)public RadioMenuItem()
public RadioMenuItem(String text)
public final void setToggleGroup(ToggleGroup value)
setToggleGroup、インタフェースToggleToggleGroupを表します。value - 新しいToggleGroup。public final ToggleGroup getToggleGroup()
getToggleGroup、インタフェースToggleToggleGroupを表します。Toggleが属するToggleGroup。public final ObjectProperty<ToggleGroup> toggleGroupProperty()
ToggleGroupを表します。toggleGroupProperty、インタフェースTogglegetToggleGroup()、setToggleGroup(ToggleGroup)public final void setSelected(boolean value)
setSelected、インタフェースTogglevalue - value - このToggleを選択するにはtrue。public final boolean isSelected()
isSelected、インタフェースToggleToggleが選択されている場合はtrue。public final BooleanProperty selectedProperty()
ToggleToggleの選択された状態。selectedProperty、インタフェースToggleisSelected()、setSelected(boolean)Copyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.