Класс 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

Сводка свойств

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

Сводка полей

Модификатор и тип	Поле	Описание
`static final 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.
`GridPane(double hgap, double vgap)`	Создает макет `GridPane` с заданными `hgap` и `vgap`.

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

Модификатор и тип	Метод	Описание
`void`	`add(Node child, int columnIndex, int rowIndex)`	Добавляет дочерний элемент в сетку на указанную позицию [столбец, строка].
`void`	`add(Node child, int columnIndex, int rowIndex, int colspan, int rowspan)`	Добавляет дочерний элемент в сетку на указанную позицию [столбец, строка] с указанным размахом.
`void`	`addColumn(int columnIndex, Node... children)`	Удобный метод для последовательной размещения узлов в заданном столбце сетки.
`void`	`addRow(int rowIndex, Node... children)`	Удобный метод для последовательной размещения узлов в заданной строке сетки.
`final ObjectProperty<Pos>`	`alignmentProperty()`	Выравнивание сетки по ширине и высоте сетки.
`static void`	`clearConstraints(Node child)`	Удаляет все ограничения сетки для дочернего узла.
`final Pos`	`getAlignment()`	Возвращает значение свойства `alignment`.
`final Bounds`	`getCellBounds(int columnIndex, int rowIndex)`	Возвращает границы ячейки в указанной позиции столбца и строки.
`static List<CssMetaData<? extends Styleable,?>>`	`getClassCssMetaData()`	Возвращает `CssMetaData`, связанный с этим классом, который может включать `CssMetaData` его суперклассов.
`final ObservableList<ColumnConstraints>`	`getColumnConstraints()`	Возвращает список ограничений столбцов.
`final int`	`getColumnCount()`	Возвращает количество столбцов в этой сетке.
`static Integer`	`getColumnIndex(Node child)`	Возвращает индекс столбца дочернего элемента, если он задан.
`static Integer`	`getColumnSpan(Node child)`	Возвращает ограничение размаха столбца дочернего элемента, если оно задано.
`Orientation`	`getContentBias()`	Возвращает ориентацию смещения изменения размера узла для целей макета.
`List<CssMetaData<? extends Styleable,?>>`	`getCssMetaData()`	Этот метод должен делегировать `Node.getClassCssMetaData()`, чтобы метаданные CSS узла можно было получить без отражения.
`static HPos`	`getHalignment(Node child)`	Возвращает ограничение выравнивания по горизонтали дочернего элемента, если оно задано.
`final double`	`getHgap()`	Возвращает значение свойства `hgap`.
`static Priority`	`getHgrow(Node child)`	Возвращает ограничение hgrow дочернего элемента, если оно задано.
`static Insets`	`getMargin(Node child)`	Возвращает ограничение отступа дочернего элемента, если оно задано.
`final ObservableList<RowConstraints>`	`getRowConstraints()`	Возвращает список ограничений строк.
`final int`	`getRowCount()`	Возвращает количество строк в этой сетке.
`static Integer`	`getRowIndex(Node child)`	Возвращает индекс строки дочернего элемента, если он задан.
`static Integer`	`getRowSpan(Node child)`	Возвращает ограничение размаха строки дочернего элемента, если оно задано.
`static VPos`	`getValignment(Node child)`	Возвращает ограничение выравнивания по вертикали дочернего элемента, если оно задано.
`final double`	`getVgap()`	Возвращает значение свойства `vgap`.
`static Priority`	`getVgrow(Node child)`	Возвращает ограничение vgrow дочернего элемента, если оно задано.
`final BooleanProperty`	`gridLinesVisibleProperty()`	Только для отладки: управляет отображением линий для показа строк и столбцов сетки.
`final DoubleProperty`	`hgapProperty()`	Ширина горизонтальных промежутков между столбцами.
`static Boolean`	`isFillHeight(Node child)`	Возвращает политику заполнения по вертикали дочернего элемента, если она задана.
`static Boolean`	`isFillWidth(Node child)`	Возвращает политику заполнения по горизонтали дочернего элемента, если она задана.
`final boolean`	`isGridLinesVisible()`	Возвращает значение свойства `gridLinesVisible`.
`final void`	`setAlignment(Pos value)`	Устанавливает значение свойства `alignment`.
`static void`	`setColumnIndex(Node child, Integer value)`	Устанавливает индекс столбца для дочернего элемента, содержащегося в сетке, чтобы он располагался, начиная со столбца сетки.
`static void`	`setColumnSpan(Node child, Integer value)`	Устанавливает размах столбца для дочернего элемента, содержащегося в сетке, чтобы он занимал указанное количество столбцов по горизонтали.
`static void`	`setConstraints(Node child, int columnIndex, int rowIndex)`	Устанавливает индексы столбца и строки для дочернего элемента, содержащегося в сетке.
`static void`	`setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan)`	Устанавливает значения столбца, строки, размаха столбца и размаха строки для дочернего элемента, содержащегося в сетке.
`static void`	`setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment)`	Устанавливает позицию, размах и выравнивание сетки для дочернего элемента при содержании в сетке.
`static void`	`setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment, Priority hgrow, Priority vgrow)`	Устанавливает позицию, размах и выравнивание сетки для дочернего элемента при содержании в сетке.
`static void`	`setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment, Priority hgrow, Priority vgrow, Insets margin)`	Устанавливает позицию сетки, размах, выравнивание, приоритеты роста и отступ для дочернего элемента при содержании в сетке.
`static void`	`setFillHeight(Node child, Boolean value)`	Устанавливает политику заполнения по вертикали для дочернего элемента, содержащегося в сетке.
`static void`	`setFillWidth(Node child, Boolean value)`	Устанавливает политику заполнения по горизонтали для дочернего элемента, содержащегося в сетке.
`final void`	`setGridLinesVisible(boolean value)`	Устанавливает значение свойства `gridLinesVisible`.
`static void`	`setHalignment(Node child, HPos value)`	Устанавливает горизонтальное выравнивание для дочернего элемента, содержащегося в сетке.
`final void`	`setHgap(double value)`	Устанавливает значение свойства `hgap`.
`static void`	`setHgrow(Node child, Priority value)`	Устанавливает приоритет горизонтального роста для дочернего элемента, содержащегося в сетке.
`static void`	`setMargin(Node child, Insets value)`	Устанавливает отступ для дочернего элемента, содержащегося в сетке.
`static void`	`setRowIndex(Node child, Integer value)`	Устанавливает индекс строки для дочернего элемента, содержащегося в сетке, чтобы он располагался, начиная со строки сетки.
`static void`	`setRowSpan(Node child, Integer value)`	Устанавливает размах строки для дочернего элемента, содержащегося в сетке, чтобы он занимал указанное количество строк по вертикали.
`static void`	`setValignment(Node child, VPos value)`	Устанавливает вертикальное выравнивание для дочернего элемента, содержащегося в сетке.
`final void`	`setVgap(double value)`	Устанавливает значение свойства `vgap`.
`static void`	`setVgrow(Node child, Priority value)`	Устанавливает приоритет вертикального роста для дочернего элемента, содержащегося в сетке.
`String`	`toString()`	Возвращает строковое представление этого объекта `GridPane`.
`final 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, focusVisibleProperty, focusWithinProperty, 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, 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, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

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

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

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

