Spec-Zone.ru › OpenJavaFX 8
javafx.scene.layout

Класс GridPane

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 и/или padding, то содержимое будет выстроено в этих отступах.

Элемент может быть размещен в любом месте сетки и может занимать несколько строк/столбцов. Элементы могут свободно перекрываться в строках/столбцах, а их порядок следования будет определяться порядком в списке дочерних элементов 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.
    BooleanProperty gridLinesVisible
    Только для отладки: управляет отображением линий для отображения строк и столбцов gridpane.
    DoubleProperty hgap
    Ширина горизонтальных промежутков между столбцами.
    DoubleProperty vgap
    Высота вертикальных промежутков между строками.
    • Свойства, унаследованные от класса javafx.scene.layout.Region

      background, border, cacheShape, centerShape, height, insets, maxHeight, maxWidth, minHeight, minWidth, opaqueInsets, padding, prefHeight, prefWidth, scaleShape, shape, snapToPixel, width
    • Свойства, унаследованные от класса javafx.scene.Parent

      needsLayout
    • Свойства, унаследованные от класса javafx.scene.Node

      accessibleHelp, accessibleRoleDescription, accessibleRole, accessibleText, blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, visible
  • Краткое описание полей

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

      USE_COMPUTED_SIZE, USE_PREF_SIZE
    • Поля, унаследованные от класса javafx.scene.Node

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

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

    Все методыСтатические методыМетоды экземпляраКонкретные методы
    Модификатор и тип Метод и описание
    void add(Node child, int columnIndex, int rowIndex)
    Добавляет дочерний элемент в сетку на указанные позиции столбца и строки.
    void add(Node child, int columnIndex, int rowIndex, int colspan, int rowspan)
    Добавляет дочерний элемент в сетку на указанные позиции столбца, строки и охватывает указанные позиции.
    void addColumn(int columnIndex, Node... children)
    Удобный метод для последовательного размещения указанных узлов в заданном столбце сетки.
    void addRow(int rowIndex, Node... children)
    Удобный метод для последовательного размещения указанных узлов в заданной строке сетки.
    ObjectProperty<Pos> alignmentProperty()
    Выравнивание сетки по ширине и высоте сетки.
    static void clearConstraints(Node child)
    Удаляет все ограничения сетки от дочернего узла.
    protected double computeMinHeight(double width)
    Вычисляет минимальную высоту данного региона.
    protected double computeMinWidth(double height)
    Вычисляет минимальную ширину данного региона.
    protected double computePrefHeight(double width)
    Вычисляет предпочтительную высоту данного региона для заданной ширины; Подклассы Region должны переопределять этот метод, чтобы возвращать соответствующее значение, основанное на их содержимом и стратегии макета.
    protected double computePrefWidth(double height)
    Вычисляет предпочтительную ширину данного региона для заданной высоты.
    Pos getAlignment()
    Получает значение свойства выравнивания.
    static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
    ObservableList<ColumnConstraints> getColumnConstraints()
    Возвращает список ограничений столбцов.
    static Integer getColumnIndex(Node child)
    Возвращает ограничение индекса столбца дочернего элемента, если оно задано.
    static Integer getColumnSpan(Node child)
    Возвращает ограничение размаха столбца дочернего элемента, если оно задано.
    Orientation getContentBias()
    Возвращает ориентацию смещения изменения размера узла для целей макета.
    List<CssMetaData<? extends Styleable,?>> getCssMetaData()
    Этот метод должен делегировать Node.getClassCssMetaData(), чтобы можно было получить доступ к CssMetaData узла без необходимости в рефлексии.
    static HPos getHalignment(Node child)
    Возвращает ограничение выравнивания по горизонтали дочернего элемента, если оно задано.
    double getHgap()
    Получает значение свойства hgap.
    static Priority getHgrow(Node child)
    Возвращает ограничение расширения по горизонтали дочернего элемента, если оно задано.
    static Insets getMargin(Node child)
    Возвращает ограничение отступа дочернего элемента, если оно задано.
    ObservableList<RowConstraints> getRowConstraints()
    Возвращает список ограничений строк.
    static Integer getRowIndex(Node child)
    Возвращает ограничение индекса строки дочернего элемента, если оно задано.
    static Integer getRowSpan(Node child)
    Возвращает ограничение размаха строки дочернего элемента, если оно задано.
    static VPos getValignment(Node child)
    Возвращает ограничение выравнивания по вертикали дочернего элемента, если оно задано.
    double getVgap()
    Получает значение свойства vgap.
    static Priority getVgrow(Node child)
    Возвращает ограничение расширения по вертикали дочернего элемента, если оно задано.
    BooleanProperty gridLinesVisibleProperty()
    Только для отладки: управляет отображением линий для отображения строк и столбцов сетки.
    DoubleProperty hgapProperty()
    Ширина горизонтальных отступов между столбцами.
    static Boolean isFillHeight(Node child)
    Возвращает политику заполнения по вертикали дочернего элемента, если она задана.
    static Boolean isFillWidth(Node child)
    Возвращает политику заполнения по горизонтали дочернего элемента, если она задана.
    boolean isGridLinesVisible()
    Получает значение свойства gridLinesVisible.
    protected void layoutChildren()
    Вызывается во время прохода макета для выравнивания дочерних элементов в этой Parent.
    void requestLayout()
    Запрашивает проход макета, который будет выполнен перед рендерингом следующей сцены.
    void setAlignment(Pos value)
    Устанавливает значение свойства выравнивания.
    static void setColumnIndex(Node child, Integer value)
    Устанавливает индекс столбца для дочернего элемента, когда он содержится в сетке, так что он будет расположен, начиная со столбца сетки.
    static void setColumnSpan(Node child, Integer value)
    Устанавливает размах столбца для дочернего элемента, когда он содержится в сетке, так что он будет занимать это количество столбцов по горизонтали.
    static void setConstraints(Node child, int columnIndex, int rowIndex)
    Устанавливает индексы столбца и строки для дочернего элемента, когда он содержится в сетке.
    static void setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan)
    Устанавливает значения столбца, строки, размаха столбца и размаха строки для дочернего элемента, когда он содержится в сетке.
    static void setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment)
    Устанавливает позицию сетки, размахи и выравнивание для дочернего элемента, когда он содержится в сетке.
    static void setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment, Priority hgrow, Priority vgrow)
    Устанавливает позицию сетки, размахи и выравнивание для дочернего элемента, когда он содержится в сетке.
    static void setConstraints(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment, Priority hgrow, Priority vgrow, Insets margin)
    Устанавливает позицию сетки, размахи, выравнивание, приоритеты расширения и отступ для дочернего элемента, когда он содержится в сетке.
    static void setFillHeight(Node child, Boolean value)
    Устанавливает политику заполнения по вертикали для дочернего элемента, когда он содержится в сетке.
    static void setFillWidth(Node child, Boolean value)
    Устанавливает политику заполнения по горизонтали для дочернего элемента, когда он содержится в сетке.
    void setGridLinesVisible(boolean value)
    Устанавливает значение свойства gridLinesVisible.
    static void setHalignment(Node child, HPos value)
    Устанавливает выравнивание по горизонтали для дочернего элемента, когда он содержится в сетке.
    void setHgap(double value)
    Устанавливает значение свойства hgap.
    static void setHgrow(Node child, Priority value)
    Устанавливает приоритет расширения по горизонтали для дочернего элемента, когда он содержится в сетке.
    static void setMargin(Node child, Insets value)
    Устанавливает отступ для дочернего элемента, когда он содержится в сетке.
    static void setRowIndex(Node child, Integer value)
    Устанавливает индекс строки для дочернего элемента, когда он содержится в сетке, так что он будет расположен, начиная со строки сетки.
    static void setRowSpan(Node child, Integer value)
    Устанавливает размах строки для дочернего элемента, когда он содержится в сетке, так что он будет занимать это количество строк по вертикали.
    static void setValignment(Node child, VPos value)
    Устанавливает выравнивание по вертикали для дочернего элемента, когда он содержится в сетке.
    void setVgap(double value)
    Устанавливает значение свойства vgap.
    static void setVgrow(Node child, Priority value)
    Устанавливает приоритет расширения по вертикали для дочернего элемента, когда он содержится в сетке.
    String toString()
    Возвращает строковое представление этого GridPane объекта.
    DoubleProperty vgapProperty()
    Высота вертикальных отступов между строками.
    • Методы, унаследованные от класса 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
    • Методы, унаследованные от класса java.lang.Object

      clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
  • Подробное описание свойств

    • hgap

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

      См. также:

      getHgap(), setHgap(double)

    • vgap

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

      См. также:

      getVgap(), setVgap(double)

    • alignment

      public final ObjectProperty<Pos> alignmentProperty
      Выравнивание сетки по ширине и высоте GridPane.

      См. также:

      getAlignment(), setAlignment(Pos)

    • gridLinesVisible

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

      См. также:

      isGridLinesVisible(), setGridLinesVisible(boolean)

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

    • REMAINING

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

      См. также:

      Значения константных полей

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

    • GridPane

      public GridPane()
      Создаёт макет GridPane с hgap/vgap = 0 и выравниванием TOP_LEFT.
  • Подробное описание методов

    • setRowIndex

      public static void setRowIndex(Node child,
                                     Integer value)
      Устанавливает индекс строки для дочернего элемента, когда он находится внутри gridpane, чтобы он позиционировался, начиная с этой строки в gridpane. Если у дочернего элемента gridpane нет заданного индекса строки, он будет размещён в первой строке. Установка значения в null удалит ограничение.

      Параметры:

      child - дочерний узел gridpane

    • 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()
      Ширина горизонтальных промежутков между столбцами.

      См. также:

      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

    • 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, если ни один из его дочерних элементов не имеет уклона содержимого.

      См. также:

      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 объекта.

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

      toString в классе Node

      Возвращает:

      строковое представление этого 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API