工坊手册

主题

EUITextLabel ​

概览 ​

字段值
KindUnit · 单位 Unit
Realmcommon

继承关系 ​

  • Unit（4 属性 / 25 函数 / 6 事件）
    • EUINodeBase（35 属性 / 12 函数 / 4 事件）
      • [EUITextLabel]（14 属性）

继承成员 ​

2 个来源 / 39 属性 / 36 函数 / 10 事件

EUITextLabel 是界面层中的文本标签控件，用于在运行时向玩家呈现可动态修改的文字内容。它提供文本内容、字体与字号设置，并支持描边、阴影、斜体以及水平与垂直对齐等外观属性，还允许分别指定文字颜色、描边颜色与阴影颜色，便于呈现标题、提示或数值信息。

适用场景 ​

适合在玩家界面的根节点下动态生成文案标签，例如展示一组随游戏状态变化的文本，并在创建后实时调整字号、颜色、描边与对齐方式使其符合当前界面风格。

使用要点 ​

先从 Players 服务获取 LocalPlayer，再用 localPlayer.PlayerGui.EuiManager:GetRootNode() 取得界面根节点，然后调用 game:GetService("World"):CreateUnit("EUITextLabel", { Parent = rootNode }) 创建标签实例。拿到实例后可直接读写 Text、TextColor、FontSize、Font、OutlineEnabled、ShadowEnabled、ItalicEnabled 等属性更新显示效果，颜色类属性用 Color.New(0, 0, 255, 255) 这样的四参数构造，对齐方式传入 Enums.EUITextHorizontalAlignment.Left、Enums.EUITextVerticalAlignment.Top 等枚举值。

注意事项 ​

EUITextLabel 是文本标签控件，通过 World:CreateUnit 创建，并把 Parent 设置为当前玩家 PlayerGui.EuiManager:GetRootNode()。文本与样式通过本页公开属性在 CreateUnit config 中初始化或赋值更新。Color 使用 0-255 RGBA 四参数构造。

代码示例 ​

创建文本标签并设置样式 ​

lua
-- @runtime client
local Players = game:GetService("Players")
local World = game:GetService("World")
local localPlayer = Players.LocalPlayer
if localPlayer == nil then return end
local rootNode = localPlayer.PlayerGui.EuiManager:GetRootNode()
local label = World:CreateUnit("EUITextLabel", {
    Parent = rootNode,
    Position = Vector2.New(0, 0),
    Size = Vector2.New(100, 40),
    Text = "任务已完成",
    FontSize = 28,
    TextColor = Color.New(255, 240, 120, 255),
})

属性 (14) ​

Name类型默认值说明
TextString""EUITextLabel 的文本属性，类型为 String，用于存放该文本标签实际显示的文字内容。
TextColorColor[255, 255, 255, 255]EUITextLabel 的文本颜色属性，类型为 Color，用于设定该文本标签中文字本身的颜色。
FontSizeInt42EUITextLabel 的字体大小属性，类型为 Int，用于控制文本标签中文字的显示尺寸。
FontTextFontTypeEnums.TextFontType.HKXZYT_W9_GBEUITextLabel 的字体属性，类型为 TextFontType，用于指定该文本标签渲染文字时所采用的字体。
OutlineEnabledBoolfalseEUITextLabel 的描边开关属性，类型为 Bool，用于决定该文本标签的文字是否启用描边效果。
OutlineColorColor[0, 0, 0, 0]EUITextLabel 的描边颜色属性，类型为 Color，用于设定该文本标签文字描边的颜色。
OutlineWidthInt1EUITextLabel 的描边宽度属性，类型为 Int，用于设定该文本标签文字描边的粗细。
OutlineOpacityFloat1.0EUITextLabel 的描边透明度属性，类型为 Float，用于控制该文本标签文字描边的透明程度。
ShadowEnabledBoolfalseEUITextLabel 的阴影开关属性，类型为 Bool，用于决定该文本标签的文字是否启用阴影效果。
ShadowColorColor[0, 0, 0, 0]EUITextLabel 的阴影颜色属性，类型为 Color，用于设定该文本标签文字阴影的颜色。
ShadowOffsetVector2[1, 1]EUITextLabel 的 ShadowOffset 属性，类型为 Vector2，用于描述文本阴影相对文字本体的偏移量。它属于 EUITextLabel 的文本外观配置项之一，与 EUITextLabel 上的 ShadowEnabled、ShadowColor 等阴影相关属性共同决定文本阴影的呈现方式。
ItalicEnabledBoolfalseEUITextLabel 的斜体开关属性，类型为 Bool，用于决定该文本标签的文字是否以斜体样式呈现。
TextHorizontalAlignmentEUITextHorizontalAlignmentEnums.EUITextHorizontalAlignment.LeftEUITextLabel 的水平对齐属性，类型为 EUITextHorizontalAlignment，用于控制文本在标签范围内的水平对齐方式。
TextVerticalAlignmentEUITextVerticalAlignmentEnums.EUITextVerticalAlignment.TopEUITextLabel 的垂直对齐属性，类型为 EUITextVerticalAlignment，用于控制文本在标签范围内的垂直对齐方式。

关联类型 ​