Label
继承
简要描述
在一行中显示纯文本或在矩形中显示。格式化文本需要使用RichTextLabel.
描述
标签在屏幕上显示纯文本。它让你控制水平，垂直对其，wrap文本在节点的包围长方形内。
注意：与大多数其他Control相反，Label的[成员Control.mouse_filter]缺省为Control.MOUSE_FILTER_IGNORE（即，它对鼠标输入事件没有反应）。这表示label不能显示任何配置的Control.hint_tooltip，除非你改变鼠标filter。
成员
| 类型 | 属性名 | 默认值 |
|---|---|---|
| int | align | 0 |
| bool | autowrap | false |
| bool | clip_text | false |
| int | lines_skipped | 0 |
| int | max_lines_visible | -1 |
| int | mouse_filter | 2 |
| float | percent_visible | 1.0 |
| int | size_flags_vertical | 4 |
| String | text | "" |
| bool | uppercase | false |
| int | valign | 0 |
| int | visible_characters | -1 |
方法
| 返回值类型 | 方法名称 |
|---|---|
| int | get_line_count() const |
| int | get_line_height() const |
| int | get_total_character_count() const |
| int | get_visible_line_count() const |
枚举
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**
通过分散行来对齐整个文本。
常量
成员说明
- int align
| Default | 0 |
|---|---|
| setter | set_align(value) |
| getter | get_align |
- bool autowrap
| Default | false |
|---|---|
| setter | set_autowrap(value) |
| getter | has_autowrap |
- bool clip_text
| Default | false |
|---|---|
| setter | set_clip_text(value) |
| getter | is_clipping_text |
- int lines_skipped
| Default | 0 |
|---|---|
| setter | set_lines_skipped(value) |
| getter | get_lines_skipped |
- int max_lines_visible
| Default | -1 |
|---|---|
| setter | set_max_lines_visible(value) |
| getter | get_max_lines_visible |
- int mouse_filter
| Default | 2 |
|---|---|
| setter | set_mouse_filter(value) |
| getter | get_mouse_filter |
- float percent_visible
| Default | 1.0 |
|---|---|
| setter | set_percent_visible(value) |
| getter | get_percent_visible |
- int size_flags_vertical
| Default | 4 |
|---|---|
| setter | set_v_size_flags(value) |
| getter | get_v_size_flags |
- String text
| Default | "" |
|---|---|
| setter | set_text(value) |
| getter | get_text |
- bool uppercase
| Default | false |
|---|---|
| setter | set_uppercase(value) |
| getter | is_uppercase |
- int valign
| Default | 0 |
|---|---|
| setter | set_valign(value) |
| getter | get_valign |
- int visible_characters
| Default | -1 |
|---|---|
| setter | set_visible_characters(value) |
| getter | get_visible_characters |
方法说明
- get_line_count get_line_count() const
返回标签具有的文本行数。
- get_line_height get_line_height() const
返回字体大小（以像素为单位）。
- get_total_character_count get_total_character_count() const
返回文本中可打印字符的总数（不包括空格和换行符）。
- get_visible_line_count get_visible_line_count() const
返回显示的行数。