@IDProperty(value="id") public class MenuItem extends Object implements EventTarget, Styleable
MenuItemは、ユーザーにオプションを提供する目的でMenu
と組み合せて使用されます。MenuItemは、JavaFXのメニューのAPIの大部分のベース・クラスとして機能します。表示のtext
プロパティを保持し、オプションでgraphic
ノードを設定できます。accelerator
プロパティでは、関連アクションに1回のキー操作でアクセスできるようにします。また、Button
コントロールと同様に、setOnAction(javafx.event.EventHandler<javafx.event.ActionEvent>)
メソッドを使用して、MenuItemのインスタンスで任意のアクションを実行できます。
注意: MenuItemには任意のサイズのグラフィックを挿入できますが、ほとんどのアプリケーションで最もよく使用されるサイズは16x16ピクセルです。JavaFXから提供されるデフォルトのスタイルを使用する場合は、このグラフィック寸法を使用することをお薦めします。
MenuItemは次のように簡単に作成できます。
MenuItem menuItem = new MenuItem("Open");
menuItem.setOnAction(new EventHandler<ActionEvent>() {
@Override public void handle(ActionEvent e) {
System.out.println("Opening Database Connection...");
}
});
menuItem.setGraphic(new ImageView(new Image("flower.png")));
MenuItemをメニュー・インスタンスに挿入する方法の詳細は、Menu
ページを参照してください。簡単に説明すると、前述の例のMenuItemは次のようにMenuに挿入できます。
final Menu menu = new Menu("File");
menu.getItems().add(menuItem);
Menu
Type | プロパティと説明 |
---|---|
ObjectProperty<KeyCombination> |
accelerator
アクセラレータ・プロパティでは、関連アクションに1回のキー操作でアクセスできるようにします。
|
BooleanProperty |
disable
このMenuItemの個別の無効化状態を設定します。
|
ObjectProperty<Node> |
graphic
MenuItem のオプション・グラフィック。 |
StringProperty |
id
このMenuItemのID。
|
BooleanProperty |
mnemonicParsing
テキストの解析を有効/無効にするMnemonicParsingプロパティ。
|
ObjectProperty<EventHandler<ActionEvent>> |
onAction
MenuItemが起動されると常に起動されるアクション。
|
ObjectProperty<EventHandler<Event>> |
onMenuValidation
MenuItemのアクセラレータの起動に関連付けられているイベント・ハンドラ。
|
ReadOnlyObjectProperty<Menu> |
parentMenu
これは、この
MenuItem が存在するMenu です。 |
ReadOnlyObjectProperty<ContextMenu> |
parentPopup
これは、この
MenuItem が存在するContextMenu です。 |
StringProperty |
style
このMenuItemに関連付けられているCSSスタイルの文字列表現。
|
StringProperty |
text
MenuItem に表示するテキスト。 |
BooleanProperty |
visible
このMenuItemをシーン・グラフの一部としてレンダリングする必要があるかどうかを指定します。
|
修飾子と型 | フィールドと説明 |
---|---|
static EventType<Event> |
MENU_VALIDATION_EVENT
Menuitemのアクセラレータが起動されると呼び出されます。
|
コンストラクタと説明 |
---|
MenuItem()
表示テキストなしでMenuItemを構築します。
|
MenuItem(String text)
MenuItemを構築し、指定されたテキストで表示テキストを設定します。
|
MenuItem(String text, Node graphic)
MenuItemを構築し、指定されたテキストで表示テキストを設定し、グラフィック
Node を指定されたノードに設定します。 |
修飾子と型 | メソッドと説明 |
---|---|
ObjectProperty<KeyCombination> |
acceleratorProperty()
アクセラレータ・プロパティでは、関連アクションに1回のキー操作でアクセスできるようにします。
|
<E extends Event> |
addEventHandler(EventType<E> eventType, EventHandler<E> eventHandler)
このMenuItemにイベント・ハンドラを登録します。
|
EventDispatchChain |
buildEventDispatchChain(EventDispatchChain tail)
このターゲットのイベント・ディスパッチ・チェーンを構築します。
|
BooleanProperty |
disableProperty()
このMenuItemの個別の無効化状態を設定します。
|
void |
fire()
新しいActionEventを起動します。
|
KeyCombination |
getAccelerator()
プロパティacceleratorの値を取得します。
|
List<CssMetaData<? extends Styleable,?>> |
getCssMetaData()
このStyleableのCssMetaData。
|
Node |
getGraphic()
プロパティgraphicの値を取得します。
|
String |
getId()
プロパティidの値を取得します。
|
EventHandler<ActionEvent> |
getOnAction()
プロパティonActionの値を取得します。
|
EventHandler<Event> |
getOnMenuValidation()
プロパティonMenuValidationの値を取得します。
|
Menu |
getParentMenu()
プロパティparentMenuの値を取得します。
|
ContextMenu |
getParentPopup()
プロパティparentPopupの値を取得します。
|
ObservableMap<Object,Object> |
getProperties()
アプリケーション開発者が主に使用するこのメニュー・アイテムのプロパティの監視可能なマップを返します。
|
ObservableSet<PseudoClass> |
getPseudoClassStates()
このStyleableの擬似クラスの状態を返します。
|
String |
getStyle()
プロパティstyleの値を取得します。
|
Styleable |
getStyleableParent()
このStyleableの親を返すか、親がない場合はnullを返します。
|
ObservableList<String> |
getStyleClass()
*パブリックAPI* *
|
String |
getText()
プロパティtextの値を取得します。
|
String |
getTypeSelector()
セレクタの照合に使用されるこの
Styleable の型。 |
Object |
getUserData()
以前に設定したObjectプロパティを返すか、または
setUserData(java.lang.Object) メソッドを使用してこのようなプロパティを設定していない場合にはnullを返します。 |
ObjectProperty<Node> |
graphicProperty()
MenuItem のオプション・グラフィック。 |
StringProperty |
idProperty()
このMenuItemのID。
|
boolean |
isDisable()
プロパティdisableの値を取得します。
|
boolean |
isMnemonicParsing()
プロパティmnemonicParsingの値を取得します。
|
boolean |
isVisible()
プロパティvisibleの値を取得します。
|
BooleanProperty |
mnemonicParsingProperty()
テキストの解析を有効/無効にするMnemonicParsingプロパティ。
|
ObjectProperty<EventHandler<ActionEvent>> |
onActionProperty()
MenuItemが起動されると常に起動されるアクション。
|
ObjectProperty<EventHandler<Event>> |
onMenuValidationProperty()
MenuItemのアクセラレータの起動に関連付けられているイベント・ハンドラ。
|
ReadOnlyObjectProperty<Menu> |
parentMenuProperty()
これは、この
MenuItem が存在するMenu です。 |
ReadOnlyObjectProperty<ContextMenu> |
parentPopupProperty()
これは、この
MenuItem が存在するContextMenu です。 |
<E extends Event> |
removeEventHandler(EventType<E> eventType, EventHandler<E> eventHandler)
以前に登録したイベント・ハンドラをこのMenuItemから登録解除します。
|
void |
setAccelerator(KeyCombination value)
プロパティacceleratorの値を設定します。
|
void |
setDisable(boolean value)
プロパティdisableの値を設定します。
|
void |
setGraphic(Node value)
プロパティgraphicの値を設定します。
|
void |
setId(String value)
プロパティidの値を設定します。
|
void |
setMnemonicParsing(boolean value)
プロパティmnemonicParsingの値を設定します。
|
void |
setOnAction(EventHandler<ActionEvent> value)
プロパティonActionの値を設定します。
|
void |
setOnMenuValidation(EventHandler<Event> value)
プロパティonMenuValidationの値を設定します。
|
protected void |
setParentMenu(Menu value)
プロパティparentMenuの値を設定します。
|
protected void |
setParentPopup(ContextMenu value)
プロパティparentPopupの値を設定します。
|
void |
setStyle(String value)
プロパティstyleの値を設定します。
|
void |
setText(String value)
プロパティtextの値を設定します。
|
void |
setUserData(Object value)
後で取得できる単一のObjectプロパティを設定するためのコンビニエンス・メソッド。
|
void |
setVisible(boolean value)
プロパティvisibleの値を設定します。
|
StringProperty |
styleProperty()
このMenuItemに関連付けられているCSSスタイルの文字列表現。
|
StringProperty |
textProperty()
MenuItem に表示するテキスト。 |
String |
toString() |
BooleanProperty |
visibleProperty()
このMenuItemをシーン・グラフの一部としてレンダリングする必要があるかどうかを指定します。
|
public final StringProperty idProperty
getId()
、setId(String)
public final StringProperty styleProperty
getStyle()
、setStyle(String)
public final ReadOnlyObjectProperty<Menu> parentMenuProperty
MenuItem
が存在するMenu
です。このクラスのインスタンスにはparentMenu
がない可能性があります。その場合、このインスタンスは次のいずれかになります。
parentMenu
に関連付けられていません。
Menu
(つまり、MenuBar
やMenuButton
か、またはMenu
を内部的に使用するその他のコントロールに直接アタッチされているコンテキスト・メニュー)。
public final ReadOnlyObjectProperty<ContextMenu> parentPopupProperty
MenuItem
が存在するContextMenu
です。public final StringProperty textProperty
MenuItem
に表示するテキスト。getText()
、setText(String)
public final ObjectProperty<Node> graphicProperty
MenuItem
のオプション・グラフィック。これは通常ImageView
ノードですが、必須ではありません。getGraphic()
、setGraphic(Node)
public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty
fire()
メソッドを起動したことによって発生する場合があります。public final ObjectProperty<EventHandler<Event>> onMenuValidationProperty
getOnMenuValidation()
、setOnMenuValidation(EventHandler)
public final BooleanProperty disableProperty
public final BooleanProperty visibleProperty
public final ObjectProperty<KeyCombination> acceleratorProperty
public final BooleanProperty mnemonicParsingProperty
MenuItemのデフォルト値はtrueです。
public MenuItem()
public MenuItem(String text)
public final void setId(String value)
public final String getId()
public final StringProperty idProperty()
getId()
、setId(String)
public final void setStyle(String value)
public final String getStyle()
public final StringProperty styleProperty()
getStyle()
、setStyle(String)
protected final void setParentMenu(Menu value)
MenuItem
が存在するMenu
です。このクラスのインスタンスにはparentMenu
がない可能性があります。その場合、このインスタンスは次のいずれかになります。
parentMenu
に関連付けられていません。
Menu
(つまり、MenuBar
やMenuButton
か、またはMenu
を内部的に使用するその他のコントロールに直接アタッチされているコンテキスト・メニュー)。
public final Menu getParentMenu()
MenuItem
が存在するMenu
です。このクラスのインスタンスにはparentMenu
がない可能性があります。その場合、このインスタンスは次のいずれかになります。
parentMenu
に関連付けられていません。
Menu
(つまり、MenuBar
やMenuButton
か、またはMenu
を内部的に使用するその他のコントロールに直接アタッチされているコンテキスト・メニュー)。
public final ReadOnlyObjectProperty<Menu> parentMenuProperty()
MenuItem
が存在するMenu
です。このクラスのインスタンスにはparentMenu
がない可能性があります。その場合、このインスタンスは次のいずれかになります。
parentMenu
に関連付けられていません。
Menu
(つまり、MenuBar
やMenuButton
か、またはMenu
を内部的に使用するその他のコントロールに直接アタッチされているコンテキスト・メニュー)。
protected final void setParentPopup(ContextMenu value)
MenuItem
が存在するContextMenu
です。public final ContextMenu getParentPopup()
MenuItem
が存在するContextMenu
です。public final ReadOnlyObjectProperty<ContextMenu> parentPopupProperty()
MenuItem
が存在するContextMenu
です。public final void setText(String value)
MenuItem
に表示するテキスト。public final String getText()
MenuItem
に表示するテキスト。public final StringProperty textProperty()
MenuItem
に表示するテキスト。getText()
、setText(String)
public final void setGraphic(Node value)
MenuItem
のオプション・グラフィック。これは通常ImageView
ノードですが、必須ではありません。public final Node getGraphic()
MenuItem
のオプション・グラフィック。これは通常ImageView
ノードですが、必須ではありません。public final ObjectProperty<Node> graphicProperty()
MenuItem
のオプション・グラフィック。これは通常ImageView
ノードですが、必須ではありません。getGraphic()
、setGraphic(Node)
public final void setOnAction(EventHandler<ActionEvent> value)
fire()
メソッドを起動したことによって発生する場合があります。public final EventHandler<ActionEvent> getOnAction()
fire()
メソッドを起動したことによって発生する場合があります。public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty()
fire()
メソッドを起動したことによって発生する場合があります。public final void setOnMenuValidation(EventHandler<Event> value)
public final EventHandler<Event> getOnMenuValidation()
public final ObjectProperty<EventHandler<Event>> onMenuValidationProperty()
getOnMenuValidation()
、setOnMenuValidation(EventHandler)
public final void setDisable(boolean value)
public final boolean isDisable()
public final BooleanProperty disableProperty()
public final void setVisible(boolean value)
public final boolean isVisible()
public final BooleanProperty visibleProperty()
public final void setAccelerator(KeyCombination value)
public final KeyCombination getAccelerator()
public final ObjectProperty<KeyCombination> acceleratorProperty()
public final void setMnemonicParsing(boolean value)
MenuItemのデフォルト値はtrueです。
public final boolean isMnemonicParsing()
MenuItemのデフォルト値はtrueです。
public final BooleanProperty mnemonicParsingProperty()
MenuItemのデフォルト値はtrueです。
public ObservableList<String> getStyleClass()
getStyleClass
、インタフェース: Styleable
public void fire()
public <E extends Event> void addEventHandler(EventType<E> eventType, EventHandler<E> eventHandler)
Event
を受け取ると呼び出されます。E
- ハンドラの特定のイベント・クラスeventType
- ハンドラが受け取るイベントのタイプeventHandler
- 登録するハンドラNullPointerException
- イベント・タイプまたはハンドラがnullの場合public <E extends Event> void removeEventHandler(EventType<E> eventType, EventHandler<E> eventHandler)
E
- ハンドラの特定のイベント・クラスeventType
- 登録解除するイベント・タイプeventHandler
- 登録解除するハンドラNullPointerException
- イベント・タイプまたはハンドラがnullの場合public EventDispatchChain buildEventDispatchChain(EventDispatchChain tail)
EventTarget
を対象にしたイベントの処理に関係する可能性があるイベント・ディスパッチャが含まれます。このイベント・ターゲットはチェーンに自動的には追加されないため、これがイベントを処理する場合は、それ自体のEventDispatcher
をチェーンに追加する必要があります。
イベント・ターゲットが階層の一部である場合、そのチェーンは通常、階層のルートからイベント・ターゲットまでの収集されたイベント・ディスパッチャから作成されます。
イベント・ディスパッチ・チェーンは、提供される初期イベント・ディスパッチ・チェーンに対する変更によって構築されます。返されるチェーンでは初期チェーンが最後にある必要があるため、ディスパッチャは初期チェーンの前に追加される必要があります。
呼出し元は、初期チェーンが変更されないままであることや、返される値によって異なるチェーンが参照されることを想定できません。
buildEventDispatchChain
、インタフェース: EventTarget
tail
- 構築元となる初期チェーンpublic Object getUserData()
setUserData(java.lang.Object)
メソッドを使用してこのようなプロパティを設定していない場合にはnullを返します。public void setUserData(Object value)
Node.getUserData()
を呼び出して取得できます。value
- 格納される値。これは、後でNode.getUserData()
を呼び出して取得できます。public ObservableMap<Object,Object> getProperties()
public String getTypeSelector()
Styleable
の型。これはHTMLの要素に似ています(CSSタイプ・セレクタ)。getTypeSelector
、インタフェース: Styleable
public Styleable getStyleableParent()
getStyleableParent
、インタフェース: Styleable
getParentMenu()
。またはparentMenu
がnullの場合にはgetParentPopup()
public final ObservableSet<PseudoClass> getPseudoClassStates()
getPseudoClassStates
、インタフェース: Styleable
public List<CssMetaData<? extends Styleable,?>> getCssMetaData()
Styleable
getCssMetaData
、インタフェース: Styleable
Copyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.