Класс ButtonBase

javafx.scene.control.ButtonBase

Все реализуемые интерфейсы:: Styleable, EventTarget, Skinnable

Прямые известные подклассы:: Button, CheckBox, Hyperlink, MenuButton, ToggleButton

public abstract class ButtonBase
extends Labeled

Базовый класс для кнопочных элементов пользовательского интерфейса, включая гиперссылки, кнопки, переключающие кнопки, флажки и радиокнопки. Основной вклад ButtonBase — предоставление согласованного API для обработки понятия «вооружение» кнопки. В пользовательских интерфейсах кнопка обычно «срабатывает» только в случае какого-либо действия пользователя, когда кнопка «вооружена». Например, кнопка может быть вооружена, если нажата кнопка мыши, и кнопка активна, и курсор находится над кнопкой. В такой ситуации, если затем отпустить кнопку мыши, кнопка «срабатывает», то есть выполняется её действие.

С момента:: JavaFX 2.0

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

Свойства
Тип	Свойство	Описание
`ReadOnlyBooleanProperty`	`armed`	Указывает, что кнопка «вооружена», и при отпускании кнопки мыши произойдёт выполнение её действия.
`ObjectProperty<EventHandler<ActionEvent>>`	`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, viewOrder, visible

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

Поля, объявленные в классе javafx.scene.layout.Region

USE_COMPUTED_SIZE, USE_PREF_SIZE

Поля, объявленные в классе javafx.scene.Node

BASELINE_OFFSET_SAME_AS_HEIGHT

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

Конструкторы
Конструктор	Описание
`ButtonBase()`	Создаёт ButtonBase по умолчанию с пустым текстом.
`ButtonBase(String text)`	Создаёт ButtonBase с заданным текстом.
`ButtonBase(String text, Node graphic)`	Создаёт ButtonBase с заданным текстом и графическим элементом.

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

Модификатор и тип	Метод	Описание
`void`	`arm()`	Вооружает кнопку.
`ReadOnlyBooleanProperty`	`armedProperty()`	Указывает, что кнопка «вооружена», и при отпускании кнопки мыши произойдёт выполнение её действия.
`void`	`disarm()`	Разряжает кнопку.
`abstract void`	`fire()`	Вызывается, когда действие пользователя указывает на то, что должно произойти событие для этого `ButtonBase`.
`EventHandler<ActionEvent>`	`getOnAction()`	Получает значение свойства onAction.
`boolean`	`isArmed()`	Получает значение свойства armed.
`ObjectProperty<EventHandler<ActionEvent>>`	`onActionProperty()`	Действие кнопки, которое вызывается всякий раз, когда кнопка срабатывает.
`void`	`setOnAction(EventHandler<ActionEvent> value)`	Устанавливает значение свойства onAction.

Методы, объявленные в классе javafx.scene.control.Labeled

alignmentProperty, contentDisplayProperty, ellipsisStringProperty, fontProperty, getAlignment, getClassCssMetaData, getContentBias, getContentDisplay, getControlCssMetaData, getEllipsisString, getFont, getGraphic, getGraphicTextGap, getInitialAlignment, 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, underlineProperty, wrapTextProperty

Методы, объявленные в классе javafx.scene.control.Control

computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, contextMenuProperty, createDefaultSkin, getContextMenu, getCssMetaData, getInitialFocusTraversable, getTooltip, isResizable, setContextMenu, setTooltip, skinProperty, tooltipProperty

Методы, объявленные в классе javafx.scene.layout.Region

backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, computePrefHeight, computePrefWidth, 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, snapPositionX, snapPositionY, snapSize, snapSizeX, snapSizeY, snapSpace, snapSpaceX, snapSpaceY, snapToPixelProperty, widthProperty

Методы, объявленные в классе javafx.scene.Parent

getBaselineOffset, getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, layoutChildren, 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, executeAccessibleAction, fireEvent, focusedProperty, focusTraversableProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInitialCursor, 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, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, 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, lookup, 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, queryAccessibleAttribute, 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, setViewOrder, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

Методы, объявленные в классе java.lang.Object

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

Методы, объявленные в интерфейсе javafx.scene.control.Skinnable

getSkin, setSkin

Методы, объявленные в интерфейсе javafx.css.Styleable

getStyleableNode, getStyleClass

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

armed

public final ReadOnlyBooleanProperty armedProperty

Указывает, что кнопка "вооружена", так что при отпускании мыши произойдёт выполнение действия кнопки. Это немного отличается от состояния pressed. Pressed означает, что мышь нажата на узел и ещё не отпущена. arm а также учитывает, находится ли мышь фактически над кнопкой и нажата ли она.

См. также:: isArmed()

onAction

public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty

Действие кнопки, которое вызывается всякий раз, когда кнопка срабатывает. Это может быть вызвано щелчком пользователя по кнопке мышью, или событием касания, или нажатием клавиши, или если разработчик программно вызывает метод fire().

См. также:: getOnAction(), setOnAction(EventHandler)

Подробности конструктора

ButtonBase

public ButtonBase()

Создаёт ButtonBase по умолчанию с пустым текстом.

ButtonBase

public ButtonBase(String text)

Создаёт ButtonBase с заданным текстом.

Параметры:: text - null текст обрабатывается как пустая строка

ButtonBase

public ButtonBase(String text, Node graphic)

Создаёт ButtonBase с заданным текстом и графикой.

Параметры:: text - null текст обрабатывается как пустая строка; graphic - допустима null графика

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

armedProperty

public final ReadOnlyBooleanProperty armedProperty()

См. также:: isArmed()

isArmed

public final boolean isArmed()

Получает значение свойства armed.

Описание свойства:: Указывает, что кнопка "вооружена", так что при отпускании мыши произойдёт выполнение действия кнопки. Это немного отличается от состояния pressed. Pressed означает, что мышь нажата на узел и ещё не отпущена. arm а также учитывает, находится ли мышь фактически над кнопкой и нажата ли она.

onActionProperty

public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty()

См. также:: getOnAction(), setOnAction(EventHandler)

setOnAction

public final void setOnAction(EventHandler<ActionEvent> value)

Устанавливает значение свойства onAction.

Описание свойства:: Действие кнопки, которое вызывается всякий раз, когда кнопка срабатывает. Это может быть вызвано щелчком пользователя по кнопке мышью, или событием касания, или нажатием клавиши, или если разработчик программно вызывает метод fire().

getOnAction

public final EventHandler<ActionEvent> getOnAction()

Получает значение свойства onAction.

Описание свойства:: Действие кнопки, которое вызывается всякий раз, когда кнопка срабатывает. Это может быть вызвано щелчком пользователя по кнопке мышью, или событием касания, или нажатием клавиши, или если разработчик программно вызывает метод fire().

arm

public void arm()

Вооружает кнопку. Вооружённая кнопка выполнит действие (будь то действие Button или переключение выбора в CheckBox или другое поведение) при следующем ожидаемом жесте пользовательского интерфейса. Примечание: эта функция предназначена для экспертов, в первую очередь для тех, кто реализует новые темы или поведение. Разработчикам и дизайнерам обычно не нужно обращаться к этой функции напрямую.

disarm

public void disarm()

Разоружает кнопку. См. arm(). Примечание: эта функция предназначена для экспертов, в первую очередь для тех, кто реализует новые темы или поведение. Разработчикам и дизайнерам обычно не нужно обращаться к этой функции напрямую.

fire

public abstract void fire()

Вызывается, когда жест пользователя указывает на то, что событие для этой ButtonBase должно произойти.

Если вызывается, этот метод будет выполнен независимо от состояния arm().

© 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.