- java.lang.Object
-
- javafx.scene.Node
-
- javafx.scene.Parent
-
- javafx.scene.layout.Region
-
- javafx.scene.layout.Pane
-
- javafx.scene.layout.GridPane
-
- Все реализуемые интерфейсы:
-
Styleable,EventTarget
public class GridPane extends Pane
GridPane выкладывает свои дочерние элементы в гибкую сетку строк и столбцов. Если установлен border и/или отступ, то содержимое будет выложено внутри этих отступов.Элемент может быть размещён где угодно в сетке и может занимать несколько строк/столбцов. Элементы могут свободно перекрываться в строках/столбцах, и их порядок следования будет определяться порядком списка дочерних элементов gridpane (0-й узел — сзади, последний узел — спереди).
GridPane может быть стилизован с помощью фона и границ с использованием CSS. Подробности см. в суперклассе
Region.Свойства размещения в сетке
Размещение элемента в сетке определяется его свойствами размещения:
Таблица свойств размещения в сетке Свойство Тип Описание columnIndex целое число столбец, в котором начинается область размещения элемента. rowIndex целое число строка, в которой начинается область размещения элемента. columnSpan целое число количество столбцов, занимаемых элементом по горизонтали. rowSpan целое число количество строк, занимаемых элементом по вертикали. Если индексы строки/столбца не заданы явно, то элемент будет помещён в первую строку/столбец. Если spans строк/столбцов не заданы, они будут по умолчанию равны 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 изменяется на размер, больший, чем его предпочтительный размер. Если приложению нужен определённый столбец или строка для роста при наличии дополнительного места, оно может установить его приоритет роста в объекте 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 wideGridPane 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:
Если для строки/столбца установлено значение процента, то это значение имеет преимущество, и свойства min, pref, max и grow строк/столбцов будут игнорироваться.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Обратите внимание, что если сумма значений widthPercent (или heightPercent) превышает 100, значения будут обрабатываться как веса. Например, если 3 столбцам присвоено widthPercent 50, то каждому будет выделено 1/3 доступной ширины gridpane (50/(50+50+50)).
Смешение типов размеров
Приложение может свободно смешивать типы размеров строк/столбцов (вычисленные из содержимого, фиксированные или процентные). Процентные строки/столбцы всегда будут выделять пространство в первую очередь, исходя из их процента от доступного пространства gridpane (размер минус отступы и промежутки). Остальное пространство будет выделено для строк/столбцов с учётом минимальных, предпочтительных и максимальных размеров и приоритетов роста.Диапазон изменения размера
Родительский элемент gridpane будет изменять размер gridpane в диапазоне изменения размера gridpane во время вычисления. По умолчанию gridpane вычисляет этот диапазон, основываясь на содержимом и свойствах строк/столбцов, как показано в таблице ниже.
Таблица изменения размера GridPane ширина высота минимум левый/правый отступы плюс сумма минимальной ширины каждого столбца. верхний/нижний отступы плюс сумма минимальной высоты каждой строки. предпочтительный левый/правый отступы плюс сумма предпочтительной ширины каждого столбца. верхний/нижний отступы плюс сумма предпочтительной высоты каждой строки. максимум Double.MAX_VALUE Double.MAX_VALUE Неограниченная максимальная ширина и высота gridpane указывают родителю, что его можно изменить на размер, превышающий предпочтительный, чтобы заполнить любое выделенное для него пространство.
GridPane предоставляет свойства для непосредственного задания диапазона размера. Эти свойства по умолчанию имеют значение USE_COMPUTED_SIZE, однако приложение может устанавливать их в другие значения по мере необходимости:
Приложения могут восстановить вычисленные значения, установив эти свойства обратно в 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);GridPane по умолчанию не обрезает своё содержимое, поэтому возможно, что границы дочерних элементов могут выходить за пределы его собственных границ, если минимальный размер элемента препятствует его размещению в отведённом пространстве.
Дополнительные свойства размещения
Приложение может задать дополнительные свойства размещения для дочерних элементов, чтобы настроить, как размер и расположение элемента внутри области размещения, установленной индексами/диапазонами строк/столбцов:
Таблица дополнительных свойств размещения в GridPane Свойство Тип Описание halignment javafx.geometry.HPos Горизонтальное выравнивание элемента в пределах его области размещения. valignment javafx.geometry.VPos Вертикальное выравнивание элемента в пределах его области размещения. hgrow javafx.scene.layout.Priority Приоритет горизонтального роста элемента. vgrow javafx.scene.layout.Priority Приоритет вертикального роста элемента. margin javafx.geometry.Insets Отступ вокруг элемента. По умолчанию выравнивание элемента внутри его области размещения определяется выравниванием, заданным для строки и столбца. Если для элемента задано индивидуальное свойство выравнивания, это выравнивание переопределит выравнивание строки/столбца только для этого элемента. Выравнивание других элементов в той же строке или столбце не повлияет.
Однако приоритеты роста могут быть применены только к целым строкам или столбцам. Поэтому, если приоритет роста задан для одного элемента, он будет использоваться для вычисления приоритета роста для охватывающей строки/столбца. Если приоритет роста задан непосредственно на объекте RowConstraint или ColumnConstraint, это значение переопределит значение, вычисленное из содержимого.
- С тех пор:
- JavaFX 2.0
-
Краткое описание свойств
Свойства Тип Свойство Описание ObjectProperty<Pos>alignmentВыравнивание сетки по ширине и высоте сетки.BooleanPropertygridLinesVisibleТолько для отладки: управляет отображением линий для показа строк и столбцов сетки.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, viewOrder, visible
-
-
Краткое описание полей
Поля Модификатор и тип Поле Описание static intREMAININGЗначение-маяк, которое может быть установлено для ограничения span строки/столбца дочернего элемента, чтобы указать, что он должен охватывать оставшиеся строки/столбцы.-
Поля, унаследованные от класса 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)Добавляет дочерний элемент в gridpane по указанным колонке и строке.voidadd(Node child, int columnIndex, int rowIndex, int colspan, int rowspan)Добавляет дочерний элемент в gridpane по указанным колонке, строке и размаху.voidaddColumn(int columnIndex, Node... children)Удобный метод для последовательного размещения узлов в заданной колонке gridpane.voidaddRow(int rowIndex, Node... children)Удобный метод для последовательного размещения узлов в заданной строке gridpane.ObjectProperty<Pos>alignmentProperty()Выравнивание сетки по ширине и высоте gridpane.static voidclearConstraints(Node child)Удаляет все ограничения gridpane для дочернего узла.protected doublecomputeMinHeight(double width)Вычисляет минимальную высоту этого региона.protected doublecomputeMinWidth(double height)Вычисляет минимальную ширину этого региона.protected doublecomputePrefHeight(double width)Вычисляет предпочтительную высоту этого региона для заданной ширины; Подклассы Region должны переопределять этот метод, чтобы возвращать соответствующее значение, основанное на их содержимом и стратегии макета.protected doublecomputePrefWidth(double height)Вычисляет предпочтительную ширину этого региона для заданной высоты.PosgetAlignment()Возвращает значение свойства alignment.BoundsgetCellBounds(int columnIndex, int rowIndex)Возвращает границы ячейки по указанной колонке и строке.static List<CssMetaData<? extends Styleable,?>>getClassCssMetaData()ObservableList<ColumnConstraints>getColumnConstraints()Возвращает список ограничений столбцов.intgetColumnCount()Возвращает количество столбцов в этом GridPane.static IntegergetColumnIndex(Node child)Возвращает индекс столбца дочернего элемента, если задан.static IntegergetColumnSpan(Node child)Возвращает ограничение размаха столбца дочернего элемента, если задан.OrientationgetContentBias()Возвращает ориентацию смещения изменения размера узла для целей макета.List<CssMetaData<? extends Styleable,?>>getCssMetaData()Этот метод должен делегироватьNode.getClassCssMetaData(), чтобы метаданные CSS узла Node можно было получить без необходимости рефлексии.static HPosgetHalignment(Node child)Возвращает ограничение выравнивания по горизонтали дочернего элемента, если задан.doublegetHgap()Возвращает значение свойства hgap.static PrioritygetHgrow(Node child)Возвращает ограничение hgrow дочернего элемента, если задан.static InsetsgetMargin(Node child)Возвращает ограничение отступа дочернего элемента, если задан.ObservableList<RowConstraints>getRowConstraints()Возвращает список ограничений строк.intgetRowCount()Возвращает количество строк в этом GridPane.static IntegergetRowIndex(Node child)Возвращает индекс строки дочернего элемента, если задан.static IntegergetRowSpan(Node child)Возвращает ограничение размаха строки дочернего элемента, если задан.static VPosgetValignment(Node child)Возвращает ограничение выравнивания по вертикали дочернего элемента, если задан.doublegetVgap()Возвращает значение свойства vgap.static PrioritygetVgrow(Node child)Возвращает ограничение vgrow дочернего элемента, если задан.BooleanPropertygridLinesVisibleProperty()Только для отладки: управляет отображением линий, показывающих строки и столбцы gridpane.DoublePropertyhgapProperty()Ширина горизонтальных отступов между столбцами.static BooleanisFillHeight(Node child)Возвращает политику заполнения по вертикали дочернего элемента, если задана.static BooleanisFillWidth(Node child)Возвращает политику заполнения по горизонтали дочернего элемента, если задана.booleanisGridLinesVisible()Возвращает значение свойства gridLinesVisible.protected voidlayoutChildren()Вызывается во время фазы макета для размещения дочерних элементов в этомParent.voidrequestLayout()Запрашивает прохождение макета перед рендерингом следующей сцены.voidsetAlignment(Pos value)Устанавливает значение свойства alignment.static voidsetColumnIndex(Node child, Integer value)Устанавливает индекс столбца для дочернего элемента при содержании в gridpane, чтобы он позиционировался, начиная со столбца gridpane.static voidsetColumnSpan(Node child, Integer value)Устанавливает размах столбца для дочернего элемента при содержании в gridpane, чтобы он занимал указанное количество столбцов по горизонтали.static voidsetConstraints(Node child, int columnIndex, int rowIndex)Устанавливает индексы столбца и строки для дочернего элемента при содержании в gridpane.
static voidsetConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan)Устанавливает значения столбца, строки, ширины и высоты столбца для дочернего элемента, когда он содержится в gridpane.static voidsetConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment)Устанавливает положение, пролеты и выравнивание сетки для дочернего элемента при включении в gridpane.static voidsetConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment, Priority hgrow, Priority vgrow)Устанавливает положение, пролеты и выравнивание сетки для дочернего элемента при включении в gridpane.static voidsetConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment, Priority hgrow, Priority vgrow, Insets margin)Устанавливает положение, пролеты, выравнивание, приоритеты увеличения и отступ для дочернего элемента при включении в gridpane.static voidsetFillHeight(Node child, Boolean value)Устанавливает политику вертикального заполнения для дочернего элемента, когда он содержится в gridpane.static voidsetFillWidth(Node child, Boolean value)Устанавливает политику горизонтального заполнения для дочернего элемента, когда он содержится в gridpane.voidsetGridLinesVisible(boolean value)Устанавливает значение свойства gridLinesVisible.static voidsetHalignment(Node child, HPos value)Устанавливает горизонтальное выравнивание для дочернего элемента, когда он содержится в gridpane.voidsetHgap(double value)Устанавливает значение свойства hgap.static voidsetHgrow(Node child, Priority value)Устанавливает приоритет горизонтального увеличения для дочернего элемента, когда он содержится в gridpane.static voidsetMargin(Node child, Insets value)Устанавливает отступ для дочернего элемента, когда он содержится в gridpane.static voidsetRowIndex(Node child, Integer value)Устанавливает индекс строки для дочернего элемента при включении в gridpane, чтобы он был расположен, начиная со строки gridpane.static voidsetRowSpan(Node child, Integer value)Устанавливает размах строки для дочернего элемента при включении в gridpane, чтобы он занимал указанное количество строк по вертикали.static voidsetValignment(Node child, VPos value)Устанавливает вертикальное выравнивание для дочернего элемента при включении в gridpane.voidsetVgap(double value)Устанавливает значение свойства vgap.static voidsetVgrow(Node child, Priority value)Устанавливает приоритет вертикального увеличения для дочернего элемента при включении в gridpane.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, snapPositionX, snapPositionY, snapSize, snapSizeX, snapSizeY, snapSpace, snapSpaceX, snapSpaceY, 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, 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, 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, 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)
-
vgap
public final DoubleProperty vgapProperty
Высота вертикальных промежутков между строками.- См. также:
-
getVgap(),setVgap(double)
-
alignment
public final ObjectProperty<Pos> alignmentProperty
Выравнивание сетки по ширине и высоте gridpane.- См. также:
-
getAlignment(),setAlignment(Pos)
-
gridLinesVisible
public final BooleanProperty gridLinesVisibleProperty
Только для отладки: управляет отображением линий для отображения строк и столбцов gridpane. Значение по умолчаниюfalse.- См. также:
-
isGridLinesVisible(),setGridLinesVisible(boolean)
-
-
Подробное описание полей
-
REMAINING
public static final int REMAINING
Значение-маркер, которое может быть установлено для ограничения размаха строки/столбца дочернего элемента, чтобы указать, что он должен занимать оставшиеся строки/столбцы.- См. также:
- Значения константных полей
-
-
Подробное описание конструкторов
-
GridPane
public GridPane()
Создает макет GridPane с hgap/vgap = 0 и выравниванием TOP_LEFT.
-
-
Method Detail
-
setRowIndex
public static void setRowIndex(Node child, Integer value)
Sets the row index for the child when contained by a gridpane so that it will be positioned starting in that row of the gridpane. If a gridpane child has no row index set, it will be positioned in the first row. Setting the value to null will remove the constraint.- Parameters:
-
child- the child node of a gridpane -
value- the row index of the child
-
getRowIndex
public static Integer getRowIndex(Node child)
Returns the child's row index constraint if set.- Parameters:
-
child- the child node of a gridpane - Returns:
- the row index for the child or null if no row index was set
-
setColumnIndex
public static void setColumnIndex(Node child, Integer value)
Sets the column index for the child when contained by a gridpane so that it will be positioned starting in that column of the gridpane. If a gridpane child has no column index set, it will be positioned in the first column. Setting the value to null will remove the constraint.- Parameters:
-
child- the child node of a gridpane -
value- the column index of the child
-
getColumnIndex
public static Integer getColumnIndex(Node child)
Returns the child's column index constraint if set.- Parameters:
-
child- the child node of a gridpane - Returns:
- the column index for the child or null if no column index was set
-
setRowSpan
public static void setRowSpan(Node child, Integer value)
Sets the row span for the child when contained by a gridpane so that it will span that number of rows vertically. This may be set to REMAINING, which will cause the span to extend across all the remaining rows.If a gridpane child has no row span set, it will default to spanning one row. Setting the value to null will remove the constraint.
- Parameters:
-
child- the child node of a gridpane -
value- the row span of the child
-
getRowSpan
public static Integer getRowSpan(Node child)
Returns the child's row-span constraint if set.- Parameters:
-
child- the child node of a gridpane - Returns:
- the row span for the child or null if no row span was set
-
setColumnSpan
public static void setColumnSpan(Node child, Integer value)
Sets the column span for the child when contained by a gridpane so that it will span that number of columns horizontally. This may be set to REMAINING, which will cause the span to extend across all the remaining columns.If a gridpane child has no column span set, it will default to spanning one column. Setting the value to null will remove the constraint.
- Parameters:
-
child- the child node of a gridpane -
value- the column span of the child
-
getColumnSpan
public static Integer getColumnSpan(Node child)
Returns the child's column-span constraint if set.- Parameters:
-
child- the child node of a gridpane - Returns:
- the column span for the child or null if no column span was set
-
setMargin
public static void setMargin(Node child, Insets value)
Sets the margin for the child when contained by a gridpane. If set, the gridpane will lay it out with the margin space around it. Setting the value to null will remove the constraint.- Parameters:
-
child- the child node of a gridpane -
value- the margin of space around the child
-
getMargin
public static Insets getMargin(Node child)
Returns the child's margin constraint if set.- Parameters:
-
child- the child node of a gridpane - Returns:
- the margin for the child or null if no margin was set
-
setHalignment
public static void setHalignment(Node child, HPos value)
Sets the horizontal alignment for the child when contained by a gridpane. If set, will override the gridpane's default horizontal alignment. Setting the value to null will remove the constraint.- Parameters:
-
child- the child node of a gridpane -
value- the hozizontal alignment for the child
-
getHalignment
public static HPos getHalignment(Node child)
Returns the child's halignment constraint if set.- Parameters:
-
child- the child node of a gridpane - Returns:
- the horizontal alignment for the child or null if no alignment was set
-
setValignment
public static void setValignment(Node child, VPos value)
Sets the vertical alignment for the child when contained by a gridpane. If set, will override the gridpane's default vertical alignment. Setting the value to null will remove the constraint.- Parameters:
-
child- the child node of a gridpane -
value- the vertical alignment for the child
-
getValignment
public static VPos getValignment(Node child)
Returns the child's valignment constraint if set.- Parameters:
-
child- the child node of a gridpane - Returns:
- the vertical alignment for the child or null if no alignment was set
-
setHgrow
public static void setHgrow(Node child, Priority value)
Sets the horizontal grow priority for the child when contained by a gridpane. If set, the gridpane will use the priority to allocate the child additional horizontal space if the gridpane is resized larger than it's preferred width. Setting the value to null will remove the constraint.- Parameters:
-
child- the child of a gridpane -
value- the horizontal grow priority for the child
-
getHgrow
public static Priority getHgrow(Node child)
Returns the child's hgrow constraint if set.- Parameters:
-
child- the child node of a gridpane - Returns:
- the horizontal grow priority for the child or null if no priority was set
-
setVgrow
public static void setVgrow(Node child, Priority value)
Sets the vertical grow priority for the child when contained by a gridpane. If set, the gridpane will use the priority to allocate the child additional vertical space if the gridpane is resized larger than it's preferred height. Setting the value to null will remove the constraint.- Parameters:
-
child- the child of a gridpane -
value- the vertical grow priority for the child
-
getVgrow
public static Priority getVgrow(Node child)
Returns the child's vgrow constraint if set.- Parameters:
-
child- the child node of a gridpane - Returns:
- the vertical grow priority for the child or null if no priority was set
-
setFillWidth
public static void setFillWidth(Node child, Boolean value)
Sets the horizontal fill policy for the child when contained by a gridpane. If set, the gridpane will use the policy to determine whether node should be expanded to fill the column or resized to its preferred width. Setting the value to null will remove the constraint. If not value is specified for the node nor for the column, the default value is true.- Parameters:
-
child- the child node of a gridpane -
value- the horizontal fill policy or null for unset - Since:
- JavaFX 8.0
-
isFillWidth
public static Boolean isFillWidth(Node child)
Returns the child's horizontal fill policy if set- Parameters:
-
child- the child node of a gridpane - Returns:
- the horizontal fill policy for the child or null if no policy was set
- Since:
- JavaFX 8.0
-
setFillHeight
public static void setFillHeight(Node child, Boolean value)
Sets the vertical fill policy for the child when contained by a gridpane. If set, the gridpane will use the policy to determine whether node should be expanded to fill the row or resized to its preferred height. Setting the value to null will remove the constraint. If not value is specified for the node nor for the row, the default value is true.- Parameters:
-
child- the child node of a gridpane -
value- the vertical fill policy or null for unset - Since:
- 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 -
columnIndex- позиция индекса столбца для дочернего элемента -
rowIndex- позиция индекса строки для дочернего элемента
-
setConstraints
public static void setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan)
Устанавливает значения столбца, строки, размаха столбцов и размаха строк для дочернего элемента при содержании в gridpane.- Параметры:
-
child- дочерний узел gridpane -
columnIndex- позиция индекса столбца для дочернего элемента -
rowIndex- позиция индекса строки для дочернего элемента -
columnspan- количество столбцов, которое должно охватывать дочерний элемент -
rowspan- количество строк, которое должно охватывать дочерний элемент
-
setConstraints
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- вертикальное выравнивание дочернего элемента
-
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 -
columnIndex- позиция индекса столбца для дочернего элемента -
rowIndex- позиция индекса строки для дочернего элемента -
columnspan- количество столбцов, которое должен охватывать дочерний элемент -
rowspan- количество строк, которое должен охватывать дочерний элемент -
halignment- горизонтальное выравнивание дочернего элемента -
valignment- вертикальное выравнивание дочернего элемента -
hgrow- приоритет горизонтального увеличения дочернего элемента -
vgrow- приоритет вертикального увеличения дочернего элемента
-
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 -
columnIndex- позиция индекса столбца для дочернего элемента -
rowIndex- позиция индекса строки для дочернего элемента -
columnspan- количество столбцов, которое должен охватывать дочерний элемент -
rowspan- количество строк, которое должен охватывать дочерний элемент -
halignment- горизонтальное выравнивание дочернего элемента -
valignment- вертикальное выравнивание дочернего элемента -
hgrow- приоритет горизонтального увеличения дочернего элемента -
vgrow- приоритет вертикального увеличения дочернего элемента -
margin- отступ вокруг дочернего элемента
-
clearConstraints
public static void clearConstraints(Node child)
Удаляет все ограничения gridpane от дочернего узла.- Параметры:
-
child- дочерний узел
-
hgapProperty
public final DoubleProperty hgapProperty()
Ширина горизонтальных промежутков между столбцами.- См. также:
-
getHgap(),setHgap(double)
-
setHgap
public final void setHgap(double value)
Устанавливает значение свойства hgap.- Описание свойства:
- Ширина горизонтальных промежутков между столбцами.
-
getHgap
public final double getHgap()
Получает значение свойства hgap.- Описание свойства:
- Ширина горизонтальных промежутков между столбцами.
-
vgapProperty
public final DoubleProperty vgapProperty()
Высота вертикальных промежутков между строками.- См. также:
-
getVgap(),setVgap(double)
-
setVgap
public final void setVgap(double value)
Устанавливает значение свойства vgap.- Описание свойства:
- Высота вертикальных промежутков между строками.
-
getVgap
public final double getVgap()
Получает значение свойства vgap.- Описание свойства:
- Высота вертикальных промежутков между строками.
-
alignmentProperty
public final ObjectProperty<Pos> alignmentProperty()
Выравнивание сетки по ширине и высоте gridpane.- См. также:
-
getAlignment(),setAlignment(Pos)
-
setAlignment
public final void setAlignment(Pos value)
Устанавливает значение свойства alignment.- Описание свойства:
- Выравнивание сетки по ширине и высоте gridpane.
-
getAlignment
public final Pos getAlignment()
Получает значение свойства alignment.- Описание свойства:
- Выравнивание сетки по ширине и высоте gridpane.
-
gridLinesVisibleProperty
public final BooleanProperty gridLinesVisibleProperty()
Только для отладки: управляет отображением линий для отображения строк и столбцов gridpane. Значение по умолчаниюfalse.- См. также:
-
isGridLinesVisible(),setGridLinesVisible(boolean)
-
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 -
columnIndex- позиция индекса столбца дочернего элемента в gridpane, отсчет с 0 -
rowIndex- позиция индекса строки дочернего элемента в gridpane, отсчет с 0
-
add
public void add(Node child, int columnIndex, int rowIndex, int colspan, int rowspan)
Добавляет дочерний элемент в gridpane в указанной позиции столбца и строки и размахах. Этот метод-удобство установит ограничения столбца, строки и размаха gridpane на дочернем элементе.- Параметры:
-
child- узел, добавляемый в gridpane -
columnIndex- позиция индекса столбца дочернего элемента в gridpane, отсчет с 0 -
rowIndex- позиция индекса строки дочернего элемента в gridpane, отсчет с 0 -
colspan- количество столбцов, которое область макета дочернего элемента должна охватывать -
rowspan- количество строк, которое область макета дочернего элемента должна охватывать
-
-
addRow
public void addRow(int rowIndex, Node... children)Удобный метод для последовательной размещения указанных узлов в заданной строке сетки. Если строка уже содержит узлы, указанные узлы будут добавлены к строке. Например, первый узел будет расположен в [столбец,строка], второй в [столбец+1,строка] и т.д. Этот метод установит соответствующие ограничения строки/столбца gridpane для узлов, а также добавит узлы в последовательность дочерних элементов gridpane.- Параметры:
-
rowIndex- индекс строки для позиционирования дочерних элементов в сетке -
children- узлы, которые нужно добавить как строку в сетку
-
addColumn
public void addColumn(int columnIndex, Node... children)Удобный метод для последовательного размещения указанных узлов в заданном столбце сетки. Если столбец уже содержит узлы, указанные узлы будут добавлены к столбцу. Например, первый узел будет расположен в [столбец, строка], второй в [столбец, строка+1] и т.д. Этот метод установит соответствующие ограничения строки/столбца gridpane для узлов, а также добавит узлы в последовательность дочерних элементов gridpane.- Параметры:
-
columnIndex- индекс столбца для позиционирования дочерних элементов в сетке -
children- узлы, которые нужно добавить как столбец в сетку
-
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.Подклассы, изменяемые по размеру, должны переопределить этот метод, чтобы вернуть соответствующее значение.
- Переопределяет:
-
getContentBiasв классеNode - Возвращает:
- null, если ни один из его дочерних элементов не имеет смещения содержимого.
- См. также:
-
Node.isResizable(),Node.minWidth(double),Node.minHeight(double),Node.prefWidth(double),Node.prefHeight(double),Node.maxWidth(double),Node.maxHeight(double)
-
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
-
getRowCount
public final int getRowCount()
Возвращает количество строк в этом GridPane.- Возвращает:
- количество строк
- С:
- 9
-
getColumnCount
public final int getColumnCount()
Возвращает количество столбцов в этом GridPane.- Возвращает:
- количество столбцов
- С:
- 9
-
getCellBounds
public final Bounds getCellBounds(int columnIndex, int rowIndex)
Возвращает границы ячейки в указанной позиции столбца и строки.- Параметры:
-
columnIndex- индекс столбца для позиции ячейки в этом GridPane, считая с 0 -
rowIndex- индекс строки для позиции ячейки в этом GridPane, считая с 0 - Возвращает:
- границы ячейки в columnIndex и rowIndex.
- С:
- 9
-
© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.