Класс GridPane

javafx.scene.layout.GridPane

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

public class GridPane
extends Pane

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

Элемент может быть размещен в любом месте сетки и может занимать несколько строк/столбцов. Элементы могут свободно перекрываться внутри строк/столбцов, а их порядок расположения будет определяться порядком списка дочерних элементов gridpane (0-й узел сзади, последний – спереди).

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

Свойства размещения в сетке

Размещение элемента в сетке определяется его свойствами компоновки:

Таблица свойств размещения в сетке
Свойство	Тип	Описание
columnIndex	целое число	столбец, в котором начинается область размещения элемента.
rowIndex	целое число	строка, в которой начинается область размещения элемента.
columnSpan	целое число	количество столбцов, занимаемых элементом по горизонтали.
rowSpan	целое число	количество строк, занимаемых элементом по вертикали.

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

Общее количество строк/столбцов не нужно указывать заранее, так как gridpane автоматически расширит/сократит сетку для размещения содержимого.

Для использования GridPane приложение должно установить свойства размещения на дочерних элементах и добавить эти элементы в экземпляр gridpane. Свойства размещения устанавливаются на дочерних элементах с использованием статических методов сеттера в классе GridPane:

     GridPane gridpane = new GridPane();

     // Set one constraint at a time...
     // Places the button at the first row and second column
     Button button = new Button();
     GridPane.setRowIndex(button, 0);
     GridPane.setColumnIndex(button, 1);

     // or convenience methods set more than one constraint at once...
     Label label = new Label();
     GridPane.setConstraints(label, 2, 0); // column=2 row=0

     // don't forget to add children to gridpane
     gridpane.getChildren().addAll(button, label);

Приложения также могут использовать удобные методы, которые объединяют шаги установки свойств размещения и добавления дочерних элементов:


     GridPane gridpane = new GridPane();
     gridpane.add(new Button(), 1, 0); // column=1 row=0
     gridpane.add(new Label(), 2, 0);  // column=2 row=0

Размер строк/столбцов

По умолчанию строки и столбцы будут иметь размер, соответствующий их содержимому; столбец будет иметь достаточную ширину для размещения самого широкого элемента, а строка – достаточную высоту для размещения самого высокого элемента. Однако, если приложение необходимо явно контролировать размер строк или столбцов, оно может сделать это, добавив объекты RowConstraints и ColumnConstraints для задания этих параметров. Например, для создания сетки с двумя столбцами фиксированной ширины:


     GridPane gridpane = new GridPane();
     gridpane.getColumnConstraints().add(new ColumnConstraints(100)); // column 0 is 100 wide
     gridpane.getColumnConstraints().add(new ColumnConstraints(200)); // column 1 is 200 wide

По умолчанию gridpane будет изменять размер строк/столбцов до их предпочтительных размеров (вычисленных из содержимого или фиксированных), даже если gridpane масштабируется больше, чем его предпочтительный размер. Если приложению необходим определенный размер строки или столбца для роста при наличии дополнительного места, оно может установить его приоритет роста в объектах RowConstraints или ColumnConstraints. Например:


     GridPane gridpane = new GridPane();
     ColumnConstraints column1 = new ColumnConstraints(100,100,Double.MAX_VALUE);
     column1.setHgrow(Priority.ALWAYS);
     ColumnConstraints column2 = new ColumnConstraints(100);
     gridpane.getColumnConstraints().addAll(column1, column2); // first column gets any extra width

Примечание: Элементы, занимающие несколько строк/столбцов, также будут иметь предпочтительный размер. Затронутые строки/столбцы изменяют размер в следующем порядке: приоритет роста, последняя строка. Это относительно ограничений строк/столбцов.

Процентный размер

В качестве альтернативы RowConstraints и ColumnConstraints позволяют задавать размер в процентах от доступного пространства gridpane:


     GridPane gridpane = new GridPane();
     ColumnConstraints column1 = new ColumnConstraints();
     column1.setPercentWidth(50);
     ColumnConstraints column2 = new ColumnConstraints();
     column2.setPercentWidth(50);
     gridpane.getColumnConstraints().addAll(column1, column2); // each get 50% of width

