Класс RowConstraints

java.lang.Object

javafx.scene.layout.ConstraintsBase

javafx.scene.layout.RowConstraints

public class RowConstraints extends ConstraintsBase

Определяет необязательные ограничения макета для строки в GridPane. Если для строки в gridpane добавлен объект RowConstraints, gridpane будет использовать эти значения ограничений при вычислении высоты и макета строки.

Например, чтобы создать GridPane с 10 строками высотой 50 пикселей:


     GridPane gridpane = new GridPane();
     for (int i = 0; i < 10; i++) {
         RowConstraints row = new RowConstraints(50);
         gridpane.getRowConstraints().add(row);
     }

Или, чтобы создать GridPane, где строки занимают 25%, 50%, 25% его высоты:


     GridPane gridpane = new GridPane();
     RowConstraints row1 = new RowConstraints();
     row1.setPercentHeight(25);
     RowConstraints row2 = new RowConstraints();
     row2.setPercentHeight(50);
     RowConstraints row3 = new RowConstraints();
     row3.setPercentHeight(25);
     gridpane.getRowConstraints().addAll(row1,row2,row3);

Обратите внимание, что добавление пустого объекта RowConstraints эквивалентно отсутствию ограничений, оставляя GridPane для вычисления макета строки исключительно на основе предпочтений размера и ограничений содержимого.

Since:: JavaFX 2.0

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

Тип	Свойство	Описание
`final BooleanProperty`	`fillHeight`	Политика вертикального заполнения строки.
`final DoubleProperty`	`maxHeight`	Максимальная высота строки.
`final DoubleProperty`	`minHeight`	Минимальная высота строки.
`final DoubleProperty`	`percentHeight`	Процентная высота строки.
`final DoubleProperty`	`prefHeight`	Предпочитаемая высота строки.
`final ObjectProperty<VPos>`	`valignment`	Вертикальное выравнивание для строки.
`final ObjectProperty<Priority>`	`vgrow`	Приоритет вертикального роста для строки.

Краткое описание полей

Поля, объявленные в классе javafx.scene.layout.ConstraintsBase

CONSTRAIN_TO_PREF

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

Конструктор	Описание
`RowConstraints()`	Создает объект ограничений строки без заданных свойств.
`RowConstraints(double height)`	Создает объект ограничения строки с фиксированной высотой.
`RowConstraints(double minHeight, double prefHeight, double maxHeight)`	Создаёт объект ограничения строки с фиксированным диапазоном размеров.
`RowConstraints(double minHeight, double prefHeight, double maxHeight, Priority vgrow, VPos valignment, boolean fillHeight)`	Создаёт объект ограничения строки с фиксированным диапазоном размеров, приоритетом вертикального роста, вертикальным выравниванием и поведением вертикального заполнения.

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

Модификатор и тип	Метод	Описание
`final BooleanProperty`	`fillHeightProperty()`	Политика вертикального заполнения строки.
`final double`	`getMaxHeight()`	Получает значение свойства `maxHeight`.
`final double`	`getMinHeight()`	Получает значение свойства `minHeight`.
`final double`	`getPercentHeight()`	Получает значение свойства `percentHeight`.
`final double`	`getPrefHeight()`	Получает значение свойства `prefHeight`.
`final VPos`	`getValignment()`	Получает значение свойства `valignment`.
`final Priority`	`getVgrow()`	Получает значение свойства `vgrow`.
`final boolean`	`isFillHeight()`	Получает значение свойства `fillHeight`.
`final DoubleProperty`	`maxHeightProperty()`	Максимальная высота строки.
`final DoubleProperty`	`minHeightProperty()`	Минимальная высота строки.
`final DoubleProperty`	`percentHeightProperty()`	Процентная высота строки.
`final DoubleProperty`	`prefHeightProperty()`	Предпочитаемая высота строки.
`final void`	`setFillHeight(boolean value)`	Устанавливает значение свойства `fillHeight`.
`final void`	`setMaxHeight(double value)`	Устанавливает значение свойства `maxHeight`.
`final void`	`setMinHeight(double value)`	Устанавливает значение свойства `minHeight`.
`final void`	`setPercentHeight(double value)`	Устанавливает значение свойства `percentHeight`.
`final void`	`setPrefHeight(double value)`	Устанавливает значение свойства `prefHeight`.
`final void`	`setValignment(VPos value)`	Устанавливает значение свойства `valignment`.
`final void`	`setVgrow(Priority value)`	Устанавливает значение свойства `vgrow`.
`String`	`toString()`	Возвращает строковое представление этого объекта `RowConstraints`.
`final ObjectProperty<VPos>`	`valignmentProperty()`	Вертикальное выравнивание для строки.
`final ObjectProperty<Priority>`	`vgrowProperty()`	Приоритет вертикального роста для строки.

