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

Class RowConstraints



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

    例如,要创建一个10行高50像素的GridPane:

       GridPane gridpane = new GridPane(); for (int i = 0; i < 10; i++) { RowConstraints row = new RowConstraints(50); gridpane.getRowConstraints().add(row); }  
    或者,要创建一个GridPane,其中行的宽度为25%,50%,25%
       GridPane gridpane = new GridPane(); RowConstraints row1 = new RowConstraints(); row1.setPercentWidth(25); RowConstraints row2 = new RowConstraints(); row2.setPercentWidth(50); RowConstraints row3 = new RowConstraints(); row3.setPercentWidth(25); gridpane.getRowConstraints().addAll(row1,row2,row3);  
    请注意,添加一个空RowConstraints对象的效果是没有设置任何约束,使GridPane仅仅根据其内容的大小偏好和约束计算行的布局。
    从以下版本开始:
    JavaFX 2.0
    • Property Detail

      • 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的值,则该行将调整为可用网格高度的百分比,并忽略其他大小约束(minHeight,prefHeight,maxHeight,vgrow)。 默认值为-1,表示该百分比将被忽略。
        另请参见:
        getPercentHeight()setPercentHeight(double)
      • vgrow

        public final ObjectProperty<Priority> vgrowProperty
        该行的垂直成长优先级。 如果设置,则如果格网尺寸大于其首选高度,则网格板将使用此优先级来确定该行是否应该被赋予任何额外的高度。 如果设置percentHeight,则忽略此属性。

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

        另请参见:
        getVgrow()setVgrow(Priority)
      • valignment

        public final ObjectProperty<VPos> valignmentProperty
        行的垂直对齐方式。 如果设置,将是行中包含的节点的默认垂直对齐方式。 如果此属性设置为VPos.BASELINE,则fillHeight属性将被忽略,并且节点将始终调整为其首选高度。
        另请参见:
        getValignment()setValignment(VPos)
      • fillHeight

        public final BooleanProperty fillHeightProperty
        行的垂直填充策略。 网格板将使用此属性来确定包含在行内的节点是否应该被扩展以填充行的高度或保持为其首选高度。

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

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

      • getMinHeight

        public final double getMinHeight​()
        获取属性minHeight的值。
        Property description:
        行的最小高度。 如果设置percentHeight,则忽略此属性。

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

      • minHeightProperty

        public final DoubleProperty minHeightProperty​()
        行的最小高度。 如果设置percentHeight,则忽略此属性。

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

        另请参见:
        getMinHeight()setMinHeight(double)
      • setPrefHeight

        public final void setPrefHeight​(double value)
        设置属性prefHeight的值。
        Property description:
        行的首选高度。 如果设置percentHeight,则忽略此属性。

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

      • getPrefHeight

        public final double getPrefHeight​()
        获取属性prefHeight的值。
        Property description:
        行的首选高度。 如果设置percentHeight,则忽略此属性。

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

      • prefHeightProperty

        public final DoubleProperty prefHeightProperty​()
        行的首选高度。 如果设置percentHeight,则忽略此属性。

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

        另请参见:
        getPrefHeight()setPrefHeight(double)
      • setMaxHeight

        public final void setMaxHeight​(double value)
        设置属性maxHeight的值。
        Property description:
        行的最大高度。 如果设置percentHeight,则忽略此属性。

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

      • getMaxHeight

        public final double getMaxHeight​()
        获取属性maxHeight的值。
        Property description:
        行的最大高度。 如果设置percentHeight,则忽略此属性。

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

      • maxHeightProperty

        public final DoubleProperty maxHeightProperty​()
        行的最大高度。 如果设置percentHeight,则忽略此属性。

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

        另请参见:
        getMaxHeight()setMaxHeight(double)
      • setPercentHeight

        public final void setPercentHeight​(double value)
        设置属性percentHeight的值。
        Property description:
        行的高度百分比。 如果设置为大于0的值,则该行将调整为可用网格高度的百分比,并忽略其他大小约束(minHeight,prefHeight,maxHeight,vgrow)。 默认值为-1,表示该百分比将被忽略。
      • getPercentHeight

        public final double getPercentHeight​()
        获取属性percentHeight的值。
        Property description:
        行的高度百分比。 如果设置为大于0的值,则该行将调整为可用网格高度的百分比,并忽略其他大小约束(minHeight,prefHeight,maxHeight,vgrow)。 默认值为-1,表示该百分比将被忽略。
      • percentHeightProperty

        public final DoubleProperty percentHeightProperty​()
        行的高度百分比。 如果设置为大于0的值,则该行将调整为可用网格高度的百分比,并忽略其他大小约束(minHeight,prefHeight,maxHeight,vgrow)。 默认值为-1,表示该百分比将被忽略。
        另请参见:
        getPercentHeight()setPercentHeight(double)
      • setVgrow

        public final void setVgrow​(Priority value)
        设置属性vgrow的值。
        Property description:
        该行的垂直成长优先级。 如果设置,则如果格网尺寸大于其首选高度,则网格板将使用此优先级来确定该行是否应该被赋予任何额外的高度。 如果设置percentHeight,则忽略此属性。

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

      • getVgrow

        public final Priority getVgrow​()
        获取属性vgrow的值。
        Property description:
        该行的垂直成长优先级。 如果设置,则如果格网尺寸大于其首选高度,则网格板将使用此优先级来确定该行是否应该被赋予任何额外的高度。 如果设置percentHeight,则忽略此属性。

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

      • vgrowProperty

        public final ObjectProperty<Priority> vgrowProperty​()
        该行的垂直成长优先级。 如果设置,则如果格网尺寸大于其首选高度,则网格板将使用此优先级来确定该行是否应该被赋予任何额外的高度。 如果设置percentHeight,则忽略此属性。

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

        另请参见:
        getVgrow()setVgrow(Priority)
      • setValignment

        public final void setValignment​(VPos value)
        设置属性对齐的值。
        Property description:
        行的垂直对齐方式。 如果设置,将是行中包含的节点的默认垂直对齐方式。 如果此属性设置为VPos.BASELINE,则fillHeight属性将被忽略,并且节点将始终调整为其首选高度。
      • getValignment

        public final VPos getValignment​()
        获取属性对齐的值。
        Property description:
        行的垂直对齐方式。 如果设置,将是行中包含的节点的默认垂直对齐方式。 如果此属性设置为VPos.BASELINE,则fillHeight属性将被忽略,并且节点将始终调整为其首选高度。
      • valignmentProperty

        public final ObjectProperty<VPos> valignmentProperty​()
        行的垂直对齐方式。 如果设置,将是行中包含的节点的默认垂直对齐方式。 如果此属性设置为VPos.BASELINE,则fillHeight属性将被忽略,并且节点将始终调整为其首选高度。
        另请参见:
        getValignment()setValignment(VPos)
      • setFillHeight

        public final void setFillHeight​(boolean value)
        设置属性fillHeight的值。
        Property description:
        行的垂直填充策略。 网格板将使用此属性来确定包含在行内的节点是否应该被扩展以填充行的高度或保持为其首选高度。

        默认值为true。

      • isFillHeight

        public final boolean isFillHeight​()
        获取属性fillHeight的值。
        Property description:
        行的垂直填充策略。 网格板将使用此属性来确定包含在行内的节点是否应该被扩展以填充行的高度或保持为其首选高度。

        默认值为true。

      • fillHeightProperty

        public final BooleanProperty fillHeightProperty​()
        行的垂直填充策略。 网格板将使用此属性来确定包含在行内的节点是否应该被扩展以填充行的高度或保持为其首选高度。

        默认值为true。

        另请参见:
        isFillHeight()setFillHeight(boolean)
      • toString

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