UITextLabel

继承自:

• UIComponent

描述

文本组件。用于在UI中显示文本内容

属性

ColorQuad  TitleColor
文本颜色设置。控制文本标签中显示文字的颜色，默认值为黑色(0,0,0,255)

TextVAlignment  TextVAlignment
文本垂直对齐方式

TextHAlignment  TextHAlignment
文本水平对齐方式

int  FontSize
文本字体大小。取值范围1-120，默认值为18

string  Title
文本内容

AutoSizeType  IsAutoSize
是否启用自动调整文本大小。控制文本标签是否根据文本内容自动调整节点大小，默认值为不启用自动调整文本大小

bool  OutlineEnable
是否启用文本描边效果。控制文本是否显示描边边框，默认值为关闭

ColorQuad  OutlineColor
描边颜色设置。默认值为黑色(0,0,0,255)

int  OutlineSize
文本描边边框宽度设置。默认值为1

bool  ShadowEnable
是否启用文本阴影效果。默认值为关闭

ColorQuad  ShadowColor
阴影颜色设置。默认值为黑色(0,0,0,255)

Vector2  ShadowOffset
阴影偏移设置。控制文本阴影相对于文本的偏移位置，默认值为(0,0)

bool  RichText
是否启用富文本模式。默认值为关闭

int  LineSpacing
行间距设置。默认值为3

bool  AutoTranslator
是否启用自动翻译功能。控制文本是否根据当前语言设置自动翻译，默认值为关闭

int  LetterSpacing
字符间距设置。控制文本中各个字符之间的水平间距，默认值为0

成员函数

Vector2  GetTextSize ()
获取文本实际尺寸。返回当前文本内容渲染后的实际宽度和高度

代码示例

-- 创建文本标签组件
local root = SandboxNode.new('UIRoot', game.Workspace)
local label = SandboxNode.new('UITextLabel', root)
-- 设置文本内容
label.Title = "商店"
-- 设置文本颜色为红色
label.TitleColor = ColorQuad.new(255, 0, 0, 255)
-- 设置位置和尺寸
label.Position = Vector2.new(75, 50)
label.Size = Vector2.new(200, 50)
-- 设置字体大小为18
label.FontSize = 18
-- 设置文本垂直居中对齐
label.TextVAlignment = Enum.TextVAlignment.Center
-- 设置文本水平左对齐
label.TextHAlignment = Enum.TextHAlignment.Left
-- 启用自动调整大小功能
label.IsAutoSize = Enum.AutoSizeType.BOTH
-- 启用文本描边效果
label.OutlineEnable = true
label.OutlineColor = ColorQuad.new(0, 0, 0, 255)
label.OutlineSize = 2
-- 启用文本阴影效果
label.ShadowEnable = true
label.ShadowColor = ColorQuad.new(0, 0, 0, 128)
label.ShadowOffset = Vector2.new(2, 2)
-- 获取文本实际渲染尺寸
local size = label:GetTextSize()
print("文本尺寸:x=", size.x, "y=", size.y)