Класс ColumnConstraints

java.lang.Object

javafx.scene.layout.ConstraintsBase

javafx.scene.layout.ColumnConstraints

public class ColumnConstraints extends ConstraintsBase

Определяет необязательные параметры макета для столбца в GridPane. Если объект ColumnConstraints добавлен для столбца в gridpane, 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 вычислять макет столбца, основываясь только на предпочтениях размера и ограничениях содержимого.

Since:: JavaFX 2.0

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

Тип	Свойство	Описание
`final BooleanProperty`	`fillWidth`	Политика заполнения по горизонтали для столбца.
`final ObjectProperty<HPos>`	`halignment`	Горизонтальное выравнивание для столбца.
`final ObjectProperty<Priority>`	`hgrow`	Приоритет горизонтального роста для столбца.
`final DoubleProperty`	`maxWidth`	Максимальная ширина для столбца.
`final DoubleProperty`	`minWidth`	Минимальная ширина для столбца.
`final DoubleProperty`	`percentWidth`	Процентная ширина столбца.
`final 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)`	Создаёт объект ограничения столбца с фиксированным диапазоном размеров, приоритетом горизонтального роста, горизонтальным выравниванием и поведением горизонтального заполнения.

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

Модификатор и тип	Метод	Описание
`final BooleanProperty`	`fillWidthProperty()`	Политика заполнения по горизонтали для столбца.
`final HPos`	`getHalignment()`	Получает значение свойства `halignment`.
`final Priority`	`getHgrow()`	Получает значение свойства `hgrow`.
`final double`	`getMaxWidth()`	Получает значение свойства `maxWidth`.
`final double`	`getMinWidth()`	Получает значение свойства `minWidth`.
`final double`	`getPercentWidth()`	Получает значение свойства `percentWidth`.
`final double`	`getPrefWidth()`	Получает значение свойства `prefWidth`.
`final ObjectProperty<HPos>`	`halignmentProperty()`	Горизонтальное выравнивание для столбца.
`final ObjectProperty<Priority>`	`hgrowProperty()`	Приоритет горизонтального роста для столбца.
`final boolean`	`isFillWidth()`	Получает значение свойства `fillWidth`.
`final DoubleProperty`	`maxWidthProperty()`	Максимальная ширина для столбца.
`final DoubleProperty`	`minWidthProperty()`	Минимальная ширина для столбца.
`final DoubleProperty`	`percentWidthProperty()`	Процентная ширина столбца.
`final DoubleProperty`	`prefWidthProperty()`	Предпочтительная ширина для столбца.
`final void`	`setFillWidth(boolean value)`	Устанавливает значение свойства `fillWidth`.
`final void`	`setHalignment(HPos value)`	Устанавливает значение свойства `halignment`.
`final void`	`setHgrow(Priority value)`	Устанавливает значение свойства `hgrow`.
`final void`	`setMaxWidth(double value)`	Устанавливает значение свойства `maxWidth`.
`final void`	`setMinWidth(double value)`	Устанавливает значение свойства `minWidth`.
`final void`	`setPercentWidth(double value)`	Устанавливает значение свойства `percentWidth`.
`final 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, что означает, что минимальная ширина будет вычислена как наибольшая минимальная ширина содержимого столбца.

См. также:

prefWidth

public final DoubleProperty prefWidthProperty

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

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

См. также:

maxWidth

public final DoubleProperty maxWidthProperty

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

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

См. также:

percentWidth

public final DoubleProperty percentWidthProperty

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

См. также:

hgrow

public final ObjectProperty<Priority> hgrowProperty

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

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

См. также:

halignment

public final ObjectProperty<HPos> halignmentProperty

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

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

См. также:

fillWidth

public final BooleanProperty fillWidthProperty

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

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

См. также:

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

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.

Параметры:

value - значение свойства minWidth

См. также:

getMinWidth

public final double getMinWidth()

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

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

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

Возвращает:

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

См. также:

minWidthProperty

public final DoubleProperty minWidthProperty()

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

Возвращает:

свойство minWidth

См. также:

setPrefWidth

public final void setPrefWidth(double value)

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

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

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

Параметры:

value - значение свойства prefWidth

См. также:

getPrefWidth

public final double getPrefWidth()

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

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

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

Возвращает:

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

См. также:

prefWidthProperty

public final DoubleProperty prefWidthProperty()

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

Возвращает:

свойство prefWidth

См. также:

setMaxWidth

public final void setMaxWidth(double value)

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

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

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

Параметры:

value - значение свойства maxWidth

См. также:

getMaxWidth

public final double getMaxWidth()

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

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

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

Возвращает:

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

См. также:

maxWidthProperty

public final DoubleProperty maxWidthProperty()

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

Возвращает:

свойство maxWidth

См. также:

setPercentWidth

public final void setPercentWidth(double value)

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

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

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

Параметры:

value - значение свойства percentWidth

См. также:

getPercentWidth

public final double getPercentWidth()

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

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

Возвращает:

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

См. также:

percentWidthProperty

public final DoubleProperty percentWidthProperty()

Возвращает:

свойство percentWidth

См. также:

setHgrow

public final void setHgrow(Priority value)

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

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

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

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

Параметры:

value - значение свойства hgrow

См. также:

getHgrow

public final Priority getHgrow()

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

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

Возвращает:

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

См. также:

hgrowProperty

public final ObjectProperty<Priority> hgrowProperty()

Возвращает:

свойство hgrow

См. также:

setHalignment

public final void setHalignment(HPos value)

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

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

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

Параметры:

value - значение свойства halignment

См. также:

getHalignment

public final HPos getHalignment()

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

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

Возвращает:

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

См. также:

halignmentProperty

public final ObjectProperty<HPos> halignmentProperty()

Возвращает:

свойство halignment

См. также:

setFillWidth

public final void setFillWidth(boolean value)

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

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

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

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

Параметры:

value - значение свойства fillWidth

См. также:

isFillWidth

public final boolean isFillWidth()

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

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

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

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

Возвращает:

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

См. также:

fillWidthProperty

public final BooleanProperty fillWidthProperty()

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

Возвращает:

свойство fillWidth

См. также:

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.