getStyleableNode

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

hgap

public final DoubleProperty hgapProperty

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

См. также:

vgap

public final DoubleProperty vgapProperty

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

См. также:

alignment

public final ObjectProperty<Pos> alignmentProperty

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

См. также:

gridLinesVisible

public final BooleanProperty gridLinesVisibleProperty

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

См. также:

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

REMAINING

public static final int REMAINING

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

См. также:

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

GridPane

public GridPane()

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

GridPane

public GridPane(double hgap, double vgap)

Создаёт макет GridPane с заданными значениями hgap и vgap.

Параметры:: hgap - размер горизонтальных промежутков между колонками; vgap - размер вертикальных промежутков между строками
С тех пор как:: 21

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

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, если выравнивание не было задано

Установить приоритет горизонтального роста

public static void setHgrow(Node child, Priority value)

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

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

Получить приоритет горизонтального роста

public static Priority getHgrow(Node child)

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

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

Установить приоритет вертикального роста

public static void setVgrow(Node child, Priority value)

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

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

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

public static Priority getVgrow(Node child)

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

Параметры:: 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 - дочерний узел

Свойство hgap

public final DoubleProperty hgapProperty()

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

Возвращает:

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

См. также:

Установить hgap

public final void setHgap(double value)

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

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

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

Параметры:

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

См. также:

Получить hgap

public final double getHgap()

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

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

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

Возвращает:

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

См. также:

Свойство vgap

public final DoubleProperty vgapProperty()

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

Возвращает:

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

См. также:

setVgap

public final void setVgap(double value)

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

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

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

Параметры:

value - значение свойства vgap

См. также:

getVgap

public final double getVgap()

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

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

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

Возвращает:

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

См. также:

alignmentProperty

public final ObjectProperty<Pos> alignmentProperty()

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

Возвращает:

выравнивание сетки по ширине и высоте GridPane

См. также:

setAlignment

public final void setAlignment(Pos value)

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

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

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

Параметры:

value - значение свойства alignment

См. также:

getAlignment

public final Pos getAlignment()

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

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

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

Возвращает:

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

См. также:

gridLinesVisibleProperty

public final BooleanProperty gridLinesVisibleProperty()

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

Возвращает:

true, если линии отображаются для визуализации строк и столбцов GridPane

См. также:

setGridLinesVisible

public final void setGridLinesVisible(boolean value)

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

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

Параметры:

value - значение свойства gridLinesVisible

См. также:

isGridLinesVisible

public final boolean isGridLinesVisible()

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

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

Возвращает:

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

См. также:

getRowConstraints

public final ObservableList<RowConstraints> getRowConstraints()

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

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

getColumnConstraints

public final ObservableList<ColumnConstraints> getColumnConstraints()

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

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

add

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

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

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

add

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

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

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

addRow

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

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

Параметры:: rowIndex - позиция строки для дочерних элементов в GridPane; children - узлы, которые нужно добавить как строку в GridPane

addColumn

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

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

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

getContentBias

public Orientation getContentBias()

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

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

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

Переопределяет:

getContentBias в классе Node

Возвращает:

null, если ни один из дочерних элементов не имеет смещения.

См. также:

toString

public String toString()

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

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

getClassCssMetaData

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

Получает CssMetaData, связанные с этим классом, которые могут включать CssMetaData его суперклассов.

Возвращает:: CssMetaData
С момента:: JavaFX 8.0

getCssMetaData

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

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

Определено в:: getCssMetaData в интерфейсе Styleable
Переопределяет:: getCssMetaData в классе Region
Возвращает:: CssMetaData, связанные с этим узлом, которые могут включать CssMetaData его суперклассов.
С момента:: JavaFX 8.0

getRowCount

public final int getRowCount()

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

Возвращает:: количество строк
С момента:: 9

getColumnCount

public final int getColumnCount()

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

Возвращает:: количество столбцов
С момента:: 9

getCellBounds

public final Bounds getCellBounds(int columnIndex, int rowIndex)

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

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