Module  javafx.graphics
软件包  javafx.scene.layout

Class ColumnConstraints



  • public class ColumnConstraints
    extends ConstraintsBase
    GridPane的列定义可选布局约束。 如果在Gridpane中为列添加ColumnConstraints对象,则在计算列的宽度和布局时,网格板将使用这些约束值。

    例如,创建一个具有100个像素宽的5列的GridPane:

       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
    • Property Detail

      • 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的值,则该列将被调整为网格窗口可用宽度的百分比,其他大小约束(minWidth,prefWidth,maxWidth,hgrow)将被忽略。 默认值为-1,表示该百分比将被忽略。
        另请参见:
        getPercentWidth()setPercentWidth(double)
      • hgrow

        public final ObjectProperty<Priority> hgrowProperty
        该列的横向增长优先级。 如果设置,则如果格网尺寸大于其首选宽度,则网格将使用此优先级来确定该列是否应该被赋予任何额外的宽度。 如果设置percentWidth,则忽略此属性。

        此默认值为null,这意味着列的增长优先级将从内容节点上设置的最大增长优先级派生。

        另请参见:
        getHgrow()setHgrow(Priority)
      • halignment

        public final ObjectProperty<HPos> halignmentProperty
        列的水平对齐。 如果设置,将是列中包含的节点的默认水平对齐方式。

        默认值为null,这意味着列对齐将返回到在gridpane上设置的默认挂起。

        另请参见:
        getHalignment()setHalignment(HPos)
      • fillWidth

        public final BooleanProperty fillWidthProperty
        列的横向填充策略。 网格板将使用此属性来确定列中包含的节点是否应扩展以填充列或保持为其首选宽度。

        默认值为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的值。
        Property description:
        列的最小宽度。 如果设置percentWidth,则忽略此属性。

        默认值为USE_COMPUTED_SIZE,这意味着最小宽度将被计算为列内容的最大最小宽度。

      • getMinWidth

        public final double getMinWidth​()
        获取属性minWidth的值。
        Property description:
        列的最小宽度。 如果设置percentWidth,则忽略此属性。

        默认值为USE_COMPUTED_SIZE,这意味着最小宽度将被计算为列内容的最大最小宽度。

      • minWidthProperty

        public final DoubleProperty minWidthProperty​()
        列的最小宽度。 如果设置percentWidth,则忽略此属性。

        默认值为USE_COMPUTED_SIZE,这意味着最小宽度将被计算为列内容的最大最小宽度。

        另请参见:
        getMinWidth()setMinWidth(double)
      • setPrefWidth

        public final void setPrefWidth​(double value)
        设置属性prefWidth的值。
        Property description:
        列的首选宽度。 如果设置percentWidth,则忽略此属性。

        默认值为USE_COMPUTED_SIZE,这意味着首选宽度将被计算为列内容的最大首选宽度。

      • getPrefWidth

        public final double getPrefWidth​()
        获取属性prefWidth的值。
        Property description:
        列的首选宽度。 如果设置percentWidth,则忽略此属性。

        默认值为USE_COMPUTED_SIZE,这意味着首选宽度将被计算为列内容的最大首选宽度。

      • prefWidthProperty

        public final DoubleProperty prefWidthProperty​()
        列的首选宽度。 如果设置percentWidth,则忽略此属性。

        默认值为USE_COMPUTED_SIZE,这意味着首选宽度将被计算为列内容的最大首选宽度。

        另请参见:
        getPrefWidth()setPrefWidth(double)
      • setMaxWidth

        public final void setMaxWidth​(double value)
        设置属性maxWidth的值。
        Property description:
        列的最大宽度。 如果设置percentWidth,则忽略此属性。

        默认值为USE_COMPUTED_SIZE,这意味着最大宽度将被计算为列内容的最小最大宽度。

      • getMaxWidth

        public final double getMaxWidth​()
        获取属性maxWidth的值。
        Property description:
        列的最大宽度。 如果设置percentWidth,则忽略此属性。

        默认值为USE_COMPUTED_SIZE,这意味着最大宽度将被计算为列内容的最小最大宽度。

      • maxWidthProperty

        public final DoubleProperty maxWidthProperty​()
        列的最大宽度。 如果设置percentWidth,则忽略此属性。

        默认值为USE_COMPUTED_SIZE,这意味着最大宽度将被计算为列内容的最小最大宽度。

        另请参见:
        getMaxWidth()setMaxWidth(double)
      • setPercentWidth

        public final void setPercentWidth​(double value)
        设置属性percentWidth的值。
        Property description:
        列的宽度百分比。 如果设置为大于0的值,则该列将被调整为网格窗口可用宽度的百分比,其他大小约束(minWidth,prefWidth,maxWidth,hgrow)将被忽略。 默认值为-1,表示该百分比将被忽略。
      • getPercentWidth

        public final double getPercentWidth​()
        获取属性percentWidth的值。
        Property description:
        列的宽度百分比。 如果设置为大于0的值,则该列将被调整为网格窗口可用宽度的百分比,其他大小约束(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的值。
        Property description:
        该列的横向增长优先级。 如果设置,则如果格网尺寸大于其首选宽度,则网格将使用此优先级来确定该列是否应该被赋予任何额外的宽度。 如果设置percentWidth,则忽略此属性。

        此默认值为null,这意味着列的增长优先级将从内容节点上设置的最大增长优先级派生。

      • getHgrow

        public final Priority getHgrow​()
        获取属性hgrow的值。
        Property description:
        该列的横向增长优先级。 如果设置,则如果格网尺寸大于其首选宽度,则网格将使用此优先级来确定该列是否应该被赋予任何额外的宽度。 如果设置percentWidth,则忽略此属性。

        此默认值为null,这意味着列的增长优先级将从内容节点上设置的最大增长优先级派生。

      • hgrowProperty

        public final ObjectProperty<Priority> hgrowProperty​()
        该列的横向增长优先级。 如果设置,则如果格网尺寸大于其首选宽度,则网格将使用此优先级来确定该列是否应该被赋予任何额外的宽度。 如果设置percentWidth,则忽略此属性。

        此默认值为null,这意味着列的增长优先级将从内容节点上设置的最大增长优先级派生。

        另请参见:
        getHgrow()setHgrow(Priority)
      • setHalignment

        public final void setHalignment​(HPos value)
        设置属性暂停的值。
        Property description:
        列的水平对齐。 如果设置,将是列中包含的节点的默认水平对齐方式。

        默认值为null,这意味着列对齐将返回到在gridpane上设置的默认挂起。

      • getHalignment

        public final HPos getHalignment​()
        获取属性暂停的值。
        Property description:
        列的水平对齐。 如果设置,将是列中包含的节点的默认水平对齐方式。

        默认值为null,这意味着列对齐将返回到在gridpane上设置的默认挂起。

      • halignmentProperty

        public final ObjectProperty<HPos> halignmentProperty​()
        列的水平对齐。 如果设置,将是列中包含的节点的默认水平对齐方式。

        默认值为null,这意味着列对齐将返回到在gridpane上设置的默认挂起。

        另请参见:
        getHalignment()setHalignment(HPos)
      • setFillWidth

        public final void setFillWidth​(boolean value)
        设置属性fillWidth的值。
        Property description:
        列的横向填充策略。 网格板将使用此属性来确定列中包含的节点是否应扩展以填充列或保持为其首选宽度。

        默认值为true。

      • isFillWidth

        public final boolean isFillWidth​()
        获取属性fillWidth的值。
        Property description:
        列的横向填充策略。 网格板将使用此属性来确定列中包含的节点是否应扩展以填充列或保持为其首选宽度。

        默认值为true。

      • fillWidthProperty

        public final BooleanProperty fillWidthProperty​()
        列的横向填充策略。 网格板将使用此属性来确定列中包含的节点是否应扩展以填充列或保持为其首选宽度。

        默认值为true。

        另请参见:
        isFillWidth()setFillWidth(boolean)
      • toString

        public String toString​()
        返回此 ColumnConstraints对象的字符串表示形式。
        重写:
        toStringObject
        结果
        这是 ColumnConstraints对象的字符串表示形式。