Класс Control

javafx.scene.control.Control

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

Прямые известные подклассы:: Accordion, ButtonBar, ChoiceBox, ComboBoxBase, HTMLEditor, Labeled, ListView, MenuBar, Pagination, ProgressIndicator, ScrollBar, ScrollPane, Separator, Slider, Spinner, SplitPane, TableView, TabPane, TextInputControl, ToolBar, TreeTableView, TreeView

public abstract class Control
extends Region
implements Skinnable

Базовый класс для всех элементов управления пользовательским интерфейсом. "Control" — это узел в графическом представлении сцены, который может быть изменён пользователем. Элементы управления предоставляют дополнительные переменные и поведение, помимо тех, что есть у Node, чтобы поддерживать распространённые пользовательские взаимодействия предсказуемым и согласованным образом.

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

Подробную информацию об использовании отдельных типов элементов управления см. в соответствующих подклассах Control.

У большинства элементов управления свойство focusTraversable по умолчанию установлено в true, однако для элементов управления только для чтения, таких как Label и ProgressIndicator, и некоторых элементов управления, которые являются контейнерами, ScrollPane и ToolBar, это не так. Обратитесь к документации по конкретному элементу управления для получения подробностей.

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

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

Свойства
Тип	Свойство	Описание
`ObjectProperty<ContextMenu>`	`contextMenu`	Контекстное меню для данного элемента управления.
`ObjectProperty<Skin<?>>`	`skin`	Тема отвечает за отрисовку этого `Control`.
`ObjectProperty<Tooltip>`	`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

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

Конструкторы
Модификатор	Конструктор	Описание
`protected`	`Control()`	Создает новый элемент управления.

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

Модификатор и тип	Метод	Описание
`protected double`	`computeMaxHeight(double width)`	Вычисляет максимальную разрешенную высоту элемента управления на основе заданной ширины.
`protected double`	`computeMaxWidth(double height)`	Вычисляет максимальную разрешенную ширину элемента управления на основе заданной высоты.
`protected double`	`computeMinHeight(double width)`	Вычисляет минимальную разрешенную высоту элемента управления на основе заданной ширины.
`protected double`	`computeMinWidth(double height)`	Вычисляет минимальную разрешенную ширину элемента управления на основе заданной высоты.
`ObjectProperty<ContextMenu>`	`contextMenuProperty()`	Контекстное меню для данного элемента управления.
`protected Skin<?>`	`createDefaultSkin()`	Создает новый экземпляр стандартной темы для данного элемента управления.
`static List<CssMetaData<? extends Styleable,?>>`	`getClassCssMetaData()`
`ContextMenu`	`getContextMenu()`	Возвращает значение свойства contextMenu.
`protected List<CssMetaData<? extends Styleable,?>>`	`getControlCssMetaData()`
`List<CssMetaData<? extends Styleable,?>>`	`getCssMetaData()`	Этот метод возвращает `List`, содержащий все `CssMetaData` для данного элемента управления (полученные из `getControlCssMetaData()` и его `Skin`), предполагая, что `skin property` является `SkinBase`.
`protected Boolean`	`getInitialFocusTraversable()`	Возвращает начальное состояние перехода фокуса для данного элемента управления, для использования движком JavaFX CSS для корректного задания его начального значения.
`Tooltip`	`getTooltip()`	Возвращает значение свойства tooltip.
`boolean`	`isResizable()`	Возвращает `true`, так как все элементы управления могут быть изменены в размерах.
`void`	`setContextMenu(ContextMenu value)`	Устанавливает значение свойства contextMenu.
`void`	`setTooltip(Tooltip value)`	Устанавливает значение свойства tooltip.
`ObjectProperty<Skin<?>>`	`skinProperty()`	Тема отвечает за отрисовку этого `Control`.
`ObjectProperty<Tooltip>`	`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, getContentBias, 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

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

skin

public final ObjectProperty<Skin<?>> skinProperty

Скин отвечает за отрисовку этого Control. С точки зрения Control, Skin — это черный ящик. Он отслеживает и реагирует на изменения состояния в Control.

Существует взаимно-однозначное соответствие между Control и его Skin. Каждый Skin сохраняет обратную ссылку на Control через метод Skin.getSkinnable().

Скин может быть null.

Определено в:: skinProperty в интерфейсе Skinnable
См. также:: Skinnable.getSkin(), Skinnable.setSkin(Skin)

tooltip

public final ObjectProperty<Tooltip> tooltipProperty

Подсказка для этого элемента управления.

См. также:: getTooltip(), setTooltip(Tooltip)

contextMenu

public final ObjectProperty<ContextMenu> contextMenuProperty

Контекстное меню для отображения для этого элемента управления.

См. также:: getContextMenu(), setContextMenu(ContextMenu)

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

Control

protected Control()

Создать новый элемент управления.

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

skinProperty

public final ObjectProperty<Skin<?>> skinProperty()

Скин может быть null.

Определено в:: skinProperty в интерфейсе Skinnable
См. также:: Skinnable.getSkin(), Skinnable.setSkin(Skin)

tooltipProperty

public final ObjectProperty<Tooltip> tooltipProperty()

Подсказка для этого элемента управления.

См. также:: getTooltip(), setTooltip(Tooltip)

setTooltip

public final void setTooltip(Tooltip value)

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

Описание свойства:: Подсказка для этого элемента управления.

getTooltip

public final Tooltip getTooltip()

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

