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