主题
EUIRichTextLabel
EUIRichTextLabel 是用于在界面中展示富文本内容的标签控件,可设置文本内容、文本颜色、字号与字体,并支持描边、阴影与斜体等文字样式。它提供完整排版控制,包括水平与垂直对齐、字间距、行间距、换行宽度以及单行最小/最大宽度和换行最...
概览
EUIRichTextLabel 是用于在界面中展示富文本内容的标签控件,可设置文本内容、文本颜色、字号与字体,并支持描边、阴影与斜体等文字样式。它提供完整排版控制,包括水平与垂直对齐、字间距、行间距、换行宽度以及单行最小/最大宽度和换行最大/最小高度。当文本超出可视区域时,可通过溢出策略配合自动滚动速度与自动滚动循环间距处理,也可启用自动缩小字号并设置最小字号与缩小步长。
继承自
EUINodeBase;可通过World:CreateUnit("EUIRichTextLabel", ...)创建;返回单个单位
属性
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
Text | String | RichTextLabel | 富文本标签展示的文本内容,类型为 String,赋值后即成为该标签当前显示的文本。 |
TextColor | Color | [255, 255, 255, 255] | 文本主体颜色,类型为 Color,包含红、绿、蓝与透明度分量。 |
FontSize | Int | 42 | 文本的字号大小,类型为 Int。 |
Font | TextFontType | Enums.TextFontType.HKXZYT_W9_GB | 文本所使用的字体,取值类型为 TextFontType,用于决定文字的字形样式。 |
OutlineEnabled | Bool | false | 是否开启文本描边效果,类型为 Bool。 |
OutlineColor | Color | [0, 0, 0, 0] | 文本描边的颜色,类型为 Color,包含红、绿、蓝与透明度分量。 |
OutlineWidth | Int | 1 | 文本描边的宽度,类型为 Int。 |
OutlineOpacity | Float | 1.0 | 文本描边的不透明度,类型为 Float。 |
ShadowEnabled | Bool | false | 是否开启文字阴影,类型为 Bool。 |
ShadowColor | Color | [0, 0, 0, 0] | 文字阴影的颜色,类型为 Color。 |
ShadowOffset | Vector2 | [1, 1] | 阴影相对于文字的位置偏移,类型为 Vector2。 |
ItalicEnabled | Bool | false | 是否以斜体样式渲染文本,类型为 Bool。 |
TextHorizontalAlignment | EUITextHorizontalAlignment | Enums.EUITextHorizontalAlignment.Left | 文本在标签范围内的水平对齐方式,取值类型为 EUITextHorizontalAlignment。 |
TextVerticalAlignment | EUITextVerticalAlignment | Enums.EUITextVerticalAlignment.Top | 文本在标签范围内的垂直对齐方式,取值类型为 EUITextVerticalAlignment。 |
WrapWidth | Int | - | 文本自动换行时使用的宽度阈值,类型为 Int。 |
SingleLineMinWidth | Int | - | 单行文本的宽度下限,类型为 Int。 |
SingleLineMaxWidth | Int | - | 单行文本的宽度上限,类型为 Int。 |
WrapMaxHeight | Int | - | 换行排版时文本允许占用的最大高度,类型为 Int。 |
WrapMinHeight | Int | - | 换行排版时文本至少占用的高度,类型为 Int。 |
AutoSizeEnabled | Bool | false | 是否在文本超出可用空间时自动缩小字号,类型为 Bool。 |
MinFontSize | Int | 12 | 自动缩小字号时可达到的最小字号,类型为 Int。 |
TextSpacing | Int | 0 | 字符之间的间距,类型为 Int。 |
LineSpacing | Int | - | 多行文本之间的行间距,类型为 Int。 |
EnableMaxHeight | Bool | false | 是否启用最大高度限制,类型为 Bool。 |
ShrinkFontSizeStep | Float | 1.0 | 自动缩小字号时每次缩小的步长,类型为 Float。 |
OverflowPolicy | EUIOverflowPolicy | Enums.EUIOverflowPolicy.Culling | 文本内容超出显示范围时的处理策略,取值类型为 EUIOverflowPolicy。 |
AutoScrollSpeed | Float | 100.0 | 自动滚动时的滚动速度,类型为 Float。 |
AutoScrollProgress | Float | 0.0 | 自动滚动时的循环间距,类型为 Float,用于控制滚动内容首尾衔接的间隔。 |
ArrangeMode | EUIArrangeMode | Enums.EUIArrangeMode.AutoWrap | 文本的排列模式,取值类型为 EUIArrangeMode。 |
EnableMaxWidth | Bool | false | 是否启用最大宽度限制,类型为 Bool。 |
