标签

Inherits: Control < CanvasItem < Node < Object

类别: 核心

简要说明

在一行中显示纯文本或在矩形内换行。对于格式化文本,请使用 RichTextLabel .

主题属性

Font

字体

Color

font_color

颜色(1,1,1,1)

Color

font_color_shadow

颜色(0,0,0,0)

Color

font_outline_modulate

颜色(1,1,1,1)

int

line_spacing

3

StyleBox

正常的

int

shadow_as_outline

0

int

shadow_offset_x

1

int

shadow_offset_y

1

枚举

枚举 排列

  • ALIGN_LEFT = 0 ---将行左对齐(默认)。

  • ALIGN_CENTER = 1 ---行居中对齐。

  • ALIGN_RIGHT = 2 ---将行右对齐。

  • ALIGN_FILL = 3 ---展开行空白以适应宽度。

枚举 VAlign

  • VALIGN_TOP = 0 ---将整个文本顶端对齐。

  • VALIGN_CENTER = 1 ---将整个文本居中对齐。

  • VALIGN_BOTTOM = 2 ---将整个文本底端对齐。

  • VALIGN_FILL = 3 ---通过展开行来对齐整个文本。

描述

标签在屏幕上显示纯文本。它允许您控制水平和垂直对齐,并且可以将文本包装在节点的边框内。它不支持粗体、斜体或其他格式。为此,请使用 RichTextLabel 相反。

注: 与大多数其他人相反 Control S,标签 Control.mouse_filter 默认为 Control.MOUSE_FILTER_IGNORE (即,它不响应鼠标输入事件)。这意味着标签不会显示任何已配置的 Control.hint_tooltip ,除非您更改其鼠标筛选器。

属性描述

违约

0

设定器

设置对齐(值)

吸气剂

获取对齐()

控制文本的水平对齐。支持左、中、右和填充或对齐。将其设置为 ALIGN_* 常量。

违约

设定器

设置自动换行(值)

吸气剂

具有自动换行符()。

如果 true ,将文本包装在节点的边框内。如果调整节点的大小,它将自动更改其高度以显示所有文本。

违约

设定器

设置剪辑文本(值)

吸气剂

正在剪切文本()

如果 true ,标签仅显示适合其边框的文本。它还允许您自由地向下扩展节点。

  • int lines_skipped

违约

0

设定器

设置跳过的行数(值)

吸气剂

获取行跳过()。

节点忽略第一个 lines_skipped 开始显示文本前的行。

  • int max_lines_visible

违约

-1

设定器

设置“最大线条”可见(值)

吸气剂

获取u max u lines u visible()。

限制节点在屏幕上显示的文本行。

违约

1.0

设定器

设置“可见百分比”(值)

吸气剂

获取可见的百分比()。

限制可见字符的计数。如果你准备好了 percent_visible 到50,屏幕上最多只能显示文本的一半字符。用于在对话框中设置文本动画。

违约

设定器

设置文本(值)

吸气剂

获取文本()

要在屏幕上显示的文本。

违约

设定器

设置大写(值)

吸气剂

是大写的

如果 true ,所有文本都显示为大写。

违约

0

设定器

设置有效(值)

吸气剂

获取有效信息()

控制文本的垂直对齐。支持顶部、中心、底部和填充。将其设置为 VALIGN_* 常量。

  • int visible_characters

违约

-1

设定器

设置可见字符(值)

吸气剂

获取u可见的u字符()

限制要显示的字符数。设置为-1以禁用。

方法说明

  • int get_line_count ( ) const

返回标签的文本行数。

  • int get_line_height ( ) const

返回以像素为单位的字体大小。

  • int get_total_character_count ( ) const

返回文本中可打印字符的总数(不包括空格和换行符)。

  • int get_visible_line_count ( ) const

返回显示的行数。如果 Label 的高度当前无法显示所有行。