Godot Engine 学习笔记 Label

xiaoxiao2025-07-18  9

Label

Label简要说明成员函数成员变量枚举说明成员函数说明使用

Label

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

简要说明

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

成员函数

返回类型函数intget_line_count ( ) constintget_line_height ( ) constintget_total_character_count ( ) constintget_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

转载请注明原文地址: https://www.6miu.com/read-5033282.html

最新回复(0)