@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、インタフェースStyleablepublic 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、インタフェースEventTargettail - 構築元となる初期チェーン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()
getTypeSelector、インタフェースStyleablepublic Styleable getStyleableParent()
getStyleableParent、インタフェースStyleablegetParentMenu()。またはparentMenuがnullの場合にはgetParentPopup()public final ObservableSet<PseudoClass> getPseudoClassStates()
getPseudoClassStates、インタフェースStyleablepublic List<CssMetaData<? extends Styleable,?>> getCssMetaData()
StyleablegetCssMetaData、インタフェースStyleableCopyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.