Spec-Zone.ru › OpenJavaFX 8
javafx.scene.control

Класс MenuButton

java.lang.Object
  • javafx.scene.Node
    • javafx.scene.Parent
      • javafx.scene.layout.Region
        • javafx.scene.control.Control
          • javafx.scene.control.Labeled
            • javafx.scene.control.ButtonBase
              • javafx.scene.control.MenuButton

Все реализованные интерфейсы:

Styleable, EventTarget, Skinnable

Прямые известные подклассы:

SplitMenuButton


public class MenuButton
extends ButtonBase
MenuButton — это кнопка, которая при нажатии отображает контекстное меню. API MenuButton очень похож на API элемента управления Menu, поскольку вы устанавливаете элементы, которые должны отображаться в списке items ObservableList, и существует свойство Labeled.text для указания метки, отображаемой внутри MenuButton.

Как упоминалось, как и сам API меню, вы найдете ObservableList items, в котором вы можете указать любой элемент, расширяющий MenuItem. Существует несколько полезных подклассов MenuItem, включая RadioMenuItem, CheckMenuItem, Menu, SeparatorMenuItem и CustomMenuItem.

Кнопка MenuButton может быть настроена на отображение меню с любой стороны кнопки. Это задаётся с помощью свойства popupSide. По умолчанию меню отображается под кнопкой. Однако независимо от указанного popupSide, если места недостаточно, контекстное меню будет разумно перепозиционировано, вероятно, на противоположную сторону MenuButton.

Пример:

MenuButton m = new MenuButton("Eats");
 m.getItems().addAll(new MenuItem("Burger"), new MenuItem("Hot Dog"));

Обработка мнемоники включена по умолчанию для MenuButton.

С:

JavaFX 2.0

См. также:

