1# ArkUI_NativeModule
2
3
4## Overview
5
6Provides drag and drop APIs of ArkUI on the native side.
7
8Provides the APIs of ArkUI to register gesture callbacks on the native side.
9
10Provides animation callbacks of ArkUI on the native side.
11
12Provides UI capabilities of ArkUI on the native side, such as UI component creation and destruction, tree node operations, attribute setting, and event listening.
13
14**Since**: 12
15
16
17## Summary
18
19
20### Files
21
22| Name| Description|
23| -------- | -------- |
24| [drag_and_drop.h](drag__and__drop_8h.md) | Declares the APIs of **NativeDrag**.<br> **Library**: libace_ndk.z.so|
25| [drawable_descriptor.h](drawable__descriptor_8h.md) | Declares the APIs of **NativeDrawableDescriptor**.<br> **Library**: libace_ndk.z.so|
26| [native_animate.h](native__animate_8h.md) | Declares a set of animation APIs of ArkUI on the native side.<br> **Library**: libace_ndk.z.so|
27| [native_dialog.h](native__dialog_8h.md) | Declares a set of custom dialog box APIs of ArkUI on the native side.<br> **Library**: libace_ndk.z.so|
28| [native_gesture.h](native__gesture_8h.md) | Declares the APIs of **NativeGesture**.<br> **Library**: libace_ndk.z.so|
29| [native_interface.h](native__interface_8h.md) | Declares a unified entry for the native module APIs.<br> **Library**: libace_ndk.z.so|
30| [native_node.h](native__node_8h.md) | Declares the APIs of **NativeNode**.<br> **Library**: libace_ndk.z.so|
31| [native_node_napi.h](native__node__napi_8h.md) | Declares the functions used to convert FrameNodes on the ArkTS side into NodeHandles.<br> **Library**: libace_ndk.z.so|
32| [native_type.h](native__type_8h.md) | Defines the common types for the native module.<br> **Library**: libace_ndk.z.so|
33| [styled_string.h](styled__string_8h.md) | Declares styled string APIs of ArkUI on the native side.<br> **Library**: libace_ndk.z.so|
34
35
36### Structs
37
38| Name| Description|
39| -------- | -------- |
40| struct  [ArkUI_ExpectedFrameRateRange](_ark_u_i___expected_frame_rate_range.md) | Defines a struct for the expected frame rate range of the animation. |
41| struct  [ArkUI_AnimateCompleteCallback](_ark_u_i___animate_complete_callback.md) | Defines a struct for the callback type for when the animation playback is complete. |
42| struct  [ArkUI_NativeAnimateAPI_1](_ark_u_i___native_animate_a_p_i__1.md) | Defines a struct for the animation APIs of ArkUI on the native side. |
43| struct  [ArkUI_NativeDialogAPI_1](_ark_u_i___native_dialog_a_p_i__1.md) | Defines a struct for the custom dialog box APIs on the native side. |
44| struct  [ArkUI_NativeGestureAPI_1](_ark_u_i___native_gesture_a_p_i__1.md) | Defines a struct for the gesture APIs. |
45| struct  [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) | Defines the general input parameter structure of the **setAttribute** function. |
46| struct  [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) | Defines a struct for the parameter type of the component callback event. |
47| struct  [ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md) | Defines the string type parameter used by the component callback event. |
48| struct  [ArkUI_NativeNodeAPI_1](_ark_u_i___native_node_a_p_i__1.md) | Defines a struct for node APIs of ArkUI on the native side. |
49| struct  [ArkUI_ContextCallback](_ark_u_i___context_callback.md) | Defines event callback. |
50| union  [ArkUI_NumberValue](union_ark_u_i___number_value.md) | Provides the number types of ArkUI in the native code. |
51| struct  [ARKUI_TextPickerRangeContent](_a_r_k_u_i___text_picker_range_content.md) | Defines the input structure of the single-column text picker with image resources. |
52| struct  [ARKUI_TextPickerCascadeRangeContent](_a_r_k_u_i___text_picker_cascade_range_content.md) | Defines the input structure of the interconnected multi-column text picker. |
53| struct  [ArkUI_ColorStop](_ark_u_i___color_stop.md) | Defines a gradient color stop. |
54| struct  [ArkUI_Rect](_ark_u_i___rect.md) | Defines a mask area. |
55| struct  [ArkUI_IntSize](_ark_u_i___int_size.md) | Describes the width and height of a component. |
56| struct  [ArkUI_IntOffset](_ark_u_i___int_offset.md) | Describes the position of a component. |
57| struct  [ArkUI_Margin](_ark_u_i___margin.md) | Describes the margins of a component. |
58| struct  [ArkUI_TranslationOptions](_ark_u_i___translation_options.md) | Defines the translation options for component transition. |
59| struct  [ArkUI_ScaleOptions](_ark_u_i___scale_options.md) | Defines the scaling options for component transition. |
60| struct  [ArkUI_RotationOptions](_ark_u_i___rotation_options.md) | Defines the rotation options for component transition. |
61
62
63### Macros
64
65| Name| Description|
66| -------- | -------- |
67| [OH_ArkUI_GetModuleInterface](#oh_arkui_getmoduleinterface)(nativeAPIVariantKind, structType, structPtr) | Obtains the macro function corresponding to a struct pointer based on the struct type. |
68| **MAX_NODE_SCOPE_NUM**    | 1000 |
69| **MAX_COMPONENT_EVENT_ARG_NUM**    | 12 |
70
71
72### Types
73
74| Name| Description|
75| -------- | -------- |
76| typedef struct [ArkUI_NodeEvent](#arkui_nodeevent-12) [ArkUI_NodeEvent](#arkui_nodeevent-12) | Defines a struct for a component event. |
77| typedef struct [ArkUI_Context](#arkui_context) [ArkUI_Context](#arkui_context) | Defines a struct for a UI context object. |
78| typedef struct [ArkUI_Context](#arkui_context) \* [ArkUI_ContextHandle](#arkui_contexthandle-12) | Defines a struct for the handle to the ArkUI native UI context. |
79| typedef struct [ArkUI_DragEvent](#arkui_dragevent) [ArkUI_DragEvent](#arkui_dragevent) | Defines a struct for a drag event. |
80| typedef struct [ArkUI_DragPreviewOption](#arkui_dragpreviewoption) [ArkUI_DragPreviewOption](#arkui_dragpreviewoption) | Defines a struct for custom drag preview options. |
81| typedef struct [ArkUI_DragAction](#arkui_dragaction) [ArkUI_DragAction](#arkui_dragaction) | Defines a struct for a drag action. |
82| typedef struct [ArkUI_DragAndDropInfo](#arkui_draganddropinfo) [ArkUI_DragAndDropInfo](#arkui_draganddropinfo) | Defines a struct for drag and drop information returned through a drag status listener. |
83| typedef struct [OH_UdmfData](#oh_udmfdata) [OH_UdmfData](#oh_udmfdata) | Defines a struct for UDMF unified data. |
84| typedef struct [OH_PixelmapNative](#oh_pixelmapnative) [OH_PixelmapNative](#oh_pixelmapnative) | Defines the **Pixelmap** struct, which is used to perform operations related to a pixel map. |
85| typedef struct [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) | Defines a struct for the **DrawableDescriptor** object. |
86| typedef struct [OH_PixelmapNative](#oh_pixelmapnative) \* [OH_PixelmapNativeHandle](#oh_pixelmapnativehandle) | Defines a struct for the pointer to an **OH_PixelmapNative** object. |
87| typedef struct [ArkUI_AnimateOption](#arkui_animateoption) [ArkUI_AnimateOption](#arkui_animateoption) | Defines a struct for the animation configuration. |
88| typedef struct ArkUI_Curve \* [ArkUI_CurveHandle](#arkui_curvehandle) | Defines a struct for the pointer to an interpolation curve. |
89| typedef struct [ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) [ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) | Defines a struct for the keyframe animation parameter object. |
90| typedef struct [ArkUI_AnimatorOption](#arkui_animatoroption) [ArkUI_AnimatorOption](#arkui_animatoroption) | Defines the animator parameter object. |
91| typedef struct ArkUI_Animator \* [ArkUI_AnimatorHandle](#arkui_animatorhandle) | Defines a struct for the pointer to an animator object. |
92| typedef struct [ArkUI_TransitionEffect](#arkui_transitioneffect) [ArkUI_TransitionEffect](#arkui_transitioneffect) | Defines a struct for the transition effect. |
93| typedef bool(\* [ArkUI_OnWillDismissEvent](#arkui_onwilldismissevent)) (int32_t reason) | Defines a pointer to the callback invoked when the dialog box is closed. |
94| typedef struct [ArkUI_DialogDismissEvent](#arkui_dialogdismissevent) [ArkUI_DialogDismissEvent](#arkui_dialogdismissevent) | Defines a struct for a dialog box dismiss event. |
95| typedef uint32_t [ArkUI_GestureEventActionTypeMask](#arkui_gestureeventactiontypemask) | Defines a set of gesture event types. |
96| typedef uint32_t [ArkUI_GestureDirectionMask](#arkui_gesturedirectionmask) | Defines a set of gesture directions. |
97| typedef ArkUI_GestureRecognizer \* [ArkUI_GestureRecognizerHandle](#arkui_gesturerecognizerhandle) | Defines the gesture recognizer handle. |
98| typedef [ArkUI_GestureRecognizerHandle](#arkui_gesturerecognizerhandle) \* [ArkUI_GestureRecognizerHandleArray](#arkui_gesturerecognizerhandlearray) | Defines the gesture recognizer handle array. |
99| typedef struct [ArkUI_GestureEventTargetInfo](#arkui_gestureeventtargetinfo) [ArkUI_GestureEventTargetInfo](#arkui_gestureeventtargetinfo) | Defines a struct for a **GestureEventTargetInfo** object that provides information about a gesture event target. |
100| typedef struct [ArkUI_ParallelInnerGestureEvent](#arkui_parallelinnergestureevent) [ArkUI_ParallelInnerGestureEvent](#arkui_parallelinnergestureevent) | Defines a parallel internal gesture event. |
101| typedef void(\* [ArkUI_GestureRecognizerDestructNotifyCallback](#arkui_gesturerecognizerdestructnotifycallback)) (ArkUI_GestureRecognizer \*recognizer, void \*userData) | Defines a callback function for notifying gesture recognizer destruction. |
102| typedef struct [ArkUI_NodeEvent](#arkui_nodeevent-12) [ArkUI_NodeEvent](#arkui_nodeevent-12) | Defines the common structure of a component event. |
103| typedef struct [ArkUI_NodeCustomEvent](#arkui_nodecustomevent) [ArkUI_NodeCustomEvent](#arkui_nodecustomevent) | Defines the common structure of a custom component event. |
104| typedef struct ArkUI_NodeAdapter \* [ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) | Defines the component adapter, which is used for lazy loading of elements of scrollable components. |
105| typedef struct [ArkUI_NodeAdapterEvent](#arkui_nodeadapterevent) [ArkUI_NodeAdapterEvent](#arkui_nodeadapterevent) | Defines the component adapter event. |
106| typedef struct [ArkUI_NodeContentEvent](#arkui_nodecontentevent) [ArkUI_NodeContentEvent](#arkui_nodecontentevent) | Defines the common structure type of a NodeContent event. |
107| typedef void(\* [ArkUI_NodeContentCallback](#arkui_nodecontentcallback)) ([ArkUI_NodeContentEvent](#arkui_nodecontentevent) \*event) | Defines the callback for the NodeContent event. |
108| typedef struct [ArkUI_LayoutConstraint](#arkui_layoutconstraint) [ArkUI_LayoutConstraint](#arkui_layoutconstraint) | Defines the size constraints of a component during component layout. |
109| typedef struct [ArkUI_DrawContext](#arkui_drawcontext) [ArkUI_DrawContext](#arkui_drawcontext) | Defines the component drawing context. |
110| typedef struct ArkUI_Node \* [ArkUI_NodeHandle](#arkui_nodehandle) | Defines the pointer to the ArkUI native component object. |
111| typedef struct ArkUI_NativeDialog \* [ArkUI_NativeDialogHandle](#arkui_nativedialoghandle) | Defines the handle to the custom dialog box controller of ArkUI on the native side. |
112| typedef struct [ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) [ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) | Defines the water flow section configuration. |
113| typedef struct [ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) [ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) | Defines the item configuration for **ListItemSwipeActionOption**. |
114| typedef struct [ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) [ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) | Defines the configuration for **ListItemSwipeActionOption**. |
115| typedef struct [ArkUI_Context](#arkui_context) \* [ArkUI_ContextHandle](#arkui_contexthandle-12) | Defines the handle to the ArkUI native UI context. |
116| typedef struct ArkUI_NodeContent \* [ArkUI_NodeContentHandle](#arkui_nodecontenthandle) | Defines the handle to the ArkUI NodeContent instance on the native side. |
117| typedef struct [ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) [ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) | Defines the alignment rule in the relative container. |
118| typedef struct [ArkUI_GuidelineOption](#arkui_guidelineoption) [ArkUI_GuidelineOption](#arkui_guidelineoption) | Defines the ID, direction, and position of a guideline. |
119| typedef struct [ArkUI_BarrierOption](#arkui_barrieroption) [ArkUI_BarrierOption](#arkui_barrieroption) | Defines the ID, direction, and referenced component of a barrier. |
120| typedef struct [ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) [ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) | Defines the image frame information. |
121| typedef struct [ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) [ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) | Defines the **ChildrenMainSize** information of the **List** component. |
122| typedef struct [ArkUI_AccessibilityState](#arkui_accessibilitystate) [ArkUI_AccessibilityState](#arkui_accessibilitystate) | Defines a struct for the component accessibility state. |
123| typedef struct [ArkUI_AccessibilityValue](#arkui_accessibilityvalue) [ArkUI_AccessibilityValue](#arkui_accessibilityvalue) | Defines a struct for the component accessibility value. |
124| typedef struct [ArkUI_SystemFontStyleEvent](#arkui_systemfontstyleevent) [ArkUI_SystemFontStyleEvent](#arkui_systemfontstyleevent) | Defines a struct for the system font style event. |
125| typedef struct [ArkUI_CustomSpanMeasureInfo](#arkui_customspanmeasureinfo) [ArkUI_CustomSpanMeasureInfo](#arkui_customspanmeasureinfo) | Defines a struct for the measurement information of a custom span. |
126| typedef struct [ArkUI_CustomSpanMetrics](#arkui_customspanmetrics) [ArkUI_CustomSpanMetrics](#arkui_customspanmetrics) | Defines a struct for the measurement metrics of a custom span. |
127| typedef struct [ArkUI_CustomSpanDrawInfo](#arkui_customspandrawinfo) [ArkUI_CustomSpanDrawInfo](#arkui_customspandrawinfo) | Defines a struct for the drawing information of a custom span. |
128| typedef struct [ArkUI_SwiperIndicator](#arkui_swiperindicator) [ArkUI_SwiperIndicator](#arkui_swiperindicator) | Defines the navigation point indicator style of the **Swiper** component. |
129| typedef struct [ArkUI_StyledString_Descriptor](#arkui_styledstring_descriptor) [ArkUI_StyledString_Descriptor](#arkui_styledstring_descriptor) | Defines a struct for the styled string descriptor object supported by the text component. |
130| typedef struct [ArkUI_StyledString](#arkui_styledstring) [ArkUI_StyledString](#arkui_styledstring) | Defines a struct for the styled string object supported by the text component. |
131
132
133### Enums
134
135| Name| Description|
136| -------- | -------- |
137| [ArkUI_DragResult](#arkui_dragresult) { ARKUI_DRAG_RESULT_SUCCESSFUL, ARKUI_DRAG_RESULT_FAILED, ARKUI_DRAG_RESULT_CANCELED } | Defines an enum for drag results, which are set by the data receiver and transferred by the system to the drag source so that the drag source is aware of the data processing result of the receiver. |
138| [ArkUI_DropProposal](#arkui_dropproposal) { ARKUI_DROP_PROPOSAL_COPY, ARKUI_DROP_PROPOSAL_MOVE } | Defines an enum for data processing modes used when data is dropped, which affects the display of the badge. |
139| [ArkUI_PreDragStatus](#arkui_predragstatus) {<br>ARKUI_PRE_DRAG_STATUS_UNKNOWN = -1, ARKUI_PRE_DRAG_STATUS_ACTION_DETECTING, ARKUI_PRE_DRAG_STATUS_READY_TO_TRIGGER_DRAG, ARKUI_PRE_DRAG_STATUS_PREVIEW_LIFT_STARTED,<br>ARKUI_PRE_DRAG_STATUS_PREVIEW_LIFT_FINISHED, ARKUI_PRE_DRAG_STATUS_PREVIEW_LANDING_STARTED, ARKUI_PRE_DRAG_STATUS_PREVIEW_LANDING_FINISHED, ARKUI_PRE_DRAG_STATUS_CANCELED_BEFORE_DRAG<br>} | Defines an enum for interaction states prior to a drop and drop operation. |
140| [ArkUI_DragPreviewScaleMode](#arkui_dragpreviewscalemode) { ARKUI_DRAG_PREVIEW_SCALE_AUTO, ARKUI_DRAG_PREVIEW_SCALE_DISABLED } | Defines an enum for drag preview scale modes. |
141| [ArkUI_DragStatus](#arkui_dragstatus) { ArkUI_DRAG_STATUS_UNKNOWN, ArkUI_DRAG_STATUS_STARTED, ArkUI_DRAG_STATUS_ENDED } | Enumerates dragging states. |
142| [ArkUI_DismissReason](#arkui_dismissreason) { DIALOG_DISMISS_BACK_PRESS = 0, DIALOG_DISMISS_TOUCH_OUTSIDE, DIALOG_DISMISS_CLOSE_BUTTON, DIALOG_DISMISS_SLIDE_DOWN } | Enumerates the actions for triggering closure of the dialog box. |
143| [ArkUI_GestureEventActionType](#arkui_gestureeventactiontype) { GESTURE_EVENT_ACTION_ACCEPT = 0x01, GESTURE_EVENT_ACTION_UPDATE = 0x02, GESTURE_EVENT_ACTION_END = 0x04, GESTURE_EVENT_ACTION_CANCEL = 0x08 } | Enumerates gesture event types. |
144| [ArkUI_GesturePriority](#arkui_gesturepriority) { NORMAL = 0, PRIORITY = 1, PARALLEL = 2 } | Enumerates gesture event modes. |
145| [ArkUI_GroupGestureMode](#arkui_groupgesturemode) { SEQUENTIAL_GROUP = 0, PARALLEL_GROUP = 1, EXCLUSIVE_GROUP = 2 } | Enumerates gesture group modes. |
146| [ArkUI_GestureDirection](#arkui_gesturedirection) {<br>GESTURE_DIRECTION_ALL = 0b1111, GESTURE_DIRECTION_HORIZONTAL = 0b0011, GESTURE_DIRECTION_VERTICAL = 0b1100, GESTURE_DIRECTION_LEFT = 0b0001,<br>GESTURE_DIRECTION_RIGHT = 0b0010, GESTURE_DIRECTION_UP = 0b0100, GESTURE_DIRECTION_DOWN = 0b1000, GESTURE_DIRECTION_NONE = 0<br>} | Enumerates gesture directions. |
147| [ArkUI_GestureMask](#arkui_gesturemask) { NORMAL_GESTURE_MASK = 0, IGNORE_INTERNAL_GESTURE_MASK } | Enumerates gesture masking modes. |
148| [ArkUI_GestureRecognizerType](#arkui_gesturerecognizertype) {<br>TAP_GESTURE = 0, LONG_PRESS_GESTURE, PAN_GESTURE, PINCH_GESTURE,<br>ROTATION_GESTURE, SWIPE_GESTURE, GROUP_GESTURE<br>} | Enumerates gesture recognizer types. |
149| [ArkUI_GestureInterruptResult](#arkui_gestureinterruptresult) { GESTURE_INTERRUPT_RESULT_CONTINUE = 0, GESTURE_INTERRUPT_RESULT_REJECT } | Enumerates gesture interruption results. |
150| [ArkUI_GestureRecognizerState](#arkui_gesturerecognizerstate) {<br>ARKUI_GESTURE_RECOGNIZER_STATE_REDAY = 0, ARKUI_GESTURE_RECOGNIZER_STATE_DETECTING = 1, ARKUI_GESTURE_RECOGNIZER_STATE_PENDING = 2, ARKUI_GESTURE_RECOGNIZER_STATE_BLOCKED = 3,<br>ARKUI_GESTURE_RECOGNIZER_STATE_SUCCESSFUL = 4, ARKUI_GESTURE_RECOGNIZER_STATE_FAILED = 5<br>} | Enumerates the gesture recognizer states. |
151| [ArkUI_NativeAPIVariantKind](#arkui_nativeapivariantkind) { ARKUI_NATIVE_NODE, ARKUI_NATIVE_DIALOG, ARKUI_NATIVE_GESTURE, ARKUI_NATIVE_ANIMATE } | Defines the native API types. |
152| [ArkUI_NodeType](#arkui_nodetype) {<br>ARKUI_NODE_CUSTOM = 0, ARKUI_NODE_TEXT = 1, ARKUI_NODE_SPAN = 2, ARKUI_NODE_IMAGE_SPAN = 3,<br>ARKUI_NODE_IMAGE = 4, ARKUI_NODE_TOGGLE = 5, ARKUI_NODE_LOADING_PROGRESS = 6, ARKUI_NODE_TEXT_INPUT = 7,<br>ARKUI_NODE_TEXT_AREA = 8, ARKUI_NODE_BUTTON = 9, ARKUI_NODE_PROGRESS = 10, ARKUI_NODE_CHECKBOX = 11,<br>ARKUI_NODE_XCOMPONENT = 12, ARKUI_NODE_DATE_PICKER = 13, ARKUI_NODE_TIME_PICKER = 14, ARKUI_NODE_TEXT_PICKER = 15,<br>ARKUI_NODE_CALENDAR_PICKER = 16, ARKUI_NODE_SLIDER = 17, ARKUI_NODE_RADIO = 18, ARKUI_NODE_IMAGE_ANIMATOR = 19,<br>ARKUI_NODE_STACK = MAX_NODE_SCOPE_NUM, ARKUI_NODE_SWIPER, ARKUI_NODE_SCROLL, ARKUI_NODE_LIST,<br>ARKUI_NODE_LIST_ITEM, ARKUI_NODE_LIST_ITEM_GROUP, ARKUI_NODE_COLUMN, ARKUI_NODE_ROW,<br>ARKUI_NODE_FLEX, ARKUI_NODE_REFRESH, ARKUI_NODE_WATER_FLOW, ARKUI_NODE_FLOW_ITEM,<br>ARKUI_NODE_RELATIVE_CONTAINER, ARKUI_NODE_GRID, ARKUI_NODE_GRID_ITEM, ARKUI_NODE_CUSTOM_SPAN<br>} | Enumerates ArkUI component types that can be created on the native side. |
153| [ArkUI_NodeAttributeType](#arkui_nodeattributetype) {<br>NODE_WIDTH = 0, NODE_HEIGHT, NODE_BACKGROUND_COLOR, NODE_BACKGROUND_IMAGE,<br>NODE_PADDING, NODE_ID, NODE_ENABLED, NODE_MARGIN,<br>NODE_TRANSLATE, NODE_SCALE, NODE_ROTATE, NODE_BRIGHTNESS,<br>NODE_SATURATION, NODE_BLUR, NODE_LINEAR_GRADIENT, NODE_ALIGNMENT,<br>NODE_OPACITY, NODE_BORDER_WIDTH, NODE_BORDER_RADIUS, NODE_BORDER_COLOR,<br>NODE_BORDER_STYLE, NODE_Z_INDEX, NODE_VISIBILITY, NODE_CLIP,<br>NODE_CLIP_SHAPE, NODE_TRANSFORM, NODE_HIT_TEST_BEHAVIOR, NODE_POSITION,<br>NODE_SHADOW, NODE_CUSTOM_SHADOW, NODE_BACKGROUND_IMAGE_SIZE, NODE_BACKGROUND_IMAGE_SIZE_WITH_STYLE,<br>NODE_BACKGROUND_BLUR_STYLE, NODE_TRANSFORM_CENTER, NODE_OPACITY_TRANSITION, NODE_ROTATE_TRANSITION,<br>NODE_SCALE_TRANSITION, NODE_TRANSLATE_TRANSITION, NODE_MOVE_TRANSITION, NODE_FOCUSABLE,<br>NODE_DEFAULT_FOCUS, NODE_RESPONSE_REGION, NODE_OVERLAY, NODE_SWEEP_GRADIENT,<br>NODE_RADIAL_GRADIENT, NODE_MASK, NODE_BLEND_MODE, NODE_DIRECTION,<br>NODE_CONSTRAINT_SIZE, NODE_GRAY_SCALE, NODE_INVERT, NODE_SEPIA,<br>NODE_CONTRAST, NODE_FOREGROUND_COLOR, NODE_OFFSET, NODE_MARK_ANCHOR,<br>NODE_BACKGROUND_IMAGE_POSITION, NODE_ALIGN_RULES, NODE_ALIGN_SELF, NODE_FLEX_GROW,<br>NODE_FLEX_SHRINK, NODE_FLEX_BASIS, NODE_ACCESSIBILITY_GROUP, NODE_ACCESSIBILITY_TEXT,<br>NODE_ACCESSIBILITY_MODE, NODE_ACCESSIBILITY_DESCRIPTION, NODE_FOCUS_STATUS, NODE_ASPECT_RATIO,<br>NODE_LAYOUT_WEIGHT, NODE_DISPLAY_PRIORITY, NODE_OUTLINE_WIDTH, NODE_WIDTH_PERCENT,<br>NODE_HEIGHT_PERCENT, NODE_PADDING_PERCENT, NODE_MARGIN_PERCENT, NODE_GEOMETRY_TRANSITION,<br>NODE_RELATIVE_LAYOUT_CHAIN_MODE, NODE_RENDER_FIT, NODE_OUTLINE_COLOR, NODE_SIZE,<br>NODE_RENDER_GROUP, NODE_COLOR_BLEND, NODE_FOREGROUND_BLUR_STYLE, NODE_LAYOUT_RECT,<br>NODE_FOCUS_ON_TOUCH, NODE_BORDER_WIDTH_PERCENT, NODE_BORDER_RADIUS_PERCENT, NODE_ACCESSIBILITY_ID = 87,<br>NODE_ACCESSIBILITY_ACTIONS = 88, NODE_ACCESSIBILITY_ROLE = 89, NODE_ACCESSIBILITY_STATE = 90, NODE_ACCESSIBILITY_VALUE = 91,<br>NODE_EXPAND_SAFE_AREA = 92, NODE_VISIBLE_AREA_CHANGE_RATIO = 93, NODE_TRANSITION = 94, NODE_UNIQUE_ID = 95,<br>NODE_CLICK_DISTANCE = 96, NODE_TEXT_CONTENT = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TEXT, NODE_FONT_COLOR, NODE_FONT_SIZE,<br>NODE_FONT_STYLE, NODE_FONT_WEIGHT, NODE_TEXT_LINE_HEIGHT, NODE_TEXT_DECORATION,<br>NODE_TEXT_CASE, NODE_TEXT_LETTER_SPACING, NODE_TEXT_MAX_LINES, NODE_TEXT_ALIGN,<br>NODE_TEXT_OVERFLOW, NODE_FONT_FAMILY, NODE_TEXT_COPY_OPTION, NODE_TEXT_BASELINE_OFFSET,<br>NODE_TEXT_TEXT_SHADOW, NODE_TEXT_MIN_FONT_SIZE, NODE_TEXT_MAX_FONT_SIZE, NODE_TEXT_FONT,<br>NODE_TEXT_HEIGHT_ADAPTIVE_POLICY, NODE_TEXT_INDENT, NODE_TEXT_WORD_BREAK, NODE_TEXT_ELLIPSIS_MODE,<br>NODE_TEXT_LINE_SPACING, NODE_FONT_FEATURE, NODE_TEXT_ENABLE_DATA_DETECTOR, NODE_TEXT_ENABLE_DATA_DETECTOR_CONFIG,<br>NODE_TEXT_SELECTED_BACKGROUND_COLOR, NODE_TEXT_CONTENT_WITH_STYLED_STRING, NODE_TEXT_HALF_LEADING = 1029, NODE_SPAN_CONTENT = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_SPAN,<br>NODE_SPAN_TEXT_BACKGROUND_STYLE, NODE_SPAN_BASELINE_OFFSET, NODE_IMAGE_SPAN_SRC = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_IMAGE_SPAN, NODE_IMAGE_SPAN_VERTICAL_ALIGNMENT,<br>NODE_IMAGE_SPAN_ALT, NODE_IMAGE_SPAN_BASELINE_OFFSET = 3003, NODE_IMAGE_SRC = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_IMAGE, NODE_IMAGE_OBJECT_FIT,<br>NODE_IMAGE_INTERPOLATION, NODE_IMAGE_OBJECT_REPEAT, NODE_IMAGE_COLOR_FILTER, NODE_IMAGE_AUTO_RESIZE,<br>NODE_IMAGE_ALT, NODE_IMAGE_DRAGGABLE, NODE_IMAGE_RENDER_MODE, NODE_IMAGE_FIT_ORIGINAL_SIZE,<br>NODE_IMAGE_FILL_COLOR, NODE_IMAGE_RESIZABLE, NODE_TOGGLE_SELECTED_COLOR = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TOGGLE, NODE_TOGGLE_SWITCH_POINT_COLOR,<br>NODE_TOGGLE_VALUE, NODE_TOGGLE_UNSELECTED_COLOR, NODE_LOADING_PROGRESS_COLOR = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_LOADING_PROGRESS, NODE_LOADING_PROGRESS_ENABLE_LOADING,<br>NODE_TEXT_INPUT_PLACEHOLDER = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TEXT_INPUT, NODE_TEXT_INPUT_TEXT, NODE_TEXT_INPUT_CARET_COLOR, NODE_TEXT_INPUT_CARET_STYLE,<br>NODE_TEXT_INPUT_SHOW_UNDERLINE, NODE_TEXT_INPUT_MAX_LENGTH, NODE_TEXT_INPUT_ENTER_KEY_TYPE, NODE_TEXT_INPUT_PLACEHOLDER_COLOR,<br>NODE_TEXT_INPUT_PLACEHOLDER_FONT, NODE_TEXT_INPUT_ENABLE_KEYBOARD_ON_FOCUS, NODE_TEXT_INPUT_TYPE, NODE_TEXT_INPUT_SELECTED_BACKGROUND_COLOR,<br>NODE_TEXT_INPUT_SHOW_PASSWORD_ICON, NODE_TEXT_INPUT_EDITING, NODE_TEXT_INPUT_CANCEL_BUTTON, NODE_TEXT_INPUT_TEXT_SELECTION,<br>NODE_TEXT_INPUT_UNDERLINE_COLOR, NODE_TEXT_INPUT_ENABLE_AUTO_FILL, NODE_TEXT_INPUT_CONTENT_TYPE, NODE_TEXT_INPUT_PASSWORD_RULES,<br>NODE_TEXT_INPUT_SELECT_ALL, NODE_TEXT_INPUT_INPUT_FILTER, NODE_TEXT_INPUT_STYLE, NODE_TEXT_INPUT_CARET_OFFSET,<br>NODE_TEXT_INPUT_CONTENT_RECT, NODE_TEXT_INPUT_CONTENT_LINE_COUNT, NODE_TEXT_INPUT_SELECTION_MENU_HIDDEN, NODE_TEXT_INPUT_BLUR_ON_SUBMIT,<br>NODE_TEXT_INPUT_CUSTOM_KEYBOARD, NODE_TEXT_INPUT_WORD_BREAK, NODE_TEXT_INPUT_NUMBER_OF_LINES, NODE_TEXT_INPUT_SHOW_KEYBOARD_ON_FOCUS,<br>NODE_TEXT_AREA_PLACEHOLDER = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TEXT_AREA, NODE_TEXT_AREA_TEXT, NODE_TEXT_AREA_MAX_LENGTH, NODE_TEXT_AREA_PLACEHOLDER_COLOR,<br>NODE_TEXT_AREA_PLACEHOLDER_FONT, NODE_TEXT_AREA_CARET_COLOR, NODE_TEXT_AREA_EDITING, NODE_TEXT_AREA_TYPE,<br>NODE_TEXT_AREA_SHOW_COUNTER, NODE_TEXT_AREA_SELECTION_MENU_HIDDEN, NODE_TEXT_AREA_BLUR_ON_SUBMIT, NODE_TEXT_AREA_INPUT_FILTER,<br>NODE_TEXT_AREA_SELECTED_BACKGROUND_COLOR, NODE_TEXT_AREA_ENTER_KEY_TYPE, NODE_TEXT_AREA_ENABLE_KEYBOARD_ON_FOCUS, NODE_TEXT_AREA_CARET_OFFSET,<br>NODE_TEXT_AREA_CONTENT_RECT, NODE_TEXT_AREA_CONTENT_LINE_COUNT, NODE_TEXT_AREA_TEXT_SELECTION, NODE_TEXT_AREA_ENABLE_AUTO_FILL,<br>NODE_TEXT_AREA_CONTENT_TYPE, NODE_TEXT_AREA_NUMBER_OF_LINES, NODE_TEXT_AREA_SHOW_KEYBOARD_ON_FOCUS, NODE_BUTTON_LABEL = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_BUTTON,<br>NODE_BUTTON_TYPE, NODE_PROGRESS_VALUE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_PROGRESS, NODE_PROGRESS_TOTAL, NODE_PROGRESS_COLOR,<br>NODE_PROGRESS_TYPE, NODE_CHECKBOX_SELECT = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_CHECKBOX, NODE_CHECKBOX_SELECT_COLOR, NODE_CHECKBOX_UNSELECT_COLOR,<br>NODE_CHECKBOX_MARK, NODE_CHECKBOX_SHAPE, NODE_XCOMPONENT_ID = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_XCOMPONENT, NODE_XCOMPONENT_TYPE,<br>NODE_XCOMPONENT_SURFACE_SIZE, NODE_DATE_PICKER_LUNAR = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_DATE_PICKER, NODE_DATE_PICKER_START, NODE_DATE_PICKER_END,<br>NODE_DATE_PICKER_SELECTED, NODE_DATE_PICKER_DISAPPEAR_TEXT_STYLE, NODE_DATE_PICKER_TEXT_STYLE, NODE_DATE_PICKER_SELECTED_TEXT_STYLE,<br>NODE_TIME_PICKER_SELECTED = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TIME_PICKER, NODE_TIME_PICKER_USE_MILITARY_TIME, NODE_TIME_PICKER_DISAPPEAR_TEXT_STYLE, NODE_TIME_PICKER_TEXT_STYLE,<br>NODE_TIME_PICKER_SELECTED_TEXT_STYLE, NODE_TEXT_PICKER_OPTION_RANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TEXT_PICKER, NODE_TEXT_PICKER_OPTION_SELECTED, NODE_TEXT_PICKER_OPTION_VALUE,<br>NODE_TEXT_PICKER_DISAPPEAR_TEXT_STYLE, NODE_TEXT_PICKER_TEXT_STYLE, NODE_TEXT_PICKER_SELECTED_TEXT_STYLE, NODE_TEXT_PICKER_SELECTED_INDEX,<br>NODE_TEXT_PICKER_CAN_LOOP, NODE_TEXT_PICKER_DEFAULT_PICKER_ITEM_HEIGHT, NODE_CALENDAR_PICKER_HINT_RADIUS = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_CALENDAR_PICKER, NODE_CALENDAR_PICKER_SELECTED_DATE,<br>NODE_CALENDAR_PICKER_EDGE_ALIGNMENT, NODE_CALENDAR_PICKER_TEXT_STYLE, NODE_SLIDER_BLOCK_COLOR = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_SLIDER, NODE_SLIDER_TRACK_COLOR,<br>NODE_SLIDER_SELECTED_COLOR, NODE_SLIDER_SHOW_STEPS, NODE_SLIDER_BLOCK_STYLE, NODE_SLIDER_VALUE,<br>NODE_SLIDER_MIN_VALUE, NODE_SLIDER_MAX_VALUE, NODE_SLIDER_STEP, NODE_SLIDER_DIRECTION,<br>NODE_SLIDER_REVERSE, NODE_SLIDER_STYLE, NODE_SLIDER_TRACK_THICKNESS, NODE_RADIO_CHECKED = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_RADIO,<br>NODE_RADIO_STYLE, NODE_RADIO_VALUE, NODE_RADIO_GROUP, NODE_STACK_ALIGN_CONTENT = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_STACK,<br>NODE_SCROLL_BAR_DISPLAY_MODE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_SCROLL, NODE_SCROLL_BAR_WIDTH, NODE_SCROLL_BAR_COLOR, NODE_SCROLL_SCROLL_DIRECTION,<br>NODE_SCROLL_EDGE_EFFECT, NODE_SCROLL_ENABLE_SCROLL_INTERACTION, NODE_SCROLL_FRICTION, NODE_SCROLL_SNAP,<br>NODE_SCROLL_NESTED_SCROLL, NODE_SCROLL_OFFSET, NODE_SCROLL_EDGE, NODE_SCROLL_ENABLE_PAGING,<br>NODE_SCROLL_PAGE, NODE_SCROLL_BY, NODE_SCROLL_FLING, NODE_SCROLL_FADING_EDGE,<br>NODE_LIST_DIRECTION = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_LIST, NODE_LIST_STICKY, NODE_LIST_SPACE, NODE_LIST_NODE_ADAPTER,<br>NODE_LIST_CACHED_COUNT, NODE_LIST_SCROLL_TO_INDEX, NODE_LIST_ALIGN_LIST_ITEM, NODE_LIST_CHILDREN_MAIN_SIZE = 1003007,<br>NODE_LIST_INITIAL_INDEX = 1003008, NODE_LIST_DIVIDER = 1003009, NODE_SWIPER_LOOP = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_SWIPER, NODE_SWIPER_AUTO_PLAY,<br>NODE_SWIPER_SHOW_INDICATOR, NODE_SWIPER_INTERVAL, NODE_SWIPER_VERTICAL, NODE_SWIPER_DURATION,<br>NODE_SWIPER_CURVE, NODE_SWIPER_ITEM_SPACE, NODE_SWIPER_INDEX, NODE_SWIPER_DISPLAY_COUNT,<br>NODE_SWIPER_DISABLE_SWIPE, NODE_SWIPER_SHOW_DISPLAY_ARROW, NODE_SWIPER_EDGE_EFFECT_MODE, NODE_SWIPER_NODE_ADAPTER,<br>NODE_SWIPER_CACHED_COUNT, NODE_SWIPER_PREV_MARGIN, NODE_SWIPER_NEXT_MARGIN, NODE_SWIPER_INDICATOR,<br>NODE_SWIPER_NESTED_SCROLL, NODE_SWIPER_SWIPE_TO_INDEX, NODE_SWIPER_INDICATOR_INTERACTIVE, NODE_LIST_ITEM_SWIPE_ACTION = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_LIST_ITEM,<br>NODE_LIST_ITEM_GROUP_SET_HEADER = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_LIST_ITEM_GROUP, NODE_LIST_ITEM_GROUP_SET_FOOTER, NODE_LIST_ITEM_GROUP_SET_DIVIDER, NODE_LIST_ITEM_GROUP_CHILDREN_MAIN_SIZE = 1005003,<br>NODE_COLUMN_ALIGN_ITEMS = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_COLUMN, NODE_COLUMN_JUSTIFY_CONTENT, NODE_ROW_ALIGN_ITEMS = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_ROW, NODE_ROW_JUSTIFY_CONTENT,<br>NODE_FLEX_OPTION = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_FLEX, NODE_REFRESH_REFRESHING = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_REFRESH, NODE_REFRESH_CONTENT, NODE_REFRESH_PULL_DOWN_RATIO = 1009002,<br>NODE_REFRESH_OFFSET = 1009003, NODE_REFRESH_PULL_TO_REFRESH = 1009004, NODE_WATER_FLOW_LAYOUT_DIRECTION = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_WATER_FLOW, NODE_WATER_FLOW_COLUMN_TEMPLATE,<br>NODE_WATER_FLOW_ROW_TEMPLATE, NODE_WATER_FLOW_COLUMN_GAP, NODE_WATER_FLOW_ROW_GAP, NODE_WATER_FLOW_SECTION_OPTION,<br>NODE_WATER_FLOW_NODE_ADAPTER, NODE_WATER_FLOW_CACHED_COUNT, NODE_WATER_FLOW_FOOTER, NODE_WATER_FLOW_SCROLL_TO_INDEX,<br>NODE_WATER_FLOW_ITEM_CONSTRAINT_SIZE, NODE_RELATIVE_CONTAINER_GUIDE_LINE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_RELATIVE_CONTAINER, NODE_RELATIVE_CONTAINER_BARRIER, NODE_GRID_COLUMN_TEMPLATE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_GRID,<br>NODE_GRID_ROW_TEMPLATE, NODE_GRID_COLUMN_GAP, NODE_GRID_ROW_GAP, NODE_GRID_NODE_ADAPTER,<br>NODE_GRID_CACHED_COUNT, NODE_IMAGE_ANIMATOR_IMAGES = ARKUI_NODE_IMAGE_ANIMATOR \* MAX_NODE_SCOPE_NUM, NODE_IMAGE_ANIMATOR_STATE, NODE_IMAGE_ANIMATOR_DURATION,<br>NODE_IMAGE_ANIMATOR_REVERSE, NODE_IMAGE_ANIMATOR_FIXED_SIZE, NODE_IMAGE_ANIMATOR_FILL_MODE, NODE_IMAGE_ANIMATOR_ITERATION<br>} | Defines the ArkUI style attributes that can be set on the native side. |
154| [ArkUI_NodeEventType](#arkui_nodeeventtype) {<br>NODE_TOUCH_EVENT = 0, NODE_EVENT_ON_APPEAR, NODE_EVENT_ON_DISAPPEAR, NODE_EVENT_ON_AREA_CHANGE,<br>NODE_ON_FOCUS, NODE_ON_BLUR, NODE_ON_CLICK, NODE_ON_TOUCH_INTERCEPT,<br>NODE_EVENT_ON_VISIBLE_AREA_CHANGE, NODE_ON_HOVER, NODE_ON_MOUSE, NODE_EVENT_ON_ATTACH,<br>NODE_EVENT_ON_DETACH, NODE_ON_ACCESSIBILITY_ACTIONS = 13, NODE_ON_PRE_DRAG = 14, NODE_ON_DRAG_START = 15,<br>NODE_ON_DRAG_ENTER = 16, NODE_ON_DRAG_MOVE = 17, NODE_ON_DRAG_LEAVE = 18, NODE_ON_DROP = 19,<br>NODE_ON_DRAG_END = 20, NODE_TEXT_ON_DETECT_RESULT_UPDATE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TEXT, NODE_IMAGE_ON_COMPLETE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_IMAGE, NODE_IMAGE_ON_ERROR,<br>NODE_IMAGE_ON_SVG_PLAY_FINISH, NODE_IMAGE_ON_DOWNLOAD_PROGRESS, NODE_TOGGLE_ON_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TOGGLE, NODE_TEXT_INPUT_ON_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TEXT_INPUT,<br>NODE_TEXT_INPUT_ON_SUBMIT, NODE_TEXT_INPUT_ON_CUT, NODE_TEXT_INPUT_ON_PASTE, NODE_TEXT_INPUT_ON_TEXT_SELECTION_CHANGE,<br>NODE_TEXT_INPUT_ON_EDIT_CHANGE, NODE_TEXT_INPUT_ON_INPUT_FILTER_ERROR, NODE_TEXT_INPUT_ON_CONTENT_SCROLL, NODE_TEXT_INPUT_ON_CONTENT_SIZE_CHANGE,<br>NODE_TEXT_INPUT_ON_WILL_INSERT = 7009, NODE_TEXT_INPUT_ON_DID_INSERT = 7010, NODE_TEXT_INPUT_ON_WILL_DELETE = 7011, NODE_TEXT_INPUT_ON_DID_DELETE = 7012,<br>NODE_TEXT_AREA_ON_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TEXT_AREA, NODE_TEXT_AREA_ON_PASTE, NODE_TEXT_AREA_ON_TEXT_SELECTION_CHANGE, NODE_TEXT_AREA_ON_EDIT_CHANGE,<br>NODE_TEXT_AREA_ON_SUBMIT, NODE_TEXT_AREA_ON_INPUT_FILTER_ERROR, NODE_TEXT_AREA_ON_CONTENT_SCROLL, NODE_TEXT_AREA_ON_CONTENT_SIZE_CHANGE,<br>NODE_TEXT_AREA_ON_WILL_INSERT = 8008, NODE_TEXT_AREA_ON_DID_INSERT = 8009, NODE_TEXT_AREA_ON_WILL_DELETE = 8010, NODE_TEXT_AREA_ON_DID_DELETE = 8011,<br>NODE_CHECKBOX_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_CHECKBOX, NODE_DATE_PICKER_EVENT_ON_DATE_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_DATE_PICKER, NODE_TIME_PICKER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TIME_PICKER, NODE_TEXT_PICKER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TEXT_PICKER,<br>NODE_CALENDAR_PICKER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_CALENDAR_PICKER, NODE_SLIDER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_SLIDER, NODE_RADIO_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_RADIO, NODE_IMAGE_ANIMATOR_EVENT_ON_START = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_IMAGE_ANIMATOR,<br>NODE_IMAGE_ANIMATOR_EVENT_ON_PAUSE, NODE_IMAGE_ANIMATOR_EVENT_ON_REPEAT, NODE_IMAGE_ANIMATOR_EVENT_ON_CANCEL, NODE_IMAGE_ANIMATOR_EVENT_ON_FINISH,<br>NODE_SWIPER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_SWIPER, NODE_SWIPER_EVENT_ON_ANIMATION_START, NODE_SWIPER_EVENT_ON_ANIMATION_END, NODE_SWIPER_EVENT_ON_GESTURE_SWIPE,<br>NODE_SWIPER_EVENT_ON_CONTENT_DID_SCROLL, NODE_SCROLL_EVENT_ON_SCROLL = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_SCROLL, NODE_SCROLL_EVENT_ON_SCROLL_FRAME_BEGIN, NODE_SCROLL_EVENT_ON_WILL_SCROLL,<br>NODE_SCROLL_EVENT_ON_DID_SCROLL, NODE_SCROLL_EVENT_ON_SCROLL_START, NODE_SCROLL_EVENT_ON_SCROLL_STOP, NODE_SCROLL_EVENT_ON_SCROLL_EDGE,<br>NODE_SCROLL_EVENT_ON_REACH_START, NODE_SCROLL_EVENT_ON_REACH_END, NODE_LIST_ON_SCROLL_INDEX = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_LIST, NODE_LIST_ON_WILL_SCROLL,<br>NODE_LIST_ON_DID_SCROLL, NODE_REFRESH_STATE_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_REFRESH, NODE_REFRESH_ON_REFRESH, NODE_REFRESH_ON_OFFSET_CHANGE,<br>NODE_ON_WILL_SCROLL = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_WATER_FLOW, NODE_WATER_FLOW_ON_DID_SCROLL, NODE_WATER_FLOW_ON_SCROLL_INDEX<br>} | Enumerates the event types supported by the NativeNode component. |
155| [ArkUI_NodeDirtyFlag](#arkui_nodedirtyflag) { NODE_NEED_MEASURE = 1, NODE_NEED_LAYOUT, NODE_NEED_RENDER } | Enumerates the dirty area flags passed in the **::markDirty** API. |
156| [ArkUI_NodeCustomEventType](#arkui_nodecustomeventtype) {<br>ARKUI_NODE_CUSTOM_EVENT_ON_MEASURE = 1 &lt;&lt; 0, ARKUI_NODE_CUSTOM_EVENT_ON_LAYOUT = 1 &lt;&lt; 1, ARKUI_NODE_CUSTOM_EVENT_ON_DRAW = 1 &lt;&lt; 2, ARKUI_NODE_CUSTOM_EVENT_ON_FOREGROUND_DRAW = 1 &lt;&lt; 3,<br>ARKUI_NODE_CUSTOM_EVENT_ON_OVERLAY_DRAW = 1 &lt;&lt; 4<br>} | Enumerates the custom component event types. |
157| [ArkUI_NodeAdapterEventType](#arkui_nodeadaptereventtype) {<br>NODE_ADAPTER_EVENT_WILL_ATTACH_TO_NODE = 1, NODE_ADAPTER_EVENT_WILL_DETACH_FROM_NODE = 2, NODE_ADAPTER_EVENT_ON_GET_NODE_ID = 3, NODE_ADAPTER_EVENT_ON_ADD_NODE_TO_ADAPTER = 4,<br>NODE_ADAPTER_EVENT_ON_REMOVE_NODE_FROM_ADAPTER = 5<br>} | Enumerates node adapter events. |
158| [ArkUI_NodeContentEventType](#arkui_nodecontenteventtype) { NODE_CONTENT_EVENT_ON_ATTACH_TO_WINDOW = 0, NODE_CONTENT_EVENT_ON_DETACH_FROM_WINDOW = 1 } | Defines the NodeContent event type. |
159| [ArkUI_Alignment](#arkui_alignment) {<br>ARKUI_ALIGNMENT_TOP_START = 0, ARKUI_ALIGNMENT_TOP, ARKUI_ALIGNMENT_TOP_END, ARKUI_ALIGNMENT_START,<br>ARKUI_ALIGNMENT_CENTER, ARKUI_ALIGNMENT_END, ARKUI_ALIGNMENT_BOTTOM_START, ARKUI_ALIGNMENT_BOTTOM,<br>ARKUI_ALIGNMENT_BOTTOM_END<br>} | Enumerates the alignment modes. |
160| [ArkUI_ImageRepeat](#arkui_imagerepeat) { ARKUI_IMAGE_REPEAT_NONE = 0, ARKUI_IMAGE_REPEAT_X, ARKUI_IMAGE_REPEAT_Y, ARKUI_IMAGE_REPEAT_XY } | Enumerates the image repeat patterns. |
161| [ArkUI_FontStyle](#arkui_fontstyle) { ARKUI_FONT_STYLE_NORMAL = 0, ARKUI_FONT_STYLE_ITALIC } | Enumerates the font styles. |
162| [ArkUI_FontWeight](#arkui_fontweight) {<br>ARKUI_FONT_WEIGHT_W100 = 0, ARKUI_FONT_WEIGHT_W200, ARKUI_FONT_WEIGHT_W300, ARKUI_FONT_WEIGHT_W400,<br>ARKUI_FONT_WEIGHT_W500, ARKUI_FONT_WEIGHT_W600, ARKUI_FONT_WEIGHT_W700, ARKUI_FONT_WEIGHT_W800,<br>ARKUI_FONT_WEIGHT_W900, ARKUI_FONT_WEIGHT_BOLD, ARKUI_FONT_WEIGHT_NORMAL, ARKUI_FONT_WEIGHT_BOLDER,<br>ARKUI_FONT_WEIGHT_LIGHTER, ARKUI_FONT_WEIGHT_MEDIUM, ARKUI_FONT_WEIGHT_REGULAR<br>} | Enumerates the font weights. |
163| [ArkUI_TextAlignment](#arkui_textalignment) { ARKUI_TEXT_ALIGNMENT_START = 0, ARKUI_TEXT_ALIGNMENT_CENTER, ARKUI_TEXT_ALIGNMENT_END, ARKUI_TEXT_ALIGNMENT_JUSTIFY } | Enumerates the text alignment mode. |
164| [ArkUI_EnterKeyType](#arkui_enterkeytype) {<br>ARKUI_ENTER_KEY_TYPE_GO = 2, ARKUI_ENTER_KEY_TYPE_SEARCH = 3, ARKUI_ENTER_KEY_TYPE_SEND, ARKUI_ENTER_KEY_TYPE_NEXT,<br>ARKUI_ENTER_KEY_TYPE_DONE, ARKUI_ENTER_KEY_TYPE_PREVIOUS, ARKUI_ENTER_KEY_TYPE_NEW_LINE<br>} | Enumerates the types of the Enter key for a single-line text box. |
165| [ArkUI_TextInputType](#arkui_textinputtype) {<br>ARKUI_TEXTINPUT_TYPE_NORMAL = 0, ARKUI_TEXTINPUT_TYPE_NUMBER = 2, ARKUI_TEXTINPUT_TYPE_PHONE_NUMBER = 3, ARKUI_TEXTINPUT_TYPE_EMAIL = 5,<br>ARKUI_TEXTINPUT_TYPE_PASSWORD = 7, ARKUI_TEXTINPUT_TYPE_NUMBER_PASSWORD = 8, ARKUI_TEXTINPUT_TYPE_SCREEN_LOCK_PASSWORD = 9, ARKUI_TEXTINPUT_TYPE_USER_NAME = 10,<br>ARKUI_TEXTINPUT_TYPE_NEW_PASSWORD = 11, ARKUI_TEXTINPUT_TYPE_NUMBER_DECIMAL = 12<br>} | Enumerates the text input types. |
166| [ArkUI_TextAreaType](#arkui_textareatype) { ARKUI_TEXTAREA_TYPE_NORMAL = 0, ARKUI_TEXTAREA_TYPE_NUMBER = 2, ARKUI_TEXTAREA_TYPE_PHONE_NUMBER = 3, ARKUI_TEXTAREA_TYPE_EMAIL = 5 } | Enumerates the text box types. |
167| [ArkUI_CancelButtonStyle](#arkui_cancelbuttonstyle) { ARKUI_CANCELBUTTON_STYLE_CONSTANT = 0, ARKUI_CANCELBUTTON_STYLE_INVISIBLE, ARKUI_CANCELBUTTON_STYLE_INPUT } | Enumerates the styles of the Cancel button. |
168| [ArkUI_XComponentType](#arkui_xcomponenttype) { ARKUI_XCOMPONENT_TYPE_SURFACE = 0, ARKUI_XCOMPONENT_TYPE_TEXTURE = 2 } |Enumerates the types of the XComponent type. |
169| [ArkUI_ProgressType](#arkui_progresstype) {<br>ARKUI_PROGRESS_TYPE_LINEAR = 0, ARKUI_PROGRESS_TYPE_RING, ARKUI_PROGRESS_TYPE_ECLIPSE, ARKUI_PROGRESS_TYPE_SCALE_RING,<br>ARKUI_PROGRESS_TYPE_CAPSULE<br>} | Enumerates the styles of the progress indicator. |
170| [ArkUI_TextDecorationType](#arkui_textdecorationtype) { ARKUI_TEXT_DECORATION_TYPE_NONE = 0, ARKUI_TEXT_DECORATION_TYPE_UNDERLINE, ARKUI_TEXT_DECORATION_TYPE_OVERLINE, ARKUI_TEXT_DECORATION_TYPE_LINE_THROUGH } | Enumerates the text decoration types. |
171| [ArkUI_TextDecorationStyle](#arkui_textdecorationstyle) {<br>ARKUI_TEXT_DECORATION_STYLE_SOLID = 0, ARKUI_TEXT_DECORATION_STYLE_DOUBLE, ARKUI_TEXT_DECORATION_STYLE_DOTTED, ARKUI_TEXT_DECORATION_STYLE_DASHED,<br>ARKUI_TEXT_DECORATION_STYLE_WAVY<br>} | Enumerates the text decoration styles. |
172| [ArkUI_TextCase](#arkui_textcase) { ARKUI_TEXT_CASE_NORMAL = 0, ARKUI_TEXT_CASE_LOWER, ARKUI_TEXT_CASE_UPPER } |  Enumerates the text cases. |
173| [ArkUI_CopyOptions](#arkui_copyoptions) { ARKUI_COPY_OPTIONS_NONE = 0, ARKUI_COPY_OPTIONS_IN_APP, ARKUI_COPY_OPTIONS_LOCAL_DEVICE, ARKUI_COPY_OPTIONS_CROSS_DEVICE } | Enumerates the text copy and paste modes. |
174| [ArkUI_ShadowType](#arkui_shadowtype) { ARKUI_SHADOW_TYPE_COLOR = 0, ARKUI_SHADOW_TYPE_BLUR } | Enumerates the shadow types. |
175| [ArkUI_TextPickerRangeType](#arkui_textpickerrangetype) { ARKUI_TEXTPICKER_RANGETYPE_SINGLE = 0, ARKUI_TEXTPICKER_RANGETYPE_MULTI, ARKUI_TEXTPICKER_RANGETYPE_RANGE_CONTENT, ARKUI_TEXTPICKER_RANGETYPE_CASCADE_RANGE_CONTENT } | Enumerates the types of the text picker. |
176| [ArkUI_AccessibilityCheckedState](#arkui_accessibilitycheckedstate) { ARKUI_ACCESSIBILITY_UNCHECKED = 0, ARKUI_ACCESSIBILITY_CHECKED } | Enumerates the accessibility check box states. |
177| [ArkUI_AccessibilityActionType](#arkui_accessibilityactiontype) {<br>ARKUI_ACCESSIBILITY_ACTION_CLICK = 1 &lt;&lt; 0, ARKUI_ACCESSIBILITY_ACTION_LONG_CLICK = 1 &lt;&lt; 1, ARKUI_ACCESSIBILITY_ACTION_CUT = 1 &lt;&lt; 2, ARKUI_ACCESSIBILITY_ACTION_COPY = 1 &lt;&lt; 3,<br>ARKUI_ACCESSIBILITY_ACTION_PASTE = 1 &lt;&lt; 4<br>} | Defines an enum for the accessibility action types. |
178| [ArkUI_EdgeEffect](#arkui_edgeeffect) { ARKUI_EDGE_EFFECT_SPRING = 0, ARKUI_EDGE_EFFECT_FADE, ARKUI_EDGE_EFFECT_NONE } | Enumerates the effects used at the edges of the component when the boundary of the scrollable content is reached. |
179| [ArkUI_ScrollDirection](#arkui_scrolldirection) { ARKUI_SCROLL_DIRECTION_VERTICAL = 0, ARKUI_SCROLL_DIRECTION_HORIZONTAL, ARKUI_SCROLL_DIRECTION_NONE = 3 } | Enumerates the scroll directions of scrollable components. |
180| [ArkUI_ScrollSnapAlign](#arkui_scrollsnapalign) { ARKUI_SCROLL_SNAP_ALIGN_NONE = 0, ARKUI_SCROLL_SNAP_ALIGN_START, ARKUI_SCROLL_SNAP_ALIGN_CENTER, ARKUI_SCROLL_SNAP_ALIGN_END } | Enumerates the alignment modes of list items when scrolling ends. |
181| [ArkUI_ScrollBarDisplayMode](#arkui_scrollbardisplaymode) { ARKUI_SCROLL_BAR_DISPLAY_MODE_OFF = 0, ARKUI_SCROLL_BAR_DISPLAY_MODE_AUTO, ARKUI_SCROLL_BAR_DISPLAY_MODE_ON } | Enumerates the scrollbar display modes. |
182| [ArkUI_Axis](#arkui_axis) { ARKUI_AXIS_VERTICAL = 0, ARKUI_AXIS_HORIZONTAL } | Enumerates the scroll directions. |
183| [ArkUI_StickyStyle](#arkui_stickystyle) { ARKUI_STICKY_STYLE_NONE = 0, ARKUI_STICKY_STYLE_HEADER = 1, ARKUI_STICKY_STYLE_FOOTER = 2, ARKUI_STICKY_STYLE_BOTH = 3 } | Enumerates the modes for pinning the header to the top or the footer to the bottom. |
184| [ArkUI_BorderStyle](#arkui_borderstyle) { ARKUI_BORDER_STYLE_SOLID = 0, ARKUI_BORDER_STYLE_DASHED, ARKUI_BORDER_STYLE_DOTTED } | Enumerates the border styles. |
185| [ArkUI_HitTestMode](#arkui_hittestmode) { ARKUI_HIT_TEST_MODE_DEFAULT = 0, ARKUI_HIT_TEST_MODE_BLOCK, ARKUI_HIT_TEST_MODE_TRANSPARENT, ARKUI_HIT_TEST_MODE_NONE } | Enumerates the hit test modes. |
186| [ArkUI_ShadowStyle](#arkui_shadowstyle) {<br>ARKUI_SHADOW_STYLE_OUTER_DEFAULT_XS = 0, ARKUI_SHADOW_STYLE_OUTER_DEFAULT_SM, ARKUI_SHADOW_STYLE_OUTER_DEFAULT_MD, ARKUI_SHADOW_STYLE_OUTER_DEFAULT_LG,<br>ARKUI_SHADOW_STYLE_OUTER_FLOATING_SM, ARKUI_SHADOW_STYLE_OUTER_FLOATING_MD<br>} | Enumerated value of the shadow effect. |
187| [ArkUI_AnimationCurve](#arkui_animationcurve) {<br>ARKUI_CURVE_LINEAR = 0, ARKUI_CURVE_EASE, ARKUI_CURVE_EASE_IN, ARKUI_CURVE_EASE_OUT,<br>ARKUI_CURVE_EASE_IN_OUT, ARKUI_CURVE_FAST_OUT_SLOW_IN, ARKUI_CURVE_LINEAR_OUT_SLOW_IN, ARKUI_CURVE_FAST_OUT_LINEAR_IN,<br>ARKUI_CURVE_EXTREME_DECELERATION, ARKUI_CURVE_SHARP, ARKUI_CURVE_RHYTHM, ARKUI_CURVE_SMOOTH,<br>ARKUI_CURVE_FRICTION<br>} | Enumerates the animation curves. |
188| [ArkUI_SwiperArrow](#arkui_swiperarrow) { ARKUI_SWIPER_ARROW_HIDE = 0, ARKUI_SWIPER_ARROW_SHOW, ARKUI_SWIPER_ARROW_SHOW_ON_HOVER } | Enumerates arrow styles of the navigation point indicator. |
189| [ArkUI_SwiperNestedScrollMode](#arkui_swipernestedscrollmode) { ARKUI_SWIPER_NESTED_SRCOLL_SELF_ONLY = 0, ARKUI_SWIPER_NESTED_SRCOLL_SELF_FIRST } | Enumerates the nested scrolling mode of the **Swiper** component and its parent container. |
190| [ArkUI_AccessibilityMode](#arkui_accessibilitymode) { ARKUI_ACCESSIBILITY_MODE_AUTO = 0, ARKUI_ACCESSIBILITY_MODE_ENABLED, ARKUI_ACCESSIBILITY_MODE_DISABLED, ARKUI_ACCESSIBILITY_MODE_DISABLED_FOR_DESCENDANTS } | Enumerates the accessibility modes. |
191| [ArkUI_TextCopyOptions](#arkui_textcopyoptions) { ARKUI_TEXT_COPY_OPTIONS_NONE = 0, ARKUI_TEXT_COPY_OPTIONS_IN_APP, ARKUI_TEXT_COPY_OPTIONS_LOCAL_DEVICE, ARKUI_TEXT_COPY_OPTIONS_CROSS_DEVICE } | Enumerates copy options, which define whether copy and paste is allowed for text content. |
192| [ArkUI_TextHeightAdaptivePolicy](#arkui_textheightadaptivepolicy) { ARKUI_TEXT_HEIGHT_ADAPTIVE_POLICY_MAX_LINES_FIRST = 0, ARKUI_TEXT_HEIGHT_ADAPTIVE_POLICY_MIN_FONT_SIZE_FIRST, ARKUI_TEXT_HEIGHT_ADAPTIVE_POLICY_LAYOUT_CONSTRAINT_FIRST } | Defines how the adaptive height is determined for the text. |
193| [ArkUI_ScrollNestedMode](#arkui_scrollnestedmode) { ARKUI_SCROLL_NESTED_MODE_SELF_ONLY = 0, ARKUI_SCROLL_NESTED_MODE_SELF_FIRST, ARKUI_SCROLL_NESTED_MODE_PARENT_FIRST, ARKUI_SCROLL_NESTED_MODE_PARALLEL } | Enumerates the nested scrolling modes. |
194| [ArkUI_ScrollEdge](#arkui_scrolledge) { ARKUI_SCROLL_EDGE_TOP = 0, ARKUI_SCROLL_EDGE_BOTTOM, ARKUI_SCROLL_EDGE_START, ARKUI_SCROLL_EDGE_END } | Defines the edge to which the component scrolls. |
195| [ArkUI_ScrollAlignment](#arkui_scrollalignment) { ARKUI_SCROLL_ALIGNMENT_START = 0, ARKUI_SCROLL_ALIGNMENT_CENTER, ARKUI_SCROLL_ALIGNMENT_END, ARKUI_SCROLL_ALIGNMENT_AUTO } | Defines how the list item to scroll to is aligned with the container. |
196| [ArkUI_ScrollState](#arkui_scrollstate) { ARKUI_SCROLL_STATE_IDLE = 0, ARKUI_SCROLL_STATE_SCROLL, ARKUI_SCROLL_STATE_FLING } | Enumerates the scrolling states. |
197| [ArkUI_SliderBlockStyle](#arkui_sliderblockstyle) { ARKUI_SLIDER_BLOCK_STYLE_DEFAULT = 0, ARKUI_SLIDER_BLOCK_STYLE_IMAGE, ARKUI_SLIDER_BLOCK_STYLE_SHAPE } | Enumerates the styles of the slider in the block direction. |
198| [ArkUI_SliderDirection](#arkui_sliderdirection) { ARKUI_SLIDER_DIRECTION_VERTICAL = 0, ARKUI_SLIDER_DIRECTION_HORIZONTAL } | Enumerates the scroll directions of the slider. |
199| [ArkUI_SliderStyle](#arkui_sliderstyle) { ARKUI_SLIDER_STYLE_OUT_SET = 0, ARKUI_SLIDER_STYLE_IN_SET, ARKUI_SLIDER_STYLE_NONE } | Enumerates the slider styles. |
200| [ArkUI_CheckboxShape](#arkui_checkboxshape) { ArkUI_CHECKBOX_SHAPE_CIRCLE = 0, ArkUI_CHECKBOX_SHAPE_ROUNDED_SQUARE } | Enumerates the shapes of the check box. |
201| [ArkUI_AnimationPlayMode](#arkui_animationplaymode) { ARKUI_ANIMATION_PLAY_MODE_NORMAL = 0, ARKUI_ANIMATION_PLAY_MODE_REVERSE, ARKUI_ANIMATION_PLAY_MODE_ALTERNATE, ARKUI_ANIMATION_PLAY_MODE_ALTERNATE_REVERSE } | Enumerates the animation playback modes. |
202| [ArkUI_ImageSize](#arkui_imagesize) { ARKUI_IMAGE_SIZE_AUTO = 0, ARKUI_IMAGE_SIZE_COVER, ARKUI_IMAGE_SIZE_CONTAIN } | Defines the image size. |
203| [ArkUI_AdaptiveColor](#arkui_adaptivecolor) { ARKUI_ADAPTIVE_COLOR_DEFAULT = 0, ARKUI_ADAPTIVE_COLOR_AVERAGE } | Enumerates the adaptive color modes. |
204| [ArkUI_ColorMode](#arkui_colormode) { ARKUI_COLOR_MODE_SYSTEM = 0, ARKUI_COLOR_MODE_LIGHT, ARKUI_COLOR_MODE_DARK } | Enumerates the color modes. |
205| [ArkUI_SystemColorMode](#arkui_systemcolormode) { ARKUI_SYSTEM_COLOR_MODE_LIGHT = 0, ARKUI_SYSTEM_COLOR_MODE_DARK } | Enumerates the system color modes. |
206| [ArkUI_BlurStyle](#arkui_blurstyle) {<br>ARKUI_BLUR_STYLE_THIN = 0, ARKUI_BLUR_STYLE_REGULAR, ARKUI_BLUR_STYLE_THICK, ARKUI_BLUR_STYLE_BACKGROUND_THIN,<br>ARKUI_BLUR_STYLE_BACKGROUND_REGULAR, ARKUI_BLUR_STYLE_BACKGROUND_THICK, ARKUI_BLUR_STYLE_BACKGROUND_ULTRA_THICK, ARKUI_BLUR_STYLE_NONE,<br>ARKUI_BLUR_STYLE_COMPONENT_ULTRA_THIN, ARKUI_BLUR_STYLE_COMPONENT_THIN, ARKUI_BLUR_STYLE_COMPONENT_REGULAR, ARKUI_BLUR_STYLE_COMPONENT_THICK,<br>ARKUI_BLUR_STYLE_COMPONENT_ULTRA_THICK<br>} | Enumerates the blur styles. |
207| [ArkUI_VerticalAlignment](#arkui_verticalalignment) { ARKUI_VERTICAL_ALIGNMENT_TOP = 0, ARKUI_VERTICAL_ALIGNMENT_CENTER, ARKUI_VERTICAL_ALIGNMENT_BOTTOM } | Enumerates the vertical alignment modes. |
208| [ArkUI_HorizontalAlignment](#arkui_horizontalalignment) { ARKUI_HORIZONTAL_ALIGNMENT_START = 0, ARKUI_HORIZONTAL_ALIGNMENT_CENTER, ARKUI_HORIZONTAL_ALIGNMENT_END } | Enumerates the alignment mode in the horizontal direction. |
209| [ArkUI_TextOverflow](#arkui_textoverflow) { ARKUI_TEXT_OVERFLOW_NONE = 0, ARKUI_TEXT_OVERFLOW_CLIP, ARKUI_TEXT_OVERFLOW_ELLIPSIS, ARKUI_TEXT_OVERFLOW_MARQUEE } | Enumerates the display modes when the text is too long. |
210| [ArkUI_ImageSpanAlignment](#arkui_imagespanalignment) { ARKUI_IMAGE_SPAN_ALIGNMENT_BASELINE = 0, ARKUI_IMAGE_SPAN_ALIGNMENT_BOTTOM, ARKUI_IMAGE_SPAN_ALIGNMENT_CENTER, ARKUI_IMAGE_SPAN_ALIGNMENT_TOP } | Enumerates the alignment mode of the image with the text. |
211| [ArkUI_ObjectFit](#arkui_objectfit) {<br>ARKUI_OBJECT_FIT_CONTAIN = 0, ARKUI_OBJECT_FIT_COVER, ARKUI_OBJECT_FIT_AUTO, ARKUI_OBJECT_FIT_FILL,<br>ARKUI_OBJECT_FIT_SCALE_DOWN, ARKUI_OBJECT_FIT_NONE, ARKUI_OBJECT_FIT_NONE_AND_ALIGN_TOP_START, ARKUI_OBJECT_FIT_NONE_AND_ALIGN_TOP,<br>ARKUI_OBJECT_FIT_NONE_AND_ALIGN_TOP_END, ARKUI_OBJECT_FIT_NONE_AND_ALIGN_START, ARKUI_OBJECT_FIT_NONE_AND_ALIGN_CENTER, ARKUI_OBJECT_FIT_NONE_AND_ALIGN_END,<br>ARKUI_OBJECT_FIT_NONE_AND_ALIGN_BOTTOM_START, ARKUI_OBJECT_FIT_NONE_AND_ALIGN_BOTTOM, ARKUI_OBJECT_FIT_NONE_AND_ALIGN_BOTTOM_END<br>} | Enumerates the image filling effects.  |
212| [ArkUI_ImageInterpolation](#arkui_imageinterpolation) { ARKUI_IMAGE_INTERPOLATION_NONE = 0, ARKUI_IMAGE_INTERPOLATION_LOW, ARKUI_IMAGE_INTERPOLATION_MEDIUM, ARKUI_IMAGE_INTERPOLATION_HIGH } | Enumerates the image interpolation effects. |
213| [ArkUI_BlendMode](#arkui_blendmode) {<br>ARKUI_BLEND_MODE_NONE = 0, ARKUI_BLEND_MODE_CLEAR, ARKUI_BLEND_MODE_SRC, ARKUI_BLEND_MODE_DST,<br>ARKUI_BLEND_MODE_SRC_OVER, ARKUI_BLEND_MODE_DST_OVER, ARKUI_BLEND_MODE_SRC_IN, ARKUI_BLEND_MODE_DST_IN,<br>ARKUI_BLEND_MODE_SRC_OUT, ARKUI_BLEND_MODE_DST_OUT, ARKUI_BLEND_MODE_SRC_ATOP, ARKUI_BLEND_MODE_DST_ATOP,<br>ARKUI_BLEND_MODE_XOR, ARKUI_BLEND_MODE_PLUS, ARKUI_BLEND_MODE_MODULATE, ARKUI_BLEND_MODE_SCREEN,<br>ARKUI_BLEND_MODE_OVERLAY, ARKUI_BLEND_MODE_DARKEN, ARKUI_BLEND_MODE_LIGHTEN, ARKUI_BLEND_MODE_COLOR_DODGE,<br>ARKUI_BLEND_MODE_COLOR_BURN, ARKUI_BLEND_MODE_HARD_LIGHT, ARKUI_BLEND_MODE_SOFT_LIGHT, ARKUI_BLEND_MODE_DIFFERENCE,<br>ARKUI_BLEND_MODE_EXCLUSION, ARKUI_BLEND_MODE_MULTIPLY, ARKUI_BLEND_MODE_HUE, ARKUI_BLEND_MODE_SATURATION,<br>ARKUI_BLEND_MODE_COLOR, ARKUI_BLEND_MODE_LUMINOSITY<br>} | Enumerates the blend modes. |
214| [ArkUI_Direction](#arkui_direction) { ARKUI_DIRECTION_LTR = 0, ARKUI_DIRECTION_RTL, ARKUI_DIRECTION_AUTO = 3 } | Enumerates the modes in which components are laid out along the main axis of the container. |
215| [ArkUI_ItemAlignment](#arkui_itemalignment) {<br>ARKUI_ITEM_ALIGNMENT_AUTO = 0, ARKUI_ITEM_ALIGNMENT_START, ARKUI_ITEM_ALIGNMENT_CENTER, ARKUI_ITEM_ALIGNMENT_END,<br>ARKUI_ITEM_ALIGNMENT_STRETCH, ARKUI_ITEM_ALIGNMENT_BASELINE<br>} | Enumerates the modes in which components are laid out along the cross axis of the container. |
216| [ArkUI_ColorStrategy](#arkui_colorstrategy) { ARKUI_COLOR_STRATEGY_INVERT = 0, ARKUI_COLOR_STRATEGY_AVERAGE, ARKUI_COLOR_STRATEGY_PRIMARY } | Enumerates the foreground colors. |
217| [ArkUI_FlexAlignment](#arkui_flexalignment) {<br>ARKUI_FLEX_ALIGNMENT_START = 1, ARKUI_FLEX_ALIGNMENT_CENTER = 2, ARKUI_FLEX_ALIGNMENT_END = 3, ARKUI_FLEX_ALIGNMENT_SPACE_BETWEEN = 6,<br>ARKUI_FLEX_ALIGNMENT_SPACE_AROUND = 7, ARKUI_FLEX_ALIGNMENT_SPACE_EVENLY = 8<br>} | Enumerates the vertical alignment modes. |
218| [ArkUI_FlexDirection](#arkui_flexdirection) { ARKUI_FLEX_DIRECTION_ROW = 0, ARKUI_FLEX_DIRECTION_COLUMN, ARKUI_FLEX_DIRECTION_ROW_REVERSE, ARKUI_FLEX_DIRECTION_COLUMN_REVERSE } | Enumerates the directions of the main axis in the flex container. |
219| [ArkUI_FlexWrap](#arkui_flexwrap) { ARKUI_FLEX_WRAP_NO_WRAP = 0, ARKUI_FLEX_WRAP_WRAP, ARKUI_FLEX_WRAP_WRAP_REVERSE } | Defines whether the flex container has a single line or multiple lines. |
220| [ArkUI_Visibility](#arkui_visibility) { ARKUI_VISIBILITY_VISIBLE = 0, ARKUI_VISIBILITY_HIDDEN, ARKUI_VISIBILITY_NONE } | Enumerates the visibility values. |
221| [ArkUI_CalendarAlignment](#arkui_calendaralignment) { ARKUI_CALENDAR_ALIGNMENT_START = 0, ARKUI_CALENDAR_ALIGNMENT_CENTER, ARKUI_CALENDAR_ALIGNMENT_END } | Enumerates the alignment modes between the calendar picker and the entry component. |
222| [ArkUI_MaskType](#arkui_masktype) {<br>ARKUI_MASK_TYPE_RECTANGLE = 0, ARKUI_MASK_TYPE_CIRCLE, ARKUI_MASK_TYPE_ELLIPSE, ARKUI_MASK_TYPE_PATH,<br>ARKUI_MASK_TYPE_PROGRESS<br>} | Enumerates the mask types. |
223| [ArkUI_ClipType](#arkui_cliptype) { ARKUI_CLIP_TYPE_RECTANGLE = 0, ARKUI_CLIP_TYPE_CIRCLE, ARKUI_CLIP_TYPE_ELLIPSE, ARKUI_CLIP_TYPE_PATH } | Enumerates the clipping region types. |
224| [ArkUI_ShapeType](#arkui_shapetype) { ARKUI_SHAPE_TYPE_RECTANGLE = 0, ARKUI_SHAPE_TYPE_CIRCLE, ARKUI_SHAPE_TYPE_ELLIPSE, ARKUI_SHAPE_TYPE_PATH } | Enumerates custom shape types. |
225| [ArkUI_LinearGradientDirection](#arkui_lineargradientdirection) {<br>ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT = 0, ARKUI_LINEAR_GRADIENT_DIRECTION_TOP, ARKUI_LINEAR_GRADIENT_DIRECTION_RIGHT, ARKUI_LINEAR_GRADIENT_DIRECTION_BOTTOM,<br>ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT_TOP, ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT_BOTTOM, ARKUI_LINEAR_GRADIENT_DIRECTION_RIGHT_TOP, ARKUI_LINEAR_GRADIENT_DIRECTION_RIGHT_BOTTOM,<br>ARKUI_LINEAR_GRADIENT_DIRECTION_NONE, ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM<br>} | Enumerates the gradient directions. |
226| [ArkUI_WordBreak](#arkui_wordbreak) { ARKUI_WORD_BREAK_NORMAL = 0, ARKUI_WORD_BREAK_BREAK_ALL, ARKUI_WORD_BREAK_BREAK_WORD } | Enumerates the word break rules. |
227| [ArkUI_EllipsisMode](#arkui_ellipsismode) { ARKUI_ELLIPSIS_MODE_START = 0, ARKUI_ELLIPSIS_MODE_CENTER, ARKUI_ELLIPSIS_MODE_END } | Enumerates the ellipsis positions. |
228| [ArkUI_ImageRenderMode](#arkui_imagerendermode) { ARKUI_IMAGE_RENDER_MODE_ORIGINAL = 0, ARKUI_IMAGE_RENDER_MODE_TEMPLATE } | Enumerates the image rendering modes. |
229| [ArkUI_TransitionEdge](#arkui_transitionedge) { ARKUI_TRANSITION_EDGE_TOP = 0, ARKUI_TRANSITION_EDGE_BOTTOM, ARKUI_TRANSITION_EDGE_START, ARKUI_TRANSITION_EDGE_END } | Enumerates the slide-in and slide-out positions of the component from the screen edge during transition. |
230| [ArkUI_FinishCallbackType](#arkui_finishcallbacktype) { ARKUI_FINISH_CALLBACK_REMOVED = 0, ARKUI_FINISH_CALLBACK_LOGICALLY } | Enumerates the animation **onFinish** callback types. |
231| [ArkUI_ListItemAlignment](#arkui_listitemalignment) { ARKUI_LIST_ITEM_ALIGNMENT_START = 0, ARKUI_LIST_ITEM_ALIGNMENT_CENTER, ARKUI_LIST_ITEM_ALIGNMENT_END } | Enumerates the alignment modes of items along the cross axis. |
232| [ArkUI_BlendApplyType](#arkui_blendapplytype) { BLEND_APPLY_TYPE_FAST = 0, BLEND_APPLY_TYPE_OFFSCREEN } | Defines how the specified blend mode is applied. |
233| [ArkUI_LengthMetricUnit](#arkui_lengthmetricunit) { ARKUI_LENGTH_METRIC_UNIT_DEFAULT = -1, ARKUI_LENGTH_METRIC_UNIT_PX = 0, ARKUI_LENGTH_METRIC_UNIT_VP, ARKUI_LENGTH_METRIC_UNIT_FP } | Enumerates the component units. |
234| [ArkUI_TextInputContentType](#arkui_textinputcontenttype) {<br>ARKUI_TEXTINPUT_CONTENT_TYPE_USER_NAME = 0, ARKUI_TEXTINPUT_CONTENT_TYPE_PASSWORD, ARKUI_TEXTINPUT_CONTENT_TYPE_NEW_PASSWORD, ARKUI_TEXTINPUT_CONTENT_TYPE_FULL_STREET_ADDRESS,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_HOUSE_NUMBER, ARKUI_TEXTINPUT_CONTENT_TYPE_DISTRICT_ADDRESS, ARKUI_TEXTINPUT_CONTENT_TYPE_CITY_ADDRESS, ARKUI_TEXTINPUT_CONTENT_TYPE_PROVINCE_ADDRESS,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_COUNTRY_ADDRESS, ARKUI_TEXTINPUT_CONTENT_TYPE_PERSON_FULL_NAME, ARKUI_TEXTINPUT_CONTENT_TYPE_PERSON_LAST_NAME, ARKUI_TEXTINPUT_CONTENT_TYPE_PERSON_FIRST_NAME,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_PHONE_NUMBER, ARKUI_TEXTINPUT_CONTENT_TYPE_PHONE_COUNTRY_CODE, ARKUI_TEXTINPUT_CONTENT_TYPE_FULL_PHONE_NUMBER, ARKUI_TEXTINPUT_CONTENT_EMAIL_ADDRESS,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_BANK_CARD_NUMBER, ARKUI_TEXTINPUT_CONTENT_TYPE_ID_CARD_NUMBER, ARKUI_TEXTINPUT_CONTENT_TYPE_NICKNAME, ARKUI_TEXTINPUT_CONTENT_TYPE_DETAIL_INFO_WITHOUT_STREET,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_FORMAT_ADDRESS<br>} | Enumerates the autofill types. |
235| [ArkUI_BarrierDirection](#arkui_barrierdirection) { ARKUI_BARRIER_DIRECTION_START = 0, ARKUI_BARRIER_DIRECTION_END, ARKUI_BARRIER_DIRECTION_TOP, ARKUI_BARRIER_DIRECTION_BOTTOM } | Enumerates the barrier directions. |
236| [ArkUI_RelativeLayoutChainStyle](#arkui_relativelayoutchainstyle) { ARKUI_RELATIVE_LAYOUT_CHAIN_STYLE_SPREAD = 0, ARKUI_RELATIVE_LAYOUT_CHAIN_STYLE_SPREAD_INSIDE, ARKUI_RELATIVE_LAYOUT_CHAIN_STYLE_PACKED } | Enumerates the chain styles. |
237| [ArkUI_TextInputStyle](#arkui_textinputstyle) { ARKUI_TEXTINPUT_STYLE_DEFAULT = 0, ARKUI_TEXTINPUT_STYLE_INLINE } | Enumerates the text input styles. |
238| [ArkUI_TextDataDetectorType](#arkui_textdatadetectortype) { ARKUI_TEXT_DATA_DETECTOR_TYPE_PHONE_NUMBER = 0, ARKUI_TEXT_DATA_DETECTOR_TYPE_URL, ARKUI_TEXT_DATA_DETECTOR_TYPE_EMAIL, ARKUI_TEXT_DATA_DETECTOR_TYPE_ADDRESS } | Enumerates the entity types of text recognition. |
239| [ArkUI_ButtonType](#arkui_buttontype) { ARKUI_BUTTON_TYPE_NORMAL = 0, ARKUI_BUTTON_TYPE_CAPSULE, ARKUI_BUTTON_TYPE_CIRCLE } | Enumerates the button types. |
240| [ArkUI_RenderFit](#arkui_renderfit) {<br>ARKUI_RENDER_FIT_CENTER = 0, ARKUI_RENDER_FIT_TOP, ARKUI_RENDER_FIT_BOTTOM, ARKUI_RENDER_FIT_LEFT,<br>ARKUI_RENDER_FIT_RIGHT, ARKUI_RENDER_FIT_TOP_LEFT, ARKUI_RENDER_FIT_TOP_RIGHT, ARKUI_RENDER_FIT_BOTTOM_LEFT,<br>ARKUI_RENDER_FIT_BOTTOM_RIGHT, ARKUI_RENDER_FIT_RESIZE_FILL, ARKUI_RENDER_FIT_RESIZE_CONTAIN, ARKUI_RENDER_FIT_RESIZE_CONTAIN_TOP_LEFT,<br>ARKUI_RENDER_FIT_RESIZE_CONTAIN_BOTTOM_RIGHT, ARKUI_RENDER_FIT_RESIZE_COVER, ARKUI_RENDER_FIT_RESIZE_COVER_TOP_LEFT, ARKUI_RENDER_FIT_RESIZE_COVER_BOTTOM_RIGHT<br>} |  |
241| [ArkUI_ThemeColorMode](#arkui_themecolormode) { ARKUI_THEME_COLOR_MODE_SYSTEM = 0, ARKUI_THEME_COLOR_MODE_LIGHT, ARKUI_THEME_COLOR_MODE_DARK } |  |
242| [ArkUI_SwiperIndicatorType](#arkui_swiperindicatortype) { ARKUI_SWIPER_INDICATOR_TYPE_DOT, ARKUI_SWIPER_INDICATOR_TYPE_DIGIT } | Enumerates the navigation point indicator types of the **Swiper** component. |
243| [ArkUI_AnimationDirection](#arkui_animationdirection) { ARKUI_ANIMATION_DIRECTION_NORMAL = 0, ARKUI_ANIMATION_DIRECTION_REVERSE, ARKUI_ANIMATION_DIRECTION_ALTERNATE, ARKUI_ANIMATION_DIRECTION_ALTERNATE_REVERSE } | Enumerates the animation playback modes. |
244| [ArkUI_AnimationFill](#arkui_animationfill) { ARKUI_ANIMATION_FILL_NONE = 0, ARKUI_ANIMATION_FILL_FORWARDS, ARKUI_ANIMATION_FILL_BACKWARDS, ARKUI_ANIMATION_FILL_BOTH } | Enumerates the state of the animated target after the animation is executed. |
245| [ArkUI_SwiperDisplayModeType](#arkui_swiperdisplaymodetype) { ARKUI_SWIPER_DISPLAY_MODE_STRETCH, ARKUI_SWIPER_DISPLAY_MODE_AUTO_LINEAR } | Enumerates the modes in which elements are displayed along the main axis of the **Swiper** component. |
246| [ArkUI_ListItemSwipeActionState](#arkui_listitemswipeactionstate) { ARKUI_LIST_ITEM_SWIPE_ACTION_STATE_COLLAPSED = 0, ARKUI_LIST_ITEM_SWIPE_ACTION_STATE_EXPANDED, ARKUI_LIST_ITEM_SWIPE_ACTION_STATE_ACTIONING } | Enumerates the swipe action item states of list items. |
247| [ArkUI_ListItemSwipeEdgeEffect](#arkui_listitemswipeedgeeffect) { ARKUI_LIST_ITEM_SWIPE_EDGE_EFFECT_SPRING = 0, ARKUI_LIST_ITEM_SWIPE_EDGE_EFFECT_NONE } | Enumerates the swipe action item edge effects of list items. |
248| [ArkUI_AnimationStatus](#arkui_animationstatus) { ARKUI_ANIMATION_STATUS_INITIAL, ARKUI_ANIMATION_STATUS_RUNNING, ARKUI_ANIMATION_STATUS_PAUSED, ARKUI_ANIMATION_STATUS_STOPPED } | Enumerates the playback states of the frame-by-frame animation. |
249| [ArkUI_AnimationFillMode](#arkui_animationfillmode) { ARKUI_ANIMATION_FILL_MODE_NONE, ARKUI_ANIMATION_FILL_MODE_FORWARDS, ARKUI_ANIMATION_FILL_MODE_BACKWARDS, ARKUI_ANIMATION_FILL_MODE_BOTH } | Enumerates the states before and after execution of the frame-by-frame animation. |
250| [ArkUI_ErrorCode](#arkui_errorcode) {<br>ARKUI_ERROR_CODE_NO_ERROR = 0, ARKUI_ERROR_CODE_PARAM_INVALID = 401, ARKUI_ERROR_CODE_ATTRIBUTE_OR_EVENT_NOT_SUPPORTED = 106102, ARKUI_ERROR_CODE_NOT_SUPPROTED_FOR_ARKTS_NODE = 106103,<br>ARKUI_ERROR_CODE_NODE_ADAPTER_NONE_HOST = 106104, ARKUI_ERROR_CODE_NODE_ADAPTER_EXIST_IN_HOST = 106105, ARKUI_ERROR_CODE_NODE_ADAPTER_CHILD_NODE_EXIST = 106106, ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INDEX_OUT_OF_RANGE = 106107,<br>ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INVALID = 106108, ARKUI_ERROR_CODE_NODE_EVENT_NO_RETURN = 106109, ARKUI_ERROR_CODE_NODE_INDEX_INVALID = 106200, ARKUI_ERROR_CODE_GET_INFO_FAILED = 106201,<br>ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR = 106202, ARKUI_ERROR_CODE_NON_SCROLLABLE_CONTAINER = 180001, ARKUI_ERROR_CODE_BUFFER_SIZE_NOT_ENOUGH = 180002, ARKUI_ERROR_CODE_INVALID_STYLED_STRING = 180101<br>} | Defines an enum for the error codes. |
251| [ArkUI_ScrollSource](#arkui_scrollsource) {<br>ARKUI_SCROLL_SOURCE_DRAG = 0, ARKUI_SCROLL_SOURCE_FLING, ARKUI_SCROLL_SOURCE_EDGE_EFFECT, ARKUI_SCROLL_SOURCE_OTHER_USER_INPUT,<br>ARKUI_SCROLL_SOURCE_SCROLL_BAR, ARKUI_SCROLL_SOURCE_SCROLL_BAR_FLING, ARKUI_SCROLL_SOURCE_SCROLLER, ARKUI_SCROLL_SOURCE_ANIMATION<br>} | Enumerates the scrolling sources. |
252| [ArkUI_SafeAreaType](#arkui_safeareatype) { ARKUI_SAFE_AREA_TYPE_SYSTEM = 1, ARKUI_SAFE_AREA_TYPE_CUTOUT = 1 &lt;&lt; 1, ARKUI_SAFE_AREA_TYPE_KEYBOARD = 1 &lt;&lt; 2 } | Enumerates the types of expanded safe areas. |
253| [ArkUI_SafeAreaEdge](#arkui_safeareaedge) { ARKUI_SAFE_AREA_EDGE_TOP = 1, ARKUI_SAFE_AREA_EDGE_BOTTOM = 1 &lt;&lt; 1, ARKUI_SAFE_AREA_EDGE_START = 1 &lt;&lt; 2, ARKUI_SAFE_AREA_EDGE_END = 1 &lt;&lt; 3 } | Enumerates the edges for expanding the safe area. |
254| [ArkUI_NavDestinationState](#arkui_navdestinationstate) {<br>ARKUI_NAV_DESTINATION_STATE_ON_SHOW = 0, ARKUI_NAV_DESTINATION_STATE_ON_HIDE = 1, ARKUI_NAV_DESTINATION_STATE_ON_APPEAR = 2, ARKUI_NAV_DESTINATION_STATE_ON_DISAPPEAR = 3,<br>ARKUI_NAV_DESTINATION_STATE_ON_WILL_SHOW = 4, ARKUI_NAV_DESTINATION_STATE_ON_WILL_HIDE = 5, ARKUI_NAV_DESTINATION_STATE_ON_WILL_APPEAR = 6, ARKUI_NAV_DESTINATION_STATE_ON_WILL_DISAPPEAR = 7,<br>ARKUI_NAV_DESTINATION_STATE_ON_BACK_PRESS = 100<br>} | Defines an enum for the **NavDestination** component states. |
255| [ArkUI_RouterPageState](#arkui_routerpagestate) {<br>ARKUI_ROUTER_PAGE_STATE_ON_WILL_APPEAR = 0, ARKUI_ROUTER_PAGE_STATE_ON_WILL_DISAPPEAR = 1, ARKUI_ROUTER_PAGE_STATE_ON_SHOW = 2, ARKUI_ROUTER_PAGE_STATE_ON_HIDE = 3,<br>ARKUI_ROUTER_PAGE_STATE_ON_BACK_PRESS = 4<br>} | Enumerates the states of a page during routing. |
256
257### Functions
258
259| Name| Description|
260| -------- | -------- |
261| [ArkUI_DragEvent](#arkui_dragevent) \* [OH_ArkUI_NodeEvent_GetDragEvent](#oh_arkui_nodeevent_getdragevent) ([ArkUI_NodeEvent](#arkui_nodeevent-12) \*nodeEvent) | Obtains a **DragEvent** object from the specified **NodeEvent** object. |
262| [ArkUI_PreDragStatus](#arkui_predragstatus) [OH_ArkUI_NodeEvent_GetPreDragStatus](#oh_arkui_nodeevent_getpredragstatus) ([ArkUI_NodeEvent](#arkui_nodeevent-12) \*nodeEvent) | Obtains the state prior to a drop and drop operation. |
263| int32_t [OH_ArkUI_DragEvent_DisableDefaultDropAnimation](#oh_arkui_dragevent_disabledefaultdropanimation) ([ArkUI_DragEvent](#arkui_dragevent) \*event, bool disable) | Sets whether to disable the default drop animation, which is enabled by default. Use this API to apply a custom drop animation. |
264| int32_t [OH_ArkUI_DragEvent_SetSuggestedDropOperation](#oh_arkui_dragevent_setsuggesteddropoperation) ([ArkUI_DragEvent](#arkui_dragevent) \*event, [ArkUI_DropProposal](#arkui_dropproposal) proposal) | Sets the data processing mode. |
265| int32_t [OH_ArkUI_DragEvent_SetDragResult](#oh_arkui_dragevent_setdragresult) ([ArkUI_DragEvent](#arkui_dragevent) \*event, [ArkUI_DragResult](#arkui_dragresult) result) | Sets the result for a drag event. |
266| int32_t [OH_ArkUI_DragEvent_SetData](#oh_arkui_dragevent_setdata) ([ArkUI_DragEvent](#arkui_dragevent) \*event, [OH_UdmfData](#oh_udmfdata) \*data) | Sets drag data for a drag event. |
267| int32_t [OH_ArkUI_DragEvent_GetUdmfData](#oh_arkui_dragevent_getudmfdata) ([ArkUI_DragEvent](#arkui_dragevent) \*event, [OH_UdmfData](#oh_udmfdata) \*data) | Obtains the default drag data from a drag event. |
268| int32_t [OH_ArkUI_DragEvent_GetDataTypesCount](#oh_arkui_dragevent_getdatatypescount) ([ArkUI_DragEvent](#arkui_dragevent) \*event, int32_t \*count) | Obtains the number of drag data types from a drag event. |
269| int32_t [OH_ArkUI_DragEvent_GetDataTypes](#oh_arkui_dragevent_getdatatypes) ([ArkUI_DragEvent](#arkui_dragevent) \*event, char \*\*result[], int32_t length) | Obtains the type list of drag data types from a drag event. |
270| int32_t [OH_ArkUI_DragEvent_GetDragResult](#oh_arkui_dragevent_getdragresult) ([ArkUI_DragEvent](#arkui_dragevent) \*event, [ArkUI_DragResult](#arkui_dragresult) \*result) | Obtains the drag and drop result from the drag event. |
271| float [OH_ArkUI_DragEvent_GetPreviewTouchPointX](#oh_arkui_dragevent_getpreviewtouchpointx) ([ArkUI_DragEvent](#arkui_dragevent) \*event) | Obtains the X coordinate of the touch point for a drag preview from a drag event. |
272| float [OH_ArkUI_DragEvent_GetPreviewTouchPointY](#oh_arkui_dragevent_getpreviewtouchpointy) ([ArkUI_DragEvent](#arkui_dragevent) \*event) | Obtains the Y coordinate of the touch point for a drag preview from a drag event. |
273| float [OH_ArkUI_DragEvent_GetPreviewRectWidth](#oh_arkui_dragevent_getpreviewrectwidth) ([ArkUI_DragEvent](#arkui_dragevent) \*event) | Obtains the width of a drag preview from a drag event. |
274| float [OH_ArkUI_DragEvent_GetPreviewRectHeight](#oh_arkui_dragevent_getpreviewrectheight) ([ArkUI_DragEvent](#arkui_dragevent) \*event) | Obtains the height of a drag preview from a drag event. |
275| float [OH_ArkUI_DragEvent_GetTouchPointXToWindow](#oh_arkui_dragevent_gettouchpointxtowindow) ([ArkUI_DragEvent](#arkui_dragevent) \*event) | Obtains the X coordinate of the touch point relative to the window from a drag event. |
276| float [OH_ArkUI_DragEvent_GetTouchPointYToWindow](#oh_arkui_dragevent_gettouchpointytowindow) ([ArkUI_DragEvent](#arkui_dragevent) \*event) | Obtains the Y coordinate of the touch point relative to the window from a drag event. |
277| float [OH_ArkUI_DragEvent_GetTouchPointXToDisplay](#oh_arkui_dragevent_gettouchpointxtodisplay) ([ArkUI_DragEvent](#arkui_dragevent) \*event) | Obtains the X coordinate of the touch point relative to the display from a drag event. |
278| float [OH_ArkUI_DragEvent_GetTouchPointYToDisplay](#oh_arkui_dragevent_gettouchpointytodisplay) ([ArkUI_DragEvent](#arkui_dragevent) \*event) | Obtains the Y coordinate of the touch point relative to the display from a drag event. |
279| float [OH_ArkUI_DragEvent_GetVelocityX](#oh_arkui_dragevent_getvelocityx) ([ArkUI_DragEvent](#arkui_dragevent) \*event) | Obtains the dragging velocity along the x-axis. |
280| float [OH_ArkUI_DragEvent_GetVelocityY](#oh_arkui_dragevent_getvelocityy) ([ArkUI_DragEvent](#arkui_dragevent) \*event) | Obtains the dragging velocity along the y-axis. |
281| float [OH_ArkUI_DragEvent_GetVelocity](#oh_arkui_dragevent_getvelocity) ([ArkUI_DragEvent](#arkui_dragevent) \*event) | Obtains the dragging velocity along the main axis. |
282| int32_t [OH_ArkUI_DragEvent_GetModifierKeyStates](#oh_arkui_dragevent_getmodifierkeystates) ([ArkUI_DragEvent](#arkui_dragevent) \*event, int64_t \*keys) | Obtains the pressed status of modifier keys from a drag event. |
283| int32_t [OH_ArkUI_SetDragEventStrictReportWithNode](#oh_arkui_setdrageventstrictreportwithnode) ([ArkUI_NodeHandle](#arkui_nodehandle) node, bool enabled) | Sets whether to enable strict reporting on drag events. This feature is disabled by default, and you are advised to enable it. If this feature is disabled, the parent component is not notified when an item in it is dragged over its child component. If this feature is enabled, the component is notified of the dragged item's leaving, and the child component to which the dragged item is dropped is notified of the item's entering. This configuration is related to a specific UI instance. You can pass in a specific component node on the current UI instance for association. |
284| int32_t [OH_ArkUI_SetDragEventStrictReportWithContext](#oh_arkui_setdrageventstrictreportwithcontext) ([ArkUI_ContextHandle](#arkui_contexthandle-12) uiContext, bool enabled) | Sets whether to enable strict reporting on drag events. This feature is disabled by default, and you are advised to enable it. If this feature is disabled, the parent component is not notified when an item in it is dragged over its child component. If this feature is enabled, the component is notified of the dragged item's leaving, and the child component to which the dragged item is dropped is notified of the item's entering. This configuration is related to a specific UI instance. You can pass in a specific UI instance for association. |
285| int32_t [OH_ArkUI_SetNodeAllowedDropDataTypes](#oh_arkui_setnodealloweddropdatatypes) ([ArkUI_NodeHandle](#arkui_nodehandle) node, const char \*typesArray[], int32_t count) | Sets the types of data that can be dropped to the specified component. This API resets the settings configured through [OH_ArkUI_DisallowNodeAnyDropDataTypes](#oh_arkui_disallownodeanydropdatatypes) or [OH_ArkUI_AllowNodeAllDropDataTypes](#oh_arkui_allownodealldropdatatypes). |
286| int32_t [OH_ArkUI_DisallowNodeAnyDropDataTypes](#oh_arkui_disallownodeanydropdatatypes) ([ArkUI_NodeHandle](#arkui_nodehandle) node) | Configures the specified component to disallow any data types. This API resets the settings configured through [OH_ArkUI_SetNodeAllowedDropDataTypes](#oh_arkui_setnodealloweddropdatatypes). |
287| int32_t [OH_ArkUI_AllowNodeAllDropDataTypes](#oh_arkui_allownodealldropdatatypes) ([ArkUI_NodeHandle](#arkui_nodehandle) node) | Configures the specified component to allow any data types. This API resets the settings configured through [OH_ArkUI_SetNodeAllowedDropDataTypes](#oh_arkui_setnodealloweddropdatatypes). |
288| int32_t [OH_ArkUI_SetNodeDraggable](#oh_arkui_setnodedraggable) ([ArkUI_NodeHandle](#arkui_nodehandle) node, bool enabled) | Sets whether the component is draggable. |
289| int32_t [OH_ArkUI_SetNodeDragPreview](#oh_arkui_setnodedragpreview) ([ArkUI_NodeHandle](#arkui_nodehandle) node, [OH_PixelmapNative](#oh_pixelmapnative) \*preview) | Sets a custom drag preview for the specified component. |
290| [ArkUI_DragPreviewOption](#arkui_dragpreviewoption) \* [OH_ArkUI_CreateDragPreviewOption](#oh_arkui_createdragpreviewoption) (void) | Creates an **ArkUI_DragPreviewOption** object. |
291| void [OH_ArkUI_DragPreviewOption_Dispose](#oh_arkui_dragpreviewoption_dispose) ([ArkUI_DragPreviewOption](#arkui_dragpreviewoption) \*option) | Disposes of an **ArkUI_DragPreviewOption** object. |
292| int32_t [OH_ArkUI_DragPreviewOption_SetScaleMode](#oh_arkui_dragpreviewoption_setscalemode) ([ArkUI_DragPreviewOption](#arkui_dragpreviewoption) \*option, [ArkUI_DragPreviewScaleMode](#arkui_dragpreviewscalemode) scaleMode) | Sets the scale mode for an **ArkUI_DragPreviewOption** object. |
293| int32_t [OH_ArkUI_DragPreviewOption_SetDefaultShadowEnabled](#oh_arkui_dragpreviewoption_setdefaultshadowenabled) ([ArkUI_DragPreviewOption](#arkui_dragpreviewoption) \*option, bool enabled) | Sets whether to enable the shadow effect for an **ArkUI_DragPreviewOption** object. The shadow effect is enabled by default. |
294| int32_t [OH_ArkUI_DragPreviewOption_SetDefaultRadiusEnabled](#oh_arkui_dragpreviewoption_setdefaultradiusenabled) ([ArkUI_DragPreviewOption](#arkui_dragpreviewoption) \*option, bool enabled) | Sets whether to enable the rounded corner effect for an **ArkUI_DragPreviewOption** object. The rounded corner effect is enabled by default. |
295| int32_t [OH_ArkUI_DragPreviewOption_SetNumberBadgeEnabled](#oh_arkui_dragpreviewoption_setnumberbadgeenabled) ([ArkUI_DragPreviewOption](#arkui_dragpreviewoption) \*option, bool enabled) | Sets whether to enable the badge for an **ArkUI_DragPreviewOption** object. If this feature is enabled, a badge that contains the number of dragged items is displayed. |
296| int32_t [OH_ArkUI_DragPreviewOption_SetBadgeNumber](#oh_arkui_dragpreviewoption_setbadgenumber) ([ArkUI_DragPreviewOption](#arkui_dragpreviewoption) \*option, uint32_t forcedNumber) | Sets the count on the badge. The settings will overwrite the value in the **SetDragPreviewNumberBadgeEnabled** API. |
297| int32_t [OH_ArkUI_DragPreviewOption_SetDefaultAnimationBeforeLiftingEnabled](#oh_arkui_dragpreviewoption_setdefaultanimationbeforeliftingenabled) ([ArkUI_DragPreviewOption](#arkui_dragpreviewoption) \*option, bool enabled) | Sets whether to enable the default animation on a click or touch. |
298| int32_t [OH_ArkUI_SetNodeDragPreviewOption](#oh_arkui_setnodedragpreviewoption) ([ArkUI_NodeHandle](#arkui_nodehandle) node, [ArkUI_DragPreviewOption](#arkui_dragpreviewoption) \*option) | Sets an **ArkUI_DragPreviewOption** object for the specified component. |
299| [ArkUI_DragAction](#arkui_dragaction) \* [OH_ArkUI_CreateDragActionWithNode](#oh_arkui_createdragactionwithnode) ([ArkUI_NodeHandle](#arkui_nodehandle) node) | Creates a drag action object. The object needs to be associated with a UI instance, which can be specified by passing in a component node of the current UI instance. |
300| [ArkUI_DragAction](#arkui_dragaction) \* [OH_ArkUI_CreateDragActionWithContext](#oh_arkui_createdragactionwithcontext) ([ArkUI_ContextHandle](#arkui_contexthandle-12) uiContext) | Creates a drag action object for the specified UI instance. |
301| void [OH_ArkUI_DragAction_Dispose](#oh_arkui_dragaction_dispose) ([ArkUI_DragAction](#arkui_dragaction) \*dragAction) | Disposes of an **ArkUI_DragAction** object. |
302| int32_t [OH_ArkUI_DragAction_SetPointerId](#oh_arkui_dragaction_setpointerid) ([ArkUI_DragAction](#arkui_dragaction) \*dragAction, int32_t pointer) | Sets the pointer ID. If only one finger is operating on the screen, the pointer ID is 0. In general cases, you can set the pointer ID to 0. |
303| int32_t [OH_ArkUI_DragAction_SetPixelMaps](#oh_arkui_dragaction_setpixelmaps) ([ArkUI_DragAction](#arkui_dragaction) \*dragAction, [OH_PixelmapNative](#oh_pixelmapnative) \*pixelmapArray[], int32_t size) | Sets the drag previews for a drag action. |
304| int32_t [OH_ArkUI_DragAction_SetTouchPointX](#oh_arkui_dragaction_settouchpointx) ([ArkUI_DragAction](#arkui_dragaction) \*dragAction, float x) | Sets the touch point relative to the upper left corner of the first drag preview (pixel map). |
305| int32_t [OH_ArkUI_DragAction_SetTouchPointY](#oh_arkui_dragaction_settouchpointy) ([ArkUI_DragAction](#arkui_dragaction) \*dragAction, float y) | Sets the touch point relative to the upper left corner of the first drag preview (pixel map). |
306| int32_t [OH_ArkUI_DragAction_SetData](#oh_arkui_dragaction_setdata) ([ArkUI_DragAction](#arkui_dragaction) \*dragAction, [OH_UdmfData](#oh_udmfdata) \*data) | Sets the drag data. |
307| int32_t [OH_ArkUI_DragAction_SetDragPreviewOption](#oh_arkui_dragaction_setdragpreviewoption) ([ArkUI_DragAction](#arkui_dragaction) \*dragAction, [ArkUI_DragPreviewOption](#arkui_dragpreviewoption) \*option) | Sets an **ArkUI_DragPreviewOption** object for the specified drag action object. |
308| int32_t [OH_ArkUI_DragAction_RegisterStatusListener](#oh_arkui_dragaction_registerstatuslistener) ([ArkUI_DragAction](#arkui_dragaction) \*dragAction, void \*userData, void(\*listener)([ArkUI_DragAndDropInfo](#arkui_draganddropinfo) \*dragAndDropInfo, void \*userData)) | Registers a drag status listener. This listener can be used to check whether the data is successfully received and processed. |
309| void [OH_ArkUI_DragAction_UnregisterStatusListener](#oh_arkui_dragaction_unregisterstatuslistener) ([ArkUI_DragAction](#arkui_dragaction) \*dragAction) | Unregisters a drag status listener. |
310| [ArkUI_DragStatus](#arkui_dragstatus) [OH_ArkUI_DragAndDropInfo_GetDragStatus](#oh_arkui_draganddropinfo_getdragstatus) ([ArkUI_DragAndDropInfo](#arkui_draganddropinfo) \*dragAndDropInfo) | Obtains the drag status of a drag action. |
311| [ArkUI_DragEvent](#arkui_dragevent) \* [OH_ArkUI_DragAndDropInfo_GetDragEvent](#oh_arkui_draganddropinfo_getdragevent) ([ArkUI_DragAndDropInfo](#arkui_draganddropinfo) \*dragAndDropInfo) | Obtains a drag event based on the specified drag and drop information. The drag event can then be used to obtain the drag result. |
312| int32_t [OH_ArkUI_StartDrag](#oh_arkui_startdrag) ([ArkUI_DragAction](#arkui_dragaction) \*dragAction) | Initiates a drag action through the specified **DragAction** object. |
313| [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) \* [OH_ArkUI_DrawableDescriptor_CreateFromPixelMap](#oh_arkui_drawabledescriptor_createfrompixelmap) ([OH_PixelmapNativeHandle](#oh_pixelmapnativehandle) pixelMap) | Creates a **DrawableDescriptor** object from a **PixelMap** object. |
314| [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) \* [OH_ArkUI_DrawableDescriptor_CreateFromAnimatedPixelMap](#oh_arkui_drawabledescriptor_createfromanimatedpixelmap) ([OH_PixelmapNativeHandle](#oh_pixelmapnativehandle) \*array, int32_t size) | Creates a **DrawableDescriptor** object from an array of **PixelMap** objects. |
315| void [OH_ArkUI_DrawableDescriptor_Dispose](#oh_arkui_drawabledescriptor_dispose) ([ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) \*drawableDescriptor) | Disposes of the pointer to a **DrawableDescriptor** object. |
316| [OH_PixelmapNativeHandle](#oh_pixelmapnativehandle) [OH_ArkUI_DrawableDescriptor_GetStaticPixelMap](#oh_arkui_drawabledescriptor_getstaticpixelmap) ([ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) \*drawableDescriptor) | Obtains the pointer to a **PixelMap** object. |
317| [OH_PixelmapNativeHandle](#oh_pixelmapnativehandle) \* [OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArray](#oh_arkui_drawabledescriptor_getanimatedpixelmaparray) ([ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) \*drawableDescriptor) | Obtains an array of **PixelMap** objects for playing an animation. |
318| int32_t [OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArraySize](#oh_arkui_drawabledescriptor_getanimatedpixelmaparraysize) ([ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) \*drawableDescriptor) | Obtains an array of **PixelMap** objects for playing an animation. |
319| void [OH_ArkUI_DrawableDescriptor_SetAnimationDuration](#oh_arkui_drawabledescriptor_setanimationduration) ([ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) \*drawableDescriptor, int32_t duration) | Sets the total playback duration for a pixel map image array. |
320| int32_t [OH_ArkUI_DrawableDescriptor_GetAnimationDuration](#oh_arkui_drawabledescriptor_getanimationduration) ([ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) \*drawableDescriptor) | Obtains the total playback duration for a pixel map image array. |
321| void [OH_ArkUI_DrawableDescriptor_SetAnimationIteration](#oh_arkui_drawabledescriptor_setanimationiteration) ([ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) \*drawableDescriptor, int32_t iteration) | Sets the number of times that a pixel map image array is played. |
322| int32_t [OH_ArkUI_DrawableDescriptor_GetAnimationIteration](#oh_arkui_drawabledescriptor_getanimationiteration) ([ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) \*drawableDescriptor) | Obtains the number of times that a pixel map image array is played. |
323| [ArkUI_AnimateOption](#arkui_animateoption) \* [OH_ArkUI_AnimateOption_Create](#oh_arkui_animateoption_create) () | Creates an animation configuration. |
324| void [OH_ArkUI_AnimateOption_Dispose](#oh_arkui_animateoption_dispose) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Destroys an animation configuration. |
325| int32_t [OH_ArkUI_AnimateOption_GetDuration](#oh_arkui_animateoption_getduration) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Obtains the animation duration, in milliseconds. |
326| float [OH_ArkUI_AnimateOption_GetTempo](#oh_arkui_animateoption_gettempo) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Obtains the playback speed of an animation. |
327| [ArkUI_AnimationCurve](#arkui_animationcurve) [OH_ArkUI_AnimateOption_GetCurve](#oh_arkui_animateoption_getcurve) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Obtains an animation curve. |
328| int32_t [OH_ArkUI_AnimateOption_GetDelay](#oh_arkui_animateoption_getdelay) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Obtains the animation delay, in milliseconds. |
329| int32_t [OH_ArkUI_AnimateOption_GetIterations](#oh_arkui_animateoption_getiterations) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Obtains the number of times that an animation is played. |
330| [ArkUI_AnimationPlayMode](#arkui_animationplaymode) [OH_ArkUI_AnimateOption_GetPlayMode](#oh_arkui_animateoption_getplaymode) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Obtains the playback mode of an animation. |
331| [ArkUI_ExpectedFrameRateRange](_ark_u_i___expected_frame_rate_range.md) \* [OH_ArkUI_AnimateOption_GetExpectedFrameRateRange](#oh_arkui_animateoption_getexpectedframeraterange) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Obtains the expected frame rate range of an animation. |
332| void [OH_ArkUI_AnimateOption_SetDuration](#oh_arkui_animateoption_setduration) ([ArkUI_AnimateOption](#arkui_animateoption) \*option, int32_t value) | Sets the animation duration. |
333| void [OH_ArkUI_AnimateOption_SetTempo](#oh_arkui_animateoption_settempo) ([ArkUI_AnimateOption](#arkui_animateoption) \*option, float value) | Sets the playback speed of an animation. |
334| void [OH_ArkUI_AnimateOption_SetCurve](#oh_arkui_animateoption_setcurve) ([ArkUI_AnimateOption](#arkui_animateoption) \*option, [ArkUI_AnimationCurve](#arkui_animationcurve) value) | Animation curve. |
335| void [OH_ArkUI_AnimateOption_SetDelay](#oh_arkui_animateoption_setdelay) ([ArkUI_AnimateOption](#arkui_animateoption) \*option, int32_t value) | Sets the animation delay. |
336| void [OH_ArkUI_AnimateOption_SetIterations](#oh_arkui_animateoption_setiterations) ([ArkUI_AnimateOption](#arkui_animateoption) \*option, int32_t value) | Number of times that the frame animation is played. |
337| void [OH_ArkUI_AnimateOption_SetPlayMode](#oh_arkui_animateoption_setplaymode) ([ArkUI_AnimateOption](#arkui_animateoption) \*option, [ArkUI_AnimationPlayMode](#arkui_animationplaymode) value) | Sets the playback mode for an animation. |
338| void [OH_ArkUI_AnimateOption_SetExpectedFrameRateRange](#oh_arkui_animateoption_setexpectedframeraterange) ([ArkUI_AnimateOption](#arkui_animateoption) \*option, [ArkUI_ExpectedFrameRateRange](_ark_u_i___expected_frame_rate_range.md) \*value) | Defines the expected frame rate range of the animation. |
339| void [OH_ArkUI_AnimateOption_SetICurve](#oh_arkui_animateoption_seticurve) ([ArkUI_AnimateOption](#arkui_animateoption) \*option, [ArkUI_CurveHandle](#arkui_curvehandle) value) | Sets the animation curve for an animation. |
340| [ArkUI_CurveHandle](#arkui_curvehandle) [OH_ArkUI_AnimateOption_GetICurve](#oh_arkui_animateoption_geticurve) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Obtains the animation curve of an animation. |
341| [ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) \* [OH_ArkUI_KeyframeAnimateOption_Create](#oh_arkui_keyframeanimateoption_create) (int32_t size) | Obtains the keyframe animation parameters. |
342| void [OH_ArkUI_KeyframeAnimateOption_Dispose](#oh_arkui_keyframeanimateoption_dispose) ([ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) \*option) | Destroys a keyframe animation parameter object. |
343| int32_t [OH_ArkUI_KeyframeAnimateOption_SetDelay](#oh_arkui_keyframeanimateoption_setdelay) ([ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) \*option, int32_t value) | Sets the overall delay of a keyframe animation, in milliseconds. By default, the keyframe animation is played without delay. |
344| int32_t [OH_ArkUI_KeyframeAnimateOption_SetIterations](#oh_arkui_keyframeanimateoption_setiterations) ([ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) \*option, int32_t value) | Sets the number of times that the keyframe animation is played. By default, the animation is played once. The value **-1** indicates that the animation is played for an unlimited number of times. The value **0** indicates that there is no animation. |
345| int32_t [OH_ArkUI_KeyframeAnimateOption_RegisterOnFinishCallback](#oh_arkui_keyframeanimateoption_registeronfinishcallback) ([ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) \*option, void \*userData, void(\*onFinish)(void \*userData)) | Sets the callback invoked when the keyframe animation playback is complete. This API is called after the keyframe animation has played for the specified number of times. |
346| int32_t [OH_ArkUI_KeyframeAnimateOption_SetDuration](#oh_arkui_keyframeanimateoption_setduration) ([ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) \*option, int32_t value, int32_t index) | Sets the duration of a keyframe animation, in milliseconds. |
347| int32_t [OH_ArkUI_KeyframeAnimateOption_SetCurve](#oh_arkui_keyframeanimateoption_setcurve) ([ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) \*option, [ArkUI_CurveHandle](#arkui_curvehandle) value, int32_t index) | Sets the animation curve for a specific keyframe in a keyframe animation. |
348| int32_t [OH_ArkUI_KeyframeAnimateOption_RegisterOnEventCallback](#oh_arkui_keyframeanimateoption_registeroneventcallback) ([ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) \*option, void \*userData, void(\*event)(void \*userData), int32_t index) | Sets the closure function of the state at the time of the keyframe, that is, the state to be reached at the time of the keyframe. |
349| int32_t [OH_ArkUI_KeyframeAnimateOption_GetDelay](#oh_arkui_keyframeanimateoption_getdelay) ([ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) \*option) | Obtains the overall delay of a keyframe animation |
350| int32_t [OH_ArkUI_KeyframeAnimateOption_GetIterations](#oh_arkui_keyframeanimateoption_getiterations) ([ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) \*option) | Obtains the number of times that a keyframe animation is played. |
351| int32_t [OH_ArkUI_KeyframeAnimateOption_GetDuration](#oh_arkui_keyframeanimateoption_getduration) ([ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) \*option, int32_t index) | Obtains the duration of a specific state in a keyframe animation. |
352| [ArkUI_CurveHandle](#arkui_curvehandle) [OH_ArkUI_KeyframeAnimateOption_GetCurve](#oh_arkui_keyframeanimateoption_getcurve) ([ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) \*option, int32_t index) | Obtains the animation curve of a specific state in a keyframe animation. |
353| [ArkUI_AnimatorOption](#arkui_animatoroption) \* [OH_ArkUI_AnimatorOption_Create](#oh_arkui_animatoroption_create) (int32_t keyframeSize) | Creates an animator parameter object. |
354| void [OH_ArkUI_AnimatorOption_Dispose](#oh_arkui_animatoroption_dispose) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Destroys an animator parameter object. |
355| int32_t [OH_ArkUI_AnimatorOption_SetDuration](#oh_arkui_animatoroption_setduration) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, int32_t value) | Sets the duration of an animation, in milliseconds. |
356| int32_t [OH_ArkUI_AnimatorOption_SetDelay](#oh_arkui_animatoroption_setdelay) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, int32_t value) | Sets the delay of animation playback, in milliseconds. |
357| int32_t [OH_ArkUI_AnimatorOption_SetIterations](#oh_arkui_animatoroption_setiterations) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, int32_t value) | Number of times that the frame animation is played. The value **0** means not to play the animation, and **-1** means to play the animation for an unlimited number of times. |
358| int32_t [OH_ArkUI_AnimatorOption_SetFill](#oh_arkui_animatoroption_setfill) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, [ArkUI_AnimationFill](#arkui_animationfill) value) | Sets whether the animator animation is restored to the initial state after being executed. |
359| int32_t [OH_ArkUI_AnimatorOption_SetDirection](#oh_arkui_animatoroption_setdirection) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, [ArkUI_AnimationDirection](#arkui_animationdirection) value) | Sets the playback direction. |
360| int32_t [OH_ArkUI_AnimatorOption_SetCurve](#oh_arkui_animatoroption_setcurve) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, [ArkUI_CurveHandle](#arkui_curvehandle) value) | Sets the interpolation curve for the animation of an animator. |
361| int32_t [OH_ArkUI_AnimatorOption_SetBegin](#oh_arkui_animatoroption_setbegin) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, float value) | Sets the interpolation start point for the animation of an animator. |
362| int32_t [OH_ArkUI_AnimatorOption_SetEnd](#oh_arkui_animatoroption_setend) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, float value) | Sets the interpolation end point for the animation of an animator. |
363| int32_t [OH_ArkUI_AnimatorOption_SetExpectedFrameRateRange](#oh_arkui_animatoroption_setexpectedframeraterange) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, [ArkUI_ExpectedFrameRateRange](_ark_u_i___expected_frame_rate_range.md) \*value) | Sets the expected frame rate range of an animation. |
364| int32_t [OH_ArkUI_AnimatorOption_SetKeyframe](#oh_arkui_animatoroption_setkeyframe) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, float time, float value, int32_t index) | Sets the keyframe parameters of an animation. |
365| int32_t [OH_ArkUI_AnimatorOption_SetKeyframeCurve](#oh_arkui_animatoroption_setkeyframecurve) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, [ArkUI_CurveHandle](#arkui_curvehandle) value, int32_t index) | Sets the keyframe curve type for the animation of an animator. |
366| int32_t [OH_ArkUI_AnimatorOption_GetDuration](#oh_arkui_animatoroption_getduration) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Obtains the duration for playing an animation. |
367| int32_t [OH_ArkUI_AnimatorOption_GetDelay](#oh_arkui_animatoroption_getdelay) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Obtains the delay for playing an animation. |
368| int32_t [OH_ArkUI_AnimatorOption_GetIterations](#oh_arkui_animatoroption_getiterations) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Obtains the number of times that an animation is played. |
369| [ArkUI_AnimationFill](#arkui_animationfill) [OH_ArkUI_AnimatorOption_GetFill](#oh_arkui_animatoroption_getfill) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Obtains whether the animator animation is restored to the initial state after being executed. |
370| [ArkUI_AnimationDirection](#arkui_animationdirection) [OH_ArkUI_AnimatorOption_GetDirection](#oh_arkui_animatoroption_getdirection) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Obtains the playback direction of an animation. |
371| [ArkUI_CurveHandle](#arkui_curvehandle) [OH_ArkUI_AnimatorOption_GetCurve](#oh_arkui_animatoroption_getcurve) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Obtains the interpolation curve of the animation of an animator. |
372| float [OH_ArkUI_AnimatorOption_GetBegin](#oh_arkui_animatoroption_getbegin) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Obtains the interpolation start point of an animation. |
373| float [OH_ArkUI_AnimatorOption_GetEnd](#oh_arkui_animatoroption_getend) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Obtains the interpolation end point of an animation. |
374| [ArkUI_ExpectedFrameRateRange](_ark_u_i___expected_frame_rate_range.md) \* [OH_ArkUI_AnimatorOption_GetExpectedFrameRateRange](#oh_arkui_animatoroption_getexpectedframeraterange) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Obtains the expected frame rate range of an animation. |
375| float [OH_ArkUI_AnimatorOption_GetKeyframeTime](#oh_arkui_animatoroption_getkeyframetime) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, int32_t index) | Obtains the keyframe time of an animation. |
376| float [OH_ArkUI_AnimatorOption_GetKeyframeValue](#oh_arkui_animatoroption_getkeyframevalue) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, int32_t index) | Obtains the keyframe value of an animation. |
377| [ArkUI_CurveHandle](#arkui_curvehandle) [OH_ArkUI_AnimatorOption_GetKeyframeCurve](#oh_arkui_animatoroption_getkeyframecurve) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, int32_t index) | Obtains the interpolation curve for a keyframe in the animation of an animator. |
378| void \* [OH_ArkUI_AnimatorEvent_GetUserData](#oh_arkui_animatorevent_getuserdata) (ArkUI_AnimatorEvent \*event) | Obtains the custom object in an animation event object. |
379| void \* [OH_ArkUI_AnimatorOnFrameEvent_GetUserData](#oh_arkui_animatoronframeevent_getuserdata) (ArkUI_AnimatorOnFrameEvent \*event) | Obtains the custom object in an animation event object. |
380| float [OH_ArkUI_AnimatorOnFrameEvent_GetValue](#oh_arkui_animatoronframeevent_getvalue) (ArkUI_AnimatorOnFrameEvent \*event) | Obtains the current progress in an animation event object. |
381| int32_t [OH_ArkUI_AnimatorOption_RegisterOnFrameCallback](#oh_arkui_animatoroption_registeronframecallback) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, void \*userData, void(\*callback)(ArkUI_AnimatorOnFrameEvent \*event)) | Sets the callback invoked when the animator receives a frame. |
382| int32_t [OH_ArkUI_AnimatorOption_RegisterOnFinishCallback](#oh_arkui_animatoroption_registeronfinishcallback) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, void \*userData, void(\*callback)(ArkUI_AnimatorEvent \*event)) | Sets the callback invoked when the animation playback is complete. |
383| int32_t [OH_ArkUI_AnimatorOption_RegisterOnCancelCallback](#oh_arkui_animatoroption_registeroncancelcallback) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, void \*userData, void(\*callback)(ArkUI_AnimatorEvent \*event)) | Sets the callback invoked when the animation playback is canceled. |
384| int32_t [OH_ArkUI_AnimatorOption_RegisterOnRepeatCallback](#oh_arkui_animatoroption_registeronrepeatcallback) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, void \*userData, void(\*callback)(ArkUI_AnimatorEvent \*event)) | Sets the callback invoked when the animation playback is repeated. |
385| int32_t [OH_ArkUI_Animator_ResetAnimatorOption](#oh_arkui_animator_resetanimatoroption) ([ArkUI_AnimatorHandle](#arkui_animatorhandle) animator, [ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Resets an animator configuration. |
386| int32_t [OH_ArkUI_Animator_Play](#oh_arkui_animator_play) ([ArkUI_AnimatorHandle](#arkui_animatorhandle) animator) | Starts the animation of an animator. |
387| int32_t [OH_ArkUI_Animator_Finish](#oh_arkui_animator_finish) ([ArkUI_AnimatorHandle](#arkui_animatorhandle) animator) | Ends the animation of an animator. |
388| int32_t [OH_ArkUI_Animator_Pause](#oh_arkui_animator_pause) ([ArkUI_AnimatorHandle](#arkui_animatorhandle) animator) | Pauses the animation of an animator. |
389| int32_t [OH_ArkUI_Animator_Cancel](#oh_arkui_animator_cancel) ([ArkUI_AnimatorHandle](#arkui_animatorhandle) animator) | Cancels the animation of an animator. |
390| int32_t [OH_ArkUI_Animator_Reverse](#oh_arkui_animator_reverse) ([ArkUI_AnimatorHandle](#arkui_animatorhandle) animator) | Plays this animation in reverse order. |
391| [ArkUI_CurveHandle](#arkui_curvehandle) [OH_ArkUI_Curve_CreateCurveByType](#oh_arkui_curve_createcurvebytype) ([ArkUI_AnimationCurve](#arkui_animationcurve) curve) | Implements initialization for the interpolation curve, which is used to create an interpolation curve based on the input parameter. |
392| [ArkUI_CurveHandle](#arkui_curvehandle) [OH_ArkUI_Curve_CreateStepsCurve](#oh_arkui_curve_createstepscurve) (int32_t count, bool end) | Creates a step curve. |
393| [ArkUI_CurveHandle](#arkui_curvehandle) [OH_ArkUI_Curve_CreateCubicBezierCurve](#oh_arkui_curve_createcubicbeziercurve) (float x1, float y1, float x2, float y2) | Creates a cubic Bezier curve. |
394| [ArkUI_CurveHandle](#arkui_curvehandle) [OH_ArkUI_Curve_CreateSpringCurve](#oh_arkui_curve_createspringcurve) (float velocity, float mass, float stiffness, float damping) | Creates a spring curve. The curve shape is subject to the spring parameters, and the animation duration is subject to the **duration** parameter in **animation** and **animateTo**. |
395| [ArkUI_CurveHandle](#arkui_curvehandle) [OH_ArkUI_Curve_CreateSpringMotion](#oh_arkui_curve_createspringmotion) (float response, float dampingFraction, float overlapDuration) | Creates a spring animation curve. If multiple spring animations are applied to the same attribute of an object, each animation replaces their predecessor and inherits the velocity. |
396| [ArkUI_CurveHandle](#arkui_curvehandle) [OH_ArkUI_Curve_CreateResponsiveSpringMotion](#oh_arkui_curve_createresponsivespringmotion) (float response, float dampingFraction, float overlapDuration) | Creates a responsive spring animation curve. It is a special case of **springMotion**, with the only difference in the default values. It can be used together with **springMotion**. |
397| [ArkUI_CurveHandle](#arkui_curvehandle) [OH_ArkUI_Curve_CreateInterpolatingSpring](#oh_arkui_curve_createinterpolatingspring) (float velocity, float mass, float stiffness, float damping) | Creates an interpolating spring curve animated from 0 to 1. The actual animation value is calculated based on the curve. |
398| [ArkUI_CurveHandle](#arkui_curvehandle) [OH_ArkUI_Curve_CreateCustomCurve](#oh_arkui_curve_createcustomcurve) (void \*userData, float(\*interpolate)(float fraction, void \*userdata)) | Creates a custom curve. |
399| void [OH_ArkUI_Curve_DisposeCurve](#oh_arkui_curve_disposecurve) ([ArkUI_CurveHandle](#arkui_curvehandle) curveHandle) | Disposes of a custom curve. |
400| [ArkUI_TransitionEffect](#arkui_transitioneffect) \* [OH_ArkUI_CreateOpacityTransitionEffect](#oh_arkui_createopacitytransitioneffect) (float opacity) | Creates an opacity object for component transition. |
401| [ArkUI_TransitionEffect](#arkui_transitioneffect) \* [OH_ArkUI_CreateTranslationTransitionEffect](#oh_arkui_createtranslationtransitioneffect) ([ArkUI_TranslationOptions](_ark_u_i___translation_options.md) \*translate) | Creates a translation object for component transition. |
402| [ArkUI_TransitionEffect](#arkui_transitioneffect) \* [OH_ArkUI_CreateScaleTransitionEffect](#oh_arkui_createscaletransitioneffect) ([ArkUI_ScaleOptions](_ark_u_i___scale_options.md) \*scale) | Creates a scaling object for component transition. |
403| [ArkUI_TransitionEffect](#arkui_transitioneffect) \* [OH_ArkUI_CreateRotationTransitionEffect](#oh_arkui_createrotationtransitioneffect) ([ArkUI_RotationOptions](_ark_u_i___rotation_options.md) \*rotate) | Creates a rotation object for component transition. |
404| [ArkUI_TransitionEffect](#arkui_transitioneffect) \* [OH_ArkUI_CreateMovementTransitionEffect](#oh_arkui_createmovementtransitioneffect) ([ArkUI_TransitionEdge](#arkui_transitionedge) move) | Creates a movement object for component transition. |
405| [ArkUI_TransitionEffect](#arkui_transitioneffect) \* [OH_ArkUI_CreateAsymmetricTransitionEffect](#oh_arkui_createasymmetrictransitioneffect) ([ArkUI_TransitionEffect](#arkui_transitioneffect) \*appear, [ArkUI_TransitionEffect](#arkui_transitioneffect) \*disappear) | Creates an asymmetric transition effect. |
406| void [OH_ArkUI_TransitionEffect_Dispose](#oh_arkui_transitioneffect_dispose) ([ArkUI_TransitionEffect](#arkui_transitioneffect) \*option) | Disposes of a transition effect. |
407| int32_t [OH_ArkUI_TransitionEffect_Combine](#oh_arkui_transitioneffect_combine) ([ArkUI_TransitionEffect](#arkui_transitioneffect) \*option, [ArkUI_TransitionEffect](#arkui_transitioneffect) \*combine) | Sets a combination of transition effects. |
408| int32_t [OH_ArkUI_TransitionEffect_SetAnimation](#oh_arkui_transitioneffect_setanimation) ([ArkUI_TransitionEffect](#arkui_transitioneffect) \*option, [ArkUI_AnimateOption](#arkui_animateoption) \*animation) | Sets transition effect animation settings. |
409| void [OH_ArkUI_DialogDismissEvent_SetShouldBlockDismiss](#oh_arkui_dialogdismissevent_setshouldblockdismiss) ([ArkUI_DialogDismissEvent](#arkui_dialogdismissevent) \*event, bool shouldBlockDismiss) | Sets whether to block the system behavior of dismissing a dialog box. |
410| void \* [OH_ArkUI_DialogDismissEvent_GetUserData](#oh_arkui_dialogdismissevent_getuserdata) ([ArkUI_DialogDismissEvent](#arkui_dialogdismissevent) \*event) | Obtains the pointer to user data in a dialog box dismiss event object. |
411| int32_t [OH_ArkUI_DialogDismissEvent_GetDismissReason](#oh_arkui_dialogdismissevent_getdismissreason) ([ArkUI_DialogDismissEvent](#arkui_dialogdismissevent) \*event) | Obtains the dismissal reason from a dialog box dismiss event object. |
412| bool [OH_ArkUI_GestureInterruptInfo_GetSystemFlag](#oh_arkui_gestureinterruptinfo_getsystemflag) (const ArkUI_GestureInterruptInfo \*event) | Checks whether a gesture is a built-in gesture of the component. |
413| ArkUI_GestureRecognizer \* [OH_ArkUI_GestureInterruptInfo_GetRecognizer](#oh_arkui_gestureinterruptinfo_getrecognizer) (const ArkUI_GestureInterruptInfo \*event) | Obtains the pointer to interrupted gesture recognizer. |
414| ArkUI_GestureEvent \* [OH_ArkUI_GestureInterruptInfo_GetGestureEvent](#oh_arkui_gestureinterruptinfo_getgestureevent) (const ArkUI_GestureInterruptInfo \*event) | Obtains the pointer to the interrupted gesture event. |
415| int32_t [OH_ArkUI_GestureInterruptInfo_GetSystemRecognizerType](#oh_arkui_gestureinterruptinfo_getsystemrecognizertype) (const ArkUI_GestureInterruptInfo \*event) | Obtains the type of the system gesture to trigger. |
416| [ArkUI_GestureEventActionType](#arkui_gestureeventactiontype) [OH_ArkUI_GestureEvent_GetActionType](#oh_arkui_gestureevent_getactiontype) (const ArkUI_GestureEvent \*event) | Obtains the gesture event type. |
417| [ArkUI_NodeHandle](#arkui_nodehandle) [OH_ArkUI_GestureEvent_GetResponseNode](#oh_arkui_gestureevent_getresponsenode) (ArkUI_GestureEvent \*event) | Obtains the node that responds to the gesture. |
418| const [ArkUI_UIInputEvent](_ark_u_i___event_module.md#arkui_uiinputevent) \* [OH_ArkUI_GestureEvent_GetRawInputEvent](#oh_arkui_gestureevent_getrawinputevent) (const ArkUI_GestureEvent \*event) | Obtains gesture input. |
419| int32_t [OH_ArkUI_LongPress_GetRepeatCount](#oh_arkui_longpress_getrepeatcount) (const ArkUI_GestureEvent \*event) | Obtains the number of times that a long press gesture is triggered periodically. |
420| float [OH_ArkUI_PanGesture_GetVelocity](#oh_arkui_pangesture_getvelocity) (const ArkUI_GestureEvent \*event) | Obtains the velocity of a pan gesture along the main axis. |
421| float [OH_ArkUI_PanGesture_GetVelocityX](#oh_arkui_pangesture_getvelocityx) (const ArkUI_GestureEvent \*event) | Obtains the velocity of a pan gesture along the x-axis. |
422| float [OH_ArkUI_PanGesture_GetVelocityY](#oh_arkui_pangesture_getvelocityy) (const ArkUI_GestureEvent \*event) | Obtains the velocity of a pan gesture along the y-axis. |
423| float [OH_ArkUI_PanGesture_GetOffsetX](#oh_arkui_pangesture_getoffsetx) (const ArkUI_GestureEvent \*event) | Obtains the relative offset of a pan gesture along the x-axis. |
424| float [OH_ArkUI_PanGesture_GetOffsetY](#oh_arkui_pangesture_getoffsety) (const ArkUI_GestureEvent \*event) | Obtains the relative offset of a pan gesture along the y-axis. |
425| float [OH_ArkUI_SwipeGesture_GetAngle](#oh_arkui_swipegesture_getangle) (const ArkUI_GestureEvent \*event) | Obtains the angle information of the swipe gesture. |
426| float [OH_ArkUI_SwipeGesture_GetVelocity](#oh_arkui_swipegesture_getvelocity) (const ArkUI_GestureEvent \*event) | Obtains the average velocity of all fingers used in the swipe gesture. |
427| float [OH_ArkUI_RotationGesture_GetAngle](#oh_arkui_rotationgesture_getangle) (const ArkUI_GestureEvent \*event) | Obtains the angle information of a rotation gesture. |
428| float [OH_ArkUI_PinchGesture_GetScale](#oh_arkui_pinchgesture_getscale) (const ArkUI_GestureEvent \*event) | Obtains the scale ratio of a pinch gesture. |
429| float [OH_ArkUI_PinchGesture_GetCenterX](#oh_arkui_pinchgesture_getcenterx) (const ArkUI_GestureEvent \*event) | Obtains the X coordinate of the center of the pinch gesture, in vp, relative to the upper left corner of the current component. |
430| float [OH_ArkUI_PinchGesture_GetCenterY](#oh_arkui_pinchgesture_getcentery) (const ArkUI_GestureEvent \*event) | Obtains the Y coordinate of the center of the pinch gesture, in vp, relative to the upper left corner of the current component. |
431| [ArkUI_NodeHandle](#arkui_nodehandle) [OH_ArkUI_GestureEvent_GetNode](#oh_arkui_gestureevent_getnode) (const ArkUI_GestureEvent \*event) | Obtains the ArkUI component to which the gesture is bound. |
432| int32_t [OH_ArkUI_GetResponseRecognizersFromInterruptInfo](#oh_arkui_getresponserecognizersfrominterruptinfo) (const ArkUI_GestureInterruptInfo \*event, [ArkUI_GestureRecognizerHandleArray](#arkui_gesturerecognizerhandlearray) \*responseChain, int32_t \*count) | Obtains information about a gesture response chain. |
433| int32_t [OH_ArkUI_SetGestureRecognizerEnabled](#oh_arkui_setgesturerecognizerenabled) (ArkUI_GestureRecognizer \*recognizer, bool enabled) | Sets the enabled state of a gesture recognizer. |
434| bool [OH_ArkUI_GetGestureRecognizerEnabled](#oh_arkui_getgesturerecognizerenabled) (ArkUI_GestureRecognizer \*recognizer) | Obtains the enabled state of a gesture recognizer. |
435| int32_t [OH_ArkUI_GetGestureRecognizerState](#oh_arkui_getgesturerecognizerstate) (ArkUI_GestureRecognizer \*recognizer, [ArkUI_GestureRecognizerState](#arkui_gesturerecognizerstate) \*state) | Obtains the state of a gesture recognizer. |
436| int32_t [OH_ArkUI_GetGestureEventTargetInfo](#oh_arkui_getgestureeventtargetinfo) (ArkUI_GestureRecognizer \*recognizer, [ArkUI_GestureEventTargetInfo](#arkui_gestureeventtargetinfo) \*\*info) | Obtains the information about a gesture event target. |
437| int32_t [OH_ArkUI_GestureEventTargetInfo_IsScrollBegin](#oh_arkui_gestureeventtargetinfo_isscrollbegin) ([ArkUI_GestureEventTargetInfo](#arkui_gestureeventtargetinfo) \*info, bool \*ret) | Obtains whether this scroll container is scrolled to the top. |
438| int32_t [OH_ArkUI_GestureEventTargetInfo_IsScrollEnd](#oh_arkui_gestureeventtargetinfo_isscrollend) ([ArkUI_GestureEventTargetInfo](#arkui_gestureeventtargetinfo) \*info, bool \*ret) | Obtains whether this scroll container is scrolled to the bottom. |
439| int32_t [OH_ArkUI_GetPanGestureDirectionMask](#oh_arkui_getpangesturedirectionmask) (ArkUI_GestureRecognizer \*recognizer, [ArkUI_GestureDirectionMask](#arkui_gesturedirectionmask) \*directionMask) | Obtains the direction of a pan gesture. |
440| bool [OH_ArkUI_IsBuiltInGesture](#oh_arkui_isbuiltingesture) (ArkUI_GestureRecognizer \*recognizer) | Obtains whether a gesture is a built-in gesture. |
441| int32_t [OH_ArkUI_GetGestureTag](#oh_arkui_getgesturetag) (ArkUI_GestureRecognizer \*recognizer, char \*buffer, int32_t bufferSize, int32_t \*result) | Obtains the tag of a gesture recognizer. |
442| int32_t [OH_ArkUI_GetGestureBindNodeId](#oh_arkui_getgesturebindnodeid) (ArkUI_GestureRecognizer \*recognizer, char \*nodeId, int32_t size, int32_t \*result) | Obtains the ID of the component linked to a gesture recognizer. |
443| bool [OH_ArkUI_IsGestureRecognizerValid](#oh_arkui_isgesturerecognizervalid) (ArkUI_GestureRecognizer \*recognizer) | Obtains whether a gesture recognizer is valid. |
444| void \* [OH_ArkUI_ParallelInnerGestureEvent_GetUserData](#oh_arkui_parallelinnergestureevent_getuserdata) ([ArkUI_ParallelInnerGestureEvent](#arkui_parallelinnergestureevent) \*event) | Obtains custom data in the parallel internal gesture event. |
445| ArkUI_GestureRecognizer \* [OH_ArkUI_ParallelInnerGestureEvent_GetCurrentRecognizer](#oh_arkui_parallelinnergestureevent_getcurrentrecognizer) ([ArkUI_ParallelInnerGestureEvent](#arkui_parallelinnergestureevent) \*event) | Obtains the current gesture recognizer in a parallel internal gesture event. |
446| int32_t [OH_ArkUI_ParallelInnerGestureEvent_GetConflictRecognizers](#oh_arkui_parallelinnergestureevent_getconflictrecognizers) ([ArkUI_ParallelInnerGestureEvent](#arkui_parallelinnergestureevent) \*event, [ArkUI_GestureRecognizerHandleArray](#arkui_gesturerecognizerhandlearray) \*array, int32_t \*size) | Obtains the conflicting gesture recognizers in a parallel internal gesture event. |
447| int32_t [OH_ArkUI_SetArkUIGestureRecognizerDisposeNotify](#oh_arkui_setarkuigesturerecognizerdisposenotify) (ArkUI_GestureRecognizer \*recognizer, [ArkUI_GestureRecognizerDestructNotifyCallback](#arkui_gesturerecognizerdestructnotifycallback) callback, void \*userData) | Sets a callback function for notifying gesture recognizer destruction. |
448| void \* [OH_ArkUI_QueryModuleInterfaceByName](#oh_arkui_querymoduleinterfacebyname) ([ArkUI_NativeAPIVariantKind](#arkui_nativeapivariantkind) type, const char \*structName) | Obtains the native API set of a specified type. |
449| [ArkUI_NodeEventType](#arkui_nodeeventtype) [OH_ArkUI_NodeEvent_GetEventType](#oh_arkui_nodeevent_geteventtype) ([ArkUI_NodeEvent](#arkui_nodeevent-12) \*event) | Obtains the type of a component event. |
450| int32_t [OH_ArkUI_NodeEvent_GetTargetId](#oh_arkui_nodeevent_gettargetid) ([ArkUI_NodeEvent](#arkui_nodeevent-12) \*event) | Obtains the custom ID of a component event. |
451| [ArkUI_NodeHandle](#arkui_nodehandle) [OH_ArkUI_NodeEvent_GetNodeHandle](#oh_arkui_nodeevent_getnodehandle) ([ArkUI_NodeEvent](#arkui_nodeevent-12) \*event) | Obtains the component object that triggers an event. |
452| [ArkUI_UIInputEvent](_ark_u_i___event_module.md#arkui_uiinputevent) \* [OH_ArkUI_NodeEvent_GetInputEvent](#oh_arkui_nodeevent_getinputevent) ([ArkUI_NodeEvent](#arkui_nodeevent-12) \*event) | Obtains input event (for example, touch event) data for a component event. |
453| [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) \* [OH_ArkUI_NodeEvent_GetNodeComponentEvent](#oh_arkui_nodeevent_getnodecomponentevent) ([ArkUI_NodeEvent](#arkui_nodeevent-12) \*event) | Obtains the numerical data in a component event. |
454| [ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md) \* [OH_ArkUI_NodeEvent_GetStringAsyncEvent](#oh_arkui_nodeevent_getstringasyncevent) ([ArkUI_NodeEvent](#arkui_nodeevent-12) \*event) | Obtains the string data in a component event. |
455| void \* [OH_ArkUI_NodeEvent_GetUserData](#oh_arkui_nodeevent_getuserdata) ([ArkUI_NodeEvent](#arkui_nodeevent-12) \*event) | Obtains the custom data in a component event. |
456| int32_t [OH_ArkUI_NodeEvent_GetNumberValue](#oh_arkui_nodeevent_getnumbervalue) ([ArkUI_NodeEvent](#arkui_nodeevent-12) \*event, int32_t index, [ArkUI_NumberValue](union_ark_u_i___number_value.md) \*value) | Obtains the numeric-type parameter of a component event. |
457| int32_t [OH_ArkUI_NodeEvent_GetStringValue](#oh_arkui_nodeevent_getstringvalue) ([ArkUI_NodeEvent](#arkui_nodeevent-12) \*event, int32_t index, char \*\*string, int32_t \*stringSize) | Obtains the string-type parameter of a component event. The string data is valid only during an event callback. To use it outside an event callback, you are advised to copy the string data. |
458| int32_t [OH_ArkUI_NodeEvent_SetReturnNumberValue](#oh_arkui_nodeevent_setreturnnumbervalue) ([ArkUI_NodeEvent](#arkui_nodeevent-12) \*event, [ArkUI_NumberValue](union_ark_u_i___number_value.md) \*value, int32_t size) | Sets the return value for a component event. |
459| [ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) [OH_ArkUI_NodeAdapter_Create](#oh_arkui_nodeadapter_create) () | Creates a component adapter. |
460| void [OH_ArkUI_NodeAdapter_Dispose](#oh_arkui_nodeadapter_dispose) ([ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) handle) | Destroys a component adapter. |
461| int32_t [OH_ArkUI_NodeAdapter_SetTotalNodeCount](#oh_arkui_nodeadapter_settotalnodecount) ([ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) handle, uint32_t size) | Sets the total number of elements in the specified adapter. |
462| uint32_t [OH_ArkUI_NodeAdapter_GetTotalNodeCount](#oh_arkui_nodeadapter_gettotalnodecount) ([ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) handle) | Obtains the total number of elements in the specified adapter. |
463| int32_t [OH_ArkUI_NodeAdapter_RegisterEventReceiver](#oh_arkui_nodeadapter_registereventreceiver) ([ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) handle, void \*userData, void(\*receiver)([ArkUI_NodeAdapterEvent](#arkui_nodeadapterevent) \*event)) | Registers an event callback for the specified adapter. |
464| void [OH_ArkUI_NodeAdapter_UnregisterEventReceiver](#oh_arkui_nodeadapter_unregistereventreceiver) ([ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) handle) | Unregisters an event callback for the specified adapter. |
465| int32_t [OH_ArkUI_NodeAdapter_ReloadAllItems](#oh_arkui_nodeadapter_reloadallitems) ([ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) handle) | Instructs the specified adapter to reload all elements. |
466| int32_t [OH_ArkUI_NodeAdapter_ReloadItem](#oh_arkui_nodeadapter_reloaditem) ([ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) handle, uint32_t startPosition, uint32_t itemCount) | Instructs the specified adapter to reload certain elements. |
467| int32_t [OH_ArkUI_NodeAdapter_RemoveItem](#oh_arkui_nodeadapter_removeitem) ([ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) handle, uint32_t startPosition, uint32_t itemCount) | Instructs the specified adapter to remove certain elements. |
468| int32_t [OH_ArkUI_NodeAdapter_InsertItem](#oh_arkui_nodeadapter_insertitem) ([ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) handle, uint32_t startPosition, uint32_t itemCount) | Instructs the specified adapter to insert certain elements. |
469| int32_t [OH_ArkUI_NodeAdapter_MoveItem](#oh_arkui_nodeadapter_moveitem) ([ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) handle, uint32_t from, uint32_t to) | Instructs the specified adapter to move certain elements. |
470| int32_t [OH_ArkUI_NodeAdapter_GetAllItems](#oh_arkui_nodeadapter_getallitems) ([ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) handle, [ArkUI_NodeHandle](#arkui_nodehandle) \*\*items, uint32_t \*size) | Obtains all elements stored in the specified adapter. |
471| void \* [OH_ArkUI_NodeAdapterEvent_GetUserData](#oh_arkui_nodeadapterevent_getuserdata) ([ArkUI_NodeAdapterEvent](#arkui_nodeadapterevent) \*event) | Obtains the custom data passed in during registration of the specified event. |
472| [ArkUI_NodeAdapterEventType](#arkui_nodeadaptereventtype) [OH_ArkUI_NodeAdapterEvent_GetType](#oh_arkui_nodeadapterevent_gettype) ([ArkUI_NodeAdapterEvent](#arkui_nodeadapterevent) \*event) | Obtains the event type. |
473| [ArkUI_NodeHandle](#arkui_nodehandle) [OH_ArkUI_NodeAdapterEvent_GetRemovedNode](#oh_arkui_nodeadapterevent_getremovednode) ([ArkUI_NodeAdapterEvent](#arkui_nodeadapterevent) \*event) | Obtains the element to be removed for the event to be destroyed. |
474| uint32_t [OH_ArkUI_NodeAdapterEvent_GetItemIndex](#oh_arkui_nodeadapterevent_getitemindex) ([ArkUI_NodeAdapterEvent](#arkui_nodeadapterevent) \*event) | Obtains the index of the element to be operated for the specified adapter event. |
475| [ArkUI_NodeHandle](#arkui_nodehandle) [OH_ArkUI_NodeAdapterEvent_GetHostNode](#oh_arkui_nodeadapterevent_gethostnode) ([ArkUI_NodeAdapterEvent](#arkui_nodeadapterevent) \*event) | Obtains the scrollable container node that uses the specified adapter. |
476| int32_t [OH_ArkUI_NodeAdapterEvent_SetItem](#oh_arkui_nodeadapterevent_setitem) ([ArkUI_NodeAdapterEvent](#arkui_nodeadapterevent) \*event, [ArkUI_NodeHandle](#arkui_nodehandle) node) | Sets the component to be added to the specified adapter. |
477| int32_t [OH_ArkUI_NodeAdapterEvent_SetNodeId](#oh_arkui_nodeadapterevent_setnodeid) ([ArkUI_NodeAdapterEvent](#arkui_nodeadapterevent) \*event, int32_t id) | Sets the component ID to be generated. |
478| [ArkUI_LayoutConstraint](#arkui_layoutconstraint) \* [OH_ArkUI_NodeCustomEvent_GetLayoutConstraintInMeasure](#oh_arkui_nodecustomevent_getlayoutconstraintinmeasure) ([ArkUI_NodeCustomEvent](#arkui_nodecustomevent) \*event) | Obtains the size constraint for measurement through a custom component event. |
479| [ArkUI_IntOffset](_ark_u_i___int_offset.md) [OH_ArkUI_NodeCustomEvent_GetPositionInLayout](#oh_arkui_nodecustomevent_getpositioninlayout) ([ArkUI_NodeCustomEvent](#arkui_nodecustomevent) \*event) | Obtains the expected position of a component relative to its parent component in the layout phase through a custom component event. |
480| [ArkUI_DrawContext](#arkui_drawcontext) \* [OH_ArkUI_NodeCustomEvent_GetDrawContextInDraw](#oh_arkui_nodecustomevent_getdrawcontextindraw) ([ArkUI_NodeCustomEvent](#arkui_nodecustomevent) \*event) | Obtains the drawing context through a custom component event. |
481| int32_t [OH_ArkUI_NodeCustomEvent_GetEventTargetId](#oh_arkui_nodecustomevent_geteventtargetid) ([ArkUI_NodeCustomEvent](#arkui_nodecustomevent) \*event) | Obtains the ID of a custom component event. |
482| void \* [OH_ArkUI_NodeCustomEvent_GetUserData](#oh_arkui_nodecustomevent_getuserdata) ([ArkUI_NodeCustomEvent](#arkui_nodecustomevent) \*event) | Obtains custom event parameters through a custom component event. |
483| [ArkUI_NodeHandle](#arkui_nodehandle) [OH_ArkUI_NodeCustomEvent_GetNodeHandle](#oh_arkui_nodecustomevent_getnodehandle) ([ArkUI_NodeCustomEvent](#arkui_nodecustomevent) \*event) | Obtains a component object through a custom component event. |
484| [ArkUI_NodeCustomEventType](#arkui_nodecustomeventtype) [OH_ArkUI_NodeCustomEvent_GetEventType](#oh_arkui_nodecustomevent_geteventtype) ([ArkUI_NodeCustomEvent](#arkui_nodecustomevent) \*event) | Obtains the event type through a custom component event. |
485| int32_t [OH_ArkUI_NodeCustomEvent_GetCustomSpanMeasureInfo](#oh_arkui_nodecustomevent_getcustomspanmeasureinfo) ([ArkUI_NodeCustomEvent](#arkui_nodecustomevent) \*event, [ArkUI_CustomSpanMeasureInfo](#arkui_customspanmeasureinfo) \*info) | Obtains the measurement information of a custom span through a custom component event. |
486| int32_t [OH_ArkUI_NodeCustomEvent_SetCustomSpanMetrics](#oh_arkui_nodecustomevent_setcustomspanmetrics) ([ArkUI_NodeCustomEvent](#arkui_nodecustomevent) \*event, [ArkUI_CustomSpanMetrics](#arkui_customspanmetrics) \*metrics) | Sets the measurement metrics of a custom span through a custom component event. |
487| int32_t [OH_ArkUI_NodeCustomEvent_GetCustomSpanDrawInfo](#oh_arkui_nodecustomevent_getcustomspandrawinfo) ([ArkUI_NodeCustomEvent](#arkui_nodecustomevent) \*event, [ArkUI_CustomSpanDrawInfo](#arkui_customspandrawinfo) \*info) | Obtains the drawing information of a custom span through a custom component event. |
488| int32_t [OH_ArkUI_NodeContent_RegisterCallback](#oh_arkui_nodecontent_registercallback) ([ArkUI_NodeContentHandle](#arkui_nodecontenthandle) content, [ArkUI_NodeContentCallback](#arkui_nodecontentcallback) callback) | Registers the callback for the NodeContent event. |
489| [ArkUI_NodeContentEventType](#arkui_nodecontenteventtype) [OH_ArkUI_NodeContentEvent_GetEventType](#oh_arkui_nodecontentevent_geteventtype) ([ArkUI_NodeContentEvent](#arkui_nodecontentevent) \*event) | Obtains the type of the specified NodeContent event. |
490| [ArkUI_NodeContentHandle](#arkui_nodecontenthandle) [OH_ArkUI_NodeContentEvent_GetNodeContentHandle](#oh_arkui_nodecontentevent_getnodecontenthandle) ([ArkUI_NodeContentEvent](#arkui_nodecontentevent) \*event) | Obtains the object that triggers the specified NodeContent event. |
491| int32_t [OH_ArkUI_NodeContent_SetUserData](#oh_arkui_nodecontent_setuserdata) ([ArkUI_NodeContentHandle](#arkui_nodecontenthandle) content, void \*userData) | Saves custom data to the specified NodeContent object. |
492| void \* [OH_ArkUI_NodeContent_GetUserData](#oh_arkui_nodecontent_getuserdata) ([ArkUI_NodeContentHandle](#arkui_nodecontenthandle) content) | Obtains the custom data saved on the specified NodeContent object. |
493| int32_t [OH_ArkUI_NodeContent_AddNode](#oh_arkui_nodecontent_addnode) ([ArkUI_NodeContentHandle](#arkui_nodecontenthandle) content, [ArkUI_NodeHandle](#arkui_nodehandle) node) | Adds an ArkUI component node to the specified NodeContent object. |
494| int32_t [OH_ArkUI_NodeContent_RemoveNode](#oh_arkui_nodecontent_removenode) ([ArkUI_NodeContentHandle](#arkui_nodecontenthandle) content, [ArkUI_NodeHandle](#arkui_nodehandle) node) | Removes an ArkUI component node from the specified NodeContent object. |
495| int32_t [OH_ArkUI_NodeContent_InsertNode](#oh_arkui_nodecontent_insertnode) ([ArkUI_NodeContentHandle](#arkui_nodecontenthandle) content, [ArkUI_NodeHandle](#arkui_nodehandle) node, int32_t position) | Inserts an ArkUI component node into a specific position of the specified NodeContent object. |
496| int32_t [OH_ArkUI_NodeUtils_GetLayoutSize](#oh_arkui_nodeutils_getlayoutsize) ([ArkUI_NodeHandle](#arkui_nodehandle) node, [ArkUI_IntSize](_ark_u_i___int_size.md) \*size) | Obtains the layout area size of a component. The size does not count in transformation attributes, such as scale. |
497| int32_t [OH_ArkUI_NodeUtils_GetLayoutPosition](#oh_arkui_nodeutils_getlayoutposition) ([ArkUI_NodeHandle](#arkui_nodehandle) node, [ArkUI_IntOffset](_ark_u_i___int_offset.md) \*localOffset) | Obtains the position of the component's layout area relative to its parent component. The relative position does not count in transformation attributes, such as translate. |
498| int32_t [OH_ArkUI_NodeUtils_GetLayoutPositionInWindow](#oh_arkui_nodeutils_getlayoutpositioninwindow) ([ArkUI_NodeHandle](#arkui_nodehandle) node, [ArkUI_IntOffset](_ark_u_i___int_offset.md) \*globalOffset) | Obtains the position of the component's layout area relative to the window. The relative position does not count in transformation attributes, such as translate. |
499| int32_t [OH_ArkUI_NodeUtils_GetLayoutPositionInScreen](#oh_arkui_nodeutils_getlayoutpositioninscreen) ([ArkUI_NodeHandle](#arkui_nodehandle) node, [ArkUI_IntOffset](_ark_u_i___int_offset.md) \*screenOffset) | Obtains the position of the component's layout area relative to the screen. The relative position does not count in transformation attributes, such as translate. |
500| int32_t [OH_ArkUI_NodeUtils_GetPositionWithTranslateInWindow](#oh_arkui_nodeutils_getpositionwithtranslateinwindow) ([ArkUI_NodeHandle](#arkui_nodehandle) node, [ArkUI_IntOffset](_ark_u_i___int_offset.md) \*translateOffset) | Obtains the position of the component in the window, including the translate attribute. |
501| int32_t [OH_ArkUI_NodeUtils_GetPositionWithTranslateInScreen](#oh_arkui_nodeutils_getpositionwithtranslateinscreen) ([ArkUI_NodeHandle](#arkui_nodehandle) node, [ArkUI_IntOffset](_ark_u_i___int_offset.md) \*translateOffset) | Obtains the position of the component on the screen, including the translate attribute. |
502| void [OH_ArkUI_NodeUtils_AddCustomProperty](#oh_arkui_nodeutils_addcustomproperty) ([ArkUI_NodeHandle](#arkui_nodehandle) node, const char \*name, const char \*value) | Sets a custom property for this component. This API takes effect only in the main thread. |
503| void [OH_ArkUI_NodeUtils_RemoveCustomProperty](#oh_arkui_nodeutils_removecustomproperty) ([ArkUI_NodeHandle](#arkui_nodehandle) node, const char \*name) | Removes a custom property that has been set for the specified component. |
504| int32_t [OH_ArkUI_List_CloseAllSwipeActions](#oh_arkui_list_closeallswipeactions) ([ArkUI_NodeHandle](#arkui_nodehandle) node, void \*userData, void(\*onFinish)(void \*userData)) | Collapses the list items in the expanded state. |
505| [ArkUI_ContextHandle](#arkui_contexthandle-12) [OH_ArkUI_GetContextByNode](#oh_arkui_getcontextbynode) ([ArkUI_NodeHandle](#arkui_nodehandle) node) | Obtains the pointer to the UI context object of the specified node. |
506| int32_t [OH_ArkUI_RegisterSystemColorModeChangeEvent](#oh_arkui_registersystemcolormodechangeevent) ([ArkUI_NodeHandle](#arkui_nodehandle) node, void \*userData, void(\*onColorModeChange)([ArkUI_SystemColorMode](#arkui_systemcolormode) colorMode, void \*userData)) | Registers an event listener for system color mode changes. A single component can only register one callback for system color mode changes. |
507| void [OH_ArkUI_UnregisterSystemColorModeChangeEvent](#oh_arkui_unregistersystemcolormodechangeevent) ([ArkUI_NodeHandle](#arkui_nodehandle) node) | Unregisters the event listener for system color mode changes. |
508| int32_t [OH_ArkUI_RegisterSystemFontStyleChangeEvent](#oh_arkui_registersystemfontstylechangeevent) ([ArkUI_NodeHandle](#arkui_nodehandle) node, void \*userData, void(\*onFontStyleChange)([ArkUI_SystemFontStyleEvent](#arkui_systemfontstyleevent) \*event, void \*userData)) | Registers an event listener for system font style changes. A single component can only register one callback for system font style changes. |
509| void [OH_ArkUI_UnregisterSystemFontStyleChangeEvent](#oh_arkui_unregistersystemfontstylechangeevent) ([ArkUI_NodeHandle](#arkui_nodehandle) node) | Unregisters the event listener for system font style changes. |
510| float [OH_ArkUI_SystemFontStyleEvent_GetFontSizeScale](#oh_arkui_systemfontstyleevent_getfontsizescale) (const [ArkUI_SystemFontStyleEvent](#arkui_systemfontstyleevent) \*event) | Obtains the font size from the system font style change event. |
511| float [OH_ArkUI_SystemFontStyleEvent_GetFontWeightScale](#oh_arkui_systemfontstyleevent_getfontweightscale) (const [ArkUI_SystemFontStyleEvent](#arkui_systemfontstyleevent) \*event) | Obtains the font weight from the system font style change event. |
512| int32_t [OH_ArkUI_GetNodeHandleFromNapiValue](#oh_arkui_getnodehandlefromnapivalue) (napi_env env, napi_value frameNode, [ArkUI_NodeHandle](#arkui_nodehandle) \*handle) | Obtains a **FrameNode** object on the ArkTS side and maps it to an **ArkUI_NodeHandle** object on the native side. |
513| int32_t [OH_ArkUI_GetContextFromNapiValue](#oh_arkui_getcontextfromnapivalue) (napi_env env, napi_value value, [ArkUI_ContextHandle](#arkui_contexthandle-12) \*context) | Obtains a **UIContext** object on the ArkTS side and maps it to an **ArkUI_ContextHandle** object on the native side. |
514| int32_t [OH_ArkUI_GetNodeContentFromNapiValue](#oh_arkui_getnodecontentfromnapivalue) (napi_env env, napi_value value, [ArkUI_NodeContentHandle](#arkui_nodecontenthandle) \*content) | Obtains a **NodeContent** object on the ArkTS side and maps it to an **ArkUI_NodeContentHandle** object on the native side. |
515| int32_t [OH_ArkUI_GetDrawableDescriptorFromNapiValue](#oh_arkui_getdrawabledescriptorfromnapivalue) (napi_env env, napi_value value, [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) \*\*drawableDescriptor) | Maps a **DrawableDescriptor** object on the ArkTS side to an **ArkUI_DrawableDescriptor** object on the native side. |
516| int32_t [OH_ArkUI_GetDrawableDescriptorFromResourceNapiValue](#oh_arkui_getdrawabledescriptorfromresourcenapivalue) (napi_env env, napi_value value, [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) \*\*drawableDescriptor) | Maps an $r resource object on the ArkTS side to an **ArkUI_DrawableDescriptor** object on the native side. |
517| [ArkUI_ErrorCode](#arkui_errorcode) [OH_ArkUI_GetNavigationId](#oh_arkui_getnavigationid) ([ArkUI_NodeHandle](#arkui_nodehandle) node, char \*buffer, int32_t bufferSize, int32_t \*writeLength) | Obtains the ID of the **Navigation** component where the specified node is located. |
518| [ArkUI_ErrorCode](#arkui_errorcode) [OH_ArkUI_GetNavDestinationName](#oh_arkui_getnavdestinationname) ([ArkUI_NodeHandle](#arkui_nodehandle) node, char \*buffer, int32_t bufferSize, int32_t \*writeLength) | Obtains the name of the **NavDestination** component where the specified node is located. |
519| [ArkUI_ErrorCode](#arkui_errorcode) [OH_ArkUI_GetNavStackLength](#oh_arkui_getnavstacklength) ([ArkUI_NodeHandle](#arkui_nodehandle) node, int32_t \*length) | Obtains the length of the navigation stack where the specified node is located. |
520| [ArkUI_ErrorCode](#arkui_errorcode) [OH_ArkUI_GetNavDestinationNameByIndex](#oh_arkui_getnavdestinationnamebyindex) ([ArkUI_NodeHandle](#arkui_nodehandle) node, int32_t index, char \*buffer, int32_t bufferSize, int32_t \*writeLength) | Obtains the page name that matches the specified index in the navigation stack where the specified node is located. The index starts from 0, which indicates the bottom of the stack. |
521| [ArkUI_ErrorCode](#arkui_errorcode) [OH_ArkUI_GetNavDestinationId](#oh_arkui_getnavdestinationid) ([ArkUI_NodeHandle](#arkui_nodehandle) node, char \*buffer, int32_t bufferSize, int32_t \*writeLength) | Obtains the ID of the **NavDestination** component where the specified node is located. |
522| [ArkUI_ErrorCode](#arkui_errorcode) [OH_ArkUI_GetNavDestinationState](#oh_arkui_getnavdestinationstate) ([ArkUI_NodeHandle](#arkui_nodehandle) node, [ArkUI_NavDestinationState](#arkui_navdestinationstate) \*state) | Obtains the state of the **NavDestination** component where the specified node is located. |
523| [ArkUI_ErrorCode](#arkui_errorcode) [OH_ArkUI_GetNavDestinationIndex](#oh_arkui_getnavdestinationindex) ([ArkUI_NodeHandle](#arkui_nodehandle) node, int32_t \*index) | Obtains the index of the **NavDestination** component where the specified node is located in the navigation stack. |
524| napi_value [OH_ArkUI_GetNavDestinationParam](#oh_arkui_getnavdestinationparam) ([ArkUI_NodeHandle](#arkui_nodehandle) node) | Obtains the parameters of the **NavDestination** component where the specified node is located. |
525| [ArkUI_ErrorCode](#arkui_errorcode) [OH_ArkUI_GetRouterPageIndex](#oh_arkui_getrouterpageindex) ([ArkUI_NodeHandle](#arkui_nodehandle) node, int32_t \*index) | Obtains the index of the page where the specified node is located in the page stack for routing. |
526| [ArkUI_ErrorCode](#arkui_errorcode) [OH_ArkUI_GetRouterPageName](#oh_arkui_getrouterpagename) ([ArkUI_NodeHandle](#arkui_nodehandle) node, char \*buffer, int32_t bufferSize, int32_t \*writeLength) | Obtains the name of the page where the specified node is located. |
527| [ArkUI_ErrorCode](#arkui_errorcode) [OH_ArkUI_GetRouterPagePath](#oh_arkui_getrouterpagepath) ([ArkUI_NodeHandle](#arkui_nodehandle) node, char \*buffer, int32_t bufferSize, int32_t \*writeLength) | Obtains the path to the page where the specified node is located. |
528| [ArkUI_ErrorCode](#arkui_errorcode) [OH_ArkUI_GetRouterPageState](#oh_arkui_getrouterpagestate) ([ArkUI_NodeHandle](#arkui_nodehandle) node, [ArkUI_RouterPageState](#arkui_routerpagestate) \*state) | Obtains the state of the page where the specified node is located. |
529| [ArkUI_ErrorCode](#arkui_errorcode) [OH_ArkUI_GetRouterPageId](#oh_arkui_getrouterpageid) ([ArkUI_NodeHandle](#arkui_nodehandle) node, char \*buffer, int32_t bufferSize, int32_t \*writeLength) | Obtains the ID of the page where the specified node is located. |
530| [ArkUI_LayoutConstraint](#arkui_layoutconstraint) \* [OH_ArkUI_LayoutConstraint_Create](#oh_arkui_layoutconstraint_create) () | Creates a size constraint. |
531| [ArkUI_LayoutConstraint](#arkui_layoutconstraint) \* [OH_ArkUI_LayoutConstraint_Copy](#oh_arkui_layoutconstraint_copy) (const [ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint) | Performs a deep copy of a size constraint. |
532| void \* [OH_ArkUI_LayoutConstraint_Dispose](#oh_arkui_layoutconstraint_dispose) ([ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint) | Disposes of the pointer to a size constraint. |
533| int32_t [OH_ArkUI_LayoutConstraint_GetMaxWidth](#oh_arkui_layoutconstraint_getmaxwidth) (const [ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint) | Obtains the maximum width for a size constraint, in px. |
534| int32_t [OH_ArkUI_LayoutConstraint_GetMinWidth](#oh_arkui_layoutconstraint_getminwidth) (const [ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint) | Obtains the minimum width for a size constraint, in px. |
535| int32_t [OH_ArkUI_LayoutConstraint_GetMaxHeight](#oh_arkui_layoutconstraint_getmaxheight) (const [ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint) | Obtains the maximum height for a size constraint, in px. |
536| int32_t [OH_ArkUI_LayoutConstraint_GetMinHeight](#oh_arkui_layoutconstraint_getminheight) (const [ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint) | Obtains the minimum height for a size constraint, in px. |
537| int32_t [OH_ArkUI_LayoutConstraint_GetPercentReferenceWidth](#oh_arkui_layoutconstraint_getpercentreferencewidth) (const [ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint) | Obtains the width percentage reference for a size constraint, in px. |
538| int32_t [OH_ArkUI_LayoutConstraint_GetPercentReferenceHeight](#oh_arkui_layoutconstraint_getpercentreferenceheight) (const [ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint) | Obtains the height percentage reference for a size constraint, in px. |
539| void [OH_ArkUI_LayoutConstraint_SetMaxWidth](#oh_arkui_layoutconstraint_setmaxwidth) ([ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint, int32_t value) | Sets the maximum width. |
540| void [OH_ArkUI_LayoutConstraint_SetMinWidth](#oh_arkui_layoutconstraint_setminwidth) ([ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint, int32_t value) | Sets the minimum width. |
541| void [OH_ArkUI_LayoutConstraint_SetMaxHeight](#oh_arkui_layoutconstraint_setmaxheight) ([ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint, int32_t value) | Sets the maximum height. |
542| void [OH_ArkUI_LayoutConstraint_SetMinHeight](#oh_arkui_layoutconstraint_setminheight) ([ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint, int32_t value) | Sets the minimum height. |
543| void [OH_ArkUI_LayoutConstraint_SetPercentReferenceWidth](#oh_arkui_layoutconstraint_setpercentreferencewidth) ([ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint, int32_t value) | Sets the width percentage reference. |
544| void [OH_ArkUI_LayoutConstraint_SetPercentReferenceHeight](#oh_arkui_layoutconstraint_setpercentreferenceheight) ([ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint, int32_t value) | Sets the height percentage reference. |
545| void \* [OH_ArkUI_DrawContext_GetCanvas](#oh_arkui_drawcontext_getcanvas) ([ArkUI_DrawContext](#arkui_drawcontext) \*context) | Obtains the pointer to a canvas for drawing, which can be converted into the **OH_Drawing_Canvas** in the **Drawing** module. |
546| [ArkUI_IntSize](_ark_u_i___int_size.md) [OH_ArkUI_DrawContext_GetSize](#oh_arkui_drawcontext_getsize) ([ArkUI_DrawContext](#arkui_drawcontext) \*context) | Obtains the size of a drawing area. |
547| [ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \* [OH_ArkUI_WaterFlowSectionOption_Create](#oh_arkui_waterflowsectionoption_create) () | Creates a water flow section configuration. |
548| void [OH_ArkUI_WaterFlowSectionOption_Dispose](#oh_arkui_waterflowsectionoption_dispose) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*option) | Disposes of the pointer to a water flow section configuration. |
549| void [OH_ArkUI_WaterFlowSectionOption_SetSize](#oh_arkui_waterflowsectionoption_setsize) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*option, int32_t size) | Sets the array length for a water flow section configuration. |
550| int32_t [OH_ArkUI_WaterFlowSectionOption_GetSize](#oh_arkui_waterflowsectionoption_getsize) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*option) | Sets the array length for a water flow section configuration. |
551| void [OH_ArkUI_WaterFlowSectionOption_SetItemCount](#oh_arkui_waterflowsectionoption_setitemcount) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*option, int32_t index, int32_t itemCount) | Sets the number of items in a water flow section. |
552| int32_t [OH_ArkUI_WaterFlowSectionOption_GetItemCount](#oh_arkui_waterflowsectionoption_getitemcount) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*option, int32_t index) | Obtains the number of items in the water flow section that matches the specified index. |
553| void [OH_ArkUI_WaterFlowSectionOption_SetCrossCount](#oh_arkui_waterflowsectionoption_setcrosscount) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*option, int32_t index, int32_t crossCount) | Sets the number of columns (in a vertical layout) or rows (in a horizontal layout) of a water flow. |
554| int32_t [OH_ArkUI_WaterFlowSectionOption_GetCrossCount](#oh_arkui_waterflowsectionoption_getcrosscount) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*option, int32_t index) | Obtains the number of columns (in a vertical layout) or rows (in a horizontal layout) of a water flow. |
555| void [OH_ArkUI_WaterFlowSectionOption_SetColumnGap](#oh_arkui_waterflowsectionoption_setcolumngap) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*, int32_t index, float columnGap) | Sets the gap between columns in the specified water flow section. |
556| float [OH_ArkUI_WaterFlowSectionOption_GetColumnGap](#oh_arkui_waterflowsectionoption_getcolumngap) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*option, int32_t index) | Obtains the gap between columns in the water flow section that matches the specified index. |
557| void [OH_ArkUI_WaterFlowSectionOption_SetRowGap](#oh_arkui_waterflowsectionoption_setrowgap) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*option, int32_t index, float rowGap) | Sets the gap between rows in the specified water flow section. |
558| float [OH_ArkUI_WaterFlowSectionOption_GetRowGap](#oh_arkui_waterflowsectionoption_getrowgap) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*option, int32_t index) | Obtains the gap between rows in the water flow section that matches the specified index. |
559| void [OH_ArkUI_WaterFlowSectionOption_SetMargin](#oh_arkui_waterflowsectionoption_setmargin) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*option, int32_t index, float marginTop, float marginRight, float marginBottom, float marginLeft) | Sets the margins for the specified water flow section. |
560| [ArkUI_Margin](_ark_u_i___margin.md) [OH_ArkUI_WaterFlowSectionOption_GetMargin](#oh_arkui_waterflowsectionoption_getmargin) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*option, int32_t index) | Obtains the margins of the water flow section that matches the specified index. |
561| void [OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndex](#oh_arkui_waterflowsectionoption_registergetitemmainsizecallbackbyindex) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*option, int32_t index, float(\*callback)(int32_t itemIndex)) | Obtains the main axis size of a specified item based on **flowItemIndex** through a water flow section configuration. |
562| void [OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndexWithUserData](#oh_arkui_waterflowsectionoption_registergetitemmainsizecallbackbyindexwithuserdata) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*option, int32_t index, void \*userData, float(\*callback)(int32_t itemIndex, void \*userData)) | Obtains the main axis size of a specified item based on **flowItemIndex** through a water flow section configuration. |
563| [ArkUI_GuidelineOption](#arkui_guidelineoption) \* [OH_ArkUI_GuidelineOption_Create](#oh_arkui_guidelineoption_create) (int32_t size) | Creates a guideline configuration for this **RelativeContainer** component. |
564| void [OH_ArkUI_GuidelineOption_Dispose](#oh_arkui_guidelineoption_dispose) ([ArkUI_GuidelineOption](#arkui_guidelineoption) \*guideline) | Disposes of a guideline configuration. |
565| void [OH_ArkUI_GuidelineOption_SetId](#oh_arkui_guidelineoption_setid) ([ArkUI_GuidelineOption](#arkui_guidelineoption) \*guideline, const char \*value, int32_t index) | Sets the ID of a guideline. |
566| void [OH_ArkUI_GuidelineOption_SetDirection](#oh_arkui_guidelineoption_setdirection) ([ArkUI_GuidelineOption](#arkui_guidelineoption) \*guideline, [ArkUI_Axis](#arkui_axis) value, int32_t index) | Sets the direction of a guideline. |
567| void [OH_ArkUI_GuidelineOption_SetPositionStart](#oh_arkui_guidelineoption_setpositionstart) ([ArkUI_GuidelineOption](#arkui_guidelineoption) \*guideline, float value, int32_t index) | Sets the distance between a guideline and the left or top of the container. |
568| void [OH_ArkUI_GuidelineOption_SetPositionEnd](#oh_arkui_guidelineoption_setpositionend) ([ArkUI_GuidelineOption](#arkui_guidelineoption) \*guideline, float value, int32_t index) | Sets the distance between a guideline and the right or bottom of the container. |
569| const char \* [OH_ArkUI_GuidelineOption_GetId](#oh_arkui_guidelineoption_getid) ([ArkUI_GuidelineOption](#arkui_guidelineoption) \*guideline, int32_t index) | Obtains the ID of a guideline. |
570| [ArkUI_Axis](#arkui_axis) [OH_ArkUI_GuidelineOption_GetDirection](#oh_arkui_guidelineoption_getdirection) ([ArkUI_GuidelineOption](#arkui_guidelineoption) \*guideline, int32_t index) | Obtains the direction of a guideline. |
571| float [OH_ArkUI_GuidelineOption_GetPositionStart](#oh_arkui_guidelineoption_getpositionstart) ([ArkUI_GuidelineOption](#arkui_guidelineoption) \*guideline, int32_t index) | Obtains the distance between a guideline and the left or top of the container. |
572| float [OH_ArkUI_GuidelineOption_GetPositionEnd](#oh_arkui_guidelineoption_getpositionend) ([ArkUI_GuidelineOption](#arkui_guidelineoption) \*guideline, int32_t index) | Obtains the distance between a guideline and the right or bottom of the container. |
573| [ArkUI_BarrierOption](#arkui_barrieroption) \* [OH_ArkUI_BarrierOption_Create](#oh_arkui_barrieroption_create) (int32_t size) | Creates a barrier configuration for this **RelativeContainer** component. |
574| void [OH_ArkUI_BarrierOption_Dispose](#oh_arkui_barrieroption_dispose) ([ArkUI_BarrierOption](#arkui_barrieroption) \*barrierStyle) | Disposes of a barrier configuration. |
575| void [OH_ArkUI_BarrierOption_SetId](#oh_arkui_barrieroption_setid) ([ArkUI_BarrierOption](#arkui_barrieroption) \*barrierStyle, const char \*value, int32_t index) | Sets the ID of a barrier. |
576| void [OH_ArkUI_BarrierOption_SetDirection](#oh_arkui_barrieroption_setdirection) ([ArkUI_BarrierOption](#arkui_barrieroption) \*barrierStyle, [ArkUI_BarrierDirection](#arkui_barrierdirection) value, int32_t index) | Sets the direction of a barrier. |
577| void [OH_ArkUI_BarrierOption_SetReferencedId](#oh_arkui_barrieroption_setreferencedid) ([ArkUI_BarrierOption](#arkui_barrieroption) \*barrierStyle, const char \*value, int32_t index) | Sets the referenced components of a barrier. |
578| const char \* [OH_ArkUI_BarrierOption_GetId](#oh_arkui_barrieroption_getid) ([ArkUI_BarrierOption](#arkui_barrieroption) \*barrierStyle, int32_t index) | Obtains the ID of a barrier. |
579| [ArkUI_BarrierDirection](#arkui_barrierdirection) [OH_ArkUI_BarrierOption_GetDirection](#oh_arkui_barrieroption_getdirection) ([ArkUI_BarrierOption](#arkui_barrieroption) \*barrierStyle, int32_t index) | Obtains the direction of a barrier. |
580| const char \* [OH_ArkUI_BarrierOption_GetReferencedId](#oh_arkui_barrieroption_getreferencedid) ([ArkUI_BarrierOption](#arkui_barrieroption) \*barrierStyle, int32_t index, int32_t referencedIndex) | Obtains the referenced components of a barrier. |
581| int32_t [OH_ArkUI_BarrierOption_GetReferencedIdSize](#oh_arkui_barrieroption_getreferencedidsize) ([ArkUI_BarrierOption](#arkui_barrieroption) \*barrierStyle, int32_t index) | Obtains the number of referenced components of a barrier. |
582| [ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \* [OH_ArkUI_AlignmentRuleOption_Create](#oh_arkui_alignmentruleoption_create) () | Creates an alignment rule configuration for this **RelativeContainer** component. |
583| void [OH_ArkUI_AlignmentRuleOption_Dispose](#oh_arkui_alignmentruleoption_dispose) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Disposes of an alignment rule configuration of this **RelativeContainer** component. |
584| void [OH_ArkUI_AlignmentRuleOption_SetStart](#oh_arkui_alignmentruleoption_setstart) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option, const char \*id, [ArkUI_HorizontalAlignment](#arkui_horizontalalignment) alignment) | Sets the left alignment parameters. |
585| void [OH_ArkUI_AlignmentRuleOption_SetEnd](#oh_arkui_alignmentruleoption_setend) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option, const char \*id, [ArkUI_HorizontalAlignment](#arkui_horizontalalignment) alignment) | Sets the right alignment parameters. |
586| void [OH_ArkUI_AlignmentRuleOption_SetCenterHorizontal](#oh_arkui_alignmentruleoption_setcenterhorizontal) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option, const char \*id, [ArkUI_HorizontalAlignment](#arkui_horizontalalignment) alignment) | Sets the horizontal center alignment parameters. |
587| void [OH_ArkUI_AlignmentRuleOption_SetTop](#oh_arkui_alignmentruleoption_settop) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option, const char \*id, [ArkUI_VerticalAlignment](#arkui_verticalalignment) alignment) | Sets the top alignment parameters. |
588| void [OH_ArkUI_AlignmentRuleOption_SetBottom](#oh_arkui_alignmentruleoption_setbottom) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option, const char \*id, [ArkUI_VerticalAlignment](#arkui_verticalalignment) alignment) | Sets the bottom alignment parameters. |
589| void [OH_ArkUI_AlignmentRuleOption_SetCenterVertical](#oh_arkui_alignmentruleoption_setcentervertical) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option, const char \*id, [ArkUI_VerticalAlignment](#arkui_verticalalignment) alignment) | Sets the vertical center alignment parameters. |
590| void [OH_ArkUI_AlignmentRuleOption_SetBiasHorizontal](#oh_arkui_alignmentruleoption_setbiashorizontal) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option, float horizontal) | Sets the bias value of the component in the horizontal direction under the anchor constraints. |
591| void [OH_ArkUI_AlignmentRuleOption_SetBiasVertical](#oh_arkui_alignmentruleoption_setbiasvertical) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option, float vertical) | Sets the bias value of the component in the vertical direction under the anchor constraints. |
592| const char \* [OH_ArkUI_AlignmentRuleOption_GetStartId](#oh_arkui_alignmentruleoption_getstartid) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in the left alignment parameters. |
593| [ArkUI_HorizontalAlignment](#arkui_horizontalalignment) [OH_ArkUI_AlignmentRuleOption_GetStartAlignment](#oh_arkui_alignmentruleoption_getstartalignment) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the alignment mode in left alignment parameters. |
594| const char \* [OH_ArkUI_AlignmentRuleOption_GetEndId](#oh_arkui_alignmentruleoption_getendid) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in the right alignment parameters. |
595| [ArkUI_HorizontalAlignment](#arkui_horizontalalignment) [OH_ArkUI_AlignmentRuleOption_GetEndAlignment](#oh_arkui_alignmentruleoption_getendalignment) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in the right alignment parameters. |
596| const char \* [OH_ArkUI_AlignmentRuleOption_GetCenterIdHorizontal](#oh_arkui_alignmentruleoption_getcenteridhorizontal) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in horizontal center alignment parameters. |
597| [ArkUI_HorizontalAlignment](#arkui_horizontalalignment) [OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentHorizontal](#oh_arkui_alignmentruleoption_getcenteralignmenthorizontal) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in horizontal center alignment parameters. |
598| const char \* [OH_ArkUI_AlignmentRuleOption_GetTopId](#oh_arkui_alignmentruleoption_gettopid) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in top alignment parameters. |
599| [ArkUI_VerticalAlignment](#arkui_verticalalignment) [OH_ArkUI_AlignmentRuleOption_GetTopAlignment](#oh_arkui_alignmentruleoption_gettopalignment) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in top alignment parameters. |
600| const char \* [OH_ArkUI_AlignmentRuleOption_GetBottomId](#oh_arkui_alignmentruleoption_getbottomid) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in bottom alignment parameters. |
601| [ArkUI_VerticalAlignment](#arkui_verticalalignment) [OH_ArkUI_AlignmentRuleOption_GetBottomAlignment](#oh_arkui_alignmentruleoption_getbottomalignment) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in bottom alignment parameters. |
602| const char \* [OH_ArkUI_AlignmentRuleOption_GetCenterIdVertical](#oh_arkui_alignmentruleoption_getcenteridvertical) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in vertical center alignment parameters. |
603| [ArkUI_VerticalAlignment](#arkui_verticalalignment) [OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentVertical](#oh_arkui_alignmentruleoption_getcenteralignmentvertical) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in vertical center alignment parameters. |
604| float [OH_ArkUI_AlignmentRuleOption_GetBiasHorizontal](#oh_arkui_alignmentruleoption_getbiashorizontal) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the bias value in the horizontal direction. |
605| float [OH_ArkUI_AlignmentRuleOption_GetBiasVertical](#oh_arkui_alignmentruleoption_getbiasvertical) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the bias value in the vertical direction. |
606| [ArkUI_SwiperIndicator](#arkui_swiperindicator) \* [OH_ArkUI_SwiperIndicator_Create](#oh_arkui_swiperindicator_create) ([ArkUI_SwiperIndicatorType](#arkui_swiperindicatortype) type) | Creates a navigation point indicator for this **Swiper** component. |
607| void [OH_ArkUI_SwiperIndicator_Dispose](#oh_arkui_swiperindicator_dispose) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Disposes of the navigation point indicator of this **Swiper** component. |
608| void [OH_ArkUI_SwiperIndicator_SetStartPosition](#oh_arkui_swiperindicator_setstartposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the distance between the navigation point indicator and the left edge of the **Swiper** component. |
609| float [OH_ArkUI_SwiperIndicator_GetStartPosition](#oh_arkui_swiperindicator_getstartposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the distance between a navigation point indicator and the left edge of the **Swiper** component. |
610| void [OH_ArkUI_SwiperIndicator_SetTopPosition](#oh_arkui_swiperindicator_settopposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the distance between the navigation point indicator and the top edge of the **Swiper** component. |
611| float [OH_ArkUI_SwiperIndicator_GetTopPosition](#oh_arkui_swiperindicator_gettopposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the distance between the navigation point indicator and the top edge of the **Swiper** component. |
612| void [OH_ArkUI_SwiperIndicator_SetEndPosition](#oh_arkui_swiperindicator_setendposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the distance between the navigation point indicator and the right edge of the **Swiper** component. |
613| float [OH_ArkUI_SwiperIndicator_GetEndPosition](#oh_arkui_swiperindicator_getendposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the distance between the navigation point indicator and the right edge of the **Swiper** component. |
614| void [OH_ArkUI_SwiperIndicator_SetBottomPosition](#oh_arkui_swiperindicator_setbottomposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the distance between the navigation point indicator and the bottom edge of the **Swiper** component. |
615| float [OH_ArkUI_SwiperIndicator_GetBottomPosition](#oh_arkui_swiperindicator_getbottomposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the distance between the navigation point indicator and the bottom edge of the **Swiper** component. |
616| void [OH_ArkUI_SwiperIndicator_SetItemWidth](#oh_arkui_swiperindicator_setitemwidth) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the width of a navigation point indicator of the dot style for the **Swiper** component. |
617| float [OH_ArkUI_SwiperIndicator_GetItemWidth](#oh_arkui_swiperindicator_getitemwidth) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the width of a navigation point indicator of the dot style of the **Swiper** component. |
618| void [OH_ArkUI_SwiperIndicator_SetItemHeight](#oh_arkui_swiperindicator_setitemheight) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the height of a navigation point indicator of the dot style for the **Swiper** component. |
619| float [OH_ArkUI_SwiperIndicator_GetItemHeight](#oh_arkui_swiperindicator_getitemheight) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the height of a navigation point indicator of the dot style of the **Swiper** component. |
620| void [OH_ArkUI_SwiperIndicator_SetSelectedItemWidth](#oh_arkui_swiperindicator_setselecteditemwidth) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the width of the selected navigation point indicator of the dot style for the **Swiper** component. |
621| float [OH_ArkUI_SwiperIndicator_GetSelectedItemWidth](#oh_arkui_swiperindicator_getselecteditemwidth) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the width of the selected navigation point indicator of the dot style of the **Swiper** component. |
622| void [OH_ArkUI_SwiperIndicator_SetSelectedItemHeight](#oh_arkui_swiperindicator_setselecteditemheight) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the height of the selected navigation point indicator of the dot style for the **Swiper** component. |
623| float [OH_ArkUI_SwiperIndicator_GetSelectedItemHeight](#oh_arkui_swiperindicator_getselecteditemheight) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the height of the selected navigation point indicator of the dot style of the **Swiper** component. |
624| void [OH_ArkUI_SwiperIndicator_SetMask](#oh_arkui_swiperindicator_setmask) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, int32_t mask) | Sets whether to enable the mask for a navigation point indicator of the dot style for the **Swiper** component. |
625| int32_t [OH_ArkUI_SwiperIndicator_GetMask](#oh_arkui_swiperindicator_getmask) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains whether the mask is enabled for a navigation point indicator of the dot style of the **Swiper** component. |
626| void [OH_ArkUI_SwiperIndicator_SetColor](#oh_arkui_swiperindicator_setcolor) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, uint32_t color) | Sets the color of a navigation point indicator of the dot style for the **Swiper** component. |
627| uint32_t [OH_ArkUI_SwiperIndicator_GetColor](#oh_arkui_swiperindicator_getcolor) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the color of a navigation point indicator of the dot style of the **Swiper** component. |
628| void [OH_ArkUI_SwiperIndicator_SetSelectedColor](#oh_arkui_swiperindicator_setselectedcolor) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, uint32_t selectedColor) | Sets the color of the selected navigation point indicator of the dot style for the **Swiper** component. |
629| uint32_t [OH_ArkUI_SwiperIndicator_GetSelectedColor](#oh_arkui_swiperindicator_getselectedcolor) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the color of the selected navigation point indicator of the dot style of the **Swiper** component. |
630| int32_t [OH_ArkUI_SwiperIndicator_SetMaxDisplayCount](#oh_arkui_swiperindicator_setmaxdisplaycount) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, int32_t maxDisplayCount) | Sets the maximum number of dots for the navigation point indicator of the dot style. |
631| int32_t [OH_ArkUI_SwiperIndicator_GetMaxDisplayCount](#oh_arkui_swiperindicator_getmaxdisplaycount) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the maximum number of points for the navigation point indicator. |
632| [ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \* [OH_ArkUI_ListItemSwipeActionItem_Create](#oh_arkui_listitemswipeactionitem_create) () | Creates a **ListItemSwipeActionItem** instance. |
633| void [OH_ArkUI_ListItemSwipeActionItem_Dispose](#oh_arkui_listitemswipeactionitem_dispose) ([ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item) | Disposes of a **ListItemSwipeActionItem** instance. |
634| void [OH_ArkUI_ListItemSwipeActionItem_SetContent](#oh_arkui_listitemswipeactionitem_setcontent) ([ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item, [ArkUI_NodeHandle](#arkui_nodehandle) node) | Sets the layout content for a **ListItemSwipeActionItem** instance. |
635| void [OH_ArkUI_ListItemSwipeActionItem_SetActionAreaDistance](#oh_arkui_listitemswipeactionitem_setactionareadistance) ([ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item, float distance) | Sets the swipe distance threshold for deleting the list item. |
636| float [OH_ArkUI_ListItemSwipeActionItem_GetActionAreaDistance](#oh_arkui_listitemswipeactionitem_getactionareadistance) ([ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item) | Obtains the swipe distance threshold for deleting the list item. |
637| void [OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionArea](#oh_arkui_listitemswipeactionitem_setonenteractionarea) ([ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item, void(\*callback)()) | Sets the callback invoked each time the list item enters the delete area. |
638| void [OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionAreaWithUserData](#oh_arkui_listitemswipeactionitem_setonenteractionareawithuserdata) ([ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item, void \*userData, void(\*callback)(void \*userData)) | Sets the callback invoked each time the list item enters the delete area. |
639| void [OH_ArkUI_ListItemSwipeActionItem_SetOnAction](#oh_arkui_listitemswipeactionitem_setonaction) ([ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item, void(\*callback)()) | Sets the callback invoked when the list item is deleted while in the delete area. |
640| void [OH_ArkUI_ListItemSwipeActionItem_SetOnActionWithUserData](#oh_arkui_listitemswipeactionitem_setonactionwithuserdata) ([ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item, void \*userData, void(\*callback)(void \*userData)) | Sets the callback invoked when the list item is deleted while in the delete area. |
641| void [OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionArea](#oh_arkui_listitemswipeactionitem_setonexitactionarea) ([ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item, void(\*callback)()) | Sets the callback invoked each time the list item exits the delete area. |
642| void [OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionAreaWithUserData](#oh_arkui_listitemswipeactionitem_setonexitactionareawithuserdata) ([ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item, void \*userData, void(\*callback)(void \*userData)) | Sets the callback invoked each time the list item exits the delete area. |
643| void [OH_ArkUI_ListItemSwipeActionItem_SetOnStateChange](#oh_arkui_listitemswipeactionitem_setonstatechange) ([ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item, void(\*callback)([ArkUI_ListItemSwipeActionState](#arkui_listitemswipeactionstate) swipeActionState)) | Sets the callback invoked when the swipe state of the list item changes. |
644| void [OH_ArkUI_ListItemSwipeActionItem_SetOnStateChangeWithUserData](#oh_arkui_listitemswipeactionitem_setonstatechangewithuserdata) ([ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item, void \*userData, void(\*callback)([ArkUI_ListItemSwipeActionState](#arkui_listitemswipeactionstate) swipeActionState, void \*userData)) | Sets the callback invoked when the swipe state of the list item changes. |
645| [ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) \* [OH_ArkUI_ListItemSwipeActionOption_Create](#oh_arkui_listitemswipeactionoption_create) () | Creates a **ListItemSwipeActionOption** instance. |
646| void [OH_ArkUI_ListItemSwipeActionOption_Dispose](#oh_arkui_listitemswipeactionoption_dispose) ([ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) \*option) | Disposes of a **ListItemSwipeActionOption** instance. |
647| void [OH_ArkUI_ListItemSwipeActionOption_SetStart](#oh_arkui_listitemswipeactionoption_setstart) ([ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) \*option, [ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item) | Sets the layout content for the left edge (for a vertical layout) or top edge (for a horizontal layout) of a **ListItemSwipeActionOption** instance. |
648| void [OH_ArkUI_ListItemSwipeActionOption_SetEnd](#oh_arkui_listitemswipeactionoption_setend) ([ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) \*option, [ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item) | Sets the layout content for the right edge (for a vertical layout) or bottom edge (for a horizontal layout) of a **ListItemSwipeActionItem** instance. |
649| void [OH_ArkUI_ListItemSwipeActionOption_SetEdgeEffect](#oh_arkui_listitemswipeactionoption_setedgeeffect) ([ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) \*option, [ArkUI_ListItemSwipeEdgeEffect](#arkui_listitemswipeedgeeffect) edgeEffect) | Sets the edge effect used when the boundary of the scrolling area is reached. |
650| int32_t [OH_ArkUI_ListItemSwipeActionOption_GetEdgeEffect](#oh_arkui_listitemswipeactionoption_getedgeeffect) ([ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) \*option) | Obtains the edge effect used when the boundary of the scrolling area is reached. |
651| void [OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChange](#oh_arkui_listitemswipeactionoption_setonoffsetchange) ([ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) \*option, void(\*callback)(float offset)) | Sets the callback invoked when the scroll offset changes. |
652| void [OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChangeWithUserData](#oh_arkui_listitemswipeactionoption_setonoffsetchangewithuserdata) ([ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) \*option, void \*userData, void(\*callback)(float offset, void \*userData)) | Sets the callback invoked when the scroll offset changes. |
653| [ArkUI_AccessibilityState](#arkui_accessibilitystate) \* [OH_ArkUI_AccessibilityState_Create](#oh_arkui_accessibilitystate_create) (void) | Creates an accessibility state. |
654| void [OH_ArkUI_AccessibilityState_Dispose](#oh_arkui_accessibilitystate_dispose) ([ArkUI_AccessibilityState](#arkui_accessibilitystate) \*state) | Disposes of the pointer to an accessibility state. |
655| void [OH_ArkUI_AccessibilityState_SetDisabled](#oh_arkui_accessibilitystate_setdisabled) ([ArkUI_AccessibilityState](#arkui_accessibilitystate) \*state, int32_t isDisabled) | Sets whether an accessibility state is disabled. |
656| int32_t [OH_ArkUI_AccessibilityState_IsDisabled](#oh_arkui_accessibilitystate_isdisabled) ([ArkUI_AccessibilityState](#arkui_accessibilitystate) \*state) | Obtains whether an accessibility state is disabled. |
657| void [OH_ArkUI_AccessibilityState_SetSelected](#oh_arkui_accessibilitystate_setselected) ([ArkUI_AccessibilityState](#arkui_accessibilitystate) \*state, int32_t isSelected) | Sets whether an accessibility state is selected. |
658| int32_t [OH_ArkUI_AccessibilityState_IsSelected](#oh_arkui_accessibilitystate_isselected) ([ArkUI_AccessibilityState](#arkui_accessibilitystate) \*state) | Obtains whether an accessibility state is selected. |
659| void [OH_ArkUI_AccessibilityState_SetCheckedState](#oh_arkui_accessibilitystate_setcheckedstate) ([ArkUI_AccessibilityState](#arkui_accessibilitystate) \*state, int32_t checkedState) | Sets the check box state of an accessibility state. |
660| int32_t [OH_ArkUI_AccessibilityState_GetCheckedState](#oh_arkui_accessibilitystate_getcheckedstate) ([ArkUI_AccessibilityState](#arkui_accessibilitystate) \*state) | Obtains the check box state of an accessibility state. |
661| [ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \* [OH_ArkUI_AccessibilityValue_Create](#oh_arkui_accessibilityvalue_create) (void) | Creates an **AccessibilityValue** instance. |
662| void [OH_ArkUI_AccessibilityValue_Dispose](#oh_arkui_accessibilityvalue_dispose) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value) | Disposes of the pointer to an **AccessibilityValue** instance. |
663| void [OH_ArkUI_AccessibilityValue_SetMin](#oh_arkui_accessibilityvalue_setmin) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value, int32_t min) | Sets the minimum accessibility value. |
664| int32_t [OH_ArkUI_AccessibilityValue_GetMin](#oh_arkui_accessibilityvalue_getmin) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value) | Obtains the minimum accessibility value. |
665| void [OH_ArkUI_AccessibilityValue_SetMax](#oh_arkui_accessibilityvalue_setmax) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value, int32_t max) | Sets the maximum accessibility value. |
666| int32_t [OH_ArkUI_AccessibilityValue_GetMax](#oh_arkui_accessibilityvalue_getmax) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value) | Obtains the maximum accessibility value. |
667| void [OH_ArkUI_AccessibilityValue_SetCurrent](#oh_arkui_accessibilityvalue_setcurrent) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value, int32_t current) | Sets the current accessibility value. |
668| int32_t [OH_ArkUI_AccessibilityValue_GetCurrent](#oh_arkui_accessibilityvalue_getcurrent) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value) | Obtains the current accessibility value. |
669| void [OH_ArkUI_AccessibilityValue_SetText](#oh_arkui_accessibilityvalue_settext) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value, const char \*text) | Sets the text description of an **AccessibilityValue** instance. |
670| const char \* [OH_ArkUI_AccessibilityValue_GetText](#oh_arkui_accessibilityvalue_gettext) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value) | Obtains the text description of an **AccessibilityValue** instance. |
671| [ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \* [OH_ArkUI_ImageAnimatorFrameInfo_CreateFromString](#oh_arkui_imageanimatorframeinfo_createfromstring) (char \*src) | Creates an image frame information object based on an image path, with the image format being SVG, PNG, or JPG. |
672| [ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \* [OH_ArkUI_ImageAnimatorFrameInfo_CreateFromDrawableDescriptor](#oh_arkui_imageanimatorframeinfo_createfromdrawabledescriptor) ([ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) \*drawable) | Creates an image frame information object based on a **DrawableDescriptor** object, with the image format being Resource or PixelMap. |
673| void [OH_ArkUI_ImageAnimatorFrameInfo_Dispose](#oh_arkui_imageanimatorframeinfo_dispose) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo) | Disposes of the pointer to an image frame information object. |
674| void [OH_ArkUI_ImageAnimatorFrameInfo_SetWidth](#oh_arkui_imageanimatorframeinfo_setwidth) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo, int32_t width) | Sets the image width. |
675| int32_t [OH_ArkUI_ImageAnimatorFrameInfo_GetWidth](#oh_arkui_imageanimatorframeinfo_getwidth) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo) | Obtains the image width. |
676| void [OH_ArkUI_ImageAnimatorFrameInfo_SetHeight](#oh_arkui_imageanimatorframeinfo_setheight) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo, int32_t height) | Sets the image height. |
677| int32_t [OH_ArkUI_ImageAnimatorFrameInfo_GetHeight](#oh_arkui_imageanimatorframeinfo_getheight) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo) | Obtains the image height. |
678| void [OH_ArkUI_ImageAnimatorFrameInfo_SetTop](#oh_arkui_imageanimatorframeinfo_settop) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo, int32_t top) | Sets the vertical coordinate of an image relative to the upper left corner of the component. |
679| int32_t [OH_ArkUI_ImageAnimatorFrameInfo_GetTop](#oh_arkui_imageanimatorframeinfo_gettop) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo) | Obtains the vertical coordinate of an image relative to the upper left corner of the component. |
680| void [OH_ArkUI_ImageAnimatorFrameInfo_SetLeft](#oh_arkui_imageanimatorframeinfo_setleft) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo, int32_t left) | Sets the horizontal coordinate of an image relative to the upper left corner of the component. |
681| int32_t [OH_ArkUI_ImageAnimatorFrameInfo_GetLeft](#oh_arkui_imageanimatorframeinfo_getleft) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo) | Obtains the horizontal coordinate of an image relative to the upper left corner of the component. |
682| void [OH_ArkUI_ImageAnimatorFrameInfo_SetDuration](#oh_arkui_imageanimatorframeinfo_setduration) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo, int32_t duration) | Sets the playback duration of an image. |
683| int32_t [OH_ArkUI_ImageAnimatorFrameInfo_GetDuration](#oh_arkui_imageanimatorframeinfo_getduration) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo) | Obtains the playback duration of an image. |
684| [ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) \* [OH_ArkUI_ListChildrenMainSizeOption_Create](#oh_arkui_listchildrenmainsizeoption_create) () | Creates a **ListChildrenMainSize** instance. |
685| void [OH_ArkUI_ListChildrenMainSizeOption_Dispose](#oh_arkui_listchildrenmainsizeoption_dispose) ([ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) \*option) | Disposes of a **ListChildrenMainSize** instance. |
686| int32_t [OH_ArkUI_ListChildrenMainSizeOption_SetDefaultMainSize](#oh_arkui_listchildrenmainsizeoption_setdefaultmainsize) ([ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) \*option, float defaultMainSize) | Sets the default size in a **ListChildrenMainSize** instance. |
687| float [OH_ArkUI_ListChildrenMainSizeOption_GetDefaultMainSize](#oh_arkui_listchildrenmainsizeoption_getdefaultmainsize) ([ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) \*option) | Obtains the default size in a **ListChildrenMainSize** instance. |
688| void [OH_ArkUI_ListChildrenMainSizeOption_Resize](#oh_arkui_listchildrenmainsizeoption_resize) ([ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) \*option, int32_t totalSize) | Resets the array size in a **ListChildrenMainSize** instance. |
689| int32_t [OH_ArkUI_ListChildrenMainSizeOption_Splice](#oh_arkui_listchildrenmainsizeoption_splice) ([ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) \*option, int32_t index, int32_t deleteCount, int32_t addCount) | Changes the content of a **ChildrenMainSizeOption** array. |
690| int32_t [OH_ArkUI_ListChildrenMainSizeOption_UpdateSize](#oh_arkui_listchildrenmainsizeoption_updatesize) ([ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) \*option, int32_t index, float mainSize) | Updates the values of a **ChildrenMainSizeOption** array. |
691| float [OH_ArkUI_ListChildrenMainSizeOption_GetMainSize](#oh_arkui_listchildrenmainsizeoption_getmainsize) ([ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) \*option, int32_t index) | Obtains the values of a **ChildrenMainSizeOption** array. |
692| [ArkUI_CustomSpanMeasureInfo](#arkui_customspanmeasureinfo) \* [OH_ArkUI_CustomSpanMeasureInfo_Create](#oh_arkui_customspanmeasureinfo_create) (void) | Creates measurement information for this custom span. |
693| void [OH_ArkUI_CustomSpanMeasureInfo_Dispose](#oh_arkui_customspanmeasureinfo_dispose) ([ArkUI_CustomSpanMeasureInfo](#arkui_customspanmeasureinfo) \*info) | Disposes of measurement information of a custom span. |
694| float [OH_ArkUI_CustomSpanMeasureInfo_GetFontSize](#oh_arkui_customspanmeasureinfo_getfontsize) ([ArkUI_CustomSpanMeasureInfo](#arkui_customspanmeasureinfo) \*info) | Obtains the font size of the parent text node of a custom span. |
695| [ArkUI_CustomSpanMetrics](#arkui_customspanmetrics) \* [OH_ArkUI_CustomSpanMetrics_Create](#oh_arkui_customspanmetrics_create) (void) | Creates measurement metrics for this custom span. |
696| void [OH_ArkUI_CustomSpanMetrics_Dispose](#oh_arkui_customspanmetrics_dispose) ([ArkUI_CustomSpanMetrics](#arkui_customspanmetrics) \*metrics) | Disposes of measurement metrics of this custom span. |
697| int32_t [OH_ArkUI_CustomSpanMetrics_SetWidth](#oh_arkui_customspanmetrics_setwidth) ([ArkUI_CustomSpanMetrics](#arkui_customspanmetrics) \*metrics, float width) | Sets the width for a custom span. |
698| int32_t [OH_ArkUI_CustomSpanMetrics_SetHeight](#oh_arkui_customspanmetrics_setheight) ([ArkUI_CustomSpanMetrics](#arkui_customspanmetrics) \*metrics, float height) | Sets the height for a custom span. |
699| [ArkUI_CustomSpanDrawInfo](#arkui_customspandrawinfo) \* [OH_ArkUI_CustomSpanDrawInfo_Create](#oh_arkui_customspandrawinfo_create) (void) | Creates drawing information for this custom span. |
700| void [OH_ArkUI_CustomSpanDrawInfo_Dispose](#oh_arkui_customspandrawinfo_dispose) ([ArkUI_CustomSpanDrawInfo](#arkui_customspandrawinfo) \*info) | Disposes of drawing information for this custom span. |
701| float [OH_ArkUI_CustomSpanDrawInfo_GetXOffset](#oh_arkui_customspandrawinfo_getxoffset) ([ArkUI_CustomSpanDrawInfo](#arkui_customspandrawinfo) \*info) | Obtains the x-axis offset of the custom span relative to the mounted component. |
702| float [OH_ArkUI_CustomSpanDrawInfo_GetLineTop](#oh_arkui_customspandrawinfo_getlinetop) ([ArkUI_CustomSpanDrawInfo](#arkui_customspandrawinfo) \*info) | Obtains the top margin of the custom span relative to the mounted component. |
703| float [OH_ArkUI_CustomSpanDrawInfo_GetLineBottom](#oh_arkui_customspandrawinfo_getlinebottom) ([ArkUI_CustomSpanDrawInfo](#arkui_customspandrawinfo) \*info) | Obtains the bottom margin of the custom span relative to the mounted component. |
704| float [OH_ArkUI_CustomSpanDrawInfo_GetBaseline](#oh_arkui_customspandrawinfo_getbaseline) ([ArkUI_CustomSpanDrawInfo](#arkui_customspandrawinfo) \*info) | Obtains the baseline offset of the custom span relative to the mounted component. |
705| [ArkUI_StyledString](#arkui_styledstring) \* [OH_ArkUI_StyledString_Create](#oh_arkui_styledstring_create) (OH_Drawing_TypographyStyle \*style, OH_Drawing_FontCollection \*collection) | Creates an **OH_Drawing_TextStyle** object. |
706| void [OH_ArkUI_StyledString_Destroy](#oh_arkui_styledstring_destroy) ([ArkUI_StyledString](#arkui_styledstring) \*handle) | Destroys an **OH_Drawing_FontCollection** object and reclaims the memory occupied by the object. |
707| void [OH_ArkUI_StyledString_PushTextStyle](#oh_arkui_styledstring_pushtextstyle) ([ArkUI_StyledString](#arkui_styledstring) \*handle, OH_Drawing_TextStyle \*style) | Pushes a text style to the top of the style stack of a styled string. |
708| void [OH_ArkUI_StyledString_AddText](#oh_arkui_styledstring_addtext) ([ArkUI_StyledString](#arkui_styledstring) \*handle, const char \*content) | Adds text for a styled string. |
709| void [OH_ArkUI_StyledString_PopTextStyle](#oh_arkui_styledstring_poptextstyle) ([ArkUI_StyledString](#arkui_styledstring) \*handle) | Pops the style at the top of the style stack of a styled string. |
710| OH_Drawing_Typography \* [OH_ArkUI_StyledString_CreateTypography](#oh_arkui_styledstring_createtypography) ([ArkUI_StyledString](#arkui_styledstring) \*handle) | Creates an **OH_Drawing_Typography** object based on an **ArkUI_StyledString** object. |
711| void [OH_ArkUI_StyledString_AddPlaceholder](#oh_arkui_styledstring_addplaceholder) ([ArkUI_StyledString](#arkui_styledstring) \*handle, OH_Drawing_PlaceholderSpan \*placeholder) | Adds a placeholder. |
712| [ArkUI_StyledString_Descriptor](#arkui_styledstring_descriptor) \* [OH_ArkUI_StyledString_Descriptor_Create](#oh_arkui_styledstring_descriptor_create) () | Creates an **ArkUI_StyledString_Descriptor** object. |
713| void [OH_ArkUI_StyledString_Descriptor_Destroy](#oh_arkui_styledstring_descriptor_destroy) ([ArkUI_StyledString_Descriptor](#arkui_styledstring_descriptor) \*descriptor) | Destroys an **ArkUI_StyledString_Descriptor** object and reclaims the memory occupied by the object. |
714| int32_t [OH_ArkUI_UnmarshallStyledStringDescriptor](#oh_arkui_unmarshallstyledstringdescriptor) (uint8_t \*buffer, size_t \*bufferSize, [ArkUI_StyledString_Descriptor](#arkui_styledstring_descriptor) \*descriptor) | Deserializes a byte array containing styled string information into a styled string. |
715| int32_t [OH_ArkUI_MarshallStyledStringDescriptor](#oh_arkui_marshallstyledstringdescriptor) (uint8_t \*buffer, size_t \*bufferSize, [ArkUI_StyledString_Descriptor](#arkui_styledstring_descriptor) \*descriptor) | Serializes the styled string information into a byte array. |
716| const char \* [OH_ArkUI_ConvertToHtml](#oh_arkui_converttohtml) ([ArkUI_StyledString_Descriptor](#arkui_styledstring_descriptor) \*descriptor) | Converts styled string information into HTML. |
717
718
719## Macro Description
720
721
722### OH_ArkUI_GetModuleInterface
723
724```
725#define OH_ArkUI_GetModuleInterface( nativeAPIVariantKind,  structType,  structPtr )
726```
727**Value:**
728```
729 do { \
730 void* anyNativeAPI = OH_ArkUI_QueryModuleInterfaceByName(nativeAPIVariantKind, #structType); \
731 if (anyNativeAPI) { \
732 structPtr = (structType*)(anyNativeAPI); \
733 } \
734 } while (0)
735#include<arkui/native_interface.h>
736#include<arkui/native_node.h>
737
738ArkUI_NativeNodeAPI_1* nativeNodeApi = nullptr;
739OH_ArkUI_GetModuleInterface(ARKUI_NATIVE_NODE, ArkUI_NativeNodeAPI_1, nativeNodeApi);
740```
741**Description**
742
743Obtains the macro function corresponding to a struct pointer based on the struct type.
744
745**Since**: 12
746
747
748## Type Description
749
750
751### ArkUI_AccessibilityState
752
753```
754typedef struct ArkUI_AccessibilityState ArkUI_AccessibilityState
755```
756**Description**
757
758Defines a struct for the component accessibility state.
759
760**Since**: 12
761
762
763### ArkUI_AccessibilityValue
764
765```
766typedef struct ArkUI_AccessibilityValue ArkUI_AccessibilityValue
767```
768**Description**
769
770Defines a struct for the component accessibility value.
771
772**Since**: 12
773
774
775### ArkUI_AlignmentRuleOption
776
777```
778typedef struct ArkUI_AlignmentRuleOption ArkUI_AlignmentRuleOption
779```
780**Description**
781
782Defines the alignment rule in the relative container.
783
784**Since**: 12
785
786
787### ArkUI_AnimateOption
788
789```
790typedef struct ArkUI_AnimateOption ArkUI_AnimateOption
791```
792**Description**
793
794Defines a struct for the animation configuration.
795
796**Since**: 12
797
798
799### ArkUI_AnimatorHandle
800
801```
802typedef struct ArkUI_Animator* ArkUI_AnimatorHandle
803```
804**Description**
805
806Defines a struct for the pointer to an animator object.
807
808**Since**: 12
809
810
811### ArkUI_AnimatorOption
812
813```
814typedef struct ArkUI_AnimatorOption ArkUI_AnimatorOption
815```
816**Description**
817
818Defines the animator parameter object.
819
820**Since**: 12
821
822
823### ArkUI_BarrierOption
824
825```
826typedef struct ArkUI_BarrierOption ArkUI_BarrierOption
827```
828**Description**
829
830Defines the ID, direction, and referenced component of a barrier.
831
832**Since**: 12
833
834
835### ArkUI_Context
836
837```
838typedef struct ArkUI_Context ArkUI_Context
839```
840**Description**
841
842Defines a struct for a UI context object.
843
844**Since**: 12
845
846
847### ArkUI_ContextHandle [1/2]
848
849```
850typedef struct ArkUI_Context* ArkUI_ContextHandle
851```
852**Description**
853
854Defines a struct for the handle to the ArkUI native UI context.
855
856**Since**: 12
857
858
859### ArkUI_ContextHandle [2/2]
860
861```
862typedef struct ArkUI_Context* ArkUI_ContextHandle
863```
864**Description**
865
866Defines the handle to the ArkUI native UI context.
867
868**Since**: 12
869
870
871### ArkUI_CurveHandle
872
873```
874typedef struct ArkUI_Curve* ArkUI_CurveHandle
875```
876**Description**
877
878Defines a struct for the pointer to an interpolation curve.
879
880**Since**: 12
881
882
883### ArkUI_CustomSpanDrawInfo
884
885```
886typedef struct ArkUI_CustomSpanDrawInfo ArkUI_CustomSpanDrawInfo
887```
888**Description**
889
890Defines a struct for the drawing information of a custom span.
891
892**Since**: 12
893
894
895### ArkUI_CustomSpanMeasureInfo
896
897```
898typedef struct ArkUI_CustomSpanMeasureInfo ArkUI_CustomSpanMeasureInfo
899```
900**Description**
901
902Defines a struct for the measurement information of a custom span.
903
904**Since**: 12
905
906
907### ArkUI_CustomSpanMetrics
908
909```
910typedef struct ArkUI_CustomSpanMetrics ArkUI_CustomSpanMetrics
911```
912**Description**
913
914Defines a struct for the measurement metrics of a custom span.
915
916**Since**: 12
917
918### ArkUI_DialogDismissEvent
919
920```
921typedef struct ArkUI_DialogDismissEvent ArkUI_DialogDismissEvent
922```
923**Description**
924
925Defines a struct for a dialog box dismiss event.
926
927**Since**: 12
928
929
930### ArkUI_DragAction
931
932```
933typedef struct ArkUI_DragAction ArkUI_DragAction
934```
935**Description**
936
937Defines a struct for a drag action.
938
939**Since**: 12
940
941
942### ArkUI_DragAndDropInfo
943
944```
945typedef struct ArkUI_DragAndDropInfo ArkUI_DragAndDropInfo
946```
947**Description**
948
949Defines a struct for drag and drop information returned through a drag status listener.
950
951**Since**: 12
952
953
954### ArkUI_DragEvent
955
956```
957typedef struct ArkUI_DragEvent ArkUI_DragEvent
958```
959**Description**
960
961Defines a struct for a drag event.
962
963**Since**: 12
964
965
966### ArkUI_DragPreviewOption
967
968```
969typedef struct ArkUI_DragPreviewOption ArkUI_DragPreviewOption
970```
971**Description**
972
973Defines a struct for custom drag preview options.
974
975**Since**: 12
976
977
978### ArkUI_DrawableDescriptor
979
980```
981typedef struct ArkUI_DrawableDescriptor ArkUI_DrawableDescriptor
982```
983**Description**
984
985Defines a struct for the **DrawableDescriptor** object.
986
987**Since**: 12
988
989
990### ArkUI_DrawContext
991
992```
993typedef struct ArkUI_DrawContext ArkUI_DrawContext
994```
995**Description**
996
997Defines the component drawing context.
998
999**Since**: 12
1000
1001
1002### ArkUI_GestureDirectionMask
1003
1004```
1005typedef uint32_t ArkUI_GestureDirectionMask
1006```
1007**Description**
1008
1009Defines a set of gesture directions.
1010
1011**Since**: 12
1012
1013
1014### ArkUI_GestureEventActionTypeMask
1015
1016```
1017typedef uint32_t ArkUI_GestureEventActionTypeMask
1018```
1019**Description**
1020
1021Defines a set of gesture event types.
1022
1023Example: **ArkUI_GestureEventActionTypeMask actions = GESTURE_EVENT_ACTION_ACCEPT | GESTURE_EVENT_ACTION_UPDATE**
1024
1025**Since**: 12
1026
1027
1028### ArkUI_GestureEventTargetInfo
1029
1030```
1031typedef struct ArkUI_GestureEventTargetInfo ArkUI_GestureEventTargetInfo
1032```
1033**Description**
1034
1035Defines a struct for a **GestureEventTargetInfo** object that provides information about a gesture event target.
1036
1037**Since**: 12
1038
1039
1040### ArkUI_GestureRecognizerDestructNotifyCallback
1041
1042```
1043typedef void(* ArkUI_GestureRecognizerDestructNotifyCallback) (ArkUI_GestureRecognizer *recognizer, void *userData)
1044```
1045**Description**
1046
1047Defines a callback function for notifying gesture recognizer destruction.
1048
1049**Since**: 12
1050
1051
1052### ArkUI_GestureRecognizerHandle
1053
1054```
1055typedef ArkUI_GestureRecognizer* ArkUI_GestureRecognizerHandle
1056```
1057**Description**
1058
1059Defines the gesture recognizer handle.
1060
1061**Since**: 12
1062
1063
1064### ArkUI_GestureRecognizerHandleArray
1065
1066```
1067typedef ArkUI_GestureRecognizerHandle* ArkUI_GestureRecognizerHandleArray
1068```
1069**Description**
1070
1071Defines the gesture recognizer handle array.
1072
1073**Since**: 12
1074
1075
1076### ArkUI_GuidelineOption
1077
1078```
1079typedef struct ArkUI_GuidelineOption ArkUI_GuidelineOption
1080```
1081**Description**
1082
1083Defines the ID, direction, and position of a guideline.
1084
1085**Since**: 12
1086
1087
1088### ArkUI_ImageAnimatorFrameInfo
1089
1090```
1091typedef struct ArkUI_ImageAnimatorFrameInfo ArkUI_ImageAnimatorFrameInfo
1092```
1093**Description**
1094
1095Defines the image frame information.
1096
1097**Since**: 12
1098
1099
1100### ArkUI_KeyframeAnimateOption
1101
1102```
1103typedef struct ArkUI_KeyframeAnimateOption ArkUI_KeyframeAnimateOption
1104```
1105**Description**
1106
1107Defines a struct for the keyframe animation parameter object.
1108
1109**Since**: 12
1110
1111
1112### ArkUI_LayoutConstraint
1113
1114```
1115typedef struct ArkUI_LayoutConstraint ArkUI_LayoutConstraint
1116```
1117**Description**
1118
1119Defines the size constraints of a component during component layout.
1120
1121**Since**: 12
1122
1123
1124### ArkUI_ListChildrenMainSize
1125
1126```
1127typedef struct ArkUI_ListChildrenMainSize ArkUI_ListChildrenMainSize
1128```
1129**Description**
1130
1131Defines the **ChildrenMainSize** information of the **List** component.
1132
1133**Since**: 12
1134
1135
1136### ArkUI_ListItemSwipeActionItem
1137
1138```
1139typedef struct ArkUI_ListItemSwipeActionItem ArkUI_ListItemSwipeActionItem
1140```
1141**Description**
1142
1143Defines the item configuration for **ListItemSwipeActionOption**.
1144
1145**Since**: 12
1146
1147
1148### ArkUI_ListItemSwipeActionOption
1149
1150```
1151typedef struct ArkUI_ListItemSwipeActionOption ArkUI_ListItemSwipeActionOption
1152```
1153**Description**
1154
1155Defines the configuration for **ListItemSwipeActionOption**.
1156
1157**Since**: 12
1158
1159
1160### ArkUI_NativeDialogHandle
1161
1162```
1163typedef struct ArkUI_NativeDialog* ArkUI_NativeDialogHandle
1164```
1165**Description**
1166
1167Defines the handle to the custom dialog box controller of ArkUI on the native side.
1168
1169**Since**: 12
1170
1171
1172### ArkUI_NodeAdapterEvent
1173
1174```
1175typedef struct ArkUI_NodeAdapterEvent ArkUI_NodeAdapterEvent
1176```
1177**Description**
1178
1179Defines the component adapter event.
1180
1181**Since**: 12
1182
1183
1184### ArkUI_NodeAdapterHandle
1185
1186```
1187typedef struct ArkUI_NodeAdapter* ArkUI_NodeAdapterHandle
1188```
1189**Description**
1190
1191Defines the component adapter, which is used for lazy loading of elements of scrollable components.
1192
1193**Since**: 12
1194
1195
1196### ArkUI_NodeContentCallback
1197
1198```
1199typedef void(* ArkUI_NodeContentCallback) (ArkUI_NodeContentEvent *event)
1200```
1201**Description**
1202
1203Defines the callback for the NodeContent event.
1204
1205**Since**: 12
1206
1207
1208### ArkUI_NodeContentEvent
1209
1210```
1211typedef struct ArkUI_NodeContentEvent ArkUI_NodeContentEvent
1212```
1213**Description**
1214
1215Defines the common structure type of a NodeContent event.
1216
1217**Since**: 12
1218
1219
1220### ArkUI_NodeContentHandle
1221
1222```
1223typedef struct ArkUI_NodeContent* ArkUI_NodeContentHandle
1224```
1225**Description**
1226
1227Defines the handle to the ArkUI NodeContent instance on the native side.
1228
1229**Since**: 12
1230
1231
1232### ArkUI_NodeCustomEvent
1233
1234```
1235typedef struct ArkUI_NodeCustomEvent ArkUI_NodeCustomEvent
1236```
1237**Description**
1238
1239Defines the common structure of a custom component event.
1240
1241**Since**: 12
1242
1243
1244### ArkUI_NodeEvent [1/2]
1245
1246```
1247typedef struct ArkUI_NodeEvent ArkUI_NodeEvent
1248```
1249**Description**
1250
1251Defines a struct for a component event.
1252
1253**Since**: 12
1254
1255
1256### ArkUI_NodeEvent [2/2]
1257
1258```
1259typedef struct ArkUI_NodeEventArkUI_NodeEvent
1260```
1261**Description**
1262
1263Defines the common structure of a component event.
1264
1265**Since**: 12
1266
1267
1268### ArkUI_NodeHandle
1269
1270```
1271typedef struct ArkUI_Node* ArkUI_NodeHandle
1272```
1273**Description**
1274
1275Defines the pointer to the ArkUI native component object.
1276
1277**Since**: 12
1278
1279
1280### ArkUI_OnWillDismissEvent
1281
1282```
1283typedef bool(* ArkUI_OnWillDismissEvent) (int32_t reason)
1284```
1285**Description**
1286
1287Defines a pointer to the callback invoked when the dialog box is closed.
1288
1289**Since**: 12
1290
1291
1292### ArkUI_ParallelInnerGestureEvent
1293
1294```
1295typedef struct ArkUI_ParallelInnerGestureEvent ArkUI_ParallelInnerGestureEvent
1296```
1297**Description**
1298
1299Defines a parallel internal gesture event.
1300
1301**Since**: 12
1302
1303
1304### ArkUI_StyledString
1305
1306```
1307typedef struct ArkUI_StyledString ArkUI_StyledString
1308```
1309**Description**
1310
1311Defines a struct for the styled string object supported by the text component.
1312
1313**Since**: 12
1314
1315
1316### ArkUI_StyledString_Descriptor
1317
1318```
1319typedef struct ArkUI_StyledString_Descriptor ArkUI_StyledString_Descriptor
1320```
1321**Description**
1322
1323Defines a struct for the styled string descriptor object supported by the text component.
1324
1325**Since**: 14
1326
1327
1328### ArkUI_SwiperIndicator
1329
1330```
1331typedef struct ArkUI_SwiperIndicator ArkUI_SwiperIndicator
1332```
1333**Description**
1334
1335Defines the navigation point indicator style of the **Swiper** component.
1336
1337**Since**: 12
1338
1339
1340### ArkUI_SystemFontStyleEvent
1341
1342```
1343typedef struct ArkUI_SystemFontStyleEvent ArkUI_SystemFontStyleEvent
1344```
1345**Description**
1346
1347Defines a struct for the system font style event.
1348
1349**Since**: 12
1350
1351
1352### ArkUI_TransitionEffect
1353
1354```
1355typedef struct ArkUI_TransitionEffect ArkUI_TransitionEffect
1356```
1357**Description**
1358
1359Defines a struct for the transition effect.
1360
1361**Since**: 12
1362
1363
1364### ArkUI_WaterFlowSectionOption
1365
1366```
1367typedef struct ArkUI_WaterFlowSectionOption ArkUI_WaterFlowSectionOption
1368```
1369**Description**
1370
1371Defines the water flow section configuration.
1372
1373**Since**: 12
1374
1375
1376### OH_PixelmapNative
1377
1378```
1379typedef struct OH_PixelmapNative OH_PixelmapNative
1380```
1381**Description**
1382
1383Defines the **Pixelmap** struct, which is used to perform operations related to a pixel map.
1384
1385**Since**: 12
1386
1387
1388### OH_PixelmapNativeHandle
1389
1390```
1391typedef struct OH_PixelmapNative* OH_PixelmapNativeHandle
1392```
1393**Description**
1394
1395Defines a struct for the pointer to an **OH_PixelmapNative** object.
1396
1397**Since**: 12
1398
1399
1400### OH_UdmfData
1401
1402```
1403typedef struct OH_UdmfData OH_UdmfData
1404```
1405**Description**
1406
1407Defines a struct for UDMF unified data.
1408
1409**Since**: 12
1410
1411
1412## Enum Description
1413
1414
1415### ArkUI_AccessibilityActionType
1416
1417```
1418enum ArkUI_AccessibilityActionType
1419```
1420**Description**
1421
1422Defines an enum for the accessibility action types.
1423
1424**Since**: 12
1425
1426| Enum| Description|
1427| -------- | -------- |
1428| ARKUI_ACCESSIBILITY_ACTION_CLICK  | Tapping. |
1429| ARKUI_ACCESSIBILITY_ACTION_LONG_CLICK  | Long press. |
1430| ARKUI_ACCESSIBILITY_ACTION_CUT  | Cut. |
1431| ARKUI_ACCESSIBILITY_ACTION_COPY  | Copy.  |
1432| ARKUI_ACCESSIBILITY_ACTION_PASTE  | Paste. |
1433
1434
1435### ArkUI_AccessibilityCheckedState
1436
1437```
1438enum ArkUI_AccessibilityCheckedState
1439```
1440**Description**
1441
1442Enumerates the accessibility check box states.
1443
1444**Since**: 12
1445
1446| Enum| Description|
1447| -------- | -------- |
1448| ARKUI_ACCESSIBILITY_UNCHECKED  | The check box is not selected. |
1449| ARKUI_ACCESSIBILITY_CHECKED  | The check box is selected. |
1450
1451
1452### ArkUI_AccessibilityMode
1453
1454```
1455enum ArkUI_AccessibilityMode
1456```
1457**Description**
1458
1459Enumerates the accessibility modes.
1460
1461**Since**: 12
1462
1463| Enum| Description|
1464| -------- | -------- |
1465| ARKUI_ACCESSIBILITY_MODE_AUTO  | The mode is automatically set to enabled or disabled based on the component. |
1466| ARKUI_ACCESSIBILITY_MODE_ENABLED  | The component can be identified by the accessibility service. |
1467| ARKUI_ACCESSIBILITY_MODE_DISABLED  | The component cannot be identified by the accessibility service. |
1468| ARKUI_ACCESSIBILITY_MODE_DISABLED_FOR_DESCENDANTS  | The component and all its child components cannot be identified by the accessibility service. |
1469
1470
1471### ArkUI_AdaptiveColor
1472
1473```
1474enum ArkUI_AdaptiveColor
1475```
1476**Description**
1477
1478Enumerates the adaptive color modes.
1479
1480**Since**: 12
1481
1482| Enum| Description|
1483| -------- | -------- |
1484| ARKUI_ADAPTIVE_COLOR_DEFAULT  | Adaptive color mode is not used. |
1485| ARKUI_ADAPTIVE_COLOR_AVERAGE  | Adaptive color mode is used. |
1486
1487
1488### ArkUI_Alignment
1489
1490```
1491enum ArkUI_Alignment
1492```
1493**Description**
1494
1495Enumerates the alignment modes.
1496
1497**Since**: 12
1498
1499| Enum| Description|
1500| -------- | -------- |
1501| ARKUI_ALIGNMENT_TOP_START  | Top start. |
1502| ARKUI_ALIGNMENT_TOP  | Top center. |
1503| ARKUI_ALIGNMENT_TOP_END  | Top end. |
1504| ARKUI_ALIGNMENT_START  | Vertically centered start. |
1505| ARKUI_ALIGNMENT_CENTER  | Horizontally and vertically centered. |
1506| ARKUI_ALIGNMENT_END  | Vertically centered end. |
1507| ARKUI_ALIGNMENT_BOTTOM_START  | Bottom start. |
1508| ARKUI_ALIGNMENT_BOTTOM  | Horizontally centered on the bottom. |
1509| ARKUI_ALIGNMENT_BOTTOM_END  | Bottom end. |
1510
1511
1512### ArkUI_AnimationCurve
1513
1514```
1515enum ArkUI_AnimationCurve
1516```
1517**Description**
1518
1519Enumerates the animation curves.
1520
1521**Since**: 12
1522
1523| Enum| Description|
1524| -------- | -------- |
1525| ARKUI_CURVE_LINEAR  | The animation speed keeps unchanged. |
1526| ARKUI_CURVE_EASE  | The animation starts slowly, accelerates, and then slows down towards the end. |
1527| ARKUI_CURVE_EASE_IN  | The animation starts at a low speed and then picks up speed until the end. |
1528| ARKUI_CURVE_EASE_OUT  | The animation ends at a low speed. |
1529| ARKUI_CURVE_EASE_IN_OUT  | The animation starts and ends at a low speed. |
1530| ARKUI_CURVE_FAST_OUT_SLOW_IN  | The animation uses the standard curve |
1531| ARKUI_CURVE_LINEAR_OUT_SLOW_IN  | The animation uses the deceleration curve. |
1532| ARKUI_CURVE_FAST_OUT_LINEAR_IN  | The animation uses the acceleration curve. |
1533| ARKUI_CURVE_EXTREME_DECELERATION  | The animation uses the extreme deceleration curve. |
1534| ARKUI_CURVE_SHARP  | The animation uses the sharp curve. |
1535| ARKUI_CURVE_RHYTHM  | The animation uses the rhythm curve. |
1536| ARKUI_CURVE_SMOOTH  | The animation uses the smooth curve. |
1537| ARKUI_CURVE_FRICTION  | The animation uses the friction curve |
1538
1539
1540### ArkUI_AnimationDirection
1541
1542```
1543enum ArkUI_AnimationDirection
1544```
1545**Description**
1546
1547Enumerates the animation playback modes.
1548
1549**Since**: 12
1550
1551| Enum| Description|
1552| -------- | -------- |
1553| ARKUI_ANIMATION_DIRECTION_NORMAL  | The animation plays in forward loop mode. |
1554| ARKUI_ANIMATION_DIRECTION_REVERSE  | The animation plays in reverse loop mode. |
1555| ARKUI_ANIMATION_DIRECTION_ALTERNATE  | The animation plays in alternating loop mode. When the animation is played for an odd number of times, the playback is in forward direction. When the animation is played for an even number of times, the playback is in reverse direction. |
1556| ARKUI_ANIMATION_DIRECTION_ALTERNATE_REVERSE  | The animation plays in reverse alternating loop mode. When the animation is played for an odd number of times, the playback is in reverse direction. When the animation is played for an even number of times, the playback is in forward direction. |
1557
1558
1559### ArkUI_AnimationFill
1560
1561```
1562enum ArkUI_AnimationFill
1563```
1564**Description**
1565
1566Enumerates the state of the animated target after the animation is executed.
1567
1568**Since**: 12
1569
1570| Enum| Description|
1571| -------- | -------- |
1572| ARKUI_ANIMATION_FILL_NONE  | No style is applied to the target before or after the animation is executed. |
1573| ARKUI_ANIMATION_FILL_FORWARDS  | The target keeps the state at the end of the animation (defined in the last key frame) after the animation is executed. |
1574| ARKUI_ANIMATION_FILL_BACKWARDS  | The animation uses the value defined in the first key frame during the duration defined by **animation-delay**. |
1575| ARKUI_ANIMATION_FILL_BOTH  | The animation follows the **forwards** and **backwards** rules. |
1576
1577
1578### ArkUI_AnimationFillMode
1579
1580```
1581enum ArkUI_AnimationFillMode
1582```
1583**Description**
1584
1585Enumerates the states before and after execution of the frame-by-frame animation.
1586
1587**Since**: 12
1588
1589| Enum| Description|
1590| -------- | -------- |
1591| ARKUI_ANIMATION_FILL_MODE_NONE  | Before execution, the animation does not apply any styles to the target component. After execution, the animation restores the target component to its default state. |
1592| ARKUI_ANIMATION_FILL_MODE_FORWARDS  | The target component retains the state set by the last keyframe encountered during execution of the animation. |
1593| ARKUI_ANIMATION_FILL_MODE_BACKWARDS  | The animation applies the values defined in the first relevant keyframe once it is applied to the target component, and retains the values during the period set by **delay**. |
1594| ARKUI_ANIMATION_FILL_MODE_BOTH  | The animation follows the rules for both **Forwards** and **Backwards**, extending the animation attributes in both directions. |
1595
1596
1597### ArkUI_AnimationPlayMode
1598
1599```
1600enum ArkUI_AnimationPlayMode
1601```
1602**Description**
1603
1604Enumerates the animation playback modes.
1605
1606**Since**: 12
1607
1608| Enum| Description|
1609| -------- | -------- |
1610| ARKUI_ANIMATION_PLAY_MODE_NORMAL  | The animation is played forwards. |
1611| ARKUI_ANIMATION_PLAY_MODE_REVERSE  | The animation is played backwards. |
1612| ARKUI_ANIMATION_PLAY_MODE_ALTERNATE  | The animation is played forwards for an odd number of times (1, 3, 5...) and backwards for an even number of times (2, 4, 6...). |
1613| ARKUI_ANIMATION_PLAY_MODE_ALTERNATE_REVERSE  | The animation is played backwards for an odd number of times (1, 3, 5...) and forwards for an even number of times (2, 4, 6...). |
1614
1615
1616### ArkUI_AnimationStatus
1617
1618```
1619enum ArkUI_AnimationStatus
1620```
1621**Description**
1622
1623Enumerates the playback states of the frame-by-frame animation.
1624
1625**Since**: 12
1626
1627| Enum| Description|
1628| -------- | -------- |
1629| ARKUI_ANIMATION_STATUS_INITIAL  | The animation is in the initial state. |
1630| ARKUI_ANIMATION_STATUS_RUNNING  | The animation is being played. |
1631| ARKUI_ANIMATION_STATUS_PAUSED  | The animation is paused. |
1632| ARKUI_ANIMATION_STATUS_STOPPED  | The animation is stopped. |
1633
1634
1635### ArkUI_Axis
1636
1637```
1638enum ArkUI_Axis
1639```
1640**Description**
1641
1642Enumerates the scroll directions.
1643
1644**Since**: 12
1645
1646| Enum| Description|
1647| -------- | -------- |
1648| ARKUI_AXIS_VERTICAL  | Only vertical scrolling is supported. |
1649| ARKUI_AXIS_HORIZONTAL  | Only horizontal scrolling is supported. |
1650
1651
1652### ArkUI_BarrierDirection
1653
1654```
1655enum ArkUI_BarrierDirection
1656```
1657**Description**
1658
1659Enumerates the barrier directions.
1660
1661**Since**: 12
1662
1663| Enum| Description|
1664| -------- | -------- |
1665| ARKUI_BARRIER_DIRECTION_START  | The barrier is on the left side of all the referenced components specified by referencedId. |
1666| ARKUI_BARRIER_DIRECTION_END  | The barrier is on the right side of all the referenced components specified by referencedId. |
1667| ARKUI_BARRIER_DIRECTION_TOP  | The barrier is at the top of all the referenced components specified by referencedId. |
1668| ARKUI_BARRIER_DIRECTION_BOTTOM  | The barrier is at the bottom of all the referenced components specified by referencedId. |
1669
1670
1671### ArkUI_BlendApplyType
1672
1673```
1674enum ArkUI_BlendApplyType
1675```
1676**Description**
1677
1678Defines how the specified blend mode is applied.
1679
1680**Since**: 12
1681
1682| Enum| Description|
1683| -------- | -------- |
1684| BLEND_APPLY_TYPE_FAST  | The content of the view is blended in sequence on the target image. |
1685| BLEND_APPLY_TYPE_OFFSCREEN  | The content of the component and its child components are drawn on the offscreen canvas, and then blended with the existing content on the canvas.  |
1686
1687
1688### ArkUI_BlendMode
1689
1690```
1691enum ArkUI_BlendMode
1692```
1693**Description**
1694
1695Enumerates the blend modes.
1696
1697**Since**: 12
1698
1699| Enum| Description|
1700| -------- | -------- |
1701| ARKUI_BLEND_MODE_NONE  | The top image is superimposed on the bottom image without any blending. |
1702| ARKUI_BLEND_MODE_CLEAR  | The target pixels covered by the source pixels are erased by being turned to completely transparent. |
1703| ARKUI_BLEND_MODE_SRC  | r = s: Only the source pixels are displayed. |
1704| ARKUI_BLEND_MODE_DST  | r = d: Only the target pixels are displayed. |
1705| ARKUI_BLEND_MODE_SRC_OVER  | r = s + (1 - sa) \d: The source pixels are blended based on opacity and cover the target pixels. |
1706| ARKUI_BLEND_MODE_DST_OVER  | r = d + (1 - da) *\ s: The target pixels are blended based on opacity and cover on the source pixels. |
1707| ARKUI_BLEND_MODE_SRC_IN  | r = s \* da: Only the part of the source pixels that overlap with the target pixels is displayed. |
1708| ARKUI_BLEND_MODE_DST_IN  | r = d \* sa: Only the part of the target pixels that overlap with the source pixels is displayed. |
1709| ARKUI_BLEND_MODE_SRC_OUT  | r = s \* (1 - da): Only the part of the source pixels that do not overlap with the target pixels is displayed. |
1710| ARKUI_BLEND_MODE_DST_OUT  | r = d \* (1 - sa): Only the part of the target pixels that do not overlap with the source pixels is displayed. |
1711| ARKUI_BLEND_MODE_SRC_ATOP  | r = s \da + d \(1 - sa): The part of the source pixels that overlap with the target pixels is displayed and the part of the target pixels that do not overlap with the source pixels are displayed. |
1712| ARKUI_BLEND_MODE_DST_ATOP  | r = d \sa + s \(1 - da): The part of the target pixels that overlap with the source pixels and the part of the source pixels that do not overlap with the target pixels are displayed. |
1713| ARKUI_BLEND_MODE_XOR  | r = s \* (1 - da) + d \* (1 - sa): Only the non-overlapping part between the source pixels and the target pixels is displayed. |
1714| ARKUI_BLEND_MODE_PLUS  | r = min(s + d, 1): New pixels resulting from adding the source pixels to the target pixels are displayed. |
1715| ARKUI_BLEND_MODE_MODULATE  | r = s \* d: New pixels resulting from multiplying the source pixels with the target pixels are displayed. |
1716| ARKUI_BLEND_MODE_SCREEN  | r = s + d - s \* d: Pixels are blended by adding the source pixels to the target pixels and subtracting the product of their multiplication. |
1717| ARKUI_BLEND_MODE_OVERLAY  | The MULTIPLY or SCREEN mode is used based on the target pixels. |
1718| ARKUI_BLEND_MODE_DARKEN  | rc = s + d - max(s \da, d \sa), ra = kSrcOver: When two colors overlap, whichever is darker is used. |
1719| ARKUI_BLEND_MODE_LIGHTEN  | rc = s + d - min(s \da, d \sa), ra = kSrcOver: The darker of the pixels (source and target) is used. |
1720| ARKUI_BLEND_MODE_COLOR_DODGE  | The colors of the target pixels are lightened to reflect the source pixels. |
1721| ARKUI_BLEND_MODE_COLOR_BURN  | The colors of the target pixels are darkened to reflect the source pixels. |
1722| ARKUI_BLEND_MODE_HARD_LIGHT  | The MULTIPLY or SCREEN mode is used, depending on the source pixels. |
1723| ARKUI_BLEND_MODE_SOFT_LIGHT  | The LIGHTEN or DARKEN mode is used, depending on the source pixels. |
1724| ARKUI_BLEND_MODE_DIFFERENCE  | rc = s + d - 2 \* (min(s \* da, d \vsa)), ra = kSrcOver: The final pixel is the result of subtracting the darker of the two pixels (source and target) from the lighter one. |
1725| ARKUI_BLEND_MODE_EXCLUSION  | rc = s + d - two(s \* d), ra = kSrcOver: The final pixel is similar to **DIFFERENCE**, but with less contrast. |
1726| ARKUI_BLEND_MODE_MULTIPLY  | r = s \* (1 - da) + d \* (1 - sa) + s \* d: The final pixel is the result of multiplying the source pixel by the target pixel.|
1727| ARKUI_BLEND_MODE_HUE  | The resultant image is created with the luminance and saturation of the source image and the hue of the target image. |
1728| ARKUI_BLEND_MODE_SATURATION  | The resultant image is created with the luminance and hue of the target image and the saturation of the source image. |
1729| ARKUI_BLEND_MODE_COLOR  | The resultant image is created with the saturation and hue of the source image and the luminance of the target image. |
1730| ARKUI_BLEND_MODE_LUMINOSITY  | The resultant image is created with the saturation and hue of the target image and the luminance of the source image. |
1731
1732
1733### ArkUI_BlurStyle
1734
1735```
1736enum ArkUI_BlurStyle
1737```
1738**Description**
1739
1740Enumerates the blur styles.
1741
1742**Since**: 12
1743
1744| Enum| Description|
1745| -------- | -------- |
1746| ARKUI_BLUR_STYLE_THIN  | Thin material. |
1747| ARKUI_BLUR_STYLE_REGULAR  | Regular material. |
1748| ARKUI_BLUR_STYLE_THICK  | Thick material. |
1749| ARKUI_BLUR_STYLE_BACKGROUND_THIN  | Material that creates the minimum depth of field effect. |
1750| ARKUI_BLUR_STYLE_BACKGROUND_REGULAR  | Material that creates a medium shallow depth of field effect. |
1751| ARKUI_BLUR_STYLE_BACKGROUND_THICK  | Material that creates a high shallow depth of field effect. |
1752| ARKUI_BLUR_STYLE_BACKGROUND_ULTRA_THICK  | Material that creates the maximum depth of field effect. |
1753| ARKUI_BLUR_STYLE_NONE  | No blur. |
1754| ARKUI_BLUR_STYLE_COMPONENT_ULTRA_THIN  | Component ultra-thin material. |
1755| ARKUI_BLUR_STYLE_COMPONENT_THIN  | Component thin material. |
1756| ARKUI_BLUR_STYLE_COMPONENT_REGULAR  | Component regular material. |
1757| ARKUI_BLUR_STYLE_COMPONENT_THICK  | Component thick material. |
1758| ARKUI_BLUR_STYLE_COMPONENT_ULTRA_THICK  | Component ultra-thick material. |
1759
1760
1761### ArkUI_BorderStyle
1762
1763```
1764enum ArkUI_BorderStyle
1765```
1766**Description**
1767
1768Enumerates the border styles.
1769
1770**Since**: 12
1771
1772| Enum| Description|
1773| -------- | -------- |
1774| ARKUI_BORDER_STYLE_SOLID  | Solid border. |
1775| ARKUI_BORDER_STYLE_DASHED  | Dashed border. |
1776| ARKUI_BORDER_STYLE_DOTTED  | Dotted border. |
1777
1778
1779### ArkUI_ButtonType
1780
1781```
1782enum ArkUI_ButtonType
1783```
1784**Description**
1785
1786Enumerates the button types.
1787
1788**Since**: 12
1789
1790| Enum| Description|
1791| -------- | -------- |
1792| ARKUI_BUTTON_TYPE_NORMAL  | Normal button (without rounded corners by default). |
1793| ARKUI_BUTTON_TYPE_CAPSULE  | Capsule-type button (the round corner is half of the height by default). |
1794| ARKUI_BUTTON_TYPE_CIRCLE  | Circle button. |
1795
1796
1797### ArkUI_CalendarAlignment
1798
1799```
1800enum ArkUI_CalendarAlignment
1801```
1802**Description**
1803
1804Enumerates the alignment modes between the calendar picker and the entry component.
1805
1806**Since**: 12
1807
1808| Enum| Description|
1809| -------- | -------- |
1810| ARKUI_CALENDAR_ALIGNMENT_START  | Left aligned. |
1811| ARKUI_CALENDAR_ALIGNMENT_CENTER  | Center aligned. |
1812| ARKUI_CALENDAR_ALIGNMENT_END  | Right aligned. |
1813
1814
1815### ArkUI_CancelButtonStyle
1816
1817```
1818enum ArkUI_CancelButtonStyle
1819```
1820**Description**
1821
1822Enumerates the styles of the Cancel button.
1823
1824**Since**: 12
1825
1826| Enum| Description|
1827| -------- | -------- |
1828| ARKUI_CANCELBUTTON_STYLE_CONSTANT  | The Cancel button is always displayed. |
1829| ARKUI_CANCELBUTTON_STYLE_INVISIBLE  | The Cancel button is always hidden. |
1830| ARKUI_CANCELBUTTON_STYLE_INPUT  | The Cancel button is displayed when there is text input. |
1831
1832
1833### ArkUI_CheckboxShape
1834
1835```
1836enum ArkUI_CheckboxShape
1837```
1838**Description**
1839
1840Enumerates the shapes of the check box.
1841
1842**Since**: 12
1843
1844| Enum| Description|
1845| -------- | -------- |
1846| ArkUI_CHECKBOX_SHAPE_CIRCLE  | Circle. |
1847| ArkUI_CHECKBOX_SHAPE_ROUNDED_SQUARE  | Rounded square. |
1848
1849
1850### ArkUI_ClipType
1851
1852```
1853enum ArkUI_ClipType
1854```
1855**Description**
1856
1857Enumerates the clipping region types.
1858
1859**Since**: 12
1860
1861| Enum| Description|
1862| -------- | -------- |
1863| ARKUI_CLIP_TYPE_RECTANGLE  | Rectangle. |
1864| ARKUI_CLIP_TYPE_CIRCLE  | **(circle)** |
1865| ARKUI_CLIP_TYPE_ELLIPSE  | Ellipse. |
1866| ARKUI_CLIP_TYPE_PATH  | Path Type |
1867
1868
1869### ArkUI_ColorMode
1870
1871```
1872enum ArkUI_ColorMode
1873```
1874**Description**
1875
1876Enumerates the color modes.
1877
1878**Since**: 12
1879
1880| Enum| Description|
1881| -------- | -------- |
1882| ARKUI_COLOR_MODE_SYSTEM  | Following the system color mode. |
1883| ARKUI_COLOR_MODE_LIGHT  | Light color mode. |
1884| ARKUI_COLOR_MODE_DARK  | Dark color mode. |
1885
1886
1887### ArkUI_ColorStrategy
1888
1889```
1890enum ArkUI_ColorStrategy
1891```
1892**Description**
1893
1894Enumerates the foreground colors.
1895
1896**Since**: 12
1897
1898| Enum| Description|
1899| -------- | -------- |
1900| ARKUI_COLOR_STRATEGY_INVERT  | The foreground colors are the inverse of the component background colors. |
1901| ARKUI_COLOR_STRATEGY_AVERAGE  | The shadow colors of the component are the average color obtained from the component background shadow area. |
1902| ARKUI_COLOR_STRATEGY_PRIMARY  | The shadow colors of the component are the primary color obtained from the component background shadow area. |
1903
1904
1905### ArkUI_CopyOptions
1906
1907```
1908enum ArkUI_CopyOptions
1909```
1910**Description**
1911
1912Enumerates the text copy and paste modes.
1913
1914**Since**: 12
1915
1916| Enum| Description|
1917| -------- | -------- |
1918| ARKUI_COPY_OPTIONS_NONE  | Copy is not allowed. |
1919| ARKUI_COPY_OPTIONS_IN_APP  | Intra-application copy is allowed. |
1920| ARKUI_COPY_OPTIONS_LOCAL_DEVICE  | Intra-device copy is allowed. |
1921| ARKUI_COPY_OPTIONS_CROSS_DEVICE  | Cross-device copy is allowed. |
1922
1923
1924### ArkUI_Direction
1925
1926```
1927enum ArkUI_Direction
1928```
1929**Description**
1930
1931Enumerates the modes in which components are laid out along the main axis of the container.
1932
1933**Since**: 12
1934
1935| Enum| Description|
1936| -------- | -------- |
1937| ARKUI_DIRECTION_LTR  | Components are arranged from left to right. |
1938| ARKUI_DIRECTION_RTL  | Components are arranged from right to left. |
1939| ARKUI_DIRECTION_AUTO  | The default layout direction is used. |
1940
1941
1942### ArkUI_DismissReason
1943
1944```
1945enum ArkUI_DismissReason
1946```
1947**Description**
1948
1949Enumerates the actions for triggering closure of the dialog box.
1950
1951**Since**: 12
1952
1953| Enum| Description|
1954| -------- | -------- |
1955| DIALOG_DISMISS_BACK_PRESS  | Touching the system-defined Back button or pressing the Esc key. |
1956| DIALOG_DISMISS_TOUCH_OUTSIDE  | Touching the mask. |
1957| DIALOG_DISMISS_CLOSE_BUTTON  | Touching the Close button. |
1958| DIALOG_DISMISS_SLIDE_DOWN  | Sliding down. |
1959
1960
1961### ArkUI_DragPreviewScaleMode
1962
1963```
1964enum ArkUI_DragPreviewScaleMode
1965```
1966**Description**
1967
1968Defines an enum for drag preview scale modes.
1969
1970**Since**: 12
1971
1972| Enum| Description|
1973| -------- | -------- |
1974| ARKUI_DRAG_PREVIEW_SCALE_AUTO  | The system automatically changes the position of the dragged point based on the scenario and scales the drag preview based on set rules. |
1975| ARKUI_DRAG_PREVIEW_SCALE_DISABLED  | The system does not scale the drag preview. |
1976
1977
1978### ArkUI_DragResult
1979
1980```
1981enum ArkUI_DragResult
1982```
1983**Description**
1984
1985Defines an enum for drag results, which are set by the data receiver and transferred by the system to the drag source so that the drag source is aware of the data processing result of the receiver.
1986
1987**Since**: 12
1988
1989| Enum| Description|
1990| -------- | -------- |
1991| ARKUI_DRAG_RESULT_SUCCESSFUL  | The drag and drop operation succeeded. |
1992| ARKUI_DRAG_RESULT_FAILED  | The drag and drop operation failed. |
1993| ARKUI_DRAG_RESULT_CANCELED  | The drag and drop operation was canceled. |
1994
1995
1996### ArkUI_DragStatus
1997
1998```
1999enum ArkUI_DragStatus
2000```
2001**Description**
2002
2003Enumerates dragging states.
2004
2005**Since**: 12
2006
2007| Enum| Description|
2008| -------- | -------- |
2009| ArkUI_DRAG_STATUS_UNKNOWN  | Unknown. |
2010| ArkUI_DRAG_STATUS_STARTED  | Started. |
2011| ArkUI_DRAG_STATUS_ENDED  | Ended. |
2012
2013
2014### ArkUI_DropProposal
2015
2016```
2017enum ArkUI_DropProposal
2018```
2019**Description**
2020
2021Defines an enum for data processing modes used when data is dropped, which affects the display of the badge.
2022
2023**Since**: 12
2024
2025| Enum| Description|
2026| -------- | -------- |
2027| ARKUI_DROP_PROPOSAL_COPY  | Copy. |
2028| ARKUI_DROP_PROPOSAL_MOVE  | Cut. |
2029
2030
2031### ArkUI_EdgeEffect
2032
2033```
2034enum ArkUI_EdgeEffect
2035```
2036**Description**
2037
2038Enumerates the effects used at the edges of the component when the boundary of the scrollable content is reached.
2039
2040**Since**: 12
2041
2042| Enum| Description|
2043| -------- | -------- |
2044| ARKUI_EDGE_EFFECT_SPRING  | Spring effect. When at one of the edges, the component can move beyond the bounds through touches, and produces a bounce effect when the user releases their finger. |
2045| ARKUI_EDGE_EFFECT_FADE  | Fade effect. When at one of the edges, the component produces a fade effect. |
2046| ARKUI_EDGE_EFFECT_NONE  | No effect when the component is at one of the edges. |
2047
2048
2049### ArkUI_EllipsisMode
2050
2051```
2052enum ArkUI_EllipsisMode
2053```
2054**Description**
2055
2056Enumerates the ellipsis positions.
2057
2058**Since**: 12
2059
2060| Enum| Description|
2061| -------- | -------- |
2062| ARKUI_ELLIPSIS_MODE_START  | An ellipsis is used at the start of the line of text. |
2063| ARKUI_ELLIPSIS_MODE_CENTER  | An ellipsis is used at the center of the line of text. |
2064| ARKUI_ELLIPSIS_MODE_END  | An ellipsis is used at the end of the line of text. |
2065
2066
2067### ArkUI_EnterKeyType
2068
2069```
2070enum ArkUI_EnterKeyType
2071```
2072**Description**
2073
2074Enumerates the types of the Enter key for a single-line text box.
2075
2076**Since**: 12
2077
2078| Enum| Description|
2079| -------- | -------- |
2080| ARKUI_ENTER_KEY_TYPE_GO  | The Enter key is labeled "Go." |
2081| ARKUI_ENTER_KEY_TYPE_SEARCH  | The Enter key is labeled "Search." |
2082| ARKUI_ENTER_KEY_TYPE_SEND  | The Enter key is labeled "Send." |
2083| ARKUI_ENTER_KEY_TYPE_NEXT  | The Enter key is labeled "Next." |
2084| ARKUI_ENTER_KEY_TYPE_DONE  | The Enter key is labeled "Done." |
2085| ARKUI_ENTER_KEY_TYPE_PREVIOUS  | The Enter key is labeled "Previous." |
2086| ARKUI_ENTER_KEY_TYPE_NEW_LINE  | The Enter key is labeled "Return." |
2087
2088
2089### ArkUI_ErrorCode
2090
2091```
2092enum ArkUI_ErrorCode
2093```
2094**Description**
2095
2096Defines an enum for the error codes.
2097
2098**Since**: 12
2099
2100| Enum| Description|
2101| -------- | -------- |
2102| ARKUI_ERROR_CODE_NO_ERROR  | No error. |
2103| ARKUI_ERROR_CODE_PARAM_INVALID  | Parameter error. |
2104| ARKUI_ERROR_CODE_ATTRIBUTE_OR_EVENT_NOT_SUPPORTED  | The component does not support specific attributes or events. |
2105| ARKUI_ERROR_CODE_NOT_SUPPROTED_FOR_ARKTS_NODE  | The specific operation is not allowed on the node created by ArkTS. |
2106| ARKUI_ERROR_CODE_NODE_ADAPTER_NONE_HOST  | The adapter for lazy loading is not bound to the component. |
2107| ARKUI_ERROR_CODE_NODE_ADAPTER_EXIST_IN_HOST  | The adapter already exists. |
2108| ARKUI_ERROR_CODE_NODE_ADAPTER_CHILD_NODE_EXIST  | Failed to add the adapter because the corresponding node already has a subnode. |
2109| ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INDEX_OUT_OF_RANGE  | The parameter length in the parameter event exceeds the limit. |
2110| ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INVALID  | The data does not exist in the component event. |
2111| ARKUI_ERROR_CODE_NODE_EVENT_NO_RETURN  | The component event does not support return values. |
2112| ARKUI_ERROR_CODE_NODE_INDEX_INVALID  | Invalid index. |
2113| ARKUI_ERROR_CODE_GET_INFO_FAILED  | Failed to obtain the route navigation information. |
2114| ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR  | Buffer size error. |
2115| ARKUI_ERROR_CODE_NON_SCROLLABLE_CONTAINER  | The component is not a scrollable container. |
2116| ARKUI_ERROR_CODE_BUFFER_SIZE_NOT_ENOUGH  | The buffer is not large enough. |
2117| ARKUI_ERROR_CODE_INVALID_STYLED_STRING  | Invalid styled string. |
2118
2119
2120### ArkUI_FinishCallbackType
2121
2122```
2123enum ArkUI_FinishCallbackType
2124```
2125**Description**
2126
2127Enumerates the animation **onFinish** callback types.
2128
2129**Since**: 12
2130
2131| Enum| Description|
2132| -------- | -------- |
2133| ARKUI_FINISH_CALLBACK_REMOVED  | The callback is invoked when the entire animation is removed once it has finished. |
2134| ARKUI_FINISH_CALLBACK_LOGICALLY  | The callback is invoked when the animation logically enters the falling state, though it may still be in its long tail state. |
2135
2136
2137### ArkUI_FlexAlignment
2138
2139```
2140enum ArkUI_FlexAlignment
2141```
2142**Description**
2143
2144Enumerates the vertical alignment modes.
2145
2146**Since**: 12
2147
2148| Enum| Description|
2149| -------- | -------- |
2150| ARKUI_FLEX_ALIGNMENT_START  | The child components are aligned with the start edge of the main axis. |
2151| ARKUI_FLEX_ALIGNMENT_CENTER  | The child components are aligned in the center of the main axis. |
2152| ARKUI_FLEX_ALIGNMENT_END  | The child components are aligned with the end edge of the main axis. |
2153| ARKUI_FLEX_ALIGNMENT_SPACE_BETWEEN  | The child components are evenly distributed along the main axis. The space between any two adjacent components is the same. The first component is aligned with the main-start, and the last component is aligned with the main-end. |
2154| ARKUI_FLEX_ALIGNMENT_SPACE_AROUND  | The child components are evenly distributed along the main axis. The space between any two adjacent components is the same. The space between the first component and main-start, and that between the last component and cross-main are both half the size of the space between two adjacent components. |
2155| ARKUI_FLEX_ALIGNMENT_SPACE_EVENLY  | The child components are evenly distributed along the main axis. The space between the first component and main-start, the space between the last component and main-end, and the space between any two adjacent components are the same. |
2156
2157
2158### ArkUI_FlexDirection
2159
2160```
2161enum ArkUI_FlexDirection
2162```
2163**Description**
2164
2165Enumerates the directions of the main axis in the flex container.
2166
2167**Since**: 12
2168
2169| Enum| Description|
2170| -------- | -------- |
2171| ARKUI_FLEX_DIRECTION_ROW  | The child components are arranged in the same direction as the main axis runs along the rows. |
2172| ARKUI_FLEX_DIRECTION_COLUMN  | The child components are arranged in the same direction as the main axis runs down the columns. |
2173| ARKUI_FLEX_DIRECTION_ROW_REVERSE  | The child components are arranged opposite to the **ROW** direction. |
2174| ARKUI_FLEX_DIRECTION_COLUMN_REVERSE  | The child components are arranged opposite to the **COLUMN** direction. |
2175
2176
2177### ArkUI_FlexWrap
2178
2179```
2180enum ArkUI_FlexWrap
2181```
2182**Description**
2183
2184Defines whether the flex container has a single line or multiple lines.
2185
2186**Since**: 12
2187
2188| Enum| Description|
2189| -------- | -------- |
2190| ARKUI_FLEX_WRAP_NO_WRAP  | The child components in the flex container are arranged in a single line, and they cannot overflow. |
2191| ARKUI_FLEX_WRAP_WRAP  | The child components in the flex container are arranged in multiple lines, and they may overflow. |
2192| ARKUI_FLEX_WRAP_WRAP_REVERSE  | The child components in the flex container are reversely arranged in multiple lines, and they may overflow. |
2193
2194
2195### ArkUI_FontStyle
2196
2197```
2198enum ArkUI_FontStyle
2199```
2200**Description**
2201
2202Enumerates the font styles.
2203
2204**Since**: 12
2205
2206| Enum| Description|
2207| -------- | -------- |
2208| ARKUI_FONT_STYLE_NORMAL  | Standard font style. |
2209| ARKUI_FONT_STYLE_ITALIC  | Italic font style. |
2210
2211
2212### ArkUI_FontWeight
2213
2214```
2215enum ArkUI_FontWeight
2216```
2217**Description**
2218
2219Enumerates the font weights.
2220
2221**Since**: 12
2222
2223| Enum| Description|
2224| -------- | -------- |
2225| ARKUI_FONT_WEIGHT_W100  | 100  |
2226| ARKUI_FONT_WEIGHT_W200  | 200  |
2227| ARKUI_FONT_WEIGHT_W300  | 300  |
2228| ARKUI_FONT_WEIGHT_W400  | 400  |
2229| ARKUI_FONT_WEIGHT_W500  | 500  |
2230| ARKUI_FONT_WEIGHT_W600  | 600  |
2231| ARKUI_FONT_WEIGHT_W700  | 700  |
2232| ARKUI_FONT_WEIGHT_W800  | 800  |
2233| ARKUI_FONT_WEIGHT_W900  | 900  |
2234| ARKUI_FONT_WEIGHT_BOLD  | The font weight is bold. |
2235| ARKUI_FONT_WEIGHT_NORMAL  | The font weight is normal. |
2236| ARKUI_FONT_WEIGHT_BOLDER  | The font weight is bolder. |
2237| ARKUI_FONT_WEIGHT_LIGHTER  | The font weight is lighter. |
2238| ARKUI_FONT_WEIGHT_MEDIUM  | The font weight is medium. |
2239| ARKUI_FONT_WEIGHT_REGULAR  | The font weight is normal. |
2240
2241### ArkUI_GestureDirection
2242
2243```
2244enum ArkUI_GestureDirection
2245```
2246**Description**
2247
2248Enumerates gesture directions.
2249
2250**Since**: 12
2251
2252| Enum| Description|
2253| -------- | -------- |
2254| GESTURE_DIRECTION_ALL  | All directions. |
2255| GESTURE_DIRECTION_HORIZONTAL  | Horizontal direction. |
2256| GESTURE_DIRECTION_VERTICAL  | Vertical direction. |
2257| GESTURE_DIRECTION_LEFT  | Leftward. |
2258| GESTURE_DIRECTION_RIGHT  | Rightward. |
2259| GESTURE_DIRECTION_UP  | Upward. |
2260| GESTURE_DIRECTION_DOWN  | Downward. |
2261| GESTURE_DIRECTION_NONE  | None. |
2262
2263
2264### ArkUI_GestureEventActionType
2265
2266```
2267enum ArkUI_GestureEventActionType
2268```
2269**Description**
2270
2271Enumerates gesture event types.
2272
2273**Since**: 12
2274
2275| Enum| Description|
2276| -------- | -------- |
2277| GESTURE_EVENT_ACTION_ACCEPT  | Triggered. |
2278| GESTURE_EVENT_ACTION_UPDATE  | Updated. |
2279| GESTURE_EVENT_ACTION_END  | Ended. |
2280| GESTURE_EVENT_ACTION_CANCEL  | Canceled. |
2281
2282
2283### ArkUI_GestureInterruptResult
2284
2285```
2286enum ArkUI_GestureInterruptResult
2287```
2288**Description**
2289
2290Enumerates gesture interruption results.
2291
2292**Since**: 12
2293
2294| Enum| Description|
2295| -------- | -------- |
2296| GESTURE_INTERRUPT_RESULT_CONTINUE  | The gesture recognition process continues. |
2297| GESTURE_INTERRUPT_RESULT_REJECT  | The gesture recognition process is paused. |
2298
2299
2300### ArkUI_GestureMask
2301
2302```
2303enum ArkUI_GestureMask
2304```
2305**Description**
2306
2307Enumerates gesture masking modes.
2308
2309**Since**: 12
2310
2311| Enum| Description|
2312| -------- | -------- |
2313| NORMAL_GESTURE_MASK  | The gestures of child components are enabled and recognized based on the default gesture recognition sequence. |
2314| IGNORE_INTERNAL_GESTURE_MASK  | The gestures of child components are disabled, including the built-in gestures. |
2315
2316
2317### ArkUI_GesturePriority
2318
2319```
2320enum ArkUI_GesturePriority
2321```
2322**Description**
2323
2324Enumerates gesture event modes.
2325
2326**Since**: 12
2327
2328| Enum| Description|
2329| -------- | -------- |
2330| NORMAL  | Normal. |
2331| PRIORITY  | High-priority. |
2332| PARALLEL  | Parallel. |
2333
2334
2335### ArkUI_GestureRecognizerState
2336
2337```
2338enum ArkUI_GestureRecognizerState
2339```
2340**Description**
2341
2342Enumerates the gesture recognizer states.
2343
2344**Since**: 12
2345
2346| Enum| Description|
2347| -------- | -------- |
2348| ARKUI_GESTURE_RECOGNIZER_STATE_REDAY  | Prepared. |
2349| ARKUI_GESTURE_RECOGNIZER_STATE_DETECTING  | Check status. |
2350| ARKUI_GESTURE_RECOGNIZER_STATE_PENDING  | Waiting |
2351| ARKUI_GESTURE_RECOGNIZER_STATE_BLOCKED  | Blocked. |
2352| ARKUI_GESTURE_RECOGNIZER_STATE_SUCCESSFUL  | (Success status) |
2353| ARKUI_GESTURE_RECOGNIZER_STATE_FAILED  | Failed. |
2354
2355
2356### ArkUI_GestureRecognizerType
2357
2358```
2359enum ArkUI_GestureRecognizerType
2360```
2361**Description**
2362
2363Enumerates gesture recognizer types.
2364
2365**Since**: 12
2366
2367| Enum| Description|
2368| -------- | -------- |
2369| TAP_GESTURE  | Tap. |
2370| LONG_PRESS_GESTURE  | Long press gesture. |
2371| PAN_GESTURE  | Pan gesture. |
2372| PINCH_GESTURE  | Pinch gesture. |
2373| ROTATION_GESTURE  | Rotation gesture. |
2374| SWIPE_GESTURE  | Swipe gesture. |
2375| GROUP_GESTURE  | A group of gestures. |
2376
2377
2378### ArkUI_GroupGestureMode
2379
2380```
2381enum ArkUI_GroupGestureMode
2382```
2383**Description**
2384
2385Enumerates gesture group modes.
2386
2387**Since**: 12
2388
2389| Enum| Description|
2390| -------- | -------- |
2391| SEQUENTIAL_GROUP  | Sequential recognition. Gestures are recognized in the registration sequence until all gestures are recognized successfully. Once one gesture fails to be recognized, all subsequent gestures fail to be recognized. Only the last gesture in the gesture group can respond to the end event. |
2392| PARALLEL_GROUP  | Parallel recognition. Registered gestures are recognized concurrently until all gestures are recognized. The recognition result of each gesture does not affect each other. |
2393| EXCLUSIVE_GROUP  | Exclusive recognition. Registered gestures are identified concurrently. If one gesture is successfully recognized, gesture recognition ends. |
2394
2395
2396### ArkUI_HitTestMode
2397
2398```
2399enum ArkUI_HitTestMode
2400```
2401**Description**
2402
2403Enumerates the hit test modes.
2404
2405**Since**: 12
2406
2407| Enum| Description|
2408| -------- | -------- |
2409| ARKUI_HIT_TEST_MODE_DEFAULT  | Both the node and its child node respond to the hit test of a touch event, but its sibling node is blocked from the hit test. |
2410| ARKUI_HIT_TEST_MODE_BLOCK  | The node responds to the hit test of a touch event, but its child node and sibling node are blocked from the hit test. |
2411| ARKUI_HIT_TEST_MODE_TRANSPARENT  | Both the node and its child node respond to the hit test of a touch event, and its sibling node is also considered during the hit test. |
2412| ARKUI_HIT_TEST_MODE_NONE  | The node does not respond to the hit test of a touch event. |
2413
2414
2415### ArkUI_HorizontalAlignment
2416
2417```
2418enum ArkUI_HorizontalAlignment
2419```
2420**Description**
2421
2422Enumerates the alignment mode in the horizontal direction.
2423
2424**Since**: 12
2425
2426| Enum| Description|
2427| -------- | -------- |
2428| ARKUI_HORIZONTAL_ALIGNMENT_START  | Aligned with the start edge in the same direction as the language in use. |
2429| ARKUI_HORIZONTAL_ALIGNMENT_CENTER  | Aligned with the center. This is the default alignment mode. |
2430| ARKUI_HORIZONTAL_ALIGNMENT_END  | Aligned with the end edge in the same direction as the language in use. |
2431
2432
2433### ArkUI_ImageInterpolation
2434
2435```
2436enum ArkUI_ImageInterpolation
2437```
2438**Description**
2439
2440Enumerates the image interpolation effects.
2441
2442**Since**: 12
2443
2444| Enum| Description|
2445| -------- | -------- |
2446| ARKUI_IMAGE_INTERPOLATION_NONE  | No image interpolation. |
2447| ARKUI_IMAGE_INTERPOLATION_LOW  | Low quality interpolation. |
2448| ARKUI_IMAGE_INTERPOLATION_MEDIUM  | Medium quality interpolation. |
2449| ARKUI_IMAGE_INTERPOLATION_HIGH  | High quality interpolation. This mode produces scaled images of the highest possible quality. |
2450
2451
2452### ArkUI_ImageRenderMode
2453
2454```
2455enum ArkUI_ImageRenderMode
2456```
2457**Description**
2458
2459Enumerates the image rendering modes.
2460
2461**Since**: 12
2462
2463| Enum| Description|
2464| -------- | -------- |
2465| ARKUI_IMAGE_RENDER_MODE_ORIGINAL  | Render image pixels as they are in the original source image. |
2466| ARKUI_IMAGE_RENDER_MODE_TEMPLATE  | Render image pixels to create a monochrome template image. |
2467
2468
2469### ArkUI_ImageRepeat
2470
2471```
2472enum ArkUI_ImageRepeat
2473```
2474**Description**
2475
2476Enumerates the image repeat patterns.
2477
2478**Since**: 12
2479
2480| Enum| Description|
2481| -------- | -------- |
2482| ARKUI_IMAGE_REPEAT_NONE  | The image is not repeatedly drawn. |
2483| ARKUI_IMAGE_REPEAT_X  | The image is repeatedly drawn only along the x-axis. |
2484| ARKUI_IMAGE_REPEAT_Y  | The image is repeatedly drawn only along the y-axis. |
2485| ARKUI_IMAGE_REPEAT_XY  | The image is repeatedly drawn along both axes. |
2486
2487
2488### ArkUI_ImageSize
2489
2490```
2491enum ArkUI_ImageSize
2492```
2493**Description**
2494
2495Defines the image size.
2496
2497**Since**: 12
2498
2499| Enum| Description|
2500| -------- | -------- |
2501| ARKUI_IMAGE_SIZE_AUTO  | The original image aspect ratio is retained. |
2502| ARKUI_IMAGE_SIZE_COVER  | Default value. The image is scaled with its aspect ratio retained for both sides to be greater than or equal to the display boundaries. |
2503| ARKUI_IMAGE_SIZE_CONTAIN  | The image is scaled with its aspect ratio retained for the content to be completely displayed within the display boundaries. |
2504
2505
2506### ArkUI_ImageSpanAlignment
2507
2508```
2509enum ArkUI_ImageSpanAlignment
2510```
2511**Description**
2512
2513Enumerates the alignment mode of the image with the text.
2514
2515**Since**: 12
2516
2517| Enum| Description|
2518| -------- | -------- |
2519| ARKUI_IMAGE_SPAN_ALIGNMENT_BASELINE  | The image is bottom aligned with the text baseline. |
2520| ARKUI_IMAGE_SPAN_ALIGNMENT_BOTTOM  | The image is bottom aligned with the text. |
2521| ARKUI_IMAGE_SPAN_ALIGNMENT_CENTER  | The image is centered aligned with the text. |
2522| ARKUI_IMAGE_SPAN_ALIGNMENT_TOP  | The image is top aligned with the text. |
2523
2524
2525### ArkUI_ItemAlignment
2526
2527```
2528enum ArkUI_ItemAlignment
2529```
2530**Description**
2531
2532Enumerates the modes in which components are laid out along the cross axis of the container.
2533
2534**Since**: 12
2535
2536| Enum| Description|
2537| -------- | -------- |
2538| ARKUI_ITEM_ALIGNMENT_AUTO  | The default configuration of the flex container is used. |
2539| ARKUI_ITEM_ALIGNMENT_START  | The items in the flex container are aligned with the cross-start edge. |
2540| ARKUI_ITEM_ALIGNMENT_CENTER  | The items in the flex container are centered along the cross axis. |
2541| ARKUI_ITEM_ALIGNMENT_END  | The items in the flex container are aligned with the cross-end edge. |
2542| ARKUI_ITEM_ALIGNMENT_STRETCH  | The items in the flex container are stretched and padded along the cross axis. |
2543| ARKUI_ITEM_ALIGNMENT_BASELINE  | The items in the flex container are aligned in such a manner that their text baselines are aligned along the cross axis. |
2544
2545
2546### ArkUI_LengthMetricUnit
2547
2548```
2549enum ArkUI_LengthMetricUnit
2550```
2551**Description**
2552
2553Enumerates the component units.
2554
2555**Since**: 12
2556
2557| Enum| Description|
2558| -------- | -------- |
2559| ARKUI_LENGTH_METRIC_UNIT_DEFAULT  | Default, which is fp for fonts and vp for non-fonts. |
2560| ARKUI_LENGTH_METRIC_UNIT_PX  | px. |
2561| ARKUI_LENGTH_METRIC_UNIT_VP  | vp. |
2562| ARKUI_LENGTH_METRIC_UNIT_FP  | fp. |
2563
2564
2565### ArkUI_LinearGradientDirection
2566
2567```
2568enum ArkUI_LinearGradientDirection
2569```
2570**Description**
2571
2572Enumerates the gradient directions.
2573
2574**Since**: 12
2575
2576| Enum| Description|
2577| -------- | -------- |
2578| ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT  | From right to left. |
2579| ARKUI_LINEAR_GRADIENT_DIRECTION_TOP  | From bottom to top. |
2580| ARKUI_LINEAR_GRADIENT_DIRECTION_RIGHT  | From left to right. |
2581| ARKUI_LINEAR_GRADIENT_DIRECTION_BOTTOM  | From top to bottom. |
2582| ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT_TOP  | From lower right to upper left. |
2583| ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT_BOTTOM  | From upper right to lower left. |
2584| ARKUI_LINEAR_GRADIENT_DIRECTION_RIGHT_TOP  | From lower left to upper right. |
2585| ARKUI_LINEAR_GRADIENT_DIRECTION_RIGHT_BOTTOM  | From upper left to lower right. |
2586| ARKUI_LINEAR_GRADIENT_DIRECTION_NONE  | No gradient. |
2587| ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM  | Custom direction. |
2588
2589
2590### ArkUI_ListItemAlignment
2591
2592```
2593enum ArkUI_ListItemAlignment
2594```
2595**Description**
2596
2597Enumerates the alignment modes of items along the cross axis.
2598
2599**Since**: 12
2600
2601| Enum| Description|
2602| -------- | -------- |
2603| ARKUI_LIST_ITEM_ALIGNMENT_START  | The list items are packed toward the start edge of the **List** component along the cross axis. |
2604| ARKUI_LIST_ITEM_ALIGNMENT_CENTER  | The list items are centered in the **List** component along the cross axis. |
2605| ARKUI_LIST_ITEM_ALIGNMENT_END  | The list items are packed toward the end edge of the **List** component along the cross axis. |
2606
2607
2608### ArkUI_ListItemSwipeActionState
2609
2610```
2611enum ArkUI_ListItemSwipeActionState
2612```
2613**Description**
2614
2615Enumerates the swipe action item states of list items.
2616
2617**Since**: 12
2618
2619| Enum| Description|
2620| -------- | -------- |
2621| ARKUI_LIST_ITEM_SWIPE_ACTION_STATE_COLLAPSED  | Collapsed state. When the list item is swiped in the opposite direction of the main axis, the swipe action item is hidden. |
2622| ARKUI_LIST_ITEM_SWIPE_ACTION_STATE_EXPANDED  | Expanded state. When the list item is swiped in the opposite direction of the main axis, the swipe action item is shown. |
2623| ARKUI_LIST_ITEM_SWIPE_ACTION_STATE_ACTIONING  | In-action state. The list item is in this state when it enters the delete area. |
2624
2625
2626### ArkUI_ListItemSwipeEdgeEffect
2627
2628```
2629enum ArkUI_ListItemSwipeEdgeEffect
2630```
2631**Description**
2632
2633Enumerates the swipe action item edge effects of list items.
2634
2635**Since**: 12
2636
2637| Enum| Description|
2638| -------- | -------- |
2639| ARKUI_LIST_ITEM_SWIPE_EDGE_EFFECT_SPRING  | When the list item scrolls to the edge of the list, it can continue to scroll for a distance. |
2640| ARKUI_LIST_ITEM_SWIPE_EDGE_EFFECT_NONE  | The list item cannot scroll beyond the edge of the list. |
2641
2642
2643### ArkUI_MaskType
2644
2645```
2646enum ArkUI_MaskType
2647```
2648**Description**
2649
2650Enumerates the mask types.
2651
2652**Since**: 12
2653
2654| Enum| Description|
2655| -------- | -------- |
2656| ARKUI_MASK_TYPE_RECTANGLE  | Rectangle. |
2657| ARKUI_MASK_TYPE_CIRCLE  | **(circle)** |
2658| ARKUI_MASK_TYPE_ELLIPSE  | Ellipse. |
2659| ARKUI_MASK_TYPE_PATH  | Path Type |
2660| ARKUI_MASK_TYPE_PROGRESS  | Progress indicator. |
2661
2662
2663### ArkUI_NativeAPIVariantKind
2664
2665```
2666enum ArkUI_NativeAPIVariantKind
2667```
2668**Description**
2669
2670Defines the native API types.
2671
2672**Since**: 12
2673
2674| Enum| Description|
2675| -------- | -------- |
2676| ARKUI_NATIVE_NODE  | API related to UI components. For details, see the struct definition in &lt;arkui/native_node.h&gt;. |
2677| ARKUI_NATIVE_DIALOG  | API related to dialog boxes. For details, see the struct definition in &lt;arkui/native_node.h&gt;. |
2678| ARKUI_NATIVE_GESTURE  | API related to gestures. For details, see the struct definition in &lt;arkui/native_node.h&gt;. |
2679| ARKUI_NATIVE_ANIMATE  | API related to animations. For details, see the struct definition in &lt;arkui/native_animate.h&gt;. |
2680
2681
2682### ArkUI_NavDestinationState
2683
2684```
2685enum ArkUI_NavDestinationState
2686```
2687**Description**
2688
2689Defines an enum for the **NavDestination** component states.
2690
2691**Since**: 12
2692
2693| Enum| Description|
2694| -------- | -------- |
2695| ARKUI_NAV_DESTINATION_STATE_ON_SHOW  | The **NavDestination** component is displayed. |
2696| ARKUI_NAV_DESTINATION_STATE_ON_HIDE  | The **NavDestination** component is hidden. |
2697| ARKUI_NAV_DESTINATION_STATE_ON_APPEAR  | The **NavDestination** component is mounted to the component tree. |
2698| ARKUI_NAV_DESTINATION_STATE_ON_DISAPPEAR  | The **NavDestination** component is unmounted from the component tree. |
2699| ARKUI_NAV_DESTINATION_STATE_ON_WILL_SHOW  | The **NavDestination** is about to be displayed. |
2700| ARKUI_NAV_DESTINATION_STATE_ON_WILL_HIDE  | The **NavDestination** is about to be hidden. |
2701| ARKUI_NAV_DESTINATION_STATE_ON_WILL_APPEAR  | The **NavDestination** is about to be mounted to the component tree. |
2702| ARKUI_NAV_DESTINATION_STATE_ON_WILL_DISAPPEAR  | The **NavDestination** component is about to be unmounted from the component tree. |
2703| ARKUI_NAV_DESTINATION_STATE_ON_BACK_PRESS  | The back button is pressed for the **NavDestination** component. |
2704
2705
2706### ArkUI_NodeAdapterEventType
2707
2708```
2709enum ArkUI_NodeAdapterEventType
2710```
2711**Description**
2712
2713Enumerates node adapter events.
2714
2715**Since**: 12
2716
2717| Enum| Description|
2718| -------- | -------- |
2719| NODE_ADAPTER_EVENT_WILL_ATTACH_TO_NODE  | This event occurs when the component is attached to the adapter. |
2720| NODE_ADAPTER_EVENT_WILL_DETACH_FROM_NODE  | This event occurs when the component is detached from the adapter. |
2721| NODE_ADAPTER_EVENT_ON_GET_NODE_ID  | This event occurs when the adapter obtains the unique ID of the new element to add. |
2722| NODE_ADAPTER_EVENT_ON_ADD_NODE_TO_ADAPTER  | This event occurs when the adapter obtains the content of the new element to add. |
2723| NODE_ADAPTER_EVENT_ON_REMOVE_NODE_FROM_ADAPTER  | This event occurs when the adapter removes an element. |
2724
2725
2726### ArkUI_NodeAttributeType
2727
2728```
2729enum ArkUI_NodeAttributeType
2730```
2731**Description**
2732
2733Defines the ArkUI style attributes that can be set on the native side.
2734
2735**Since**: 12
2736
2737| Enum                                     | Description                                                        |
2738| ------------------------------------------- | ------------------------------------------------------------ |
2739| NODE_WIDTH                                  | Defines the width attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: width, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: width, in vp.|
2740| NODE_HEIGHT                                 | Defines the height attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: height, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: height, in vp.|
2741| NODE_BACKGROUND_COLOR                       | Defines the background color attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: background color, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: background color, in 0xARGB format. For example, 0xFFFF0000 indicates red.|
2742| NODE_BACKGROUND_IMAGE                       | Defines the background image attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: image address.<br>.value[0]?.i32: whether to repeat the image. Optional. The parameter type is [ArkUI_ImageRepeat](#arkui_imagerepeat). The default value is **ARKUI_IMAGE_REPEAT_NONE**.<br>.object: **PixelMap** object. The parameter type is [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: image address.<br>.value[0].i32: whether to repeat the image. The parameter type is [ArkUI_ImageRepeat](#arkui_imagerepeat).<br>.object: **PixelMap** object. The parameter type is [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor). Either **.object** or **.string** must be set.|
2743| NODE_PADDING                                | Defines the padding attribute, which can be set, reset, and obtained as required through APIs.<br>There are two formats of [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) for setting the attribute value:<br>1: Specify the same padding for the four directions.<br>.value[0].f32: padding, in vp.<br>2: Specify different paddings for different directions.<br>.value[0].f32: top padding, in vp.<br>.value[1].f32: right padding, in vp.<br>.value[2].f32: bottom padding, in vp.<br>.value[3].f32: left padding, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: top padding, in vp.<br>.value[1].f32: right padding, in vp.<br>.value[2].f32: bottom padding, in vp.<br>.value[3].f32: left padding, in vp.|
2744| NODE_ID                                     | Defines the component ID attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: component ID.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: component ID.|
2745| NODE_ENABLED                                | Defines the interactivity attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: The value **true** means that the component can interact with users, and **false** means the opposite.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: The value **1** means that the component can interact with users, and **0** means the opposite. |
2746| NODE_MARGIN                                 | Defines the margin attribute, which can be set, reset, and obtained as required through APIs.<br>There are two formats of [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) for setting the attribute value:<br>1: Specify the same margin for the four directions.<br>.value[0].f32: margin, in vp.<br>2: Specify different margins for different directions.<br>.value[0].f32: top margin, in vp.<br>.value[1].f32: right margin, in vp.<br>.value[2].f32: bottom margin, in vp.<br>.value[3].f32: left margin, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: top margin, in vp.<br>.value[1].f32: right margin, in vp.<br>.value[2].f32: bottom margin, in vp.<br>.value[3].f32: left margin, in vp.|
2747| NODE_TRANSLATE                              | Defines the translate attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: distance to translate along the x-axis, in vp. The default value is **0**.<br>.value[1].f32: distance to translate along the y-axis, in vp. The default value is **0**.<br>.value[2].f32: distance to translate along the z-axis, in vp. The default value is **0**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: distance to translate along the x-axis, in vp.<br>.value[1].f32: distance to translate along the y-axis, in vp.<br>.value[2].f32: distance to translate along the z-axis, in vp.|
2748| NODE_SCALE                                  | Defines the scale attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: scale factor along the x-axis. The default value is **1**.<br>.value[1].f32: scale factor along the y-axis. The default value is **1**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: scale factor along the x-axis.<br>.value[1].f32: scale factor along the y-axis.|
2749| NODE_ROTATE                                 | Defines the rotate attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: X-coordinate of the rotation axis vector. The default value is **0**.<br>.value[1].f32: Y-coordinate of the rotation axis vector. The default value is **0**.<br>.value[2].f32: Z-coordinate of the rotation axis vector. The default value is **0**.<br>.value[3].f32: rotation angle. The default value is **0**.<br>.value[4].f32: line of sight, that is, the distance from the viewpoint to the z=0 plane, in vp. The default value is **0**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: X-coordinate of the rotation axis vector.<br>.value[1].f32: Y-coordinate of the rotation axis vector.<br>.value[2].f32: Z-coordinate of the rotation axis vector.<br>.value[3].f32: rotation angle.<br>.value[4].f32: line of sight, that is, the distance from the viewpoint to the z=0 plane, in vp.|
2750| NODE_BRIGHTNESS                             | Sets the brightness attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: brightness value. The default value is **1.0**, and the recommended value range is [0, 2].<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: brightness value.|
2751| NODE_SATURATION                             | Sets the saturation attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: saturation value. The default value is **1.0**, and the recommended value range is [0, 50).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: saturation value.|
2752| NODE_BLUR                                   | Sets the blur attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: blur radius. The larger the fuzzy radius, the more blurred the image. If the value is **0**, the image is not blurred. The unit is px. The default value is **0.0**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: blur radius. The larger the fuzzy radius, the more blurred the image. If the value is **0**, the image is not blurred. The unit is px.|
2753| NODE_LINEAR_GRADIENT                        | Sets the gradient attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: start angle of the linear gradient. This attribute takes effect only when [ArkUI_LinearGradientDirection](#arkui_lineargradientdirection) is set to **ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM**. A positive value indicates a clockwise rotation from the origin, (0, 0). The default value is **180**.<br>.value[1].i32: direction of the linear gradient. When it is set, the **angle** attribute does not take effect. The data type is [ArkUI_LinearGradientDirection](#arkui_lineargradientdirection)<br>.value[2].i32: whether the colors are repeated. The default value is **false**.<br>.object: The parameter type is [ArkUI_ColorStop](_ark_u_i___color_stop.md). - **colors**: array of color stops, each of which consists of a color and its stop position. Invalid colors are automatically skipped.<br>**colors**: colors of the color stops.<br>**stops**: stop positions of the color stops.<br>**size**: number of colors.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: start angle of the linear gradient. The set value is used only when **ArkUI_LinearGradientDirection** is set to **ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM**. In other cases, the default value is used.<br>.value[1].i32: direction of the linear gradient.<br>.value[2].i32: whether the colors are repeated.<br>.object: array of color stops, each of which consists of a color and its stop position. Invalid colors are automatically skipped. The parameter type is [ArkUI_ColorStop](_ark_u_i___color_stop.md).<br>**colors**: colors of the color stops.<br>**stops**: stop positions of the color stops.<br>**size**: number of colors.|
2754| NODE_ALIGNMENT                              | Sets the alignment attribute, which can be set, reset, and obtained as required through APIs.<br>In the **Stack** component, this attribute has the same effect as **NODE_STACK_ALIGN_CONTENT**, which means that it sets the alignment mode of child components in the container.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: alignment mode. The parameter type is [ArkUI_Alignment](#arkui_alignment). The default value is **ARKUI_ALIGNMENT_CENTER**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: alignment mode. The parameter type is [ArkUI_Alignment](#arkui_alignment).|
2755| NODE_OPACITY                                | Defines the opacity attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: opacity value. The value ranges from 0 to 1.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: opacity value. The value ranges from 0 to 1.|
2756| NODE_BORDER_WIDTH                           | Defines the border width attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>1: .value[0].f32: width of the four borders.<br>2: .value[0].f32: width of the top border.<br>.value[1].f32: width of the right border.<br>.value[2].f32: width of the bottom border.<br>.value[3].f32: width of the left border.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: width of the top border.<br>.value[1].f32: width of the right border.<br>.value[2].f32: width of the bottom border.<br>.value[3].f32: width of the left border.|
2757| NODE_BORDER_RADIUS                          | Defines the border corner radius attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>1: .value[0].f32: radius of the four corners.<br>2: .value[0].f32: radius of the upper left corner.<br>.value[1].f32: radius of the upper right corner.<br>.value[2].f32: radius of the lower left corner.<br>.value[3].f32: radius of the lower right corner.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: radius of the upper left corner.<br>.value[1].f32: radius of the upper right corner.<br>.value[2].f32: radius of the lower left corner.<br>.value[3].f32: radius of the lower right corner.|
2758| NODE_BORDER_COLOR                           | Defines the border color attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>1: .value[0].u32: color of the four borders, in 0xARGB format, for example, **0xFFFF11FF**.<br>2: .value[0].u32: color of the top border, in 0xARGB format, for example, **0xFFFF11FF**.<br>.value[1].u32: color of the right border, in 0xARGB format, for example, **0xFFFF11FF**.<br>.value[2].u32: color of the lower border, in 0xARGB format, for example, **0xFFFF11FF**.<br>.value[3].u32: color of the left border, in 0xARGB format, for example, **0xFFFF11FF**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color of the top border, in 0xARGB format, for example, **0xFFFF11FF**.<br>.value[1].u32: color of the right border, in 0xARGB format, for example, **0xFFFF11FF**.<br>.value[2].u32: color of the lower border, in 0xARGB format, for example, **0xFFFF11FF**.<br>.value[3].u32: color of the left border, in 0xARGB format, for example, **0xFFFF11FF**.|
2759| NODE_BORDER_STYLE                           | Defines the border line style attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>1: .value[0].i32: line style of the four borders. The parameter type is [ArkUI_BorderStyle](#arkui_borderstyle). The default value is **ARKUI_BORDER_STYLE_SOLID**.<br>2: .value[0].i32: line style of the top border. The parameter type is **ArkUI_BorderStyle**. The default value is **ARKUI_BORDER_STYLE_SOLID**.<br>.value[1].i32: line style of the right border. The parameter type is [ArkUI_BorderStyle](#arkui_borderstyle). The default value is **ARKUI_BORDER_STYLE_SOLID**.<br>.value[2].i32: line style of the bottom border. The parameter type is [ArkUI_BorderStyle](#arkui_borderstyle). The default value is **ARKUI_BORDER_STYLE_SOLID**.<br>.value[3].i32: line style of the left border. The parameter type is [ArkUI_BorderStyle](#arkui_borderstyle). The default value is **ARKUI_BORDER_STYLE_SOLID**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: line style of the top border.<br>.value[1].i32: line style of the right border.<br>.value[2].i32: line style of the bottom border.<br>.value[3].i32: line style of the left border.|
2760| NODE_Z_INDEX                                | Defines the z-index attribute for the stack sequence. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: z-index value.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: z-index value.|
2761| NODE_VISIBILITY                             | Defines the visibility attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to show or hide the component. The parameter type is [ArkUI_Visibility](#arkui_visibility). The default value is **ARKUI_VISIBILITY_VISIBLE**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to show or hide the component. The parameter type is [ArkUI_Visibility](#arkui_visibility). The default value is **ARKUI_VISIBILITY_VISIBLE**.|
2762| NODE_CLIP                                   | Defines the clip attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to clip the component based on the parent container bounds. The value **0** means to clip the component, and **1** means the opposite.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to clip the component based on the parent container bounds. The value **0** means to clip the component, and **1** means the opposite.|
2763| NODE_CLIP_SHAPE                             | Defines the clipping region on the component. This attribute can be set and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute, which supports five types of shapes:<br>1. Rectangle:<br>.value[0].i32: type of shape. The parameter type is [ArkUI_ClipType](#arkui_cliptype). The value is **ARKUI_CLIP_TYPE_RECTANGLE** for the rectangle shape.<br>.value[1].f32: width of the rectangle.<br>.value[2].f32: height of the rectangle.<br>.value[3].f32: width of the rounded corner of the rectangle.<br>.value[4].f32: height of the rounded corner of the rectangle.<br>.value[5]?.f32: radius of the upper left corner of the rectangle. <br>.value[6]?.f32: radius of the lower left corner of the rectangle. <br>.value[7]?.f32: radius of the upper right corner of the rectangle. <br>.value[8]?.f32: radius of the lower right corner of the rectangle. <br>2. Circle:<br>.value[0].i32: type of shape. The parameter type is [ArkUI_ClipType](#arkui_cliptype). The value is **ARKUI_CLIP_TYPE_CIRCLE** for the circle shape.<br>.value[1].f32: width of the circle.<br>.value[2].f32: height of the circle.<br>3. Ellipse:<br>.value[0].i32: type of shape. The parameter type is [ArkUI_ClipType](#arkui_cliptype). The value is **ARKUI_CLIP_TYPE_ELLIPSE** for the ellipse shape.<br>.value[1].f32: width of the ellipse.<br>.value[2].f32: height of the ellipse.<br>4. Path:<br>.value[0].i32: type of shape. The parameter type is [ArkUI_ClipType](#arkui_cliptype). The value is **ARKUI_CLIP_TYPE_PATH** for the path shape.<br>.value[1].f32: width of the path.<br>.value[2].f32: height of the path.<br>.string: command for drawing the path.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md), which supports five types of shapes:<br>1. Rectangle:<br>.value[0].i32: type of shape. The parameter type is [ArkUI_ClipType](#arkui_cliptype). The value is **ARKUI_CLIP_TYPE_RECTANGLE** for the rectangle shape.<br>.value[1].f32: width of the rectangle.<br>.value[2].f32: height of the rectangle.<br>.value[3].f32: width of the rounded corner of the rectangle.<br>.value[4].f32: height of the rounded corner of the rectangle.<br>.value[5]?.f32: radius of the upper left corner of the rectangle. <br>.value[6]?.f32: radius of the lower left corner of the rectangle. <br>.value[7]?.f32: radius of the upper right corner of the rectangle. <br>.value[8]?.f32: radius of the lower right corner of the rectangle. <br>2. Circle:<br>.value[0].i32: type of shape. The parameter type is [ArkUI_ClipType](#arkui_cliptype). The value is **ARKUI_CLIP_TYPE_CIRCLE** for the circle shape.<br>.value[1].f32: width of the circle.<br>.value[2].f32: height of the circle.<br>3. Ellipse:<br>.value[0].i32: type of shape. The parameter type is [ArkUI_ClipType](#arkui_cliptype). The value is **ARKUI_CLIP_TYPE_ELLIPSE** for the ellipse shape.<br>.value[1].f32: width of the ellipse.<br>.value[2].f32: height of the ellipse.<br>4. Path:<br>.value[0].i32: type of shape. The parameter type is [ArkUI_ClipType](#arkui_cliptype). The value is **ARKUI_CLIP_TYPE_PATH** for the path shape.<br>.value[1].f32: width of the path.<br>.value[2].f32: height of the path.<br>.string: command for drawing the path.|
2764| NODE_TRANSFORM                              | Defines the transform attribute, which can be used to translate, rotate, and scale images. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0...15].f32: 16 floating-point numbers.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0...15].f32: 16 floating-point numbers.|
2765| NODE_HIT_TEST_BEHAVIOR                      | Defines the hit test behavior attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: hit test mode. The parameter type is [ArkUI_HitTestMode](#arkui_hittestmode). The default value is **ARKUI_HIT_TEST_MODE_DEFAULT**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: hit test mode. The parameter type is **ArkKUI_HitTestMode**. The default value is **ARKUI_HIT_TEST_MODE_DEFAULT**.|
2766| NODE_POSITION                               | Defines the offset attribute, which specifies the offset of the component's upper left corner relative to the parent container's. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: X coordinate.<br>.value[1].f32: Y coordinate.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: X coordinate.<br>.value[1].f32: Y coordinate.|
2767| NODE_SHADOW                                 | Defines the shadow attribute. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: shadow effect. The parameter type is [ArkUI_ShadowStyle](#arkui_shadowstyle).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: shadow effect. The parameter type is [ArkUI_ShadowStyle](#arkui_shadowstyle).|
2768| NODE_CUSTOM_SHADOW                          | Defines the custom shadow effect. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0]?.f32: blur radius of the shadow, in vp.<br>.value[1]?.i32: whether to enable the coloring strategy. The value **1** means to enable the coloring strategy, and **0** (default value) means the opposite.<br>.value[2]?.f32: offset of the shadow along the x-axis, in px.<br>.value[3]?.f32: offset of the shadow along the y-axis, in px.<br>.value[4]?.i32: shadow type [ArkUI_ShadowType](#arkui_shadowtype). The default value is **ARKUI_SHADOW_TYPE_COLOR**.<br>.value[5]?.u32: shadow color, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>.value[6]?.u32: whether to fill the shadow. The value 1 means to fill the shadow, and 0 means the opposite.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: blur radius of the shadow, in vp.<br>.value[1].i32: whether to enable the coloring strategy. <br>.value[2].f32: offset of the shadow along the x-axis, in px.<br>.value[3].f32: offset of the shadow along the y-axis, in px.<br>.value[4].i32: shadow type [ArkUI_ShadowType](#arkui_shadowtype). The default value is **ARKUI_SHADOW_TYPE_COLOR**.<br>.value[5].u32: shadow color, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>.value[6].u32: whether to fill the shadow. The value **1** means to fill the shadow, and **0** means the opposite.|
2769| NODE_BACKGROUND_IMAGE_SIZE                  | Defines the background image width and height. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: width of the image. The value range is [0, +∞), and the unit is vp.<br>.value[1].f32: height of the image. The value range is [0, +∞), and the unit is vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: width of the image, in vp.<br>.value[1].f32: height of the image, in vp.|
2770| NODE_BACKGROUND_IMAGE_SIZE_WITH_STYLE       | Defines the background image size. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: size of the background image. The value is an enumerated value of [ArkUI_ImageSize](#arkui_imagesize).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: size of the background image. The value is an enumerated value of [ArkUI_ImageSize](#arkui_imagesize).|
2771| NODE_BACKGROUND_BLUR_STYLE                  | Defines the background blur attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: blur type. The value is an enumerated value of [ArkUI_BlurStyle](#arkui_blurstyle).<br>.value[1]?.i32: color mode. The value is an enumerated value of [ArkUI_ColorMode](#arkui_colormode).<br>.value[2]?.i32: adaptive color mode. The value is an enumerated value of [ArkUI_AdaptiveColor](#arkui_adaptivecolor).<br>.value[3]?.f32: blur degree. The value range is [0.0, 1.0].<br>.value[4]?.f32: start boundary of grayscale blur.<br>.value[5]?.f32: end boundary of grayscale blur.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: blur type. The value is an enumerated value of [ArkUI_BlurStyle](#arkui_blurstyle).<br>.value[1].i32: color mode. The value is an enumerated value of [ArkUI_ColorMode](#arkui_colormode).<br>.value[2].i32: adaptive color mode. The value is an enumerated value of [ArkUI_AdaptiveColor](#arkui_adaptivecolor).<br>.value[3].f32: blur degree. The value range is [0.0, 1.0].<br>.value[4].f32: start boundary of grayscale blur.<br>.value[5].f32: end boundary of grayscale blur.|
2772| NODE_TRANSFORM_CENTER                       | Defines the transform center attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0]?.f32: X coordinate of the center point, in vp.<br>.value[1]?.f32: Y coordinate of the center point, in vp.<br>.value[2]?.f32: Z coordinate of the center point, in vp.<br>.value[3]?.f32 : X coordinate of the center point, expressed in a number that represents a percentage. For example, 0.2 indicates 20%. This attribute overwrites value[0].f32. The default value is **0.5f**.<br>.value[4]?.f32 : Y coordinate of the center point, expressed in a number that represents a percentage. For example, 0.2 indicates 20%. This attribute overwrites value[1].f32. The default value is **0.5f**.<br>.value[5]?.f32 : Z coordinate of the center point, expressed in a number that represents a percentage. For example, 0.2 indicates 20%. This attribute overwrites value[2].f32. The default value is **0.0f**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: X coordinate of the center point, in vp. <br>.value[1].f32: Y coordinate of the center point, in vp. <br>.value[2].f32: Z coordinate of the center point, in vp. <br>Note: If the coordinate is expressed in a number that represents a percentage, the attribute obtaining API returns the calculated value in vp.|
2773| NODE_OPACITY_TRANSITION                     | Defines the transition opacity attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: opacity values of the start and end points.<br>.value[1].i32: animation duration, in milliseconds.<br>.value[2].i32: animation curve type. The value is an enumerated value of [ArkUI_AnimationCurve](#arkui_animationcurve).<br>.value[3]?.i32: animation delay duration, in milliseconds.<br>.value[4]?.i32: number of times that the animation is played.<br>.value[5]?.i32: animation playback mode. The value is an enumerated value of [ArkUI_AnimationPlayMode](#arkui_animationplaymode).<br>.value[6]?.f32: animation playback speed.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: opacity values of the start and end points.<br>.value[1].i32: animation duration, in milliseconds.<br>.value[2].i32: animation curve type. The value is an enumerated value of [ArkUI_AnimationCurve](#arkui_animationcurve).<br>.value[3].i32: animation delay duration, in milliseconds.<br>.value[4].i32: number of times that the animation is played.<br>.value[5].i32: animation playback mode. The value is an enumerated value of [ArkUI_AnimationPlayMode](#arkui_animationplaymode).<br>.value[6].f32: animation playback speed.|
2774| NODE_ROTATE_TRANSITION                      | Defines the transition rotation attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: X-component of the rotation vector.<br>.value[1].f32: Y-component of the rotation vector.<br>.value[2].f32: Z-component of the rotation vector<br>.value[3].f32: angle.<br>.value[4].f32: line of sight. The default value is **0.0f**.<br>.value[5].i32: animation duration, in milliseconds.<br>.value[6].i32: animation curve type. The value is an enumerated value of [ArkUI_AnimationCurve](#arkui_animationcurve).<br>.value[7]?.i32: animation delay duration, in milliseconds.<br>.value[8]?.i32: number of times that the animation is played.<br>.value[9]?.i32: animation playback mode. The value is an enumerated value of [ArkUI_AnimationPlayMode](#arkui_animationplaymode).<br>.value[10]?.f32: animation playback speed.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: X-component of the rotation vector.<br>.value[1].f32: Y-component of the rotation vector.<br>.value[2].f32: Z-component of the rotation vector<br>.value[3].f32: angle.<br>.value[4].f32: line of sight.<br>.value[5].i32: animation duration, in milliseconds.<br>.value[6].i32: animation curve type. The value is an enumerated value of [ArkUI_AnimationCurve](#arkui_animationcurve).<br>.value[7].i32: animation delay duration, in milliseconds.<br>.value[8].i32: number of times that the animation is played.<br>.value[9].i32: animation playback mode. The value is an enumerated value of [ArkUI_AnimationPlayMode](#arkui_animationplaymode).<br>.value[10].f32: animation playback speed.|
2775| NODE_SCALE_TRANSITION                       | Defines the transition scaling attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: scale factor along the x-axis.<br>.value[1].f32: scale factor along the y-axis.<br>.value[2].f32: scale factor along the z-axis.<br>value[3].i32: animation duration, in milliseconds.<br>.value[4].i32: animation curve type. The value is an enumerated value of [ArkUI_AnimationCurve](#arkui_animationcurve).<br>.value[5]?.i32: animation delay duration, in milliseconds.<br>.value[6]?.i32: number of times that the animation is played.<br>.value[7]?.i32: animation playback mode. The value is an enumerated value of [ArkUI_AnimationPlayMode](#arkui_animationplaymode).<br>value[8]?.f32: animation playback speed.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: scale factor along the x-axis.<br>.value[1].f32: scale factor along the y-axis.<br>.value[2].f32: scale factor along the z-axis.<br>value[3].i32: animation duration, in milliseconds.<br>.value[4].i32: animation curve type. The value is an enumerated value of [ArkUI_AnimationCurve](#arkui_animationcurve).<br>value[5].i32: animation delay duration, in milliseconds.<br>value[6].i32: number of times that the animation is played.<br>.value[7].i32: animation playback mode. The value is an enumerated value of [ArkUI_AnimationPlayMode](#arkui_animationplaymode).<br>value[8].f32: animation playback speed.|
2776| NODE_TRANSLATE_TRANSITION                   | Defines the transition translation attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>value[0].f32: translation distance along the x-axis, in vp.<br>value[1].f32: translation distance along the y-axis, in vp.<br>value[2].f32: translation distance along the z-axis, in vp.<br>value[3].i32: animation duration, in milliseconds.<br>value[4].i32: animation curve type. The value is an enumerated value of [ArkUI_AnimationCurve](#arkui_animationcurve).<br>value[5]?.i32: animation delay duration, in milliseconds.<br>value[6]?.i32: number of times that the animation is played.<br>value[7]?.i32: animation playback mode. The value is an enumerated value of [ArkUI_AnimationPlayMode](#arkui_animationplaymode).<br>value[8]?.f32: animation playback speed.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>value[0].f32: translation distance along the x-axis, in vp.<br>value[1].f32: translation distance along the y-axis, in vp.<br>value[2].f32: translation distance along the z-axis, in vp.<br>value[3].i32: animation duration, in milliseconds.<br>value[4].i32: animation curve type. The value is an enumerated value of [ArkUI_AnimationCurve](#arkui_animationcurve).<br>value[5].i32: animation delay duration, in milliseconds.<br>value[6].i32: number of times that the animation is played.<br>value[7].i32: animation playback mode. The value is an enumerated value of [ArkUI_AnimationPlayMode](#arkui_animationplaymode).<br>value[8].f32: animation playback speed.|
2777| NODE_MOVE_TRANSITION                        | Defines the slide-in and slide-out of the component from the screen edge during transition. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: [ArkUI_TransitionEdge](#arkui_transitionedge) type.<br>.value[1].i32: animation duration, in milliseconds.<br>.value[2].i32: animation curve type. The value is an enumerated value of [ArkUI_AnimationCurve](#arkui_animationcurve).<br>.value[3]?.i32: animation delay duration, in milliseconds.<br>.value[4]?.i32: number of times that the animation is played.<br>.value[5]?.i32: animation playback mode. The value is an enumerated value of [ArkUI_AnimationPlayMode](#arkui_animationplaymode).<br>.value[6]?.f32: animation playback speed.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: [ArkUI_TransitionEdge](#arkui_transitionedge) type.<br>.value[1].i32: animation duration, in milliseconds.<br>.value[2].i32: animation curve type. The value is an enumerated value of [ArkUI_AnimationCurve](#arkui_animationcurve).<br>.value[3].i32: animation delay duration, in milliseconds.<br>.value[4].i32: number of times that the animation is played.<br>.value[5].i32: animation playback mode. The value is an enumerated value of [ArkUI_AnimationPlayMode](#arkui_animationplaymode).<br>.value[6].f32: animation playback speed.|
2778| NODE_FOCUSABLE                              | Defines the focus attribute, which can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: The parameter type is 1 or 0.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: The parameter type is 1 or 0.|
2779| NODE_DEFAULT_FOCUS                          | Defines the default focus attribute, which can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>value[0].i32: The parameter type is 1 or 0.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>value[0].i32: The parameter type is 1 or 0.|
2780| NODE_RESPONSE_REGION                        | Defines the touch target attribute, which can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.data[0].f32: X coordinate of the touch point relative to the upper left corner of the component, in vp.<br>.data[1].f32: Y coordinate of the touch point relative to the upper left corner of the component, in vp.<br>.data[2].f32: width of the touch target, in percentage.<br>.data[3].f32: height of the touch target, in percentage.<br>.data[4...].f32: Multiple touch targets can be set. The sequence of the parameters is the same as the preceding.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.data[0].f32: X coordinate of the touch point relative to the upper left corner of the component, in vp.<br>.data[1].f32: Y coordinate of the touch point relative to the upper left corner of the component, in vp.<br>.data[2].f32: width of the touch target, in percentage.<br>.data[3].f32: height of the touch target, in percentage.<br>.data[4...].f32: Multiple touch targets can be set. The sequence of the parameters is the same as the preceding.|
2781| NODE_OVERLAY                                | Defines the overlay attribute, which can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: mask text.<br>.value[0]?.i32: position of the overlay relative to the component. Optional. The parameter type is [ArkUI_Alignment](#arkui_alignment). The default value is **ARKUI_ALIGNMENT_TOP_START**.<br>.value[1]?.f32: offset of the overlay relative to the upper left corner of itself on the x-axis, in vp. Optional.<br>.value[2]?.f32: offset of the overlay relative to the upper left corner of itself on the y-axis, in vp. Optional.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: mask text.<br>.value[0].i32: position of the overlay relative to the component. The parameter type is [ArkUI_Alignment](#arkui_alignment). The default value is **ARKUI_ALIGNMENT_TOP_START**.<br>.value[1].f32: offset of the overlay relative to the upper left corner of itself on the x-axis, in vp.<br>.value[2].f32: offset of the overlay relative to the upper left corner of itself on the y-axis, in vp.|
2782| NODE_SWEEP_GRADIENT                         | Defines the sweep gradient effect. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0]?.f32: X coordinate of the sweep gradient center relative to the upper left corner of the component.<br>.value[1]?.f32: Y coordinate of the sweep gradient center relative to the upper left corner of the component.<br>.value[2]?.f32: start point of the sweep gradient. The default value is **0**.<br>.value[3]?.f32: end point of the sweep gradient. The default value is **0**.<br>.value[4]?.f32: rotation angle of the sweep gradient. The default value is **0**.<br>.value[5]?.i32: whether the colors are repeated. The value **1** means that the colors are repeated, and **0** means the opposite.<br>.object: The parameter type is [ArkUI_ColorStop](_ark_u_i___color_stop.md). - **colors**: array of color stops, each of which consists of a color and its stop position. Invalid colors are automatically skipped.<br>**colors**: colors of the color stops.<br>**stops**: stop positions of the color stops.<br>**size**: number of colors.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: X coordinate of the sweep gradient center relative to the upper left corner of the component. <br>.value[1].f32: Y coordinate of the sweep gradient center relative to the upper left corner of the component. <br>.value[2].f32: start point of the sweep gradient. The default value is **0**.<br>.value[3].f32: end point of the sweep gradient. The default value is **0**.<br>.value[4].f32: rotation angle of the sweep gradient. The default value is **0**.<br>.value[5].i32: whether the colors are repeated. The value **1** means that the colors are repeated, and **0** means the opposite. <br>.object: The parameter type is [ArkUI_ColorStop](_ark_u_i___color_stop.md). - **colors**: array of color stops, each of which consists of a color and its stop position. Invalid colors are automatically skipped.<br>**colors**: colors of the color stops.<br>**stops**: stop positions of the color stops.<br>**size**: number of colors.|
2783| NODE_RADIAL_GRADIENT                        | Defines the radial gradient effect. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0]?.f32: X coordinate of the radial gradient center relative to the upper left corner of the component.<br>.value[1]?.f32: Y coordinate of the radial gradient center relative to the upper left corner of the component.<br>.value[2]?.f32: radius of the radial gradient. The default value is **0**.<br>.value[3]?.i32: whether the colors are repeated. The value **1** means that the colors are repeated, and **0** means the opposite.<br>.object: The parameter type is [ArkUI_ColorStop](_ark_u_i___color_stop.md). - **colors**: array of color stops, each of which consists of a color and its stop position. Invalid colors are automatically skipped.<br>**colors**: colors of the color stops.<br>**stops**: stop positions of the color stops.<br>**size**: number of colors.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: X coordinate of the radial gradient center relative to the upper left corner of the component. <br>.value[1].f32: Y coordinate of the radial gradient center relative to the upper left corner of the component. <br>.value[2].f32: radius of the radial gradient. The default value is **0**.<br>.value[3].i32: whether the colors are repeated. The value **1** means that the colors are repeated, and **0** means the opposite. <br>.object: The parameter type is [ArkUI_ColorStop](_ark_u_i___color_stop.md). - **colors**: array of color stops, each of which consists of a color and its stop position. Invalid colors are automatically skipped.<br>**colors**: colors of the color stops.<br>**stops**: stop positions of the color stops.<br>**size**: number of colors.|
2784| NODE_MASK                                   | Adds a mask of the specified shape to the component. APIs are provided for setting and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute, which supports five types of shapes:<br>1. Rectangle:<br>.value[0].u32 fill color, in 0xARGB format.<br>.value[1].u32: stroke color, in 0xARGB format.<br>.value[2].f32: stroke width, in vp.<br>.value[3].i32: mask type. The parameter type is [ArkUI_MaskType](#arkui_masktype). The value is **ARKUI_MASK_TYPE_RECTANGLE** for the rectangle shape.<br>.value[4].f32: width of the rectangle.<br>.value[5].f32: height of the rectangle.<br>.value[6].f32: width of the rounded corner of the rectangle.<br>.value[7].f32: height of the rounded corner of the rectangle.<br>.value[8]?.f32: radius of the upper left corner of the rectangle. <br>.value[9]?.f32: radius of the lower left corner of the rectangle. <br>.value[10]?.f32: radius of the upper right corner of the rectangle. <br>.value[11]?.f32: radius of the lower right corner of the rectangle. <br>2. Circle:<br>.value[0].u32 fill color, in 0xARGB format.<br>.value[1].u32: stroke color, in 0xARGB format.<br>.value[2].f32: stroke width, in vp.<br>.value[3].i32: mask type. The parameter type is [ArkUI_MaskType](#arkui_masktype). The value is **ARKUI_MASK_TYPE_CIRCLE** for the circle shape.<br>.value[4].f32: width of the circle.<br>.value[5].f32: height of the circle.<br>3. Ellipse:<br>.value[0].u32 fill color, in 0xARGB format.<br>.value[1].u32: stroke color, in 0xARGB format.<br>.value[2].f32: stroke width, in vp.<br>.value[3].i32: mask type. The parameter type is [ArkUI_MaskType](#arkui_masktype). The value is **ARKUI_MASK_TYPE_ELLIPSE** for the ellipse shape.<br>.value[4].f32: width of the ellipse.<br>.value[5].f32: height of the ellipse.<br>4. Path:<br>.value[0].u32 fill color, in 0xARGB format.<br>.value[1].u32: stroke color, in 0xARGB format.<br>.value[2].f32: stroke width, in vp.<br>.value[3].i32: mask type. The parameter type is [ArkUI_MaskType](#arkui_masktype). The value is **ARKUI_MASK_TYPE_PATH** for the path shape.<br>.value[4].f32: width of the path.<br>.value[5].f32: height of the path.<br>.string: command for drawing the path.<br>5. Progress:<br>.value[0].i32: mask type. The parameter type is [ArkUI_MaskType](#arkui_masktype). The value is **ARKUI_MASK_TYPE_PROGRESS** for the progress shape.<br>.value[1].f32: current value of the progress indicator.<br>.value[2].f32: maximum value of the progress indicator.<br>.value[3].u32: color of the progress indicator.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md), which supports five types of shapes:<br>1. Rectangle:<br>.value[0].u32 fill color, in 0xARGB format.<br>.value[1].u32: stroke color, in 0xARGB format.<br>.value[2].f32: stroke width, in vp.<br>.value[3].i32: mask type.<br>.value[4].f32: width of the rectangle.<br>.value[5].f32: height of the rectangle.<br>.value[6].f32: width of the rounded corner of the rectangle.<br>.value[7].f32: height of the rounded corner of the rectangle.<br>.value[8]?.f32: radius of the upper left corner of the rectangle. <br>.value[9]?.f32: radius of the lower left corner of the rectangle. <br>.value[10]?.f32: radius of the upper right corner of the rectangle. <br>.value[11]?.f32: radius of the lower right corner of the rectangle. <br>2. Circle:<br>.value[0].u32 fill color, in 0xARGB format.<br>.value[1].u32: stroke color, in 0xARGB format.<br>.value[2].f32: stroke width, in vp.<br>.value[3].i32: mask type.<br>.value[4].f32: width of the circle.<br>.value[5].f32: height of the circle.<br>3. Ellipse:<br>.value[0].u32 fill color, in 0xARGB format.<br>.value[1].u32: stroke color, in 0xARGB format.<br>.value[2].f32: stroke width, in vp.<br>.value[3].i32: mask type.<br>.value[4].f32: width of the ellipse.<br>.value[5].f32: height of the ellipse.<br>4. Path:<br>.value[0].u32 fill color, in 0xARGB format.<br>.value[1].u32: stroke color, in 0xARGB format.<br>.value[2].f32: stroke width, in vp.<br>.value[3].i32: mask type.<br>.value[4].f32: width of the path.<br>.value[5].f32: height of the path.<br>.string: command for drawing the path.<br>5. Progress:<br>.value[0].i32: mask type.<br>.value[1].f32: current value of the progress indicator.<br>.value[2].f32: maximum value of the progress indicator.<br>.value[3].u32: color of the progress indicator.|
2785| NODE_BLEND_MODE                             | Blends the component's background with the content of the component's child node. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: blend mode. The parameter type is [ArkUI_BlendMode](#arkui_blendmode). The default value is **ARKUI_BLEND_MODE_NONE**.<br>.value[1].?i32: how the specified blend mode is applied. The parameter type is [ArkUI_BlendApplyType](#arkui_blendapplytype). The default value is **BLEND_APPLY_TYPE_FAST**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: blend mode. The parameter type is [ArkUI_BlendMode](#arkui_blendmode). The default value is **ARKUI_BLEND_MODE_NONE**.<br>.value[1].i32: how the specified blend mode is applied. The parameter type is [ArkUI_BlendApplyType](#arkui_blendapplytype). The default value is **BLEND_APPLY_TYPE_FAST**.|
2786| NODE_DIRECTION                              | Sets the direction of the main axis. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: direction of the main axis.<br>The parameter type is [ArkUI_Direction](#arkui_direction). The default value is **ARKUI_DIRECTION_AUTO**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: direction of the main axis.<br>The parameter type is [ArkUI_Direction](#arkui_direction). The default value is **ARKUI_DIRECTION_AUTO**.|
2787| NODE_CONSTRAINT_SIZE                        | Defines the size constraints. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: minimum width, in vp.<br>.value[1].f32: maximum width, in vp.<br>.value[2].f32: minimum height, in vp.<br>.value[3].f32: maximum height, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: minimum width, in vp.<br>.value[1].f32: maximum width, in vp.<br>.value[2].f32: minimum height, in vp.<br>.value[3].f32: maximum height, in vp.|
2788| NODE_GRAY_SCALE                             | Defines the grayscale effect. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: grayscale conversion ratio. The value ranges from 0 to 1. For example, 0.5 indicates a 50% grayscale conversion ratio.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: grayscale conversion ratio. The value ranges from 0 to 1.|
2789| NODE_INVERT                                 | Inverts the image. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: image inversion ratio. The value ranges from 0 to 1. For example, 0.5 indicates a 50% image inversion ratio.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: image inversion ratio. The value ranges from 0 to 1.|
2790| NODE_SEPIA                                  | Defines the sepia conversion ratio. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: sepia conversion ratio. The value ranges from 0 to 1. For example, 0.5 indicates that a 50% sepia conversion ratio.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: sepia conversion ratio. The value ranges from 0 to 1.|
2791| NODE_CONTRAST                               | Defines the contrast attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: contrast. If the value is **1**, the source image is displayed. A larger value indicates a higher contrast. Value range: [0, 10).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: contrast. Value range: [0, 10).|
2792| NODE_FOREGROUND_COLOR                       | Defines the border color attribute, which can be set, reset, and obtained as required through APIs.<br>There are two parameter formats of [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) for setting the attribute:\n<br>1: .value[0].u32: color value, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>2: .value[0].i32: color enum **ArkUI_ColoringStrategy**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color value, in 0xARGB format.|
2793| NODE_OFFSET                                 | Defines the offset of the component's child relative to the component. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32 : offset along the x-axis, in vp.<br>.value[1].f32 : offset along the y-axis, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32 : offset along the x-axis, in vp.<br>.value[1].f32 : offset along the y-axis, in vp.|
2794| NODE_MARK_ANCHOR                            | Sets the anchor for locating the component's child. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: X coordinate of the anchor, in vp.<br>.value[1].f32: Y coordinate of the anchor, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: X coordinate of the anchor, in vp.<br>.value[1].f32: Y coordinate of the anchor, in vp.|
2795| NODE_BACKGROUND_IMAGE_POSITION              | Defines the position of the background image in the component, that is, the coordinates relative to the upper left corner of the component. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: position along the x-axis, in px.<br>.value[1].f32: position along the y-axis, in px.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: position along the x-axis, in px.<br>.value[1].f32: position along the y-axis, in px.|
2796| NODE_ALIGN_RULES                            | Sets the alignment rules in the relative container. APIs are provided for setting, resetting, and obtaining the attribute value.<br>.object: [ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) object that defines the alignment rules.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: [ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) object that defines the alignment rules.|
2797| NODE_ALIGN_SELF                             | Sets the alignment mode of the child components along the cross axis of the parent container. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: alignment mode of the child components along the cross axis of the parent container. <br>The parameter type is [ArkUI_ItemAlignment](#arkui_itemalignment). The default value is **ARKUI_ITEM_ALIGNMENT_AUTO**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: alignment mode of the child components along the cross axis of the parent container. <br>The parameter type is [ArkUI_ItemAlignment](#arkui_itemalignment). The default value is **ARKUI_ITEM_ALIGNMENT_AUTO**.|
2798| NODE_FLEX_GROW                              | Sets the percentage of the parent container's remaining space that is allocated to the component. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: percentage of the parent container's remaining space that is allocated to the component.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: percentage of the parent container's remaining space that is allocated to the component.|
2799| NODE_FLEX_SHRINK                            | Sets the percentage of the parent container's shrink size that is allocated to the component. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: percentage of the parent container's shrink size that is allocated to the component.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: percentage of the parent container's shrink size that is allocated to the component.|
2800| NODE_FLEX_BASIS                             | Sets the base size of the component. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: base size of the component on the main axis of the parent container.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: base size of the component on the main axis of the parent container.|
2801| NODE_ACCESSIBILITY_GROUP                    | Sets the accessibility group. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: If the value is **1**, the component and all its child components form an entire selectable component, and the accessibility service will no longer available for the content of its child components. The value is **1** or **0**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: If the value is **1**, the component and all its child components form an entire selectable component, and the accessibility service will no longer available for the content of its child components. The value is **1** or **0**.|
2802| NODE_ACCESSIBILITY_TEXT                     | Sets the accessibility text. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: accessibility text.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: accessibility text.|
2803| NODE_ACCESSIBILITY_MODE                     | Defines the accessibility mode. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: auxiliary service mode. The parameter type is [ArkUI_AccessibilityMode](#arkui_accessibilitymode).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: auxiliary service mode. The parameter type is [ArkUI_AccessibilityMode](#arkui_accessibilitymode).|
2804| NODE_ACCESSIBILITY_DESCRIPTION              | Sets the accessibility description. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: accessibility description.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: accessibility description.|
2805| NODE_FOCUS_STATUS                           | This interface is used to obtain focus attributes. Attributes can be set and obtained.<br>**NOTE**<br>Setting the parameter to **0** shifts focus from the currently focused component on the current level of the page to the root container.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: The parameter type is 1 or 0.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>value[0].i32: The parameter type is 1 or 0.|
2806| NODE_ASPECT_RATIO                           | Defines the aspect ratio attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: aspect ratio of the component, in width/height format.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: aspect ratio of the component, in width/height format.|
2807| NODE_LAYOUT_WEIGHT                          | Defines the weight of the component within its row, column, or flex container for proportional distribution of available space within the container. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: weight of the component along the main axis.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: weight of the component along the main axis.|
2808| NODE_DISPLAY_PRIORITY                       | Sets the display priority for the component in the row, column, or flex (single-line) container. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: display priority of the component in the container.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: display priority of the component in the container.|
2809| NODE_OUTLINE_WIDTH                          | Sets the thickness of an element's outline.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: thickness of the left outline.<br>.value[1].f32: thickness of the top outline.<br>.value[2].f32: thickness of the right outline.<br>.value[3].f32: thickness of the bottom outline.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: thickness of the left outline.<br>.value[1].f32: thickness of the top outline.<br>.value[2].f32: thickness of the right outline.<br>.value[3].f32: thickness of the bottom outline.|
2810| NODE_WIDTH_PERCENT                          | Defines the width attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: width, in percentage. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: width, in percentage. |
2811| NODE_HEIGHT_PERCENT                         | Defines the height attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: height, in percentage. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: height, in percentage. |
2812| NODE_PADDING_PERCENT                        | Defines the padding attribute, which can be set, reset, and obtained as required through APIs.<br>There are two formats of [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) for setting the attribute value:<br>1: Specify the same padding for the four directions.<br>.value[0].f32: padding, in percentage. <br>2: Specify different paddings for different directions.<br>.value[0].f32: top padding, in percentage. <br>.value[1].f32: right padding, in percentage. <br>.value[2].f32: bottom padding, in percentage. <br>.value[3].f32: left padding, in percentage. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: top padding, in percentage. <br>.value[1].f32: right padding, in percentage. <br>.value[2].f32: bottom padding, in percentage. <br>.value[3].f32: left padding, in percentage. |
2813| NODE_MARGIN_PERCENT                         | Defines the margin attribute, which can be set, reset, and obtained as required through APIs.<br>There are two formats of [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) for setting the attribute value:<br>1: Specify the same margin for the four directions.<br>.value[0].f32: margin, in percentage. <br>2: Specify different margins for different directions.<br>.value[0].f32: top margin, in percentage. <br>.value[1].f32: right margin, in percentage. <br>.value[2].f32: bottom margin, in percentage. <br>.value[3].f32: left margin, in percentage. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: top margin, in percentage. <br>.value[1].f32: right margin, in percentage. <br>.value[2].f32: bottom margin, in percentage. <br>.value[3].f32: left margin, in percentage. |
2814| NODE_GEOMETRY_TRANSITION                    | Implements an implicit shared element transition. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: two components bound to the shared element. The parameter type is 1 or 0. By default, the out component does not continue to participate in the shared element animation when not yet deleted, which means that it stays in its original position.<br>.string: ID used to set up a binding relationship. If this attribute is set to an empty string **""**, the binding relationship is cleared. The value can be dynamically changed to refresh the binding relationship. One ID can be bound to only two components, which function as in and out components.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: two components bound to the shared element. The parameter type is 1 or 0. By default, the out component does not continue to participate in the shared element animation when not yet deleted, which means that it stays in its original position.<br>.string: ID used to set up a binding relationship. If this attribute is set to an empty string **""**, the binding relationship is cleared. The value can be dynamically changed to refresh the binding relationship. One ID can be bound to only two components, which function as in and out components.|
2815| NODE_RELATIVE_LAYOUT_CHAIN_MODE             | Specifies the parameters of the chain formed by the component as the chain head. The attribute setting, attribute resetting, and attribute obtaining interfaces are supported.<br>This attribute has effect only when the parent container is **RelativeContainer**.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: direction of the chain. Enumeration [ArkUI_Axis](#arkui_axis).<br>.value[1].i32: style of the chain. Enumeration [ArkUI_RelativeLayoutChainStyle](#arkui_relativelayoutchainstyle).<br>.value[0].i32: direction of the chain. Enumeration [ArkUI_Axis](#arkui_axis).<br>.value[1].i32: style of the chain. Enumeration [ArkUI_RelativeLayoutChainStyle](#arkui_relativelayoutchainstyle).|
2816| NODE_RENDER_FIT                             | Sets how the final state of the component's content is rendered during its width and height animation process. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32 Content filling mode. The enumerated values of [ArkUI_RenderFit](#arkui_renderfit) are used.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32 Content filling mode. The enumerated values of [ArkUI_RenderFit](#arkui_renderfit) are used.|
2817| NODE_OUTLINE_COLOR                          | Defines the border color attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>1: .value[0].u32: color of the four borders, in 0xARGB format, for example, **0xFFFF11FF**.<br>2: .value[0].u32: color of the top border, in 0xARGB format, for example, **0xFFFF11FF**.<br>.value[1].u32: color of the right border, in 0xARGB format, for example, **0xFFFF11FF**.<br>.value[2].u32: color of the lower border, in 0xARGB format, for example, **0xFFFF11FF**.<br>.value[3].u32: color of the left border, in 0xARGB format, for example, **0xFFFF11FF**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color of the top border, in 0xARGB format, for example, **0xFFFF11FF**.<br>.value[1].u32: color of the right border, in 0xARGB format, for example, **0xFFFF11FF**.<br>.value[2].u32: color of the lower border, in 0xARGB format, for example, **0xFFFF11FF**.<br>.value[3].u32: color of the left border, in 0xARGB format, for example, **0xFFFF11FF**.|
2818| NODE_SIZE                                   | Sets the size. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: width, in vp.<br>.value[1].f32: height, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: width, in vp.<br>.value[1].f32: height, in vp.|
2819| NODE_RENDER_GROUP                           | Sets whether the component and its child components are rendered off the screen and then drawn together with its parent. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: The parameter type is 1 or 0.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>value[0].i32: The parameter type is 1 or 0.|
2820| NODE_COLOR_BLEND                            | The color overlay effect is added to the component. The attribute setting, attribute resetting, and attribute obtaining interfaces are supported.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: color to blend with the component, in 0xARGB format, for example, **0xFFFF11FF**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color to blend with the component, in 0xARGB format, for example, **0xFFFF11FF**.|
2821| NODE_FOREGROUND_BLUR_STYLE                  | Applies a foreground blur style to the component. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: foreground blur style. The value is an enum of [ArkUI_BlurStyle](#arkui_blurstyle).<br>.value[1]?.i32: color mode used for the foreground blur. The value is an enum of [ArkUI_ColorMode](#arkui_colormode).<br>.value[2]?.i32: adaptive color mode used for the foreground blur. The value is an enum of [ArkUI_AdaptiveColor](#arkui_adaptivecolor).<br>.value[3]?.f32: blur degree. The value range is [0.0, 1.0].<br>.value[4]?.i32: brightness of black in the grayscale blur. The value range is [0, 127].<br>.value[5]?.i32: degree of darkening the white color in the grayscale blur. The value range is [0, 127].<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: foreground blur style. The value is an enum of [ArkUI_BlurStyle](#arkui_blurstyle).<br>.value[1].i32: color mode used for the foreground blur. The value is an enum of [ArkUI_ColorMode](#arkui_colormode).<br>.value[2].i32: adaptive color mode used for the foreground blur. The value is an enum of [ArkUI_AdaptiveColor](#arkui_adaptivecolor).<br>.value[3].f32: blur degree. The value range is [0.0, 1.0].<br>.value[4].i32: brightness of black in the grayscale blur. The value range is [0, 127].<br>.value[5].i32: degree of darkening the white color in the grayscale blur. The value range is [0, 127].|
2822| NODE_LAYOUT_RECT                            | Defines the component size and position for layout. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: X coordinate of the component, in px. <br>.value[1].i32: Y coordinate of the component, in px. <br>.value[2].i32: width of the component, in px. <br>.value[3].i32: height of the component, in px. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: X coordinate of the component, in px. <br>.value[1].i32: Y coordinate of the component, in px. <br>.value[2].i32: width of the component, in px. <br>.value[3].i32: height of the component, in px. |
2823| NODE_FOCUS_ON_TOUCH                         | Sets whether the component is focusable on touch. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: The parameter type is 1 or 0.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>value[0].i32: The parameter type is 1 or 0.|
2824| NODE_BORDER_WIDTH_PERCENT                   | Defines the border width attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>1: .value[0].f32: width of the four borders, in percentage.<br>2: .value[0].f32: width of the top border, in percentage.<br>.value[1].f32: width of the right border, in percentage.<br>.value[2].f32: width of the bottom border, in percentage.<br>.value[3].f32: width of the left border, in percentage.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: width of the top border, in percentage.<br>.value[1].f32: width of the right border, in percentage.<br>.value[2].f32: width of the bottom border, in percentage.<br>.value[3].f32: width of the left border, in percentage.|
2825| NODE_BORDER_RADIUS_PERCENT                  | Defines the border corner radius attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>1: .value[0].f32: radius of the four corners, in percentage.<br>2: .value[0].f32: radius of the upper left corner, in percentage.<br>.value[1].f32: radius of the upper right corner, in percentage.<br>.value[2].f32: radius of the lower left corner, in percentage.<br>.value[3].f32: radius of the lower right corner, in percentage.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: radius of the upper left corner, in percentage.<br>.value[1].f32: radius of the upper right corner, in percentage.<br>.value[2].f32: radius of the lower left corner, in percentage.<br>.value[3].f32: radius of the lower right corner, in percentage.|
2826| NODE_ACCESSIBILITY_ID                       | Sets the custom accessibility ID. This attribute can be obtained.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: custom accessibility ID.|
2827| NODE_ACCESSIBILITY_ACTIONS                  | Sets the accessibility action type. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: accessibility operation type. The parameter type is [ArkUI_AccessibilityActionType](#arkui_accessibilityactiontype).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: accessibility operation type. The parameter type is [ArkUI_AccessibilityActionType](#arkui_accessibilityactiontype).|
2828| NODE_ACCESSIBILITY_ROLE                     | Defines supported accessibility component types. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: Accessibility component type. The parameter type is [ArkUI_NodeType](#arkui_nodetype).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: Accessibility component type. The parameter type is [ArkUI_NodeType](#arkui_nodetype).|
2829| NODE_ACCESSIBILITY_STATE                    | Sets the accessibility state. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: accessibility state. The parameter type is [ArkUI_AccessibilityState](#arkui_accessibilitystate).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: accessibility state. The parameter type is [ArkUI_AccessibilityState](#arkui_accessibilitystate).|
2830| NODE_ACCESSIBILITY_VALUE                    | Sets the accessibility value. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: accessibility value. The parameter type is [ArkUI_AccessibilityValue](#arkui_accessibilityvalue).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: accessibility value. The parameter type is [ArkUI_AccessibilityValue](#arkui_accessibilityvalue).|
2831| NODE_EXPAND_SAFE_AREA                       | Sets the safe area to be expanded to. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0]?.u32: types of the expanded safe area, which are enumerated values of [ArkUI_SafeAreaType](#arkui_safeareatype). Example: ARKUI_SAFE_AREA_TYPE_SYSTEM \| ARKUI_SAFE_AREA_TYPE_CUTOUT.<br>.value[1]?.u32: edges for expanding the safe area, which are enumerated values of [ArkUI_SafeAreaEdge](#arkui_safeareaedge).<br>Example: ARKUI_SAFE_AREA_EDGE_TOP \| ARKUI_SAFE_AREA_EDGE_BOTTOM.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: expanded safe area.<br>.<br>.value[1].u32: edges for expanding the safe area.<br> |
2832| NODE_VISIBLE_AREA_CHANGE_RATIO              | Defines the visible area ratio (visible area/total area of the component) threshold for invoking the visible area change event of the component.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[...].f32: threshold array. The value ranges from 0 to 1.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[...].f32: threshold array.<br> |
2833| NODE_TRANSITION                             | Sets the transition effect when the component is inserted or deleted. This attribute can be set and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: transition effect. The parameter type is [ArkUI_TransitionEffect](#arkui_transitioneffect).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: transition effect. The parameter type is [ArkUI_TransitionEffect](#arkui_transitioneffect).|
2834| NODE_UNIQUE_ID                              | Defines the component ID. This attribute can be obtained through APIs.<br>**NOTE**<br>The component ID is read-only and unique in a process.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: component ID.|
2835| NODE_CLICK_DISTANCE                         | Defines the moving distance limit for the component-bound tap gesture. This attribute can be set as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: allowed moving distance of a finger, in vp.|
2836| NODE_TEXT_CONTENT                           | Defines the text content attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: text content.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: text content.|
2837| NODE_FONT_COLOR                             | Defines the font color attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: font color, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: font color value, in 0xARGB format.|
2838| NODE_FONT_SIZE                              | Defines the font size attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: font size, in fp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: font size, in fp.|
2839| NODE_FONT_STYLE                             | Defines the font style attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: font style [ArkUI_FontStyle](#arkui_fontstyle). The default value is **ARKUI_FONT_STYLE_NORMAL**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: font style [ArkUI_FontStyle](#arkui_fontstyle).|
2840| NODE_FONT_WEIGHT                            | Defines the font weight attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: font weight [ArkUI_FontWeight](#arkui_fontweight). The default value is **ARKUI_FONT_WEIGHT_NORMAL**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: font weight [ArkUI_FontWeight](#arkui_fontweight).|
2841| NODE_TEXT_LINE_HEIGHT                       | Defines the text line height attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: line height, in fp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: line height, in fp.|
2842| NODE_TEXT_DECORATION                        | Defines the text decoration style and color. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: text decoration type [ArkUI_TextDecorationType](#arkui_textdecorationtype). The default value is **ARKUI_TEXT_DECORATION_TYPE_NONE**.<br>.value[1]?.u32: text decoration color, in 0xARGB format. For example, 0xFFFF0000 indicates red. Optional. <br>.value[2]?.i32: text decoration style [ArkUI_TextDecorationStyle](#arkui_textdecorationstyle).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: text decoration type [ArkUI_TextDecorationType](#arkui_textdecorationtype).<br>.value[1].u32: text decoration color, in 0xARGB format.<br>.value[2].i32: text decoration style [ArkUI_TextDecorationStyle](#arkui_textdecorationstyle).|
2843| NODE_TEXT_CASE                              | Defines the text case attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: text case.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: text case.|
2844| NODE_TEXT_LETTER_SPACING                    | Defines the letter spacing attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: letter spacing, in fp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: letter spacing, in fp.|
2845| NODE_TEXT_MAX_LINES                         | Sets the maximum number of lines in the text. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: maximum number of lines in the text.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: maximum number of lines in the text.|
2846| NODE_TEXT_ALIGN                             | Horizontal alignment mode of the text. The interfaces for setting, resetting, and obtaining attributes are supported.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: horizontal alignment mode of the text. The value is an enum of [ArkUI_TextAlignment](#arkui_textalignment).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: horizontal alignment mode of the text. The value is an enum of [ArkUI_TextAlignment](#arkui_textalignment).|
2847| NODE_TEXT_OVERFLOW                          | Defines the text overflow attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: display mode when the text is too long.{\@ArkUI_TextOverflow}<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: display mode when the text is too long.{\@ArkUI_TextOverflow} |
2848| NODE_FONT_FAMILY                            | Defines the font family attribute, which can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: fonts, separated by commas (,).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: fonts, separated by commas (,).|
2849| NODE_TEXT_COPY_OPTION                       | Defines the copy option attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: copy option [ArkUI_CopyOptions](#arkui_copyoptions). The default value is **ARKUI_COPY_OPTIONS_NONE**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: copy option [ArkUI_CopyOptions](#arkui_copyoptions).|
2850| NODE_TEXT_BASELINE_OFFSET                   | Defines the text baseline offset attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: baseline offset, in fp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: baseline offset, in fp.|
2851| NODE_TEXT_TEXT_SHADOW                       | Defines the shadow attribute. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: blur radius of the shadow, in vp.<br>.value[1].i32: shadow type [ArkUI_ShadowType](#arkui_shadowtype). The default value is **ARKUI_SHADOW_TYPE_COLOR**.<br>.value[2].u32: shadow color, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>.value[3].f32: offset of the shadow along the x-axis, in vp.<br>.value[4].f32: offset of the shadow along the y-axis, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: blur radius of the shadow, in vp.<br>.value[1].i32: shadow type [ArkUI_ShadowType](#arkui_shadowtype).<br>.value[2].u32: shadow color, in 0xARGB format.<br>.value[3].f32: offset of the shadow along the x-axis, in vp.<br>.value[4].f32: offset of the shadow along the y-axis, in vp.|
2852| NODE_TEXT_MIN_FONT_SIZE                     | Defines the minimum font size attribute, which can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: minimum font size, in fp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: minimum font size, in fp.|
2853| NODE_TEXT_MAX_FONT_SIZE                     | Defines the maximum font size attribute, which can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: maximum font size, in fp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: maximum font size, in fp.|
2854| NODE_TEXT_FONT                              | Defines the text style attribute, which can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string?: font family. Optional. Use commas (,) to separate multiple fonts.<br>.value[0].f32: font size, in fp.<br>.value[1]? .i32: font weight. Optional. The parameter type is [ArkUI_FontWeight](#arkui_fontweight). The default value is **ARKUI_FONT_WEIGHT_NORMAL**.<br>.value[2]?.i32: font style. Optional. The parameter type is [ArkUI_FontStyle](#arkui_fontstyle). The default value is **ARKUI_FONT_STYLE_NORMAL**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: font family. Use commas (,) to separate multiple fonts.<br>.value[0].f32: font size, in fp.<br>.value[1].i32: font weight. The parameter type is [ArkUI_FontWeight](#arkui_fontweight). The default value is **ARKUI_FONT_WEIGHT_NORMAL**.<br>.value[2].i32: font style. The parameter type is [ArkUI_FontStyle](#arkui_fontstyle). The default value is **ARKUI_FONT_STYLE_NORMAL**.|
2855| NODE_TEXT_HEIGHT_ADAPTIVE_POLICY            | Defines how the adaptive height is determined for the text. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: how the adaptive height is determined for the text. The parameter type is [ArkUI_TextHeightAdaptivePolicy](#arkui_textheightadaptivepolicy).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: how the adaptive height is determined for the text. The parameter type is [ArkUI_TextHeightAdaptivePolicy](#arkui_textheightadaptivepolicy).|
2856| NODE_TEXT_INDENT                            | Defines the indentation of the first line. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: indentation of the first line.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: indentation of the first line.|
2857| NODE_TEXT_WORD_BREAK                        | Defines the line break rule. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: line break rule. The parameter type is [ArkUI_WordBreak](#arkui_wordbreak).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: line break rule. The parameter type is [ArkUI_WordBreak](#arkui_wordbreak).|
2858| NODE_TEXT_ELLIPSIS_MODE                     | Defines the ellipsis position. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: ellipsis position. The parameter type is [ArkUI_EllipsisMode](#arkui_ellipsismode).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: ellipsis position. The parameter type is [ArkUI_EllipsisMode](#arkui_ellipsismode).|
2859| NODE_TEXT_LINE_SPACING                      | Defines the line spacing attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: line spacing, in fp. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: line spacing, in fp. |
2860| NODE_FONT_FEATURE                           | Sets the font feature. **NODE_FONT_FEATURE** provides advanced typographic features in OpenType fonts.<br>These features such as hyphenation and monospace are generally used in custom fonts and require support from the respective fonts. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: string that complies with the text feature format. The format is normal\.| &lt;feature-tag-value&gt;,<br>Syntax for &lt;feature-tag-value&gt;: &lt;string&gt; [ &lt;integer&gt; \| on \| off ],<br>There can be multiple **feature-tag-value** values, separated by commas (,). For example, for the monospace feature, you can pass in **ss01 on**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: font feature. Multiple font features are separated by commas (,).|
2861| NODE_TEXT_ENABLE_DATA_DETECTOR              | Sets whether to enable text recognition.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to enable text recognition. The default value is **false**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to enable text recognition.|
2862| NODE_TEXT_ENABLE_DATA_DETECTOR_CONFIG       | Configures text recognition settings.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0...].i32: entity type array. The parameter type is [ArkUI_TextDataDetectorType](#arkui_textdatadetectortype).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0...].i32: entity type array. The parameter type is [ArkUI_TextDataDetectorType](#arkui_textdatadetectortype).|
2863| NODE_TEXT_SELECTED_BACKGROUND_COLOR         | Defines the background color of the selected text. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: color value, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color value, in 0xARGB format.|
2864| NODE_TEXT_CONTENT_WITH_STYLED_STRING        | Sets the string to use in the styled string. This attribute can be set and obtained as required through APIs. When a custom **OH_Drawing_Typography** object is configured for a **Text** component, the layout measurement phase of the **Text** component is skipped. Below are some tips to handle this issue:<br>1. Ensure that the lifecycle of the **OH_ArkUI_StyledString** object and the **OH_Drawing_Typography** object follows that of the **Text** component. Reset the **OH_ArkUI_StyledString** object when the **Text** component is destroyed; otherwise, a null pointer crash may occur in the application.<br>2. Ensure that the **OH_Drawing_TypographyLayout** API is called before the layout measurement of the **Text** component.<br>3. When releasing the **OH_ArkUI_StyledString** object and the **OH_Drawing_Typography** object, call the **reset** API of the **Text** component. Otherwise, a null pointer crash may occur in the application<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.object: string to use in the styled string. The parameter type is [ArkUI_StyledString](#arkui_styledstring).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: string to use in the styled string. The parameter type is [ArkUI_StyledString](#arkui_styledstring).|
2865| NODE_TEXT_HALF_LEADING                      | Sets whether to center text vertically in the **Text** component.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to center text vertically. The default value is **false**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to center text vertically.|
2866| NODE_SPAN_CONTENT                           | Defines the text content attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: content of the text span.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: content of the text span.|
2867| NODE_SPAN_TEXT_BACKGROUND_STYLE             | Defines the text background style. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: color of the text background, in 0xARGB format, for example, **0xFFFF0000** indicating red.<br>The second parameter is used to set the rounded corner of the text background. The options are as follows:<br>1: .value[1].f32: The radiuses of rounded corners in the four directions are set in a unified manner. The unit is vp.<br>2: .value[1].f32: radius of the upper left corner, in vp.<br>.value[2].f32: radius of the upper right corner, in vp.<br>.value[3].f32: radius of the lower left corner, in vp.<br>.value[4].f32: radius of the lower right corner, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color of the text background, in 0xARGB format.<br>.value[1].f32: radius of the upper left corner, in vp.<br>.value[2].f32: radius of the upper right corner, in vp.<br>.value[3].f32: radius of the lower left corner, in vp.<br>.value[4].f32: radius of the lower right corner, in vp.|
2868| NODE_SPAN_BASELINE_OFFSET                   | Defines the text baseline offset attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: baseline offset, in fp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: baseline offset, in fp.|
2869| NODE_IMAGE_SPAN_SRC                         | Defines the image source for an image span. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: image address of the image span.<br>.object: **PixelMap** object. The parameter type is [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: image address of the image span.<br>.object: **PixelMap** object. The parameter type is [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor). Either **.object** or **.string** must be set.|
2870| NODE_IMAGE_SPAN_VERTICAL_ALIGNMENT          | Defines the alignment mode of the image with the text. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32 indicates the text-based image alignment mode. The enumerated values of [ArkUI_ImageSpanAlignment](#arkui_imagespanalignment) are used.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32 indicates the text-based image alignment mode. The enumerated values of [ArkUI_ImageSpanAlignment](#arkui_imagespanalignment) are used.|
2871| NODE_IMAGE_SPAN_ALT                         | Defines the image source for an image span. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: placeholder image address for the image span. GIF images are not supported.<br>.object: **PixelMap** object. The parameter type is [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor). Either **.object** or **.string** must be set.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: image source for the image span.<br>.object: **PixelMap** object. The parameter type is [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor).|
2872| NODE_IMAGE_SPAN_BASELINE_OFFSET             | Defines the baseline offset attribute of the **ImageSpan** component. This attribute can be set, reset, and obtained as required through APIs. A positive value means an upward offset, while a negative value means a downward offset. The default value is **0**, and the unit is fp.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: baseline offset, in fp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: baseline offset, in fp.|
2873| NODE_IMAGE_SRC                              | Defines the image source of the **Image** component. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: image source.<br>.object: **PixelMap** object. The parameter type is [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor). Either **.object** or **.string** must be set.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: image source.<br>.object: **PixelMap** object. The parameter type is [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor).|
2874| NODE_IMAGE_OBJECT_FIT                       | Defines how the image is resized to fit its container. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32 indicates the image filling effect. The enumerated values of [ArkUI_ObjectFit](#arkui_objectfit) are used.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32 indicates the image filling effect. The enumerated values of [ArkUI_ObjectFit](#arkui_objectfit) are used.|
2875| NODE_IMAGE_INTERPOLATION                    | Defines the interpolation effect of the image. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32 indicates the interpolation effect. The enumerated values of [ArkUI_ImageInterpolation](#arkui_imageinterpolation) are used.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32 indicates the interpolation effect. The enumerated values of [ArkUI_ImageInterpolation](#arkui_imageinterpolation) are used.|
2876| NODE_IMAGE_OBJECT_REPEAT                    | Defines how the image is repeated. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32 indicates the image repetition style. The enumerated values of [ArkUI_ImageRepeat](#arkui_imagerepeat) are used.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32 indicates the image repetition style. The enumerated values of [ArkUI_ImageRepeat](#arkui_imagerepeat) are used.|
2877| NODE_IMAGE_COLOR_FILTER                     | Defines the color filter of the image. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32 to .value[19].f32: filter matrix array.<br>.size: 5 x 4 filter array size.<br>.object: pointer to the color filter. The parameter type is **OH_Drawing_ColorFilter**. Either .object or .size can be set.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32 to .value[19].f32: filter matrix array.<br>.size: 5 x 4 filter array size.<br>.object: pointer to the color filter. The parameter type is **OH_Drawing_ColorFilter**.|
2878| NODE_IMAGE_AUTO_RESIZE                      | Defines the auto resize attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32 : whether to resize the image source.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32 : whether to resize the image source.|
2879| NODE_IMAGE_ALT                              | Defines the placeholder image source. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: image source for the image span.<br>.object: **PixelMap** object. The parameter type is [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor). Either **.object** or **.string** must be set.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: image source for the image span.<br>.object: **PixelMap** object. The parameter type is [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor).|
2880| NODE_IMAGE_DRAGGABLE                        | Defines whether the image is draggable. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether the image is draggable. The value **true** means that the image is draggable.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether the image is draggable.|
2881| NODE_IMAGE_RENDER_MODE                      | Defines the image rendering mode. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: The parameter type is [ArkUI_ImageRenderMode](#arkui_imagerendermode).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: The parameter type is [ArkUI_ImageRenderMode](#arkui_imagerendermode).|
2882| NODE_IMAGE_FIT_ORIGINAL_SIZE                | Sets whether to fit the component to the size of the image source when the component size is not set. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: indicates whether the display size of an image follows the size of the image source. The value 1 indicates that the display size follows the size of the image source, and the value 0 indicates that the display size does not follow the size of the image source. The default value is 0.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: The value **1** means to fit the component to the size of the image source, and **0** means the opposite.|
2883| NODE_IMAGE_FILL_COLOR                       | Sets the fill color to be superimposed on the image. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: fill color. The value is in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: fill color. The value is in 0xARGB format.|
2884| NODE_IMAGE_RESIZABLE                        | Sets the resizable image options.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: width of the left edge. The unit is vp.<br>.value[1].f32: width of the top edge. The unit is vp.<br>.value[2].f32: width of the right edge. The unit is vp.<br>.value[3].f32: width of the bottom edge. The unit is vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: width of the left edge. The unit is vp.<br>.value[1].f32: width of the top edge. The unit is vp.<br>.value[2].f32: width of the right edge. The unit is vp.<br>.value[3].f32: width of the bottom edge. The unit is vp.|
2885| NODE_TOGGLE_SELECTED_COLOR                  | Defines the color of the component when it is selected. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: background color, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: background color, in 0xARGB format.|
2886| NODE_TOGGLE_SWITCH_POINT_COLOR              | Defines the color of the circular slider for the component of the switch type. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: color of the circular slider, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color of the circular slider, in 0xARGB format.|
2887| NODE_TOGGLE_VALUE                           | Defines the toggle switch value. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to enable the toggle. The value **true** means to enable the toggle.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to enable the toggle.|
2888| NODE_TOGGLE_UNSELECTED_COLOR                | Defines the color of the component when it is deselected. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: background color, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: background color, in 0xARGB format.|
2889| NODE_LOADING_PROGRESS_COLOR                 | Defines the foreground color of the loading progress bar. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: foreground color, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: foreground color, in 0xARGB format.|
2890| NODE_LOADING_PROGRESS_ENABLE_LOADING        | Defines whether to show the loading animation for the **LoadingProgress** component. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to show the loading animation. The value **true** means to show the loading animation, and **false** means the opposite.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to show the loading animation. The value **true** means to show the loading animation, and **false** means the opposite.|
2891| NODE_TEXT_INPUT_PLACEHOLDER                 | Defines the default placeholder text of the single-line text box. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: default placeholder text.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: default placeholder text.|
2892| NODE_TEXT_INPUT_TEXT                        | Defines the default text content of the single-line text box. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: default text content.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: default text content.|
2893| NODE_TEXT_INPUT_CARET_COLOR                 | Defines the border color attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: caret color, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: caret color, in 0xARGB format. |
2894| NODE_TEXT_INPUT_CARET_STYLE                 | Defines the caret style attribute. APIs are provided for setting, resetting, and obtaining the attribute value.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: caret width, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: caret width, in vp.|
2895| NODE_TEXT_INPUT_SHOW_UNDERLINE              | Defines the underline attribute of the single-line text box. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to show an underline. The value **true** means to show an underline, and **false** means the opposite.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: The value **1** means to show an underline, and **0** means the opposite.|
2896| NODE_TEXT_INPUT_MAX_LENGTH                  | Defines the maximum number of characters in the text input. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: maximum number of characters in the text input, without a unit.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: maximum number of characters in the text input.|
2897| NODE_TEXT_INPUT_ENTER_KEY_TYPE              | Defines the type of the Enter key. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: Enter key type enumeration [ArkUI_EnterKeyType](#arkui_enterkeytype). The default value is ARKUI_ENTER_KEY_TYPE_DONE.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: type of the Enter key. The value is an enum of [ArkUI_EnterKeyType](#arkui_enterkeytype).|
2898| NODE_TEXT_INPUT_PLACEHOLDER_COLOR           | Defines the placeholder text color. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: color value, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color value, in 0xARGB format.|
2899| NODE_TEXT_INPUT_PLACEHOLDER_FONT            | Defines the placeholder text font. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0]?.f32: font size, in fp. Optional. The default value is **16.0**.<br>.value[1]?.i32: font style [ArkUI_FontStyle](#arkui_fontstyle). Optional. The default value is **ARKUI_FONT_STYLE_NORMAL**.<br>.value[2]?.i32: font weight [ArkUI_FontWeight](#arkui_fontweight). Optional. The default value is **ARKUI_FONT_WEIGHT_NORMAL**.<br>?.string: font family. Multiple font families are separated by commas (,). For example, "font weight; font family 1, font family 2".<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: font size, in fp.<br>.value[1].i32: font style [ArkUI_FontStyle](#arkui_fontstyle).<br>.value[2].i32: font weight [ArkUI_FontWeight](#arkui_fontweight).<br>.string: font family. Multiple font families are separated by commas (,).|
2900| NODE_TEXT_INPUT_ENABLE_KEYBOARD_ON_FOCUS    | Defines whether to enable the input method when the component obtains focus. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to enable the input method when the component obtains focus. The value **true** means to enable the input method, and **false** means the opposite.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to enable the input method when the component obtains focus. The value **1** means to enable the input method when the component obtains focus, and **0** means the opposite.|
2901| NODE_TEXT_INPUT_TYPE                        | Defines the text box type. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: input box type enumeration [ArkUI_TextInputType](#arkui_textinputtype). The default value is ARKUI_TEXTINPUT_TYPE_NORMAL.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: input box type enumeration [ArkUI_TextInputType](#arkui_textinputtype).|
2902| NODE_TEXT_INPUT_SELECTED_BACKGROUND_COLOR   | Defines the background color of the selected text. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: color value, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color value, in 0xARGB format.|
2903| NODE_TEXT_INPUT_SHOW_PASSWORD_ICON          | Defines whether to display the password icon at the end of the password text box. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to display the password icon at the end of the password text box. The value **true** means to display the password icon, and **false** means the opposite.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: The value **1** means to display the password icon at the end of the password text box, and **0** means the opposite.|
2904| NODE_TEXT_INPUT_EDITING                     | Defines the editable state for the single-line text box. This attribute can be set as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to remain in the editable state. The value **true** means to remain in the editable state, and **false** means to exit the editable state.<br>The format of the attribute obtaining method parameter [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) is as follows:<br>.value[0].i32: whether to remain in the editable state. The value **true** means to remain in the editable state, and **false** means to exit the editable state.|
2905| NODE_TEXT_INPUT_CANCEL_BUTTON               | Defines the style of the cancel button on the right of the single-line text box. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: button style [ArkUI_CancelButtonStyle](#arkui_cancelbuttonstyle). The default value is ARKUI_CANCELBUTTON_STYLE_INPUT.<br>.value[1]?.f32: button icon size, in vp.<br>.value[2]?.u32: button icon color, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>?.string: button icon image source. The value is the local address of the image, for example, /pages/icon.png.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: button style [ArkUI_CancelButtonStyle](#arkui_cancelbuttonstyle).<br>.value[1].f32: icon size, in vp.<br>.value[2].u32: button icon color, in 0xARGB format.<br>.string: button icon image source.|
2906| NODE_TEXT_INPUT_TEXT_SELECTION              | Sets the text selection area, which will be highlighted. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: start position of the text selection. <br>.value[1].i32: end position of the text selection. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: start position of the text selection. <br>.value[1].i32: end position of the text selection. |
2907| NODE_TEXT_INPUT_UNDERLINE_COLOR             | Sets the color of the underline when it is shown.<br>The default underline color configured for the theme is **'0x33182431'**.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: color of the underline applied to the text being typed in. The value is in 0xARGB format. <br>.value[1].u32: color of the underline applied to the text in the normal state. The value is in 0xARGB format. <br>.value[2].u32: color of the underline applied to the text when an error is detected. The value is in 0xARGB format. <br>.value[3].u32: color of the underline applied to the text when it is disabled. The value is in 0xARGB format. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color of the underline applied to the text being typed in. The value is in 0xARGB format. <br>.value[1].u32: color of the underline applied to the text in the normal state. The value is in 0xARGB format. <br>.value[2].u32: color of the underline applied to the text when an error is detected. The value is in 0xARGB format. <br>.value[3].u32: color of the underline applied to the text when it is disabled. The value is in 0xARGB format. |
2908| NODE_TEXT_INPUT_ENABLE_AUTO_FILL            | Sets whether to enable autofill.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to enable autofill. The default value is **true**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to enable autofill.|
2909| NODE_TEXT_INPUT_CONTENT_TYPE                | Sets the autofill type.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: autofill type. The parameter type is [ArkUI_TextInputContentType](#arkui_textinputcontenttype).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: autofill type. The parameter type is [ArkUI_TextInputContentType](#arkui_textinputcontenttype).|
2910| NODE_TEXT_INPUT_PASSWORD_RULES              | Defines the rules for generating passwords. When autofill is used, these rules are transparently transmitted to Password Vault for generating a new password.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: rules for generating passwords.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: rules for generating passwords.|
2911| NODE_TEXT_INPUT_SELECT_ALL                  | Sets whether to select all text in the initial state. This attribute is not available for the inline input style.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to select all text in the initial state. The default value is b>false</b>.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to select all text in the initial state.|
2912| NODE_TEXT_INPUT_INPUT_FILTER                | Sets the regular expression for input filtering. Only inputs that comply with the regular expression can be displayed. Other inputs are filtered out. The specified regular expression can match single characters, but not strings.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: regular expression.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: regular expression.|
2913| NODE_TEXT_INPUT_STYLE                       | Sets the text box to the default style or inline input style.<br>For the inline input style, only **InputType.Normal** is supported.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: text input style. The parameter type is [ArkUI_TextInputStyle](#arkui_textinputstyle).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: text input style. The parameter type is [ArkUI_TextInputStyle](#arkui_textinputstyle).|
2914| NODE_TEXT_INPUT_CARET_OFFSET                | Sets or obtains the caret position.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>Sets the position of the caret. .value[0].i32: length from the start of the string to the position where the input cursor is located.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>Returns the position information of the caret. If this API is called when the cursor position is updated in the current frame, value[0].i32 (index value of the cursor position) does not take effect.<br>value[1].f32: X coordinate of the cursor relative to the text box.<br>value[2].f32: Y coordinate of the cursor relative to the text box.|
2915| NODE_TEXT_INPUT_CONTENT_RECT                | Position of the edited text area relative to the component and its size.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>value[0].f32: horizontal coordinate.<br>value[1].f32: vertical coordinate.<br>value[2].f32: content width.<br>value[3].f32: content height.|
2916| NODE_TEXT_INPUT_CONTENT_LINE_COUNT          | Obtains the number of lines of the edited text.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>value[0].i32: number of lines in the edited text.|
2917| NODE_TEXT_INPUT_SELECTION_MENU_HIDDEN       | Sets whether to hide the text selection menu when the text box is long-pressed, double-click, or right-clicked. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to hide the text selection menu when the text box is long-pressed, double-click, or right-clicked. The default value is **false**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to hide the text selection menu when the text box is long-pressed, double-click, or right-clicked.|
2918| NODE_TEXT_INPUT_BLUR_ON_SUBMIT              | Sets whether the text box loses focus after the Enter key is pressed to submit information.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether the text box loses focus.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether the text box loses focus.|
2919| NODE_TEXT_INPUT_CUSTOM_KEYBOARD             | Sets a custom keyboard.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.object: custom keyboard. The parameter type is **ArkUI_NodeHandle**.<br>.value[0]?.i32: whether the custom keyboard supports avoidance. The default value is **false**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: custom keyboard. The parameter type is **ArkUI_NodeHandle**.<br>.value[0].i32: whether the custom keyboard supports avoidance.|
2920| NODE_TEXT_INPUT_WORD_BREAK                  | Defines the line break rule. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: line break rule. The parameter type is [ArkUI_WordBreak](#arkui_wordbreak).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: line break rule. The parameter type is [ArkUI_WordBreak](#arkui_wordbreak).|
2921| NODE_TEXT_INPUT_NUMBER_OF_LINES             | Sets the number of lines in **TextInput** component, which can be used to work out the height of the component.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: number of lines.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: number of lines.|
2922| NODE_TEXT_INPUT_SHOW_KEYBOARD_ON_FOCUS      | Sets whether to show the keyboard when the text box obtains focus. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to show the keyboard when the text box obtains focus.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to show the keyboard when the text box obtains focus.|
2923| NODE_TEXT_AREA_PLACEHOLDER                  | Defines the default placeholder text of the single-line text box. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: default placeholder text.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: default placeholder text.|
2924| NODE_TEXT_AREA_TEXT                         | Defines the default text content for the multi-line text box. The attribute setting, attribute resetting, and attribute obtaining interfaces are supported.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: default text content.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: default text content.|
2925| NODE_TEXT_AREA_MAX_LENGTH                   | Defines the maximum number of characters in the text input. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: maximum number of characters in the text input.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: maximum number of characters in the text input.|
2926| NODE_TEXT_AREA_PLACEHOLDER_COLOR            | Defines the placeholder text color. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: color value, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color value, in 0xARGB format.|
2927| NODE_TEXT_AREA_PLACEHOLDER_FONT             | Defines the placeholder text font. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0]?.f32: font size, in fp. Optional. The default value is **16.0**.<br>.value[1]?.i32: font style [ArkUI_FontStyle](#arkui_fontstyle). Optional. The default value is **ARKUI_FONT_STYLE_NORMAL**.<br>.value[2]?.i32: font weight [ArkUI_FontWeight](#arkui_fontweight). Optional. The default value is **ARKUI_FONT_WEIGHT_NORMAL**.<br>?.string: font family. Multiple font families are separated by commas (,). For example, "font weight; font family 1, font family 2".<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: font size, in fp.<br>.value[1].i32: font style [ArkUI_FontStyle](#arkui_fontstyle).<br>.value[2].i32: font weight [ArkUI_FontWeight](#arkui_fontweight).<br>.string: font family. Multiple font families are separated by commas (,).|
2928| NODE_TEXT_AREA_CARET_COLOR                  | Defines the border color attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: background color, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: background color, in 0xARGB format.|
2929| NODE_TEXT_AREA_EDITING                      | Defines the editable state for the multi-line text box. This attribute can be set as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to remain in the editable state. The value **true** means to remain in the editable state, and **false** means to exit the editable state.<br>The format of the attribute obtaining method parameter [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) is as follows:<br>.value[0].i32: whether to remain in the editable state. The value **true** means to remain in the editable state, and **false** means to exit the editable state.|
2930| NODE_TEXT_AREA_TYPE                         | Defines the text box type. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: input box type enumeration [ArkUI_TextAreaType](#arkui_textareatype). The default value is ARKUI_TEXTAREA_TYPE_NORMAL.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: input box type enumeration [ArkUI_TextAreaType](#arkui_textareatype).|
2931| NODE_TEXT_AREA_SHOW_COUNTER                 | Defines the counter settings. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to show a character counter. The value **true** means to show a character counter.<br>.value[1]?.f32: threshold percentage for displaying the character counter. The character counter is displayed when the number of characters that have been entered is greater than the maximum number of characters multiplied by the threshold percentage value. The value range is 1 to 100. If the value is a decimal, it is rounded down.<br>.value[2]?.i32: whether to highlight the border when the number of entered characters reaches the maximum.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to show a character counter.<br>.value[1].f32: threshold percentage for displaying the character counter. The character counter is displayed when the number of characters that have been entered is greater than the maximum number of characters multiplied by the threshold percentage value. The value range is 1 to 100.<br>.value[2].i32: whether to highlight the border when the number of entered characters reaches the maximum. The default value is **true**.|
2932| NODE_TEXT_AREA_SELECTION_MENU_HIDDEN        | Sets whether to hide the text selection menu when the text box is long-pressed, double-click, or right-clicked. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to hide the text selection menu when the text box is long-pressed, double-click, or right-clicked. The default value is **false**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to hide the text selection menu when the text box is long-pressed, double-click, or right-clicked.|
2933| NODE_TEXT_AREA_BLUR_ON_SUBMIT               | Sets whether the multi-line text box loses focus after the Enter key is pressed to submit information.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether the text box loses focus.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether the text box loses focus.|
2934| NODE_TEXT_AREA_INPUT_FILTER                 | Sets the regular expression for input filtering. Only inputs that comply with the regular expression can be displayed. Other inputs are filtered out. The specified regular expression can match single characters, but not strings.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: regular expression.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: regular expression.|
2935| NODE_TEXT_AREA_SELECTED_BACKGROUND_COLOR    | Sets the background color of the selected text. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: color value, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color value, in 0xARGB format.|
2936| NODE_TEXT_AREA_ENTER_KEY_TYPE               | Defines the type of the Enter key. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: Enter key type enumeration [ArkUI_EnterKeyType](#arkui_enterkeytype). The default value is ARKUI_ENTER_KEY_TYPE_DONE.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: type of the Enter key. The value is an enum of [ArkUI_EnterKeyType](#arkui_enterkeytype).|
2937| NODE_TEXT_AREA_ENABLE_KEYBOARD_ON_FOCUS     | Sets whether to enable the input method when the multi-line text box obtains focus in a way other than clicking. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to enable the input method when the multi-line text box obtains focus in a way other than clicking. The value **true** means to enable the input method, and **false** means the opposite. The default value is **false**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to enable the input method when the component obtains focus. The value **1** means to enable the input method when the component obtains focus, and **0** means the opposite.|
2938| NODE_TEXT_AREA_CARET_OFFSET                 | Sets or obtains the caret position.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>Sets the position of the caret. .value[0].i32: length from the start of the string to the position where the input cursor is located.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>Returns the position information of the caret. If this API is called when the cursor position is updated in the current frame, value[0].i32 (index value of the cursor position) does not take effect.<br>value[1].f32: X coordinate of the cursor relative to the text box.<br>value[2].f32: Y coordinate of the cursor relative to the text box.|
2939| NODE_TEXT_AREA_CONTENT_RECT                 | Position of the edited text area relative to the component and its size.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>value[0].f32: horizontal coordinate.<br>value[1].f32: vertical coordinate.<br>value[2].f32: content width.<br>value[3].f32: content height.|
2940| NODE_TEXT_AREA_CONTENT_LINE_COUNT           | Obtains the number of lines of the edited text.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>value[0].i32: number of lines in the edited text.|
2941| NODE_TEXT_AREA_TEXT_SELECTION               | Sets the text selection range and highlights the selected text when the component is focused. This API works only when the value of **selectionStart** is less than that of **selectionEnd**.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: start position of the text selection. <br>.value[1].i32: end position of the text selection. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: start position of the text selection. <br>.value[1].i32: end position of the text selection. |
2942| NODE_TEXT_AREA_ENABLE_AUTO_FILL             | Sets whether to enable autofill.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to enable autofill. The default value is **true**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to enable autofill.|
2943| NODE_TEXT_AREA_CONTENT_TYPE                 | Enumerates the content types for autofill.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: autofill type. The parameter type is [ArkUI_TextInputContentType](#arkui_textinputcontenttype).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: autofill type. The parameter type is [ArkUI_TextInputContentType](#arkui_textinputcontenttype).|
2944| NODE_TEXT_AREA_NUMBER_OF_LINES              | Sets the number of lines in **TextArea** component, which can be used to work out the height of the component.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: number of lines.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: number of lines.|
2945| NODE_TEXT_AREA_SHOW_KEYBOARD_ON_FOCUS       | Sets whether to show the keyboard when the text box obtains focus. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to show the keyboard when the text box obtains focus.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to show the keyboard when the text box obtains focus.|
2946| NODE_BUTTON_LABEL                           | Defines the button text content. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: default text content.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: default text content.|
2947| NODE_BUTTON_TYPE                            | Sets the button type. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: button style. The parameter type is [ArkUI_ButtonType](#arkui_buttontype). The default value is ARKUI_BUTTON_TYPE_CAPSULE.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: Obtains the style of the button. The parameter type is [ArkUI_ButtonType](#arkui_buttontype). The default value is ARKUI_BUTTON_TYPE_CAPSULE.|
2948| NODE_PROGRESS_VALUE                         | Defines the current value of the progress indicator. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: current value of the progress indicator.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: current value of the progress indicator.|
2949| NODE_PROGRESS_TOTAL                         | Defines the total value of the progress indicator. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: total value of the progress indicator.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: total value of the progress indicator.|
2950| NODE_PROGRESS_COLOR                         | Defines the color for the progress value on the progress indicator. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: color value, in 0xARGB format. For example, 0xFFFF0000 indicates red.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color value, in 0xARGB format.|
2951| NODE_PROGRESS_TYPE                          | Defines the type of the progress indicator. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: progress bar type. The enumerated value is [ArkUI_ProgressType](#arkui_progresstype). The default value is ARKUI_PROGRESS_TYPE_LINEAR.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: progress bar type enumeration value [ArkUI_ProgressType](#arkui_progresstype).|
2952| NODE_CHECKBOX_SELECT                        | Defines whether the check box is selected. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether the check box is selected. The value **1** means that the check box is selected, and **0** means the opposite.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether the check box is selected. The value **1** means that the check box is selected, and **0** means the opposite.|
2953| NODE_CHECKBOX_SELECT_COLOR                  | Defines the color of the check box when it is selected. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color of the check box when it is selected, in 0xARGB format, for example, **0xFF1122FF**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color of the check box when it is selected, in 0xARGB format, for example, **0xFF1122FF**.|
2954| NODE_CHECKBOX_UNSELECT_COLOR                | Defines the border color of the check box when it is not selected. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: border color, in 0xARGB format, for example, **0xFF1122FF**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: border color, in 0xARGB format, for example, **0xFF1122FF**.|
2955| NODE_CHECKBOX_MARK                          | Defines the internal icon style of the check box. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: border color, in 0xARGB format, for example, **0xFF1122FF**.<br>.value[1]?.f32: size of the internal mark, in vp. Optional.<br>.value[2]?.f32: stroke width of the internal mark, in vp. Optional. The default value is **2**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: border color, in 0xARGB format, for example, **0xFF1122FF**.<br>.value[1].f32: size of the internal mark, in vp. <br>.value[2].f32: stroke width of the internal mark, in vp. The default value is **2**.|
2956| NODE_CHECKBOX_SHAPE                         | Defines the shape of the check box. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: component shape. The parameter type is [ArkUI_CheckboxShape](#arkui_checkboxshape).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: component shape. The parameter type is [ArkUI_CheckboxShape](#arkui_checkboxshape).|
2957| NODE_XCOMPONENT_ID                          | Defines the ID of the **XComponent** component. This attribute can be set and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: component ID.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: component ID.|
2958| NODE_XCOMPONENT_TYPE                        | Defines the type of the **XComponent** component. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: type. The parameter type is [ArkUI_XComponentType](#arkui_xcomponenttype). The default value is **ARKUI_XCOMPONENT_TYPE_SURFACE**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: type. The parameter type is [ArkUI_XComponentType](#arkui_xcomponenttype).|
2959| NODE_XCOMPONENT_SURFACE_SIZE                | Defines the width and height of the **XComponent** component. This attribute can be set and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: width, in px. <br>.value[1].u32: height, in px. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: width, in px. <br>.value[1].u32: height, in px. |
2960| NODE_DATE_PICKER_LUNAR                      | Defines whether to display the lunar calendar in the date picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to display the lunar calendar in the date picker. The default value is **false**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to display the lunar calendar in the date picker.|
2961| NODE_DATE_PICKER_START                      | Defines the start date of the date picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: date. The default value is **"1970-1-1"**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: date.|
2962| NODE_DATE_PICKER_END                        | Defines the end date of the date picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: date. The default value is **"2100-12-31"**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: date.|
2963| NODE_DATE_PICKER_SELECTED                   | Defines the selected date of the date picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: date. The default value is **"2024-01-22"**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: date.|
2964| NODE_DATE_PICKER_DISAPPEAR_TEXT_STYLE       | Defines the font color, font size, and font weight for the top and bottom items in the date picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.|
2965| NODE_DATE_PICKER_TEXT_STYLE                 | Defines the font color, font size, and font weight of all items except the top, bottom, and selected items in the date picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.|
2966| NODE_DATE_PICKER_SELECTED_TEXT_STYLE        | Defines the font color, font size, and font weight of the selected item in the date picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.|
2967| NODE_TIME_PICKER_SELECTED                   | Defines the time of the selected item. in the timer picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: time. The default value is the current system time.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: time.|
2968| NODE_TIME_PICKER_USE_MILITARY_TIME          | Defines whether the display time is in 24-hour format. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether the display time is in 24-hour format. The default value is **false**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether the display time is in 24-hour format.|
2969| NODE_TIME_PICKER_DISAPPEAR_TEXT_STYLE       | Defines the font color, font size, and font weight for the top and bottom items in the time picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.|
2970| NODE_TIME_PICKER_TEXT_STYLE                 | Defines the font color, font size, and font weight of all items except the top, bottom, and selected items in the time picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.|
2971| NODE_TIME_PICKER_SELECTED_TEXT_STYLE        | Defines the font color, font size, and font weight of the selected item in the time picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.|
2972| NODE_TEXT_PICKER_OPTION_RANGE               | Defines the data selection range of the text picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: type of the used selector [ArkUI_TextPickerRangeType](#arkui_textpickerrangetype). The default value is ARKUI_TEXTPICKER_RANGETYPE_SINGLE.<br>?.string: string input, whose format varies by picker type.<br>1: single-column picker. The input format is a group of strings separated by semicolons (;).<br>2: multi-column picker. Multiple pairs of plain text strings are supported. The pairs are separated by semicolons (;), and strings within each pair are separated by commas (,).<br>?.object: Object input, whose format varies by picker type.<br>1: A single column supports the image selector. The input structure is [ARKUI_TextPickerRangeContent](_a_r_k_u_i___text_picker_range_content.md).<br>2: multi-column linkage selector. The input structure is [ARKUI_TextPickerCascadeRangeContent](_a_r_k_u_i___text_picker_cascade_range_content.md).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: type of the text picker [ArkUI_TextPickerRangeType](#arkui_textpickerrangetype).<br>?.string: string output, whose format varies by picker type.<br>1: single-column picker. The output format is a group of strings separated by semicolons (;).<br>2: multi-column picker. Multiple pairs of plain text strings are supported. The pairs are separated by semicolons (;), and strings within each pair are separated by commas (,).<br>?.string: Object output, whose format varies by picker type.<br>1: A single column supports the image selector. The output structure is [ARKUI_TextPickerRangeContent](_a_r_k_u_i___text_picker_range_content.md).<br>2: multi-column linkage selector. The output structure is [ARKUI_TextPickerCascadeRangeContent](_a_r_k_u_i___text_picker_cascade_range_content.md).|
2973| NODE_TEXT_PICKER_OPTION_SELECTED            | Defines the index of the default selected item in the data selection range of the text picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: index. If there are multiple index values, add them one by one.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: index. If there are multiple index values, add them one by one.|
2974| NODE_TEXT_PICKER_OPTION_VALUE               | Defines the value of the default selected item in the text picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: value of the selected item. If there are multiple values, add them one by one and separate them with semicolons (;).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: value of the selected item. If there are multiple values, add them one by one and separate them with semicolons (;).|
2975| NODE_TEXT_PICKER_DISAPPEAR_TEXT_STYLE       | Defines the font color, font size, and font weight for the top and bottom items in the text picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.|
2976| NODE_TEXT_PICKER_TEXT_STYLE                 | Defines the font color, font size, and font weight for all items except the top, bottom, and selected items in the text picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: font color, in ::argb format.<br>Parameter 2: font size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.|
2977| NODE_TEXT_PICKER_SELECTED_TEXT_STYLE        | Defines the font color, font size, and font weight of the selected item in the text picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Input parameter 1: text color. The value is of the argb type.<br>Input parameter 2: text size, in fp. The value is a number.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: fonts, separated by commas (,).<br>Parameter 5: font style. Available options are ("normal", "italic").<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: array of five parameters of the string type, separated by semicolons (;).<br>Parameter 1: text color. The value is of the argb type.<br>Parameter 2: text size. The value is a number, and the unit is fp.<br>Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").<br>Parameter 4: text font list, which is separated by commas (,).<br>Parameter 5: text style, string enumeration ("normal", "italic")<br>Example: **"\#ff182431;14;normal;Arial,HarmonyOS Sans;normal"**.|
2978| NODE_TEXT_PICKER_SELECTED_INDEX             | Defines the index of the default selected item in the data selection range of the text picker. This attribute can be set, reset, and obtained as required through APIs.<br>[ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter type. The options are as follows:<br>.value[0...].i32: index of the default item in the data selection range.|
2979| NODE_TEXT_PICKER_CAN_LOOP                   | Defines whether to support scroll looping for the text picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to support scroll looping. The value **true** means to support scroll looping, and **false** means the opposite.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>value[0].i32: The value **1** means to support scroll looping, and **0** means the opposite.|
2980| NODE_TEXT_PICKER_DEFAULT_PICKER_ITEM_HEIGHT | Defines the height of each item in the picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>value[0].f32: item height, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>value[0].f32: item height, in vp.|
2981| NODE_CALENDAR_PICKER_HINT_RADIUS            | Defines the style of the background in the selected state of the calendar picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: radius of the rounded corner of the bottom plate when the calendar is selected. The value range is [0, +∞). The value 0 indicates that the bottom plate style is a right-angle rectangle. The value range is (0, 16), indicating that the bottom plate style is a rounded rectangle. If the value range is [16, +∞), the bottom plate style is round.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: radius of the rounded corner of the bottom plate when the calendar is selected. The value range is [0, +∞). The value 0 indicates that the bottom plate style is a right-angle rectangle. The value range is (0, 16), indicating that the bottom plate style is a rounded rectangle. If the value range is [16, +∞), the bottom plate style is round.|
2982| NODE_CALENDAR_PICKER_SELECTED_DATE          | Defines the date of the selected item in the calendar picker. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: year of the selected date.<br>.value[1].u32: month of the selected date.<br>.value[2].u32: day of the selected date.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: year of the selected date.<br>.value[1].u32: month of the selected date.<br>.value[2].u32: day of the selected date.|
2983| NODE_CALENDAR_PICKER_EDGE_ALIGNMENT         | Defines how the calendar picker is aligned with the entry component. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: alignment mode type. The parameter type is [ArkUI_CalendarAlignment](#arkui_calendaralignment).<br>.value[1].f32: offset of the picker relative to the entry component along the x-axis after alignment based on the specified alignment mode.<br>.value[2].f32: offset of the picker relative to the entry component along the y-axis after alignment based on the specified alignment mode.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: alignment mode type. The parameter type is [ArkUI_CalendarAlignment](#arkui_calendaralignment).<br>.value[1].f32: offset of the picker relative to the entry component along the x-axis after alignment based on the specified alignment mode.<br>.value[2].f32: offset of the picker relative to the entry component along the y-axis after alignment based on the specified alignment mode.|
2984| NODE_CALENDAR_PICKER_TEXT_STYLE             | Defines the font color, font size, and font weight in the entry area of the calendar picker.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0]?.u32: font color of the entry area.<br>.value[1]?.f32: font size of the entry area, in fp.<br>.value[2]?.i32: font weight of the text in the entry area. The parameter type is [ArkUI_FontWeight](#arkui_fontweight).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: font color of the entry area.<br>.value[1].f32: font size of the entry area, in fp.<br>.value[2].i32: font weight of the text in the entry area. The parameter type is [ArkUI_FontWeight](#arkui_fontweight).|
2985| NODE_SLIDER_BLOCK_COLOR                     | Defines the color of the slider. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color of the slider, in 0xARGB format, for example, **0xFF1122FF**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color of the slider, in 0xARGB format, for example, **0xFF1122FF**.|
2986| NODE_SLIDER_TRACK_COLOR                     | Defines the background color of the slider. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: background color, in 0xARGB format, for example, **0xFF1122FF**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: background color, in 0xARGB format, for example, **0xFF1122FF**.|
2987| NODE_SLIDER_SELECTED_COLOR                  | Defines the color of the selected part of the slider track. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color of the selected part of the slider track, in 0xARGB format, for example, **0xFF1122FF**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color of the selected part of the slider track, in 0xARGB format, for example, **0xFF1122FF**.|
2988| NODE_SLIDER_SHOW_STEPS                      | Sets whether to display the step scale value. Attributes can be set, reset, and obtained.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to display the stepping value. The value **1** means to display the stepping value, and **0** (default value) means the opposite.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to display the stepping value. The value **1** means to display the stepping value, and **0** (default value) means the opposite.|
2989| NODE_SLIDER_BLOCK_STYLE                     | Defines the slider shape, which can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: shape. The parameter type is [ArkUI_SliderBlockStyle](#arkui_sliderblockstyle).<br>.string? depending on the shape. Optional.<br>ARKUI_SLIDER_BLOCK_STYLE_IMAGE: image resource of the slider. Example: /pages/common/icon.png.<br>ARKUI_SLIDER_BLOCK_STYLE_SHAPE: custom shape of the slider.<br>There are five types:<br>1. Rectangle:<br>.value[1].i32: cropping type. The parameter type is [ArkUI_ShapeType](#arkui_shapetype), ARKUI_SHAPE_TYPE_RECTANGLE.<br>.value[2].f32: height of the rectangle.<br>.value[3].f32: height of the rectangle.<br>.value[4].f32: height of the rounded corner of the rectangle.<br>.value[5].f32: height of the rounded corner of the rectangle.<br>2. Circle:<br>.value[1].i32: cropping type. The parameter type is [ArkUI_ShapeType](#arkui_shapetype), ARKUI_SHAPE_TYPE_CIRCLE.<br>.value[2].f32: height of the circle.<br>.value[3].f32: height of the circle.<br>3. Ellipse:<br>.value[1].i32: cropping type. The parameter type is [ArkUI_ShapeType](#arkui_shapetype), ARKUI_SHAPE_TYPE_ELLIPSE.<br>.value[2].f32: height of the ellipse.<br>.value[3].f32: height of the ellipse.<br>4. Path:<br>.value[1].i32: cropping type. The parameter type is [ArkUI_ShapeType](#arkui_shapetype), ARKUI_SHAPE_TYPE_PATH.<br>.value[2].f32: width of the path.<br>.value[3].f32: height of the path.<br>.string: command for drawing the path.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: shape. The parameter type is [ArkUI_SliderBlockStyle](#arkui_sliderblockstyle).<br>.string? depending on the shape. Optional.<br>ARKUI_SLIDER_BLOCK_STYLE_IMAGE: image resource of the slider. Example: /pages/common/icon.png.<br>ARKUI_SLIDER_BLOCK_STYLE_SHAPE: custom shape of the slider.<br>There are five types:<br>1. Rectangle:<br>.value[1].i32: cropping type. The parameter type is [ArkUI_ShapeType](#arkui_shapetype), ARKUI_SHAPE_TYPE_RECTANGLE.<br>.value[2].f32: height of the rectangle.<br>.value[3].f32: height of the rectangle.<br>.value[4].f32: height of the rounded corner of the rectangle.<br>.value[5].f32: height of the rounded corner of the rectangle.<br>2. Circle:<br>.value[1].i32: cropping type. The parameter type is [ArkUI_ShapeType](#arkui_shapetype), ARKUI_SHAPE_TYPE_CIRCLE.<br>.value[2].f32: height of the circle.<br>.value[3].f32: height of the circle.<br>3. Ellipse:<br>.value[1].i32: cropping type. The parameter type is [ArkUI_ShapeType](#arkui_shapetype), ARKUI_SHAPE_TYPE_ELLIPSE.<br>.value[2].f32: height of the ellipse.<br>.value[3].f32: height of the ellipse.<br>4. Path:<br>.value[1].i32: cropping type. The parameter type is [ArkUI_ShapeType](#arkui_shapetype), ARKUI_SHAPE_TYPE_PATH.<br>.value[2].f32: width of the path.<br>.value[3].f32: height of the path.<br>.string: command for drawing the path.|
2990| NODE_SLIDER_VALUE                           | Defines the current value of the slider. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: current value.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: current value.|
2991| NODE_SLIDER_MIN_VALUE                       | Defines the minimum value of the slider. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: minimum value.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: minimum value.|
2992| NODE_SLIDER_MAX_VALUE                       | Defines the maximum value of the slider. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: maximum value.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: maximum value.|
2993| NODE_SLIDER_STEP                            | Defines the step of the slider. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: step. The value range is [0.01, 100].<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: step. The value range is [0.01, 100].|
2994| NODE_SLIDER_DIRECTION                       | Defines whether the slider moves horizontally or vertically. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: display style. The parameter type is [ArkUI_SliderDirection](#arkui_sliderdirection).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: display style. The parameter type is [ArkUI_SliderDirection](#arkui_sliderdirection).|
2995| NODE_SLIDER_REVERSE                         | Defines whether the slider values are reversed. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether the slider values are reversed. The value **1** means that the slider values are reversed, and **0** means the opposite.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether the slider values are reversed. The value **1** means that the slider values are reversed, and **0** means the opposite.|
2996| NODE_SLIDER_STYLE                           | Defines the style of the slider thumb and track. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: display style. The parameter type is [ArkUI_SliderStyle](#arkui_sliderstyle).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: display style. The parameter type is [ArkUI_SliderStyle](#arkui_sliderstyle).|
2997| NODE_SLIDER_TRACK_THICKNESS                 | Sets the track thickness of the slider. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: track thickness of the slider, in vp. The default value is 4.0 vp when **NODE_SLIDER_STYLE** is set to **ARKUI_SLIDER_STYLE_OUT_SET** and 20.0 vp when **NODE_SLIDER_STYLE** is set to **ARKUI_SLIDER_STYLE_IN_SET**. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: track thickness of the slider, in vp. |
2998| NODE_RADIO_CHECKED                          | Sets whether the radio button is selected. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether the radio button is selected. The default value is **false**. Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether the radio button is selected.|
2999| NODE_RADIO_STYLE                            | Sets the style of the radio button in selected or deselected state. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0]?.u32: color of the background when the radio button is selected, in 0xARGB format. The default value is **0xFF007DFF**.<br>.value[1]?.u32: color of the border when the radio button is deselected, in 0xARGB format. The default value is **0xFF182431**.<br>.value[2]?.u32: color of the indicator when the radio button is selected, in 0xARGB format. The default value is **0xFFFFFFFF**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color of the background when the radio button is selected, in 0xARGB format. The default value is **0xFF007DFF**.<br>.value[1].u32: color of the border when the radio button is deselected, in 0xARGB format. The default value is **0xFF182431**.<br>.value[2].u32: color of the indicator when the radio button is selected, in 0xARGB format. The default value is **0xFFFFFFF**.|
3000| NODE_RADIO_VALUE                            | Sets the current value of the radio button. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: value of the option button.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: value of the option button.|
3001| NODE_RADIO_GROUP                            | Sets the name of the group to which the radio button belongs. Only one radio button in a given group can be selected at a time. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: name of the group to which the radio button belongs. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: name of the group to which the radio button belongs. |
3002| NODE_STACK_ALIGN_CONTENT                    | Defines the alignment mode of the child components in the container. This attribute can be set, reset, and obtained as required through APIs.<br>If this attribute and the universal attribute **NODE_ALIGNMENT** are both set, whichever is set later takes effect.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: alignment mode. The parameter type is [ArkUI_Alignment](#arkui_alignment). The default value is **ARKUI_ALIGNMENT_CENTER**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: alignment mode. The parameter type is [ArkUI_Alignment](#arkui_alignment).|
3003| NODE_SCROLL_BAR_DISPLAY_MODE                | Defines the scrollbar status. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: scroll bar status. The data type is [ArkUI_ScrollBarDisplayMode](#arkui_scrollbardisplaymode), and the default value is ARKUI_SCROLL_BAR_DISPLAY_MODE_AUTO.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: scroll bar status. The data type is [ArkUI_ScrollBarDisplayMode](#arkui_scrollbardisplaymode).|
3004| NODE_SCROLL_BAR_WIDTH                       | Defines the width of the scrollbar. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: width of the scrollbar, in vp. The default value is **4**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: width of the scrollbar, in vp.|
3005| NODE_SCROLL_BAR_COLOR                       | Defines the color of the scrollbar. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.data[0].u32: color of the scrollbar, in 0xARGB format.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.data[0].u32: color of the scrollbar, in 0xARGB format.|
3006| NODE_SCROLL_SCROLL_DIRECTION                | Defines the scroll direction. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: scrolling direction. The data type is [ArkUI_ScrollDirection](#arkui_scrolldirection), and the default value is ARKUI_SCROLL_DIRECTION_VERTICAL.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: scrolling direction. The data type is [ArkUI_ScrollDirection](#arkui_scrolldirection).|
3007| NODE_SCROLL_EDGE_EFFECT                     | Defines the effect used at the edges of the component when the boundary of the scrollable content is reached. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: edge sliding effect. The parameter type is [ArkUI_EdgeEffect](#arkui_edgeeffect). The default value is ARKUI_EDGE_EFFECT_NONE.<br>.value[1]?.i32: whether to enable the scroll effect when the component content size is smaller than the component itself. Optional. The value **1** means to enable the scroll effect, and **0** means the opposite. The default value is **1**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: edge sliding effect. The parameter type is [ArkUI_EdgeEffect](#arkui_edgeeffect).<br>.value[1].i32: whether to enable the scroll effect when the component content size is smaller than the component itself. The value **1** means to enable the scroll effect, and **0** means the opposite.|
3008| NODE_SCROLL_ENABLE_SCROLL_INTERACTION       | Sets whether to support scroll gestures. When this attribute is set to **false**, scrolling by finger or mouse is not supported, but the scroll controller API is not affected.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to support scroll gestures. The default value is **true**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to support scroll gestures.|
3009| NODE_SCROLL_FRICTION                        | Sets the friction coefficient. It applies only to gestures in the scrolling area, and it affects only indirectly the scroll chaining during the inertial scrolling process.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: friction coefficient. The default value is **0.6** for non-wearable devices and **0.9** for wearable devices.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: friction coefficient.|
3010| NODE_SCROLL_SNAP                            | Defines the scroll snapping mode. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: limit scrolling mode of the scroll component. The data type is [ArkUI_ScrollSnapAlign](#arkui_scrollsnapalign), and the default value is ARKUI_SCROLL_SNAP_ALIGN_NONE.<br>.value[1].i32: whether to enable the snap to start feature. When scroll snapping is defined for the **Scroll** component, setting this attribute to **false** enables the component to scroll between the start edge and the first snap point. The default value is **true**. It is valid only when there are multiple snap points.<br>.value[2].i32: Whether to enable the snap to end feature. When scroll snapping is defined for the **Scroll** component, setting this attribute to **false** enables the component to scroll between the end edge and the last snap point. The default value is **true**. It is valid only when there are multiple snap points.<br>.value[3...].f32: snap points for the **Scroll** component. Each snap point defines the offset from an edge to which the **Scroll** component can scroll. The value can be one or more.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: alignment mode for the scroll snap position. The parameter type is [ArkUI_ScrollSnapAlign](#arkui_scrollsnapalign).<br>.value[1].i32: whether to enable the snap to start feature. When scroll snapping is defined for the **Scroll** component, setting this attribute to **false** enables the component to scroll between the start edge and the first snap point.<br>.value[2].i32: Whether to enable the snap to end feature. When scroll snapping is defined for the **Scroll** component, setting this attribute to **false** enables the component to scroll between the end edge and the last snap point.<br>.value[3...].f32: snap points for the **Scroll** component. Each snap point defines the offset from an edge to which the **Scroll** component can scroll.|
3011| NODE_SCROLL_NESTED_SCROLL                   | Defines the nested scrolling options. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: nested scrolling when the scrollable component scrolls to the end. The parameter type is [ArkUI_ScrollNestedMode](#arkui_scrollnestedmode).<br>.value[1].i32: nested scrolling when the scrollable component scrolls to the start end. The parameter type is [ArkUI_ScrollNestedMode](#arkui_scrollnestedmode).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: nested scrolling when the scrollable component scrolls to the end. The parameter type is [ArkUI_ScrollNestedMode](#arkui_scrollnestedmode).<br>.value[1].i32: nested scrolling when the scrollable component scrolls to the start end. The parameter type is [ArkUI_ScrollNestedMode](#arkui_scrollnestedmode).|
3012| NODE_SCROLL_OFFSET                          | Defines the specified position to scroll to. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: horizontal scrolling offset, in vp.<br>.value[1].f32: vertical scrolling offset, in vp.<br>.value[2]?.i32: scrolling duration, in milliseconds. Optional.<br>.value[3]?.i32: (optional) scrolling curve. The parameter type is [ArkUI_AnimationCurve](#arkui_animationcurve). The default value is **ARKUI_CURVE_EASE**.<br>.value[4]?.i32: whether to enable the default spring animation. Optional. The default value **0** means not to enable the default spring animation.<br>.value[5]?.i32: whether to enable overscroll. Optional.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: horizontal scrolling offset, in vp.<br>.value[1].f32: vertical scrolling offset, in vp.|
3013| NODE_SCROLL_EDGE                            | Defines the edge position to scroll to. This attribute can be set and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: container edge. The parameter type is [ArkUI_ScrollEdge](#arkui_scrolledge).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: indicates whether the container is on the edge. The value -1 indicates that the container is not on the edge. If the container is on the edge, the status parameter type is [ArkUI_ScrollEdge](#arkui_scrolledge).|
3014| NODE_SCROLL_ENABLE_PAGING                   | Defines whether to enable the swipe-to-turn-pages feature. This attribute can be set, reset, and obtained as required through APIs.<br>If both **enablePaging** and **scrollSnap** are set, **scrollSnap** takes effect, but **enablePaging** does not.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to enable the swipe-to-turn-pages feature. The default value is **false**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to enable the swipe-to-turn-pages feature.|
3015| NODE_SCROLL_PAGE                            | Scrolls to the next or previous page.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to scroll to the next page. The value **0** means to scroll to the next page, and **1** means to scroll to the previous page.<br>.value[1]?.i32: whether to enable the page turning animation. The value **1** means to enable the page turning animation, and **0** means the opposite. Default value: 0.|
3016| NODE_SCROLL_BY                              | Scrolls by the specified amount.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: amount to scroll by in the horizontal direction, in vp by default. <br>.value[1].f32: amount to scroll by in the vertical direction, in vp by default.|
3017| NODE_SCROLL_FLING                           | Performs inertial scrolling based on the initial velocity passed in.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: initial velocity of inertial scrolling. The default unit is vp/s. If the value specified is 0, it is considered as invalid, and the scrolling for this instance will not take effect. If the value is positive, the scroll will move downward; if the value is negative, the scroll will move upward.|
3018| NODE_SCROLL_FADING_EDGE                     | Sets the edge fade effect for the scrollable component.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to enable the edge fade effect. The value **0** means to disable edge fade effect, and **1** means the opposite.<br>.value[1]?.f32: length of the edge fade effect, in vp. The default value is **32**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to enable the edge fade effect. The value **0** means to disable edge fade effect, and **1** means the opposite.<br>.value[1].f32: length of the edge fade effect, in vp.<br>**Since**: 14|
3019| NODE_LIST_DIRECTION                         | Defines the direction in which the list items are arranged. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: direction in which the list items are arranged. The parameter type is [ArkUI_Axis](#arkui_axis). The default value is **ARKUI_AXIS_VERTICAL**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: direction in which the list items are arranged. The parameter type is [ArkUI_Axis](#arkui_axis).|
3020| NODE_LIST_STICKY                            | Defines whether to pin the header to the top or the footer to the bottom in the **ListItemGroup** component. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to pin the header to the top or the footer to the bottom in the **ListItemGroup** component. It is used together with the **ListItemGroup** component. Data type [ArkUI_StickyStyle](#arkui_stickystyle). The default value is **ARKUI_STICKY_STYLE_NONE**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to pin the header to the top or the footer to the bottom in the **ListItemGroup** component. It is used together with the **ListItemGroup** component. The parameter type is [ArkUI_StickyStyle](#arkui_stickystyle).|
3021| NODE_LIST_SPACE                             | Defines the spacing between list items. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: spacing between list items along the main axis. The default value is **0**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: spacing between list items along the main axis.|
3022| NODE_LIST_NODE_ADAPTER                      | Defines the list adapter. The attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.object: **ArkUI_NodeAdapter** object as the adapter.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: **ArkUI_NodeAdapter** object.|
3023| NODE_LIST_CACHED_COUNT                      | Sets the number of cached items in the list adapter. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: number of cached items in the list adapter. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: number of cached items in the list adapter.|
3024| NODE_LIST_SCROLL_TO_INDEX                   | Slide to the specified index.<br>When **smooth** is set to **true**, all passed items are loaded and counted in layout calculation. This may result in performance issues if a large number of items are involved.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: index of the item to be scrolled to in the container.<br>.value[1]?.i32: whether to enable the smooth animation for scrolling to the item with the specified index. The value **1** means to enable the animation, and **0** means the opposite. Default value: 0.<br>.value[2]?.i32: how the item to scroll to is aligned with the container. The parameter type is [ArkUI_ScrollAlignment](#arkui_scrollalignment). The default value is **ARKUI_SCROLL_ALIGNMENT_START**.|
3025| NODE_LIST_ALIGN_LIST_ITEM                   | Sets the alignment mode of list items along the cross axis when the cross-axis width of the list is greater than the cross-axis width of list items multiplied by the value of lanes. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: alignment mode of list items along the cross axis. The parameter type is **ArkUI_ListItemAlign**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: alignment mode of list items along the cross axis. The parameter type is **ArkUI_ListItemAlign**.|
3026| NODE_LIST_CHILDREN_MAIN_SIZE                | Sets the default main axis size of the child components in this list.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>object: **ArkUI_ListChildrenMainSize** object.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: The parameter format is **ArkUI_ListChildrenMainSize**.|
3027| NODE_LIST_INITIAL_INDEX                     | Sets the item displayed at the beginning of the viewport when the current list is loaded for the first time, that is, the first item to be displayed. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: index value the item displayed at the beginning of the viewport when the current list is loaded for the first time. The default value is **0**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: index value the item displayed at the beginning of the viewport when the current list is loaded for the first time. The default value is **0**.|
3028| NODE_LIST_DIVIDER                           | Defines the style of the divider for the list items. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: color of the divider, in 0xARGB format. <br>.value[1].f32: stroke width of the divider.<br>.value[2].f32: distance between the divider and the start of the list, in vp.<br>.value[3].f32: distance between the divider and the end of the list, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color of the divider, in 0xARGB format. <br>.value[1].f32: stroke width of the divider.<br>.value[2].f32: distance between the divider and the start of the list, in vp.<br>.value[3].f32: distance between the divider and the end of the list, in vp.|
3029| NODE_SWIPER_LOOP                            | Defines whether to enable loop playback for the swiper. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to enable loop playback. The value **1** means to enable loop playback, and **0** means the opposite. The default value is **1**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to enable loop playback. The value **1** means to enable loop playback, and **0** means the opposite. The default value is **1**.|
3030| NODE_SWIPER_AUTO_PLAY                       | Defines whether to enable automatic playback for child component switching in the swiper. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to enable automatic playback for child component switching. The value **1** means to enable automatic playback, and **0** means the opposite. The default value is **0**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to enable automatic playback for child component switching. The value **1** means to enable automatic playback, and **0** means the opposite. The default value is **0**.|
3031| NODE_SWIPER_SHOW_INDICATOR                  | Defines whether to enable the navigation point indicator for the swiper. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to enable the navigation point indicator. The value **1** means to enable the navigation point indicator, and **0** means the opposite. The default value is **1**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to enable the navigation point indicator. The value **1** means to enable the navigation point indicator, and **0** means the opposite. The default value is **1**.|
3032| NODE_SWIPER_INTERVAL                        | Defines the interval for automatic playback. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: interval for automatic playback, in milliseconds.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: interval for automatic playback, in milliseconds.|
3033| NODE_SWIPER_VERTICAL                        | Defines whether vertical swiping is used for the swiper. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether vertical swiping is used. The value **1** means that vertical swiping is used, and **0** means the opposite. The default value is **0**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether vertical swiping is used. The value **1** means that vertical swiping is used, and **0** means the opposite. The default value is **0**.|
3034| NODE_SWIPER_DURATION                        | Defines the duration of the animation for switching child components. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: duration of the animation for switching child components, in milliseconds. The default value is **400**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: duration of the animation for switching child components, in milliseconds. The default value is **400**.|
3035| NODE_SWIPER_CURVE                           | Defines the animation curve for the swiper. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: Sets the animation curve parameter. The parameter type is [ArkUI_AnimationCurve](#arkui_animationcurve). The default value is ARKUI_CURVE_LINEAR.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: Sets the animation curve parameter. The parameter type is [ArkUI_AnimationCurve](#arkui_animationcurve). The default value is ARKUI_CURVE_LINEAR.|
3036| NODE_SWIPER_ITEM_SPACE                      | Defines the spacing between child components in the swiper. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: spacing between child components.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: spacing between child components.|
3037| NODE_SWIPER_INDEX                           | Defines the index of the child component currently displayed in the swiper. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: number of elements to display per page.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: number of elements to display per page.|
3038| NODE_SWIPER_DISPLAY_COUNT                   | Defines the number of elements to display per page. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: number of elements to display per page.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: number of elements to display per page.|
3039| NODE_SWIPER_DISABLE_SWIPE                   | This interface is used to disable the sliding switching function of the Swiper component. The attribute setting, attribute resetting, and attribute obtaining interfaces are supported.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to disable the swipe feature. The value **1** means to disable the swipe feature, and **0** means the opposite. The default value is **0**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to disable the swipe feature. The value **1** means to disable the swipe feature, and **0** means the opposite. The default value is **0**.|
3040| NODE_SWIPER_SHOW_DISPLAY_ARROW              | Defines whether to show the arrow when the mouse pointer hovers over the navigation point indicator. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: indicates whether to display the navigation arrow. The parameter type is [ArkUI_SwiperArrow](#arkui_swiperarrow).<br>The default value is **ARKUI_SWIPER_ARROW_HIDE**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: indicates whether to display the navigation arrow. The parameter type is [ArkUI_SwiperArrow](#arkui_swiperarrow).<br>The default value is **ARKUI_SWIPER_ARROW_HIDE**.|
3041| NODE_SWIPER_EDGE_EFFECT_MODE                | Defines the effect used at the edges of the swiper when the boundary of the scrollable content is reached. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: effect used at the edges of the swiper when the boundary of the scrollable content is reached. The parameter type is [ArkUI_EdgeEffect](#arkui_edgeeffect).<br>The default value is **ARKUI_EDGE_EFFECT_SPRING**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: effect used at the edges of the swiper when the boundary of the scrollable content is reached. The parameter type is [ArkUI_EdgeEffect](#arkui_edgeeffect).|
3042| NODE_SWIPER_NODE_ADAPTER                    | Defines the swiper adapter. The attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.object: **ArkUI_NodeAdapter** object as the adapter.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: The format of the return value is ArkUI_NodeAdapter.|
3043| NODE_SWIPER_CACHED_COUNT                    | Sets the number of cached items in the swiper adapter. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: number of cached items in the swiper adapter. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: number of cached items in the list adapter.|
3044| NODE_SWIPER_PREV_MARGIN                     | Sets the previous margin of the swiper. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: previous margin, in vp. The default value is **0**.<br>.value[1].i32: whether to ignore blank areas. The value **1** means to ignore blank areas, and **0** means the opposite.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: previous margin, in vp. .value[1].i32: whether to ignore blank areas. The value **1** means to ignore blank areas, and **0** means the opposite.|
3045| NODE_SWIPER_NEXT_MARGIN                     | Sets the next margin of the swiper. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: next margin, in vp. The default value is **0**.<br>.value[1].i32: whether to ignore blank areas. The value **1** means to ignore blank areas, and **0** means the opposite.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: next margin, in vp. .value[1].i32: whether to ignore blank areas. The value **1** means to ignore blank areas, and **0** means the opposite.|
3046| NODE_SWIPER_INDICATOR                       | Sets the navigation indicator type of the Swiper component. The attribute setting, attribute resetting, and attribute obtaining interfaces are supported.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: navigation indicator type. The parameter type is [ArkUI_SwiperIndicatorType](#arkui_swiperindicatortype).<br>.object: The parameter type is [ArkUI_SwiperIndicator](#arkui_swiperindicator).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: navigation indicator type. The parameter type is [ArkUI_SwiperIndicatorType](#arkui_swiperindicatortype).<br>.object: The parameter type is [ArkUI_SwiperIndicator](#arkui_swiperindicator).|
3047| NODE_SWIPER_NESTED_SCROLL                   | Sets the nested scrolling mode of the **Swiper** component and its parent container.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: nested scrolling mode of the Swiper component and parent component. The parameter type is [ArkUI_SwiperNestedScrollMode](#arkui_swipernestedscrollmode).<br>The default value is **ARKUI_SWIPER_NESTED_SCROLL_SELF_ONLY**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: nested scrolling mode of the Swiper component and parent component. The parameter type is [ArkUI_SwiperNestedScrollMode](#arkui_swipernestedscrollmode).|
3048| NODE_SWIPER_SWIPE_TO_INDEX                  | Sets the swiper to switch to the specified page.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: index of the target page in the swiper.<br>.value[1]?.i32: whether to use an animation for when the target page is reached. The value 1 indicates that the dynamic effect is enabled, and the value 0 indicates that the dynamic effect is disabled. The default value is 0.|
3049| NODE_SWIPER_INDICATOR_INTERACTIVE           | Sets whether the navigation point indicator is interactive.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether the navigation point indicator is interactive. The default value **true** means that the navigation point indicator is interactive.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether the navigation point indicator is interactive.|
3050| NODE_LIST_ITEM_SWIPE_ACTION                 | Sets the swipe action item displayed when the list item is swiped out from the screen edge. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.object: [ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) object.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: [ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) object.|
3051| NODE_LIST_ITEM_GROUP_SET_HEADER             | Defines the header of the list item group. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.object: Use the [ArkUI_NodeHandle](#arkui_nodehandle) object as the ListItemGroup header component.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: Use the [ArkUI_NodeHandle](#arkui_nodehandle) object as the ListItemGroup header component.|
3052| NODE_LIST_ITEM_GROUP_SET_FOOTER             | Defines the footer of the list item group. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.object: [ArkUI_NodeHandle](#arkui_nodehandle) object to be used as the footer of the list item group.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: [ArkUI_NodeHandle](#arkui_nodehandle) object to be used as the footer of the list item group.|
3053| NODE_LIST_ITEM_GROUP_SET_DIVIDER            | Defines the style of the divider for the list items. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: color of the divider, in 0xARGB format.<br>.value[1].f32: stroke width of the divider, in vp.<br>.value[2].f32: distance between the divider and the start of the list, in vp.<br>.value[3].f32: distance between the divider and the end of the list, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color of the divider, in 0xARGB format.<br>.value[1].f32: stroke width of the divider, in vp.<br>.value[2].f32: distance between the divider and the start of the list, in vp.<br>.value[3].f32: distance between the divider and the end of the list, in vp.|
3054| NODE_LIST_ITEM_GROUP_CHILDREN_MAIN_SIZE     | Sets the default spindle size of the ListItemGroup child component.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>object: **ArkUI_ListChildrenMainSize** object.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: **ArkUI_ListChildrenMainSize** object.|
3055| NODE_COLUMN_ALIGN_ITEMS                     | Defines the horizontal alignment mode of child components in the column. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: horizontal alignment format of a child component. The data type is [ArkUI_HorizontalAlignment](#arkui_horizontalalignment).<br>Default value: **ARKUI_HORIZONTAL_ALIGNMENT_CENTER**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: horizontal alignment format of a child component. The data type is [ArkUI_HorizontalAlignment](#arkui_horizontalalignment).|
3056| NODE_COLUMN_JUSTIFY_CONTENT                 | Defines the vertical alignment mode of child components in the column. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: vertical alignment format of the child component. The data type is [ArkUI_FlexAlignment](#arkui_flexalignment).<br>Default value: **ARKUI_FLEX_ALIGNMENT_START**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: vertical alignment format of a child component. The data type is [ArkUI_FlexAlignment](#arkui_flexalignment).|
3057| NODE_ROW_ALIGN_ITEMS                        | Defines the vertical alignment mode of child components in the row. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: vertical alignment format of a child component. The data type is [ArkUI_VerticalAlignment](#arkui_verticalalignment).<br>Default value: **ARKUI_VERTICAL_ALIGNMENT_CENTER**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: vertical alignment format of a child component. The data type is [ArkUI_VerticalAlignment](#arkui_verticalalignment).|
3058| NODE_ROW_JUSTIFY_CONTENT                    | Defines the horizontal alignment mode of child components in the row. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: horizontal alignment format of a child component. The data type is [ArkUI_FlexAlignment](#arkui_flexalignment).<br>Default value: **ARKUI_FLEX_ALIGNMENT_START**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: horizontal alignment format of a child component. The data type is [ArkUI_FlexAlignment](#arkui_flexalignment).|
3059| NODE_FLEX_OPTION                            | Defines the opacity attribute, which can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0]?.i32: arrangement direction of child components on the Flex container [ArkUI_FlexDirection](#arkui_flexdirection). The default value is ARKUI_FLEX_DIRECTION_ROW.<br>.value[1]?.i32: arrangement rule [ArkUI_FlexWrap](#arkui_flexwrap). The default value is ARKUI_FLEX_WRAP_NO_WRAP.<br>.value[2]?.i32: alignment format on the principal axis [ArkUI_FlexAlignment](#arkui_flexalignment). The default value is ARKUI_FLEX_ALIGNMENT_START.<br>.value[3]?.i32: alignment format on the cross axis [ArkUI_ItemAlignment](#arkui_itemalignment). The default value is ARKUI_ITEM_ALIGNMENT_START.<br>.value[4]?.i32: alignment mode of multiple lines when there is extra space in the cross axis [ArkUI_FlexAlignment](#arkui_flexalignment). The default value is ARKUI_FLEX_ALIGNMENT_START.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: direction in which flex items are arranged. <br>.value[1].i32: how the flex items are wrapped. <br>.value[2].i32: alignment mode along the main axis. <br>.value[3].i32: alignment mode along the cross axis. <br>.value[4].i32: alignment mode along the cross axis for multi-line content.|
3060| NODE_REFRESH_REFRESHING                     | Sets whether a component is being refreshed. Attributes can be set and obtained.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: The parameter type is 1 or 0.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>value[0].i32: The parameter type is 1 or 0.|
3061| NODE_REFRESH_CONTENT                        | Sets the custom content in the pull-down area. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: The parameter type is **ArkUI_NodeHandle**.|
3062| NODE_REFRESH_PULL_DOWN_RATIO                | Sets the pull-down and hand coefficients. The interfaces for setting, resetting, and obtaining attributes are supported.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: pull-down ratio. The value is in the range from 0 to 1.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: pull-down ratio. The value is in the range from 0 to 1.|
3063| NODE_REFRESH_OFFSET                         | Sets the pull-down offset that initiates a refresh. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: pull-down offset, in vp. The default value is 64 vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: pull-down offset, in vp. The default value is 64 vp.|
3064| NODE_REFRESH_PULL_TO_REFRESH                | Sets whether to initiate a refresh when the pull-down distance exceeds the value of **refreshOffset**. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to initiate a refresh. The value **true** means to initiate a refresh, and **false** means the opposite.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to initiate a refresh. The value **1** means to initiate a refresh, and **0** means the opposite.|
3065| NODE_WATER_FLOW_LAYOUT_DIRECTION            | Defines the main axis direction of the waterfall component layout. Attributes can be set, reset, and obtained.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: main axis direction. The parameter type is **ArkUI_FlexDirection**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: main axis direction. The parameter type is **ArkUI_FlexDirection**.|
3066| NODE_WATER_FLOW_COLUMN_TEMPLATE             | Sets the number of columns in the water flow layout. If this parameter is not set, one column is used by default. This attribute can be set, reset, and obtained as required through APIs. For example, **'1fr 1fr 2fr'** indicates three columns, with the first column taking up 1/4 of the parent component's full width, the second column 1/4, and the third column 2/4. You can use **columnsTemplate('repeat(auto-fill,track-size)')** to automatically calculate the number of rows based on the specified row height **track-size**. **repeat** and **auto-fill** are keywords. The units for **track-size** can be px, vp (default), %, or a valid number.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: number of layout columns.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: number of layout columns.|
3067| NODE_WATER_FLOW_ROW_TEMPLATE                | Sets the number of rows in the water flow layout. If this parameter is not set, one row is used by default. This attribute can be set, reset, and obtained as required through APIs. For example, **'1fr 1fr 2fr'** indicates three rows, with the first row taking up 1/4 of the parent component's full height, the second row 1/4, and the third row 2/4. You can use **rowsTemplate('repeat(auto-fill,track-size)')** to automatically calculate the number of rows based on the specified row height **track-size**. **repeat** and **auto-fill** are keywords. The units for **track-size** can be px, vp (default), %, or a valid number.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: number of layout rows.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: number of layout rows.|
3068| NODE_WATER_FLOW_COLUMN_GAP                  | Sets the gap between columns. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: gap between columns, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: gap between columns, in vp.|
3069| NODE_WATER_FLOW_ROW_GAP                     | Sets the gap between rows. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: gap between lines, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: gap between lines, in vp.|
3070| NODE_WATER_FLOW_SECTION_OPTION              | Defines the water flow section configuration. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: zero-based index of the water flow item section to update. The value is converted to an integer. <br>.object: **ArkUI_WaterFlowSectionOption** object.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: **ArkUI_WaterFlowSectionOption** object.|
3071| NODE_WATER_FLOW_NODE_ADAPTER                | Defines the water flow adapter. The attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.object: **ArkUI_NodeAdapter** object as the adapter.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: **ArkUI_NodeAdapter** object.|
3072| NODE_WATER_FLOW_CACHED_COUNT                | Sets the number of cached items in the water flow adapter. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: number of cached items in the water flow adapter. |
3073| NODE_WATER_FLOW_FOOTER                      | Sets the custom footer for the water flow container.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: custom footer. The parameter type is [ArkUI_NodeHandle](#arkui_nodehandle).|
3074| NODE_WATER_FLOW_SCROLL_TO_INDEX             | Scrolls to the item with the specified index.<br>When **smooth** is set to **true**, all passed items are loaded and counted in layout calculation. This may result in performance issues if a large number of items are involved.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: index of the item to be scrolled to in the container.<br>.value[1]?.i32: whether to enable the smooth animation for scrolling to the item with the specified index. The value **1** means to enable the animation, and **0** means the opposite. The default value is **0**.<br>.value[2]?.i32: how the item to scroll to is aligned with the container. The parameter type is [ArkUI_ScrollAlignment](#arkui_scrollalignment). The default value is **ARKUI_SCROLL_ALIGNMENT_START**.|
3075| NODE_WATER_FLOW_ITEM_CONSTRAINT_SIZE        | Defines the size constraints to apply to water flow items. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: minimum width. The value **-1** indicates that the minimum width is not set. <br>.value[1].f32: maximum width. The value **-1** indicates that the maximum width is not set. <br>.value[2].f32: minimum height. The value **-1** indicates that the minimum height is not set. <br>.value[3].f32: maximum height. The value **-1** indicates that the maximum height is not set. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: minimum width. The value **-1** indicates that the minimum width is not set. <br>.value[1].f32: maximum width. The value **-1** indicates that the maximum width is not set. <br>.value[2].f32: minimum height. The value **-1** indicates that the minimum height is not set. <br>.value[3].f32: maximum height. The value **-1** indicates that the maximum height is not set. |
3076| NODE_RELATIVE_CONTAINER_GUIDE_LINE          | Sets the guideline in the **RelativeContainer**. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.object: guideline in the **RelativeContainer**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: guideline in the **RelativeContainer**.|
3077| NODE_RELATIVE_CONTAINER_BARRIER             | Sets the barrier in the **RelativeContainer**. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.object: guideline in the **RelativeContainer**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: barrier in the **RelativeContainer** component.|
3078| NODE_GRID_COLUMN_TEMPLATE                   | Sets the number of columns in the water flow layout. If this parameter is not set, one column is used by default. This attribute can be set, reset, and obtained as required through APIs. For example, **'1fr 1fr 2fr'** indicates three columns, with the first column taking up 1/4 of the parent component's full width, the second column 1/4, and the third column 2/4. You can use **columnsTemplate('repeat(auto-fill,track-size)')** to automatically calculate the number of rows based on the specified row height **track-size**. **repeat** and **auto-fill** are keywords. The units for **track-size** can be px, vp (default), %, or a valid number.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: number of layout columns.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: number of layout columns.|
3079| NODE_GRID_ROW_TEMPLATE                      | Sets the number of rows or the minimum row height in the grid layout. If this parameter is not set, one row is used by default. This attribute can be set, reset, and obtained as required through APIs. For example, **'1fr 1fr 2fr'** indicates three rows, with the first row taking up 1/4 of the parent component's full height, the second row 1/4, and the third row 2/4. You can use **rowsTemplate('repeat(auto-fill,track-size)')** to automatically calculate the number of rows based on the specified row height **track-size**. **repeat** and **auto-fill** are keywords. The units for **track-size** can be px, vp (default), %, or a valid number.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: number of layout rows.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: number of layout rows.|
3080| NODE_GRID_COLUMN_GAP                        | Sets the gap between columns. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: gap between columns, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: gap between columns, in vp.|
3081| NODE_GRID_ROW_GAP                           | Sets the gap between rows. This attribute can be set, reset, and obtained as required through APIs.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: gap between lines, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: gap between lines, in vp.|
3082| NODE_GRID_NODE_ADAPTER                      | Defines the grid adapter. The attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.object: **ArkUI_NodeAdapter** object as the adapter.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: The format of the return value is ArkUI_NodeAdapter.|
3083| NODE_GRID_CACHED_COUNT                      | Sets the number of cached items in the grid adapter. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: number of cached items in the water flow adapter. |
3084| NODE_IMAGE_ANIMATOR_IMAGES                  | Sets the image frame information set of the frame animation component. Dynamic update is not supported. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.size: number of image frames;<br>.object: image frame array. The parameter type is **ArkUI_ImageAnimatorFrameInfo**. <br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.size: number of image frames;<br>.object: image frame array. The parameter type is **ArkUI_ImageAnimatorFrameInfo**. |
3085| NODE_IMAGE_ANIMATOR_STATE                   | Sets the playback status of the frame-by-frame animation. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: controls the playing status of the animation. The parameter type is [ArkUI_AnimationStatus](#arkui_animationstatus). The default value is the initial status.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: controls the playing status of the animation. The parameter type is [ArkUI_AnimationStatus](#arkui_animationstatus).|
3086| NODE_IMAGE_ANIMATOR_DURATION                | Sets the playback duration of the frame-by-frame animation. This attribute does not take effect when a separate duration is set for any of the image frames. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: playback duration, in milliseconds. The default value is **1000**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: playback duration, in milliseconds. The default value is **1000**.|
3087| NODE_IMAGE_ANIMATOR_REVERSE                 | Sets the playback direction of the frame-by-frame animation. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: playback direction. The value **0** indicates that images are played from the first one to the last one, and **1** indicates that images are played from the last one to the first one. The default value is **0**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: playback direction. The value **0** indicates that images are played from the first one to the last one, and **1** indicates that images are played from the last one to the first one.|
3088| NODE_IMAGE_ANIMATOR_FIXED_SIZE              | Whether the image size is fixed at the component size.<br> This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether the image size is the fixed at the component size. The value **1** indicates that the image size is fixed at the component size. The value **0** indicates that the width, height, top, and left attributes of each image must be set separately. The default value is **1**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether the image size is the fixed at the component size. The value **1** indicates that the image size is fixed at the component size. The value **0** indicates that the width, height, top, and left attributes of each image must be set separately.|
3089| NODE_IMAGE_ANIMATOR_FILL_MODE               | Sets the status before and after execution of the frame-by-frame animation in the current playback direction. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: status before and after execution of the frame-by-frame animation in the current playback direction. The parameter type is **ArkUI_AnimationFillMode**. The default value is **FORWARDS**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: status before and after execution of the frame-by-frame animation in the current playback direction. The parameter type is **ArkUI_AnimationFillMode**.|
3090| NODE_IMAGE_ANIMATOR_ITERATION               | Number of times that the frame animation is played. This attribute can be set, reset, and obtained as required through APIs.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: number of times that the animation is played.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: number of times that the animation is played.|
3091
3092
3093### ArkUI_NodeContentEventType
3094
3095```
3096enum ArkUI_NodeContentEventType
3097```
3098**Description**
3099
3100Defines the NodeContent event type.
3101
3102**Since**: 12
3103
3104| Enum| Description|
3105| -------- | -------- |
3106| NODE_CONTENT_EVENT_ON_ATTACH_TO_WINDOW  | Attach event. |
3107| NODE_CONTENT_EVENT_ON_DETACH_FROM_WINDOW  | Detach event. |
3108
3109
3110### ArkUI_NodeCustomEventType
3111
3112```
3113enum ArkUI_NodeCustomEventType
3114```
3115**Description**
3116
3117Enumerates the custom component event types.
3118
3119**Since**: 12
3120
3121| Enum| Description|
3122| -------- | -------- |
3123| ARKUI_NODE_CUSTOM_EVENT_ON_MEASURE  | Measure. |
3124| ARKUI_NODE_CUSTOM_EVENT_ON_LAYOUT  | Layout. |
3125| ARKUI_NODE_CUSTOM_EVENT_ON_DRAW  | Draw. |
3126| ARKUI_NODE_CUSTOM_EVENT_ON_FOREGROUND_DRAW  | Foreground. |
3127| ARKUI_NODE_CUSTOM_EVENT_ON_OVERLAY_DRAW  | Overlay. |
3128
3129
3130### ArkUI_NodeDirtyFlag
3131
3132```
3133enum ArkUI_NodeDirtyFlag
3134```
3135**Description**
3136
3137Enumerates the dirty area flags passed in the **::markDirty** API.
3138
3139**Since**: 12
3140
3141| Enum| Description|
3142| -------- | -------- |
3143| NODE_NEED_MEASURE  | Recalculate the size.<br>When this type of flag is specified, re-layout is triggered by default.|
3144| NODE_NEED_LAYOUT  | Re-layout. |
3145| NODE_NEED_RENDER  | Re-rendering. |
3146
3147
3148### ArkUI_NodeEventType
3149
3150```
3151enum ArkUI_NodeEventType
3152```
3153**Description**
3154
3155Enumerates the event types supported by the NativeNode component.
3156
3157**Since**: 12
3158
3159| Enum| Description|
3160| -------- | -------- |
3161| NODE_TOUCH_EVENT  | Gesture event.<br>When the event callback occurs, the union type in the event parameter [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_UIInputEvent](_ark_u_i___event_module.md#arkui_uiinputevent).|
3162| NODE_EVENT_ON_APPEAR  | Mount event.<br>This event is triggered when the component is mounted to the component tree and displayed.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3163| NODE_EVENT_ON_DISAPPEAR  | Unmount event.<br>This event is triggered when the component is unmounted from the component tree and disappears.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3164| NODE_EVENT_ON_AREA_CHANGE  | Component area change event.<br>This event is triggered when the component's size, position, or any other attribute that may affect its display area changes.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].f32: original width of the target element, in vp. The value is a number.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].f32: original height of the target element, in vp. The value is a number.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[2].f32: X coordinate of the upper left corner of the target element relative to the upper left corner of the parent element. The value type is number and the unit is vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[3].f32: Y-axis coordinate of the upper left corner of the target element relative to the upper left corner of the parent element. The value type is number, and the unit is vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[4].f32: X coordinate of the upper left corner of the target element relative to the upper left corner of the page. The value type is number, and the unit is vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[5].f32: Y coordinate of the upper left corner of the target element relative to the upper left corner of the page. The value type is number, and the unit is vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[6].f32: new width of the target element, in vp. The value is a number.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].f32: original height of the target element, in vp. The value is a number.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[8].f32: X coordinate of the upper left corner of the latest target element relative to the upper left corner of the parent element. The value type is number and the unit is vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[9].f32: Y coordinate of the upper left corner of the latest target element relative to the upper left corner of the parent element. The value type is number, and the unit is vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[10].f32: X coordinate of the upper left corner of the latest target element relative to the upper left corner of the page. The value type is number, and the unit is vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[11].f32: Y coordinate of the upper left corner of the latest target element relative to the upper left corner of the page. The value type is number, and the unit is vp.|
3165| NODE_ON_FOCUS  | Event of obtaining the focus.<br>This event is triggered when the component obtains the focus.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3166| NODE_ON_BLUR  | Event of losing the focus.<br>This event is triggered when the component loses the focus.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3167| NODE_ON_CLICK  | Click event.<br>This event is triggered when the component is clicked.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].f32: X coordinate of the clicked position relative to the upper left corner of the original area of the clicked element, in vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].f32: Y coordinate of the clicked position relative to the upper left corner of the original area of the clicked element, in vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[2].f32: event timestamp. It is the interval between the time when the event is triggered and the time when the system starts, in microseconds.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[3].i32: event input device. The value 1 indicates the mouse, 2 indicates the touchscreen, and 4 indicates the key.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[4].f32: X coordinate of the clicked position relative to the upper left corner of the application window, in vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[5].f32: Y coordinate of the clicked position relative to the upper left corner of the application window, in vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[6].f32: X coordinate of the clicked position relative to the upper left corner of the application screen, in vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[7].f32: Y coordinate of the clicked position relative to the upper left corner of the application screen, in vp.|
3168| NODE_ON_TOUCH_INTERCEPT  | Custom component event interception.<br>This event is triggered when the component is clicked.<br>When the event callback occurs, the union type in the event parameter [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_UIInputEvent](_ark_u_i___event_module.md#arkui_uiinputevent).|
3169| NODE_EVENT_ON_VISIBLE_AREA_CHANGE  | Visible area change event.<br>This event is triggered when the ratio of the component's visible area to its total area is greater than or less than the threshold. Before registering the event, you need to use **NODE_VISIBLE_AREA_CHANGE_RATIO** to configure the threshold.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: whether the component's visible area has increased or decreased relative to its total area since the last update. The value **1** indicates that the visible area has increased, and **0** indicates that the visible area has decreased.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].f32: ratio of the component's visible area to its total area at the time the callback is triggered.|
3170| NODE_ON_HOVER  | Called when the mouse pointer is moved over or away from the component.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: indicates whether the mouse pointer is hovered over the component. The value 1 indicates that the mouse pointer is hovered over the component, and the value 0 indicates that the mouse pointer is hovered over the component.|
3171| NODE_ON_MOUSE  | Mouse event.<br>This event is triggered when the component is clicked by a mouse device button or when the mouse pointer moves within the component.<br>When the event callback occurs, the union type in the event parameter [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_UIInputEvent](_ark_u_i___event_module.md#arkui_uiinputevent).|
3172| NODE_EVENT_ON_ATTACH  | Attach event.<br>This event is triggered when the component is attached to the component tree.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3173| NODE_EVENT_ON_DETACH  | Detach event.<br>This event is triggered when the component is detached from the component tree.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3174| NODE_ON_ACCESSIBILITY_ACTIONS  | Accessibility action.<br>This event is triggered when an accessibility action is performed after the corresponding accessibility action type is set.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].u32:: operation type for triggering callback. The parameter type is [ArkUI_AccessibilityActionType](#arkui_accessibilityactiontype).|
3175| NODE_ON_PRE_DRAG  | Notifies the listener of the interaction state prior to a drop and drop operation.<br>This event is triggered when a component is draggable and when a long press, lift, or drag initiation occurs.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: corresponds to [ArkUI_PreDragStatus](#arkui_predragstatus).|
3176| NODE_ON_DRAG_START  | Called when the user starts to drag an item.<br>A drag operation is recognized only when the dragged item is moved far enough.<br>When the event callback occurs, you can obtain [ArkUI_DragEvent](#arkui_dragevent) from the [ArkUI_NodeEvent](#arkui_nodeevent-12) object.|
3177| NODE_ON_DRAG_ENTER  | Called when a dragged item enters the boundaries of the current component.<br>The current component refers to the component that listens for this event.<br>When the event callback occurs, you can obtain [ArkUI_DragEvent](#arkui_dragevent) from the [ArkUI_NodeEvent](#arkui_nodeevent-12) object.|
3178| NODE_ON_DRAG_MOVE  | Called  when a dragged item moves in the current component.<br>The current component refers to the component that listens for this event.<br>When the event callback occurs, you can obtain [ArkUI_DragEvent](#arkui_dragevent) from the [ArkUI_NodeEvent](#arkui_nodeevent-12) object.|
3179| NODE_ON_DRAG_LEAVE  | Called when a dragged item leaves the boundaries of the current component.<br>The current component refers to the component that listens for this event.<br>When the event callback occurs, you can obtain [ArkUI_DragEvent](#arkui_dragevent) from the [ArkUI_NodeEvent](#arkui_nodeevent-12) object.|
3180| NODE_ON_DROP  | Called when a dragged item is dropped on the current component. The component can obtain the drag data for processing through the callback.<br>The current component refers to the component that listens for this event.<br>When the event callback occurs, you can obtain [ArkUI_DragEvent](#arkui_dragevent) from the [ArkUI_NodeEvent](#arkui_nodeevent-12) object.|
3181| NODE_ON_DRAG_END  | Called when a drag operation ends. The drag source can obtain the drag result by registering this callback.<br>A drag operation ends when the dragged item is released. When the event callback occurs, the [ArkUI_DragEvent](#arkui_dragevent) object can be obtained from the [ArkUI_NodeEvent](#arkui_nodeevent-12) object.|
3182| NODE_TEXT_ON_DETECT_RESULT_UPDATE  | Called when text recognition with the configured **TextDataDetectorConfig** settings succeeds.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md).<br>[ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md) contains the following parameters:<br>[ArkUI_StringAsyncEvent.pStr](_ark_u_i___string_async_event.md#pstr): text recognition result in JSON format. |
3183| NODE_IMAGE_ON_COMPLETE  | Image loading success event.<br>This event is triggered when an image is successfully loaded or decoded.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: loading status. The value **0** indicates that the image is loaded successfully, and the value **1** indicates that the image is decoded successfully.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].f32: width of the image, in px.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[2].f32: height of the image, in px.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[3].f32: width of the component, in px.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[4].f32: height of the component, in px.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[5].f32: offset of the rendered content relative to the component on the x-axis, in px.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[6].f32: offset of the rendered content relative to the component on the y-axis, in px.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[7].f32: actual rendered width of the image, in px.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[8].f32:actual rendered height of the image, in px.|
3184| NODE_IMAGE_ON_ERROR  | Image loading failure event.<br>This event is triggered when an error occurs during image loading.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32 error code information:<br>401: The image could not be obtained because the image path is invalid.<br>103101: The image format is not supported.|
3185| NODE_IMAGE_ON_SVG_PLAY_FINISH  | Defines the SVG animation playback completion event.<br>This event is triggered when the animation playback in the loaded SVG image is complete.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3186| NODE_IMAGE_ON_DOWNLOAD_PROGRESS  | Called during image download.<br>Condition for triggering this event: This event is triggered when the page component downloads a web page image.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>Number of bytes that have been downloaded by the [ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].u32: so far.<br>Total number of bytes of images to be downloaded by the [ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].u32:.|
3187| NODE_TOGGLE_ON_CHANGE  | Called when the toggle status changes.<br>This event is triggered when the switch status changes.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: current switch status. The value 1 indicates that the switch is turned on, and the value 0 indicates that the switch is turned off.|
3188| NODE_TEXT_INPUT_ON_CHANGE  | Called when the text input content changes.<br>Condition for triggering the event: The input content changes.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md).<br>[ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md) contains the following parameters:<br>[ArkUI_StringAsyncEvent.pStr](_ark_u_i___string_async_event.md#pstr): input text content.|
3189| NODE_TEXT_INPUT_ON_SUBMIT  | Called when the Enter key of the textInput input method is pressed.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: type of the Enter key.|
3190| NODE_TEXT_INPUT_ON_CUT  | Called when the cut button on the pasteboard, which displays when the text box is long pressed, is clicked.<br>Condition for triggering this event: Touch and hold the internal area of the text box to display the clipboard, and touch the clipboard cut button.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md).<br>[ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md) contains the following parameters:<br>[ArkUI_StringAsyncEvent.pStr](_ark_u_i___string_async_event.md#pstr): cut text content.|
3191| NODE_TEXT_INPUT_ON_PASTE  | Called when the paste button on the pasteboard, which displays when the text box is long pressed, is clicked.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md).<br>[ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md) contains the following parameters:<br>[ArkUI_StringAsyncEvent.pStr](_ark_u_i___string_async_event.md#pstr): text pasted.|
3192| NODE_TEXT_INPUT_ON_TEXT_SELECTION_CHANGE  | Called when the text selection position changes.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: indicates the start position of the selected text.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32: indicates the end position of the selected text.|
3193| NODE_TEXT_INPUT_ON_EDIT_CHANGE  | Called when the input status changes.<br>Condition for triggering this event: The input status changes.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: **true** indicates that text input is in progress.|
3194| NODE_TEXT_INPUT_ON_INPUT_FILTER_ERROR  | Called when matching with the regular expression specified by **NODE_TEXT_INPUT_INPUT_FILTER** fails.<br>Condition for triggering the event: The regular expression fails to be matched.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md).<br>[ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md) contains the following parameters:<br>[ArkUI_StringAsyncEvent.pStr](_ark_u_i___string_async_event.md#pstr): content that is filtered out when regular expression matching fails.|
3195| NODE_TEXT_INPUT_ON_CONTENT_SCROLL  | Called when the text content is scrolled.<br>Condition for triggering this event: The text content is scrolled.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: horizontal coordinate offset of the text in the content area.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32: offset in the Y coordinate of the text in the content area.|
3196| NODE_TEXT_INPUT_ON_CONTENT_SIZE_CHANGE  | Called when the text input content changes.<br>Condition for triggering the event: The input content changes.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].f32: indicates the width of the text.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].f32: height of the text.|
3197| NODE_TEXT_INPUT_ON_WILL_INSERT  | Called when text is about to be entered.<br>The event parameter is [ArkUI_NodeEvent](#arkui_nodeevent-12).<br>value.f32: position of the text, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetNumberValue**.<br>buffer: string value of the text, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetStringValue**.<br> <br>It returns **true** if the text is inserted; returns **false** otherwise. You can set the return value using **OH_ArkUI_NodeEvent_SetReturnNumberValue**.|
3198| NODE_TEXT_INPUT_ON_DID_INSERT  | Called when text is entered.<br>The event parameter is [ArkUI_NodeEvent](#arkui_nodeevent-12).<br>value.f32: position of the text, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetNumberValue**.<br>buffer: string value of the text, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetStringValue**.|
3199| NODE_TEXT_INPUT_ON_WILL_DELETE  | Called when text is about to be deleted.<br>The event parameter is [ArkUI_NodeEvent](#arkui_nodeevent-12).<br>value.f32: position of the text deleted, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetNumberValue**.<br>value.i32: direction for deleting the text, with the index of **1**; obtained using **OH_ArkUI_NodeEvent_GetNumberValue**. The value **0** indicates backward-delete, and **1** indicates forward-delete.<br>buffer: string value of the text, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetStringValue**.<br> <br>It returns **true** if the text is inserted; returns **false** otherwise.<br>You can set the return value using **OH_ArkUI_NodeEvent_SetReturnNumberValue**.|
3200| NODE_TEXT_INPUT_ON_DID_DELETE  | Called when text is deleted.<br>The event parameter is [ArkUI_NodeEvent](#arkui_nodeevent-12).<br>value.f32: position of the text deleted, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetNumberValue**.<br>value.i32: direction for deleting the text, with the index of **1**; obtained using **OH_ArkUI_NodeEvent_GetNumberValue**. The value **0** indicates backward-delete, and **1** indicates forward-delete.<br>buffer: string value of the text, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetStringValue**.|
3201| NODE_TEXT_AREA_ON_CHANGE  | Called when the input in the text box changes.<br> <br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md).<br>[ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md) contains the following parameters:<br>[ArkUI_StringAsyncEvent.pStr](_ark_u_i___string_async_event.md#pstr): text entered.|
3202| NODE_TEXT_AREA_ON_PASTE  | Called when the paste button on the pasteboard, which displays when the text box is long pressed, is clicked.<br>Condition for triggering this event: Touch and hold the internal area of the text box to display the clipboard, and touch the clipboard paste button.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md).<br>[ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md) contains the following parameters:<br>[ArkUI_StringAsyncEvent.pStr](_ark_u_i___string_async_event.md#pstr): text pasted.|
3203| NODE_TEXT_AREA_ON_TEXT_SELECTION_CHANGE  | Called when the text selection position changes.<br>Condition for triggering this event: The position of the selected text changes.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: indicates the start position of the selected text.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32: end position of the text selection area.|
3204| NODE_TEXT_AREA_ON_EDIT_CHANGE  | Called when the input status changes.<br>Condition for triggering this event: The input status changes.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: **true** indicates that text input is in progress.|
3205| NODE_TEXT_AREA_ON_SUBMIT  | Called when the Enter key on the keyboard is pressed for the multi-line text box.<br>This event is not triggered when **keyType** is **ARKUI_ENTER_KEY_TYPE_NEW_LINE**.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: type of the Enter key.|
3206| NODE_TEXT_AREA_ON_INPUT_FILTER_ERROR  | Called when matching with the regular expression specified by **NODE_TEXT_AREA_INPUT_FILTER** fails.<br> <br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md).<br>[ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md) contains the following parameters:<br>[ArkUI_StringAsyncEvent.pStr](_ark_u_i___string_async_event.md#pstr): content that is filtered out when regular expression matching fails.|
3207| NODE_TEXT_AREA_ON_CONTENT_SCROLL  | Called when the text content is scrolled.<br>Condition for triggering this event: The text content is scrolled.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: horizontal coordinate offset of the text in the content area.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32: offset in the Y coordinate of the text in the content area.|
3208| NODE_TEXT_AREA_ON_CONTENT_SIZE_CHANGE  | Called when the text input content changes in the **TextArea**. component.<br> <br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].f32: indicates the width of the text.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].f32: height of the text.|
3209| NODE_TEXT_AREA_ON_WILL_INSERT  | Called when text is about to be entered.<br>The event parameter is [ArkUI_NodeEvent](#arkui_nodeevent-12).<br>value.f32: position of the text, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetNumberValue**.<br>buffer: string value of the text, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetStringValue**.<br> <br>It returns **true** if the text is inserted; returns **false** otherwise. You can set the return value using **OH_ArkUI_NodeEvent_SetReturnNumberValue**.|
3210| NODE_TEXT_AREA_ON_DID_INSERT  | Called when text is entered.<br>The event parameter is [ArkUI_NodeEvent](#arkui_nodeevent-12).<br>value.f32: position of the text, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetNumberValue**.<br>buffer: string value of the text, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetStringValue**.|
3211| NODE_TEXT_AREA_ON_WILL_DELETE  | Called when text is about to be deleted.<br>The event parameter is [ArkUI_NodeEvent](#arkui_nodeevent-12).<br>value.f32: position of the text deleted, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetNumberValue**.<br>value.i32: direction for deleting the text, with the index of **1**; obtained using **OH_ArkUI_NodeEvent_GetNumberValue**. The value **0** indicates backward-delete, and **1** indicates forward-delete.<br>buffer: string value of the text, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetStringValue**.<br> <br>It returns **true** if the text is inserted; returns **false** otherwise.<br>You can set the return value using **OH_ArkUI_NodeEvent_SetReturnNumberValue**.|
3212| NODE_TEXT_AREA_ON_DID_DELETE  | Called when text is deleted.<br>The event parameter is [ArkUI_NodeEvent](#arkui_nodeevent-12).<br>value.f32: position of the text deleted, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetNumberValue**.<br>value.i32: direction for deleting the text, with the index of **1**; obtained using **OH_ArkUI_NodeEvent_GetNumberValue**. The value **0** indicates backward-delete, and **1** indicates forward-delete.<br>buffer: string value of the text, with the index of **0**; obtained using **OH_ArkUI_NodeEvent_GetStringValue**.|
3213| NODE_CHECKBOX_EVENT_ON_CHANGE  | Called when the selected status of the **ARKUI_NODE_CHECKBOX** component changes.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: **1**: selected; **0**: not selected|
3214| NODE_DATE_PICKER_EVENT_ON_DATE_CHANGE  | Called when a date is selected in the **ARKUI_NODE_DATE_PICKER** component.<br> <br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: year of the selected date.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32: month of the selected date. Value range: 0–11.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[2].i32: day of the selected date.|
3215| NODE_TIME_PICKER_EVENT_ON_CHANGE  | Called when a time is selected in the **ARKUI_NODE_TIME_PICKER** component.<br> <br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: hour of the selected time. Value range: 0-23.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32: minute of the selected time. Value range: 0-59.|
3216| NODE_TEXT_PICKER_EVENT_ON_CHANGE  | Called when an item is selected in the **ARKUI_NODE_TEXT_PICKER** component.<br> <br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0...11].i32: value of the selected item.|
3217| NODE_CALENDAR_PICKER_EVENT_ON_CHANGE  | Called when a date is selected in the **NODE_CALENDAR_PICKER**.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>**ArkUI_NodeComponent.data[0].u32**: year of the selected date.<br>**ArkUI_NodeComponent.data[1].u32**: month of the selected date.<br>**ArkUI_NodeComponent.data[2].u32**: day of the selected date.|
3218| NODE_SLIDER_EVENT_ON_CHANGE  | Called when the **ARKUI_NODE_SLIDER** component is dragged or clicked.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].f32: current slider value.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32: state triggered by the event.|
3219| NODE_RADIO_EVENT_ON_CHANGE  | Called when the **ARKUI_NODE_RADIO** component is dragged or clicked.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: status of the radio button.|
3220| NODE_IMAGE_ANIMATOR_EVENT_ON_START  | Called when the frame-by-frame animation starts to play.<br> <br> <br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3221| NODE_IMAGE_ANIMATOR_EVENT_ON_PAUSE  | Called when the frame-by-frame animation playback is paused.<br> <br> <br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3222| NODE_IMAGE_ANIMATOR_EVENT_ON_REPEAT  | Called when the frame-by-frame animation playback is repeated.<br> <br> <br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3223| NODE_IMAGE_ANIMATOR_EVENT_ON_CANCEL  | Called when the frame-by-frame animation playback returns to the initial state.<br> <br> <br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3224| NODE_IMAGE_ANIMATOR_EVENT_ON_FINISH  | Called when the frame-by-frame animation playback is complete or stopped.<br> <br> <br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3225| NODE_SWIPER_EVENT_ON_CHANGE  | Called when the index of the currently displayed element of this **ARKUI_NODE_SWIPER** instance changes.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: index of the currently displayed element.|
3226| NODE_SWIPER_EVENT_ON_ANIMATION_START  | Called when the switching animation of this **ARKUI_NODE_SWIPER** instance starts.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: index of the currently displayed element.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32: index of the target element to switch to.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[2].f32: offset of the currently displayed element relative to the start position of the swiper along the main axis.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[3].f32: offset of the target element relative to the start position of the swiper along the main axis.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[4].f32: hands-off velocity.|
3227| NODE_SWIPER_EVENT_ON_ANIMATION_END  | Called when the switching animation of this **ARKUI_NODE_SWIPER** instance ends.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: index of the currently displayed element.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].f32: offset of the currently displayed element relative to the start position of the swiper along the main axis.|
3228| NODE_SWIPER_EVENT_ON_GESTURE_SWIPE  | Triggered on a frame-by-frame basis when the page is turned by a swipe.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: index of the currently displayed element.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].f32: offset of the currently displayed element relative to the start position of the swiper along the main axis.|
3229| NODE_SWIPER_EVENT_ON_CONTENT_DID_SCROLL  | Called when content in the **ARKUI_NODE_SWIPER** component scrolls. Instructions:<br>1. When [ArkUI_SwiperDisplayModeType](#arkui_swiperdisplaymodetype) is set to ARKUI_SWIPER_DISPLAY_MODE_AUTO_LINEAR, this API does not take effect.<br>2. This API does not work when **prevMargin** and **nextMargin** are set in such a way that the **Swiper** frontend and backend display the same page during loop playback.<br>3. During page scrolling, the </b>ContentDidScrollCallback</b> callback is invoked for all pages in the viewport on a frame-by-frame basis.<br>For example, when there are two pages whose subscripts are 0 and 1 in the viewport, two callbacks whose indexes are 0 and 1 are invoked in each frame.<br>4. When the swipeByGroup parameter of the displayCount attribute is set to true and at least one page in the same group is in the window:<br>Callback is triggered for all pages in the same group.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: index of the Swiper component, which is the same as the index value in the onChange event.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32: index of a page in the window.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[2].f32: moving ratio of the page relative to the start position of the Swiper major axis (the start position of the page corresponding to selectedIndex).<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[3].f32: page length in the principal axis direction.|
3230| NODE_SCROLL_EVENT_ON_SCROLL  | Defines the scrolling event enumeration values of the scrolling container component.<br>**NOTE**<br>1. This event is triggered when scrolling is started by the **Scroll** component or other input settings, such as keyboard and mouse operations.<br>2. This event is triggered when the controller API is called.<br>3. This event supports the out-of-bounds bounce effect.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].f32: horizontal scrolling offset.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].f32: vertical scrolling offset.|
3231| NODE_SCROLL_EVENT_ON_SCROLL_FRAME_BEGIN  | Called when the container starts scrolling.<br>**NOTE**<br>1. This event is triggered when scrolling is started by the **Scroll** component or other input settings, such as keyboard and mouse operations.<br>2. This event is not triggered when the controller API is called.<br>3. This event does not support the out-of-bounds bounce effect.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].f32: indicates the upcoming scrolling amount.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32: current scroll state.<br>The [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) parameter contains the following return value:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].f32: The event handler can work out the amount by which the component needs to scroll based on the real-world situation and return the result in this parameter.|
3232| NODE_SCROLL_EVENT_ON_WILL_SCROLL  | Called when the container is about to scroll.<br>**NOTE**<br>1. This event is triggered when scrolling is started by the **Scroll** component or other input settings, such as keyboard and mouse operations.<br>2. This event is triggered when the controller API is called.<br>3. This event supports the out-of-bounds bounce effect.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].f32:: scrolling offset of each frame. The offset is positive when the content scrolls leftwards and negative when the content scrolls rightwards. The unit is vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].f32: Scrolling offset of each frame. The offset is positive when the content scrolls up and negative when the content scrolls down. The unit is vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[2].i32: current scroll state. The parameter type is [ArkUI_ScrollState](#arkui_scrollstate).<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[3].i32: scroll source. The parameter type is [ArkUI_ScrollSource](#arkui_scrollsource).<br>**Returns**<br>Returns one or no number to indicate the actual amount by which the scroll component scrolls.|
3233| NODE_SCROLL_EVENT_ON_DID_SCROLL  | Called when the container scrolls.<br>**NOTE**<br>1. This event is triggered when scrolling is started by the **Scroll** component or other input settings, such as keyboard and mouse operations.<br>2. This event is triggered when the controller API is called.<br>3. This event supports the out-of-bounds bounce effect.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].f32:: scrolling offset of each frame. The offset is positive when the content scrolls leftwards and negative when the content scrolls rightwards. The unit is vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].f32: Scrolling offset of each frame. The offset is positive when the content scrolls up and negative when the content scrolls down. The unit is vp.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[2].i32: current scroll state. The parameter type is [ArkUI_ScrollState](#arkui_scrollstate).|
3234| NODE_SCROLL_EVENT_ON_SCROLL_START  | Called when the container starts scrolling.<br>**NOTE**<br>1. This event is triggered when scrolling is started by the **Scroll** component or other input settings, such as keyboard and mouse operations.<br>2. This event is triggered when the controller API is called, accompanied by a transition animation.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3235| NODE_SCROLL_EVENT_ON_SCROLL_STOP  | Called when the container stops scrolling.<br>**NOTE**<br>1. This event is triggered when scrolling is stopped by the **Scroll** component or other input settings, such as keyboard and mouse operations.<br>2. This event is triggered when the controller API is called, accompanied by a transition animation.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3236| NODE_SCROLL_EVENT_ON_SCROLL_EDGE  | Defines the scrolling edge event enumeration values of the scrolling container component.<br>**NOTE**<br>1. This event is triggered when scrolling reaches the edge after being started by the **Scroll** component or other input settings, such as keyboard and mouse operations.<br>2. This event is triggered when the controller API is called.<br>3. This event supports the out-of-bounds bounce effect.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32 indicates the top, bottom, left, and right edges that are touched.|
3237| NODE_SCROLL_EVENT_ON_REACH_START  | Called when the container reaches the start edge.<br>**NOTE**<br>This event is triggered when scrolling hits the start edge.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3238| NODE_SCROLL_EVENT_ON_REACH_END  | Called when the container reaches the end edge.<br>**NOTE**<br>This event is triggered when scrolling hits the end edge.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3239| NODE_LIST_ON_SCROLL_INDEX  | Called when a child component enters or leaves the list display area.<br>**NOTE**<br>This event is triggered once when the list is initialized and when the index of the first child component or the next child component in the list display area changes.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: index of the first child component in the list display area.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32: index of the last child component in the list display area.<br>**[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[2].i32**: index of the center child component in the list display area.|
3240| NODE_LIST_ON_WILL_SCROLL  | Called when the list is about to scroll.<br>**NOTE**<br>1. This event is triggered when scrolling is started by the **Scroll** component or other input settings, such as keyboard and mouse operations.<br>2. This event is triggered when the controller API is called.<br>3. This event supports the out-of-bounds bounce effect.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].f32: Scrolling offset of each frame. When the list content scrolls up, the offset is positive. When the list content scrolls down, the offset is negative.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32: current scroll state. The parameter type is [ArkUI_ScrollState](#arkui_scrollstate).<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[2].i32: scroll source. The parameter type is [ArkUI_ScrollSource](#arkui_scrollsource).<br>**Returns**<br>Returns one or no number to indicate the actual amount by which the scroll component scrolls.|
3241| NODE_LIST_ON_DID_SCROLL  | Called when the list scrolls.<br>**NOTE**<br>1. This event is triggered when scrolling is started by the scrollable component or other input settings, such as keyboard and mouse operations.<br>2. Scrolling can be initiated by calling the controller API.<br>3. The out-of-bounds bounce effect is supported.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].f32: scroll offset of each frame. The offset is positive when the list is scrolled up and negative when the list is scrolled down.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32: current scroll state.|
3242| NODE_REFRESH_STATE_CHANGE  | Called when the refresh state of the **ARKUI_NODE_REFRESH** object changes.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32: refresh state.|
3243| NODE_REFRESH_ON_REFRESH  | Called when the **ARKUI_NODE_REFRESH** object enters the refresh state.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) does not contain parameters.|
3244| NODE_REFRESH_ON_OFFSET_CHANGE  | Called when the pull-down distance of the **ARKUI_NODE_REFRESH** object changes.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].f32: pull-down distance.|
3245| NODE_ON_WILL_SCROLL  | Called when the water flow container is about to scroll.<br>**NOTE**<br>1. This event is triggered when scrolling is started by the scrollable component or other input settings, such as keyboard and mouse operations.<br>2. Scrolling can be initiated by calling the controller API.<br>3. The out-of-bounds bounce effect is supported.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].f32: scroll offset of each frame. The offset is positive when the component is scrolled up and negative when the component is scrolled down.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32: current scroll state. The parameter type is [ArkUI_ScrollState](#arkui_scrollstate).<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[2].i32: scroll source. The parameter type is [ArkUI_ScrollSource](#arkui_scrollsource).<br>**Returns**<br>Returns one or no number to indicate the actual amount by which the scroll component scrolls.|
3246| NODE_WATER_FLOW_ON_DID_SCROLL  | Called when the water flow container scrolls.<br>**NOTE**<br>1. This event is triggered when scrolling is started by the scrollable component or other input settings, such as keyboard and mouse operations.<br>2. Scrolling can be initiated by calling the controller API.<br>3. The out-of-bounds bounce effect is supported.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].f32: Offset of scrolling each frame. The offset is positive when the content scrolls up and negative when the content scrolls down.<br>Current sliding status of the [ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32:.|
3247| NODE_WATER_FLOW_ON_SCROLL_INDEX  | Called when the first or last item displayed in the water flow container changes.<br>**NOTE**<br>This event is triggered when either of the preceding indexes changes.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md).<br>[ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) contains the following parameters:<br>Index of the start position of the water flow displayed on the [ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[0].i32:.<br>Index of the end position of the waterfall currently displayed on the [ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32:.|
3248
3249
3250### ArkUI_NodeType
3251
3252```
3253enum ArkUI_NodeType
3254```
3255**Description**
3256
3257Enumerates ArkUI component types that can be created on the native side.
3258
3259**Since**: 12
3260
3261| Enum| Description|
3262| -------- | -------- |
3263| ARKUI_NODE_CUSTOM  | Custom node. |
3264| ARKUI_NODE_TEXT  | Text to insert. |
3265| ARKUI_NODE_SPAN  | Text span. |
3266| ARKUI_NODE_IMAGE_SPAN  | Image span. |
3267| ARKUI_NODE_IMAGE  | Image. |
3268| ARKUI_NODE_TOGGLE  | Toggle. |
3269| ARKUI_NODE_LOADING_PROGRESS  | Loading icon. |
3270| ARKUI_NODE_TEXT_INPUT  | Single-line text input. |
3271| ARKUI_NODE_TEXT_AREA  | Multi-line text input. |
3272| ARKUI_NODE_BUTTON  | Icon. |
3273| ARKUI_NODE_PROGRESS  | Progress indicator. |
3274| ARKUI_NODE_CHECKBOX  | Check box |
3275| ARKUI_NODE_XCOMPONENT  | XComponent. |
3276| ARKUI_NODE_DATE_PICKER  | Date picker. |
3277| ARKUI_NODE_TIME_PICKER  | Time picker. |
3278| ARKUI_NODE_TEXT_PICKER  | Text picker. |
3279| ARKUI_NODE_CALENDAR_PICKER  | Calendar picker. |
3280| ARKUI_NODE_SLIDER  | Slider. |
3281| ARKUI_NODE_RADIO  | Radio button. |
3282| ARKUI_NODE_IMAGE_ANIMATOR  | Frame-by-frame animation component. |
3283| ARKUI_NODE_STACK  | Stack container. |
3284| ARKUI_NODE_SWIPER  | Swiper. |
3285| ARKUI_NODE_SCROLL  | Scrolling container. |
3286| ARKUI_NODE_LIST  | List. |
3287| ARKUI_NODE_LIST_ITEM  | List item. |
3288| ARKUI_NODE_LIST_ITEM_GROUP  | List item group. |
3289| ARKUI_NODE_COLUMN  | Column container. |
3290| ARKUI_NODE_ROW  | Row container. |
3291| ARKUI_NODE_FLEX  | Flex container. |
3292| ARKUI_NODE_REFRESH  | Refresh component. |
3293| ARKUI_NODE_WATER_FLOW  | Water flow container. |
3294| ARKUI_NODE_FLOW_ITEM  | Water flow item. |
3295| ARKUI_NODE_RELATIVE_CONTAINER  | Relative layout component. |
3296| ARKUI_NODE_GRID  | Grid. |
3297| ARKUI_NODE_GRID_ITEM  | Grid item. |
3298| ARKUI_NODE_CUSTOM_SPAN  | Custom span. |
3299
3300
3301### ArkUI_ObjectFit
3302
3303```
3304enum ArkUI_ObjectFit
3305```
3306**Description**
3307
3308Enumerates the image filling effects. ImageSpanAlignment
3309
3310**Since**: 12
3311
3312| Enum| Description|
3313| -------- | -------- |
3314| ARKUI_OBJECT_FIT_CONTAIN  | The image is scaled with its aspect ratio retained for the content to be completely displayed within the display boundaries. |
3315| ARKUI_OBJECT_FIT_COVER  | The image is scaled with its aspect ratio retained for both sides to be greater than or equal to the display boundaries. |
3316| ARKUI_OBJECT_FIT_AUTO  | The image is scaled automatically to fit the display area. |
3317| ARKUI_OBJECT_FIT_FILL  | The image is scaled to fill the display area, and its aspect ratio is not retained. |
3318| ARKUI_OBJECT_FIT_SCALE_DOWN  | The image is displayed with its aspect ratio retained, in a size smaller than or equal to the original size. |
3319| ARKUI_OBJECT_FIT_NONE  | The original size is retained. |
3320| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_TOP_START  | Not resized, the image is aligned with the start edge of the top of the container. |
3321| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_TOP  | Not resized, the image is horizontally centered at the top of the container. |
3322| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_TOP_END  | Not resized, the image is aligned with the end edge at the top of the container. |
3323| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_START  | Not resized, the image is vertically centered on the start edge of the container. |
3324| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_CENTER  | Not resized, the image is horizontally and vertically centered in the container. |
3325| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_END  | Not resized, the image is vertically centered on the end edge of the container. |
3326| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_BOTTOM_START  | Not resized, the image is aligned with the start edge at the bottom of the container. |
3327| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_BOTTOM  | Not resized, the image is horizontally centered at the bottom of the container. |
3328| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_BOTTOM_END  | Not resized, the image is aligned with the end edge at the bottom of the container. |
3329
3330
3331### ArkUI_PreDragStatus
3332
3333```
3334enum ArkUI_PreDragStatus
3335```
3336**Description**
3337
3338Defines an enum for interaction states prior to a drop and drop operation.
3339
3340**Since**: 12
3341
3342| Enum| Description|
3343| -------- | -------- |
3344| ARKUI_PRE_DRAG_STATUS_UNKNOWN  | Unknown. |
3345| ARKUI_PRE_DRAG_STATUS_ACTION_DETECTING  | A drag gesture is being detected. |
3346| ARKUI_PRE_DRAG_STATUS_READY_TO_TRIGGER_DRAG  | The component is ready to be dragged. |
3347| ARKUI_PRE_DRAG_STATUS_PREVIEW_LIFT_STARTED  | A lift animation is started. |
3348| ARKUI_PRE_DRAG_STATUS_PREVIEW_LIFT_FINISHED  | A lift animation is finished. |
3349| ARKUI_PRE_DRAG_STATUS_PREVIEW_LANDING_STARTED  | A drop animation is started. |
3350| ARKUI_PRE_DRAG_STATUS_PREVIEW_LANDING_FINISHED  | A drop animation is finished. |
3351| ARKUI_PRE_DRAG_STATUS_CANCELED_BEFORE_DRAG  | A drop animation is terminated. |
3352
3353
3354### ArkUI_ProgressType
3355
3356```
3357enum ArkUI_ProgressType
3358```
3359**Description**
3360
3361Enumerates the styles of the progress indicator.
3362
3363**Since**: 12
3364
3365| Enum| Description|
3366| -------- | -------- |
3367| ARKUI_PROGRESS_TYPE_LINEAR  | Linear type. |
3368| ARKUI_PROGRESS_TYPE_RING  | Indeterminate ring style. |
3369| ARKUI_PROGRESS_TYPE_ECLIPSE  | Eclipse style. |
3370| ARKUI_PROGRESS_TYPE_SCALE_RING  | Determinate ring style. |
3371| ARKUI_PROGRESS_TYPE_CAPSULE  | Capsule style. |
3372
3373
3374### ArkUI_RelativeLayoutChainStyle
3375
3376```
3377enum ArkUI_RelativeLayoutChainStyle
3378```
3379**Description**
3380
3381Enumerates the chain styles.
3382
3383**Since**: 12
3384
3385| Enum| Description|
3386| -------- | -------- |
3387| ARKUI_RELATIVE_LAYOUT_CHAIN_STYLE_SPREAD  | Child components are evenly distributed among constraint anchors. |
3388| ARKUI_RELATIVE_LAYOUT_CHAIN_STYLE_SPREAD_INSIDE  | All child components except the first and last ones are evenly distributed among constraint anchors. |
3389| ARKUI_RELATIVE_LAYOUT_CHAIN_STYLE_PACKED  | There is no gap between child components in the chain. |
3390
3391
3392### ArkUI_RenderFit
3393
3394```
3395enum ArkUI_RenderFit
3396```
3397
3398| Enum| Description|
3399| -------- | -------- |
3400| ARKUI_RENDER_FIT_CENTER  | The component's content stays at the final size and always aligned with the center of the component. |
3401| ARKUI_RENDER_FIT_TOP  | The component's content stays at the final size and always aligned with the top center of the component. |
3402| ARKUI_RENDER_FIT_BOTTOM  | The component's content stays at the final size and always aligned with the bottom center of the component. |
3403| ARKUI_RENDER_FIT_LEFT  | The component's content stays at the final size and always aligned with the left of the component. |
3404| ARKUI_RENDER_FIT_RIGHT  | The component's content stays at the final size and always aligned with the right of the component. |
3405| ARKUI_RENDER_FIT_TOP_LEFT  | The component's content stays at the final size and always aligned with the upper left corner of the component. |
3406| ARKUI_RENDER_FIT_TOP_RIGHT  | The component's content stays at the final size and always aligned with the upper right corner of the component. |
3407| ARKUI_RENDER_FIT_BOTTOM_LEFT  | The component's content stays at the final size and always aligned with the lower left corner of the component. |
3408| ARKUI_RENDER_FIT_BOTTOM_RIGHT  | The component's content stays at the final size and always aligned with the lower right corner of the component. |
3409| ARKUI_RENDER_FIT_RESIZE_FILL  | The component's content is always resized to fill the component's content box, without considering its aspect ratio in the final state. |
3410| ARKUI_RENDER_FIT_RESIZE_CONTAIN  | While maintaining its aspect ratio in the final state, the component's content is scaled to fit within the component's content box. It is always aligned with the center of the component. |
3411| ARKUI_RENDER_FIT_RESIZE_CONTAIN_TOP_LEFT  | While maintaining its aspect ratio in the final state, the component's content is scaled to fit within the component's content box. When there is remaining space in the width direction of the component, the content is left-aligned with the component. When there is remaining space in the height direction of the component, the content is top-aligned with the component. |
3412| ARKUI_RENDER_FIT_RESIZE_CONTAIN_BOTTOM_RIGHT  | While maintaining its aspect ratio in the final state, the component's content is scaled to fit within the component's content box. When there is remaining space in the width direction of the component, the content is right-aligned with the component. When there is remaining space in the height direction of the component, the content is bottom-aligned with the component. |
3413| ARKUI_RENDER_FIT_RESIZE_COVER  | While maintaining its aspect ratio in the final state, the component's content is scaled to cover the component's entire content box. It is always aligned with the center of the component, so that its middle part is displayed. |
3414| ARKUI_RENDER_FIT_RESIZE_COVER_TOP_LEFT  | While maintaining its aspect ratio in the final state, the component's content is scaled to cover the component's entire content box. When there is remaining space in the width direction, the content is left-aligned with the component, so that its left part is displayed. When there is remaining space in the height direction, the content is top-aligned with the component, so that its top part is displayed. |
3415| ARKUI_RENDER_FIT_RESIZE_COVER_BOTTOM_RIGHT  | While maintaining its aspect ratio in the final state, the component's content is scaled to cover the component's entire content box. When there is remaining space in the width direction, the content is right-aligned with the component, so that its right part is displayed. When there is remaining space in the height direction, the content is bottom-aligned with the component, so that its bottom part is displayed. |
3416
3417
3418### ArkUI_RouterPageState
3419
3420```
3421enum ArkUI_RouterPageState
3422```
3423**Description**
3424
3425Enumerates the states of a page during routing.
3426
3427**Since**: 12
3428
3429| Enum| Description|
3430| -------- | -------- |
3431| ARKUI_ROUTER_PAGE_STATE_ON_WILL_APPEAR  | The page is about to be displayed. |
3432| ARKUI_ROUTER_PAGE_STATE_ON_WILL_DISAPPEAR  | The page is about to be destroyed. |
3433| ARKUI_ROUTER_PAGE_STATE_ON_SHOW  | The page is displayed. |
3434| ARKUI_ROUTER_PAGE_STATE_ON_HIDE  | The page is hidden. |
3435| ARKUI_ROUTER_PAGE_STATE_ON_BACK_PRESS  | The back button is pressed for the page. |
3436
3437
3438### ArkUI_SafeAreaEdge
3439
3440```
3441enum ArkUI_SafeAreaEdge
3442```
3443**Description**
3444
3445Enumerates the edges for expanding the safe area.
3446
3447**Since**: 12
3448
3449| Enum| Description|
3450| -------- | -------- |
3451| ARKUI_SAFE_AREA_EDGE_TOP  | Top edge. |
3452| ARKUI_SAFE_AREA_EDGE_BOTTOM  | Bottom edge. |
3453| ARKUI_SAFE_AREA_EDGE_START  | Start edge. |
3454| ARKUI_SAFE_AREA_EDGE_END  | End edge. |
3455
3456
3457### ArkUI_SafeAreaType
3458
3459```
3460enum ArkUI_SafeAreaType
3461```
3462**Description**
3463
3464Enumerates the types of expanded safe areas.
3465
3466**Since**: 12
3467
3468| Enum| Description|
3469| -------- | -------- |
3470| ARKUI_SAFE_AREA_TYPE_SYSTEM  | Default non-safe area of the system, including the status bar and navigation bar. |
3471| ARKUI_SAFE_AREA_TYPE_CUTOUT  | Non-safe area of the device, for example, the notch area. |
3472| ARKUI_SAFE_AREA_TYPE_KEYBOARD  | Soft keyboard area. |
3473
3474
3475### ArkUI_ScrollAlignment
3476
3477```
3478enum ArkUI_ScrollAlignment
3479```
3480**Description**
3481
3482Defines how the list item to scroll to is aligned with the container.
3483
3484**Since**: 12
3485
3486| Enum| Description|
3487| -------- | -------- |
3488| ARKUI_SCROLL_ALIGNMENT_START  | The start edge of the list item is flush with the start edge of the container. |
3489| ARKUI_SCROLL_ALIGNMENT_CENTER  | The list item is centered along the main axis of the list. |
3490| ARKUI_SCROLL_ALIGNMENT_END  | The end edge of the list item Aligns the tail of an item with that of a container. |
3491| ARKUI_SCROLL_ALIGNMENT_AUTO  | The list item is automatically aligned. If the item is fully contained within the display area, no adjustment is performed. Otherwise, the item is aligned so that its start or end edge is flush with the start or end edge of the container, whichever requires a shorter scrolling distance. |
3492
3493### ArkUI_ScrollBarDisplayMode
3494
3495```
3496enum ArkUI_ScrollBarDisplayMode
3497```
3498**Description**
3499
3500Enumerates the scrollbar display modes.
3501
3502**Since**: 12
3503
3504| Enum| Description|
3505| -------- | -------- |
3506| ARKUI_SCROLL_BAR_DISPLAY_MODE_OFF  | Not displayed. |
3507| ARKUI_SCROLL_BAR_DISPLAY_MODE_AUTO  | Displayed when the screen is touched and hidden after 2s. |
3508| ARKUI_SCROLL_BAR_DISPLAY_MODE_ON  | Always displayed. |
3509
3510
3511### ArkUI_ScrollDirection
3512
3513```
3514enum ArkUI_ScrollDirection
3515```
3516**Description**
3517
3518Enumerates the scroll directions of scrollable components.
3519
3520**Since**: 12
3521
3522| Enum| Description|
3523| -------- | -------- |
3524| ARKUI_SCROLL_DIRECTION_VERTICAL  | Only vertical scrolling is supported. |
3525| ARKUI_SCROLL_DIRECTION_HORIZONTAL  | Only horizontal scrolling is supported. |
3526| ARKUI_SCROLL_DIRECTION_NONE  | Scrolling is forbidden. |
3527
3528
3529### ArkUI_ScrollEdge
3530
3531```
3532enum ArkUI_ScrollEdge
3533```
3534**Description**
3535
3536Defines the edge to which the component scrolls.
3537
3538**Since**: 12
3539
3540| Enum| Description|
3541| -------- | -------- |
3542| ARKUI_SCROLL_EDGE_TOP  | Top edge in the vertical direction. |
3543| ARKUI_SCROLL_EDGE_BOTTOM  | Bottom edge in the vertical direction. |
3544| ARKUI_SCROLL_EDGE_START  | Start position in the horizontal direction. |
3545| ARKUI_SCROLL_EDGE_END  | End position in the horizontal direction. |
3546
3547
3548### ArkUI_ScrollNestedMode
3549
3550```
3551enum ArkUI_ScrollNestedMode
3552```
3553**Description**
3554
3555Enumerates nested scrolling options.
3556
3557**Since**: 12
3558
3559| Enum| Description|
3560| -------- | -------- |
3561| ARKUI_SCROLL_NESTED_MODE_SELF_ONLY  | The scrolling is contained within the component, and no scroll chaining occurs, that is, the parent component does not scroll when the component scrolling reaches the boundary. |
3562| ARKUI_SCROLL_NESTED_MODE_SELF_FIRST  | The component scrolls first, and when it hits the boundary, the parent component scrolls. When the parent component hits the boundary, its edge effect is displayed. If no edge effect is specified for the parent component, the edge effect of the child component is displayed instead. |
3563| ARKUI_SCROLL_NESTED_MODE_PARENT_FIRST  | The parent component scrolls first, and when it hits the boundary, the component scrolls. When the component hits the boundary, its edge effect is displayed. If no edge effect is specified for the component, the edge effect of the parent component is displayed instead. |
3564| ARKUI_SCROLL_NESTED_MODE_PARALLEL  | The component and its parent component scroll at the same time. When both the component and its parent component hit the boundary, the edge effect of the component is displayed. If no edge effect is specified for the component, the edge effect of the parent component is displayed instead. |
3565
3566
3567### ArkUI_ScrollSnapAlign
3568
3569```
3570enum ArkUI_ScrollSnapAlign
3571```
3572**Description**
3573
3574Enumerates the alignment modes of list items when scrolling ends.
3575
3576**Since**: 12
3577
3578| Enum| Description|
3579| -------- | -------- |
3580| ARKUI_SCROLL_SNAP_ALIGN_NONE  | No alignment. This is the default value. |
3581| ARKUI_SCROLL_SNAP_ALIGN_START  | The first item in the view is aligned at the start of the list. |
3582| ARKUI_SCROLL_SNAP_ALIGN_CENTER  | The middle items in the view are aligned in the center of the list. |
3583| ARKUI_SCROLL_SNAP_ALIGN_END  | The last item in the view is aligned at the end of the list. |
3584
3585
3586### ArkUI_ScrollSource
3587
3588```
3589enum ArkUI_ScrollSource
3590```
3591**Description**
3592
3593Enumerates the scrolling sources.
3594
3595**Since**: 12
3596
3597| Enum| Description|
3598| -------- | -------- |
3599| ARKUI_SCROLL_SOURCE_DRAG  | Drag your finger. |
3600| ARKUI_SCROLL_SOURCE_FLING  | Inertia scrolling after finger dragging. |
3601| ARKUI_SCROLL_SOURCE_EDGE_EFFECT  | Executes the EdgeEffect.Spring edge special effect when the boundary is crossed. |
3602| ARKUI_SCROLL_SOURCE_OTHER_USER_INPUT  | User input other than dragging, such as mouse wheel and keyboard events. |
3603| ARKUI_SCROLL_SOURCE_SCROLL_BAR  | Scrollbar dragging |
3604| ARKUI_SCROLL_SOURCE_SCROLL_BAR_FLING  | Inertial scrolling after the scroll bar is dragged. |
3605| ARKUI_SCROLL_SOURCE_SCROLLER  | Scrolling by the scroll controller (without animation). |
3606| ARKUI_SCROLL_SOURCE_ANIMATION  | Scrolling by the scroll controller (with animation). |
3607
3608
3609### ArkUI_ScrollState
3610
3611```
3612enum ArkUI_ScrollState
3613```
3614**Description**
3615
3616Enumerates the scrolling states.
3617
3618**Since**: 12
3619
3620| Enum| Description|
3621| -------- | -------- |
3622| ARKUI_SCROLL_STATE_IDLE  | Idle. The container enters this state when an API in the controller is used to scroll the container or when the scrollbar is dragged. |
3623| ARKUI_SCROLL_STATE_SCROLL  | Scrolling. The container enters this state when the user drags the container to scroll. |
3624| ARKUI_SCROLL_STATE_FLING  | Inertial scrolling. The container enters this state when inertial scrolling occurs or when the container bounces back after being released from a fling. |
3625
3626
3627### ArkUI_ShadowStyle
3628
3629```
3630enum ArkUI_ShadowStyle
3631```
3632**Description**
3633
3634Enumerated value of the shadow effect.
3635
3636**Since**: 12
3637
3638| Enum| Description|
3639| -------- | -------- |
3640| ARKUI_SHADOW_STYLE_OUTER_DEFAULT_XS  | Mini shadow. |
3641| ARKUI_SHADOW_STYLE_OUTER_DEFAULT_SM  | Small shadow. |
3642| ARKUI_SHADOW_STYLE_OUTER_DEFAULT_MD  | Medium shadow. |
3643| ARKUI_SHADOW_STYLE_OUTER_DEFAULT_LG  | Large shadow. |
3644| ARKUI_SHADOW_STYLE_OUTER_FLOATING_SM  | Floating small shadow. |
3645| ARKUI_SHADOW_STYLE_OUTER_FLOATING_MD  | Floating medium shadow. |
3646
3647
3648### ArkUI_ShadowType
3649
3650```
3651enum ArkUI_ShadowType
3652```
3653**Description**
3654
3655Defines the enumerated values of the shadow type.
3656
3657**Since**: 12
3658
3659| Enum| Description|
3660| -------- | -------- |
3661| ARKUI_SHADOW_TYPE_COLOR  | Color. |
3662| ARKUI_SHADOW_TYPE_BLUR  | Blur. |
3663
3664
3665### ArkUI_ShapeType
3666
3667```
3668enum ArkUI_ShapeType
3669```
3670**Description**
3671
3672Enumerates custom shape types.
3673
3674**Since**: 12
3675
3676| Enum| Description|
3677| -------- | -------- |
3678| ARKUI_SHAPE_TYPE_RECTANGLE  | Rectangle. |
3679| ARKUI_SHAPE_TYPE_CIRCLE  | **(circle)** |
3680| ARKUI_SHAPE_TYPE_ELLIPSE  | Ellipse. |
3681| ARKUI_SHAPE_TYPE_PATH  | Path Type |
3682
3683
3684### ArkUI_SliderBlockStyle
3685
3686```
3687enum ArkUI_SliderBlockStyle
3688```
3689**Description**
3690
3691Enumerates the styles of the slider in the block direction.
3692
3693**Since**: 12
3694
3695| Enum| Description|
3696| -------- | -------- |
3697| ARKUI_SLIDER_BLOCK_STYLE_DEFAULT  | Round slider. |
3698| ARKUI_SLIDER_BLOCK_STYLE_IMAGE  | Slider with an image background. |
3699| ARKUI_SLIDER_BLOCK_STYLE_SHAPE  | Slider in a custom shape. |
3700
3701
3702### ArkUI_SliderDirection
3703
3704```
3705enum ArkUI_SliderDirection
3706```
3707**Description**
3708
3709Enumerates the scroll directions of the slider.
3710
3711**Since**: 12
3712
3713| Enum| Description|
3714| -------- | -------- |
3715| ARKUI_SLIDER_DIRECTION_VERTICAL  | Vertical direction. |
3716| ARKUI_SLIDER_DIRECTION_HORIZONTAL  | Horizontal direction. |
3717
3718
3719### ArkUI_SliderStyle
3720
3721```
3722enum ArkUI_SliderStyle
3723```
3724**Description**
3725
3726Enumerates the slider styles.
3727
3728**Since**: 12
3729
3730| Enum| Description|
3731| -------- | -------- |
3732| ARKUI_SLIDER_STYLE_OUT_SET  | The slider is on the slider rail. |
3733| ARKUI_SLIDER_STYLE_IN_SET  | The slider is in the slider rail. |
3734| ARKUI_SLIDER_STYLE_NONE  | There is no thumb. |
3735
3736
3737### ArkUI_StickyStyle
3738
3739```
3740enum ArkUI_StickyStyle
3741```
3742**Description**
3743
3744Enumerates the modes for pinning the header to the top or the footer to the bottom.
3745
3746**Since**: 12
3747
3748| Enum| Description|
3749| -------- | -------- |
3750| ARKUI_STICKY_STYLE_NONE  | In the list item group, the header is not pinned to the top, and the footer is not pinned to the bottom. |
3751| ARKUI_STICKY_STYLE_HEADER  | In the list item group, the header is pinned to the top, and the footer is not pinned to the bottom. |
3752| ARKUI_STICKY_STYLE_FOOTER  | In the list item group, the footer is pinned to the bottom, and the header is not pinned to the top. |
3753| ARKUI_STICKY_STYLE_BOTH  | In the list item group, the footer is pinned to the bottom, and the header is pinned to the top. |
3754
3755
3756### ArkUI_SwiperArrow
3757
3758```
3759enum ArkUI_SwiperArrow
3760```
3761**Description**
3762
3763Enumerates arrow styles of the navigation point indicator.
3764
3765**Since**: 12
3766
3767| Enum| Description|
3768| -------- | -------- |
3769| ARKUI_SWIPER_ARROW_HIDE  | The arrow is not displayed for the navigation point indicator. |
3770| ARKUI_SWIPER_ARROW_SHOW  | The arrow is displayed for the navigation point indicator. |
3771| ARKUI_SWIPER_ARROW_SHOW_ON_HOVER  | The arrow is displayed only when the mouse pointer hovers over the navigation point indicator. |
3772
3773
3774### ArkUI_SwiperDisplayModeType
3775
3776```
3777enum ArkUI_SwiperDisplayModeType
3778```
3779**Description**
3780
3781Enumerates the modes in which elements are displayed along the main axis of the **Swiper** component.
3782
3783**Since**: 12
3784
3785| Enum| Description|
3786| -------- | -------- |
3787| ARKUI_SWIPER_DISPLAY_MODE_STRETCH  | The slide width of the **Swiper** component is equal to the width of the component. |
3788| ARKUI_SWIPER_DISPLAY_MODE_AUTO_LINEAR  | The slide width of the **Swiper** component is equal to the width of the leftmost child component in the viewport. |
3789
3790
3791### ArkUI_SwiperIndicatorType
3792
3793```
3794enum ArkUI_SwiperIndicatorType
3795```
3796**Description**
3797
3798Enumerates the navigation point indicator types of the **Swiper** component.
3799
3800**Since**: 12
3801
3802| Enum| Description|
3803| -------- | -------- |
3804| ARKUI_SWIPER_INDICATOR_TYPE_DOT  | Dot type. |
3805| ARKUI_SWIPER_INDICATOR_TYPE_DIGIT  | Digit type. |
3806
3807
3808### ArkUI_SwiperNestedScrollMode
3809
3810```
3811enum ArkUI_SwiperNestedScrollMode
3812```
3813**Description**
3814
3815Enumerates the nested scrolling mode of the **Swiper** component and its parent container.
3816
3817**Since**: 12
3818
3819| Enum| Description|
3820| -------- | -------- |
3821| ARKUI_SWIPER_NESTED_SRCOLL_SELF_ONLY  | The scrolling is contained within the **Swiper** component, and no scroll chaining occurs, that is, the parent container does not scroll when the component scrolling reaches the boundary. |
3822| ARKUI_SWIPER_NESTED_SRCOLL_SELF_FIRST  | The **Swiper** component scrolls first, and when it hits the boundary, the parent container scrolls. When the parent container hits the boundary, its edge effect is displayed. If no edge effect is specified for the parent container, the edge effect of the child component is displayed instead. |
3823
3824
3825### ArkUI_SystemColorMode
3826
3827```
3828enum ArkUI_SystemColorMode
3829```
3830**Description**
3831
3832Enumerates the system color modes.
3833
3834**Since**: 12
3835
3836| Enum| Description|
3837| -------- | -------- |
3838| ARKUI_SYSTEM_COLOR_MODE_LIGHT  | Light mode. |
3839| ARKUI_SYSTEM_COLOR_MODE_DARK  | Dark mode. |
3840
3841
3842### ArkUI_TextAlignment
3843
3844```
3845enum ArkUI_TextAlignment
3846```
3847**Description**
3848
3849Enumerates the text alignment mode.
3850
3851**Since**: 12
3852
3853| Enum| Description|
3854| -------- | -------- |
3855| ARKUI_TEXT_ALIGNMENT_START  | Aligned with the start. |
3856| ARKUI_TEXT_ALIGNMENT_CENTER  | Horizontally centered. |
3857| ARKUI_TEXT_ALIGNMENT_END  | Aligned with the end. |
3858| ARKUI_TEXT_ALIGNMENT_JUSTIFY  | Aligned with both margins. |
3859
3860
3861### ArkUI_TextAreaType
3862
3863```
3864enum ArkUI_TextAreaType
3865```
3866**Description**
3867
3868Enumerates the text box types.
3869
3870**Since**: 12
3871
3872| Enum| Description|
3873| -------- | -------- |
3874| ARKUI_TEXTAREA_TYPE_NORMAL  | Normal input mode. |
3875| ARKUI_TEXTAREA_TYPE_NUMBER  | Number input mode. |
3876| ARKUI_TEXTAREA_TYPE_PHONE_NUMBER  | Phone number input mode. |
3877| ARKUI_TEXTAREA_TYPE_EMAIL  | Email address input mode. |
3878
3879
3880### ArkUI_TextCase
3881
3882```
3883enum ArkUI_TextCase
3884```
3885**Description**
3886
3887Defines the enumerated values of text case.
3888
3889**Since**: 12
3890
3891| Enum| Description|
3892| -------- | -------- |
3893| ARKUI_TEXT_CASE_NORMAL  | The original case of the text is retained. |
3894| ARKUI_TEXT_CASE_LOWER  | All letters in the text are in lowercase. |
3895| ARKUI_TEXT_CASE_UPPER  | All letters in the text are in uppercase. |
3896
3897
3898### ArkUI_TextCopyOptions
3899
3900```
3901enum ArkUI_TextCopyOptions
3902```
3903**Description**
3904
3905Enumerates copy options, which define whether copy and paste is allowed for text content.
3906
3907**Since**: 12
3908
3909| Enum| Description|
3910| -------- | -------- |
3911| ARKUI_TEXT_COPY_OPTIONS_NONE  | Copy is not allowed. |
3912| ARKUI_TEXT_COPY_OPTIONS_IN_APP  | Intra-application copy is allowed. |
3913| ARKUI_TEXT_COPY_OPTIONS_LOCAL_DEVICE  | Intra-device copy is allowed. |
3914| ARKUI_TEXT_COPY_OPTIONS_CROSS_DEVICE  | Cross-device copy is allowed. |
3915
3916
3917### ArkUI_TextDataDetectorType
3918
3919```
3920enum ArkUI_TextDataDetectorType
3921```
3922**Description**
3923
3924Enumerates the entity types of text recognition.
3925
3926**Since**: 12
3927
3928| Enum| Description|
3929| -------- | -------- |
3930| ARKUI_TEXT_DATA_DETECTOR_TYPE_PHONE_NUMBER  | Phone number. |
3931| ARKUI_TEXT_DATA_DETECTOR_TYPE_URL  | Link. |
3932| ARKUI_TEXT_DATA_DETECTOR_TYPE_EMAIL  | Email  |
3933| ARKUI_TEXT_DATA_DETECTOR_TYPE_ADDRESS  | Network address. |
3934
3935
3936### ArkUI_TextDecorationStyle
3937
3938```
3939enum ArkUI_TextDecorationStyle
3940```
3941**Description**
3942
3943Enumerates the text decoration styles.
3944
3945**Since**: 12
3946
3947| Enum| Description|
3948| -------- | -------- |
3949| ARKUI_TEXT_DECORATION_STYLE_SOLID  | Single solid line. |
3950| ARKUI_TEXT_DECORATION_STYLE_DOUBLE  | Double solid line. |
3951| ARKUI_TEXT_DECORATION_STYLE_DOTTED  | Dotted line. |
3952| ARKUI_TEXT_DECORATION_STYLE_DASHED  | Dashed style. |
3953| ARKUI_TEXT_DECORATION_STYLE_WAVY  | Wavy line. |
3954
3955
3956### ArkUI_TextDecorationType
3957
3958```
3959enum ArkUI_TextDecorationType
3960```
3961**Description**
3962
3963Enumerates the text decoration types.
3964
3965**Since**: 12
3966
3967| Enum| Description|
3968| -------- | -------- |
3969| ARKUI_TEXT_DECORATION_TYPE_NONE  | No text decoration. |
3970| ARKUI_TEXT_DECORATION_TYPE_UNDERLINE  | Line under the text. |
3971| ARKUI_TEXT_DECORATION_TYPE_OVERLINE  | Line over the text. |
3972| ARKUI_TEXT_DECORATION_TYPE_LINE_THROUGH  | Line through the text. |
3973
3974
3975### ArkUI_TextHeightAdaptivePolicy
3976
3977```
3978enum ArkUI_TextHeightAdaptivePolicy
3979```
3980**Description**
3981
3982Defines how the adaptive height is determined for the text.
3983
3984**Since**: 12
3985
3986| Enum| Description|
3987| -------- | -------- |
3988| ARKUI_TEXT_HEIGHT_ADAPTIVE_POLICY_MAX_LINES_FIRST  | Prioritize the **maxLines** settings. |
3989| ARKUI_TEXT_HEIGHT_ADAPTIVE_POLICY_MIN_FONT_SIZE_FIRST  | Prioritize the **minFontSize** settings. |
3990| ARKUI_TEXT_HEIGHT_ADAPTIVE_POLICY_LAYOUT_CONSTRAINT_FIRST  | Prioritize the layout constraint settings in terms of height. |
3991
3992
3993### ArkUI_TextInputContentType
3994
3995```
3996enum ArkUI_TextInputContentType
3997```
3998**Description**
3999
4000Enumerates the autofill types.
4001
4002**Since**: 12
4003
4004| Enum| Description|
4005| -------- | -------- |
4006| ARKUI_TEXTINPUT_CONTENT_TYPE_USER_NAME  | Username. Password Vault, when enabled, can automatically save and fill in usernames. |
4007| ARKUI_TEXTINPUT_CONTENT_TYPE_PASSWORD  | Password. Password Vault, when enabled, can automatically save and fill in passwords. |
4008| ARKUI_TEXTINPUT_CONTENT_TYPE_NEW_PASSWORD  | New password. Password Vault, when enabled, can automatically generate a new password. |
4009| ARKUI_TEXTINPUT_CONTENT_TYPE_FULL_STREET_ADDRESS  | Full street address. The scenario-based autofill feature, when enabled, can automatically save and fill in full street addresses. |
4010| ARKUI_TEXTINPUT_CONTENT_TYPE_HOUSE_NUMBER  | House number. The scenario-based autofill feature, when enabled, can automatically save and fill in house numbers. |
4011| ARKUI_TEXTINPUT_CONTENT_TYPE_DISTRICT_ADDRESS  | District and county. The scenario-based autofill feature, when enabled, can automatically save and fill in districts and counties. |
4012| ARKUI_TEXTINPUT_CONTENT_TYPE_CITY_ADDRESS  | City. The scenario-based autofill feature, when enabled, can automatically save and fill in cities. |
4013| ARKUI_TEXTINPUT_CONTENT_TYPE_PROVINCE_ADDRESS  | Province. The scenario-based autofill feature, when enabled, can automatically save and fill in provinces. |
4014| ARKUI_TEXTINPUT_CONTENT_TYPE_COUNTRY_ADDRESS  | Country. The scenario-based autofill feature, when enabled, can automatically save and fill in countries. |
4015| ARKUI_TEXTINPUT_CONTENT_TYPE_PERSON_FULL_NAME  | Full name. The scenario-based autofill feature, when enabled, can automatically save and fill in full names. |
4016| ARKUI_TEXTINPUT_CONTENT_TYPE_PERSON_LAST_NAME  | Last name. The scenario-based autofill feature, when enabled, can automatically save and fill in last names. |
4017| ARKUI_TEXTINPUT_CONTENT_TYPE_PERSON_FIRST_NAME  | First name. The scenario-based autofill feature, when enabled, can automatically save and fill in first names. |
4018| ARKUI_TEXTINPUT_CONTENT_TYPE_PHONE_NUMBER  | Phone number. The scenario-based autofill feature, when enabled, can automatically save and fill in phone numbers. |
4019| ARKUI_TEXTINPUT_CONTENT_TYPE_PHONE_COUNTRY_CODE  | Country code. The scenario-based autofill feature, when enabled, can automatically save and fill in country codes. |
4020| ARKUI_TEXTINPUT_CONTENT_TYPE_FULL_PHONE_NUMBER  | Phone number with country code. The scenario-based autofill feature, when enabled, can automatically save and fill in phone numbers with country codes. |
4021| ARKUI_TEXTINPUT_CONTENT_EMAIL_ADDRESS  | Email address. The scenario-based autofill feature, when enabled, can automatically save and fill in email addresses. |
4022| ARKUI_TEXTINPUT_CONTENT_TYPE_BANK_CARD_NUMBER  | Bank card number. The scenario-based autofill feature, when enabled, can automatically save and fill in bank card numbers. |
4023| ARKUI_TEXTINPUT_CONTENT_TYPE_ID_CARD_NUMBER  | ID card number. The scenario-based autofill feature, when enabled, can automatically save and fill in ID card numbers. |
4024| ARKUI_TEXTINPUT_CONTENT_TYPE_NICKNAME  | Nickname. The scenario-based autofill feature, when enabled, can automatically save and fill in nicknames. |
4025| ARKUI_TEXTINPUT_CONTENT_TYPE_DETAIL_INFO_WITHOUT_STREET  | Address information without street address. The scenario-based autofill feature, when enabled, can automatically save and fill in address information without street addresses. |
4026| ARKUI_TEXTINPUT_CONTENT_TYPE_FORMAT_ADDRESS  | Standard address. The scenario-based autofill feature, when enabled, can automatically save and fill in standard addresses. |
4027
4028
4029### ArkUI_TextInputStyle
4030
4031```
4032enum ArkUI_TextInputStyle
4033```
4034**Description**
4035
4036Enumerates the text input styles.
4037
4038**Since**: 12
4039
4040| Enum| Description|
4041| -------- | -------- |
4042| ARKUI_TEXTINPUT_STYLE_DEFAULT  | Default style. The caret width is fixed at 1.5 vp, and the caret height is subject to the background height and font size of the selected text. |
4043| ARKUI_TEXTINPUT_STYLE_INLINE  | Inline input style. The background height of the selected text is the same as the height of the text box. |
4044
4045
4046### ArkUI_TextInputType
4047
4048```
4049enum ArkUI_TextInputType
4050```
4051**Description**
4052
4053Enumerates the text input types.
4054
4055**Since**: 12
4056
4057| Enum| Description|
4058| -------- | -------- |
4059| ARKUI_TEXTINPUT_TYPE_NORMAL  | Normal input mode. |
4060| ARKUI_TEXTINPUT_TYPE_NUMBER  | Number input mode. |
4061| ARKUI_TEXTINPUT_TYPE_PHONE_NUMBER  | Phone number input mode. |
4062| ARKUI_TEXTINPUT_TYPE_EMAIL  | Email address input mode. |
4063| ARKUI_TEXTINPUT_TYPE_PASSWORD  | Password input mode. |
4064| ARKUI_TEXTINPUT_TYPE_NUMBER_PASSWORD  | Numeric password input mode. |
4065| ARKUI_TEXTINPUT_TYPE_SCREEN_LOCK_PASSWORD  | Lock screen password input mode. |
4066| ARKUI_TEXTINPUT_TYPE_USER_NAME  | Username input mode. |
4067| ARKUI_TEXTINPUT_TYPE_NEW_PASSWORD  | New password input mode. |
4068| ARKUI_TEXTINPUT_TYPE_NUMBER_DECIMAL  | Number input mode with a decimal point. |
4069
4070
4071### ArkUI_TextOverflow
4072
4073```
4074enum ArkUI_TextOverflow
4075```
4076**Description**
4077
4078Enumerates the display modes when the text is too long.
4079
4080**Since**: 12
4081
4082| Enum| Description|
4083| -------- | -------- |
4084| ARKUI_TEXT_OVERFLOW_NONE  | Extra-long text is not clipped. |
4085| ARKUI_TEXT_OVERFLOW_CLIP  | Extra-long text is clipped. |
4086| ARKUI_TEXT_OVERFLOW_ELLIPSIS  | An ellipsis (...) is used to represent text overflow. |
4087| ARKUI_TEXT_OVERFLOW_MARQUEE  | Text continuously scrolls when text overflow occurs. |
4088
4089
4090### ArkUI_TextPickerRangeType
4091
4092```
4093enum ArkUI_TextPickerRangeType
4094```
4095**Description**
4096
4097Enumerates the types of the text picker.
4098
4099**Since**: 12
4100
4101| Enum| Description|
4102| -------- | -------- |
4103| ARKUI_TEXTPICKER_RANGETYPE_SINGLE  | Single-column text picker. |
4104| ARKUI_TEXTPICKER_RANGETYPE_MULTI  | Multi-column text picker. |
4105| ARKUI_TEXTPICKER_RANGETYPE_RANGE_CONTENT  | Single-column text picker with image resources. |
4106| ARKUI_TEXTPICKER_RANGETYPE_CASCADE_RANGE_CONTENT  | Interconnected multi-column text picker. |
4107
4108
4109### ArkUI_ThemeColorMode
4110
4111```
4112enum ArkUI_ThemeColorMode
4113```
4114
4115| Enum| Description|
4116| -------- | -------- |
4117| ARKUI_THEME_COLOR_MODE_SYSTEM  | Following the system color mode. |
4118| ARKUI_THEME_COLOR_MODE_LIGHT  | Light color mode. |
4119| ARKUI_THEME_COLOR_MODE_DARK  | Dark color mode. |
4120
4121
4122### ArkUI_TransitionEdge
4123
4124```
4125enum ArkUI_TransitionEdge
4126```
4127**Description**
4128
4129Enumerates the slide-in and slide-out positions of the component from the screen edge during transition.
4130
4131**Since**: 12
4132
4133| Enum| Description|
4134| -------- | -------- |
4135| ARKUI_TRANSITION_EDGE_TOP  | Top edge of the window. |
4136| ARKUI_TRANSITION_EDGE_BOTTOM  | Bottom edge of the window. |
4137| ARKUI_TRANSITION_EDGE_START  | Left edge of the window. |
4138| ARKUI_TRANSITION_EDGE_END  | Right edge of the window. |
4139
4140
4141### ArkUI_VerticalAlignment
4142
4143```
4144enum ArkUI_VerticalAlignment
4145```
4146**Description**
4147
4148Enumerates the vertical alignment modes.
4149
4150**Since**: 12
4151
4152| Enum| Description|
4153| -------- | -------- |
4154| ARKUI_VERTICAL_ALIGNMENT_TOP  | Top aligned. |
4155| ARKUI_VERTICAL_ALIGNMENT_CENTER  | Aligned with the center. This is the default alignment mode. |
4156| ARKUI_VERTICAL_ALIGNMENT_BOTTOM  | Bottom aligned. |
4157
4158
4159### ArkUI_Visibility
4160
4161```
4162enum ArkUI_Visibility
4163```
4164**Description**
4165
4166Enumerates the visibility values.
4167
4168**Since**: 12
4169
4170| Enum| Description|
4171| -------- | -------- |
4172| ARKUI_VISIBILITY_VISIBLE  | Display |
4173| ARKUI_VISIBILITY_HIDDEN  | The component is hidden, and a placeholder is used for it in the layout. |
4174| ARKUI_VISIBILITY_NONE  | The component is hidden. It is not involved in the layout, and no placeholder is used for it. |
4175
4176
4177### ArkUI_WordBreak
4178
4179```
4180enum ArkUI_WordBreak
4181```
4182**Description**
4183
4184Enumerates the word break rules.
4185
4186**Since**: 12
4187
4188| Enum| Description|
4189| -------- | -------- |
4190| ARKUI_WORD_BREAK_NORMAL  | Word breaks can occur between any two characters for Chinese, Japanese, and Korean (CJK) text, but can occur only at a space character for non-CJK text (such as English). |
4191| ARKUI_WORD_BREAK_BREAK_ALL  | Word breaks can occur between any two characters for non-CJK text. CJK text behavior is the same as for **NORMAL**. |
4192| ARKUI_WORD_BREAK_BREAK_WORD  | This option has the same effect as **BREAK_ALL** for non-CJK text, except that if it preferentially wraps lines at appropriate characters (for example, spaces) whenever possible. CJK text behavior is the same as for **NORMAL**. |
4193
4194
4195### ArkUI_XComponentType
4196
4197```
4198enum ArkUI_XComponentType
4199```
4200**Description**
4201
4202Defines the enumerated values of the XComponent type.
4203
4204**Since**: 12
4205
4206| Enum| Description|
4207| -------- | -------- |
4208| ARKUI_XCOMPONENT_TYPE_SURFACE  | The custom content of EGL/OpenGL ES and media data is displayed individually on the screen. |
4209| ARKUI_XCOMPONENT_TYPE_TEXTURE  | The custom content of EGL/OpenGL ES and media data is grouped and displayed together with content of the component. |
4210
4211
4212## Function Description
4213
4214
4215### OH_ArkUI_AccessibilityState_Create()
4216
4217```
4218ArkUI_AccessibilityState* OH_ArkUI_AccessibilityState_Create (void )
4219```
4220**Description**
4221
4222Creates an accessibility state.
4223
4224**Since**: 12
4225
4226**Returns**
4227
4228Returns the pointer to the created accessibility state object. If a null pointer is returned, the creation fails. A possible cause is that the application address space is full.
4229
4230
4231### OH_ArkUI_AccessibilityState_Dispose()
4232
4233```
4234void OH_ArkUI_AccessibilityState_Dispose (ArkUI_AccessibilityState * state)
4235```
4236**Description**
4237
4238Disposes of the pointer to an accessibility state.
4239
4240**Since**: 12
4241
4242**Parameters**
4243
4244| Name| Description|
4245| -------- | -------- |
4246| state | Pointer to an accessibility state object. |
4247
4248
4249### OH_ArkUI_AccessibilityState_GetCheckedState()
4250
4251```
4252int32_t OH_ArkUI_AccessibilityState_GetCheckedState (ArkUI_AccessibilityState * state)
4253```
4254**Description**
4255
4256Obtains the check box state of an accessibility state.
4257
4258**Since**: 12
4259
4260**Parameters**
4261
4262| Name| Description|
4263| -------- | -------- |
4264| state | Pointer to an accessibility state object. |
4265
4266**Returns**
4267
4268Returns the check box state. The parameter type is [ArkUI_AccessibilityCheckedState](#arkui_accessibilitycheckedstate). The default value is **ARKUI_ACCESSIBILITY_UNCHECKED**. If a parameter error occurs, the default value is returned.
4269
4270
4271### OH_ArkUI_AccessibilityState_IsDisabled()
4272
4273```
4274int32_t OH_ArkUI_AccessibilityState_IsDisabled (ArkUI_AccessibilityState * state)
4275```
4276**Description**
4277
4278Obtains whether an accessibility state is disabled.
4279
4280**Since**: 12
4281
4282**Parameters**
4283
4284| Name| Description|
4285| -------- | -------- |
4286| state | Pointer to an accessibility state object. |
4287
4288**Returns**
4289
4290Returns whether the accessibility state is disabled. The value **1** means that the accessibility state is disabled, and **0** means the opposite. The default value is **0**. If the value of **state** is empty, the default value is returned.
4291
4292
4293### OH_ArkUI_AccessibilityState_IsSelected()
4294
4295```
4296int32_t OH_ArkUI_AccessibilityState_IsSelected (ArkUI_AccessibilityState * state)
4297```
4298**Description**
4299
4300Obtains whether an accessibility state is selected.
4301
4302**Since**: 12
4303
4304**Parameters**
4305
4306| Name| Description|
4307| -------- | -------- |
4308| state | Pointer to an accessibility state object. |
4309
4310**Returns**
4311
4312Returns whether the accessibility state is selected. The value **1** means that the accessibility state is selected, and **0** means the opposite. The default value is **0**. If the value of **state** is empty, the default value is returned.
4313
4314
4315### OH_ArkUI_AccessibilityState_SetCheckedState()
4316
4317```
4318void OH_ArkUI_AccessibilityState_SetCheckedState (ArkUI_AccessibilityState * state, int32_t checkedState )
4319```
4320**Description**
4321
4322Sets the check box state of an accessibility state.
4323
4324**Since**: 12
4325
4326**Parameters**
4327
4328| Name| Description|
4329| -------- | -------- |
4330| state | Pointer to an accessibility state object. |
4331| checkedState | Check box status. The parameter type is [ArkUI_AccessibilityCheckedState](#arkui_accessibilitycheckedstate). The default value is **ARKUI_ACCESSIBILITY_UNCHECKED**. |
4332
4333
4334### OH_ArkUI_AccessibilityState_SetDisabled()
4335
4336```
4337void OH_ArkUI_AccessibilityState_SetDisabled (ArkUI_AccessibilityState * state, int32_t isDisabled )
4338```
4339**Description**
4340
4341Sets whether an accessibility state is disabled.
4342
4343**Since**: 12
4344
4345**Parameters**
4346
4347| Name| Description|
4348| -------- | -------- |
4349| state | Pointer to an accessibility state object. |
4350| isDisabled | Whether the accessibility state is disabled. The value **1** means that the accessibility state is disabled, and **0** means the opposite. The default value is **0**. |
4351
4352
4353### OH_ArkUI_AccessibilityState_SetSelected()
4354
4355```
4356void OH_ArkUI_AccessibilityState_SetSelected (ArkUI_AccessibilityState * state, int32_t isSelected )
4357```
4358**Description**
4359
4360Sets whether an accessibility state is selected.
4361
4362**Since**: 12
4363
4364**Parameters**
4365
4366| Name| Description|
4367| -------- | -------- |
4368| state | Pointer to an accessibility state object. |
4369| isSelected | Whether the accessibility state is selected. The value **1** means that the accessibility state is selected, and **0** means the opposite. The default value is **0**. |
4370
4371
4372### OH_ArkUI_AccessibilityValue_Create()
4373
4374```
4375ArkUI_AccessibilityValue* OH_ArkUI_AccessibilityValue_Create (void )
4376```
4377**Description**
4378
4379Creates an **AccessibilityValue** instance.
4380
4381**Since**: 12
4382
4383**Returns**
4384
4385Returns the pointer to the created **AccessibilityValue** instance.
4386
4387
4388### OH_ArkUI_AccessibilityValue_Dispose()
4389
4390```
4391void OH_ArkUI_AccessibilityValue_Dispose (ArkUI_AccessibilityValue * value)
4392```
4393**Description**
4394
4395Disposes of the pointer to an **AccessibilityValue** instance.
4396
4397**Since**: 12
4398
4399**Parameters**
4400
4401| Name| Description|
4402| -------- | -------- |
4403| state | Pointer to an **AccessibilityValue** instance. |
4404
4405
4406### OH_ArkUI_AccessibilityValue_GetCurrent()
4407
4408```
4409int32_t OH_ArkUI_AccessibilityValue_GetCurrent (ArkUI_AccessibilityValue * value)
4410```
4411**Description**
4412
4413Obtains the current accessibility value.
4414
4415**Since**: 12
4416
4417**Parameters**
4418
4419| Name| Description|
4420| -------- | -------- |
4421| value | Pointer to an **AccessibilityValue** instance. |
4422
4423**Returns**
4424
4425Returns the current value based on the range component. The default value is **-1**. If a parameter error occurs, **-1** is returned.
4426
4427
4428### OH_ArkUI_AccessibilityValue_GetMax()
4429
4430```
4431int32_t OH_ArkUI_AccessibilityValue_GetMax (ArkUI_AccessibilityValue * value)
4432```
4433**Description**
4434
4435Obtains the maximum accessibility value.
4436
4437**Since**: 12
4438
4439**Parameters**
4440
4441| Name| Description|
4442| -------- | -------- |
4443| value | Pointer to an **AccessibilityValue** instance. |
4444
4445**Returns**
4446
4447Returns the maximum value based on the range component. The default value is **-1**. If a parameter error occurs, **-1** is returned.
4448
4449
4450### OH_ArkUI_AccessibilityValue_GetMin()
4451
4452```
4453int32_t OH_ArkUI_AccessibilityValue_GetMin (ArkUI_AccessibilityValue * value)
4454```
4455**Description**
4456
4457Obtains the minimum accessibility value.
4458
4459**Since**: 12
4460
4461**Parameters**
4462
4463| Name| Description|
4464| -------- | -------- |
4465| value | Pointer to an **AccessibilityValue** instance. |
4466
4467**Returns**
4468
4469Returns the minimum value based on the range component. The default value is **-1**. If a parameter error occurs, **-1** is returned.
4470
4471
4472### OH_ArkUI_AccessibilityValue_GetText()
4473
4474```
4475const char* OH_ArkUI_AccessibilityValue_GetText (ArkUI_AccessibilityValue * value)
4476```
4477**Description**
4478
4479Obtains the text description of an **AccessibilityValue** instance.
4480
4481**Since**: 12
4482
4483**Parameters**
4484
4485| Name| Description|
4486| -------- | -------- |
4487| value | Pointer to an **AccessibilityValue** instance. |
4488
4489**Returns**
4490
4491Returns the text description. The default value is an empty string. If a parameter error occurs, a null pointer is returned.
4492
4493
4494### OH_ArkUI_AccessibilityValue_SetCurrent()
4495
4496```
4497void OH_ArkUI_AccessibilityValue_SetCurrent (ArkUI_AccessibilityValue * value, int32_t current )
4498```
4499**Description**
4500
4501Sets the current accessibility value.
4502
4503**Since**: 12
4504
4505**Parameters**
4506
4507| Name| Description|
4508| -------- | -------- |
4509| value | Pointer to an **AccessibilityValue** instance. |
4510| current | Current value based on the range component. The default value is **-1**. |
4511
4512
4513### OH_ArkUI_AccessibilityValue_SetMax()
4514
4515```
4516void OH_ArkUI_AccessibilityValue_SetMax (ArkUI_AccessibilityValue * value, int32_t max )
4517```
4518**Description**
4519
4520Sets the maximum accessibility value.
4521
4522**Since**: 12
4523
4524**Parameters**
4525
4526| Name| Description|
4527| -------- | -------- |
4528| value | Pointer to an **AccessibilityValue** instance. |
4529| max | Maximum value based on the range component. The default value is **-1**. |
4530
4531
4532### OH_ArkUI_AccessibilityValue_SetMin()
4533
4534```
4535void OH_ArkUI_AccessibilityValue_SetMin (ArkUI_AccessibilityValue * value, int32_t min )
4536```
4537**Description**
4538
4539Sets the minimum accessibility value.
4540
4541**Since**: 12
4542
4543**Parameters**
4544
4545| Name| Description|
4546| -------- | -------- |
4547| value | Pointer to an **AccessibilityValue** instance. |
4548| min | Minimum value based on the range component. The default value is **-1**. |
4549
4550
4551### OH_ArkUI_AccessibilityValue_SetText()
4552
4553```
4554void OH_ArkUI_AccessibilityValue_SetText (ArkUI_AccessibilityValue * value, const char * text )
4555```
4556**Description**
4557
4558Sets the text description of an **AccessibilityValue** instance.
4559
4560**Since**: 12
4561
4562**Parameters**
4563
4564| Name| Description|
4565| -------- | -------- |
4566| value | Pointer to an **AccessibilityValue** instance. |
4567| text | Text description. The default value is an empty string. |
4568
4569
4570### OH_ArkUI_AlignmentRuleOption_Create()
4571
4572```
4573ArkUI_AlignmentRuleOption* OH_ArkUI_AlignmentRuleOption_Create ()
4574```
4575**Description**
4576
4577Creates an alignment rule configuration for this **RelativeContainer** component.
4578
4579**Since**: 12
4580
4581**Returns**
4582
4583Alignment rule information.
4584
4585
4586### OH_ArkUI_AlignmentRuleOption_Dispose()
4587
4588```
4589void OH_ArkUI_AlignmentRuleOption_Dispose (ArkUI_AlignmentRuleOption * option)
4590```
4591**Description**
4592
4593Disposes of an alignment rule configuration of this **RelativeContainer** component.
4594
4595**Since**: 12
4596
4597**Parameters**
4598
4599| Name| Description|
4600| -------- | -------- |
4601| option | Pointer to an alignment rule configuration. |
4602
4603
4604### OH_ArkUI_AlignmentRuleOption_GetBiasHorizontal()
4605
4606```
4607float OH_ArkUI_AlignmentRuleOption_GetBiasHorizontal (ArkUI_AlignmentRuleOption * option)
4608```
4609**Description**
4610
4611Obtains the bias value in the horizontal direction.
4612
4613**Since**: 12
4614
4615**Parameters**
4616
4617| Name| Description|
4618| -------- | -------- |
4619| option | Pointer to an alignment rule configuration. |
4620
4621**Returns**
4622
4623Bias value in the horizontal direction.
4624
4625
4626### OH_ArkUI_AlignmentRuleOption_GetBiasVertical()
4627
4628```
4629float OH_ArkUI_AlignmentRuleOption_GetBiasVertical (ArkUI_AlignmentRuleOption * option)
4630```
4631**Description**
4632
4633Obtains the bias value in the vertical direction.
4634
4635**Since**: 12
4636
4637**Parameters**
4638
4639| Name| Description|
4640| -------- | -------- |
4641| option | Pointer to an alignment rule configuration. |
4642
4643**Returns**
4644
4645Returns the bias value in the vertical direction.
4646
4647
4648### OH_ArkUI_AlignmentRuleOption_GetBottomAlignment()
4649
4650```
4651ArkUI_VerticalAlignment OH_ArkUI_AlignmentRuleOption_GetBottomAlignment (ArkUI_AlignmentRuleOption * option)
4652```
4653**Description**
4654
4655Obtains the alignment mode in bottom alignment parameters.
4656
4657**Since**: 12
4658
4659**Parameters**
4660
4661| Name| Description|
4662| -------- | -------- |
4663| option | Pointer to an alignment rule configuration. |
4664
4665**Returns**
4666
4667Returns the alignment mode in bottom alignment parameters.
4668
4669
4670### OH_ArkUI_AlignmentRuleOption_GetBottomId()
4671
4672```
4673const char* OH_ArkUI_AlignmentRuleOption_GetBottomId (ArkUI_AlignmentRuleOption * option)
4674```
4675**Description**
4676
4677Obtains the ID in bottom alignment parameters.
4678
4679**Since**: 12
4680
4681**Parameters**
4682
4683| Name| Description|
4684| -------- | -------- |
4685| option | Pointer to an alignment rule configuration. |
4686
4687**Returns**
4688
4689Returns the ID in bottom alignment parameters.
4690
4691
4692### OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentHorizontal()
4693
4694```
4695ArkUI_HorizontalAlignment OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentHorizontal (ArkUI_AlignmentRuleOption * option)
4696```
4697**Description**
4698
4699Obtains the alignment mode in horizontal center alignment parameters.
4700
4701**Since**: 12
4702
4703**Parameters**
4704
4705| Name| Description|
4706| -------- | -------- |
4707| option | Pointer to an alignment rule configuration. |
4708
4709**Returns**
4710
4711Returns the alignment mode in horizontal center alignment parameters.
4712
4713### OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentVertical()
4714
4715```
4716ArkUI_VerticalAlignment OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentVertical (ArkUI_AlignmentRuleOption * option)
4717```
4718**Description**
4719
4720Obtains the alignment mode in vertical center alignment parameters.
4721
4722**Since**: 12
4723
4724**Parameters**
4725
4726| Name| Description|
4727| -------- | -------- |
4728| option | Pointer to an alignment rule configuration. |
4729
4730**Returns**
4731
4732Returns the alignment mode in vertical center alignment parameters.
4733
4734
4735### OH_ArkUI_AlignmentRuleOption_GetCenterIdHorizontal()
4736
4737```
4738const char* OH_ArkUI_AlignmentRuleOption_GetCenterIdHorizontal (ArkUI_AlignmentRuleOption * option)
4739```
4740**Description**
4741
4742Obtains the alignment mode in horizontal center alignment parameters.
4743
4744**Since**: 12
4745
4746**Parameters**
4747
4748| Name| Description|
4749| -------- | -------- |
4750| option | Pointer to an alignment rule configuration. |
4751
4752**Returns**
4753
4754Returns the alignment mode in horizontal center alignment parameters.
4755
4756
4757### OH_ArkUI_AlignmentRuleOption_GetCenterIdVertical()
4758
4759```
4760const char* OH_ArkUI_AlignmentRuleOption_GetCenterIdVertical (ArkUI_AlignmentRuleOption * option)
4761```
4762**Description**
4763
4764Obtains the ID in vertical center alignment parameters.
4765
4766**Since**: 12
4767
4768**Parameters**
4769
4770| Name| Description|
4771| -------- | -------- |
4772| option | Pointer to an alignment rule configuration. |
4773
4774**Returns**
4775
4776Returns the ID in vertical center alignment parameters.
4777
4778
4779### OH_ArkUI_AlignmentRuleOption_GetEndAlignment()
4780
4781```
4782ArkUI_HorizontalAlignment OH_ArkUI_AlignmentRuleOption_GetEndAlignment (ArkUI_AlignmentRuleOption * option)
4783```
4784**Description**
4785
4786Obtains the alignment mode in the right alignment parameters.
4787
4788**Since**: 12
4789
4790**Parameters**
4791
4792| Name| Description|
4793| -------- | -------- |
4794| option | Pointer to an alignment rule configuration. |
4795
4796**Returns**
4797
4798Returns the alignment mode in the right alignment parameters.
4799
4800
4801### OH_ArkUI_AlignmentRuleOption_GetEndId()
4802
4803```
4804const char* OH_ArkUI_AlignmentRuleOption_GetEndId (ArkUI_AlignmentRuleOption * option)
4805```
4806**Description**
4807
4808Obtains the ID in the right alignment parameters.
4809
4810**Since**: 12
4811
4812**Parameters**
4813
4814| Name| Description|
4815| -------- | -------- |
4816| option | Pointer to an alignment rule configuration. |
4817
4818**Returns**
4819
4820Returns the ID in the right alignment parameters.
4821
4822
4823### OH_ArkUI_AlignmentRuleOption_GetStartAlignment()
4824
4825```
4826ArkUI_HorizontalAlignment OH_ArkUI_AlignmentRuleOption_GetStartAlignment (ArkUI_AlignmentRuleOption * option)
4827```
4828**Description**
4829
4830Obtains the alignment mode in left alignment parameters.
4831
4832**Since**: 12
4833
4834**Parameters**
4835
4836| Name| Description|
4837| -------- | -------- |
4838| option | Pointer to an alignment rule configuration. |
4839
4840**Returns**
4841
4842Returns the alignment mode in left alignment parameters.
4843
4844
4845### OH_ArkUI_AlignmentRuleOption_GetStartId()
4846
4847```
4848const char* OH_ArkUI_AlignmentRuleOption_GetStartId (ArkUI_AlignmentRuleOption * option)
4849```
4850**Description**
4851
4852Obtains the ID in the left alignment parameters.
4853
4854**Since**: 12
4855
4856**Parameters**
4857
4858| Name| Description|
4859| -------- | -------- |
4860| option | Pointer to an alignment rule configuration. |
4861
4862**Returns**
4863
4864Returns the ID in left alignment parameters.
4865
4866
4867### OH_ArkUI_AlignmentRuleOption_GetTopAlignment()
4868
4869```
4870ArkUI_VerticalAlignment OH_ArkUI_AlignmentRuleOption_GetTopAlignment (ArkUI_AlignmentRuleOption * option)
4871```
4872**Description**
4873
4874Obtains the alignment mode in top alignment parameters.
4875
4876**Since**: 12
4877
4878**Parameters**
4879
4880| Name| Description|
4881| -------- | -------- |
4882| option | Pointer to an alignment rule configuration. |
4883
4884**Returns**
4885
4886Returns the alignment mode in top alignment parameters.
4887
4888
4889### OH_ArkUI_AlignmentRuleOption_GetTopId()
4890
4891```
4892const char* OH_ArkUI_AlignmentRuleOption_GetTopId (ArkUI_AlignmentRuleOption * option)
4893```
4894**Description**
4895
4896Obtains the ID in top alignment parameters.
4897
4898**Since**: 12
4899
4900**Parameters**
4901
4902| Name| Description|
4903| -------- | -------- |
4904| option | Pointer to an alignment rule configuration. |
4905
4906**Returns**
4907
4908Returns the ID in top alignment parameters.
4909
4910
4911### OH_ArkUI_AlignmentRuleOption_SetBiasHorizontal()
4912
4913```
4914void OH_ArkUI_AlignmentRuleOption_SetBiasHorizontal (ArkUI_AlignmentRuleOption * option, float horizontal )
4915```
4916**Description**
4917
4918Sets the bias value of the component in the horizontal direction under the anchor constraints.
4919
4920**Since**: 12
4921
4922**Parameters**
4923
4924| Name| Description|
4925| -------- | -------- |
4926| option | Pointer to an alignment rule configuration. |
4927| horizontal | Bias value in the horizontal direction. |
4928
4929
4930### OH_ArkUI_AlignmentRuleOption_SetBiasVertical()
4931
4932```
4933void OH_ArkUI_AlignmentRuleOption_SetBiasVertical (ArkUI_AlignmentRuleOption * option, float vertical )
4934```
4935**Description**
4936
4937Sets the bias value of the component in the vertical direction under the anchor constraints.
4938
4939**Since**: 12
4940
4941**Parameters**
4942
4943| Name| Description|
4944| -------- | -------- |
4945| option | Pointer to an alignment rule configuration. |
4946| horizontal | Bias value in the vertical direction. |
4947
4948
4949### OH_ArkUI_AlignmentRuleOption_SetBottom()
4950
4951```
4952void OH_ArkUI_AlignmentRuleOption_SetBottom (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_VerticalAlignment alignment )
4953```
4954**Description**
4955
4956Sets the bottom alignment parameters.
4957
4958**Since**: 12
4959
4960**Parameters**
4961
4962| Name| Description|
4963| -------- | -------- |
4964| option | Pointer to an alignment rule configuration. |
4965| id | ID of the anchor component. |
4966| value | Alignment mode relative to the anchor component. |
4967
4968
4969### OH_ArkUI_AlignmentRuleOption_SetCenterHorizontal()
4970
4971```
4972void OH_ArkUI_AlignmentRuleOption_SetCenterHorizontal (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_HorizontalAlignment alignment )
4973```
4974**Description**
4975
4976Sets the horizontal center alignment parameters.
4977
4978**Since**: 12
4979
4980**Parameters**
4981
4982| Name| Description|
4983| -------- | -------- |
4984| option | Pointer to an alignment rule configuration. |
4985| id | ID of the anchor component. |
4986| value | Alignment mode relative to the anchor component. |
4987
4988
4989### OH_ArkUI_AlignmentRuleOption_SetCenterVertical()
4990
4991```
4992void OH_ArkUI_AlignmentRuleOption_SetCenterVertical (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_VerticalAlignment alignment )
4993```
4994**Description**
4995
4996Sets the vertical center alignment parameters.
4997
4998**Since**: 12
4999
5000**Parameters**
5001
5002| Name| Description|
5003| -------- | -------- |
5004| option | Pointer to an alignment rule configuration. |
5005| id | ID of the anchor component. |
5006| value | Alignment mode relative to the anchor component. |
5007
5008
5009### OH_ArkUI_AlignmentRuleOption_SetEnd()
5010
5011```
5012void OH_ArkUI_AlignmentRuleOption_SetEnd (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_HorizontalAlignment alignment )
5013```
5014**Description**
5015
5016Sets the right alignment parameters.
5017
5018**Since**: 12
5019
5020**Parameters**
5021
5022| Name| Description|
5023| -------- | -------- |
5024| option | Pointer to an alignment rule configuration. |
5025| id | ID of the anchor component. |
5026| value | Alignment mode relative to the anchor component. |
5027
5028
5029### OH_ArkUI_AlignmentRuleOption_SetStart()
5030
5031```
5032void OH_ArkUI_AlignmentRuleOption_SetStart (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_HorizontalAlignment alignment )
5033```
5034**Description**
5035
5036Sets the left alignment parameters.
5037
5038**Since**: 12
5039
5040**Parameters**
5041
5042| Name| Description|
5043| -------- | -------- |
5044| option | Pointer to an alignment rule configuration. |
5045| id | ID of the anchor component. |
5046| value | Alignment mode relative to the anchor component. |
5047
5048
5049### OH_ArkUI_AlignmentRuleOption_SetTop()
5050
5051```
5052void OH_ArkUI_AlignmentRuleOption_SetTop (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_VerticalAlignment alignment )
5053```
5054**Description**
5055
5056Sets the top alignment parameters.
5057
5058**Since**: 12
5059
5060**Parameters**
5061
5062| Name| Description|
5063| -------- | -------- |
5064| option | Pointer to an alignment rule configuration. |
5065| id | ID of the anchor component. |
5066| value | Alignment mode relative to the anchor component. |
5067
5068
5069### OH_ArkUI_AllowNodeAllDropDataTypes()
5070
5071```
5072int32_t OH_ArkUI_AllowNodeAllDropDataTypes (ArkUI_NodeHandle node)
5073```
5074**Description**
5075
5076Configures the specified component to allow any data types. This API resets the settings configured through [OH_ArkUI_SetNodeAllowedDropDataTypes](#oh_arkui_setnodealloweddropdatatypes).
5077
5078**Since**: 12
5079
5080**Parameters**
5081
5082| Name| Description|
5083| -------- | -------- |
5084| node | Pointer to a component node. |
5085
5086**Returns**
5087
5088Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
5089
5090
5091### OH_ArkUI_AnimateOption_Create()
5092
5093```
5094ArkUI_AnimateOption* OH_ArkUI_AnimateOption_Create ()
5095```
5096**Description**
5097
5098Creates an animation configuration.
5099
5100**Since**: 12
5101
5102**Returns**
5103
5104Returns the pointer to the created animation configuration.
5105
5106
5107### OH_ArkUI_AnimateOption_Dispose()
5108
5109```
5110void OH_ArkUI_AnimateOption_Dispose (ArkUI_AnimateOption * option)
5111```
5112**Description**
5113
5114Disposes of an animation configuration.
5115
5116**Since**: 12
5117
5118
5119### OH_ArkUI_AnimateOption_GetCurve()
5120
5121```
5122ArkUI_AnimationCurve OH_ArkUI_AnimateOption_GetCurve (ArkUI_AnimateOption * option)
5123```
5124**Description**
5125
5126Obtains an animation curve.
5127
5128**Since**: 12
5129
5130**Parameters**
5131
5132| Name| Description|
5133| -------- | -------- |
5134| option | Pointer to an animation configuration. |
5135
5136**Returns**
5137
5138Returns the animation curve.
5139
5140
5141### OH_ArkUI_AnimateOption_GetDelay()
5142
5143```
5144int32_t OH_ArkUI_AnimateOption_GetDelay (ArkUI_AnimateOption * option)
5145```
5146**Description**
5147
5148Obtains the animation delay, in milliseconds.
5149
5150**Since**: 12
5151
5152**Parameters**
5153
5154| Name| Description|
5155| -------- | -------- |
5156| option | Pointer to an animation configuration. |
5157
5158**Returns**
5159
5160Returns the animation delay.
5161
5162
5163### OH_ArkUI_AnimateOption_GetDuration()
5164
5165```
5166int32_t OH_ArkUI_AnimateOption_GetDuration (ArkUI_AnimateOption * option)
5167```
5168**Description**
5169
5170Obtains the animation duration, in milliseconds.
5171
5172**Since**: 12
5173
5174**Parameters**
5175
5176| Name| Description|
5177| -------- | -------- |
5178| option | Pointer to an animation configuration. |
5179
5180**Returns**
5181
5182Returns the animation duration.
5183
5184
5185### OH_ArkUI_AnimateOption_GetExpectedFrameRateRange()
5186
5187```
5188ArkUI_ExpectedFrameRateRange* OH_ArkUI_AnimateOption_GetExpectedFrameRateRange (ArkUI_AnimateOption * option)
5189```
5190**Description**
5191
5192Obtains the expected frame rate range of an animation.
5193
5194**Since**: 12
5195
5196**Parameters**
5197
5198| Name| Description|
5199| -------- | -------- |
5200| option | Pointer to an animation configuration. |
5201
5202**Returns**
5203
5204Returns the expected frame rate range.
5205
5206
5207### OH_ArkUI_AnimateOption_GetICurve()
5208
5209```
5210ArkUI_CurveHandle OH_ArkUI_AnimateOption_GetICurve (ArkUI_AnimateOption * option)
5211```
5212**Description**
5213
5214Obtains the animation curve of an animation.
5215
5216**Since**: 12
5217
5218**Parameters**
5219
5220| Name| Description|
5221| -------- | -------- |
5222| option | Pointer to an animation configuration. |
5223
5224**Returns**
5225
5226Returns the animation curve of the specified animation.
5227
5228
5229### OH_ArkUI_AnimateOption_GetIterations()
5230
5231```
5232int32_t OH_ArkUI_AnimateOption_GetIterations (ArkUI_AnimateOption * option)
5233```
5234**Description**
5235
5236Obtains the number of times that an animation is played.
5237
5238**Since**: 12
5239
5240**Parameters**
5241
5242| Name| Description|
5243| -------- | -------- |
5244| option | Pointer to an animation configuration. |
5245
5246**Returns**
5247
5248Returns the number of times that the animation is played.
5249
5250
5251### OH_ArkUI_AnimateOption_GetPlayMode()
5252
5253```
5254ArkUI_AnimationPlayMode OH_ArkUI_AnimateOption_GetPlayMode (ArkUI_AnimateOption * option)
5255```
5256**Description**
5257
5258Obtains the playback mode of an animation.
5259
5260**Since**: 12
5261
5262**Parameters**
5263
5264| Name| Description|
5265| -------- | -------- |
5266| option | Pointer to an animation configuration. |
5267
5268**Returns**
5269
5270Returns the animation playback mode.
5271
5272
5273### OH_ArkUI_AnimateOption_GetTempo()
5274
5275```
5276float OH_ArkUI_AnimateOption_GetTempo (ArkUI_AnimateOption * option)
5277```
5278**Description**
5279
5280Obtains the playback speed of an animation.
5281
5282**Since**: 12
5283
5284**Parameters**
5285
5286| Name| Description|
5287| -------- | -------- |
5288| option | Pointer to an animation configuration. |
5289
5290**Returns**
5291
5292Animation playback speed.
5293
5294
5295### OH_ArkUI_AnimateOption_SetCurve()
5296
5297```
5298void OH_ArkUI_AnimateOption_SetCurve (ArkUI_AnimateOption * option, ArkUI_AnimationCurve value )
5299```
5300**Description**
5301
5302Sets the animation curve.
5303
5304**Since**: 12
5305
5306**Parameters**
5307
5308| Name| Description|
5309| -------- | -------- |
5310| option | Pointer to an animation configuration. |
5311| value | Animation curve. Default value: **ARKUI_CURVE_LINEAR**. |
5312
5313
5314### OH_ArkUI_AnimateOption_SetDelay()
5315
5316```
5317void OH_ArkUI_AnimateOption_SetDelay (ArkUI_AnimateOption * option, int32_t value )
5318```
5319**Description**
5320
5321Sets the animation delay.
5322
5323**Since**: 12
5324
5325**Parameters**
5326
5327| Name| Description|
5328| -------- | -------- |
5329| option | Pointer to an animation configuration. |
5330| value | Delay of animation playback. |
5331
5332
5333### OH_ArkUI_AnimateOption_SetDuration()
5334
5335```
5336void OH_ArkUI_AnimateOption_SetDuration (ArkUI_AnimateOption * option, int32_t value )
5337```
5338**Description**
5339
5340Sets the animation duration.
5341
5342**Since**: 12
5343
5344**Parameters**
5345
5346| Name| Description|
5347| -------- | -------- |
5348| option | Pointer to an animation configuration. |
5349| value | Duration, in milliseconds. |
5350
5351
5352### OH_ArkUI_AnimateOption_SetExpectedFrameRateRange()
5353
5354```
5355void OH_ArkUI_AnimateOption_SetExpectedFrameRateRange (ArkUI_AnimateOption * option, ArkUI_ExpectedFrameRateRange * value )
5356```
5357**Description**
5358
5359Sets the expected frame rate range of the animation.
5360
5361**Since**: 12
5362
5363**Parameters**
5364
5365| Name| Description|
5366| -------- | -------- |
5367| option | Pointer to an animation configuration. |
5368| value | Expected frame rate range of the animation. |
5369
5370
5371### OH_ArkUI_AnimateOption_SetICurve()
5372
5373```
5374void OH_ArkUI_AnimateOption_SetICurve (ArkUI_AnimateOption * option, ArkUI_CurveHandle value )
5375```
5376**Description**
5377
5378Sets the animation curve for an animation.
5379
5380**Since**: 12
5381
5382**Parameters**
5383
5384| Name| Description|
5385| -------- | -------- |
5386| option | Pointer to an animation configuration. |
5387| value | Animation curve settings. |
5388
5389**NOTE**
5390
5391This API is preferred over the value set by **OH_ArkUI_AnimateOption_SetCurve**.
5392
5393
5394### OH_ArkUI_AnimateOption_SetIterations()
5395
5396```
5397void OH_ArkUI_AnimateOption_SetIterations (ArkUI_AnimateOption * option, int32_t value )
5398```
5399**Description**
5400
5401Sets the number of times that an animation is played.
5402
5403**Since**: 12
5404
5405**Parameters**
5406
5407| Name| Description|
5408| -------- | -------- |
5409| option | Pointer to an animation configuration. |
5410| value | Number of times that the animation is played. |
5411
5412
5413### OH_ArkUI_AnimateOption_SetPlayMode()
5414
5415```
5416void OH_ArkUI_AnimateOption_SetPlayMode (ArkUI_AnimateOption * option, ArkUI_AnimationPlayMode value )
5417```
5418**Description**
5419
5420Sets the playback mode for an animation.
5421
5422**Since**: 12
5423
5424**Parameters**
5425
5426| Name| Description|
5427| -------- | -------- |
5428| option | Pointer to an animation configuration. |
5429| value | Animation playback mode. |
5430
5431
5432### OH_ArkUI_AnimateOption_SetTempo()
5433
5434```
5435void OH_ArkUI_AnimateOption_SetTempo (ArkUI_AnimateOption * option, float value )
5436```
5437**Description**
5438
5439Sets the playback speed of an animation.
5440
5441**Since**: 12
5442
5443**Parameters**
5444
5445| Name| Description|
5446| -------- | -------- |
5447| option | Pointer to an animation configuration. |
5448| value | Animation playback speed. |
5449
5450
5451### OH_ArkUI_Animator_Cancel()
5452
5453```
5454int32_t OH_ArkUI_Animator_Cancel (ArkUI_AnimatorHandle animator)
5455```
5456**Description**
5457
5458Cancels the animation of an animator.
5459
5460**Parameters**
5461
5462| Name| Description|
5463| -------- | -------- |
5464| animator | Animator object. |
5465
5466**Returns**
5467
5468Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
5469
5470
5471### OH_ArkUI_Animator_Finish()
5472
5473```
5474int32_t OH_ArkUI_Animator_Finish (ArkUI_AnimatorHandle animator)
5475```
5476**Description**
5477
5478Ends the animation of an animator.
5479
5480**Parameters**
5481
5482| Name| Description|
5483| -------- | -------- |
5484| animator | Animator object. |
5485
5486**Returns**
5487
5488Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
5489
5490
5491### OH_ArkUI_Animator_Pause()
5492
5493```
5494int32_t OH_ArkUI_Animator_Pause (ArkUI_AnimatorHandle animator)
5495```
5496**Description**
5497
5498Pauses the animation of an animator.
5499
5500**Parameters**
5501
5502| Name| Description|
5503| -------- | -------- |
5504| animator | Animator object. |
5505
5506**Returns**
5507
5508Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
5509
5510
5511### OH_ArkUI_Animator_Play()
5512
5513```
5514int32_t OH_ArkUI_Animator_Play (ArkUI_AnimatorHandle animator)
5515```
5516**Description**
5517
5518Starts the animation of an animator.
5519
5520**Parameters**
5521
5522| Name| Description|
5523| -------- | -------- |
5524| animator | Animator object. |
5525
5526**Returns**
5527
5528Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
5529
5530
5531### OH_ArkUI_Animator_ResetAnimatorOption()
5532
5533```
5534int32_t OH_ArkUI_Animator_ResetAnimatorOption (ArkUI_AnimatorHandle animator, ArkUI_AnimatorOption * option )
5535```
5536**Description**
5537
5538Resets an animator configuration.
5539
5540**Parameters**
5541
5542| Name| Description|
5543| -------- | -------- |
5544| animator | Animator object. |
5545| option | Pointer to an animation configuration. |
5546
5547**Returns**
5548
5549Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
5550
5551
5552### OH_ArkUI_Animator_Reverse()
5553
5554```
5555int32_t OH_ArkUI_Animator_Reverse (ArkUI_AnimatorHandle animator)
5556```
5557**Description**
5558
5559Plays the animation of an animator in reverse order.
5560
5561**Parameters**
5562
5563| Name| Description|
5564| -------- | -------- |
5565| animator | Animator object. |
5566
5567**Returns**
5568
5569Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
5570
5571
5572### OH_ArkUI_AnimatorEvent_GetUserData()
5573
5574```
5575void* OH_ArkUI_AnimatorEvent_GetUserData (ArkUI_AnimatorEvent * event)
5576```
5577**Description**
5578
5579Obtains the custom object in an animation event object.
5580
5581**Since**: 12
5582
5583**Parameters**
5584
5585| Name| Description|
5586| -------- | -------- |
5587| event | Animation event object. |
5588
5589**Returns**
5590
5591Returns the custom object.
5592
5593
5594### OH_ArkUI_AnimatorOnFrameEvent_GetUserData()
5595
5596```
5597void* OH_ArkUI_AnimatorOnFrameEvent_GetUserData (ArkUI_AnimatorOnFrameEvent * event)
5598```
5599**Description**
5600
5601Obtains the custom object in an animation event object.
5602
5603**Since**: 12
5604
5605**Parameters**
5606
5607| Name| Description|
5608| -------- | -------- |
5609| event | Animation event object. |
5610
5611**Returns**
5612
5613Returns the custom object.
5614
5615
5616### OH_ArkUI_AnimatorOnFrameEvent_GetValue()
5617
5618```
5619float OH_ArkUI_AnimatorOnFrameEvent_GetValue (ArkUI_AnimatorOnFrameEvent * event)
5620```
5621**Description**
5622
5623Obtains the current progress in an animation event object.
5624
5625**Since**: 12
5626
5627**Parameters**
5628
5629| Name| Description|
5630| -------- | -------- |
5631| event | Animation event object. |
5632
5633**Returns**
5634
5635Returns the animation progress.
5636
5637
5638### OH_ArkUI_AnimatorOption_Create()
5639
5640```
5641ArkUI_AnimatorOption* OH_ArkUI_AnimatorOption_Create (int32_t keyframeSize)
5642```
5643**Description**
5644
5645Creates an animator parameter object.
5646
5647**Since**: 12
5648
5649**Parameters**
5650
5651| Name| Description|
5652| -------- | -------- |
5653| keyframeSize | Number of keyframes. |
5654
5655**NOTE**
5656
5657If the value of **keyframeSize** is greater than 0, the animation interpolation start point is 0, and the animation interpolation end point is 1; no setting is allowed.
5658
5659**Returns**
5660
5661Returns the pointer to the animator parameter object.
5662
5663
5664### OH_ArkUI_AnimatorOption_Dispose()
5665
5666```
5667void OH_ArkUI_AnimatorOption_Dispose (ArkUI_AnimatorOption * option)
5668```
5669**Description**
5670
5671Disposes of an **AnimatorOption** object.
5672
5673**Since**: 12
5674
5675
5676### OH_ArkUI_AnimatorOption_GetBegin()
5677
5678```
5679float OH_ArkUI_AnimatorOption_GetBegin (ArkUI_AnimatorOption * option)
5680```
5681**Description**
5682
5683Obtains the interpolation start point of an animation.
5684
5685**Since**: 12
5686
5687**Parameters**
5688
5689| Name| Description|
5690| -------- | -------- |
5691| option | Pointer to an animation configuration. |
5692
5693**Returns**
5694
5695Returns the start point of the animation interpolation.
5696
5697
5698### OH_ArkUI_AnimatorOption_GetCurve()
5699
5700```
5701ArkUI_CurveHandle OH_ArkUI_AnimatorOption_GetCurve (ArkUI_AnimatorOption * option)
5702```
5703**Description**
5704
5705Obtains the interpolation curve of the animation of an animator.
5706
5707**Since**: 12
5708
5709**Parameters**
5710
5711| Name| Description|
5712| -------- | -------- |
5713| option | Pointer to an animation configuration. |
5714
5715**Returns**
5716
5717Returns the interpolation curve of the animation.
5718
5719
5720### OH_ArkUI_AnimatorOption_GetDelay()
5721
5722```
5723int32_t OH_ArkUI_AnimatorOption_GetDelay (ArkUI_AnimatorOption * option)
5724```
5725**Description**
5726
5727Obtains the delay for playing an animation.
5728
5729**Since**: 12
5730
5731**Parameters**
5732
5733| Name| Description|
5734| -------- | -------- |
5735| option | Pointer to an animation configuration. |
5736
5737**Returns**
5738
5739Returns the delay for playing the animation, in milliseconds.
5740
5741
5742### OH_ArkUI_AnimatorOption_GetDirection()
5743
5744```
5745ArkUI_AnimationDirection OH_ArkUI_AnimatorOption_GetDirection (ArkUI_AnimatorOption * option)
5746```
5747**Description**
5748
5749Obtains the playback direction of an animation.
5750
5751**Since**: 12
5752
5753**Parameters**
5754
5755| Name| Description|
5756| -------- | -------- |
5757| option | Pointer to an animation configuration. |
5758
5759**Returns**
5760
5761Returns the animation playback direction.
5762
5763
5764### OH_ArkUI_AnimatorOption_GetDuration()
5765
5766```
5767int32_t OH_ArkUI_AnimatorOption_GetDuration (ArkUI_AnimatorOption * option)
5768```
5769**Description**
5770
5771Obtains the duration for playing an animation.
5772
5773**Since**: 12
5774
5775**Parameters**
5776
5777| Name| Description|
5778| -------- | -------- |
5779| option | Pointer to an animation configuration. |
5780
5781**Returns**
5782
5783Returns the duration for playing the animation, in milliseconds.
5784
5785
5786### OH_ArkUI_AnimatorOption_GetEnd()
5787
5788```
5789float OH_ArkUI_AnimatorOption_GetEnd (ArkUI_AnimatorOption * option)
5790```
5791**Description**
5792
5793Obtains the interpolation end point of an animation.
5794
5795**Since**: 12
5796
5797**Parameters**
5798
5799| Name| Description|
5800| -------- | -------- |
5801| option | Pointer to an animation configuration. |
5802
5803**Returns**
5804
5805Returns the interpolation end point of the animation.
5806
5807
5808### OH_ArkUI_AnimatorOption_GetExpectedFrameRateRange()
5809
5810```
5811ArkUI_ExpectedFrameRateRange* OH_ArkUI_AnimatorOption_GetExpectedFrameRateRange (ArkUI_AnimatorOption * option)
5812```
5813**Description**
5814
5815Obtains the expected frame rate range of an animation.
5816
5817**Since**: 12
5818
5819**Parameters**
5820
5821| Name| Description|
5822| -------- | -------- |
5823| option | Pointer to an animation configuration. |
5824
5825**Returns**
5826
5827Returns the pointer to the expected frame rate range object.
5828
5829
5830### OH_ArkUI_AnimatorOption_GetFill()
5831
5832```
5833ArkUI_AnimationFill OH_ArkUI_AnimatorOption_GetFill (ArkUI_AnimatorOption * option)
5834```
5835**Description**
5836
5837Obtains whether the animator animation is restored to the initial state after being executed.
5838
5839**Since**: 12
5840
5841**Parameters**
5842
5843| Name| Description|
5844| -------- | -------- |
5845| option | Pointer to an animation configuration. |
5846
5847**Returns**
5848
5849Returns whether the animator animation is restored to the initial state after being executed.
5850
5851
5852### OH_ArkUI_AnimatorOption_GetIterations()
5853
5854```
5855int32_t OH_ArkUI_AnimatorOption_GetIterations (ArkUI_AnimatorOption * option)
5856```
5857**Description**
5858
5859Obtains the number of times that an animation is played.
5860
5861**Since**: 12
5862
5863**Parameters**
5864
5865| Name| Description|
5866| -------- | -------- |
5867| option | Pointer to an **AnimatorOption** object. |
5868
5869**Returns**
5870
5871Number of times that the animation is played.
5872
5873### OH_ArkUI_AnimatorOption_GetKeyframeCurve()
5874
5875```
5876ArkUI_CurveHandle OH_ArkUI_AnimatorOption_GetKeyframeCurve (ArkUI_AnimatorOption * option, int32_t index )
5877```
5878**Description**
5879
5880Obtains the interpolation curve for a keyframe in the animation of an animator.
5881
5882**Since**: 12
5883
5884**Parameters**
5885
5886| Name| Description|
5887| -------- | -------- |
5888| option | Pointer to an **AnimatorOption** object. |
5889| index | Keyframe index. |
5890
5891**Returns**
5892
5893Returns the interpolation curve.
5894
5895
5896### OH_ArkUI_AnimatorOption_GetKeyframeTime()
5897
5898```
5899float OH_ArkUI_AnimatorOption_GetKeyframeTime (ArkUI_AnimatorOption * option, int32_t index )
5900```
5901**Description**
5902
5903Obtains the keyframe time of an animation.
5904
5905**Since**: 12
5906
5907**Parameters**
5908
5909| Name| Description|
5910| -------- | -------- |
5911| option | Pointer to an **AnimatorOption** object. |
5912| index | Keyframe index. |
5913
5914**Returns**
5915
5916Keyframe time.
5917
5918
5919### OH_ArkUI_AnimatorOption_GetKeyframeValue()
5920
5921```
5922float OH_ArkUI_AnimatorOption_GetKeyframeValue (ArkUI_AnimatorOption * option, int32_t index )
5923```
5924**Description**
5925
5926Obtains the keyframe value of an animation.
5927
5928**Since**: 12
5929
5930**Parameters**
5931
5932| Name| Description|
5933| -------- | -------- |
5934| option | Pointer to an **AnimatorOption** object. |
5935| index | Keyframe index. |
5936
5937**Returns**
5938
5939Keyframe value.
5940
5941
5942### OH_ArkUI_AnimatorOption_RegisterOnCancelCallback()
5943
5944```
5945int32_t OH_ArkUI_AnimatorOption_RegisterOnCancelCallback (ArkUI_AnimatorOption * option, void * userData, void(*)(ArkUI_AnimatorEvent *event) callback )
5946```
5947**Description**
5948
5949Sets the callback invoked when the animation playback is canceled.
5950
5951**Parameters**
5952
5953| Name| Description|
5954| -------- | -------- |
5955| option | Pointer to an animation configuration. |
5956| userData | Custom parameter. |
5957| callback | Callback used to return the result. |
5958
5959**Returns**
5960
5961Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
5962
5963
5964### OH_ArkUI_AnimatorOption_RegisterOnFinishCallback()
5965
5966```
5967int32_t OH_ArkUI_AnimatorOption_RegisterOnFinishCallback (ArkUI_AnimatorOption * option, void * userData, void(*)(ArkUI_AnimatorEvent *event) callback )
5968```
5969**Description**
5970
5971Sets the callback invoked when the animation playback is complete.
5972
5973**Parameters**
5974
5975| Name| Description|
5976| -------- | -------- |
5977| option | Pointer to an animation configuration. |
5978| userData | Custom parameter. |
5979| callback | Callback used to return the result. |
5980
5981**Returns**
5982
5983Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
5984
5985
5986### OH_ArkUI_AnimatorOption_RegisterOnFrameCallback()
5987
5988```
5989int32_t OH_ArkUI_AnimatorOption_RegisterOnFrameCallback (ArkUI_AnimatorOption * option, void * userData, void(*)(ArkUI_AnimatorOnFrameEvent *event) callback )
5990```
5991**Description**
5992
5993Sets the callback invoked when the animator receives a frame.
5994
5995**Parameters**
5996
5997| Name| Description|
5998| -------- | -------- |
5999| option | Pointer to an animation configuration. |
6000| userData | Custom parameter. |
6001| callback | Callback used to return the result. |
6002
6003**Returns**
6004
6005Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6006
6007
6008### OH_ArkUI_AnimatorOption_RegisterOnRepeatCallback()
6009
6010```
6011int32_t OH_ArkUI_AnimatorOption_RegisterOnRepeatCallback (ArkUI_AnimatorOption * option, void * userData, void(*)(ArkUI_AnimatorEvent *event) callback )
6012```
6013**Description**
6014
6015Sets the callback invoked when the animation playback is repeated.
6016
6017**Parameters**
6018
6019| Name| Description|
6020| -------- | -------- |
6021| option | Pointer to an animation configuration. |
6022| userData | Custom parameter. |
6023| callback | Callback used to return the result. |
6024
6025**Returns**
6026
6027Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6028
6029
6030### OH_ArkUI_AnimatorOption_SetBegin()
6031
6032```
6033int32_t OH_ArkUI_AnimatorOption_SetBegin (ArkUI_AnimatorOption * option, float value )
6034```
6035**Description**
6036
6037Sets the interpolation start point for the animation of an animator.
6038
6039**Parameters**
6040
6041| Name| Description|
6042| -------- | -------- |
6043| option | Pointer to an **AnimatorOption** object. |
6044| value | Start point of the animation interpolation. |
6045
6046**NOTE**
6047
6048This API does not take effect when the animation is a keyframe animation.
6049
6050**Returns**
6051
6052Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6053
6054
6055### OH_ArkUI_AnimatorOption_SetCurve()
6056
6057```
6058int32_t OH_ArkUI_AnimatorOption_SetCurve (ArkUI_AnimatorOption * option, ArkUI_CurveHandle value )
6059```
6060**Description**
6061
6062Sets the interpolation curve for the animation of an animator.
6063
6064**Parameters**
6065
6066| Name| Description|
6067| -------- | -------- |
6068| option | Pointer to an **AnimatorOption** object. |
6069| value | Interpolation curve of the animation. Default value: **ARKUI_CURVE_LINEAR**. |
6070
6071**NOTE**
6072
6073The **springCurve**, **springMotion**, **responsiveSpringMotion**, and **interpolatingSpring customCurve** curves are not supported.
6074
6075**Returns**
6076
6077Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6078
6079
6080### OH_ArkUI_AnimatorOption_SetDelay()
6081
6082```
6083int32_t OH_ArkUI_AnimatorOption_SetDelay (ArkUI_AnimatorOption * option, int32_t value )
6084```
6085**Description**
6086
6087Sets the delay of animation playback, in milliseconds.
6088
6089**Parameters**
6090
6091| Name| Description|
6092| -------- | -------- |
6093| option | Pointer to an **AnimatorOption** object. |
6094| value | Animation delay, in milliseconds. |
6095
6096**Returns**
6097
6098Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6099
6100
6101### OH_ArkUI_AnimatorOption_SetDirection()
6102
6103```
6104int32_t OH_ArkUI_AnimatorOption_SetDirection (ArkUI_AnimatorOption * option, ArkUI_AnimationDirection value )
6105```
6106**Description**
6107
6108Sets the playback direction.
6109
6110**Parameters**
6111
6112| Name| Description|
6113| -------- | -------- |
6114| option | Pointer to an **AnimatorOption** object. |
6115| value | Animation playback direction. |
6116
6117**Returns**
6118
6119Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6120
6121
6122### OH_ArkUI_AnimatorOption_SetDuration()
6123
6124```
6125int32_t OH_ArkUI_AnimatorOption_SetDuration (ArkUI_AnimatorOption * option, int32_t value )
6126```
6127**Description**
6128
6129Sets the duration of an animation, in milliseconds.
6130
6131**Parameters**
6132
6133| Name| Description|
6134| -------- | -------- |
6135| option | Pointer to an **AnimatorOption** object. |
6136| value | Duration for playing the animation, in milliseconds. |
6137
6138**Returns**
6139
6140Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6141
6142
6143### OH_ArkUI_AnimatorOption_SetEnd()
6144
6145```
6146int32_t OH_ArkUI_AnimatorOption_SetEnd (ArkUI_AnimatorOption * option, float value )
6147```
6148**Description**
6149
6150Sets the interpolation end point for the animation of an animator.
6151
6152**Parameters**
6153
6154| Name| Description|
6155| -------- | -------- |
6156| option | Pointer to an **AnimatorOption** object. |
6157| value | End point of animation interpolation. |
6158
6159**NOTE**
6160
6161This API does not take effect when the animation is a keyframe animation.
6162
6163**Returns**
6164
6165Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6166
6167
6168### OH_ArkUI_AnimatorOption_SetExpectedFrameRateRange()
6169
6170```
6171int32_t OH_ArkUI_AnimatorOption_SetExpectedFrameRateRange (ArkUI_AnimatorOption * option, ArkUI_ExpectedFrameRateRange * value )
6172```
6173**Description**
6174
6175Sets the expected frame rate range of an animation.
6176
6177**Parameters**
6178
6179| Name| Description|
6180| -------- | -------- |
6181| option | Pointer to an **AnimatorOption** object. |
6182| value | Expected frame rate range. |
6183
6184**Returns**
6185
6186Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6187
6188
6189### OH_ArkUI_AnimatorOption_SetFill()
6190
6191```
6192int32_t OH_ArkUI_AnimatorOption_SetFill (ArkUI_AnimatorOption * option, ArkUI_AnimationFill value )
6193```
6194**Description**
6195
6196Sets whether the animator animation is restored to the initial state after being executed.
6197
6198**Parameters**
6199
6200| Name| Description|
6201| -------- | -------- |
6202| option | Pointer to an **AnimatorOption** object. |
6203| value | Whether to restore the animation to the initial state after the animation is executed. |
6204
6205**Returns**
6206
6207Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6208
6209
6210### OH_ArkUI_AnimatorOption_SetIterations()
6211
6212```
6213int32_t OH_ArkUI_AnimatorOption_SetIterations (ArkUI_AnimatorOption * option, int32_t value )
6214```
6215**Description**
6216
6217Sets the number of times that the frame animation is played. The value **0** means not to play the animation, and **-1** means to play the animation for an unlimited number of times.
6218
6219**Parameters**
6220
6221| Name| Description|
6222| -------- | -------- |
6223| option | Pointer to an **AnimatorOption** object. |
6224| value | Number of times that the animation is played. |
6225
6226**NOTE**
6227
6228If this parameter is set to a negative value other than **-1**, the value is invalid. In this case, the animation is played once.
6229
6230**Returns**
6231
6232Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6233
6234
6235### OH_ArkUI_AnimatorOption_SetKeyframe()
6236
6237```
6238int32_t OH_ArkUI_AnimatorOption_SetKeyframe (ArkUI_AnimatorOption * option, float time, float value, int32_t index )
6239```
6240**Description**
6241
6242Sets the keyframe parameters of an animation.
6243
6244**Parameters**
6245
6246| Name| Description|
6247| -------- | -------- |
6248| option | Pointer to an **AnimatorOption** object. |
6249| time | Keyframe time. Value range: [0, 1]. The value must be in ascending order. |
6250| value | Keyframe value. |
6251| index | Keyframe index. |
6252
6253**Returns**
6254
6255Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6256
6257
6258### OH_ArkUI_AnimatorOption_SetKeyframeCurve()
6259
6260```
6261int32_t OH_ArkUI_AnimatorOption_SetKeyframeCurve (ArkUI_AnimatorOption * option, ArkUI_CurveHandle value, int32_t index )
6262```
6263**Description**
6264
6265Sets the keyframe curve type for the animation of an animator.
6266
6267**Parameters**
6268
6269| Name| Description|
6270| -------- | -------- |
6271| option | Pointer to an **AnimatorOption** object. |
6272| value | Animation interpolation curve. |
6273| index | Keyframe index. |
6274
6275**NOTE**
6276
6277The **springCurve**, **springMotion**, **responsiveSpringMotion**, and **interpolatingSpring customCurve** curves are not supported.
6278
6279**Returns**
6280
6281Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6282
6283
6284### OH_ArkUI_BarrierOption_Create()
6285
6286```
6287ArkUI_BarrierOption* OH_ArkUI_BarrierOption_Create (int32_t size)
6288```
6289**Description**
6290
6291Creates a barrier configuration for this **RelativeContainer** component.
6292
6293**Since**: 12
6294
6295**Parameters**
6296
6297| Name| Description|
6298| -------- | -------- |
6299| size | Number of barriers. |
6300
6301**Returns**
6302
6303Returns the barrier configuration.
6304
6305
6306### OH_ArkUI_BarrierOption_Dispose()
6307
6308```
6309void OH_ArkUI_BarrierOption_Dispose (ArkUI_BarrierOption * barrierStyle)
6310```
6311**Description**
6312
6313Disposes of a barrier configuration.
6314
6315**Since**: 12
6316
6317**Parameters**
6318
6319| Name| Description|
6320| -------- | -------- |
6321| barrierStyle | Pointer to a barrier configuration. |
6322
6323
6324### OH_ArkUI_BarrierOption_GetDirection()
6325
6326```
6327ArkUI_BarrierDirection OH_ArkUI_BarrierOption_GetDirection (ArkUI_BarrierOption * barrierStyle, int32_t index )
6328```
6329**Description**
6330
6331Obtains the direction of a barrier.
6332
6333**Since**: 12
6334
6335**Parameters**
6336
6337| Name| Description|
6338| -------- | -------- |
6339| barrierStyle | Pointer to a barrier configuration. |
6340| index | Index of the barrier. |
6341
6342**Returns**
6343
6344Returns the direction of the barrier.
6345
6346
6347### OH_ArkUI_BarrierOption_GetId()
6348
6349```
6350const char* OH_ArkUI_BarrierOption_GetId (ArkUI_BarrierOption * barrierStyle, int32_t index )
6351```
6352**Description**
6353
6354Obtains the ID of a barrier.
6355
6356**Since**: 12
6357
6358**Parameters**
6359
6360| Name| Description|
6361| -------- | -------- |
6362| barrierStyle | Pointer to a barrier configuration. |
6363| index | Index of the barrier. |
6364
6365**Returns**
6366
6367Returns the ID of the barrier.
6368
6369
6370### OH_ArkUI_BarrierOption_GetReferencedId()
6371
6372```
6373const char* OH_ArkUI_BarrierOption_GetReferencedId (ArkUI_BarrierOption * barrierStyle, int32_t index, int32_t referencedIndex )
6374```
6375**Description**
6376
6377Obtains the referenced components of a barrier.
6378
6379**Since**: 12
6380
6381**Parameters**
6382
6383| Name| Description|
6384| -------- | -------- |
6385| barrierStyle | Pointer to a barrier configuration. |
6386| index | Index of the barrier. |
6387| referencedIndex | Index of the referenced component ID. |
6388
6389**Returns**
6390
6391Returns the referenced components of the barrier.
6392
6393
6394### OH_ArkUI_BarrierOption_GetReferencedIdSize()
6395
6396```
6397int32_t OH_ArkUI_BarrierOption_GetReferencedIdSize (ArkUI_BarrierOption * barrierStyle, int32_t index )
6398```
6399**Description**
6400
6401Obtains the number of referenced components of a barrier.
6402
6403**Since**: 12
6404
6405**Parameters**
6406
6407| Name| Description|
6408| -------- | -------- |
6409| barrierStyle | Pointer to a barrier configuration. |
6410| index | Index of the barrier. |
6411
6412**Returns**
6413
6414Returns the number of referenced components of the barrier.
6415
6416
6417### OH_ArkUI_BarrierOption_SetDirection()
6418
6419```
6420void OH_ArkUI_BarrierOption_SetDirection (ArkUI_BarrierOption * barrierStyle, ArkUI_BarrierDirection value, int32_t index )
6421```
6422**Description**
6423
6424Sets the direction of a barrier.
6425
6426**Since**: 12
6427
6428**Parameters**
6429
6430| Name| Description|
6431| -------- | -------- |
6432| barrierStyle | Pointer to a barrier configuration. |
6433| value | Direction.  |
6434| index | Index of the barrier. |
6435
6436
6437### OH_ArkUI_BarrierOption_SetId()
6438
6439```
6440void OH_ArkUI_BarrierOption_SetId (ArkUI_BarrierOption * barrierStyle, const char * value, int32_t index )
6441```
6442**Description**
6443
6444Sets the ID of a barrier.
6445
6446**Since**: 12
6447
6448**Parameters**
6449
6450| Name| Description|
6451| -------- | -------- |
6452| barrierStyle | Pointer to a barrier configuration. |
6453| value | ID of the barrier, which must be unique and cannot be the same as the name of any component in the container. |
6454| index | Index of the barrier. |
6455
6456
6457### OH_ArkUI_BarrierOption_SetReferencedId()
6458
6459```
6460void OH_ArkUI_BarrierOption_SetReferencedId (ArkUI_BarrierOption * barrierStyle, const char * value, int32_t index )
6461```
6462**Description**
6463
6464Sets the referenced components of a barrier.
6465
6466**Since**: 12
6467
6468**Parameters**
6469
6470| Name| Description|
6471| -------- | -------- |
6472| barrierStyle | Pointer to a barrier configuration. |
6473| value | Referenced component IDs. |
6474| index | Index of the barrier. |
6475
6476
6477### OH_ArkUI_ConvertToHtml()
6478
6479```
6480const char* OH_ArkUI_ConvertToHtml (ArkUI_StyledString_Descriptor * descriptor)
6481```
6482**Description**
6483
6484Converts styled string information into HTML.
6485
6486**Since**: 14
6487
6488**Parameters**
6489
6490| Name| Description|
6491| -------- | -------- |
6492| descriptor | Pointer to an **ArkUI_StyledString_Descriptor** object. |
6493
6494**Returns**
6495
6496Returns an HTML object. The pointer is managed internally and should be destroyed by calling **OH_ArkUI_StyledString_Descriptor_Destroy()** when no longer needed to free the memory.
6497
6498
6499### OH_ArkUI_CreateAsymmetricTransitionEffect()
6500
6501```
6502ArkUI_TransitionEffect* OH_ArkUI_CreateAsymmetricTransitionEffect (ArkUI_TransitionEffect * appear, ArkUI_TransitionEffect * disappear )
6503```
6504**Description**
6505
6506Creates an asymmetric transition effect.
6507
6508**Since**: 12
6509
6510**Parameters**
6511
6512| Name| Description|
6513| -------- | -------- |
6514| appear | Transition effect for appearance. |
6515| disappear | Transition effect for disappearance. |
6516
6517**NOTE**
6518
6519If the **asymmetric** function is not used for constructing **TransitionEffect**, the transition effect takes effect for both appearance and disappearance of the component.
6520
6521**Returns**
6522
6523Returns the asymmetric transition effect; returns **NULL** if a parameter error occurs.
6524
6525
6526### OH_ArkUI_CreateDragActionWithContext()
6527
6528```
6529ArkUI_DragAction* OH_ArkUI_CreateDragActionWithContext (ArkUI_ContextHandle uiContext)
6530```
6531**Description**
6532
6533Creates a drag action object for the specified UI instance.
6534
6535**Since**: 12
6536
6537**Parameters**
6538
6539| Name| Description|
6540| -------- | -------- |
6541| uiContext | Pointer to the UI instance object. |
6542
6543**Returns**
6544
6545Returns the pointer to the created drag action object; returns null if the operation fails.
6546
6547
6548### OH_ArkUI_CreateDragActionWithNode()
6549
6550```
6551ArkUI_DragAction* OH_ArkUI_CreateDragActionWithNode (ArkUI_NodeHandle node)
6552```
6553**Description**
6554
6555Creates a drag action object. The object needs to be associated with a UI instance, which can be specified by passing in a component node of the current UI instance.
6556
6557**Since**: 12
6558
6559**Parameters**
6560
6561| Name| Description|
6562| -------- | -------- |
6563| node | Pointer to a component node. |
6564
6565**Returns**
6566
6567Returns the pointer to the created drag action object; returns null if the operation fails.
6568
6569
6570### OH_ArkUI_CreateDragPreviewOption()
6571
6572```
6573ArkUI_DragPreviewOption* OH_ArkUI_CreateDragPreviewOption (void )
6574```
6575**Description**
6576
6577Creates an **ArkUI_DragPreviewOption** object.
6578
6579**Since**: 12
6580
6581**Returns**
6582
6583ArkUI_DragPreviewOption object.
6584
6585
6586### OH_ArkUI_CreateMovementTransitionEffect()
6587
6588```
6589ArkUI_TransitionEffect* OH_ArkUI_CreateMovementTransitionEffect (ArkUI_TransitionEdge move)
6590```
6591**Description**
6592
6593Creates a movement object for component transition.
6594
6595**Since**: 12
6596
6597**Parameters**
6598
6599| Name| Description|
6600| -------- | -------- |
6601| move | Panning type. |
6602
6603**Returns**
6604
6605Returns the movement object created for component transition; returns **NULL** if a parameter error occurs.
6606
6607
6608### OH_ArkUI_CreateOpacityTransitionEffect()
6609
6610```
6611ArkUI_TransitionEffect* OH_ArkUI_CreateOpacityTransitionEffect (float opacity)
6612```
6613**Description**
6614
6615Creates an opacity object for component transition.
6616
6617**Since**: 12
6618
6619**Parameters**
6620
6621| Name| Description|
6622| -------- | -------- |
6623| opacity | Opacity. The value range is [0, 1]. |
6624
6625**NOTE**
6626
6627If the value specified is less than 0, the value **0** is used. If the value specified is greater than 1, the value **1** is used.
6628
6629**Returns**
6630
6631Returns the created opacity object for component transition.
6632
6633
6634### OH_ArkUI_CreateRotationTransitionEffect()
6635
6636```
6637ArkUI_TransitionEffect* OH_ArkUI_CreateRotationTransitionEffect (ArkUI_RotationOptions * rotate)
6638```
6639**Description**
6640
6641Creates a rotation object for component transition.
6642
6643**Since**: 12
6644
6645**Parameters**
6646
6647| Name| Description|
6648| -------- | -------- |
6649| rotate | Rotation parameter object during component transition. |
6650
6651**Returns**
6652
6653Returns the rotation object created for component transition; returns **NULL** if a parameter error occurs.
6654
6655
6656### OH_ArkUI_CreateScaleTransitionEffect()
6657
6658```
6659ArkUI_TransitionEffect* OH_ArkUI_CreateScaleTransitionEffect (ArkUI_ScaleOptions * scale)
6660```
6661**Description**
6662
6663Creates a scaling transition effect object.
6664
6665**Since**: 12
6666
6667**Parameters**
6668
6669| Name| Description|
6670| -------- | -------- |
6671| scale | Scaling settings for component transition. |
6672
6673**Returns**
6674
6675Returns the created scaling transition effect object; returns **NULL** if a parameter error occurs.
6676
6677
6678### OH_ArkUI_CreateTranslationTransitionEffect()
6679
6680```
6681ArkUI_TransitionEffect* OH_ArkUI_CreateTranslationTransitionEffect (ArkUI_TranslationOptions * translate)
6682```
6683**Description**
6684
6685Creates a translation transition effect object.
6686
6687**Since**: 12
6688
6689**Parameters**
6690
6691| Name| Description|
6692| -------- | -------- |
6693| translate | Translation settings for component transition. |
6694
6695**Returns**
6696
6697Returns the created translation transition effect object; returns **NULL** if a parameter error occurs.
6698
6699
6700### OH_ArkUI_Curve_CreateCubicBezierCurve()
6701
6702```
6703ArkUI_CurveHandle OH_ArkUI_Curve_CreateCubicBezierCurve (float x1, float y1, float x2, float y2 )
6704```
6705**Description**
6706
6707Creates a cubic Bezier curve.
6708
6709**Parameters**
6710
6711| Name| Description|
6712| -------- | -------- |
6713| x1 | X coordinate of the first point on the Bezier curve. Value range: [0, 1]. A value less than 0 evaluates to the value **0**. A value greater than 1 evaluates to the value **1**. |
6714| y1 | Y coordinate of the first point on the Bezier curve. |
6715| x2 | X coordinate of the second point on the Bezier curve. Value range: [0, 1]. A value less than 0 evaluates to the value **0**. A value greater than 1 evaluates to the value **1**. |
6716| y2 | Y coordinate of the second point on the Bezier curve. |
6717
6718**Returns**
6719
6720Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
6721
6722
6723### OH_ArkUI_Curve_CreateCurveByType()
6724
6725```
6726ArkUI_CurveHandle OH_ArkUI_Curve_CreateCurveByType (ArkUI_AnimationCurve curve)
6727```
6728**Description**
6729
6730Implements initialization for the interpolation curve, which is used to create an interpolation curve based on the input parameter.
6731
6732**Parameters**
6733
6734| Name| Description|
6735| -------- | -------- |
6736| curve | Curve type. |
6737
6738**Returns**
6739
6740Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
6741
6742
6743### OH_ArkUI_Curve_CreateCustomCurve()
6744
6745```
6746ArkUI_CurveHandle OH_ArkUI_Curve_CreateCustomCurve (void * userData, float(*)(float fraction, void *userdata) interpolate )
6747```
6748**Description**
6749
6750Creates a custom curve.
6751
6752**Parameters**
6753
6754| Name| Description|
6755| -------- | -------- |
6756| userData | Custom data. |
6757| interpolate | Custom interpolation callback. **fraction** indicates the input x value for interpolation when the animation starts; value range: [0,1]. The return value is the **y** value of the curve; value range: [0,1]. If **fraction** is **0**, the return value **0** corresponds to the animation start point; any other return value means that the animation jumps at the start point. If **fraction** is **1**, the return value **1** corresponds to the animation end point; any other return value means that the end value of the animation is not the value of the state variable, which will result in an effect of transition from that end value to the value of the state variable. |
6758
6759**Returns**
6760
6761Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
6762
6763
6764### OH_ArkUI_Curve_CreateInterpolatingSpring()
6765
6766```
6767ArkUI_CurveHandle OH_ArkUI_Curve_CreateInterpolatingSpring (float velocity, float mass, float stiffness, float damping )
6768```
6769**Description**
6770
6771Creates an interpolating spring curve animated from 0 to 1. The actual animation value is calculated based on the curve.
6772
6773**Parameters**
6774
6775| Name| Description|
6776| -------- | -------- |
6777| velocity | Initial velocity. It is applied by external factors to the spring animation, designed to help ensure the smooth transition from the previous motion state. The velocity is the normalized velocity, and its value is equal to the actual velocity at the beginning of the animation divided by the animation attribute change value. |
6778| mass | Mass, which influences the inertia in the spring system. The greater the mass, the greater the amplitude of the oscillation, and the slower the speed of restoring to the equilibrium position. |
6779| stiffness | Stiffness. It is the degree to which an object deforms by resisting the force applied. In an elastic system, the greater the stiffness, the stronger the ability to resist deformation, and the faster the speed of restoring to the equilibrium position. |
6780| damping | Damping. It is used to describe the oscillation and attenuation of the system after being disturbed. The larger the damping, the smaller the number of oscillations of elastic motion, and the smaller the oscillation amplitude. |
6781
6782**NOTE**
6783
6784The animation duration is subject to the curve parameters, rather than the **duration** parameter in **animation** or **animateTo**.
6785
6786**Returns**
6787
6788Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
6789
6790
6791### OH_ArkUI_Curve_CreateResponsiveSpringMotion()
6792
6793```
6794ArkUI_CurveHandle OH_ArkUI_Curve_CreateResponsiveSpringMotion (float response, float dampingFraction, float overlapDuration )
6795```
6796**Description**
6797
6798Creates a responsive spring animation curve. It is a special case of **springMotion**, with the only difference in the default values. It can be used together with **springMotion**.
6799
6800**Parameters**
6801
6802| Name| Description|
6803| -------- | -------- |
6804| response | Duration of one complete oscillation. |
6805| dampingFraction | Damping coefficient. If the value is greater than 0 and less than 1, the value is underdamped and exceeds the target value during motion. If the value is equal to 1, the value is critical damping. If the value is greater than 1, the value is overdamped and gradually approaches the target value during motion. |
6806| overlapDuration | Duration for animations to overlap, in seconds. When animations overlap, the **response** values of these animations will transit smoothly over this duration if they are different. |
6807
6808**NOTE**
6809
6810The animation duration is subject to the curve parameters, rather than the **duration** parameter in **animation** or **animateTo**.
6811
6812**Returns**
6813
6814Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
6815
6816
6817### OH_ArkUI_Curve_CreateSpringCurve()
6818
6819```
6820ArkUI_CurveHandle OH_ArkUI_Curve_CreateSpringCurve (float velocity, float mass, float stiffness, float damping )
6821```
6822**Description**
6823
6824Creates a spring curve. The curve shape is subject to the spring parameters, and the animation duration is subject to the **duration** parameter in **animation** and **animateTo**.
6825
6826**Parameters**
6827
6828| Name| Description|
6829| -------- | -------- |
6830| velocity | Initial velocity. It is applied by external factors to the spring animation, designed to help ensure the smooth transition from the previous motion state. The velocity is the normalized velocity, and its value is equal to the actual velocity at the beginning of the animation divided by the animation attribute change value. |
6831| mass | Mass, which influences the inertia in the spring system. The greater the mass, the greater the amplitude of the oscillation, and the slower the speed of restoring to the equilibrium position. |
6832| stiffness | Stiffness. It is the degree to which an object deforms by resisting the force applied. In an elastic system, the greater the stiffness, the stronger the ability to resist deformation, and the faster the speed of restoring to the equilibrium position. |
6833| damping | Damping. It is used to describe the oscillation and attenuation of the system after being disturbed. The larger the damping, the smaller the number of oscillations of elastic motion, and the smaller the oscillation amplitude. |
6834
6835**Returns**
6836
6837Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
6838
6839
6840### OH_ArkUI_Curve_CreateSpringMotion()
6841
6842```
6843ArkUI_CurveHandle OH_ArkUI_Curve_CreateSpringMotion (float response, float dampingFraction, float overlapDuration )
6844```
6845**Description**
6846
6847Creates a spring animation curve. If multiple spring animations are applied to the same attribute of an object, each animation replaces their predecessor and inherits the velocity.
6848
6849**Parameters**
6850
6851| Name| Description|
6852| -------- | -------- |
6853| response | Duration of one complete oscillation. |
6854| dampingFraction | Damping coefficient. If the value is greater than 0 and less than 1, the value is underdamped and exceeds the target value during motion. If the value is equal to 1, the value is critical damping. If the value is greater than 1, the value is overdamped and gradually approaches the target value during motion. |
6855| overlapDuration | Duration for animations to overlap, in seconds. When animations overlap, the **response** values of these animations will transit smoothly over this duration if they are different. |
6856
6857**NOTE**
6858
6859The animation duration is subject to the curve parameters, rather than the **duration** parameter in **animation** or **animateTo**.
6860
6861**Returns**
6862
6863Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
6864
6865
6866### OH_ArkUI_Curve_CreateStepsCurve()
6867
6868```
6869ArkUI_CurveHandle OH_ArkUI_Curve_CreateStepsCurve (int32_t count, bool end )
6870```
6871**Description**
6872
6873Creates a step curve.
6874
6875**Parameters**
6876
6877| Name| Description|
6878| -------- | -------- |
6879| count | Number of tiers. The value must be a positive integer. Value range: [1, +∞). |
6880| end | Step change occurs at the start point or end point of each interval. true: Step change occurs at the end point. false: Step change occurs at the start point. |
6881
6882**Returns**
6883
6884Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
6885
6886
6887### OH_ArkUI_Curve_DisposeCurve()
6888
6889```
6890void OH_ArkUI_Curve_DisposeCurve (ArkUI_CurveHandle curveHandle)
6891```
6892**Description**
6893
6894Disposes of a custom curve.
6895
6896**Parameters**
6897
6898| Name| Description|
6899| -------- | -------- |
6900| curve | Returns the pointer to the interpolation object of the curve; |
6901
6902
6903### OH_ArkUI_CustomSpanDrawInfo_Create()
6904
6905```
6906ArkUI_CustomSpanDrawInfo* OH_ArkUI_CustomSpanDrawInfo_Create (void )
6907```
6908**Description**
6909
6910Creates drawing information for this custom span.
6911
6912**Since**: 12
6913
6914**Returns**
6915
6916Returns a **CustomSpanDrawInfo** instance. If a null pointer is returned, the memory may be insufficient.
6917
6918
6919### OH_ArkUI_CustomSpanDrawInfo_Dispose()
6920
6921```
6922void OH_ArkUI_CustomSpanDrawInfo_Dispose (ArkUI_CustomSpanDrawInfo * info)
6923```
6924**Description**
6925
6926Disposes of drawing information for this custom span.
6927
6928**Since**: 12
6929
6930**Parameters**
6931
6932| Name| Description|
6933| -------- | -------- |
6934| info | Pointer to the drawing information of a custom span. |
6935
6936
6937### OH_ArkUI_CustomSpanDrawInfo_GetBaseline()
6938
6939```
6940float OH_ArkUI_CustomSpanDrawInfo_GetBaseline (ArkUI_CustomSpanDrawInfo * info)
6941```
6942**Description**
6943
6944Obtains the baseline offset of the custom span relative to the mounted component.
6945
6946**Since**: 12
6947
6948**Parameters**
6949
6950| Name| Description|
6951| -------- | -------- |
6952| info | Pointer to the drawing information of a custom span. |
6953
6954**Returns**
6955
6956Returns the baseline offset. If a parameter error occurs, **0.0f** is returned. A possible cause is that mandatory parameters are left unspecified.
6957
6958
6959### OH_ArkUI_CustomSpanDrawInfo_GetLineBottom()
6960
6961```
6962float OH_ArkUI_CustomSpanDrawInfo_GetLineBottom (ArkUI_CustomSpanDrawInfo * info)
6963```
6964**Description**
6965
6966Obtains the bottom margin of the custom span relative to the mounted component.
6967
6968**Since**: 12
6969
6970**Parameters**
6971
6972| Name| Description|
6973| -------- | -------- |
6974| info | Pointer to the drawing information of a custom span. |
6975
6976**Returns**
6977
6978Returns the bottom margin. If a parameter error occurs, **0.0f** is returned. A possible cause is that mandatory parameters are left unspecified.
6979
6980
6981### OH_ArkUI_CustomSpanDrawInfo_GetLineTop()
6982
6983```
6984float OH_ArkUI_CustomSpanDrawInfo_GetLineTop (ArkUI_CustomSpanDrawInfo * info)
6985```
6986**Description**
6987
6988Obtains the top margin of the custom span relative to the mounted component.
6989
6990**Since**: 12
6991
6992**Parameters**
6993
6994| Name| Description|
6995| -------- | -------- |
6996| info | Pointer to the drawing information of a custom span. |
6997
6998**Returns**
6999
7000Returns the top margin. If a parameter error occurs, **0.0f** is returned. A possible cause is that mandatory parameters are left unspecified.
7001
7002
7003### OH_ArkUI_CustomSpanDrawInfo_GetXOffset()
7004
7005```
7006float OH_ArkUI_CustomSpanDrawInfo_GetXOffset (ArkUI_CustomSpanDrawInfo * info)
7007```
7008**Description**
7009
7010Obtains the x-axis offset of the custom span relative to the mounted component.
7011
7012**Since**: 12
7013
7014**Parameters**
7015
7016| Name| Description|
7017| -------- | -------- |
7018| info | Pointer to the drawing information of a custom span. |
7019
7020**Returns**
7021
7022Returns the x-axis offset. If a parameter error occurs, **0.0f** is returned. A possible cause is that mandatory parameters are left unspecified.
7023
7024
7025### OH_ArkUI_CustomSpanMeasureInfo_Create()
7026
7027```
7028ArkUI_CustomSpanMeasureInfo* OH_ArkUI_CustomSpanMeasureInfo_Create (void )
7029```
7030**Description**
7031
7032Creates measurement information for this custom span.
7033
7034**Since**: 12
7035
7036**Returns**
7037
7038Returns a **CustomSpanMeasureInfo** instance. If a null pointer is returned, the memory may be insufficient.
7039
7040
7041### OH_ArkUI_CustomSpanMeasureInfo_Dispose()
7042
7043```
7044void OH_ArkUI_CustomSpanMeasureInfo_Dispose (ArkUI_CustomSpanMeasureInfo * info)
7045```
7046**Description**
7047
7048Disposes of measurement information of a custom span.
7049
7050**Since**: 12
7051
7052**Parameters**
7053
7054| Name| Description|
7055| -------- | -------- |
7056| info | Pointer to the measurement information of a custom span. |
7057
7058
7059### OH_ArkUI_CustomSpanMeasureInfo_GetFontSize()
7060
7061```
7062float OH_ArkUI_CustomSpanMeasureInfo_GetFontSize (ArkUI_CustomSpanMeasureInfo * info)
7063```
7064**Description**
7065
7066Obtains the font size of the parent text node of a custom span.
7067
7068**Since**: 12
7069
7070**Parameters**
7071
7072| Name| Description|
7073| -------- | -------- |
7074| info | Pointer to the measurement information of a custom span. |
7075
7076**Returns**
7077
7078Returns the font size of the parent text node. If a parameter error occurs, **0.0f** is returned. A possible cause is that mandatory parameters are left unspecified.
7079
7080
7081### OH_ArkUI_CustomSpanMetrics_Create()
7082
7083```
7084ArkUI_CustomSpanMetrics* OH_ArkUI_CustomSpanMetrics_Create (void )
7085```
7086**Description**
7087
7088Creates measurement metrics for this custom span.
7089
7090**Since**: 12
7091
7092**Returns**
7093
7094Returns a **CustomSpanMetrics** instance. If a null pointer is returned, the memory may be insufficient.
7095
7096
7097### OH_ArkUI_CustomSpanMetrics_Dispose()
7098
7099```
7100void OH_ArkUI_CustomSpanMetrics_Dispose (ArkUI_CustomSpanMetrics * metrics)
7101```
7102**Description**
7103
7104Disposes of measurement metrics of this custom span.
7105
7106**Since**: 12
7107
7108**Parameters**
7109
7110| Name| Description|
7111| -------- | -------- |
7112| metrics | Returns a **CustomSpanMetrics** instance. |
7113
7114
7115### OH_ArkUI_CustomSpanMetrics_SetHeight()
7116
7117```
7118int32_t OH_ArkUI_CustomSpanMetrics_SetHeight (ArkUI_CustomSpanMetrics * metrics, float height )
7119```
7120**Description**
7121
7122Sets the height for a custom span.
7123
7124**Since**: 12
7125
7126**Parameters**
7127
7128| Name| Description|
7129| -------- | -------- |
7130| metrics | Returns a **CustomSpanMetrics** instance. |
7131| height | Height, in vp. |
7132
7133**Returns**
7134
7135Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs. A possible cause is that mandatory parameters are left unspecified.
7136
7137
7138### OH_ArkUI_CustomSpanMetrics_SetWidth()
7139
7140```
7141int32_t OH_ArkUI_CustomSpanMetrics_SetWidth (ArkUI_CustomSpanMetrics * metrics, float width )
7142```
7143**Description**
7144
7145Sets the width for a custom span.
7146
7147**Since**: 12
7148
7149**Parameters**
7150
7151| Name| Description|
7152| -------- | -------- |
7153| metrics | Returns a **CustomSpanMetrics** instance. |
7154| width | Width, in vp. |
7155
7156**Returns**
7157
7158Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs. A possible cause is that mandatory parameters are left unspecified.
7159
7160
7161### OH_ArkUI_DialogDismissEvent_GetDismissReason()
7162
7163```
7164int32_t OH_ArkUI_DialogDismissEvent_GetDismissReason (ArkUI_DialogDismissEvent * event)
7165```
7166**Description**
7167
7168Obtains the dismissal reason from a dialog box dismiss event object.
7169
7170**Since**: 12
7171
7172**Parameters**
7173
7174| Name| Description|
7175| -------- | -------- |
7176| event | Pointer to a dialog box dismiss event object.|
7177
7178**Returns**
7179
7180Returns the dismissal reason. Returns **-1** if an exception occurs.<br> **DIALOG_DISMISS_BACK_PRESS**: touching the Back button, swiping left or right on the screen, or pressing the Esc key.<br> **DIALOG_DISMISS_TOUCH_OUTSIDE**: touching the mask.<br> **DIALOG_DISMISS_CLOSE_BUTTON**: touching the Close button.<br> **DIALOG_DISMISS_SLIDE_DOWN**: sliding down.
7181
7182### OH_ArkUI_DialogDismissEvent_GetUserData()
7183
7184```
7185void* OH_ArkUI_DialogDismissEvent_GetUserData (ArkUI_DialogDismissEvent * event)
7186```
7187**Description**
7188
7189Obtains the pointer to user data in a dialog box dismiss event object.
7190
7191**Since**: 12
7192
7193**Parameters**
7194
7195| Name| Description|
7196| -------- | -------- |
7197| event | Pointer to a dialog box dismiss event object.|
7198
7199**Returns**
7200
7201Returns the pointer to user data.
7202
7203
7204### OH_ArkUI_DialogDismissEvent_SetShouldBlockDismiss()
7205
7206```
7207void OH_ArkUI_DialogDismissEvent_SetShouldBlockDismiss (ArkUI_DialogDismissEvent * event, bool shouldBlockDismiss )
7208```
7209**Description**
7210
7211Sets whether to block the system behavior of dismissing a dialog box.
7212
7213**Since**: 12
7214
7215**Parameters**
7216
7217| Name| Description|
7218| -------- | -------- |
7219| event | Pointer to a dialog box dismiss event object. |
7220| shouldBlockDismiss | Whether to block the system behavior of dismissing the dialog box. The value **true** means to block the system behavior, and **false** means the opposite. |
7221
7222
7223### OH_ArkUI_DisallowNodeAnyDropDataTypes()
7224
7225```
7226int32_t OH_ArkUI_DisallowNodeAnyDropDataTypes (ArkUI_NodeHandle node)
7227```
7228**Description**
7229
7230The configuration component is not allowed to accept any data type. This interface resets the data type configured through [OH_ArkUI_SetNodeAllowedDropDataTypes](#oh_arkui_setnodealloweddropdatatypes).
7231
7232**Since**: 12
7233
7234**Parameters**
7235
7236| Name| Description|
7237| -------- | -------- |
7238| node | Pointer to a component node. |
7239
7240**Returns**
7241
7242Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7243
7244
7245### OH_ArkUI_DragAction_Dispose()
7246
7247```
7248void OH_ArkUI_DragAction_Dispose (ArkUI_DragAction * dragAction)
7249```
7250**Description**
7251
7252Disposes of an **ArkUI_DragAction** object.
7253
7254**Since**: 12
7255
7256**Parameters**
7257
7258| Name| Description|
7259| -------- | -------- |
7260| dragAction | Pointer to the target drag action object. |
7261
7262
7263### OH_ArkUI_DragAction_RegisterStatusListener()
7264
7265```
7266int32_t OH_ArkUI_DragAction_RegisterStatusListener (ArkUI_DragAction * dragAction, void * userData, void(*)(ArkUI_DragAndDropInfo *dragAndDropInfo, void *userData) listener )
7267```
7268**Description**
7269
7270Registers a drag status listener. This listener can be used to check whether the data is successfully received and processed.
7271
7272**Since**: 12
7273
7274**Parameters**
7275
7276| Name| Description|
7277| -------- | -------- |
7278| dragAction | Pointer to the target drag action object. |
7279| userData | Custom user data. |
7280| listener | Listener to register. When the callback is invoked, the system returns a pointer to the drag status object. The pointer is destroyed after the callback is complete and the application should not hold it anymore. |
7281
7282**Returns**
7283
7284Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7285
7286
7287### OH_ArkUI_DragAction_SetData()
7288
7289```
7290int32_t OH_ArkUI_DragAction_SetData (ArkUI_DragAction * dragAction, OH_UdmfData * data )
7291```
7292**Description**
7293
7294Sets the drag data.
7295
7296**Since**: 12
7297
7298**Parameters**
7299
7300| Name| Description|
7301| -------- | -------- |
7302| dragAction | Pointer to the target drag action object. |
7303| data | Drag data. |
7304
7305**Returns**
7306
7307Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7308
7309
7310### OH_ArkUI_DragAction_SetDragPreviewOption()
7311
7312```
7313int32_t OH_ArkUI_DragAction_SetDragPreviewOption (ArkUI_DragAction * dragAction, ArkUI_DragPreviewOption * option )
7314```
7315**Description**
7316
7317Sets an **ArkUI_DragPreviewOption** object for the specified drag action object.
7318
7319**Since**: 12
7320
7321**Parameters**
7322
7323| Name| Description|
7324| -------- | -------- |
7325| dragAction | Pointer to the target drag action object. |
7326| option | Custom parameters. |
7327
7328**Returns**
7329
7330Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7331
7332
7333### OH_ArkUI_DragAction_SetPixelMaps()
7334
7335```
7336int32_t OH_ArkUI_DragAction_SetPixelMaps (ArkUI_DragAction * dragAction, OH_PixelmapNative * pixelmapArray[], int32_t size )
7337```
7338**Description**
7339
7340Sets the drag previews for a drag action.
7341
7342**Since**: 12
7343
7344**Parameters**
7345
7346| Name| Description|
7347| -------- | -------- |
7348| dragAction | Pointer to the target drag action object. |
7349| pixelmapArray | Drag the bitmap array of the follower map. |
7350| size | Number of drag-and-drop images. |
7351
7352**Returns**
7353
7354Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7355
7356
7357### OH_ArkUI_DragAction_SetPointerId()
7358
7359```
7360int32_t OH_ArkUI_DragAction_SetPointerId (ArkUI_DragAction * dragAction, int32_t pointer )
7361```
7362**Description**
7363
7364Sets the pointer ID. If only one finger is operating on the screen, the pointer ID is 0. In general cases, you can set the pointer ID to 0.
7365
7366**Since**: 12
7367
7368**Parameters**
7369
7370| Name| Description|
7371| -------- | -------- |
7372| dragAction | Pointer to the target drag action object. |
7373| pointer | Pointer ID. The value ranges from 0 to 9. |
7374
7375**Returns**
7376
7377Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7378
7379
7380### OH_ArkUI_DragAction_SetTouchPointX()
7381
7382```
7383int32_t OH_ArkUI_DragAction_SetTouchPointX (ArkUI_DragAction * dragAction, float x )
7384```
7385**Description**
7386
7387Sets the touch point relative to the upper left corner of the first drag preview (pixel map).
7388
7389**Since**: 12
7390
7391**Parameters**
7392
7393| Name| Description|
7394| -------- | -------- |
7395| dragAction | Pointer to the target drag action object. |
7396| x | X value of the hand point coordinate. |
7397
7398**Returns**
7399
7400Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7401
7402
7403### OH_ArkUI_DragAction_SetTouchPointY()
7404
7405```
7406int32_t OH_ArkUI_DragAction_SetTouchPointY (ArkUI_DragAction * dragAction, float y )
7407```
7408**Description**
7409
7410Sets the touch point relative to the upper left corner of the first drag preview (pixel map).
7411
7412**Since**: 12
7413
7414**Parameters**
7415
7416| Name| Description|
7417| -------- | -------- |
7418| dragAction | Pointer to the target drag action object. |
7419| y | Y value of the hand point coordinate. |
7420
7421**Returns**
7422
7423Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7424
7425
7426### OH_ArkUI_DragAction_UnregisterStatusListener()
7427
7428```
7429void OH_ArkUI_DragAction_UnregisterStatusListener (ArkUI_DragAction * dragAction)
7430```
7431**Description**
7432
7433Unregisters a drag status listener.
7434
7435**Since**: 12
7436
7437**Parameters**
7438
7439| Name| Description|
7440| -------- | -------- |
7441| dragAction | Pointer to the target drag action object. |
7442
7443
7444### OH_ArkUI_DragAndDropInfo_GetDragEvent()
7445
7446```
7447ArkUI_DragEvent* OH_ArkUI_DragAndDropInfo_GetDragEvent (ArkUI_DragAndDropInfo * dragAndDropInfo)
7448```
7449**Description**
7450
7451Obtains a drag event based on the specified drag and drop information. The drag event can then be used to obtain the drag result.
7452
7453**Since**: 12
7454
7455**Parameters**
7456
7457| Name| Description|
7458| -------- | -------- |
7459| dragAndDropInfo | Drag-related information returned by the drag status listener. |
7460
7461**Returns**
7462
7463Returns an **ArkUI_DragEvent** object; returns null if an error occurs.
7464
7465
7466### OH_ArkUI_DragAndDropInfo_GetDragStatus()
7467
7468```
7469ArkUI_DragStatus OH_ArkUI_DragAndDropInfo_GetDragStatus (ArkUI_DragAndDropInfo * dragAndDropInfo)
7470```
7471**Description**
7472
7473Obtains the drag status of a drag action.
7474
7475**Since**: 12
7476
7477**Parameters**
7478
7479| Name| Description|
7480| -------- | -------- |
7481| dragAndDropInfo | Drag-related information returned by the drag status listener. |
7482
7483**Returns**
7484
7485Returns an **ArkUI_DragStatus** object; returns **ArkUI_DRAG_STATUS_UNKNOWN** if an error occurs.
7486
7487
7488### OH_ArkUI_DragEvent_DisableDefaultDropAnimation()
7489
7490```
7491int32_t OH_ArkUI_DragEvent_DisableDefaultDropAnimation (ArkUI_DragEvent * event, bool disable )
7492```
7493**Description**
7494
7495Sets whether to disable the default drop animation, which is enabled by default. Use this API to apply a custom drop animation.
7496
7497**Since**: 12
7498
7499**Parameters**
7500
7501| Name| Description|
7502| -------- | -------- |
7503| event | Pointer to an **ArkUI_DragEvent** object. |
7504| disable | Whether to disable the default drop animation. The value **true** means to disable the default drop animation, and **false** means the opposite. |
7505
7506**Returns**
7507
7508Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7509
7510
7511### OH_ArkUI_DragEvent_GetDataTypes()
7512
7513```
7514int32_t OH_ArkUI_DragEvent_GetDataTypes (ArkUI_DragEvent * event, char ** result[], int32_t length )
7515```
7516**Description**
7517
7518Obtains the type list of drag data types from a drag event.
7519
7520**Since**: 12
7521
7522**Parameters**
7523
7524| Name| Description|
7525| -------- | -------- |
7526| event | Pointer to an **ArkUI_DragEvent** object. |
7527| char | \*\*result[] Returns the type list of the dragged data. You need to create a string array first. |
7528| length | The total length of the array must be greater than or equal to the number obtained by using [OH_ArkUI_DragEvent_GetDataTypesCount](#oh_arkui_dragevent_getdatatypescount). |
7529
7530**Returns**
7531
7532Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7533
7534
7535### OH_ArkUI_DragEvent_GetDataTypesCount()
7536
7537```
7538int32_t OH_ArkUI_DragEvent_GetDataTypesCount (ArkUI_DragEvent * event, int32_t * count )
7539```
7540**Description**
7541
7542Obtains the number of drag data types from a drag event.
7543
7544**Since**: 12
7545
7546**Parameters**
7547
7548| Name| Description|
7549| -------- | -------- |
7550| event | Pointer to an **ArkUI_DragEvent** object. |
7551| count | Output parameter, which returns the number of types of dragged data. |
7552
7553**Returns**
7554
7555Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7556
7557
7558### OH_ArkUI_DragEvent_GetDragResult()
7559
7560```
7561int32_t OH_ArkUI_DragEvent_GetDragResult (ArkUI_DragEvent * event, ArkUI_DragResult * result )
7562```
7563**Description**
7564
7565Obtains the drag and drop result from the drag event.
7566
7567**Since**: 12
7568
7569**Parameters**
7570
7571| Name| Description|
7572| -------- | -------- |
7573| event | Pointer to an **ArkUI_DragEvent** object. |
7574| result | Output parameter, which returns the drag result corresponding to the drag event. |
7575
7576**Returns**
7577
7578Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7579
7580
7581### OH_ArkUI_DragEvent_GetModifierKeyStates()
7582
7583```
7584int32_t OH_ArkUI_DragEvent_GetModifierKeyStates (ArkUI_DragEvent * event, int64_t * keys )
7585```
7586**Description**
7587
7588Obtains the pressed status of modifier keys from a drag event.
7589
7590**Since**: 12
7591
7592**Parameters**
7593
7594| Name| Description|
7595| -------- | -------- |
7596| event | Pointer to an **ArkUI_DragEvent** object. |
7597| keys | Returns the modifier key combination that is currently pressed. The application can determine the modifier key combination through bitwise operations. |
7598
7599**Returns**
7600
7601Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7602
7603
7604### OH_ArkUI_DragEvent_GetPreviewRectHeight()
7605
7606```
7607float OH_ArkUI_DragEvent_GetPreviewRectHeight (ArkUI_DragEvent * event)
7608```
7609**Description**
7610
7611Obtains the height of a drag preview from a drag event.
7612
7613**Since**: 12
7614
7615**Parameters**
7616
7617| Name| Description|
7618| -------- | -------- |
7619| event | Pointer to an **ArkUI_DragEvent** object. |
7620
7621**Returns**
7622
7623Returns the height of the drag preview, in px; returns the default value **0** if the input parameter is invalid.
7624
7625
7626### OH_ArkUI_DragEvent_GetPreviewRectWidth()
7627
7628```
7629float OH_ArkUI_DragEvent_GetPreviewRectWidth (ArkUI_DragEvent * event)
7630```
7631**Description**
7632
7633Obtains the width of a drag preview from a drag event.
7634
7635**Since**: 12
7636
7637**Parameters**
7638
7639| Name| Description|
7640| -------- | -------- |
7641| event | Pointer to an **ArkUI_DragEvent** object. |
7642
7643**Returns**
7644
7645Returns the width of the drag preview, in px; returns the default value **0** if the input parameter is invalid.
7646
7647
7648### OH_ArkUI_DragEvent_GetPreviewTouchPointX()
7649
7650```
7651float OH_ArkUI_DragEvent_GetPreviewTouchPointX (ArkUI_DragEvent * event)
7652```
7653**Description**
7654
7655Obtains the X coordinate of the touch point for a drag preview from a drag event.
7656
7657**Since**: 12
7658
7659**Parameters**
7660
7661| Name| Description|
7662| -------- | -------- |
7663| event | Pointer to an **ArkUI_DragEvent** object. |
7664
7665**Returns**
7666
7667Returns the X coordinate of the touch point, in px; returns the default value **0** if the input parameter is invalid.
7668
7669
7670### OH_ArkUI_DragEvent_GetPreviewTouchPointY()
7671
7672```
7673float OH_ArkUI_DragEvent_GetPreviewTouchPointY (ArkUI_DragEvent * event)
7674```
7675**Description**
7676
7677Obtains the Y coordinate of the touch point for a drag preview from a drag event.
7678
7679**Since**: 12
7680
7681**Parameters**
7682
7683| Name| Description|
7684| -------- | -------- |
7685| event | ArkUI_DragEvent event pointer. The unit is PX. If the input parameter is invalid, the default value 0 is returned. |
7686
7687**Returns**
7688
7689float returns the y-axis coordinate of the drag and hand point.
7690
7691
7692### OH_ArkUI_DragEvent_GetTouchPointXToDisplay()
7693
7694```
7695float OH_ArkUI_DragEvent_GetTouchPointXToDisplay (ArkUI_DragEvent * event)
7696```
7697**Description**
7698
7699Obtains the X coordinate of the touch point relative to the display from a drag event.
7700
7701**Since**: 12
7702
7703**Parameters**
7704
7705| Name| Description|
7706| -------- | -------- |
7707| event | Pointer to an **ArkUI_DragEvent** object. |
7708
7709**Returns**
7710
7711Returns the X coordinate of the touch point relative to the display, in px; returns the default value **0** if the input parameter is invalid.
7712
7713
7714### OH_ArkUI_DragEvent_GetTouchPointXToWindow()
7715
7716```
7717float OH_ArkUI_DragEvent_GetTouchPointXToWindow (ArkUI_DragEvent * event)
7718```
7719**Description**
7720
7721Obtains the X coordinate of the touch point relative to the window from a drag event.
7722
7723**Since**: 12
7724
7725**Parameters**
7726
7727| Name| Description|
7728| -------- | -------- |
7729| event | Pointer to an **ArkUI_DragEvent** object. |
7730
7731**Returns**
7732
7733Returns the X coordinate of the touch point relative to the window, in px; returns the default value **0** if the input parameter is invalid.
7734
7735
7736### OH_ArkUI_DragEvent_GetTouchPointYToDisplay()
7737
7738```
7739float OH_ArkUI_DragEvent_GetTouchPointYToDisplay (ArkUI_DragEvent * event)
7740```
7741**Description**
7742
7743Obtains the Y coordinate of the touch point relative to the display from a drag event.
7744
7745**Since**: 12
7746
7747**Parameters**
7748
7749| Name| Description|
7750| -------- | -------- |
7751| event | Pointer to an **ArkUI_DragEvent** object. |
7752
7753**Returns**
7754
7755Returns the Y coordinate of the touch point relative to the display, in px; returns the default value **0** if the input parameter is invalid.
7756
7757
7758### OH_ArkUI_DragEvent_GetTouchPointYToWindow()
7759
7760```
7761float OH_ArkUI_DragEvent_GetTouchPointYToWindow (ArkUI_DragEvent * event)
7762```
7763**Description**
7764
7765Obtains the Y coordinate of the touch point relative to the window from a drag event.
7766
7767**Since**: 12
7768
7769**Parameters**
7770
7771| Name| Description|
7772| -------- | -------- |
7773| event | Pointer to an **ArkUI_DragEvent** object. |
7774
7775**Returns**
7776
7777Returns the Y coordinate of the touch point relative to the window, in px; returns the default value **0** if the input parameter is invalid.
7778
7779
7780### OH_ArkUI_DragEvent_GetUdmfData()
7781
7782```
7783int32_t OH_ArkUI_DragEvent_GetUdmfData (ArkUI_DragEvent * event, OH_UdmfData * data )
7784```
7785**Description**
7786
7787Obtain the default drag-and-drop data from ArkUI_DragEvent.
7788
7789**Since**: 12
7790
7791**Parameters**
7792
7793| Name| Description|
7794| -------- | -------- |
7795| event | Pointer to an **ArkUI_DragEvent** object. |
7796| data | Pointer to the dragged data of OH_UdmfData. When receiving data, the application needs to create a pointer for receiving data by using the OH_UdmfData_Create method. |
7797
7798**Returns**
7799
7800Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7801
7802
7803### OH_ArkUI_DragEvent_GetVelocity()
7804
7805```
7806float OH_ArkUI_DragEvent_GetVelocity (ArkUI_DragEvent * event)
7807```
7808**Description**
7809
7810Obtains the dragging velocity along the main axis.
7811
7812**Since**: 12
7813
7814**Parameters**
7815
7816| Name| Description|
7817| -------- | -------- |
7818| event | Pointer to an **ArkUI_DragEvent** object. |
7819
7820**Returns**
7821
7822Returns the dragging velocity along the main axis, in px; returns the default value **0** if the input parameter is invalid.
7823
7824
7825### OH_ArkUI_DragEvent_GetVelocityX()
7826
7827```
7828float OH_ArkUI_DragEvent_GetVelocityX (ArkUI_DragEvent * event)
7829```
7830**Description**
7831
7832Obtains the dragging velocity along the x-axis.
7833
7834**Since**: 12
7835
7836**Parameters**
7837
7838| Name| Description|
7839| -------- | -------- |
7840| event | Pointer to an **ArkUI_DragEvent** object. |
7841
7842**Returns**
7843
7844Returns the dragging velocity along the x-axis, in px; returns the default value **0** if the input parameter is invalid.
7845
7846
7847### OH_ArkUI_DragEvent_GetVelocityY()
7848
7849```
7850float OH_ArkUI_DragEvent_GetVelocityY (ArkUI_DragEvent * event)
7851```
7852**Description**
7853
7854Obtains the dragging velocity along the y-axis.
7855
7856**Since**: 12
7857
7858**Parameters**
7859
7860| Name| Description|
7861| -------- | -------- |
7862| event | Pointer to an **ArkUI_DragEvent** object. |
7863
7864**Returns**
7865
7866Returns the dragging velocity along the y-axis, in px; returns the default value **0** if the input parameter is invalid.
7867
7868
7869### OH_ArkUI_DragEvent_SetData()
7870
7871```
7872int32_t OH_ArkUI_DragEvent_SetData (ArkUI_DragEvent * event, OH_UdmfData * data )
7873```
7874**Description**
7875
7876Sets drag data for a drag event.
7877
7878**Since**: 12
7879
7880**Parameters**
7881
7882| Name| Description|
7883| -------- | -------- |
7884| event | Pointer to an **ArkUI_DragEvent** object. |
7885| data | Drag data. |
7886
7887**Returns**
7888
7889Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7890
7891
7892### OH_ArkUI_DragEvent_SetDragResult()
7893
7894```
7895int32_t OH_ArkUI_DragEvent_SetDragResult (ArkUI_DragEvent * event, ArkUI_DragResult result )
7896```
7897**Description**
7898
7899Sets the result for a drag event.
7900
7901**Since**: 12
7902
7903**Parameters**
7904
7905| Name| Description|
7906| -------- | -------- |
7907| event | Pointer to an **ArkUI_DragEvent** object. |
7908| result | Drag the data processing result. |
7909
7910**Returns**
7911
7912Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7913
7914
7915### OH_ArkUI_DragEvent_SetSuggestedDropOperation()
7916
7917```
7918int32_t OH_ArkUI_DragEvent_SetSuggestedDropOperation (ArkUI_DragEvent * event, ArkUI_DropProposal proposal )
7919```
7920**Description**
7921
7922Sets the data processing mode.
7923
7924**Since**: 12
7925
7926**Parameters**
7927
7928| Name| Description|
7929| -------- | -------- |
7930| proposal | Recommended data processing mode |
7931| proposal | Type of the badge display status. |
7932
7933**Returns**
7934
7935Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7936
7937
7938### OH_ArkUI_DragPreviewOption_Dispose()
7939
7940```
7941void OH_ArkUI_DragPreviewOption_Dispose (ArkUI_DragPreviewOption * option)
7942```
7943**Description**
7944
7945Disposes of an **ArkUI_DragPreviewOption** object.
7946
7947**Since**: 12
7948
7949**Parameters**
7950
7951| Name| Description|
7952| -------- | -------- |
7953| option | Custom parameters. |
7954
7955
7956### OH_ArkUI_DragPreviewOption_SetBadgeNumber()
7957
7958```
7959int32_t OH_ArkUI_DragPreviewOption_SetBadgeNumber (ArkUI_DragPreviewOption * option, uint32_t forcedNumber )
7960```
7961**Description**
7962
7963Sets the count on the badge. The settings will overwrite the value in the **SetDragPreviewNumberBadgeEnabled** API.
7964
7965**Since**: 12
7966
7967**Parameters**
7968
7969| Name| Description|
7970| -------- | -------- |
7971| option | Custom parameters. |
7972| forcedNumber | Number of corner marks. |
7973
7974**Returns**
7975
7976Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7977
7978
7979### OH_ArkUI_DragPreviewOption_SetDefaultAnimationBeforeLiftingEnabled()
7980
7981```
7982int32_t OH_ArkUI_DragPreviewOption_SetDefaultAnimationBeforeLiftingEnabled (ArkUI_DragPreviewOption * option, bool enabled )
7983```
7984**Description**
7985
7986Sets whether to enable the default animation on a click or touch.
7987
7988**Since**: 12
7989
7990**Parameters**
7991
7992| Name| Description|
7993| -------- | -------- |
7994| option | Custom parameters. |
7995| enabled | Whether to enable the default click effect. |
7996
7997**Returns**
7998
7999Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
8000
8001
8002### OH_ArkUI_DragPreviewOption_SetDefaultRadiusEnabled()
8003
8004```
8005int32_t OH_ArkUI_DragPreviewOption_SetDefaultRadiusEnabled (ArkUI_DragPreviewOption * option, bool enabled )
8006```
8007**Description**
8008
8009Sets whether to enable the default corner radius effect for an **ArkUI_DragPreviewOption** object. The effect is enabled by default.
8010
8011**Since**: 12
8012
8013**Parameters**
8014
8015| Name| Description|
8016| -------- | -------- |
8017| option | Custom parameters. |
8018| enabled | Whether to enable the default corner radius effect. |
8019
8020**Returns**
8021
8022Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
8023
8024
8025### OH_ArkUI_DragPreviewOption_SetDefaultShadowEnabled()
8026
8027```
8028int32_t OH_ArkUI_DragPreviewOption_SetDefaultShadowEnabled (ArkUI_DragPreviewOption * option, bool enabled )
8029```
8030**Description**
8031
8032Sets whether to enable the default shadow effect for an **ArkUI_DragPreviewOption** object. The effect is enabled by default.
8033
8034**Since**: 12
8035
8036**Parameters**
8037
8038| Name| Description|
8039| -------- | -------- |
8040| option | Custom parameters. |
8041| enabled | Whether to enable the default shadow effect. |
8042
8043**Returns**
8044
8045Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
8046
8047
8048### OH_ArkUI_DragPreviewOption_SetNumberBadgeEnabled()
8049
8050```
8051int32_t OH_ArkUI_DragPreviewOption_SetNumberBadgeEnabled (ArkUI_DragPreviewOption * option, bool enabled )
8052```
8053**Description**
8054
8055Sets whether to enable the badge for an **ArkUI_DragPreviewOption** object. If this feature is enabled, a badge that contains the number of dragged items is displayed.
8056
8057**Since**: 12
8058
8059**Parameters**
8060
8061| Name| Description|
8062| -------- | -------- |
8063| option | Custom parameters. |
8064| enabled | Whether to enable the badge. |
8065
8066**Returns**
8067
8068Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
8069
8070
8071### OH_ArkUI_DragPreviewOption_SetScaleMode()
8072
8073```
8074int32_t OH_ArkUI_DragPreviewOption_SetScaleMode (ArkUI_DragPreviewOption * option, ArkUI_DragPreviewScaleMode scaleMode )
8075```
8076**Description**
8077
8078Sets the scale mode for an **ArkUI_DragPreviewOption** object.
8079
8080**Since**: 12
8081
8082**Parameters**
8083
8084| Name| Description|
8085| -------- | -------- |
8086| option | Custom parameters. |
8087| scaleMode | Scale mode to set. |
8088
8089**Returns**
8090
8091Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
8092
8093
8094### OH_ArkUI_DrawableDescriptor_CreateFromAnimatedPixelMap()
8095
8096```
8097ArkUI_DrawableDescriptor* OH_ArkUI_DrawableDescriptor_CreateFromAnimatedPixelMap (OH_PixelmapNativeHandle * array, int32_t size )
8098```
8099**Description**
8100
8101Creates a **DrawableDescriptor** object from an array of **PixelMap** objects.
8102
8103**Since**: 12
8104
8105**Parameters**
8106
8107| Name| Description|
8108| -------- | -------- |
8109| array | Pointer to the array of **PixelMap** objects. |
8110| size | Size of the **PixelMap** object array. |
8111
8112**Returns**
8113
8114Returns the pointer to the created **DrawableDescriptor** object.
8115
8116
8117### OH_ArkUI_DrawableDescriptor_CreateFromPixelMap()
8118
8119```
8120ArkUI_DrawableDescriptor* OH_ArkUI_DrawableDescriptor_CreateFromPixelMap (OH_PixelmapNativeHandle pixelMap)
8121```
8122**Description**
8123
8124Creates a **DrawableDescriptor** object from a **PixelMap** object.
8125
8126**Since**: 12
8127
8128**Parameters**
8129
8130| Name| Description|
8131| -------- | -------- |
8132| pixelMap | Pointer to the **PixelMap** object. |
8133
8134**Returns**
8135
8136Returns the pointer to the created **DrawableDescriptor** object.
8137
8138
8139### OH_ArkUI_DrawableDescriptor_Dispose()
8140
8141```
8142void OH_ArkUI_DrawableDescriptor_Dispose (ArkUI_DrawableDescriptor * drawableDescriptor)
8143```
8144**Description**
8145
8146Disposes of the pointer to a **DrawableDescriptor** object.
8147
8148**Since**: 12
8149
8150**Parameters**
8151
8152| Name| Description|
8153| -------- | -------- |
8154| drawableDescriptor | Pointer to the **DrawableDescriptor** object. |
8155
8156
8157### OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArray()
8158
8159```
8160OH_PixelmapNativeHandle* OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArray (ArkUI_DrawableDescriptor * drawableDescriptor)
8161```
8162**Description**
8163
8164Obtains an array of **PixelMap** objects for playing an animation.
8165
8166**Since**: 12
8167
8168**Parameters**
8169
8170| Name| Description|
8171| -------- | -------- |
8172| drawableDescriptor | Pointer to a **DrawableDescriptor** object. |
8173
8174**Returns**
8175
8176Pointer to the PixelMap image array.
8177
8178
8179### OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArraySize()
8180
8181```
8182int32_t OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArraySize (ArkUI_DrawableDescriptor * drawableDescriptor)
8183```
8184**Description**
8185
8186Obtains an array of **PixelMap** objects for playing an animation.
8187
8188**Since**: 12
8189
8190**Parameters**
8191
8192| Name| Description|
8193| -------- | -------- |
8194| drawableDescriptor | Pointer to a **DrawableDescriptor** object. |
8195
8196**Returns**
8197
8198Size of the PixelMap image array.
8199
8200
8201### OH_ArkUI_DrawableDescriptor_GetAnimationDuration()
8202
8203```
8204int32_t OH_ArkUI_DrawableDescriptor_GetAnimationDuration (ArkUI_DrawableDescriptor * drawableDescriptor)
8205```
8206**Description**
8207
8208Obtains the total playback duration of a PixelMap image array.
8209
8210**Since**: 12
8211
8212**Parameters**
8213
8214| Name| Description|
8215| -------- | -------- |
8216| drawableDescriptor | Pointer to a **DrawableDescriptor** object. |
8217
8218**Returns**
8219
8220Total playback duration, in milliseconds.
8221
8222
8223### OH_ArkUI_DrawableDescriptor_GetAnimationIteration()
8224
8225```
8226int32_t OH_ArkUI_DrawableDescriptor_GetAnimationIteration (ArkUI_DrawableDescriptor * drawableDescriptor)
8227```
8228**Description**
8229
8230Obtains the number of times that a **PixelMap** object array is played.
8231
8232**Since**: 12
8233
8234**Parameters**
8235
8236| Name| Description|
8237| -------- | -------- |
8238| drawableDescriptor | Pointer to a **DrawableDescriptor** object. |
8239
8240**Returns**
8241
8242Returns the number of playback times.
8243
8244
8245### OH_ArkUI_DrawableDescriptor_GetStaticPixelMap()
8246
8247```
8248OH_PixelmapNativeHandle OH_ArkUI_DrawableDescriptor_GetStaticPixelMap (ArkUI_DrawableDescriptor * drawableDescriptor)
8249```
8250**Description**
8251
8252Obtains the pointer to a **PixelMap** object.
8253
8254**Since**: 12
8255
8256**Parameters**
8257
8258| Name| Description|
8259| -------- | -------- |
8260| drawableDescriptor | Pointer to a **DrawableDescriptor** object. |
8261
8262**Returns**
8263
8264Pointer to the PixelMap object.
8265
8266
8267### OH_ArkUI_DrawableDescriptor_SetAnimationDuration()
8268
8269```
8270void OH_ArkUI_DrawableDescriptor_SetAnimationDuration (ArkUI_DrawableDescriptor * drawableDescriptor, int32_t duration )
8271```
8272**Description**
8273
8274Sets the total playback duration of the PixelMap image array.
8275
8276**Since**: 12
8277
8278**Parameters**
8279
8280| Name| Description|
8281| -------- | -------- |
8282| drawableDescriptor | Pointer to a **DrawableDescriptor** object. |
8283| duration | Total playback duration, in milliseconds. |
8284
8285
8286### OH_ArkUI_DrawableDescriptor_SetAnimationIteration()
8287
8288```
8289void OH_ArkUI_DrawableDescriptor_SetAnimationIteration (ArkUI_DrawableDescriptor * drawableDescriptor, int32_t iteration )
8290```
8291**Description**
8292
8293Sets the number of times that a pixel map image array is played.
8294
8295**Since**: 12
8296
8297**Parameters**
8298
8299| Name| Description|
8300| -------- | -------- |
8301| drawableDescriptor | Pointer to a **DrawableDescriptor** object. |
8302| iterations | Number of playback times. |
8303
8304
8305### OH_ArkUI_DrawContext_GetCanvas()
8306
8307```
8308void* OH_ArkUI_DrawContext_GetCanvas (ArkUI_DrawContext * context)
8309```
8310**Description**
8311
8312Obtains the drawing canvas pointer, which can be converted into the OH_Drawing_Canvas pointer of the graphics library for drawing.
8313
8314**Since**: 12
8315
8316**Parameters**
8317
8318| Name| Description|
8319| -------- | -------- |
8320| context | Draw context. |
8321
8322**Returns**
8323
8324Pointer to the canvas for drawing.
8325
8326
8327### OH_ArkUI_DrawContext_GetSize()
8328
8329```
8330ArkUI_IntSize OH_ArkUI_DrawContext_GetSize (ArkUI_DrawContext * context)
8331```
8332**Description**
8333
8334Obtains the size of a drawing area.
8335
8336**Since**: 12
8337
8338**Parameters**
8339
8340| Name| Description|
8341| -------- | -------- |
8342| context | Draw context. |
8343
8344**Returns**
8345
8346Size of the area that can be drawn.
8347
8348
8349### OH_ArkUI_GestureEvent_GetActionType()
8350
8351```
8352ArkUI_GestureEventActionType OH_ArkUI_GestureEvent_GetActionType (const ArkUI_GestureEvent * event)
8353```
8354**Description**
8355
8356Obtains the gesture event type.
8357
8358**Since**: 12
8359
8360**Parameters**
8361
8362| Name| Description|
8363| -------- | -------- |
8364| event | Gesture event. |
8365
8366**Returns**
8367
8368Returns the gesture event type.
8369
8370
8371### OH_ArkUI_GestureEvent_GetNode()
8372
8373```
8374ArkUI_NodeHandle OH_ArkUI_GestureEvent_GetNode (const ArkUI_GestureEvent * event)
8375```
8376**Description**
8377
8378Obtains the ArkUI component to which the gesture is bound.
8379
8380**Since**: 12
8381
8382**Parameters**
8383
8384| Name| Description|
8385| -------- | -------- |
8386| event | Gesture event. |
8387
8388**Returns**
8389
8390Returns the ArkUI component.
8391
8392
8393### OH_ArkUI_GestureEvent_GetRawInputEvent()
8394
8395```
8396const ArkUI_UIInputEvent* OH_ArkUI_GestureEvent_GetRawInputEvent (const ArkUI_GestureEvent * event)
8397```
8398**Description**
8399
8400Obtains gesture input.
8401
8402**Since**: 12
8403
8404**Parameters**
8405
8406| Name| Description|
8407| -------- | -------- |
8408| event | Gesture event. |
8409
8410**Returns**
8411
8412Returns the pointer to the input event of the gesture event.
8413
8414
8415### OH_ArkUI_GestureEvent_GetResponseNode()
8416
8417```
8418ArkUI_NodeHandle OH_ArkUI_GestureEvent_GetResponseNode (ArkUI_GestureEvent * event)
8419```
8420**Description**
8421
8422Obtains the node that responds to the gesture.
8423
8424**Since**: 12
8425
8426**Parameters**
8427
8428| Name| Description|
8429| -------- | -------- |
8430| event | Gesture event. |
8431
8432**Returns**
8433
8434Returns the pointer to the node if the node exists; returns **NULL** otherwise.
8435
8436
8437### OH_ArkUI_GestureEventTargetInfo_IsScrollBegin()
8438
8439```
8440int32_t OH_ArkUI_GestureEventTargetInfo_IsScrollBegin (ArkUI_GestureEventTargetInfo * info, bool * ret )
8441```
8442**Description**
8443
8444Obtains whether this scroll container is scrolled to the top.
8445
8446**Since**: 12
8447
8448**Parameters**
8449
8450| Name| Description|
8451| -------- | -------- |
8452| info | Gesture event target information. |
8453| ret | Obtains whether this scroll container is scrolled to the top. |
8454
8455**Returns**
8456
8457Returns **0** if the operation is successful. Returns **401** if a parameter error occurs. Returns **180001** if the component is not a scroll container.
8458
8459
8460### OH_ArkUI_GestureEventTargetInfo_IsScrollEnd()
8461
8462```
8463int32_t OH_ArkUI_GestureEventTargetInfo_IsScrollEnd (ArkUI_GestureEventTargetInfo * info, bool * ret )
8464```
8465**Description**
8466
8467Obtains whether this scroll container is scrolled to the bottom.
8468
8469**Since**: 12
8470
8471**Parameters**
8472
8473| Name| Description|
8474| -------- | -------- |
8475| info | Gesture event target information. |
8476| ret | Obtains whether this scroll container is scrolled to the bottom. |
8477
8478**Returns**
8479
8480Returns **0** if the operation is successful. Returns **401** if a parameter error occurs. Returns **180001** if the component is not a scroll container.
8481
8482
8483### OH_ArkUI_GestureInterruptInfo_GetGestureEvent()
8484
8485```
8486ArkUI_GestureEvent* OH_ArkUI_GestureInterruptInfo_GetGestureEvent (const ArkUI_GestureInterruptInfo * event)
8487```
8488**Description**
8489
8490Obtains the pointer to the interrupted gesture event.
8491
8492**Since**: 12
8493
8494**Parameters**
8495
8496| Name| Description|
8497| -------- | -------- |
8498| event | Interrupt callback event. |
8499
8500**Returns**
8501
8502Returns the pointer to the interrupted gesture event.
8503
8504
8505### OH_ArkUI_GestureInterruptInfo_GetRecognizer()
8506
8507```
8508ArkUI_GestureRecognizer* OH_ArkUI_GestureInterruptInfo_GetRecognizer (const ArkUI_GestureInterruptInfo * event)
8509```
8510**Description**
8511
8512Returns the pointer to interrupted gesture recognizer.
8513
8514**Since**: 12
8515
8516**Parameters**
8517
8518| Name| Description|
8519| -------- | -------- |
8520| event | Interrupt callback event. |
8521
8522**Returns**
8523
8524Pointer to the interrupted gesture.
8525
8526
8527### OH_ArkUI_GestureInterruptInfo_GetSystemFlag()
8528
8529```
8530bool OH_ArkUI_GestureInterruptInfo_GetSystemFlag (const ArkUI_GestureInterruptInfo * event)
8531```
8532**Description**
8533
8534Checks whether a gesture is a built-in gesture of the component.
8535
8536**Since**: 12
8537
8538**Parameters**
8539
8540| Name| Description|
8541| -------- | -------- |
8542| event | Gesture interrupt callback event. |
8543
8544**Returns**
8545
8546true: built-in gestures; false: non-built-in gestures.
8547
8548
8549### OH_ArkUI_GestureInterruptInfo_GetSystemRecognizerType()
8550
8551```
8552int32_t OH_ArkUI_GestureInterruptInfo_GetSystemRecognizerType (const ArkUI_GestureInterruptInfo * event)
8553```
8554**Description**
8555
8556Obtains the type of the system gesture to trigger.
8557
8558**Since**: 12
8559
8560**Parameters**
8561
8562| Name| Description|
8563| -------- | -------- |
8564| event | Interrupt callback event. |
8565
8566**Returns**
8567
8568Returns the type of the system gesture to trigger. If the gesture to trigger is not a system gesture, **-1** is returned.
8569
8570
8571### OH_ArkUI_GetContextByNode()
8572
8573```
8574ArkUI_ContextHandle OH_ArkUI_GetContextByNode (ArkUI_NodeHandle node)
8575```
8576**Description**
8577
8578Obtains the pointer to the UI context object of the specified node.
8579
8580**Since**: 12
8581
8582**Parameters**
8583
8584| Name| Description|
8585| -------- | -------- |
8586| node | Specified node. |
8587
8588**Returns**
8589
8590Returns the pointer to the UI context object.
8591
8592
8593### OH_ArkUI_GetContextFromNapiValue()
8594
8595```
8596int32_t OH_ArkUI_GetContextFromNapiValue (napi_env env, napi_value value, ArkUI_ContextHandle * context )
8597```
8598**Description**
8599
8600Obtains a **UIContext** object on the ArkTS side and maps it to an **ArkUI_ContextHandle** object on the native side.
8601
8602**Since**: 12
8603
8604**Parameters**
8605
8606| Name| Description|
8607| -------- | -------- |
8608| env | Pointer to the NAPI environment. |
8609| value | Context object created on the ArkTS side. |
8610| context | ArkUI_ContextHandle pointer. |
8611
8612**Returns**
8613
8614Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
8615
8616
8617### OH_ArkUI_GetDrawableDescriptorFromNapiValue()
8618
8619```
8620int32_t OH_ArkUI_GetDrawableDescriptorFromNapiValue (napi_env env, napi_value value, ArkUI_DrawableDescriptor ** drawableDescriptor )
8621```
8622**Description**
8623
8624Maps a **DrawableDescriptor** object on the ArkTS side to an **ArkUI_DrawableDescriptor** object on the native side.
8625
8626**Since**: 12
8627
8628**Parameters**
8629
8630| Name| Description|
8631| -------- | -------- |
8632| env | Pointer to the NAPI environment. |
8633| value | **DrawableDescriptor** object created on the ArkTS side. |
8634| drawableDescriptor | Object that receives the pointer to the **ArkUI_DrawableDescriptor** object. |
8635
8636**Returns**
8637
8638Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
8639
8640
8641### OH_ArkUI_GetDrawableDescriptorFromResourceNapiValue()
8642
8643```
8644int32_t OH_ArkUI_GetDrawableDescriptorFromResourceNapiValue (napi_env env, napi_value value, ArkUI_DrawableDescriptor ** drawableDescriptor )
8645```
8646**Description**
8647
8648Maps an $r resource object on the ArkTS side to an **ArkUI_DrawableDescriptor** object on the native side.
8649
8650**Since**: 12
8651
8652**Parameters**
8653
8654| Name| Description|
8655| -------- | -------- |
8656| env | Pointer to the NAPI environment. |
8657| value | $r resource object created on ArkTS. |
8658| drawableDescriptor | Object that receives the pointer to the **ArkUI_DrawableDescriptor** object. |
8659
8660**Returns**
8661
8662Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
8663
8664
8665### OH_ArkUI_GetGestureBindNodeId()
8666
8667```
8668int32_t OH_ArkUI_GetGestureBindNodeId (ArkUI_GestureRecognizer * recognizer, char * nodeId, int32_t size, int32_t * result )
8669```
8670**Description**
8671
8672Obtains the ID of the component linked to a gesture recognizer.
8673
8674**Since**: 12
8675
8676**Parameters**
8677
8678| Name| Description|
8679| -------- | -------- |
8680| recognizer | Pointer to the gesture recognizer. |
8681| nodeId | ID of a component. |
8682| size | Size of the storage area. |
8683| result | Length of the string to be copied. |
8684
8685**Returns**
8686
8687Returns **0** if the operation is successful. Returns **401** if a parameter error occurs. Returns **180002** if the buffer is not large enough.
8688
8689
8690### OH_ArkUI_GetGestureEventTargetInfo()
8691
8692```
8693int32_t OH_ArkUI_GetGestureEventTargetInfo (ArkUI_GestureRecognizer * recognizer, ArkUI_GestureEventTargetInfo ** info )
8694```
8695**Description**
8696
8697Obtains the information about a gesture event target.
8698
8699**Since**: 12
8700
8701**Parameters**
8702
8703| Name| Description|
8704| -------- | -------- |
8705| recognizer | Pointer to the gesture recognizer. |
8706| info | Gesture event target information. |
8707
8708**Returns**
8709
8710Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
8711
8712
8713### OH_ArkUI_GetGestureRecognizerEnabled()
8714
8715```
8716bool OH_ArkUI_GetGestureRecognizerEnabled (ArkUI_GestureRecognizer * recognizer)
8717```
8718**Description**
8719
8720Obtains the enabled state of a gesture recognizer.
8721
8722**Since**: 12
8723
8724**Parameters**
8725
8726| Name| Description|
8727| -------- | -------- |
8728| recognizer | Pointer to the gesture recognizer. |
8729
8730**Returns**
8731
8732**true**: enabled false: disabled
8733
8734
8735### OH_ArkUI_GetGestureRecognizerState()
8736
8737```
8738int32_t OH_ArkUI_GetGestureRecognizerState (ArkUI_GestureRecognizer * recognizer, ArkUI_GestureRecognizerState * state )
8739```
8740**Description**
8741
8742Obtains the state of a gesture recognizer.
8743
8744**Since**: 12
8745
8746**Parameters**
8747
8748| Name| Description|
8749| -------- | -------- |
8750| recognizer | Pointer to the gesture recognizer. |
8751| state | Status of the gesture recognizer. |
8752
8753**Returns**
8754
8755Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
8756
8757
8758### OH_ArkUI_GetGestureTag()
8759
8760```
8761int32_t OH_ArkUI_GetGestureTag (ArkUI_GestureRecognizer * recognizer, char * buffer, int32_t bufferSize, int32_t * result )
8762```
8763**Description**
8764
8765Obtains the mark of the gesture recognizer.
8766
8767**Since**: 12
8768
8769**Parameters**
8770
8771| Name| Description|
8772| -------- | -------- |
8773| recognizer | Pointer to the gesture recognizer. |
8774| buffer | Storage zone |
8775| bufferSize | Size of the storage area. |
8776| result | Length of the string to be copied. |
8777
8778**Returns**
8779
8780Returns **0** if the operation is successful. Returns **401** if a parameter error occurs. Returns **180002** if the buffer is not large enough.
8781
8782
8783### OH_ArkUI_GetNavDestinationId()
8784
8785```
8786ArkUI_ErrorCode OH_ArkUI_GetNavDestinationId (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )
8787```
8788**Description**
8789
8790Obtains the ID of the **NavDestination** component where the specified node is located.
8791
8792**Since**: 12
8793
8794**Parameters**
8795
8796| Name| Description|
8797| -------- | -------- |
8798| node | Specified node. |
8799| buffer | buffer. NavDestinationID is written to this memory area. |
8800| bufferSize | Pointer to the buffer size. |
8801| writeLength | When ARKUI_ERROR_CODE_NO_ERROR is returned, this parameter indicates the length of the string written to the buffer. When ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR is returned, this parameter indicates the minimum buffer size that can hold the target. |
8802
8803**Returns**
8804
8805Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. The ARKUI_ERROR_CODE_GET_INFO_FAILED fails to query information. The possible cause is that the current node is not in Navigation. The buffer size specified by ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR is less than the minimum buffer size that can hold the target.
8806
8807
8808### OH_ArkUI_GetNavDestinationIndex()
8809
8810```
8811ArkUI_ErrorCode OH_ArkUI_GetNavDestinationIndex (ArkUI_NodeHandle node, int32_t * index )
8812```
8813**Description**
8814
8815Obtains the index of the **NavDestination** component where the specified node is located in the navigation stack.
8816
8817**Since**: 12
8818
8819**Parameters**
8820
8821| Name| Description|
8822| -------- | -------- |
8823| node | Specified node. |
8824| index | Returns the index, starting from 0. |
8825
8826**Returns**
8827
8828Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. The ARKUI_ERROR_CODE_GET_INFO_FAILED fails to query information. The possible cause is that the current node is not in Navigation.
8829
8830
8831### OH_ArkUI_GetNavDestinationName()
8832
8833```
8834ArkUI_ErrorCode OH_ArkUI_GetNavDestinationName (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )
8835```
8836**Description**
8837
8838Obtains the name of the **NavDestination** component where the specified node is located.
8839
8840**Since**: 12
8841
8842**Parameters**
8843
8844| Name| Description|
8845| -------- | -------- |
8846| node | Specified node. |
8847| buffer | Buffer. The queried NavDestination name is written to this memory area. |
8848| bufferSize | Pointer to the buffer size. |
8849| writeLength | When ARKUI_ERROR_CODE_NO_ERROR is returned, this parameter indicates the length of the string written to the buffer. When ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR is returned, this parameter indicates the minimum buffer size that can hold the target. |
8850
8851**Returns**
8852
8853Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. The ARKUI_ERROR_CODE_GET_INFO_FAILED fails to query information. The possible cause is that the current node is not in Navigation. The buffer size specified by ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR is less than the minimum buffer size that can hold the target.
8854
8855
8856### OH_ArkUI_GetNavDestinationNameByIndex()
8857
8858```
8859ArkUI_ErrorCode OH_ArkUI_GetNavDestinationNameByIndex (ArkUI_NodeHandle node, int32_t index, char * buffer, int32_t bufferSize, int32_t * writeLength )
8860```
8861**Description**
8862
8863Obtains the page name that matches the specified index in the navigation stack where the specified node is located.        The index starts from 0, which indicates the bottom of the stack.
8864
8865**Since**: 12
8866
8867**Parameters**
8868
8869| Name| Description|
8870| -------- | -------- |
8871| node | Specified node. |
8872| index | Index of the queried NavDestination in the stack. |
8873| buffer | Buffer. The name of the queried page is written to this memory area. |
8874| bufferSize | Pointer to the buffer size. |
8875| writeLength | When ARKUI_ERROR_CODE_NO_ERROR is returned, this parameter indicates the length of the string written to the buffer. When ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR is returned, this parameter indicates the minimum buffer size that can hold the target. |
8876
8877**Returns**
8878
8879Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. The value of ARKUI_ERROR_CODE_NODE_INDEX_INVALID index is invalid. The ARKUI_ERROR_CODE_GET_INFO_FAILED fails to query information. The possible cause is that the current node is not in Navigation. The buffer size specified by ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR is less than the minimum buffer size that can hold the target.
8880
8881
8882### OH_ArkUI_GetNavDestinationParam()
8883
8884```
8885napi_value OH_ArkUI_GetNavDestinationParam (ArkUI_NodeHandle node)
8886```
8887**Description**
8888
8889Obtains the parameters of the **NavDestination** component where the specified node is located.
8890
8891**Since**: 12
8892
8893**Parameters**
8894
8895| Name| Description|
8896| -------- | -------- |
8897| node | Specified node. |
8898
8899**Returns**
8900
8901Parameter object.
8902
8903
8904### OH_ArkUI_GetNavDestinationState()
8905
8906```
8907ArkUI_ErrorCode OH_ArkUI_GetNavDestinationState (ArkUI_NodeHandle node, ArkUI_NavDestinationState * state )
8908```
8909**Description**
8910
8911Obtains the state of the **NavDestination** component where the specified node is located.
8912
8913**Since**: 12
8914
8915**Parameters**
8916
8917| Name| Description|
8918| -------- | -------- |
8919| node | Specified node. |
8920| state | The status value of NavDestination is written back to this parameter. |
8921
8922**Returns**
8923
8924The error code ARKUI_ERROR_CODE_NO_ERROR is returned. The ARKUI_ERROR_CODE_GET_INFO_FAILED fails to query information. The possible cause is that the current node is not in Navigation.
8925
8926
8927### OH_ArkUI_GetNavigationId()
8928
8929```
8930ArkUI_ErrorCode OH_ArkUI_GetNavigationId (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )
8931```
8932**Description**
8933
8934Obtains the ID of the **Navigation** component where the specified node is located.
8935
8936**Since**: 12
8937
8938**Parameters**
8939
8940| Name| Description|
8941| -------- | -------- |
8942| node | Specified node. |
8943| buffer | buffer. The NavigationID is written to this memory area. |
8944| bufferSize | Pointer to the buffer size. |
8945| writeLength | When ARKUI_ERROR_CODE_NO_ERROR is returned, this parameter indicates the length of the string written to the buffer. When ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR is returned, this parameter indicates the minimum buffer size that can hold the target. |
8946
8947**Returns**
8948
8949Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. The ARKUI_ERROR_CODE_GET_INFO_FAILED fails to query information. The possible cause is that the current node is not in Navigation. The buffer size specified by ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR is less than the minimum buffer size that can hold the target.
8950
8951
8952### OH_ArkUI_GetNavStackLength()
8953
8954```
8955ArkUI_ErrorCode OH_ArkUI_GetNavStackLength (ArkUI_NodeHandle node, int32_t * length )
8956```
8957**Description**
8958
8959Obtains the length of the navigation stack where the specified node is located.
8960
8961**Since**: 12
8962
8963**Parameters**
8964
8965| Name| Description|
8966| -------- | -------- |
8967| node | Specified node. |
8968| length | Length of the stack. The result, if obtained successfully, is written back to this parameter. |
8969
8970**Returns**
8971
8972Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. The ARKUI_ERROR_CODE_GET_INFO_FAILED fails to query information. The possible cause is that the current node is not in Navigation.
8973
8974
8975### OH_ArkUI_GetNodeContentFromNapiValue()
8976
8977```
8978int32_t OH_ArkUI_GetNodeContentFromNapiValue (napi_env env, napi_value value, ArkUI_NodeContentHandle * content )
8979```
8980**Description**
8981
8982Obtains a **NodeContent** object on the ArkTS side and maps it to an **ArkUI_NodeContentHandle** object on the native side.
8983
8984**Since**: 12
8985
8986**Parameters**
8987
8988| Name| Description|
8989| -------- | -------- |
8990| env | Pointer to the NAPI environment. |
8991| value | NodeContent object created on ArkTS. |
8992| context | ArkUI_NodeContentHandle pointer. |
8993
8994**Returns**
8995
8996Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
8997
8998
8999### OH_ArkUI_GetNodeHandleFromNapiValue()
9000
9001```
9002int32_t OH_ArkUI_GetNodeHandleFromNapiValue (napi_env env, napi_value frameNode, ArkUI_NodeHandle * handle )
9003```
9004**Description**
9005
9006Obtains a **FrameNode** object on the ArkTS side and maps it to an **ArkUI_NodeHandle** object on the native side.
9007
9008**Since**: 12
9009
9010**Parameters**
9011
9012| Name| Description|
9013| -------- | -------- |
9014| env | Pointer to the NAPI environment. |
9015| frameNode | FrameNode object created on the ArkTS side. |
9016| handle | **ArkUI_NodeHandle** pointer. |
9017
9018**Returns**
9019
9020Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9021
9022### OH_ArkUI_GetPanGestureDirectionMask()
9023
9024```
9025int32_t OH_ArkUI_GetPanGestureDirectionMask (ArkUI_GestureRecognizer * recognizer, ArkUI_GestureDirectionMask * directionMask )
9026```
9027**Description**
9028
9029Obtains the direction of a pan gesture.
9030
9031**Since**: 12
9032
9033**Parameters**
9034
9035| Name| Description|
9036| -------- | -------- |
9037| recognizer | Pointer to the gesture recognizer. |
9038| directionMask | Sliding direction of the sliding gesture. |
9039
9040**Returns**
9041
9042Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
9043
9044
9045### OH_ArkUI_GetResponseRecognizersFromInterruptInfo()
9046
9047```
9048int32_t OH_ArkUI_GetResponseRecognizersFromInterruptInfo (const ArkUI_GestureInterruptInfo * event, ArkUI_GestureRecognizerHandleArray * responseChain, int32_t * count )
9049```
9050**Description**
9051
9052Obtains information about a gesture response chain.
9053
9054**Since**: 12
9055
9056**Parameters**
9057
9058| Name| Description|
9059| -------- | -------- |
9060| event | Gesture interrupt callback event. |
9061| responseChain | Gesture recognizer on the response chain component. |
9062| count | Number of gesture recognizers on the response chain component. |
9063
9064**Returns**
9065
9066Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
9067
9068
9069### OH_ArkUI_GetRouterPageId()
9070
9071```
9072ArkUI_ErrorCode OH_ArkUI_GetRouterPageId (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )
9073```
9074**Description**
9075
9076Obtains the ID of the page where the specified node is located.
9077
9078**Since**: 12
9079
9080**Parameters**
9081
9082| Name| Description|
9083| -------- | -------- |
9084| node | Specified node. |
9085| buffer | buffer. Page Id is written to this memory area. |
9086| bufferSize | Pointer to the buffer size. |
9087| writeLength | When ARKUI_ERROR_CODE_NO_ERROR is returned, this parameter indicates the length of the string written to the buffer. When ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR is returned, this parameter indicates the minimum buffer size that can hold the target. |
9088
9089**Returns**
9090
9091Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. The ARKUI_ERROR_CODE_GET_INFO_FAILED fails to query information. The buffer size specified by ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR is less than the minimum buffer size that can hold the target.
9092
9093
9094### OH_ArkUI_GetRouterPageIndex()
9095
9096```
9097ArkUI_ErrorCode OH_ArkUI_GetRouterPageIndex (ArkUI_NodeHandle node, int32_t * index )
9098```
9099**Description**
9100
9101Obtains the index of the page where the specified node is located in the page stack for routing.
9102
9103**Since**: 12
9104
9105**Parameters**
9106
9107| Name| Description|
9108| -------- | -------- |
9109| node | Specified node. |
9110| index | Returns the index, starting from 1. |
9111
9112**Returns**
9113
9114Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. The ARKUI_ERROR_CODE_GET_INFO_FAILED fails to query information. The possible cause is that the current node is not in Navigation.
9115
9116
9117### OH_ArkUI_GetRouterPageName()
9118
9119```
9120ArkUI_ErrorCode OH_ArkUI_GetRouterPageName (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )
9121```
9122**Description**
9123
9124Obtains the name of the page where the specified node is located.
9125
9126**Since**: 12
9127
9128**Parameters**
9129
9130| Name| Description|
9131| -------- | -------- |
9132| node | Specified node. |
9133| buffer | Buffer. The page name is written to this memory area. |
9134| bufferSize | Pointer to the buffer size. |
9135| writeLength | When ARKUI_ERROR_CODE_NO_ERROR is returned, this parameter indicates the length of the string written to the buffer. When ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR is returned, this parameter indicates the minimum buffer size that can hold the target. |
9136
9137**Returns**
9138
9139Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. The ARKUI_ERROR_CODE_GET_INFO_FAILED fails to query information. The buffer size specified by ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR is less than the minimum buffer size that can hold the target.
9140
9141
9142### OH_ArkUI_GetRouterPagePath()
9143
9144```
9145ArkUI_ErrorCode OH_ArkUI_GetRouterPagePath (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )
9146```
9147**Description**
9148
9149Obtains the path to the page where the specified node is located.
9150
9151**Since**: 12
9152
9153**Parameters**
9154
9155| Name| Description|
9156| -------- | -------- |
9157| node | Specified node. |
9158| buffer | buffer. Page Path is written to this memory area. |
9159| bufferSize | Pointer to the buffer size. |
9160| writeLength | When ARKUI_ERROR_CODE_NO_ERROR is returned, this parameter indicates the length of the string written to the buffer. When ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR is returned, this parameter indicates the minimum buffer size that can hold the target. |
9161
9162**Returns**
9163
9164Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. The ARKUI_ERROR_CODE_GET_INFO_FAILED fails to query information. The buffer size specified by ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR is less than the minimum buffer size that can hold the target.
9165
9166
9167### OH_ArkUI_GetRouterPageState()
9168
9169```
9170ArkUI_ErrorCode OH_ArkUI_GetRouterPageState (ArkUI_NodeHandle node, ArkUI_RouterPageState * state )
9171```
9172**Description**
9173
9174Obtains the state of the page where the specified node is located.
9175
9176**Since**: 12
9177
9178**Parameters**
9179
9180| Name| Description|
9181| -------- | -------- |
9182| node | Specified node. |
9183| state | The status value of Router Page is written back to this parameter. |
9184
9185**Returns**
9186
9187The error code ARKUI_ERROR_CODE_NO_ERROR is returned. The ARKUI_ERROR_CODE_GET_INFO_FAILED fails to query information.
9188
9189
9190### OH_ArkUI_GuidelineOption_Create()
9191
9192```
9193ArkUI_GuidelineOption* OH_ArkUI_GuidelineOption_Create (int32_t size)
9194```
9195**Description**
9196
9197Creates a guideline configuration for this **RelativeContainer**.
9198
9199**Since**: 12
9200
9201**Parameters**
9202
9203| Name| Description|
9204| -------- | -------- |
9205| size | Number of guidelines. |
9206
9207**Returns**
9208
9209Returns the guideline configuration.
9210
9211
9212### OH_ArkUI_GuidelineOption_Dispose()
9213
9214```
9215void OH_ArkUI_GuidelineOption_Dispose (ArkUI_GuidelineOption * guideline)
9216```
9217**Description**
9218
9219Destroys auxiliary line information.
9220
9221**Since**: 12
9222
9223**Parameters**
9224
9225| Name| Description|
9226| -------- | -------- |
9227| guideline | Pointer to a guideline configuration. |
9228
9229
9230### OH_ArkUI_GuidelineOption_GetDirection()
9231
9232```
9233ArkUI_Axis OH_ArkUI_GuidelineOption_GetDirection (ArkUI_GuidelineOption * guideline, int32_t index )
9234```
9235**Description**
9236
9237Obtains the direction of a guideline.
9238
9239**Since**: 12
9240
9241**Parameters**
9242
9243| Name| Description|
9244| -------- | -------- |
9245| guideline | Pointer to a guideline configuration. |
9246| index | Index of the guideline. |
9247
9248**Returns**
9249
9250Returns the direction of the guideline.
9251
9252
9253### OH_ArkUI_GuidelineOption_GetId()
9254
9255```
9256const char* OH_ArkUI_GuidelineOption_GetId (ArkUI_GuidelineOption * guideline, int32_t index )
9257```
9258**Description**
9259
9260Obtains the ID of a guideline.
9261
9262**Since**: 12
9263
9264**Parameters**
9265
9266| Name| Description|
9267| -------- | -------- |
9268| guideline | Pointer to a guideline configuration. |
9269| index | Index of the guideline. |
9270
9271**Returns**
9272
9273Returns the ID of the guideline.
9274
9275
9276### OH_ArkUI_GuidelineOption_GetPositionEnd()
9277
9278```
9279float OH_ArkUI_GuidelineOption_GetPositionEnd (ArkUI_GuidelineOption * guideline, int32_t index )
9280```
9281**Description**
9282
9283Obtains the distance between a guideline and the right or bottom of the container.
9284
9285**Since**: 12
9286
9287**Parameters**
9288
9289| Name| Description|
9290| -------- | -------- |
9291| guideline | Pointer to a guideline configuration. |
9292| index | Index of the guideline. |
9293
9294**Returns**
9295
9296Distance between the guideline and the right or bottom of the container.
9297
9298
9299### OH_ArkUI_GuidelineOption_GetPositionStart()
9300
9301```
9302float OH_ArkUI_GuidelineOption_GetPositionStart (ArkUI_GuidelineOption * guideline, int32_t index )
9303```
9304**Description**
9305
9306Obtains the distance between a guideline and the left or top of the container.
9307
9308**Since**: 12
9309
9310**Parameters**
9311
9312| Name| Description|
9313| -------- | -------- |
9314| guideline | Pointer to a guideline configuration. |
9315| index | Index of the guideline. |
9316
9317**Returns**
9318
9319Distance between the guideline and the left or top of the container.
9320
9321
9322### OH_ArkUI_GuidelineOption_SetDirection()
9323
9324```
9325void OH_ArkUI_GuidelineOption_SetDirection (ArkUI_GuidelineOption * guideline, ArkUI_Axis value, int32_t index )
9326```
9327**Description**
9328
9329Sets the direction of a guideline.
9330
9331**Since**: 12
9332
9333**Parameters**
9334
9335| Name| Description|
9336| -------- | -------- |
9337| guideline | Pointer to a guideline configuration. |
9338| value | Direction.  |
9339| index | Index of the guideline. |
9340
9341
9342### OH_ArkUI_GuidelineOption_SetId()
9343
9344```
9345void OH_ArkUI_GuidelineOption_SetId (ArkUI_GuidelineOption * guideline, const char * value, int32_t index )
9346```
9347**Description**
9348
9349Sets the ID of a guideline.
9350
9351**Since**: 12
9352
9353**Parameters**
9354
9355| Name| Description|
9356| -------- | -------- |
9357| guideline | Pointer to a guideline configuration. |
9358| value | ID of the guideline, which must be unique and cannot be the same as the name of any component in the container. |
9359| index | Index of the guideline. |
9360
9361
9362### OH_ArkUI_GuidelineOption_SetPositionEnd()
9363
9364```
9365void OH_ArkUI_GuidelineOption_SetPositionEnd (ArkUI_GuidelineOption * guideline, float value, int32_t index )
9366```
9367**Description**
9368
9369Sets the distance between a guideline and the right or bottom of the container.
9370
9371**Since**: 12
9372
9373**Parameters**
9374
9375| Name| Description|
9376| -------- | -------- |
9377| guideline | Pointer to a guideline configuration. |
9378| value | Distance between the guideline and the right or bottom of the container. |
9379| index | Index of the guideline. |
9380
9381
9382### OH_ArkUI_GuidelineOption_SetPositionStart()
9383
9384```
9385void OH_ArkUI_GuidelineOption_SetPositionStart (ArkUI_GuidelineOption * guideline, float value, int32_t index )
9386```
9387**Description**
9388
9389Sets the distance between a guideline and the left or top of the container.
9390
9391**Since**: 12
9392
9393**Parameters**
9394
9395| Name| Description|
9396| -------- | -------- |
9397| guideline | Pointer to a guideline configuration. |
9398| value | Distance between the guideline and the left or top of the container. |
9399| index | Index of the guideline. |
9400
9401
9402### OH_ArkUI_ImageAnimatorFrameInfo_CreateFromDrawableDescriptor()
9403
9404```
9405ArkUI_ImageAnimatorFrameInfo* OH_ArkUI_ImageAnimatorFrameInfo_CreateFromDrawableDescriptor (ArkUI_DrawableDescriptor * drawable)
9406```
9407**Description**
9408
9409Creates an image frame information object based on a **DrawableDescriptor** object, with the image format being Resource or PixelMap.
9410
9411**Since**: 12
9412
9413**Parameters**
9414
9415| Name| Description|
9416| -------- | -------- |
9417| drawable | Pointer to an **ArkUI_DrawableDescriptor** object created using Resource or PixelMap. |
9418
9419**Returns**
9420
9421Returns the pointer to the created frame image object.
9422
9423
9424### OH_ArkUI_ImageAnimatorFrameInfo_CreateFromString()
9425
9426```
9427ArkUI_ImageAnimatorFrameInfo* OH_ArkUI_ImageAnimatorFrameInfo_CreateFromString (char * src)
9428```
9429**Description**
9430
9431Creates an image frame information object based on an image path, with the image format being SVG, PNG, or JPG.
9432
9433**Since**: 12
9434
9435**Parameters**
9436
9437| Name| Description|
9438| -------- | -------- |
9439| src | Image path. |
9440
9441**Returns**
9442
9443Returns the pointer to the created frame image object.
9444
9445
9446### OH_ArkUI_ImageAnimatorFrameInfo_Dispose()
9447
9448```
9449void OH_ArkUI_ImageAnimatorFrameInfo_Dispose (ArkUI_ImageAnimatorFrameInfo * imageInfo)
9450```
9451**Description**
9452
9453Disposes of the pointer to an image frame information object.
9454
9455**Since**: 12
9456
9457**Parameters**
9458
9459| Name| Description|
9460| -------- | -------- |
9461| imageInfo | Pointer to the frame image object. |
9462
9463
9464### OH_ArkUI_ImageAnimatorFrameInfo_GetDuration()
9465
9466```
9467int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetDuration (ArkUI_ImageAnimatorFrameInfo * imageInfo)
9468```
9469**Description**
9470
9471Obtains the playback duration of an image.
9472
9473**Since**: 12
9474
9475**Parameters**
9476
9477| Name| Description|
9478| -------- | -------- |
9479| imageInfo | Pointer to the frame image object. |
9480
9481**Returns**
9482
9483Returns the playback duration of the image, in milliseconds. If **imageInfo** is a null pointer, **0** is returned.
9484
9485
9486### OH_ArkUI_ImageAnimatorFrameInfo_GetHeight()
9487
9488```
9489int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetHeight (ArkUI_ImageAnimatorFrameInfo * imageInfo)
9490```
9491**Description**
9492
9493Obtains the image height.
9494
9495**Since**: 12
9496
9497**Parameters**
9498
9499| Name| Description|
9500| -------- | -------- |
9501| imageInfo | Pointer to the frame image object. |
9502
9503**Returns**
9504
9505Returns the image height, in PX. If **imageInfo** is a null pointer, **0** is returned.
9506
9507
9508### OH_ArkUI_ImageAnimatorFrameInfo_GetLeft()
9509
9510```
9511int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetLeft (ArkUI_ImageAnimatorFrameInfo * imageInfo)
9512```
9513**Description**
9514
9515Obtains the horizontal coordinate of an image relative to the upper left corner of the component.
9516
9517**Since**: 12
9518
9519**Parameters**
9520
9521| Name| Description|
9522| -------- | -------- |
9523| imageInfo | Pointer to the frame image object. |
9524
9525**Returns**
9526
9527Returns the horizontal coordinate of the image relative to the upper left corner of the component, in px. If **imageInfo** is a null pointer, **0** is returned.
9528
9529
9530### OH_ArkUI_ImageAnimatorFrameInfo_GetTop()
9531
9532```
9533int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetTop (ArkUI_ImageAnimatorFrameInfo * imageInfo)
9534```
9535**Description**
9536
9537Obtains the vertical coordinate of an image relative to the upper left corner of the component.
9538
9539**Since**: 12
9540
9541**Parameters**
9542
9543| Name| Description|
9544| -------- | -------- |
9545| imageInfo | Pointer to the frame image object. |
9546
9547**Returns**
9548
9549Returns the vertical coordinate of the image relative to the upper left corner of the component, in px. If **imageInfo** is a null pointer, **0** is returned.
9550
9551
9552### OH_ArkUI_ImageAnimatorFrameInfo_GetWidth()
9553
9554```
9555int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetWidth (ArkUI_ImageAnimatorFrameInfo * imageInfo)
9556```
9557**Description**
9558
9559Obtains the image width.
9560
9561**Since**: 12
9562
9563**Parameters**
9564
9565| Name| Description|
9566| -------- | -------- |
9567| imageInfo | Pointer to the frame image object. |
9568
9569**Returns**
9570
9571Returns the image width, in PX. If **imageInfo** is a null pointer, **0** is returned.
9572
9573
9574### OH_ArkUI_ImageAnimatorFrameInfo_SetDuration()
9575
9576```
9577void OH_ArkUI_ImageAnimatorFrameInfo_SetDuration (ArkUI_ImageAnimatorFrameInfo * imageInfo, int32_t duration )
9578```
9579**Description**
9580
9581Sets the playback duration of an image.
9582
9583**Since**: 12
9584
9585**Parameters**
9586
9587| Name| Description|
9588| -------- | -------- |
9589| imageInfo | Pointer to the frame image object. |
9590| duration | Playback duration of an image, in milliseconds. |
9591
9592
9593### OH_ArkUI_ImageAnimatorFrameInfo_SetHeight()
9594
9595```
9596void OH_ArkUI_ImageAnimatorFrameInfo_SetHeight (ArkUI_ImageAnimatorFrameInfo * imageInfo, int32_t height )
9597```
9598**Description**
9599
9600Sets the image height.
9601
9602**Since**: 12
9603
9604**Parameters**
9605
9606| Name| Description|
9607| -------- | -------- |
9608| imageInfo | Pointer to the frame image object. |
9609| height | Image height, in px. |
9610
9611
9612### OH_ArkUI_ImageAnimatorFrameInfo_SetLeft()
9613
9614```
9615void OH_ArkUI_ImageAnimatorFrameInfo_SetLeft (ArkUI_ImageAnimatorFrameInfo * imageInfo, int32_t left )
9616```
9617**Description**
9618
9619Sets the horizontal coordinate of an image relative to the upper left corner of the component.
9620
9621**Since**: 12
9622
9623**Parameters**
9624
9625| Name| Description|
9626| -------- | -------- |
9627| imageInfo | Pointer to the frame image object. |
9628| left | Horizontal coordinate of the image relative to the upper left corner of the component, in px. |
9629
9630
9631### OH_ArkUI_ImageAnimatorFrameInfo_SetTop()
9632
9633```
9634void OH_ArkUI_ImageAnimatorFrameInfo_SetTop (ArkUI_ImageAnimatorFrameInfo * imageInfo, int32_t top )
9635```
9636**Description**
9637
9638Sets the vertical coordinate of an image relative to the upper left corner of the component.
9639
9640**Since**: 12
9641
9642**Parameters**
9643
9644| Name| Description|
9645| -------- | -------- |
9646| imageInfo | Pointer to the frame image object. |
9647| top | Vertical coordinate of the image relative to the upper left corner of the component, in px. |
9648
9649
9650### OH_ArkUI_ImageAnimatorFrameInfo_SetWidth()
9651
9652```
9653void OH_ArkUI_ImageAnimatorFrameInfo_SetWidth (ArkUI_ImageAnimatorFrameInfo * imageInfo, int32_t width )
9654```
9655**Description**
9656
9657Sets the image width.
9658
9659**Since**: 12
9660
9661**Parameters**
9662
9663| Name| Description|
9664| -------- | -------- |
9665| imageInfo | Pointer to the frame image object. |
9666| width | Image width, in px. |
9667
9668
9669### OH_ArkUI_IsBuiltInGesture()
9670
9671```
9672bool OH_ArkUI_IsBuiltInGesture (ArkUI_GestureRecognizer * recognizer)
9673```
9674**Description**
9675
9676Obtains whether a gesture is a built-in gesture.
9677
9678**Since**: 12
9679
9680**Parameters**
9681
9682| Name| Description|
9683| -------- | -------- |
9684| recognizer | Pointer to the gesture recognizer. |
9685
9686**Returns**
9687
9688true: built-in gestures. false: The gesture is not a built-in gesture.
9689
9690
9691### OH_ArkUI_IsGestureRecognizerValid()
9692
9693```
9694bool OH_ArkUI_IsGestureRecognizerValid (ArkUI_GestureRecognizer * recognizer)
9695```
9696**Description**
9697
9698Obtains whether a gesture recognizer is valid.
9699
9700**Since**: 12
9701
9702**Parameters**
9703
9704| Name| Description|
9705| -------- | -------- |
9706| recognizer | Pointer to the gesture recognizer. |
9707
9708**Returns**
9709
9710true: The gesture recognizer is valid. Returns **false** if the gesture recognizer is invalid.
9711
9712
9713### OH_ArkUI_KeyframeAnimateOption_Create()
9714
9715```
9716ArkUI_KeyframeAnimateOption* OH_ArkUI_KeyframeAnimateOption_Create (int32_t size)
9717```
9718**Description**
9719
9720Obtains the keyframe animation parameters.
9721
9722**Since**: 12
9723
9724**Parameters**
9725
9726| Name| Description|
9727| -------- | -------- |
9728| size | Number of key frame animation states. |
9729
9730**Returns**
9731
9732Returns the keyframe animation parameter object; returns **NULL** if the value of **size** is less than 0.
9733
9734
9735### OH_ArkUI_KeyframeAnimateOption_Dispose()
9736
9737```
9738void OH_ArkUI_KeyframeAnimateOption_Dispose (ArkUI_KeyframeAnimateOption * option)
9739```
9740**Description**
9741
9742Destroys a keyframe animation parameter object.
9743
9744**Since**: 12
9745
9746**Parameters**
9747
9748| Name| Description|
9749| -------- | -------- |
9750| option | Returns the keyframe animation parameter object; |
9751
9752
9753### OH_ArkUI_KeyframeAnimateOption_GetCurve()
9754
9755```
9756ArkUI_CurveHandle OH_ArkUI_KeyframeAnimateOption_GetCurve (ArkUI_KeyframeAnimateOption * option, int32_t index )
9757```
9758**Description**
9759
9760Obtains the animation curve of a specific state in a keyframe animation.
9761
9762**Since**: 12
9763
9764**Parameters**
9765
9766| Name| Description|
9767| -------- | -------- |
9768| option | Keyframe animation parameters. |
9769| index | Status index. |
9770
9771**Returns**
9772
9773Returns the animation curve.
9774
9775
9776### OH_ArkUI_KeyframeAnimateOption_GetDelay()
9777
9778```
9779int32_t OH_ArkUI_KeyframeAnimateOption_GetDelay (ArkUI_KeyframeAnimateOption * option)
9780```
9781**Description**
9782
9783Obtains the overall delay of a keyframe animation
9784
9785**Since**: 12
9786
9787**Parameters**
9788
9789| Name| Description|
9790| -------- | -------- |
9791| option | Keyframe animation parameters. |
9792
9793**Returns**
9794
9795Returns the overall delay.
9796
9797
9798### OH_ArkUI_KeyframeAnimateOption_GetDuration()
9799
9800```
9801int32_t OH_ArkUI_KeyframeAnimateOption_GetDuration (ArkUI_KeyframeAnimateOption * option, int32_t index )
9802```
9803**Description**
9804
9805Obtains the duration of a specific state in a keyframe animation.
9806
9807**Since**: 12
9808
9809**Parameters**
9810
9811| Name| Description|
9812| -------- | -------- |
9813| option | Keyframe animation parameters. |
9814| index | Status index. |
9815
9816**Returns**
9817
9818Duration, in milliseconds.
9819
9820
9821### OH_ArkUI_KeyframeAnimateOption_GetIterations()
9822
9823```
9824int32_t OH_ArkUI_KeyframeAnimateOption_GetIterations (ArkUI_KeyframeAnimateOption * option)
9825```
9826**Description**
9827
9828Obtains the number of times that a keyframe animation is played.
9829
9830**Since**: 12
9831
9832**Parameters**
9833
9834| Name| Description|
9835| -------- | -------- |
9836| option | Keyframe animation parameters. |
9837
9838**Returns**
9839
9840Number of times that the animation is played.
9841
9842
9843### OH_ArkUI_KeyframeAnimateOption_RegisterOnEventCallback()
9844
9845```
9846int32_t OH_ArkUI_KeyframeAnimateOption_RegisterOnEventCallback (ArkUI_KeyframeAnimateOption * option, void * userData, void(*)(void *userData) event, int32_t index )
9847```
9848**Description**
9849
9850Sets the closure function of the state at the time of the keyframe, that is, the state to be reached at the time of the keyframe.
9851
9852**Parameters**
9853
9854| Name| Description|
9855| -------- | -------- |
9856| option | Keyframe animation parameters. |
9857| event | Closure function. |
9858| userData | Pointer to a custom object. |
9859| index | Status index. |
9860
9861**Returns**
9862
9863Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9864
9865
9866### OH_ArkUI_KeyframeAnimateOption_RegisterOnFinishCallback()
9867
9868```
9869int32_t OH_ArkUI_KeyframeAnimateOption_RegisterOnFinishCallback (ArkUI_KeyframeAnimateOption * option, void * userData, void(*)(void *userData) onFinish )
9870```
9871**Description**
9872
9873Sets the callback invoked when the keyframe animation playback is complete. This API is called after the keyframe animation has played for the specified number of times.
9874
9875**Parameters**
9876
9877| Name| Description|
9878| -------- | -------- |
9879| option | Keyframe animation parameters. |
9880| userData | Pointer to a custom object. |
9881| onFinish | Callback used to return the result. |
9882
9883**Returns**
9884
9885Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9886
9887
9888### OH_ArkUI_KeyframeAnimateOption_SetCurve()
9889
9890```
9891int32_t OH_ArkUI_KeyframeAnimateOption_SetCurve (ArkUI_KeyframeAnimateOption * option, ArkUI_CurveHandle value, int32_t index )
9892```
9893**Description**
9894
9895Sets the animation curve for a specific keyframe in a keyframe animation.
9896
9897**Parameters**
9898
9899| Name| Description|
9900| -------- | -------- |
9901| option | Keyframe animation parameters. |
9902| value | Animation curve used by the key frame. Default value: **EASE_IN_OUT**. |
9903| index | Status index. |
9904
9905**NOTE**
9906
9907Because the **springMotion**, **responsiveSpringMotion**, and **interpolatingSpring** curves do not have effective duration settings, they are not supported.
9908
9909**Returns**
9910
9911Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9912
9913
9914### OH_ArkUI_KeyframeAnimateOption_SetDelay()
9915
9916```
9917int32_t OH_ArkUI_KeyframeAnimateOption_SetDelay (ArkUI_KeyframeAnimateOption * option, int32_t value )
9918```
9919**Description**
9920
9921Sets the overall delay of a keyframe animation, in milliseconds. By default, the keyframe animation is played without delay.
9922
9923**Parameters**
9924
9925| Name| Description|
9926| -------- | -------- |
9927| option | Keyframe animation parameters. |
9928| value | Delay time, in milliseconds. |
9929
9930**Returns**
9931
9932Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9933
9934
9935### OH_ArkUI_KeyframeAnimateOption_SetDuration()
9936
9937```
9938int32_t OH_ArkUI_KeyframeAnimateOption_SetDuration (ArkUI_KeyframeAnimateOption * option, int32_t value, int32_t index )
9939```
9940**Description**
9941
9942Sets the duration of a keyframe animation, in milliseconds.
9943
9944**Parameters**
9945
9946| Name| Description|
9947| -------- | -------- |
9948| option | Keyframe animation parameters. |
9949| value | Duration, in milliseconds. |
9950| index | Status index. |
9951
9952**Returns**
9953
9954Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9955
9956
9957### OH_ArkUI_KeyframeAnimateOption_SetIterations()
9958
9959```
9960int32_t OH_ArkUI_KeyframeAnimateOption_SetIterations (ArkUI_KeyframeAnimateOption * option, int32_t value )
9961```
9962**Description**
9963
9964Sets the number of times that the keyframe animation is played. By default, the animation is played once. The value **-1** indicates that the animation is played for an unlimited number of times. The value **0** indicates that there is no animation.
9965
9966**Parameters**
9967
9968| Name| Description|
9969| -------- | -------- |
9970| option | Keyframe animation parameters. |
9971| value | Number of times that the animation is played. |
9972
9973**Returns**
9974
9975Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9976
9977
9978### OH_ArkUI_LayoutConstraint_Copy()
9979
9980```
9981ArkUI_LayoutConstraint* OH_ArkUI_LayoutConstraint_Copy (const ArkUI_LayoutConstraint * Constraint)
9982```
9983**Description**
9984
9985Constraint size deep copy.
9986
9987**Since**: 12
9988
9989**Parameters**
9990
9991| Name| Description|
9992| -------- | -------- |
9993| Constraint | Size constraint. |
9994
9995**Returns**
9996
9997Pointer to the new constraint size.
9998
9999
10000### OH_ArkUI_LayoutConstraint_Create()
10001
10002```
10003ArkUI_LayoutConstraint* OH_ArkUI_LayoutConstraint_Create ()
10004```
10005**Description**
10006
10007Create a constraint size.
10008
10009**Since**: 12
10010
10011
10012### OH_ArkUI_LayoutConstraint_Dispose()
10013
10014```
10015void* OH_ArkUI_LayoutConstraint_Dispose (ArkUI_LayoutConstraint * Constraint)
10016```
10017**Description**
10018
10019Pointer to the size of the destruction constraint.
10020
10021**Since**: 12
10022
10023**Parameters**
10024
10025| Name| Description|
10026| -------- | -------- |
10027| Constraint | Size constraint. |
10028
10029
10030### OH_ArkUI_LayoutConstraint_GetMaxHeight()
10031
10032```
10033int32_t OH_ArkUI_LayoutConstraint_GetMaxHeight (const ArkUI_LayoutConstraint * Constraint)
10034```
10035**Description**
10036
10037Obtains the maximum height for a size constraint, in px.
10038
10039**Since**: 12
10040
10041**Parameters**
10042
10043| Name| Description|
10044| -------- | -------- |
10045| Constraint | Size constraint. |
10046
10047**Returns**
10048
10049Maximum height.
10050
10051
10052### OH_ArkUI_LayoutConstraint_GetMaxWidth()
10053
10054```
10055int32_t OH_ArkUI_LayoutConstraint_GetMaxWidth (const ArkUI_LayoutConstraint * Constraint)
10056```
10057**Description**
10058
10059Obtains the maximum width for a size constraint, in px.
10060
10061**Since**: 12
10062
10063**Parameters**
10064
10065| Name| Description|
10066| -------- | -------- |
10067| Constraint | Size constraint. |
10068
10069**Returns**
10070
10071Maximum width.
10072
10073
10074### OH_ArkUI_LayoutConstraint_GetMinHeight()
10075
10076```
10077int32_t OH_ArkUI_LayoutConstraint_GetMinHeight (const ArkUI_LayoutConstraint * Constraint)
10078```
10079**Description**
10080
10081Obtains the minimum height for a size constraint, in px.
10082
10083**Since**: 12
10084
10085**Parameters**
10086
10087| Name| Description|
10088| -------- | -------- |
10089| Constraint | Size constraint. |
10090
10091**Returns**
10092
10093Minimum Height
10094
10095
10096### OH_ArkUI_LayoutConstraint_GetMinWidth()
10097
10098```
10099int32_t OH_ArkUI_LayoutConstraint_GetMinWidth (const ArkUI_LayoutConstraint * Constraint)
10100```
10101**Description**
10102
10103Obtains the minimum width for a size constraint, in px.
10104
10105**Since**: 12
10106
10107**Parameters**
10108
10109| Name| Description|
10110| -------- | -------- |
10111| Constraint | Size constraint. |
10112
10113**Returns**
10114
10115Minimum Width
10116
10117
10118### OH_ArkUI_LayoutConstraint_GetPercentReferenceHeight()
10119
10120```
10121int32_t OH_ArkUI_LayoutConstraint_GetPercentReferenceHeight (const ArkUI_LayoutConstraint * Constraint)
10122```
10123**Description**
10124
10125Obtains the height percentage reference for a size constraint, in px.
10126
10127**Since**: 12
10128
10129**Parameters**
10130
10131| Name| Description|
10132| -------- | -------- |
10133| Constraint | Size constraint. |
10134
10135**Returns**
10136
10137Height percentage benchmark.
10138
10139
10140### OH_ArkUI_LayoutConstraint_GetPercentReferenceWidth()
10141
10142```
10143int32_t OH_ArkUI_LayoutConstraint_GetPercentReferenceWidth (const ArkUI_LayoutConstraint * Constraint)
10144```
10145**Description**
10146
10147Obtains the width percentage reference for a size constraint, in px.
10148
10149**Since**: 12
10150
10151**Parameters**
10152
10153| Name| Description|
10154| -------- | -------- |
10155| Constraint | Size constraint. |
10156
10157**Returns**
10158
10159Width percentage reference.
10160
10161
10162### OH_ArkUI_LayoutConstraint_SetMaxHeight()
10163
10164```
10165void OH_ArkUI_LayoutConstraint_SetMaxHeight (ArkUI_LayoutConstraint * Constraint, int32_t value )
10166```
10167**Description**
10168
10169Sets the maximum height.
10170
10171**Since**: 12
10172
10173**Parameters**
10174
10175| Name| Description|
10176| -------- | -------- |
10177| Constraint | Size constraint. |
10178| value | Maximum height, in pixels. |
10179
10180
10181### OH_ArkUI_LayoutConstraint_SetMaxWidth()
10182
10183```
10184void OH_ArkUI_LayoutConstraint_SetMaxWidth (ArkUI_LayoutConstraint * Constraint, int32_t value )
10185```
10186**Description**
10187
10188Sets the maximum width.
10189
10190**Since**: 12
10191
10192**Parameters**
10193
10194| Name| Description|
10195| -------- | -------- |
10196| Constraint | Size constraint. |
10197| value | Maximum width, in pixels. |
10198
10199
10200### OH_ArkUI_LayoutConstraint_SetMinHeight()
10201
10202```
10203void OH_ArkUI_LayoutConstraint_SetMinHeight (ArkUI_LayoutConstraint * Constraint, int32_t value )
10204```
10205**Description**
10206
10207Sets the minimum height.
10208
10209**Since**: 12
10210
10211**Parameters**
10212
10213| Name| Description|
10214| -------- | -------- |
10215| Constraint | Size constraint. |
10216| value | Minimum height, in pixels. |
10217
10218
10219### OH_ArkUI_LayoutConstraint_SetMinWidth()
10220
10221```
10222void OH_ArkUI_LayoutConstraint_SetMinWidth (ArkUI_LayoutConstraint * Constraint, int32_t value )
10223```
10224**Description**
10225
10226Sets the minimum width.
10227
10228**Since**: 12
10229
10230**Parameters**
10231
10232| Name| Description|
10233| -------- | -------- |
10234| Constraint | Size constraint. |
10235| value | Minimum width, in pixels. |
10236
10237
10238### OH_ArkUI_LayoutConstraint_SetPercentReferenceHeight()
10239
10240```
10241void OH_ArkUI_LayoutConstraint_SetPercentReferenceHeight (ArkUI_LayoutConstraint * Constraint, int32_t value )
10242```
10243**Description**
10244
10245Sets the height percentage reference.
10246
10247**Since**: 12
10248
10249**Parameters**
10250
10251| Name| Description|
10252| -------- | -------- |
10253| Constraint | Size constraint. |
10254| value | Height percentage base, in px. |
10255
10256
10257### OH_ArkUI_LayoutConstraint_SetPercentReferenceWidth()
10258
10259```
10260void OH_ArkUI_LayoutConstraint_SetPercentReferenceWidth (ArkUI_LayoutConstraint * Constraint, int32_t value )
10261```
10262**Description**
10263
10264Sets the width percentage reference.
10265
10266**Since**: 12
10267
10268**Parameters**
10269
10270| Name| Description|
10271| -------- | -------- |
10272| Constraint | Size constraint. |
10273| value | Width percentage benchmark, in px. |
10274
10275
10276### OH_ArkUI_List_CloseAllSwipeActions()
10277
10278```
10279int32_t OH_ArkUI_List_CloseAllSwipeActions (ArkUI_NodeHandle node, void * userData, void(*)(void *userData) onFinish )
10280```
10281**Description**
10282
10283Collapse the expanded ListItem.
10284
10285**Since**: 12
10286
10287**Parameters**
10288
10289| Name| Description|
10290| -------- | -------- |
10291| node | Node object for which an event needs to be registered. |
10292| userData | Custom event parameter, which is passed in the callback when the event is triggered. |
10293| onFinish | Callback triggered after the collapse animation is complete. |
10294
10295**Returns**
10296
10297Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs. Returns **ARKUI_ERROR_CODE_ATTRIBUTE_OR_EVENT_NOT_SUPPORTED** if the event is not supported.
10298
10299
10300### OH_ArkUI_ListChildrenMainSizeOption_Create()
10301
10302```
10303ArkUI_ListChildrenMainSize* OH_ArkUI_ListChildrenMainSizeOption_Create ()
10304```
10305**Description**
10306
10307Creates a **ListChildrenMainSize** instance.
10308
10309**Since**: 12
10310
10311**Returns**
10312
10313Returns the created **ListChildrenMainSize** instance.
10314
10315
10316### OH_ArkUI_ListChildrenMainSizeOption_Dispose()
10317
10318```
10319void OH_ArkUI_ListChildrenMainSizeOption_Dispose (ArkUI_ListChildrenMainSize * option)
10320```
10321**Description**
10322
10323Destroys a ListChildrenMainSize instance.
10324
10325**Since**: 12
10326
10327**Parameters**
10328
10329| Name| Description|
10330| -------- | -------- |
10331| option | ListChildrenMainSize instance to be destroyed. |
10332
10333
10334### OH_ArkUI_ListChildrenMainSizeOption_GetDefaultMainSize()
10335
10336```
10337float OH_ArkUI_ListChildrenMainSizeOption_GetDefaultMainSize (ArkUI_ListChildrenMainSize * option)
10338```
10339**Description**
10340
10341Obtains the default size in a **ListChildrenMainSize** instance.
10342
10343**Since**: 12
10344
10345**Parameters**
10346
10347| Name| Description|
10348| -------- | -------- |
10349| option | **ListChildrenMainSize** instance. |
10350
10351**Returns**
10352
10353Returns the default size, in vp. The default value is **0**. If **option** is a null pointer, **-1** is returned.
10354
10355
10356### OH_ArkUI_ListChildrenMainSizeOption_GetMainSize()
10357
10358```
10359float OH_ArkUI_ListChildrenMainSizeOption_GetMainSize (ArkUI_ListChildrenMainSize * option, int32_t index )
10360```
10361**Description**
10362
10363Obtains the value of the ChildrenMainSizeOption array of the List component.
10364
10365**Since**: 12
10366
10367**Parameters**
10368
10369| Name| Description|
10370| -------- | -------- |
10371| option | **ListChildrenMainSize** instance. |
10372| index | Subscript position of the value to be obtained. |
10373
10374**Returns**
10375
10376Value of the specific position of the array. If a parameter error occurs, **-1** is returned.
10377
10378
10379### OH_ArkUI_ListChildrenMainSizeOption_Resize()
10380
10381```
10382void OH_ArkUI_ListChildrenMainSizeOption_Resize (ArkUI_ListChildrenMainSize * option, int32_t totalSize )
10383```
10384**Description**
10385
10386Resets the array size of ChildrenMainSizeOption of the List component.
10387
10388**Since**: 12
10389
10390**Parameters**
10391
10392| Name| Description|
10393| -------- | -------- |
10394| option | **ListChildrenMainSize** instance. |
10395| totalSize | Array size. |
10396
10397
10398### OH_ArkUI_ListChildrenMainSizeOption_SetDefaultMainSize()
10399
10400```
10401int32_t OH_ArkUI_ListChildrenMainSizeOption_SetDefaultMainSize (ArkUI_ListChildrenMainSize * option, float defaultMainSize )
10402```
10403**Description**
10404
10405Sets the default size in a **ListChildrenMainSize** instance.
10406
10407**Since**: 12
10408
10409**Parameters**
10410
10411| Name| Description|
10412| -------- | -------- |
10413| option | **ListChildrenMainSize** instance. |
10414| defaultMainSize | Default size of a list item in a list. The unit is vp. |
10415
10416**Returns**
10417
10418Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
10419
10420
10421### OH_ArkUI_ListChildrenMainSizeOption_Splice()
10422
10423```
10424int32_t OH_ArkUI_ListChildrenMainSizeOption_Splice (ArkUI_ListChildrenMainSize * option, int32_t index, int32_t deleteCount, int32_t addCount )
10425```
10426**Description**
10427
10428The size of the ChildrenMainSizeOption array of the List component is adjusted.
10429
10430**Since**: 12
10431
10432**Parameters**
10433
10434| Name| Description|
10435| -------- | -------- |
10436| option | **ListChildrenMainSize** instance. |
10437| index | Start position of the array whose MainSize is to be modified. |
10438| deleteCount | Number of MainSize arrays to be deleted starting from index. |
10439| addCount | Number of MainSize arrays to be added starting from index. |
10440
10441**Returns**
10442
10443Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
10444
10445
10446### OH_ArkUI_ListChildrenMainSizeOption_UpdateSize()
10447
10448```
10449int32_t OH_ArkUI_ListChildrenMainSizeOption_UpdateSize (ArkUI_ListChildrenMainSize * option, int32_t index, float mainSize )
10450```
10451**Description**
10452
10453Updates the values in a **ChildrenMainSizeOption** array of a List component.
10454
10455**Since**: 12
10456
10457**Parameters**
10458
10459| Name| Description|
10460| -------- | -------- |
10461| option | **ListChildrenMainSize** instance. |
10462| index | Index at which to start changing the values in the array. |
10463| mainSize | New size value to set at the specified index. |
10464
10465**Returns**
10466
10467Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
10468
10469
10470### OH_ArkUI_ListItemSwipeActionItem_Create()
10471
10472```
10473ArkUI_ListItemSwipeActionItem* OH_ArkUI_ListItemSwipeActionItem_Create ()
10474```
10475**Description**
10476
10477Creates a **ListItemSwipeActionItem** instance.
10478
10479**Since**: 12
10480
10481**Returns**
10482
10483Returns the created **ListItemSwipeActionItem** instance.
10484
10485
10486### OH_ArkUI_ListItemSwipeActionItem_Dispose()
10487
10488```
10489void OH_ArkUI_ListItemSwipeActionItem_Dispose (ArkUI_ListItemSwipeActionItem * item)
10490```
10491**Description**
10492
10493Disposes of a **ListItemSwipeActionItem** instance.
10494
10495**Since**: 12
10496
10497**Parameters**
10498
10499| Name| Description|
10500| -------- | -------- |
10501| item | **ListItemSwipeActionItem** instance to dispose of. |
10502
10503
10504### OH_ArkUI_ListItemSwipeActionItem_GetActionAreaDistance()
10505
10506```
10507float OH_ArkUI_ListItemSwipeActionItem_GetActionAreaDistance (ArkUI_ListItemSwipeActionItem * item)
10508```
10509**Description**
10510
10511Obtains the swipe distance threshold for deleting the list item.
10512
10513**Since**: 12
10514
10515**Parameters**
10516
10517| Name| Description|
10518| -------- | -------- |
10519| item | Target **ListItemSwipeActionItem** instance. |
10520
10521**Returns**
10522
10523Returns the swipe distance threshold for deleting the list item. Return **0** if an error occurs.
10524
10525
10526### OH_ArkUI_ListItemSwipeActionItem_SetActionAreaDistance()
10527
10528```
10529void OH_ArkUI_ListItemSwipeActionItem_SetActionAreaDistance (ArkUI_ListItemSwipeActionItem * item, float distance )
10530```
10531**Description**
10532
10533Swipe distance threshold for deleting the list item.
10534
10535**Since**: 12
10536
10537**Parameters**
10538
10539| Name| Description|
10540| -------- | -------- |
10541| item | Target **ListItemSwipeActionItem** instance. |
10542| distance | Returns the swipe distance threshold for deleting the list item. |
10543
10544
10545### OH_ArkUI_ListItemSwipeActionItem_SetContent()
10546
10547```
10548void OH_ArkUI_ListItemSwipeActionItem_SetContent (ArkUI_ListItemSwipeActionItem * item, ArkUI_NodeHandle node )
10549```
10550**Description**
10551
10552Sets the layout content of ListItemSwipeActionItem.
10553
10554**Since**: 12
10555
10556**Parameters**
10557
10558| Name| Description|
10559| -------- | -------- |
10560| item | Target **ListItemSwipeActionItem** instance. |
10561| node | Layout information |
10562
10563
10564### OH_ArkUI_ListItemSwipeActionItem_SetOnAction()
10565
10566```
10567void OH_ArkUI_ListItemSwipeActionItem_SetOnAction (ArkUI_ListItemSwipeActionItem * item, void(*)() callback )
10568```
10569**Description**
10570
10571Sets the callback invoked when the list item is deleted while in the delete area.
10572
10573**Since**: 12
10574
10575**Parameters**
10576
10577| Name| Description|
10578| -------- | -------- |
10579| item | Target **ListItemSwipeActionItem** instance. |
10580| callback | Callback to invoke when an event of the specified type occurs. |
10581
10582
10583### OH_ArkUI_ListItemSwipeActionItem_SetOnActionWithUserData()
10584
10585```
10586void OH_ArkUI_ListItemSwipeActionItem_SetOnActionWithUserData (ArkUI_ListItemSwipeActionItem * item, void * userData, void(*)(void *userData) callback )
10587```
10588**Description**
10589
10590Sets the callback invoked when the list item is deleted while in the delete area.
10591
10592**Since**: 12
10593
10594**Parameters**
10595
10596| Name| Description|
10597| -------- | -------- |
10598| item | Target **ListItemSwipeActionItem** instance. |
10599| userData | Custom data. |
10600| callback | Callback to invoke when an event of the specified type occurs. |
10601
10602
10603### OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionArea()
10604
10605```
10606void OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionArea (ArkUI_ListItemSwipeActionItem * item, void(*)() callback )
10607```
10608**Description**
10609
10610Sets the callback invoked each time the list item enters the delete area.
10611
10612**Since**: 12
10613
10614**Parameters**
10615
10616| Name| Description|
10617| -------- | -------- |
10618| item | Target **ListItemSwipeActionItem** instance. |
10619| callback | Callback to invoke when an event of the specified type occurs. |
10620
10621
10622### OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionAreaWithUserData()
10623
10624```
10625void OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionAreaWithUserData (ArkUI_ListItemSwipeActionItem * item, void * userData, void(*)(void *userData) callback )
10626```
10627**Description**
10628
10629Sets the callback invoked each time the list item enters the delete area.
10630
10631**Since**: 12
10632
10633**Parameters**
10634
10635| Name| Description|
10636| -------- | -------- |
10637| item | Target **ListItemSwipeActionItem** instance. |
10638| userData | Custom data. |
10639| callback | Callback to invoke when an event of the specified type occurs. |
10640
10641
10642### OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionArea()
10643
10644```
10645void OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionArea (ArkUI_ListItemSwipeActionItem * item, void(*)() callback )
10646```
10647**Description**
10648
10649Sets the callback invoked each time the list item exits the delete area.
10650
10651**Since**: 12
10652
10653**Parameters**
10654
10655| Name| Description|
10656| -------- | -------- |
10657| item | Target **ListItemSwipeActionItem** instance. |
10658| callback | Callback to invoke when an event of the specified type occurs. |
10659
10660
10661### OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionAreaWithUserData()
10662
10663```
10664void OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionAreaWithUserData (ArkUI_ListItemSwipeActionItem * item, void * userData, void(*)(void *userData) callback )
10665```
10666**Description**
10667
10668Sets the callback invoked each time the list item exits the delete area.
10669
10670**Since**: 12
10671
10672**Parameters**
10673
10674| Name| Description|
10675| -------- | -------- |
10676| item | Target **ListItemSwipeActionItem** instance. |
10677| userData | Custom data. |
10678| callback | Callback to invoke when an event of the specified type occurs. |
10679
10680### OH_ArkUI_ListItemSwipeActionItem_SetOnStateChange()
10681
10682```
10683void OH_ArkUI_ListItemSwipeActionItem_SetOnStateChange (ArkUI_ListItemSwipeActionItem * item, void(*)(ArkUI_ListItemSwipeActionState swipeActionState) callback )
10684```
10685**Description**
10686
10687Sets the callback invoked when the swipe state of the list item changes.
10688
10689**Since**: 12
10690
10691**Parameters**
10692
10693| Name| Description|
10694| -------- | -------- |
10695| item | Target **ListItemSwipeActionItem** instance. |
10696| callback | Status after the callback event swipeActionState changes. |
10697
10698
10699### OH_ArkUI_ListItemSwipeActionItem_SetOnStateChangeWithUserData()
10700
10701```
10702void OH_ArkUI_ListItemSwipeActionItem_SetOnStateChangeWithUserData (ArkUI_ListItemSwipeActionItem * item, void * userData, void(*)(ArkUI_ListItemSwipeActionState swipeActionState, void *userData) callback )
10703```
10704**Description**
10705
10706Sets the callback invoked when the swipe state of the list item changes.
10707
10708**Since**: 12
10709
10710**Parameters**
10711
10712| Name| Description|
10713| -------- | -------- |
10714| item | Target **ListItemSwipeActionItem** instance. |
10715| userData | Custom data. |
10716| callback | Status after the callback event swipeActionState changes. |
10717
10718
10719### OH_ArkUI_ListItemSwipeActionOption_Create()
10720
10721```
10722ArkUI_ListItemSwipeActionOption* OH_ArkUI_ListItemSwipeActionOption_Create ()
10723```
10724**Description**
10725
10726Creates a **ListItemSwipeActionOption** instance.
10727
10728**Since**: 12
10729
10730**Returns**
10731
10732ListItemSwipeActionOption configuration item instance.
10733
10734
10735### OH_ArkUI_ListItemSwipeActionOption_Dispose()
10736
10737```
10738void OH_ArkUI_ListItemSwipeActionOption_Dispose (ArkUI_ListItemSwipeActionOption * option)
10739```
10740**Description**
10741
10742Destroys a ListItemSwipeActionOption instance.
10743
10744**Since**: 12
10745
10746**Parameters**
10747
10748| Name| Description|
10749| -------- | -------- |
10750| option | ListItemSwipeActionOption instance to destroy. |
10751
10752
10753### OH_ArkUI_ListItemSwipeActionOption_GetEdgeEffect()
10754
10755```
10756int32_t OH_ArkUI_ListItemSwipeActionOption_GetEdgeEffect (ArkUI_ListItemSwipeActionOption * option)
10757```
10758**Description**
10759
10760Obtains the sliding effect.
10761
10762**Since**: 12
10763
10764**Parameters**
10765
10766| Name| Description|
10767| -------- | -------- |
10768| option | Target **ListItemSwipeActionItem** instance. |
10769
10770**Returns**
10771
10772Scroll effect. The default return value is **ARKUI_LIST_ITEM_SWIPE_EDGE_EFFECT_SPRING**.
10773
10774
10775### OH_ArkUI_ListItemSwipeActionOption_SetEdgeEffect()
10776
10777```
10778void OH_ArkUI_ListItemSwipeActionOption_SetEdgeEffect (ArkUI_ListItemSwipeActionOption * option, ArkUI_ListItemSwipeEdgeEffect edgeEffect )
10779```
10780**Description**
10781
10782Sets the sliding effect.
10783
10784**Since**: 12
10785
10786**Parameters**
10787
10788| Name| Description|
10789| -------- | -------- |
10790| option | Target **ListItemSwipeActionItem** instance. |
10791| edgeEffect | Scroll effect. |
10792
10793
10794### OH_ArkUI_ListItemSwipeActionOption_SetEnd()
10795
10796```
10797void OH_ArkUI_ListItemSwipeActionOption_SetEnd (ArkUI_ListItemSwipeActionOption * option, ArkUI_ListItemSwipeActionItem * item )
10798```
10799**Description**
10800
10801Sets the layout content for the right edge (for a vertical layout) or bottom edge (for a horizontal layout) of a **ListItemSwipeActionItem** instance.
10802
10803**Since**: 12
10804
10805**Parameters**
10806
10807| Name| Description|
10808| -------- | -------- |
10809| option | Target **ListItemSwipeActionItem** instance. |
10810| builder | Layout information |
10811
10812
10813### OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChange()
10814
10815```
10816void OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChange (ArkUI_ListItemSwipeActionOption * option, void(*)(float offset) callback )
10817```
10818**Description**
10819
10820Sets the callback invoked when the scroll offset changes.
10821
10822**Since**: 12
10823
10824**Parameters**
10825
10826| Name| Description|
10827| -------- | -------- |
10828| option | Target **ListItemSwipeActionItem** instance. |
10829| callback | Sliding offset of the callback event offset. |
10830
10831
10832### OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChangeWithUserData()
10833
10834```
10835void OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChangeWithUserData (ArkUI_ListItemSwipeActionOption * option, void * userData, void(*)(float offset, void *userData) callback )
10836```
10837**Description**
10838
10839Sets the callback invoked when the scroll offset changes.
10840
10841**Since**: 12
10842
10843**Parameters**
10844
10845| Name| Description|
10846| -------- | -------- |
10847| option | Target **ListItemSwipeActionItem** instance. |
10848| userData | Custom data. |
10849| callback | Sliding offset of the callback event offset. |
10850
10851
10852### OH_ArkUI_ListItemSwipeActionOption_SetStart()
10853
10854```
10855void OH_ArkUI_ListItemSwipeActionOption_SetStart (ArkUI_ListItemSwipeActionOption * option, ArkUI_ListItemSwipeActionItem * item )
10856```
10857**Description**
10858
10859Sets the layout content for the left edge (for a vertical layout) or top edge (for a horizontal layout) of a **ListItemSwipeActionItem** instance.
10860
10861**Since**: 12
10862
10863**Parameters**
10864
10865| Name| Description|
10866| -------- | -------- |
10867| option | Target **ListItemSwipeActionItem** instance. |
10868| builder | Layout information |
10869
10870
10871### OH_ArkUI_LongPress_GetRepeatCount()
10872
10873```
10874int32_t OH_ArkUI_LongPress_GetRepeatCount (const ArkUI_GestureEvent * event)
10875```
10876**Description**
10877
10878Obtains the number of times that a long press gesture is triggered periodically.
10879
10880**Since**: 12
10881
10882**Parameters**
10883
10884| Name| Description|
10885| -------- | -------- |
10886| event | Gesture event. |
10887
10888**Returns**
10889
10890Returns the number of times that the long press gesture is triggered periodically.
10891
10892
10893### OH_ArkUI_MarshallStyledStringDescriptor()
10894
10895```
10896int32_t OH_ArkUI_MarshallStyledStringDescriptor (uint8_t * buffer, size_t * bufferSize, ArkUI_StyledString_Descriptor * descriptor )
10897```
10898**Description**
10899
10900Serializes the styled string information into a byte array.
10901
10902**Since**: 14
10903
10904**Parameters**
10905
10906| Name| Description|
10907| -------- | -------- |
10908| buffer | Byte array where the serialized data will be stored. |
10909| bufferSize | Length of the byte array. |
10910| descriptor | Pointer to an **ArkUI_StyledString_Descriptor** object. |
10911
10912**Returns**
10913
10914Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs. Returns **ARKUI_ERROR_CODE_INVALID_STYLED_STRING** if the styled string is invalid.
10915
10916
10917### OH_ArkUI_NodeAdapter_Create()
10918
10919```
10920ArkUI_NodeAdapterHandle OH_ArkUI_NodeAdapter_Create ()
10921```
10922**Description**
10923
10924Creates a component adapter.
10925
10926**Since**: 12
10927
10928
10929### OH_ArkUI_NodeAdapter_Dispose()
10930
10931```
10932void OH_ArkUI_NodeAdapter_Dispose (ArkUI_NodeAdapterHandle handle)
10933```
10934**Description**
10935
10936Destroys a component adapter.
10937
10938**Since**: 12
10939
10940**Parameters**
10941
10942| Name| Description|
10943| -------- | -------- |
10944| handle | Component adapter object. |
10945
10946
10947### OH_ArkUI_NodeAdapter_GetAllItems()
10948
10949```
10950int32_t OH_ArkUI_NodeAdapter_GetAllItems (ArkUI_NodeAdapterHandle handle, ArkUI_NodeHandle ** items, uint32_t * size )
10951```
10952**Description**
10953
10954Obtains all elements stored in the specified adapter.
10955
10956When the API is called, the array object pointer of the element is returned. The memory data pointed by the pointer needs to be manually released by developers.
10957
10958**Since**: 12
10959
10960**Parameters**
10961
10962| Name| Description|
10963| -------- | -------- |
10964| handle | Component adapter object. |
10965| items | Array of nodes in the adapter. |
10966| size | Number of elements. |
10967
10968**Returns**
10969
10970Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
10971
10972
10973### OH_ArkUI_NodeAdapter_GetTotalNodeCount()
10974
10975```
10976uint32_t OH_ArkUI_NodeAdapter_GetTotalNodeCount (ArkUI_NodeAdapterHandle handle)
10977```
10978**Description**
10979
10980Obtains the total number of elements in the Adapter.
10981
10982**Since**: 12
10983
10984**Parameters**
10985
10986| Name| Description|
10987| -------- | -------- |
10988| handle | Component adapter object. |
10989
10990**Returns**
10991
10992Total number of elements in the Adapter.
10993
10994
10995### OH_ArkUI_NodeAdapter_InsertItem()
10996
10997```
10998int32_t OH_ArkUI_NodeAdapter_InsertItem (ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount )
10999```
11000**Description**
11001
11002Instructs the specified adapter to insert certain elements.
11003
11004**Since**: 12
11005
11006**Parameters**
11007
11008| Name| Description|
11009| -------- | -------- |
11010| handle | Component adapter object. |
11011| startPosition | Start position for inserting an element. |
11012| itemCount | Number of inserted elements. |
11013
11014**Returns**
11015
11016Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
11017
11018
11019### OH_ArkUI_NodeAdapter_MoveItem()
11020
11021```
11022int32_t OH_ArkUI_NodeAdapter_MoveItem (ArkUI_NodeAdapterHandle handle, uint32_t from, uint32_t to )
11023```
11024**Description**
11025
11026Instructs the specified adapter to move certain elements.
11027
11028**Since**: 12
11029
11030**Parameters**
11031
11032| Name| Description|
11033| -------- | -------- |
11034| handle | Component adapter object. |
11035| from | Start position of the element shift. |
11036| to | End position of the element shift. |
11037
11038**Returns**
11039
11040Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
11041
11042
11043### OH_ArkUI_NodeAdapter_RegisterEventReceiver()
11044
11045```
11046int32_t OH_ArkUI_NodeAdapter_RegisterEventReceiver (ArkUI_NodeAdapterHandle handle, void * userData, void(*)(ArkUI_NodeAdapterEvent *event) receiver )
11047```
11048**Description**
11049
11050Registers callback events related to the Adapter.
11051
11052**Since**: 12
11053
11054**Parameters**
11055
11056| Name| Description|
11057| -------- | -------- |
11058| handle | Component adapter object. |
11059| userData | Custom data. |
11060| receiver | Event receiving callback. |
11061
11062**Returns**
11063
11064Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
11065
11066
11067### OH_ArkUI_NodeAdapter_ReloadAllItems()
11068
11069```
11070int32_t OH_ArkUI_NodeAdapter_ReloadAllItems (ArkUI_NodeAdapterHandle handle)
11071```
11072**Description**
11073
11074Instructs the specified adapter to reload all elements.
11075
11076**Since**: 12
11077
11078**Parameters**
11079
11080| Name| Description|
11081| -------- | -------- |
11082| handle | Component adapter object. |
11083
11084**Returns**
11085
11086Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
11087
11088
11089### OH_ArkUI_NodeAdapter_ReloadItem()
11090
11091```
11092int32_t OH_ArkUI_NodeAdapter_ReloadItem (ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount )
11093```
11094**Description**
11095
11096Instructs the specified adapter to reload certain elements.
11097
11098**Since**: 12
11099
11100**Parameters**
11101
11102| Name| Description|
11103| -------- | -------- |
11104| handle | Component adapter object. |
11105| startPosition | Start position of an element change. |
11106| itemCount | Number of changed elements. |
11107
11108**Returns**
11109
11110Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
11111
11112
11113### OH_ArkUI_NodeAdapter_RemoveItem()
11114
11115```
11116int32_t OH_ArkUI_NodeAdapter_RemoveItem (ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount )
11117```
11118**Description**
11119
11120Instructs the specified adapter to remove certain elements.
11121
11122**Since**: 12
11123
11124**Parameters**
11125
11126| Name| Description|
11127| -------- | -------- |
11128| handle | Component adapter object. |
11129| startPosition | Start position for deleting an element. |
11130| itemCount | Number of deleted elements. |
11131
11132**Returns**
11133
11134Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
11135
11136
11137### OH_ArkUI_NodeAdapter_SetTotalNodeCount()
11138
11139```
11140int32_t OH_ArkUI_NodeAdapter_SetTotalNodeCount (ArkUI_NodeAdapterHandle handle, uint32_t size )
11141```
11142**Description**
11143
11144Sets the total number of elements in the specified adapter.
11145
11146**Since**: 12
11147
11148**Parameters**
11149
11150| Name| Description|
11151| -------- | -------- |
11152| handle | Component adapter object. |
11153| size | Number of elements. |
11154
11155**Returns**
11156
11157Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
11158
11159
11160### OH_ArkUI_NodeAdapter_UnregisterEventReceiver()
11161
11162```
11163void OH_ArkUI_NodeAdapter_UnregisterEventReceiver (ArkUI_NodeAdapterHandle handle)
11164```
11165**Description**
11166
11167Deregisters Adapter-related callback events.
11168
11169**Since**: 12
11170
11171**Parameters**
11172
11173| Name| Description|
11174| -------- | -------- |
11175| handle | Component adapter object. |
11176
11177
11178### OH_ArkUI_NodeAdapterEvent_GetHostNode()
11179
11180```
11181ArkUI_NodeHandle OH_ArkUI_NodeAdapterEvent_GetHostNode (ArkUI_NodeAdapterEvent * event)
11182```
11183**Description**
11184
11185Obtains the scrolling class container node that uses the adapter.
11186
11187**Since**: 12
11188
11189**Parameters**
11190
11191| Name| Description|
11192| -------- | -------- |
11193| event | Adapter event object. |
11194
11195**Returns**
11196
11197Returns the scrollable container node that uses the specified adapter.
11198
11199
11200### OH_ArkUI_NodeAdapterEvent_GetItemIndex()
11201
11202```
11203uint32_t OH_ArkUI_NodeAdapterEvent_GetItemIndex (ArkUI_NodeAdapterEvent * event)
11204```
11205**Description**
11206
11207Sequence number of the element to be operated when the adapter event is obtained.
11208
11209**Since**: 12
11210
11211**Parameters**
11212
11213| Name| Description|
11214| -------- | -------- |
11215| event | Adapter event object. |
11216
11217**Returns**
11218
11219Sequence number of an element.
11220
11221
11222### OH_ArkUI_NodeAdapterEvent_GetRemovedNode()
11223
11224```
11225ArkUI_NodeHandle OH_ArkUI_NodeAdapterEvent_GetRemovedNode (ArkUI_NodeAdapterEvent * event)
11226```
11227**Description**
11228
11229Obtains the element to be destroyed in the event to be destroyed.
11230
11231**Since**: 12
11232
11233**Parameters**
11234
11235| Name| Description|
11236| -------- | -------- |
11237| event | Adapter event object. |
11238
11239**Returns**
11240
11241Element to be destroyed.
11242
11243
11244### OH_ArkUI_NodeAdapterEvent_GetType()
11245
11246```
11247ArkUI_NodeAdapterEventType OH_ArkUI_NodeAdapterEvent_GetType (ArkUI_NodeAdapterEvent * event)
11248```
11249**Description**
11250
11251Obtains the event type.
11252
11253**Since**: 12
11254
11255**Parameters**
11256
11257| Name| Description|
11258| -------- | -------- |
11259| event | Adapter event object. |
11260
11261**Returns**
11262
11263Represents an event type.
11264
11265
11266### OH_ArkUI_NodeAdapterEvent_GetUserData()
11267
11268```
11269void* OH_ArkUI_NodeAdapterEvent_GetUserData (ArkUI_NodeAdapterEvent * event)
11270```
11271**Description**
11272
11273Obtains the custom data passed in during registration of the specified event.
11274
11275**Since**: 12
11276
11277**Parameters**
11278
11279| Name| Description|
11280| -------- | -------- |
11281| event | Adapter event object. |
11282
11283
11284### OH_ArkUI_NodeAdapterEvent_SetItem()
11285
11286```
11287int32_t OH_ArkUI_NodeAdapterEvent_SetItem (ArkUI_NodeAdapterEvent * event, ArkUI_NodeHandle node )
11288```
11289**Description**
11290
11291Sets the component to be added to the specified adapter.
11292
11293**Since**: 12
11294
11295**Parameters**
11296
11297| Name| Description|
11298| -------- | -------- |
11299| event | Adapter event object. |
11300| node | Component to be added. |
11301
11302**Returns**
11303
11304Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
11305
11306
11307### OH_ArkUI_NodeAdapterEvent_SetNodeId()
11308
11309```
11310int32_t OH_ArkUI_NodeAdapterEvent_SetNodeId (ArkUI_NodeAdapterEvent * event, int32_t id )
11311```
11312**Description**
11313
11314Sets the generated component ID.
11315
11316**Since**: 12
11317
11318**Parameters**
11319
11320| Name| Description|
11321| -------- | -------- |
11322| event | Adapter event object. |
11323| id | Sets the returned component ID. |
11324
11325**Returns**
11326
11327Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
11328
11329
11330### OH_ArkUI_NodeContent_AddNode()
11331
11332```
11333int32_t OH_ArkUI_NodeContent_AddNode (ArkUI_NodeContentHandle content, ArkUI_NodeHandle node )
11334```
11335**Description**
11336
11337Adds an ArkUI component node to the specified NodeContent object.
11338
11339**Since**: 12
11340
11341**Parameters**
11342
11343| Name| Description|
11344| -------- | -------- |
11345| content | NodeContent object to which a node is to be added. |
11346| node | Node to be added. |
11347
11348**Returns**
11349
11350Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
11351
11352
11353### OH_ArkUI_NodeContent_GetUserData()
11354
11355```
11356void* OH_ArkUI_NodeContent_GetUserData (ArkUI_NodeContentHandle content)
11357```
11358**Description**
11359
11360Obtains the user-defined data saved on the NodeContent object.
11361
11362**Since**: 12
11363
11364**Parameters**
11365
11366| Name| Description|
11367| -------- | -------- |
11368| content | NodeContent object whose user-defined data needs to be saved. |
11369
11370**Returns**
11371
11372Custom data.
11373
11374
11375### OH_ArkUI_NodeContent_InsertNode()
11376
11377```
11378int32_t OH_ArkUI_NodeContent_InsertNode (ArkUI_NodeContentHandle content, ArkUI_NodeHandle node, int32_t position )
11379```
11380**Description**
11381
11382Inserts an ArkUI component node into a specific location of the corresponding NodeContent object.
11383
11384**Since**: 12
11385
11386**Parameters**
11387
11388| Name| Description|
11389| -------- | -------- |
11390| content | NodeContent object of the node to be inserted. |
11391| node | Node to be inserted. |
11392| position | Start time for an asset to be inserted, |
11393
11394**Returns**
11395
11396Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
11397
11398
11399### OH_ArkUI_NodeContent_RegisterCallback()
11400
11401```
11402int32_t OH_ArkUI_NodeContent_RegisterCallback (ArkUI_NodeContentHandle content, ArkUI_NodeContentCallback callback )
11403```
11404**Description**
11405
11406Registers the NodeContent event function.
11407
11408**Since**: 12
11409
11410**Parameters**
11411
11412| Name| Description|
11413| -------- | -------- |
11414| content | NodeContent object for which an event needs to be registered. |
11415| callback | Function callback to be executed when an event is triggered. |
11416
11417**Returns**
11418
11419Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
11420
11421
11422### OH_ArkUI_NodeContent_RemoveNode()
11423
11424```
11425int32_t OH_ArkUI_NodeContent_RemoveNode (ArkUI_NodeContentHandle content, ArkUI_NodeHandle node )
11426```
11427**Description**
11428
11429Removes an ArkUI component node from the specified NodeContent object.
11430
11431**Since**: 12
11432
11433**Parameters**
11434
11435| Name| Description|
11436| -------- | -------- |
11437| content | NodeContent object of the node to be deleted. |
11438| node | Node to be deleted. |
11439
11440**Returns**
11441
11442Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
11443
11444
11445### OH_ArkUI_NodeContent_SetUserData()
11446
11447```
11448int32_t OH_ArkUI_NodeContent_SetUserData (ArkUI_NodeContentHandle content, void * userData )
11449```
11450**Description**
11451
11452Saves user-defined data on the NodeContent object.
11453
11454**Since**: 12
11455
11456**Parameters**
11457
11458| Name| Description|
11459| -------- | -------- |
11460| content | NodeContent object whose user-defined data needs to be saved. |
11461| userData | User-defined data to be saved. |
11462
11463**Returns**
11464
11465Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
11466
11467
11468### OH_ArkUI_NodeContentEvent_GetEventType()
11469
11470```
11471ArkUI_NodeContentEventType OH_ArkUI_NodeContentEvent_GetEventType (ArkUI_NodeContentEvent * event)
11472```
11473**Description**
11474
11475Obtains the type of the specified NodeContent event.
11476
11477**Since**: 12
11478
11479**Parameters**
11480
11481| Name| Description|
11482| -------- | -------- |
11483| event | Pointer to the NodeContent event. |
11484
11485**Returns**
11486
11487NodeContent event type.
11488
11489
11490### OH_ArkUI_NodeContentEvent_GetNodeContentHandle()
11491
11492```
11493ArkUI_NodeContentHandle OH_ArkUI_NodeContentEvent_GetNodeContentHandle (ArkUI_NodeContentEvent * event)
11494```
11495**Description**
11496
11497Obtains the object that triggers the specified NodeContent event.
11498
11499**Since**: 12
11500
11501**Parameters**
11502
11503| Name| Description|
11504| -------- | -------- |
11505| event | Pointer to the NodeContent event. |
11506
11507**Returns**
11508
11509Returns the NodeContent object that triggers the event.
11510
11511
11512### OH_ArkUI_NodeCustomEvent_GetCustomSpanDrawInfo()
11513
11514```
11515int32_t OH_ArkUI_NodeCustomEvent_GetCustomSpanDrawInfo (ArkUI_NodeCustomEvent * event, ArkUI_CustomSpanDrawInfo * info )
11516```
11517**Description**
11518
11519Obtains the drawing information of a custom span through a custom component event.
11520
11521**Since**: 12
11522
11523**Parameters**
11524
11525| Name| Description|
11526| -------- | -------- |
11527| event | Pointer to the custom component event. |
11528| info | Drawing information to obtain. |
11529
11530**Returns**
11531
11532Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs. A possible cause is that mandatory parameters are left unspecified.
11533
11534
11535### OH_ArkUI_NodeCustomEvent_GetCustomSpanMeasureInfo()
11536
11537```
11538int32_t OH_ArkUI_NodeCustomEvent_GetCustomSpanMeasureInfo (ArkUI_NodeCustomEvent * event, ArkUI_CustomSpanMeasureInfo * info )
11539```
11540**Description**
11541
11542Obtains the measurement information of a custom span through a custom component event.
11543
11544**Since**: 12
11545
11546**Parameters**
11547
11548| Name| Description|
11549| -------- | -------- |
11550| event | Pointer to the custom component event. |
11551| info | Measurement information to obtain. |
11552
11553**Returns**
11554
11555Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs. A possible cause is that mandatory parameters are left unspecified.
11556
11557
11558### OH_ArkUI_NodeCustomEvent_GetDrawContextInDraw()
11559
11560```
11561ArkUI_DrawContext* OH_ArkUI_NodeCustomEvent_GetDrawContextInDraw (ArkUI_NodeCustomEvent * event)
11562```
11563**Description**
11564
11565Obtains the drawing context through a custom component event.
11566
11567**Since**: 12
11568
11569**Parameters**
11570
11571| Name| Description|
11572| -------- | -------- |
11573| event | Pointer to the custom component event. |
11574
11575**Returns**
11576
11577Returns the drawing context.
11578
11579
11580### OH_ArkUI_NodeCustomEvent_GetEventTargetId()
11581
11582```
11583int32_t OH_ArkUI_NodeCustomEvent_GetEventTargetId (ArkUI_NodeCustomEvent * event)
11584```
11585**Description**
11586
11587Obtains the ID of a custom component event.
11588
11589**Since**: 12
11590
11591**Parameters**
11592
11593| Name| Description|
11594| -------- | -------- |
11595| event | Pointer to the custom component event. |
11596
11597**Returns**
11598
11599Returns the custom event ID.
11600
11601
11602### OH_ArkUI_NodeCustomEvent_GetEventType()
11603
11604```
11605ArkUI_NodeCustomEventType OH_ArkUI_NodeCustomEvent_GetEventType (ArkUI_NodeCustomEvent * event)
11606```
11607**Description**
11608
11609Obtains the event type through a custom component event.
11610
11611**Since**: 12
11612
11613**Parameters**
11614
11615| Name| Description|
11616| -------- | -------- |
11617| event | Pointer to the custom component event. |
11618
11619**Returns**
11620
11621Returns the type of the custom component event.
11622
11623
11624### OH_ArkUI_NodeCustomEvent_GetLayoutConstraintInMeasure()
11625
11626```
11627ArkUI_LayoutConstraint* OH_ArkUI_NodeCustomEvent_GetLayoutConstraintInMeasure (ArkUI_NodeCustomEvent * event)
11628```
11629**Description**
11630
11631Obtains the size constraint for measurement through a custom component event.
11632
11633**Since**: 12
11634
11635**Parameters**
11636
11637| Name| Description|
11638| -------- | -------- |
11639| event | Pointer to the custom component event. |
11640
11641**Returns**
11642
11643Pointer to the constraint size.
11644
11645
11646### OH_ArkUI_NodeCustomEvent_GetNodeHandle()
11647
11648```
11649ArkUI_NodeHandle OH_ArkUI_NodeCustomEvent_GetNodeHandle (ArkUI_NodeCustomEvent * event)
11650```
11651**Description**
11652
11653Obtains a component object through a custom component event.
11654
11655**Since**: 12
11656
11657**Parameters**
11658
11659| Name| Description|
11660| -------- | -------- |
11661| event | Pointer to the custom component event. |
11662
11663**Returns**
11664
11665Returns the obtained component object.
11666
11667
11668### OH_ArkUI_NodeCustomEvent_GetPositionInLayout()
11669
11670```
11671ArkUI_IntOffset OH_ArkUI_NodeCustomEvent_GetPositionInLayout (ArkUI_NodeCustomEvent * event)
11672```
11673**Description**
11674
11675Obtains the expected position of a component relative to its parent component in the layout phase through a custom component event.
11676
11677**Since**: 12
11678
11679**Parameters**
11680
11681| Name| Description|
11682| -------- | -------- |
11683| event | Pointer to the custom component event. |
11684
11685**Returns**
11686
11687Returns the expected position relative to the parent component.
11688
11689
11690### OH_ArkUI_NodeCustomEvent_GetUserData()
11691
11692```
11693void* OH_ArkUI_NodeCustomEvent_GetUserData (ArkUI_NodeCustomEvent * event)
11694```
11695**Description**
11696
11697Obtains custom event parameters through a custom component event.
11698
11699**Since**: 12
11700
11701**Parameters**
11702
11703| Name| Description|
11704| -------- | -------- |
11705| event | Pointer to the custom component event. |
11706
11707**Returns**
11708
11709Returns the custom event parameters.
11710
11711
11712### OH_ArkUI_NodeCustomEvent_SetCustomSpanMetrics()
11713
11714```
11715int32_t OH_ArkUI_NodeCustomEvent_SetCustomSpanMetrics (ArkUI_NodeCustomEvent * event, ArkUI_CustomSpanMetrics * metrics )
11716```
11717**Description**
11718
11719Sets the measurement metrics of a custom span through a custom component event.
11720
11721**Since**: 12
11722
11723**Parameters**
11724
11725| Name| Description|
11726| -------- | -------- |
11727| event | Pointer to the custom component event. |
11728| metrics | Measurement metrics to set. |
11729
11730**Returns**
11731
11732Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs. A possible cause is that mandatory parameters are left unspecified.
11733
11734
11735### OH_ArkUI_NodeEvent_GetDragEvent()
11736
11737```
11738ArkUI_DragEvent* OH_ArkUI_NodeEvent_GetDragEvent (ArkUI_NodeEvent * nodeEvent)
11739```
11740**Description**
11741
11742Obtains an **ArkUI_DragEvent** object from the specified **ArkUI_DragEvent** object.
11743
11744**Since**: 12
11745
11746**Parameters**
11747
11748| Name| Description|
11749| -------- | -------- |
11750| node | Pointer to an **ArkUI_NodeEvent** object. |
11751
11752**Returns**
11753
11754Returns the pointer to an **ArkUI_DragEvent** object; returns null if the parameter passed in is invalid or is not a drag-related event.
11755
11756
11757### OH_ArkUI_NodeEvent_GetEventType()
11758
11759```
11760ArkUI_NodeEventType OH_ArkUI_NodeEvent_GetEventType (ArkUI_NodeEvent * event)
11761```
11762**Description**
11763
11764Obtains the type of a component event.
11765
11766**Since**: 12
11767
11768**Parameters**
11769
11770| Name| Description|
11771| -------- | -------- |
11772| event | Pointer to the component event. |
11773
11774**Returns**
11775
11776Returns the type of the component event.
11777
11778
11779### OH_ArkUI_NodeEvent_GetInputEvent()
11780
11781```
11782ArkUI_UIInputEvent* OH_ArkUI_NodeEvent_GetInputEvent (ArkUI_NodeEvent * event)
11783```
11784**Description**
11785
11786Obtains input event (for example, touch event) data for a component event.
11787
11788**Since**: 12
11789
11790**Parameters**
11791
11792| Name| Description|
11793| -------- | -------- |
11794| event | Pointer to the component event. |
11795
11796**Returns**
11797
11798Returns the pointer to the input event data.
11799
11800
11801### OH_ArkUI_NodeEvent_GetNodeComponentEvent()
11802
11803```
11804ArkUI_NodeComponentEvent* OH_ArkUI_NodeEvent_GetNodeComponentEvent (ArkUI_NodeEvent * event)
11805```
11806**Description**
11807
11808Obtains the numerical data in a component event.
11809
11810**Since**: 12
11811
11812**Parameters**
11813
11814| Name| Description|
11815| -------- | -------- |
11816| event | Pointer to the component event. |
11817
11818**Returns**
11819
11820Returns the pointer to the numerical data.
11821
11822
11823### OH_ArkUI_NodeEvent_GetNodeHandle()
11824
11825```
11826ArkUI_NodeHandle OH_ArkUI_NodeEvent_GetNodeHandle (ArkUI_NodeEvent * event)
11827```
11828**Description**
11829
11830Obtains the component object that triggers an event.
11831
11832**Since**: 12
11833
11834**Parameters**
11835
11836| Name| Description|
11837| -------- | -------- |
11838| event | Pointer to the component event. |
11839
11840**Returns**
11841
11842Component object that triggers the event.
11843
11844
11845### OH_ArkUI_NodeEvent_GetNumberValue()
11846
11847```
11848int32_t OH_ArkUI_NodeEvent_GetNumberValue (ArkUI_NodeEvent * event, int32_t index, ArkUI_NumberValue * value )
11849```
11850**Description**
11851
11852Obtains the numeric-type parameter of a component event.
11853
11854**Since**: 12
11855
11856**Parameters**
11857
11858| Name| Description|
11859| -------- | -------- |
11860| event | Pointer to the component event. |
11861| index | Return value index. |
11862| value | Return value. |
11863
11864**Returns**
11865
11866Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INDEX_OUT_OF_RANGE** if the parameter length in the parameter event exceeds the limit. Returns **ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INVALID** if the data does not exist in the component event.
11867
11868
11869### OH_ArkUI_NodeEvent_GetPreDragStatus()
11870
11871```
11872ArkUI_PreDragStatus OH_ArkUI_NodeEvent_GetPreDragStatus (ArkUI_NodeEvent * nodeEvent)
11873```
11874**Description**
11875
11876Obtains the state prior to a drop and drop operation.
11877
11878**Since**: 12
11879
11880**Parameters**
11881
11882| Name| Description|
11883| -------- | -------- |
11884| node | ArkUI_NodeEvent node object. |
11885
11886**Returns**
11887
11888Returns the state prior to the drop and drop operation.
11889
11890
11891### OH_ArkUI_NodeEvent_GetStringAsyncEvent()
11892
11893```
11894ArkUI_StringAsyncEvent* OH_ArkUI_NodeEvent_GetStringAsyncEvent (ArkUI_NodeEvent * event)
11895```
11896**Description**
11897
11898Obtains the string data in a component event.
11899
11900**Since**: 12
11901
11902**Parameters**
11903
11904| Name| Description|
11905| -------- | -------- |
11906| event | Pointer to the component event. |
11907
11908**Returns**
11909
11910ArkUI_StringAsyncEvent\Pointer to string data.
11911
11912
11913### OH_ArkUI_NodeEvent_GetStringValue()
11914
11915```
11916int32_t OH_ArkUI_NodeEvent_GetStringValue (ArkUI_NodeEvent * event, int32_t index, char ** string, int32_t * stringSize )
11917```
11918**Description**
11919
11920Obtains the string-type parameter of the component callback event. The string data is valid only during event callback and needs to be used outside event callback. You are advised to copy the string data.
11921
11922**Since**: 12
11923
11924**Parameters**
11925
11926| Name| Description|
11927| -------- | -------- |
11928| event | Pointer to the component event. |
11929| index | Return value index. |
11930| string | Pointer to the string array. |
11931| stringSize | Length of the string array. |
11932
11933**Returns**
11934
11935Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INDEX_OUT_OF_RANGE** if the parameter length in the parameter event exceeds the limit. Returns **ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INVALID** if the data does not exist in the component event.
11936
11937
11938### OH_ArkUI_NodeEvent_GetTargetId()
11939
11940```
11941int32_t OH_ArkUI_NodeEvent_GetTargetId (ArkUI_NodeEvent * event)
11942```
11943**Description**
11944
11945Obtains the custom ID of a component event.
11946
11947The event ID is transferred as a parameter when the registerNodeEvent function is called and can be used in the distribution logic of the same event entry function registerNodeEventReceiver.
11948
11949**Since**: 12
11950
11951**Parameters**
11952
11953| Name| Description|
11954| -------- | -------- |
11955| event | Pointer to the component event. |
11956
11957**Returns**
11958
11959Returns the custom ID of the component event.
11960
11961
11962### OH_ArkUI_NodeEvent_GetUserData()
11963
11964```
11965void* OH_ArkUI_NodeEvent_GetUserData (ArkUI_NodeEvent * event)
11966```
11967**Description**
11968
11969Obtains the custom data in a component event.
11970
11971This parameter is passed in **registerNodeEvent** and can be applied to the service logic when the event is triggered.
11972
11973**Since**: 12
11974
11975**Parameters**
11976
11977| Name| Description|
11978| -------- | -------- |
11979| event | Pointer to the component event. |
11980
11981**Returns**
11982
11983Returns the pointer to user data.
11984
11985
11986### OH_ArkUI_NodeEvent_SetReturnNumberValue()
11987
11988```
11989int32_t OH_ArkUI_NodeEvent_SetReturnNumberValue (ArkUI_NodeEvent * event, ArkUI_NumberValue * value, int32_t size )
11990```
11991**Description**
11992
11993Sets the return value for a component event.
11994
11995**Since**: 12
11996
11997**Parameters**
11998
11999| Name| Description|
12000| -------- | -------- |
12001| event | Pointer to the component event. |
12002| value | Event numeric type array. |
12003| size | Size of the array. |
12004
12005**Returns**
12006
12007Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. The component event does not support return values. Returns **ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INVALID** if the data does not exist in the component event.
12008
12009
12010### OH_ArkUI_NodeUtils_AddCustomProperty()
12011
12012```
12013void OH_ArkUI_NodeUtils_AddCustomProperty (ArkUI_NodeHandle node, const char * name, const char * value )
12014```
12015**Description**
12016
12017Sets a custom property for a component. This API takes effect only in the main thread.
12018
12019**Since**: 13
12020
12021**Parameters**
12022
12023| Name| Description|
12024| -------- | -------- |
12025| node | **ArkUI_NodeHandle** pointer. |
12026| name | Name of the custom property. A null pointer is not allowed. |
12027| value | Value of the custom property. A null pointer is not allowed. |
12028
12029
12030### OH_ArkUI_NodeUtils_GetLayoutPosition()
12031
12032```
12033int32_t OH_ArkUI_NodeUtils_GetLayoutPosition (ArkUI_NodeHandle node, ArkUI_IntOffset * localOffset )
12034```
12035**Description**
12036
12037Obtains the position of the component's layout area relative to its parent component. The relative position does not count in transformation attributes, such as translate.
12038
12039**Since**: 12
12040
12041**Parameters**
12042
12043| Name| Description|
12044| -------- | -------- |
12045| node | **ArkUI_NodeHandle** pointer. |
12046| localOffset | Offset of the component handle relative to the parent component, in pixels. |
12047
12048**Returns**
12049
12050Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12051
12052
12053### OH_ArkUI_NodeUtils_GetLayoutPositionInScreen()
12054
12055```
12056int32_t OH_ArkUI_NodeUtils_GetLayoutPositionInScreen (ArkUI_NodeHandle node, ArkUI_IntOffset * screenOffset )
12057```
12058**Description**
12059
12060Obtains the position of the component's layout area relative to the screen. The relative position does not count in transformation attributes, such as translate.
12061
12062**Since**: 12
12063
12064**Parameters**
12065
12066| Name| Description|
12067| -------- | -------- |
12068| node | **ArkUI_NodeHandle** pointer. |
12069| screenOffset | Offset of the component handle relative to the screen, in pixels. |
12070
12071**Returns**
12072
12073Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12074
12075
12076### OH_ArkUI_NodeUtils_GetLayoutPositionInWindow()
12077
12078```
12079int32_t OH_ArkUI_NodeUtils_GetLayoutPositionInWindow (ArkUI_NodeHandle node, ArkUI_IntOffset * globalOffset )
12080```
12081**Description**
12082
12083Obtains the position of the component's layout area relative to the window. The relative position does not count in transformation attributes, such as translate.
12084
12085**Since**: 12
12086
12087**Parameters**
12088
12089| Name| Description|
12090| -------- | -------- |
12091| node | **ArkUI_NodeHandle** pointer. |
12092| globalOffset | Offset of the component handle relative to the window, in pixels. |
12093
12094**Returns**
12095
12096Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12097
12098
12099### OH_ArkUI_NodeUtils_GetLayoutSize()
12100
12101```
12102int32_t OH_ArkUI_NodeUtils_GetLayoutSize (ArkUI_NodeHandle node, ArkUI_IntSize * size )
12103```
12104**Description**
12105
12106Obtains the layout area size of a component. The size does not count in transformation attributes, such as scale.
12107
12108**Since**: 12
12109
12110**Parameters**
12111
12112| Name| Description|
12113| -------- | -------- |
12114| node | **ArkUI_NodeHandle** pointer. |
12115| size | Size of the layout area, in px. |
12116
12117**Returns**
12118
12119Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12120
12121
12122### OH_ArkUI_NodeUtils_GetPositionWithTranslateInScreen()
12123
12124```
12125int32_t OH_ArkUI_NodeUtils_GetPositionWithTranslateInScreen (ArkUI_NodeHandle node, ArkUI_IntOffset * translateOffset )
12126```
12127**Description**
12128
12129Obtains the position of a component on the screen, including the translate attribute.
12130
12131**Since**: 12
12132
12133**Parameters**
12134
12135| Name| Description|
12136| -------- | -------- |
12137| node | **ArkUI_NodeHandle** pointer. |
12138| translateOffset | Accumulated offset of the component, its parent component, and its ancestor node, in px. |
12139
12140**Returns**
12141
12142Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12143
12144
12145### OH_ArkUI_NodeUtils_GetPositionWithTranslateInWindow()
12146
12147```
12148int32_t OH_ArkUI_NodeUtils_GetPositionWithTranslateInWindow (ArkUI_NodeHandle node, ArkUI_IntOffset * translateOffset )
12149```
12150**Description**
12151
12152Obtains the position of a component in the window, including the translate attribute.
12153
12154**Since**: 12
12155
12156**Parameters**
12157
12158| Name| Description|
12159| -------- | -------- |
12160| node | **ArkUI_NodeHandle** pointer. |
12161| translateOffset | Accumulated offset of the component, its parent component, and its ancestor node, in px. |
12162
12163**Returns**
12164
12165Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12166
12167
12168### OH_ArkUI_NodeUtils_RemoveCustomProperty()
12169
12170```
12171void OH_ArkUI_NodeUtils_RemoveCustomProperty (ArkUI_NodeHandle node, const char * name )
12172```
12173**Description**
12174
12175Removes a custom property that has been set for the specified component.
12176
12177**Since**: 13
12178
12179**Parameters**
12180
12181| Name| Description|
12182| -------- | -------- |
12183| node | **ArkUI_NodeHandle** pointer. |
12184| name | Name of the custom property. |
12185
12186
12187### OH_ArkUI_PanGesture_GetOffsetX()
12188
12189```
12190float OH_ArkUI_PanGesture_GetOffsetX (const ArkUI_GestureEvent * event)
12191```
12192**Description**
12193
12194Obtains the relative offset of a pan gesture along the x-axis.
12195
12196**Since**: 12
12197
12198**Parameters**
12199
12200| Name| Description|
12201| -------- | -------- |
12202| event | Gesture event. |
12203
12204**Returns**
12205
12206Returns the relative offset of the gesture along the x-axis, in px.
12207
12208
12209### OH_ArkUI_PanGesture_GetOffsetY()
12210
12211```
12212float OH_ArkUI_PanGesture_GetOffsetY (const ArkUI_GestureEvent * event)
12213```
12214**Description**
12215
12216Obtains the relative offset of a pan gesture along the y-axis.
12217
12218**Since**: 12
12219
12220**Parameters**
12221
12222| Name| Description|
12223| -------- | -------- |
12224| event | Gesture event. |
12225
12226**Returns**
12227
12228Returns the relative offset of the gesture along the y-axis, in px.
12229
12230
12231### OH_ArkUI_PanGesture_GetVelocity()
12232
12233```
12234float OH_ArkUI_PanGesture_GetVelocity (const ArkUI_GestureEvent * event)
12235```
12236**Description**
12237
12238Obtains the velocity of a pan gesture along the main axis.
12239
12240**Since**: 12
12241
12242**Parameters**
12243
12244| Name| Description|
12245| -------- | -------- |
12246| event | Gesture event. |
12247
12248**Returns**
12249
12250Returns the velocity of the pan gesture along the main axis, in px/s. The value is the square root of the sum of the squares of the velocity on the x-axis and y-axis.
12251
12252
12253### OH_ArkUI_PanGesture_GetVelocityX()
12254
12255```
12256float OH_ArkUI_PanGesture_GetVelocityX (const ArkUI_GestureEvent * event)
12257```
12258**Description**
12259
12260Obtains the velocity of a pan gesture along the x-axis.
12261
12262**Since**: 12
12263
12264**Parameters**
12265
12266| Name| Description|
12267| -------- | -------- |
12268| event | Gesture event. |
12269
12270**Returns**
12271
12272Returns the velocity of the pan gesture along the x-axis, in px/s.
12273
12274
12275### OH_ArkUI_PanGesture_GetVelocityY()
12276
12277```
12278float OH_ArkUI_PanGesture_GetVelocityY (const ArkUI_GestureEvent * event)
12279```
12280**Description**
12281
12282Obtains the velocity of a pan gesture along the y-axis.
12283
12284**Since**: 12
12285
12286**Parameters**
12287
12288| Name| Description|
12289| -------- | -------- |
12290| event | Gesture event. |
12291
12292**Returns**
12293
12294Returns the velocity of the pan gesture along the y-axis, in px/s.
12295
12296
12297### OH_ArkUI_ParallelInnerGestureEvent_GetConflictRecognizers()
12298
12299```
12300int32_t OH_ArkUI_ParallelInnerGestureEvent_GetConflictRecognizers (ArkUI_ParallelInnerGestureEvent * event, ArkUI_GestureRecognizerHandleArray * array, int32_t * size )
12301```
12302**Description**
12303
12304Obtains the conflicting gesture recognizers in a parallel internal gesture event.
12305
12306**Since**: 12
12307
12308**Parameters**
12309
12310| Name| Description|
12311| -------- | -------- |
12312| event | Parallel internal gesture event. |
12313| array | Array of conflicting gesture recognizers. |
12314| size | Size of the conflicting gesture recognizer array. |
12315
12316**Returns**
12317
12318Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
12319
12320
12321### OH_ArkUI_ParallelInnerGestureEvent_GetCurrentRecognizer()
12322
12323```
12324ArkUI_GestureRecognizer* OH_ArkUI_ParallelInnerGestureEvent_GetCurrentRecognizer (ArkUI_ParallelInnerGestureEvent * event)
12325```
12326**Description**
12327
12328Obtains the current gesture recognizer in a parallel internal gesture event.
12329
12330**Since**: 12
12331
12332**Parameters**
12333
12334| Name| Description|
12335| -------- | -------- |
12336| event | Parallel internal gesture event. |
12337
12338**Returns**
12339
12340Returns the pointer to the current gesture recognizer.
12341
12342
12343### OH_ArkUI_ParallelInnerGestureEvent_GetUserData()
12344
12345```
12346void* OH_ArkUI_ParallelInnerGestureEvent_GetUserData (ArkUI_ParallelInnerGestureEvent * event)
12347```
12348**Description**
12349
12350Obtains custom data in the parallel internal gesture event.
12351
12352**Since**: 12
12353
12354**Parameters**
12355
12356| Name| Description|
12357| -------- | -------- |
12358| event | Parallel internal gesture event. |
12359
12360**Returns**
12361
12362Returns the pointer to custom data.
12363
12364
12365### OH_ArkUI_PinchGesture_GetCenterX()
12366
12367```
12368float OH_ArkUI_PinchGesture_GetCenterX (const ArkUI_GestureEvent * event)
12369```
12370**Description**
12371
12372Obtains the X coordinate of the center of the pinch gesture, in vp, relative to the upper left corner of the current component.
12373
12374**Since**: 12
12375
12376**Parameters**
12377
12378| Name| Description|
12379| -------- | -------- |
12380| event | Gesture event. |
12381
12382**Returns**
12383Returns the X coordinate of the center of the pinch gesture, in vp, relative to the upper left corner of the current component.
12384
12385
12386### OH_ArkUI_PinchGesture_GetCenterY()
12387
12388```
12389float OH_ArkUI_PinchGesture_GetCenterY (const ArkUI_GestureEvent * event)
12390```
12391**Description**
12392
12393Obtains the Y coordinate of the center of the pinch gesture, in vp, relative to the upper left corner of the current component.
12394
12395**Since**: 12
12396
12397**Parameters**
12398
12399| Name| Description|
12400| -------- | -------- |
12401| event | Gesture event. |
12402
12403**Returns**
12404
12405Returns the Y coordinate of the center of the pinch gesture, in vp, relative to the upper left corner of the current component.
12406
12407
12408### OH_ArkUI_PinchGesture_GetScale()
12409
12410```
12411float OH_ArkUI_PinchGesture_GetScale (const ArkUI_GestureEvent * event)
12412```
12413**Description**
12414
12415Obtains the scale ratio of a pinch gesture.
12416
12417**Since**: 12
12418
12419**Parameters**
12420
12421| Name| Description|
12422| -------- | -------- |
12423| event | Gesture event. |
12424
12425**Returns**
12426
12427Scale.
12428
12429
12430### OH_ArkUI_QueryModuleInterfaceByName()
12431
12432```
12433void* OH_ArkUI_QueryModuleInterfaceByName (ArkUI_NativeAPIVariantKind type, const char * structName )
12434```
12435**Description**
12436
12437Obtains the native API set of a specified type.
12438
12439**Since**: 12
12440
12441**Parameters**
12442
12443| Name| Description|
12444| -------- | -------- |
12445| type | Type of the native API set provided by ArkUI, for example, **ARKUI_NATIVE_NODE** or **ARKUI_NATIVE_GESTURE**. |
12446| sturctName | Name of a native struct defined in the corresponding header file, for example, **ArkUI_NativeNodeAPI_1** in &lt;arkui/native_node.h&gt. |
12447
12448**Returns**
12449
12450Returns the pointer to the abstract native API, which can be used after being converted into a specific type. \#include&lt;arkui/native_interface.h&gt; \#include&lt;arkui/native_node.h&gt; \#include&lt;arkui/native_gesture.h&gt; auto\* anyNativeAPI = [OH_ArkUI_QueryModuleInterfaceByName](#oh_arkui_querymoduleinterfacebyname)(ARKUI_NATIVE_NODE, "ArkUI_NativeNodeAPI_1"); if (anyNativeAPI) { auto nativeNodeApi = reinterpret_cast&lt;[ArkUI_NativeNodeAPI_1](_ark_u_i___native_node_a_p_i__1.md)\*&gt;(anyNativeAPI); } auto anyGestureAPI = OH_ArkUI_QueryModuleInterface(ARKUI_NATIVE_GESTURE, "ArkUI_NativeGestureAPI_1"); if (anyNativeAPI) { auto basicGestureApi = reinterpret_cast&lt;[ArkUI_NativeGestureAPI_1](_ark_u_i___native_gesture_a_p_i__1.md)\*&gt;(anyGestureAPI); }
12451
12452
12453### OH_ArkUI_RegisterSystemColorModeChangeEvent()
12454
12455```
12456int32_t OH_ArkUI_RegisterSystemColorModeChangeEvent (ArkUI_NodeHandle node, void * userData, void(*)(ArkUI_SystemColorMode colorMode, void *userData) onColorModeChange )
12457```
12458**Description**
12459
12460Registers an event listener for system color mode changes. A single component can only register one callback for system color mode changes.
12461
12462**Since**: 12
12463
12464**Parameters**
12465
12466| Name| Description|
12467| -------- | -------- |
12468| node | Specified node. |
12469| userData | Custom event parameter, which is passed in the callback when the event is triggered. |
12470| onColorModeChange | Callback to be executed when the event is triggered. |
12471
12472**Returns**
12473
12474Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs. Returns **ARKUI_ERROR_CODE_ATTRIBUTE_OR_EVENT_NOT_SUPPORTED** if the event is not supported.
12475
12476
12477### OH_ArkUI_RegisterSystemFontStyleChangeEvent()
12478
12479```
12480int32_t OH_ArkUI_RegisterSystemFontStyleChangeEvent (ArkUI_NodeHandle node, void * userData, void(*)(ArkUI_SystemFontStyleEvent *event, void *userData) onFontStyleChange )
12481```
12482**Description**
12483
12484Registers an event listener for system font style changes. A single component can only register one callback for system font style changes.
12485
12486**Since**: 12
12487
12488**Parameters**
12489
12490| Name| Description|
12491| -------- | -------- |
12492| node | Specified node. |
12493| userData | Custom event parameter, which is passed in the callback when the event is triggered. |
12494| onFontStyleChange | Callback to be executed when the event is triggered. |
12495
12496**Returns**
12497
12498Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs. Returns **ARKUI_ERROR_CODE_ATTRIBUTE_OR_EVENT_NOT_SUPPORTED** if the event is not supported.
12499
12500
12501### OH_ArkUI_RotationGesture_GetAngle()
12502
12503```
12504float OH_ArkUI_RotationGesture_GetAngle (const ArkUI_GestureEvent * event)
12505```
12506**Description**
12507
12508Obtains the angle information of a rotation gesture.
12509
12510**Since**: 12
12511
12512**Parameters**
12513
12514| Name| Description|
12515| -------- | -------- |
12516| event | Gesture event. |
12517
12518**Returns**
12519
12520Rotation angle.
12521
12522
12523### OH_ArkUI_SetArkUIGestureRecognizerDisposeNotify()
12524
12525```
12526int32_t OH_ArkUI_SetArkUIGestureRecognizerDisposeNotify (ArkUI_GestureRecognizer * recognizer, ArkUI_GestureRecognizerDestructNotifyCallback callback, void * userData )
12527```
12528**Description**
12529
12530Sets a callback function for notifying gesture recognizer destruction.
12531
12532**Parameters**
12533
12534| Name| Description|
12535| -------- | -------- |
12536| recognizer | Pointer to the gesture recognizer. |
12537| callback | Callback function for notifying gesture recognizer destruction. |
12538| userData | Custom data. |
12539
12540**Returns**
12541
12542Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
12543
12544
12545### OH_ArkUI_SetDragEventStrictReportWithContext()
12546
12547```
12548int32_t OH_ArkUI_SetDragEventStrictReportWithContext (ArkUI_ContextHandle uiContext, bool enabled )
12549```
12550**Description**
12551
12552Sets whether to enable strict reporting on drag events. This feature is disabled by default, and you are advised to enable it. If this feature is disabled, the parent component is not notified when an item in it is dragged over its child component. If this feature is enabled, the component is notified of the dragged item's leaving, and the child component to which the dragged item is dropped is notified of the item's entering. This configuration is related to a specific UI instance. You can pass in a UI instance for association.
12553
12554**Since**: 12
12555
12556**Parameters**
12557
12558| Name| Description|
12559| -------- | -------- |
12560| uiContext | Pointer to the UI instance. |
12561| enabled | Whether to enable strict reporting on drag events. |
12562
12563**Returns**
12564
12565Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12566
12567
12568### OH_ArkUI_SetDragEventStrictReportWithNode()
12569
12570```
12571int32_t OH_ArkUI_SetDragEventStrictReportWithNode (ArkUI_NodeHandle node, bool enabled )
12572```
12573**Description**
12574
12575Sets whether to enable strict reporting on drag events. This feature is disabled by default, and you are advised to enable it. If this feature is disabled, the parent component is not notified when an item in it is dragged over its child component. If this feature is enabled, the component is notified of the dragged item's leaving, and the child component to which the dragged item is dropped is notified of the item's entering. This configuration is related to a specific UI instance. You can pass in a specific component node on the current UI instance for association.
12576
12577**Since**: 12
12578
12579**Parameters**
12580
12581| Name| Description|
12582| -------- | -------- |
12583| node | Pointer to a component node. |
12584| enabled | Whether to enable strict reporting on drag events. |
12585
12586**Returns**
12587
12588Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12589
12590
12591### OH_ArkUI_SetGestureRecognizerEnabled()
12592
12593```
12594int32_t OH_ArkUI_SetGestureRecognizerEnabled (ArkUI_GestureRecognizer * recognizer, bool enabled )
12595```
12596**Description**
12597
12598Sets the enabled state of a gesture recognizer.
12599
12600**Since**: 12
12601
12602**Parameters**
12603
12604| Name| Description|
12605| -------- | -------- |
12606| recognizer | Pointer to the gesture recognizer. |
12607| enabled | Whether to enable notification. |
12608
12609**Returns**
12610
12611Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
12612
12613
12614### OH_ArkUI_SetNodeAllowedDropDataTypes()
12615
12616```
12617int32_t OH_ArkUI_SetNodeAllowedDropDataTypes (ArkUI_NodeHandle node, const char * typesArray[], int32_t count )
12618```
12619**Description**
12620
12621Sets the types of data that can be dropped to the specified component. This API resets the settings configured through [OH_ArkUI_DisallowNodeAnyDropDataTypes](#oh_arkui_disallownodeanydropdatatypes) or [OH_ArkUI_AllowNodeAllDropDataTypes](#oh_arkui_allownodealldropdatatypes).
12622
12623**Since**: 12
12624
12625**Parameters**
12626
12627| Name| Description|
12628| -------- | -------- |
12629| node | Pointer to a component node. |
12630| typesArray | Array of data types that can fall into. |
12631| count | Length of an array. |
12632
12633**Returns**
12634
12635Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12636
12637
12638### OH_ArkUI_SetNodeDraggable()
12639
12640```
12641int32_t OH_ArkUI_SetNodeDraggable (ArkUI_NodeHandle node, bool enabled )
12642```
12643**Description**
12644
12645Sets whether the component is draggable.
12646
12647**Since**: 12
12648
12649**Parameters**
12650
12651| Name| Description|
12652| -------- | -------- |
12653| node | Pointer to a component node. |
12654| bool | Whether the component is draggable. |
12655
12656**Returns**
12657
12658Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12659
12660
12661### OH_ArkUI_SetNodeDragPreview()
12662
12663```
12664int32_t OH_ArkUI_SetNodeDragPreview (ArkUI_NodeHandle node, OH_PixelmapNative * preview )
12665```
12666**Description**
12667
12668Sets a custom drag preview for the specified component.
12669
12670**Since**: 12
12671
12672**Parameters**
12673
12674| Name| Description|
12675| -------- | -------- |
12676| node | Pointer to the target component node. |
12677| preview | Custom drag preview, which is a pixel map. |
12678
12679**Returns**
12680
12681Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12682
12683
12684### OH_ArkUI_SetNodeDragPreviewOption()
12685
12686```
12687int32_t OH_ArkUI_SetNodeDragPreviewOption (ArkUI_NodeHandle node, ArkUI_DragPreviewOption * option )
12688```
12689**Description**
12690
12691Sets an **ArkUI_DragPreviewOption** object for the specified component.
12692
12693**Since**: 12
12694
12695**Parameters**
12696
12697| Name| Description|
12698| -------- | -------- |
12699| node | Pointer to a component node. |
12700| option | Custom parameters. |
12701
12702**Returns**
12703
12704Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12705
12706
12707### OH_ArkUI_StartDrag()
12708
12709```
12710int32_t OH_ArkUI_StartDrag (ArkUI_DragAction * dragAction)
12711```
12712**Description**
12713
12714Initiates a drag action through the specified drag action object.
12715
12716**Since**: 12
12717
12718**Parameters**
12719
12720| Name| Description|
12721| -------- | -------- |
12722| dragAction | Drag action object. |
12723
12724**Returns**
12725
12726Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12727
12728
12729### OH_ArkUI_StyledString_AddPlaceholder()
12730
12731```
12732void OH_ArkUI_StyledString_AddPlaceholder (ArkUI_StyledString * handle, OH_Drawing_PlaceholderSpan * placeholder )
12733```
12734**Description**
12735
12736Adds a placeholder.
12737
12738**Since**: 12
12739
12740**Parameters**
12741
12742| Name| Description|
12743| -------- | -------- |
12744| handle | Pointer to an **ArkUI_StyledString** object. |
12745| placeholder | Pointer to an **OH_Drawing_PlaceholderSpan** object. |
12746
12747
12748### OH_ArkUI_StyledString_AddText()
12749
12750```
12751void OH_ArkUI_StyledString_AddText (ArkUI_StyledString * handle, const char * content )
12752```
12753**Description**
12754
12755Sets the text content based on the current format string style.
12756
12757**Since**: 12
12758
12759**Parameters**
12760
12761| Name| Description|
12762| -------- | -------- |
12763| handle | Pointer to an **ArkUI_StyledString** object. |
12764| content | Pointer to the text content. |
12765
12766
12767### OH_ArkUI_StyledString_Create()
12768
12769```
12770ArkUI_StyledString* OH_ArkUI_StyledString_Create (OH_Drawing_TypographyStyle * style, OH_Drawing_FontCollection * collection )
12771```
12772**Description**
12773
12774Creates an **ArkUI_StyledString** object.
12775
12776**Since**: 12
12777
12778**Parameters**
12779
12780| Name| Description|
12781| -------- | -------- |
12782| style | Pointer to an **OH_Drawing_TypographyStyle** object, which is obtained by calling **OH_Drawing_CreateTypographyStyle**. |
12783| collection | Pointer to an **OH_Drawing_FontCollection** object, which is obtained by calling **OH_Drawing_CreateFontCollection**. |
12784
12785**Returns**
12786
12787Returns the pointer to the **ArkUI_StyledString** object created. If a null pointer is returned, the creation fails. A possible cause is that the application address space is full, or a parameter error, for example, a null pointer for the **style** or **collection** parameter, occurs.
12788
12789
12790### OH_ArkUI_StyledString_CreateTypography()
12791
12792```
12793OH_Drawing_Typography* OH_ArkUI_StyledString_CreateTypography (ArkUI_StyledString * handle)
12794```
12795**Description**
12796
12797Creates an **OH_Drawing_Typography** object based on an **ArkUI_StyledString** object.
12798
12799**Since**: 12
12800
12801**Parameters**
12802
12803| Name| Description|
12804| -------- | -------- |
12805| handle | Pointer to an **ArkUI_StyledString** object. |
12806
12807**Returns**
12808
12809Returns the pointer to the **OH_Drawing_Typography** object created. If a null pointer is returned, the creation fails. A possible cause is that a parameter error, for example, a null pointer for the **handle** parameter, occurs.
12810
12811
12812### OH_ArkUI_StyledString_Descriptor_Create()
12813
12814```
12815ArkUI_StyledString_Descriptor* OH_ArkUI_StyledString_Descriptor_Create ()
12816```
12817**Description**
12818
12819Creates an **ArkUI_StyledString_Descriptor** object.
12820
12821**Since**: 14
12822
12823**Returns**
12824
12825Pointer to an **ArkUI_StyledString_Descriptor** object.
12826
12827
12828### OH_ArkUI_StyledString_Descriptor_Destroy()
12829
12830```
12831void OH_ArkUI_StyledString_Descriptor_Destroy (ArkUI_StyledString_Descriptor * descriptor)
12832```
12833**Description**
12834
12835Destroys an **ArkUI_StyledString_Descriptor** object and reclaims the memory occupied by the object.
12836
12837**Since**: 14
12838
12839**Parameters**
12840
12841| Name| Description|
12842| -------- | -------- |
12843| descriptor | Pointer to an **ArkUI_StyledString_Descriptor** object. |
12844
12845
12846### OH_ArkUI_StyledString_Destroy()
12847
12848```
12849void OH_ArkUI_StyledString_Destroy (ArkUI_StyledString * handle)
12850```
12851**Description**
12852
12853Destroys an **OH_Drawing_TextStyle** object and reclaims the memory occupied by the object.
12854
12855**Since**: 12
12856
12857**Parameters**
12858
12859| Name| Description|
12860| -------- | -------- |
12861| handle | Pointer to an **ArkUI_StyledString** object. |
12862
12863
12864### OH_ArkUI_StyledString_PopTextStyle()
12865
12866```
12867void OH_ArkUI_StyledString_PopTextStyle (ArkUI_StyledString * handle)
12868```
12869**Description**
12870
12871Removes the top style from the current formatted string object.
12872
12873**Since**: 12
12874
12875**Parameters**
12876
12877| Name| Description|
12878| -------- | -------- |
12879| handle | Pointer to an **ArkUI_StyledString** object. |
12880
12881
12882### OH_ArkUI_StyledString_PushTextStyle()
12883
12884```
12885void OH_ArkUI_StyledString_PushTextStyle (ArkUI_StyledString * handle, OH_Drawing_TextStyle * style )
12886```
12887**Description**
12888
12889Sets the new typesetting style to the top of the current format string style stack.
12890
12891**Since**: 12
12892
12893**Parameters**
12894
12895| Name| Description|
12896| -------- | -------- |
12897| handle | Pointer to an **ArkUI_StyledString** object. |
12898| style | Pointer to an **OH_Drawing_TextStyle** object. |
12899
12900
12901### OH_ArkUI_SwipeGesture_GetAngle()
12902
12903```
12904float OH_ArkUI_SwipeGesture_GetAngle (const ArkUI_GestureEvent * event)
12905```
12906**Description**
12907
12908Obtains the angle information of the swipe gesture.
12909
12910**Since**: 12
12911
12912**Parameters**
12913
12914| Name| Description|
12915| -------- | -------- |
12916| event | Gesture event. |
12917
12918**Returns**
12919
12920Returns the angle of the swipe gesture, which is the result obtained based on the aforementioned formula.
12921
12922
12923### OH_ArkUI_SwipeGesture_GetVelocity()
12924
12925```
12926float OH_ArkUI_SwipeGesture_GetVelocity (const ArkUI_GestureEvent * event)
12927```
12928**Description**
12929
12930Obtains the average velocity of all fingers used in the swipe gesture.
12931
12932**Since**: 12
12933
12934**Parameters**
12935
12936| Name| Description|
12937| -------- | -------- |
12938| event | Gesture event. |
12939
12940**Returns**
12941
12942Returns the average velocity of all fingers used in the swipe gesture, in px/s.
12943
12944
12945### OH_ArkUI_SwiperIndicator_Create()
12946
12947```
12948ArkUI_SwiperIndicator* OH_ArkUI_SwiperIndicator_Create (ArkUI_SwiperIndicatorType type)
12949```
12950**Description**
12951
12952Creates a navigation indicator for the Swiper component.
12953
12954**Since**: 12
12955
12956**Parameters**
12957
12958| Name| Description|
12959| -------- | -------- |
12960| type | Type of the navigation indicator. |
12961
12962**Returns**
12963
12964Returns the pointer to the navigation point indicator.
12965
12966
12967### OH_ArkUI_SwiperIndicator_Dispose()
12968
12969```
12970void OH_ArkUI_SwiperIndicator_Dispose (ArkUI_SwiperIndicator * indicator)
12971```
12972**Description**
12973
12974Disposes of the navigation point indicator of this **Swiper** component.
12975
12976**Since**: 12
12977
12978**Parameters**
12979
12980| Name| Description|
12981| -------- | -------- |
12982| indicator | Returns the pointer to the navigation point indicator. |
12983
12984
12985### OH_ArkUI_SwiperIndicator_GetBottomPosition()
12986
12987```
12988float OH_ArkUI_SwiperIndicator_GetBottomPosition (ArkUI_SwiperIndicator * indicator)
12989```
12990**Description**
12991
12992Obtains the distance between the navigation point indicator and the bottom edge of the **Swiper** component.
12993
12994**Since**: 12
12995
12996**Parameters**
12997
12998| Name| Description|
12999| -------- | -------- |
13000| indicator | Returns the pointer to the navigation point indicator. |
13001
13002**Returns**
13003
13004Returns the distance between a navigation point indicator and the bottom edge of the **Swiper** component.
13005
13006
13007### OH_ArkUI_SwiperIndicator_GetColor()
13008
13009```
13010uint32_t OH_ArkUI_SwiperIndicator_GetColor (ArkUI_SwiperIndicator * indicator)
13011```
13012**Description**
13013
13014Obtains the color of a navigation point indicator of the dot style of the **Swiper** component.
13015
13016**Since**: 12
13017
13018**Parameters**
13019
13020| Name| Description|
13021| -------- | -------- |
13022| indicator | Returns the pointer to the navigation point indicator. |
13023
13024**Returns**
13025
13026Returns the color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
13027
13028
13029### OH_ArkUI_SwiperIndicator_GetEndPosition()
13030
13031```
13032float OH_ArkUI_SwiperIndicator_GetEndPosition (ArkUI_SwiperIndicator * indicator)
13033```
13034**Description**
13035
13036Obtains the distance between a navigation point indicator and the right edge of the **Swiper** component.
13037
13038**Since**: 12
13039
13040**Parameters**
13041
13042| Name| Description|
13043| -------- | -------- |
13044| indicator | Returns the pointer to the navigation point indicator. |
13045
13046**Returns**
13047
13048Returns the distance between the navigation point indicator and the right edge of the **Swiper** component.
13049
13050
13051### OH_ArkUI_SwiperIndicator_GetItemHeight()
13052
13053```
13054float OH_ArkUI_SwiperIndicator_GetItemHeight (ArkUI_SwiperIndicator * indicator)
13055```
13056**Description**
13057
13058Obtains the height of a navigation point indicator of the dot style of the **Swiper** component.
13059
13060**Since**: 12
13061
13062**Parameters**
13063
13064| Name| Description|
13065| -------- | -------- |
13066| indicator | Returns the pointer to the navigation point indicator. |
13067
13068**Returns**
13069
13070Returns the height of the navigation point indicator of the dot style.
13071
13072
13073### OH_ArkUI_SwiperIndicator_GetItemWidth()
13074
13075```
13076float OH_ArkUI_SwiperIndicator_GetItemWidth (ArkUI_SwiperIndicator * indicator)
13077```
13078**Description**
13079
13080Obtains the width of a navigation point indicator of the dot style of the **Swiper** component.
13081
13082**Since**: 12
13083
13084**Parameters**
13085
13086| Name| Description|
13087| -------- | -------- |
13088| indicator | Returns the pointer to the navigation point indicator. |
13089
13090**Returns**
13091
13092Returns the width of the navigation point indicator of the dot style.
13093
13094
13095### OH_ArkUI_SwiperIndicator_GetMask()
13096
13097```
13098int32_t OH_ArkUI_SwiperIndicator_GetMask (ArkUI_SwiperIndicator * indicator)
13099```
13100**Description**
13101
13102Obtains whether the mask is enabled for a navigation point indicator of the dot style of the **Swiper** component.
13103
13104**Since**: 12
13105
13106**Parameters**
13107
13108| Name| Description|
13109| -------- | -------- |
13110| indicator | Returns the pointer to the navigation point indicator. |
13111
13112**Returns**
13113
13114Returns **1** if the mask is enabled; returns **0** otherwise.
13115
13116
13117### OH_ArkUI_SwiperIndicator_GetMaxDisplayCount()
13118
13119```
13120int32_t OH_ArkUI_SwiperIndicator_GetMaxDisplayCount (ArkUI_SwiperIndicator * indicator)
13121```
13122**Description**
13123
13124Obtains the maximum number of dots for the navigation point indicator of the dot style.
13125
13126**Since**: 12
13127
13128**Parameters**
13129
13130| Name| Description|
13131| -------- | -------- |
13132| indicator | Pointer to the navigation point indicator. |
13133
13134**Returns**
13135
13136Returns the maximum number of dots. The value ranges from 6 to 9.
13137
13138
13139### OH_ArkUI_SwiperIndicator_GetSelectedColor()
13140
13141```
13142uint32_t OH_ArkUI_SwiperIndicator_GetSelectedColor (ArkUI_SwiperIndicator * indicator)
13143```
13144**Description**
13145
13146Obtains the color of the selected navigation point indicator of the dot style of the **Swiper** component.
13147
13148**Since**: 12
13149
13150**Parameters**
13151
13152| Name| Description|
13153| -------- | -------- |
13154| indicator | Returns the pointer to the navigation point indicator. |
13155
13156**Returns**
13157
13158Returns the color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
13159
13160
13161### OH_ArkUI_SwiperIndicator_GetSelectedItemHeight()
13162
13163```
13164float OH_ArkUI_SwiperIndicator_GetSelectedItemHeight (ArkUI_SwiperIndicator * indicator)
13165```
13166**Description**
13167
13168Obtains the height of the selected navigation point indicator of the dot style of the **Swiper** component.
13169
13170**Since**: 12
13171
13172**Parameters**
13173
13174| Name| Description|
13175| -------- | -------- |
13176| indicator | Returns the pointer to the navigation point indicator. |
13177
13178**Returns**
13179
13180Returns the height of the navigation point indicator of the dot style.
13181
13182
13183### OH_ArkUI_SwiperIndicator_GetSelectedItemWidth()
13184
13185```
13186float OH_ArkUI_SwiperIndicator_GetSelectedItemWidth (ArkUI_SwiperIndicator * indicator)
13187```
13188**Description**
13189
13190Obtains the width of the selected navigation point indicator of the dot style of the **Swiper** component.
13191
13192**Since**: 12
13193
13194**Parameters**
13195
13196| Name| Description|
13197| -------- | -------- |
13198| indicator | Returns the pointer to the navigation point indicator. |
13199
13200**Returns**
13201
13202Returns the width of the navigation point indicator of the dot style.
13203
13204
13205### OH_ArkUI_SwiperIndicator_GetStartPosition()
13206
13207```
13208float OH_ArkUI_SwiperIndicator_GetStartPosition (ArkUI_SwiperIndicator * indicator)
13209```
13210**Description**
13211
13212Obtains the distance between a navigation point indicator and the left edge of the **Swiper** component.
13213
13214**Since**: 12
13215
13216**Parameters**
13217
13218| Name| Description|
13219| -------- | -------- |
13220| indicator | Returns the pointer to the navigation point indicator. |
13221
13222**Returns**
13223
13224Returns the distance between the navigation point indicator and the left edge of the **Swiper** component.
13225
13226
13227### OH_ArkUI_SwiperIndicator_GetTopPosition()
13228
13229```
13230float OH_ArkUI_SwiperIndicator_GetTopPosition (ArkUI_SwiperIndicator * indicator)
13231```
13232**Description**
13233
13234Obtains the distance between the navigation point indicator and the top edge of the **Swiper** component.
13235
13236**Since**: 12
13237
13238**Parameters**
13239
13240| Name| Description|
13241| -------- | -------- |
13242| indicator | Returns the pointer to the navigation point indicator. |
13243
13244**Returns**
13245
13246Returns the distance between a navigation point indicator and the top edge of the **Swiper** component.
13247
13248
13249### OH_ArkUI_SwiperIndicator_SetBottomPosition()
13250
13251```
13252void OH_ArkUI_SwiperIndicator_SetBottomPosition (ArkUI_SwiperIndicator * indicator, float value )
13253```
13254**Description**
13255
13256Distance between the navigation point indicator and the bottom edge of the **Swiper** component.
13257
13258**Since**: 12
13259
13260**Parameters**
13261
13262| Name| Description|
13263| -------- | -------- |
13264| indicator | Returns the pointer to the navigation point indicator. |
13265| value | Returns the distance between a navigation point indicator and the bottom edge of the **Swiper** component. |
13266
13267
13268### OH_ArkUI_SwiperIndicator_SetColor()
13269
13270```
13271void OH_ArkUI_SwiperIndicator_SetColor (ArkUI_SwiperIndicator * indicator, uint32_t color )
13272```
13273**Description**
13274
13275Sets the color of a navigation point indicator of the dot style for the **Swiper** component.
13276
13277**Since**: 12
13278
13279**Parameters**
13280
13281| Name| Description|
13282| -------- | -------- |
13283| indicator | Returns the pointer to the navigation point indicator. |
13284| color | Returns the color, in 0xARGB format. For example, 0xFFFF0000 indicates red. |
13285
13286
13287### OH_ArkUI_SwiperIndicator_SetEndPosition()
13288
13289```
13290void OH_ArkUI_SwiperIndicator_SetEndPosition (ArkUI_SwiperIndicator * indicator, float value )
13291```
13292**Description**
13293
13294Distance between the navigation point indicator and the left edge of the **Swiper** component.
13295
13296**Since**: 12
13297
13298**Parameters**
13299
13300| Name| Description|
13301| -------- | -------- |
13302| indicator | Returns the pointer to the navigation point indicator. |
13303| value | Returns the distance between the navigation point indicator and the right edge of the **Swiper** component. |
13304
13305
13306### OH_ArkUI_SwiperIndicator_SetItemHeight()
13307
13308```
13309void OH_ArkUI_SwiperIndicator_SetItemHeight (ArkUI_SwiperIndicator * indicator, float value )
13310```
13311**Description**
13312
13313Sets the height of a navigation point indicator of the dot style for the **Swiper** component.
13314
13315**Since**: 12
13316
13317**Parameters**
13318
13319| Name| Description|
13320| -------- | -------- |
13321| indicator | Returns the pointer to the navigation point indicator. |
13322| value | Returns the height of the navigation point indicator of the dot style. |
13323
13324
13325### OH_ArkUI_SwiperIndicator_SetItemWidth()
13326
13327```
13328void OH_ArkUI_SwiperIndicator_SetItemWidth (ArkUI_SwiperIndicator * indicator, float value )
13329```
13330**Description**
13331
13332Sets the width of a navigation point indicator of the dot style for the **Swiper** component.
13333
13334**Since**: 12
13335
13336**Parameters**
13337
13338| Name| Description|
13339| -------- | -------- |
13340| indicator | Returns the pointer to the navigation point indicator. |
13341| value | Returns the width of the navigation point indicator of the dot style. |
13342
13343
13344### OH_ArkUI_SwiperIndicator_SetMask()
13345
13346```
13347void OH_ArkUI_SwiperIndicator_SetMask (ArkUI_SwiperIndicator * indicator, int32_t mask )
13348```
13349**Description**
13350
13351Sets whether to enable the mask for a navigation point indicator of the dot style for the **Swiper** component.
13352
13353**Since**: 12
13354
13355**Parameters**
13356
13357| Name| Description|
13358| -------- | -------- |
13359| indicator | Pointer to a navigation point indicator. |
13360| mask | Whether to enable the mask. The value **1** means to enable the mask, and **0** means the opposite. |
13361
13362
13363### OH_ArkUI_SwiperIndicator_SetMaxDisplayCount()
13364
13365```
13366int32_t OH_ArkUI_SwiperIndicator_SetMaxDisplayCount (ArkUI_SwiperIndicator * indicator, int32_t maxDisplayCount )
13367```
13368**Description**
13369
13370Sets the maximum number of dots for the navigation point indicator of the dot style.
13371
13372**Since**: 12
13373
13374**Parameters**
13375
13376| Name| Description|
13377| -------- | -------- |
13378| indicator | Pointer to a navigation point indicator. |
13379| maxDisplayCount | Maximum number of navigation points. The value ranges from 6 to 9. |
13380
13381**Returns**
13382
13383Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if **maxDisplayCount** is set to an invalid value.
13384
13385
13386### OH_ArkUI_SwiperIndicator_SetSelectedColor()
13387
13388```
13389void OH_ArkUI_SwiperIndicator_SetSelectedColor (ArkUI_SwiperIndicator * indicator, uint32_t selectedColor )
13390```
13391**Description**
13392
13393Sets the color of the selected navigation point indicator of the dot style for the **Swiper** component.
13394
13395**Since**: 12
13396
13397**Parameters**
13398
13399| Name| Description|
13400| -------- | -------- |
13401| indicator | Pointer to a navigation point indicator. |
13402| selectedColor | Color, in 0xARGB format. For example, 0xFFFF0000 indicates red. |
13403
13404
13405### OH_ArkUI_SwiperIndicator_SetSelectedItemHeight()
13406
13407```
13408void OH_ArkUI_SwiperIndicator_SetSelectedItemHeight (ArkUI_SwiperIndicator * indicator, float value )
13409```
13410**Description**
13411
13412Sets the height of the selected navigation point indicator of the dot style for the **Swiper** component.
13413
13414**Since**: 12
13415
13416**Parameters**
13417
13418| Name| Description|
13419| -------- | -------- |
13420| indicator | Pointer to a navigation point indicator. |
13421| value | Height of the navigation point indicator of the dot style. |
13422
13423
13424### OH_ArkUI_SwiperIndicator_SetSelectedItemWidth()
13425
13426```
13427void OH_ArkUI_SwiperIndicator_SetSelectedItemWidth (ArkUI_SwiperIndicator * indicator, float value )
13428```
13429**Description**
13430
13431Sets the width of the selected navigation point indicator of the dot style for the **Swiper** component.
13432
13433**Since**: 12
13434
13435**Parameters**
13436
13437| Name| Description|
13438| -------- | -------- |
13439| indicator | Pointer to a navigation point indicator. |
13440| value | Width of the navigation point indicator of the dot style. |
13441
13442
13443### OH_ArkUI_SwiperIndicator_SetStartPosition()
13444
13445```
13446void OH_ArkUI_SwiperIndicator_SetStartPosition (ArkUI_SwiperIndicator * indicator, float value )
13447```
13448**Description**
13449
13450Sets the distance between the navigation point indicator and the left edge of the **Swiper** component.
13451
13452**Since**: 12
13453
13454**Parameters**
13455
13456| Name| Description|
13457| -------- | -------- |
13458| indicator | Pointer to a navigation point indicator. |
13459| value | Distance between the navigation point indicator and the left edge of the **Swiper** component. |
13460
13461
13462### OH_ArkUI_SwiperIndicator_SetTopPosition()
13463
13464```
13465void OH_ArkUI_SwiperIndicator_SetTopPosition (ArkUI_SwiperIndicator * indicator, float value )
13466```
13467**Description**
13468
13469Sets the distance between the navigation point indicator and the top edge of the **Swiper** component.
13470
13471**Since**: 12
13472
13473**Parameters**
13474
13475| Name| Description|
13476| -------- | -------- |
13477| indicator | Pointer to a navigation point indicator. |
13478| value | Distance between a navigation point indicator and the top edge of the **Swiper** component. |
13479
13480
13481### OH_ArkUI_SystemFontStyleEvent_GetFontSizeScale()
13482
13483```
13484float OH_ArkUI_SystemFontStyleEvent_GetFontSizeScale (const ArkUI_SystemFontStyleEvent * event)
13485```
13486**Description**
13487
13488Obtains the font size scale from the system font style change event.
13489
13490**Since**: 12
13491
13492**Parameters**
13493
13494| Name| Description|
13495| -------- | -------- |
13496| event | Pointer to the current system font style change event. |
13497
13498**Returns**
13499
13500Returns the font size scale after the change. Default value: **1.0**.
13501
13502
13503### OH_ArkUI_SystemFontStyleEvent_GetFontWeightScale()
13504
13505```
13506float OH_ArkUI_SystemFontStyleEvent_GetFontWeightScale (const ArkUI_SystemFontStyleEvent * event)
13507```
13508**Description**
13509
13510Obtains the font weight scale from the system font style change event.
13511
13512**Since**: 12
13513
13514**Parameters**
13515
13516| Name| Description|
13517| -------- | -------- |
13518| event | Pointer to the current system font style change event. |
13519
13520**Returns**
13521
13522Returns the font weight scale after the change. Default value: **1.0**.
13523
13524
13525### OH_ArkUI_TransitionEffect_Combine()
13526
13527```
13528int32_t OH_ArkUI_TransitionEffect_Combine (ArkUI_TransitionEffect * option, ArkUI_TransitionEffect * combine )
13529```
13530**Description**
13531
13532Sets a combination of transition effects.
13533
13534**Since**: 12
13535
13536**Parameters**
13537
13538| Name| Description|
13539| -------- | -------- |
13540| option | Transition effect options. |
13541| combine | Combination of transition effects. |
13542
13543**Returns**
13544
13545Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13546
13547
13548### OH_ArkUI_TransitionEffect_Dispose()
13549
13550```
13551void OH_ArkUI_TransitionEffect_Dispose (ArkUI_TransitionEffect * option)
13552```
13553**Description**
13554
13555Destroys a transition effect object.
13556
13557**Since**: 12
13558
13559**Parameters**
13560
13561| Name| Description|
13562| -------- | -------- |
13563| option | Transition effect object. |
13564
13565
13566### OH_ArkUI_TransitionEffect_SetAnimation()
13567
13568```
13569int32_t OH_ArkUI_TransitionEffect_SetAnimation (ArkUI_TransitionEffect * option, ArkUI_AnimateOption * animation )
13570```
13571**Description**
13572
13573Sets transition effect animation settings.
13574
13575**Since**: 12
13576
13577**Parameters**
13578
13579| Name| Description|
13580| -------- | -------- |
13581| option | Transition effect options. |
13582| animation | Animation settings. |
13583
13584**NOTE**
13585
13586If **combine** is used for combining transition effects, the animation settings of a transition effect are applicable to the one following it.
13587
13588**Returns**
13589
13590Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13591
13592
13593### OH_ArkUI_UnmarshallStyledStringDescriptor()
13594
13595```
13596int32_t OH_ArkUI_UnmarshallStyledStringDescriptor (uint8_t * buffer, size_t * bufferSize, ArkUI_StyledString_Descriptor * descriptor )
13597```
13598**Description**
13599
13600Deserializes a byte array containing styled string information into a styled string.
13601
13602**Since**: 14
13603
13604**Parameters**
13605
13606| Name| Description|
13607| -------- | -------- |
13608| buffer | Byte array to be deserialized. |
13609| bufferSize | Length of the byte array. |
13610| descriptor | Pointer to an **ArkUI_StyledString_Descriptor** object. |
13611
13612**Returns**
13613
13614Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13615
13616
13617### OH_ArkUI_UnregisterSystemColorModeChangeEvent()
13618
13619```
13620void OH_ArkUI_UnregisterSystemColorModeChangeEvent (ArkUI_NodeHandle node)
13621```
13622**Description**
13623
13624Unregisters the event listener for system color mode changes.
13625
13626**Since**: 12
13627
13628**Parameters**
13629
13630| Name| Description|
13631| -------- | -------- |
13632| node | Specified node. |
13633
13634
13635### OH_ArkUI_UnregisterSystemFontStyleChangeEvent()
13636
13637```
13638void OH_ArkUI_UnregisterSystemFontStyleChangeEvent (ArkUI_NodeHandle node)
13639```
13640**Description**
13641
13642Unregisters the event listener for system font style changes.
13643
13644**Since**: 12
13645
13646**Parameters**
13647
13648| Name| Description|
13649| -------- | -------- |
13650| node | Specified node. |
13651
13652
13653### OH_ArkUI_WaterFlowSectionOption_Create()
13654
13655```
13656ArkUI_WaterFlowSectionOption* OH_ArkUI_WaterFlowSectionOption_Create ()
13657```
13658**Description**
13659
13660Creates a water flow section configuration.
13661
13662**Since**: 12
13663
13664**Returns**
13665
13666Return the pointer to the created water flow section configuration.
13667
13668
13669### OH_ArkUI_WaterFlowSectionOption_Dispose()
13670
13671```
13672void OH_ArkUI_WaterFlowSectionOption_Dispose (ArkUI_WaterFlowSectionOption * option)
13673```
13674**Description**
13675
13676Disposes of the pointer to a water flow section configuration.
13677
13678**Since**: 12
13679
13680**Parameters**
13681
13682| Name| Description|
13683| -------- | -------- |
13684| option | Pointer to a water flow section configuration. |
13685
13686
13687### OH_ArkUI_WaterFlowSectionOption_GetColumnGap()
13688
13689```
13690float OH_ArkUI_WaterFlowSectionOption_GetColumnGap (ArkUI_WaterFlowSectionOption * option, int32_t index )
13691```
13692**Description**
13693
13694Obtains the gap between columns in the water flow section that matches the specified index.
13695
13696**Since**: 12
13697
13698**Parameters**
13699
13700| Name| Description|
13701| -------- | -------- |
13702| option | Pointer to a water flow section configuration. |
13703| index | Index of the target water flow section. |
13704
13705**Returns**
13706
13707Column spacing.
13708
13709
13710### OH_ArkUI_WaterFlowSectionOption_GetCrossCount()
13711
13712```
13713int32_t OH_ArkUI_WaterFlowSectionOption_GetCrossCount (ArkUI_WaterFlowSectionOption * option, int32_t index )
13714```
13715**Description**
13716
13717Obtains the number of columns (in a vertical layout) or rows (in a horizontal layout) of a water flow.
13718
13719**Since**: 12
13720
13721**Parameters**
13722
13723| Name| Description|
13724| -------- | -------- |
13725| option | Pointer to a water flow section configuration. |
13726| index | Index of the target water flow section. |
13727
13728**Returns**
13729
13730Returns the number of columns (in a vertical layout) or rows (in a horizontal layout) of a water flow.
13731
13732
13733### OH_ArkUI_WaterFlowSectionOption_GetItemCount()
13734
13735```
13736int32_t OH_ArkUI_WaterFlowSectionOption_GetItemCount (ArkUI_WaterFlowSectionOption * option, int32_t index )
13737```
13738**Description**
13739
13740Obtains the number of items in the water flow section that matches the specified index.
13741
13742**Since**: 12
13743
13744**Parameters**
13745
13746| Name| Description|
13747| -------- | -------- |
13748| option | Pointer to a water flow section configuration. |
13749| index | Index of the target water flow section. |
13750
13751**Returns**
13752
13753Returns the number of items in the water flow section.
13754
13755
13756### OH_ArkUI_WaterFlowSectionOption_GetMargin()
13757
13758```
13759ArkUI_Margin OH_ArkUI_WaterFlowSectionOption_GetMargin (ArkUI_WaterFlowSectionOption * option, int32_t index )
13760```
13761**Description**
13762
13763Obtains the margins of the water flow section that matches the specified index.
13764
13765**Since**: 12
13766
13767**Parameters**
13768
13769| Name| Description|
13770| -------- | -------- |
13771| option | Pointer to a water flow section configuration. |
13772| index | Index of the target water flow section. |
13773
13774**Returns**
13775
13776Returns the margins.
13777
13778
13779### OH_ArkUI_WaterFlowSectionOption_GetRowGap()
13780
13781```
13782float OH_ArkUI_WaterFlowSectionOption_GetRowGap (ArkUI_WaterFlowSectionOption * option, int32_t index )
13783```
13784**Description**
13785
13786Obtains the gap between rows in the water flow section that matches the specified index.
13787
13788**Since**: 12
13789
13790**Parameters**
13791
13792| Name| Description|
13793| -------- | -------- |
13794| option | Pointer to a water flow section configuration. |
13795| index | Index of the target water flow section. |
13796
13797**Returns**
13798
13799Returns the gap between rows.
13800
13801
13802### OH_ArkUI_WaterFlowSectionOption_GetSize()
13803
13804```
13805int32_t OH_ArkUI_WaterFlowSectionOption_GetSize (ArkUI_WaterFlowSectionOption * option)
13806```
13807**Description**
13808
13809Sets the array length for a water flow section configuration.
13810
13811**Since**: 12
13812
13813**Parameters**
13814
13815| Name| Description|
13816| -------- | -------- |
13817| option | Pointer to a water flow section configuration. |
13818
13819**Returns**
13820
13821Returns the array length. If **-1** is returned, an error code indicating failure is returned. The possible cause is that the **option** parameter is abnormal, for example, a null pointer.
13822
13823
13824### OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndex()
13825
13826```
13827void OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndex (ArkUI_WaterFlowSectionOption * option, int32_t index, float(*)(int32_t itemIndex) callback )
13828```
13829**Description**
13830
13831Obtains the main axis size of a specified item based on **flowItemIndex** through a water flow section configuration.
13832
13833**Since**: 12
13834
13835**Parameters**
13836
13837| Name| Description|
13838| -------- | -------- |
13839| option | Pointer to a water flow section configuration. |
13840| index | Index of the target water flow section. |
13841| callback | Callback used to return the result. |
13842
13843
13844### OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndexWithUserData()
13845
13846```
13847void OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndexWithUserData (ArkUI_WaterFlowSectionOption * option, int32_t index, void * userData, float(*)(int32_t itemIndex, void *userData) callback )
13848```
13849**Description**
13850
13851Obtains the main axis size of a specified item based on **flowItemIndex** through a water flow section configuration.
13852
13853**Since**: 12
13854
13855**Parameters**
13856
13857| Name| Description|
13858| -------- | -------- |
13859| option | Pointer to a water flow section configuration. |
13860| index | Index of the target water flow section. |
13861| userData | Custom data of the water flow item. |
13862| callback | Callback used to return the result. |
13863
13864
13865### OH_ArkUI_WaterFlowSectionOption_SetColumnGap()
13866
13867```
13868void OH_ArkUI_WaterFlowSectionOption_SetColumnGap (ArkUI_WaterFlowSectionOption * , int32_t index, float columnGap )
13869```
13870**Description**
13871
13872Sets the gap between columns in the specified water flow section.
13873
13874**Since**: 12
13875
13876**Parameters**
13877
13878| Name| Description|
13879| -------- | -------- |
13880| option | Pointer to a water flow section configuration. |
13881| index | Index of the target water flow section. |
13882| columnGap | Gap between columns. |
13883
13884
13885### OH_ArkUI_WaterFlowSectionOption_SetCrossCount()
13886
13887```
13888void OH_ArkUI_WaterFlowSectionOption_SetCrossCount (ArkUI_WaterFlowSectionOption * option, int32_t index, int32_t crossCount )
13889```
13890**Description**
13891
13892Sets the number of columns (in a vertical layout) or rows (in a horizontal layout) of a water flow.
13893
13894**Since**: 12
13895
13896**Parameters**
13897
13898| Name| Description|
13899| -------- | -------- |
13900| option | Pointer to a water flow section configuration. |
13901| index | Index of the target water flow section. |
13902| crossCount | Number of columns or rows, depending on the layout direction. |
13903
13904
13905### OH_ArkUI_WaterFlowSectionOption_SetItemCount()
13906
13907```
13908void OH_ArkUI_WaterFlowSectionOption_SetItemCount (ArkUI_WaterFlowSectionOption * option, int32_t index, int32_t itemCount )
13909```
13910**Description**
13911
13912Sets the number of items in a water flow section.
13913
13914**Since**: 12
13915
13916**Parameters**
13917
13918| Name| Description|
13919| -------- | -------- |
13920| option | Pointer to a water flow section configuration. |
13921| index | Index of the target water flow section. |
13922| itemCount | Number of items in the water flow section. |
13923
13924
13925### OH_ArkUI_WaterFlowSectionOption_SetMargin()
13926
13927```
13928void OH_ArkUI_WaterFlowSectionOption_SetMargin (ArkUI_WaterFlowSectionOption * option, int32_t index, float marginTop, float marginRight, float marginBottom, float marginLeft )
13929```
13930**Description**
13931
13932Sets the margins for the specified water flow section.
13933
13934**Since**: 12
13935
13936**Parameters**
13937
13938| Name| Description|
13939| -------- | -------- |
13940| option | Pointer to a water flow section configuration. |
13941| index | Index of the target water flow section. |
13942| marginTop | Top margin of the water flow section. |
13943| marginRight | Right margin of the water flow section. |
13944| marginBottom | Bottom margin of the water flow section. |
13945| marginLeft | Left margin of the water flow section. |
13946
13947
13948### OH_ArkUI_WaterFlowSectionOption_SetRowGap()
13949
13950```
13951void OH_ArkUI_WaterFlowSectionOption_SetRowGap (ArkUI_WaterFlowSectionOption * option, int32_t index, float rowGap )
13952```
13953**Description**
13954
13955Sets the gap between rows in the specified water flow section.
13956
13957**Since**: 12
13958
13959**Parameters**
13960
13961| Name| Description|
13962| -------- | -------- |
13963| option | Pointer to a water flow section configuration. |
13964| index | Index of the target water flow section. |
13965| rowGap | Gap between rows to set. |
13966
13967
13968### OH_ArkUI_WaterFlowSectionOption_SetSize()
13969
13970```
13971void OH_ArkUI_WaterFlowSectionOption_SetSize (ArkUI_WaterFlowSectionOption * option, int32_t size )
13972```
13973**Description**
13974
13975Sets the array length for a water flow section configuration.
13976
13977**Since**: 12
13978
13979**Parameters**
13980
13981| Name| Description|
13982| -------- | -------- |
13983| option | Pointer to a water flow section configuration. |
13984| size | Array length. |
13985