以下为我对于官方文档的翻译以及使用情况,3.0版本的文档 Label官方文档 继承: Control < CanvasItem < Node < Object 类型: Core
显示一行或包在矩形中的纯文本,对于格式化文本,使用RichTextLabel。
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_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