Если для строки/столбца установлено значение в процентах, это значение имеет приоритет, и ограничения min, pref, max и grow строки/столбца будут игнорироваться.

Обратите внимание, что если сумма значений widthPercent (или heightPercent) превышает 100, значения будут обрабатываться как веса. Например, если 3 столбцам заданы значения widthPercent по 50, каждый из них получит 1/3 доступной ширины gridpane (50/(50+50+50)).

Смешение типов размера

Приложение может свободно смешивать типы размера строк/столбцов (вычисляемые из содержимого, фиксированные или процентные). Процентные строки/столбцы всегда будут выделять место в первую очередь на основе их процента от доступного пространства gridpane (размер минус отступы и промежутки). Остальное место будет выделено строкам/столбцам в соответствии с их минимальными, предпочтительными и максимальными размерами, а также приоритетами роста.

Изменяемый диапазон

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

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

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

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

     gridpane.setPrefSize(300, 300);
     // never size the gridpane larger than its preferred size:
     gridpane.setMaxSize(Region.USE_COMPUTED_SIZE, Region.USE_COMPUTED_SIZE);

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

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

Дополнительные свойства размещения

Приложение может установить дополнительные свойства размещения на дочерних элементах для настройки того, как элемент масштабируется и позиционируется в области размещения, определенной индексами/диапазонами строк/столбцов:

Таблица свойств размещения GridPane
Свойство	Тип	Описание
halignment	javafx.geometry.HPos	Горизонтальное выравнивание элемента внутри его области размещения.
valignment	javafx.geometry.VPos	Вертикальное выравнивание элемента внутри его области размещения.
hgrow	javafx.scene.layout.Priority	Приоритет горизонтального роста элемента.
vgrow	javafx.scene.layout.Priority	Приоритет вертикального роста элемента.
margin	javafx.geometry.Insets	Отступ вокруг элемента.

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

Приоритеты роста, с другой стороны, могут быть применены только к целым строкам или столбцам. Поэтому, если приоритет роста установлен для отдельного элемента, он будет использоваться для вычисления приоритета роста для охватывающей строки/столбца. Если приоритет роста установлен непосредственно на объекте RowConstraint или ColumnConstraint, он переопределит значение, вычисленное из содержимого.

С тех пор:: JavaFX 2.0

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

Свойства
Тип	Свойство	Описание
`ObjectProperty<Pos>`	`alignment`	Выравнивание сетки по ширине и высоте gridpane.
`BooleanProperty`	`gridLinesVisible`	Только для отладки: определяет, будут ли отображаться линии для визуализации строк и столбцов gridpane.
`DoubleProperty`	`hgap`	Ширина горизонтальных отступов между столбцами.
`DoubleProperty`	`vgap`	Высота вертикальных отступов между строками.

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

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

Поля
Модификатор и тип	Поле	Описание
`static int`	`REMAINING`	Значение-сенсор, которое может быть установлено для ограничения пролёта строки/столбца дочернего элемента, чтобы указать, что он должен охватывать оставшиеся строки/столбцы.

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

USE_COMPUTED_SIZE, USE_PREF_SIZE

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

BASELINE_OFFSET_SAME_AS_HEIGHT

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

Конструкторы
Конструктор	Описание
`GridPane()`	Создаёт макет GridPane с hgap/vgap = 0 и выравниванием TOP_LEFT.

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

Модификатор и тип	Метод	Описание

