Spec-Zone.ru › OpenJavaFX 21

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

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

prefWidth

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

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

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

maxWidth

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

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

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

percentWidth

public final DoubleProperty percentWidthProperty
Процентная ширина столбца. Если установлено значение больше 0, столбец будет изменён на этот процент от доступной ширины гридпанели, и другие ограничения размера (minWidth, prefWidth, maxWidth, hgrow) будут проигнорированы. Значение по умолчанию — -1, что означает, что процент будет проигнорирован.
См. также:
  • getPercentWidth()
  • setPercentWidth(double)
  • percentWidthProperty()

hgrow

public final ObjectProperty<Priority> hgrowProperty
Приоритет горизонтального увеличения для столбца. Если установлено, гридпанель будет использовать этот приоритет для определения, должен ли столбец получить дополнительную ширину, если гридпанель будет больше своей предпочтительной ширины. Это свойство игнорируется, если установлено percentWidth.

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

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

halignment

public final ObjectProperty<HPos> halignmentProperty
Горизонтальное выравнивание для столбца. Если установлено, это будет стандартное горизонтальное выравнивание узлов, содержащихся в столбце.

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

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

fillWidth

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

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

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

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

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

Параметры:
value - значение для свойства minWidth
См. также:
  • getMinWidth()
  • minWidthProperty()

getMinWidth

public final double getMinWidth()
Получает значение свойства minWidth.
Описание свойства:
Минимальная ширина столбца. Это свойство игнорируется, если установлено percentWidth.

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

Возвращает:
значение свойства minWidth
См. также:
  • setMinWidth(double)
  • minWidthProperty()

minWidthProperty

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

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

Возвращает:
свойство minWidth
См. также:
  • getMinWidth()
  • setMinWidth(double)

setPrefWidth

public final void setPrefWidth(double value)
Устанавливает значение свойства prefWidth.
Описание свойства:
Предпочтительная ширина столбца. Это свойство игнорируется, если установлено percentWidth.

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

Параметры:
value - значение для свойства prefWidth
См. также:
  • getPrefWidth()
  • prefWidthProperty()

getPrefWidth

public final double getPrefWidth()
Получает значение свойства prefWidth.
Описание свойства:
Предпочтительная ширина столбца. Это свойство игнорируется, если установлено percentWidth.

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

Возвращает:
значение свойства prefWidth
См. также:
  • setPrefWidth(double)
  • prefWidthProperty()

prefWidthProperty

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

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

Возвращает:
свойство prefWidth
См. также:
  • getPrefWidth()
  • setPrefWidth(double)

УстановитьМаксимальнуюШирину

public final void setMaxWidth(double value)
Устанавливает значение свойства maxWidth.
Описание свойства:
Максимальная ширина столбца. Это свойство игнорируется, если установлено percentWidth.

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

Параметры:
value - значение для свойства maxWidth
См. также:
  • getMaxWidth()
  • maxWidthProperty()

ПолучитьМаксимальнуюШирину

public final double getMaxWidth()
Возвращает значение свойства maxWidth.
Описание свойства:
Максимальная ширина столбца. Это свойство игнорируется, если установлено percentWidth.

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

Возвращаемое значение:
значение свойства maxWidth
См. также:
  • setMaxWidth(double)
  • maxWidthProperty()

свойствоMaxWidth

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

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

Возвращаемое значение:
свойство maxWidth
См. также:
  • getMaxWidth()
  • setMaxWidth(double)

УстановитьПроцентнуюШирину

public final void setPercentWidth(double value)
Устанавливает значение свойства percentWidth.
Описание свойства:
Процентная ширина столбца. Если установлено значение больше 0, столбец будет изменён на этот процент от доступной ширины gridpane, и другие ограничения размера (minWidth, prefWidth, maxWidth, hgrow) будут проигнорированы. Значение по умолчанию - -1, что означает, что процент будет проигнорирован.
Параметры:
value - значение для свойства percentWidth
См. также:
  • getPercentWidth()
  • percentWidthProperty()

ПолучитьПроцентнуюШирину

public final double getPercentWidth()
Возвращает значение свойства percentWidth.
Описание свойства:
Процентная ширина столбца. Если установлено значение больше 0, столбец будет изменён на этот процент от доступной ширины gridpane, и другие ограничения размера (minWidth, prefWidth, maxWidth, hgrow) будут проигнорированы. Значение по умолчанию - -1, что означает, что процент будет проигнорирован.
Возвращаемое значение:
значение свойства percentWidth
См. также:
  • setPercentWidth(double)
  • percentWidthProperty()

свойствоPercentWidth

