Класс AnchorPane

javafx.scene.layout.AnchorPane

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

public class AnchorPane
extends Pane

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

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, 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)`	Возвращает ограничение привязки к нижней стороне дочернего узла, если оно установлено.
`static Double`	`getLeftAnchor(Node child)`	Возвращает ограничение привязки к левой стороне дочернего узла, если оно установлено.
`static Double`	`getRightAnchor(Node child)`	Возвращает ограничение привязки к правой стороне дочернего узла, если оно установлено.
`static Double`	`getTopAnchor(Node child)`	Возвращает ограничение привязки к верхней стороне дочернего узла, если оно установлено.
`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, 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, 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.css.Styleable

getStyleableNode, getStyleClass

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

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.