`void`	`add(Node child, int columnIndex, int rowIndex)`	Добавляет дочерний элемент в gridpane в указанной позиции [столбец, строка].
`void`	`add(Node child, int columnIndex, int rowIndex, int colspan, int rowspan)`	Добавляет дочерний элемент в gridpane в указанной позиции [столбец, строка] с указанием размаха.
`void`	`addColumn(int columnIndex, Node... children)`	Удобный метод для последовательного размещения указанных узлов в заданном столбце gridpane.
`void`	`addRow(int rowIndex, Node... children)`	Удобный метод для последовательного размещения указанных узлов в заданной строке gridpane.
`ObjectProperty<Pos>`	`alignmentProperty()`	Выравнивание сетки по ширине и высоте gridpane.
`static void`	`clearConstraints(Node child)`	Удаляет все ограничения gridpane для дочернего узла.
`Pos`	`getAlignment()`	Получает значение свойства выравнивания.
`Bounds`	`getCellBounds(int columnIndex, int rowIndex)`	Возвращает границы ячейки в указанной позиции столбца и строки.
`static List<CssMetaData<? extends Styleable,?>>`	`getClassCssMetaData()`
`ObservableList<ColumnConstraints>`	`getColumnConstraints()`	Возвращает список ограничений столбцов.
`int`	`getColumnCount()`	Возвращает количество столбцов в этом GridPane.
`static Integer`	`getColumnIndex(Node child)`	Возвращает ограничение индекса столбца дочернего элемента, если оно задано.
`static Integer`	`getColumnSpan(Node child)`	Возвращает ограничение размаха столбца дочернего элемента, если оно задано.
`Orientation`	`getContentBias()`	Возвращает ориентацию смещения изменения размера узла в целях макета.
`List<CssMetaData<? extends Styleable,?>>`	`getCssMetaData()`	Этот метод должен делегировать `Node.getClassCssMetaData()`, чтобы можно было получить доступ к CssMetaData узла без необходимости рефлексии.
`static HPos`	`getHalignment(Node child)`	Возвращает ограничение выравнивания по горизонтали дочернего элемента, если оно задано.
`double`	`getHgap()`	Получает значение свойства hgap.
`static Priority`	`getHgrow(Node child)`	Возвращает ограничение роста по горизонтали дочернего элемента, если оно задано.
`static Insets`	`getMargin(Node child)`	Возвращает ограничение отступа дочернего элемента, если оно задано.
`ObservableList<RowConstraints>`	`getRowConstraints()`	Возвращает список ограничений строк.
`int`	`getRowCount()`	Возвращает количество строк в этом GridPane.
`static Integer`	`getRowIndex(Node child)`	Возвращает ограничение индекса строки дочернего элемента, если оно задано.
`static Integer`	`getRowSpan(Node child)`	Возвращает ограничение размаха строки дочернего элемента, если оно задано.
`static VPos`	`getValignment(Node child)`	Возвращает ограничение выравнивания по вертикали дочернего элемента, если оно задано.
`double`	`getVgap()`	Получает значение свойства vgap.
`static Priority`	`getVgrow(Node child)`	Возвращает ограничение роста по вертикали дочернего элемента, если оно задано.
`BooleanProperty`	`gridLinesVisibleProperty()`	Только для отладки: управляет отображением линий для отображения строк и столбцов gridpane.
`DoubleProperty`	`hgapProperty()`	Ширина горизонтальных отступов между столбцами.
`static Boolean`	`isFillHeight(Node child)`	Возвращает политику заполнения по вертикали дочернего элемента, если она задана
`static Boolean`	`isFillWidth(Node child)`	Возвращает политику заполнения по горизонтали дочернего элемента, если она задана
`boolean`	`isGridLinesVisible()`	Получает значение свойства gridLinesVisible.
`void`	`setAlignment(Pos value)`	Устанавливает значение свойства выравнивания.
`static void`	`setColumnIndex(Node child, Integer value)`	Устанавливает индекс столбца для дочернего элемента при включении в gridpane, чтобы он располагался, начиная с этого столбца в gridpane.
`static void`	`setColumnSpan(Node child, Integer value)`	Устанавливает размах столбца для дочернего элемента при включении в gridpane, чтобы он занимал это количество столбцов по горизонтали.
`static void`	`setConstraints(Node child, int columnIndex, int rowIndex)`	Устанавливает индексы столбца и строки для дочернего элемента при включении в gridpane.
`static void`	`setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan)`	Устанавливает значения столбца, строки, размаха столбца и размаха строки для дочернего элемента при включении в gridpane.
`static void`	`setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment)`	Устанавливает позицию, размах и выравнивание сетки для дочернего элемента при включении в gridpane.
`static void`	`setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment, Priority hgrow, Priority vgrow)`	Устанавливает позицию, размах и выравнивание сетки для дочернего элемента при включении в gridpane.
`static void`	`setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment, Priority hgrow, Priority vgrow, Insets margin)`	Устанавливает позицию, размах, выравнивание, приоритеты роста и отступ для дочернего элемента при включении в gridpane.
`static void`	`setFillHeight(Node child, Boolean value)`	Устанавливает политику заполнения по вертикали для дочернего элемента при включении в gridpane.
`static void`	`setFillWidth(Node child, Boolean value)`	Устанавливает политику заполнения по горизонтали для дочернего элемента при включении в gridpane.
`void`	`setGridLinesVisible(boolean value)`	Устанавливает значение свойства gridLinesVisible.