public final DoubleProperty percentWidthProperty()
Процентная ширина столбца. Если установлено значение больше 0, столбец будет изменён на этот процент от доступной ширины gridpane, и другие ограничения размера (minWidth, prefWidth, maxWidth, hgrow) будут проигнорированы. Значение по умолчанию - -1, что означает, что процент будет проигнорирован.
Возвращаемое значение:
свойство percentWidth
См. также:
  • getPercentWidth()
  • setPercentWidth(double)

УстановитьГоризонтальныйРост

public final void setHgrow(Priority value)
Устанавливает значение свойства hgrow.
Описание свойства:
Приоритет горизонтального роста столбца. Если установлен, gridpane будет использовать этот приоритет для определения, должен ли столбец получить дополнительную ширину, если gridpane будет изменён на большую ширину, чем предпочтительная. Это свойство игнорируется, если percentWidth установлен.

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

Параметры:
value - значение для свойства hgrow
См. также:
  • getHgrow()
  • hgrowProperty()

ПолучитьГоризонтальныйРост

public final Priority getHgrow()
Возвращает значение свойства hgrow.
Описание свойства:
Приоритет горизонтального роста столбца. Если установлен, gridpane будет использовать этот приоритет для определения, должен ли столбец получить дополнительную ширину, если gridpane будет изменён на большую ширину, чем предпочтительная. Это свойство игнорируется, если percentWidth установлен.

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

Возвращаемое значение:
значение свойства hgrow
См. также:
  • setHgrow(Priority)
  • hgrowProperty()

свойствоHgrow

public final ObjectProperty<Priority> hgrowProperty()
Приоритет горизонтального роста столбца. Если установлен, gridpane будет использовать этот приоритет для определения, должен ли столбец получить дополнительную ширину, если gridpane будет изменён на большую ширину, чем предпочтительная. Это свойство игнорируется, если percentWidth установлен.

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

Возвращаемое значение:
свойство hgrow
См. также:
  • getHgrow()
  • setHgrow(Priority)

УстановитьГоризонтальноеВыравнивание

public final void setHalignment(HPos value)
Устанавливает значение свойства halignment.
Описание свойства:
Горизонтальное выравнивание для столбца. Если установлено, будет использоваться в качестве стандартного горизонтального выравнивания для узлов, содержащихся в столбце.

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

Параметры:
value - значение для свойства halignment
См. также:
  • getHalignment()
  • halignmentProperty()

ПолучитьГоризонтальноеВыравнивание

public final HPos getHalignment()
Возвращает значение свойства halignment.
Описание свойства:
Горизонтальное выравнивание для столбца. Если установлено, будет использоваться в качестве стандартного горизонтального выравнивания для узлов, содержащихся в столбце.

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

Возвращаемое значение:
значение свойства halignment
См. также:
  • setHalignment(HPos)
  • halignmentProperty()

свойствоHalignment

public final ObjectProperty<HPos> halignmentProperty()
Горизонтальное выравнивание для столбца. Если установлено, будет использоваться в качестве стандартного горизонтального выравнивания для узлов, содержащихся в столбце.

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

Возвращаемое значение:
свойство halignment
См. также:
  • getHalignment()
  • setHalignment(HPos)

УстановитьЗаполнениеПоШирине

public final void setFillWidth(boolean value)
Устанавливает значение свойства fillWidth.
Описание свойства:
Политика горизонтального заполнения для столбца. Gridpane будет использовать это свойство для определения, должны ли узлы, содержащиеся в столбце, быть расширены для заполнения столбца или оставаться своих предпочтительных ширинах.

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

Параметры:
value - значение для свойства fillWidth
См. также:
  • isFillWidth()
  • fillWidthProperty()

ИмеетЗаполнениеПоШирине

public final boolean isFillWidth()
Возвращает значение свойства fillWidth.
Описание свойства:
Политика горизонтального заполнения для столбца. Gridpane будет использовать это свойство для определения, должны ли узлы, содержащиеся в столбце, быть расширены для заполнения столбца или оставаться своих предпочтительных ширинах.

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

Возвращаемое значение:
значение свойства fillWidth
См. также:
  • setFillWidth(boolean)
  • fillWidthProperty()

fillWidthProperty

public final BooleanProperty fillWidthProperty()
Политика горизонтального заполнения для столбца. Компоновщик gridpane будет использовать это свойство, чтобы определить, должны ли узлы, содержащиеся в столбце, расширяться для заполнения столбца или сохранять свои предпочтительные ширины.

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

Возвращает:
свойство fillWidth
См. также:
  • 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.

Spec-Zone.ru

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