Godot Engine 学习笔记 Label

Label

以下为我对于官方文档的翻译以及使用情况，3.0版本的文档
Label官方文档
继承: Control < CanvasItem < Node < Object
类型: Core

简要说明

显示一行或包在矩形中的纯文本，对于格式化文本，使用RichTextLabel。

成员函数

返回类型	函数
int	get_line_count ( ) const
int	get_line_height ( ) const
int	get_total_character_count ( ) const
int	get_visible_line_count ( ) const

成员变量

• Align align - 控制文本的水平对其。支持左，中，右，填充。为其设置ALIGN_*常量中的一个。
• bool autowarp - 如果设置为true，则会使文本限制在节点的矩形边框内显示。如果你调整它节点大小，它会自动改变高度显示出所有文档。默认为：false.
• bool clip_text - 如果设置为true，标签只显示适合其边界矩形的文本。它还允许你自由地缩放节点。
• int lines_skipped - 在开始显示文本之前，该节点忽略前lines_skipped行。
• int max_lines_visible - 限制节点在屏幕上显示的文本行。
• float percent_visible - 限制可见字符的计数。如果将percent_visible设置为0.5，则只有多达一半的文本字符会显示在屏幕上。用于在对话框中的动画文本。
• String text - 要在屏幕上显示的文本。
• bool uppercase - 如果设置为true，所有文本显示为大写。
• VAlign valign - 控制文本的垂直对齐。支持顶部，中心，底部和填补。为其设置VALIGN_*常量中的一个。
• int visible_characters - 限制要显示的字符数。设置为-1禁用。

枚举

enum Align

• ALIGN_LEFT = 0 — 左对齐 (默认)。
• ALIGN_CENTER = 1 — 水平居中。
• ALIGN_RIGHT = 2 — 右对齐。
• ALIGN_FILL = 3 — 扩展行空白以适应宽度。

enum VAlign

• VALIGN_TOP = 0 — 顶部对齐。
• VALIGN_CENTER = 1 — 垂直居中
• VALIGN_BOTTOM = 2 — 底部对齐。
• VALIGN_FILL = 3 — 通过扩展行对齐整个文本。

说明

标签在屏幕上显示纯文本。它提供了对水平和垂直对齐的控制，并可以将文本封装在节点的边界矩形内。它不支持粗体、斜体或其他格式。为此，使用RichTextLabel代替。

注意，与大多数其他控件相反，Label的Control.mouse_filte默认为MOUSE_FILTER_IGNORE（即，它不对鼠标输入事件作出反应）。

成员函数说明

• int get_line_count ( ) const

返回标签的文本行数。

• int get_line_height ( ) const

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

• int get_total_character_count ( ) const

返回文本总长度。

• int get_visible_line_count ( ) const

返回所显示的行数。如果标签的高度不能显示所有的行，则返回有用的。

使用

autowarp与clip_text单个启用的时候宽度都可以收缩到像素为1（如都无启用，控件会显示所有文本），但是高度不可低于空间内文本高度，且autowarp宽度收缩到小于文本长度会出现一行空行，而autowarp与clip_text同时启用，高度和宽度都可收缩到像素为1。

percent_visible显示百分比字符数，visible_characters 限制显示字符数，Label的实际字符数为Text中字符数加2（原因没找到），空格换行不算字符数。

max_lines_visible和visible_characters都是为-1的时候禁用，默认也为-1