`static void`	`setHalignment(Node child, HPos value)`	Устанавливает горизонтальное выравнивание дочернего элемента, когда он содержится в gridpane.
`void`	`setHgap(double value)`	Устанавливает значение свойства hgap.
`static void`	`setHgrow(Node child, Priority value)`	Устанавливает приоритет горизонтального увеличения для дочернего элемента, когда он содержится в gridpane.
`static void`	`setMargin(Node child, Insets value)`	Устанавливает отступ для дочернего элемента, когда он содержится в gridpane.
`static void`	`setRowIndex(Node child, Integer value)`	Устанавливает индекс строки для дочернего элемента, когда он содержится в gridpane, чтобы он располагался, начиная с этой строки в gridpane.
`static void`	`setRowSpan(Node child, Integer value)`	Устанавливает интервал строк для дочернего элемента, когда он содержится в gridpane, чтобы он занимал указанное количество строк по вертикали.
`static void`	`setValignment(Node child, VPos value)`	Устанавливает вертикальное выравнивание для дочернего элемента, когда он содержится в gridpane.
`void`	`setVgap(double value)`	Устанавливает значение свойства vgap.
`static void`	`setVgrow(Node child, Priority value)`	Устанавливает приоритет вертикального увеличения для дочернего элемента, когда он содержится в gridpane.
`String`	`toString()`	Возвращает строковое представление этого объекта `GridPane`.
`DoubleProperty`	`vgapProperty()`	Высота вертикальных отступов между строками.

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

getChildren

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

backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, getBackground, getBorder, 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, 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, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

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

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

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

getStyleableNode, getStyleClass

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

hgap

public final DoubleProperty hgapProperty

Ширина горизонтальных промежутков между столбцами.

См. также:: getHgap(), setHgap(double)

vgap

public final DoubleProperty vgapProperty

Высота вертикальных промежутков между строками.

См. также:: getVgap(), setVgap(double)

alignment

public final ObjectProperty<Pos> alignmentProperty

Выравнивание сетки по ширине и высоте gridpane.

См. также:: getAlignment(), setAlignment(Pos)

gridLinesVisible

public final BooleanProperty gridLinesVisibleProperty

Только для отладки: управляет отображением линий для отображения строк и столбцов gridpane. По умолчанию false.

См. также:: isGridLinesVisible(), setGridLinesVisible(boolean)

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

REMAINING

public static final int REMAINING

Значение-маяк, которое может быть установлено для ограничения раздела строки/столбца элемента, чтобы указать, что он должен охватывать оставшиеся строки/столбцы.

См. также:: Значения константных полей

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

GridPane

public GridPane()

Создаёт макет GridPane с hgap/vgap = 0 и выравниванием TOP_LEFT.

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

setRowIndex

public static void setRowIndex(Node child, Integer value)

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

Параметры:: child - дочерний узел gridpane; value - индекс строки дочернего элемента

getRowIndex

public static Integer getRowIndex(Node child)

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

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

setColumnIndex

public static void setColumnIndex(Node child, Integer value)

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

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

getColumnIndex

public static Integer getColumnIndex(Node child)

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

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

setRowSpan

public static void setRowSpan(Node child, Integer value)

Устанавливает размах строк для дочернего элемента, содержащегося в gridpane, чтобы он занимал указанное количество строк вертикально. Может быть установлено в REMAINING, что вызовет расширение размаха до всех оставшихся строк.

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

Параметры:: child - дочерний узел gridpane; value - размах строк дочернего элемента

getRowSpan

public static Integer getRowSpan(Node child)

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

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

setColumnSpan

