Класс ColumnConstraints

java.lang.Object

javafx.scene.layout.ConstraintsBase

javafx.scene.layout.ColumnConstraints

public class ColumnConstraints
extends ConstraintsBase

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

Например, чтобы создать GridPane с 5 столбцами шириной 100 пикселей:


     GridPane gridpane = new GridPane();
     for (int i = 0; i < 5; i++) {
         ColumnConstraints column = new ColumnConstraints(100);
         gridpane.getColumnConstraints().add(column);
     }

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


     GridPane gridpane = new GridPane();
     ColumnConstraints col1 = new ColumnConstraints();
     col1.setPercentWidth(25);
     ColumnConstraints col2 = new ColumnConstraints();
     col2.setPercentWidth(50);
     ColumnConstraints col3 = new ColumnConstraints();
     col3.setPercentWidth(25);
     gridpane.getColumnConstraints().addAll(col1,col2,col3);

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

С:: JavaFX 2.0

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

Свойства
Тип	Свойство	Описание
`BooleanProperty`	`fillWidth`	Политика горизонтального заполнения для столбца.
`ObjectProperty<HPos>`	`halignment`	Горизонтальное выравнивание для столбца.
`ObjectProperty<Priority>`	`hgrow`	Горизонтальный приоритет увеличения для столбца.
`DoubleProperty`	`maxWidth`	Максимальная ширина для столбца.
`DoubleProperty`	`minWidth`	Минимальная ширина для столбца.
`DoubleProperty`	`percentWidth`	Процент ширины столбца.
`DoubleProperty`	`prefWidth`	Предпочтительная ширина для столбца.

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

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

CONSTRAIN_TO_PREF

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

Конструкторы
Конструктор	Описание
`ColumnConstraints()`	Создать объект ограничения столбца без установки свойств.
`ColumnConstraints(double width)`	Создает объект ограничения столбца с фиксированной шириной.
`ColumnConstraints(double minWidth, double prefWidth, double maxWidth)`	Создает объект ограничения столбца с фиксированным диапазоном размеров.
`ColumnConstraints(double minWidth, double prefWidth, double maxWidth, Priority hgrow, HPos halignment, boolean fillWidth)`	Создает объект ограничения столбца с фиксированным диапазоном размеров, приоритетом горизонтального увеличения, горизонтальным выравниванием и поведением горизонтального заполнения.

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

Модификатор и тип	Метод	Описание
`BooleanProperty`	`fillWidthProperty()`	Политика горизонтального заполнения для столбца.
`HPos`	`getHalignment()`	Получает значение свойства halignment.
`Priority`	`getHgrow()`	Получает значение свойства hgrow.
`double`	`getMaxWidth()`	Получает значение свойства maxWidth.
`double`	`getMinWidth()`	Получает значение свойства minWidth.
`double`	`getPercentWidth()`	Получает значение свойства percentWidth.
`double`	`getPrefWidth()`	Получает значение свойства prefWidth.
`ObjectProperty<HPos>`	`halignmentProperty()`	Горизонтальное выравнивание для столбца.
`ObjectProperty<Priority>`	`hgrowProperty()`	Горизонтальный приоритет увеличения для столбца.
`boolean`	`isFillWidth()`	Получает значение свойства fillWidth.
`DoubleProperty`	`maxWidthProperty()`	Максимальная ширина для столбца.
`DoubleProperty`	`minWidthProperty()`	Минимальная ширина для столбца.
`DoubleProperty`	`percentWidthProperty()`	Процент ширины столбца.
`DoubleProperty`	`prefWidthProperty()`	Предпочтительная ширина для столбца.
`void`	`setFillWidth(boolean value)`	Задает значение свойства fillWidth.
`void`	`setHalignment(HPos value)`	Задает значение свойства halignment.
`void`	`setHgrow(Priority value)`	Задает значение свойства hgrow.
`void`	`setMaxWidth(double value)`	Задает значение свойства maxWidth.
`void`	`setMinWidth(double value)`	Задает значение свойства minWidth.
`void`	`setPercentWidth(double value)`	Задает значение свойства percentWidth.
`void`	`setPrefWidth(double value)`	Задает значение свойства prefWidth.
`String`	`toString()`	Возвращает строковое представление этого `ColumnConstraints` объекта.

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

requestLayout

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

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

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

minWidth

public final DoubleProperty minWidthProperty

Минимальная ширина столбца. Это свойство игнорируется, если установлено percentWidth.

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

См. также:: getMinWidth(), setMinWidth(double)

prefWidth

public final DoubleProperty prefWidthProperty

Предпочтительная ширина столбца. Это свойство игнорируется, если установлено percentWidth.

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

См. также:: getPrefWidth(), setPrefWidth(double)

maxWidth

public final DoubleProperty maxWidthProperty

Максимальная ширина столбца. Это свойство игнорируется, если установлено percentWidth.

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

