harmony 鸿蒙drawing_text_font_descriptor.h
drawing_text_font_descriptor.h
概述
定义了字体信息的相关接口，比如获取字体信息，查找指定字体等。
引用文件：
库： libnative_drawing.so
起始版本： 14
相关模块： Drawing
汇总
枚举
|名称|typedef关键字|描述| |–|–|–| |OH_Drawing_SystemFontType|OH_Drawing_SystemFontType|字体类型的枚举。|
函数
|名称|描述|
|–|–|
|OH_Drawing_FontDescriptor* OH_Drawing_MatchFontDescriptors(OH_Drawing_FontDescriptor* desc, size_t* num)|获取与指定字体描述符匹配的所有系统字体描述符，其中OH_Drawing_FontDescriptor的path字段不作为有效的匹配字段，其余字段不是默认值时生效。
如果参数desc的所有字段都是默认值，则获取所有系统字体描述符。
如果匹配失败，返回NULL。不再需要OH_Drawing_FontDescriptor时，请使用OH_Drawing_DestroyFontDescriptors接口释放该对象的指针。|
|void OH_Drawing_DestroyFontDescriptors(OH_Drawing_FontDescriptor* descriptors, size_t num)|释放字体描述符OH_Drawing_FontDescriptor数组。|
|OH_Drawing_FontDescriptor* OH_Drawing_GetFontDescriptorByFullName(const OH_Drawing_String* fullName,OH_Drawing_SystemFontType fontType)|根据字体名称和字体类型获取指定的字体描述符，支持系统字体、风格字体和用户已安装字体。
字体描述符是描述字体特征的一种数据结构，它包含了定义字体外观和属性的详细信息。|
|OH_Drawing_Array* OH_Drawing_GetSystemFontFullNamesByType(OH_Drawing_SystemFontType fontType)|根据字体类型获取对应字体的字体名称数组。|
|const OH_Drawing_String* OH_Drawing_GetSystemFontFullNameByIndex(OH_Drawing_Array* fullNameArray, size_t index)|在字体名称数组中通过索引获取对应位置的字体名称。|
|void OH_Drawing_DestroySystemFontFullNames(OH_Drawing_Array* fullNameArray)|释放通过字体类型获取的对应字体的字体名称数组占用的内存。|
枚举类型说明
OH_Drawing_SystemFontType
enum OH_Drawing_SystemFontType
描述
字体类型的枚举。
起始版本： 14
|枚举项|描述|
|–|–|
|ALL = 1 << 0|所有字体类型。|
|GENERIC = 1 << 1|系统字体类型。|
|STYLISH = 1 << 2|风格字体类型|
|INSTALLED = 1 << 3|用户已安装字体类型。|
|CUSTOMIZED = 1 << 4|自定义字体类型。
起始版本： 18|
函数说明
OH_Drawing_MatchFontDescriptors()
OH_Drawing_FontDescriptor* OH_Drawing_MatchFontDescriptors(OH_Drawing_FontDescriptor* desc, size_t* num)
描述
获取与指定字体描述符匹配的所有系统字体描述符，其中OH_Drawing_FontDescriptor的path字段不作为有效的匹配字段，其余字段不是默认值时生效。
如果参数desc的所有字段都是默认值，则获取所有系统字体描述符。
如果匹配失败，返回NULL。不再需要OH_Drawing_FontDescriptor时，请使用OH_Drawing_DestroyFontDescriptors接口释放该对象的指针。
系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing
起始版本： 18
参数：
|参数项|描述|
|–|–|
|OH_Drawing_FontDescriptor* desc|指针。
建议使用OH_Drawing_CreateFontDescriptor获得有效的OH_Drawing_FontDescriptor实例。
如果自己创建OH_Drawing_FontDescriptor实例，请确保不用于匹配的字段是默认值。|
|size_t* num|表示返回值数组的成员个数。|
返回：
|类型|说明| |–|–| |OH_Drawing_FontDescriptor*|OH_Drawing_FontDescriptor数组，释放时请使用OH_Drawing_DestroyFontDescriptors。|
OH_Drawing_DestroyFontDescriptors()
void OH_Drawing_DestroyFontDescriptors(OH_Drawing_FontDescriptor* descriptors, size_t num)
描述
释放字体描述符OH_Drawing_FontDescriptor数组。
系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing
起始版本： 18
参数：
|参数项|描述| |–|–| |OH_Drawing_FontDescriptor* descriptors|数组。| |size_t num|OH_Drawing_FontDescriptor数组的成员个数。|
OH_Drawing_GetFontDescriptorByFullName()
OH_Drawing_FontDescriptor* OH_Drawing_GetFontDescriptorByFullName(const OH_Drawing_String* fullName,OH_Drawing_SystemFontType fontType)
描述
根据字体名称和字体类型获取指定的字体描述符，支持系统字体、风格字体和用户已安装字体。
字体描述符是描述字体特征的一种数据结构，它包含了定义字体外观和属性的详细信息。
系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing
起始版本： 14
参数：
|参数项|描述| |–|–| |const OH_Drawing_String* fullName|表示指向字体名称字符串OH_Drawing_String的指针。| |OH_Drawing_SystemFontType fontType|表示字体类型的枚举值OH_Drawing_SystemFontType。|
返回：
|类型|说明| |–|–| |OH_Drawing_FontDescriptor*|指向字体描述符对象OH_Drawing_FontDescriptor的指针，不再需要OH_Drawing_FontDescriptor时，请使用OH_Drawing_DestroyFontDescriptor接口释放该对象的指针。|
OH_Drawing_GetSystemFontFullNamesByType()
OH_Drawing_Array* OH_Drawing_GetSystemFontFullNamesByType(OH_Drawing_SystemFontType fontType)
描述
根据字体类型获取对应字体的字体名称数组。
系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing
起始版本： 14
参数：
|参数项|描述| |–|–| |OH_Drawing_SystemFontType fontType|表示字体类型的枚举值OH_Drawing_SystemFontType。|
返回：
|类型|说明| |–|–| |OH_Drawing_Array*|返回对应字体类型的字体名称数组OH_Drawing_Array的指针，不再需要OH_Drawing_Array时，请使用OH_Drawing_DestroySystemFontFullNames接口释放该对象的指针。|
OH_Drawing_GetSystemFontFullNameByIndex()
const OH_Drawing_String* OH_Drawing_GetSystemFontFullNameByIndex(OH_Drawing_Array* fullNameArray, size_t index)
描述
在字体名称数组中通过索引获取对应位置的字体名称。
系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing
起始版本： 14
参数：
|参数项|描述| |–|–| |OH_Drawing_Array* fullNameArray|表示字体名称数组OH_Drawing_Array的指针。| |size_t index|数组的索引。|
返回：
|类型|说明| |–|–| |const OH_Drawing_String*|返回对应索引的字体名称OH_Drawing_String的指针。|
OH_Drawing_DestroySystemFontFullNames()
void OH_Drawing_DestroySystemFontFullNames(OH_Drawing_Array* fullNameArray)
描述
释放通过字体类型获取的对应字体的字体名称数组占用的内存。
系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing
起始版本： 14
参数：
|参数项|描述| |–|–| |OH_Drawing_Array* fullNameArray|表示字体名称数组OH_Drawing_Array的指针。|
你可能感兴趣的鸿蒙文章
harmony 鸿蒙ArkGraphics 2D（方舟2D图形服务）
- 所属分类： 后端技术
- 本文标签：
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