Класс GridPane
- javafx.scene.Node
-
- javafx.scene.Parent
-
- javafx.scene.layout.Region
-
- javafx.scene.layout.Pane
-
- javafx.scene.layout.GridPane
Все реализованные интерфейсы:
public class GridPane extends Pane
Элемент может быть размещен в любом месте сетки и может занимать несколько строк/столбцов. Элементы могут свободно перекрываться в строках/столбцах, а их порядок следования будет определяться порядком в списке дочерних элементов 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, значения будут обрабатываться как веса. Например, если трем столбцам присвоен widthPercent по 50, каждому будет выделена 1/3 доступной ширины gridpane (50/(50+50+50)).
Смешение типов размеров
Приложение может свободно комбинировать типы размеров строк/столбцов (вычисленные из содержимого, фиксированные или процентные). Процентные строки/столбцы всегда будут выделять место в первую очередь в зависимости от их процента от доступного пространства 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 по умолчанию не обрезает содержимое, поэтому границы элементов могут выходить за пределы собственных границ, если минимальный размер элемента препятствует его размещению в доступном пространстве.
Дополнительные ограничения выравнивания
Приложение может установить дополнительные ограничения на дочерние элементы, чтобы настроить способ, которым элемент масштабируется и позиционируется в области размещения, определённой индексами/диапазонами строк/столбцов:| Ограничение | Тип | Описание |
|---|---|---|
| halignment | javafx.geometry.HPos | Горизонтальное выравнивание элемента в его области размещения. |
| valignment | javafx.geometry.VPos | Вертикальное выравнивание элемента в его области размещения. |
| hgrow | javafx.scene.layout.Priority | Приоритет горизонтального роста элемента. |
| vgrow | javafx.scene.layout.Priority | Приоритет вертикального роста элемента. |
| margin | javafx.geometry.Insets | Отступ вокруг внешней стороны элемента. |
По умолчанию выравнивание элемента в его области размещения определяется выравниванием, заданным для строки и столбца. Если для отдельного элемента установлено ограничение выравнивания, это выравнивание переопределяет выравнивание строки/столбца только для этого элемента. Выравнивание других элементов в той же строке или столбце не повлияет.
Приоритеты роста, с другой стороны, могут применяться только к целым строкам или столбцам. Поэтому, если приоритет роста установлен для одного элемента, он будет использоваться для вычисления приоритета роста соответствующей строки/столбца. Если приоритет роста установлен непосредственно в объекте RowConstraint или ColumnConstraint, он переопределит значение, вычисленное из содержимого.
С момента:
JavaFX 2.0
-
Краткое описание свойств
Все методыМетоды экземпляровКонкретные методы Тип Свойство и описание ObjectProperty<Pos>alignmentВыравнивание сетки по ширине и высоте gridpane.BooleanPropertygridLinesVisibleТолько для отладки: управляет отображением линий для отображения строк и столбцов gridpane.DoublePropertyhgapШирина горизонтальных промежутков между столбцами.DoublePropertyvgapВысота вертикальных промежутков между строками.-
Свойства, унаследованные от класса javafx.scene.layout.Region
background, border, cacheShape, centerShape, height, insets, maxHeight, maxWidth, minHeight, minWidth, opaqueInsets, padding, prefHeight, prefWidth, scaleShape, shape, snapToPixel, width
-
Свойства, унаследованные от класса javafx.scene.Parent
needsLayout
-
Свойства, унаследованные от класса javafx.scene.Node
accessibleHelp, accessibleRoleDescription, accessibleRole, accessibleText, blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, visible
-
-
Краткое описание полей
Поля Модификатор и тип Поле и описание static intREMAININGЗначение-маркер, которое может быть установлено для ограничения разброса строки/столбца дочернего элемента, чтобы указать, что он должен занимать оставшиеся строки/столбцы.-
Поля, унаследованные от класса 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.
-
Краткое описание методов
Все методыСтатические методыМетоды экземпляраКонкретные методы Модификатор и тип Метод и описание voidadd(Node child, int columnIndex, int rowIndex)Добавляет дочерний элемент в сетку на указанные позиции столбца и строки.voidadd(Node child, int columnIndex, int rowIndex, int colspan, int rowspan)Добавляет дочерний элемент в сетку на указанные позиции столбца, строки и охватывает указанные позиции.voidaddColumn(int columnIndex, Node... children)Удобный метод для последовательного размещения указанных узлов в заданном столбце сетки.voidaddRow(int rowIndex, Node... children)Удобный метод для последовательного размещения указанных узлов в заданной строке сетки.ObjectProperty<Pos>alignmentProperty()Выравнивание сетки по ширине и высоте сетки.static voidclearConstraints(Node child)Удаляет все ограничения сетки от дочернего узла.protected doublecomputeMinHeight(double width)Вычисляет минимальную высоту данного региона.protected doublecomputeMinWidth(double height)Вычисляет минимальную ширину данного региона.protected doublecomputePrefHeight(double width)Вычисляет предпочтительную высоту данного региона для заданной ширины; Подклассы Region должны переопределять этот метод, чтобы возвращать соответствующее значение, основанное на их содержимом и стратегии макета.protected doublecomputePrefWidth(double height)Вычисляет предпочтительную ширину данного региона для заданной высоты.PosgetAlignment()Получает значение свойства выравнивания.static List<CssMetaData<? extends Styleable,?>>getClassCssMetaData()ObservableList<ColumnConstraints>getColumnConstraints()Возвращает список ограничений столбцов.static IntegergetColumnIndex(Node child)Возвращает ограничение индекса столбца дочернего элемента, если оно задано.static IntegergetColumnSpan(Node child)Возвращает ограничение размаха столбца дочернего элемента, если оно задано.OrientationgetContentBias()Возвращает ориентацию смещения изменения размера узла для целей макета.List<CssMetaData<? extends Styleable,?>>getCssMetaData()Этот метод должен делегироватьNode.getClassCssMetaData(), чтобы можно было получить доступ к CssMetaData узла без необходимости в рефлексии.static HPosgetHalignment(Node child)Возвращает ограничение выравнивания по горизонтали дочернего элемента, если оно задано.doublegetHgap()Получает значение свойства hgap.static PrioritygetHgrow(Node child)Возвращает ограничение расширения по горизонтали дочернего элемента, если оно задано.static InsetsgetMargin(Node child)Возвращает ограничение отступа дочернего элемента, если оно задано.ObservableList<RowConstraints>getRowConstraints()Возвращает список ограничений строк.static IntegergetRowIndex(Node child)Возвращает ограничение индекса строки дочернего элемента, если оно задано.static IntegergetRowSpan(Node child)Возвращает ограничение размаха строки дочернего элемента, если оно задано.static VPosgetValignment(Node child)Возвращает ограничение выравнивания по вертикали дочернего элемента, если оно задано.doublegetVgap()Получает значение свойства vgap.static PrioritygetVgrow(Node child)Возвращает ограничение расширения по вертикали дочернего элемента, если оно задано.BooleanPropertygridLinesVisibleProperty()Только для отладки: управляет отображением линий для отображения строк и столбцов сетки.DoublePropertyhgapProperty()Ширина горизонтальных отступов между столбцами.static BooleanisFillHeight(Node child)Возвращает политику заполнения по вертикали дочернего элемента, если она задана.static BooleanisFillWidth(Node child)Возвращает политику заполнения по горизонтали дочернего элемента, если она задана.booleanisGridLinesVisible()Получает значение свойства gridLinesVisible.protected voidlayoutChildren()Вызывается во время прохода макета для выравнивания дочерних элементов в этойParent.voidrequestLayout()Запрашивает проход макета, который будет выполнен перед рендерингом следующей сцены.voidsetAlignment(Pos value)Устанавливает значение свойства выравнивания.static voidsetColumnIndex(Node child, Integer value)Устанавливает индекс столбца для дочернего элемента, когда он содержится в сетке, так что он будет расположен, начиная со столбца сетки.static voidsetColumnSpan(Node child, Integer value)Устанавливает размах столбца для дочернего элемента, когда он содержится в сетке, так что он будет занимать это количество столбцов по горизонтали.static voidsetConstraints(Node child, int columnIndex, int rowIndex)Устанавливает индексы столбца и строки для дочернего элемента, когда он содержится в сетке.static voidsetConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan)Устанавливает значения столбца, строки, размаха столбца и размаха строки для дочернего элемента, когда он содержится в сетке.static voidsetConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment)Устанавливает позицию сетки, размахи и выравнивание для дочернего элемента, когда он содержится в сетке.static voidsetConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment, Priority hgrow, Priority vgrow)Устанавливает позицию сетки, размахи и выравнивание для дочернего элемента, когда он содержится в сетке.static voidsetConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment, Priority hgrow, Priority vgrow, Insets margin)Устанавливает позицию сетки, размахи, выравнивание, приоритеты расширения и отступ для дочернего элемента, когда он содержится в сетке.static voidsetFillHeight(Node child, Boolean value)Устанавливает политику заполнения по вертикали для дочернего элемента, когда он содержится в сетке.static voidsetFillWidth(Node child, Boolean value)Устанавливает политику заполнения по горизонтали для дочернего элемента, когда он содержится в сетке.voidsetGridLinesVisible(boolean value)Устанавливает значение свойства gridLinesVisible.static voidsetHalignment(Node child, HPos value)Устанавливает выравнивание по горизонтали для дочернего элемента, когда он содержится в сетке.voidsetHgap(double value)Устанавливает значение свойства hgap.static voidsetHgrow(Node child, Priority value)Устанавливает приоритет расширения по горизонтали для дочернего элемента, когда он содержится в сетке.static voidsetMargin(Node child, Insets value)Устанавливает отступ для дочернего элемента, когда он содержится в сетке.static voidsetRowIndex(Node child, Integer value)Устанавливает индекс строки для дочернего элемента, когда он содержится в сетке, так что он будет расположен, начиная со строки сетки.static voidsetRowSpan(Node child, Integer value)Устанавливает размах строки для дочернего элемента, когда он содержится в сетке, так что он будет занимать это количество строк по вертикали.static voidsetValignment(Node child, VPos value)Устанавливает выравнивание по вертикали для дочернего элемента, когда он содержится в сетке.voidsetVgap(double value)Устанавливает значение свойства vgap.static voidsetVgrow(Node child, Priority value)Устанавливает приоритет расширения по вертикали для дочернего элемента, когда он содержится в сетке.StringtoString()Возвращает строковое представление этогоGridPaneобъекта.DoublePropertyvgapProperty()Высота вертикальных отступов между строками.-
Методы, унаследованные от класса javafx.scene.layout.Pane
getChildren
-
Методы, унаследованные от класса javafx.scene.layout.Region
backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, computeMaxHeight, computeMaxWidth, 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, snapSize, snapSpace, snapToPixelProperty, widthProperty
-
Методы, унаследованные от класса javafx.scene.Parent
getBaselineOffset, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, lookup, needsLayoutProperty, queryAccessibleAttribute, requestParentLayout, setNeedsLayout, updateBounds
-
Методы, унаследованные от класса javafx.scene.Node
accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, executeAccessibleAction, fireEvent, focusedProperty, focusTraversableProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, 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, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, 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, 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, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, translateXProperty, translateYProperty, translateZProperty, usesMirroring, visibleProperty
-
-
Подробное описание свойств
-
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.
-
-
Подробное описание методов
-
setRowIndex
public static void setRowIndex(Node child, Integer value)Устанавливает индекс строки для дочернего элемента, когда он находится внутри gridpane, чтобы он позиционировался, начиная с этой строки в gridpane. Если у дочернего элемента gridpane нет заданного индекса строки, он будет размещён в первой строке. Установка значения в null удалит ограничение.Параметры:
child- дочерний узел gridpane
-
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
-
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
-
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
-
getColumnSpan
public static Integer getColumnSpan(Node child)
Возвращает ограничение интервала столбцов дочернего элемента, если оно задано.Параметры:
child- дочерний узел gridpaneВозвращает:
интервал столбцов дочернего элемента или null, если интервал столбцов не был задан
-
setMargin
public static void setMargin(Node child, Insets value)Устанавливает отступ для дочернего элемента, когда он находится внутри gridpane. Если задан, gridpane разместит его с отступом вокруг него. Установка значения в null удалит ограничение.Параметры:
child- дочерний узел gridpane
-
getMargin
public static Insets getMargin(Node child)
Возвращает ограничение отступа дочернего элемента, если оно задано.Параметры:
child- дочерний узел gridpaneВозвращает:
отступ дочернего элемента или null, если отступ не был задан
-
setHalignment
public static void setHalignment(Node child, HPos value)Устанавливает горизонтальное выравнивание для дочернего элемента, когда он находится внутри gridpane. Если задано, переопределяет по умолчанию горизонтальное выравнивание gridpane. Установка значения в null удалит ограничение.Параметры:
child- дочерний узел gridpane
-
getHalignment
public static HPos getHalignment(Node child)
Возвращает ограничение горизонтального выравнивания дочернего элемента, если оно задано.Параметры:
child- дочерний узел gridpaneВозвращает:
горизонтальное выравнивание дочернего элемента или null, если выравнивание не было задано
-
setValignment
public static void setValignment(Node child, VPos value)Устанавливает вертикальное выравнивание для дочернего элемента, когда он находится внутри gridpane. Если задано, переопределяет по умолчанию вертикальное выравнивание gridpane. Установка значения в null удалит ограничение.Параметры:
child- дочерний узел gridpane
-
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
-
getHgrow
public static Priority getHgrow(Node child)
Возвращает ограничение горизонтального роста дочернего элемента, если оно задано.Параметры:
child- дочерний узел gridpaneВозвращает:
приоритет горизонтального роста для дочернего элемента или null, если приоритет не был задан
-
setVgrow
public static void setVgrow(Node child, Priority value)Устанавливает приоритет вертикального роста для дочернего элемента, когда он находится внутри gridpane. Если задан, gridpane будет использовать приоритет для выделения дочернему элементу дополнительного вертикального пространства, если gridpane будет изменён в размерах и станет выше, чем предпочтительная высота. Установка значения в null удалит ограничение.Параметры:
child- дочерний элемент gridpane
-
getVgrow
public static Priority getVgrow(Node child)
Возвращает ограничение вертикального роста дочернего элемента, если оно задано.Параметры:
child- дочерний узел gridpaneВозвращает:
приоритет вертикального роста для дочернего элемента или null, если приоритет не был задан
-
setFillWidth
public static void setFillWidth(Node child, Boolean value)Устанавливает политику горизонтального заполнения для дочернего элемента, когда он находится внутри gridpane. Если задано, gridpane будет использовать политику для определения, нужно ли расширить узел до заполнения столбца или сохранить его предпочтительную ширину. Установка значения в null удалит ограничение. Если для узла и столбца не задано значение, значение по умолчанию — true.Параметры:
child- дочерний узел gridpaneС:
JavaFX 8.0
-
isFillWidth
public static Boolean isFillWidth(Node child)
Возвращает политику горизонтального заполнения дочернего элемента, если она заданаПараметры:
child- дочерний узел gridpaneВозвращает:
политику горизонтального заполнения дочернего элемента или null, если политика не была установлена
С:
JavaFX 8.0
-
setFillHeight
public static void setFillHeight(Node child, Boolean value)Устанавливает политику вертикального заполнения для дочернего элемента, когда он находится внутри gridpane. Если задано, gridpane будет использовать политику для определения, нужно ли расширить узел до заполнения строки или сохранить его предпочтительную высоту. Установка значения в null удалит ограничение. Если для узла и строки не задано значение, значение по умолчанию — true.Параметры:
child- дочерний узел gridpaneС:
JavaFX 8.0
-
isFillHeight
public static Boolean isFillHeight(Node child)
Возвращает политику вертикального заполнения дочернего элемента, если она заданаПараметры:
child- дочерний узел gridpaneВозвращает:
политику вертикального заполнения дочернего элемента или null, если политика не была установлена
С:
JavaFX 8.0
-
setConstraints
public static void setConstraints(Node child, int columnIndex, int rowIndex)Устанавливает индексы столбца и строки для дочернего элемента при размещении его внутри gridpane.Параметры:
child- дочерний узел gridpane
-
setConstraints
public static void setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan)Устанавливает значения столбца, строки, интервала столбцов и интервала строк для дочернего элемента при размещении его внутри gridpane.Параметры:
child- дочерний узел gridpane
-
setConstraints
public static void setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment)Устанавливает позицию в сетке, интервалы и выравнивание дочернего элемента при его размещении внутри gridpane.Параметры:
child- дочерний узел gridpane
-
setConstraints
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
-
setConstraints
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
-
clearConstraints
public static void clearConstraints(Node child)
Удаляет все ограничения gridpane от дочернего узла.Параметры:
child- дочерний узел
-
hgapProperty
public final DoubleProperty hgapProperty()
Ширина горизонтальных промежутков между столбцами.См. также:
-
-
setHgap
public final void setHgap(double value)
Устанавливает значение свойства hgap.Описание свойства:
Ширина горизонтальных промежутков между столбцами.
-
getHgap
public final double getHgap()
Получает значение свойства hgap.Описание свойства:
Ширина горизонтальных промежутков между столбцами.
-
vgapProperty
public final DoubleProperty vgapProperty()
Высота вертикальных промежутков между строками.См. также:
-
setVgap
public final void setVgap(double value)
Устанавливает значение свойства vgap.Описание свойства:
Высота вертикальных промежутков между строками.
-
getVgap
public final double getVgap()
Получает значение свойства vgap.Описание свойства:
Высота вертикальных промежутков между строками.
-
alignmentProperty
public final ObjectProperty<Pos> alignmentProperty()
Выравнивание сетки по ширине и высоте gridpane.См. также:
-
setAlignment
public final void setAlignment(Pos value)
Устанавливает значение свойства alignment.Описание свойства:
Выравнивание сетки по ширине и высоте gridpane.
-
getAlignment
public final Pos getAlignment()
Получает значение свойства alignment.Описание свойства:
Выравнивание сетки по ширине и высоте gridpane.
-
gridLinesVisibleProperty
public final BooleanProperty gridLinesVisibleProperty()
Только для отладки: управляет отображением линий для визуализации строк и столбцов gridpane. По умолчаниюfalse.См. также:
-
setGridLinesVisible
public final void setGridLinesVisible(boolean value)
Устанавливает значение свойства gridLinesVisible.Описание свойства:
Только для отладки: управляет отображением линий для визуализации строк и столбцов gridpane. По умолчанию
false.
-
isGridLinesVisible
public final boolean isGridLinesVisible()
Получает значение свойства gridLinesVisible.Описание свойства:
Только для отладки: управляет отображением линий для визуализации строк и столбцов gridpane. По умолчанию
false.
-
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 в указанную позицию столбца и строки. Этот метод по умолчанию устанавливает ограничения столбца и строки gridpane для дочернего элемента.Параметры:
child- узел, добавляемый в gridpane
-
add
public void add(Node child, int columnIndex, int rowIndex, int colspan, int rowspan)Добавляет дочерний элемент в gridpane в указанную позицию столбца, строки и размаха. Этот метод по умолчанию устанавливает ограничения столбца, строки и размаха gridpane для дочернего элемента.Параметры:
child- узел, добавляемый в gridpane
-
addRow
public void addRow(int rowIndex, Node... children)Удобный метод для последовательного размещения указанных узлов в заданной строке gridpane. Если строка уже содержит узлы, указанные узлы будут добавлены в конец строки. Например, первый узел будет размещён в [столбец,строка], второй - в [столбец+1,строка] и т. д. Этот метод также установит соответствующие ограничения строки/столбца gridpane для узлов и добавит узлы в последовательность дочерних элементов gridpane.Параметры:
rowIndex- позиция индекса строки для дочерних элементов внутри gridpane
-
addColumn
public void addColumn(int columnIndex, Node... children)Удобный метод для последовательного размещения указанных узлов в заданном столбце gridpane. Если столбец уже содержит узлы, указанные узлы будут добавлены в конец столбца. Например, первый узел будет размещен в [столбец, строка], второй - в [столбец, строка+1] и т. д. Этот метод установит соответствующие ограничения строки/столбца gridpane для узлов и добавит узлы в последовательность дочерних элементов gridpane.Параметры:
columnIndex- позиция индекса столбца для дочерних элементов внутри gridpane
-
computeMinWidth
protected double computeMinWidth(double height)
Описание скопировано из класса:RegionВычисляет минимальную ширину этого региона. По умолчанию возвращает сумму левого и правого отступов. Подклассы Region должны переопределить этот метод, чтобы вернуть соответствующее значение, основанное на содержимом и стратегии макета. Если у подкласса нет вертикальной направленности содержимого, параметр высоты можно игнорировать.Переопределяет:
computeMinWidthв классеRegionПараметры:
height- высота, которая должна использоваться, если минимальная ширина зависит от неёВозвращает:
вычисленная минимальная ширина этого региона
-
computeMinHeight
protected double computeMinHeight(double width)
Описание скопировано из класса:RegionВычисляет минимальную высоту этого региона. По умолчанию возвращает сумму верхнего и нижнего отступов. Подклассы Region должны переопределить этот метод, чтобы вернуть соответствующее значение, основанное на содержимом и стратегии макета. Если у подкласса нет горизонтальной направленности содержимого, параметр ширины можно игнорировать.Переопределяет:
computeMinHeightв классеRegionПараметры:
width- ширина, которая должна использоваться, если минимальная высота зависит от неёВозвращает:
вычисленная минимальная высота для этого региона
-
computePrefWidth
protected double computePrefWidth(double height)
Описание скопировано из класса:RegionВычисляет предпочтительную ширину этого региона для заданной высоты. Подклассы Region должны переопределить этот метод, чтобы вернуть соответствующее значение, основанное на содержимом и стратегии макета. Если у подкласса нет вертикальной направленности содержимого, параметр высоты можно игнорировать.Переопределяет:
computePrefWidthв классеRegionПараметры:
height- высота, которая должна использоваться, если предпочтительная ширина зависит от неёВозвращает:
вычисленная предпочтительная ширина для этого региона
-
computePrefHeight
protected double computePrefHeight(double width)
Описание скопировано из класса:RegionВычисляет предпочтительную высоту этого региона для заданной ширины. Подклассы Region должны переопределить этот метод, чтобы вернуть соответствующее значение, основанное на содержимом и стратегии макета. Если у подкласса нет горизонтальной направленности содержимого, параметр ширины можно игнорировать.Переопределяет:
computePrefHeightв классеRegionПараметры:
width- ширина, которая должна использоваться, если предпочтительная высота зависит от неёВозвращает:
вычисленная предпочтительная высота для этого региона
-
getContentBias
public Orientation getContentBias()
Описание скопировано из класса:NodeВозвращает ориентацию уклона изменения размера узла для целей макета. Если у типа узла нет уклона, возвращает null. Если узел изменяемый по размеру и его высота зависит от ширины, возвращает HORIZONTAL, иначе, если его ширина зависит от высоты, возвращает VERTICAL.Подклассы Resizable должны переопределить этот метод, чтобы вернуть соответствующее значение.
Переопределяет:
getContentBiasв классеNodeВозвращает:
null, если ни один из его дочерних элементов не имеет уклона содержимого.
-
requestLayout
public void requestLayout()
Описание скопировано из класса:ParentЗапрашивает проход макета перед рендерингом следующей сцены. Это выполняется асинхронно, пакетно, один раз на "импульс" или кадр анимации.Если этот родительский элемент является корнем макета или не управляется, он будет добавлен непосредственно в список грязного макета сцены, в противном случае вызывается requestParentLayout.
Переопределяет:
requestLayoutв классеParent
-
-
layoutChildren
protected void layoutChildren()
Описание скопировано из класса:ParentВызывается во время прохода компоновки для компоновки дочерних элементов в этомParent. По умолчанию он будет устанавливать только размер управляемого, изменяемого содержимого до их предпочтительных размеров и не выполняет позиционирование узлов.Подклассы должны переопределять эту функцию для компоновки содержимого по мере необходимости.
Переопределяет:
layoutChildrenв классеParent
-
toString
public String toString()
Возвращает строковое представление этогоGridPaneобъекта.
-
getClassCssMetaData
public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
Возвращает:
CssMetaData, связанная с этим классом, которая может включать CssMetaData его родительских классов.
С момента:
JavaFX 8.0
-
getCssMetaData
public List<CssMetaData<? extends Styleable,?>> getCssMetaData()
Этот метод должен делегироватьNode.getClassCssMetaData(), чтобы CssMetaData узла можно было получить без необходимости в рефлексии.Задано:
getCssMetaDataв интерфейсеStyleableПереопределяет:
getCssMetaDataв классеRegionВозвращает:
CssMetaData, связанная с этим узлом, которая может включать CssMetaData его родительских классов.
С момента:
JavaFX 8.0
-
© 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.