См. также:: getMaxWidth(), setMaxWidth(double)

percentWidth

public final DoubleProperty percentWidthProperty

Процентная ширина столбца. Если установлено значение больше 0, столбец будет изменён на этот процент от доступной ширины gridpane, и другие ограничения размера (minWidth, prefWidth, maxWidth, hgrow) будут игнорироваться. Значение по умолчанию — -1, что означает, что процент будет игнорироваться.

См. также:: getPercentWidth(), setPercentWidth(double)

hgrow

public final ObjectProperty<Priority> hgrowProperty

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

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

См. также:: getHgrow(), setHgrow(Priority)

halignment

public final ObjectProperty<HPos> halignmentProperty

Горизонтальное выравнивание столбца. Если установлено, будет использоваться в качестве стандартного горизонтального выравнивания узлов, содержащихся в столбце.

Значение по умолчанию — null, что означает, что выравнивание столбца будет возвращено к стандартному выравниванию halignment, установленному в gridpane.

См. также:: getHalignment(), setHalignment(HPos)

fillWidth

public final BooleanProperty fillWidthProperty

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

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

См. также:: isFillWidth(), setFillWidth(boolean)

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

ColumnConstraints

public ColumnConstraints()

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

ColumnConstraints

public ColumnConstraints(double width)

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

Параметры:: width - ширина столбца

ColumnConstraints

public ColumnConstraints(double minWidth, double prefWidth, double maxWidth)

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

Параметры:: minWidth - минимальная ширина; prefWidth - предпочтительная ширина; maxWidth - максимальная ширина

ColumnConstraints

public ColumnConstraints(double minWidth, double prefWidth, double maxWidth, Priority hgrow, HPos halignment, boolean fillWidth)

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

Параметры:: minWidth - минимальная ширина; prefWidth - предпочтительная ширина; maxWidth - максимальная ширина; hgrow - приоритет горизонтального увеличения; halignment - горизонтальное выравнивание; fillWidth - горизонтальное поведение заполнения

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

setMinWidth

public final void setMinWidth(double value)

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

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

getMinWidth

public final double getMinWidth()

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

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

minWidthProperty

public final DoubleProperty minWidthProperty()

Минимальная ширина столбца. Это свойство игнорируется, если установлено percentWidth.

См. также:: getMinWidth(), setMinWidth(double)

setPrefWidth

public final void setPrefWidth(double value)

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

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

getPrefWidth

public final double getPrefWidth()

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

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

prefWidthProperty

public final DoubleProperty prefWidthProperty()

Предпочтительная ширина столбца. Это свойство игнорируется, если установлено percentWidth.

См. также:: getPrefWidth(), setPrefWidth(double)

setMaxWidth

public final void setMaxWidth(double value)

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

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

getMaxWidth

public final double getMaxWidth()

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

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

maxWidthProperty

public final DoubleProperty maxWidthProperty()

Максимальная ширина столбца. Это свойство игнорируется, если установлено percentWidth.

См. также:: getMaxWidth(), setMaxWidth(double)

setPercentWidth

public final void setPercentWidth(double value)

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

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

getPercentWidth

public final double getPercentWidth()

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

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

percentWidthProperty

public final DoubleProperty percentWidthProperty()

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

См. также:: getPercentWidth(), setPercentWidth(double)

setHgrow

public final void setHgrow(Priority value)

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

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

getHgrow

public final Priority getHgrow()

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

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

hgrowProperty

public final ObjectProperty<Priority> hgrowProperty()

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

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

См. также:: getHgrow(), setHgrow(Priority)

setHalignment

public final void setHalignment(HPos value)

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

Описание свойства:: Горизонтальное выравнивание для колонки. Если установлено, станет стандартным горизонтальным выравниванием для узлов, содержащихся в колонке.
Значение по умолчанию null, что означает, что выравнивание колонки будет сведено к стандартному halignment, установленному в gridpane.

getHalignment

public final HPos getHalignment()

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

Описание свойства:: Горизонтальное выравнивание для колонки. Если установлено, станет стандартным горизонтальным выравниванием для узлов, содержащихся в колонке.
Значение по умолчанию null, что означает, что выравнивание колонки будет сведено к стандартному halignment, установленному в gridpane.

halignmentProperty

public final ObjectProperty<HPos> halignmentProperty()

Горизонтальное выравнивание для колонки. Если установлено, станет стандартным горизонтальным выравниванием для узлов, содержащихся в колонке.

Значение по умолчанию null, что означает, что выравнивание колонки будет сведено к стандартному halignment, установленному в gridpane.

См. также:: getHalignment(), setHalignment(HPos)

setFillWidth

public final void setFillWidth(boolean value)

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

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

isFillWidth

public final boolean isFillWidth()

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

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

fillWidthProperty

public final BooleanProperty fillWidthProperty()

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

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

См. также:: isFillWidth(), setFillWidth(boolean)

toString

public String toString()

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

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

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