1# 主题、自定义和系统字体（C++） 2 3## 介绍 4 5本工程主要实现了对以下指南文档中 [主题字体](https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/graphics/theme-font-c.md) 示例代码片段的工程化，主要目标是实现指南中示例代码需要与sample工程文件同源，以及除基本文字、排版属性之外，针对应用中不同文本的设计，开发者可能需要设置使用不同的绘制样式或能力，以凸显对应文本的独特表现或风格，此时可以结合使用多种绘制样式进行文本的渲染。 6 7## 效果预览 8 9|  |  |  |  | 10|----------------------------------|------------------------------------|---------------------------------------|------------------------------------------------| 11 12使用说明 13 141. 该工程可以选择在模拟器和开发板上运行。 152. 点击构建，即可在生成的应用中点击对应的按钮进行图案的绘制。 163. 进入“DocsSample/graphic/NDKGraphics2D/NDKThemFontAndCustomFontText/entry/src/ohosTest/ets/test/DrawingAbility.test.ets”文件，可以对本项目进行UI的自动化测试。 17 18## 工程目录 19 20``` 21NDKThemFontAndCustomFontText 22├──entry/src/main 23│ ├──cpp // C++代码区 24│ │ ├──CMakeLists.txt // CMake配置文件 25│ │ ├──hello.cpp // Napi模块注册 26│ │ ├──common 27│ │ │ └──log_common.h // 日志封装定义文件 28│ │ ├──plugin // 生命周期管理模块 29│ │ │ ├──plugin_manager.cpp 30│ │ │ └──plugin_manager.h 31│ │ ├──samples // samples渲染模块 32│ │ │ ├──sample_bitmap.cpp 33│ │ │ └──sample_bitmap.h 34│ ├──ets // ets代码区 35│ │ ├──entryability 36│ │ │ ├──EntryAbility.ts // 程序入口类 37| | | └──EntryAbility.ets 38| | ├──interface 39│ │ │ └──XComponentContext.ts // XComponentContext 40│ │ └──pages // 页面文件 41│ │ └──Index.ets // 主界面 42| ├──resources // 资源文件目录 43``` 44 45## 具体实现 46 471. 利用Native XComponent来获取NativeWindow实例、获取布局/事件信息、注册事件回调并通过Drawing API实现在页面上绘制形状。 482. 通过在IDE中创建Native c++ 工程，在c++代码中定义对外接口为drawPattern和drawText，在js侧调用该接口可在页面上绘制出相对应的不同效果的文字。 493. 在XComponent的OnSurfaceCreated回调中获取NativeWindow实例并初始化NativeWindow环境。调用OH_Drawing_FontCollection接口获取全局的字体集对象，调用OH_Drawing_CreateSharedFontCollection接口创建可共享的字体集对象，OH_Drawing_RegisterFont接口在字体管理器中注册自定义字体,OH_Drawing_CreateTextStyle接口创建指向OH_Drawing_TextStyle对象的指针，用于设置文本样式，OH_Drawing_SetTextStyleFontFamilies接口来设置字体类型。OH_Drawing_FontConfigInfo接口获取系统字体配置信息，OH_Drawing_DestroySystemFontConfigInfo释放系统字体配置信息占用的内存。OH_Drawing_DisableFontCollectionSystemFont接口禁用系统字体。 50 51 52 53## 相关权限 54 55无。 56 57## 依赖 58 59不涉及。 60 61## 约束和限制 62 631. 本示例支持标准系统上运行，支持设备：RK3568。 642. 本示例支持API14版本SDK，版本号：5.0.2.123。 653. 本示例已支持DevEco Studio 5.0.2 Release (构建版本：5.0.7.210，构建 2025年5月6日)编译运行。 66 67## 下载 68 69如需单独下载本工程，执行如下命令： 70 71``` 72git init 73git config core.sparsecheckout true 74echo code/DocsSample/graphic/NDKGraphics2D/NDKThemFontAndCustomFontText/ > .git/info/sparse-checkout 75git remote add origin https://gitee.com/openharmony/applications_app_samples.git 76git pull origin master 77``` 78 79