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

Class Region

  • All Implemented Interfaces:
    StyleableEventTarget
    已知直接子类:
    AxisChartControlPaneTableColumnHeaderVirtualFlow


    public class Region
    extends Parent
    Region是所有基于JavaFX Node的UI控件和所有布局容器的基类。 它是一个可调整大小的父节点,可以从CSS样式。 它可以有多个背景和边界。 它旨在支持与JavaFX相关的背景和边框CSS3规范。 完整的规格可在the W3C

    每个区域都有其布局边界,它们被指定为(0,0,width,height)。 一个地区可能会超出这些范围。 区域的内容区域是其孩子的布局占用的区域。 默认情况下,该区域与区域的布局边界相同,但可以通过边框的属性(使用BorderStrokes或BorderImages)和填充来修改。 填充可以是负的,使得区域的内容区域可能延伸超出区域的布局边界,但不影响布局边界。

    区域有一个背景和一个边框,尽管这两个或者两个可能是空的。 区域背景由零个或多个BackgroundFill以及零个或多个BackgroundImages组成。 同样地,一个区域的边界由它的Border定义,它由零个或多个BorderStrokes和零个或多个BorderImages组成。 所有的BackgroundFill都先绘制,其次是BackgroundImages,BorderStrokes,最后是BorderImages。 内容绘制在所有背景和边框之上。 如果存在BorderImage(并且正确加载了所有图像),则实际上不绘制BorderStrokes,尽管它们被考虑用于计算内容区域的位置(请参阅BorderStroke的stroke width属性)。 这些语义符合CSS3规范。 这些语义的目的是允许应用程序指定在ImageStroke无法下载或加载的情况下显示的后备BorderStroke。

    默认情况下,区域显示为矩形。 BackgroundFill半径可能会导致Rectangle显示为四舍五入。 这不仅影响视觉效果看起来像圆角的矩形,而且还会导致区域的选取行为像圆角矩形,从而忽略角半径之外的位置。 一个区域可以使用任何形状,但是,通过指定shape属性。 如果指定了一个形状,那么所有的BackgroundFill,BackgroundImages和BorderStrokes将被应用于形状。 BorderImages不用于具有指定形状的区域。

    具有形状的区域

    虽然区域的布局界限不受任何边框或背景影响,但区域内容区域和区域的选区也是如此。 该区域的insets定义了布局边界的边缘与内容区域的边缘之间的距离。 例如,如果区域布局界限为(x = 0,y = 0,width = 200,height = 100),并且插图为(top = 10,right = 20,bottom = 30,left = 40)内容区域界限为(x = 40,y = 10,width = 140,height = 60)。 布置其子女的区域子类应该计算并遵守这些内容区域边界。

    默认情况下,Region继承其超类的布局行为,即Parent ,这意味着它会将任何可调整大小的子节点的大小调整到其首选大小,但不会重新定位它们。 如果应用程序需要更具体的布局行为,那么它应该使用的地区的一个子类: StackPaneHBoxVBoxTilePaneFlowPaneBorderPaneGridPane ,或AnchorPane

    为了实现更自定义布局,区域子类必须覆盖computePrefWidthcomputePrefHeight ,并layoutChildren 请注意, layoutChildren在执行自上而下的布局传递时由场景图自动调用,不应由region子类直接调用。

    区域子类,其布局自己的孩子会通过设置定位节点二百七十○万七千一百十六亿二千一百五十三万三千六百三十三 / 二七零七一一六二一五四五四七六并不会改变二百七十�鐾蚱咔б话偈�六亿二千一百五十六万一千二百六十六 / 二百七十万七千一百十六亿二千一百五十七万三千一百零九 ,这些将被保留调整和动画。

    从以下版本开始:
    JavaFX 2.0
    • Property Detail

      • snapToPixel

        public final BooleanProperty snapToPixelProperty
        定义此区域是否将其子项的位置,间距和大小值调整为像素边界。 这默认为true,这通常是预期的行为,以便具有清晰的用户界面。 值为false将允许分数对齐,这可能导致“模糊”的边界。
        另请参见:
        isSnapToPixel()setSnapToPixel(boolean)
      • padding

        public final ObjectProperty<Insets> paddingProperty
        顶部,右侧,底部和左侧填充该区域的内容。 该空间将包含在该区域的最小和优选大小的计算中。 默认填充为Insets.EMPTY。 应避免将值设置为null。
        另请参见:
        getPadding()setPadding(Insets)
      • background

        public final ObjectProperty<Background> backgroundProperty
        该区域的背景由零个或多个BackgroundFill组成,以及零个或多个BackgroundImages。 背景可能是空的,它既没有填充也没有图像,并且在语义上等同于null。
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        getBackground()setBackground(Background)
      • border

        public final ObjectProperty<Border> borderProperty
        该区域的边界由零个或多个BorderStrokes组成,零个或多个BorderImages。 边框可以是空的,它既没有笔画也没有图像,并且在语义上等同于null。
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        getBorder()setBorder(Border)
      • opaqueInsets

        public final ObjectProperty<Insets> opaqueInsetsProperty
        定义绘制完全不透明像素的区域的面积。 这用于各种性能优化。 该区域内的像素必须完全不透明,否则会产生渲染伪像。 应用程序的责任是通过代码或通过CSS来确保opaqueInsets对于区域的背景和边界是正确的。 每个插值的值必须是实数,而不是NaN或Infinity。 如果没有已知的insets存在,那么opaqueInsets应该设置为null。
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        getOpaqueInsets()setOpaqueInsets(Insets)
      • insets

        public final ReadOnlyObjectProperty<Insets> insetsProperty
        区域的插图定义从区域边缘(其布局边界,或(0,0,宽度,高度))到内容区域边缘的距离。 所有子节点都应该布置在内容区域内。 插值是根据已指定的边框(如果有的话)以及填充来计算的。
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        getInsets()
      • width

        public final ReadOnlyDoubleProperty widthProperty
        这个可调节大小的节点的宽度。 此属性在布局期间由区域的父级设置,可能不由应用程序设置。 如果应用程序需要明确地控制的区域的大小,它应通过将覆盖其优选尺寸范围minWidthprefWidth ,和maxWidth性质。
        另请参见:
        getWidth()setWidth(double)
      • height

        public final ReadOnlyDoubleProperty heightProperty
        这个可调节大小的节点的高度。 此属性在布局期间由区域的父级设置,可能不由应用程序设置。 如果应用程序需要明确地控制的区域的大小,它应通过将覆盖其优选尺寸范围minHeightprefHeight ,和maxHeight性质。
        另请参见:
        getHeight()setHeight(double)
      • minWidth

        public final DoubleProperty minWidthProperty
        覆盖该地区计算出的最小宽度的属性。 只有当区域内部计算的最小宽度不符合应用程序的布局需求时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着minWidth(forHeight)将返回区域内部计算的最小宽度。

        将此值设置为USE_PREF_SIZE标志将导致minWidth(forHeight)返回区域的首选宽度,使应用程序可以轻松限制区域的可重定位。

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

        public final DoubleProperty minHeightProperty
        覆盖该地区计算最小高度的属性。 只有当区域的内部计算的最小高度不符合应用程序的布局需要时,才应该设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着minHeight(forWidth)将返回区域内部计算的最小高度。

        将此值设置为USE_PREF_SIZE标志将导致minHeight(forWidth)返回区域的首选高度,从而使应用程序能够轻松限制区域的可minHeight(forWidth)性。

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

        public final DoubleProperty prefWidthProperty
        覆盖该地区计算的首选宽度的属性。 只有当区域内部计算的首选宽度不符合应用程序的布局需要时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getPrefWidth(forHeight)将返回区域内部计算的首选宽度。

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

        public final DoubleProperty prefHeightProperty
        覆盖该地区计算的首选高度的属性。 只有当区域内部计算的首选高度不符合应用程序的布局需求时,才应该设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getPrefHeight(forWidth)将返回区域内部计算的首选宽度。

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

        public final DoubleProperty maxWidthProperty
        覆盖该地区计算出的最大宽度的属性。 只有当区域的内部计算的最大宽度不符合应用程序的布局需要时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getMaxWidth(forHeight)将返回区域内部计算的最大宽度。

        将此值设置为USE_PREF_SIZE标志将导致getMaxWidth(forHeight)返回区域的首选宽度,使应用程序能够轻松限制区域的可getMaxWidth(forHeight)性。

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

        public final DoubleProperty maxHeightProperty
        覆盖该地区计算出的最大高度的属性。 只有当区域内部计算的最大高度不符合应用程序的布局需求时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getMaxHeight(forWidth)将返回区域内部计算的最大高度。

        将此值设置为USE_PREF_SIZE标志将导致getMaxHeight(forWidth)返回区域的首选高度,使应用程序能够轻松限制区域的可重定位。

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

        public final ObjectProperty<Shape> shapeProperty
        指定时, Shape将导致该区域被渲染为指定的形状而不是圆角矩形。 当为空时,Region将被渲染为圆角矩形。 当渲染为Shape时,任何背景都用于填充形状,尽管任何背景插入将被忽略,如背景半径。 定义的任何BorderStrokes用于抚摸形状。 任何BorderImages都被忽略。
        Default value:
        空值
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        getShape()setShape(Shape)
      • scaleShape

        public final BooleanProperty scaleShapeProperty
        指定是否将形状(如果已定义)缩放以匹配“区域”的大小。 true表示形状被缩放以适应区域的大小, false表示形状为其源尺寸,其定位取决于centerShape的值。
        Default value:
        真正
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        isScaleShape()setScaleShape(boolean)
      • centerShape

        public final BooleanProperty centerShapeProperty
        定义形状是否位于区域的宽度或高度内。 true表示以区域宽度和高度为中心的形状, false表示形状位于其源位置。
        Default value:
        真正
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        isCenterShape()setCenterShape(boolean)
      • cacheShape

        public final BooleanProperty cacheShapeProperty
        定义对系统的提示,指出用于定义区域背景的Shape是稳定的,可以从缓存中受益。
        Default value:
        真正
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        isCacheShape()setCacheShape(boolean)
    • 构造方法详细信息

      • Region

        public Region​()
        创建一个空的背景和空的Border的新区域。 区域默认为将pickOnBounds设置为true,这意味着在Region区域内的边界内发生的任何选择(鼠标选择或触摸拾取等)将返回true,而不管该区域是填充还是透明。
    • 方法详细信息

      • isSnapToPixel

        public final boolean isSnapToPixel​()
        获取属性snapToPixel的值。
        Property description:
        定义此区域是否将其子项的位置,间距和大小值调整为像素边界。 这默认为true,这通常是预期的行为,以便具有清晰的用户界面。 值为false将允许分数对齐,这可能导致“模糊”的边界。
      • setSnapToPixel

        public final void setSnapToPixel​(boolean value)
        设置属性snapToPixel的值。
        Property description:
        定义此区域是否将其子项的位置,间距和大小值调整为像素边界。 这默认为true,这通常是预期的行为,以便具有清晰的用户界面。 值为false将允许分数对齐,这可能导致“模糊”的边界。
      • snapToPixelProperty

        public final BooleanProperty snapToPixelProperty​()
        定义此区域是否将其子项的位置,间距和大小值调整为像素边界。 这默认为true,这通常是预期的行为,以便具有清晰的用户界面。 值为false将允许分数对齐,这可能导致“模糊”的边界。
        另请参见:
        isSnapToPixel()setSnapToPixel(boolean)
      • setPadding

        public final void setPadding​(Insets value)
        设置属性填充的值。
        Property description:
        顶部,右侧,底部和左侧填充该区域的内容。 该空间将包含在该区域的最小和优选大小的计算中。 默认填充为Insets.EMPTY。 应避免将值设置为null。
      • getPadding

        public final Insets getPadding​()
        获取属性填充的值。
        Property description:
        顶部,右侧,底部和左侧填充该区域的内容。 该空间将包含在该区域的最小和优选大小的计算中。 默认填充为Insets.EMPTY。 应避免将值设置为null。
      • paddingProperty

        public final ObjectProperty<Insets> paddingProperty​()
        顶部,右侧,底部和左侧填充该区域的内容。 该空间将包含在该区域的最小和优选大小的计算中。 默认填充为Insets.EMPTY。 应避免将值设置为null。
        另请参见:
        getPadding()setPadding(Insets)
      • setBackground

        public final void setBackground​(Background value)
        设置属性背景的值。
        Property description:
        该区域的背景由零个或多个BackgroundFill组成,以及零个或多个BackgroundImages。 背景可能是空的,它既没有填充也没有图像,并且在语义上等同于null。
        从以下版本开始:
        JavaFX 8.0
      • getBackground

        public final Background getBackground​()
        获取属性背景的值。
        Property description:
        该区域的背景由零个或多个BackgroundFill组成,以及零个或多个BackgroundImages。 背景可能是空的,它既没有填充也没有图像,并且在语义上等同于null。
        从以下版本开始:
        JavaFX 8.0
      • backgroundProperty

        public final ObjectProperty<Background> backgroundProperty​()
        该区域的背景由零个或多个BackgroundFill组成,以及零个或多个BackgroundImages。 背景可能是空的,它既没有填充也没有图像,并且在语义上等同于null。
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        getBackground()setBackground(Background)
      • setBorder

        public final void setBorder​(Border value)
        设置属性边框的值。
        Property description:
        该区域的边界由零个或多个BorderStrokes组成,零个或多个BorderImages。 边框可以是空的,它既没有笔画也没有图像,并且在语义上等同于null。
        从以下版本开始:
        JavaFX 8.0
      • getBorder

        public final Border getBorder​()
        获取属性边框的值。
        Property description:
        该区域的边界由零个或多个BorderStrokes组成,零个或多个BorderImages。 边框可以是空的,它既没有笔画也没有图像,并且在语义上等同于null。
        从以下版本开始:
        JavaFX 8.0
      • borderProperty

        public final ObjectProperty<Border> borderProperty​()
        该区域的边界由零个或多个BorderStrokes组成,零个或多个BorderImages。 边框可以是空的,它既没有笔画也没有图像,并且在语义上等同于null。
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        getBorder()setBorder(Border)
      • opaqueInsetsProperty

        public final ObjectProperty<Insets> opaqueInsetsProperty​()
        定义绘制完全不透明像素的区域的面积。 这用于各种性能优化。 该区域内的像素必须完全不透明,否则会产生渲染伪像。 应用程序的责任是通过代码或通过CSS来确保opaqueInsets对于区域的背景和边界是正确的。 每个插值的值必须是实数,而不是NaN或Infinity。 如果没有已知的insets存在,那么opaqueInsets应该设置为null。
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        getOpaqueInsets()setOpaqueInsets(Insets)
      • setOpaqueInsets

        public final void setOpaqueInsets​(Insets value)
        设置属性opaqueInsets的值。
        Property description:
        定义绘制完全不透明像素的区域的面积。 这用于各种性能优化。 该区域内的像素必须完全不透明,否则会产生渲染伪像。 应用程序的责任是通过代码或通过CSS来确保opaqueInsets对于区域的背景和边界是正确的。 每个插值的值必须是实数,而不是NaN或Infinity。 如果没有已知的insets存在,那么opaqueInsets应该设置为null。
        从以下版本开始:
        JavaFX 8.0
      • getOpaqueInsets

        public final Insets getOpaqueInsets​()
        获取属性opaqueInsets的值。
        Property description:
        定义绘制完全不透明像素的区域的面积。 这用于各种性能优化。 该区域内的像素必须完全不透明,否则会产生渲染伪像。 应用程序的责任是通过代码或通过CSS来确保opaqueInsets对于区域的背景和边界是正确的。 每个插值的值必须是实数,而不是NaN或Infinity。 如果没有已知的insets存在,那么opaqueInsets应该设置为null。
        从以下版本开始:
        JavaFX 8.0
      • getInsets

        public final Insets getInsets​()
        获取属性插值的值。
        Property description:
        区域的插图定义从区域边缘(其布局边界,或(0,0,宽度,高度))到内容区域边缘的距离。 所有子节点都应该布置在内容区域内。 插值是根据已指定的边框(如果有的话)以及填充来计算的。
        从以下版本开始:
        JavaFX 8.0
      • insetsProperty

        public final ReadOnlyObjectProperty<Insets> insetsProperty​()
        区域的插图定义从区域边缘(其布局边界,或(0,0,宽度,高度))到内容区域边缘的距离。 所有子节点都应该布置在内容区域内。 插值是根据已指定的边框(如果有的话)以及填充来计算的。
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        getInsets()
      • setWidth

        protected void setWidth​(double value)
        设置属性宽度的值。
        Property description:
        这个可调节大小的节点的宽度。 此属性在布局期间由区域的父级设置,可能不由应用程序设置。 如果应用程序需要明确地控制的区域的大小,它应通过将覆盖其优选尺寸范围minWidthprefWidth ,和maxWidth性质。
      • getWidth

        public final double getWidth​()
        获取属性宽度的值。
        Property description:
        这个可调节大小的节点的宽度。 此属性在布局期间由区域的父级设置,可能不由应用程序设置。 如果应用程序需要明确地控制的区域的大小,它应通过将覆盖其优选尺寸范围minWidthprefWidth ,和maxWidth性质。
      • widthProperty

        public final ReadOnlyDoubleProperty widthProperty​()
        这个可调节大小的节点的宽度。 此属性在布局期间由区域的父级设置,可能不由应用程序设置。 如果应用程序需要明确地控制的区域的大小,它应通过将覆盖其优选尺寸范围minWidthprefWidth ,和maxWidth性质。
        另请参见:
        getWidth()setWidth(double)
      • setHeight

        protected void setHeight​(double value)
        设置属性高度的值。
        Property description:
        这个可调节大小的节点的高度。 此属性在布局期间由区域的父级设置,可能不由应用程序设置。 如果应用程序需要明确地控制的区域的大小,它应通过将覆盖其优选尺寸范围minHeightprefHeight ,和maxHeight性质。
      • getHeight

        public final double getHeight​()
        获取属性高度的值。
        Property description:
        这个可调节大小的节点的高度。 此属性在布局期间由区域的父级设置,可能不由应用程序设置。 如果应用程序需要明确地控制的区域的大小,它应通过将覆盖其优选尺寸范围minHeightprefHeight ,和maxHeight性质。
      • heightProperty

        public final ReadOnlyDoubleProperty heightProperty​()
        这个可调节大小的节点的高度。 此属性在布局期间由区域的父级设置,可能不由应用程序设置。 如果应用程序需要明确地控制的区域的大小,它应通过将覆盖其优选尺寸范围minHeightprefHeight ,和maxHeight性质。
        另请参见:
        getHeight()setHeight(double)
      • setMinWidth

        public final void setMinWidth​(double value)
        设置属性minWidth的值。
        Property description:
        覆盖该地区计算出的最小宽度的属性。 只有当区域内部计算的最小宽度不符合应用程序的布局需求时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着minWidth(forHeight)将返回区域内部计算的最小宽度。

        将此值设置为USE_PREF_SIZE标志将导致minWidth(forHeight)返回区域的首选宽度,使应用程序能够轻松地限制区域的可重定位。

      • getMinWidth

        public final double getMinWidth​()
        获取属性minWidth的值。
        Property description:
        覆盖该地区计算出的最小宽度的属性。 只有当区域内部计算的最小宽度不符合应用程序的布局需求时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着minWidth(forHeight)将返回区域内部计算的最小宽度。

        将此值设置为USE_PREF_SIZE标志将导致minWidth(forHeight)返回区域的首选宽度,使应用程序能够轻松限制区域的可重定位。

      • minWidthProperty

        public final DoubleProperty minWidthProperty​()
        覆盖该地区计算出的最小宽度的属性。 只有当区域内部计算的最小宽度不符合应用程序的布局需求时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着minWidth(forHeight)将返回区域内部计算的最小宽度。

        将此值设置为USE_PREF_SIZE标志将导致minWidth(forHeight)返回区域的首选宽度,使应用程序能够轻松限制区域的可重定位。

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

        public final void setMinHeight​(double value)
        设置属性minHeight的值。
        Property description:
        覆盖该地区计算最小高度的属性。 只有当区域的内部计算的最小高度不符合应用程序的布局需要时,才应该设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着minHeight(forWidth)将返回区域内部计算的最小高度。

        将此值设置为USE_PREF_SIZE标志将导致minHeight(forWidth)返回区域的首选高度,使应用程序能够轻松限制区域的可重定位。

      • getMinHeight

        public final double getMinHeight​()
        获取属性minHeight的值。
        Property description:
        覆盖该地区计算最小高度的属性。 只有当区域的内部计算的最小高度不符合应用程序的布局需要时,才应该设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着minHeight(forWidth)将返回区域内部计算的最小高度。

        将此值设置为USE_PREF_SIZE标志将导致minHeight(forWidth)返回区域的首选高度,使应用程序能够轻松限制区域的可重定位。

      • minHeightProperty

        public final DoubleProperty minHeightProperty​()
        覆盖该地区计算最小高度的属性。 只有当区域的内部计算的最小高度不符合应用程序的布局需要时,才应该设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着minHeight(forWidth)将返回区域内部计算的最小高度。

        将此值设置为USE_PREF_SIZE标志将导致minHeight(forWidth)返回区域的首选高度,从而使应用程序能够轻松限制区域的可minHeight(forWidth)性。

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

        public void setMinSize​(double minWidth,
                               double minHeight)
        覆盖区域计算的最小宽度和高度的便利方法。 只有当区域的内部计算的最小大小不符合应用程序的布局需求时,才应该调用此方法。
        参数
        minWidth - 最小宽度的覆盖值
        minHeight - 最小高度的覆盖值
        另请参见:
        setMinWidth(double)setMinHeight(double)
      • setPrefWidth

        public final void setPrefWidth​(double value)
        设置属性prefWidth的值。
        Property description:
        覆盖该地区计算的首选宽度的属性。 只有当区域内部计算的首选宽度不符合应用程序的布局需要时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getPrefWidth(forHeight)将返回区域内部计算的首选宽度。

      • getPrefWidth

        public final double getPrefWidth​()
        获取属性prefWidth的值。
        Property description:
        覆盖该地区计算的首选宽度的属性。 只有当区域内部计算的首选宽度不符合应用程序的布局需要时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getPrefWidth(forHeight)将返回区域内部计算的首选宽度。

      • prefWidthProperty

        public final DoubleProperty prefWidthProperty​()
        覆盖该地区计算的首选宽度的属性。 只有当区域内部计算的首选宽度不符合应用程序的布局需要时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getPrefWidth(forHeight)将返回区域内部计算的首选宽度。

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

        public final void setPrefHeight​(double value)
        设置属性prefHeight的值。
        Property description:
        覆盖该地区计算的首选高度的属性。 只有当区域内部计算的首选高度不符合应用程序的布局需求时,才应该设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getPrefHeight(forWidth)将返回区域内部计算的首选宽度。

      • getPrefHeight

        public final double getPrefHeight​()
        获取属性prefHeight的值。
        Property description:
        覆盖该地区计算的首选高度的属性。 只有当区域内部计算的首选高度不符合应用程序的布局需求时,才应该设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getPrefHeight(forWidth)将返回区域内部计算的首选宽度。

      • prefHeightProperty

        public final DoubleProperty prefHeightProperty​()
        覆盖该地区计算的首选高度的属性。 只有当区域内部计算的首选高度不符合应用程序的布局需求时,才应该设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getPrefHeight(forWidth)将返回区域内部计算的首选宽度。

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

        public void setPrefSize​(double prefWidth,
                                double prefHeight)
        覆盖区域计算的首选宽度和高度的便捷方法。 只有当该区域的内部计算的首选大小不符合应用程序的布局需求时,才应该调用此方法。
        参数
        prefWidth - 优先宽度的覆盖值
        prefHeight - 首选高度的覆盖值
        另请参见:
        setPrefWidth(double)setPrefHeight(double)
      • setMaxWidth

        public final void setMaxWidth​(double value)
        设置属性maxWidth的值。
        Property description:
        覆盖该地区计算出的最大宽度的属性。 只有当区域的内部计算的最大宽度不符合应用程序的布局需要时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getMaxWidth(forHeight)将返回区域内部计算的最大宽度。

        将此值设置为USE_PREF_SIZE标志将导致getMaxWidth(forHeight)返回区域的首选宽度,使应用程序能够轻松限制区域的可重定位。

      • getMaxWidth

        public final double getMaxWidth​()
        获取属性maxWidth的值。
        Property description:
        覆盖该地区计算出的最大宽度的属性。 只有当区域的内部计算的最大宽度不符合应用程序的布局需要时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getMaxWidth(forHeight)将返回区域内部计算的最大宽度。

        将此值设置为USE_PREF_SIZE标志将导致getMaxWidth(forHeight)返回区域的首选宽度,使应用程序能够轻松限制区域的可重定位。

      • maxWidthProperty

        public final DoubleProperty maxWidthProperty​()
        覆盖该地区计算出的最大宽度的属性。 只有当区域的内部计算的最大宽度不符合应用程序的布局需要时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getMaxWidth(forHeight)将返回区域内部计算的最大宽度。

        将此值设置为USE_PREF_SIZE标志将导致getMaxWidth(forHeight)返回区域的首选宽度,使应用程序能够轻松限制区域的可重定位。

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

        public final void setMaxHeight​(double value)
        设置属性maxHeight的值。
        Property description:
        覆盖该地区计算出的最大高度的属性。 只有当区域内部计算的最大高度不符合应用程序的布局需求时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getMaxHeight(forWidth)将返回区域内部计算的最大高度。

        将此值设置为USE_PREF_SIZE标志将导致getMaxHeight(forWidth)返回该区域的首选高度,从而使应用程序能够轻松地限制该区域的可getMaxHeight(forWidth)性。

      • getMaxHeight

        public final double getMaxHeight​()
        获取属性maxHeight的值。
        Property description:
        覆盖该地区计算出的最大高度的属性。 只有当区域内部计算的最大高度不符合应用程序的布局需求时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getMaxHeight(forWidth)将返回区域内部计算的最大高度。

        将此值设置为USE_PREF_SIZE标志将导致getMaxHeight(forWidth)返回该区域的首选高度,从而使应用程序能够轻松限制区域的可getMaxHeight(forWidth)性。

      • maxHeightProperty

        public final DoubleProperty maxHeightProperty​()
        覆盖该地区计算出的最大高度的属性。 只有当区域内部计算的最大高度不符合应用程序的布局需求时,才应设置此值。

        默认为USE_COMPUTED_SIZE标志,这意味着getMaxHeight(forWidth)将返回区域内部计算的最大高度。

        将此值设置为USE_PREF_SIZE标志将导致getMaxHeight(forWidth)返回区域的首选高度,使应用程序能够轻松限制区域的可getMaxHeight(forWidth)性。

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

        public void setMaxSize​(double maxWidth,
                               double maxHeight)
        覆盖区域计算的最大宽度和高度的便捷方法。 只有当区域的内部计算的最大大小不符合应用程序的布局需求时,才应该调用此方法。
        参数
        maxWidth - 最大宽度的覆盖值
        maxHeight - 最大高度的覆盖值
        另请参见:
        setMaxWidth(double)setMaxHeight(double)
      • getShape

        public final Shape getShape​()
        获取属性形状的值。
        Property description:
        指定时, Shape将使该区域呈现为指定的形状,而不是圆角矩形。 当为空时,Region将被渲染为圆角矩形。 当渲染为Shape时,任何背景都用于填充形状,尽管任何背景插入将被忽略,如背景半径。 定义的任何BorderStrokes用于抚摸形状。 任何BorderImages都被忽略。
        Default value:
        空值
        从以下版本开始:
        JavaFX 8.0
      • setShape

        public final void setShape​(Shape value)
        设置属性形状的值。
        Property description:
        指定时, Shape将导致该区域被渲染为指定的形状而不是圆角矩形。 当为空时,Region将被渲染为圆角矩形。 当渲染为Shape时,任何背景都用于填充形状,尽管任何背景插入将被忽略,如背景半径。 定义的任何BorderStrokes用于抚摸形状。 任何BorderImages都被忽略。
        Default value:
        空值
        从以下版本开始:
        JavaFX 8.0
      • shapeProperty

        public final ObjectProperty<Shape> shapeProperty​()
        指定时, Shape将导致该区域被渲染为指定的形状而不是圆角矩形。 当为空时,Region将被渲染为圆角矩形。 当渲染为Shape时,任何背景都用于填充形状,尽管任何背景插入将被忽略,如背景半径。 定义的任何BorderStrokes用于抚摸形状。 任何BorderImages都被忽略。
        Default value:
        空值
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        getShape()setShape(Shape)
      • setScaleShape

        public final void setScaleShape​(boolean value)
        设置属性scaleShape的值。
        Property description:
        指定是否将形状(如果已定义)缩放以匹配“区域”的大小。 true表示形状缩放以适应区域的大小, false表示形状为其源尺寸,其定位取决于centerShape的值。
        Default value:
        真正
        从以下版本开始:
        JavaFX 8.0
      • isScaleShape

        public final boolean isScaleShape​()
        获取属性scaleShape的值。
        Property description:
        指定是否将形状(如果已定义)缩放以匹配“区域”的大小。 true表示形状缩放以适应区域的大小, false表示形状为其源尺寸,其定位取决于centerShape的值。
        Default value:
        真正
        从以下版本开始:
        JavaFX 8.0
      • scaleShapeProperty

        public final BooleanProperty scaleShapeProperty​()
        指定是否将形状(如果已定义)缩放以匹配“区域”的大小。 true是指缩放形状以适应区域的大小, false表示形状为其源尺寸,其定位取决于centerShape的值。
        Default value:
        真正
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        isScaleShape()setScaleShape(boolean)
      • setCenterShape

        public final void setCenterShape​(boolean value)
        设置属性centerShape的值。
        Property description:
        定义形状是否位于区域的宽度或高度内。 true是指以区域宽度和高度为中心的形状, false表示形状位于其源位置。
        Default value:
        真正
        从以下版本开始:
        JavaFX 8.0
      • isCenterShape

        public final boolean isCenterShape​()
        获取属性centerShape的值。
        Property description:
        定义形状是否位于区域的宽度或高度内。 true是指以区域宽度和高度为中心的形状, false表示形状位于其源位置。
        Default value:
        真正
        从以下版本开始:
        JavaFX 8.0
      • centerShapeProperty

        public final BooleanProperty centerShapeProperty​()
        定义形状是否位于区域的宽度或高度内。 true是指以区域宽度和高度为中心的形状, false表示形状位于其源位置。
        Default value:
        真正
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        isCenterShape()setCenterShape(boolean)
      • setCacheShape

        public final void setCacheShape​(boolean value)
        设置属性cacheShape的值。
        Property description:
        定义对系统的提示,指出用于定义区域背景的Shape是稳定的,可以从缓存中受益。
        Default value:
        真正
        从以下版本开始:
        JavaFX 8.0
      • isCacheShape

        public final boolean isCacheShape​()
        获取属性cacheShape的值。
        Property description:
        定义对系统的提示,指出用于定义区域背景的Shape是稳定的,可以从缓存中受益。
        Default value:
        真正
        从以下版本开始:
        JavaFX 8.0
      • cacheShapeProperty

        public final BooleanProperty cacheShapeProperty​()
        定义对系统的提示,指出用于定义区域背景的Shape是稳定的,可以从缓存中受益。
        Default value:
        真正
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        isCacheShape()setCacheShape(boolean)
      • minWidth

        public final double minWidth​(double height)
        在布局期间调用以确定此节点的最小宽度。 computeMinWidth(forHeight)返回值,除非应用程序通过设置minWidth属性来覆盖最小宽度。
        重写:
        minWidthParent
        参数
        height - 如果最小宽度取决于应该使用的高度
        结果
        在布局期间该节点应该调整大小的最小宽度
        另请参见:
        setMinWidth(double)
      • minHeight

        public final double minHeight​(double width)
        在布局期间调用以确定此节点的最小高度。 computeMinHeight(forWidth)返回值,除非应用程序通过设置minHeight属性来覆盖最小高度。
        重写:
        minHeightParent
        参数
        width - 如果最小高度取决于应该使用的宽度
        结果
        在布局期间该节点应该调整大小的最小高度
        另请参见:
        setMinHeight(double)
      • prefWidth

        public final double prefWidth​(double height)
        在布局期间调用以确定此节点的首选宽度。 返回值为computePrefWidth(forHeight)除非应用程序通过设置prefWidth属性来覆盖首选宽度。
        重写:
        prefWidthParent
        参数
        height - 如果首选宽度取决于应该使用的高度
        结果
        在布局期间该节点应该调整大小的首选宽度
        另请参见:
        setPrefWidth(double)
      • prefHeight

        public final double prefHeight​(double width)
        在布局期间调用以确定此节点的首选高度。 computePrefHeight(forWidth)返回值,除非应用程序通过设置prefHeight属性来覆盖首选高度。
        重写:
        prefHeightParent
        参数
        width - 如果首选的高度取决于应该使用的宽度
        结果
        在布局期间该节点应该调整大小的首选高度
        另请参见:
        setPrefHeight(double)
      • maxWidth

        public final double maxWidth​(double height)
        在布局期间调用以确定此节点的最大宽度。 computeMaxWidth(forHeight)返回值,除非应用程序通过设置maxWidth属性来覆盖最大宽度。
        重写:
        maxWidthNode
        参数
        height - 如果最大宽度取决于它应该使用的高度
        结果
        在布局期间该节点应该调整大小的最大宽度
        另请参见:
        setMaxWidth(double)
      • maxHeight

        public final double maxHeight​(double width)
        在布局期间调用以确定此节点的最大高度。 computeMaxHeight(forWidth)返回值,除非应用程序通过设置maxHeight属性来覆盖最大高度。
        重写:
        maxHeightNode
        参数
        width - 如果最大高度取决于应该使用的宽度
        结果
        在布局期间该节点应该调整大小的最大高度
        另请参见:
        setMaxHeight(double)
      • computeMinWidth

        protected double computeMinWidth​(double height)
        计算该区域的最小宽度。 默认情况下返回左和右插入的总和。 区域子类应该覆盖此方法,以根据其内容和布局策略返回适当的值。 如果子类没有VERTICAL内容偏差,则可以忽略height参数。
        重写:
        computeMinWidthParent
        参数
        height - 如果最小宽度取决于它应该使用的高度
        结果
        计算出该区域的最小宽度
      • computeMinHeight

        protected double computeMinHeight​(double width)
        计算该区域的最小高度。 默认返回顶部和底部插入的总和。 区域子类应该覆盖此方法,以根据其内容和布局策略返回适当的值。 如果子类没有HORIZONTAL内容偏差,则可以忽略width参数。
        重写:
        computeMinHeightParent
        参数
        width - 如果最小高度取决于应该使用的宽度
        结果
        计算该区域的最小高度
      • computePrefWidth

        protected double computePrefWidth​(double height)
        计算给定高度的该区域的首选宽度。 区域子类应该覆盖此方法,以根据其内容和布局策略返回适当的值。 如果子类没有VERTICAL内容偏差,则可以忽略height参数。
        重写:
        computePrefWidthParent
        参数
        height - 如果首选宽度取决于应该使用的高度
        结果
        计算这个区域的首选宽度
      • computePrefHeight

        protected double computePrefHeight​(double width)
        计算给定宽度的该区域的首选高度; 区域子类应该覆盖此方法,以根据其内容和布局策略返回适当的值。 如果子类没有HORIZONTAL内容偏差,则可以忽略width参数。
        重写:
        computePrefHeightParent
        参数
        width - 如果首选的高度取决于应该使用的宽度
        结果
        该区域计算的优选高度
      • computeMaxWidth

        protected double computeMaxWidth​(double height)
        计算此区域的最大宽度。 默认情况下返回Double.MAX_VALUE。 区域子类可以覆盖此方法,以根据其内容和布局策略返回不同的值。 如果子类没有VERTICAL内容偏差,则可以忽略height参数。
        参数
        height - 区域的高度,以防该值可能决定最大宽度
        结果
        该区域的计算最大宽度
      • computeMaxHeight

        protected double computeMaxHeight​(double width)
        计算该区域的最大高度。 默认情况下返回Double.MAX_VALUE。 区域子类可以覆盖此方法以根据其内容和布局策略返回不同的值。 如果子类没有HORIZONTAL内容偏差,则可以忽略width参数。
        参数
        width - 区域的宽度,以防该值可能指定最大高度
        结果
        计算出该区域的最大高度
      • snapSpace

        @Deprecated(since="9")
        protected double snapSpace​(double value)
        已过时。 snapSpaceX()snapSpaceY()取代
        如果该区域的snapToPixel属性为false,则此方法返回相同的值,否则它会尝试将值舍入到最近的像素,但是由于没有指示值是垂直还是水平测量,因此可能会被捕捉到具有不同水平和垂直刻度的屏幕上错误的像素尺寸公制。
        参数
        value - 要捕获的空间值
        结果
        值舍入到最近的像素
      • snapSpaceX

        public double snapSpaceX​(double value)
        如果此区域的snapToPixel属性为true,则返回一个舍入为水平方向最近像素的值,否则返回相同的值。
        参数
        value - 要拍摄的空间值
        结果
        值舍入到最近的像素
        从以下版本开始:
        9
      • snapSpaceY

        public double snapSpaceY​(double value)
        如果该区域的snapToPixel属性为true,则返回一个四舍五入到垂直方向上最近的像素的值,否则返回相同的值。
        参数
        value - 要拍摄的空间值
        结果
        值舍入到最近的像素
        从以下版本开始:
        9
      • snapSize

        @Deprecated(since="9")
        protected double snapSize​(double value)
        已过时。 替换为snapSizeX()snapSizeY()
        如果该区域的snapToPixel属性为false,则此方法返回相同的值,否则它会尝试将值舍弃为最近的像素,但是由于没有指示值是垂直还是水平测量,因此可能会被捕捉到具有不同水平和垂直刻度的屏幕上错误的像素尺寸公制。
        参数
        value - 要拍摄的大小值
        结果
        值被忽略到最近的像素
      • snapSizeX

        public double snapSizeX​(double value)
        如果此区域的snapToPixel属性为true,则返回一个值,该值将被忽略到水平方向上最近的像素,否则返回相同的值。
        参数
        value - 要拍摄的大小值
        结果
        值被忽略到最近的像素
        从以下版本开始:
        9
      • snapSizeY

        public double snapSizeY​(double value)
        如果此区域的snapToPixel属性为true,则返回一个值,该值将被忽略到垂直方向上最近的像素,否则返回相同的值。
        参数
        value - 要拍摄的大小值
        结果
        值被忽略到最近的像素
        从以下版本开始:
        9
      • snapPosition

        @Deprecated(since="9")
        protected double snapPosition​(double value)
        已过时。 替换为snapPositionX()snapPositionY()
        如果该区域的snapToPixel属性为false,则此方法返回相同的值,否则它会尝试将值舍入到最近的像素,但是由于没有指示值是垂直还是水平测量,因此可能会被捕捉到具有不同水平和垂直刻度的屏幕上错误的像素尺寸公制。
        参数
        value - 要 value的位置值
        结果
        值舍入到最近的像素
      • snapPositionX

        public double snapPositionX​(double value)
        如果此区域的snapToPixel属性为true,则返回一个舍入为水平方向最近像素的值,否则返回相同的值。
        参数
        value - 要 value的位置值
        结果
        值舍入到最近的像素
        从以下版本开始:
        9
      • snapPositionY

        public double snapPositionY​(double value)
        如果该区域的snapToPixel属性为true,则返回一个四舍五入到垂直方向上最近的像素的值,否则返回相同的值。
        参数
        value - 要 value的位置值
        结果
        值舍入到最近的像素
        从以下版本开始:
        9
      • snappedTopInset

        public final double snappedTopInset​()
        获取包含填充和边框插入的顶层插图的实用方法。 如果isSnapToPixel()为true,则拍摄到整个像素。
        结果
        圆顶顶
        从以下版本开始:
        JavaFX 8.0
      • snappedBottomInset

        public final double snappedBottomInset​()
        获取底部插图的实用方法,其中包括填充和边框插入。 如果isSnapToPixel()为true,则拍摄到整个像素。
        结果
        倒圆角的底部
        从以下版本开始:
        JavaFX 8.0
      • snappedLeftInset

        public final double snappedLeftInset​()
        获取包含填充和边框插入的左边插图的实用方法。 如果isSnapToPixel()为true,则拍摄到整个像素。
        结果
        向左舍入
        从以下版本开始:
        JavaFX 8.0
      • snappedRightInset

        public final double snappedRightInset​()
        获取正确的插图的实用方法,包括填充和边框插入。 如果isSnapToPixel()为true,则拍摄到整个像素。
        结果
        圆形插图正确
        从以下版本开始:
        JavaFX 8.0
      • positionInArea

        protected void positionInArea​(Node child,
                                      double areaX,
                                      double areaY,
                                      double areaWidth,
                                      double areaHeight,
                                      double areaBaselineOffset,
                                      HPos halignment,
                                      VPos valignment)
        通过定义哪个位置该区域的区域内的子工具方法areaXareaYareaWidth X areaHeight ,与基线偏移相对于该区域。

        此功能调整节点和使用节点的布局界限的宽度和高度,以决定应如何定位的区域内。

        如果垂直对齐是VPos.BASELINE那么它将定位节点,使其自己的基线与baselineOffset传递的基线对齐,否则基线参数将被忽略。

        如果该区域的snapToPixeltrue ,那么x / y位置值将舍入为最接近的像素边界。

        参数
        child - 孩子被定位在这个区域内
        areaX - 相对于该区域的布局区域的水平偏移
        areaY - 相对于该区域的布局区域的垂直偏移
        areaWidth - 布局区域的宽度
        areaHeight - 布局区域的高度
        areaBaselineOffset - 如果VPos为基线,则使用的基线偏移量
        halignment - 区域内儿童的水平对齐方式
        valignment - 区域内儿童的垂直对齐方式
      • positionInArea

        public static void positionInArea​(Node child,
                                          double areaX,
                                          double areaY,
                                          double areaWidth,
                                          double areaHeight,
                                          double areaBaselineOffset,
                                          Insets margin,
                                          HPos halignment,
                                          VPos valignment,
                                          boolean isSnapToPixel)
        通过定义哪个位置该区域的区域内的子工具方法areaXareaYareaWidth X areaHeight ,与基线偏移相对于该区域。

        此功能调整节点和使用节点的布局界限的宽度和高度,以决定应如何定位的区域内。

        如果垂直对齐是VPos.BASELINE那么它将定位节点,使其自己的基线与baselineOffset传递的基线对齐,否则基线参数将被忽略。

        如果该区域的snapToPixeltrue ,则x / y位置值将被舍入到最接近的像素边界。

        如果margin为非空值,则该空间将在布局区域内的小孩周围分配。 保证金可能为空。

        参数
        child - 孩子被定位在这个区域内
        areaX - 相对于该区域的布局区域的水平偏移
        areaY - 相对于该区域的布局区域的垂直偏移
        areaWidth - 布局区域的宽度
        areaHeight - 布局区域的高度
        areaBaselineOffset - 如果VPos为基线,则使用的基线偏移量
        margin - 要在孩子周围分配的空间余量
        halignment - 区域内儿童的水平对齐
        valignment - 区域内儿童的垂直对齐方式
        isSnapToPixel - 是否将尺寸和位置 isSnapToPixel到像素
        从以下版本开始:
        JavaFX 8.0
      • layoutInArea

        protected void layoutInArea​(Node child,
                                    double areaX,
                                    double areaY,
                                    double areaWidth,
                                    double areaHeight,
                                    double areaBaselineOffset,
                                    HPos halignment,
                                    VPos valignment)
        其中规定了子由所限定的本地区的区域内实用方法areaXareaYareaWidth X areaHeight ,与基线偏移相对于该区域。

        如果孩子可调整大小,则该方法将调整其大小以填充指定的区域,除非该节点的最大大小阻止它。 如果节点的最大大小偏好小于区域大小,则将使用最大大小。 如果节点的最大值大于区域大小,则节点将被调整大小以适合该区域,除非它的最小大小阻止它。

        如果孩子有一个非空的contentBias,那么这个方法将在调整小孩时使用它。 如果contentBias是水平的,它将首先将其宽度设置为区域的宽度(直到孩子的最大宽度限制),然后传递该值以计算孩子的高度。 如果孩子的contentBias是垂直的,那么它将把它的高度设置为区域高度(最高到孩子的最大高度限制),并传递该高度来计算孩子的宽度。 如果孩子的contentBias为null,那么它的width和height没有彼此的依赖关系。

        如果孩子不能调整大小(Shape,Group等),那么它只能被定位,而不是调整大小。

        如果小孩的大小与区域的大小不同(由于它不是可调整大小,或者是调整大小偏好设置),那么这个函数将使用水平和垂直对齐值来对齐节点。 如果取值为VPos.BASELINE则节点的基线将与区域基线偏移参数对齐,否则基线参数将被忽略。

        如果该区域的snapToPixeltrue ,则所得到的x,y值将被舍入到其最近的像素边界,并且宽/高值将被忽略到下一个像素边界。

        参数
        child - 孩子被定位在这个区域内
        areaX - 相对于该区域的布局区域的水平偏移
        areaY - 相对于该区域的布局区域的垂直偏移
        areaWidth - 布局区域的宽度
        areaHeight - 布局区域的高度
        areaBaselineOffset - 如果 areaBaselineOffset为基线,则使用的基线偏移量
        halignment - 区域内儿童的水平对齐
        valignment - 区域内儿童的垂直对齐方式
      • layoutInArea

        protected void layoutInArea​(Node child,
                                    double areaX,
                                    double areaY,
                                    double areaWidth,
                                    double areaHeight,
                                    double areaBaselineOffset,
                                    Insets margin,
                                    HPos halignment,
                                    VPos valignment)
        其中规定了子由所限定的本地区的区域内实用方法areaXareaYareaWidth X areaHeight ,与基线偏移相对于该区域。

        如果孩子可调整大小,则该方法将调整其大小以填充指定的区域,除非该节点的最大大小阻止它。 如果节点的最大大小偏好小于区域大小,则将使用最大大小。 如果节点的最大值大于区域大小,则节点将被调整大小以适合该区域,除非它的最小大小阻止它。

        如果孩子有一个非空的contentBias,那么这个方法将在调整小孩时使用它。 如果contentBias是水平的,它将首先将其宽度设置为区域的宽度(直到孩子的最大宽度限制),然后传递该值以计算孩子的高度。 如果孩子的contentBias是垂直的,那么它将把它的高度设置为区域高度(最高到孩子的最大高度限制),并传递该高度来计算孩子的宽度。 如果孩子的contentBias为null,那么它的width和height没有彼此的依赖关系。

        如果孩子不能调整大小(Shape,Group等),那么它只能被定位,而不是调整大小。

        如果小孩的大小与区域的大小不同(由于它不是可调整大小,或者是调整大小偏好设置),那么这个函数将使用水平和垂直对齐值来对齐节点。 如果取值为VPos.BASELINE则节点的基线将与区域基线偏移参数对齐,否则基线参数将被忽略。

        如果margin为非空值,则该空间将在布局区域内的小孩周围分配。 保证金可能为空。

        如果该区域的snapToPixeltrue ,则所得到的x,y值将被舍入到其最近的像素边界,并且宽度/高度值将被忽略到下一个像素边界。

        参数
        child - 孩子被定位在这个区域内
        areaX - 相对于该区域的布局区域的水平偏移
        areaY - 相对于该区域的布局区域的垂直偏移
        areaWidth - 布局区域的宽度
        areaHeight - 布局区域的高度
        areaBaselineOffset - 如果VPos为BASELINE,则使用的基线偏移量
        margin - 要分配在孩子周围的空间余量
        halignment - 区域内儿童的水平对齐
        valignment - 区域内儿童的垂直对齐方式
      • layoutInArea

        protected void layoutInArea​(Node child,
                                    double areaX,
                                    double areaY,
                                    double areaWidth,
                                    double areaHeight,
                                    double areaBaselineOffset,
                                    Insets margin,
                                    boolean fillWidth,
                                    boolean fillHeight,
                                    HPos halignment,
                                    VPos valignment)
        其中规定了子由所限定的本地区的区域内实用方法areaXareaYareaWidth X areaHeight ,与基线偏移相对于该区域。

        如果小孩可调整大小,则此方法将使用fillWidthfillHeight来确定是否调整其大小以填充该区域或将孩子保持在其首选的尺寸。 如果fillWidth / fillHeight为true,那么此方法将仅调整小孩的大小,直到其最大大小限制。 如果节点的最大大小偏好小于区域大小,则将使用最大大小。 如果节点的最大值大于区域大小,则节点将被调整大小以适合该区域,除非它的最小大小阻止它。

        如果孩子有一个非空的contentBias,那么这个方法将在调整小孩时使用它。 如果contentBias是水平的,它将首先设置它的宽度,然后传递该值来计算孩子的高度。 如果child的contentBias是垂直的,那么它将首先设置它的高度,并传递该值来计算孩子的宽度。 如果孩子的contentBias为null,那么它的width和height没有彼此的依赖关系。

        如果孩子不能调整大小(Shape,Group等),那么它只能被定位,而不是调整大小。

        如果小孩的大小与区域的大小不同(由于它不是可调整大小,或者是调整大小偏好设置),那么这个函数将使用水平和垂直对齐值来对齐节点。 如果取值为VPos.BASELINE则节点的基线将与区域基线偏移参数对齐,否则基线参数将被忽略。

        如果margin为非空值,则该空间将在布局区域内的小孩周围分配。 保证金可能为空。

        如果snapToPixel为该区域的true ,则所得到的x,y值将舍入为最接近的像素边界,宽/高值将被忽略到下一个像素边界。

        参数
        child - 孩子被定位在这个区域内
        areaX - 相对于该区域的布局区域的水平偏移
        areaY - 相对于该区域的布局区域的垂直偏移
        areaWidth - 布局区域的宽度
        areaHeight - 布局区域的高度
        areaBaselineOffset - 如果VPOS为BASELINE,则使用的基线偏移量
        margin - 要分配给孩子的空间余量
        fillWidth - 小孩是否应调整大小以填补面积宽度或保持其首选宽度
        fillHeight - 小孩是否应该调整大小以填补区域高度或保持在其首选高度
        halignment - 区域内儿童的水平对齐
        valignment - 区域内儿童的垂直对齐方式
      • layoutInArea

        public static void layoutInArea​(Node child,
                                        double areaX,
                                        double areaY,
                                        double areaWidth,
                                        double areaHeight,
                                        double areaBaselineOffset,
                                        Insets margin,
                                        boolean fillWidth,
                                        boolean fillHeight,
                                        HPos halignment,
                                        VPos valignment,
                                        boolean isSnapToPixel)
        其中规定了儿童的它的区域内的工具方法的父通过定义areaXareaYareaWidth X areaHeight ,与基线偏移相对于该区域。

        如果孩子可调整大小,则此方法将使用fillWidthfillHeight来确定是否调整其大小以填充该区域或将孩子保持在其首选的尺寸。 如果fillWidth / fillHeight为true,那么此方法将仅调整小孩的大小,直到其最大大小限制。 如果节点的最大大小偏好小于区域大小,则将使用最大大小。 如果节点的最大值大于区域大小,则节点将被调整大小以适合该区域,除非它的最小大小阻止它。

        如果孩子有一个非空的contentBias,那么这个方法将在调整小孩时使用它。 如果contentBias是水平的,它将首先设置它的宽度,然后传递该值来计算孩子的高度。 如果child的contentBias是垂直的,那么它将首先设置它的高度,并传递该值来计算孩子的宽度。 如果孩子的contentBias为null,那么它的width和height没有彼此的依赖关系。

        如果孩子不能调整大小(Shape,Group等),那么它只能被定位,而不是调整大小。

        如果小孩的大小与区域的大小不同(由于它不是可调整大小,或者是调整大小偏好设置),那么这个函数将使用水平和垂直对齐值来对齐节点。 如果取值为VPos.BASELINE则节点的基线将与区域基线偏移参数对齐,否则基线参数将被忽略。

        如果margin为非空,则该空间将在布局区域内的小孩周围分配。 保证金可能为空。

        如果snapToPixel是该区域的true ,则所得到的x,y值将被舍入到其最近的像素边界,并且宽/高值将被忽略到下一个像素边界。

        参数
        child - 孩子被定位在这个区域内
        areaX - 相对于该区域的布局区域的水平偏移量
        areaY - 相对于该区域的布局区域的垂直偏移
        areaWidth - 布局区域的宽度
        areaHeight - 布局区域的高度
        areaBaselineOffset - 如果VPos为基线,则使用的基线偏移量
        margin - 要在孩子周围分配的空间余量
        fillWidth - 小孩是否应调整大小以填补面积宽度或保持其首选宽度
        fillHeight - 儿童是否应该调整大小以填补区域高度或保持其首选高度
        halignment - 区域内儿童的水平对齐方式
        valignment - 区域内儿童的垂直对齐方式
        isSnapToPixel - 是否将像素的大小和位置 isSnapToPixel
        从以下版本开始:
        JavaFX 8.0
      • getUserAgentStylesheet

        public String getUserAgentStylesheet​()
        实现可以通过覆盖此方法来为该Region及其子项指定其自己的用户代理样式。 除了正在使用的用户代理样式表之外,还使用了这些样式。 这为第三方提供了引入自定义控件样式的机制。

        URL是[scheme:] [// authority] [path]形式的分层URI。 如果URL没有[scheme:]组件,则该URL仅被认为是[path]组件。 [path]的任何前导的'/'字符被忽略,并且[path]被视为相对于应用程序的类路径的根的路径。

        覆盖此方法的子类不应对其调用的数量和频率采取任何特定的实现方法。 因此,非常不鼓励尝试任何类型的动态实现(即返回不同的用户代理样式表值),因为这种方法将被调用甚至无法保证。 一些JavaFX CSS实现可能会选择缓存这个响应无限期的时间,因此在调用此方法时应该不会期望。

           package com.example.javafx.app; import javafx.application.Application; import javafx.scene.Group; import javafx.scene.Scene; import javafx.stage.Stage; public class MyApp extends Application { @Override public void start(Stage stage) { Scene scene = new Scene(new Group()); scene.getStylesheets().add("/com/example/javafx/app/mystyles.css"); stage.setScene(scene); stage.show(); } public static void main(String[] args) { launch(args); } }  
        有关使用CSS与场景图的其他信息,请参阅CSS Reference Guide
        结果
        字符串URL
        从以下版本开始:
        JavaFX 8u40
      • getClassCssMetaData

        public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData​()
        结果
        与此类相关联的CssMetaData可能包括其类的CssMetaData。
        从以下版本开始:
        JavaFX 8.0