public static void setColumnSpan(Node child, Integer value)

Устанавливает размах столбцов для дочернего элемента, содержащегося в gridpane, чтобы он занимал указанное количество столбцов горизонтально. Может быть установлено в REMAINING, что вызовет расширение размаха до всех оставшихся столбцов.

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

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

getColumnSpan

public static Integer getColumnSpan(Node child)

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

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

setMargin

public static void setMargin(Node child, Insets value)

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

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

getMargin

public static Insets getMargin(Node child)

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

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

setHalignment

public static void setHalignment(Node child, HPos value)

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

Параметры:: child - дочерний узел gridpane; value - горизонтальное выравнивание для дочернего элемента

getHalignment

public static HPos getHalignment(Node child)

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

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

setValignment

public static void setValignment(Node child, VPos value)

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

Параметры:: child - дочерний узел gridpane; value - вертикальное выравнивание для дочернего элемента

getValignment

public static VPos getValignment(Node child)

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

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

setHgrow

public static void setHgrow(Node child, Priority value)

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

Параметры:: child - дочерний элемент gridpane; value - приоритет горизонтального роста для дочернего элемента

getHgrow

public static Priority getHgrow(Node child)

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

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

setVgrow

public static void setVgrow(Node child, Priority value)

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

Параметры:: child - дочерний элемент gridpane; value - приоритет вертикального роста для дочернего элемента

getVgrow

public static Priority getVgrow(Node child)

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

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

Установить ширину заполнения

public static void setFillWidth(Node child, Boolean value)

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

Параметры:: child - дочерний узел сетки GridPane; value - политика горизонтального заполнения или null для сброса
С момента:: JavaFX 8.0

Установить ширину заполнения

public static Boolean isFillWidth(Node child)

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

Параметры:: child - дочерний узел сетки GridPane
Возвращает:: политику горизонтального заполнения для дочернего элемента или null, если политика не была задана
С момента:: JavaFX 8.0

Установить высоту заполнения

public static void setFillHeight(Node child, Boolean value)

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

Параметры:: child - дочерний узел сетки GridPane; value - политика вертикального заполнения или null для сброса
С момента:: JavaFX 8.0

Установить высоту заполнения

public static Boolean isFillHeight(Node child)

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

Параметры:: child - дочерний узел сетки GridPane
Возвращает:: политику вертикального заполнения для дочернего элемента или null, если политика не была задана
С момента:: JavaFX 8.0

Установить ограничения

public static void setConstraints(Node child, int columnIndex, int rowIndex)

Устанавливает индексы столбца и строки для дочернего элемента, когда он содержится в сетке GridPane.

Параметры:: child - дочерний узел сетки GridPane; columnIndex - позиция индекса столбца для дочернего элемента; rowIndex - позиция индекса строки для дочернего элемента

Установить ограничения

public static void setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan)

Устанавливает значения столбца, строки, размаха по столбцам и размаха по строкам для дочернего элемента при включении в сетку GridPane.

Параметры:: child - дочерний узел сетки GridPane; columnIndex - позиция индекса столбца для дочернего элемента; rowIndex - позиция индекса строки для дочернего элемента; columnspan - количество столбцов, которое должен занимать дочерний элемент; rowspan - количество строк, которое должен занимать дочерний элемент

Установить ограничения

public static void setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment)

Устанавливает позицию в сетке, размах и выравнивание для дочернего элемента при включении в сетку GridPane.

Параметры:: child - дочерний узел сетки GridPane; columnIndex - позиция индекса столбца для дочернего элемента; rowIndex - позиция индекса строки для дочернего элемента; columnspan - количество столбцов, которое должен занимать дочерний элемент; rowspan - количество строк, которое должен занимать дочерний элемент; halignment - горизонтальное выравнивание дочернего элемента; valignment - вертикальное выравнивание дочернего элемента

Установить ограничения

public static void setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment, Priority hgrow, Priority vgrow)

Устанавливает позицию в сетке, размах и выравнивание для дочернего элемента при включении в сетку GridPane.

