harmony 鸿蒙Resourcemanager
Resourcemanager
概述
提供c相关获取资源的接口。
起始版本: 12
汇总
文件
名称 | 描述 |
---|---|
ohresmgr.h | 提供资源管理native侧获取资源的能力。 |
resmgr_common.h | 提供接口所需要的枚举类型和结构体。 |
结构体
名称 | 描述 |
---|---|
struct ResourceManager_Configuration | 设备状态的枚举。 |
类型定义
名称 | 描述 |
---|---|
typedef enum ResourceManager_Direction ResourceManager_Direction | 屏幕方向的枚举。 |
typedef enum ResourceManager_ColorMode ResourceManager_ColorMode | 颜色模式的枚举。 |
typedef enum ResourceManager_DeviceType ResourceManager_DeviceType | 设备类型的枚举。 |
typedef struct ResourceManager_Configuration ResourceManager_Configuration | 设备状态的枚举。 |
枚举
名称 | 描述 |
---|---|
ResourceManager_ErrorCode { SUCCESS = 0, ERROR_CODE_INVALID_INPUT_PARAMETER = 401, ERROR_CODE_RES_ID_NOT_FOUND = 9001001, ERROR_CODE_RES_NOT_FOUND_BY_ID = 9001002, ERROR_CODE_RES_NAME_NOT_FOUND = 9001003, ERROR_CODE_RES_NOT_FOUND_BY_NAME = 9001004, ERROR_CODE_RES_PATH_INVALID = 9001005, ERROR_CODE_RES_REF_TOO_MUCH = 9001006, ERROR_CODE_RES_ID_FORMAT_ERROR = 9001007, ERROR_CODE_RES_NAME_FORMAT_ERROR = 9001008, ERROR_CODE_SYSTEM_RES_MANAGER_GET_FAILED = 9001009, ERROR_CODE_OVERLAY_RES_PATH_INVALID = 9001010, ERROR_CODE_OUT_OF_MEMORY = 9001100 } |
资源管理错误码。 |
ScreenDensity { SCREEN_SDPI = 120, SCREEN_MDPI = 160, SCREEN_LDPI = 240, SCREEN_XLDPI = 320, SCREEN_XXLDPI = 480, SCREEN_XXXLDPI = 640 } |
屏幕密度类型的枚举。 |
ResourceManager_Direction { DIRECTION_VERTICAL = 0, DIRECTION_HORIZONTAL = 1 } | 屏幕方向的枚举。 |
ResourceManager_ColorMode { DARK = 0, LIGHT = 1 } | 颜色模式的枚举。 |
ResourceManager_DeviceType { DEVICE_TYPE_PHONE = 0X00, DEVICE_TYPE_TABLET = 0x01, DEVICE_TYPE_CAR = 0x02, DEVICE_TYPE_PC = 0x03, DEVICE_TYPE_TV = 0x04, DEVICE_TYPE_WEARABLE = 0x06, DEVICE_TYPE_2IN1 = 0x07 } |
设备类型的枚举。 |
函数
名称 | 描述 |
---|---|
ResourceManager_ErrorCode OH_ResourceManager_GetMediaBase64 (const NativeResourceManager *mgr, uint32_t resId, char **resultValue, uint64_t *resultLen, uint32_t density=0) | 通过指定资源ID,获取屏幕密度对应的media资源的Base64码。 |
ResourceManager_ErrorCode OH_ResourceManager_GetMediaBase64Data (const NativeResourceManager *mgr, uint32_t resId, char **resultValue, uint64_t *resultLen, uint32_t density) | 通过指定资源ID,获取屏幕密度对应的media资源的Base64码。 |
ResourceManager_ErrorCode OH_ResourceManager_GetMediaBase64ByName (const NativeResourceManager *mgr, const char *resName, char **resultValue, uint64_t *resultLen, uint32_t density=0) | 通过指定资源名称,获取屏幕密度对应的media资源的Base64码。 |
ResourceManager_ErrorCode OH_ResourceManager_GetMediaBase64DataByName (const NativeResourceManager *mgr, const char *resName, char **resultValue, uint64_t *resultLen, uint32_t density) | 通过指定资源名称,获取屏幕密度对应的media资源的Base64码。 |
ResourceManager_ErrorCode OH_ResourceManager_GetMedia (const NativeResourceManager *mgr, uint32_t resId, uint8_t **resultValue, uint64_t *resultLen, uint32_t density=0) | 通过指定资源ID,获取屏幕密度对应的media资源的内容。 |
ResourceManager_ErrorCode OH_ResourceManager_GetMediaData (const NativeResourceManager *mgr, uint32_t resId, uint8_t **resultValue, uint64_t *resultLen, uint32_t density) | 通过指定资源ID,获取屏幕密度对应的media资源的内容。 |
ResourceManager_ErrorCode OH_ResourceManager_GetMediaByName (const NativeResourceManager *mgr, const char *resName, uint8_t **resultValue, uint64_t *resultLen, uint32_t density=0) | 通过指定资源名称,获取屏幕密度对应的media资源的内容。 |
ResourceManager_ErrorCode OH_ResourceManager_GetMediaDataByName (const NativeResourceManager *mgr, const char *resName, uint8_t **resultValue, uint64_t *resultLen, uint32_t density) | 通过指定资源名称,获取屏幕密度对应的media资源的内容。 |
ResourceManager_ErrorCode OH_ResourceManager_GetDrawableDescriptor (const NativeResourceManager *mgr, uint32_t resId, ArkUI_DrawableDescriptor **drawableDescriptor, uint32_t density=0, uint32_t type=0) | 通过指定资源Id,获取屏幕密度对应的图标资源的DrawableDescriptor。 |
ResourceManager_ErrorCode OH_ResourceManager_GetDrawableDescriptorData (const NativeResourceManager *mgr, uint32_t resId, ArkUI_DrawableDescriptor **drawableDescriptor, uint32_t density, uint32_t type) | 通过指定资源Id,获取屏幕密度对应的图标资源的DrawableDescriptor。 |
ResourceManager_ErrorCode OH_ResourceManager_GetDrawableDescriptorByName (const NativeResourceManager *mgr, const char *resName, ArkUI_DrawableDescriptor **drawableDescriptor, uint32_t density=0, uint32_t type=0) | 通过指定资源名称,获取屏幕密度对应的图标资源的DrawableDescriptor。 |
ResourceManager_ErrorCode OH_ResourceManager_GetDrawableDescriptorDataByName (const NativeResourceManager *mgr, const char *resName, ArkUI_DrawableDescriptor **drawableDescriptor, uint32_t density, uint32_t type) | 通过指定资源名称,获取屏幕密度对应的图标资源的DrawableDescriptor。 |
ResourceManager_ErrorCode OH_ResourceManager_GetSymbol (const NativeResourceManager *mgr, uint32_t resId, uint32_t *resultValue) | 通过指定资源ID,获取对应的symbol资源。 |
ResourceManager_ErrorCode OH_ResourceManager_GetSymbolByName (const NativeResourceManager *mgr, const char *resName, uint32_t *resultValue) | 通过指定资源名称,获取对应的symbol资源。 |
ResourceManager_ErrorCode OH_ResourceManager_GetLocales (const NativeResourceManager *mgr, char ***resultValue, uint32_t *resultLen, bool includeSystem=false) | 获取语言列表。 |
ResourceManager_ErrorCode OH_ResourceManager_GetLocalesData (const NativeResourceManager *mgr, char ***resultValue, uint32_t *resultLen, bool includeSystem) | 获取语言列表。 |
ResourceManager_ErrorCode OH_ResourceManager_GetConfiguration (const NativeResourceManager *mgr, ResourceManager_Configuration *configuration) | 获取设备配置。 |
ResourceManager_ErrorCode OH_ResourceManager_ReleaseConfiguration (ResourceManager_Configuration *configuration) | 释放OH_ResourceManager_GetConfiguration()方法申请的内存。 |
ResourceManager_ErrorCode OH_ResourceManager_GetString (const NativeResourceManager *mgr, uint32_t resId, char **resultValue,…) | 通过指定资源ID,获取对应的string资源。 |
ResourceManager_ErrorCode OH_ResourceManager_GetStringByName (const NativeResourceManager *mgr, const char *resName, char **resultValue,…) | 通过指定资源名称,获取对应的string资源。 |
ResourceManager_ErrorCode OH_ResourceManager_GetStringArray (const NativeResourceManager *mgr, uint32_t resId, char ***resultValue, uint32_t *resultLen) | 通过指定资源ID,获取字符串数组。 |
ResourceManager_ErrorCode OH_ResourceManager_GetStringArrayByName (const NativeResourceManager *mgr, const char *resName, char ***resultValue, uint32_t *resultLen) | 通过指定资源名称,获取字符串数组。 |
ResourceManager_ErrorCode OH_ResourceManager_ReleaseStringArray (char ***resValue, uint32_t len) | 释放字符串数组内存。 |
ResourceManager_ErrorCode OH_ResourceManager_GetPluralString (const NativeResourceManager *mgr, uint32_t resId, uint32_t num, char **resultValue) | 通过指定资源ID,获取对应的单复数字符串。 |
ResourceManager_ErrorCode OH_ResourceManager_GetPluralStringByName (const NativeResourceManager *mgr, const char *resName, uint32_t num, char **resultValue) | 通过指定资源名称,获取对应的单复数字符串。 |
ResourceManager_ErrorCodeOH_ResourceManager_GetIntPluralString (const NativeResourceManager *mgr, uint32_t resId, uint32_t num, char **resultValue,…) | 通过指定资源ID,获取对应的单复数字符串。 |
ResourceManager_ErrorCodeOH_ResourceManager_GetDoublePluralString (const NativeResourceManager *mgr, uint32_t resId, double num, char **resultValue,…) | 通过指定资源ID,获取对应的单复数字符串。 |
ResourceManager_ErrorCodeOH_ResourceManager_GetIntPluralStringByName (const NativeResourceManager *mgr, const char *resName, uint32_t num, char **resultValue,…) | 通过指定资源名称,获取对应的单复数字符串。 |
ResourceManager_ErrorCodeOH_ResourceManager_GetDoublePluralStringByName (const NativeResourceManager *mgr, const char *resName, double num, char **resultValue,…) | 通过指定资源名称,获取对应的单复数字符串。 |
ResourceManager_ErrorCode OH_ResourceManager_GetColor (const NativeResourceManager *mgr, uint32_t resId, uint32_t *resultValue) | 通过指定资源ID,获取对应的颜色值。 |
ResourceManager_ErrorCode OH_ResourceManager_GetColorByName (const NativeResourceManager *mgr, const char *resName, uint32_t *resultValue) | 通过指定资源ID,获取对应的颜色值。 |
ResourceManager_ErrorCode OH_ResourceManager_GetInt (const NativeResourceManager *mgr, uint32_t resId, int *resultValue) | 通过指定资源ID,获取对应的int值。 |
ResourceManager_ErrorCode OH_ResourceManager_GetIntByName (const NativeResourceManager *mgr, const char *resName, int *resultValue) | 通过指定资源名称,获取对应的int值。 |
ResourceManager_ErrorCode OH_ResourceManager_GetFloat (const NativeResourceManager *mgr, uint32_t resId, float *resultValue) | 通过指定资源ID,获取对应的float值。 |
ResourceManager_ErrorCode OH_ResourceManager_GetFloatByName (const NativeResourceManager *mgr, const char *resName, float *resultValue) | 通过指定资源名称,获取对应的float值。 |
ResourceManager_ErrorCode OH_ResourceManager_GetBool (const NativeResourceManager *mgr, uint32_t resId, bool *resultValue) | 通过指定资源ID,获取对应的bool值。 |
ResourceManager_ErrorCode OH_ResourceManager_GetBoolByName (const NativeResourceManager *mgr, const char *resName, bool *resultValue) | 通过指定资源名称,获取对应的bool值。 |
ResourceManager_ErrorCode OH_ResourceManager_AddResource (const NativeResourceManager *mgr, const char *path) | 在应用程序运行时添加overlay资源。 |
ResourceManager_ErrorCode OH_ResourceManager_RemoveResource (const NativeResourceManager *mgr, const char *path) | 在应用程序运行时删除overlay资源。 |
类型定义说明
ResourceManager_ColorMode
typedef enum ResourceManager_ColorModeResourceManager_ColorMode
描述
颜色模式的枚举。
起始版本: 12
ResourceManager_Configuration
typedef struct ResourceManager_ConfigurationResourceManager_Configuration
描述
设备状态的枚举。
起始版本: 12
ResourceManager_DeviceType
typedef enum ResourceManager_DeviceTypeResourceManager_DeviceType
描述
设备类型的枚举。
起始版本: 12
ResourceManager_Direction
typedef enum ResourceManager_DirectionResourceManager_Direction
描述
屏幕方向的枚举。
起始版本: 12
枚举类型说明
ResourceManager_ColorMode
enum ResourceManager_ColorMode
描述
颜色模式的枚举。
起始版本: 12
枚举值 | 描述 |
---|---|
DARK | 表示深色模式。 |
LIGHT | 表示浅色模式。 |
ResourceManager_DeviceType
enum ResourceManager_DeviceType
描述
设备类型的枚举。
起始版本: 12
枚举值 | 描述 |
---|---|
DEVICE_TYPE_PHONE | 手机。 |
DEVICE_TYPE_TABLET | 平板。 |
DEVICE_TYPE_CAR | 汽车。 |
DEVICE_TYPE_PC | 电脑。 |
DEVICE_TYPE_TV | 电视。 |
DEVICE_TYPE_WEARABLE | 穿戴。 |
DEVICE_TYPE_2IN1 | 2in1设备。 |
ResourceManager_Direction
enum ResourceManager_Direction
描述
屏幕方向的枚举。
起始版本: 12
枚举值 | 描述 |
---|---|
DIRECTION_VERTICAL | 表示垂直方向。 |
DIRECTION_HORIZONTAL | 表示水平方向。 |
ResourceManager_ErrorCode
enum ResourceManager_ErrorCode
描述
资源管理错误码。
起始版本: 12
枚举值 | 描述 |
---|---|
SUCCESS | 成功。 |
ERROR_CODE_INVALID_INPUT_PARAMETER | 输入参数无效。 |
ERROR_CODE_RES_ID_NOT_FOUND | 无效的资源ID。 |
ERROR_CODE_RES_NOT_FOUND_BY_ID | 无效的资源名称。 |
ERROR_CODE_RES_NAME_NOT_FOUND | 没有根据资源ID找到匹配的资源。 |
ERROR_CODE_RES_NOT_FOUND_BY_NAME | 没有根据资源名称找到匹配的资源。 |
ERROR_CODE_RES_PATH_INVALID | 无效的相对路径。 |
ERROR_CODE_RES_REF_TOO_MUCH | 资源被循环引用。 |
ERROR_CODE_RES_ID_FORMAT_ERROR | 无法格式化基于资源ID获得的资源。 |
ERROR_CODE_RES_NAME_FORMAT_ERROR | 无法格式化基于资源名称获得的资源。 |
ERROR_CODE_SYSTEM_RES_MANAGER_GET_FAILED | 访问系统资源失败。 |
ERROR_CODE_OVERLAY_RES_PATH_INVALID | 无效的overlay路径。 |
ERROR_CODE_OUT_OF_MEMORY | 内存溢出。 |
ScreenDensity
enum ScreenDensity
描述
屏幕密度类型的枚举。
起始版本: 12
枚举值 | 描述 |
---|---|
SCREEN_SDPI | 表示小屏幕密度。 |
SCREEN_MDPI | 表示中屏幕密度。 |
SCREEN_LDPI | 表示大屏幕密度。 |
SCREEN_XLDPI | 表示特大屏幕密度。 |
SCREEN_XXLDPI | 表示超大屏幕密度。 |
SCREEN_XXXLDPI | 表示超特大屏幕密度。 |
函数说明
OH_ResourceManager_AddResource()
ResourceManager_ErrorCode OH_ResourceManager_AddResource (const NativeResourceManager * mgr, const char * path )
描述
在应用程序运行时添加overlay资源。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
path | 资源路径。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_OVERLAY_RES_PATH_INVALID 9001010 - 无效的资源路径。
OH_ResourceManager_GetBool()
ResourceManager_ErrorCode OH_ResourceManager_GetBool (const NativeResourceManager * mgr, uint32_t resId, bool * resultValue )
描述
通过指定资源ID,获取对应的bool值。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
resultValue | 写入resultValue的结果。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
OH_ResourceManager_GetBoolByName()
ResourceManager_ErrorCode OH_ResourceManager_GetBoolByName (const NativeResourceManager * mgr, const char * resName, bool * resultValue )
描述
通过指定资源名称,获取对应的bool值。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
resultValue | 写入resultValue的结果。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001004 - 没有根据资源名称找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
OH_ResourceManager_GetColor()
ResourceManager_ErrorCode OH_ResourceManager_GetColor (const NativeResourceManager * mgr, uint32_t resId, uint32_t * resultValue )
描述
通过指定资源ID,获取对应的颜色值。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
resultValue | 写入resultValue的结果。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
OH_ResourceManager_GetColorByName()
ResourceManager_ErrorCode OH_ResourceManager_GetColorByName (const NativeResourceManager * mgr, const char * resName, uint32_t * resultValue )
描述
通过指定资源ID,获取对应的颜色值。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
resultValue | 写入resultValue的结果。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001004 - 没有根据资源名称找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
OH_ResourceManager_GetConfiguration()
ResourceManager_ErrorCode OH_ResourceManager_GetConfiguration (const NativeResourceManager * mgr, ResourceManager_Configuration * configuration )
描述
获取设备配置。
使用此接口后,需要调用OH_ResourceManager_ReleaseConfiguration()方法来释放内存。如果使用malloc创建ResourceManager_Configuration对象,还需要调用free()方法来释放它。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
configuration | 写入configuration的结果。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_SYSTEM_RES_MANAGER_GET_FAILED 9001009 - 无法访问系统资源。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetDoublePluralString()
ResourceManager_ErrorCode OH_ResourceManager_GetDoublePluralString (const NativeResourceManager * mgr, uint32_t resId, double num, char ** resultValue, ... )
描述
通过指定资源ID,获取对应的单复数字符串。
使用此接口后,需要调用free()方法来释放字符串的内存。
起始版本: 18
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
num | 数量值(浮点数)。根据当前语言的复数规则获取该数量值对应的字符串数字。 |
resultValue | 写入resultValue的结果。 |
… | 格式化字符串资源参数,可变参数,支持const char*、int、float类型。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetDoublePluralStringByName()
ResourceManager_ErrorCode OH_ResourceManager_GetDoublePluralStringByName (const NativeResourceManager * mgr, const char * resName, double num, char ** resultValue, ... )
描述
通过指定资源名称,获取对应的单复数字符串。
使用此接口后,需要调用free()方法来释放字符串的内存。
起始版本: 18
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
num | 数量值(浮点数)。根据当前语言的复数规则获取该数量值对应的字符串数字。 |
resultValue | 写入resultValue的结果。 |
… | 格式化字符串资源参数,可变参数,支持const char*、int、float类型。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001004 - 没有根据资源名称找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetDrawableDescriptor()
ResourceManager_ErrorCode OH_ResourceManager_GetDrawableDescriptor (const NativeResourceManager * mgr, uint32_t resId, ArkUI_DrawableDescriptor ** drawableDescriptor, uint32_t density = 0, uint32_t type = 0 )
描述
通过指定资源Id,获取屏幕密度对应的图标资源的DrawableDescriptor。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
density | 可选参数,取值范围参考ScreenDensity,默认值为0,表示使用当前系统dpi的密度。 |
type | 可选参数,表示图标类型,0表示自身图标,1表示主题图标。 |
drawableDescriptor | 写入drawableDescriptor的结果。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
OH_ResourceManager_GetDrawableDescriptorByName()
ResourceManager_ErrorCode OH_ResourceManager_GetDrawableDescriptorByName (const NativeResourceManager * mgr, const char * resName, ArkUI_DrawableDescriptor ** drawableDescriptor, uint32_t density = 0, uint32_t type = 0 )
描述
通过指定资源名称,获取屏幕密度对应的图标资源的DrawableDescriptor。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
density | 可选参数,取值范围参考ScreenDensity,默认值为0,表示使用当前系统dpi的密度。 |
type | 可选参数,表示图标类型,0表示自身图标,1表示主题图标,2表示动态图标。 |
drawableDescriptor | 写入drawableDescriptor的结果。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_NAME_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_NAME 9001004 - 没有根据资源名称找到匹配的资源。
OH_ResourceManager_GetDrawableDescriptorData()
ResourceManager_ErrorCode OH_ResourceManager_GetDrawableDescriptorData (const NativeResourceManager * mgr, uint32_t resId, ArkUI_DrawableDescriptor ** drawableDescriptor, uint32_t density, uint32_t type )
描述
通过指定资源Id,获取屏幕密度对应的图标资源的DrawableDescriptor。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
drawableDescriptor | 写入drawableDescriptor的结果。 |
density | 可选参数,取值范围参考ScreenDensity,值为0表示使用当前系统dpi的密度。如果不需要此属性,请将此参数设置为0。 |
type | 可选参数,表示图标类型,0表示自身图标,1表示主题图标。如果该属性不是必需的,请将该参数设为0。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
OH_ResourceManager_GetDrawableDescriptorDataByName()
ResourceManager_ErrorCode OH_ResourceManager_GetDrawableDescriptorDataByName (const NativeResourceManager * mgr, const char * resName, ArkUI_DrawableDescriptor ** drawableDescriptor, uint32_t density, uint32_t type )
描述
通过指定资源名称,获取屏幕密度对应的图标资源的DrawableDescriptor。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
drawableDescriptor | 写入drawableDescriptor的结果。 |
density | 可选参数,取值范围参考ScreenDensity,值为0表示使用当前系统dpi的密度。如果不需要此属性,请将此参数设置为0。 |
type | 可选参数,表示图标类型,0表示自身图标,1表示主题图标。如果该属性不是必需的,请将该参数设为0。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_NAME_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_NAME 9001004 - 没有根据资源名称找到匹配的资源。
OH_ResourceManager_GetFloat()
ResourceManager_ErrorCode OH_ResourceManager_GetFloat (const NativeResourceManager * mgr, uint32_t resId, float * resultValue )
描述
通过指定资源ID,获取对应的float值。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
resultValue | 写入resultValue的结果。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
OH_ResourceManager_GetFloatByName()
ResourceManager_ErrorCode OH_ResourceManager_GetFloatByName (const NativeResourceManager * mgr, const char * resName, float * resultValue )
描述
通过指定资源名称,获取对应的float值。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
resultValue | 写入resultValue的结果。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001004 - 没有根据资源名称找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
OH_ResourceManager_GetInt()
ResourceManager_ErrorCode OH_ResourceManager_GetInt (const NativeResourceManager * mgr, uint32_t resId, int * resultValue )
描述
通过指定资源ID,获取对应的int值。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
resultValue | 写入resultValue的结果。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
OH_ResourceManager_GetIntByName()
ResourceManager_ErrorCode OH_ResourceManager_GetIntByName (const NativeResourceManager * mgr, const char * resName, int * resultValue )
描述
通过指定资源名称,获取对应的int值。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
resultValue | 写入resultValue的结果。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001004 - 没有根据资源名称找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
OH_ResourceManager_GetIntPluralString()
ResourceManager_ErrorCode OH_ResourceManager_GetIntPluralString (const NativeResourceManager * mgr, uint32_t resId, uint32_t num, char ** resultValue, ... )
描述
通过指定资源ID,获取对应的单复数字符串。
使用此接口后,需要调用free()方法来释放字符串的内存。
起始版本: 18
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
num | 数量值(整数)。根据当前语言的复数规则获取该数量值对应的字符串数字。 |
resultValue | 写入resultValue的结果。 |
… | 格式化字符串资源参数,可变参数,支持const char*、int、float类型。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetIntPluralStringByName()
ResourceManager_ErrorCode OH_ResourceManager_GetIntPluralStringByName (const NativeResourceManager * mgr, const char * resName, uint32_t num, char ** resultValue, ... )
描述
通过指定资源名称,获取对应的单复数字符串。
使用此接口后,需要调用free()方法来释放字符串的内存。
起始版本: 18
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
num | 数量值(整数)。根据当前语言的复数规则获取该数量值对应的字符串数字。 |
resultValue | 写入resultValue的结果。 |
… | 格式化字符串资源参数,可变参数,支持const char*、int、float类型。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001004 - 没有根据资源名称找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetLocales()
ResourceManager_ErrorCode OH_ResourceManager_GetLocales (const NativeResourceManager * mgr, char *** resultValue, uint32_t * resultLen, bool includeSystem = false )
描述
获取语言列表。
使用此接口后,需要调用OH_ResourceManager_ReleaseStringArray()方法来释放localinfo的内存。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resultValue | 写入resultValue的结果。 |
resultLen | 写入resultLen的locales长度。 |
includeSystem | 是否包含系统资源,默认值为false,当只有系统资源查询locales列表时它不起作用。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetLocalesData()
ResourceManager_ErrorCode OH_ResourceManager_GetLocalesData (const NativeResourceManager * mgr, char *** resultValue, uint32_t * resultLen, bool includeSystem )
描述
获取语言列表。
使用此接口后,需要调用OH_ResourceManager_ReleaseStringArray()方法来释放localinfo的内存。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resultValue | 写入resultValue的结果。 |
resultLen | 写入resultLen的locales长度。 |
includeSystem | 是否包含系统资源,如果不需要此属性,请将此参数设置为 false。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetMedia()
ResourceManager_ErrorCode OH_ResourceManager_GetMedia (const NativeResourceManager * mgr, uint32_t resId, uint8_t ** resultValue, uint64_t * resultLen, uint32_t density = 0 )
描述
通过指定资源ID,获取屏幕密度对应的media资源的内容。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
density | 可选参数,取值范围参考ScreenDensity,默认值为0,表示使用当前系统dpi的密度。 |
resultValue | 写入resultValue的结果。 |
resultLen | 写入resultLen的media长度。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetMediaBase64()
ResourceManager_ErrorCode OH_ResourceManager_GetMediaBase64 (const NativeResourceManager * mgr, uint32_t resId, char ** resultValue, uint64_t * resultLen, uint32_t density = 0 )
描述
通过指定资源ID,获取屏幕密度对应的media资源的Base64码。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
density | 可选参数,取值范围参考ScreenDensity,默认值为0,表示使用当前系统dpi的密度。 |
resultValue | 写入resultValue的结果。 |
resultLen | 写入resultLen的media长度。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetMediaBase64ByName()
ResourceManager_ErrorCode OH_ResourceManager_GetMediaBase64ByName (const NativeResourceManager * mgr, const char * resName, char ** resultValue, uint64_t * resultLen, uint32_t density = 0 )
描述
通过指定资源名称,获取屏幕密度对应的media资源的Base64码。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
density | 可选参数,取值范围参考ScreenDensity,默认值为0,表示使用当前系统dpi的密度。 |
resultValue | 写入resultValue的结果。 |
resultLen | 写入resultLen的media长度。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_NAME_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_NAME 9001004 - 没有根据资源名称找到匹配的资源。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetMediaBase64Data()
ResourceManager_ErrorCode OH_ResourceManager_GetMediaBase64Data (const NativeResourceManager * mgr, uint32_t resId, char ** resultValue, uint64_t * resultLen, uint32_t density )
描述
通过指定资源ID,获取屏幕密度对应的media资源的Base64码。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
resultValue | 写入resultValue的结果。 |
resultLen | 写入resultLen的media长度。 |
density | 可选参数,取值范围参考ScreenDensity,值为0表示使用当前系统dpi的密度。如果不需要此属性,请将此参数设置为0。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetMediaBase64DataByName()
ResourceManager_ErrorCode OH_ResourceManager_GetMediaBase64DataByName (const NativeResourceManager * mgr, const char * resName, char ** resultValue, uint64_t * resultLen, uint32_t density )
描述
通过指定资源名称,获取屏幕密度对应的media资源的Base64码。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
resultValue | 写入resultValue的结果。 |
resultLen | 写入resultLen的media长度。 |
density | 可选参数,取值范围参考ScreenDensity,值为0表示使用当前系统dpi的密度。如果不需要此属性,请将此参数设置为0。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_NAME_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_NAME 9001004 - 没有根据资源名称找到匹配的资源。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetMediaByName()
ResourceManager_ErrorCode OH_ResourceManager_GetMediaByName (const NativeResourceManager * mgr, const char * resName, uint8_t ** resultValue, uint64_t * resultLen, uint32_t density = 0 )
描述
通过指定资源名称,获取屏幕密度对应的media资源的内容。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
density | 可选参数,取值范围参考ScreenDensity,默认值为0,表示使用当前系统dpi的密度。 |
resultValue | 写入resultValue的结果。 |
resultLen | 写入resultLen的media长度。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_NAME_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_NAME 9001004 - 没有根据资源名称找到匹配的资源。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetMediaData()
ResourceManager_ErrorCode OH_ResourceManager_GetMediaData (const NativeResourceManager * mgr, uint32_t resId, uint8_t ** resultValue, uint64_t * resultLen, uint32_t density )
描述
通过指定资源ID,获取屏幕密度对应的media资源的内容。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
resultValue | 写入resultValue的结果。 |
resultLen | 写入resultLen的media长度。 |
density | 可选参数,取值范围参考ScreenDensity,值为0表示使用当前系统dpi的密度。如果不需要此属性,请将此参数设置为0。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetMediaDataByName()
ResourceManager_ErrorCode OH_ResourceManager_GetMediaDataByName (const NativeResourceManager * mgr, const char * resName, uint8_t ** resultValue, uint64_t * resultLen, uint32_t density )
描述
通过指定资源名称,获取屏幕密度对应的media资源的内容。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
resultValue | 写入resultValue的结果。 |
resultLen | 写入resultLen的media长度。 |
density | 可选参数,取值范围参考ScreenDensity,值为0表示使用当前系统dpi的密度。如果不需要此属性,请将此参数设置为0。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_NAME_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_NAME 9001004 - 没有根据资源名称找到匹配的资源。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetPluralString()
ResourceManager_ErrorCode OH_ResourceManager_GetPluralString (const NativeResourceManager * mgr, uint32_t resId, uint32_t num, char ** resultValue )
描述
通过指定资源ID,获取对应的单复数字符串。
使用此接口后,需要调用free()方法来释放字符串的内存。
起始版本: 12
废弃版本: 18
替代接口:OH_ResourceManager_GetIntPluralString
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
num | 数量值。 |
resultValue | 写入resultValue的结果。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetPluralStringByName()
ResourceManager_ErrorCode OH_ResourceManager_GetPluralStringByName (const NativeResourceManager * mgr, const char * resName, uint32_t num, char ** resultValue )
描述
通过指定资源名称,获取对应的单复数字符串。
使用此接口后,需要调用free()方法来释放字符串的内存。
起始版本: 12
废弃版本: 18
替代接口:OH_ResourceManager_GetIntPluralStringByName
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
num | 数量值。 |
resultValue | 写入resultValue的结果。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001004 - 没有根据资源名称找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetString()
ResourceManager_ErrorCode OH_ResourceManager_GetString (const NativeResourceManager * mgr, uint32_t resId, char ** resultValue, ... )
描述
通过指定资源ID,获取对应的string资源。
获取普通string资源使用OH_ResourceManager_GetString(mgr, resId, resultValue)接口。 获取带有d、s、f占位符的格式化资源使用OH_ResourceManager_GetString(mgr, resId, resultValue, 10, “format”, 10.10)接口。 使用此接口后,需要调用free()方法来释放字符串的内存。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
resultValue | 写入resultValue的结果。 |
… | 格式化字符串资源参数,可变参数,支持const char*、int、float类型。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetStringArray()
ResourceManager_ErrorCode OH_ResourceManager_GetStringArray (const NativeResourceManager * mgr, uint32_t resId, char *** resultValue, uint32_t * resultLen )
描述
通过指定资源ID,获取字符串数组。
使用此接口后,需要调用OH_ResourceManager_ReleaseStringArray()接口来释放字符串数组内存。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
resultValue | 写入resultValue的结果。 |
resultLen | 写入resultLen的StringArray长度。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetStringArrayByName()
ResourceManager_ErrorCode OH_ResourceManager_GetStringArrayByName (const NativeResourceManager * mgr, const char * resName, char *** resultValue, uint32_t * resultLen )
描述
通过指定资源名称,获取字符串数组。
使用此接口后,需要调用OH_ResourceManager_ReleaseStringArray()接口来释放字符串数组内存。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
resultValue | 写入resultValue的结果。 |
resultLen | 写入resultLen的StringArray长度。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001004 - 没有根据资源名称找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetStringByName()
ResourceManager_ErrorCode OH_ResourceManager_GetStringByName (const NativeResourceManager * mgr, const char * resName, char ** resultValue, ... )
描述
通过指定资源名称,获取对应的string资源。
获取普通string资源使用OH_ResourceManager_GetString(mgr, resName, resultValue)接口。 获取带有%d、%s、%f占位符的格式化资源使用OH_ResourceManager_GetString(mgr, resName, resultValue, 10, “format”, 10.10)接口。 使用此接口后,需要调用free()方法来释放字符串的内存。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
resultValue | 写入resultValue的结果。 |
… | 格式化字符串资源参数,可变参数,支持const char*、int、float类型。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001004 - 没有根据资源名称找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
ERROR_CODE_OUT_OF_MEMORY 9001100 - 内存溢出。
OH_ResourceManager_GetSymbol()
ResourceManager_ErrorCode OH_ResourceManager_GetSymbol (const NativeResourceManager * mgr, uint32_t resId, uint32_t * resultValue )
描述
通过指定资源ID,获取对应的symbol资源。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resId | 资源ID。 |
resultValue | 写入resultValue的结果。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_ID_NOT_FOUND 9001001 - 无效的资源ID。
ERROR_CODE_RES_NOT_FOUND_BY_ID 9001002 - 没有根据资源ID找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
OH_ResourceManager_GetSymbolByName()
ResourceManager_ErrorCode OH_ResourceManager_GetSymbolByName (const NativeResourceManager * mgr, const char * resName, uint32_t * resultValue )
描述
通过指定资源名称,获取对应的symbol资源。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
resName | 资源名称。 |
resultValue | 写入resultValue的结果。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_RES_NAME_NOT_FOUND 9001003 - 无效的资源名称。
ERROR_CODE_RES_NOT_FOUND_BY_NAME 9001004 - 没有根据资源名称找到匹配的资源。
ERROR_CODE_RES_REF_TOO_MUCH 9001006 - 资源被循环引用。
OH_ResourceManager_ReleaseConfiguration()
ResourceManager_ErrorCode OH_ResourceManager_ReleaseConfiguration (ResourceManager_Configuration * configuration)
描述
释放OH_ResourceManager_GetConfiguration()方法申请的内存。
起始版本: 12
参数:
名称 | 描述 |
---|---|
configuration | 需要释放内存的configuration对象。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
OH_ResourceManager_ReleaseStringArray()
ResourceManager_ErrorCode OH_ResourceManager_ReleaseStringArray (char *** resValue, uint32_t len )
描述
释放字符串数组内存。
起始版本: 12
参数:
名称 | 描述 |
---|---|
resValue | 需要释放的字符串数组。 |
len | 字符串数组长度。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
OH_ResourceManager_RemoveResource()
ResourceManager_ErrorCode OH_ResourceManager_RemoveResource (const NativeResourceManager * mgr, const char * path )
描述
在应用程序运行时删除overlay资源。
起始版本: 12
参数:
名称 | 描述 |
---|---|
mgr | 指向NativeResourceManager的指针,此指针通过OH_ResourceManager_InitNativeResourceManager方法获取。 |
path | 资源路径。 |
返回:
SUCCESS 0 - 成功。
ERROR_CODE_INVALID_INPUT_PARAMETER 401 - 输入参数无效。可能的原因:1.参数类型不正确;2.参数验证失败。
ERROR_CODE_OVERLAY_RES_PATH_INVALID 9001010 - 无效的资源路径。
你可能感兴趣的鸿蒙文章
harmony 鸿蒙Localization Kit(本地化开发服务)
harmony 鸿蒙ResourceManager_Configuration
harmony 鸿蒙@ohos.fontManager (字体管理)
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