Class RowConstraints

java.lang.Object

javafx.scene.layout.ConstraintsBase

javafx.scene.layout.RowConstraints

public class RowConstraints
extends ConstraintsBase

Defines optional layout constraints for a row in a GridPane. If a RowConstraints object is added for a row in a gridpane, the gridpane will use those constraint values when computing the row's height and layout.

For example, to create a GridPane with 10 rows 50 pixels tall:


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

Or, to create a GridPane where rows take 25%, 50%, 25% of its height:


     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);

Note that adding an empty RowConstraints object has the effect of not setting any constraints, leaving the GridPane to compute the row's layout based solely on its content's size preferences and constraints.

Since:: JavaFX 2.0

Сводка свойств

Свойства
Тип	Свойство	Описание
`BooleanProperty`	`fillHeight`	Политика вертикального заполнения для строки.
`DoubleProperty`	`maxHeight`	Максимальная высота для строки.
`DoubleProperty`	`minHeight`	Минимальная высота для строки.
`DoubleProperty`	`percentHeight`	Процент высоты строки.
`DoubleProperty`	`prefHeight`	Предпочтительная высота для строки.
`ObjectProperty<VPos>`	`valignment`	Вертикальное выравнивание для строки.
`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)`	Создает объект ограничения строки с фиксированным диапазоном размеров, приоритетом вертикального увеличения, вертикальным выравниванием и поведением вертикального заполнения.

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

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

См. также:: getMinHeight(), setMinHeight(double)

prefHeight

public final DoubleProperty prefHeightProperty

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

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

См. также:: getPrefHeight(), setPrefHeight(double)

maxHeight

public final DoubleProperty maxHeightProperty

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

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

См. также:: getMaxHeight(), setMaxHeight(double)

percentHeight

public final DoubleProperty percentHeightProperty

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

См. также:: getPercentHeight(), setPercentHeight(double)

vgrow

public final ObjectProperty<Priority> vgrowProperty

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

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

См. также:: getVgrow(), setVgrow(Priority)

valignment

public final ObjectProperty<VPos> valignmentProperty

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

См. также:: getValignment(), setValignment(VPos)

fillHeight

public final BooleanProperty fillHeightProperty

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

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

См. также:: isFillHeight(), setFillHeight(boolean)

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

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.
Значение по умолчанию — USE_COMPUTED_SIZE, что означает, что минимальная высота будет вычислена как наибольшая минимальная высота содержимого строки.

getMinHeight

public final double getMinHeight()

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

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

minHeightProperty

public final DoubleProperty minHeightProperty()

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

См. также:: getMinHeight(), setMinHeight(double)

setPrefHeight

public final void setPrefHeight(double value)

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

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

getPrefHeight

public final double getPrefHeight()

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

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

prefHeightProperty

public final DoubleProperty prefHeightProperty()

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

См. также:: getPrefHeight(), setPrefHeight(double)

setMaxHeight

public final void setMaxHeight(double value)

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

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

getMaxHeight

public final double getMaxHeight()

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

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

maxHeightProperty

public final DoubleProperty maxHeightProperty()

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

См. также:: getMaxHeight(), setMaxHeight(double)

setPercentHeight

public final void setPercentHeight(double value)

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

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

getPercentHeight

public final double getPercentHeight()

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

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

percentHeightСвойство

public final DoubleProperty percentHeightProperty()

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

См. также:: getPercentHeight(), setPercentHeight(double)

setVgrow

public final void setVgrow(Priority value)

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

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

getVgrow

public final Priority getVgrow()

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

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

vgrowСвойство

public final ObjectProperty<Priority> vgrowProperty()

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

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

См. также:: getVgrow(), setVgrow(Priority)

setValignment

public final void setValignment(VPos value)

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

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

getValignment

public final VPos getValignment()

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

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

valignmentСвойство

public final ObjectProperty<VPos> valignmentProperty()

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

См. также:: getValignment(), setValignment(VPos)

setFillHeight

public final void setFillHeight(boolean value)

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

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

isFillHeight

public final boolean isFillHeight()

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

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

fillHeightСвойство

public final BooleanProperty fillHeightProperty()

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

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

См. также:: isFillHeight(), setFillHeight(boolean)

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.