Параметры:: child - дочерний узел сетки GridPane; columnIndex - позиция индекса столбца для дочернего элемента; rowIndex - позиция индекса строки для дочернего элемента; columnspan - количество столбцов, которое должен занимать дочерний элемент; rowspan - количество строк, которое должен занимать дочерний элемент; halignment - горизонтальное выравнивание дочернего элемента; valignment - вертикальное выравнивание дочернего элемента; hgrow - приоритет горизонтального увеличения дочернего элемента; vgrow - приоритет вертикального увеличения дочернего элемента

Установить ограничения

public static void setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment, Priority hgrow, Priority vgrow, Insets margin)

Устанавливает позицию в сетке, размах, выравнивание, приоритеты увеличения и отступ для дочернего элемента при включении в сетку GridPane.

Параметры:: child - дочерний узел сетки GridPane; columnIndex - позиция индекса столбца для дочернего элемента; rowIndex - позиция индекса строки для дочернего элемента; columnspan - количество столбцов, которое должен занимать дочерний элемент; rowspan - количество строк, которое должен занимать дочерний элемент; halignment - горизонтальное выравнивание дочернего элемента; valignment - вертикальное выравнивание дочернего элемента; hgrow - приоритет горизонтального увеличения дочернего элемента; vgrow - приоритет вертикального увеличения дочернего элемента; margin - отступ вокруг дочернего элемента

Очистить ограничения

public static void clearConstraints(Node child)

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

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

hgapProperty

public final DoubleProperty hgapProperty()

Ширина горизонтальных промежутков между столбцами.

См. также:: getHgap(), setHgap(double)

Установить Hgap

public final void setHgap(double value)

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

Описание свойства:: Ширина горизонтальных промежутков между столбцами.

Получить Hgap

public final double getHgap()

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

Описание свойства:: Ширина горизонтальных промежутков между столбцами.

vgapProperty

public final DoubleProperty vgapProperty()

Высота вертикальных промежутков между строками.

См. также:: getVgap(), setVgap(double)

Установить Vgap

public final void setVgap(double value)

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

Описание свойства:: Высота вертикальных промежутков между строками.

Получить Vgap

public final double getVgap()

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

Описание свойства:: Высота вертикальных промежутков между строками.

alignmentProperty

public final ObjectProperty<Pos> alignmentProperty()

Выравнивание сетки внутри ширины и высоты сетки GridPane.

См. также:: getAlignment(), setAlignment(Pos)

Выровнять

public final void setAlignment(Pos value)

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

Описание свойства:: Выравнивание сетки внутри ширины и высоты сетки GridPane.

Получить выравнивание

public final Pos getAlignment()

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

Описание свойства:: Выравнивание сетки внутри ширины и высоты сетки GridPane.

gridLinesVisibleProperty

public final BooleanProperty gridLinesVisibleProperty()

Только для отладки: управляет отображением линий для отображения строк и столбцов сетки GridPane. Значение по умолчанию — false.

См. также:: isGridLinesVisible(), setGridLinesVisible(boolean)

Установить видимость линий сетки

public final void setGridLinesVisible(boolean value)

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

Описание свойства:: Только для отладки: управляет отображением линий для отображения строк и столбцов сетки GridPane. Значение по умолчанию — false.

Видимость линий сетки

public final boolean isGridLinesVisible()

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

Описание свойства:: Только для отладки: управляет отображением линий для отображения строк и столбцов сетки GridPane. Значение по умолчанию — false.

Получить ограничения строк

public final ObservableList<RowConstraints> getRowConstraints()

Возвращает список ограничений строк. Ограничения строк могут быть добавлены для явного управления размером и поведением макета отдельных строк. Если не задано, размер и поведение макета строк вычисляется на основе содержимого. Индекс в ObservableList обозначает номер строки, поэтому ограничение строки для первой строки находится на позиции 0.

Возвращает:: список ограничений строк

getColumnConstraints

public final ObservableList<ColumnConstraints> getColumnConstraints()

Возвращает список ограничений столбцов. Ограничения столбцов можно добавить, чтобы явно контролировать размер и поведение каждого столбца. Если не задано, размер и поведение столбца вычисляются на основе содержимого. Индекс в ObservableList обозначает номер столбца, поэтому ограничение первого столбца находится в позиции 0.

