工坊手册

主题

EUIButton ​

EUIButton 是挂载在界面根节点下的按钮控件，提供常态、按下、禁用三态图片与三态底色，可配置按钮文字及其字体、字号和颜色，并通过拉伸区域控制不同尺寸下的显示效果。它还带有 Disabled 开关用于整体控制按钮是否可交互，点击行为可通...

概览 ​

EUIButton 是挂载在界面根节点下的按钮控件，提供常态、按下、禁用三态图片与三态底色，可配置按钮文字及其字体、字号和颜色，并通过拉伸区域控制不同尺寸下的显示效果。它还带有 Disabled 开关用于整体控制按钮是否可交互，点击行为可通过 OnClicked 订阅。

继承自 EUINodeBase；可通过 World:CreateUnit("EUIButton", ...) 创建；返回单个单位

属性 ​

名称类型默认值说明
NormalImageStringofficial://image/10000按钮常态图片写入时使用 Asset 协议字符串（如 official://image/10066）；不要把调试打印出的 official://image/... 字符串原样写回属性。
PressImageStringofficial://image/10001按钮按下图片写入时使用 Asset 协议字符串（如 official://image/10067）；不要把调试打印出的 official://image/... 字符串原样写回属性。
DisableImageStringofficial://image/10002按钮禁用图片写入时使用 Asset 协议字符串（如 official://image/10068）；不要把调试打印出的 official://image/... 字符串原样写回属性。
DisabledBoolfalse是否禁用属性，类型为 Bool，用于控制按钮是否处于禁用状态，默认值为 false。
ButtonTextString""按钮文本属性，类型为 String，用于设置按钮上显示的文字内容，默认值为空字符串。
ButtonTextFontTextFontTypeEnums.TextFontType.HKXZYT_W9_GB按钮文本字体属性，类型为 TextFontType，用于指定按钮文本所使用的字体，默认值为 hkxzyt_w9_gb.ttf。
ButtonTextFontSizeInt42按钮文本字号属性，类型为 Int，用于指定按钮文本的字体大小，默认值为 42。
ButtonTextColorColor[255, 255, 255, 255]按钮文本颜色属性，类型为 Color，用于设置按钮文本的显示颜色，默认值为 (255, 255, 255, 255)。
ButtonNormalColorColor[255, 255, 255, 255]按钮的常态颜色属性，类型为 Color，用于设置按钮在常态下使用的颜色，默认值为 (255, 255, 255, 255)。
ButtonPressColorColor[255, 255, 255, 255]按钮的按下态颜色属性，类型为 Color，用于设置按钮被按下时使用的颜色，默认值为 (255, 255, 255, 255)。
ButtonDisableColorColor[255, 255, 255, 255]按钮的禁用态颜色属性，类型为 Color，用于设置按钮在禁用状态下使用的颜色，默认值为 (255, 255, 255, 255)。
StretchAreaVector4[0, 0, 0, 0]拉伸区域属性，类型为 Vector4，用于设置按钮图片的拉伸区域，默认值为 (0, 0, 0, 0)。
StretchAreaPercentEnabledBooltrue拉伸区域按百分比计算属性，类型为 Bool，用于控制 StretchArea 的取值是否按百分比解释，默认值为 true。（只读）