ui_label_ext
ui_label_ext 模块提供扩展标签组件，在标签基础上增加滚动、淡入淡出等扩展显示效果。
Class Summary
OHOS::UILabelExt
扩展 UILabel 的能力，支持矢量字体与排版整形场景下的文本标识功能
- 构造：无
-
成员函数：
接口名称 功能简述 GetViewType 获取视图类型，返回 UI_LABEL_EXT SetTextId 设置文本资源 ID ForceResetText 强制重置文本内容 -
使用包含头文件：
#include "components/ui_label_ext.h" - 声明头文件：
middleware/services/gui/uikit/proprietary/include/components/ui_label_ext.h - 公有运算符：无
- 继承关系：UILabel
- 嵌套类型：无
- 模板形参：无
Functions
OHOS::UILabelExt
GetViewType
UIViewType GetViewType() const override
功能说明
- 核心用途：获取当前视图的类型标识
- 设计目的：区分 UILabelExt 与其他 UILabel 派生类，供框架进行类型分发与判断
- 使用场景：UI 框架内部类型识别、视图树遍历中按类型筛选
返回值
- 返回类型：
UIViewType
返回视图类型枚举值
| 返回值 | 触发场景 |
|---|---|
| UI_LABEL_EXT | 当前对象为 UILabelExt 实例 |
SetTextId
void SetTextId(uint16_t textId)
功能说明
- 核心用途：设置文本资源 ID，用于关联多语言或动态文本资源
- 设计目的：通过资源 ID 间接引用文本内容，实现文本与界面的解耦
- 使用场景：多语言切换、动态文本资源加载、国际化文本管理
入参
| 名称 | 参数类型 | 详细说明 | 约束取值范围 |
|---|---|---|---|
| textId | uint16_t | 文本资源标识符 | 0 ~ 65535 |
ForceResetText
void ForceResetText() override
功能说明
- 核心用途：强制重置文本内容，清除当前文本并触发重新排版
- 设计目的：在矢量字体或排版整形场景下，确保文本状态与底层资源同步
- 使用场景：字体资源变更后文本需强制刷新、文本内容被外部修改后需重新排版
Kconfig 配置
| 配置项 | 说明 | 默认值 |
|---|---|---|
| ENABLE_FONT_VECTOR_GLOBAL | 启用全局矢量字体支持 | 1 |
| ENABLE_SHAPING | 启用排版整形支持 | 1 |