harmony 鸿蒙drawing_text_lineTypography.h

  • 2025-06-12
  • 浏览 (3)

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_CreateLineTypography()

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的指针。|

OH_Drawing_DestroyLineTypography()

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获取。|

OH_Drawing_LineTypographyGetLineBreak()

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_LineTypographyCreateLine()

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的指针。|

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkGraphics 2D(方舟2D图形服务)

harmony 鸿蒙buffer_common.h

harmony 鸿蒙buffer_handle.h

harmony 鸿蒙BufferHandle

harmony 鸿蒙ColorSpacePrimaries

harmony 鸿蒙DisplaySoloist_ExpectedRateRange

harmony 鸿蒙drawing_bitmap.h

harmony 鸿蒙drawing_brush.h

harmony 鸿蒙drawing_canvas.h

harmony 鸿蒙drawing_color_filter.h

0  赞