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

Class Text

  • All Implemented Interfaces:
    Styleable ， EventTarget 

    @DefaultProperty("text")
public class Text
extends Shape
    Text类定义了一个显示文本的节点。 段落由'\n'分隔，文本包裹在段落边界。 
      import javafx.scene.text.*;

Text t = new Text(10, 50, "This is a test");
t.setFont(new Font(20)); 
      import javafx.scene.text.*;

Text t = new Text();
text.setFont(new Font(20));
text.setText("First row\nSecond row"); 
      import javafx.scene.text.*;

Text t = new Text();
text.setFont(new Font(20));
text.setWrappingWidth(200);
text.setTextAlignment(TextAlignment.JUSTIFY)
text.setText("The quick brown fox jumps over the lazy dog");
    从以下版本开始：
    JavaFX 2.0

    • 构造方法详细信息

      • Text

        public Text​()
        创建一个空的文本实例。

      • Text

        public Text​(String text)
        创建一个包含给定字符串的文本的实例。
        参数
        text - 要包含在实例中的文本

      • Text

        public Text​(double x,
            double y,
            String text)
        在包含给定字符串的给定坐标上创建一个Text实例。
        参数
        x - 文本的水平位置
        y - 文本的垂直位置
        text - 要包含在实例中的文本

    • 方法详细信息

      • usesMirroring

        public boolean usesMirroring​()
        说明从类别复制： Node
        确定当节点方向是从右到左时是否应该镜像节点。

        当一个节点被镜像时，原点会自动移动到右上角，导致节点布局孩子，并使用镜像转换从右到左绘制。 一些节点可能希望从右到左绘制，而不使用转换。 这些节点将会回答false并实现从右到左的方向，而不使用自动转换。

        重写：
        usesMirroring在 Node
        结果
        如果这个 Node应该被镜像， Node true

      • setText

        public final void setText​(String value)
        设置属性文本的值。
        Property description:
        定义要显示的文本字符串。
        Default value:
        空字符串

      • getText

        public final String getText​()
        获取属性文本的值。
        Property description:
        定义要显示的文本字符串。
        Default value:
        空字符串

      • setX

        public final void setX​(double value)
        设置属性x的值。
        Property description:
        定义文本原点的X坐标。
        Default value:
        0

      • getX

        public final double getX​()
        获取属性x的值。
        Property description:
        定义文本原点的X坐标。
        Default value:
        0

      • setY

        public final void setY​(double value)
        设置属性y的值。
        Property description:
        定义文本原点的Y坐标。
        Default value:
        0

      • getY

        public final double getY​()
        获取属性y的值。
        Property description:
        定义文本原点的Y坐标。
        Default value:
        0

      • setFont

        public final void setFont​(Font value)
        设置属性字体的值。
        Property description:
        定义文本的字体。
        Default value:
        字体{}

      • getFont

        public final Font getFont​()
        获取属性字体的值。
        Property description:
        定义文本的字体。
        Default value:
        字体{}

      • setTextOrigin

        public final void setTextOrigin​(VPos value)
        设置属性textOrigin的值。
        Property description:
        以局部坐标定义文本坐标系的起点。 注意：如果渲染多行VPos.BASELINE和VPos.TOP定义顶行的原点，而VPos.BOTTOM定义了底行的原点。
        Default value:
        VPos.BASELINE

      • getTextOrigin

        public final VPos getTextOrigin​()
        获取属性textOrigin的值。
        Property description:
        以局部坐标定义文本坐标系的起点。 注意：如果渲染多行VPos.BASELINE和VPos.TOP定义顶行的原点，而VPos.BOTTOM定义底行的原点。
        Default value:
        VPos.BASELINE

      • textOriginProperty

        public final ObjectProperty<VPos> textOriginProperty​()
        以局部坐标定义文本坐标系的起点。 注意：如果渲染多行VPos.BASELINE和VPos.TOP定义顶行的原点，而VPos.BOTTOM定义底行的原点。
        Default value:
        VPos.BASELINE
        另请参见：
        getTextOrigin() ， setTextOrigin(VPos)

      • setBoundsType

        public final void setBoundsType​(TextBoundsType value)
        设置属性boundsType的值。
        Property description:
        确定如何计算文本节点的边界。 逻辑边界对于文本而言比视觉边界更合适。 有关详细信息，请参阅TextBoundsType 。
        Default value:
        TextBoundsType.LOGICAL

      • getBoundsType

        public final TextBoundsType getBoundsType​()
        获取属性boundsType的值。
        Property description:
        确定如何计算文本节点的边界。 逻辑边界对于文本而言比视觉边界更合适。 有关详细信息，请参阅TextBoundsType 。
        Default value:
        TextBoundsType.LOGICAL

      • setWrappingWidth

        public final void setWrappingWidth​(double value)
        设置wrapWidth属性的值。
        Property description:
        定义用户空间坐标中文本的宽度约束，例如像素，而不是字形或字符数。 如果值为> 0文本将根据需要进行行包装以满足此约束。
        Default value:
        0

      • getWrappingWidth

        public final double getWrappingWidth​()
        获取propertyWidth的值。
        Property description:
        定义用户空间坐标中文本的宽度约束，例如像素，而不是字形或字符数。 如果值为> 0文本将根据需要进行行包装以满足此约束。
        Default value:
        0

      • wrappingWidthProperty

        public final DoubleProperty wrappingWidthProperty​()
        定义用户空间坐标中文本的宽度约束，例如像素，而不是字形或字符数。 如果值为> 0文本将根据需要进行行包装以满足此约束。
        Default value:
        0
        另请参见：
        getWrappingWidth() ， setWrappingWidth(double)

      • setUnderline

        public final void setUnderline​(boolean value)
        设置属性下划线的值。
        Property description:
        定义每行文本是否应在其下方有一行。
        Default value:
        假

      • isUnderline

        public final boolean isUnderline​()
        获取属性下划线的值。
        Property description:
        定义每行文本是否应在其下方有一行。
        Default value:
        假

      • setStrikethrough

        public final void setStrikethrough​(boolean value)
        设置属性删除线的值。
        Property description:
        定义每行文本是否应该有一行。
        Default value:
        假

      • isStrikethrough

        public final boolean isStrikethrough​()
        获取属性删除线的值。
        Property description:
        定义每行文本是否应该有一行。
        Default value:
        假

      • setTextAlignment

        public final void setTextAlignment​(TextAlignment value)
        设置textAlignment属性的值。
        Property description:
        在边界框中定义水平文本对齐。 边框的宽度由最宽的行定义。 注意：在单行文本的情况下，节点的宽度由文本的宽度决定，对齐设置不起作用。
        Default value:
        TextAlignment.LEFT

      • getTextAlignment

        public final TextAlignment getTextAlignment​()
        获取属性textAlignment的值。
        Property description:
        在边界框中定义水平文本对齐。 边框的宽度由最宽的行定义。 注意：在单行文本的情况下，节点的宽度由文本的宽度决定，对齐设置不起作用。
        Default value:
        TextAlignment.LEFT

      • textAlignmentProperty

        public final ObjectProperty<TextAlignment> textAlignmentProperty​()
        在边界框中定义水平文本对齐。 边框的宽度由最宽的行定义。 注意：在单行文本的情况下，节点的宽度由文本的宽度决定，对齐设置不起作用。
        Default value:
        TextAlignment.LEFT
        另请参见：
        getTextAlignment() ， setTextAlignment(TextAlignment)

      • setLineSpacing

        public final void setLineSpacing​(double spacing)
        设置属性lineSpacing的值。
        Property description:
        定义行之间像素的垂直空间。
        Default value:
        0
        从以下版本开始：
        JavaFX 8.0

      • getLineSpacing

        public final double getLineSpacing​()
        获取属性lineSpacing的值。
        Property description:
        定义行之间像素的垂直空间。
        Default value:
        0
        从以下版本开始：
        JavaFX 8.0

      • getBaselineOffset

        public final double getBaselineOffset​()
        获取属性baselineOffset的值。
        重写：
        getBaselineOffset在 Node
        Property description:
        “文字”（或罗马）基线偏离了文本节点的layoutBounds.minY位置。 该值通常对应于字体的最大上升。
        结果
        对于不可调整大小的节点，文本基线与layoutBounds.minY的偏移量为 Node.BASELINE_OFFSET_SAME_AS_HEIGHT

      • baselineOffsetProperty

        public final ReadOnlyDoubleProperty baselineOffsetProperty​()
        “文字”（或罗马）基线偏离了文本节点的layoutBounds.minY位置。 该值通常对应于字体的最大上升。
        另请参见：
        getBaselineOffset()

      • setFontSmoothingType

        public final void setFontSmoothingType​(FontSmoothingType value)
        设置属性fontSmoothingType的值。
        Property description:
        指定所请求的字体平滑类型：灰色或LCD。 边框的宽度由最宽的行定义。 注意：LCD模式不适用于许多情况，例如各种合成模式，其中应用效果和非常大的字形。
        Default value:
        FontSmoothingType.GRAY
        从以下版本开始：
        JavaFX 2.1

      • getFontSmoothingType

        public final FontSmoothingType getFontSmoothingType​()
        获取属性fontSmoothingType的值。
        Property description:
        指定所请求的字体平滑类型：灰色或LCD。 边框的宽度由最宽的行定义。 注意：LCD模式不适用于许多情况，例如各种合成模式，其中应用效果和非常大的字形。
        Default value:
        FontSmoothingType.GRAY
        从以下版本开始：
        JavaFX 2.1

      • fontSmoothingTypeProperty

        public final ObjectProperty<FontSmoothingType> fontSmoothingTypeProperty​()
        指定所请求的字体平滑类型：灰色或LCD。 边框的宽度由最宽的行定义。 注意：LCD模式不适用于许多情况，例如各种合成模式，其中应用效果和非常大的字形。
        Default value:
        FontSmoothingType.GRAY
        从以下版本开始：
        JavaFX 2.1
        另请参见：
        getFontSmoothingType() ， setFontSmoothingType(FontSmoothingType)

      • getSelectionShape

        public final PathElement[] getSelectionShape​()
        局部坐标选择形状。
        结果
        局部坐标选择的形状
        从以下版本开始：
        9

      • setSelectionStart

        public final void setSelectionStart​(int value)
        选择开始索引的内容。 设置为-1以取消设置选择。
        参数
        value - 选择开始索引
        从以下版本开始：
        9

      • getSelectionStart

        public final int getSelectionStart​()
        获取属性selectionStart的值。
        Property description:

      • setSelectionEnd

        public final void setSelectionEnd​(int value)
        选择内容中的最终索引。 设置为-1以取消设置选择。
        参数
        value - 选择结束索引
        从以下版本开始：
        9

      • getSelectionEnd

        public final int getSelectionEnd​()
        获取属性selectionEnd的值。
        Property description:

      • setSelectionFill

        public final void setSelectionFill​(Paint paint)
        设置属性selectionFill的值。
        Property description:
        所选文字的填充颜色。
        从以下版本开始：
        9

      • getSelectionFill

        public final Paint getSelectionFill​()
        获取属性selectionFill的值。
        Property description:
        所选文字的填充颜色。
        从以下版本开始：
        9

      • getCaretShape

        public final PathElement[] getCaretShape​()
        在本地坐标中插入符号的形状。
        结果
        在本地坐标中插入符号的形状
        从以下版本开始：
        9

      • setCaretPosition

        public final void setCaretPosition​(int value)
        插入索引的内容。 设置为-1以取消设置插入符号。
        参数
        value - 内容中的插入符号索引
        从以下版本开始：
        9

      • getCaretPosition

        public final int getCaretPosition​()
        获取属性caretPosition的值。
        Property description:

      • setCaretBias

        public final void setCaretBias​(boolean value)
        插入偏见的内容。 true是指朝向主角的偏向。 （真=领先/假=尾随）
        参数
        value - 内容中的插入偏见
        从以下版本开始：
        9

      • isCaretBias

        public final boolean isCaretBias​()
        获取属性caretBias的值。
        Property description:

      • hitTest

        public final HitInfo hitTest​(Point2D point)
        将本地点映射到内容中的索引。
        参数
        point - 要测试的指定点
        结果
        一个 HitInfo代表发现的字符索引
        从以下版本开始：
        9

      • caretShape

        public final PathElement[] caretShape​(int charIndex,
                                      boolean caretBias)
        在给定的索引和偏倚上返回插入符号的形状。
        参数
        charIndex - 插入符号的字符索引
        caretBias - 插入符号是否偏向字符的 caretBias
        结果
        一个 PathElement的阵列，可以用来创建一个 Shape
        从以下版本开始：
        9

      • rangeShape

        public final PathElement[] rangeShape​(int start,
                                      int end)
        返回局部坐标中文本范围的形状。
        参数
        start - 范围的起始字符索引
        end - 范围的结束字符索引（不包含）
        结果
        一个 PathElement的数组，可以用来创建一个 Shape
        从以下版本开始：
        9

      • underlineShape

        public final PathElement[] underlineShape​(int start,
                                          int end)
        返回局部坐标下划线的形状。
        参数
        start - 范围的起始字符索引
        end - 范围的结束字符索引（不包含）
        结果
        一个 PathElement的数组，可以用来创建一个 Shape
        从以下版本开始：
        9

      • getClassCssMetaData

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

      • toString

        public String toString​()
        返回此 Text对象的字符串表示形式。
        重写：
        toString在 Node
        结果
        这个 Text对象的字符串表示形式。

      • queryAccessibleAttribute

        public Object queryAccessibleAttribute​(AccessibleAttribute attribute,
                                       Object... parameters)
        该方法由辅助技术调用以请求属性的值。

        子类通常覆盖此方法来实现特定角色所需的属性。
        如果未处理特定属性，则必须调用超类实现。

        重写：
        queryAccessibleAttribute在 Node
        参数
        attribute - 请求的属性
        parameters - 可选参数列表
        结果
        请求的属性的值
        另请参见：
        AccessibleAttribute