1# native_node.h 2<!--Kit: ArkUI--> 3<!--Subsystem: ArkUI--> 4<!--Owner: @piggyguy; @xiang-shouxing; @yangfan229--> 5<!--Designer: @piggyguy; @xiang-shouxing; @yangfan229--> 6<!--Tester: @fredyuan912--> 7<!--Adviser: @HelloCrease--> 8 9## 概述 10 11提供NativeNode接口的类型定义。 12 13**引用文件：** <arkui/native_node.h> 14 15**库：** libace_ndk.z.so 16 17**系统能力：** SystemCapability.ArkUI.ArkUI.Full 18 19**起始版本：** 12 20 21**相关模块：** [ArkUI_NativeModule](capi-arkui-nativemodule.md) 22 23## 汇总 24 25### 结构体 26 27| 名称 | typedef关键字 | 描述 | 28| -- | -- |------------------------------------------------------------------------------| 29| [ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md) | ArkUI_AttributeItem | 定义[setAttribute](capi-arkui-nativemodule-arkui-nativenodeapi-1.md#setattribute)函数通用入参结构。 | 30| [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md) | ArkUI_NodeComponentEvent | 定义组件回调事件的参数类型。 | 31| [ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md) | ArkUI_StringAsyncEvent | 定义组件回调事件使用字符串参数的类型。 | 32| [ArkUI_TextChangeEvent](capi-arkui-nativemodule-arkui-textchangeevent.md) | ArkUI_TextChangeEvent | 定义组件事件的混合类型数据。 | 33| [ArkUI_NativeNodeAPI_1](capi-arkui-nativemodule-arkui-nativenodeapi-1.md) | ArkUI_NativeNodeAPI_1 | ArkUI提供的Native侧Node类型接口集合。Node模块相关接口需要在主线程上调用。 | 34| [ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md) | ArkUI_NodeEvent | 定义组件事件的通用结构类型。 | 35| [ArkUI_NodeCustomEvent](capi-arkui-nativemodule-arkui-nodecustomevent.md) | ArkUI_NodeCustomEvent | 定义自定义组件事件的通用结构类型。 | 36| [ArkUI_NodeAdapter*](capi-arkui-nativemodule-arkui-nodeadapter8h.md) | ArkUI_NodeAdapterHandle | 定义组件适配器对象，用于滚动类组件的元素懒加载。 | 37| [ArkUI_NodeAdapterEvent](capi-arkui-nativemodule-arkui-nodeadapterevent.md) | ArkUI_NodeAdapterEvent | 定义适配器事件对象。 | 38| [ArkUI_NodeContentEvent](capi-arkui-nativemodule-arkui-nodecontentevent.md) | ArkUI_NodeContentEvent | 定义NodeContent事件的通用结构类型。 | 39 40### 枚举 41 42| 名称 | typedef关键字 | 描述 | 43| -- | -- | -- | 44| [ArkUI_NodeType](#arkui_nodetype) | ArkUI_NodeType | 提供ArkUI在Native侧可创建组件类型。 | 45| [ArkUI_NodeAttributeType](#arkui_nodeattributetype) | ArkUI_NodeAttributeType | 定义ArkUI在Native侧可以设置的属性样式集合。 | 46| [ArkUI_NodeEventType](#arkui_nodeeventtype) | ArkUI_NodeEventType | 提供NativeNode组件支持的事件类型定义。 | 47| [ArkUI_NodeDirtyFlag](#arkui_nodedirtyflag) | ArkUI_NodeDirtyFlag | 自定义组件调用<b>::markDirty</b>时，传递的脏区标识类型。 | 48| [ArkUI_NodeCustomEventType](#arkui_nodecustomeventtype) | ArkUI_NodeCustomEventType | 定义自定义组件事件类型。 | 49| [ArkUI_NodeAdapterEventType](#arkui_nodeadaptereventtype) | ArkUI_NodeAdapterEventType | 定义节点适配器事件枚举值。 | 50| [ArkUI_NodeContentEventType](#arkui_nodecontenteventtype) | ArkUI_NodeContentEventType | 定义NodeContent事件类型。 | 51| [ArkUI_InspectorErrorCode](#arkui_inspectorerrorcode) | ArkUI_InspectorErrorCode | inspector错误码的枚举。 | 52 53### 函数 54 55| 名称 | typedef关键字 | 描述 | 56| -- | -- | -- | 57| [ArkUI_NodeEventType OH_ArkUI_NodeEvent_GetEventType(ArkUI_NodeEvent* event)](#oh_arkui_nodeevent_geteventtype) | - | 获取组件事件类型。 | 58| [int32_t OH_ArkUI_NodeEvent_GetTargetId(ArkUI_NodeEvent* event)](#oh_arkui_nodeevent_gettargetid) | - | 获取事件自定义标识ID。该事件id在调用[registerNodeEvent](capi-arkui-nativemodule-arkui-nativenodeapi-1.md#registernodeevent)函数时作为参数传递进来，可应用于同一事件入口函数[registerNodeEventReceiver](capi-arkui-nativemodule-arkui-nativenodeapi-1.md#registernodeeventreceiver)分发逻辑。 | 59| [ArkUI_NodeHandle OH_ArkUI_NodeEvent_GetNodeHandle(ArkUI_NodeEvent* event)](#oh_arkui_nodeevent_getnodehandle) | - | 获取触发该事件的组件对象。 | 60| [ArkUI_UIInputEvent* OH_ArkUI_NodeEvent_GetInputEvent(ArkUI_NodeEvent* event)](#oh_arkui_nodeevent_getinputevent) | - | 获取组件事件中的输入事件（如触碰事件）数据。 | 61| [ArkUI_NodeComponentEvent* OH_ArkUI_NodeEvent_GetNodeComponentEvent(ArkUI_NodeEvent* event)](#oh_arkui_nodeevent_getnodecomponentevent) | - | 获取组件事件中的数字类型数据。 | 62| [ArkUI_StringAsyncEvent* OH_ArkUI_NodeEvent_GetStringAsyncEvent(ArkUI_NodeEvent* event)](#oh_arkui_nodeevent_getstringasyncevent) | - | 获取组件事件中的字符串数据。 | 63| [ArkUI_TextChangeEvent* OH_ArkUI_NodeEvent_GetTextChangeEvent(ArkUI_NodeEvent* event)](#oh_arkui_nodeevent_gettextchangeevent) | - | 获取组件事件中的ArkUI_TextChangeEvent数据。 | 64| [void* OH_ArkUI_NodeEvent_GetUserData(ArkUI_NodeEvent* event)](#oh_arkui_nodeevent_getuserdata) | - | 获取组件事件中的用户自定义数据。该自定义参数在调用[registerNodeEvent](capi-arkui-nativemodule-arkui-nativenodeapi-1.md#registernodeevent)函数时作为参数传递进来，可应用于事件触发时的业务逻辑处理。 | 65| [int32_t OH_ArkUI_NodeEvent_GetNumberValue(ArkUI_NodeEvent* event, int32_t index, ArkUI_NumberValue* value)](#oh_arkui_nodeevent_getnumbervalue) | - | 获取组件回调事件的数字类型参数。 | 66| [int32_t OH_ArkUI_NodeEvent_GetStringValue(ArkUI_NodeEvent* event, int32_t index, char** string, int32_t* stringSize)](#oh_arkui_nodeevent_getstringvalue) | - | 获取组件回调事件的字符串类型参数，字符串数据仅在事件回调过程中有效，需要在事件回调外使用建议进行额外拷贝处理。 | 67| [int32_t OH_ArkUI_NodeEvent_SetReturnNumberValue(ArkUI_NodeEvent* event, ArkUI_NumberValue* value, int32_t size)](#oh_arkui_nodeevent_setreturnnumbervalue) | - | 设置组件回调事件的返回值。 | 68| [ArkUI_NodeAdapterHandle OH_ArkUI_NodeAdapter_Create()](#oh_arkui_nodeadapter_create) | - | 创建组件适配器对象。 | 69| [void OH_ArkUI_NodeAdapter_Dispose(ArkUI_NodeAdapterHandle handle)](#oh_arkui_nodeadapter_dispose) | - | 销毁组件适配器对象。 | 70| [int32_t OH_ArkUI_NodeAdapter_SetTotalNodeCount(ArkUI_NodeAdapterHandle handle, uint32_t size)](#oh_arkui_nodeadapter_settotalnodecount) | - | 设置Adapter中的元素总数。 | 71| [uint32_t OH_ArkUI_NodeAdapter_GetTotalNodeCount(ArkUI_NodeAdapterHandle handle)](#oh_arkui_nodeadapter_gettotalnodecount) | - | 获取Adapter中的元素总数。 | 72| [int32_t OH_ArkUI_NodeAdapter_RegisterEventReceiver(ArkUI_NodeAdapterHandle handle, void* userData, void (\*receiver)(ArkUI_NodeAdapterEvent* event))](#oh_arkui_nodeadapter_registereventreceiver) | - | 注册Adapter相关回调事件。 | 73| [void OH_ArkUI_NodeAdapter_UnregisterEventReceiver(ArkUI_NodeAdapterHandle handle)](#oh_arkui_nodeadapter_unregistereventreceiver) | - | 注销Adapter相关回调事件。 | 74| [int32_t OH_ArkUI_NodeAdapter_ReloadAllItems(ArkUI_NodeAdapterHandle handle)](#oh_arkui_nodeadapter_reloadallitems) | - | 通知Adapter进行全量元素变化。 | 75| [int32_t OH_ArkUI_NodeAdapter_ReloadItem(ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount)](#oh_arkui_nodeadapter_reloaditem) | - | 通知Adapter进行局部元素变化。 | 76| [int32_t OH_ArkUI_NodeAdapter_RemoveItem(ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount)](#oh_arkui_nodeadapter_removeitem) | - | 通知Adapter进行局部元素删除。 | 77| [int32_t OH_ArkUI_NodeAdapter_InsertItem(ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount)](#oh_arkui_nodeadapter_insertitem) | - | 通知Adapter进行局部元素插入。 | 78| [int32_t OH_ArkUI_NodeAdapter_MoveItem(ArkUI_NodeAdapterHandle handle, uint32_t from, uint32_t to)](#oh_arkui_nodeadapter_moveitem) | - | 通知Adapter进行局部元素移位。 | 79| [int32_t OH_ArkUI_NodeAdapter_GetAllItems(ArkUI_NodeAdapterHandle handle, ArkUI_NodeHandle** items, uint32_t* size)](#oh_arkui_nodeadapter_getallitems) | - | 获取存储在Adapter中的所有元素。接口调用会返回元素的数组对象指针，该指针指向的内存数据需要开发者手动释放。 | 80| [void* OH_ArkUI_NodeAdapterEvent_GetUserData(ArkUI_NodeAdapterEvent* event)](#oh_arkui_nodeadapterevent_getuserdata) | - | 获取注册事件时传入的自定义数据。 | 81| [ArkUI_NodeAdapterEventType OH_ArkUI_NodeAdapterEvent_GetType(ArkUI_NodeAdapterEvent* event)](#oh_arkui_nodeadapterevent_gettype) | - | 获取事件类型。 | 82| [ArkUI_NodeHandle OH_ArkUI_NodeAdapterEvent_GetRemovedNode(ArkUI_NodeAdapterEvent* event)](#oh_arkui_nodeadapterevent_getremovednode) | - | 获取需要销毁的事件中待销毁的元素。 | 83| [uint32_t OH_ArkUI_NodeAdapterEvent_GetItemIndex(ArkUI_NodeAdapterEvent* event)](#oh_arkui_nodeadapterevent_getitemindex) | - | 获取适配器事件时需要操作的元素序号。 | 84| [ArkUI_NodeHandle OH_ArkUI_NodeAdapterEvent_GetHostNode(ArkUI_NodeAdapterEvent* event)](#oh_arkui_nodeadapterevent_gethostnode) | - | 获取使用该适配器的滚动类容器节点。 | 85| [int32_t OH_ArkUI_NodeAdapterEvent_SetItem(ArkUI_NodeAdapterEvent* event, ArkUI_NodeHandle node)](#oh_arkui_nodeadapterevent_setitem) | - | 设置需要新增到Adapter中的组件。 | 86| [int32_t OH_ArkUI_NodeAdapterEvent_SetNodeId(ArkUI_NodeAdapterEvent* event, int32_t id)](#oh_arkui_nodeadapterevent_setnodeid) | - | 设置生成的组件标识。 | 87| [ArkUI_LayoutConstraint* OH_ArkUI_NodeCustomEvent_GetLayoutConstraintInMeasure(ArkUI_NodeCustomEvent* event)](#oh_arkui_nodecustomevent_getlayoutconstraintinmeasure) | - | 通过自定义组件事件获取测算过程中的约束尺寸。 | 88| [ArkUI_IntOffset OH_ArkUI_NodeCustomEvent_GetPositionInLayout(ArkUI_NodeCustomEvent* event)](#oh_arkui_nodecustomevent_getpositioninlayout) | - | 通过自定义组件事件获取在布局阶段期望自身相对父组件的位置。 | 89| [ArkUI_DrawContext* OH_ArkUI_NodeCustomEvent_GetDrawContextInDraw(ArkUI_NodeCustomEvent* event)](#oh_arkui_nodecustomevent_getdrawcontextindraw) | - | 通过自定义组件事件获取绘制上下文。 | 90| [int32_t OH_ArkUI_NodeCustomEvent_GetEventTargetId(ArkUI_NodeCustomEvent* event)](#oh_arkui_nodecustomevent_geteventtargetid) | - | 通过自定义组件事件获取自定义事件ID。 | 91| [void* OH_ArkUI_NodeCustomEvent_GetUserData(ArkUI_NodeCustomEvent* event)](#oh_arkui_nodecustomevent_getuserdata) | - | 通过自定义组件事件获取自定义事件参数。 | 92| [ArkUI_NodeHandle OH_ArkUI_NodeCustomEvent_GetNodeHandle(ArkUI_NodeCustomEvent* event)](#oh_arkui_nodecustomevent_getnodehandle) | - | 通过自定义组件事件获取组件对象。 | 93| [ArkUI_NodeCustomEventType OH_ArkUI_NodeCustomEvent_GetEventType(ArkUI_NodeCustomEvent* event)](#oh_arkui_nodecustomevent_geteventtype) | - | 通过自定义组件事件获取事件类型。 | 94| [int32_t OH_ArkUI_NodeCustomEvent_GetCustomSpanMeasureInfo(ArkUI_NodeCustomEvent* event, ArkUI_CustomSpanMeasureInfo* info)](#oh_arkui_nodecustomevent_getcustomspanmeasureinfo) | - | 通过自定义组件事件获取自定义段落组件的测量信息。 | 95| [int32_t OH_ArkUI_NodeCustomEvent_SetCustomSpanMetrics(ArkUI_NodeCustomEvent* event, ArkUI_CustomSpanMetrics* metrics)](#oh_arkui_nodecustomevent_setcustomspanmetrics) | - | 通过自定义组件事件设置自定义段落的度量指标。 | 96| [int32_t OH_ArkUI_NodeCustomEvent_GetCustomSpanDrawInfo(ArkUI_NodeCustomEvent* event, ArkUI_CustomSpanDrawInfo* info)](#oh_arkui_nodecustomevent_getcustomspandrawinfo) | - | 通过自定义组件事件获取自定义段落组件的绘制信息。 | 97| [typedef void (\*ArkUI_NodeContentCallback)(ArkUI_NodeContentEvent* event)](#arkui_nodecontentcallback) | ArkUI_NodeContentCallback | 定义NodeContent事件的回调函数类型。 | 98| [int32_t OH_ArkUI_NodeContent_RegisterCallback(ArkUI_NodeContentHandle content, ArkUI_NodeContentCallback callback)](#oh_arkui_nodecontent_registercallback) | - | 注册NodeContent事件函数。 | 99| [ArkUI_NodeContentEventType OH_ArkUI_NodeContentEvent_GetEventType(ArkUI_NodeContentEvent* event)](#oh_arkui_nodecontentevent_geteventtype) | - | 获取触发NodeContent事件的事件类型。 | 100| [ArkUI_NodeContentHandle OH_ArkUI_NodeContentEvent_GetNodeContentHandle(ArkUI_NodeContentEvent* event)](#oh_arkui_nodecontentevent_getnodecontenthandle) | - | 获取触发事件的NodeContent对象。 | 101| [int32_t OH_ArkUI_NodeContent_SetUserData(ArkUI_NodeContentHandle content, void* userData)](#oh_arkui_nodecontent_setuserdata) | - | 在NodeContent对象上保存自定义数据。 | 102| [void* OH_ArkUI_NodeContent_GetUserData(ArkUI_NodeContentHandle content)](#oh_arkui_nodecontent_getuserdata) | - | 获取在NodeContent对象上保存的自定义数据。 | 103| [int32_t OH_ArkUI_NodeContent_AddNode(ArkUI_NodeContentHandle content, ArkUI_NodeHandle node)](#oh_arkui_nodecontent_addnode) | - | 将一个ArkUI组件节点添加到对应的NodeContent对象下。 | 104| [int32_t OH_ArkUI_NodeContent_RemoveNode(ArkUI_NodeContentHandle content, ArkUI_NodeHandle node)](#oh_arkui_nodecontent_removenode) | - | 删除NodeContent对象下的一个ArkUI组件节点。 | 105| [int32_t OH_ArkUI_NodeContent_InsertNode(ArkUI_NodeContentHandle content, ArkUI_NodeHandle node, int32_t position)](#oh_arkui_nodecontent_insertnode) | - | 将一个ArkUI组件节点插入到对应的NodeContent对象的特定位置下。 | 106| [int32_t OH_ArkUI_NodeUtils_GetLayoutSize(ArkUI_NodeHandle node, ArkUI_IntSize* size)](#oh_arkui_nodeutils_getlayoutsize) | - | 获取组件布局区域的大小。布局区域大小不包含图形变化属性，如缩放。 | 107| [int32_t OH_ArkUI_NodeUtils_GetLayoutPosition(ArkUI_NodeHandle node, ArkUI_IntOffset* localOffset)](#oh_arkui_nodeutils_getlayoutposition) | - | 获取组件布局区域相对父组件的位置。布局区域相对位置不包含图形变化属性，如平移。 | 108| [int32_t OH_ArkUI_NodeUtils_GetLayoutPositionInWindow(ArkUI_NodeHandle node, ArkUI_IntOffset* globalOffset)](#oh_arkui_nodeutils_getlayoutpositioninwindow) | - | 获取组件布局区域相对窗口的位置。布局区域相对位置不包含图形变化属性，如平移。 | 109| [int32_t OH_ArkUI_NodeUtils_GetLayoutPositionInScreen(ArkUI_NodeHandle node, ArkUI_IntOffset* screenOffset)](#oh_arkui_nodeutils_getlayoutpositioninscreen) | - | 获取组件布局区域相对屏幕的位置。布局区域相对位置不包含图形变化属性，如平移。 | 110| [int32_t OH_ArkUI_NodeUtils_GetLayoutPositionInGlobalDisplay(ArkUI_NodeHandle node, ArkUI_IntOffset* offset)](#oh_arkui_nodeutils_getlayoutpositioninglobaldisplay) | - | 获取组件相对于全局屏幕的偏移。布局区域相对位置不包含图形变化属性，如平移。 | 111| [int32_t OH_ArkUI_NodeUtils_GetPositionWithTranslateInWindow(ArkUI_NodeHandle node, ArkUI_IntOffset* translateOffset)](#oh_arkui_nodeutils_getpositionwithtranslateinwindow) | - | 获取组件在窗口中的位置，包含了图形平移变化属性。 | 112| [int32_t OH_ArkUI_NodeUtils_GetPositionWithTranslateInScreen(ArkUI_NodeHandle node, ArkUI_IntOffset* translateOffset)](#oh_arkui_nodeutils_getpositionwithtranslateinscreen) | - | 获取组件在屏幕中的位置，包含了图形平移变化属性。 | 113| [void OH_ArkUI_NodeUtils_AddCustomProperty(ArkUI_NodeHandle node, const char* name, const char* value)](#oh_arkui_nodeutils_addcustomproperty) | - | 设置组件的自定义属性。该接口仅在主线程生效。 | 114| [void OH_ArkUI_NodeUtils_RemoveCustomProperty(ArkUI_NodeHandle node, const char* name)](#oh_arkui_nodeutils_removecustomproperty) | - | 移除组件已设置的自定义属性。 | 115| [int32_t OH_ArkUI_NodeUtils_GetCustomProperty(ArkUI_NodeHandle node, const char* name, ArkUI_CustomProperty** handle)](#oh_arkui_nodeutils_getcustomproperty) | - | 获取组件的自定义属性的值。 | 116| [ArkUI_NodeHandle OH_ArkUI_NodeUtils_GetParentInPageTree(ArkUI_NodeHandle node)](#oh_arkui_nodeutils_getparentinpagetree) | - | 获取父节点，可获取由ArkTs创建的组件节点。 | 117| [int32_t OH_ArkUI_NodeUtils_GetActiveChildrenInfo(ArkUI_NodeHandle head, ArkUI_ActiveChildrenInfo** handle)](#oh_arkui_nodeutils_getactivechildreninfo) | - | 获取某个节点所有活跃的子节点。Span将不会被计入子节点的统计中。 | 118| [ArkUI_NodeHandle OH_ArkUI_NodeUtils_GetCurrentPageRootNode(ArkUI_NodeHandle node)](#oh_arkui_nodeutils_getcurrentpagerootnode) | - | 获取当前页面的根节点。 | 119| [bool OH_ArkUI_NodeUtils_IsCreatedByNDK(ArkUI_NodeHandle node)](#oh_arkui_nodeutils_iscreatedbyndk) | - | 获取组件是否由C-API创建的标签。 | 120| [int32_t OH_ArkUI_NodeUtils_GetNodeType(ArkUI_NodeHandle node)](#oh_arkui_nodeutils_getnodetype) | - | 获取节点的类型。 | 121| [int32_t OH_ArkUI_NodeUtils_GetWindowInfo(ArkUI_NodeHandle node, ArkUI_HostWindowInfo** info)](#oh_arkui_nodeutils_getwindowinfo) | - | 获取节点所属的窗口信息。 | 122| [int32_t OH_ArkUI_NodeUtils_MoveTo(ArkUI_NodeHandle node, ArkUI_NodeHandle target_parent, int32_t index)](#oh_arkui_nodeutils_moveto) | - | 将节点移动到目标父节点下，作为子节点。 | 123| [int32_t OH_ArkUI_List_CloseAllSwipeActions(ArkUI_NodeHandle node, void* userData, void (\*onFinish)(void* userData))](#oh_arkui_list_closeallswipeactions) | - | 收起展开状态下的ListItem。 | 124| [ArkUI_ContextHandle OH_ArkUI_GetContextByNode(ArkUI_NodeHandle node)](#oh_arkui_getcontextbynode) | - | 获取当前节点所在页面的UI的上下文实例对象指针。 | 125| [int32_t OH_ArkUI_RegisterSystemColorModeChangeEvent(ArkUI_NodeHandle node,void* userData, void (\*onColorModeChange)(ArkUI_SystemColorMode colorMode, void* userData))](#oh_arkui_registersystemcolormodechangeevent) | - | 注册系统深浅色变更事件。同一组件仅能注册一个系统深浅变更回调。示例请参考：[监听组件事件](../../ui/ndk-listen-to-component-events.md)。 | 126| [void OH_ArkUI_UnregisterSystemColorModeChangeEvent(ArkUI_NodeHandle node)](#oh_arkui_unregistersystemcolormodechangeevent) | - | 注销系统深浅色变更事件。 | 127| [int32_t OH_ArkUI_RegisterSystemFontStyleChangeEvent(ArkUI_NodeHandle node,void* userData, void (\*onFontStyleChange)(ArkUI_SystemFontStyleEvent* event, void* userData))](#oh_arkui_registersystemfontstylechangeevent) | - | 注册系统字体变更事件。同一组件仅能注册一个系统字体变更回调。 | 128| [void OH_ArkUI_UnregisterSystemFontStyleChangeEvent(ArkUI_NodeHandle node)](#oh_arkui_unregistersystemfontstylechangeevent) | - | 注销系统字体变更事件。 | 129| [float OH_ArkUI_SystemFontStyleEvent_GetFontSizeScale(const ArkUI_SystemFontStyleEvent* event)](#oh_arkui_systemfontstyleevent_getfontsizescale) | - | 获取系统字体变更事件的字体大小值。 | 130| [float OH_ArkUI_SystemFontStyleEvent_GetFontWeightScale(const ArkUI_SystemFontStyleEvent* event)](#oh_arkui_systemfontstyleevent_getfontweightscale) | - | 获取系统字体变更事件的字体粗细值。 | 131| [int32_t OH_ArkUI_RegisterLayoutCallbackOnNodeHandle(ArkUI_NodeHandle node,void* userData, void (\*onLayoutCompleted)(void* userData))](#oh_arkui_registerlayoutcallbackonnodehandle) | - | 注册指定节点的布局完成回调函数。 | 132| [int32_t OH_ArkUI_RegisterDrawCallbackOnNodeHandle(ArkUI_NodeHandle node,void* userData, void (\*onDrawCompleted)(void* userData))](#oh_arkui_registerdrawcallbackonnodehandle) | - | 注册指定节点的绘制完成回调函数。 | 133| [int32_t OH_ArkUI_UnregisterLayoutCallbackOnNodeHandle(ArkUI_NodeHandle node)](#oh_arkui_unregisterlayoutcallbackonnodehandle) | - | 取消注册指定节点的布局完成回调函数。 | 134| [int32_t OH_ArkUI_UnregisterDrawCallbackOnNodeHandle(ArkUI_NodeHandle node)](#oh_arkui_unregisterdrawcallbackonnodehandle) | - | 取消注册指定节点的绘制完成回调函数。 | 135| [int32_t OH_ArkUI_GetNodeSnapshot(ArkUI_NodeHandle node, ArkUI_SnapshotOptions* snapshotOptions,OH_PixelmapNative** pixelmap)](#oh_arkui_getnodesnapshot) | - | 获取给定组件的截图，若节点不在组件树上或尚未渲染，截图操作将会失败。当pixelmap不再使用时，应通过调用OH_PixelmapNative_Release来释放。 | 136| [int32_t OH_ArkUI_NodeUtils_GetAttachedNodeHandleById(const char* id, ArkUI_NodeHandle* node)](#oh_arkui_nodeutils_getattachednodehandlebyid) | - | 根据用户id获取目标节点。 | 137| [int32_t OH_ArkUI_NodeUtils_GetNodeHandleByUniqueId(const uint32_t uniqueId, ArkUI_NodeHandle* node)](#oh_arkui_nodeutils_getnodehandlebyuniqueid) | - | 通过uniqueId获取节点。 | 138| [int32_t OH_ArkUI_NodeUtils_GetNodeUniqueId(ArkUI_NodeHandle node, int32_t* uniqueId)](#oh_arkui_nodeutils_getnodeuniqueid) | - | 获取目标节点的uniqueId。 | 139| [int32_t OH_ArkUI_NodeUtils_SetCrossLanguageOption(ArkUI_NodeHandle node, ArkUI_CrossLanguageOption* option)](#oh_arkui_nodeutils_setcrosslanguageoption) | - | 设置目标节点跨语言设置属性的能力。 | 140| [int32_t OH_ArkUI_NodeUtils_GetCrossLanguageOption(ArkUI_NodeHandle node, ArkUI_CrossLanguageOption* option)](#oh_arkui_nodeutils_getcrosslanguageoption) | - | 获取目标节点跨语言设置属性的配置项。 | 141| [int32_t OH_ArkUI_NodeUtils_GetFirstChildIndexWithoutExpand(ArkUI_NodeHandle node, uint32_t* index)](#oh_arkui_nodeutils_getfirstchildindexwithoutexpand) | - | 获取目标节点在树上的第一个子节点的下标。 | 142| [int32_t OH_ArkUI_NodeUtils_GetLastChildIndexWithoutExpand(ArkUI_NodeHandle node, uint32_t* index)](#oh_arkui_nodeutils_getlastchildindexwithoutexpand) | - | 获取目标节点在树上的最后一个子节点的下标。 | 143| [int32_t OH_ArkUI_NodeUtils_GetChildWithExpandMode(ArkUI_NodeHandle node, int32_t position,ArkUI_NodeHandle* subnode, uint32_t expandMode)](#oh_arkui_nodeutils_getchildwithexpandmode) | - | 用不同的展开模式获取对应下标的子节点。 | 144| [int32_t OH_ArkUI_NodeUtils_GetPositionToParent(ArkUI_NodeHandle node, ArkUI_IntOffset* globalOffset)](#oh_arkui_nodeutils_getpositiontoparent) | - | 获取目标节点相对于父节点的偏移值，单位：px。 | 145| [ArkUI_ErrorCode OH_ArkUI_AddSupportedUIStates(ArkUI_NodeHandle node, int32_t uiStates,void (statesChangeHandler)(int32_t currentStates, void* userData), bool excludeInner, void* userData)](#oh_arkui_addsupporteduistates) | - | 设置组件支持的多态样式状态。为了更高效地处理，需传入所关注的状态值及对应的状态处理函数，当关注的状态发生时，处理函数会被执行。可在回调中根据当前状态调整UI样式。当在同一个节点上多次调用该方法时，将以最后一次传入的状态及处理函数为准。有些类型的组件节点，系统内部已有对某些状态的默认处理。例如，Button组件默认具备对PRESSED状态的样式变化，当在此类组件上使用此方法自定义状态处理时，会先应用系统默认样式变化，再执行自定义的样式处理，最终效果为两者叠加。可以通过指定excludeInner为true来禁用系统内部的默认样式效果，但这通常取决于系统内部实现规范是否允许。当调用该函数时，传入的statesChangeHandler函数会立即执行一次，且无需特意注册对NORMAL状态的监听，只要注册了非NORMAL状态，当状态从任意状态变化回NORMAL时，系统都会进行回调，以便应用进行样式复原。 | 146| [ArkUI_ErrorCode OH_ArkUI_RemoveSupportedUIStates(ArkUI_NodeHandle node, int32_t uiStates)](#oh_arkui_removesupporteduistates) | - | 删除注册的状态处理。当通过OH_ArkUI_AddSupportedUIStates注册的状态都被删除时，所注册的stateChangeHandler也不会再被执行。 | 147| [int32_t OH_ArkUI_RunTaskInScope(ArkUI_ContextHandle uiContext, void* userData, void(\*callback)(void* userData))](#oh_arkui_runtaskinscope) | - | 在目标UI上下文中执行传入的自定义回调函数。示例请参考：[在NDK中保证多实例场景功能正常](../../ui/ndk-scope-task.md)。 | 148 149 150### 宏定义 151 152| 名称 | 描述 | 153| -------- | -------- | 154| MAX_NODE_SCOPE_NUM 1000| 定义组件最大方法数量。 | 155| MAX_COMPONENT_EVENT_ARG_NUM 12| 定义组件事件最大参数数量。 | 156 157## 枚举类型说明 158 159### ArkUI_NodeType 160 161``` 162enum ArkUI_NodeType 163``` 164 165**描述：** 166 167 168提供ArkUI在Native侧可创建组件类型。 169 170**起始版本：** 12 171 172| 枚举项 | 描述 | 173| -- |--------------------------------------| 174| ARKUI_NODE_CUSTOM = 0 | 自定义节点。 | 175| ARKUI_NODE_TEXT = 1 | 文本。 | 176| ARKUI_NODE_SPAN = 2 | 文本段落。 | 177| ARKUI_NODE_IMAGE_SPAN = 3 | 文本图片段落。 | 178| ARKUI_NODE_IMAGE = 4 | 图片。 | 179| ARKUI_NODE_TOGGLE = 5 | 状态开关。 | 180| ARKUI_NODE_LOADING_PROGRESS = 6 | 等待图标。 | 181| ARKUI_NODE_TEXT_INPUT = 7 | 单行文本输入。 | 182| ARKUI_NODE_TEXT_AREA = 8 | 多行文本。 | 183| ARKUI_NODE_BUTTON = 9 | 按钮。 | 184| ARKUI_NODE_PROGRESS = 10 | 进度条。 | 185| ARKUI_NODE_CHECKBOX = 11 | 复选框。 | 186| ARKUI_NODE_XCOMPONENT = 12 | SURFACE类型XComponent。 | 187| ARKUI_NODE_DATE_PICKER = 13 | 日期选择器组件。 | 188| ARKUI_NODE_TIME_PICKER = 14 | 时间选择组件。 | 189| ARKUI_NODE_TEXT_PICKER = 15 | 滑动选择文本内容的组件。 | 190| ARKUI_NODE_CALENDAR_PICKER = 16 | 日历选择器组件。 | 191| ARKUI_NODE_SLIDER = 17 | 滑动条组件。 | 192| ARKUI_NODE_RADIO = 18 | 单选框。 | 193| ARKUI_NODE_IMAGE_ANIMATOR = 19 | 帧动画组件。 | 194| ARKUI_NODE_XCOMPONENT_TEXTURE | TEXTURE类型XComponent。<br>**起始版本：** 18 | 195| ARKUI_NODE_CHECKBOX_GROUP = 21 | 复选框组。<br>**起始版本：** 15 | 196| ARKUI_NODE_STACK = MAX_NODE_SCOPE_NUM | 堆叠容器。 | 197| ARKUI_NODE_SWIPER | 翻页容器。 | 198| ARKUI_NODE_SCROLL | 滚动容器。 | 199| ARKUI_NODE_LIST | 列表。 | 200| ARKUI_NODE_LIST_ITEM | 列表项。 | 201| ARKUI_NODE_LIST_ITEM_GROUP | 列表item分组。 | 202| ARKUI_NODE_COLUMN | 垂直布局容器。 | 203| ARKUI_NODE_ROW | 水平布局容器。 | 204| ARKUI_NODE_FLEX | 弹性布局容器。 | 205| ARKUI_NODE_REFRESH | 刷新组件。 | 206| ARKUI_NODE_WATER_FLOW | 瀑布流容器。 | 207| ARKUI_NODE_FLOW_ITEM | 瀑布流子组件。 | 208| ARKUI_NODE_RELATIVE_CONTAINER | 相对布局组件。 | 209| ARKUI_NODE_GRID | 网格容器。 | 210| ARKUI_NODE_GRID_ITEM | 网格子组件。 | 211| ARKUI_NODE_CUSTOM_SPAN | 自定义文本段落。 | 212| ARKUI_NODE_EMBEDDED_COMPONENT | 同应用进程嵌入式组件。 <br>**起始版本：** 20 | 213 214### ArkUI_NodeAttributeType 215 216``` 217enum ArkUI_NodeAttributeType 218``` 219 220**描述：** 221 222 223定义ArkUI在Native侧可以设置的属性样式集合。 224 225**起始版本：** 12 226 227| 枚举项 |描述 | 228| -- |--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| 229| NODE_WIDTH = 0 | 宽度属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：宽度数值，单位为vp；<br>属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：宽度数值，单位为vp；| 230| NODE_HEIGHT | 高度属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：高度数值，单位为vp；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：高度数值，单位为vp；| 231| NODE_BACKGROUND_COLOR | 背景色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：背景色数值，0xargb格式，形如 0xFFFF0000 表示红色；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：背景色数值，0xargb格式，形如 0xFFFF0000 表示红色；| 232| NODE_BACKGROUND_IMAGE | 背景色图片属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string: 图片地址，支持网络图片地址、本地图片地址、Base64或PixelMap对象。不支持SVG类型的图片。<br> .value[0]?.i32：可选值，repeat参数，参数类型[ArkUI_ImageRepeat](capi-native-type-h.md#arkui_imagerepeat)，默认值为ARKUI_IMAGE_REPEAT_NONE；<br> .object：PixelMap 图片数据，参数类型为[ArkUI_DrawableDescriptor](capi-arkui-nativemodule-arkui-drawabledescriptor.md)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string: 图片地址，支持网络图片地址、本地图片地址、Base64或PixelMap对象。不支持SVG类型的图片。<br> .value[0].i32：repeat参数，参数类型[ArkUI_ImageRepeat](capi-native-type-h.md#arkui_imagerepeat)；<br> .object：PixelMap 图片数据，参数类型为[ArkUI_DrawableDescriptor](capi-arkui-nativemodule-arkui-drawabledescriptor.md)；.object参数和.string参数二选一，不可同时设置。| 233| NODE_PADDING | 内间距属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式有两种：<br> 1：上下左右四个位置的内间距值相等。<br> .value[0].f32：内间距数值，单位为vp；<br> 2：分别指定上下左右四个位置的内间距值。<br> .value[0].f32：上内间距数值，单位为vp；<br> .value[1].f32：右内间距数值，单位为vp；<br> .value[2].f32：下内间距数值，单位为vp；<br> .value[3].f32：左内间距数值，单位为vp；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：上内间距数值，单位为vp；<br> .value[1].f32：右内间距数值，单位为vp；<br> .value[2].f32：下内间距数值，单位为vp；<br> .value[3].f32：左内间距数值，单位为vp；| 234| NODE_ID | 组件ID属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string: ID的内容；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string: ID的内容；| 235| NODE_ENABLED | 设置组件是否可交互，支持属性设置，属性重置和属性获取。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：false表示不可交互，true表示可交互；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：0表示不可交互，1表示可交互；| 236| NODE_MARGIN | 外间距属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式有两种：<br> 1：上下左右四个位置的外间距值相等。<br> .value[0].f32：外间距数值，单位为vp；<br> 2：分别指定上下左右四个位置的外间距值。<br> .value[0].f32：上外间距数值，单位为vp；<br> .value[1].f32：右外间距数值，单位为vp；<br> .value[2].f32：下外间距数值，单位为vp；<br> .value[3].f32：左外间距数值，单位为vp；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：上外间距数值，单位为vp；<br> .value[1].f32：右外间距数值，单位为vp；<br> .value[2].f32：下外间距数值，单位为vp；<br> .value[3].f32：左外间距数值，单位为vp；| 237| NODE_TRANSLATE | 设置组件平移，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： x轴移动距离，单位vp，默认值0；<br> .value[1].f32： y轴移动距离，单位vp，默认值0；<br> .value[2].f32： z轴移动距离，单位vp，默认值0。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32： x轴移动距离，单位vp；<br> .value[1].f32： y轴移动距离，单位vp；<br> .value[2].f32： z轴移动距离，单位vp。| 238| NODE_SCALE | 设置组件缩放，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： x轴的缩放系数，默认值1；<br> .value[1].f32： y轴的缩放系数，默认值1。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32： x轴的缩放系数；<br> .value[1].f32： y轴的缩放系数。| 239| NODE_ROTATE | 设置组件旋转，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： 旋转轴向量x坐标，默认值0；<br> .value[1].f32： 旋转轴向量y坐标，默认值0；<br> .value[2].f32： 旋转轴向量z坐标，默认值0；<br> .value[3].f32： 旋转角度，默认值0；<br> .value[4].f32： 视距，即视点到z=0平面的距离，单位vp，默认值0。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： 旋转轴向量x坐标；<br> .value[1].f32： 旋转轴向量y坐标；<br> .value[2].f32： 旋转轴向量z坐标；<br> .value[3].f32： 旋转角度；<br> .value[4].f32： 视距，即视点到z=0平面的距离，单位vp。| 240| NODE_BRIGHTNESS | 设置组件高光效果，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： 亮度值，默认值1.0，推荐取值范围[0,2]。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： 亮度值。| 241| NODE_SATURATION | 设置组件饱和度效果，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： 饱和度值，默认值1.0，推荐取值范围[0,50)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： 饱和度值。 | 242| NODE_BLUR | 设置组件内容模糊效果，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： 模糊半径，模糊半径越大越模糊，为0时不模糊，小于0时按0处理且不会返回错误码。单位vp，默认值0.0。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： 模糊半径，模糊半径越大越模糊，为0时不模糊。单位vp。| 243| NODE_LINEAR_GRADIENT | 设置组件颜色渐变效果，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32： 线性渐变的起始角度，当[ArkUI_LinearGradientDirection](capi-native-type-h.md#arkui_lineargradientdirection)为ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM时，angle属性生效，否则按direction为主要布局方式。0点方向顺时针旋转为正向角度，默认值：180； <br> .value[1].i32：线性渐变的方向，设置除ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM的线性渐变方向后，angle不生效。数据类型[ArkUI_LinearGradientDirection](capi-native-type-h.md#arkui_lineargradientdirection)。 <br> .value[2].i32： 为渐变的颜色重复着色，默认值 false。 <br> .object: 参数类型为[ArkUI_ColorStop](capi-arkui-nativemodule-arkui-colorstop.md)。指定某百分比位置处的渐变色颜色，设置非法颜色直接跳过： <br> colors：渐变色颜色颜色。 <br> stops：渐变位置。 <br> size：颜色个数。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： 线性渐变的起始角度。当为ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM时，angle为设置值，其他情况均为默认值。<br> .value[1].i32：线性渐变的方向。<br> .value[2].i32： 为渐变的颜色重复着色。<br> .object: 参数类型为[ArkUI_ColorStop](capi-arkui-nativemodule-arkui-colorstop.md)。指定某百分比位置处的渐变色颜色，设置非法颜色直接跳过： <br> colors：渐变色颜色颜色。 <br> stops：渐变位置。 <br> size：颜色个数。| 244| NODE_ALIGNMENT | 设置组件内容在元素绘制区域内的对齐方式，支持属性设置，属性重置和属性获取接口。在Stack中该属性与NODE_STACK_ALIGN_CONTENT效果一致，只能设置子组件在容器内的对齐方式。<br> <br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 对齐方式，数据类型[ArkUI_Alignment](capi-native-type-h.md#arkui_alignment)，默认值ARKUI_ALIGNMENT_CENTER。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 对齐方式，数据类型[ArkUI_Alignment](capi-native-type-h.md#arkui_alignment)。| 245| NODE_OPACITY | 透明度属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：透明度数值，取值范围为0到1。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：透明度数值，取值范围为0到1。 | 246| NODE_BORDER_WIDTH | 边框宽度属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> 1: .value[0].f32：统一设置四条边的边框宽度。 <br> 2: .value[0].f32：设置上边框的边框宽度。 <br> .value[1].f32：设置右边框的边框宽度。 <br> .value[2].f32：设置下边框的边框宽度。 <br> .value[3].f32：设置左边框的边框宽度。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：设置上边框的边框宽度。 <br> .value[1].f32：设置右边框的边框宽度。 <br> .value[2].f32：设置下边框的边框宽度。 <br> .value[3].f32：设置左边框的边框宽度。| 247| NODE_BORDER_RADIUS | 边框圆角属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> 1: .value[0].f32：统一设置四条边的边框圆角。 <br> 2: .value[0].f32：设置左上角圆角半径。 <br> .value[1].f32：设置右上角圆角半径。 <br> .value[2].f32：设置左下角圆角半径。 <br> .value[3].f32：设置右下角圆角半径。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：设置左上角圆角半径。 <br> .value[1].f32：设置右上角圆角半径。 <br> .value[2].f32：设置左下角圆角半径。 <br> .value[3].f32：设置右下角圆角半径。 | 248| NODE_BORDER_COLOR | 边框颜色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> 1: .value[0].u32：统一设置四条边的边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> 2: .value[0].u32：设置上侧边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> .value[1].u32：设置右侧边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> .value[2].u32：设置下侧边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> .value[3].u32：设置左侧边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：设置上侧边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> .value[1].u32：设置右侧边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> .value[2].u32：设置下侧边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> .value[3].u32：设置左侧边框颜色，使用0xargb表示，如0xFFFF11FF。| 249| NODE_BORDER_STYLE | 边框线条样式属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> 1: .value[0].i32：统一设置四条边的边框线条样式，参数类型[ArkUI_BorderStyle](capi-native-type-h.md#arkui_borderstyle)，默认值为ARKUI_BORDER_STYLE_SOLID。 <br> 2:.value[0].i32：设置上侧边框线条样式，参数类型[ArkUI_BorderStyle](capi-native-type-h.md#arkui_borderstyle)，默认值为ARKUI_BORDER_STYLE_SOLID。 <br> .value[1].i32：设置右侧边框线条样式，参数类型[ArkUI_BorderStyle](capi-native-type-h.md#arkui_borderstyle)，默认值为ARKUI_BORDER_STYLE_SOLID。 <br> .value[2].i32：设置下侧边框线条样式，参数类型[ArkUI_BorderStyle](capi-native-type-h.md#arkui_borderstyle)，默认值为ARKUI_BORDER_STYLE_SOLID。 <br> .value[3].i32：设置左侧边框线条样式，参数类型[ArkUI_BorderStyle](capi-native-type-h.md#arkui_borderstyle)，默认值为ARKUI_BORDER_STYLE_SOLID。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：上侧边框线条样式对应的数值。 <br> .value[1].i32：右侧边框线条样式对应的数值。 <br> .value[2].i32：下侧边框线条样式对应的数值。 <br> .value[3].i32：左侧边框线条样式对应的数值。 | 250| NODE_Z_INDEX | 组件的堆叠顺序属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：堆叠顺序数值。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：堆叠顺序数值。 | 251| NODE_VISIBILITY | 组件是否可见属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：控制当前组件显示或隐藏，参数类型[ArkUI_Visibility](capi-native-type-h.md#arkui_visibility)，默认值为ARKUI_VISIBILITY_VISIBLE。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：控制当前组件显示或隐藏，参数类型[ArkUI_Visibility](capi-native-type-h.md#arkui_visibility)，默认值为ARKUI_VISIBILITY_VISIBLE。| 252| NODE_CLIP | 组件进行裁剪、遮罩处理属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：控制是否按照父容器边缘轮廓进行裁剪，0表示不裁切，1表示裁切。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：控制是否按照父容器边缘轮廓进行裁剪，0表示不裁切，1表示裁切。| 253| NODE_CLIP_SHAPE | 组件上指定形状的裁剪，支持属性设置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式，共有4种类型： <br> 1.rect类型： <br> .value[0].i32：裁剪类型，参数类型[ArkUI_ClipType](capi-native-type-h.md#arkui_cliptype)，ARKUI_CLIP_TYPE_RECTANGLE； <br> .value[1].f32：矩形宽度； <br> .value[2].f32：矩形高度； <br> .value[3].f32：矩形圆角宽度； <br> .value[4].f32：矩形圆角高度； <br> .value[5]?.f32：矩形形状的左上圆角半径； <br> .value[6]?.f32：矩形形状的左下圆角半径； <br> .value[7]?.f32：矩形形状的右上圆角半径； <br> .value[8]?.f32：矩形形状的右下圆角半径； <br> 2.circle类型： <br> .value[0].i32：裁剪类型，参数类型[ArkUI_ClipType](capi-native-type-h.md#arkui_cliptype)，ARKUI_CLIP_TYPE_CIRCLE； <br> .value[1].f32：圆形宽度； <br> .value[2].f32：圆形高度； <br> 3.ellipse类型： <br> .value[0].i32：裁剪类型，参数类型[ArkUI_ClipType](capi-native-type-h.md#arkui_cliptype)，ARKUI_CLIP_TYPE_ELLIPSE； <br> .value[1].f32：椭圆形宽度； <br> .value[2].f32：椭圆形高度； <br> 4.path类型： <br> .value[0].i32：裁剪类型，参数类型[ArkUI_ClipType](capi-native-type-h.md#arkui_cliptype)，ARKUI_CLIP_TYPE_PATH； <br> .value[1].f32：路径宽度； <br> .value[2].f32：路径高度； <br> .string：路径绘制的命令字符串； <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式，共有4种类型： <br> 1.rect类型： <br> .value[0].i32：裁剪类型，参数类型[ArkUI_ClipType](capi-native-type-h.md#arkui_cliptype)，ARKUI_CLIP_TYPE_RECTANGLE； <br> .value[1].f32：矩形宽度； <br> .value[2].f32：矩形高度； <br> .value[3].f32：矩形圆角宽度； <br> .value[4].f32：矩形圆角高度； <br> .value[5]?.f32：矩形形状的左上圆角半径； <br> .value[6]?.f32：矩形形状的左下圆角半径； <br> .value[7]?.f32：矩形形状的右上圆角半径； <br> .value[8]?.f32：矩形形状的右下圆角半径； <br> 2.circle类型： <br> .value[0].i32：裁剪类型，参数类型[ArkUI_ClipType](capi-native-type-h.md#arkui_cliptype)，ARKUI_CLIP_TYPE_CIRCLE； <br> .value[1].f32：圆形宽度； <br> .value[2].f32：圆形高度； <br> 3.ellipse类型： <br> .value[0].i32：裁剪类型，参数类型[ArkUI_ClipType](capi-native-type-h.md#arkui_cliptype)，ARKUI_CLIP_TYPE_ELLIPSE； <br> .value[1].f32：椭圆形宽度； <br> .value[2].f32：椭圆形高度； <br> 4.path类型： <br> .value[0].i32：裁剪类型，参数类型[ArkUI_ClipType](capi-native-type-h.md#arkui_cliptype)，ARKUI_CLIP_TYPE_PATH； <br> .value[1].f32：路径宽度； <br> .value[2].f32：路径高度； <br> .string：路径绘制的命令字符串； | 254| NODE_TRANSFORM | 矩阵变换功能，可对图形进行平移、旋转和缩放等，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0...15].f32: 16个浮点数字。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0...15].f32: 16个浮点数字。| 255| NODE_HIT_TEST_BEHAVIOR | 触摸测试类型，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：控制当前组件的触摸测试类型，参数类型[ArkUI_HitTestMode](capi-native-type-h.md#arkui_hittestmode)，默认值为ARKUI_HIT_TEST_MODE_DEFAULT。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：控制当前组件的触摸测试类型，参数类型ArkUI_HitTestMode，默认值为ARKUI_HIT_TEST_MODE_DEFAULT。 | 256| NODE_POSITION | 元素左上角相对于父容器左上角偏移位置，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：x轴坐标。 <br> .value[1].f32: y轴坐标。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：x轴坐标。 <br> .value[1].f32: y轴坐标。 | 257| NODE_SHADOW | 阴影效果属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：设置当前组件阴影效果，参数类型[ArkUI_ShadowStyle](capi-native-type-h.md#arkui_shadowstyle)。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：设置当前组件阴影效果，参数类型[ArkUI_ShadowStyle](capi-native-type-h.md#arkui_shadowstyle)。 | 258| NODE_CUSTOM_SHADOW | 自定义阴影效果，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0]?.f32：阴影模糊半径，单位为vp；<br> .value[1]?.i32：是否开启智能取色，0代表不开启，1代表开启，默认不开启；<br> .value[2]?.f32：阴影X轴偏移量，单位为px；<br> .value[3]?.f32：阴影Y轴偏移量，单位为px；<br> .value[4]?.i32：阴影类型[ArkUI_ShadowType](capi-native-type-h.md#arkui_shadowtype)，默认值为ARKUI_SHADOW_TYPE_COLOR；<br> .value[5]?.u32：阴影颜色，0xargb格式，形如 0xFFFF0000 表示红色；<br> .value[6]?.u32：阴影是否内部填充，0表示不填充，1表示填充。<br> <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：阴影模糊半径，单位为vp；<br> .value[1].i32：是否开启智能取色；<br> .value[2].f32：阴影X轴偏移量，单位为px；<br> .value[3].f32：阴影Y轴偏移量，单位为px；<br> .value[4].i32：阴影类型[ArkUI_ShadowType](capi-native-type-h.md#arkui_shadowtype)，默认值为ARKUI_SHADOW_TYPE_COLOR；<br> .value[5].u32：阴影颜色，0xargb格式，形如 0xFFFF0000 表示红色；<br> .value[6].u32：阴影是否内部填充，0表示不填充，1表示填充；| 259| NODE_BACKGROUND_IMAGE_SIZE | 背景图片的宽高属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示图片的宽度值，取值范围[0,+∞)，单位为vp。<br> .value[1].f32 表示图片的高度值，取值范围[0,+∞)，单位为vp。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示图片的宽度值，单位为vp。<br> .value[1].f32 表示图片的高度值，单位为vp。 | 260| NODE_BACKGROUND_IMAGE_SIZE_WITH_STYLE | 背景图片的宽高样式属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示背景图片的宽高样式，取[ArkUI_ImageSize](capi-native-type-h.md#arkui_imagesize)枚举值。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示背景图片的宽高样式，取[ArkUI_ImageSize](capi-native-type-h.md#arkui_imagesize)枚举值。| 261| NODE_BACKGROUND_BLUR_STYLE | 背景和内容之间的模糊属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示模糊类型，取[ArkUI_BlurStyle](capi-native-type-h.md#arkui_blurstyle)枚举值。<br> .value[1]?.i32 表示深浅色模式，取[ArkUI_ColorMode](capi-native-type-h.md#arkui_colormode)枚举值。<br> .value[2]?.i32 表示取色模式，取[ArkUI_AdaptiveColor](capi-native-type-h.md#arkui_adaptivecolor)枚举值。<br> .value[3]?.f32 表示模糊效果程度，取[0.0,1.0]范围内的值。<br> .value[4]?.f32 表示灰阶模糊起始边界。<br> .value[5]?.f32 表示灰阶模糊终点边界。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示模糊类型，取[ArkUI_BlurStyle](capi-native-type-h.md#arkui_blurstyle)枚举值。<br> .value[1].i32 表示深浅色模式，取[ArkUI_ColorMode](capi-native-type-h.md#arkui_colormode)枚举值。<br> .value[2].i32 表示取色模式，取[ArkUI_AdaptiveColor](capi-native-type-h.md#arkui_adaptivecolor)枚举值。<br> .value[3].f32 表示模糊效果程度，取[0.0,1.0]范围内的值。<br> .value[4].f32 表示灰阶模糊起始边界。<br> .value[5].f32 表示灰阶模糊终点边界。| 262| NODE_TRANSFORM_CENTER | 图形变换和转场的中心点属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0]?.f32 表示中心点X轴坐标值，单位为vp。 <br> .value[1]?.f32 表示中心点Y轴坐标，单位为vp。 <br> .value[2]?.f32 表示中心点Z轴坐标，单位为vp。 <br> .value[3]?.f32 表示中心点X轴坐标的百分比位置，如0.2表示百分之20的位置，该属性覆盖value[0].f32，默认值:0.5f。<br> .value[4]?.f32 表示中心点Y轴坐标的百分比位置，如0.2表示百分之20的位置，该属性覆盖value[1].f32，默认值:0.5f。<br> .value[5]?.f32 表示中心点Z轴坐标的百分比位置，如0.2表示百分之20的位置，该属性覆盖value[2].f32，默认值:0.0f。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示中心点X轴坐标，单位为vp。 <br> .value[1].f32 表示中心点Y轴坐标，单位为vp。 <br> .value[2].f32 表示中心点Z轴坐标，单位为vp。 <br> 注：如果设置坐标百分比位置，属性获取方法返回计算后的vp为单位的值。| 263| NODE_OPACITY_TRANSITION | 转场时的透明度效果属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示起终点的透明度值。 <br> .value[1].i32 表示动画时长，单位ms。 <br> .value[2].i32 表示动画曲线类型，取[ArkUI_AnimationCurve](capi-native-type-h.md#arkui_animationcurve)枚举值。 <br> .value[3]?.i32 表示动画延迟时长，单位ms。 <br> .value[4]?.i32 表示动画播放次数。 <br> .value[5]?.i32 表示动画播放模式，取[ArkUI_AnimationPlayMode](capi-native-type-h.md#arkui_animationplaymode)枚举值。 <br> .value[6]?.f32 表示动画播放速度。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示起终点的透明度值。 <br> .value[1].i32 表示动画时长，单位ms。 <br> .value[2].i32 表示动画曲线类型，取[ArkUI_AnimationCurve](capi-native-type-h.md#arkui_animationcurve)枚举值。 <br> .value[3].i32 表示动画延迟时长，单位ms。 <br> .value[4].i32 表示动画播放次数。 <br> .value[5].i32 表示动画播放模式，取[ArkUI_AnimationPlayMode](capi-native-type-h.md#arkui_animationplaymode)枚举值。 <br> .value[6].f32 表示动画播放速度。 | 264| NODE_ROTATE_TRANSITION | 转场时的旋转效果属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示横向旋转分量。<br> .value[1].f32 表示纵向的旋转分量。<br> .value[2].f32 表示竖向的旋转分量。<br> .value[3].f32 表示角度。<br> .value[4].f32 表示视距，默认值：0.0f。<br> .value[5].i32 表示动画时长，单位ms。<br> .value[6].i32 表示动画曲线类型，取[ArkUI_AnimationCurve](capi-native-type-h.md#arkui_animationcurve)枚举值。<br> .value[7]?.i32 表示动画延迟时长，单位ms。<br> .value[8]?.i32 表示动画播放次数。<br> .value[9]?.i32 表示动画播放模式，取[ArkUI_AnimationPlayMode](capi-native-type-h.md#arkui_animationplaymode)枚举值。<br> .value[10]?.f32 表示动画播放速度。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示横向旋转分量。<br> .value[1].f32 表示纵向的旋转分量。<br> .value[2].f32 表示竖向的旋转分量。<br> .value[3].f32 表示角度。<br> .value[4].f32 表示视距。<br> .value[5].i32 表示动画时长，单位ms。<br> .value[6].i32 表示动画曲线类型，取[ArkUI_AnimationCurve](capi-native-type-h.md#arkui_animationcurve)枚举值。<br> .value[7].i32 表示动画延迟时长，单位ms。<br> .value[8].i32 表示动画播放次数。<br> .value[9].i32 表示动画播放模式，取[ArkUI_AnimationPlayMode](capi-native-type-h.md#arkui_animationplaymode)枚举值。<br> .value[10].f32 表示动画播放速度。 | 265| NODE_SCALE_TRANSITION | 转场时的缩放效果属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 横向放大倍数。<br> .value[1].f32 纵向放大倍数。<br> .value[2].f32 竖向放大倍数。<br> .value[3].i32 表示动画时长，单位ms。<br> .value[4].i32 表示动画曲线类型，取[ArkUI_AnimationCurve](capi-native-type-h.md#arkui_animationcurve)枚举值。<br> .value[5]?.i32 表示动画延迟时长，单位ms。<br> .value[6]?.i32 表示动画播放次数。<br> .value[7]?.i32 表示动画播放模式，取[ArkUI_AnimationPlayMode](capi-native-type-h.md#arkui_animationplaymode)枚举值。<br> .value[8]?.f32 表示动画播放速度。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 横向放大倍数。<br> .value[1].f32 纵向放大倍数。<br> .value[2].f32 竖向放大倍数。<br> .value[3].i32 表示动画时长，单位ms。<br> .value[4].i32 表示动画曲线类型，取[ArkUI_AnimationCurve](capi-native-type-h.md#arkui_animationcurve)枚举值。<br> .value[5].i32 表示动画延迟时长，单位ms。<br> .value[6].i32 表示动画播放次数。<br> .value[7].i32 表示动画播放模式，取[ArkUI_AnimationPlayMode](capi-native-type-h.md#arkui_animationplaymode)枚举值。<br> .value[8].f32 表示动画播放速度。| 266| NODE_TRANSLATE_TRANSITION | 转场时的平移效果属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> value[0].f32 表示横向平移距离值，单位为vp。 <br> value[1].f32 表示纵向平移距离值，单位为vp。 <br> value[2].f32 表示竖向平移距离值，单位为vp。 <br> value[3].i32 表示动画时长，单位ms。<br> value[4].i32 表示动画曲线类型，取[ArkUI_AnimationCurve](capi-native-type-h.md#arkui_animationcurve)枚举值。<br> value[5]?.i32 表示动画延迟时长，单位ms。<br> value[6]?.i32 表示动画播放次数。<br> value[7]?.i32 表示动画播放模式，取[ArkUI_AnimationPlayMode](capi-native-type-h.md#arkui_animationplaymode)枚举值。<br> value[8]?.f32 表示动画播放速度。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> value[0].f32 表示横向平移距离值，单位为vp。 <br> value[1].f32 表示纵向平移距离值，单位为vp。 <br> value[2].f32 表示竖向平移距离值，单位为vp。 <br> value[3].i32 表示动画时长，单位ms。<br> value[4].i32 表示动画曲线类型，取[ArkUI_AnimationCurve](capi-native-type-h.md#arkui_animationcurve)枚举值。<br> value[5].i32 表示动画延迟时长，单位ms。<br> value[6].i32 表示动画播放次数。<br> value[7].i32 表示动画播放模式，取[ArkUI_AnimationPlayMode](capi-native-type-h.md#arkui_animationplaymode)枚举值。<br> value[8].f32 表示动画播放速度。| 267| NODE_MOVE_TRANSITION | 转场时从屏幕边缘滑入和滑出的效果属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 参数类型[ArkUI_TransitionEdge](capi-native-type-h.md#arkui_transitionedge)。 <br> .value[1].i32 表示动画时长，单位ms。 <br> .value[2].i32 表示动画曲线类型，取[ArkUI_AnimationCurve](capi-native-type-h.md#arkui_animationcurve)枚举值。 <br> .value[3]?.i32 表示动画延迟时长，单位ms。 <br> .value[4]?.i32 表示动画播放次数。 <br> .value[5]?.i32 表示动画播放模式，取[ArkUI_AnimationPlayMode](capi-native-type-h.md#arkui_animationplaymode)枚举值。 <br> .value[6]?.f32 表示动画播放速度。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 参数类型[ArkUI_TransitionEdge](capi-native-type-h.md#arkui_transitionedge)。 <br> .value[1].i32 表示动画时长，单位ms。 <br> .value[2].i32 表示动画曲线类型，取[ArkUI_AnimationCurve](capi-native-type-h.md#arkui_animationcurve)枚举值。 <br> .value[3].i32 表示动画延迟时长，单位ms。 <br> .value[4].i32 表示动画播放次数。 <br> .value[5].i32 表示动画播放模式，取[ArkUI_AnimationPlayMode](capi-native-type-h.md#arkui_animationplaymode)枚举值。 <br> .value[6].f32 表示动画播放速度。 | 268| NODE_FOCUSABLE | 获焦属性，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：参数类型为1表示可获焦，为0表示不可获焦。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：参数类型为1表示可获焦，为0表示不可获焦。 | 269| NODE_DEFAULT_FOCUS | 默认焦点属性，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> value[0].i32：参数类型为1表示是默认焦点，为0表示不是默认焦点。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> value[0].i32：参数类型为1表示是默认焦点，为0表示不是默认焦点。 | 270| NODE_RESPONSE_REGION | 触摸热区属性，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .data[0].f32：触摸点相对于组件左上角的x轴坐标,单位为vp。 <br> .data[1].f32：触摸点相对于组件左上角的y轴坐标,单位为vp。 <br> .data[2].f32：触摸热区的宽度 ，单位为百分比。 <br> .data[3].f32：触摸热区的高度，单位为百分比。 <br> .data[4...].f32:可以设置多个手势响应区域，顺序和上述一致。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .data[0].f32：触摸点相对于组件左上角的x轴坐标,单位为vp。 <br> .data[1].f32：触摸点相对于组件左上角的y轴坐标,单位为vp。 <br> .data[2].f32：触摸热区的宽度，单位为百分比。 <br> .data[3].f32：触摸热区的高度，单位为百分比。 <br> .data[4...].f32:可以设置多个手势响应区域，顺序和上述一致。 | 271| NODE_OVERLAY | 遮罩文本属性，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .string 遮罩文本；<br> .value[0]?.i32：可选值，浮层相对于组件的位置，参数类型[ArkUI_Alignment](capi-native-type-h.md#arkui_alignment)，默认值为ARKUI_ALIGNMENT_TOP_START。 <br> .value[1]?.f32：可选值，浮层基于自身左上角的偏移量X，单位为vp。 <br> .value[2]?.f32：可选值，浮层基于自身左上角的偏移量Y，单位为vp。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string 遮罩文本； <br> .value[0].i32：浮层相对于组件的位置，参数类型[ArkUI_Alignment](capi-native-type-h.md#arkui_alignment)，默认值为ARKUI_ALIGNMENT_TOP_START。 <br> .value[1].f32：浮层基于自身左上角的偏移量X，单位为vp。 <br> .value[2].f32：浮层基于自身左上角的偏移量Y，单位为vp。 | 272| NODE_SWEEP_GRADIENT | 角度渐变效果，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0]?.f32:为角度渐变的中心点，即相对于当前组件左上角的坐标,X轴坐标。 <br> .value[1]?.f32:为角度渐变的中心点，即相对于当前组件左上角的坐标,Y轴坐标。 <br> .value[2]?.f32:角度渐变的起点，默认值0。 <br> .value[3]?.f32:角度渐变的终点，默认值0。 <br> .value[4]?.f32:角度渐变的旋转角度，默认值0。 <br> .value[5]?.i32:为渐变的颜色重复着色，0表示不重复着色，1表示重复着色。 <br> .object: 参数类型为[ArkUI_ColorStop](capi-arkui-nativemodule-arkui-colorstop.md)。指定某百分比位置处的渐变色颜色，设置非法颜色直接跳过： <br> colors：渐变色颜色颜色。 <br> stops：渐变位置。 <br> size：颜色个数。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32:为角度渐变的中心点，即相对于当前组件左上角的坐标,X轴坐标。 <br> .value[1].f32:为角度渐变的中心点，即相对于当前组件左上角的坐标,Y轴坐标。 <br> .value[2].f32:角度渐变的起点，默认值0。 <br> .value[3].f32:角度渐变的终点，默认值0。 <br> .value[4].f32:角度渐变的旋转角度，默认值0。 <br> .value[5].i32:为渐变的颜色重复着色，0表示不重复着色，1表示重复着色。 <br> .object: 参数类型为[ArkUI_ColorStop](capi-arkui-nativemodule-arkui-colorstop.md)。指定某百分比位置处的渐变色颜色，设置非法颜色直接跳过： <br> colors：渐变色颜色颜色。 <br> stops：渐变位置。 <br> size：颜色个数。| 273| NODE_RADIAL_GRADIENT | 径向渐变渐变效果，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0]?.f32:为径向渐变的中心点，即相对于当前组件左上角的坐标,X轴坐标。 <br> .value[1]?.f32:为径向渐变的中心点，即相对于当前组件左上角的坐标,Y轴坐标。 <br> .value[2]?.f32:径向渐变的半径，默认值0。 <br> .value[3]?.i32:为渐变的颜色重复着色，0表示不重复着色，1表示重复着色。 <br> .object: 参数类型为[ArkUI_ColorStop](capi-arkui-nativemodule-arkui-colorstop.md)。指定某百分比位置处的渐变色颜色，设置非法颜色直接跳过： <br> colors：渐变色颜色颜色。 <br> stops：渐变位置。 <br> size：颜色个数。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32:为径向渐变的中心点，即相对于当前组件左上角的坐标,X轴坐标。 <br> .value[1].f32:为径向渐变的中心点，即相对于当前组件左上角的坐标,Y轴坐标。 <br> .value[2].f32:径向渐变的半径，默认值0。 <br> .value[3].i32:为渐变的颜色重复着色，0表示不重复着色，1表示重复着色。 <br> .object: 参数类型为[ArkUI_ColorStop](capi-arkui-nativemodule-arkui-colorstop.md)。指定某百分比位置处的渐变色颜色，设置非法颜色直接跳过： <br> colors：渐变色颜色颜色。 <br> stops：渐变位置。 <br> size：颜色个数。| 274| NODE_MASK | 组件上加上指定形状的遮罩，支持属性设置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式,共有5种类型： <br> 1.rect类型： <br> .value[0].u32：填充颜色，0xargb类型； <br> .value[1].u32：描边颜色，0xargb类型； <br> .value[2].f32：描边宽度，单位为vp； <br> .value[3].i32：遮罩类型，参数类型[ArkUI_MaskType](capi-native-type-h.md#arkui_masktype)，遮罩类型枚举值为ARKUI_MASK_TYPE_RECTANGLE； <br> .value[4].f32：矩形宽度，单位为vp； <br> .value[5].f32：矩形高度，单位为vp； <br> .value[6].f32：矩形圆角宽度，单位为vp； <br> .value[7].f32：矩形圆角高度，单位为vp； <br> .value[8]?.f32：矩形形状的左上圆角半径，单位为vp； <br> .value[9]?.f32：矩形形状的左下圆角半径，单位为vp； <br> .value[10]?.f32：矩形形状的右上圆角半径，单位为vp； <br> .value[11]?.f32：矩形形状的右下圆角半径，单位为vp； <br> 2.circle类型： <br> .value[0].u32：填充颜色，0xargb类型； <br> .value[1].u32：描边颜色，0xargb类型； <br> .value[2].f32：描边宽度，单位为vp； <br> .value[3].i32：遮罩类型，参数类型[ArkUI_MaskType](capi-native-type-h.md#arkui_masktype)，遮罩类型枚举值为ARKUI_MASK_TYPE_CIRCLE； <br> .value[4].f32：圆形宽度，单位为vp； <br> .value[5].f32：圆形高度，单位为vp； <br> 3.ellipse类型： <br> .value[0].u32：填充颜色，0xargb类型； <br> .value[1].u32：描边颜色，0xargb类型； <br> .value[2].f32：描边宽度，单位为vp； <br> .value[3].i32：遮罩类型，参数类型[ArkUI_MaskType](capi-native-type-h.md#arkui_masktype)，遮罩类型枚举值为ARKUI_MASK_TYPE_ELLIPSE； <br> .value[4].f32：椭圆形宽度，单位为vp； <br> .value[5].f32：椭圆形高度，单位为vp； <br> 4.path类型： <br> .value[0].u32：填充颜色，0xargb类型； <br> .value[1].u32：描边颜色，0xargb类型； <br> .value[2].f32：描边宽度，单位为vp； <br> .value[3].i32：遮罩类型，参数类型[ArkUI_MaskType](capi-native-type-h.md#arkui_masktype)，遮罩类型枚举值为ARKUI_MASK_TYPE_PATH； <br> .value[4].f32：路径宽度，单位为vp； <br> .value[5].f32：路径高度，单位为vp； <br> .string：路径绘制的命令字符串； <br> 5.progress类型： <br> .value[0].i32：遮罩类型，参数类型[ArkUI_MaskType](capi-native-type-h.md#arkui_masktype)，遮罩类型枚举值为ARKUI_MASK_TYPE_PROGRESS； <br> .value[1].f32：进度遮罩的当前值； <br> .value[2].f32：进度遮罩的最大值； <br> .value[3].u32：进度遮罩的颜色； <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式,共有5种类型： <br> 1.rect类型： <br> .value[0].u32：填充颜色，0xargb类型； <br> .value[1].u32：描边颜色，0xargb类型； <br> .value[2].f32：描边宽度，单位为vp； <br> .value[3].i32：遮罩类型； <br> .value[4].f32：矩形宽度，单位为vp； <br> .value[5].f32：矩形高度，单位为vp； <br> .value[6].f32：矩形圆角宽度，单位为vp； <br> .value[7].f32：矩形圆角高度，单位为vp； <br> .value[8]?.f32：矩形形状的左上圆角半径，单位为vp； <br> .value[9]?.f32：矩形形状的左下圆角半径，单位为vp； <br> .value[10]?.f32：矩形形状的右上圆角半径，单位为vp； <br> .value[11]?.f32：矩形形状的右下圆角半径，单位为vp； <br> 2.circle类型： <br> .value[0].u32：填充颜色，0xargb类型； <br> .value[1].u32：描边颜色，0xargb类型； <br> .value[2].f32：描边宽度，单位为vp； <br> .value[3].i32：遮罩类型； <br> .value[4].f32：圆形宽度，单位为vp； <br> .value[5].f32：圆形高度，单位为vp； <br> 3.ellipse类型： <br> .value[0].u32：填充颜色，0xargb类型； <br> .value[1].u32：描边颜色，0xargb类型； <br> .value[2].f32：描边宽度，单位为vp； <br> .value[3].i32：遮罩类型； <br> .value[4].f32：椭圆形宽度，单位为vp； <br> .value[5].f32：椭圆形高度，单位为vp； <br> 4.path类型： <br> .value[0].u32：填充颜色，0xargb类型； <br> .value[1].u32：描边颜色，0xargb类型； <br> .value[2].f32：描边宽度，单位为vp； <br> .value[3].i32：遮罩类型； <br> .value[4].f32：路径宽度，单位为vp； <br> .value[5].f32：路径高度，单位为vp； <br> .string：路径绘制的命令字符串； <br> 5.progress类型： <br> .value[0].i32：遮罩类型； <br> .value[1].f32：进度遮罩的当前值； <br> .value[2].f32：进度遮罩的最大值； <br> .value[3].u32：进度遮罩的颜色； <br> | 275| NODE_BLEND_MODE | 当前控件背景与子节点内容进行混合，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：控制当前组件的混合模式类型，参数类型[ArkUI_BlendMode](capi-native-type-h.md#arkui_blendmode)，默认值为ARKUI_BLEND_MODE_NONE。 <br> .value[1].?i32：blendMode实现方式是否离屏，参数类型[ArkUI_BlendApplyType](capi-native-type-h.md#arkui_blendapplytype)，默认值为BLEND_APPLY_TYPE_FAST。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：控制当前组件的混合模式类型，参数类型[ArkUI_BlendMode](capi-native-type-h.md#arkui_blendmode)，默认值为ARKUI_BLEND_MODE_NONE。 <br> .value[1].i32：blendMode实现方式是否离屏，参数类型[ArkUI_BlendApplyType](capi-native-type-h.md#arkui_blendapplytype)，默认值为BLEND_APPLY_TYPE_FAST。| 276| NODE_DIRECTION | 设置容器元素内主轴方向上的布局，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：设置容器元素内主轴方向上的布局类型， <br> 参数类型[ArkUI_Direction](capi-native-type-h.md#arkui_direction)，默认值为ARKUI_DIRECTION_AUTO。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：设置容器元素内主轴方向上的布局类型， <br> 参数类型[ArkUI_Direction](capi-native-type-h.md#arkui_direction)，默认值为ARKUI_DIRECTION_AUTO。| 277| NODE_CONSTRAINT_SIZE | 约束尺寸属性，组件布局时，进行尺寸范围限制，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：最小宽度，单位vp； <br> .value[1].f32：最大宽度，单位vp； <br> .value[2].f32：最小高度，单位vp； <br> .value[3].f32：最大高度，单位vp； <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：最小宽度，单位vp； <br> .value[1].f32：最大宽度，单位vp； <br> .value[2].f32：最小高度，单位vp； <br> .value[3].f32：最大高度，单位vp；| 278| NODE_GRAY_SCALE | 灰度效果属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：灰度转换比例，范围0-1之间，比如0.5指按照50%进行灰度处理； <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：灰度转换比例，范围0-1之间；| 279| NODE_INVERT | 反转输入的图像比例属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：图像反转比例，范围0-1之间，比如0.5指按照50%进行反转处理； <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：图像反转比例，范围0-1之间；| 280| NODE_SEPIA | 图像转换为深褐色比例属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：图像转换为深褐色比例，范围0-1之间，比如0.5指按照50%进行深褐色处理； <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：图像转换为深褐色比例，范围0-1之间； | 281| NODE_CONTRAST | 对比度属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：对比度，等于1时为原图，越大则对比度越高，取值范围：[0, 10)； <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：对比度，取值范围：[0, 10)； | 282| NODE_FOREGROUND_COLOR | 前景颜色属性，支持属性设置和属性获取接口。属性重置接口无效果。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式，支持两种入参格式：<br> 1：.value[0].u32：颜色数值，0xargb类型，如0xFFFF0000表示红色；<br> 2：.value[0].i32：颜色数值枚举ArkUI_ColoringStrategy；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：颜色数值，0xargb类型；| 283| NODE_OFFSET | 组件子元素相对组件自身的额外偏移属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示x轴方向的偏移值, 单位为vp。 <br> .value[1].f32 表示y轴方向的偏移值, 单位为vp。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示x轴方向的偏移值, 单位为vp。 <br> .value[1].f32 表示y轴方向的偏移值, 单位为vp。| 284| NODE_MARK_ANCHOR | 组件子元素在位置定位时的锚点属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示锚点x坐标值, 单位为vp。 <br> .value[1].f32 表示锚点y坐标值, 单位为vp。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示锚点x坐标值, 单位为vp。 <br> .value[1].f32 表示锚点y坐标值, 单位为vp。 | 285| NODE_BACKGROUND_IMAGE_POSITION | 背景图在组件中显示位置，即相对于组件左上角的坐标，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示x轴方向的位置, 单位为px。 <br> .value[1].f32 表示y轴方向的位置, 单位为px。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示x轴方向的位置, 单位为px。 <br> .value[1].f32 表示y轴方向的位置, 单位为px。| 286| NODE_ALIGN_RULES | 相对容器中子组件的对齐规则属性，支持属性设置，属性重置，获取属性接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br>.object：使用[ArkUI_AlignmentRuleOption](capi-arkui-nativemodule-arkui-alignmentruleoption.md)对象作为组件的对齐规则。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：使用[ArkUI_AlignmentRuleOption](capi-arkui-nativemodule-arkui-alignmentruleoption.md)对象作为组件的对齐规则。 | 287| NODE_ALIGN_SELF | 设置子组件在父容器交叉轴的对齐格式，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：设置子组件在父容器交叉轴的对齐格式类型， <br> 参数类型[ArkUI_ItemAlignment](capi-native-type-h.md#arkui_itemalignment)，默认值为ARKUI_ITEM_ALIGNMENT_AUTO。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：设置子组件在父容器交叉轴的对齐格式类型， <br> 参数类型[ArkUI_ItemAlignment](capi-native-type-h.md#arkui_itemalignment)，默认值为ARKUI_ITEM_ALIGNMENT_AUTO。 | 288| NODE_FLEX_GROW | 设置组件在父容器的剩余空间所占比例，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：父容器的剩余空间所占比例。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：父容器的剩余空间所占比例。 | 289| NODE_FLEX_SHRINK | 设置父容器压缩尺寸分配给此属性所在组件的比例，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：父容器压缩尺寸分配给此属性所在组件的比例数值。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：父容器压缩尺寸分配给此属性所在组件的比例数值。 | 290| NODE_FLEX_BASIS | 设置组件的基准尺寸，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：组件在父容器主轴方向上的基准尺寸。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：组件在父容器主轴方向上的基准尺寸。 | 291| NODE_ACCESSIBILITY_GROUP | 无障碍组属性, 支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：为1时表示该组件及其所有子组件为一整个可以选中的组件。无障碍服务将不再关注其子组件内容。参数类型为1或者0。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：为1时表示该组件及其所有子组件为一整个可以选中的组件。无障碍服务将不再关注其子组件内容。参数类型为1或者0。| 292| NODE_ACCESSIBILITY_TEXT | 无障碍文本属性，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .string：无障碍文本。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string：无障碍文本。| 293| NODE_ACCESSIBILITY_MODE | 无障碍辅助服务模式，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：辅助服务模式，参数类型[ArkUI_AccessibilityMode](capi-native-type-h.md#arkui_accessibilitymode)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：辅助服务模式，参数类型[ArkUI_AccessibilityMode](capi-native-type-h.md#arkui_accessibilitymode)。| 294| NODE_ACCESSIBILITY_DESCRIPTION | 无障碍说明属性，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .string：无障碍说明。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string：无障碍说明。| 295| NODE_FOCUS_STATUS | 组件获取焦点属性，支持属性设置，属性获取。<br/>**说明：** 设置参数为0时，当前层级页面获焦组件失焦，焦点转移到根容器上。<br>属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：参数类型为1表示组件获焦，为0表示组件失焦。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：参数类型为1表示组件获焦，为0表示组件失焦。 | 296| NODE_ASPECT_RATIO | 设置组件的宽高比，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：组件的宽高比，输入值为 width/height。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：组件的宽高比，width/height的比值。 | 297| NODE_LAYOUT_WEIGHT | Row/Column/Flex 布局下的子组件布局权重参数，支持属性设置、属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：子组件占主轴尺寸的权重。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：子组件占主轴尺寸的权重。 | 298| NODE_DISPLAY_PRIORITY | Row/Column/Flex(单行) 布局下的子组件在布局容器中显示的优先级。当子组件的displayPriority大于1时，displayPriority数值越大，优先级越高。支持属性设置、属性重置和属性获取接口。属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：子组件在父容器中的显示优先级。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：子组件在父容器中的显示优先级。 | 299| NODE_OUTLINE_WIDTH | 设置元素的外描边宽度。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：元素左边的外描边宽度。 <br> .value[1].f32：元素上边的外描边宽度。 <br> .value[2].f32：元素右边的外描边宽度。 <br> .value[3].f32：元素下边的外描边宽度。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：元素左边的外描边宽度。 <br> .value[1].f32：元素上边的外描边宽度。 <br> .value[2].f32：元素右边的外描边宽度。 <br> .value[3].f32：元素下边的外描边宽度。 | 300| NODE_WIDTH_PERCENT | 宽度属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：宽度数值，单位为百分比；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：宽度数值，单位为百分比；| 301| NODE_HEIGHT_PERCENT | 高度属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：高度数值，单位为百分比；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：高度数值，单位为百分比； | 302| NODE_PADDING_PERCENT | 内间距属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式有两种：<br> 1：上下左右四个位置的内间距值相等。<br> .value[0].f32：内间距数值，单位为百分比；<br> 2：分别指定上下左右四个位置的内间距值。<br> .value[0].f32：上内间距数值，单位为百分比；<br> .value[1].f32：右内间距数值，单位为百分比；<br> .value[2].f32：下内间距数值，单位为百分比；<br> .value[3].f32：左内间距数值，单位为百分比；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：上内间距数值，单位为百分比；<br> .value[1].f32：右内间距数值，单位为百分比；<br> .value[2].f32：下内间距数值，单位为百分比；<br> .value[3].f32：左内间距数值，单位为百分比； | 303| NODE_MARGIN_PERCENT | 外间距属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式有两种：<br> 1：上下左右四个位置的外间距值相等。<br> .value[0].f32：外间距数值，单位为百分比；<br> 2：分别指定上下左右四个位置的外间距值。<br> .value[0].f32：上外间距数值，单位为百分比；<br> .value[1].f32：右外间距数值，单位为百分比；<br> .value[2].f32：下外间距数值，单位为百分比；<br> .value[3].f32：左外间距数值，单位为百分比；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：上外间距数值，单位为百分比；<br> .value[1].f32：右外间距数值，单位为百分比；<br> .value[2].f32：下外间距数值，单位为百分比；<br> .value[3].f32：左外间距数值，单位为百分比； | 304| NODE_GEOMETRY_TRANSITION | 组件内隐式共享元素转场，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0]?.i32：参数类型为1或者0。共享元素绑定的2个组件，针对出场元素未进行删除时是否要继续参与共享元素动画，默认为false，不参与保持原始位置不动。 <br> .string 用于设置绑定关系，id置""清除绑定关系避免参与共享行为，id可更换重新建立绑定关系。同一个id只能有两个组件绑定且是in/out不同类型角色，不能多个组件绑定同一个id。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：参数类型为1或者0。共享元素绑定的2个组件，针对出场元素未进行删除时是否要继续参与共享元素动画，默认未false，不参与保持原始位置不动。 <br> .string 用于设置绑定关系，id置""清除绑定关系避免参与共享行为，id可更换重新建立绑定关系。同一个id只能有两个组件绑定且是in/out不同类型角色，不能多个组件绑定同一个id。| 305| NODE_RELATIVE_LAYOUT_CHAIN_MODE | 指定以该组件为链头所构成的链的参数，支持属性设置、属性重置和属性获取接口。仅当父容器为RelativeContainer时生效。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：链的方向。枚举[ArkUI_Axis](capi-native-type-h.md#arkui_axis)。 <br> .value[1].i32：链的样式。枚举[ArkUI_RelativeLayoutChainStyle](capi-native-type-h.md#arkui_relativelayoutchainstyle)。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br>.value[0].i32：链的方向。枚举[ArkUI_Axis](capi-native-type-h.md#arkui_axis)。 <br> .value[1].i32：链的样式。枚举[ArkUI_RelativeLayoutChainStyle](capi-native-type-h.md#arkui_relativelayoutchainstyle)。| 306| NODE_RENDER_FIT | 设置宽高动画过程中的组件内容填充方式，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 内容填充方式，使用[ArkUI_RenderFit](capi-native-type-h.md)枚举值。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 内容填充方式，使用[ArkUI_RenderFit](capi-native-type-h.md)枚举值。 | 307| NODE_OUTLINE_COLOR | 外描边颜色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> 1: .value[0].u32：统一设置四条边的边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> 2: .value[0].u32：设置上侧边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> .value[1].u32：设置右侧边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> .value[2].u32：设置下侧边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> .value[3].u32：设置左侧边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：设置上侧边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> .value[1].u32：设置右侧边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> .value[2].u32：设置下侧边框颜色，使用0xargb表示，如0xFFFF11FF。 <br> .value[3].u32：设置左侧边框颜色，使用0xargb表示，如0xFFFF11FF。 | 308| NODE_SIZE | 设置高宽尺寸，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：宽度数值，单位为vp；<br> .value[1].f32：高度数值，单位为vp；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：宽度数值，单位为vp；<br> .value[1].f32：高度数值，单位为vp；| 309| NODE_RENDER_GROUP | 设置当前组件和子组件是否先整体离屏渲染绘制后再与父控件融合绘制，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：参数类型为1表示当前组件与子组件需要先整体离屏渲染绘制后再与父控件融合绘制，参数类型为0表示不需要整体离屏渲染绘制后再与父控件融合绘制。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：参数类型为1表示当前组件与子组件完成整体离屏渲染绘制，参数类型为0表示当前组件与子组件未完成整体离屏渲染绘制。 | 310| NODE_COLOR_BLEND | 为组件添加颜色叠加效果，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：叠加的颜色，使用0xargb表示，如0xFFFF11FF。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：叠加的颜色，使用0xargb表示，如0xFFFF11FF。 | 311| NODE_FOREGROUND_BLUR_STYLE | 为当前组件提供内容模糊能力，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示内容模糊样式，取[ArkUI_BlurStyle](capi-native-type-h.md#arkui_blurstyle)枚举值。<br> .value[1]?.i32 表示内容模糊效果使用的深浅色模式，取[ArkUI_ColorMode](capi-native-type-h.md#arkui_colormode)枚举值。<br> .value[2]?.i32 表示内容模糊效果使用的取色模式，取[ArkUI_AdaptiveColor](capi-native-type-h.md#arkui_adaptivecolor)枚举值。<br> .value[3]?.f32 表示模糊效果程度，取[0.0,1.0]范围内的值。<br> .value[4]?.i32 表示灰阶模糊参数，对黑色的提亮程度，取值范围为[0,127]。<br> .value[5]?.i32 表示灰阶模糊参数，对白色的压暗程度，取值范围为[0,127]。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示内容模糊样式，取[ArkUI_BlurStyle](capi-native-type-h.md#arkui_blurstyle)枚举值。<br> .value[1].i32 表示内容模糊效果使用的深浅色模式，取[ArkUI_ColorMode](capi-native-type-h.md#arkui_colormode)枚举值。<br> .value[2].i32 表示内容模糊效果使用的取色模式，取[ArkUI_AdaptiveColor](capi-native-type-h.md#arkui_adaptivecolor)枚举值。<br> .value[3].f32 表示模糊效果程度，取[0.0,1.0]范围内的值。<br> .value[4].i32 表示灰阶模糊参数，对黑色的提亮程度，取值范围为[0,127]。<br> .value[5].i32 表示灰阶模糊参数，对白色的压暗程度，取值范围为[0,127]。 | 312| NODE_LAYOUT_RECT | 组件布局大小位置属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：组件X轴坐标，单位为px；<br> .value[1].i32：组件Y轴坐标，单位为px；<br> .value[2].i32：组件宽度，单位为px；<br> .value[3].i32：组件高度，单位为px；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：组件X轴坐标，单位为px；<br> .value[1].i32：组件Y轴坐标，单位为px；<br> .value[2].i32：组件宽度，单位为px；<br> .value[3].i32：组件高度，单位为px；| 313| NODE_FOCUS_ON_TOUCH | 设置当前组件是否支持点击获焦能力，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：参数类型为1表示支持点击获焦，为0表示不支持点击获焦。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：参数类型为1表示支持点击获焦，为0表示不支持点击获焦。| 314| NODE_BORDER_WIDTH_PERCENT = 85 | 边框宽度属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> 1: .value[0].f32：统一设置四条边的边框宽度，单位为百分比。 <br> 2: .value[0].f32：设置上边框的边框宽度，单位为百分比。 <br> .value[1].f32：设置右边框的边框宽度，单位为百分比。 <br> .value[2].f32：设置下边框的边框宽度，单位为百分比。 <br> .value[3].f32：设置左边框的边框宽度，单位为百分比。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：设置上边框的边框宽度，单位为百分比。 <br> .value[1].f32：设置右边框的边框宽度，单位为百分比。 <br> .value[2].f32：设置下边框的边框宽度，单位为百分比。 <br> .value[3].f32：设置左边框的边框宽度，单位为百分比。 | 315| NODE_BORDER_RADIUS_PERCENT = 86 | 边框圆角属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> 1: .value[0].f32：统一设置四条边的边框圆角半径，单位为百分比。 <br> 2: .value[0].f32：设置左上角圆角半径，单位为百分比。 <br> .value[1].f32：设置右上角圆角半径，单位为百分比。 <br> .value[2].f32：设置左下角圆角半径，单位为百分比。 <br> .value[3].f32：设置右下角圆角半径，单位为百分比。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：设置左上角圆角半径，单位为百分比。 <br> .value[1].f32：设置右上角圆角半径，单位为百分比。 <br> .value[2].f32：设置左下角圆角半径，单位为百分比。 <br> .value[3].f32：设置右下角圆角半径，单位为百分比。 | 316| NODE_ACCESSIBILITY_ID = 87 | 无障碍自定义标识ID，支持属性获取。属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：无障碍自定义标识ID。 | 317| NODE_ACCESSIBILITY_ACTIONS = 88 | 定义无障碍支持操作类型属性，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].u32：配置无障碍操作类型，参数类型[ArkUI_AccessibilityActionType](capi-native-type-h.md#arkui_accessibilityactiontype)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：配置无障碍操作类型，参数类型[ArkUI_AccessibilityActionType](capi-native-type-h.md#arkui_accessibilityactiontype)。 | 318| NODE_ACCESSIBILITY_ROLE = 89 | 定义无障碍组件类型属性，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].u32：无障碍组件类型，参数类型[ArkUI_NodeType](capi-native-node-h.md#arkui_nodetype)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：无障碍组件类型，参数类型[ArkUI_NodeType](capi-native-node-h.md#arkui_nodetype)。 | 319| NODE_ACCESSIBILITY_STATE = 90 | 定义无障碍状态属性，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .object：参数类型为[ArkUI_AccessibilityState](capi-arkui-nativemodule-arkui-accessibilitystate.md)。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .object：参数类型为[ArkUI_AccessibilityState](capi-arkui-nativemodule-arkui-accessibilitystate.md)。 | 320| NODE_ACCESSIBILITY_VALUE = 91 | 定义无障碍信息属性，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .object：参数类型为[ArkUI_AccessibilityValue](capi-arkui-nativemodule-arkui-accessibilityvalue.md)。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .object：参数类型为[ArkUI_AccessibilityValue](capi-arkui-nativemodule-arkui-accessibilityvalue.md)。 | 321| NODE_EXPAND_SAFE_AREA = 92 | 定义控制组件扩展其安全区域，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0]?.u32：扩展安全区域的枚举值集合[ArkUI_SafeAreaType](capi-native-type-h.md#arkui_safeareatype)，例如：ARKUI_SAFE_AREA_TYPE_SYSTEM \| ARKUI_SAFE_AREA_TYPE_CUTOUT；<br> .value[1]?.u32：扩展安全区域的方向枚举值集合[ArkUI_SafeAreaEdge](capi-native-type-h.md#arkui_safeareaedge)；例如：ARKUI_SAFE_AREA_EDGE_TOP \| ARKUI_SAFE_AREA_EDGE_BOTTOM；<br>属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br>.value[0].u32：扩展安全区域；<br>.value[1].u32：扩展安全区域的方向。| 322| NODE_VISIBLE_AREA_CHANGE_RATIO = 93 | 定义控制组件触发可视区域面积变更事件的可视区域面积占组件本身面积的比例阈值。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[...].f32：占比数值，输入范围0-1。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[...].f32：占比数值； | 323| NODE_TRANSITION = 94 | 定义组件插入和删除时显示过渡动效，支持属性设置，属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .object：参数类型为[ArkUI_TransitionEffect](capi-arkui-nativemodule-arkui-transitioneffect.md)。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .object：参数类型为[ArkUI_TransitionEffect](capi-arkui-nativemodule-arkui-transitioneffect.md)。 | 324| NODE_UNIQUE_ID = 95 | 组件标识ID，支持属性获取。<br />组件标识ID只读，且进程内唯一。| 325| NODE_FOCUS_BOX = 96 | 设置当前组件系统焦点框样式。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32: 焦点框相对组件边缘的距离。 <br> 正数代表外侧，负数代表内侧。 <br> 不支持百分比。 <br> .value[1].f32: 焦点框宽度。 不支持负数和百分比。 <br> .value[2].u32: 焦点框颜色。 | 326| NODE_CLICK_DISTANCE = 97 | 组件所绑定的点击手势移动距离限制，支持属性设置。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示识别点击手势时允许手指在该范围内移动，单位为vp。 | 327| NODE_TAB_STOP = 98 | 控制焦点是否能停在当前组件，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：参数类型为1表示焦点能停在当前组件，为0表示焦点不能停在当前组件。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：参数类型为1表示焦点停在当前组件，为0表示焦点未停在当前组件。<br>**起始版本：** 14 | 328| NODE_BACKDROP_BLUR = 99 | 设置背景模糊效果，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].f32：表示背景模糊半径，取值范围[0,+∞)。单位px，默认值0.0。<br> .value[1]?.f32：表示灰阶模糊参数，对黑色的提亮程度，取值范围为[0,127]。<br> .value[2]?.f32：表示灰阶模糊参数，对白色的压暗程度，取值范围为[0,127]。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：表示背景模糊半径，取值范围[0,+∞)。单位px。<br> .value[1].f32：表示灰阶模糊参数，对黑色的提亮程度，取值范围为[0,127]。<br> .value[2].f32：表示灰阶模糊参数，对白色的压暗程度，取值范围为[0,127]。<br>**起始版本：** 15 | 329| NODE_BACKGROUND_IMAGE_RESIZABLE_WITH_SLICE = 100 | 设置背景图在拉伸时可调整大小的属性，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].f32: 图片左部拉伸时，图片的像素值保持不变，单位为vp。 <br> .value[1].f32: 图片顶部拉伸时，图片的像素值保持不变，单位为vp。 <br> .value[2].f32: 图片右部拉伸时，图片的像素值保持不变，单位为vp。 <br> .value[3].f32: 图片底部拉伸时，图片的像素值保持不变，单位为vp。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32: 图片左部拉伸时，图片的像素值保持不变，单位为vp。 <br> .value[1].f32: 图片顶部拉伸时，图片的像素值保持不变，单位为vp。 <br> .value[2].f32: 图片右部拉伸时，图片的像素值保持不变，单位为vp。 <br> .value[3].f32: 图片底部拉伸时，图片的像素值保持不变，单位为vp。 <br>**起始版本：** 19 | 330| NODE_NEXT_FOCUS = 101 | 设置下一个走焦节点。[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)的参数格式： <br> .value[0].i32：走焦类型，定义在 [ArkUI_FocusMove](capi-native-type-h.md#arkui_focusmove)。.object: 下一个焦点。参数类型为[ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md)。<br>**起始版本：** 18 | 331| NODE_VISIBLE_AREA_APPROXIMATE_CHANGE_RATIO = 102 | 设置可见区域变化监听的参数。 <br>**说明：** 非实时回调，实际回调与预期间隔可能存在差别。两次可见区域回调的时间间隔不小于预期更新间隔。当开发者设置的预期间隔过小时，由系统负载决定实际回调间隔时间。当前接口的可见区域回调阈值默认包含0。例如，开发者设置回调阈值为[0.5]，实际生效的阈值为[0.0, 0.5]。<br>属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .object：参数类型为[ArkUI_VisibleAreaEventOptions](capi-arkui-nativemodule-arkui-visibleareaeventoptions.md)。<br>属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：参数类型为[ArkUI_VisibleAreaEventOptions](capi-arkui-nativemodule-arkui-visibleareaeventoptions.md)。<br>**起始版本：** 17 | 332| NODE_TRANSLATE_WITH_PERCENT = 103 | 设置组件平移，支持百分比形式的平移入参，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： x轴移动距离，默认单位为百分比，除非value[3]存在且value[3]为0时单位为vp，默认值0；<br> .value[1].f32： y轴移动距离，默认单位为百分比，除非value[4]存在且value[4]为0时单位为vp，默认值0；<br> .value[2].f32： z轴移动距离，单位vp，默认值0。<br> .value[3]?.i32： x轴移动距离是否为百分比形式指定，取值范围：0或1。为1时表示以百分比形式指定，例如value[0].f32=0.1且value[3].i32=1时表示x方向平移10%。默认值1。<br> .value[4]?.i32： y轴移动距离是否为百分比形式指定，取值范围：0或1。为1时表示以百分比形式指定，例如value[1].f32=0.1且value[4].i32=1时表示y方向平移10%，默认值1。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32： x轴移动距离，单位取决于value[3]；<br> .value[1].f32： y轴移动距离，单位取决于value[4]；<br> .value[2].f32： z轴移动距离，单位vp；<br> .value[3].i32： x轴移动距离的单位是否为百分比，当value[3].i32为0时x轴移动距离单位为vp，当value[3].i32为1时x轴移动距离单位为百分比；<br> .value[4].i32： y轴移动距离的单位是否为百分比，当value[4].i32为0时y轴移动距离单位为vp，当value[4].i32为1时y轴移动距离单位为百分比；<br>**起始版本：** 20 | 333| NODE_ROTATE_ANGLE = 104 | 设置组件旋转，支持各轴旋转角属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： x轴方向旋转角度，默认值0；<br> .value[1].f32： y轴方向旋转角度，默认值0；<br> .value[2].f32： z轴方向旋转角度，默认值0；<br> .value[3].f32： 视距，即视点到z=0平面的距离，单位px，默认值0。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： x轴方向旋转角度，默认值0；<br> .value[1].f32： y轴方向旋转角度，默认值0；<br> .value[2].f32： z轴方向旋转角度，默认值0；<br> .value[3].f32： 视距，即视点到z=0平面的距离，单位px，默认值0。<br>**起始版本：** 20 | 334| NODE_TEXT_CONTENT = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT | Text组件设置文本内容属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string 表示文本内容。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string 表示文本内容。| 335| NODE_FONT_COLOR | 组件字体颜色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：字体颜色数值，0xargb格式，形如 0xFFFF0000 表示红色；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：字体颜色数值，0xargb格式；| 336| NODE_FONT_SIZE | 组件字体大小属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：字体大小数值，单位为fp；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：字体大小数值，单位为fp；| 337| NODE_FONT_STYLE | 组件字体样式属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：字体样式[ArkUI_FontStyle](capi-native-type-h.md#arkui_fontstyle)，默认值为ARKUI_FONT_STYLE_NORMAL；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：字体样式[ArkUI_FontStyle](capi-native-type-h.md#arkui_fontstyle)； | 338| NODE_FONT_WEIGHT | 组件字体粗细属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：字体粗细样式[ArkUI_FontWeight](capi-native-type-h.md#arkui_fontweight)，默认值为ARKUI_FONT_WEIGHT_NORMAL；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：字体粗细样式[ArkUI_FontWeight](capi-native-type-h.md#arkui_fontweight)；| 339| NODE_TEXT_LINE_HEIGHT | 文本行高属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示lineHeight值，单位为fp。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示lineHeight值，单位为fp。 | 340| NODE_TEXT_DECORATION | 置文本装饰线样式及其颜色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：文本装饰线类型[ArkUI_TextDecorationType](capi-native-type-h.md#arkui_textdecorationtype)，默认值为ARKUI_TEXT_DECORATION_TYPE_NONE；<br> .value[1]?.u32：可选值，装饰线颜色，0xargb格式，形如 0xFFFF0000 表示红色；<br> .value[2]?.i32：文本装饰线样式[ArkUI_TextDecorationStyle](capi-native-type-h.md#arkui_textdecorationstyle)；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：文本装饰线类型[ArkUI_TextDecorationType](capi-native-type-h.md#arkui_textdecorationtype)；<br> .value[1].u32：装饰线颜色，0xargb格式。<br> .value[2].i32：文本装饰线样式[ArkUI_TextDecorationStyle](capi-native-type-h.md#arkui_textdecorationstyle)；| 341| NODE_TEXT_CASE | 文本大小写属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：表示文本大小写类型[ArkUI_TextCase](capi-native-type-h.md#arkui_textcase)，默认值为ARKUI_TEXT_CASE_NORMAL。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：表示文本大小写类型[ArkUI_TextCase](capi-native-type-h.md#arkui_textcase)。 | 342| NODE_TEXT_LETTER_SPACING | 文本字符间距属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示字符间距值，单位为fp。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 表示字符间距值，单位为fp。 | 343| NODE_TEXT_MAX_LINES | 文本最大行数属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示最大行数。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示最大行数。 | 344| NODE_TEXT_ALIGN | 文本水平对齐方式, 支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：表示文本水平对齐方式，取[ArkUI_TextAlignment](capi-native-type-h.md#arkui_textalignment)枚举值。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：表示文本水平对齐方式，取[ArkUI_TextAlignment](capi-native-type-h.md#arkui_textalignment)枚举值。| 345| NODE_TEXT_OVERFLOW | 文本超长时的显示方式属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：表示文本超长时的显示方式。[ArkUI_TextOverflow](capi-native-type-h.md#arkui_textoverflow)<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：表示文本超长时的显示方式。[ArkUI_TextOverflow](capi-native-type-h.md#arkui_textoverflow)| 346| NODE_FONT_FAMILY | Text字体列表属性，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .string：字体字符串，多个用,分隔。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string：字体字符串，多个用,分隔。| 347| NODE_TEXT_COPY_OPTION | 文本复制粘贴属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：复制粘贴方式[ArkUI_CopyOptions](capi-native-type-h.md#arkui_copyoptions)，默认值为ARKUI_COPY_OPTIONS_NONE；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：复制粘贴方式[ArkUI_CopyOptions](capi-native-type-h.md#arkui_copyoptions)。 | 348| NODE_TEXT_BASELINE_OFFSET | 文本基线的偏移量属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：偏移量数值，单位为fp；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：偏移量数值，单位为fp。 | 349| NODE_TEXT_TEXT_SHADOW | 文字阴影效果属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：阴影模糊半径，单位为vp；<br> .value[1].i32：阴影类型[ArkUI_ShadowType](capi-native-type-h.md#arkui_shadowtype)，默认值为ARKUI_SHADOW_TYPE_COLOR；<br> .value[2].u32：阴影颜色，0xargb格式，形如 0xFFFF0000 表示红色；<br> .value[3].f32：阴影X轴偏移量，单位为vp；<br> .value[4].f32：阴影Y轴偏移量，单位为vp；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：阴影模糊半径，单位为vp；<br> .value[1].i32：阴影类型[ArkUI_ShadowType](capi-native-type-h.md#arkui_shadowtype)；<br> .value[2].u32：阴影颜色，0xargb格式；<br> .value[3].f32：阴影X轴偏移量，单位为vp；<br> .value[4].f32：阴影Y轴偏移量，单位为vp； | 350| NODE_TEXT_MIN_FONT_SIZE | Text最小显示字号，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].f32：文本最小显示字号，单位为fp。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：文本最小显示字号，单位为fp。 | 351| NODE_TEXT_MAX_FONT_SIZE | Text最大显示字号，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].f32：文本最大显示字号，单位为fp。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：文本最大显示字号，单位为fp。 | 352| NODE_TEXT_FONT | Text样式，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .string?：可选值 字体列表，使用多个字体，使用','进行分割。 <br> .value[0].f32：文本尺寸，单位为fp。 <br> .value[1]?.i32：可选值，文本的字体粗细，参数类型[ArkUI_FontWeight](capi-native-type-h.md#arkui_fontweight)。默认值为ARKUI_FONT_WEIGHT_NORMAL。 <br> .value[2]?.i32：可选值，字体样式，参数类型[ArkUI_FontStyle](capi-native-type-h.md#arkui_fontstyle)。默认值为ARKUI_FONT_STYLE_NORMAL。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string：字体列表，使用多个字体，使用','进行分割。 <br> .value[0].f32：文本尺寸，单位为fp。 <br> .value[1].i32：文本的字体粗细，参数类型[ArkUI_FontWeight](capi-native-type-h.md#arkui_fontweight)。默认值为ARKUI_FONT_WEIGHT_NORMAL。 <br> .value[2].i32：字体样式，参数类型[ArkUI_FontStyle](capi-native-type-h.md#arkui_fontstyle)。默认值为ARKUI_FONT_STYLE_NORMAL。| 353| NODE_TEXT_HEIGHT_ADAPTIVE_POLICY | Text自适应高度的方式，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：参数类型[ArkUI_TextHeightAdaptivePolicy](capi-native-type-h.md#arkui_textheightadaptivepolicy)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：参数类型[ArkUI_TextHeightAdaptivePolicy](capi-native-type-h.md#arkui_textheightadaptivepolicy)。| 354| NODE_TEXT_INDENT | 文本首行缩进属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32: 表示首行缩进值。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32: 表示首行缩进值。<br> | 355| NODE_TEXT_WORD_BREAK | 文本断行规则属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 参数类型[ArkUI_WordBreak](capi-native-type-h.md#arkui_wordbreak)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 参数类型[ArkUI_WordBreak](capi-native-type-h.md#arkui_wordbreak)。 | 356| NODE_TEXT_ELLIPSIS_MODE | 设置文本省略位置，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32: 参数类型[ArkUI_EllipsisMode](capi-native-type-h.md#arkui_ellipsismode)。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32: 参数类型[ArkUI_EllipsisMode](capi-native-type-h.md#arkui_ellipsismode)。 | 357| NODE_TEXT_LINE_SPACING | 文本行间距属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32 表示lineSpacing值，单位为fp。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32 表示lineSpacing值，单位为fp。 | 358| NODE_FONT_FEATURE | 设置文本特性效果，设置NODE_FONT_FEATURE属性，NODE_FONT_FEATURE是 OpenType 字体的高级排版能力，如支持连字、数字等宽等特性，一般用在自定义字体中，其能力需要字体本身支持,支持属性设置，属性重置，属性获取接口。 <br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string 符合文本特性格式的字符串，格式为normal \| \<feature-tag-value>, <br> \<feature-tag-value>的格式为：<string\> [ <integer\> \| on \| off ], <br> \<feature-tag-value>的个数可以有多个，中间用','隔开,例如，使用等宽数字的输入格式为：ss01 on。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string 表示文本特性的内容，多个文本特性之间使用逗号分隔。 <br> | 359| NODE_TEXT_ENABLE_DATA_DETECTOR | 设置使能文本识别。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：使能文本识别，默认值false，true表示文本可实体识别，false表示不可识别。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：使能文本识别。 | 360| NODE_TEXT_ENABLE_DATA_DETECTOR_CONFIG | 设置文本识别配置。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0...].i32: 实体类型数组，参数类型[ArkUI_TextDataDetectorType](capi-native-type-h.md#arkui_textdatadetectortype)。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0...].i32：实体类型数组，参数类型[ArkUI_TextDataDetectorType](capi-native-type-h.md#arkui_textdatadetectortype)。 | 361| NODE_TEXT_SELECTED_BACKGROUND_COLOR | 文本选中时的背景色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：颜色数值，0xargb格式，形如 0xFFFF0000 表示红色。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：颜色数值，0xargb格式。 | 362| NODE_TEXT_CONTENT_WITH_STYLED_STRING | Text组件使用格式化字符串对象设置文本内容属性，支持属性设置，属性重置，属性获取接口。配置自定义OH_Drawing_Typography对象到Text组件，会跳过文本控件的布局测算阶段，需要注意： <br> 1、需要保证OH_ArkUI_StyledString对象、OH_Drawing_Typography对象的生命周期跟随Text组件生命周期，Text组件析构时重置OH_ArkUI_StyledString对象，否则会导致应用出现空指针崩溃。 <br> 2、保证OH_Drawing_TypographyLayout方法调用时序在Text组件的布局测算之前。 <br> 3、释放OH_ArkUI_StyledString对象、OH_Drawing_Typography对象时，需要同步调用Text组件的reset方法，否则会导致应用出现空指针崩溃。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .object 表示 ArkUI_StyledString 格式化字符串数据，参数类型为[ArkUI_StyledString](capi-arkui-nativemodule-arkui-styledstring.md)。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .object 表示 ArkUI_StyledString 格式化字符串数据，参数类型为[ArkUI_StyledString](capi-arkui-nativemodule-arkui-styledstring.md)。 | 363| NODE_TEXT_HALF_LEADING = 1029 | Text组件设置文本纵向居中显示。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：文本是否纵向居中显示，默认值false。<br>true表示文本是纵向居中显示，false表示文本不是纵向居中显示。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：文本是否纵向居中显示。 | 364| NODE_IMMUTABLE_FONT_WEIGHT = 1030 | 组件字体粗细属性，支持属性设置，属性重置和属性获取接口。通过此接口设置的粗细属性不会跟随系统字体粗细变化。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：字体粗细样式[ArkUI_FontWeight](capi-native-type-h.md#arkui_fontweight)，默认值为ARKUI_FONT_WEIGHT_NORMAL； <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：字体粗细样式[ArkUI_FontWeight](capi-native-type-h.md#arkui_fontweight)； <br>**起始版本：** 15 | 365| NODE_TEXT_LINE_COUNT = 1031 | 文本行数属性，支持属性获取接口。属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32: 表示文本行数。 <br>**起始版本：** 20 | 366| NODE_TEXT_OPTIMIZE_TRAILING_SPACE = 1032 | 设置文本排版时是否优化每行结尾的空格，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32: 设置文本排版时是否优化每行结尾的空格，默认值为false。<br>true表示设置文本排版时优化每行结尾的空格，false表示不优化。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32: 文本排版时是否优化每行结尾的空格。 <br>**起始版本：** 20 | 367| NODE_TEXT_LINEAR_GRADIENT = 1033 | 设置文本线性渐变效果，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：线性渐变的起始角度。当direction属性设置为ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM时，angle属性生效；否则，以direction属性为主要布局方式。0点方向顺时针旋转为正向角度，默认值：180 <br> .value[1].i32：线性渐变的方向[ArkUI_LinearGradientDirection](capi-native-type-h.md#arkui_lineargradientdirection)。设置除ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM之外的线性渐变方向后，angle不生效。默认值：ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT_BOTTOM <br> .value[2].i32：为渐变的颜色重复着色，false表示不重复着色，true表示重复着色。默认值：false <br> .object: 参数类型为[ArkUI_ColorStop](capi-arkui-nativemodule-arkui-colorstop.md)。指定某百分比位置处的渐变色颜色，设置非法颜色直接跳过。 <br> colors：渐变色颜色数组，数组元素为0xargb格式，形如0xFFFF0000表示红色。 <br> stops：stops表示指定颜色所处位置的数组，数组元素取值范围为[0,1.0]，0表示需要设置渐变色的容器的开始处，1.0表示容器的结尾处。想要实现多个颜色渐变效果时，数组元素建议递增设置，如后一个数组元素比前一个数组元素小的话，按照等于前一个数组元素的值处理。 <br> size：颜色个数，若小于colors数组长度则仅生效前size个颜色，不建议设置大于colors数组长度或小于等于0的值以及异常值。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：线性渐变的起始角度。当为ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM时，angle为设置值，其他情况均为默认值0。 <br> .value[1].i32：线性渐变的方向[ArkUI_LinearGradientDirection](capi-native-type-h.md#arkui_lineargradientdirection)。 <br> .value[2].i32：为渐变的颜色重复着色，0表示不重复着色，1表示重复着色。默认值：0 <br> .object：参数类型为[ArkUI_ColorStop](capi-arkui-nativemodule-arkui-colorstop.md)。指定某百分比位置处的渐变色颜色，设置非法颜色直接跳过： <br> colors：渐变色颜色数组，数组元素为0xargb格式，形如0xFFFF0000表示红色。 <br> stops：stops表示指定颜色所处位置的数组，数组元素取值范围为[0,1.0]，0表示需要设置渐变色的容器的开始处，1.0表示容器的结尾处。 <br> size：生效后渐变色的颜色个数。 <br>**起始版本：** 20 | 368| NODE_TEXT_RADIAL_GRADIENT = 1034 | 设置文本径向渐变渐变效果，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0]?.f32：为径向渐变的中心点，即相对于当前文本框左上角的X轴坐标。 <br> .value[1]?.f32：为径向渐变的中心点，即相对于当前文本框左上角的Y轴坐标。文本框左上角的坐标为[0,0]。<br> .value[2]?.f32：径向渐变的半径，默认值0。 <br> .value[3]?.i32：为渐变的颜色重复着色，false表示不重复着色，true表示重复着色。默认值：false <br> .object：参数类型为[ArkUI_ColorStop](capi-arkui-nativemodule-arkui-colorstop.md)。指定某百分比位置处的渐变色颜色，设置非法颜色直接跳过： <br> colors：渐变色颜色数组，数组元素为0xargb格式，形如0xFFFF0000表示红色。 <br> stops：stops表示指定颜色所处位置的数组，数组元素取值范围为[0,1.0]，0表示需要设置渐变色的容器的开始处，1.0表示容器的结尾处。想要实现多个颜色渐变效果时，数组元素建议递增设置，如后一个数组元素比前一个数组元素小的话，按照等于前一个数组元素的值处理。 <br> size：颜色个数，若小于colors数组长度则仅生效前size个颜色，不建议设置大于colors数组长度或小于等于0的值以及异常值。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0]?.f32：为径向渐变的中心点，即相对于当前文本框左上角的X轴坐标。 <br> .value[1]?.f32：为径向渐变的中心点，即相对于当前文本框左上角的Y轴坐标。文本框左上角的坐标为[0,0]。<br> .value[2]?.f32：径向渐变的半径，默认值0。 <br> .value[3]?.i32：为渐变的颜色重复着色，0表示不重复着色，1表示重复着色。默认值：0 <br> .object：参数类型为[ArkUI_ColorStop](capi-arkui-nativemodule-arkui-colorstop.md)。指定某百分比位置处的渐变色颜色，设置非法颜色直接跳过： <br> colors：渐变色颜色数组，数组元素为0xargb格式，形如0xFFFF0000表示红色。 <br> stops：stops表示指定颜色所处位置的数组，数组元素取值范围为[0,1.0]，0表示需要设置渐变色的容器的开始处，1.0表示容器的结尾处。 <br> size：生效后渐变色的颜色个数。 <br>**起始版本：** 20 | 369| NODE_TEXT_VERTICAL_ALIGN = 1035 | 设置文本内容垂直对齐方式，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：文本内容垂直对齐方式[ArkUI_TextVerticalAlignment](capi-native-type-h.md#arkui_textverticalalignment)，默认值：ARKUI_TEXT_VERTICAL_ALIGNMENT_BASELINE <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：文本内容垂直对齐方式[ArkUI_TextVerticalAlignment](capi-native-type-h.md#arkui_textverticalalignment)。 <br>**起始版本：** 20 | 370| NODE_SPAN_CONTENT = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SPAN | 文本内容属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string 表示span的文本内容。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string 表示span的文本内容。 | 371| NODE_SPAN_TEXT_BACKGROUND_STYLE | 文本背景色属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32 表示文本背景颜色，0xargb格式，形如0xFFFF0000 表示红色。 <br> 第二个参数为文本背景圆角设置，支持如下两种设置方式： <br> - .value[1].f32：四个方向的圆角半径统一设置，单位为vp。 <br> - .value[1].f32：设置左上角圆角半径，单位为vp。 <br> .value[2].f32：设置右上角圆角半径，单位为vp。 <br> .value[3].f32：设置左下角圆角半径，单位为vp。 <br> .value[4].f32：设置右下角圆角半径，单位为vp。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：文本背景颜色，0xargb格式。 <br> .value[1].f32：左上角圆角半径，单位为vp。 <br> .value[2].f32：右上角圆角半径，单位为vp。 <br> .value[3].f32：左下角圆角半径，单位为vp。 <br> .value[4].f32：右下角圆角半径，单位为vp。 | 372| NODE_SPAN_BASELINE_OFFSET | 文本基线的偏移量属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：偏移量数值，单位为fp。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：偏移量数值，单位为fp。 | 373| NODE_IMAGE_SPAN_SRC = MAX_NODE_SCOPE_NUM * ARKUI_NODE_IMAGE_SPAN | imageSpan组件图片地址属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string 表示imageSpan的图片地址。 <br> .object 表示 PixelMap 图片数据，参数类型为[ArkUI_DrawableDescriptor](capi-arkui-nativemodule-arkui-drawabledescriptor.md)。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string 表示imageSpan的图片地址。 <br> .object 表示 PixelMap 图片数据，参数类型为[ArkUI_DrawableDescriptor](capi-arkui-nativemodule-arkui-drawabledescriptor.md)；.object参数和.string参数二选一，不可同时设置。 | 374| NODE_IMAGE_SPAN_VERTICAL_ALIGNMENT | 图片基于文本的对齐方式属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32 表示图片基于文本的对齐方式，取[ArkUI_ImageSpanAlignment](capi-native-type-h.md#arkui_imagespanalignment)枚举值。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32 表示图片基于文本的对齐方式，取[ArkUI_ImageSpanAlignment](capi-native-type-h.md#arkui_imagespanalignment)枚举值。 | 375| NODE_IMAGE_SPAN_ALT | imageSpan组件占位图地址属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string 表示image组件占位图地址(不支持gif类型图源)。 <br> .object 表示 PixelMap 图片数据，参数类型为[ArkUI_DrawableDescriptor](capi-arkui-nativemodule-arkui-drawabledescriptor.md)；.object参数和.string参数二选一，不可同时设置。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string 表示image组件占位图地址。 <br> .object 表示 PixelMap 图片数据，参数类型为[ArkUI_DrawableDescriptor](capi-arkui-nativemodule-arkui-drawabledescriptor.md)。 | 376| NODE_IMAGE_SPAN_BASELINE_OFFSET = 3003 | imageSpan组件的基线偏移量属性，支持属性设置，属性重置和属性获取接口。偏移量数值为正数时向上偏移，负数时向下偏移，默认值0，单位为fp。 <br> <br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：偏移量数值，单位为fp； <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：偏移量数值，单位为fp。 <br>**起始版本：** 13 | 377| NODE_IMAGE_SRC = MAX_NODE_SCOPE_NUM * ARKUI_NODE_IMAGE | image组件设置图片地址属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string 表示image组件地址。 <br> .object 表示 PixelMap 图片数据，参数类型为[ArkUI_DrawableDescriptor](capi-arkui-nativemodule-arkui-drawabledescriptor.md)；.object参数和.string参数二选一，不可同时设置。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string 表示image组件地址。 <br> .object 表示 PixelMap 图片数据，参数类型为[ArkUI_DrawableDescriptor](capi-arkui-nativemodule-arkui-drawabledescriptor.md)。| 378| NODE_IMAGE_OBJECT_FIT | 图片填充效果属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示图片填充效果，取[ArkUI_ObjectFit](capi-native-type-h.md#arkui_objectfit)枚举值。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示图片填充效果，取[ArkUI_ObjectFit](capi-native-type-h.md#arkui_objectfit)枚举值。| 379| NODE_IMAGE_INTERPOLATION | 图片插值效果属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示插值效果，取[ArkUI_ImageInterpolation](capi-native-type-h.md#arkui_imageinterpolation)枚举值。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示插值效果，取[ArkUI_ImageInterpolation](capi-native-type-h.md#arkui_imageinterpolation)枚举值。 | 380| NODE_IMAGE_OBJECT_REPEAT | 图片重复样式属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示图片重复样式，取[ArkUI_ImageRepeat](capi-native-type-h.md#arkui_imagerepeat)枚举值。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示图片重复样式，取[ArkUI_ImageRepeat](capi-native-type-h.md#arkui_imagerepeat)枚举值。 | 381| NODE_IMAGE_COLOR_FILTER | 图片滤镜效果属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 ~ .value[19].f32 表示滤镜矩阵数组。 <br> .size 表示滤镜数组大小 5x4。 <br> .object 颜色滤波器指针，参数类型为OH_Drawing_ColorFilter，.object和.size参数只能二选一，不可同时设置。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 ~ .value[19].f32 表示滤镜矩阵数组。 <br> .size 表示滤镜数组大小 5x4。 <br> .object 颜色滤波器指针，参数类型为OH_Drawing_ColorFilter。 | 382| NODE_IMAGE_AUTO_RESIZE | 图源自动缩放属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示是否缩放布尔值，默认值：false。false表示关闭图源自动缩放，true表示开启图源自动缩放。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示是否缩放布尔值。 | 383| NODE_IMAGE_ALT | 占位图地址属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string 表示image组件占位图地址。<br> .object 表示 PixelMap 图片数据，参数类型为[ArkUI_DrawableDescriptor](capi-arkui-nativemodule-arkui-drawabledescriptor.md)；.object参数和.string参数二选一，不可同时设置。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string 表示image组件占位图地址。<br> .object 表示 PixelMap 图片数据，参数类型为[ArkUI_DrawableDescriptor](capi-arkui-nativemodule-arkui-drawabledescriptor.md)。 | 384| NODE_IMAGE_DRAGGABLE | 图片拖拽效果属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示是否支持拖拽，设置为true表示支持。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示是否支持拖拽。 | 385| NODE_IMAGE_RENDER_MODE | 图片渲染模式属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 参数类型[ArkUI_ImageRenderMode](capi-native-type-h.md#arkui_imagerendermode)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 参数类型[ArkUI_ImageRenderMode](capi-native-type-h.md#arkui_imagerendermode)。 | 386| NODE_IMAGE_FIT_ORIGINAL_SIZE | 设置图片的显示尺寸是否跟随图源尺寸，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32，设置图片的显示尺寸是否跟随图源尺寸，1表示跟随，0表示不跟随，默认值为0。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32，1表示图片的显示尺寸跟随图源尺寸，0表示图片的显示尺寸不跟随图源尺寸。 | 387| NODE_IMAGE_FILL_COLOR | 设置填充颜色，设置后填充颜色会覆盖在图片上，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：填充色数值，0xargb格式，形如 0xFFFF0000 表示红色。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：填充色数值，0xargb格式。| 388| NODE_IMAGE_RESIZABLE | 设置图像拉伸时，可调整大小的图像选项。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 图片左部拉伸时，保持不变距离。单位vp。<br> .value[1].f32 图片上部拉伸时，保持不变距离。单位vp。<br> .value[2].f32 图片右部拉伸时，保持不变距离。单位vp。<br> .value[3].f32 图片下部拉伸时，保持不变距离。单位vp。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32 图片左部拉伸时，保持不变距离。单位vp。<br> .value[1].f32 图片上部拉伸时，保持不变距离。单位vp。<br> .value[2].f32 图片右部拉伸时，保持不变距离。单位vp。<br> .value[3].f32 图片下部拉伸时，保持不变距离。单位vp。 | 389| NODE_IMAGE_SYNC_LOAD = 4012 | 图源同步加载属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示是否同步，默认值：false。false表示异步加载图片，true表示同步加载图片。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 表示是否同步。<br>**起始版本：** 20 | 390| NODE_TOGGLE_SELECTED_COLOR = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TOGGLE | 组件打开状态的背景颜色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：背景色数值，0xargb格式，形如 0xFFFF0000 表示红色。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：背景色数值，0xargb格式。 | 391| NODE_TOGGLE_SWITCH_POINT_COLOR | Switch类型的圆形滑块颜色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：圆形滑块颜色数值，0xargb格式，形如 0xFFFF0000 表示红色。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：圆形滑块颜色数值，0xargb格式。 | 392| NODE_TOGGLE_VALUE | Switch类型的开关值，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：设置开关的值，true表示开启。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：设置开关的值。| 393| NODE_TOGGLE_UNSELECTED_COLOR | 组件关闭状态的背景颜色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：背景色数值，0xargb格式，形如 0xFFFF0000 表示红色。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：背景色数值，0xargb格式。 | 394| NODE_LOADING_PROGRESS_COLOR = MAX_NODE_SCOPE_NUM * ARKUI_NODE_LOADING_PROGRESS | 加载进度条前景色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：前景颜色数值，0xargb格式，形如 0xFFFF0000 表示红色。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：前景颜色数值，0xargb格式。 | 395| NODE_LOADING_PROGRESS_ENABLE_LOADING | LoadingProgress动画显示属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：false时不显示动画，true时可以显示动画；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：0时不显示动画，1时可以显示动画。 | 396| NODE_TEXT_INPUT_PLACEHOLDER = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT_INPUT | 单行文本输入框的默认提示文本内容属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string：默认提示文本的内容。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string：默认提示文本的内容。 | 397| NODE_TEXT_INPUT_TEXT | 单行文本输入框的默认文本内容属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string：默认文本的内容。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string：默认文本的内容。 | 398| NODE_TEXT_INPUT_CARET_COLOR | 光标颜色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：光标颜色数值，0xargb格式，形如 0xFFFF0000 表示红色。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：光标颜色数值，0xargb格式。 | 399| NODE_TEXT_INPUT_CARET_STYLE | 光标风格属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：光标宽度数值，单位为vp。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：光标宽度数值，单位为vp。 | 400| NODE_TEXT_INPUT_SHOW_UNDERLINE | 单行文本输入框下划线属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：false表示不展示下划线，true表示展示下划线。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：0表示不展示下划线，1表示展示下划线。 | 401| NODE_TEXT_INPUT_MAX_LENGTH | 输入框支持的最大文本数属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：最大文本数的数字，无单位。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：最大文本数的数字。| 402| NODE_TEXT_INPUT_ENTER_KEY_TYPE | 回车键类型属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：回车键类型枚举[ArkUI_EnterKeyType](capi-native-type-h.md#arkui_enterkeytype)，默认值为ARKUI_ENTER_KEY_TYPE_DONE。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：回车键类型枚举[ArkUI_EnterKeyType](capi-native-type-h.md#arkui_enterkeytype)。 | 403| NODE_TEXT_INPUT_PLACEHOLDER_COLOR | 无输入时默认提示文本的颜色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：颜色数值，0xargb格式，形如 0xFFFF0000 表示红色。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：颜色数值，0xargb格式。| 404| NODE_TEXT_INPUT_PLACEHOLDER_FONT | 无输入时默认提示文本的字体配置（包括大小、字重、样式、字体列表）属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0]?.f32：可选字体大小数值，默认值16.0，单位为fp；<br> .value[1]?.i32：可选字体样式[ArkUI_FontStyle](capi-native-type-h.md#arkui_fontstyle)，默认值为ARKUI_FONT_STYLE_NORMAL；<br> .value[2]?.i32：可选字体粗细样式[ArkUI_FontWeight](capi-native-type-h.md#arkui_fontweight)，默认值为ARKUI_FONT_WEIGHT_NORMAL；<br> ?.string: 字体族内容，多个字体族之间使用逗号分隔，形如“字重；字体族1，字体族2”。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：字体大小数值，单位为fp；<br> .value[1].i32：字体样式[ArkUI_FontStyle](capi-native-type-h.md#arkui_fontstyle)；<br> .value[2].i32：字体粗细样式[ArkUI_FontWeight](capi-native-type-h.md#arkui_fontweight)；<br> .string: 字体族内容，多个字体族之间使用逗号分隔。| 405| NODE_TEXT_INPUT_ENABLE_KEYBOARD_ON_FOCUS | 聚焦时是否绑定输入法属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：false表示聚焦不拉起输入法，true表示拉起。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：0表示聚焦不拉起输入法，1表示拉起。| 406| NODE_TEXT_INPUT_TYPE | 输入框的类型属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：输入框类型枚举[ArkUI_TextInputType](capi-native-type-h.md#arkui_textinputtype)，默认值为ARKUI_TEXTINPUT_TYPE_NORMAL。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：输入框类型枚举[ArkUI_TextInputType](capi-native-type-h.md#arkui_textinputtype)。 | 407| NODE_TEXT_INPUT_SELECTED_BACKGROUND_COLOR | 输入框文本选中时的背景色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：颜色数值，0xargb格式，形如 0xFFFF0000 表示红色。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：颜色数值，0xargb格式。| 408| NODE_TEXT_INPUT_SHOW_PASSWORD_ICON | 密码输入模式时是否显示末尾图标属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：false表示不显示图标，true表示显示图标；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：0表示不显示图标，1表示显示图标。 | 409| NODE_TEXT_INPUT_EDITING | 控制单行文本输入框编辑态属性，支持属性设置。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：false表示退出编辑态，true表示维持现状。<br> 属性获取方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：false表示退出编辑态，true表示维持现状。 | 410| NODE_TEXT_INPUT_CANCEL_BUTTON | 单行文本右侧清除按钮样式属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：按钮样式[ArkUI_CancelButtonStyle](capi-native-type-h.md#arkui_cancelbuttonstyle)，默认值为ARKUI_CANCELBUTTON_STYLE_INPUT；<br> .value[1]?.f32：图标大小数值，单位为vp；<br> .value[2]?.u32：按钮图标颜色数值，0xargb格式，形如 0xFFFF0000 表示红色；<br> ?.string：按钮图标地址，入参内容为图片本地地址，例如 /pages/icon.png。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：按钮样式[ArkUI_CancelButtonStyle](capi-native-type-h.md#arkui_cancelbuttonstyle)；<br> .value[1].f32：图标大小数值，单位为vp；<br> .value[2].u32：按钮图标颜色数值，0xargb格式；<br> .string：按钮图标地址。| 411| NODE_TEXT_INPUT_TEXT_SELECTION | 单行文本设置文本选中并高亮的区域，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：选中文本的起始位置；<br> .value[1].i32：选中文本的终止位置；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：选中文本的起始位置；<br> .value[1].i32：选中文本的终止位置；| 412| NODE_TEXT_INPUT_UNDERLINE_COLOR | 开启下划线时，支持配置下划线颜色。主题配置的默认下划线颜色为'0x33182431'。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：typing，必填，键入时下划线颜色，0xargb类型；<br> .value[1].u32：normal，必填，非特殊状态时下划线颜色，0xargb类型；<br> .value[2].u32：error，必填，错误时下划线颜色，0xargb类型；<br> .value[3].u32：disable，必填，禁用时下划线颜色，0xargb类型；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：typing，键入时下划线颜色，0xargb类型；<br> .value[1].u32：normal，非特殊状态时下划线颜色，0xargb类型；<br> .value[2].u32：error，错误时下划线颜色，0xargb类型；<br> .value[3].u32：disable，禁用时下划线颜色，0xargb类型；| 413| NODE_TEXT_INPUT_ENABLE_AUTO_FILL | 设置是否启用自动填充。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 是否启用自动填充，默认值true。<br>true表示启用，false表示不启用。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 是否启用自动填充。 | 414| NODE_TEXT_INPUT_CONTENT_TYPE | 自动填充类型。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 参数类型[ArkUI_TextInputContentType](capi-native-type-h.md#arkui_textinputcontenttype)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 参数类型[ArkUI_TextInputContentType](capi-native-type-h.md#arkui_textinputcontenttype)。 | 415| NODE_TEXT_INPUT_PASSWORD_RULES | 定义生成密码的规则。在触发自动填充时，所设置的密码规则会透传给密码保险箱，用于新密码的生成。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 定义生成密码的规则。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 定义生成密码的规则。| 416| NODE_TEXT_INPUT_SELECT_ALL | 设置当初始状态，是否全选文本。不支持内联模式。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 是否全选文本，默认值：false。<br>true表示会全选文本，false表示不会全选文本。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 是否全选文本。| 417| NODE_TEXT_INPUT_INPUT_FILTER | 通过正则表达式设置输入过滤器。匹配表达式的输入允许显示，不匹配的输入将被过滤。单字符输入场景仅支持单字符匹配，多字符输入场景支持字符串匹配，例如粘贴。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 正则表达式。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 正则表达式。 | 418| NODE_TEXT_INPUT_STYLE | 设置输入框为默认风格或内联输入风格。内联输入风格只支持输入框类型的枚举[ArkUI_TextInputType](capi-native-type-h.md#arkui_textinputtype)设置为ARKUI_TEXTINPUT_TYPE_NORMAL。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 参数类型[ArkUI_TextInputStyle](capi-native-type-h.md#arkui_textinputstyle)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 参数类型[ArkUI_TextInputStyle](capi-native-type-h.md#arkui_textinputstyle)。 | 419| NODE_TEXT_INPUT_CARET_OFFSET | 设置或获取光标所在位置信息。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> 设置输入光标的位置。<br> .value[0].i32： 从字符串开始到光标所在位置的字符长度。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> 返回当前光标所在位置信息。在当前帧更新光标位置同时调用该接口，该接口不生效。<br> .value[0].i32：光标所在位置的索引值。<br> .value[1].f32：光标相对输入框的x坐标位值。<br> .value[2].f32：光标相对输入框的y坐标位值。 | 420| NODE_TEXT_INPUT_CONTENT_RECT | 获取已编辑文本内容区域相对组件的位置和大小。属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：水平方向横坐标。<br> .value[1].f32：竖直方向纵坐标。<br> .value[2].f32：内容宽度大小。<br> .value[3].f32：内容高度大小。 | 421| NODE_TEXT_INPUT_CONTENT_LINE_COUNT | 获取已编辑文本内容的行数。属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> value[0].i32：已编辑文本内容行数。 | 422| NODE_TEXT_INPUT_SELECTION_MENU_HIDDEN | 设置长按、双击输入框或者右键输入框时，是否不弹出文本选择菜单，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 长按、双击输入框或者右键输入框时，是否不弹出文本选择菜单。默认值false。<br>设置为true时，单击输入框光标、长按输入框、双击输入框、三击输入框或者右键输入框，隐藏系统文本选择菜单。<br>设置为false时，显示系统文本选择菜单。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 长按、双击输入框或者右键输入框时，是否不弹出文本选择菜单。 | 423| NODE_TEXT_INPUT_BLUR_ON_SUBMIT | 设置输入框在submit状态下，触发回车键是否失焦。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否失焦。false表示触发回车键后不失焦，true表示触发回车键后失焦。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否失焦。| 424| NODE_TEXT_INPUT_CUSTOM_KEYBOARD | 设置自定义键盘。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：自定义键盘，参数类型[ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md)。<br> .value[0]?.i32：设置自定义键盘是否支持避让功能，默认值false。<br>true表示支持避让，false表示不支持避让。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：自定义键盘，参数类型[ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md)。<br> .value[0].i32：设置自定义键盘是否支持避让功能。 | 425| NODE_TEXT_INPUT_WORD_BREAK | 文本断行规则属性，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 参数类型[ArkUI_WordBreak](capi-native-type-h.md#arkui_wordbreak)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 参数类型[ArkUI_WordBreak](capi-native-type-h.md#arkui_wordbreak)。 | 426| NODE_TEXT_INPUT_NUMBER_OF_LINES | 设置该属性后，通过该属性计算TextInput组件的高度。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 设置numberOfLines的值。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 设置numberOfLines的值。 | 427| NODE_TEXT_INPUT_LETTER_SPACING = 7032 | 设置该属性后，通过该属性调整TextInput组件的字符间距。接口支持设置，重置以及获取该属性。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32: 设置letterSpacing的值，默认单位fp。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32: 获取letterSpacing的值，默认单位fp。<br>**起始版本：** 15 | 428| NODE_TEXT_INPUT_ENABLE_PREVIEW_TEXT = 7033 | 设置TextInput组件是否开启输入预上屏。接口支持设置，重置以及获取该属性。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 设置是否开启输入预上屏。false表示不开启输入预上屏，true表示开启输入预上屏。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 获取是否开启输入预上屏。<br>**起始版本：** 15 | 429| NODE_TEXT_INPUT_HALF_LEADING = 7034 | 设置文本将行间距平分至行的顶部与底部。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 设置文本是否将行间距平分至行的顶部与底部。默认值false。<br>true表示将行间距平分至行的顶部与底部，false表示不平分。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 设置文本是否将行间距平分至行的顶部与底部。<br>**起始版本：** 18 | 430| NODE_TEXT_INPUT_KEYBOARD_APPEARANCE = 7035 | 设置输入框拉起的键盘样式。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：键盘样式，参数类型[ArkUI_KeyboardAppearance](capi-native-type-h.md#arkui_keyboardappearance)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：键盘样式，参数类型[ArkUI_KeyboardAppearance](capi-native-type-h.md#arkui_keyboardappearance)。<br>**起始版本：** 15 | 431| NODE_TEXT_INPUT_ENABLE_FILL_ANIMATION = 7036 | 设置是否启用自动填充动效。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否启用自动填充动效。<br/>true表示启用，false表示不启用。<br/>默认值true。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否启用自动填充动效。启用之后，仅输入框类型的枚举[ArkUI_TextInputType](capi-native-type-h.md#arkui_textinputtype)设置为ARKUI_TEXTINPUT_TYPE_PASSWORD、ARKUI_TEXTINPUT_TYPE_NUMBER_PASSWORD或ARKUI_TEXTINPUT_TYPE_NEW_PASSWORD的输入框在进行自动填充时动效可生效。<br>**起始版本：** 20 | 432| NODE_TEXT_INPUT_SHOW_KEYBOARD_ON_FOCUS | 设置输入框获取焦点时是否弹出键盘，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 是否弹出键盘。false表示获取焦点时不弹出键盘，true表示获取焦点时弹出键盘。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 是否弹出键盘。 | 433| NODE_TEXT_INPUT_LINE_HEIGHT = 7037 | 设置输入框文本的高度，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：文本的高度的数字。默认值是自适应字体大小。设置为undefined时，文本的高度设置为5。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：文本的高度的数字。<br>**起始版本：** 20 | 434| NODE_TEXT_AREA_PLACEHOLDER = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT_AREA | 多行文本输入框的默认提示文本内容属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string：默认提示文本的内容。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string：默认提示文本的内容。 | 435| NODE_TEXT_AREA_TEXT | 多行文本输入框的默认文本内容属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string：默认文本的内容。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string：默认文本的内容。 | 436| NODE_TEXT_AREA_MAX_LENGTH | 输入框支持的最大文本数属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：最大文本数的数字。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：最大文本数的数字。| 437| NODE_TEXT_AREA_PLACEHOLDER_COLOR | 无输入时默认提示文本的颜色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：颜色数值，0xargb格式，形如 0xFFFF0000 表示红色。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：颜色数值，0xargb格式。 | 438| NODE_TEXT_AREA_PLACEHOLDER_FONT | 无输入时默认提示文本的字体配置（包括大小、字重、样式、字体列表）属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0]?.f32：可选字体大小数值，默认值16.0，单位为fp；<br> .value[1]?.i32：可选字体样式[ArkUI_FontStyle](capi-native-type-h.md#arkui_fontstyle)，默认值为ARKUI_FONT_STYLE_NORMAL；<br> .value[2]?.i32：可选字体粗细样式[ArkUI_FontWeight](capi-native-type-h.md#arkui_fontweight)，默认值为ARKUI_FONT_WEIGHT_NORMAL；<br> ?.string: 字体族内容，多个字体族之间使用逗号分隔，形如“字重；字体族1，字体族2”。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：字体大小数值，单位为fp；<br> .value[1].i32：字体样式[ArkUI_FontStyle](capi-native-type-h.md#arkui_fontstyle)；<br> .value[2].i32：字体粗细样式[ArkUI_FontWeight](capi-native-type-h.md#arkui_fontweight)；<br> .string: 字体族内容，多个字体族之间使用逗号分隔。| 439| NODE_TEXT_AREA_CARET_COLOR | 光标颜色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：背景色数值，0xargb格式，形如 0xFFFF0000 表示红色。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：背景色数值，0xargb格式。| 440| NODE_TEXT_AREA_EDITING | 控制多行文本输入框编辑态属性，支持属性设置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：false表示退出编辑态，true表示维持现状。<br> 属性获取方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：false表示退出编辑态，true表示维持现状。 | 441| NODE_TEXT_AREA_TYPE | 输入框的类型属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：输入框类型枚举[ArkUI_TextAreaType](capi-native-type-h.md#arkui_textareatype)，默认值为ARKUI_TEXTAREA_TYPE_NORMAL。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：输入框类型枚举[ArkUI_TextAreaType](capi-native-type-h.md#arkui_textareatype)。 | 442| NODE_TEXT_AREA_SHOW_COUNTER | 设置输入的字符数超过阈值时是否显示计数器并设置计数器样式，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否开启计数器，值为true时为开启。<br> .value[1]?.f32：可输入字符数占最大字符限制的百分比值，超过此值时显示计数器，取值范围1-100，小数时向下取整。<br> .value[2]?.i32：输入字符超出限制时是否高亮边框。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否开启计数器。<br> .value[1].f32：可输入字符数占最大字符限制的百分比值，超过此值时显示计数器，取值范围1-100。<br> .value[2].i32：输入字符超出限制时是否高亮边框，默认高亮。| 443| NODE_TEXT_AREA_SELECTION_MENU_HIDDEN | 设置长按、双击输入框或者右键输入框时，是否不弹出文本选择菜单，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 长按、双击输入框或者右键输入框时，是否不弹出文本选择菜单。默认值false。<br>设置为true时，单击输入框光标、长按输入框、双击输入框、三击输入框或者右键输入框，隐藏系统文本选择菜单。<br>设置为false时，显示系统文本选择菜单。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 长按、双击输入框或者右键输入框时，是否不弹出文本选择菜单。| 444| NODE_TEXT_AREA_BLUR_ON_SUBMIT | 设置多行输入框在submit状态下，触发回车键是否失焦。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否失焦。false表示触发回车键后不失焦，true表示触发回车键后失焦。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否失焦。 | 445| NODE_TEXT_AREA_INPUT_FILTER | 通过正则表达式设置输入过滤器。匹配表达式的输入允许显示，不匹配的输入将被过滤。单字符输入场景仅支持单字符匹配，多字符输入场景支持字符串匹配，例如粘贴。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 正则表达式。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 正则表达式。 | 446| NODE_TEXT_AREA_SELECTED_BACKGROUND_COLOR | 设置文本选中底板颜色，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：颜色数值，0xargb格式，形如 0xFFFF0000 表示红色。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：颜色数值，0xargb格式。 | 447| NODE_TEXT_AREA_ENTER_KEY_TYPE | 设置输入法回车键类型，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：回车键类型枚举[ArkUI_EnterKeyType](capi-native-type-h.md#arkui_enterkeytype)，默认值为ARKUI_ENTER_KEY_TYPE_DONE。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：回车键类型枚举[ArkUI_EnterKeyType](capi-native-type-h.md#arkui_enterkeytype)。| 448| NODE_TEXT_AREA_ENABLE_KEYBOARD_ON_FOCUS | 设置TextArea通过点击以外的方式获焦时，是否绑定输入法，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：false表示聚焦不拉起输入法，true表示拉起，默认值为true。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：0表示聚焦不拉起输入法，1表示拉起。 | 449| NODE_TEXT_AREA_CARET_OFFSET | 设置或获取光标所在位置信息。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> 设置输入光标的位置。<br> .value[0].i32： 从字符串开始到光标所在位置的字符长度。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> 返回当前光标所在位置信息。在当前帧更新光标位置同时调用该接口，该接口不生效。<br> .value[0].i32：光标所在位置的索引值。<br> .value[1].f32：光标相对输入框的x坐标位值。<br> .value[2].f32：光标相对输入框的y坐标位值。| 450| NODE_TEXT_AREA_CONTENT_RECT | 获取已编辑文本内容区域相对组件的位置和大小。<br>属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：水平方向横坐标。<br> .value[1].f32：竖直方向纵坐标。<br> .value[2].f32：内容宽度大小。<br> .value[3].f32：内容高度大小。 | 451| NODE_TEXT_AREA_CONTENT_LINE_COUNT | 获取已编辑文本内容的行数。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：已编辑文本内容行数。 | 452| NODE_TEXT_AREA_TEXT_SELECTION | 组件在获焦状态下，调用该接口设置文本选择区域并高亮显示，且只有在selectionStart小于selectionEnd时，文字才会被选取、高亮显示。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：选中文本的起始位置；<br> .value[1].i32：选中文本的终止位置；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：选中文本的起始位置；<br> .value[1].i32：选中文本的终止位置； | 453| NODE_TEXT_AREA_ENABLE_AUTO_FILL | 设置是否启用自动填充。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 是否启用自动填充，默认值true。<br>true表示启用，false表示不启用。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 是否启用自动填充。 | 454| NODE_TEXT_AREA_CONTENT_TYPE | 自动填充类型。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 参数类型[ArkUI_TextInputContentType](capi-native-type-h.md#arkui_textinputcontenttype)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 参数类型[ArkUI_TextInputContentType](capi-native-type-h.md#arkui_textinputcontenttype)。| 455| NODE_TEXT_AREA_NUMBER_OF_LINES | 设置该属性后，通过该属性计算TextArea组件的高度。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 设置numberOfLines的值。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 设置numberOfLines的值。 | 456| NODE_TEXT_AREA_LETTER_SPACING = 8023 | 设置该属性后，通过该属性调整TextArea组件的字符间距。接口支持设置，重置以及获取该属性。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32: 设置letterSpacing的值，默认单位fp。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32: 获取letterSpacing的值，默认单位fp。<br>**起始版本：** 15 | 457| NODE_TEXT_AREA_ENABLE_PREVIEW_TEXT = 8024 | 设置TextArea组件是否开启输入预上屏。接口支持设置，重置以及获取该属性。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 设置是否开启输入预上屏。false表示不开启输入预上屏，true表示开启输入预上屏。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 获取是否开启输入预上屏。<br>**起始版本：** 15 | 458| NODE_TEXT_AREA_HALF_LEADING = 8025 | 设置文本将行间距平分至行的顶部与底部。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 设置文本是否将行间距平分至行的顶部与底部。默认值false。<br>true表示将行间距平分至行的顶部与底部，false表示不平分。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: 设置文本是否将行间距平分至行的顶部与底部。<br>**起始版本：** 18 | 459| NODE_TEXT_AREA_KEYBOARD_APPEARANCE = 8026 | 设置输入框拉起的键盘样式。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：键盘样式，参数类型[ArkUI_KeyboardAppearance](capi-native-type-h.md#arkui_keyboardappearance)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：键盘样式，参数类型[ArkUI_KeyboardAppearance](capi-native-type-h.md#arkui_keyboardappearance)。<br>**起始版本：** 15 | 460| NODE_TEXT_AREA_MAX_LINES = 8027 | 设置输入框内联模式编辑态时文本可显示的最大行数，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：内联输入风格编辑态时文本可显示的最大行数。内联模式下，默认值是3，<br> 非内联模式下，默认值是+∞，不限制最大行数。设置为undefined时，最大行数设置为5。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：最大行数的数字。<br>**起始版本：** 20 | 461| NODE_TEXT_AREA_LINE_SPACING = 8028 | 设置输入框文本的行间距，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：文本的行间距的数字。默认值是0。设置为undefined时，行间距设置为5。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：文本的行间距的数字。<br>**起始版本：** 20 | 462| NODE_TEXT_AREA_MIN_LINES = 8029 | 设置节点的最小行数。支持属性设置、属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：最小行数的数字。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：最小行数的数字。<br>**起始版本：** 20 | 463| NODE_TEXT_AREA_MAX_LINES_WITH_SCROLL = 8030 | 设置支持滚动时节点的最大行数。支持属性设置、属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：支持滚动时的最大行数的数字。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：支持滚动时的最大行数的数字。<br>**起始版本：** 20 | 464| NODE_TEXT_AREA_SHOW_KEYBOARD_ON_FOCUS | 设置输入框获取焦点时是否弹出键盘，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 是否弹出键盘。false表示获取焦点时不弹出键盘，true表示获取焦点时弹出键盘。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 是否弹出键盘。| 465| NODE_TEXT_AREA_LINE_HEIGHT = 8031 | 设置输入框文本的高度，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：文本的高度的数字。默认值是自适应字体大小。设置为undefined时，文本的高度设置为5。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：文本的高度的数字。<br>**起始版本：** 20 | 466| NODE_BUTTON_LABEL = MAX_NODE_SCOPE_NUM * ARKUI_NODE_BUTTON | button按钮的文本内容属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string：默认文本的内容。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string：默认文本的内容。 | 467| NODE_BUTTON_TYPE | Button按钮的样式属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：设置Button按钮的样式，参数类型[ArkUI_ButtonType](capi-native-type-h.md#arkui_buttontype)，默认值为ARKUI_BUTTON_TYPE_CAPSULE。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：获取Button按钮的样式，参数类型[ArkUI_ButtonType](capi-native-type-h.md#arkui_buttontype)，默认值为ARKUI_BUTTON_TYPE_CAPSULE。 | 468| NODE_BUTTON_MIN_FONT_SCALE | Button按钮的最小字体缩放倍数属性，支持属性设置，属性重置和属性获取。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32: 设置Button按钮的最小字体缩放倍数，默认单位fp。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32: 获取Button按钮的最小字体缩放倍数，默认单位fp。<br>**起始版本：** 18 | 469| NODE_BUTTON_MAX_FONT_SCALE | Button按钮的最大字体缩放倍数属性，支持属性设置，属性重置和属性获取。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32: 设置Button按钮的最大字体缩放倍数，默认单位fp。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32: 获取Button按钮的最大字体缩放倍数，默认单位fp。<br>**起始版本：** 18 | 470| NODE_PROGRESS_VALUE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_PROGRESS | 进度条的当前进度值属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：进度条当前值。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：进度条当前值。 | 471| NODE_PROGRESS_TOTAL | 进度条的总长属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：进度条总长。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：进度条总长。 | 472| NODE_PROGRESS_COLOR | 进度条显示进度值的颜色属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：颜色数值，0xargb格式，形如 0xFFFF0000 表示红色。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：颜色数值，0xargb格式。 | 473| NODE_PROGRESS_TYPE | 进度条的类型属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：进度条类型枚举值[ArkUI_ProgressType](capi-native-type-h.md#arkui_progresstype)，默认值为ARKUI_PROGRESS_TYPE_LINEAR。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：进度条类型枚举值[ArkUI_ProgressType](capi-native-type-h.md#arkui_progresstype)。 | 474| NODE_PROGRESS_LINEAR_STYLE | 线性进度条样式设置，支持属性设置，属性重置和属性获取接口，如果进度条类型不是线性样式则不生效。.object：使用[ArkUI_ProgressLinearStyleOption](capi-arkui-nativemodule-arkui-progresslinearstyleoption.md)对象设置组件样式。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：使用[ArkUI_ProgressLinearStyleOption](capi-arkui-nativemodule-arkui-progresslinearstyleoption.md)对象获取组件样式。<br>**起始版本：** 15 | 475| NODE_CHECKBOX_SELECT = MAX_NODE_SCOPE_NUM * ARKUI_NODE_CHECKBOX | CheckBox多选框是否选中，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：1表示选中，0表示不选中。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：1表示选中，0表示不选中。 | 476| NODE_CHECKBOX_SELECT_COLOR | CheckBox多选框选中状态颜色，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].u32：多选框选中状态颜色, 类型为0xargb，如0xFF1122FF。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：多选框选中状态颜色, 类型为0xargb，如0xFF1122FF。 | 477| NODE_CHECKBOX_UNSELECT_COLOR | CheckBox多选框非选中状态边框颜色，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].u32：边框颜色, 类型为0xargb，如0xFF1122FF。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：边框颜色, 类型为0xargb，如0xFF1122FF。 | 478| NODE_CHECKBOX_MARK | CheckBox多选框内部图标样式，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].u32：边框颜色, 类型为0xargb，如0xFF1122FF；<br> .value[1]?.f32：可选，内部图标大小，单位vp；<br> .value[2]?.f32：可选，内部图标粗细，单位vp，默认值2。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：边框颜色, 类型为0xargb，如0xFF1122FF；<br> .value[1].f32：内部图标大小，单位vp；<br> .value[2].f32：内部图标粗细，单位vp，默认值2。 | 479| NODE_CHECKBOX_SHAPE | CheckBox组件形状, 支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：组件形状，参数类型[ArkUI_CheckboxShape](capi-native-type-h.md#arkui_checkboxshape)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：组件形状，参数类型[ArkUI_CheckboxShape](capi-native-type-h.md#arkui_checkboxshape)。 | 480| NODE_CHECKBOX_NAME | 定义复选框的名称, 支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .string: 组件名称。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string: 组件名称。 <br> **起始版本：** 15 | 481| NODE_CHECKBOX_GROUP | 定义复选框的组的名称, 支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .string: 组件名称。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string: 组件名称。 <br>**起始版本：** 15 | 482| NODE_XCOMPONENT_ID = MAX_NODE_SCOPE_NUM * ARKUI_NODE_XCOMPONENT | XComponent组件ID属性，支持属性设置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string: ID的内容。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string: ID的内容。 | 483| NODE_XCOMPONENT_TYPE | XComponent组件的类型，仅支持属性获取接口。<br/>XComponent组件的类型需要在组件创建时通过[ArkUI_NodeType](#arkui_nodetype)中的ARKUI_NODE_XCOMPONENT或者ARKUI_NODE_XCOMPONENT_TEXTURE明确，不允许后续修改。<br/>使用[setAttribute](capi-arkui-nativemodule-arkui-nativenodeapi-1.md#setattribute)接口尝试修改XComponent组件的类型时会发生绘制内容异常。<br/> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：字体样式[ArkUI_XComponentType](capi-native-type-h.md#arkui_xcomponenttype)。 | 484| NODE_XCOMPONENT_SURFACE_SIZE | XComponent组件的宽高，仅支持属性获取接口。<br/>使用[setAttribute](capi-arkui-nativemodule-arkui-nativenodeapi-1.md#setattribute)接口尝试修改XComponent组件的宽高时设置不会生效。<br/> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：宽数值，单位为px；<br> .value[1].u32：高数值，单位为px。 | 485| NODE_XCOMPONENT_SURFACE_RECT | 设置XComponent组件持有Surface的显示区域，支持属性设置和获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: Surface显示区域相对于XComponent组件左上角的x轴坐标, 单位为px。<br> .value[1].i32: Surface显示区域相对于XComponent组件左上角的y轴坐标, 单位为px。<br> .value[2].i32: Surface显示区域的宽度, 单位为px。<br> .value[3].i32: Surface显示区域的高度, 单位为px。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: Surface显示区域相对于XComponent组件左上角的x轴坐标, 单位为px。<br> .value[1].i32: Surface显示区域相对于XComponent组件左上角的y轴坐标, 单位为px。<br> .value[2].i32: Surface显示区域的宽度, 单位为px。<br> .value[3].i32: Surface显示区域的高度, 单位为px。<br>**起始版本：** 18 | 486| NODE_XCOMPONENT_ENABLE_ANALYZER | 设置XComponent组件是否支持图像分析，支持属性设置和获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> value[0].i32: 是否支持图像分析，1表示支持图像分析，0表示不支持图像分析。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> value[0].i32: 是否支持图像分析，1表示支持图像分析，0表示不支持图像分析。<br>**起始版本：** 18 | 487| NODE_DATE_PICKER_LUNAR = MAX_NODE_SCOPE_NUM * ARKUI_NODE_DATE_PICKER | 设置日期选择器组件的日期是否显示农历，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 是否显示农历，默认值false。false表示不展示农历，true表示展示农历。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 是否显示农历。 | 488| NODE_DATE_PICKER_START | 设置日期选择器组件选择器的起始日期，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 日期，默认值"1970-1-1"。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 日期。| 489| NODE_DATE_PICKER_END | 设置日期选择器组件选择器的结束日期，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 日期，默认值"2100-12-31"。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 日期。| 490| NODE_DATE_PICKER_SELECTED | 设置日期选择器组件选中项的日期，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 日期，默认值"2024-01-22"。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 日期。 | 491| NODE_DATE_PICKER_DISAPPEAR_TEXT_STYLE | 设置日期选择器组件的所有选项中最上和最下两个选项的文本颜色、字号、字体粗细，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 入参5个，格式为字符串，以 ';' 分割：<br> 入参1： 文本颜色，#argb类型。<br> 入参2： 文本大小，数字类型，单位fp。<br> 入参3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")。<br> 入参4： 文本字体列表，使用 ',' 进行分割。<br> 入参5： 文本样式，字符串枚举("normal", "italic")。<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 参数5个，格式为字符串，以 ';' 分割：<br> 参数1： 文本颜色，#argb类型。<br> 参数2： 文本大小，数字类型，单位fp。<br> 参数3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")。<br> 参数4： 文本字体列表，使用 ',' 进行分割。<br> 参数5： 文本样式，字符串枚举("normal", "italic")。<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。 | 492| NODE_DATE_PICKER_TEXT_STYLE | 设置日期选择器组件的所有选项中除了最上、最下及选中项以外的文本颜色、字号、字体粗细，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 入参5个，格式为字符串，以 ';' 分割：<br> 入参1： 文本颜色，#argb类型。<br> 入参2： 文本大小，数字类型，单位fp。<br> 入参3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")。<br> 入参4： 文本字体列表，使用 ',' 进行分割。<br> 入参5： 文本样式，字符串枚举("normal", "italic")。<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 参数5个，格式为字符串，以 ';' 分割：<br> 参数1： 文本颜色，#argb类型。<br> 参数2： 文本大小，数字类型，单位fp。<br> 参数3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")。<br> 参数4： 文本字体列表，使用 ',' 进行分割。<br> 参数5： 文本样式，字符串枚举("normal", "italic")。<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。 | 493| NODE_DATE_PICKER_SELECTED_TEXT_STYLE | 设置日期选择器组件的选中项的文本颜色、字号、字体粗细，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 入参5个，格式为字符串，以 ';' 分割：<br> 入参1： 文本颜色，#argb类型。<br> 入参2： 文本大小，数字类型，单位fp。<br> 入参3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")。<br> 入参4： 文本字体列表，使用 ',' 进行分割。<br> 入参5： 文本样式，字符串枚举("normal", "italic")。<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 参数5个，格式为字符串，以 ';' 分割：<br> 参数1： 文本颜色，#argb类型。<br> 参数2： 文本大小，数字类型，单位fp。<br> 参数3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")。<br> 参数4： 文本字体列表，使用 ',' 进行分割。<br> 参数5： 文本样式，字符串枚举("normal", "italic")。<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。 | 494| NODE_DATE_PICKER_MODE = 13007 | 设置要显示的日期选项列。DatePicker显示不同样式的日期列，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：显示的日期列类型。参数类型[ArkUI_DatePickerMode](capi-native-type-h.md#arkui_datepickermode)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：显示的日期列类型。参数类型[ArkUI_DatePickerMode](capi-native-type-h.md#arkui_datepickermode)。<br>**起始版本：** 18 | 495| NODE_DATE_PICKER_ENABLE_HAPTIC_FEEDBACK = 13008 | 设置是否开启触控反馈。支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：是否开启触控反馈。默认值：true，true表示开启触控反馈，false则表示不开启触控反馈。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> value[0].f32：是否开启触控反馈。 <br> **起始版本：** 18 | 496| NODE_DATE_PICKER_CAN_LOOP = 13009 | Picker组件可循环滚动属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：false表示不可循环，true表示可循环。默认值：true，设置异常值时使用默认值。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> value[0].i32：0表示不可循环，1表示可循环。<br> 说明：可循环情况下，年份随着月份的循环滚动进行联动加减，月份随着日的循环滚动进行联动加减。<br> 不可循环情况下，年/月/日到达本列的顶部或底部时，无法再进行滚动，年/月/日之间也无法再联动加减。<br> **起始版本：** 20 | 497| NODE_TIME_PICKER_USE_MILITARY_TIME | 设置时间选择组件展示时间是否为24小时制，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 是否为24小时制，默认值：false。false表示展示时间为12小时制，true表示展示时间为24小时制。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 是否为24小时制。| 498| NODE_TIME_PICKER_DISAPPEAR_TEXT_STYLE | 设置时间选择组件所有选项中最上和最下两个选项的文本颜色、字号、字体粗细，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 入参5个，格式为字符串，以 ';' 分割：<br> 入参1： 文本颜色，#argb类型。<br> 入参2： 文本大小，数字类型，单位fp。<br> 入参3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")。<br> 入参4： 文本字体列表，使用 ',' 进行分割。<br> 入参5： 文本样式，字符串枚举("normal", "italic")。<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 参数5个，格式为字符串，以 ';' 分割：<br> 参数1： 文本颜色，#argb类型。<br> 参数2： 文本大小，数字类型，单位fp。<br> 参数3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")。<br> 参数4： 文本字体列表，使用 ',' 进行分割。<br> 参数5： 文本样式，字符串枚举("normal", "italic")。<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。| 499| NODE_TIME_PICKER_TEXT_STYLE | 设置时间选择组件所有选项中除了最上、最下及选中项以外的文本颜色、字号、字体粗细，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 入参5个，格式为字符串，以 ';' 分割：<br> 入参1： 文本颜色，#argb类型。<br> 入参2： 文本大小，数字类型，单位fp。<br> 入参3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")。<br> 入参4： 文本字体列表，使用 ',' 进行分割。<br> 入参5： 文本样式，字符串枚举("normal", "italic")。<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 参数5个，格式为字符串，以 ';' 分割：<br> 参数1： 文本颜色，#argb类型。<br> 参数2： 文本大小，数字类型，单位fp。<br> 参数3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")。<br> 参数4： 文本字体列表，使用 ',' 进行分割。<br> 参数5： 文本样式，字符串枚举("normal", "italic")。<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。 | 500| NODE_TIME_PICKER_SELECTED_TEXT_STYLE | 设置时间选择组件选中项的文本颜色、字号、字体粗细，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 入参5个，格式为字符串，以 ';' 分割：<br> 入参1： 文本颜色，#argb类型。<br> 入参2： 文本大小，数字类型，单位fp。<br> 入参3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")。<br> 入参4： 文本字体列表，使用 ',' 进行分割。<br> 入参5： 文本样式，字符串枚举("normal", "italic")。<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 参数5个，格式为字符串，以 ';' 分割：<br> 参数1： 文本颜色，#argb类型。<br> 参数2： 文本大小，数字类型，单位fp。<br> 参数3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")。<br> 参数4： 文本字体列表，使用 ',' 进行分割。<br> 参数5： 文本样式，字符串枚举("normal", "italic")。<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。 | 501| NODE_TIME_PICKER_SELECTED = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TIME_PICKER | 设置时间选择器组件的选中项时间，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数 [ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md) 参数格式：<br> .string: 时间。 默认值：当前系统时间。格式：仅支持时、分输入（例：23:59/23-59）。<br> 属性获取方法返回值 [ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md) 参数格式：<br> .string: 时间。 默认值：当前系统时间。格式：时、分、秒（例：23,59,1）。 | 502| NODE_TIME_PICKER_START = 14005 | 设置时间选择器组件的起始时间，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数 [ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md) 参数格式：<br> .string: 时间。 默认值："0:0:0"。格式：仅支持时、分输入（例：12:59/12-59）。<br> 属性获取方法返回值 [ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md) 参数格式：<br> .string: 时间。 默认值："0:0:0"。格式：时、分、秒（例：12:59:0）。<br>**起始版本：** 18 | 503| NODE_TIME_PICKER_END = 14006 | 设置时间选择器组件的结束日期，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数 [ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md) 参数格式：<br> .string: 时间。默认值："23:59:59"。格式：仅支持时、分输入（例：23:59/23-59）。<br> 属性获取方法返回值 [ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md) 参数格式：<br> .string: 时间。默认值："23:59:59"。格式：时、分、秒（例：23:59:0）。<br>**起始版本：** 18 | 504| NODE_TIME_PICKER_ENABLE_CASCADE = 14007 | 在设置12小时制时，上午和下午的标识会根据小时数自动切换，支持属性设置、重置和获取。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 在12小时制时，设置上午和下午的标识是否会根据小时数自动切换，默认值：false。false表示不自动切换，true表示自动切换。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 在12小时制时，设置上午和下午的标识是否会根据小时数自动切换。<br>**起始版本：** 18 | 505| NODE_TEXT_PICKER_OPTION_RANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT_PICKER | 设置滑动选择文本选择器的选择列表，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：使用的选择器类型[ArkUI_TextPickerRangeType](capi-native-type-h.md#arkui_textpickerrangetype)，默认值为ARKUI_TEXTPICKER_RANGETYPE_SINGLE；<br> ?.string：针对不同选择器类型有如下输入范式：<br> 1：单列选择器，入参格式为用分号分隔的一组字符串；<br> 2：多列选择器，支持多对纯文本字符串对，多对之间使用分号分隔，每对内部使用逗号分隔；<br> ?.object：针对不同选择器类型有如下输入范式：<br> 1：单列支持图片的选择器，输入结构体为[ARKUI_TextPickerRangeContentArray](capi-arkui-nativemodule-arkui-textpickerrangecontentarray.md)；<br> 2：多列联动选择器，输入结构体为[ARKUI_TextCascadePickerRangeContentArray](capi-arkui-nativemodule-arkui-textcascadepickerrangecontentarray.md)；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：使用的选择器类型[ArkUI_TextPickerRangeType](capi-native-type-h.md#arkui_textpickerrangetype)；<br> ?.string：针对不同选择器类型有如下输出范式：<br> 1：单列选择器，输出格式为用分号分隔的一组字符串；<br> 2：多列选择器，输出多对纯文本字符串对，多对之间使用分号分隔，每对内部使用逗号分隔； | 506| NODE_TEXT_PICKER_OPTION_SELECTED | 设置滑动选择文本内容的组件默认选中项在数组中的索引值，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：索引值，如存在多个索引值则逐个添加。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：索引值，如存在多个索引值则逐个添加； | 507| NODE_TEXT_PICKER_OPTION_VALUE | 设置滑动选择文本内容的组件默认选中项的值，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string：选中项的值，如存在多个值则逐个添加，用分号分隔。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string：选中项的值，如存在多个值则逐个添加，用分号分隔； | 508| NODE_TEXT_PICKER_DISAPPEAR_TEXT_STYLE | 设置滑动选择文本内容的组件所有选项中最上和最下两个选项的文本颜色、字号、字体粗细，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 入参5个，格式为字符串，以 ';' 分割：<br> 入参1： 文本颜色，#argb类型<br> 入参2： 文本大小，数字类型，单位fp<br> 入参3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")<br> 入参4： 文本字体列表，使用 ',' 进行分割<br> 入参5： 文本样式，字符串枚举("normal", "italic")<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 参数5个，格式为字符串，以 ';' 分割：<br> 参数1： 文本颜色，#argb类型<br> 参数2： 文本大小，数字类型，单位fp<br> 参数3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")<br> 参数4： 文本字体列表，使用 ',' 进行分割<br> 参数5： 文本样式，字符串枚举("normal", "italic")<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。 | 509| NODE_TEXT_PICKER_TEXT_STYLE | 设置滑动选择文本内容的组件所有选项中除了最上、最下及选中项以外的文本颜色、字号、字体粗细，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 入参5个，格式为字符串，以 ';' 分割：<br> 入参1： 文本颜色，#argb类型。<br> 入参2： 文本大小，数字类型，单位fp。<br> 入参3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")。<br> 入参4： 文本字体列表，使用 ',' 进行分割。<br> 入参5： 文本样式，字符串枚举("normal", "italic")。<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 参数5个，格式为字符串，以 ';' 分割：<br> 参数1： 文本颜色，#argb类型。<br> 参数2： 文本大小，数字类型，单位fp。<br> 参数3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")。<br> 参数4： 文本字体列表，使用 ',' 进行分割。<br> 参数5： 文本样式，字符串枚举("normal", "italic")。<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。 | 510| NODE_TEXT_PICKER_SELECTED_TEXT_STYLE | 设置滑动选择文本内容的组件选中项的文本颜色、字号、字体粗细，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 入参5个，格式为字符串，以 ';' 分割：<br> 入参1： 文本颜色，#argb类型；<br> 入参2： 文本大小，数字类型，单位fp；<br> 入参3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")；<br> 入参4： 文本字体列表，使用 ',' 进行分割；<br> 入参5： 文本样式，字符串枚举("normal", "italic")；<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string： 参数5个，格式为字符串，以 ';' 分割：<br> 参数1： 文本颜色，#argb类型；<br> 参数2： 文本大小，数字类型，单位fp；<br> 参数3： 文本粗细，字符串枚举("bold", "normal", "bolder", "lighter", "medium", "regular")；<br> 参数4： 文本字体列表，使用 ',' 进行分割；<br> 参数5： 文本样式，字符串枚举("normal", "italic")；<br> 如 "#ff182431;14;normal;Arial,HarmonyOS Sans;normal" 。 | 511| NODE_TEXT_PICKER_SELECTED_INDEX | 设置滑动选择文本内容的组件默认选中项在数组中的索引值，支持属性设置，属性重置和属性获取接口。[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数类型：<br> .value[0...].i32：默认选中项在数组中的索引值数组。 | 512| NODE_TEXT_PICKER_CAN_LOOP | Picker组件可循环滚动属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：false表示不可循环，true表示可循环。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> value[0].i32：0表示不可循环，1表示可循环。 | 513| NODE_TEXT_PICKER_DEFAULT_PICKER_ITEM_HEIGHT | Picker各选择项的高度属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：子项高度属性，单位为vp。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> value[0].f32：子项高度属性，单位为vp。 | 514| NODE_TEXT_PICKER_ENABLE_HAPTIC_FEEDBACK = 15010 | 设置是否开启触控反馈。支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：是否开启触控反馈。默认值：true，true表示开启触控反馈，false则表示不开启触控反馈。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> value[0].f32：是否开启触控反馈。 <br> **起始版本：** 18 | 515| NODE_TEXT_PICKER_SELECTED_BACKGROUND_STYLE = 15011 | 设置选中项的背景颜色和边框圆角。支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：背景颜色，采用 0xARGB 格式，例如，<b>0xFF1122FF</b>。 <br> 1：.value[1].f32：四个角的圆角半径，单位为VP。 <br> 2：.value[1].f32：左上角的圆角半径，单位为VP。 <br> .value[2].f32：右上角的圆角半径，单位为VP。 <br> .value[3].f32：左下角的圆角半径，单位为VP。 <br> .value[4].f32：右下角的圆角半径，单位为VP。 <br> 默认值：背景颜色：0x0C182431；圆角半径：24.0。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：背景颜色，采用 0xARGB 格式，例如，<b>0xFF1122FF</b>。 <br> .value[1].f32：左上角的圆角半径，单位为VP。 <br> .value[2].f32：右上角的圆角半径，单位为VP。 <br> .value[3].f32：左下角的圆角半径，单位为VP。 <br> .value[4].f32：右下角的圆角半径，单位为VP。 <br>**起始版本：** 20 | 516| NODE_CALENDAR_PICKER_HINT_RADIUS = MAX_NODE_SCOPE_NUM * ARKUI_NODE_CALENDAR_PICKER | 设置日历选中态底板圆角半径的参数，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： 日历选中态底板圆角半径，取值范围[0,+∞)，其中取值为0表示底板样式为直角矩形；取值范围为(0, 16)时，底板样式为圆角矩形；取值范围为[16,+∞)时，底板样式为圆形。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： 日历选中态底板圆角半径，取值范围[0,+∞)，其中取值为0表示底板样式为直角矩形；取值范围为(0, 16)时，底板样式为圆角矩形；取值范围为[16,+∞)时，底板样式为圆形。 | 517| NODE_CALENDAR_PICKER_SELECTED_DATE | 设置日历选择选中日期的参数，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32： 选中的年。<br> .value[1].u32： 选中的月。<br> .value[2].u32： 选中的日。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32： 选中的年。<br> .value[1].u32： 选中的月。<br> .value[2].u32： 选中的日。 | 518| NODE_CALENDAR_PICKER_EDGE_ALIGNMENT | 设置日历选择器与入口组件的对齐方式，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 对齐方式类型，参数类型[ArkUI_CalendarAlignment](capi-native-type-h.md#arkui_calendaralignment)。<br> .value[1]?.f32： 按照对齐方式对齐后，选择器相对入口组件的x轴方向相对偏移。<br> .value[2]?.f32： 按照对齐方式对齐后，选择器相对入口组件的y轴方向相对偏移。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 对齐方式类型，参数类型[ArkUI_CalendarAlignment](capi-native-type-h.md#arkui_calendaralignment)。<br> .value[1].f32： 按照对齐方式对齐后，选择器相对入口组件的x轴方向相对偏移。<br> .value[2].f32： 按照对齐方式对齐后，选择器相对入口组件的y轴方向相对偏移。 | 519| NODE_CALENDAR_PICKER_TEXT_STYLE | 设置日历选择器入口区的文本颜色、字号、字体粗细。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0]?.u32： 入口区的文本颜色。<br> .value[1]?.f32： 入口区的文本字号，单位为fp。<br> .value[2]?.i32： 入口区的文本字体粗细，参数类型[ArkUI_FontWeight](capi-native-type-h.md#arkui_fontweight)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32： 入口区的文本颜色。<br> .value[1].f32： 入口区的文本字号，单位为fp。<br> .value[2].i32： 入口区的文本字体粗细，参数类型[ArkUI_FontWeight](capi-native-type-h.md#arkui_fontweight)。 | 520| NODE_CALENDAR_PICKER_START = 16004 | 设置日历选择器的开始日期，支持属性设置，属性重置和属性获取接口。设置属性时的参数格式为[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)：<br> .string: 日期。值的格式如 "1970-1-1"。 <br> 获取属性时的返回值格式为[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)：<br> .string: 日期。 <br>**起始版本：** 18 | 521| NODE_CALENDAR_PICKER_END = 16005 | 设置日历选择器的结束日期，支持属性设置，属性重置和属性获取接口。设置属性时的参数格式为[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)：<br> .string: 日期。值的格式如 "2100-12-31"。 <br> 获取属性时的返回值格式为[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)：<br> .string: 日期。 <br>**起始版本：** 18 | 522| NODE_CALENDAR_PICKER_DISABLED_DATE_RANGE = 16006 | 设置日历选择器的禁用日期区间，支持属性设置，属性重置和属性获取接口。设置属性时的参数格式为[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)：<br> .string: 禁用日期区间字符串。禁用日期区间："第一个区间开始日期,第一个区间结束日期,第二个区间开始日期,第二个区间结束日期,...,第n个区间开始日期,第n个区间结束日期"。<br> 设置的禁用日期区间格式："1910-01-01,1910-12-31,2020-01-01,2020-12-31"。<br> 获取属性时的返回值格式为[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)：<br> .string: 禁用日期区间字符串。<br>**起始版本：** 19 | 523| NODE_CALENDAR_PICKER_MARK_TODAY = 16007 | 设置日历选择器在系统当前日期时，是否保持高亮显示，支持属性设置，属性重置和属性获取接口。设置属性时的参数格式为[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)：<br> value[0].i32: 日历选择器在系统当前日期时，是否保持高亮显示，默认值：false。false表示不保持高亮显示，true表示保持高亮显示。<br> 获取属性时的返回值格式为[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)：<br> value[0].i32: 日历选择器在系统当前日期时，是否保持高亮显示。<br>**起始版本：** 19 | 524| NODE_SLIDER_BLOCK_COLOR = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SLIDER | Slider滑块的颜色，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].u32：滑块的颜色, 类型为0xargb，如0xFF1122FF。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：滑块的颜色, 类型为0xargb，如0xFF1122FF。 | 525| NODE_SLIDER_TRACK_COLOR | Slider滑轨的背景颜色，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].u32：背景颜色, 类型为0xargb，如0xFF1122FF。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：背景颜色, 类型为0xargb，如0xFF1122FF。 | 526| NODE_SLIDER_SELECTED_COLOR | Slider滑轨的已滑动部分颜色，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].u32：已滑动部分颜色, 类型为0xargb，如0xFF1122FF。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：已滑动部分颜色, 类型为0xargb，如0xFF1122FF。 | 527| NODE_SLIDER_SHOW_STEPS | 设置是否显示步长刻度值，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：是否显示步长刻度值，1表示显示，0表示不显示，默认值为0。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否显示步长刻度值，1表示显示，0表示不显示，默认值为0。 | 528| NODE_SLIDER_BLOCK_STYLE | Slider滑块形状参数，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：形状参数。参数类型[ArkUI_SliderBlockStyle](capi-native-type-h.md#arkui_sliderblockstyle)。<br> .string? 可选值，根据形状参数而定。<br> ARKUI_SLIDER_BLOCK_STYLE_IMAGE: 滑块图片资源。如/pages/common/icon.png。<br> ARKUI_SLIDER_BLOCK_STYLE_SHAPE: 滑块使用的自定义形状。<br> 共有5种类型： <br> 1.rect类型： <br> .value[1].i32：裁剪类型，参数类型[ArkUI_ShapeType](capi-native-type-h.md#arkui_shapetype)，ARKUI_SHAPE_TYPE_RECTANGLE； <br> .value[2].f32：矩形宽度； <br> .value[3].f32：矩形高度； <br> .value[4].f32：矩形圆角宽度； <br> .value[5].f32：矩形圆角高度； <br> 2.circle类型： <br> .value[1].i32：裁剪类型，参数类型[ArkUI_ShapeType](capi-native-type-h.md#arkui_shapetype)，ARKUI_SHAPE_TYPE_CIRCLE； <br> .value[2].f32：圆形宽度； <br> .value[3].f32：圆形高度； <br> 3.ellipse类型： <br> .value[1].i32：裁剪类型，参数类型[ArkUI_ShapeType](capi-native-type-h.md#arkui_shapetype)，ARKUI_SHAPE_TYPE_ELLIPSE； <br> .value[2].f32：椭圆形宽度； <br> .value[3].f32：椭圆形高度； <br> 4.path类型： <br> .value[1].i32：裁剪类型，参数类型[ArkUI_ShapeType](capi-native-type-h.md#arkui_shapetype)，ARKUI_SHAPE_TYPE_PATH； <br> .value[2].f32：路径宽度； <br> .value[3].f32：路径高度； <br> .string：路径绘制的命令字符串； <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：形状参数。参数类型[ArkUI_SliderBlockStyle](capi-native-type-h.md#arkui_sliderblockstyle)。<br> .string? 可选值，根据形状参数而定。<br> ARKUI_SLIDER_BLOCK_STYLE_IMAGE: 滑块图片资源。如/pages/common/icon.png。<br> ARKUI_SLIDER_BLOCK_STYLE_SHAPE: 滑块使用的自定义形状。<br> 共有5种类型： <br> 1.rect类型： <br> .value[1].i32：裁剪类型，参数类型[ArkUI_ShapeType](capi-native-type-h.md#arkui_shapetype)，ARKUI_SHAPE_TYPE_RECTANGLE； <br> .value[2].f32：矩形宽度； <br> .value[3].f32：矩形高度； <br> .value[4].f32：矩形圆角宽度； <br> .value[5].f32：矩形圆角高度； <br> 2.circle类型： <br> .value[1].i32：裁剪类型，参数类型[ArkUI_ShapeType](capi-native-type-h.md#arkui_shapetype)，ARKUI_SHAPE_TYPE_CIRCLE； <br> .value[2].f32：圆形宽度； <br> .value[3].f32：圆形高度； <br> 3.ellipse类型： <br> .value[1].i32：裁剪类型，参数类型[ArkUI_ShapeType](capi-native-type-h.md#arkui_shapetype)，ARKUI_SHAPE_TYPE_ELLIPSE； <br> .value[2].f32：椭圆形宽度； <br> .value[3].f32：椭圆形高度； <br> 4.path类型： <br> .value[1].i32：裁剪类型，参数类型[ArkUI_ShapeType](capi-native-type-h.md#arkui_shapetype)，ARKUI_SHAPE_TYPE_PATH； <br> .value[2].f32：路径宽度； <br> .value[3].f32：路径高度； <br> .string：路径绘制的命令字符串； | 529| NODE_SLIDER_VALUE | slider进度值，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].f32：进度值。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：进度值。 | 530| NODE_SLIDER_MIN_VALUE | slider最小值，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].f32：进度值的最小值。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：进度值的最小值。 | 531| NODE_SLIDER_MAX_VALUE | slider最大值，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].f32：进度值的最大值。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：进度值的最大值。 | 532| NODE_SLIDER_STEP | Slider滑动步长，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].f32：滑动步长，取值范围：[0.01, 100]。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：滑动步长，取值范围：[0.01, 100]。 | 533| NODE_SLIDER_DIRECTION | Slider滑动条滑动方向，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：显示样式，参数类型[ArkUI_SliderDirection](capi-native-type-h.md#arkui_sliderdirection)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：显示样式，参数类型[ArkUI_SliderDirection](capi-native-type-h.md#arkui_sliderdirection)。 | 534| NODE_SLIDER_REVERSE | Slider滑动条取值范围是否反向，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：是否反向，1表示反向，0表示不反向。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：是否反向，1表示反向，0表示不反向。 | 535| NODE_SLIDER_STYLE | Slider的滑块与滑轨显示样式，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：显示样式，参数类型[ArkUI_SliderStyle](capi-native-type-h.md#arkui_sliderstyle)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：显示样式，参数类型[ArkUI_SliderStyle](capi-native-type-h.md#arkui_sliderstyle)。 | 536| NODE_SLIDER_TRACK_THICKNESS | Slider滑块的滑轨粗细属性，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].f32：滑轨的粗细，单位为vp；当参数NODE_SLIDER_STYLE的值设置为ARKUI_SLIDER_STYLE_OUT_SET时为4.0vp，设置为ARKUI_SLIDER_STYLE_IN_SET时为20.0vp <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：滑轨的粗细，单位为vp； | 537| NODE_SLIDER_ENABLE_HAPTIC_FEEDBACK = 17013 | 设置是否开启触控反馈。支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：是否开启触控反馈。默认值：true，true表示开启触控反馈，false则表示不开启触控反馈。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> value[0].f32：是否开启触控反馈。 <br> 开启触控反馈时，需要在工程的module.json5的requestPermissions字段中增加"name": "ohos.permission.VIBRATE"，开启振动权限。<br>**起始版本：** 18 | 538| NODE_SLIDER_PREFIX | 在Slider组件的前端设置自定义组件。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .object: 参数类型 [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md)。前缀组件将放置在Slider组件的起始位置，通常在LTR布局的左侧。<br>**起始版本：** 20 | 539| NODE_SLIDER_SUFFIX | 在Slider组件的后端设置自定义组件。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .object: 参数类型 [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md)。后缀组件将放置在Slider组件的尾侧位置，通常在LTR布局的右侧。<br>**起始版本：** 20 | 540| NODE_RADIO_CHECKED = MAX_NODE_SCOPE_NUM * ARKUI_NODE_RADIO | 设置单选框的选中状态，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：单选框的选中状态，默认值false。值为true时，单选框被选中。值为false时，单选框不被选中。属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：单选框的选中状态。 | 541| NODE_RADIO_STYLE | 设置单选框选中状态和非选中状态的样式，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0]?.u32：开启状态底板颜色, 类型为0xargb，默认值为0xFF007DFF。<br> .value[1]?.u32：关闭状态描边颜色, 类型为0xargb，默认值为0xFF182431。<br> .value[2]?.u32：开启状态内部圆饼颜色, 类型为0xargb，默认值为0xFFFFFFFF。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32：开启状态底板颜色, 类型为0xargb，默认值为0xFF007DFF。<br> .value[1].u32：关闭状态描边颜色, 类型为0xargb，默认值为0xFF182431。<br> .value[2].u32：开启状态内部圆饼颜色, 类型为0xargb，默认值为0xFFFFFFF。 | 542| NODE_RADIO_VALUE | 设置当前单选框的值，支持属性设置、重置和获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .string: 单选框的值.<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string: 单选框的值. | 543| NODE_RADIO_GROUP | 设置当前单选框的所属群组名称，相同group的Radio只能有一个被选中，支持属性设置、重置和获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .string: 当前单选框的所属群组名称.<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string: 当前单选框的所属群组名称. | 544| NODE_CHECKBOX_GROUP_NAME = MAX_NODE_SCOPE_NUM * ARKUI_NODE_CHECKBOX_GROUP | 定义复选框组的名称, 支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .string: 组件名称。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .string: 组件名称。 <br>**起始版本：** 15 | 545| NODE_CHECKBOX_GROUP_SELECT_ALL | CheckBoxGroup多选框组是否全选, 支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32: 是否设置全选1表示选中，0表示不选中。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32: 1表示选中，0表示不选中。<br>**起始版本：** 15 | 546| NODE_CHECKBOX_GROUP_SELECTED_COLOR | CheckBoxGroup多选框选中状态颜色, 支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].u32: CheckBoxGroup多选框选中状态颜色, 0xARGB格式。例如0xFF1122FF。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32: CheckBoxGroup多选框选中状态颜色, 0xARGB格式。例如0xFF1122FF。<br>**起始版本：** 15 | 547| NODE_CHECKBOX_GROUP_UNSELECTED_COLOR | CheckBoxGroup多选框未选中边框颜色, 支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].u32: 边框颜色, 类型为0xargb，如0xFF1122FF。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32: 边框颜色, 类型为0xargb，如0xFF1122FF。<br>**起始版本：** 15 | 548| NODE_CHECKBOX_GROUP_MARK | CheckBoxGroup多选框内部图标样式, 支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].u32: 边框颜色, 类型为0xargb，如0xFF1122FF；<br> .value[1]?.f32: 可选，内部图标大小，单位vp；<br> .value[2]?.f32: 可选，内部图标粗细，单位vp，默认值2。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].u32: 边框颜色, 类型为0xargb，如0xFF1122FF；<br> .value[1]?.f32: 可选，内部图标大小，单位vp；<br> .value[2]?.f32: 可选，内部图标粗细，单位vp，默认值2。<br>**起始版本：** 15 | 549| NODE_CHECKBOX_GROUP_SHAPE | CheckBoxGroup组件形状, 支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32: 组件形状，参数类型[ArkUI_CheckboxShape](capi-native-type-h.md#arkui_checkboxshape)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32: 组件形状，参数类型[ArkUI_CheckboxShape](capi-native-type-h.md#arkui_checkboxshape)。<br>**起始版本：** 15 | 550| NODE_STACK_ALIGN_CONTENT = MAX_NODE_SCOPE_NUM * ARKUI_NODE_STACK | 设置子组件在容器内的对齐方式，支持属性设置，属性重置和属性获取接口。该属性与通用属性NODE_ALIGNMENT同时设置时，后设置的属性生效。<br> <br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 对齐方式，数据类型[ArkUI_Alignment](capi-native-type-h.md#arkui_alignment)，默认值ARKUI_ALIGNMENT_CENTER。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32： 对齐方式，数据类型[ArkUI_Alignment](capi-native-type-h.md#arkui_alignment)。 | 551| NODE_SCROLL_BAR_DISPLAY_MODE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SCROLL | 设置滚动条状态，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：滚动条状态，数据类型[ArkUI_ScrollBarDisplayMode](capi-native-type-h.md#arkui_scrollbardisplaymode)，List、Grid、Scroll组件默认值为ARKUI_SCROLL_BAR_DISPLAY_MODE_AUTO，WaterFlow组件默认值为ARKUI_SCROLL_BAR_DISPLAY_MODE_OFF。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：滚动条状态，数据类型[ArkUI_ScrollBarDisplayMode](capi-native-type-h.md#arkui_scrollbardisplaymode)。 | 552| NODE_SCROLL_BAR_WIDTH | 设置滚动条的宽度，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：滚动条宽度，单位vp，默认值4。<br>取值范围：设置为小于0的值时，按默认值处理。设置为0时，不显示滚动条。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：滚动条宽度，单位vp。 | 553| NODE_SCROLL_BAR_COLOR | 设置滚动条的颜色，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .data[0].u32：滚动条颜色，0xargb类型。默认值：0x66182431<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .data[0].u32：滚动条颜色，0xargb类型。 | 554| NODE_SCROLL_SCROLL_DIRECTION | 设置滚动方向，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：滚动方向，数据类型[ArkUI_ScrollDirection](capi-native-type-h.md#arkui_scrolldirection)，默认值ARKUI_SCROLL_DIRECTION_VERTICAL。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：滚动方向，数据类型[ArkUI_ScrollDirection](capi-native-type-h.md#arkui_scrolldirection)。 | 555| NODE_SCROLL_EDGE_EFFECT | 设置边缘滑动效果，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：边缘滑动效果，参数类型[ArkUI_EdgeEffect](capi-native-type-h.md#arkui_edgeeffect)，Grid、Scroll、WaterFlow组件默认值为ARKUI_EDGE_EFFECT_NONE，List组件默认值为ARKUI_EDGE_EFFECT_SPRING；<br> .value[1]?.i32：可选值，组件内容大小小于组件自身时，设置是否开启滑动效果，开启为1，关闭为0，List、Grid、WaterFlow组件默认值为0，Scroll组件默认值为1；<br> .value[2]?.i32：边缘效果生效的方向，参数类型[ArkUI_EffectEdge](capi-native-type-h.md#arkui_effectedge)，默认值ARKUI_EFFECT_EDGE_START \| ARKUI_EFFECT_EDGE_END。<br> 该参数从API version 18开始支持。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：边缘滑动效果，参数类型[ArkUI_EdgeEffect](capi-native-type-h.md#arkui_edgeeffect)；<br> .value[1].i32：组件内容大小小于组件自身时，设置是否开启滑动效果，开启为1，关闭为0；<br> .value[2].i32：边缘效果生效的方向，参数类型[ArkUI_EffectEdge](capi-native-type-h.md#arkui_effectedge)。该参数从API version 18开始支持。 | 556| NODE_SCROLL_ENABLE_SCROLL_INTERACTION | 设置是否支持滚动手势，当设置为0时，无法通过手指或者鼠标滚动，但不影响控制器的滚动接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否支持滚动手势，默认值1。1：支持滚动手势，0：不支持滚动手势。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否支持滚动手势。| 557| NODE_SCROLL_FRICTION | 设置摩擦系数，手动划动滚动区域时生效，只对惯性滚动过程有影响，对惯性滚动过程中的链式效果有间接影响。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：摩擦系数，默认值：非可穿戴设备为0.6，可穿戴设备为0.9。取值范围：(0, +∞)，设置为小于等于0的值时，按默认值处理。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：摩擦系数。| 558| NODE_SCROLL_SNAP | 设置Scroll组件的限位滚动模式，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：Scroll组件限位滚动时的对其方式，数据类型[ArkUI_ScrollSnapAlign](capi-native-type-h.md#arkui_scrollsnapalign)，默认值ARKUI_SCROLL_SNAP_ALIGN_NONE；<br> .value[1].i32：在Scroll组件限位滚动模式下，该属性设置为false后，运行Scroll在开头和第一个限位点间自由滑动。默认值true，仅在限位点为多个时生效；<br> .value[2].i32：在Scroll组件限位滚动模式下，该属性设置为false后，运行Scroll在最后一个限位点和末尾间自由滑动。默认值true，仅在限位点为多个时生效；<br> .value[3...].f32：Scroll组件限位滚动时的限位点，限位点即为Scroll组件能滑动停靠的偏移量。可以1个或多个。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：Scroll组件限位滚动时的对其方式，数据类型[ArkUI_ScrollSnapAlign](capi-native-type-h.md#arkui_scrollsnapalign)；<br> .value[1].i32： 在Scroll组件限位滚动模式下，该属性设置为false后，运行Scroll在开头和第一个限位点间自由滑动；<br> .value[2].i32：在Scroll组件限位滚动模式下，该属性设置为false后，运行Scroll在最后一个限位点和末尾间自由滑动；<br> .value[3...].f32：Scroll组件限位滚动时的限位点，限位点即为Scroll组件能滑动停靠的偏移量。 | 559| NODE_SCROLL_NESTED_SCROLL | Scroll嵌套滚动选项，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .value[0].i32：可滚动组件往末尾端滚动时的嵌套滚动，参数类型[ArkUI_ScrollNestedMode](capi-native-type-h.md#arkui_scrollnestedmode)。<br> .value[1].i32：可滚动组件往起始端滚动时的嵌套滚动，参数类型[ArkUI_ScrollNestedMode](capi-native-type-h.md#arkui_scrollnestedmode)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：可滚动组件往末尾端滚动时的嵌套滚动，参数类型[ArkUI_ScrollNestedMode](capi-native-type-h.md#arkui_scrollnestedmode)。<br> .value[1].i32：可滚动组件往起始端滚动时的嵌套滚动，参数类型[ArkUI_ScrollNestedMode](capi-native-type-h.md#arkui_scrollnestedmode)。 | 560| NODE_SCROLL_OFFSET | Scroll滑动到指定位置，支持属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].f32：水平滑动偏移，单位为vp。<br> .value[1].f32：垂直滑动偏移，单位为vp。<br> .value[2]?.i32：可选值，滚动时长，单位为毫秒，默认值1000。<br> .value[3]?.i32：可选值，滚动曲线，参数类型[ArkUI_AnimationCurve](capi-native-type-h.md#arkui_animationcurve)。默认值为ARKUI_CURVE_EASE。<br> .value[4]?.i32：可选值，是否使能默认弹簧动效，默认值为0不使能。 <br> .value[5]?.i32：可选值，设置动画滚动到边界是否转换为越界回弹动画，默认值为0不转换越界回弹动画。 <br> .value[6]?.i32：可选值，设置滚动是否可以停留在越界位置，默认值为0不停留在越界位置。该参数从API version 20开始支持。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：水平滑动偏移，单位为vp。<br> .value[1].f32：垂直滑动偏移，单位为vp。 | 561| NODE_SCROLL_EDGE | Scroll滚动到容器边缘位置，支持属性设置，属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .value[0].i32：容器边缘位置，参数类型[ArkUI_ScrollEdge](capi-native-type-h.md#arkui_scrolledge)。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：容器是否位于边缘，-1：表示未处于边缘，如果处于边缘状态参数类型[ArkUI_ScrollEdge](capi-native-type-h.md#arkui_scrolledge)。| 562| NODE_SCROLL_ENABLE_PAGING | 设置是否支持滑动翻页，支持属性设置，属性重置和属性获取接口。如果同时设置了划动翻页enablePaging和限位滚动scrollSnap，则scrollSnap优先生效，enablePaging不生效。<br> <br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否支持划动翻页，默认值0。0：不支持划动翻页，1：支持划动翻页。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否支持划动翻页。 | 563| NODE_SCROLL_PAGE | 滚动到下一页或者上一页。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 是否向下翻页。0表示向下翻页，1表示向上翻页。<br> .value[1]?.i32 是否开启翻页动画效果。1有动画，0无动画。默认值：0。 | 564| NODE_SCROLL_BY | 滑动指定距离。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：水平方向滚动距离，默认单位为vp; <br> .value[1].f32：竖直方向滚动距离，默认单位为vp。 | 565| NODE_SCROLL_FLING | 滚动类组件按传入的初始速度进行惯性滚动。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：惯性滚动的初始速度，默认单位为vp/s。值设置为0，视为异常值，本次滚动不生效。如果值为正数，则向下滚动；如果值为负数，则向上滚动。 <br>**起始版本：** 13 | 566| NODE_SCROLL_FADING_EDGE | 设置滚动类组件边缘渐隐效果。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否使能边缘渐隐效果。0表示关闭边缘效果，1表示开启边缘效果，默认值0。 <br> .value[1]?.f32：边缘渐隐效果长度。单位：vp，默认值：32。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否使能边缘渐隐效果。0表示关闭边缘效果，1表示开启边缘效果。 <br> .value[1].f32：边缘渐隐效果长度。单位：vp。 <br>**起始版本：** 14 | 567| NODE_SCROLL_SIZE | 获取滚动类组件所有子组件全展开尺寸。属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：滚动类组件所有子组件全展开的宽度，默认单位为vp。<br> .value[1].f32：滚动类组件所有子组件全展开的高度，默认单位为vp。<br> 设置NODE_PADDING、NODE_MARGIN或NODE_BORDER_WIDTH后，NODE_PADDING、NODE_MARGIN或NODE_BORDER_WIDTH在单位vp转换成单位px时会进行像素取整，返回值根据取整后的值计算。<br>**起始版本：** 14 | 568| NODE_SCROLL_CONTENT_START_OFFSET | 设置取滚动类组件内容起始端偏移量。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： 内容起始端偏移量，单位vp；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： 内容起始端偏移量，单位vp；<br>**起始版本：** 15 | 569| NODE_SCROLL_CONTENT_END_OFFSET | 设置取滚动类组件内容末尾端偏移量。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： 内容末尾端偏移量，单位vp；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32： 内容末尾端偏移量，单位vp；<br>**起始版本：** 15 | 570| NODE_SCROLL_FLING_SPEED_LIMIT = 1002019 | 限制跟手滑动结束后，Fling动效开始时的最大初始速度。支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：Fling动效开始时的最大初始速度，单位：vp/s。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：Fling动效开始时的最大初始速度。 <br>**起始版本：** 18 | 571| NODE_SCROLL_CLIP_CONTENT = 1002020 | 设置滚动容器的内容层裁剪区域。支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：内容裁剪模式，参数类型[ArkUI_ContentClipMode](capi-native-type-h.md#arkui_contentclipmode)。Grid、Scroll组件默认值为ARKUI_SCROLL_BAR_DISPLAY_MODE_AUTO，List、WaterFlow组件默认值为ARKUI_SCROLL_BAR_DISPLAY_MODE_OFF。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：内容裁剪模式，参数类型[ArkUI_ContentClipMode](capi-native-type-h.md#arkui_contentclipmode)。 <br>**起始版本：** 18 | 572| NODE_SCROLL_BACK_TO_TOP = 1002021 | 设置滚动容器是否在点击状态栏时回到顶部。支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否回到顶部，1表示回到顶部，0表示保持当前位置不变，默认值：API version 18之前：0。API version 18及以后：滚动方向是水平方向时为0，是垂直方向时为1。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否回到顶部。 <br>**起始版本：** 15 | 573| NODE_SCROLL_BAR_MARGIN = 1002022 | 设置滚动条的边距，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：设置滚动条起始边距，默认值为0，单位：vp。 <br> .value[1].f32：设置滚动条末尾边距，默认值为0，单位：vp。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：滚动条起始边距，单位：vp。 <br> .value[1].f32：滚动条末尾边距，单位：vp。 <br>**起始版本：** 20 | 574| NODE_SCROLL_MAX_ZOOM_SCALE = 1002023 | 设置滚动内容最大缩放比例。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：设置内容最大缩放比例。默认值：1<br>取值范围：(0, +∞)，小于或等于0时按默认值1处理。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：获取内容最大缩放比例。 <br>**起始版本：** 20 | 575| NODE_SCROLL_MIN_ZOOM_SCALE = 1002024 | 设置滚动内容最小缩放比例。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：设置内容最小缩放比例，默认值：1<br>取值范围：(0, NODE_SCROLL_MAX_ZOOM_SCALE]，小于或等于0时按默认值1处理，大于NODE_SCROLL_MAX_ZOOM_SCALE时按NODE_SCROLL_MAX_ZOOM_SCALE处理。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：获取内容最小缩放比例。 <br>**起始版本：** 20 | 576| NODE_SCROLL_ZOOM_SCALE = 1002025 | 设置滚动内容缩放比例。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：设置内容缩放比例，默认值：1<br>取值范围：(0, +∞)，小于或等于0时按默认值1处理。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：获取内容缩放比例。 <br>**起始版本：** 20 | 577| NODE_SCROLL_ENABLE_BOUNCES_ZOOM = 1002026 | 设置是否支持过缩放回弹效果。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否支持过缩放回弹效果，0：不支持，1：支持。默认值：1 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否支持过缩放回弹效果，0：不支持，1：支持。 <br>**起始版本：** 20 | 578| NODE_LIST_DIRECTION = MAX_NODE_SCOPE_NUM * ARKUI_NODE_LIST | 设置List组件排列方向。支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：List组件排列方向，数据类型[ArkUI_Axis](capi-native-type-h.md#arkui_axis)，默认值ARKUI_AXIS_VERTICAL。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：List组件排列方向，数据类型[ArkUI_Axis](capi-native-type-h.md#arkui_axis)。 | 579| NODE_LIST_STICKY | 配合ListItemGroup组件使用，设置ListItemGroup中header和footer是否要吸顶或吸底，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：配合ListItemGroup组件使用，设置ListItemGroup中header和footer是否要吸顶或吸底。数据类型[ArkUI_StickyStyle](capi-native-type-h.md#arkui_stickystyle)，默认值ARKUI_STICKY_STYLE_NONE。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：配合ListItemGroup组件使用，设置ListItemGroup中header和footer是否要吸顶或吸底。数据类型[ArkUI_StickyStyle](capi-native-type-h.md#arkui_stickystyle)。 | 580| NODE_LIST_SPACE | 设置列表项间距，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：子组件主轴方向的间隔。默认值0。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：子组件主轴方向的间隔。 | 581| NODE_LIST_NODE_ADAPTER | list组件适配器，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：使用[ArkUI_NodeAdapter](capi-arkui-nativemodule-arkui-nodeadapter8h.md)对象作为适配器。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：返回值格式为[ArkUI_NodeAdapter](capi-arkui-nativemodule-arkui-nodeadapter8h.md)。| 582| NODE_LIST_CACHED_COUNT | list组件Adapter缓存数量，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：配合List组件Adapter使用，设置adapter中的缓存数量<br> .value[1]?.i32：是否显示缓存节点，0：不显示，1：显示，默认值：0。该参数从API version 15开始支持。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：adapter中的缓存数量。<br> .value[1].i32：是否显示缓存节点，0：不显示，1：显示。该参数从API version 15开始支持。 | 583| NODE_LIST_SCROLL_TO_INDEX | 滑动到指定index。开启smooth动效时，会对经过的所有item进行加载和布局计算，当大量加载item时会导致性能问题。<br> <br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：要滑动到的目标元素在当前容器中的索引值。<br> .value[1]?.i32：设置滑动到列表项在列表中的索引值时是否有动效，1表示有动效，0表示没有动效。默认值：0。<br> .value[2]?.i32：指定滑动到的元素与当前容器的对齐方式，参数类型[ArkUI_ScrollAlignment](capi-native-type-h.md#arkui_scrollalignment), 默认值：ARKUI_SCROLL_ALIGNMENT_START。<br> .value[3]?.i32：额外偏移量，默认值：0，单位：vp。该参数从API version 16开始支持。 | 584| NODE_LIST_ALIGN_LIST_ITEM | 设置List交叉轴方向宽度大于ListItem交叉轴宽度 * lanes时，ListItem在List交叉轴方向的布局方式，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：交叉轴方向的布局方式。参数类型[ArkUI_ListItemAlign](capi-native-type-h.md#arkui_listitemalignment)。默认值：ARKUI_LIST_ITEM_ALIGNMENT_START <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：交叉轴方向的布局方式。参数类型[ArkUI_ListItemAlign](capi-native-type-h.md#arkui_listitemalignment)。 | 585| NODE_LIST_CHILDREN_MAIN_SIZE = 1003007 | 设置List子组件默认主轴尺寸。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> object：参数格式为[ArkUI_ListChildrenMainSize](capi-arkui-nativemodule-arkui-listchildrenmainsize.md)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：参数格式为[ArkUI_ListChildrenMainSize](capi-arkui-nativemodule-arkui-listchildrenmainsize.md)。 | 586| NODE_LIST_INITIAL_INDEX = 1003008 | 设置当前List初次加载时视口起始位置显示的item的索引值，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：当前List初次加载时视口起始位置显示的item的索引值。默认值：0 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：当前List初次加载时视口起始位置显示的item的索引值。| 587| NODE_LIST_DIVIDER = 1003009 | 设置ListItem分割线样式，默认无分割线，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：分割线颜色，0xargb类型，默认值为0x08000000；<br> .value[1].f32：分割线宽，单位vp；<br> .value[2].f32：分割线距离列表侧边起始端的距离，默认值：0，单位vp；<br> .value[3].f32：分割线距离列表侧边结束端的距离，默认值：0，单位vp。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：分割线颜色，0xargb类型；<br> .value[1].f32：分割线宽；<br> .value[2].f32：分割线距离列表侧边起始端的距离，单位vp；<br> .value[3].f32： 分割线距离列表侧边结束端的距离，单位vp。 | 588| NODE_LIST_SCROLL_TO_INDEX_IN_GROUP = 1003010 | 滑动到指定ListItemGroup中指定index。开启smooth动效时，会对经过的所有item进行加载和布局计算，当大量加载item时会导致性能问题。<br> <br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：要滑动到的目标ListItemGroup在当前List中的索引值。<br> .value[1].i32：要滑动到的目标ListItem在ListItemGroup中的索引值。<br> .value[2]?.i32：设置滑动到列表项在列表中的索引值时是否有动效，1表示有动效，0表示没有动效。默认值：0<br> .value[3]?.i32：指定滑动到的元素与当前容器的对齐方式，参数类型[ArkUI_ScrollAlignment](capi-native-type-h.md#arkui_scrollalignment)。默认值：ARKUI_SCROLL_ALIGNMENT_START<br>**起始版本：** 15 | 589| NODE_LIST_LANES = 1003011 | 设置List列数，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：List列数，如果设置了最大最小列宽，则设置列数不生效；默认值：1，取值范围：[1, +∞)<br> .value[1]?.f32：最小列宽，单位vp；<br> .value[2]?.f32：最大列宽，单位vp；<br> .value[3]?.f32：列间距，默认值：0，单位vp；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：当前List列数；<br> .value[1].f32： 最小列宽，单位vp；<br> .value[2].f32： 最小列宽，单位vp；<br> .value[3].f32： 列间距，单位vp。<br>**起始版本：** 15 | 590| NODE_LIST_SCROLL_SNAP_ALIGN = 1003012 | 设置List限位对齐模式。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：List组件限位滚动时的对其方式，数据类型[ArkUI_ScrollSnapAlign](capi-native-type-h.md#arkui_scrollsnapalign)，默认值ARKUI_SCROLL_SNAP_ALIGN_NONE；<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：List组件限位滚动时的对其方式，数据类型[ArkUI_ScrollSnapAlign](capi-native-type-h.md#arkui_scrollsnapalign)；<br>**起始版本：** 15 | 591| NODE_LIST_MAINTAIN_VISIBLE_CONTENT_POSITION = 1003013 | 设置List显示区域外插入或删除数据是否保持可见内容位置不变。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：List显示区域外插入或删除数据是否保持可见内容位置不变。0表示不保持可见内容位置，1表示保持可见内容位置，默认值为0。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：List显示区域外插入或删除数据是否保持可见内容位置不变。0表示不保持可见内容位置，1表示保持可见内容位置，默认值为0。 <br>**起始版本：** 15 | 592| NODE_LIST_STACK_FROM_END = 1003014 | 设置List从末尾开始布局。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：设置List是否从末尾开始布局。0表示从顶部开始布局，1表示从末尾开始布局，默认值为0。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：设置List是否从末尾开始布局。0表示从顶部开始布局，1表示从末尾开始布局，默认值为0。<br>**起始版本：** 19 | 593| NODE_LIST_FOCUS_WRAP_MODE = 1003015 | List组件走焦换行模式，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：List组件走焦换行模式，参数类型[ArkUI_FocusWrapMode](capi-native-type-h.md#arkui_focuswrapmode)。默认值：ARKUI_FOCUS_WRAP_MODE_DEFAULT<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32:List组件走焦换行模式，参数类型[ArkUI_FocusWrapMode](capi-native-type-h.md#arkui_focuswrapmode)。<br>**起始版本：** 20 | 594| NODE_LIST_SYNC_LOAD = 1003016 | List组件是否同步加载子节点，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：List组件是否同步加载子节点。0：分帧加载，1：同步加载，默认值为1。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：List组件是否同步加载子节点。0：分帧加载，1：同步加载。<br>**起始版本：** 20 | 595| NODE_SWIPER_LOOP = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SWIPER | Swiper是否开启循环，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：控制是否开启循环，0表示不循环，1表示循环，默认值为1。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：控制是否开启循环，0表示不循环，1表示循环，默认值为1。 | 596| NODE_SWIPER_AUTO_PLAY | Swiper子组件是否自动播放，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：控制子组件是否自动播放，0表示不自动播放，1表示自动播放，默认值为0。 <br> .value[1]?.i32：手指按下是否停止自动播放，0表示停止，1表示不停止，默认值为0。该参数从API version 16开始支持。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：控制子组件是否自动播放，0表示不自动播放，1表示自动播放，默认值为0。 <br> .value[1].i32：手指按下是否停止自动播放，0表示停止，1表示不停止。该参数从API version 16开始支持。 | 597| NODE_SWIPER_SHOW_INDICATOR | Swiper是否显示导航点指示器，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：是否显示导航点指示器，0表示不显示导航点指示器，1表示显示导航点指示器，默认值为1。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：是否显示导航点指示器，0表示不显示导航点指示器，1表示显示导航点指示器，默认值为1。 | 598| NODE_SWIPER_INTERVAL | 设置Swiper自动播放时播放的时间间隔，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：使用自动播放时播放的时间间隔，单位为毫秒。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：使用自动播放时播放的时间间隔，单位为毫秒。 | 599| NODE_SWIPER_VERTICAL | 设置Swiper是否为纵向滑动，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：是否为纵向滑动，0表示横向滑动，1表示纵向滑动，默认值为0。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：是否为纵向滑动，0表示横向滑动，1表示纵向滑动，默认值为0。 | 600| NODE_SWIPER_DURATION | 设置Swiper子组件切换的动画时长，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：子组件切换的动画时长，单位为毫秒, 默认值为400。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：子组件切换的动画时长，单位为毫秒, 默认值为400。 | 601| NODE_SWIPER_CURVE | 设置Swiper的动画曲线，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：设置动画曲线参数，参数类型[ArkUI_AnimationCurve](capi-native-type-h.md#arkui_animationcurve)，默认值为ARKUI_CURVE_LINEAR。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：设置动画曲线参数，参数类型[ArkUI_AnimationCurve](capi-native-type-h.md#arkui_animationcurve)，默认值为ARKUI_CURVE_LINEAR。 | 602| NODE_SWIPER_ITEM_SPACE | 设置Swiper子组件与子组件之间间隙，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：子组件与子组件之间间隙数值。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：子组件与子组件之间间隙数值。 | 603| NODE_SWIPER_INDEX | 设置Swiper当前在容器中显示的子组件的索引值，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：子组件的索引值。 <br> .value[1]?.i32：跳转动画模式，参数类型[ArkUI_SwiperAnimationMode](capi-native-type-h.md#arkui_swiperanimationmode)。仅当次调用有效。 <br> 该参数从API version 15开始支持。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：子组件的索引值。 | 604| NODE_SWIPER_DISPLAY_COUNT | 设置Swiper一页内元素显示个数，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：视窗内显示的子元素个数。 <br> .value[1]?.i32：是否按组翻页，0：按子元素翻页，1：视窗内显示的子元素按组翻页，默认值：0。 <br> .string?: 此参数只能设置为“auto”。当设置为“auto”时，value[] 参数将被忽略。 <br> 该参数从API version 19开始支持。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：视窗内显示的子元素个数。 <br> .value[1].i32：是否按组翻页。该参数从API version 19开始支持。 | 605| NODE_SWIPER_DISABLE_SWIPE | 设置Swiper禁用组件滑动切换功能，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：是否禁用组件滑动切换功能，0表示不禁用滑动切换功能，1表示禁用滑动切换功能，默认值为0。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：是否禁用组件滑动切换功能，0表示不禁用滑动切换功能，1表示禁用滑动切换功能，默认值为0。 | 606| NODE_SWIPER_SHOW_DISPLAY_ARROW | 设置Swiper是否显示导航点箭头，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：设置是否显示导航点箭头，参数类型[ArkUI_SwiperArrow](capi-native-type-h.md#arkui_swiperarrow)，默认值为ARKUI_SWIPER_ARROW_HIDE。 <br> .?object：显示导航箭头时设置箭头样式，参数类型为[ArkUI_SwiperArrowStyle](capi-arkui-nativemodule-arkui-swiperarrowstyle.md)。该参数从API version 19开始支持。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：设置是否显示导航点箭头，参数类型[ArkUI_SwiperArrow](capi-native-type-h.md#arkui_swiperarrow)， <br> .object：箭头样式，参数类型为[ArkUI_SwiperArrowStyle](capi-arkui-nativemodule-arkui-swiperarrowstyle.md)。该参数从API version 19开始支持。 | 607| NODE_SWIPER_EDGE_EFFECT_MODE | 设置Swiper的边缘滑动效果，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32: 边缘滑动效果，参数类型[ArkUI_EdgeEffect](capi-native-type-h.md#arkui_edgeeffect)， <br> 默认值为ARKUI_EDGE_EFFECT_SPRING。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32: 边缘滑动效果，参数类型[ArkUI_EdgeEffect](capi-native-type-h.md#arkui_edgeeffect)， | 608| NODE_SWIPER_NODE_ADAPTER | swiper组件适配器，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：使用[ArkUI_NodeAdapter](capi-arkui-nativemodule-arkui-nodeadapter8h.md)对象作为适配器。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .object：返回值格式为[ArkUI_NodeAdapter](capi-arkui-nativemodule-arkui-nodeadapter8h.md)。| 609| NODE_SWIPER_CACHED_COUNT | swiper组件Adapter缓存数量，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：配合swiper组件Adapter使用，设置adapter中的缓存数量<br> .value[1]?.i32：是否显示缓存节点，0：不显示，1：显示，默认值：0。该参数从API version 19开始支持。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：adapter中的缓存数量。 <br> .value[1].i32：是否显示缓存节点，0：不显示，1：显示。该参数从API version 19开始支持。 | 610| NODE_SWIPER_PREV_MARGIN | 设置 Swiper 组件的前边距，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：前边距数值，单位为vp，默认值为0。 <br> .value[1]?.i32：是否忽略空白，1表示忽略空白，0表示不忽略空白。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：前边距数值，单位为vp。.value[1].i32：是否忽略空白，1表示忽略空白，0表示不忽略空白。 | 611| NODE_SWIPER_NEXT_MARGIN | 设置 Swiper 组件的后边距，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：后边距数值，单位为vp，默认值为0。 <br> .value[1]?.i32：是否忽略空白，1表示忽略空白，0表示不忽略空白。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：后边距数值，单位为vp。.value[1].i32：是否忽略空白，1表示忽略空白，0表示不忽略空白。 | 612| NODE_SWIPER_INDICATOR | 设置 Swiper 组件的导航指示器类型，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：设置导航指示器的类型，参数类型[ArkUI_SwiperIndicatorType](capi-native-type-h.md#arkui_swiperindicatortype)。 <br> .object：导航指示器的类型为ARKUI_SWIPER_INDICATOR_TYPE_DOT时参数类型为[ArkUI_SwiperIndicator](capi-arkui-nativemodule-arkui-swiperindicator.md)。 <br> 导航指示器的类型为ARKUI_SWIPER_INDICATOR_TYPE_DIGIT时参数类型为[ArkUI_SwiperDigitIndicator](capi-arkui-nativemodule-arkui-swiperdigitindicator.md)。 <br> ArkUI_SwiperDigitIndicator类型从API version 19开始支持属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：导航指示器的类型，参数类型[ArkUI_SwiperIndicatorType](capi-native-type-h.md#arkui_swiperindicatortype)。 <br> .object：导航指示器的类型为ARKUI_SWIPER_INDICATOR_TYPE_DOT时参数类型为[ArkUI_SwiperIndicator](capi-arkui-nativemodule-arkui-swiperindicator.md)。 <br> 导航指示器的类型为ARKUI_SWIPER_INDICATOR_TYPE_DIGIT时参数类型为[ArkUI_SwiperDigitIndicator](capi-arkui-nativemodule-arkui-swiperdigitindicator.md)。 <br> ArkUI_SwiperDigitIndicator类型从API version 19开始支持 | 613| NODE_SWIPER_NESTED_SCROLL | 设置Swiper组件和父组件的嵌套滚动模式。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：Swiper组件和父组件的嵌套滚动模式，参数类型[ArkUI_SwiperNestedScrollMode](capi-native-type-h.md#arkui_swipernestedscrollmode) <br> 默认值为：ARKUI_SWIPER_NESTED_SRCOLL_SELF_ONLY <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：Swiper组件和父组件的嵌套滚动模式，参数类型[ArkUI_SwiperNestedScrollMode](capi-native-type-h.md#arkui_swipernestedscrollmode) | 614| NODE_SWIPER_SWIPE_TO_INDEX | 设置swiper组件翻至指定页面。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：指定页面在Swiper中的索引值。<br> .value[1]?.i32：设置翻至指定页面时是否有动效。1表示有动效，0表示没有动效, 默认值：0。 | 615| NODE_SWIPER_INDICATOR_INTERACTIVE | 设置禁用组件导航点交互功能。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：设置禁用组件导航点交互功能，设置为true时表示导航点可交互，默认值true。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：设置禁用组件导航点交互功能。 | 616| NODE_SWIPER_PAGE_FLIP_MODE | 设置组件鼠标滚轮翻页模式。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：设置组件鼠标滚轮翻页模式，参数类型[ArkUI_PageFlipMode](capi-native-type-h.md#arkui_pageflipmode)。<br> 属性获取方法返回值[ArkUI_PageFlipMode](capi-native-type-h.md#arkui_pageflipmode)格式： <br> .value[0].i32：鼠标滚轮翻页模式。 <br>**起始版本：** 15 | 617| NODE_SWIPER_AUTO_FILL | 设置Swiper一页内元素显示个数根据元素最小宽度自适应，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：元素显示最小宽度，单位：vp。 <br> .value[1]?.i32：是否按组翻页，0：按子元素翻页，1：视窗内显示的子元素按组翻页，默认值：0 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].f32：元素显示最小宽度，单位：vp。 <br> .value[1].i32：是否按组翻页。 <br>**起始版本：** 19 | 618| NODE_SWIPER_MAINTAIN_VISIBLE_CONTENT_POSITION = 1001023 | 设置Swiper显示区域外插入或删除数据是否保持可见内容位置不变。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：Swiper显示区域外插入或删除数据是否保持可见内容位置不变。0表示不保持可见内容位置，1表示保持可见内容位置，默认值为0。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：Swiper显示区域外插入或删除数据是否保持可见内容位置不变。0表示不保持可见内容位置，1表示保持可见内容位置，默认值为0。 <br>**起始版本：** 20 | 619| NODE_LIST_ITEM_SWIPE_ACTION = MAX_NODE_SCOPE_NUM * ARKUI_NODE_LIST_ITEM | 设置ListItem的划出组件，支持属性设置，属性重置，属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：使用[ArkUI_ListItemSwipeActionOption](capi-arkui-nativemodule-arkui-listitemswipeactionoption.md)对象构造。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：使用[ArkUI_ListItemSwipeActionOption](capi-arkui-nativemodule-arkui-listitemswipeactionoption.md)对象构造。 | 620| NODE_LIST_ITEM_GROUP_SET_HEADER = MAX_NODE_SCOPE_NUM * ARKUI_NODE_LIST_ITEM_GROUP | 设置 ListItemGroup 头部组件，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：使用[ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md)对象作为ListItemGroup头部组件。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：使用[ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md)对象作为ListItemGroup头部组件。 | 621| NODE_LIST_ITEM_GROUP_SET_FOOTER | 设置 ListItemGroup 尾部组件，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：使用[ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md)对象作为ListItemGroup尾部组件。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：使用[ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md)对象作为ListItemGroup尾部组件。| 622| NODE_LIST_ITEM_GROUP_SET_DIVIDER | 设置ListItem分割线样式，默认无分割线，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：颜色，0xargb类型，默认值为0x08000000；<br> .value[1].f32：分割线宽，单位vp；<br> .value[2].f32：分割线距离列表侧边起始端的距离，默认值：0，单位vp；<br> .value[3].f32：分割线距离列表侧边结束端的距离，默认值：0，单位vp。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].u32：颜色，0xargb类型；<br> .value[1].f32：分割线宽，单位vp；<br> .value[2].f32：分割线距离列表侧边起始端的距离，单位vp；<br> .value[3].f32：分割线距离列表侧边结束端的距离，单位vp。 | 623| NODE_LIST_ITEM_GROUP_CHILDREN_MAIN_SIZE = 1005003 | 设置ListItemGroup子组件默认主轴尺寸。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> object：参数格式为[ArkUI_ListChildrenMainSize](capi-arkui-nativemodule-arkui-listchildrenmainsize.md)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：参数格式为[ArkUI_ListChildrenMainSize](capi-arkui-nativemodule-arkui-listchildrenmainsize.md)。| 624| NODE_LIST_ITEM_GROUP_NODE_ADAPTER = 1005004 | ListItemGroup组件适配器，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：使用[ArkUI_NodeAdapter](capi-arkui-nativemodule-arkui-nodeadapter8h.md)对象作为适配器。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：返回值格式为[ArkUI_NodeAdapter](capi-arkui-nativemodule-arkui-nodeadapter8h.md)。 <br>**起始版本：** 15 | 625| NODE_COLUMN_ALIGN_ITEMS = MAX_NODE_SCOPE_NUM * ARKUI_NODE_COLUMN | 设置Column子组件在水平方向上的对齐格式，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：子组件在水平方向上的对齐格式，数据类型[ArkUI_HorizontalAlignment](capi-native-type-h.md#arkui_horizontalalignment)， <br> 默认值ARKUI_HORIZONTAL_ALIGNMENT_CENTER。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：子组件在水平方向上的对齐格式，数据类型[ArkUI_HorizontalAlignment](capi-native-type-h.md#arkui_horizontalalignment)。 | 626| NODE_COLUMN_JUSTIFY_CONTENT | 设置Column子组件在垂直方向上的对齐格式，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：子组件在垂直方向上的对齐格式，数据类型[ArkUI_FlexAlignment](capi-native-type-h.md#arkui_flexalignment)， <br> 默认值ARKUI_FLEX_ALIGNMENT_START。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：子组件在垂直方向上的对齐格式，数据类型[ArkUI_FlexAlignment](capi-native-type-h.md#arkui_flexalignment)。 | 627| NODE_ROW_ALIGN_ITEMS = MAX_NODE_SCOPE_NUM * ARKUI_NODE_ROW | 设置Row子组件在垂直方向上的对齐格式，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：子组件在垂直方向上的对齐格式，数据类型[ArkUI_VerticalAlignment](capi-native-type-h.md#arkui_verticalalignment)， <br> 默认值ARKUI_VERTICAL_ALIGNMENT_CENTER。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：子组件在垂直方向上的对齐格式，数据类型[ArkUI_VerticalAlignment](capi-native-type-h.md#arkui_verticalalignment)。 | 628| NODE_ROW_JUSTIFY_CONTENT | 设置Row子组件在水平方向上的对齐格式，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：子组件在水平方向上的对齐格式，数据类型[ArkUI_FlexAlignment](capi-native-type-h.md#arkui_flexalignment)， <br> 默认值ARKUI_FLEX_ALIGNMENT_START。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：子组件在水平方向上的对齐格式，数据类型[ArkUI_FlexAlignment](capi-native-type-h.md#arkui_flexalignment)。 | 629| NODE_FLEX_OPTION = MAX_NODE_SCOPE_NUM * ARKUI_NODE_FLEX | 设置Flex属性，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0]?.i32：子组件在Flex容器上排列的方向[ArkUI_FlexDirection](capi-native-type-h.md#arkui_flexdirection)，默认值为ARKUI_FLEX_DIRECTION_ROW； <br> .value[1]?.i32：排列规则[ArkUI_FlexWrap](capi-native-type-h.md#arkui_flexwrap)，默认值为ARKUI_FLEX_WRAP_NO_WRAP； <br> .value[2]?.i32：主轴上的对齐格式[ArkUI_FlexAlignment](capi-native-type-h.md#arkui_flexalignment)，默认值为ARKUI_FLEX_ALIGNMENT_START； <br> .value[3]?.i32：交叉轴上的对齐格式[ArkUI_ItemAlignment](capi-native-type-h.md#arkui_itemalignment)，默认值为ARKUI_ITEM_ALIGNMENT_START； <br> .value[4]?.i32： 交叉轴中有额外的空间时，多行内容的对齐方式[ArkUI_FlexAlignment](capi-native-type-h.md#arkui_flexalignment)，默认值为ARKUI_FLEX_ALIGNMENT_START； <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：子组件在Flex容器上排列的方向的枚举值； <br> .value[1].i32：排列规则的枚举值； <br> .value[2].i32：主轴上的对齐格式的枚举值； <br> .value[3].i32：交叉轴上的对齐格式的枚举值； <br> .value[4].i32：交叉轴中有额外的空间时，多行内容的对齐方式的枚举值； | 630| NODE_REFRESH_REFRESHING = MAX_NODE_SCOPE_NUM * ARKUI_NODE_REFRESH | 设置组件是否正在刷新，支持属性设置，属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式： <br> .value[0].i32：参数类型为1或者0，1表示正在刷新，0表示不在刷新。默认值：0<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：参数类型为1或者0，1表示正在刷新，0表示不在刷新。 | 631| NODE_REFRESH_CONTENT | 设置下拉区域的自定义内容，支持属性设置和重置。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .object：参数类型[ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md)。 | 632| NODE_REFRESH_PULL_DOWN_RATIO = 1009002 | 设置下拉跟手系数，支持属性设置，属性重置和属性获取接口。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .value[0].f32：下拉跟手系数,有效值为0-1之间的值。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：下拉跟手系数,有效值为0-1之间的值。 | 633| NODE_REFRESH_OFFSET = 1009003 | 设置触发刷新的下拉偏移量，支持属性设置，属性重置和属性获取接口。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .value[0].f32：下拉偏移量，单位vp， 默认值：64vp。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：下拉偏移量，单位vp， 默认值：64vp。 | 634| NODE_REFRESH_PULL_TO_REFRESH = 1009004 | 设置当下拉距离超过refreshOffset时是否触发刷新，支持属性设置，属性重置和属性获取接口。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .value[0].i32：是否触发刷新，true为触发刷新，false为不触发刷新，默认值true。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：是否触发刷新，1为触发刷新，0为不触发刷新。 | 635| NODE_REFRESH_MAX_PULL_DOWN_DISTANCE = 1009005 | 设置刷新的最大下拉距离。此属性可以根据需要通过api进行属性设置，属性重置和属性获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)的参数格式：<br> .value[0].f32：最大下拉距离，单位：vp。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)的格式：<br> .value[0].f32：最大下拉距离，单位：vp。<br>**起始版本：** 20 | 636| NODE_WATER_FLOW_LAYOUT_DIRECTION = MAX_NODE_SCOPE_NUM * ARKUI_NODE_WATER_FLOW | 定义瀑布流组件布局主轴方向，支持属性设置、重置和获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .value[0].i32 主轴方向，参数类型[ArkUI_FlexDirection](capi-native-type-h.md#arkui_flexdirection)。默认值ARKUI_FLEX_DIRECTION_COLUMN<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32 主轴方向，参数类型[ArkUI_FlexDirection](capi-native-type-h.md#arkui_flexdirection)。 | 637| NODE_WATER_FLOW_COLUMN_TEMPLATE | 设置当前瀑布流组件布局列的数量，不设置时默认1列，支持属性设置、重置和获取。例如，'1fr 1fr 2fr' 是将父组件分3列，将父组件允许的宽分为4等份，第1列占1份，第2列占1份，第3列占2份。可使用columnsTemplate('repeat(auto-fill,track-size)')根据给定的列宽track-size自动计算列数，其中repeat、auto-fill为关键字，track-size为可设置的宽度，支持的单位包括px、vp、%或有效数字，默认单位为vp。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .string：布局列的数量。默认值：'1fr'<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string：布局列的数量。 | 638| NODE_WATER_FLOW_ROW_TEMPLATE | 设置当前瀑布流组件布局行的数量，不设置时默认1行，支持属性设置、重置和获取。例如，'1fr 1fr 2fr'是将父组件分3行，将父组件允许的高分为4等份，第1行占1份，第2行占1份，第3行占2份。可使用rowsTemplate('repeat(auto-fill,track-size)')根据给定的行高track-size自动计算行数，其中repeat、auto-fill为关键字，track-size为可设置的高度，支持的单位包括px、vp、%或有效数字，默认单位为vp。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .string：布局行的数量。默认值：'1fr'<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string：布局行的数量。 | 639| NODE_WATER_FLOW_COLUMN_GAP | 设置列与列的间距，支持属性设置、重置和获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .value[0].f32：列与列的间距，默认值：0，单位vp。取值范围：[0, +∞)<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：列与列的间距，单位vp。 | 640| NODE_WATER_FLOW_ROW_GAP | 设置行与行的间距，支持属性设置、重置和获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .value[0].f32：行与行的间距，默认值：0，单位vp。取值范围：[0, +∞)<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：行与行的间距，单位vp。 | 641| NODE_WATER_FLOW_SECTION_OPTION | 设置FlowItem分组配置信息，支持属性设置、重置和获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .value[0].i32：从0开始计算的索引，会转换为整数，表示要开始改变分组的位置。<br> .object：参数格式为[ArkUI_WaterFlowSectionOption](capi-arkui-nativemodule-arkui-waterflowsectionoption.md)。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：返回值格式为[ArkUI_WaterFlowSectionOption](capi-arkui-nativemodule-arkui-waterflowsectionoption.md)。 | 642| NODE_WATER_FLOW_NODE_ADAPTER | waterFlow组件适配器，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：使用[ArkUI_NodeAdapter](capi-arkui-nativemodule-arkui-nodeadapter8h.md)对象作为适配器。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：返回值格式为[ArkUI_NodeAdapter](capi-arkui-nativemodule-arkui-nodeadapter8h.md)。 | 643| NODE_WATER_FLOW_CACHED_COUNT | waterFlow组件Adapter缓存数量，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：配合waterFlow组件Adapter使用，设置adapter中的缓存数量<br> .value[1]?.i32：是否显示缓存节点，0：不显示，1：显示，默认值：0。该参数从API version 16开始支持。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：adapter中的缓存数量。<br> .value[1].i32：是否显示缓存节点，0：不显示，1：显示。该参数从API version 16开始支持。 | 644| NODE_WATER_FLOW_FOOTER | 设置瀑布流组件末尾的自定义显示组件。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .object：参数类型[ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md)。 | 645| NODE_WATER_FLOW_SCROLL_TO_INDEX | 滑动到指定index。开启smooth动效时，会对经过的所有item进行加载和布局计算，当大量加载item时会导致性能问题。<br> <br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：要滑动到的目标元素在当前容器中的索引值。<br> .value[1]?.i32：设置滑动到列表项在列表中的索引值时是否有动效，1表示有动效，0表示没有动效。默认值：0。<br> .value[2]?.i32：指定滑动到的元素与当前容器的对齐方式，参数类型[ArkUI_ScrollAlignment](capi-native-type-h.md#arkui_scrollalignment)。默认值为：ARKUI_SCROLL_ALIGNMENT_START。| 646| NODE_WATER_FLOW_ITEM_CONSTRAINT_SIZE | 设置当前瀑布流子组件的约束尺寸属性，组件布局时，进行尺寸范围限制，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：最小宽度，使用-1表示不设置； <br> .value[1].f32：最大宽度，使用-1表示不设置； <br> .value[2].f32：最小高度，使用-1表示不设置； <br> .value[3].f32：最大高度，使用-1表示不设置； <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：最小宽度，使用-1表示不设置； <br> .value[1].f32：最大宽度，使用-1表示不设置； <br> .value[2].f32：最小高度，使用-1表示不设置； <br> .value[3].f32：最大高度，使用-1表示不设置； | 647| NODE_WATER_FLOW_LAYOUT_MODE | 定义瀑布流组件布局模式，支持属性设置、重置和获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .value[0].i32：布局模式，参数类型[ArkUI_WaterFlowLayoutMode](capi-native-type-h.md#arkui_waterflowlayoutmode)，默认值：ARKUI_WATER_FLOW_LAYOUT_MODE_ALWAYS_TOP_DOWN。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：布局模式，参数类型[ArkUI_WaterFlowLayoutMode](capi-native-type-h.md#arkui_waterflowlayoutmode)。<br>**起始版本：** 18 | 648| NODE_WATER_FLOW_SYNC_LOAD = 1010012 | WaterFlow组件是否同步加载子节点，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：WaterFlow组件是否同步加载子节点。0：分帧加载，1：同步加载。默认值：1<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：WaterFlow组件是否同步加载子节点。0：分帧加载，1：同步加载。<br>**起始版本：** 20 | 649| NODE_RELATIVE_CONTAINER_GUIDE_LINE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_RELATIVE_CONTAINER | 设置RelativeContainer容器内的辅助线，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .object: RelativeContainer容器内的辅助线： <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .object: RelativeContainer容器内的辅助线： | 650| NODE_RELATIVE_CONTAINER_BARRIER | 设置RelativeContainer容器内的屏障，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .object: RelativeContainer容器内的辅助线： <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .object: RelativeContainer容器内的屏障： | 651| NODE_GRID_COLUMN_TEMPLATE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_GRID | 设置当前Grid组件布局列的数量，不设置时默认1列，支持属性设置、重置和获取。例如，'1fr 1fr 2fr' 是将父组件分3列，将父组件允许的宽分为4等份，第1列占1份，第2列占1份，第3列占2份。可使用columnsTemplate('repeat(auto-fill,track-size)')根据给定的列宽track-size自动计算列数，其中repeat、auto-fill为关键字，track-size为可设置的宽度，支持的单位包括px、vp、%或有效数字，默认单位为vp。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .string: 布局列的数量。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string: 布局列的数量。 | 652| NODE_GRID_ROW_TEMPLATE | 设置当前Grid布局行的数量或最小行高值，不设置时默认1行，支持属性设置、重置和获取。例如，'1fr 1fr 2fr'是将父组件分3行，将父组件允许的高分为4等份，第1行占1份，第2行占1份，第3行占2份。可使用rowsTemplate('repeat(auto-fill,track-size)')根据给定的行高track-size自动计算行数，其中repeat、auto-fill为关键字，track-size为可设置的高度，支持的单位包括px、vp、%或有效数字，默认单位为vp。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .string: 布局行的数量。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .string: 布局行的数量。 | 653| NODE_GRID_COLUMN_GAP | 设置列与列的间距，支持属性设置、重置和获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .value[0].f32：列与列的间距，默认值：0，单位vp。取值范围：[0, +∞)<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：列与列的间距，单位vp。 | 654| NODE_GRID_ROW_GAP | 设置行与行的间距，支持属性设置、重置和获取。属性设置方法[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)参数格式：<br> .value[0].f32：行与行的间距，默认值：0，单位vp。取值范围：[0, +∞)<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32：行与行的间距，单位vp。 | 655| NODE_GRID_NODE_ADAPTER | Grid组件适配器，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：使用[ArkUI_NodeAdapter](capi-arkui-nativemodule-arkui-nodeadapter8h.md)对象作为适配器。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .object：返回值格式为[ArkUI_NodeAdapter](capi-arkui-nativemodule-arkui-nodeadapter8h.md)。 | 656| NODE_GRID_CACHED_COUNT | Grid组件Adapter缓存数量，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：配合Grid组件Adapter使用，设置Adapter中的缓存数量。 | 657| NODE_GRID_FOCUS_WRAP_MODE = 1013006 | Grid组件走焦换行模式，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：Grid组件走焦换行模式，参数类型[ArkUI_FocusWrapMode](capi-native-type-h.md#arkui_focuswrapmode)。默认值：FOCUS_WRAP_MODE_DEFAULT<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32: Grid组件走焦换行模式，参数类型[ArkUI_FocusWrapMode](capi-native-type-h.md#arkui_focuswrapmode)。<br>**起始版本：** 20 | 658| NODE_GRID_SYNC_LOAD = 1013007 | Grid组件是否同步加载子节点，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：Grid组件是否同步加载子节点。0：分帧加载，1：同步加载。默认值：1<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].i32：Grid组件是否同步加载子节点。0：分帧加载，1：同步加载。<br>**起始版本：** 20 | 659| NODE_TEXT_PICKER_COLUMN_WIDTHS = 15009 | 设置每一个选择项列宽，支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式：<br> .value[0].f32: 设置的第1个选择项列宽，为总宽度的百分比。默认情况下，所有选择项的列宽相等。<br> .value[1]?.f32: 设置的第2个选择项列宽，为总宽度的百分比。默认情况下，所有选择项的列宽相等。<br> .value[2]?.f32: 设置的第3个选择项列宽，为总宽度的百分比。默认情况下，所有选择项的列宽相等。<br> ...<br> .value[n]?.f32: 设置的第n+1个选择项列宽，为总宽度的百分比。默认情况下，所有选择项的列宽相等。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> value[0].f32: 第1列宽度，总宽度的百分比。<br> value[1].f32: 第2列宽度，总宽度的百分比。<br> value[2].f32: 第3列宽度，总宽度的百分比。<br> ...<br> value[n].f32: 第n+1列宽度，总宽度的百分比。<br>**起始版本：** 18 | 660| NODE_IMAGE_ANIMATOR_IMAGES = ARKUI_NODE_IMAGE_ANIMATOR * MAX_NODE_SCOPE_NUM | 设置帧动画组件的图片帧信息集合。不支持动态更新。支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .size：图片帧的数量； <br> .object：图片帧数组，参数类型为[ArkUI_ImageAnimatorFrameInfo](capi-arkui-nativemodule-arkui-imageanimatorframeinfo.md)数组； <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .size：图片帧的数量； <br> .object：图片帧数组，参数类型为[ArkUI_ImageAnimatorFrameInfo](capi-arkui-nativemodule-arkui-imageanimatorframeinfo.md)数组； | 661| NODE_IMAGE_ANIMATOR_STATE = 19001 | 控制帧动画组件的播放状态。支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：控制动画的播放状态，参数类型为[ArkUI_AnimationStatus](capi-native-type-h.md#arkui_animationstatus)，默认值为初始状态。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：控制动画的播放状态，参数类型为[ArkUI_AnimationStatus](capi-native-type-h.md#arkui_animationstatus)。 | 662| NODE_IMAGE_ANIMATOR_DURATION = 19002 | 设置帧动画的播放时长，当数组中任意一帧图片单独设置了duration属性后，该属性设置无效。支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：播放时长，单位为毫秒，默认值1000。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：播放时长，单位为毫秒，默认值1000。 | 663| NODE_IMAGE_ANIMATOR_REVERSE = 19003 | 设置帧动画的播放方向。支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：播放方向，0表示从第一张图片播放到最后一张，1表示从最后一张图片播放到第一张，默认值为0。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：播放方向，0表示从第一张图片播放到最后一张，1表示从最后一张图片播放到第一张。 | 664| NODE_IMAGE_ANIMATOR_FIXED_SIZE = 19004 | 设置图片大小是否固定为组件大小。支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：设置图片大小是否固定为组件大小，1表示图片大小与组件大小一致。0表示每一张图片的width、height、top和left都要单独设置，默认值为1。<br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：设置图片大小是否固定为组件大小，1表示图片大小与组件大小一致。0表示每一张图片的width、height、top和left都要单独设置。 | 665| NODE_IMAGE_ANIMATOR_FILL_MODE = 19005 | 设置帧动画在当前播放方向下，动画开始前和结束后的状态。支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：当前播放方向下，动画开始前和结束后的状态，参数类型为[ArkUI_AnimationFillMode](capi-native-type-h.md#arkui_animationfillmode)，默认值为ARKUI_ANIMATION_FILL_MODE_FORWARDS。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：当前播放方向下，动画开始前和结束后的状态，参数类型为[ArkUI_AnimationFillMode](capi-native-type-h.md#arkui_animationfillmode)。 | 666| NODE_IMAGE_ANIMATOR_ITERATION = 19006 | 设置帧动画的播放次数。支持属性设置，属性重置和属性获取接口。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：播放次数。 <br> 属性获取方法返回值[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .value[0].i32：播放次数。 | 667| NODE_EMBEDDED_COMPONENT_WANT = MAX_NODE_SCOPE_NUM * ARKUI_NODE_EMBEDDED_COMPONENT | 定义用于启动EmbeddedAbility的want。支持属性设置。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .object: EmbeddedCompont的want参数。参数类型为[AbilityBase_Want](capi-arkui-nativemodule-abilitybase-want.md)。默认值为nullptr。 <br>**起始版本：** 20 | 668| NODE_EMBEDDED_COMPONENT_OPTION | EmbeddedCompont的选项。支持属性设置。<br>属性设置方法参数[ArkUI_AttributeItem](capi-arkui-nativemodule-arkui-attributeitem.md)格式： <br> .object: EmbeddedCompont的选项列表，参数类型为[ArkUI_EmbeddedComponentOption](capi-arkui-nativemodule-arkui-embeddedcomponentoption.md)。<br>**起始版本：** 20 | 669 670### ArkUI_NodeEventType 671 672``` 673enum ArkUI_NodeEventType 674``` 675 676**描述：** 677 678 679提供NativeNode组件支持的事件类型定义。 680 681**起始版本：** 12 682 683| 枚举项 | 描述 | 684| -- |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| 685| NODE_TOUCH_EVENT = 0 | 手势事件类型。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_UIInputEvent](capi-arkui-eventmodule-arkui-uiinputevent.md)。 | 686| NODE_EVENT_ON_APPEAR | 挂载事件。触发该事件的条件：组件挂载显示时触发此回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 687| NODE_EVENT_ON_DISAPPEAR | 卸载事件。触发该事件的条件 ：组件卸载时触发此回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 688| NODE_EVENT_ON_AREA_CHANGE | 组件区域变化事件触发该事件的条件：组件区域变化时触发该回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含12个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：表示过去目标元素的宽度，类型为number，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[1].f32</b>：表示过去目标元素的高度，类型为number，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[2].f32</b>：表示过去目标元素左上角相对父元素左上角的位置的x轴坐标，类型为number，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[3].f32</b>：表示过去目标元素左上角相对父元素左上角的位置的y轴坐标，类型为number，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[4].f32</b>：表示过去目标元素目标元素左上角相对页面左上角的位置的x轴坐标，类型为number，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[5].f32</b>：表示过去目标元素目标元素左上角相对页面左上角的位置的y轴坐标，类型为number，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[6].f32</b>：表示最新目标元素的宽度，类型为number，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[7].f32</b>：表示最新目标元素的高度，类型为number，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[8].f32</b>：表示最新目标元素左上角相对父元素左上角的位置的x轴坐标，类型为number，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[9].f32</b>：表示最新目标元素左上角相对父元素左上角的位置的y轴坐标，类型为number，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[10].f32</b>：表示最新目标元素目标元素左上角相对页面左上角的位置的x轴坐标，类型为number，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[11].f32</b>：表示最新目标元素目标元素左上角相对页面左上角的位置的y轴坐标，类型为number，单位vp。 | 689| NODE_ON_FOCUS | 获焦事件。触发该事件的条件：组件获焦时触发此回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 690| NODE_ON_BLUR | 失去焦点事件。触发该事件的条件：组件失去焦点时触发此回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 691| NODE_ON_CLICK | 组件点击事件。触发该事件的条件：组件被点击时触发此回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含8个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：点击位置相对于被点击元素原始区域左上角的X坐标，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[1].f32</b>：点击位置相对于被点击元素原始区域左上角的Y坐标，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[2].f32</b>：事件时间戳。触发事件时距离系统启动的时间间隔，单位微秒。<br> <b>ArkUI_NodeComponentEvent.data[3].i32</b>：事件输入设备，1表示鼠标，2表示触屏，4表示按键。<br> <b>ArkUI_NodeComponentEvent.data[4].f32</b>：点击位置相对于应用窗口左上角的X坐标，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[5].f32</b>：点击位置相对于应用窗口左上角的Y坐标，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[6].f32</b>：点击位置相对于应用屏幕左上角的X坐标，单位vp。<br> <b>ArkUI_NodeComponentEvent.data[7].f32</b>：点击位置相对于应用屏幕左上角的Y坐标，单位vp。 | 692| NODE_ON_TOUCH_INTERCEPT | 组件自定义事件拦截。触发该事件的条件：组件被触摸时触发此回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_UIInputEvent](capi-arkui-eventmodule-arkui-uiinputevent.md)。 | 693| NODE_EVENT_ON_VISIBLE_AREA_CHANGE | 组件可见区域变化事件。触发该事件的条件：组件可见面积与自身面积的比值接近设置的阈值时触发回调，注册事件前需先使用NODE_VISIBLE_AREA_CHANGE_RATIO配置阈值。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：组件可见面积与自身面积的比值与上次变化相比的情况，变大为1，变小为0。<br> <b>ArkUI_NodeComponentEvent.data[1].f32</b>：触发回调时组件可见面积与自身面积的比值。 | 694| NODE_ON_HOVER | 鼠标进入或退出组件事件。触发该事件的条件：鼠标进入或退出组件时触发回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：鼠标是否悬浮在组件上，鼠标进入时为1，退出时为0。 | 695| NODE_ON_MOUSE | 组件点击事件。触发该事件的条件：组件被鼠标按键点击或者鼠标在组件上悬浮移动时触发该回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_UIInputEvent](capi-arkui-eventmodule-arkui-uiinputevent.md)。 | 696| NODE_EVENT_ON_ATTACH | 上树事件。触发该事件的条件：组件上树时触发此回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 697| NODE_EVENT_ON_DETACH | 下树事件。触发该事件的条件：组件下树时触发此回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 698| NODE_ON_ACCESSIBILITY_ACTIONS = 13 | 无障碍支持操作事件触发。触发该事件的条件：已设置无障碍操作类型，并进行相应操作。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数: <br> <b>ArkUI_NodeComponentEvent.data[0].u32</b>: 触发回调的操作类型，参数类型[ArkUI_AccessibilityActionType](capi-native-type-h.md#arkui_accessibilityactiontype)。 | 699| NODE_ON_PRE_DRAG = 14 | 在拖拽行为开始之前告诉侦听器详细的交互状态。触发该事件的条件：组件可拖拽，当长按浮起/松手/发起拖拽时，回调触发。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：对应[ArkUI_PreDragStatus](capi-drag-and-drop-h.md#arkui_predragstatus)。 | 700| NODE_ON_DRAG_START = 15 | 用户已移动足够距离，即将发起拖拽。触发该事件的条件：长按拖动产生足够位移距离时触发。<br> 事件回调发生时，可从事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中获取[ArkUI_DragEvent](capi-arkui-nativemodule-arkui-dragevent.md)。 | 701| NODE_ON_DRAG_ENTER = 16 | 用户拖拽进入当前组件范围。触发该事件的条件: 拖拽对象进入监听了该事件的组件边界时触发。<br> 事件回调发生时，可从事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中获取[ArkUI_DragEvent](capi-arkui-nativemodule-arkui-dragevent.md)。 | 702| NODE_ON_DRAG_MOVE = 17 | 用户拖拽在当前组件范围内移动。触发该事件的条件: 拖拽对象在监听了该事件的组件范围内移动时触发。<br> 事件回调发生时，可从事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中获取[ArkUI_DragEvent](capi-arkui-nativemodule-arkui-dragevent.md)。 | 703| NODE_ON_DRAG_LEAVE = 18 | 用户拖拽从当前组件范围离开。触发该事件的条件: 拖拽对象离开监听了该事件的组件边界时触发。<br> 事件回调发生时，可从事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中获取[ArkUI_DragEvent](capi-arkui-nativemodule-arkui-dragevent.md)。 | 704| NODE_ON_DROP = 19 | 当用户在组件上方松手时，该组件上可通过该回调拿到拖拽数据进行处理。触发该事件的条件: 拖拽对象并在组件上方松手时触发。<br> 事件回调发生时，可从事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中获取[ArkUI_DragEvent](capi-arkui-nativemodule-arkui-dragevent.md)。 | 705| NODE_ON_DRAG_END = 20 | 拖拽发起方可通过注册该回调感知拖拽结束后的结果。触发该事件的条件：用户松手，拖拽行为结束时触发。事件回调发生时，可从事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中获取[ArkUI_DragEvent](capi-arkui-nativemodule-arkui-dragevent.md)。 | 706| NODE_ON_KEY_EVENT = 21 | 绑定该方法的组件获焦后，按键动作触发该回调。触发该事件的条件：由外设键盘等设备与获焦窗口交互触发此回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br>**起始版本：** 14 | 707| NODE_ON_KEY_PRE_IME = 22 | 绑定该方法的组件获焦后，按键动作在响应输入法前优先触发该回调。该回调的返回值为true时，视作该按键事件已被消费，后续的事件回调（keyboardShortcut、输入法事件、onKeyEvent）会被拦截，不再触发。触发该事件的条件：由外设键盘等设备与获焦窗口交互触发此回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br>**起始版本：** 14 | 708| NODE_ON_FOCUS_AXIS = 23 | 绑定该方法的组件获焦后，收到焦点轴事件时触发该回调。触发该事件的条件：由游戏手柄与获焦组件交互触发此回调。 <br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_UIInputEvent](capi-arkui-eventmodule-arkui-uiinputevent.md)。 <br>**起始版本：** 15 | 709| NODE_DISPATCH_KEY_EVENT = 24 | 组件按键事件重新派发事件。当组件节点接收到按键事件时，将触发此回调函数，而非将事件分发给其子节点。 <br> 当事件回调发生时，[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。 <br>**起始版本：** 15 | 710| NODE_ON_AXIS = 25 | 绑定该方法的组件收到轴事件时触发该回调。当绑定组件接收到轴事件时，会触发该事件回调。 <br> 事件发生时，[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md) 对象中的联合类型为[ArkUI_UIInputEvent](capi-arkui-eventmodule-arkui-uiinputevent.md)。 <br>**起始版本：** 17 | 711| NODE_ON_HOVER_EVENT = 27 | 定义鼠标指针移至组件上方或远离组件时触发的事件。当鼠标指针移到组件上方或远离组件时触发该事件。 <br>当事件回调发生时，[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合类型为[ArkUI_UIInputEvent](capi-arkui-eventmodule-arkui-uiinputevent.md)。 <br> **起始版本：** 17 | 712| NODE_ON_CLICK_EVENT = 26 | 绑定该方法的组件被点击时触发此回调。当绑定组件被点击时，将触发此事件回调。 <br> 当发生事件回调，[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合类型是[ArkUI_UIInputEvent](capi-arkui-eventmodule-arkui-uiinputevent.md)。 <br>**起始版本：** 18 | 713| NODE_VISIBLE_AREA_APPROXIMATE_CHANGE_EVENT = 28 | 设置限制回调间隔的NODE_EVENT_ON_VISIBLE_AREA_CHANGE事件的回调。触发该事件的条件：组件可见面积与自身面积的比值接近设置的阈值时触发回调，注册事件前需先使用NODE_VISIBLE_AREA_APPROXIMATE_CHANGE_RATIO 配置阈值和更新间隔。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：组件可见面积与自身面积的比值与上次变化相比的情况，变大为1，变小为0。<br> <b>ArkUI_NodeComponentEvent.data[1].f32</b>：触发回调时组件可见面积与自身面积的比值。<br>**起始版本：** 17 | 714| NODE_ON_HOVER_MOVE = 29 | 定义悬浮事件。当手写笔设备指针悬停在组件内时会触发该事件。<br> 事件回调发生时, 可从事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中获取[ArkUI_UIInputEvent](capi-arkui-eventmodule-arkui-uiinputevent.md)。<br>**起始版本：** 15 | 715| NODE_TEXT_ON_DETECT_RESULT_UPDATE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT | 文本设置TextDataDetectorConfig且识别成功时，触发onDetectResultUpdate回调。触发该事件的条件：文本设置TextDataDetectorConfig且识别成功后。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)。<br> [ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)中包含1个参数：<br> <b>ArkUI_StringAsyncEvent.pStr</b>：表示文本识别的结果，Json格式。 | 716| NODE_TEXT_SPAN_ON_LONG_PRESS = 1001 | Span组件长按事件。组件被长按时触发此回调。<br> 事件回调发生时，可从事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中获取ArkUI_UIInputEvent。<br>**起始版本：** 20 | 717| NODE_IMAGE_ON_COMPLETE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_IMAGE | 图片加载成功事件。触发该事件的条件 ：图片数据加载成功和解码成功均触发该回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含9个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：表示加载状态，0表示数据加载成功，1表示解码成功。<br> <b>ArkUI_NodeComponentEvent.data[1].f32</b>：表示图片的宽度，单位px。<br> <b>ArkUI_NodeComponentEvent.data[2].f32</b>：表示图片的高度，单位px。<br> <b>ArkUI_NodeComponentEvent.data[3].f32</b>：表示当前组件的宽度，单位px。<br> <b>ArkUI_NodeComponentEvent.data[4].f32</b>：表示当前组件的高度，单位px。<br> <b>ArkUI_NodeComponentEvent.data[5].f32</b>：图片绘制区域相对组件X轴位置，单位px。<br> <b>ArkUI_NodeComponentEvent.data[6].f32</b>：图片绘制区域相对组件Y轴位置，单位px。<br> <b>ArkUI_NodeComponentEvent.data[7].f32</b>：图片绘制区域宽度，单位px。<br> <b>ArkUI_NodeComponentEvent.data[8].f32</b>：图片绘制区域高度，单位px。 | 718| NODE_IMAGE_ON_ERROR | 图片加载失败事件。触发该事件的条件：图片加载异常时触发该回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>错误码信息：<br> 401: 图片路径参数异常，无法获取到图片数据。<br> 103101: 图片格式不支持。 | 719| NODE_IMAGE_ON_SVG_PLAY_FINISH | SVG图片动效播放完成事件。触发该事件的条件：带动效的SVG图片动画结束时触发。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 720| NODE_IMAGE_ON_DOWNLOAD_PROGRESS | 定义图片下载过程中触发事件。触发该事件的条件 ：页面组件下载网页图片时触发。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数: <br> <b>ArkUI_NodeComponentEvent.data[0].u32</b>: 到目前为止已下载的字节数。 <br> <b>ArkUI_NodeComponentEvent.data[1].u32</b>: 要下载图片的总字节数。 | 721| NODE_TOGGLE_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TOGGLE | 开关状态发生变化时触发给事件。触发该事件的条件：开关状态发生变化。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：当前开关状态，1表示开，0表示关。 | 722| NODE_TEXT_INPUT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT_INPUT | TextInput输入内容发生变化时触发该事件。触发该事件的条件：输入内容发生变化时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)。<br> [ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)中包含1个参数：<br> <b>ArkUI_StringAsyncEvent.pStr</b>：输入的文本内容。 | 723| NODE_TEXT_INPUT_ON_SUBMIT | TextInput按下输入法回车键触发该事件。触发该事件的条件：按下输入法回车键。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：输入法回车键类型。 | 724| NODE_TEXT_INPUT_ON_CUT | 长按输入框内部区域弹出剪贴板后，点击剪切板剪切按钮，触发该回调。触发该事件的条件：长按输入框内部区域弹出剪贴板后，点击剪切板剪切按钮。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)。<br> [ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)中包含1个参数：<br> <b>ArkUI_StringAsyncEvent.pStr</b>：剪切的文本内容。 | 725| NODE_TEXT_INPUT_ON_PASTE | 长按输入框内部区域弹出剪贴板后，点击剪切板粘贴按钮，触发该回调。触发该事件的条件：长按输入框内部区域弹出剪贴板后，点击剪切板粘贴按钮。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)。<br> [ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)中包含1个参数：<br> <b>ArkUI_StringAsyncEvent.pStr</b>：粘贴的文本内容。 | 726| NODE_TEXT_INPUT_ON_TEXT_SELECTION_CHANGE | 文本选择的位置发生变化时，触发该回调。触发该事件的条件：文本选择的位置发生变化时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：表示所选文本的起始位置。<br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：表示所选文本的结束位置。 | 727| NODE_TEXT_INPUT_ON_EDIT_CHANGE | 输入状态变化时，触发该回调。触发该事件的条件：输入状态变化时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：true表示正在输入。 | 728| NODE_TEXT_INPUT_ON_INPUT_FILTER_ERROR | 设置NODE_TEXT_INPUT_INPUT_FILTER，正则匹配失败时触发。触发该事件的条件：正则匹配失败时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)。<br> [ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)中包含1个参数：<br> <b>ArkUI_StringAsyncEvent.pStr</b>：表示正则匹配失败时，被过滤的内容。 | 729| NODE_TEXT_INPUT_ON_CONTENT_SCROLL | 文本内容滚动时，触发该回调。触发该事件的条件：文本内容滚动时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：表示文本在内容区的横坐标偏移。<br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：表示文本在内容区的纵坐标偏移。 | 730| NODE_TEXT_INPUT_ON_CONTENT_SIZE_CHANGE | TextInput输入内容发生变化时触发该事件。触发该事件的条件：输入内容发生变化时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：表示文本的宽度。<br> <b>ArkUI_NodeComponentEvent.data[1].f32</b>：表示文本的高度。 | 731| NODE_TEXT_INPUT_ON_WILL_INSERT = 7009 | 定义在将要输入时，触发回调的枚举值。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)。<br> 通过OH_ArkUI_NodeEvent_GetNumberValue获取到index为0的value.f32：插入的值的位置信息。<br> 通过OH_ArkUI_NodeEvent_GetStringValue获取到index为0的buffer字符串：插入的值。 | 732| NODE_TEXT_INPUT_ON_DID_INSERT = 7010 | 定义在输入完成时，触发回调的枚举值。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)。<br> 通过OH_ArkUI_NodeEvent_GetNumberValue获取到index为0的value.f32：插入的值的位置信息。<br> 通过OH_ArkUI_NodeEvent_GetStringValue获取到index为0的buffer字符串：插入的值。 | 733| NODE_TEXT_INPUT_ON_WILL_DELETE = 7011 | 定义在将要删除时，触发回调的枚举值。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)。<br> 通过OH_ArkUI_NodeEvent_GetNumberValue获取到index为0的value.f32：删除的值的位置信息。<br> 通过OH_ArkUI_NodeEvent_GetNumberValue获取到index为1的value.i32：删除值的方向，0为向后删除，1为向前删除。<br> 通过OH_ArkUI_NodeEvent_GetStringValue获取到index为0的buffer字符串：删除的值。 | 734| NODE_TEXT_INPUT_ON_DID_DELETE = 7012 | 定义在删除完成时，触发回调的枚举值。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)。<br> 通过OH_ArkUI_NodeEvent_GetNumberValue获取到index为0的value.f32：删除的值的位置信息。<br> 通过OH_ArkUI_NodeEvent_GetNumberValue获取到index为1的value.i32：删除值的方向，0为向后删除，1为向前删除。<br> 通过OH_ArkUI_NodeEvent_GetStringValue获取到index为0的buffer字符串：删除的值。 | 735| NODE_TEXT_INPUT_ON_CHANGE_WITH_PREVIEW_TEXT = 7013 | 定义TextInput组件在内容改变时（包含预上屏内容），触发回调的枚举值。事件回调发生时，联合类型[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)为[ArkUI_TextChangeEvent](capi-arkui-nativemodule-arkui-textchangeevent.md)。<br> [ArkUI_TextChangeEvent](capi-arkui-nativemodule-arkui-textchangeevent.md)包含参数：<br> <b>ArkUI_TextChangeEvent.pStr</b>: TextInput的内容。<br> <b>ArkUI_TextChangeEvent.pExtendStr</b>: TextInput的预上屏内容。<br> <b>ArkUI_TextChangeEvent.number</b>: TextInput的预上屏起始位置。<br>**起始版本：** 15 | 736| NODE_TEXT_INPUT_ON_WILL_CHANGE = 7014 | 定义TextInput组件在内容将要改变时（包含预上屏内容），触发回调的枚举值。事件回调发生时，联合类型[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)为[ArkUI_TextChangeEvent](capi-arkui-nativemodule-arkui-textchangeevent.md)。<br> [ArkUI_TextChangeEvent](capi-arkui-nativemodule-arkui-textchangeevent.md)包含参数：<br> <b>ArkUI_TextChangeEvent.pStr</b>：TextInput的内容。<br> <b>ArkUI_TextChangeEvent.pExtendStr</b>：TextInput的预上屏内容。<br> <b>ArkUI_TextChangeEvent.number</b>：TextInput的预上屏起始位置。<br>**起始版本：** 20 | 737| NODE_TEXT_AREA_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT_AREA | 输入内容发生变化时，触发该回调。触发该事件的条件：输入内容发生变化时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)。<br> [ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)中包含1个参数：<br> <b>ArkUI_StringAsyncEvent.pStr</b>：当前输入的文本内容。 | 738| NODE_TEXT_AREA_ON_PASTE | 长按输入框内部区域弹出剪贴板后，点击剪切板粘贴按钮，触发该回调。触发该事件的条件：长按输入框内部区域弹出剪贴板后，点击剪切板粘贴按钮。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)。<br> [ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)中包含1个参数：<br> <b>ArkUI_StringAsyncEvent.pStr</b>：粘贴的文本内容。 | 739| NODE_TEXT_AREA_ON_TEXT_SELECTION_CHANGE | 文本选择的位置发生变化时，触发该回调。触发该事件的条件：文本选择的位置发生变化时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：表示所选文本的起始位置。<br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：表示所选文本的结束位置。 | 740| NODE_TEXT_AREA_ON_EDIT_CHANGE | 输入状态变化时，触发该回调。触发该事件的条件：输入状态变化时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：true表示正在输入。 | 741| NODE_TEXT_AREA_ON_SUBMIT | TextArea按下输入法回车键触发该事件。触发该事件的条件：按下输入法回车键。keyType为ARKUI_ENTER_KEY_TYPE_NEW_LINE时不触发<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：输入法回车键类型。 | 742| NODE_TEXT_AREA_ON_INPUT_FILTER_ERROR | 设置NODE_TEXT_AREA_INPUT_FILTER，正则匹配失败时触发。触发该事件的条件：正则匹配失败时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)。<br> [ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)中包含1个参数：<br> <b>ArkUI_StringAsyncEvent.pStr</b>：表示正则匹配失败时，被过滤的内容。 | 743| NODE_TEXT_AREA_ON_CONTENT_SCROLL | 文本内容滚动时，触发该回调。触发该事件的条件：文本内容滚动时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：表示文本在内容区的横坐标偏移。<br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：表示文本在内容区的纵坐标偏移。 | 744| NODE_TEXT_AREA_ON_CONTENT_SIZE_CHANGE | TextArea输入内容发生变化时触发该事件。触发该事件的条件：输入内容发生变化时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：表示文本的宽度。<br> <b>ArkUI_NodeComponentEvent.data[1].f32</b>：表示文本的高度。 | 745| NODE_TEXT_AREA_ON_WILL_INSERT = 8008 | 定义在将要输入时，触发回调的枚举值。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)。<br> 通过OH_ArkUI_NodeEvent_GetNumberValue获取到index为0的value.f32：插入的值的位置信息。<br> 通过OH_ArkUI_NodeEvent_GetStringValue获取到index为0的buffer字符串：插入的值。 | 746| NODE_TEXT_AREA_ON_DID_INSERT = 8009 | 定义在输入完成时，触发回调的枚举值。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)。<br> 通过OH_ArkUI_NodeEvent_GetNumberValue获取到index为0的value.f32：插入的值的位置信息。<br> 通过OH_ArkUI_NodeEvent_GetStringValue获取到index为0的buffer字符串：插入的值。 | 747| NODE_TEXT_AREA_ON_WILL_DELETE = 8010 | 定义在将要删除时，触发回调的枚举值。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)。<br> 通过OH_ArkUI_NodeEvent_GetNumberValue获取到index为0的value.f32：删除的值的位置信息。<br> 通过OH_ArkUI_NodeEvent_GetNumberValue获取到index为1的value.i32：删除值的方向，0为向后删除，1为向前删除。<br> 通过OH_ArkUI_NodeEvent_GetStringValue获取到index为0的buffer字符串：删除的值。 | 748| NODE_TEXT_AREA_ON_DID_DELETE = 8011 | 定义在删除完成时，触发回调的枚举值。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)。<br> 通过OH_ArkUI_NodeEvent_GetNumberValue获取到index为0的value.f32：删除的值的位置信息。<br> 通过OH_ArkUI_NodeEvent_GetNumberValue获取到index为1的value.i32：删除值的方向，0为向后删除，1为向前删除。<br> 通过OH_ArkUI_NodeEvent_GetStringValue获取到index为0的buffer字符串：删除的值。 | 749| NODE_TEXT_AREA_ON_CHANGE_WITH_PREVIEW_TEXT = 8012 | 定义TextArea组件在内容改变时（包含预上屏内容），触发回调的枚举值。事件回调发生时，联合类型[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)为[ArkUI_TextChangeEvent](capi-arkui-nativemodule-arkui-textchangeevent.md)。<br> [ArkUI_TextChangeEvent](capi-arkui-nativemodule-arkui-textchangeevent.md)包含参数：<br> <b>ArkUI_TextChangeEvent.pStr</b>: TextArea的内容。<br> <b>ArkUI_TextChangeEvent.pExtendStr</b>: TextArea的预上屏内容。<br> <b>ArkUI_TextChangeEvent.number</b>: TextArea的预上屏起始位置。<br>**起始版本：** 15 | 750| NODE_TEXT_AREA_ON_WILL_CHANGE = 8013 | 定义TextArea组件在内容将要改变时（包含预上屏内容），触发回调的枚举值。事件回调发生时，联合类型[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)为[ArkUI_TextChangeEvent](capi-arkui-nativemodule-arkui-textchangeevent.md)。<br> [ArkUI_TextChangeEvent](capi-arkui-nativemodule-arkui-textchangeevent.md)包含参数：<br> <b>ArkUI_TextChangeEvent.pStr</b>：TextArea的内容。<br> <b>ArkUI_TextChangeEvent.pExtendStr</b>：TextArea的预上屏内容。<br> <b>ArkUI_TextChangeEvent.number</b>：TextArea的预上屏起始位置。<br>**起始版本：** 20 | 751| NODE_CHECKBOX_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_CHECKBOX | 定义ARKUI_NODE_CHECKBOX当选中状态发生变化时，触发该回调。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>1:表示已选中, 0: 表示未选中。 | 752| NODE_DATE_PICKER_EVENT_ON_DATE_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_DATE_PICKER | 定义ARKUI_NODE_DATE_PICKER列表组件的滚动触摸事件枚举值。触发该事件的条件：选择日期时触发该事件。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含3个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：表示选中时间的年。<br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：表示选中时间的月，取值范围：[0-11]。<br> <b>ArkUI_NodeComponentEvent.data[2].i32</b>：表示选中时间的天。 | 753| NODE_TIME_PICKER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TIME_PICKER | 定义ARKUI_NODE_TIME_PICKER列表组件的滚动触摸事件枚举值。触发该事件的条件：选择时间时触发该事件。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：表示选中时间的时，取值范围：[0-23]。<br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：表示选中时间的分，取值范围：[0-59]。 | 754| NODE_TEXT_PICKER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT_PICKER | 定义ARKUI_NODE_TEXT_PICKER列表组件的滚动触摸事件枚举值。触发该事件的条件 ：选择文本时触发该事件。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0...11].i32</b>表示选中数据的维度。| 755| NODE_TEXT_PICKER_EVENT_ON_SCROLL_STOP = 15001 | 定义ARKUI_NODE_TEXT_PICKER列表组件的滚动触摸事件枚举值。触发该事件的条件 ：滑动选择文本项停止时触发该事件。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0...11].i32</b>表示选中数据的维度。<br>**起始版本：** 14 | 756| NODE_CALENDAR_PICKER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_CALENDAR_PICKER | 定义NODE_CALENDAR_PICKER选中日期时触发的事件。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> <b>ArkUI_NodeComponent.data[0].u32</b>选中的年。<br> <b>ArkUI_NodeComponent.data[1].u32</b>选中的月。<br> <b>ArkUI_NodeComponent.data[2].u32</b>选中的日。 | 757| NODE_SLIDER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SLIDER | 定义ARKUI_NODE_SLIDER拖动或点击时触发事件回调。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：当前滑动进度值。<br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：事件触发的相关状态值 | 758| NODE_RADIO_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_RADIO | 定义ARKUI_NODE_RADIO拖动或点击时触发事件回调。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：单选框的状态。 | 759| NODE_IMAGE_ANIMATOR_EVENT_ON_START = MAX_NODE_SCOPE_NUM * ARKUI_NODE_IMAGE_ANIMATOR | 定义帧动画开始的状态回调。触发该事件的条件：<br> 1、帧动画开始播放时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 760| NODE_IMAGE_ANIMATOR_EVENT_ON_PAUSE | 定义帧动画播放暂停时的状态回调。触发该事件的条件：<br> 1、帧动画暂停播放时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 761| NODE_IMAGE_ANIMATOR_EVENT_ON_REPEAT | 定义帧动画c重复播放时的状态回调。触发该事件的条件：<br> 1、帧动画重复播放时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 762| NODE_IMAGE_ANIMATOR_EVENT_ON_CANCEL | 定义帧动画返回最初状态时的状态回调。触发该事件的条件：<br> 1、帧动画返回最初状态时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 763| NODE_IMAGE_ANIMATOR_EVENT_ON_FINISH | 定义帧动画播放完成时或者停止播放时的状态回调。触发该事件的条件：<br> 1、帧动画播放完成时或停止播放时。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 764| NODE_CHECKBOX_GROUP_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_CHECKBOX_GROUP | 定义ARKUI_NODE_CHECKBOX_GROUP的选中状态或群组内的Checkbox的选中状态发生变化时，触发该回调。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_StringAsyncEvent](capi-arkui-nativemodule-arkui-stringasyncevent.md)。<br> <b>ArkUI_StringAsyncEvent.pStr</b>Name: 被选中的checkbox的名字;Status:0: 表示群组多选择框全部选择。1: 群组多选择框部分选择。2: 群组多选择框全部没有选择。<br>**起始版本：** 15 | 765| NODE_SWIPER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SWIPER | 定义ARKUI_NODE_SWIPER当前元素索引变化时触发事件回调。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：表示当前显示元素的索引。 | 766| NODE_SWIPER_EVENT_ON_ANIMATION_START | 定义ARKUI_NODE_SWIPER切换动画开始时触发回调。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含5个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：表示当前显示元素的索引。<br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：表示切换动画目标元素的索引。<br> <b>ArkUI_NodeComponentEvent.data[2].f32</b>：表示主轴方向上当前显示元素相对Swiper起始位置的位移。<br> <b>ArkUI_NodeComponentEvent.data[3].f32</b>：表示主轴方向上目标元素相对Swiper起始位置的位移。<br> <b>ArkUI_NodeComponentEvent.data[4].f32</b>：表示离手速度。 | 767| NODE_SWIPER_EVENT_ON_ANIMATION_END | 定义ARKUI_NODE_SWIPER切换动画结束是触发回调。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：表示当前显示元素的索引。<br> <b>ArkUI_NodeComponentEvent.data[1].f32</b>：表示主轴方向上当前显示元素相对Swiper起始位置的位移。 | 768| NODE_SWIPER_EVENT_ON_GESTURE_SWIPE | 定义ARKUI_NODE_SWIPER在页面跟手滑动过程中，逐帧触发该回调。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：表示当前显示元素的索引。<br> <b>ArkUI_NodeComponentEvent.data[1].f32</b>：表示主轴方向上当前显示元素相对Swiper起始位置的位移。 | 769| NODE_SWIPER_EVENT_ON_CONTENT_DID_SCROLL | 定义ARKUI_NODE_SWIPER监听Swiper页面滑动事件。使用说明 ：<br> 1. 设置NODE_SWIPER_DISPLAY_COUNT属性为'auto'时，该接口不生效。<br> 2. 循环场景下，设置prevMargin和nextMargin属性，使得Swiper前后端显示同一页面时，该接口不生效。<br> 3. 在页面滑动过程中，会对视窗内所有页面逐帧触发ContentDidScrollCallback回调。<br> 例如，当视窗内有下标为0、1的两个页面时，会每帧触发两次index值分别为0和1的回调。<br> 4. 设置displayCount属性的swipeByGroup参数为true时，若同组中至少有一个页面在视窗内时，<br> 则会对同组中所有页面触发回调。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含4个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：Swiper组件的索引，和onChange事件中的index值变化保持一致。<br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：视窗内某个页面的索引。<br> <b>ArkUI_NodeComponentEvent.data[2].f32</b>：页面相对于Swiper主轴起始位置（selectedIndex对应页面的起始位置）的移动比例。<br> <b>ArkUI_NodeComponentEvent.data[3].f32</b>：主轴方向上页面的长度。 | 770| NODE_SWIPER_EVENT_ON_SELECTED = 1001005 | 定义当ARKUI_NODE_SWIPER选中元素改变时触发回调。触发该事件的条件：<br> 1、滑动离手时满足翻页阈值，开始切换动画时。<br> 2、通过NODE_SWIPER_INDEX或NODE_SWIPER_SWIPE_TO_INDEX切换页面时。<br> 事件回调发生时, 事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md) 中包含1个参数:<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>: 表示当前选中元素的索引。<br>**起始版本：** 18 | 771| NODE_SWIPER_EVENT_ON_UNSELECTED = 1001006 | 定义当ARKUI_NODE_SWIPER页面切换事件回调。满足以下任一条件，即可触发该事件：<br> 1. 滑动离手时满足翻页阈值，并且开始切换动画。<br> 2. 通过NODE_SWIPER_INDEX或NODE_SWIPER_SWIPE_TO_INDEX切换页面。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md) 中包含1个参数:<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>: 表示将要隐藏元素的索引。<br>**起始版本：** 18 | 772| NODE_SWIPER_EVENT_ON_CONTENT_WILL_SCROLL = 1001007 | 定义ARKUI_NODE_SWIPER滑动行为拦截事件。使用说明: 在页面滑动前, </b>ContentWillScrollCallback</b> 回调会触发。<br> 事件回调发生时， 事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含3个参数:<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>: 当前显示元素的索引。<br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>: 切换动画目标元素的索引。<br> <b>ArkUI_NodeComponentEvent.data[2].f32</b>: 每帧的滑动偏移量。正数表示向后滑动（例如从index=1到index=0），负数表示向前滑动（例如从index=0到index=1）。<br>**起始版本：** 15 | 773| NODE_SWIPER_EVENT_ON_SCROLL_STATE_CHANGED = 1001008 | 定义ARKUI_NODE_SWIPER滑动状态变化事件。触发该事件的条件 ：<br> Swiper在跟手滑动、离手动画、停止三种滑动状态变化时触发。事件回调发生时， 事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数:<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>: 当前滑动状态，参数类型[ArkUI_ScrollState](capi-native-type-h.md#arkui_scrollstate)。<br>**起始版本：** 20 | 774| NODE_SCROLL_EVENT_ON_SCROLL = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SCROLL | 定义滚动容器组件的滚动事件枚举值。触发该事件的条件 ：<br> 1、滚动组件触发滚动时触发，支持键鼠操作等其他触发滚动的输入设置。<br> 2、通过滚动控制器API接口调用。<br> 3、越界回弹。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：表示距离上一次事件触发的X轴增量。<br> <b>ArkUI_NodeComponentEvent.data[1].f32</b>：表示距离上一次事件触发的Y轴增量。 | 775| NODE_SCROLL_EVENT_ON_SCROLL_FRAME_BEGIN | 定义滚动容器组件的滚动帧始事件枚举值。触发该事件的条件 ：<br> 1、滚动组件触发滚动时触发，包括键鼠操作等其他触发滚动的输入设置。<br> 2、调用控制器接口时不触发。<br> 3、越界回弹不触发。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：表示即将发生的滚动量。<br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：表示当前滚动状态。<br> <b>::ArkUI_NodeComponentEvent</b>中包含1个返回值：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：事件处理函数中可根据应用场景计算实际需要的滚动量并存于data[0].f32中，Scroll将按照返回值的实际滚动量进行滚动。 | 776| NODE_SCROLL_EVENT_ON_WILL_SCROLL | 定义滚动容器组件的滑动前触发事件枚举值。触发该事件的条件 ：<br> 1、滚动组件触发滚动时触发，支持键鼠操作等其他触发滚动的输入设置。<br> 2、通过滚动控制器API接口调用。<br> 3、越界回弹。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含4个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：每帧滚动的偏移量，内容向左滚动时偏移量为正，向右滚动时偏移量为负，单位vp。 <br> <b>ArkUI_NodeComponentEvent.data[1].f32</b>：每帧滚动的偏移量，内容向上滚动时偏移量为正，向下滚动时偏移量为负，单位vp。 <br> <b>ArkUI_NodeComponentEvent.data[2].i32</b>：当前滑动状态，参数类型[ArkUI_ScrollState](capi-native-type-h.md#arkui_scrollstate)。<br> <b>ArkUI_NodeComponentEvent.data[3].i32</b>：当前滚动的来源，参数类型[ArkUI_ScrollSource](capi-native-type-h.md#arkui_scrollsource)。 | 777| NODE_SCROLL_EVENT_ON_DID_SCROLL | 定义滚动容器组件的滑动时触发事件枚举值。触发该事件的条件 ：<br> 1、滚动组件触发滚动时触发，支持键鼠操作等其他触发滚动的输入设置。<br> 2、通过滚动控制器API接口调用。<br> 3、越界回弹。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含3个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：每帧滚动的偏移量，内容向左滚动时偏移量为正，向右滚动时偏移量为负，单位vp。 <br> <b>ArkUI_NodeComponentEvent.data[1].f32</b>：每帧滚动的偏移量，内容向上滚动时偏移量为正，向下滚动时偏移量为负，单位vp。 <br> <b>ArkUI_NodeComponentEvent.data[2].i32</b>：当前滑动状态，参数类型[ArkUI_ScrollState](capi-native-type-h.md#arkui_scrollstate)。 | 778| NODE_SCROLL_EVENT_ON_SCROLL_START | 定义滚动容器组件的滚动开始事件枚举值。触发该事件的条件 ：<br> 1、滚动组件开始滚动时触发，支持键鼠操作等其他触发滚动的输入设置。<br> 2、通过滚动控制器API接口调用后开始，带过渡动效。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 779| NODE_SCROLL_EVENT_ON_SCROLL_STOP | 定义滚动容器组件的滚动停止事件枚举值。触发该事件的条件 ：<br> 1、滚动组件触发滚动后停止，支持键鼠操作等其他触发滚动的输入设置。<br> 2、通过滚动控制器API接口调用后停止，带过渡动效。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 780| NODE_SCROLL_EVENT_ON_SCROLL_EDGE | 定义滚动容器组件的滚动边缘事件枚举值。触发该事件的条件 ：<br> 1、滚动组件滚动到边缘时触发，支持键鼠操作等其他触发滚动的输入设置。<br> 2、通过滚动控制器API接口调用。<br> 3、越界回弹。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数。<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：表示当前碰到的是上下左右哪个边。 | 781| NODE_SCROLL_EVENT_ON_REACH_START | 定义滚动容器组件到达起始位置时触发回调。触发该事件的条件 ：<br> 1、组件到达起始位置时触发。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 782| NODE_SCROLL_EVENT_ON_REACH_END | 定义滚动容器组件到底末尾位置时触发回调。触发该事件的条件 ：<br> 1、组件到底末尾位置时触发。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。 | 783| NODE_SCROLL_EVENT_ON_WILL_STOP_DRAGGING | 定义滚动容器组件拖划即将离手回调。触发该事件的条件： <br> 滚动容器组件拖划即将离手时触发。 <br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。 <br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：划动离手速度，单位vp/s。 <br>**起始版本：** 20 | 784| NODE_SCROLL_EVENT_ON_DID_ZOOM | 定义Scroll组件缩放回调。触发该事件的条件：Scroll组件缩放每帧完成时触发。 <br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。 <br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：当前缩放比例。 <br>**起始版本：** 20 | 785| NODE_SCROLL_EVENT_ON_ZOOM_START | 定义Scroll组件缩放开始回调。触发该事件的条件：Scroll组件缩放开始时触发。 <br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。 <br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。<br>**起始版本：** 20 | 786| NODE_SCROLL_EVENT_ON_ZOOM_STOP | 定义Scroll组件缩放停止回调。触发该事件的条件：Scroll组件缩放停止时触发。 <br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。 <br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数。<br>**起始版本：** 20 | 787| NODE_LIST_ON_SCROLL_INDEX = MAX_NODE_SCOPE_NUM * ARKUI_NODE_LIST | 定义ARKUI_NODE_LIST有子组件划入或划出List显示区域时触发事件枚举值。触发该事件的条件 ：<br> 列表初始化时会触发一次，List显示区域内第一个子组件的索引值或最后一个子组件的索引值有变化时会触发。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含3个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：List显示区域内第一个子组件的索引值。<br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：List显示区域内最后一个子组件的索引值。<br> <b>ArkUI_NodeComponentEvent.data[2].i32</b>：List显示区域内中间位置子组件的索引值。 | 788| NODE_LIST_ON_WILL_SCROLL | 定义ARKUI_NODE_LIST组件的滑动前触发事件枚举值。触发该事件的条件 ：<br> 1、滚动组件触发滚动时触发，支持键鼠操作等其他触发滚动的输入设置。<br> 2、通过滚动控制器API接口调用。<br> 3、越界回弹。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含3个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：每帧滚动的偏移量，list内容向上滚动时偏移量为正，向下滚动时偏移量为负。 <br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：当前滑动状态，参数类型[ArkUI_ScrollState](capi-native-type-h.md#arkui_scrollstate)。<br> <b>ArkUI_NodeComponentEvent.data[2].i32</b>：当前滚动的来源，参数类型[ArkUI_ScrollSource](capi-native-type-h.md#arkui_scrollsource)。 | 789| NODE_LIST_ON_DID_SCROLL | 定义ARKUI_NODE_LIST组件的滑动时触发事件枚举值。触发该事件的条件 ：<br> 1、滚动组件触发滚动时触发，支持键鼠操作等其他触发滚动的输入设置。<br> 2、通过滚动控制器API接口调用。<br> 3、越界回弹。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：每帧滚动的偏移量，list内容向上滚动时偏移量为正，向下滚动时偏移量为负。 <br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：当前滑动状态。 | 790| NODE_LIST_ON_SCROLL_VISIBLE_CONTENT_CHANGE | 定义ARKUI_NODE_LIST当前显示内容发生改变的时候触发事件枚举值。触发该事件的条件 ：<br> 列表初始化时会触发一次，List显示区域内第一个子组件的索引值或最后一个子组件的索引值有变化时会触发。计算触发条件时，每一个ListItem、ListItemGroup中的header或footer都算一个子组件。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含3个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：List显示区域内第一个子组件的索引值。 <br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：List显示区域起始端在ListItemGroup中的区域。类型为[ArkUI_ListItemGroupArea](capi-native-type-h.md#arkui_listitemgrouparea)。<br> <b>ArkUI_NodeComponentEvent.data[2].i32</b>：List显示区域起始端在ListItemGroup中的ListItem索引号，如果List显示区域起始端不在ListItem上，该值为-1。 <br> <b>ArkUI_NodeComponentEvent.data[4].i32</b>：List显示区域内最后一个子组件的索引值。 <br> <b>ArkUI_NodeComponentEvent.data[5].i32</b>：List显示区域末尾端在ListItemGroup中的区域。类型为[ArkUI_ListItemGroupArea](capi-native-type-h.md#arkui_listitemgrouparea)。<br> <b>ArkUI_NodeComponentEvent.data[6].i32</b>：List显示区域末尾端在ListItemGroup中的ListItem索引号，如果List显示区域末尾端不在ListItem上，该值为-1。 <br>**起始版本：** 15 | 791| NODE_REFRESH_STATE_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_REFRESH | 定义ARKUI_NODE_REFRESH刷新状态变更触发该事件。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：刷新状态。 | 792| NODE_REFRESH_ON_REFRESH | 定义ARKUI_NODE_REFRESH进入刷新状态时触发该事件。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中不包含参数： | 793| NODE_REFRESH_ON_OFFSET_CHANGE | 定义ARKUI_NODE_REFRESH下拉距离发生变化时触发该事件。事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含1个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：下拉距离。 | 794| NODE_ON_WILL_SCROLL = MAX_NODE_SCOPE_NUM * ARKUI_NODE_WATER_FLOW | 定义ARKUI_NODE_WATER_FLOW组件的滑动前触发事件枚举值。触发该事件的条件 ：<br> 1、滚动组件触发滚动时触发，支持键鼠操作等其他触发滚动的输入设置。<br> 2、通过滚动控制器API接口调用。<br> 3、越界回弹。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含3个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：每帧滚动的偏移量，内容向上滚动时偏移量为正，向下滚动时偏移量为负。 <br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：当前滑动状态，参数类型[ArkUI_ScrollState](capi-native-type-h.md#arkui_scrollstate)。<br> <b>ArkUI_NodeComponentEvent.data[2].i32</b>：当前滚动的来源，参数类型[ArkUI_ScrollSource](capi-native-type-h.md#arkui_scrollsource)。 | 795| NODE_WATER_FLOW_ON_DID_SCROLL | 定义ARKUI_NODE_WATER_FLOW组件的滑动时触发事件枚举值。触发该事件的条件 ：<br> 1、滚动组件触发滚动时触发，支持键鼠操作等其他触发滚动的输入设置。<br> 2、通过滚动控制器API接口调用。<br> 3、越界回弹。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含2个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].f32</b>：每帧滚动的偏移量，内容向上滚动时偏移量为正，向下滚动时偏移量为负。 <br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：当前滑动状态。 | 796| NODE_WATER_FLOW_ON_SCROLL_INDEX | 定义ARKUI_NODE_WATER_FLOW当前瀑布流显示的起始位置/终止位置的子组件发生变化时触发事件枚举值。触发该事件的条件 ：<br> 瀑布流显示区域上第一个子组件/最后一个组件的索引值有变化就会触发。<br> 事件回调发生时，事件参数[ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)对象中的联合体类型为[ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)。<br> [ArkUI_NodeComponentEvent](capi-arkui-nativemodule-arkui-nodecomponentevent.md)中包含3个参数：<br> <b>ArkUI_NodeComponentEvent.data[0].i32</b>：当前显示的WaterFlow起始位置的索引值。 <br> <b>ArkUI_NodeComponentEvent.data[1].i32</b>：当前显示的瀑布流终止位置的索引值。 | 797 798### ArkUI_NodeDirtyFlag 799 800``` 801enum ArkUI_NodeDirtyFlag 802``` 803 804**描述：** 805 806 807自定义组件调用<b>::markDirty</b>时，传递的脏区标识类型。 808 809**起始版本：** 12 810 811| 枚举项 | 描述 | 812| -- | -- | 813| NODE_NEED_MEASURE = 1 | 重新测算大小。该flag类型触发时，同时也默认会触发重新布局。 | 814| NODE_NEED_LAYOUT | 重新布局位置。 | 815| NODE_NEED_RENDER | 重新进行绘制。 | 816 817### ArkUI_NodeCustomEventType 818 819``` 820enum ArkUI_NodeCustomEventType 821``` 822 823**描述：** 824 825 826定义自定义组件事件类型。 827 828**起始版本：** 12 829 830| 枚举项 | 描述 | 831| -- | -- | 832| ARKUI_NODE_CUSTOM_EVENT_ON_MEASURE = 1 << 0 | 自定义测量类型。 | 833| ARKUI_NODE_CUSTOM_EVENT_ON_LAYOUT = 1 << 1 | 自定义布局类型。 | 834| ARKUI_NODE_CUSTOM_EVENT_ON_DRAW = 1 << 2 | 自定义内容层绘制类型。 | 835| ARKUI_NODE_CUSTOM_EVENT_ON_FOREGROUND_DRAW = 1 << 3 | 自定义前景绘制类型。 | 836| ARKUI_NODE_CUSTOM_EVENT_ON_OVERLAY_DRAW = 1 << 4 | 自定义浮层绘制类型。 | 837| ARKUI_NODE_CUSTOM_EVENT_ON_DRAW_FRONT = 1 << 5 | 自定义内容层前景绘制类型。 <br>**起始版本：** 20 | 838| ARKUI_NODE_CUSTOM_EVENT_ON_DRAW_BEHIND = 1 << 6 | 自定义内容层背景绘制类型。 <br>**起始版本：** 20 | 839 840### ArkUI_NodeAdapterEventType 841 842``` 843enum ArkUI_NodeAdapterEventType 844``` 845 846**描述：** 847 848 849定义节点适配器事件枚举值。 850 851**起始版本：** 12 852 853| 枚举项 | 描述 | 854| -- | -- | 855| NODE_ADAPTER_EVENT_WILL_ATTACH_TO_NODE = 1 | 组件和adapter关联时产生该事件。 | 856| NODE_ADAPTER_EVENT_WILL_DETACH_FROM_NODE = 2 | 组件和adapter取消关联时产生该事件。 | 857| NODE_ADAPTER_EVENT_ON_GET_NODE_ID = 3 | Adapter需要添加新元素时获取新元素的唯一标识符时产生该事件。 | 858| NODE_ADAPTER_EVENT_ON_ADD_NODE_TO_ADAPTER = 4 | Adapter需要添加新元素时获取新元素的内容时产生该事件。 | 859| NODE_ADAPTER_EVENT_ON_REMOVE_NODE_FROM_ADAPTER = 5 | Adapter将元素移除时产生该事件。 | 860 861### ArkUI_NodeContentEventType 862 863``` 864enum ArkUI_NodeContentEventType 865``` 866 867**描述：** 868 869 870定义NodeContent事件类型。 871 872**起始版本：** 12 873 874| 枚举项 | 描述 | 875| -- | -- | 876| NODE_CONTENT_EVENT_ON_ATTACH_TO_WINDOW = 0 | 上树事件。 | 877| NODE_CONTENT_EVENT_ON_DETACH_FROM_WINDOW = 1 | 下树事件。 | 878 879### ArkUI_InspectorErrorCode 880 881``` 882enum ArkUI_InspectorErrorCode 883``` 884 885**描述：** 886 887 888inspector错误码的枚举。 889 890**起始版本：** 15 891 892| 枚举项 | 描述 | 893| -- | -- | 894| ARKUI_INSPECTOR_NATIVE_RESULT_SUCCESSFUL = 0 | 成功。 | 895| ARKUI_INSPECTOR_NATIVE_RESULT_BAD_PARAMETER = -1 | 参数错误。 | 896 897 898## 函数说明 899 900### OH_ArkUI_NodeEvent_GetEventType() 901 902``` 903ArkUI_NodeEventType OH_ArkUI_NodeEvent_GetEventType(ArkUI_NodeEvent* event) 904``` 905 906**描述：** 907 908 909获取组件事件类型。 910 911**起始版本：** 12 912 913 914**参数：** 915 916| 参数项 | 描述 | 917| -- | -- | 918| [ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)* event | 组件事件指针。 | 919 920**返回：** 921 922| 类型 | 说明 | 923| -- | -- | 924| [ArkUI_NodeEventType](capi-native-node-h.md#arkui_nodeeventtype) | ArkUI_NodeEventType 组件事件类型。 | 925 926### OH_ArkUI_NodeEvent_GetTargetId() 927 928``` 929int32_t OH_ArkUI_NodeEvent_GetTargetId(ArkUI_NodeEvent* event) 930``` 931 932**描述：** 933 934 935获取事件自定义标识ID。该事件id在调用[registerNodeEvent](capi-arkui-nativemodule-arkui-nativenodeapi-1.md#registernodeevent)函数时作为参数传递进来，可应用于同一事件入口函数[registerNodeEventReceiver](capi-arkui-nativemodule-arkui-nativenodeapi-1.md#registernodeeventreceiver)分发逻辑。 936 937**起始版本：** 12 938 939 940**参数：** 941 942| 参数项 | 描述 | 943| -- | -- | 944| [ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)* event | 组件事件指针。 | 945 946**返回：** 947 948| 类型 | 说明 | 949| -- | -- | 950| int32_t | int32_t 事件自定义标识ID。 | 951 952### OH_ArkUI_NodeEvent_GetNodeHandle() 953 954``` 955ArkUI_NodeHandle OH_ArkUI_NodeEvent_GetNodeHandle(ArkUI_NodeEvent* event) 956``` 957 958**描述：** 959 960 961获取触发该事件的组件对象。 962 963**起始版本：** 12 964 965 966**参数：** 967 968| 参数项 | 描述 | 969| -- | -- | 970| [ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)* event | 组件事件指针。 | 971 972**返回：** 973 974| 类型 | 说明 | 975| -- | -- | 976| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) | ArkUI_NodeHandle 触发该组件的组件对象。 | 977 978### OH_ArkUI_NodeEvent_GetInputEvent() 979 980``` 981ArkUI_UIInputEvent* OH_ArkUI_NodeEvent_GetInputEvent(ArkUI_NodeEvent* event) 982``` 983 984**描述：** 985 986 987获取组件事件中的输入事件（如触碰事件）数据。 988 989**起始版本：** 12 990 991 992**参数：** 993 994| 参数项 | 描述 | 995| -- | -- | 996| [ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)* event | 组件事件指针。 | 997 998**返回：** 999 1000| 类型 | 说明 | 1001| -- | -- | 1002| ArkUI_UIInputEvent* | ArkUI_UIInputEvent 输入事件数据指针。 | 1003 1004### OH_ArkUI_NodeEvent_GetNodeComponentEvent() 1005 1006``` 1007ArkUI_NodeComponentEvent* OH_ArkUI_NodeEvent_GetNodeComponentEvent(ArkUI_NodeEvent* event) 1008``` 1009 1010**描述：** 1011 1012 1013获取组件事件中的数字类型数据。 1014 1015**起始版本：** 12 1016 1017 1018**参数：** 1019 1020| 参数项 | 描述 | 1021| -- | -- | 1022| [ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)* event | 组件事件指针。 | 1023 1024**返回：** 1025 1026| 类型 | 说明 | 1027| -- | -- | 1028| ArkUI_NodeComponentEvent* | ArkUI_NodeComponentEvent 数字类型数据指针。 | 1029 1030### OH_ArkUI_NodeEvent_GetStringAsyncEvent() 1031 1032``` 1033ArkUI_StringAsyncEvent* OH_ArkUI_NodeEvent_GetStringAsyncEvent(ArkUI_NodeEvent* event) 1034``` 1035 1036**描述：** 1037 1038 1039获取组件事件中的字符串数据。 1040 1041**起始版本：** 12 1042 1043 1044**参数：** 1045 1046| 参数项 | 描述 | 1047| -- | -- | 1048| [ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)* event | 组件事件指针。 | 1049 1050**返回：** 1051 1052| 类型 | 说明 | 1053| -- | -- | 1054| ArkUI_StringAsyncEvent* | ArkUI_StringAsyncEvent 字符串数据指针。 | 1055 1056### OH_ArkUI_NodeEvent_GetTextChangeEvent() 1057 1058``` 1059ArkUI_TextChangeEvent* OH_ArkUI_NodeEvent_GetTextChangeEvent(ArkUI_NodeEvent* event) 1060``` 1061 1062**描述：** 1063 1064 1065获取组件事件中的ArkUI_TextChangeEvent数据。 1066 1067**起始版本：** 15 1068 1069 1070**参数：** 1071 1072| 参数项 | 描述 | 1073| -- | -- | 1074| [ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)* event | 组件事件指针，不应为空。 | 1075 1076**返回：** 1077 1078| 类型 | 说明 | 1079| -- | -- | 1080| ArkUI_TextChangeEvent* | 返回ArkUI_TextChangeEvent对象的指针。 | 1081 1082### OH_ArkUI_NodeEvent_GetUserData() 1083 1084``` 1085void* OH_ArkUI_NodeEvent_GetUserData(ArkUI_NodeEvent* event) 1086``` 1087 1088**描述：** 1089 1090 1091获取组件事件中的用户自定义数据。该自定义参数在调用[registerNodeEvent](capi-arkui-nativemodule-arkui-nativenodeapi-1.md#registernodeevent)函数时作为参数传递进来，可应用于事件触发时的业务逻辑处理。 1092 1093**起始版本：** 12 1094 1095 1096**参数：** 1097 1098| 参数项 | 描述 | 1099| -- | -- | 1100| [ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)* event | 组件事件指针。 | 1101 1102**返回：** 1103 1104| 类型 | 说明 | 1105| -- | -- | 1106| void* | void 用户自定义数据指针。 | 1107 1108### OH_ArkUI_NodeEvent_GetNumberValue() 1109 1110``` 1111int32_t OH_ArkUI_NodeEvent_GetNumberValue(ArkUI_NodeEvent* event, int32_t index, ArkUI_NumberValue* value) 1112``` 1113 1114**描述：** 1115 1116 1117获取组件回调事件的数字类型参数。 1118 1119**起始版本：** 12 1120 1121 1122**参数：** 1123 1124| 参数项 | 描述 | 1125| -- | -- | 1126| [ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)* event | 组件事件指针。 | 1127| int32_t index | 返回值索引。 | 1128| [ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)* value | 具体返回值。 | 1129 1130**返回：** 1131 1132| 类型 | 说明 | 1133| -- | -- | 1134| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INDEX_OUT_OF_RANGE](capi-native-type-h.md#arkui_errorcode) 组件事件中参数长度超限。<br> [ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 组件事件中不存在该数据。 | 1135 1136### OH_ArkUI_NodeEvent_GetStringValue() 1137 1138``` 1139int32_t OH_ArkUI_NodeEvent_GetStringValue(ArkUI_NodeEvent* event, int32_t index, char** string, int32_t* stringSize) 1140``` 1141 1142**描述：** 1143 1144 1145获取组件回调事件的字符串类型参数，字符串数据仅在事件回调过程中有效，需要在事件回调外使用建议进行额外拷贝处理。 1146 1147**起始版本：** 12 1148 1149 1150**参数：** 1151 1152| 参数项 | 描述 | 1153| -- | -- | 1154| [ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)* event | 组件事件指针。 | 1155| int32_t index | 返回值索引。 | 1156| char** string | 字符串数组的指针。 | 1157| int32_t* stringSize | 字符串数组的长度。 | 1158 1159**返回：** 1160 1161| 类型 | 说明 | 1162| -- | -- | 1163| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INDEX_OUT_OF_RANGE](capi-native-type-h.md#arkui_errorcode) 组件事件中参数长度超限。<br> [ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 组件事件中不存在该数据。 | 1164 1165### OH_ArkUI_NodeEvent_SetReturnNumberValue() 1166 1167``` 1168int32_t OH_ArkUI_NodeEvent_SetReturnNumberValue(ArkUI_NodeEvent* event, ArkUI_NumberValue* value, int32_t size) 1169``` 1170 1171**描述：** 1172 1173 1174设置组件回调事件的返回值。 1175 1176**起始版本：** 12 1177 1178 1179**参数：** 1180 1181| 参数项 | 描述 | 1182| -- | -- | 1183| [ArkUI_NodeEvent](capi-arkui-nativemodule-arkui-nodeevent.md)* event | 组件事件指针。 | 1184| [ArkUI_NumberValue](capi-arkui-nativemodule-arkui-numbervalue.md)* value | 事件数字类型数组。 | 1185| int32_t size | 数组长度。 | 1186 1187**返回：** 1188 1189| 类型 | 说明 | 1190| -- | -- | 1191| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 组件事件中不存在该数据。 | 1192 1193### OH_ArkUI_NodeAdapter_Create() 1194 1195``` 1196ArkUI_NodeAdapterHandle OH_ArkUI_NodeAdapter_Create() 1197``` 1198 1199**描述：** 1200 1201 1202创建组件适配器对象。 1203 1204**起始版本：** 12 1205 1206**返回：** 1207 1208| 类型 | 说明 | 1209| -- | -- | 1210| [ArkUI_NodeAdapterHandle](capi-arkui-nativemodule-arkui-nodeadapter8h.md) | 组件适配器对象。 | 1211 1212### OH_ArkUI_NodeAdapter_Dispose() 1213 1214``` 1215void OH_ArkUI_NodeAdapter_Dispose(ArkUI_NodeAdapterHandle handle) 1216``` 1217 1218**描述：** 1219 1220 1221销毁组件适配器对象。 1222 1223**起始版本：** 12 1224 1225 1226**参数：** 1227 1228| 参数项 | 描述 | 1229| -- | -- | 1230| [ArkUI_NodeAdapterHandle](capi-arkui-nativemodule-arkui-nodeadapter8h.md) handle | 组件适配器对象。 | 1231 1232### OH_ArkUI_NodeAdapter_SetTotalNodeCount() 1233 1234``` 1235int32_t OH_ArkUI_NodeAdapter_SetTotalNodeCount(ArkUI_NodeAdapterHandle handle, uint32_t size) 1236``` 1237 1238**描述：** 1239 1240 1241设置Adapter中的元素总数。 1242 1243**起始版本：** 12 1244 1245 1246**参数：** 1247 1248| 参数项 | 描述 | 1249| -- | -- | 1250| [ArkUI_NodeAdapterHandle](capi-arkui-nativemodule-arkui-nodeadapter8h.md) handle | 组件适配器对象。 | 1251| uint32_t size | 元素数量。 | 1252 1253**返回：** 1254 1255| 类型 | 说明 | 1256| -- | -- | 1257| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 1258 1259### OH_ArkUI_NodeAdapter_GetTotalNodeCount() 1260 1261``` 1262uint32_t OH_ArkUI_NodeAdapter_GetTotalNodeCount(ArkUI_NodeAdapterHandle handle) 1263``` 1264 1265**描述：** 1266 1267 1268获取Adapter中的元素总数。 1269 1270**起始版本：** 12 1271 1272 1273**参数：** 1274 1275| 参数项 | 描述 | 1276| -- | -- | 1277| [ArkUI_NodeAdapterHandle](capi-arkui-nativemodule-arkui-nodeadapter8h.md) handle | 组件适配器对象。 | 1278 1279**返回：** 1280 1281| 类型 | 说明 | 1282| -- | -- | 1283| uint32_t | Adapter中的元素总数。 | 1284 1285### OH_ArkUI_NodeAdapter_RegisterEventReceiver() 1286 1287``` 1288int32_t OH_ArkUI_NodeAdapter_RegisterEventReceiver( 1289ArkUI_NodeAdapterHandle handle, void* userData, void (*receiver)(ArkUI_NodeAdapterEvent* event)) 1290``` 1291 1292**描述：** 1293 1294 1295注册Adapter相关回调事件。 1296 1297**起始版本：** 12 1298 1299 1300**参数：** 1301 1302| 参数项 | 描述 | 1303| -- | -- | 1304| ArkUI_NodeAdapterHandle handle | 组件适配器对象。 | 1305| void* userData | 自定义数据。 | 1306| receiver | 事件接收回调。 | 1307 1308**返回：** 1309 1310| 类型 | 说明 | 1311| -- | -- | 1312| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 1313 1314### OH_ArkUI_NodeAdapter_UnregisterEventReceiver() 1315 1316``` 1317void OH_ArkUI_NodeAdapter_UnregisterEventReceiver(ArkUI_NodeAdapterHandle handle) 1318``` 1319 1320**描述：** 1321 1322 1323注销Adapter相关回调事件。 1324 1325**起始版本：** 12 1326 1327 1328**参数：** 1329 1330| 参数项 | 描述 | 1331| -- | -- | 1332| [ArkUI_NodeAdapterHandle](capi-arkui-nativemodule-arkui-nodeadapter8h.md) handle | 组件适配器对象。 | 1333 1334### OH_ArkUI_NodeAdapter_ReloadAllItems() 1335 1336``` 1337int32_t OH_ArkUI_NodeAdapter_ReloadAllItems(ArkUI_NodeAdapterHandle handle) 1338``` 1339 1340**描述：** 1341 1342 1343通知Adapter进行全量元素变化。 1344 1345**起始版本：** 12 1346 1347 1348**参数：** 1349 1350| 参数项 | 描述 | 1351| -- | -- | 1352| [ArkUI_NodeAdapterHandle](capi-arkui-nativemodule-arkui-nodeadapter8h.md) handle | 组件适配器对象。 | 1353 1354**返回：** 1355 1356| 类型 | 说明 | 1357| -- | -- | 1358| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 1359 1360### OH_ArkUI_NodeAdapter_ReloadItem() 1361 1362``` 1363int32_t OH_ArkUI_NodeAdapter_ReloadItem( 1364ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount) 1365``` 1366 1367**描述：** 1368 1369 1370通知Adapter进行局部元素变化。 1371 1372**起始版本：** 12 1373 1374 1375**参数：** 1376 1377| 参数项 | 描述 | 1378| -- | -- | 1379| [ArkUI_NodeAdapterHandle](capi-arkui-nativemodule-arkui-nodeadapter8h.md) handle | 组件适配器对象。 | 1380| uint32_t startPosition | 元素变化起始位置。 | 1381| uint32_t itemCount | 元素变化数量。 | 1382 1383**返回：** 1384 1385| 类型 | 说明 | 1386| -- | -- | 1387| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> ERROR_CODE_NATIVE_IMPL_NODE_ADAPTER_NO_LISTENER_ERROR NodeAdapter需要添加监听器。 | 1388 1389### OH_ArkUI_NodeAdapter_RemoveItem() 1390 1391``` 1392int32_t OH_ArkUI_NodeAdapter_RemoveItem( 1393ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount) 1394``` 1395 1396**描述：** 1397 1398 1399通知Adapter进行局部元素删除。 1400 1401**起始版本：** 12 1402 1403 1404**参数：** 1405 1406| 参数项 | 描述 | 1407| -- | -- | 1408| [ArkUI_NodeAdapterHandle](capi-arkui-nativemodule-arkui-nodeadapter8h.md) handle | 组件适配器对象。 | 1409| uint32_t startPosition | 元素删除起始位置。 | 1410| uint32_t itemCount | 元素删除数量。 | 1411 1412**返回：** 1413 1414| 类型 | 说明 | 1415| -- | -- | 1416| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> ERROR_CODE_NATIVE_IMPL_NODE_ADAPTER_NO_LISTENER_ERROR NodeAdapter需要添加监听器。 | 1417 1418### OH_ArkUI_NodeAdapter_InsertItem() 1419 1420``` 1421int32_t OH_ArkUI_NodeAdapter_InsertItem( 1422ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount) 1423``` 1424 1425**描述：** 1426 1427 1428通知Adapter进行局部元素插入。 1429 1430**起始版本：** 12 1431 1432 1433**参数：** 1434 1435| 参数项 | 描述 | 1436| -- | -- | 1437| [ArkUI_NodeAdapterHandle](capi-arkui-nativemodule-arkui-nodeadapter8h.md) handle | 组件适配器对象。 | 1438| uint32_t startPosition | 元素插入起始位置。 | 1439| uint32_t itemCount | 元素插入数量。 | 1440 1441**返回：** 1442 1443| 类型 | 说明 | 1444| -- | -- | 1445| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> ERROR_CODE_NATIVE_IMPL_NODE_ADAPTER_NO_LISTENER_ERROR NodeAdapter需要添加监听器。 | 1446 1447### OH_ArkUI_NodeAdapter_MoveItem() 1448 1449``` 1450int32_t OH_ArkUI_NodeAdapter_MoveItem(ArkUI_NodeAdapterHandle handle, uint32_t from, uint32_t to) 1451``` 1452 1453**描述：** 1454 1455 1456通知Adapter进行局部元素移位。 1457 1458**起始版本：** 12 1459 1460 1461**参数：** 1462 1463| 参数项 | 描述 | 1464| -- | -- | 1465| [ArkUI_NodeAdapterHandle](capi-arkui-nativemodule-arkui-nodeadapter8h.md) handle | 组件适配器对象。 | 1466| uint32_t from | 元素移位起始位置。 | 1467| uint32_t to | 元素移位结束位置。 | 1468 1469**返回：** 1470 1471| 类型 | 说明 | 1472| -- | -- | 1473| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> ERROR_CODE_NATIVE_IMPL_NODE_ADAPTER_NO_LISTENER_ERROR NodeAdapter需要添加监听器。 | 1474 1475### OH_ArkUI_NodeAdapter_GetAllItems() 1476 1477``` 1478int32_t OH_ArkUI_NodeAdapter_GetAllItems(ArkUI_NodeAdapterHandle handle, ArkUI_NodeHandle** items, uint32_t* size) 1479``` 1480 1481**描述：** 1482 1483 1484获取存储在Adapter中的所有元素。接口调用会返回元素的数组对象指针，该指针指向的内存数据需要开发者手动释放。 1485 1486**起始版本：** 12 1487 1488 1489**参数：** 1490 1491| 参数项 | 描述 | 1492| -- | -- | 1493| [ArkUI_NodeAdapterHandle](capi-arkui-nativemodule-arkui-nodeadapter8h.md) handle | 组件适配器对象。 | 1494| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md)** items | 适配器内节点数组。 | 1495| uint32_t* size | 元素数量。 | 1496 1497**返回：** 1498 1499| 类型 | 说明 | 1500| -- | -- | 1501| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> ERROR_CODE_NATIVE_IMPL_NODE_ADAPTER_NO_LISTENER_ERROR NodeAdapter需要添加监听器。 | 1502 1503### OH_ArkUI_NodeAdapterEvent_GetUserData() 1504 1505``` 1506void* OH_ArkUI_NodeAdapterEvent_GetUserData(ArkUI_NodeAdapterEvent* event) 1507``` 1508 1509**描述：** 1510 1511 1512获取注册事件时传入的自定义数据。 1513 1514**起始版本：** 12 1515 1516 1517**参数：** 1518 1519| 参数项 | 描述 | 1520| -- | -- | 1521| [ArkUI_NodeAdapterEvent](capi-arkui-nativemodule-arkui-nodeadapterevent.md)* event | 适配器事件对象。 | 1522 1523**返回：** 1524 1525| 类型 | 说明 | 1526| -- | -- | 1527| void* | 用户自定义数据的指针。 | 1528 1529### OH_ArkUI_NodeAdapterEvent_GetType() 1530 1531``` 1532ArkUI_NodeAdapterEventType OH_ArkUI_NodeAdapterEvent_GetType(ArkUI_NodeAdapterEvent* event) 1533``` 1534 1535**描述：** 1536 1537 1538获取事件类型。 1539 1540**起始版本：** 12 1541 1542 1543**参数：** 1544 1545| 参数项 | 描述 | 1546| -- | -- | 1547| [ArkUI_NodeAdapterEvent](capi-arkui-nativemodule-arkui-nodeadapterevent.md)* event | 适配器事件对象。 | 1548 1549**返回：** 1550 1551| 类型 | 说明 | 1552| -- | -- | 1553| [ArkUI_NodeAdapterEventType](capi-native-node-h.md#arkui_nodeadaptereventtype) | 事件类型。 | 1554 1555### OH_ArkUI_NodeAdapterEvent_GetRemovedNode() 1556 1557``` 1558ArkUI_NodeHandle OH_ArkUI_NodeAdapterEvent_GetRemovedNode(ArkUI_NodeAdapterEvent* event) 1559``` 1560 1561**描述：** 1562 1563 1564获取需要销毁的事件中待销毁的元素。 1565 1566**起始版本：** 12 1567 1568 1569**参数：** 1570 1571| 参数项 | 描述 | 1572| -- | -- | 1573| [ArkUI_NodeAdapterEvent](capi-arkui-nativemodule-arkui-nodeadapterevent.md)* event | 适配器事件对象。 | 1574 1575**返回：** 1576 1577| 类型 | 说明 | 1578| -- | -- | 1579| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) | 待销毁的元素。 | 1580 1581### OH_ArkUI_NodeAdapterEvent_GetItemIndex() 1582 1583``` 1584uint32_t OH_ArkUI_NodeAdapterEvent_GetItemIndex(ArkUI_NodeAdapterEvent* event) 1585``` 1586 1587**描述：** 1588 1589 1590获取适配器事件时需要操作的元素序号。 1591 1592**起始版本：** 12 1593 1594 1595**参数：** 1596 1597| 参数项 | 描述 | 1598| -- | -- | 1599| [ArkUI_NodeAdapterEvent](capi-arkui-nativemodule-arkui-nodeadapterevent.md)* event | 适配器事件对象。 | 1600 1601**返回：** 1602 1603| 类型 | 说明 | 1604| -- | -- | 1605| uint32_t | 元素序号。 | 1606 1607### OH_ArkUI_NodeAdapterEvent_GetHostNode() 1608 1609``` 1610ArkUI_NodeHandle OH_ArkUI_NodeAdapterEvent_GetHostNode(ArkUI_NodeAdapterEvent* event) 1611``` 1612 1613**描述：** 1614 1615 1616获取使用该适配器的滚动类容器节点。 1617 1618**起始版本：** 12 1619 1620 1621**参数：** 1622 1623| 参数项 | 描述 | 1624| -- | -- | 1625| [ArkUI_NodeAdapterEvent](capi-arkui-nativemodule-arkui-nodeadapterevent.md)* event | 适配器事件对象。 | 1626 1627**返回：** 1628 1629| 类型 | 说明 | 1630| -- | -- | 1631| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) | 适配器的滚动类容器节点。 | 1632 1633### OH_ArkUI_NodeAdapterEvent_SetItem() 1634 1635``` 1636int32_t OH_ArkUI_NodeAdapterEvent_SetItem(ArkUI_NodeAdapterEvent* event, ArkUI_NodeHandle node) 1637``` 1638 1639**描述：** 1640 1641 1642设置需要新增到Adapter中的组件。 1643 1644**起始版本：** 12 1645 1646 1647**参数：** 1648 1649| 参数项 | 描述 | 1650| -- | -- | 1651| [ArkUI_NodeAdapterEvent](capi-arkui-nativemodule-arkui-nodeadapterevent.md)* event | 适配器事件对象。 | 1652| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 待添加的组件。 | 1653 1654**返回：** 1655 1656| 类型 | 说明 | 1657| -- | -- | 1658| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 1659 1660### OH_ArkUI_NodeAdapterEvent_SetNodeId() 1661 1662``` 1663int32_t OH_ArkUI_NodeAdapterEvent_SetNodeId(ArkUI_NodeAdapterEvent* event, int32_t id) 1664``` 1665 1666**描述：** 1667 1668 1669设置生成的组件标识。 1670 1671**起始版本：** 12 1672 1673 1674**参数：** 1675 1676| 参数项 | 描述 | 1677| -- | -- | 1678| [ArkUI_NodeAdapterEvent](capi-arkui-nativemodule-arkui-nodeadapterevent.md)* event | 适配器事件对象。 | 1679| int32_t id | 设置返回的组件标识。 | 1680 1681**返回：** 1682 1683| 类型 | 说明 | 1684| -- | -- | 1685| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 1686 1687### OH_ArkUI_NodeCustomEvent_GetLayoutConstraintInMeasure() 1688 1689``` 1690ArkUI_LayoutConstraint* OH_ArkUI_NodeCustomEvent_GetLayoutConstraintInMeasure(ArkUI_NodeCustomEvent* event) 1691``` 1692 1693**描述：** 1694 1695 1696通过自定义组件事件获取测算过程中的约束尺寸。 1697 1698**起始版本：** 12 1699 1700 1701**参数：** 1702 1703| 参数项 | 描述 | 1704| -- | -- | 1705| [ArkUI_NodeCustomEvent](capi-arkui-nativemodule-arkui-nodecustomevent.md)* event | 自定义组件事件。 | 1706 1707**返回：** 1708 1709| 类型 | 说明 | 1710| -- | -- | 1711| ArkUI_LayoutConstraint* | 约束尺寸指针。 | 1712 1713### OH_ArkUI_NodeCustomEvent_GetPositionInLayout() 1714 1715``` 1716ArkUI_IntOffset OH_ArkUI_NodeCustomEvent_GetPositionInLayout(ArkUI_NodeCustomEvent* event) 1717``` 1718 1719**描述：** 1720 1721 1722通过自定义组件事件获取在布局阶段期望自身相对父组件的位置。 1723 1724**起始版本：** 12 1725 1726 1727**参数：** 1728 1729| 参数项 | 描述 | 1730| -- | -- | 1731| [ArkUI_NodeCustomEvent](capi-arkui-nativemodule-arkui-nodecustomevent.md)* event | 自定义组件事件。 | 1732 1733**返回：** 1734 1735| 类型 | 说明 | 1736| -- | -- | 1737| [ArkUI_IntOffset](capi-arkui-nativemodule-arkui-intoffset.md) | 期望自身相对父组件的位置。 | 1738 1739### OH_ArkUI_NodeCustomEvent_GetDrawContextInDraw() 1740 1741``` 1742ArkUI_DrawContext* OH_ArkUI_NodeCustomEvent_GetDrawContextInDraw(ArkUI_NodeCustomEvent* event) 1743``` 1744 1745**描述：** 1746 1747 1748通过自定义组件事件获取绘制上下文。 1749 1750**起始版本：** 12 1751 1752 1753**参数：** 1754 1755| 参数项 | 描述 | 1756| -- | -- | 1757| [ArkUI_NodeCustomEvent](capi-arkui-nativemodule-arkui-nodecustomevent.md)* event | 自定义组件事件。 | 1758 1759**返回：** 1760 1761| 类型 | 说明 | 1762| -- | -- | 1763| ArkUI_DrawContext* | 绘制上下文。 | 1764 1765### OH_ArkUI_NodeCustomEvent_GetEventTargetId() 1766 1767``` 1768int32_t OH_ArkUI_NodeCustomEvent_GetEventTargetId(ArkUI_NodeCustomEvent* event) 1769``` 1770 1771**描述：** 1772 1773 1774通过自定义组件事件获取自定义事件ID。 1775 1776**起始版本：** 12 1777 1778 1779**参数：** 1780 1781| 参数项 | 描述 | 1782| -- | -- | 1783| [ArkUI_NodeCustomEvent](capi-arkui-nativemodule-arkui-nodecustomevent.md)* event | 自定义组件事件。 | 1784 1785**返回：** 1786 1787| 类型 | 说明 | 1788| -- | -- | 1789| int32_t | 自定义事件ID。 | 1790 1791### OH_ArkUI_NodeCustomEvent_GetUserData() 1792 1793``` 1794void* OH_ArkUI_NodeCustomEvent_GetUserData(ArkUI_NodeCustomEvent* event) 1795``` 1796 1797**描述：** 1798 1799 1800通过自定义组件事件获取自定义事件参数。 1801 1802**起始版本：** 12 1803 1804 1805**参数：** 1806 1807| 参数项 | 描述 | 1808| -- | -- | 1809| [ArkUI_NodeCustomEvent](capi-arkui-nativemodule-arkui-nodecustomevent.md)* event | 自定义组件事件。 | 1810 1811**返回：** 1812 1813| 类型 | 说明 | 1814| -- | -- | 1815| void* | 自定义事件参数。 | 1816 1817### OH_ArkUI_NodeCustomEvent_GetNodeHandle() 1818 1819``` 1820ArkUI_NodeHandle OH_ArkUI_NodeCustomEvent_GetNodeHandle(ArkUI_NodeCustomEvent* event) 1821``` 1822 1823**描述：** 1824 1825 1826通过自定义组件事件获取组件对象。 1827 1828**起始版本：** 12 1829 1830 1831**参数：** 1832 1833| 参数项 | 描述 | 1834| -- | -- | 1835| [ArkUI_NodeCustomEvent](capi-arkui-nativemodule-arkui-nodecustomevent.md)* event | 自定义组件事件。 | 1836 1837**返回：** 1838 1839| 类型 | 说明 | 1840| -- | -- | 1841| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) | 组件对象。 | 1842 1843### OH_ArkUI_NodeCustomEvent_GetEventType() 1844 1845``` 1846ArkUI_NodeCustomEventType OH_ArkUI_NodeCustomEvent_GetEventType(ArkUI_NodeCustomEvent* event) 1847``` 1848 1849**描述：** 1850 1851 1852通过自定义组件事件获取事件类型。 1853 1854**起始版本：** 12 1855 1856 1857**参数：** 1858 1859| 参数项 | 描述 | 1860| -- | -- | 1861| [ArkUI_NodeCustomEvent](capi-arkui-nativemodule-arkui-nodecustomevent.md)* event | 自定义组件事件。 | 1862 1863**返回：** 1864 1865| 类型 | 说明 | 1866| -- | -- | 1867| [ArkUI_NodeCustomEventType](capi-native-node-h.md#arkui_nodecustomeventtype) | 组件自定义事件类型。 | 1868 1869### OH_ArkUI_NodeCustomEvent_GetCustomSpanMeasureInfo() 1870 1871``` 1872int32_t OH_ArkUI_NodeCustomEvent_GetCustomSpanMeasureInfo(ArkUI_NodeCustomEvent* event, ArkUI_CustomSpanMeasureInfo* info) 1873``` 1874 1875**描述：** 1876 1877 1878通过自定义组件事件获取自定义段落组件的测量信息。 1879 1880**起始版本：** 12 1881 1882 1883**参数：** 1884 1885| 参数项 | 描述 | 1886| -- | -- | 1887| [ArkUI_NodeCustomEvent](capi-arkui-nativemodule-arkui-nodecustomevent.md)* event | 自定义组件事件。 | 1888| [ArkUI_CustomSpanMeasureInfo](capi-arkui-nativemodule-arkui-customspanmeasureinfo.md)* info | 需要获取的测量信息。 | 1889 1890**返回：** 1891 1892| 类型 | 说明 | 1893| -- | -- | 1894| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> 异常原因：传入参数验证失败，参数不能为空。 | 1895 1896### OH_ArkUI_NodeCustomEvent_SetCustomSpanMetrics() 1897 1898``` 1899int32_t OH_ArkUI_NodeCustomEvent_SetCustomSpanMetrics(ArkUI_NodeCustomEvent* event, ArkUI_CustomSpanMetrics* metrics) 1900``` 1901 1902**描述：** 1903 1904 1905通过自定义组件事件设置自定义段落的度量指标。 1906 1907**起始版本：** 12 1908 1909 1910**参数：** 1911 1912| 参数项 | 描述 | 1913| -- | -- | 1914| [ArkUI_NodeCustomEvent](capi-arkui-nativemodule-arkui-nodecustomevent.md)* event | 自定义组件事件。 | 1915| [ArkUI_CustomSpanMetrics](capi-arkui-nativemodule-arkui-customspanmetrics.md)* metrics | 需要获取的度量指标信息。 | 1916 1917**返回：** 1918 1919| 类型 | 说明 | 1920| -- | -- | 1921| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> 异常原因：传入参数验证失败，参数不能为空。 | 1922 1923### OH_ArkUI_NodeCustomEvent_GetCustomSpanDrawInfo() 1924 1925``` 1926int32_t OH_ArkUI_NodeCustomEvent_GetCustomSpanDrawInfo(ArkUI_NodeCustomEvent* event, ArkUI_CustomSpanDrawInfo* info) 1927``` 1928 1929**描述：** 1930 1931 1932通过自定义组件事件获取自定义段落组件的绘制信息。 1933 1934**起始版本：** 12 1935 1936 1937**参数：** 1938 1939| 参数项 | 描述 | 1940| -- | -- | 1941| [ArkUI_NodeCustomEvent](capi-arkui-nativemodule-arkui-nodecustomevent.md)* event | 自定义组件事件。 | 1942| [ArkUI_CustomSpanDrawInfo](capi-arkui-nativemodule-arkui-customspandrawinfo.md)* info | 需要获取的绘制信息。 | 1943 1944**返回：** 1945 1946| 类型 | 说明 | 1947| -- | -- | 1948| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> 异常原因：传入参数验证失败，参数不能为空。 | 1949 1950### ArkUI_NodeContentCallback() 1951 1952``` 1953typedef void (*ArkUI_NodeContentCallback)(ArkUI_NodeContentEvent* event) 1954``` 1955 1956**描述：** 1957 1958 1959定义NodeContent事件的回调函数类型。 1960 1961**起始版本：** 12 1962 1963 1964**参数：** 1965 1966| 参数项 | 描述 | 1967| -- | -- | 1968| [ArkUI_NodeContentEvent](capi-arkui-nativemodule-arkui-nodecontentevent.md)* event | NodeContent事件指针。 | 1969 1970### OH_ArkUI_NodeContent_RegisterCallback() 1971 1972``` 1973int32_t OH_ArkUI_NodeContent_RegisterCallback(ArkUI_NodeContentHandle content, ArkUI_NodeContentCallback callback) 1974``` 1975 1976**描述：** 1977 1978 1979注册NodeContent事件函数。 1980 1981**起始版本：** 12 1982 1983 1984**参数：** 1985 1986| 参数项 | 描述 | 1987| -- | -- | 1988| [ArkUI_NodeContentHandle](capi-arkui-nativemodule-arkui-nodecontent8h.md) content | 需要注册事件的NodeContent对象。 | 1989| [ArkUI_NodeContentCallback](capi-native-node-h.md#arkui_nodecontentcallback) callback | 事件触发时需要执行的函数回调。 | 1990 1991**返回：** 1992 1993| 类型 | 说明 | 1994| -- | -- | 1995| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 1996 1997### OH_ArkUI_NodeContentEvent_GetEventType() 1998 1999``` 2000ArkUI_NodeContentEventType OH_ArkUI_NodeContentEvent_GetEventType(ArkUI_NodeContentEvent* event) 2001``` 2002 2003**描述：** 2004 2005 2006获取触发NodeContent事件的事件类型。 2007 2008**起始版本：** 12 2009 2010 2011**参数：** 2012 2013| 参数项 | 描述 | 2014| -- | -- | 2015| [ArkUI_NodeContentEvent](capi-arkui-nativemodule-arkui-nodecontentevent.md)* event | NodeContent事件指针。 | 2016 2017**返回：** 2018 2019| 类型 | 说明 | 2020| -- | -- | 2021| [ArkUI_NodeContentEventType](capi-native-node-h.md#arkui_nodecontenteventtype) | NodeContent事件类型。 | 2022 2023### OH_ArkUI_NodeContentEvent_GetNodeContentHandle() 2024 2025``` 2026ArkUI_NodeContentHandle OH_ArkUI_NodeContentEvent_GetNodeContentHandle(ArkUI_NodeContentEvent* event) 2027``` 2028 2029**描述：** 2030 2031 2032获取触发事件的NodeContent对象。 2033 2034**起始版本：** 12 2035 2036 2037**参数：** 2038 2039| 参数项 | 描述 | 2040| -- | -- | 2041| [ArkUI_NodeContentEvent](capi-arkui-nativemodule-arkui-nodecontentevent.md)* event | NodeContent事件指针。 | 2042 2043**返回：** 2044 2045| 类型 | 说明 | 2046| -- | -- | 2047| [ArkUI_NodeContentHandle](capi-arkui-nativemodule-arkui-nodecontent8h.md) | Returns 触发事件的NodeContent对象。 | 2048 2049### OH_ArkUI_NodeContent_SetUserData() 2050 2051``` 2052int32_t OH_ArkUI_NodeContent_SetUserData(ArkUI_NodeContentHandle content, void* userData) 2053``` 2054 2055**描述：** 2056 2057 2058在NodeContent对象上保存自定义数据。 2059 2060**起始版本：** 12 2061 2062 2063**参数：** 2064 2065| 参数项 | 描述 | 2066| -- | -- | 2067| [ArkUI_NodeContentHandle](capi-arkui-nativemodule-arkui-nodecontent8h.md) content | 需要保存自定义数据的NodeContent对象。 | 2068| void* userData | 要保存的自定义数据。 | 2069 2070**返回：** 2071 2072| 类型 | 说明 | 2073| -- | -- | 2074| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2075 2076### OH_ArkUI_NodeContent_GetUserData() 2077 2078``` 2079void* OH_ArkUI_NodeContent_GetUserData(ArkUI_NodeContentHandle content) 2080``` 2081 2082**描述：** 2083 2084 2085获取在NodeContent对象上保存的自定义数据。 2086 2087**起始版本：** 12 2088 2089 2090**参数：** 2091 2092| 参数项 | 描述 | 2093| -- | -- | 2094| [ArkUI_NodeContentHandle](capi-arkui-nativemodule-arkui-nodecontent8h.md) content | 需要保存自定义数据的NodeContent对象。 | 2095 2096**返回：** 2097 2098| 类型 | 说明 | 2099| -- | -- | 2100| void* | 自定义数据。 | 2101 2102### OH_ArkUI_NodeContent_AddNode() 2103 2104``` 2105int32_t OH_ArkUI_NodeContent_AddNode(ArkUI_NodeContentHandle content, ArkUI_NodeHandle node) 2106``` 2107 2108**描述：** 2109 2110 2111将一个ArkUI组件节点添加到对应的NodeContent对象下。 2112 2113**起始版本：** 12 2114 2115 2116**参数：** 2117 2118| 参数项 | 描述 | 2119| -- | -- | 2120| [ArkUI_NodeContentHandle](capi-arkui-nativemodule-arkui-nodecontent8h.md) content | 需要被添加节点的NodeContent对象。 | 2121| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 需要被添加的节点。 | 2122 2123**返回：** 2124 2125| 类型 | 说明 | 2126| -- | -- | 2127| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2128 2129### OH_ArkUI_NodeContent_RemoveNode() 2130 2131``` 2132int32_t OH_ArkUI_NodeContent_RemoveNode(ArkUI_NodeContentHandle content, ArkUI_NodeHandle node) 2133``` 2134 2135**描述：** 2136 2137 2138删除NodeContent对象下的一个ArkUI组件节点。 2139 2140**起始版本：** 12 2141 2142 2143**参数：** 2144 2145| 参数项 | 描述 | 2146| -- | -- | 2147| [ArkUI_NodeContentHandle](capi-arkui-nativemodule-arkui-nodecontent8h.md) content | 需要被删除节点的NodeContent对象。 | 2148| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 需要被删除的节点。 | 2149 2150**返回：** 2151 2152| 类型 | 说明 | 2153| -- | -- | 2154| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2155 2156### OH_ArkUI_NodeContent_InsertNode() 2157 2158``` 2159int32_t OH_ArkUI_NodeContent_InsertNode(ArkUI_NodeContentHandle content, ArkUI_NodeHandle node, int32_t position) 2160``` 2161 2162**描述：** 2163 2164 2165将一个ArkUI组件节点插入到对应的NodeContent对象的特定位置下。 2166 2167**起始版本：** 12 2168 2169 2170**参数：** 2171 2172| 参数项 | 描述 | 2173| -- | -- | 2174| [ArkUI_NodeContentHandle](capi-arkui-nativemodule-arkui-nodecontent8h.md) content | 需要被插入节点的NodeContent对象。 | 2175| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 需要被插入的节点。 | 2176| int32_t position | 需要被插入的位置。 | 2177 2178**返回：** 2179 2180| 类型 | 说明 | 2181| -- | -- | 2182| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2183 2184### OH_ArkUI_NodeUtils_GetLayoutSize() 2185 2186``` 2187int32_t OH_ArkUI_NodeUtils_GetLayoutSize(ArkUI_NodeHandle node, ArkUI_IntSize* size) 2188``` 2189 2190**描述：** 2191 2192 2193获取组件布局区域的大小。布局区域大小不包含图形变化属性，如缩放。 2194 2195**起始版本：** 12 2196 2197 2198**参数：** 2199 2200| 参数项 | 描述 | 2201| -- | -- | 2202| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | ArkUI_NodeHandle指针。 | 2203| [ArkUI_IntSize](capi-arkui-nativemodule-arkui-intsize.md)* size | 组件handle的绘制区域尺寸，单位：px。 | 2204 2205**返回：** 2206 2207| 类型 | 说明 | 2208| -- | -- | 2209| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2210 2211### OH_ArkUI_NodeUtils_GetLayoutPosition() 2212 2213``` 2214int32_t OH_ArkUI_NodeUtils_GetLayoutPosition(ArkUI_NodeHandle node, ArkUI_IntOffset* localOffset) 2215``` 2216 2217**描述：** 2218 2219 2220获取组件布局区域相对父组件的位置。布局区域相对位置不包含图形变化属性，如平移。 2221 2222**起始版本：** 12 2223 2224 2225**参数：** 2226 2227| 参数项 | 描述 | 2228| -- | -- | 2229| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | ArkUI_NodeHandle指针。 | 2230| [ArkUI_IntOffset](capi-arkui-nativemodule-arkui-intoffset.md)* localOffset | 组件handle相对父组件的偏移值，单位：px。 | 2231 2232**返回：** 2233 2234| 类型 | 说明 | 2235| -- | -- | 2236| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2237 2238### OH_ArkUI_NodeUtils_GetLayoutPositionInWindow() 2239 2240``` 2241int32_t OH_ArkUI_NodeUtils_GetLayoutPositionInWindow(ArkUI_NodeHandle node, ArkUI_IntOffset* globalOffset) 2242``` 2243 2244**描述：** 2245 2246 2247获取组件布局区域相对窗口的位置。布局区域相对位置不包含图形变化属性，如平移。 2248 2249**起始版本：** 12 2250 2251 2252**参数：** 2253 2254| 参数项 | 描述 | 2255| -- | -- | 2256| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | ArkUI_NodeHandle指针。 | 2257| [ArkUI_IntOffset](capi-arkui-nativemodule-arkui-intoffset.md)* globalOffset | 组件handle相对窗口的偏移值，单位：px。 | 2258 2259**返回：** 2260 2261| 类型 | 说明 | 2262| -- | -- | 2263| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2264 2265### OH_ArkUI_NodeUtils_GetLayoutPositionInScreen() 2266 2267``` 2268int32_t OH_ArkUI_NodeUtils_GetLayoutPositionInScreen(ArkUI_NodeHandle node, ArkUI_IntOffset* screenOffset) 2269``` 2270 2271**描述：** 2272 2273 2274获取组件布局区域相对屏幕的位置。布局区域相对位置不包含图形变化属性，如平移。 2275 2276**起始版本：** 12 2277 2278 2279**参数：** 2280 2281| 参数项 | 描述 | 2282| -- | -- | 2283| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | ArkUI_NodeHandle指针。 | 2284| [ArkUI_IntOffset](capi-arkui-nativemodule-arkui-intoffset.md)* screenOffset | 组件handle相对屏幕的偏移值，单位：px。 | 2285 2286**返回：** 2287 2288| 类型 | 说明 | 2289| -- | -- | 2290| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2291 2292### OH_ArkUI_NodeUtils_GetLayoutPositionInGlobalDisplay() 2293 2294``` 2295int32_t OH_ArkUI_NodeUtils_GetLayoutPositionInGlobalDisplay(ArkUI_NodeHandle node, ArkUI_IntOffset* offset) 2296``` 2297 2298**描述：** 2299 2300 2301获取组件相对于全局屏幕的偏移。布局区域相对位置不包含图形变化属性，如平移。 2302 2303**起始版本：** 20 2304 2305 2306**参数：** 2307 2308| 参数项 | 描述 | 2309| -- | -- | 2310| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | ArkUI_NodeHandle指针。 | 2311| [ArkUI_IntOffset](capi-arkui-nativemodule-arkui-intoffset.md)* offset | 组件handle相对屏幕的偏移值，单位：px。 | 2312 2313**返回：** 2314 2315| 类型 | 说明 | 2316| -- | -- | 2317| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2318 2319### OH_ArkUI_NodeUtils_GetPositionWithTranslateInWindow() 2320 2321``` 2322int32_t OH_ArkUI_NodeUtils_GetPositionWithTranslateInWindow(ArkUI_NodeHandle node, ArkUI_IntOffset* translateOffset) 2323``` 2324 2325**描述：** 2326 2327 2328获取组件在窗口中的位置，包含了图形平移变化属性。 2329 2330**起始版本：** 12 2331 2332 2333**参数：** 2334 2335| 参数项 | 描述 | 2336| -- | -- | 2337| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | ArkUI_NodeHandle指针。 | 2338| [ArkUI_IntOffset](capi-arkui-nativemodule-arkui-intoffset.md)* translateOffset | 组件handle自身，父组件及祖先节点的偏移累计值，单位：px。 | 2339 2340**返回：** 2341 2342| 类型 | 说明 | 2343| -- | -- | 2344| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2345 2346### OH_ArkUI_NodeUtils_GetPositionWithTranslateInScreen() 2347 2348``` 2349int32_t OH_ArkUI_NodeUtils_GetPositionWithTranslateInScreen(ArkUI_NodeHandle node, ArkUI_IntOffset* translateOffset) 2350``` 2351 2352**描述：** 2353 2354 2355获取组件在屏幕中的位置，包含了图形平移变化属性。 2356 2357**起始版本：** 12 2358 2359 2360**参数：** 2361 2362| 参数项 | 描述 | 2363| -- | -- | 2364| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | ArkUI_NodeHandle指针。 | 2365| [ArkUI_IntOffset](capi-arkui-nativemodule-arkui-intoffset.md)* translateOffset | 组件handle自身，父组件及祖先节点的偏移累计值，单位：px。 | 2366 2367**返回：** 2368 2369| 类型 | 说明 | 2370| -- | -- | 2371| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2372 2373### OH_ArkUI_NodeUtils_AddCustomProperty() 2374 2375``` 2376void OH_ArkUI_NodeUtils_AddCustomProperty(ArkUI_NodeHandle node, const char* name, const char* value) 2377``` 2378 2379**描述：** 2380 2381 2382设置组件的自定义属性。该接口仅在主线程生效。 2383 2384**起始版本：** 13 2385 2386 2387**参数：** 2388 2389| 参数项 | 描述 | 2390| -- | -- | 2391| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | ArkUI_NodeHandle指针。 | 2392| const char* name | 自定义属性的名称。不允许传入空指针。 | 2393| const char* value | 对应key参数名称的自定义属性的值。不允许传入空指针。 | 2394 2395### OH_ArkUI_NodeUtils_RemoveCustomProperty() 2396 2397``` 2398void OH_ArkUI_NodeUtils_RemoveCustomProperty(ArkUI_NodeHandle node, const char* name) 2399``` 2400 2401**描述：** 2402 2403 2404移除组件已设置的自定义属性。 2405 2406**起始版本：** 13 2407 2408 2409**参数：** 2410 2411| 参数项 | 描述 | 2412| -- | -- | 2413| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | ArkUI_NodeHandle指针。 | 2414| const char* name | 自定义属性的名称。 | 2415 2416### OH_ArkUI_NodeUtils_GetCustomProperty() 2417 2418``` 2419int32_t OH_ArkUI_NodeUtils_GetCustomProperty(ArkUI_NodeHandle node, const char* name, ArkUI_CustomProperty** handle) 2420``` 2421 2422**描述：** 2423 2424 2425获取组件的自定义属性的值。 2426 2427**起始版本：** 14 2428 2429 2430**参数：** 2431 2432| 参数项 | 描述 | 2433| -- | -- | 2434| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | ArkUI_NodeHandle指针。 | 2435| const char* name | 自定义属性的名称。 | 2436| [ArkUI_CustomProperty](capi-arkui-nativemodule-arkui-customproperty.md)** handle | 获取的对应key参数名称的自定义属性的结构体。 | 2437 2438**返回：** 2439 2440| 类型 | 说明 | 2441| -- | -- | 2442| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2443 2444### OH_ArkUI_NodeUtils_GetParentInPageTree() 2445 2446``` 2447ArkUI_NodeHandle OH_ArkUI_NodeUtils_GetParentInPageTree(ArkUI_NodeHandle node) 2448``` 2449 2450**描述：** 2451 2452 2453获取父节点，可获取由ArkTs创建的组件节点。 2454 2455**起始版本：** 14 2456 2457 2458**参数：** 2459 2460| 参数项 | 描述 | 2461| -- | -- | 2462| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点对象。 | 2463 2464**返回：** 2465 2466| 类型 | 说明 | 2467| -- | -- | 2468| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) | 组件的指针，如果没有返回NULL。 | 2469 2470### OH_ArkUI_NodeUtils_GetActiveChildrenInfo() 2471 2472``` 2473int32_t OH_ArkUI_NodeUtils_GetActiveChildrenInfo(ArkUI_NodeHandle head, ArkUI_ActiveChildrenInfo** handle) 2474``` 2475 2476**描述：** 2477 2478 2479获取某个节点所有活跃的子节点。Span将不会被计入子节点的统计中。在LazyForEach场景中，推荐使用[OH_ArkUI_NodeUtils_GetChildWithExpandMode](#oh_arkui_nodeutils_getchildwithexpandmode)接口进行遍历。 2480 2481**起始版本：** 14 2482 2483 2484**参数：** 2485 2486| 参数项 | 描述 | 2487| -- | -- | 2488| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) head | 传入需要获取的节点。 | 2489| [ArkUI_ActiveChildrenInfo](capi-arkui-nativemodule-arkui-activechildreninfo.md)** handle | 对应head节点子节点信息的结构体。 | 2490 2491**返回：** 2492 2493| 类型 | 说明 | 2494| -- | -- | 2495| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2496 2497### OH_ArkUI_NodeUtils_GetCurrentPageRootNode() 2498 2499``` 2500ArkUI_NodeHandle OH_ArkUI_NodeUtils_GetCurrentPageRootNode(ArkUI_NodeHandle node) 2501``` 2502 2503**描述：** 2504 2505 2506获取当前页面的根节点。 2507 2508**起始版本：** 14 2509 2510 2511**参数：** 2512 2513| 参数项 | 描述 | 2514| -- | -- | 2515| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点对象。 | 2516 2517**返回：** 2518 2519| 类型 | 说明 | 2520| -- | -- | 2521| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) | 根节点的指针，如果没有返回NULL。 | 2522 2523### OH_ArkUI_NodeUtils_IsCreatedByNDK() 2524 2525``` 2526bool OH_ArkUI_NodeUtils_IsCreatedByNDK(ArkUI_NodeHandle node) 2527``` 2528 2529**描述：** 2530 2531 2532获取组件是否由C-API创建的标签。 2533 2534**起始版本：** 14 2535 2536 2537**参数：** 2538 2539| 参数项 | 描述 | 2540| -- | -- | 2541| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点对象。 | 2542 2543**返回：** 2544 2545| 类型 | 说明 | 2546| -- | -- | 2547| bool | 节点是否由C-API创建的Tag，true代表由C-API创建，false代表非C-API创建。 | 2548 2549### OH_ArkUI_NodeUtils_GetNodeType() 2550 2551``` 2552int32_t OH_ArkUI_NodeUtils_GetNodeType(ArkUI_NodeHandle node) 2553``` 2554 2555**描述：** 2556 2557 2558获取节点的类型。 2559 2560**起始版本：** 14 2561 2562 2563**参数：** 2564 2565| 参数项 | 描述 | 2566| -- | -- | 2567| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点对象。 | 2568 2569**返回：** 2570 2571| 类型 | 说明 | 2572| -- | -- | 2573| int32_t | 节点的类型，具体已开放类型参考[ArkUI_NodeType](capi-native-node-h.md#arkui_nodetype)，未开放结点返回-1。 | 2574 2575### OH_ArkUI_NodeUtils_GetWindowInfo() 2576 2577``` 2578int32_t OH_ArkUI_NodeUtils_GetWindowInfo(ArkUI_NodeHandle node, ArkUI_HostWindowInfo** info) 2579``` 2580 2581**描述：** 2582 2583 2584获取节点所属的窗口信息。 2585 2586**起始版本：** 15 2587 2588 2589**参数：** 2590 2591| 参数项 | 描述 | 2592| -- | -- | 2593| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点对象。 | 2594| [ArkUI_HostWindowInfo](capi-arkui-nativemodule-arkui-hostwindowinfo.md)** info | 窗口信息。使用[OH_ArkUI_HostWindowInfo_Destroy](capi-native-type-h.md#oh_arkui_hostwindowinfo_destroy)释放内存。 | 2595 2596**返回：** 2597 2598| 类型 | 说明 | 2599| -- | -- | 2600| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化错误。<br> [ARKUI_ERROR_CODE_NODE_NOT_ON_MAIN_TREE](capi-native-type-h.md#arkui_errorcode) 节点未挂载到节点树上。 | 2601 2602### OH_ArkUI_NodeUtils_MoveTo() 2603 2604``` 2605int32_t OH_ArkUI_NodeUtils_MoveTo(ArkUI_NodeHandle node, ArkUI_NodeHandle target_parent, int32_t index) 2606``` 2607 2608**描述：** 2609 2610 2611将节点移动到目标父节点下，作为子节点。 2612 2613**起始版本：** 18 2614 2615 2616**参数：** 2617 2618| 参数项 | 描述 | 2619| -- | -- | 2620| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 待移动的节点对象。 | 2621| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) target_parent | 目标父节点指针。 | 2622| int32_t index | 转移后的节点下标，如果下标值为非法值，则添加在目标父节点的最后一位。 | 2623 2624**返回：** 2625 2626| 类型 | 说明 | 2627| -- | -- | 2628| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化错误。 | 2629 2630### OH_ArkUI_List_CloseAllSwipeActions() 2631 2632``` 2633int32_t OH_ArkUI_List_CloseAllSwipeActions(ArkUI_NodeHandle node, void* userData, void (*onFinish)(void* userData)) 2634``` 2635 2636**描述：** 2637 2638 2639收起展开状态下的ListItem。 2640 2641**起始版本：** 12 2642 2643 2644**参数：** 2645 2646| 参数项 | 描述 | 2647| -- | -- | 2648| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 需要注册事件的节点对象。 | 2649| void* userData | 自定义事件参数，当事件触发时在回调参数中携带回来。 | 2650| onFinish | 在收起动画完成后触发的回调。 | 2651 2652**返回：** 2653 2654| 类型 | 说明 | 2655| -- | -- | 2656| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_ATTRIBUTE_OR_EVENT_NOT_SUPPORTED](capi-native-type-h.md#arkui_errorcode) 组件不支持该事件。 | 2657 2658### OH_ArkUI_GetContextByNode() 2659 2660``` 2661ArkUI_ContextHandle OH_ArkUI_GetContextByNode(ArkUI_NodeHandle node) 2662``` 2663 2664**描述：** 2665 2666 2667获取当前节点所在页面的UI的上下文实例对象指针。 2668 2669**起始版本：** 12 2670 2671 2672**参数：** 2673 2674| 参数项 | 描述 | 2675| -- | -- | 2676| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 指定的节点。 | 2677 2678**返回：** 2679 2680| 类型 | 说明 | 2681| -- | -- | 2682| [ArkUI_ContextHandle](capi-arkui-nativemodule-arkui-context8h.md) | UI的上下文实例对象指针。 | 2683 2684### OH_ArkUI_RegisterSystemColorModeChangeEvent() 2685 2686``` 2687int32_t OH_ArkUI_RegisterSystemColorModeChangeEvent(ArkUI_NodeHandle node,void* userData, void (*onColorModeChange)(ArkUI_SystemColorMode colorMode, void* userData)) 2688``` 2689 2690**描述：** 2691 2692 2693注册系统深浅色变更事件。同一组件仅能注册一个系统深浅变更回调。示例请参考：[监听组件事件](../../ui/ndk-listen-to-component-events.md)。 2694 2695**起始版本：** 12 2696 2697 2698**参数：** 2699 2700| 参数项 | 描述 | 2701| -- | -- | 2702| node | 指定的节点。 | 2703| void* userData | 自定义事件参数，当事件触发时在回调参数中携带回来。 | 2704| onColorModeChange | 事件触发后的回调。[ArkUI_SystemColorMode](capi-native-type-h.md#arkui_systemcolormode)用于定义系统深浅色模式。 | 2705 2706**返回：** 2707 2708| 类型 | 说明 | 2709| -- | -- | 2710| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2711 2712### OH_ArkUI_UnregisterSystemColorModeChangeEvent() 2713 2714``` 2715void OH_ArkUI_UnregisterSystemColorModeChangeEvent(ArkUI_NodeHandle node) 2716``` 2717 2718**描述：** 2719 2720 2721注销系统深浅色变更事件。 2722 2723**起始版本：** 12 2724 2725 2726**参数：** 2727 2728| 参数项 | 描述 | 2729| -- | -- | 2730| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 指定的节点。 | 2731 2732### OH_ArkUI_RegisterSystemFontStyleChangeEvent() 2733 2734``` 2735int32_t OH_ArkUI_RegisterSystemFontStyleChangeEvent(ArkUI_NodeHandle node,void* userData, void (*onFontStyleChange)(ArkUI_SystemFontStyleEvent* event, void* userData)) 2736``` 2737 2738**描述：** 2739 2740 2741注册系统字体变更事件。同一组件仅能注册一个系统字体变更回调。 2742 2743**起始版本：** 12 2744 2745 2746**参数：** 2747 2748| 参数项 | 描述 | 2749| -- | -- | 2750| node | 指定的节点。 | 2751| void* userData | 自定义事件参数，当事件触发时在回调参数中携带回来。 | 2752| onFontStyleChange | 事件触发后的回调。 | 2753 2754**返回：** 2755 2756| 类型 | 说明 | 2757| -- | -- | 2758| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2759 2760### OH_ArkUI_UnregisterSystemFontStyleChangeEvent() 2761 2762``` 2763void OH_ArkUI_UnregisterSystemFontStyleChangeEvent(ArkUI_NodeHandle node) 2764``` 2765 2766**描述：** 2767 2768 2769注销系统字体变更事件。 2770 2771**起始版本：** 12 2772 2773 2774**参数：** 2775 2776| 参数项 | 描述 | 2777| -- | -- | 2778| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 指定的节点。 | 2779 2780### OH_ArkUI_SystemFontStyleEvent_GetFontSizeScale() 2781 2782``` 2783float OH_ArkUI_SystemFontStyleEvent_GetFontSizeScale(const ArkUI_SystemFontStyleEvent* event) 2784``` 2785 2786**描述：** 2787 2788 2789获取系统字体变更事件的字体大小值。 2790 2791**起始版本：** 12 2792 2793 2794**参数：** 2795 2796| 参数项 | 描述 | 2797| -- | -- | 2798| [const ArkUI_SystemFontStyleEvent](capi-arkui-nativemodule-arkui-systemfontstyleevent.md)* event | 表示指向当前系统字体变更事件的指针。 | 2799 2800**返回：** 2801 2802| 类型 | 说明 | 2803| -- | -- | 2804| float | 更新后的系统字体大小缩放系数。默认值：1.0。 | 2805 2806### OH_ArkUI_SystemFontStyleEvent_GetFontWeightScale() 2807 2808``` 2809float OH_ArkUI_SystemFontStyleEvent_GetFontWeightScale(const ArkUI_SystemFontStyleEvent* event) 2810``` 2811 2812**描述：** 2813 2814 2815获取系统字体变更事件的字体粗细值。 2816 2817**起始版本：** 12 2818 2819 2820**参数：** 2821 2822| 参数项 | 描述 | 2823| -- | -- | 2824| [const ArkUI_SystemFontStyleEvent](capi-arkui-nativemodule-arkui-systemfontstyleevent.md)* event | 表示指向当前系统字体变更事件的指针。 | 2825 2826**返回：** 2827 2828| 类型 | 说明 | 2829| -- | -- | 2830| float | 更新后的系统字体粗细缩放系数。默认值：1.0。 | 2831 2832### OH_ArkUI_RegisterLayoutCallbackOnNodeHandle() 2833 2834``` 2835int32_t OH_ArkUI_RegisterLayoutCallbackOnNodeHandle(ArkUI_NodeHandle node,void* userData, void (*onLayoutCompleted)(void* userData)) 2836``` 2837 2838**描述：** 2839 2840 2841注册指定节点的布局完成回调函数。 2842 2843**起始版本：** 15 2844 2845 2846**参数：** 2847 2848| 参数项 | 描述 | 2849| -- | -- | 2850| node | 指定需要注册回调函数的目标节点。 | 2851| void* userData | 执行回调函数时传给回调函数的用户自定义参数。 | 2852| onLayoutCompleted | 布局完成时的回调函数。 | 2853 2854**返回：** 2855 2856| 类型 | 说明 | 2857| -- | -- | 2858| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 参数错误。 | 2859 2860### OH_ArkUI_RegisterDrawCallbackOnNodeHandle() 2861 2862``` 2863int32_t OH_ArkUI_RegisterDrawCallbackOnNodeHandle(ArkUI_NodeHandle node,void* userData, void (*onDrawCompleted)(void* userData)) 2864``` 2865 2866**描述：** 2867 2868 2869注册指定节点的绘制完成回调函数。 2870 2871**起始版本：** 15 2872 2873 2874**参数：** 2875 2876| 参数项 | 描述 | 2877| -- | -- | 2878| node | 指定需要注册回调函数的目标节点。 | 2879| void* userData | 执行回调函数时传给回调函数的用户自定义参数。 | 2880| onDrawCompleted | 绘制完成时的回调函数。 | 2881 2882**返回：** 2883 2884| 类型 | 说明 | 2885| -- | -- | 2886| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 参数错误。 | 2887 2888### OH_ArkUI_UnregisterLayoutCallbackOnNodeHandle() 2889 2890``` 2891int32_t OH_ArkUI_UnregisterLayoutCallbackOnNodeHandle(ArkUI_NodeHandle node) 2892``` 2893 2894**描述：** 2895 2896 2897取消注册指定节点的布局完成回调函数。 2898 2899**起始版本：** 15 2900 2901 2902**参数：** 2903 2904| 参数项 | 描述 | 2905| -- | -- | 2906| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 指定需要取消注册回调函数的目标节点。 | 2907 2908**返回：** 2909 2910| 类型 | 说明 | 2911| -- | -- | 2912| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 参数错误。 | 2913 2914### OH_ArkUI_UnregisterDrawCallbackOnNodeHandle() 2915 2916``` 2917int32_t OH_ArkUI_UnregisterDrawCallbackOnNodeHandle(ArkUI_NodeHandle node) 2918``` 2919 2920**描述：** 2921 2922 2923取消注册指定节点的绘制完成回调函数。 2924 2925**起始版本：** 15 2926 2927 2928**参数：** 2929 2930| 参数项 | 描述 | 2931| -- | -- | 2932| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 指定需要取消注册回调函数的目标节点。 | 2933 2934**返回：** 2935 2936| 类型 | 说明 | 2937| -- | -- | 2938| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 参数错误。 | 2939 2940### OH_ArkUI_GetNodeSnapshot() 2941 2942``` 2943int32_t OH_ArkUI_GetNodeSnapshot(ArkUI_NodeHandle node, ArkUI_SnapshotOptions* snapshotOptions,OH_PixelmapNative** pixelmap) 2944``` 2945 2946**描述：** 2947 2948 2949获取给定组件的截图，若节点不在组件树上或尚未渲染，截图操作将会失败。当pixelmap不再使用时，应通过调用OH_PixelmapNative_Release来释放。 2950 2951**起始版本：** 15 2952 2953 2954**参数：** 2955 2956| 参数项 | 描述 | 2957| -- | -- | 2958| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 截图的目标节点。 | 2959| [ArkUI_SnapshotOptions](capi-arkui-nativemodule-arkui-snapshotoptions.md)* snapshotOptions | 给定的截图配置，为空时表示默认配置。 | 2960| OH_PixelmapNative** pixelmap | 通过系统创建的Pixelmap指针。 | 2961 2962**返回：** 2963 2964| 类型 | 说明 | 2965| -- | -- | 2966| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。<br> [ARKUI_ERROR_CODE_INTERNAL_ERROR](capi-native-type-h.md#arkui_errorcode) 截图失败，将返回空指针。<br> [ARKUI_ERROR_CODE_COMPONENT_SNAPSHOT_TIMEOUT](capi-native-type-h.md#arkui_errorcode) 截图超时。 | 2967 2968### OH_ArkUI_NodeUtils_GetAttachedNodeHandleById() 2969 2970``` 2971int32_t OH_ArkUI_NodeUtils_GetAttachedNodeHandleById(const char* id, ArkUI_NodeHandle* node) 2972``` 2973 2974**描述：** 2975 2976 2977根据用户id获取目标节点。 2978 2979**起始版本：** 15 2980 2981 2982**参数：** 2983 2984| 参数项 | 描述 | 2985| -- | -- | 2986| const char* id | 目标节点的id。 | 2987| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md)* node | 目标节点的指针。 | 2988 2989**返回：** 2990 2991| 类型 | 说明 | 2992| -- | -- | 2993| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 2994 2995### OH_ArkUI_NodeUtils_GetNodeHandleByUniqueId() 2996 2997``` 2998int32_t OH_ArkUI_NodeUtils_GetNodeHandleByUniqueId(const uint32_t uniqueId, ArkUI_NodeHandle* node) 2999``` 3000 3001**描述：** 3002 3003 3004通过uniqueId获取节点。 3005 3006**起始版本：** 20 3007 3008 3009**参数：** 3010 3011| 参数项 | 描述 | 3012| -- | -- | 3013| const uint32_t uniqueId | 目标节点的uniqueId。 | 3014| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md)* node | 目标节点的指针。 | 3015 3016**返回：** 3017 3018| 类型 | 说明 | 3019| -- | -- | 3020| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 方法参数错误。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化错误。 | 3021 3022### OH_ArkUI_NodeUtils_GetNodeUniqueId() 3023 3024``` 3025int32_t OH_ArkUI_NodeUtils_GetNodeUniqueId(ArkUI_NodeHandle node, int32_t* uniqueId) 3026``` 3027 3028**描述：** 3029 3030 3031获取目标节点的uniqueId。 3032 3033**起始版本：** 20 3034 3035 3036**参数：** 3037 3038| 参数项 | 描述 | 3039| -- | -- | 3040| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | ArkUI节点指针。 | 3041| int32_t* uniqueId | 目标节点的uniqueId。组件标识ID只读，且进程内唯一，若该节点存在，返回该节点的uniqueld值；否则返回-1。 | 3042 3043**返回：** 3044 3045| 类型 | 说明 | 3046| -- | -- | 3047| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 方法参数错误。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化错误。 | 3048 3049### OH_ArkUI_NodeUtils_SetCrossLanguageOption() 3050 3051``` 3052int32_t OH_ArkUI_NodeUtils_SetCrossLanguageOption(ArkUI_NodeHandle node, ArkUI_CrossLanguageOption* option) 3053``` 3054 3055**描述：** 3056 3057 3058设置目标节点跨语言设置属性的能力。 3059 3060**起始版本：** 15 3061 3062 3063**参数：** 3064 3065| 参数项 | 描述 | 3066| -- | -- | 3067| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点的指针。 | 3068| [ArkUI_CrossLanguageOption](capi-arkui-nativemodule-arkui-crosslanguageoption.md)* option | 跨语言配置项 [ArkUI_CrossLanguageOption](capi-arkui-nativemodule-arkui-crosslanguageoption.md)。 | 3069 3070**返回：** 3071 3072| 类型 | 说明 | 3073| -- | -- | 3074| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 3075 3076### OH_ArkUI_NodeUtils_GetCrossLanguageOption() 3077 3078``` 3079int32_t OH_ArkUI_NodeUtils_GetCrossLanguageOption(ArkUI_NodeHandle node, ArkUI_CrossLanguageOption* option) 3080``` 3081 3082**描述：** 3083 3084 3085获取目标节点跨语言设置属性的配置项。 3086 3087**起始版本：** 15 3088 3089 3090**参数：** 3091 3092| 参数项 | 描述 | 3093| -- | -- | 3094| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点的指针。 | 3095| [ArkUI_CrossLanguageOption](capi-arkui-nativemodule-arkui-crosslanguageoption.md)* option | 跨语言配置项 [ArkUI_CrossLanguageOption](capi-arkui-nativemodule-arkui-crosslanguageoption.md)。 | 3096 3097**返回：** 3098 3099| 类型 | 说明 | 3100| -- | -- | 3101| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 3102 3103### OH_ArkUI_NodeUtils_GetFirstChildIndexWithoutExpand() 3104 3105``` 3106int32_t OH_ArkUI_NodeUtils_GetFirstChildIndexWithoutExpand(ArkUI_NodeHandle node, uint32_t* index) 3107``` 3108 3109**描述：** 3110 3111 3112获取目标节点在树上的第一个子节点的下标。 3113 3114**起始版本：** 15 3115 3116 3117**参数：** 3118 3119| 参数项 | 描述 | 3120| -- | -- | 3121| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点的指针。 | 3122| uint32_t* index | 子节点的下标值。 | 3123 3124**返回：** 3125 3126| 类型 | 说明 | 3127| -- | -- | 3128| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 3129 3130### OH_ArkUI_NodeUtils_GetLastChildIndexWithoutExpand() 3131 3132``` 3133int32_t OH_ArkUI_NodeUtils_GetLastChildIndexWithoutExpand(ArkUI_NodeHandle node, uint32_t* index) 3134``` 3135 3136**描述：** 3137 3138 3139获取目标节点在树上的最后一个子节点的下标。 3140 3141**起始版本：** 15 3142 3143 3144**参数：** 3145 3146| 参数项 | 描述 | 3147| -- | -- | 3148| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点的指针。 | 3149| uint32_t* index | 子节点的下标值。 | 3150 3151**返回：** 3152 3153| 类型 | 说明 | 3154| -- | -- | 3155| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 3156 3157### OH_ArkUI_NodeUtils_GetChildWithExpandMode() 3158 3159``` 3160int32_t OH_ArkUI_NodeUtils_GetChildWithExpandMode(ArkUI_NodeHandle node, int32_t position,ArkUI_NodeHandle* subnode, uint32_t expandMode) 3161``` 3162 3163**描述：** 3164 3165 3166用不同的展开模式获取对应下标的子节点。 3167 3168**起始版本：** 15 3169 3170 3171**参数：** 3172 3173| 参数项 | 描述 | 3174| -- | -- | 3175| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点的指针。 | 3176| int32_t position | 对应子节点的下标。 | 3177| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md)* subnode | 获取子节点的指针。 | 3178| uint32_t expandMode | 节点遍历展开方式。 [ArkUI_ExpandMode](capi-native-type-h.md#arkui_expandmode)。 | 3179 3180**返回：** 3181 3182| 类型 | 说明 | 3183| -- | -- | 3184| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 3185 3186### OH_ArkUI_NodeUtils_GetPositionToParent() 3187 3188``` 3189int32_t OH_ArkUI_NodeUtils_GetPositionToParent(ArkUI_NodeHandle node, ArkUI_IntOffset* globalOffset) 3190``` 3191 3192**描述：** 3193 3194 3195获取目标节点相对于父节点的偏移值，单位：px。 3196 3197**起始版本：** 15 3198 3199 3200**参数：** 3201 3202| 参数项 | 描述 | 3203| -- | -- | 3204| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点。 | 3205| [ArkUI_IntOffset](capi-arkui-nativemodule-arkui-intoffset.md)* globalOffset | 目标节点相对父节点的偏移值，单位：px。 | 3206 3207**返回：** 3208 3209| 类型 | 说明 | 3210| -- | -- | 3211| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 3212 3213### OH_ArkUI_AddSupportedUIStates() 3214 3215``` 3216ArkUI_ErrorCode OH_ArkUI_AddSupportedUIStates(ArkUI_NodeHandle node, int32_t uiStates,void (statesChangeHandler)(int32_t currentStates, void* userData), bool excludeInner, void* userData) 3217``` 3218 3219**描述：** 3220 3221 3222设置组件支持的多态样式状态。为了更高效地处理，需传入所关注的状态值及对应的状态处理函数，当关注的状态发生时，处理函数会被执行。可在回调中根据当前状态调整UI样式。当在同一个节点上多次调用该方法时，将以最后一次传入的状态及处理函数为准。有些类型的组件节点，系统内部已有对某些状态的默认处理。例如，Button组件默认具备对PRESSED状态的样式变化，当在此类组件上使用此方法自定义状态处理时，会先应用系统默认样式变化，再执行自定义的样式处理，最终效果为两者叠加。可以通过指定excludeInner为true来禁用系统内部的默认样式效果，但这通常取决于系统内部实现规范是否允许。当调用该函数时，传入的statesChangeHandler函数会立即执行一次，且无需特意注册对NORMAL状态的监听，只要注册了非NORMAL状态，当状态从任意状态变化回NORMAL时，系统都会进行回调，以便应用进行样式复原。 3223 3224**起始版本：** 20 3225 3226 3227**参数：** 3228 3229| 参数项 | 描述 | 3230| -- | -- | 3231| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点。 | 3232| int32_t uiStates | 目标节点需要处理的目标UI状态。所有目标UI状态的组合结果可以通过“\|”操作来计算。例如：targetUIStates = ArkUI_UIState::PRESSED | ArkUI_UIState::FOCUSED。 | 3233| void (statesChangeHandler)(int32_t currentStates, void* userData) | UI状态改变处理函数。返回当前UI状态，该值是所有当前状态枚举值“\|”计算的结果，可以通过执行“&”操作来确定状态。例如：if (currentStates & ArkUI_UIState::PRESSED == ArkUI_UIState::PRESSED)。但是，对于正常状态检查，应直接使用等号。例如：if (currentStates == ArkUI_UIState::NORMAL) | 3234| bool excludeInner | 禁止内部默认状态样式的标志。true表示禁用系统内部的默认样式，false表示不禁用。| 3235| void* userData | onDrawCompleted回调函数中使用的自定义数据。 | 3236 3237**返回：** 3238 3239| 类型 | 说明 | 3240| -- | -- | 3241| [ArkUI_ErrorCode](capi-native-type-h.md#arkui_errorcode) | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 3242 3243### OH_ArkUI_RemoveSupportedUIStates() 3244 3245``` 3246ArkUI_ErrorCode OH_ArkUI_RemoveSupportedUIStates(ArkUI_NodeHandle node, int32_t uiStates) 3247``` 3248 3249**描述：** 3250 3251 3252删除注册的状态处理。当通过OH_ArkUI_AddSupportedUIStates注册的状态都被删除时，所注册的stateChangeHandler也不会再被执行。 3253 3254**起始版本：** 20 3255 3256 3257**参数：** 3258 3259| 参数项 | 描述 | 3260| -- | -- | 3261| [ArkUI_NodeHandle](capi-arkui-nativemodule-arkui-node8h.md) node | 目标节点。 | 3262| int32_t uiStates | 节点需要删除的目标UI状态。 | 3263 3264**返回：** 3265 3266| 类型 | 说明 | 3267| -- | -- | 3268| [ArkUI_ErrorCode](capi-native-type-h.md#arkui_errorcode) | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_PARAM_INVALID](capi-native-type-h.md#arkui_errorcode) 函数参数异常。 | 3269 3270### OH_ArkUI_RunTaskInScope() 3271 3272``` 3273int32_t OH_ArkUI_RunTaskInScope(ArkUI_ContextHandle uiContext, void* userData, void(*callback)(void* userData)) 3274``` 3275 3276**描述：** 3277 3278 3279在目标UI上下文中执行传入的自定义回调函数。示例请参考：[在NDK中保证多实例场景功能正常](../../ui/ndk-scope-task.md)。 3280 3281**起始版本：** 20 3282 3283 3284**参数：** 3285 3286| 参数项 | 描述 | 3287| -- | -- | 3288| [ArkUI_ContextHandle](capi-arkui-nativemodule-arkui-context8h.md) uiContext | 表示目标UI上下文的指针。 | 3289| void* userData | 开发者自定义数据指针，以便在回调函数中处理自定义数据，开发者需自行保证自定义函数被执行时的数据有效性。 | 3290| void(\*callback)(void\* userData) | 开发者自定义回调函数。 | 3291 3292**返回：** 3293 3294| 类型 | 说明 | 3295| -- | -- | 3296| int32_t | 错误码。<br> [ARKUI_ERROR_CODE_NO_ERROR](capi-native-type-h.md#arkui_errorcode) 成功。<br> [ARKUI_ERROR_CODE_CAPI_INIT_ERROR](capi-native-type-h.md#arkui_errorcode) CAPI初始化错误。<br> [ARKUI_ERROR_CODE_UI_CONTEXT_INVALID](capi-native-type-h.md#arkui_errorcode) UIContext对象无效。<br> [ARKUI_ERROR_CODE_CALLBACK_INVALID](capi-native-type-h.md#arkui_errorcode) 回调函数无效。 | 3297 3298 3299