MenuItem, Menu, SplitMenuButton

  • Краткое описание свойств

    Все методыМетоды экземпляраКонкретные методы
    Тип Свойство и описание
    ObjectProperty<Side> popupSide
    Указывает, с какой стороны должно открыться контекстное меню относительно MenuButton.
    ReadOnlyBooleanProperty showing
    Указывает, отображается ли в данный момент контекстное меню.

    • Свойства, унаследованные от класса javafx.scene.control.ButtonBase

      armed, onAction

    • Свойства, унаследованные от класса javafx.scene.control.Labeled

      alignment, contentDisplay, ellipsisString, font, graphic, graphicTextGap, labelPadding, lineSpacing, mnemonicParsing, textAlignment, textFill, textOverrun, text, underline, wrapText

    • Свойства, унаследованные от класса javafx.scene.control.Control

      contextMenu, skin, tooltip

    • Свойства, унаследованные от класса javafx.scene.layout.Region

      background, border, cacheShape, centerShape, height, insets, maxHeight, maxWidth, minHeight, minWidth, opaqueInsets, padding, prefHeight, prefWidth, scaleShape, shape, snapToPixel, width

    • Свойства, унаследованные от класса javafx.scene.Parent

      needsLayout

    • Свойства, унаследованные от класса javafx.scene.Node

      accessibleHelp, accessibleRoleDescription, accessibleRole, accessibleText, blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, visible

  • Краткое описание полей

    • Поля, унаследованные от класса javafx.scene.layout.Region

      USE_COMPUTED_SIZE, USE_PREF_SIZE

    • Поля, унаследованные от класса javafx.scene.Node

      BASELINE_OFFSET_SAME_AS_HEIGHT

  • Краткое описание конструкторов

    Конструкторы
    Конструктор и описание
    MenuButton()
    Создаёт новую пустую кнопку меню.
    MenuButton(String text)
    Создаёт новую пустую кнопку меню с заданным текстом для отображения на кнопке.
    MenuButton(String text, Node graphic)
    Создаёт новую пустую кнопку меню с заданным текстом и графикой для отображения на кнопке.
    MenuButton(String text, Node graphic, MenuItem... items)
    Создаёт новую кнопку меню с заданным текстом и графикой для отображения на кнопке, а также вставляет заданные элементы в список items.

  • Краткое описание методов

    Все методыМетоды экземпляраКонкретные методы
    Модификатор и тип Метод и описание
    protected Skin<?> createDefaultSkin()
    Создаёт новый экземпляр стандартной темы для этого элемента управления.
    void executeAccessibleAction(AccessibleAction action, Object... parameters)
    * Обработка доступности * *
    void fire()
    Это не оказывает никакого влияния.
    ObservableList<MenuItem> getItems()
    Элементы, которые будут отображаться в меню этой кнопки.
    Side getPopupSide()
    Получает значение свойства popupSide.
    void hide()
    Скрывает контекстное меню.
    boolean isShowing()
    Получает значение свойства showing.
    ObjectProperty<Side> popupSideProperty()
    Указывает, с какой стороны должно открыться контекстное меню относительно MenuButton.
    void setPopupSide(Side value)
    Устанавливает значение свойства popupSide.
    void show()
    Отображает контекстное меню, если кнопка MenuButton не отключена.
    ReadOnlyBooleanProperty showingProperty()
    Указывает, отображается ли в данный момент контекстное меню.

    • Методы, унаследованные от класса javafx.scene.control.ButtonBase

      arm, armedProperty, disarm, getOnAction, isArmed, onActionProperty, setOnAction

    • Методы, унаследованные от класса javafx.scene.control.Labeled

      alignmentProperty, contentDisplayProperty, ellipsisStringProperty, fontProperty, getAlignment, getClassCssMetaData, getContentBias, getContentDisplay, getControlCssMetaData, getEllipsisString, getFont, getGraphic, getGraphicTextGap, getLabelPadding, getLineSpacing, getText, getTextAlignment, getTextFill, getTextOverrun, graphicProperty, graphicTextGapProperty, isMnemonicParsing, isUnderline, isWrapText, labelPaddingProperty, lineSpacingProperty, mnemonicParsingProperty, setAlignment, setContentDisplay, setEllipsisString, setFont, setGraphic, setGraphicTextGap, setLineSpacing, setMnemonicParsing, setText, setTextAlignment, setTextFill, setTextOverrun, setUnderline, setWrapText, textAlignmentProperty, textFillProperty, textOverrunProperty, textProperty, toString, underlineProperty, wrapTextProperty

    • Методы, унаследованные от класса javafx.scene.control.Control

      computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getContextMenu, getCssMetaData, getSkin, getTooltip, isResizable, layoutChildren, queryAccessibleAttribute, setContextMenu, setSkin, setTooltip, skinProperty, tooltipProperty

    • Методы, унаследованные от класса javafx.scene.layout.Region

      backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, getBackground, getBorder, getHeight, getInsets, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpaqueInsets, getPadding, getPrefHeight, getPrefWidth, getShape, getUserAgentStylesheet, getWidth, heightProperty, insetsProperty, isCacheShape, isCenterShape, isScaleShape, isSnapToPixel, layoutInArea, layoutInArea, layoutInArea, layoutInArea, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, opaqueInsetsProperty, paddingProperty, positionInArea, positionInArea, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, scaleShapeProperty, setBackground, setBorder, setCacheShape, setCenterShape, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setOpaqueInsets, setPadding, setPrefHeight, setPrefSize, setPrefWidth, setScaleShape, setShape, setSnapToPixel, setWidth, shapeProperty, snappedBottomInset, snappedLeftInset, snappedRightInset, snappedTopInset, snapPosition, snapSize, snapSpace, snapToPixelProperty, widthProperty

    • Методы, унаследованные от класса javafx.scene.Parent

      getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, lookup, needsLayoutProperty, requestLayout, requestParentLayout, setNeedsLayout, updateBounds

    • Методы, унаследованные от класса javafx.scene.Node

      accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, fireEvent, focusedProperty, focusTraversableProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getNodeOrientation, getOnContextMenuRequested, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragEntered, getOnMouseDragExited, getOnMouseDragged, getOnMouseDragOver, getOnMouseDragReleased, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnRotate, getOnRotationFinished, getOnRotationStarted, getOnScroll, getOnScrollFinished, getOnScrollStarted, getOnSwipeDown, getOnSwipeLeft, getOnSwipeRight, getOnSwipeUp, getOnTouchMoved, getOnTouchPressed, getOnTouchReleased, getOnTouchStationary, getOnZoom, getOnZoomFinished, getOnZoomStarted, getOpacity, getParent, getProperties, getPseudoClassStates, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleableParent, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookupAll, managedProperty, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, pressedProperty, pseudoClassStateChanged, relocate, removeEventFilter, removeEventHandler, requestFocus, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setAccessibleHelp, setAccessibleRole, setAccessibleRoleDescription, setAccessibleText, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, translateXProperty, translateYProperty, translateZProperty, usesMirroring, visibleProperty

    • Методы, унаследованные от класса java.lang.Object

      clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • Подробное описание свойства

    • showing

      public final ReadOnlyBooleanProperty showingProperty
      Указывает, отображается ли в данный момент ContextMenu.

      См. также:

      isShowing()

    • popupSide

      public final ObjectProperty<Side> popupSideProperty
      Указывает, со стороны какой стороны ContextMenu должен открываться относительно MenuButton. Элементы меню обычно выстраиваются вертикально в любом случае. Например, если кнопка меню находится в вертикальной панели инструментов слева на экране приложения, можно изменить popupSide на Side.RIGHT, чтобы всплывающее окно появилось справа от MenuButton.

      Значение по умолчанию:

      Side.BOTTOM

      См. также:

      getPopupSide(), setPopupSide(Side)

  • Подробное описание конструкторов

    • MenuButton

      public MenuButton()
      Создает новую пустую кнопку меню. Используйте Labeled.setText(String), Labeled.setGraphic(Node) и getItems() для установки содержимого.

    • MenuButton

      public MenuButton(String text)
      Создает новую пустую кнопку меню с заданным текстом для отображения на кнопке. Используйте Labeled.setGraphic(Node) и getItems() для установки содержимого.

      Параметры:

      text - текст для отображения на кнопке меню

    • MenuButton

      public MenuButton(String text,
                  Node graphic)
      Создает новую пустую кнопку меню с заданным текстом и графическим элементом для отображения на кнопке. Используйте getItems() для установки содержимого.

      Параметры:

      text - текст для отображения на кнопке меню

    • MenuButton

      public MenuButton(String text,
                  Node graphic,
                  MenuItem... items)
      Создает новую кнопку меню с заданным текстом и графическим элементом для отображения на кнопке, а также вставляет заданные элементы в список items.

      Параметры:

      text - текст для отображения на кнопке меню

      С тех пор:

      JavaFX 8u40

  • Подробное описание методов

    • getItems

      public final ObservableList<MenuItem> getItems()
      Элементы, которые должны отображаться в меню этой кнопки. Если этот список ObservableList изменяется во время выполнения, меню будет обновляться как ожидается.

      Обычно используемые элементы управления включают в себя MenuItem, CheckMenuItem, RadioMenuItem и, конечно же, Menu, которые, если добавлены в меню, превратятся в подменю. SeparatorMenuItem — ещё один часто используемый узел в ObservableList элементов меню.

    • isShowing

      public final boolean isShowing()
      Возвращает значение свойства showing.

      Описание свойства:

      Указывает, отображается ли в данный момент ContextMenu.

    • showingProperty

      public final ReadOnlyBooleanProperty showingProperty()
      Указывает, отображается ли в данный момент ContextMenu.

      См. также:

      isShowing()

    • setPopupSide

      public final void setPopupSide(Side value)
      Устанавливает значение свойства popupSide.

      Описание свойства:

      Указывает, со стороны какой стороны ContextMenu должен открываться относительно MenuButton. Элементы меню обычно выстраиваются вертикально в любом случае. Например, если кнопка меню находится в вертикальной панели инструментов слева на экране приложения, можно изменить popupSide на Side.RIGHT, чтобы всплывающее окно появилось справа от MenuButton.

      Значение по умолчанию:

      Side.BOTTOM

    • getPopupSide

      public final Side getPopupSide()
      Возвращает значение свойства popupSide.

      Описание свойства:

      Указывает, со стороны какой стороны ContextMenu должен открываться относительно MenuButton. Элементы меню обычно выстраиваются вертикально в любом случае. Например, если кнопка меню находится в вертикальной панели инструментов слева на экране приложения, можно изменить popupSide на Side.RIGHT, чтобы всплывающее окно появилось справа от MenuButton.

      Значение по умолчанию:

      Side.BOTTOM

    • popupSideProperty

      public final ObjectProperty<Side> popupSideProperty()
      Указывает, со стороны какой стороны ContextMenu должен открываться относительно MenuButton. Элементы меню обычно выстраиваются вертикально в любом случае. Например, если кнопка меню находится в вертикальной панели инструментов слева на экране приложения, можно изменить popupSide на Side.RIGHT, чтобы всплывающее окно появилось справа от MenuButton.

      Значение по умолчанию:

      Side.BOTTOM

      См. также:

      getPopupSide(), setPopupSide(Side)

    • show

      public void show()
      Отображает ContextMenu, предполагая, что данная кнопка MenuButton не отключена.

      См. также:

      Node.isDisabled(), isShowing()

    • hide

      public void hide()
      Скрывает ContextMenu.

      См. также:

      isShowing()

    • fire

      public void fire()
      Это не оказывает никакого влияния.

      Определено в:

      fire в классе ButtonBase

    • createDefaultSkin

      protected Skin<?> createDefaultSkin()
      Создает новый экземпляр стандартной темы для данного элемента управления. Вызывается для создания темы для элемента управления, если тема не задана с помощью CSS -fx-skin или явно задана в подклассе с setSkin(...).

      Переопределяет:

      createDefaultSkin в классе Control

      Возвращает:

      новый экземпляр стандартной темы для этого элемента управления. Если null, то у элемента управления не будет темы, если она не задана через css.

    • executeAccessibleAction

      public void executeAccessibleAction(AccessibleAction action,
                                    Object... parameters)
      * Обработка доступности * *

      Переопределяет:

      executeAccessibleAction в классе ButtonBase

      Параметры:

      action - действие для выполнения

      См. также:

      AccessibleAction

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API