Module  javafx.controls
软件包  javafx.scene.control

Class Labeled

  • All Implemented Interfaces:
    Styleable ， EventTarget ， Skinnable
    已知直接子类：
    ButtonBase ， Cell ， Label ， TitledPane 

    @DefaultProperty("text")
public abstract class Labeled
extends Control
    标签Control是其用户界面的一部分，与其相关联的文本内容。 例如， Button个显示text ，象一个Label ，一个Tooltip ，以及许多其他的控制。

    标签也是一个方便的基类，当构建新的控件时，作为其UI的一部分，显示只读文本内容。

    示例如何在文本上方放置图形： 

       Image image = new Image(getClass().getResourceAsStream("image.png")); ImageView imageView = new ImageView(); imageView.setImage(image); Label label = new Label("text", imageView); label.setContentDisplay(ContentDisplay.TOP);
    从以下版本开始：
    JavaFX 2.0
    另请参见：
    Button ， Label ， ToggleButton

    • 构造方法详细信息

      • Labeled

        public Labeled​()
        创建一个没有文字和图形的标签

      • Labeled

        public Labeled​(String text)
        创建带有文本的标签
        参数
        text - 标签的文字。

      • Labeled

        public Labeled​(String text,
               Node graphic)
        创建带有文本和图形的标签
        参数
        text - 标签的文本。
        graphic - 标签的图形。

    • 方法详细信息

      • setText

        public final void setText​(String value)
        设置属性文本的值。
        Property description:
        要在标签中显示的文字。 文本可能为null。

      • getText

        public final String getText​()
        获取属性文本的值。
        Property description:
        要在标签中显示的文字。 文本可能为null。

      • setAlignment

        public final void setAlignment​(Pos value)
        设置属性对齐的值。
        Property description:
        指定Labeled内的空格时如何对齐Labeled中的文本和图形。

      • getAlignment

        public final Pos getAlignment​()
        获取属性对齐的值。
        Property description:
        指定Labeled内的空格时如何对齐Labeled中的文本和图形。

      • setTextAlignment

        public final void setTextAlignment​(TextAlignment value)
        设置textAlignment属性的值。
        Property description:
        指定 文本行多 行时的文本行的行为与影响图形和文本的 contentDisplayProperty()不同，此设置仅影响文本边界的多行文本。

      • getTextAlignment

        public final TextAlignment getTextAlignment​()
        获取属性textAlignment的值。
        Property description:
        指定 文本行多 行时的文本行行为不同于影响图形和文本的 contentDisplayProperty() ，此设置仅影响文本边界的多行文本。

      • setTextOverrun

        public final void setTextOverrun​(OverrunStyle value)
        设置textOverrun属性的值。
        Property description:
        指定 Labeled的文本超过可用空间进行渲染时使用的行为。

      • getTextOverrun

        public final OverrunStyle getTextOverrun​()
        获取textOverrun属性的值。
        Property description:
        指定 Labeled的文本超过可用空间来呈现文本时使用的行为。

      • ellipsisStringProperty

        public final StringProperty ellipsisStringProperty​()
        指定在文本被截断时为省略号显示的字符串。 Ellipsis Table Examples "..." Default value for most locales " . . . " " [...] " "\u2026" The Unicode ellipsis character '…' "" No ellipsis, just display the truncated string

        请注意，并非所有字体都支持所有Unicode字符。

        从以下版本开始：
        JavaFX 2.2
        另请参见：
        getEllipsisString() ， setEllipsisString(String)

      • setEllipsisString

        public final void setEllipsisString​(String value)
        设置属性ellipsisString的值。
        Property description:
        指定在文本被截断时为省略号显示的字符串。 Ellipsis Table Examples "..." Default value for most locales " . . . " " [...] " "\u2026" The Unicode ellipsis character '…' "" No ellipsis, just display the truncated string

        请注意，并非所有字体都支持所有Unicode字符。

        从以下版本开始：
        JavaFX 2.2

      • getEllipsisString

        public final String getEllipsisString​()
        获取属性ellipsisString的值。
        Property description:
        指定在文本被截断时为省略号显示的字符串。 Ellipsis Table Examples "..." Default value for most locales " . . . " " [...] " "\u2026" The Unicode ellipsis character '…' "" No ellipsis, just display the truncated string

        请注意，并非所有字体都支持所有Unicode字符。

        从以下版本开始：
        JavaFX 2.2

      • setWrapText

        public final void setWrapText​(boolean value)
        设置属性wrapText的值。
        Property description:
        如果文本运行超过了标签的宽度，则该变量指示文本是否应该包装到另一行。

      • isWrapText

        public final boolean isWrapText​()
        获取propertyTextText的值。
        Property description:
        如果文本运行超过了标签的宽度，则该变量指示文本是否应该包装到另一行。

      • fontProperty

        public final ObjectProperty<Font> fontProperty​()
        用于标签中文本的默认字体。 如果Label的文本是富文本，则根据嵌入在富文本中的字体信息，可能会使用或不使用该字体，但是在任何需要默认字体的情况下，将使用该字体。
        另请参见：
        getFont() ， setFont(Font)

      • setFont

        public final void setFont​(Font value)
        设置属性字体的值。
        Property description:
        用于标签中文本的默认字体。 如果Label的文本是富文本，则根据嵌入在富文本中的字体信息，可能会使用或不使用该字体，但是在任何需要默认字体的情况下，将使用该字体。

      • getFont

        public final Font getFont​()
        获取属性字体的值。
        Property description:
        用于标签中文本的默认字体。 如果Label的文本是富文本，则根据嵌入在富文本中的字体信息，可能会使用或不使用该字体，但是在任何需要默认字体的情况下，将使用该字体。

      • setGraphic

        public final void setGraphic​(Node value)
        设置属性图形的值。
        Property description:
        标签的可选图标。 这可以通过使用setContentDisplay(javafx.scene.control.ContentDisplay)相对于文本进行定位 。 为此变量指定的节点不能出现在场景图中的其他IllegalArgumentException ，否则抛出IllegalArgumentException 。 有关详细信息，请参阅Node的类描述。

      • getGraphic

        public final Node getGraphic​()
        获取属性图形的值。
        Property description:
        标签的可选图标。 这可以通过使用setContentDisplay(javafx.scene.control.ContentDisplay)相对于文本进行定位 。 为此变量指定的节点不能出现在场景图中的其他IllegalArgumentException ，否则抛出IllegalArgumentException 。 有关详细信息，请参阅Node的类描述。

      • setUnderline

        public final void setUnderline​(boolean value)
        设置属性下划线的值。
        Property description:
        是否所有文本都应加下划线。

      • isUnderline

        public final boolean isUnderline​()
        获取属性下划线的值。
        Property description:
        是否所有文本都应加下划线。

      • setLineSpacing

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

      • getLineSpacing

        public final double getLineSpacing​()
        获取属性lineSpacing的值。
        Property description:
        指定行之间的像素间距。
        从以下版本开始：
        JavaFX 8.0

      • setContentDisplay

        public final void setContentDisplay​(ContentDisplay value)
        设置属性contentDisplay的值。
        Property description:
        指定图形相对于文本的位置。

      • getContentDisplay

        public final ContentDisplay getContentDisplay​()
        获取属性contentDisplay的值。
        Property description:
        指定图形相对于文本的位置。

      • labelPaddingProperty

        public final ReadOnlyObjectProperty<Insets> labelPaddingProperty​()
        标签周围的文字和图形内容。 默认情况下labelPadding为Insets.EMPTY，不能设置为null。 子类可以在该填充之外添加节点，并在Labeled的填充内添加节点。 此属性只能从CSS设置。
        另请参见：
        getLabelPadding()

      • getLabelPadding

        public final Insets getLabelPadding​()
        获取属性labelPadding的值。
        Property description:
        标签周围的文字和图形内容。 默认情况下labelPadding为Insets.EMPTY，不能设置为null。 子类可以在该填充之外添加节点，并在Labeled的填充内添加节点。 此属性只能从CSS设置。

      • setGraphicTextGap

        public final void setGraphicTextGap​(double value)
        设置属性graphicTextGap的值。
        Property description:
        图形和文字之间的空间量

      • getGraphicTextGap

        public final double getGraphicTextGap​()
        获取属性graphicTextGap的值。
        Property description:
        图形和文字之间的空间量

      • setTextFill

        public final void setTextFill​(Paint value)
        设置属性textFill的值。
        Property description:
        Paint用于填写文字。

      • getTextFill

        public final Paint getTextFill​()
        获取属性textFill的值。
        Property description:
        Paint用于填写文字。

      • setMnemonicParsing

        public final void setMnemonicParsing​(boolean value)
        设置属性mnemonicParsing的值。
        Property description:
        助记符属性启用/禁用文本解析。 如果设置为true，则将解析Label文本，以查看它是否包含助记符解析字符“_”。 当检测到助记符时，密钥组合将根据后续字符确定，并添加助记符。

        Labeled的默认值为false，但默认情况下在某些控件上启用。

      • isMnemonicParsing

        public final boolean isMnemonicParsing​()
        获取属性mnemonicParsing的值。
        Property description:
        助记符属性启用/禁用文本解析。 如果设置为true，则将解析Label文本，以查看它是否包含助记符解析字符“_”。 当检测到助记符时，密钥组合将根据后续字符确定，并添加助记符。

        Labeled的默认值为false，但默认情况下在某些控件上启用。

      • mnemonicParsingProperty

        public final BooleanProperty mnemonicParsingProperty​()
        助记符属性启用/禁用文本解析。 如果设置为true，则将解析Label文本，以查看它是否包含助记符解析字符“_”。 当检测到助记符时，密钥组合将根据后续字符确定，并添加助记符。

        Labeled的默认值为false，但默认情况下在某些控件上启用。

        另请参见：
        isMnemonicParsing() ， setMnemonicParsing(boolean)

      • toString

        public String toString​()
        说明从类别复制Node
        返回对象的字符串表示形式。
        重写：
        toString在 Node
        结果
        对象的字符串表示形式。

      • getInitialAlignment

        protected Pos getInitialAlignment​()
        返回此控件的初始对齐状态，供JavaFX CSS引擎正确设置其初始值。 该方法最初被覆盖使用Pos.CENTER_LEFT。
        结果
        该控件的初始对齐状态
        从以下版本开始：
        9

      • getClassCssMetaData

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