openharmony 鸿蒙 capi-drawing-font-collection-h

2026-08-25 浏览 (1)

drawing_font_collection.h

Overview

This file declares the functions related to the font collection in the drawing module.

File to include: <native_drawing/drawing_font_collection.h>

Library: libnative_drawing.so

System capability: SystemCapability.Graphic.Graphic2D.NativeDrawing

Since: 8

Related module: Drawing

Summary

Functions

NameDescription
OH_Drawing_FontCollection* OH_Drawing_CreateFontCollection(void)Creates an OH_Drawing_FontCollection object.
void OH_Drawing_DestroyFontCollection(OH_Drawing_FontCollection* fontCollection)Destroys an OH_Drawing_FontCollection object and reclaims the memory occupied by the object.
void OH_Drawing_DisableFontCollectionFallback(OH_Drawing_FontCollection* fontCollection)Disables the system fonts.
void OH_Drawing_DisableFontCollectionSystemFont(OH_Drawing_FontCollection* fontCollection)Disables the system fonts.
OH_Drawing_FontCollection* OH_Drawing_CreateSharedFontCollection(void)Creates a shareable OH_Drawing_FontCollection object.
void OH_Drawing_ClearFontCaches(OH_Drawing_FontCollection* fontCollection)Clears the font cache. (The font cache has a memory limit and a clearing mechanism. It occupies limited memory. You are not advised to clear it unless otherwise required.)
OH_Drawing_FontCollection* OH_Drawing_GetFontCollectionGlobalInstance(void)Obtains the global OH_Drawing_FontCollection object, which can be used to sense the theme font information. Do not release the object.

Function Description

OH_Drawing_CreateFontCollection()

OH_Drawing_FontCollection* OH_Drawing_CreateFontCollection(void)

Description

Creates an OH_Drawing_FontCollection object.

System capability: SystemCapability.Graphic.Graphic2D.NativeDrawing

Since: 8

Return value

TypeDescription
OH_Drawing_FontCollection*Returns the pointer to the OH_Drawing_FontCollection object created. The OH_Drawing_FontCollection object created by this function cannot be shared by multiple OH_Drawing_TypographyCreate objects. You need to use the OH_Drawing_CreateSharedFontCollection function to create an OH_Drawing_FontCollection object for sharing.

OH_Drawing_DestroyFontCollection()

void OH_Drawing_DestroyFontCollection(OH_Drawing_FontCollection* fontCollection)

Description

Destroys an OH_Drawing_FontCollection object and reclaims the memory occupied by the object.

System capability: SystemCapability.Graphic.Graphic2D.NativeDrawing

Since: 8

Parameters

NameDescription
OH_Drawing_FontCollection* fontCollectionPointer to an OH_Drawing_FontCollection object.

OH_Drawing_DisableFontCollectionFallback()

void OH_Drawing_DisableFontCollectionFallback(OH_Drawing_FontCollection* fontCollection)

Description

Disables the system fonts.

System capability: SystemCapability.Graphic.Graphic2D.NativeDrawing

Since: 12

Deprecated from: 18

Replaced by: OH_Drawing_DisableFontCollectionSystemFont()

Parameters

NameDescription
OH_Drawing_FontCollection* fontCollectionPointer to an OH_Drawing_FontCollection object.

OH_Drawing_DisableFontCollectionSystemFont()

void OH_Drawing_DisableFontCollectionSystemFont(OH_Drawing_FontCollection* fontCollection)

Description

Disables the system fonts.

System capability: SystemCapability.Graphic.Graphic2D.NativeDrawing

Since: 12

Parameters

NameDescription
OH_Drawing_FontCollection* fontCollectionPointer to an OH_Drawing_FontCollection object.

OH_Drawing_CreateSharedFontCollection()

OH_Drawing_FontCollection* OH_Drawing_CreateSharedFontCollection(void)

Description

Creates a shareable OH_Drawing_FontCollection object.

System capability: SystemCapability.Graphic.Graphic2D.NativeDrawing

Since: 12

Return value

TypeDescription
OH_Drawing_FontCollection*Returns the pointer to the OH_Drawing_FontCollection object created.

OH_Drawing_ClearFontCaches()

void OH_Drawing_ClearFontCaches(OH_Drawing_FontCollection* fontCollection)

Description

Clears the font cache. (The font cache has a memory limit and a clearing mechanism. It occupies limited memory. You are not advised to clear it unless otherwise required.)

System capability: SystemCapability.Graphic.Graphic2D.NativeDrawing

Since: 12

Parameters

NameDescription
OH_Drawing_FontCollection* fontCollectionPointer to an OH_Drawing_FontCollection object.

OH_Drawing_GetFontCollectionGlobalInstance()

OH_Drawing_FontCollection* OH_Drawing_GetFontCollectionGlobalInstance(void)

Description

Obtains the global OH_Drawing_FontCollection object, which can be used to sense the theme font information. Do not release the object.

System capability: SystemCapability.Graphic.Graphic2D.NativeDrawing

Since: 14

Return value

TypeDescription
OH_Drawing_FontCollection*Returns the pointer to the global {@link OH_Drawing_FontCollection} object obtained.

你可能感兴趣的鸿蒙文章

openharmony 鸿蒙 capi-drawing-gpu-context-h

openharmony 鸿蒙 capi-drawing-nativepixelmap-

openharmony 鸿蒙 capi-nativevsync-oh-nativevsync-expectedraterange

openharmony 鸿蒙 capi-drawing-oh-drawing-brush

openharmony 鸿蒙 capi-drawing-oh-drawing-image-info

openharmony 鸿蒙 capi-drawing-text-linetypography-h

openharmony 鸿蒙 capi-oh-nativeimage-oh-nativeimage

openharmony 鸿蒙 capi-drawing-typeface-h

openharmony 鸿蒙 capi-drawing-brush-h

openharmony 鸿蒙 capi-nativewindow

  • 所属分类: 后端技术
  • 本文标签: 软件 鸿蒙
  • 版权声明: 本文链接 https://seaxiang.com/blog/kI0X2J9H