Skip to content

EUIRichTextLabel ​

EUIRichTextLabel 是用于在界面中展示富文本内容的标签控件,可设置文本内容、文本颜色、字号与字体,并支持描边、阴影与斜体等文字样式。它提供完整排版控制,包括水平与垂直对齐、字间距、行间距、换行宽度以及单行最小/最大宽度和换行最...

概览 ​

EUIRichTextLabel 是用于在界面中展示富文本内容的标签控件,可设置文本内容、文本颜色、字号与字体,并支持描边、阴影与斜体等文字样式。它提供完整排版控制,包括水平与垂直对齐、字间距、行间距、换行宽度以及单行最小/最大宽度和换行最大/最小高度。当文本超出可视区域时,可通过溢出策略配合自动滚动速度与自动滚动循环间距处理,也可启用自动缩小字号并设置最小字号与缩小步长。

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

属性 ​

名称类型默认值说明
TextStringRichTextLabel富文本标签展示的文本内容,类型为 String,赋值后即成为该标签当前显示的文本。
TextColorColor[255, 255, 255, 255]文本主体颜色,类型为 Color,包含红、绿、蓝与透明度分量。
FontSizeInt42文本的字号大小,类型为 Int。
FontTextFontTypeEnums.TextFontType.HKXZYT_W9_GB文本所使用的字体,取值类型为 TextFontType,用于决定文字的字形样式。
OutlineEnabledBoolfalse是否开启文本描边效果,类型为 Bool。
OutlineColorColor[0, 0, 0, 0]文本描边的颜色,类型为 Color,包含红、绿、蓝与透明度分量。
OutlineWidthInt1文本描边的宽度,类型为 Int。
OutlineOpacityFloat1.0文本描边的不透明度,类型为 Float。
ShadowEnabledBoolfalse是否开启文字阴影,类型为 Bool。
ShadowColorColor[0, 0, 0, 0]文字阴影的颜色,类型为 Color。
ShadowOffsetVector2[1, 1]阴影相对于文字的位置偏移,类型为 Vector2。
ItalicEnabledBoolfalse是否以斜体样式渲染文本,类型为 Bool。
TextHorizontalAlignmentEUITextHorizontalAlignmentEnums.EUITextHorizontalAlignment.Left文本在标签范围内的水平对齐方式,取值类型为 EUITextHorizontalAlignment。
TextVerticalAlignmentEUITextVerticalAlignmentEnums.EUITextVerticalAlignment.Top文本在标签范围内的垂直对齐方式,取值类型为 EUITextVerticalAlignment。
WrapWidthInt-文本自动换行时使用的宽度阈值,类型为 Int。
SingleLineMinWidthInt-单行文本的宽度下限,类型为 Int。
SingleLineMaxWidthInt-单行文本的宽度上限,类型为 Int。
WrapMaxHeightInt-换行排版时文本允许占用的最大高度,类型为 Int。
WrapMinHeightInt-换行排版时文本至少占用的高度,类型为 Int。
AutoSizeEnabledBoolfalse是否在文本超出可用空间时自动缩小字号,类型为 Bool。
MinFontSizeInt12自动缩小字号时可达到的最小字号,类型为 Int。
TextSpacingInt0字符之间的间距,类型为 Int。
LineSpacingInt-多行文本之间的行间距,类型为 Int。
EnableMaxHeightBoolfalse是否启用最大高度限制,类型为 Bool。
ShrinkFontSizeStepFloat1.0自动缩小字号时每次缩小的步长,类型为 Float。
OverflowPolicyEUIOverflowPolicyEnums.EUIOverflowPolicy.Culling文本内容超出显示范围时的处理策略,取值类型为 EUIOverflowPolicy。
AutoScrollSpeedFloat100.0自动滚动时的滚动速度,类型为 Float。
AutoScrollProgressFloat0.0自动滚动时的循环间距,类型为 Float,用于控制滚动内容首尾衔接的间隔。
ArrangeModeEUIArrangeModeEnums.EUIArrangeMode.AutoWrap文本的排列模式,取值类型为 EUIArrangeMode。
EnableMaxWidthBoolfalse是否启用最大宽度限制,类型为 Bool。