capi结构体描述规范整改-docs-AtomGit

已合并

capi结构体描述规范整改 #122647

capi结构体描述规范整改 #122647

已合并

wanglili12创建于 2025年12月19日

共 4 个文件变更+10-10

	@@ -12,7 +12,7 @@ typedef struct {...} ArkUI_AttributeItem
12		12
13	## 概述	13	## 概述
14		14
15	-定义[setAttribute](capi-arkui-nativemodule-arkui-nativenodeapi-1.md#setattribute)函数通用入参结构。	15	+定义[setAttribute](capi-arkui-nativemodule-arkui-nativenodeapi-1.md#setattribute)函数通用入参结构。各个属性设置接口可选择使用其中的成员变量来存储特定类型的参数数据。
		pengdongfa2025年12月30日需先合入：https://gitcode.com/openharmony-sig/interface_native_header/pull/2959 和https://gitcode.com/openharmony-sig/interface_native_header仓
16		16
17	起始版本： 12	17	起始版本： 12
18		18
	@@ -26,9 +26,9 @@ typedef struct {...} ArkUI_AttributeItem
26		26
27	\| 名称 \| 描述 \|	27	\| 名称 \| 描述 \|
28	\|------------------------------------\| -- \|	28	\|------------------------------------\| -- \|
29	-\| const [ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)* value \| 数字类型数组。 \|	29	+\| const [ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)* value \| 数字类型数组，用于存储数字数组类型的参数。 \|
30	-\| int32_t size \| 数字类型数组大小。 \|	30	+\| int32_t size \| 数字类型数组大小，配合变量value使用，value数组的长度。 \|
31	-\| const char* string \| 字符串类型。 \|	31	+\| const char* string \| 字符串类型，用于存储字符串类型的参数。 \|
32	-\| void* object \| 对象类型。 \|	32	+\| void* object \| 对象类型，用于存储对象类型的参数。 \|
33		33
34		34

	@@ -26,7 +26,7 @@ typedef struct {...} ArkUI_ContextCallback
26		26
27	\| 名称 \| 描述 \|	27	\| 名称 \| 描述 \|
28	\| -- \| -- \|	28	\| -- \| -- \|
29	-\| void* userData \| 自定义类型。 \|	29	+\| void* userData \| 自定义类型，开发者自定义类型的数据，在回调时作为参数传入。 \|
30		30
31		31
32	### 成员函数	32	### 成员函数

	@@ -26,7 +26,7 @@ ArkUI提供的Native侧Node类型接口集合。Node模块相关接口需要在
26		26
27	\| 名称 \| 描述 \|	27	\| 名称 \| 描述 \|
28	\| -- \| -- \|	28	\| -- \| -- \|
29	-\| int32_t version \| 结构体版本。 \|	29	+\| int32_t version \| 结构体版本，当前使用的ArkUI_NativeNodeAPI_1结构体的版本编号，由系统提供，开发者无需修改。 \|
30		30
31		31
32	### 成员函数	32	### 成员函数

	@@ -26,6 +26,6 @@ ArkUI在Native侧的数字类型定义。
26		26
27	\| 名称 \| 描述 \|	27	\| 名称 \| 描述 \|
28	\| -- \| -- \|	28	\| -- \| -- \|
29	-\| float f32 \| 浮点类型。 \|	29	+\| float f32 \| 浮点类型的变量，用于存储浮点类型的数值。 \|
30	-\| int32_t i32 \| 有符号整型。 \|	30	+\| int32_t i32 \| 有符号整型的变量，用于存储有符号整型的数值。 \|
31	-\| uint32_t u32 \| 无符号整型。 \|	31	+\| uint32_t u32 \| 无符号整型的变量，用于存储无符号整型的数值。 \|