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

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

使用

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

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

在这里插入图片描述
在这里插入图片描述

max_lines_visiblevisible_characters都是为-1的时候禁用,默认也为-1

猜你喜欢

转载自blog.csdn.net/ddd999ppp/article/details/83379933