Описание свойства:: Подсказка для этого элемента управления.

contextMenuProperty

public final ObjectProperty<ContextMenu> contextMenuProperty()

Контекстное меню для отображения для этого элемента управления.

См. также:: getContextMenu(), setContextMenu(ContextMenu)

setContextMenu

public final void setContextMenu(ContextMenu value)

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

Описание свойства:: Контекстное меню для отображения для этого элемента управления.

getContextMenu

public final ContextMenu getContextMenu()

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

Описание свойства:: Контекстное меню для отображения для этого элемента управления.

isResizable

public boolean isResizable()

Возвращает true, так как все элементы управления могут быть изменены в размерах.

Переопределяет:: isResizable в классе Region
Возвращает:: можно ли изменять размер этого узла его родителем во время выравнивания
См. также:: Node.getContentBias(), Node.minWidth(double), Node.minHeight(double), Node.prefWidth(double), Node.prefHeight(double), Node.maxWidth(double), Node.maxHeight(double), Node.resize(double, double), Node.getLayoutBounds()

computeMinWidth

protected double computeMinWidth(double height)

Вычисляет минимально допустимую ширину элемента управления на основе предоставленной высоты. Минимальная ширина не вычисляется в элементе управления, вместо этого вычисление делегируется методу Node.minWidth(double) объекта Skin. Если Скин равен null, возвращаемое значение равно 0.

Переопределяет:: computeMinWidth в классе Region
Параметры:: height - Высота элемента управления, в случае если это значение может определять минимальную ширину.
Возвращает:: Число с плавающей точкой, представляющее минимальную ширину этого элемента управления.

computeMinHeight

protected double computeMinHeight(double width)

Вычисляет минимально допустимую высоту элемента управления на основе предоставленной ширины. Минимальная высота не вычисляется в элементе управления, вместо этого вычисление делегируется методу Node.minHeight(double) объекта Skin. Если Скин равен null, возвращаемое значение равно 0.

Переопределяет:: computeMinHeight в классе Region
Параметры:: width - Ширина элемента управления, в случае если это значение может определять минимальную высоту.
Возвращает:: Число с плавающей точкой, представляющее минимальную высоту этого элемента управления.

computeMaxWidth

protected double computeMaxWidth(double height)

Вычисляет максимально допустимую ширину элемента управления на основе предоставленной высоты. Максимальная ширина не вычисляется в элементе управления, вместо этого вычисление делегируется методу Node.maxWidth(double) объекта Skin. Если Скин равен null, возвращаемое значение равно 0.

Переопределяет:: computeMaxWidth в классе Region
Параметры:: height - Высота элемента управления, в случае если это значение может определять максимальную ширину.
Возвращает:: Число с плавающей точкой, представляющее максимальную ширину этого элемента управления.

computeMaxHeight

protected double computeMaxHeight(double width)

Вычисляет максимально допустимую высоту элемента управления на основе предоставленной ширины. Максимальная высота не вычисляется в элементе управления, вместо этого вычисление делегируется методу Node.maxHeight(double) объекта Skin. Если Скин равен null, возвращаемое значение равно 0.

Переопределяет:: computeMaxHeight в классе Region
Параметры:: width - Ширина элемента управления, в случае если это значение может определять максимальную высоту.
Возвращает:: Число с плавающей точкой, представляющее максимальную высоту этого элемента управления.

createDefaultSkin

protected Skin<?> createDefaultSkin()

Создает новый экземпляр стандартного скин для данного элемента управления. Это вызывается для создания скин для элемента управления, если скин не предоставлен через CSS -fx-skin или явно задан в подклассе с помощью setSkin(...).

Возвращает:: новый экземпляр стандартного скин для этого элемента управления. Если null, то у элемента управления не будет скин, если он не предоставлен с помощью CSS.
Since:: JavaFX 8.0

getClassCssMetaData

public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()

Возвращает:: CssMetaData, связанный с этим классом, который может включать CssMetaData его суперклассов.
Since:: JavaFX 8.0

getCssMetaData

public final List<CssMetaData<? extends Styleable,?>> getCssMetaData()

Этот метод возвращает List, содержащую все CssMetaData для данного Control (возвращаемого методом getControlCssMetaData()) и его Skin, при условии, что skin property является SkinBase.

Разработчикам, желающим предоставить пользовательские CssMetaData, рекомендуется переопределить getControlCssMetaData() или SkinBase.getCssMetaData(), в зависимости от местоположения CssMetaData.

Specified by:: getCssMetaData в интерфейсе Styleable
Overrides:: getCssMetaData в классе Region
Returns:: CssMetaData, связанный с этим узлом, который может включать CssMetaData его суперклассов.
Since:: JavaFX 8.0

getControlCssMetaData

protected List<CssMetaData<? extends Styleable,?>> getControlCssMetaData()

Returns:: неизменяемый список стилизуемых свойств управления.
Since:: JavaFX 8.0

getInitialFocusTraversable

protected Boolean getInitialFocusTraversable()

Возвращает начальное состояние прохода фокуса для этого элемента управления, используемое движком JavaFX CSS для правильной установки его начального значения. По умолчанию все элементы управления UI имеют возможность прохода фокуса, поэтому в Control этот метод переопределён для установки начального состояния прохода фокуса в значение true.

Overrides:: getInitialFocusTraversable в классе Node
Returns:: начальное состояние прохода фокуса для этого элемента управления
Since:: 9

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