Методы, объявленные в классе javafx.scene.layout.ConstraintsBase

requestLayout

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

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

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

minHeight

public final DoubleProperty minHeightProperty

Минимальная высота строки. Это свойство игнорируется, если установлено percentHeight.

Значение по умолчанию — USE_COMPUTED_SIZE, что означает, что минимальная высота будет вычислена как наибольшая минимальная высота содержимого строки.

См. также:

prefHeight

public final DoubleProperty prefHeightProperty

Предпочтительная высота строки. Это свойство игнорируется, если установлено percentHeight.

Значение по умолчанию — USE_COMPUTED_SIZE, что означает, что предпочтительная высота будет вычислена как наибольшая предпочтительная высота содержимого строки.

См. также:

maxHeight

public final DoubleProperty maxHeightProperty

Максимальная высота строки. Это свойство игнорируется, если установлено percentHeight.

Значение по умолчанию — USE_COMPUTED_SIZE, что означает, что максимальная высота будет вычислена как наименьшая максимальная высота содержимого строки.

См. также:

percentHeight

public final DoubleProperty percentHeightProperty

Процентная высота строки. Если задано значение больше 0, строка будет пересчитана на этот процент от доступной высоты gridpane, и другие ограничения размера (minHeight, prefHeight, maxHeight, vgrow) будут проигнорированы. Значение по умолчанию — -1, что означает, что процент будет проигнорирован.

См. также:

vgrow

public final ObjectProperty<Priority> vgrowProperty

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

Значение по умолчанию — null, что означает, что приоритет увеличения строки будет получен из наибольшего приоритета увеличения, установленного на узле содержимого.

См. также:

valignment

public final ObjectProperty<VPos> valignmentProperty

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

См. также:

fillHeight

public final BooleanProperty fillHeightProperty

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

Значение по умолчанию — true.

См. также:

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

RowConstraints

public RowConstraints()

Создаёт объект ограничений строки без установленных свойств.

RowConstraints

public RowConstraints(double height)

Создаёт объект ограничения строки с фиксированной высотой. Это удобный способ установить ограничение предпочтительной высоты на фиксированное значение и ограничения minHeight и maxHeight на флаг USE_PREF_SIZE, чтобы гарантировать, что высота строки всегда будет такой.

Параметры:: height - высота строки

RowConstraints

public RowConstraints(double minHeight, double prefHeight, double maxHeight)

Создаёт объект ограничения строки с фиксированным диапазоном размеров. Это удобный способ установить ограничения минимальной, предпочтительной и максимальной высоты.

Параметры:: minHeight - минимальная высота; prefHeight - предпочтительная высота; maxHeight - максимальная высота

RowConstraints

public RowConstraints(double minHeight, double prefHeight, double maxHeight, Priority vgrow, VPos valignment, boolean fillHeight)

Создаёт объект ограничения строки с фиксированным диапазоном размеров, приоритетом вертикального увеличения, вертикальным выравниванием и поведением вертикального заполнения.

Параметры:: minHeight - минимальная высота; prefHeight - предпочтительная высота; maxHeight - максимальная высота; vgrow - приоритет вертикального увеличения; valignment - вертикальное выравнивание; fillHeight - поведение вертикального заполнения

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

setMinHeight

public final void setMinHeight(double value)

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

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

