Класс Button

javafx.scene.control.Button

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

public class Button extends ButtonBase

Простой элемент управления кнопкой. Элемент управления кнопкой может содержать текст и/или графику. Элемент управления кнопкой имеет три различных режима:

Обычный: обычная кнопка.
По умолчанию: кнопка по умолчанию отображается по-другому, чтобы пользователи понимали, что это предпочтительный выбор в случае неопределённости. Поведение кнопки по умолчанию отличается в зависимости от платформы:
- Windows/Linux: Кнопка по умолчанию получает нажатия клавиши ENTER, когда у неё есть фокус. Когда у кнопки по умолчанию нет фокуса, а фокус находится на другой кнопке, нажатие клавиши ENTER будет получено другой, не по умолчанию кнопкой. Если фокус находится в другом месте пользовательского интерфейса и не находится ни на одной кнопке, нажатие клавиши ENTER будет получено кнопкой по умолчанию, если она указана, если вначале её не потребляет другой элемент сцены.
- Mac OS X: Кнопка по умолчанию — единственная кнопка в пользовательском интерфейсе, которая реагирует на нажатие клавиши ENTER. Если фокус находится на другой кнопке, не являющейся кнопкой по умолчанию, и нажимается клавиша ENTER, событие принимается только кнопкой по умолчанию. В macOS единственный способ нажать нестандартную кнопку — нажатие клавиши SPACE.
Отмена: Кнопка Отмена — это кнопка, которая получает нажатие клавиши VK_ESC, если ни один другой элемент на сцене не потребляет его.

При нажатии и отпускании кнопки отправляется событие ActionEvent. Приложение может выполнить некоторое действие на основе этого события, реализовав обработчик EventHandler для обработки события ActionEvent. Кнопки также могут реагировать на события мыши, реализовав обработчик EventHandler для обработки события MouseEvent

Разбор мнемоник по умолчанию включён для Button.

Пример:

Button button = new Button("Click Me");

С:: JavaFX 2.0

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

Тип	Свойство	Описание
`final BooleanProperty`	`cancelButton`	Кнопка Отмены — это кнопка, которая получает нажатие клавиши VK_ESC, если ни один другой элемент на сцене не потребляет его.
`final BooleanProperty`	`defaultButton`	Кнопка по умолчанию — это кнопка, которая получает нажатие клавиши VK_ENTER, если ни один другой элемент на сцене не потребляет его.

Свойства, объявленные в классе 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, focusVisible, focusWithin, 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

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

Конструктор	Описание
`Button()`	Создаёт кнопку со строкой для метки.
`Button(String text)`	Создаёт кнопку с заданным текстом в качестве метки.
`Button(String text, Node graphic)`	Создаёт кнопку с заданным текстом и иконкой для метки.

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

Модификатор и тип	Метод	Описание
`final BooleanProperty`	`cancelButtonProperty()`	Кнопка Отмены — это кнопка, которая получает нажатие клавиши VK_ESC, если ни один другой элемент на сцене не потребляет его.
`final BooleanProperty`	`defaultButtonProperty()`	Кнопка по умолчанию — это кнопка, которая получает нажатие клавиши VK_ENTER, если ни один другой элемент на сцене не потребляет его.
`void`	`fire()`	Вызывается, когда пользовательское действие указывает, что для данного `ButtonBase` должно произойти событие.
`final boolean`	`isCancelButton()`	Возвращает значение свойства `cancelButton`.
`final boolean`	`isDefaultButton()`	Возвращает значение свойства `defaultButton`.
`final void`	`setCancelButton(boolean value)`	Устанавливает значение свойства `cancelButton`.
`final void`	`setDefaultButton(boolean value)`	Устанавливает значение свойства `defaultButton`.

Методы, объявленные в классе 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, 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, getSkin, getTooltip, isResizable, setContextMenu, setSkin, 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, focusVisibleProperty, focusWithinProperty, 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, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isFocusVisible, isFocusWithin, 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.css.Styleable

getStyleableNode

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

defaultButton

public final BooleanProperty defaultButtonProperty

Кнопка по умолчанию — кнопка, которая получает нажатие клавиши VK_ENTER на клавиатуре, если ни один другой узел в сцене не потребляет его.

См. также:

isDefaultButton()
setDefaultButton(boolean)
defaultButtonProperty()

cancelButton

public final BooleanProperty cancelButtonProperty

Кнопка отмены — кнопка, которая получает нажатие клавиши VK_ESC на клавиатуре, если ни один другой узел в сцене не потребляет его.

См. также:

isCancelButton()
setCancelButton(boolean)
cancelButtonProperty()

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

Кнопка

public Button()

Создаёт кнопку с пустой строкой в качестве метки.

Кнопка

public Button(String text)

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

Параметры:: text - Строка текста для метки.

Кнопка

public Button(String text, Node graphic)

Создаёт кнопку со указанным текстом и иконкой в качестве метки.

Параметры:: text - Строка текста для метки.; graphic - иконка для метки.

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

setDefaultButton

public final void setDefaultButton(boolean value)

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

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

Параметры:

value - значение для свойства defaultButton

См. также:

isDefaultButton()
defaultButtonProperty()

isDefaultButton

public final boolean isDefaultButton()

Возвращает значение свойства defaultButton.

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

Возвращает:

значение свойства defaultButton

См. также:

setDefaultButton(boolean)
defaultButtonProperty()

defaultButtonProperty

public final BooleanProperty defaultButtonProperty()

Возвращает:

свойство defaultButton

См. также:

isDefaultButton()
setDefaultButton(boolean)

setCancelButton

public final void setCancelButton(boolean value)

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

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

Параметры:

value - значение для свойства cancelButton

См. также:

isCancelButton()
cancelButtonProperty()

isCancelButton

public final boolean isCancelButton()

Возвращает значение свойства cancelButton.

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

Возвращает:

значение свойства cancelButton

См. также:

setCancelButton(boolean)
cancelButtonProperty()

cancelButtonProperty

public final BooleanProperty cancelButtonProperty()

Возвращает:

свойство cancelButton

См. также:

isCancelButton()
setCancelButton(boolean)

fire

public void fire()

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

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

Установлено в:: fire в классе ButtonBase

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