Класс AnchorPane

javafx.scene.layout.AnchorPane

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

public class AnchorPane extends Pane

AnchorPane позволяет привязывать края дочерних узлов к смещению относительно краёв панели AnchorPane. Если у панели AnchorPane заданы граница и/или отступы, смещения будут измеряться от внутреннего края этих отступов.

AnchorPane выстраивает каждый управляемый дочерний узел независимо от значения свойства visible дочернего узла; неуправляемые дочерние узлы игнорируются при всех расчётах компоновки.

AnchorPane можно стилизовать с помощью фонов и границ с помощью CSS. Смотрите Region суперкласс для получения подробной информации.

Ограничения по привязкам

Приложение устанавливает ограничения по привязкам для каждого дочернего узла, чтобы настроить привязки к одному или нескольким сторонам. Если дочерний узел привязан к противоположным сторонам (и может быть изменён размером), панель AnchorPane изменит его размер для поддержания обоих смещений, иначе панель AnchorPane изменит его размер до его предпочтительного размера. Если в первом случае (привязан к противоположным сторонам) и дочерний узел не может изменяться размером, то будет учтена только верхняя/левая привязка. AnchorPane предоставляет статический метод для установки каждого ограничения по привязке.

Таблица ограничений AnchorPane
Ограничение	Тип	Описание
topAnchor	double	расстояние от верхних отступов панели AnchorPane до верхнего края дочернего узла.
leftAnchor	double	расстояние от левых отступов панели AnchorPane до левого края дочернего узла.
bottomAnchor	double	расстояние от нижних отступов панели AnchorPane до нижнего края дочернего узла.
rightAnchor	double	расстояние от правых отступов панели AnchorPane до правого края дочернего узла.

Пример AnchorPane:

     AnchorPane anchorPane = new AnchorPane();
     // List should stretch as anchorPane is resized
     ListView list = new ListView();
     AnchorPane.setTopAnchor(list, 10.0);
     AnchorPane.setLeftAnchor(list, 10.0);
     AnchorPane.setRightAnchor(list, 65.0);
     // Button will float on right edge
     Button button = new Button("Add");
     AnchorPane.setTopAnchor(button, 10.0);
     AnchorPane.setRightAnchor(button, 10.0);
     anchorPane.getChildren().addAll(list, button);

Диапазон изменения размеров

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

Таблица изменения размеров AnchorPane
	ширина	высота
минимальный	левые/правые отступы плюс ширина, необходимая для отображения дочерних узлов, привязанных слева/справа, с их минимальной шириной как минимум	верхние/нижние отступы плюс высота, необходимая для отображения дочерних узлов, привязанных сверху/снизу, с их минимальной высотой как минимум
предпочитаемый	левые/правые отступы плюс ширина, необходимая для отображения дочерних узлов, привязанных слева/справа, с их предпочтительной шириной как минимум	верхние/нижние отступы плюс высота, необходимая для отображения дочерних узлов, привязанных сверху/снизу, с их предпочтительной высотой как минимум
максимальный	Double.MAX_VALUE	Double.MAX_VALUE

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

AnchorPane предоставляет свойства для непосредственного задания диапазона размеров. Эти свойства по умолчанию имеют значение Region.USE_COMPUTED_SIZE, однако приложение может установить их на другие значения по мере необходимости:

     anchorPane.setPrefSize(300, 300);

Приложения могут восстановить вычисленные значения, установив эти свойства обратно в Region.USE_COMPUTED_SIZE.

AnchorPane по умолчанию не обрезает своё содержимое, поэтому возможно, что границы дочерних узлов могут выходить за пределы его собственных границ, если панель AnchorPane изменит размер меньше её предпочтительного размера.

С:: JavaFX 2.0

Резюме свойств

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

Резюме конструкторов

Конструктор	Описание
`AnchorPane()`	Создаёт `AnchorPane` компоновку.
`AnchorPane(Node... children)`	Создаёт `AnchorPane` компоновку с заданными дочерними узлами.

Резюме методов

Модификатор и тип	Метод	Описание
`static void`	`clearConstraints(Node child)`	Удаляет все ограничения привязки AnchorPane для дочернего узла.
`static Double`	`getBottomAnchor(Node child)`	Возвращает ограничение привязки bottom дочернего узла, если оно задано.
`static Double`	`getLeftAnchor(Node child)`	Возвращает ограничение привязки left дочернего узла, если оно задано.
`static Double`	`getRightAnchor(Node child)`	Возвращает ограничение привязки right дочернего узла, если оно задано.
`static Double`	`getTopAnchor(Node child)`	Возвращает ограничение привязки top дочернего узла, если оно задано.
`static void`	`setBottomAnchor(Node child, Double value)`	Устанавливает нижнюю привязку для дочернего узла, когда он содержится в панели AnchorPane.
`static void`	`setLeftAnchor(Node child, Double value)`	Устанавливает левую привязку для дочернего узла, когда он содержится в панели AnchorPane.
`static void`	`setRightAnchor(Node child, Double value)`	Устанавливает правую привязку для дочернего узла, когда он содержится в панели AnchorPane.
`static void`	`setTopAnchor(Node child, Double value)`	Устанавливает верхнюю привязку для дочернего узла, когда он содержится в панели AnchorPane.

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

