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