Класс 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 за пределами его предпочтительного размера, чтобы заполнить любое назначенное ему пространство.

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()`, чтобы CssMetaData узла можно было получить без рефлексии.
`static HPos`	`getHalignment(Node child)`	Возвращает ограничение выравнивания по горизонтали дочернего элемента, если оно установлено.
`final double`	`getHgap()`	Получает значение свойства `hgap`.
`static Priority`	`getHgrow(Node child)`	Возвращает ограничение увеличения по горизонтали дочернего элемента, если оно установлено.
`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)`	Возвращает ограничение увеличения по вертикали дочернего элемента, если оно установлено.
`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, 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

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

См. также:

getHgap()
setHgap(double)
hgapProperty()

vgap

public final DoubleProperty vgapProperty

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

См. также:

getVgap()
setVgap(double)
vgapProperty()

alignment

public final ObjectProperty<Pos> alignmentProperty

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

См. также:

getAlignment()
setAlignment(Pos)
alignmentProperty()

gridLinesVisible

public final BooleanProperty gridLinesVisibleProperty

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

См. также:

isGridLinesVisible()
setGridLinesVisible(boolean)
gridLinesVisibleProperty()

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

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

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

Установить приоритет увеличения по вертикали

public static void setVgrow(Node child, Priority value)

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

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

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

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 - узел дочернего элемента

hgapСвойство

public final DoubleProperty hgapProperty()

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

Возвращает:

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

См. также:

getHgap()
setHgap(double)

Установить hgap

public final void setHgap(double value)

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

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

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

Параметры:

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

См. также:

getHgap()
hgapProperty()

Получить hgap

public final double getHgap()

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

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

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

Возвращает:

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

См. также:

setHgap(double)
hgapProperty()

vgapСвойство

public final DoubleProperty vgapProperty()

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

Возвращает:

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

См. также:

getVgap()
setVgap(double)

Установить vgap

public final void setVgap(double value)

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

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

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

Параметры:

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

См. также:

getVgap()
vgapProperty()

Получить vgap

public final double getVgap()

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

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

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

Возвращает:

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

См. также:

setVgap(double)
vgapProperty()

Свойство выравнивания

public final ObjectProperty<Pos> alignmentProperty()

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

Возвращает:

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

См. также:

getAlignment()
setAlignment(Pos)

Выравнивание

public final void setAlignment(Pos value)

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

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

Выравнивание сетки по ширине и высоте гридпанели.

Параметры:

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

См. также:

getAlignment()
alignmentProperty()

getAlignment

public final Pos getAlignment()

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

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

Выравнивание сетки по ширине и высоте гридпанели.

Возвращает:

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

См. также:

setAlignment(Pos)
alignmentProperty()

gridLinesVisibleProperty

public final BooleanProperty gridLinesVisibleProperty()

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

Возвращает:

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

См. также:

isGridLinesVisible()
setGridLinesVisible(boolean)

setGridLinesVisible

public final void setGridLinesVisible(boolean value)

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

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

Параметры:

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

См. также:

isGridLinesVisible()
gridLinesVisibleProperty()

isGridLinesVisible

public final boolean isGridLinesVisible()

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

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

Возвращает:

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

См. также:

setGridLinesVisible(boolean)
gridLinesVisibleProperty()

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)

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

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

add

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

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

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

addRow

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

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

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

addColumn

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

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

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

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(), чтобы метаданные CSS узла можно было получить без рефлексии.

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

getRowCount

public final int getRowCount()

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

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

getColumnCount

public final int getColumnCount()

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

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

getCellBounds

public final Bounds getCellBounds(int columnIndex, int rowIndex)

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

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