Returns:: список ограничений столбцов

add

public void add(Node child, int columnIndex, int rowIndex)

Добавляет дочерний элемент в сетку в указанной позиции [столбец, строка]. Этот метод удобен для задания ограничений столбца и строки сетки для дочернего элемента.

Parameters:: child - добавляемый узел в сетку; columnIndex - индекс столбца для дочернего элемента в сетке, отсчёт с 0; rowIndex - индекс строки для дочернего элемента в сетке, отсчёт с 0

add

public void add(Node child, int columnIndex, int rowIndex, int colspan, int rowspan)

Добавляет дочерний элемент в сетку в указанной позиции [столбец, строка] и с указанными размахом. Этот метод удобен для задания ограничений столбца, строки и размаха для дочернего элемента.

Parameters:: child - добавляемый узел в сетку; columnIndex - индекс столбца для дочернего элемента в сетке, отсчёт с 0; rowIndex - индекс строки для дочернего элемента в сетке, отсчёт с 0; colspan - количество столбцов, на которое дочерний элемент должен занимать место в сетке; rowspan - количество строк, на которое дочерний элемент должен занимать место в сетке

addRow

public void addRow(int rowIndex, Node... children)

Удобный метод для размещения указанных узлов последовательно в заданной строке сетки. Если строка уже содержит узлы, указанные узлы будут добавлены в конец строки. Например, первый узел будет размещён в [столбец, строка], второй в [столбец+1, строка] и т.д. Этот метод также задаст соответствующие ограничения строки/столбца для узлов и добавит узлы в последовательность дочерних элементов сетки.

Parameters:: rowIndex - индекс строки для дочерних элементов в сетке; children - узлы, которые будут добавлены как строка в сетку

addColumn

public void addColumn(int columnIndex, Node... children)

Удобный метод для размещения указанных узлов последовательно в заданном столбце сетки. Если столбец уже содержит узлы, указанные узлы будут добавлены в конец столбца. Например, первый узел будет размещён в [столбец, строка], второй в [столбец, строка+1] и т.д. Этот метод также задаст соответствующие ограничения строки/столбца для узлов и добавит узлы в последовательность дочерних элементов сетки.

Parameters:: columnIndex - индекс столбца для дочерних элементов в сетке; children - узлы, которые будут добавлены как столбец в сетку

getContentBias

public Orientation getContentBias()

Описание, скопированное из класса: Node

Возвращает ориентацию смещения изменения размера узла для целей макета. Если у типа узла нет смещения, возвращает null. Если узел является масштабируемым, и его высота зависит от ширины, возвращает HORIZONTAL, в противном случае, если его ширина зависит от высоты, возвращает VERTICAL.

Подклассы, допускающие масштабирование, должны переопределить этот метод, чтобы вернуть соответствующее значение.

Overrides:: getContentBias в классе Node
Returns:: null, если ни один из дочерних элементов не имеет смещения содержимого.
See Also:: Node.isResizable(), Node.minWidth(double), Node.minHeight(double), Node.prefWidth(double), Node.prefHeight(double), Node.maxWidth(double), Node.maxHeight(double)

toString

public String toString()

Возвращает строковое представление этого объекта GridPane.

Overrides:: toString в классе Node
Returns:: строковое представление этого объекта GridPane.

getClassCssMetaData

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

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

getCssMetaData

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

Этот метод должен делегировать Node.getClassCssMetaData(), чтобы можно было получить CssMetaData узла без необходимости рефлексии.

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

getRowCount

public final int getRowCount()

Возвращает количество строк в этой сетке.

Returns:: количество строк
Since:: 9

getColumnCount

public final int getColumnCount()

Возвращает количество столбцов в этой сетке.

Returns:: количество столбцов
Since:: 9

getCellBounds

public final Bounds getCellBounds(int columnIndex, int rowIndex)

Возвращает границы ячейки в указанной позиции столбца и строки.

Parameters:: columnIndex - индекс столбца ячейки в этой сетке, отсчёт с 0; rowIndex - индекс строки ячейки в этой сетке, отсчёт с 0
Returns:: границы ячейки в columnIndex и rowIndex.
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.