Минимальная высота строки. Это свойство игнорируется, если установлено percentHeight.

Параметры:

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

См. также:

getMinHeight

public final double getMinHeight()

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

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

Минимальная высота строки. Это свойство игнорируется, если установлено percentHeight.

Возвращает:

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

См. также:

minHeightProperty

public final DoubleProperty minHeightProperty()

Минимальная высота строки. Это свойство игнорируется, если установлено percentHeight.

Возвращает:

свойство minHeight

См. также:

setPrefHeight

public final void setPrefHeight(double value)

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

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

Предпочтительная высота строки. Это свойство игнорируется, если установлено percentHeight.

Параметры:

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

См. также:

getPrefHeight

public final double getPrefHeight()

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

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

Предпочтительная высота строки. Это свойство игнорируется, если установлено percentHeight.

Возвращает:

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

См. также:

prefHeightProperty

public final DoubleProperty prefHeightProperty()

Предпочтительная высота строки. Это свойство игнорируется, если задан percentHeight.

Возвращает:

свойство prefHeight

См. также:

setMaxHeight

public final void setMaxHeight(double value)

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

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

Максимальная высота строки. Это свойство игнорируется, если задан percentHeight.

Параметры:

value — значение для свойства maxHeight

См. также:

getMaxHeight

public final double getMaxHeight()

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

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

Максимальная высота строки. Это свойство игнорируется, если задан percentHeight.

Возвращает:

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

См. также:

maxHeightProperty

public final DoubleProperty maxHeightProperty()

Максимальная высота строки. Это свойство игнорируется, если задан percentHeight.

Возвращает:

свойство maxHeight

См. также:

setPercentHeight

public final void setPercentHeight(double value)

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

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

Процентная высота строки. Если задано значение больше 0, строка будет переразмерены до этого процента доступной высоты gridpane, а другие ограничения размера (minHeight, prefHeight, maxHeight, vgrow) будут проигнорированы. Значение по умолчанию — -1, что означает, что процент будет проигнорирован.

Параметры:

value — значение для свойства percentHeight

См. также:

getPercentHeight

public final double getPercentHeight()

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

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

Возвращает:

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

См. также:

percentHeightProperty

public final DoubleProperty percentHeightProperty()

Возвращает:

свойство percentHeight

См. также:

setVgrow

public final void setVgrow(Priority value)

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

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

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

Значение по умолчанию — null, что означает, что приоритет роста строки будет получен из наибольшего приоритета роста узла содержимого.

Параметры:

value — значение для свойства vgrow

См. также:

getVgrow

public final Priority getVgrow()

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

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

Возвращает:

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

См. также:

vgrowProperty

public final ObjectProperty<Priority> vgrowProperty()

Возвращает:

свойство vgrow

См. также:

setValignment

public final void setValignment(VPos value)

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

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

Вертикальное выравнивание строки. Если задано, будет являться стандартным вертикальным выравниванием для узлов, содержащихся в строке. Если это свойство установлено в VPos.BASELINE, свойство fillHeight будет проигнорировано, и узлы всегда будут переразмерены до их предпочтительных высот.

Параметры:

value — значение для свойства valignment

См. также:

getValignment

public final VPos getValignment()

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

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

Возвращает:

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

См. также:

valignmentProperty

public final ObjectProperty<VPos> valignmentProperty()

Возвращает:

свойство valignment

См. также:

setFillHeight

public final void setFillHeight(boolean value)

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

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

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

Значение по умолчанию — true.

Параметры:

value — значение для свойства fillHeight

См. также:

isFillHeight

public final boolean isFillHeight()

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

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

Вертикальная политика заполнения для строки. Gridpane будет использовать это свойство для определения, должны ли узлы, содержащиеся в строке, расширяться для заполнения высоты строки или сохранять свои предпочтительные высоты.

Значение по умолчанию — true.

Возвращает:

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

См. также:

fillHeightProperty

public final BooleanProperty fillHeightProperty()

Значение по умолчанию — true.

Возвращает:

свойство fillHeight

См. также:

toString

public String toString()

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

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

© 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.