1# 简单文本绘制与显示（C/C++） 2<!--Kit: ArkGraphics 2D--> 3<!--Subsystem: Graphics--> 4<!--Owner: @oh_wangxk; @gmiao522; @Lem0nC--> 5<!--Designer: @liumingxiang--> 6<!--Tester: @yhl0101--> 7<!--Adviser: @ge-yafang--> 8 9## 场景介绍 10 11在一个简单的用户界面中，可能只需要展示几行静态文本，例如标签、按钮上的文字、菜单项或状态栏中的提示信息。此时，开发者只需要选择合适的字体、大小和颜色即可完成渲染。 12 13 14## 接口说明 15 16| 接口定义 | 描述 | 17| -------- | -------- | 18| OH_Drawing_TextStyle\* OH_Drawing_CreateTextStyle(void) | 创建指向OH_Drawing_TextStyle对象的指针。 | 19| void OH_Drawing_SetTextStyleFontSize(OH_Drawing_TextStyle\* style, double fontSize) | 设置字号。 | 20| void OH_Drawing_SetTextStyleFontWeight(OH_Drawing_TextStyle\* style, int fontWeight) | 设置字重。目前只有系统默认字体支持字重的调节，其他字体设置字重值小于semi-bold时字体粗细无变化，当设置字重值大于等于semi-bold时可能会触发伪加粗效果。 | 21 22 23## 开发步骤 24 25画布Canvas对象具体可见[画布的获取与绘制结果的显示](canvas-get-result-draw-c.md)。 26 27```c++ 28// 创建一个 TypographyStyle 创建 Typography 时需要使用 29OH_Drawing_TypographyStyle *typoStyle = OH_Drawing_CreateTypographyStyle(); 30// 设置文本对齐方式为居中 31OH_Drawing_SetTypographyTextAlign(typoStyle, TEXT_ALIGN_CENTER); 32 33// 设置文字颜色、大小、字重，不设置 TextStyle 会使用 TypographyStyle 中的默认 TextStyle 34OH_Drawing_TextStyle *txtStyle = OH_Drawing_CreateTextStyle(); 35OH_Drawing_SetTextStyleColor(txtStyle, OH_Drawing_ColorSetArgb(0xFF, 0x00, 0x00, 0x00)); 36OH_Drawing_SetTextStyleFontSize(txtStyle, 60); 37OH_Drawing_SetTextStyleFontWeight(txtStyle, FONT_WEIGHT_400); 38 39// 创建 FontCollection，FontCollection 用于管理字体匹配逻辑 40OH_Drawing_FontCollection *fc = OH_Drawing_CreateSharedFontCollection(); 41// 使用 FontCollection 和 之前创建的 TypographyStyle 创建 TypographyCreate。TypographyCreate 用于创建 Typography 42OH_Drawing_TypographyCreate *handler = OH_Drawing_CreateTypographyHandler(typoStyle, fc); 43 44// 将之前创建的 TextStyle 加入 handler 中 45OH_Drawing_TypographyHandlerPushTextStyle(handler, txtStyle); 46// 设置文本内容，并将文本添加到 handler 中 47const char *text = "Hello World Drawing\n"; 48// 此处可以使用 OH_Drawing_TypographyHandlerAddEncodedText 添加不同编码的文本。 49// OH_Drawing_TypographyHandlerAddText 只支持UTF-8编码的文本 50OH_Drawing_TypographyHandlerAddText(handler, text); 51 52OH_Drawing_Typography *typography = OH_Drawing_CreateTypography(handler); 53// 设置排版宽度 54double layoutWidth = 1310; 55OH_Drawing_TypographyLayout(typography, layoutWidth); 56// 设置文本在画布上绘制的起始位置 57double position[2] = {0, 1140}; 58// 将文本绘制到画布上 59OH_Drawing_TypographyPaint(typography, canvas, position[0], position[1]); 60 61// 释放内存 62OH_Drawing_DestroyTypographyStyle(typoStyle); 63OH_Drawing_DestroyTextStyle(txtStyle); 64OH_Drawing_DestroyFontCollection(fc); 65OH_Drawing_DestroyTypographyHandler(handler); 66OH_Drawing_DestroyTypography(typography); 67``` 68 69 70## 效果展示 71 72
