文本绘制与显示中多样式文本绘制与显示接口使用说明（ArkTS）
介绍
本工程主要实现了对以下指南文档中 复杂文本绘制与显示 示例代码片段的工程化，主要目标是实现指南中示例代码需要与sample工程文件同源，以及除基本文字、排版属性之外，针对应用中不同文本的设计，开发者可能需要设置使用不同的绘制样式或能力，以凸显对应文本的独特表现或风格，此时可以结合使用多种绘制样式进行文本的渲染。
效果预览
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
|---|
使用方法：
- 该工程可以选择在模拟器和开发板上运行。
- 点击构建，即可在生成的应用中点击对应的按钮进行图案的绘制。
- 进入“ArkGraphics2D/TextEngine/entry/src/ohosTest/ets/test/Ability.test.ets”文件，可以对本项目进行UI的自动化测试。
工程目录
ComplexTextDrawing
├──entry/src/main
│ ├──ets // ets代码区
│ │ ├──entryability
| | | └──EntryAbility.ets // 程序入口类
| | ├──entrybackupability
│ │ │ └──EntryBackupAbility.ets
│ │ └──pages // 页面文件
│ │ ├─ complexStyle
│ │ │ ├─ ComplexStyleExample1.ets
│ │ │ ├─ ComplexStyleExample2.ets
│ │ │ ├─ ComplexStyleExample3.ets
│ │ │ ├─ ComplexStyleExample4.ets
│ │ │ ├─ ComplexStyleExample5.ets
│ │ │ ├─ ComplexStyleExample6.ets
│ │ │ ├─ ComplexStyleExample7.ets
│ │ │ ├─ ComplexStyleExample8.ets
│ │ │ ├─ ComplexStyleExample9.ets
│ │ │ ├─ ComplexStyleExample10.ets
│ │ │ ├─ ComplexStyleExample11.ets
│ │ │ └─ ComplexStyleText.ets
│ │ ├─ Index.ets // 主界面
│ │ ├─ multilanguage
│ │ │ └─ MultilanguageText.ets
│ │ ├─ multiline
│ │ │ └─ MultilineText.ets
│ │ └─ shape
│ │ └─ IndependentShaping.ets
| ├──resources // 资源文件目录
└─ ohosTest
└──ets
└─ test
└─ Ability.test.ets // 自动化测试入口
具体实现
- 利用Native XComponent来获取NativeWindow实例、获取布局/事件信息、注册事件回调并通过Drawing API实现在页面上绘制形状。
- 通过在IDE中创建Native ArkTS工程，该工程复杂文本绘制主要包含以下几个场景：多语言文本绘制与显示、多行文本绘制与显示、省略号样式设置、文字换行方式设置、行首标点压缩、查询各类型字体资源路径、多样式文本绘制与显示，针对每个场景实现了具体demo的编写。
- 在XComponent的OnSurfaceCreated回调中获取NativeWindow实例并初始化NativeWindow环境。支持的能力包括：
- 省略号样式设置： 在文本内容超出显示区域时，可以使用省略号截断文本，支持头部、中部、尾部以及多行省略模式。
- 文字换行方式设置： 文本排版时支持不同的断行策略（贪婪、高质量、均衡），可根据场景选择合适的换行方式。
- 行首标点压缩： 在排版中，通过开启行首标点压缩功能，将行首标点符号进行挤压处理，避免标点占用行首空间，提升排版紧凑度。
相关权限
不涉及。
依赖
不涉及。
约束与限制
- 本示例支持API26版本SDK，版本号：26.0.0。
下载
如需单独下载本工程，执行如下命令：
git init
git config core.sparsecheckout true
echo ArkGraphics2D/TextEngine/ComplexTextDrawing/ > .git/info/sparse-checkout
git remote add origin https://gitcode.com/HarmonyOS_Samples/guide-snippets.git
git pull origin master