47b6924a创建于 2025年12月3日历史提交

drawing_text_lineTypography.h

概述

提供排版行相关的接口，比如获取指定位置处开始可以排版的字符个数等函数。

引用文件： <native_drawing/drawing_text_lineTypography.h>

库： libnative_drawing.so

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 18

相关模块： Drawing

名称	描述
OH_Drawing_LineTypography* OH_Drawing_CreateLineTypography(OH_Drawing_TypographyCreate* handler)	创建一个排版行对象OH_Drawing_LineTypography的指针，排版行对象保存着文本内容以及样式的载体，可以用于计算单行排版信息。
void OH_Drawing_DestroyLineTypography(OH_Drawing_LineTypography* lineTypography)	释放排版行对象OH_Drawing_LineTypography占用的内存。
size_t OH_Drawing_LineTypographyGetLineBreak(OH_Drawing_LineTypography* lineTypography,size_t startIndex, double width)	计算在限定排版宽度的情况下，从指定位置处开始可以排版的字符个数。
OH_Drawing_TextLine* OH_Drawing_LineTypographyCreateLine(OH_Drawing_LineTypography* lineTypography,size_t startIndex, size_t count)	根据指定区间文本内容创建一个指向文本行对象OH_Drawing_TextLine的指针。

OH_Drawing_LineTypography* OH_Drawing_CreateLineTypography(OH_Drawing_TypographyCreate* handler)

描述

创建一个排版行对象OH_Drawing_LineTypography的指针，排版行对象保存着文本内容以及样式的载体，可以用于计算单行排版信息。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 18

参数：

参数项	描述
OH_Drawing_TypographyCreate* handler	指向OH_Drawing_TypographyCreate对象的指针，由OH_Drawing_CreateTypographyHandler获取。

返回：

类型	说明
OH_Drawing_LineTypography*	返回一个指向排版行对象OH_Drawing_LineTypography的指针。

void OH_Drawing_DestroyLineTypography(OH_Drawing_LineTypography* lineTypography)

描述

释放排版行对象OH_Drawing_LineTypography占用的内存。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 18

参数：

参数项	描述
OH_Drawing_LineTypography* lineTypography	指向排版行对象OH_Drawing_LineTypography的指针，由OH_Drawing_CreateLineTypography获取。

size_t OH_Drawing_LineTypographyGetLineBreak(OH_Drawing_LineTypography* lineTypography,size_t startIndex, double width)

描述

计算在限定排版宽度的情况下，从指定位置处开始可以排版的字符个数。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 18

参数：

参数项	描述
OH_Drawing_LineTypography* lineTypography	指向排版行对象OH_Drawing_LineTypography的指针，由OH_Drawing_CreateLineTypography获取。
size_t startIndex	开始计算排版的起始位置（包括起始位置）。取值范围需要为[0,文本字符总数）的整数。
double width	换行宽度，大于0的浮点数，单位为物理像素px。

返回：

类型	说明
size_t	返回在限定排版宽度的情况下，从指定位置处开始可以排版的字符总数，取值为整数。

OH_Drawing_TextLine* OH_Drawing_LineTypographyCreateLine(OH_Drawing_LineTypography* lineTypography,size_t startIndex, size_t count)

描述

根据指定区间文本内容创建一个指向文本行对象OH_Drawing_TextLine的指针。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 18

参数：

参数项	描述
OH_Drawing_LineTypography* lineTypography	指向排版行对象OH_Drawing_LineTypography的指针，由OH_Drawing_CreateLineTypography获取。
size_t startIndex	表示计算排版的起始位置，整数，取值范围为[0, 文本字符总数)。
size_t count	表示从指定排版起始位置开始进行排版的字符个数，取值为[0,文本字符总数)的整数，startIndex和count之和不能大于文本字符总数。可以先使用OH_Drawing_LineTypographyGetLineBreak获得合理的可用于进行排版的字符总数。如果该值设置为0，则返回nullptr。

返回：

类型	说明
OH_Drawing_TextLine*	返回一个指向文本行对象OH_Drawing_TextLine的指针。