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

Class Text

  • All Implemented Interfaces:
    StyleableEventTarget


    @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并实现从右到左的方向,而不使用自动转换。

        重写:
        usesMirroringNode
        结果
        如果这个 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.BASELINEVPos.TOP定义顶行的原点,而VPos.BOTTOM定义了底行的原点。
        Default value:
        VPos.BASELINE
      • getTextOrigin

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

        public final ObjectProperty<VPos> textOriginProperty​()
        以局部坐标定义文本坐标系的起点。 注意:如果渲染多行VPos.BASELINEVPos.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的值。
        重写:
        getBaselineOffsetNode
        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对象的字符串表示形式。
        重写:
        toStringNode
        结果
        这个 Text对象的字符串表示形式。
      • queryAccessibleAttribute

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

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

        重写:
        queryAccessibleAttributeNode
        参数
        attribute - 请求的属性
        parameters - 可选参数列表
        结果
        请求的属性的值
        另请参见:
        AccessibleAttribute