getChildren

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

backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, getBackground, getBorder, getClassCssMetaData, getCssMetaData, getHeight, getInsets, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpaqueInsets, getPadding, getPrefHeight, getPrefWidth, getShape, getUserAgentStylesheet, getWidth, heightProperty, insetsProperty, isCacheShape, isCenterShape, isResizable, 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, 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, getContentBias, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInitialCursor, getInitialFocusTraversable, 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, requestFocusTraversal, 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

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

AnchorPane

public AnchorPane()

Создаёт макет AnchorPane.

AnchorPane

public AnchorPane(Node... children)

Создаёт макет AnchorPane с заданными дочерними элементами.

Параметры:: children - начальный набор дочерних элементов для этой области
С момента:: JavaFX 8.0

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

setTopAnchor

public static void setTopAnchor(Node child, Double value)

Устанавливает верхнее привязанное ограничение для дочернего элемента при размещении в области AnchorPane. Если задано, область AnchorPane будет поддерживать размер и положение дочернего элемента, таким образом, что его верхняя граница всегда смещена на это значение относительно верхней границы содержимого области AnchorPane. Установка значения в null удалит ограничение.

Параметры:: child - дочерний узел области AnchorPane; value - смещение от верхней границы области AnchorPane

getTopAnchor

public static Double getTopAnchor(Node child)

Возвращает ограничение привязки по вертикали кверху дочернего элемента, если оно задано.

Параметры:: child - дочерний узел области AnchorPane
Возвращает:: смещение от верхней границы области AnchorPane, или null если привязка по вертикали кверху не была задана

setLeftAnchor

public static void setLeftAnchor(Node child, Double value)

Устанавливает привязку по горизонтали к левому краю для дочернего элемента, когда он содержится в области AnchorPane. Если задано, область AnchorPane будет поддерживать размер и положение дочернего элемента, таким образом, что его левая граница всегда смещена на это значение относительно левого края содержимого области AnchorPane. Установка значения в null удалит ограничение.

Параметры:: child - дочерний узел области AnchorPane; value - смещение от левого края области AnchorPane

getLeftAnchor

public static Double getLeftAnchor(Node child)

Возвращает ограничение привязки по горизонтали к левому краю дочернего элемента, если оно задано.

Параметры:: child - дочерний узел области AnchorPane
Возвращает:: смещение от левого края области AnchorPane, или null если привязка к левому краю не была задана

setBottomAnchor

public static void setBottomAnchor(Node child, Double value)

Устанавливает привязку по вертикали к нижнему краю для дочернего элемента при размещении в области AnchorPane. Если задано, область AnchorPane будет поддерживать размер и положение дочернего элемента, таким образом, что его нижняя граница всегда смещена на это значение относительно нижней границы содержимого области AnchorPane. Установка значения в null удалит ограничение.

Параметры:: child - дочерний узел области AnchorPane; value - смещение от нижней границы области AnchorPane

getBottomAnchor

public static Double getBottomAnchor(Node child)

Возвращает ограничение привязки по вертикали к нижнему краю дочернего элемента, если оно задано.

Параметры:: child - дочерний узел области AnchorPane
Возвращает:: смещение от нижней границы области AnchorPane, или null если привязка к нижнему краю не была задана

setRightAnchor

public static void setRightAnchor(Node child, Double value)

Устанавливает привязку по горизонтали к правому краю для дочернего элемента при размещении в области AnchorPane. Если задано, область AnchorPane будет поддерживать размер и положение дочернего элемента, таким образом, что его правая граница всегда смещена на это значение относительно правого края содержимого области AnchorPane. Установка значения в null удалит ограничение.

Параметры:: child - дочерний узел области AnchorPane; value - смещение от правого края области AnchorPane

getRightAnchor

public static Double getRightAnchor(Node child)

Возвращает ограничение привязки по горизонтали к правому краю дочернего элемента, если оно задано.

Параметры:: child - дочерний узел области AnchorPane
Возвращает:: смещение от правого края области AnchorPane, или null если привязка к правому краю не была задана

clearConstraints

public static void clearConstraints(Node child)

Удаляет все ограничения AnchorPane для дочернего узла.

Параметры:: child - дочерний узел

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