• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# ArkUI_NativeModule
2
3
4## Overview
5
6Provides drag and drop APIs of ArkUI on the native side.
7
8Provides the general key event APIs of ArkUI on the native side.
9
10Provides the APIs of ArkUI to register gesture callbacks on the native side.
11
12Provides animation callbacks of ArkUI on the native side.
13
14Provides UI capabilities of ArkUI on the native side, such as UI component creation and destruction, tree node operations, attribute setting, and event listening.
15
16**Since**: 12
17
18
19## Summary
20
21
22### Files
23
24| Name| Description|
25| -------- | -------- |
26| [drag_and_drop.h](drag__and__drop_8h.md) | Declares the APIs of **NativeDrag**. |
27| [drawable_descriptor.h](drawable__descriptor_8h.md) | Declares the APIs of **NativeDrawableDescriptor**. |
28| [native_animate.h](native__animate_8h.md) | Declares a set of animation APIs of ArkUI on the native side. |
29| [native_dialog.h](native__dialog_8h.md) | Declares a set of custom dialog box APIs of ArkUI on the native side. |
30| [native_gesture.h](native__gesture_8h.md) | Declares the APIs of **NativeGesture**. |
31| [native_interface.h](native__interface_8h.md) | Declares a unified entry for the native module APIs. |
32| [native_interface_focus.h](native__interface__focus_8h.md) | Declares the APIs of **NativeFocus**.|
33| [native_key_event.h](native__key_event_8h.md) | Declares the APIs of **NativeKeyEvent**. |
34| [native_node.h](native__node_8h.md) | Declares the APIs of **NativeNode**. |
35| [native_node_napi.h](native__node__napi_8h.md) | Declares the functions used to convert FrameNodes on the ArkTS side into NodeHandles. |
36| [native_type.h](native__type_8h.md) | Defines the common types for the native module. |
37| [styled_string.h](styled__string_8h.md) | Declares styled string APIs of ArkUI on the native side. |
38
39
40### Structs
41
42| Name| Description|
43| -------- | -------- |
44| struct  [ArkUI_ExpectedFrameRateRange](_ark_u_i___expected_frame_rate_range.md) | Defines a struct for the expected frame rate range of the animation. |
45| struct  [ArkUI_AnimateCompleteCallback](_ark_u_i___animate_complete_callback.md) | Defines a struct for the callback type for when the animation playback is complete. |
46| 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. |
47| 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. |
48| struct  [ArkUI_NativeGestureAPI_1](_ark_u_i___native_gesture_a_p_i__1.md) | Defines a struct for the gesture APIs. |
49| struct  [ArkUI_NativeGestureAPI_2](_ark_u_i___native_gesture_a_p_i__2.md) | Defines a new struct for the gesture APIs.|
50| struct  [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) | Defines the general input parameter structure of the **setAttribute** function. |
51| struct  [ArkUI_NodeComponentEvent](_ark_u_i___node_component_event.md) | Defines a struct for the parameter type of the component callback event. |
52| struct  [ArkUI_StringAsyncEvent](_ark_u_i___string_async_event.md) | Defines the string type parameter used by the component callback event. |
53| 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. |
54| struct  [ArkUI_ContextCallback](_ark_u_i___context_callback.md) | Defines event callback. |
55| union  [ArkUI_NumberValue](union_ark_u_i___number_value.md) | Provides the number types of ArkUI in the native code. |
56| 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. |
57| 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. |
58| struct  [ArkUI_ColorStop](_ark_u_i___color_stop.md) | Defines a gradient color stop. |
59| struct  [ArkUI_Rect](_ark_u_i___rect.md) | Defines a mask area. |
60| struct  [ArkUI_IntSize](_ark_u_i___int_size.md) | Describes the width and height of a component. |
61| struct  [ArkUI_IntOffset](_ark_u_i___int_offset.md) | Describes the position of a component. |
62| struct  [ArkUI_Margin](_ark_u_i___margin.md) | Describes the margins of a component. |
63| struct  [ArkUI_TranslationOptions](_ark_u_i___translation_options.md) | Defines the translation options for component transition. |
64| struct  [ArkUI_ScaleOptions](_ark_u_i___scale_options.md) | Defines the scaling options for component transition. |
65| struct  [ArkUI_RotationOptions](_ark_u_i___rotation_options.md) | Defines the rotation options for component transition. |
66
67
68### Macros
69
70| Name| Description|
71| -------- | -------- |
72| [OH_ArkUI_GetModuleInterface](#oh_arkui_getmoduleinterface)(nativeAPIVariantKind, structType, structPtr) | Obtains the macro function corresponding to a struct pointer based on the struct type. |
73| **MAX_NODE_SCOPE_NUM** | 1000 |
74| **MAX_COMPONENT_EVENT_ARG_NUM** | 12 |
75| **UDMF_KEY_BUFFER_LEN** | 512 |
76
77
78### Types
79
80| Name| Description|
81| -------- | -------- |
82| typedef struct [ArkUI_NodeEvent](#arkui_nodeevent-12) [ArkUI_NodeEvent](#arkui_nodeevent-12) | Defines a struct for a component event. |
83| typedef struct [ArkUI_Context](#arkui_context) [ArkUI_Context](#arkui_context) | Defines a struct for a UI context object. |
84| typedef struct [ArkUI_Context](#arkui_context) \* [ArkUI_ContextHandle](#arkui_contexthandle-12) | Defines a struct for the handle to the ArkUI native UI context. |
85| typedef struct [ArkUI_DragEvent](#arkui_dragevent) [ArkUI_DragEvent](#arkui_dragevent) | Defines a struct for a drag event. |
86| typedef struct [ArkUI_DragPreviewOption](#arkui_dragpreviewoption) [ArkUI_DragPreviewOption](#arkui_dragpreviewoption) | Defines a struct for custom drag preview options. |
87| typedef struct [ArkUI_DragAction](#arkui_dragaction) [ArkUI_DragAction](#arkui_dragaction) | Defines a struct for a drag action. |
88| typedef struct [ArkUI_DragAndDropInfo](#arkui_draganddropinfo) [ArkUI_DragAndDropInfo](#arkui_draganddropinfo) | Defines a struct for drag and drop information returned through a drag status listener. |
89| typedef struct [OH_UdmfData](#oh_udmfdata) [OH_UdmfData](#oh_udmfdata) | Defines a struct for UDMF unified data. |
90| 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. |
91| typedef struct [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) [ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) | Defines a struct for the **DrawableDescriptor** object. |
92| typedef struct [OH_PixelmapNative](#oh_pixelmapnative) \* [OH_PixelmapNativeHandle](#oh_pixelmapnativehandle) | Defines a struct for the pointer to an **OH_PixelmapNative** object. |
93| typedef struct [ArkUI_AnimateOption](#arkui_animateoption) [ArkUI_AnimateOption](#arkui_animateoption) | Defines a struct for the animation configuration. |
94| typedef struct ArkUI_Curve \* [ArkUI_CurveHandle](#arkui_curvehandle) | Defines a struct for the pointer to an interpolation curve. |
95| typedef struct [ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) [ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) | Defines a struct for the keyframe animation parameter object. |
96| typedef struct [ArkUI_AnimatorOption](#arkui_animatoroption) [ArkUI_AnimatorOption](#arkui_animatoroption) | Defines the animator parameter object. |
97| typedef struct ArkUI_Animator \* [ArkUI_AnimatorHandle](#arkui_animatorhandle) | Defines a struct for the pointer to an animator object. |
98| typedef struct [ArkUI_TransitionEffect](#arkui_transitioneffect) [ArkUI_TransitionEffect](#arkui_transitioneffect) | Defines a struct for the transition effect. |
99| typedef bool(\* [ArkUI_OnWillDismissEvent](#arkui_onwilldismissevent)) (int32_t reason) | Defines a pointer to the callback invoked when the dialog box is closed. |
100| typedef struct [ArkUI_DialogDismissEvent](#arkui_dialogdismissevent) [ArkUI_DialogDismissEvent](#arkui_dialogdismissevent) | Defines a struct for a dialog box dismiss event. |
101| typedef struct [ArkUI_CustomDialogOptions ](#arkui_customdialogoptions) [ArkUI_CustomDialogOptions ](#arkui_customdialogoptions) | Defines a struct for custom dialog box options. |
102| typedef uint32_t [ArkUI_GestureEventActionTypeMask](#arkui_gestureeventactiontypemask) | Defines a set of gesture event types. |
103| typedef uint32_t [ArkUI_GestureDirectionMask](#arkui_gesturedirectionmask) | Defines a set of gesture directions. |
104| typedef ArkUI_GestureRecognizer \* [ArkUI_GestureRecognizerHandle](#arkui_gesturerecognizerhandle) | Defines the gesture recognizer handle. |
105| typedef [ArkUI_GestureRecognizerHandle](#arkui_gesturerecognizerhandle) \* [ArkUI_GestureRecognizerHandleArray](#arkui_gesturerecognizerhandlearray) | Defines the gesture recognizer handle array. |
106| typedef ArkUI_TouchRecognizer  \* [ArkUI_TouchRecognizerHandle](#arkui_touchrecognizerhandle) | Defines a gesture recognizer handle. |
107| typedef [ArkUI_TouchRecognizerHandle](#arkui_touchrecognizerhandle) \* [ArkUI_TouchRecognizerHandleArray](#arkui_touchrecognizerhandlearray) | Defines an array of gesture recognizer handles. |
108| 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. |
109| typedef struct [ArkUI_ParallelInnerGestureEvent](#arkui_parallelinnergestureevent) [ArkUI_ParallelInnerGestureEvent](#arkui_parallelinnergestureevent) | Defines a parallel internal gesture event. |
110| typedef void(\* [ArkUI_GestureRecognizerDestructNotifyCallback](#arkui_gesturerecognizerdestructnotifycallback)) (ArkUI_GestureRecognizer \*recognizer, void \*userData) | Defines a callback function for notifying gesture recognizer destruction. |
111| typedef struct [ArkUI_NodeEvent](#arkui_nodeevent-12) [ArkUI_NodeEvent](#arkui_nodeevent-12) | Defines the common structure of a component event. |
112| typedef struct [ArkUI_NodeCustomEvent](#arkui_nodecustomevent) [ArkUI_NodeCustomEvent](#arkui_nodecustomevent) | Defines the common structure of a custom component event. |
113| typedef struct ArkUI_NodeAdapter \* [ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) | Defines the component adapter, which is used for lazy loading of elements of scrollable components. |
114| typedef struct [ArkUI_NodeAdapterEvent](#arkui_nodeadapterevent) [ArkUI_NodeAdapterEvent](#arkui_nodeadapterevent) | Defines the component adapter event. |
115| typedef struct [ArkUI_NodeContentEvent](#arkui_nodecontentevent) [ArkUI_NodeContentEvent](#arkui_nodecontentevent) | Defines the common structure type of a NodeContent event. |
116| typedef void(\* [ArkUI_NodeContentCallback](#arkui_nodecontentcallback)) ([ArkUI_NodeContentEvent](#arkui_nodecontentevent) \*event) | Defines the callback for the NodeContent event. |
117| typedef struct [ArkUI_LayoutConstraint](#arkui_layoutconstraint) [ArkUI_LayoutConstraint](#arkui_layoutconstraint) | Defines the size constraints of a component during component layout. |
118| typedef struct [ArkUI_DrawContext](#arkui_drawcontext) [ArkUI_DrawContext](#arkui_drawcontext) | Defines the component drawing context. |
119| typedef struct ArkUI_Node \* [ArkUI_NodeHandle](#arkui_nodehandle) | Defines the pointer to the ArkUI native component object. |
120| typedef struct ArkUI_NativeDialog \* [ArkUI_NativeDialogHandle](#arkui_nativedialoghandle) | Defines the handle to the custom dialog box controller of ArkUI on the native side. |
121| typedef struct [ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) [ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) | Defines the water flow section configuration. |
122| typedef struct [ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) [ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) | Defines the item configuration for **ListItemSwipeActionOption**. |
123| typedef struct [ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) [ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) | Defines the configuration for **ListItemSwipeActionOption**. |
124| typedef struct [ArkUI_Context](#arkui_context) \* [ArkUI_ContextHandle](#arkui_contexthandle-12) | Defines the handle to the ArkUI native UI context. |
125| typedef struct ArkUI_NodeContent \* [ArkUI_NodeContentHandle](#arkui_nodecontenthandle) | Defines the handle to the ArkUI NodeContent instance on the native side. |
126| typedef struct [ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) [ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) | Defines the alignment rule in the relative container. |
127| typedef struct [ArkUI_GuidelineOption](#arkui_guidelineoption) [ArkUI_GuidelineOption](#arkui_guidelineoption) | Defines the ID, direction, and position of a guideline. |
128| typedef struct [ArkUI_BarrierOption](#arkui_barrieroption) [ArkUI_BarrierOption](#arkui_barrieroption) | Defines the ID, direction, and referenced component of a barrier. |
129| typedef struct [ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) [ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) | Defines the image frame information. |
130| typedef struct [ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) [ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) | Defines the **ChildrenMainSize** information of the **List** component. |
131| typedef struct [ArkUI_AccessibilityState](#arkui_accessibilitystate) [ArkUI_AccessibilityState](#arkui_accessibilitystate) | Defines a struct for the component accessibility state. |
132| typedef struct [ArkUI_AccessibilityValue](#arkui_accessibilityvalue) [ArkUI_AccessibilityValue](#arkui_accessibilityvalue) | Defines a struct for the component accessibility value. |
133| typedef struct [ArkUI_SystemFontStyleEvent](#arkui_systemfontstyleevent) [ArkUI_SystemFontStyleEvent](#arkui_systemfontstyleevent) | Defines a struct for the system font style event. |
134| typedef struct [ArkUI_CustomSpanMeasureInfo](#arkui_customspanmeasureinfo) [ArkUI_CustomSpanMeasureInfo](#arkui_customspanmeasureinfo) | Defines a struct for the measurement information of a custom span. |
135| typedef struct [ArkUI_CustomSpanMetrics](#arkui_customspanmetrics) [ArkUI_CustomSpanMetrics](#arkui_customspanmetrics) | Defines a struct for the measurement metrics of a custom span. |
136| typedef struct [ArkUI_CustomSpanDrawInfo](#arkui_customspandrawinfo) [ArkUI_CustomSpanDrawInfo](#arkui_customspandrawinfo) | Defines a struct for the drawing information of a custom span. |
137| typedef struct [ArkUI_SwiperIndicator](#arkui_swiperindicator) [ArkUI_SwiperIndicator](#arkui_swiperindicator) | Defines the navigation indicator style of the **Swiper** component. |
138| 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. |
139| typedef struct [ArkUI_StyledString](#arkui_styledstring) [ArkUI_StyledString](#arkui_styledstring) | Defines a struct for the styled string object supported by the text component. |
140| typedef struct [OH_UdmfGetDataParams](#oh_udmfgetdataparams) [OH_UdmfGetDataParams](#oh_udmfgetdataparams) | Defines a struct for parameters used for obtaining data from UDMF. |
141| typedef struct [ArkUI_ProgressLinearStyleOption](#arkui_progresslinearstyleoption) [ArkUI_ProgressLinearStyleOption](#arkui_progresslinearstyleoption) | Defines the style object for a linear progress indicator.|
142| typedef struct [ArkUI_VisibleAreaEventOptions](#arkui_visibleareaeventoptions) [ArkUI_VisibleAreaEventOptions](#arkui_visibleareaeventoptions) | Defines a struct for visible area change event parameters. |
143
144
145### Enums
146
147| Name| Description|
148| -------- | -------- |
149| [ArkUI_DragResult](#arkui_dragresult) { ARKUI_DRAG_RESULT_SUCCESSFUL = 0, 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. |
150| [ArkUI_DropOperation](#arkui_dropoperation) { ARKUI_DROP_OPERATION_COPY = 0, ARKUI_DROP_OPERATION_MOVE } | Defines an enum for data processing modes used when data is dropped, which affects the display of the badge. |
151| [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. |
152| [ArkUI_DragPreviewScaleMode](#arkui_dragpreviewscalemode) { ARKUI_DRAG_PREVIEW_SCALE_AUTO = 0, ARKUI_DRAG_PREVIEW_SCALE_DISABLED } | Defines an enum for drag preview scale modes. |
153| [ArkUI_DragStatus](#arkui_dragstatus) { ARKUI_DRAG_STATUS_UNKNOWN = -1, ARKUI_DRAG_STATUS_STARTED, ARKUI_DRAG_STATUS_ENDED } | Enumerates dragging states. |
154| [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. |
155| [ArkUI_LevelMode](#arkui_levelmode) { ARKUI_LEVEL_MODE_OVERLAY = 0, ARKUI_LEVEL_MODE_EMBEDDED } | Enumerates the display levels of the dialog box. |
156| [ArkUI_ImmersiveMode](#arkui_immersivemode) { ARKUI_IMMERSIVE_MODE_DEFAULT = 0, ARKUI_IMMERSIVE_MODE_EXTEND } | Enumerates the display areas of the embedded dialog box overlay. |
157| [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. |
158| [ArkUI_GesturePriority](#arkui_gesturepriority) { NORMAL = 0, PRIORITY = 1, PARALLEL = 2 } | Enumerates gesture event modes. |
159| [ArkUI_GroupGestureMode](#arkui_groupgesturemode) { SEQUENTIAL_GROUP = 0, PARALLEL_GROUP = 1, EXCLUSIVE_GROUP = 2 } | Enumerates gesture group modes. |
160| [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. |
161| [ArkUI_GestureMask](#arkui_gesturemask) { NORMAL_GESTURE_MASK = 0, IGNORE_INTERNAL_GESTURE_MASK } | Enumerates gesture masking modes. |
162| [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. |
163| [ArkUI_GestureInterruptResult](#arkui_gestureinterruptresult) { GESTURE_INTERRUPT_RESULT_CONTINUE = 0, GESTURE_INTERRUPT_RESULT_REJECT } | Enumerates gesture interruption results. |
164| [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. |
165| [ArkUI_NativeAPIVariantKind](#arkui_nativeapivariantkind) { ARKUI_NATIVE_NODE, ARKUI_NATIVE_DIALOG, ARKUI_NATIVE_GESTURE, ARKUI_NATIVE_ANIMATE } | Defines the native API types. |
166| [ArkUI_KeyCode](#arkui_keycode) {<br>ARKUI_KEYCODE_UNKNOWN = -1, ARKUI_KEYCODE_FN = 0, ARKUI_KEYCODE_VOLUME_UP = 16, ARKUI_KEYCODE_VOLUME_DOWN = 17,<br>ARKUI_KEYCODE_POWER = 18, ARKUI_KEYCODE_CAMERA = 19, ARKUI_KEYCODE_VOLUME_MUTE = 22, ARKUI_KEYCODE_MUTE = 23,<br>ARKUI_KEYCODE_BRIGHTNESS_UP = 40, ARKUI_KEYCODE_BRIGHTNESS_DOWN = 41, ARKUI_KEYCODE_0 = 2000, ARKUI_KEYCODE_1 = 2001,<br>ARKUI_KEYCODE_2 = 2002, ARKUI_KEYCODE_3 = 2003, ARKUI_KEYCODE_4 = 2004, ARKUI_KEYCODE_5 = 2005,<br>ARKUI_KEYCODE_6 = 2006, ARKUI_KEYCODE_7 = 2007, ARKUI_KEYCODE_8 = 2008, ARKUI_KEYCODE_9 = 2009,<br>ARKUI_KEYCODE_STAR = 2010, ARKUI_KEYCODE_POUND = 2011, ARKUI_KEYCODE_DPAD_UP = 2012, ARKUI_KEYCODE_DPAD_DOWN = 2013,<br>ARKUI_KEYCODE_DPAD_LEFT = 2014, ARKUI_KEYCODE_DPAD_RIGHT = 2015, ARKUI_KEYCODE_DPAD_CENTER = 2016, ARKUI_KEYCODE_A = 2017,<br>ARKUI_KEYCODE_B = 2018, ARKUI_KEYCODE_C = 2019, ARKUI_KEYCODE_D = 2020, ARKUI_KEYCODE_E = 2021,<br>ARKUI_KEYCODE_F = 2022, ARKUI_KEYCODE_G = 2023, ARKUI_KEYCODE_H = 2024, ARKUI_KEYCODE_I = 2025,<br>ARKUI_KEYCODE_J = 2026, ARKUI_KEYCODE_K = 2027, ARKUI_KEYCODE_L = 2028, ARKUI_KEYCODE_M = 2029,<br>ARKUI_KEYCODE_N = 2030, ARKUI_KEYCODE_O = 2031, ARKUI_KEYCODE_P = 2032, ARKUI_KEYCODE_Q = 2033,<br>ARKUI_KEYCODE_R = 2034, ARKUI_KEYCODE_S = 2035, ARKUI_KEYCODE_T = 2036, ARKUI_KEYCODE_U = 2037,<br>ARKUI_KEYCODE_V = 2038, ARKUI_KEYCODE_W = 2039, ARKUI_KEYCODE_X = 2040, ARKUI_KEYCODE_Y = 2041,<br>ARKUI_KEYCODE_Z = 2042, ARKUI_KEYCODE_COMMA = 2043, ARKUI_KEYCODE_PERIOD = 2044, ARKUI_KEYCODE_ALT_LEFT = 2045,<br>ARKUI_KEYCODE_ALT_RIGHT = 2046, ARKUI_KEYCODE_SHIFT_LEFT = 2047, ARKUI_KEYCODE_SHIFT_RIGHT = 2048, ARKUI_KEYCODE_TAB = 2049,<br>ARKUI_KEYCODE_SPACE = 2050, ARKUI_KEYCODE_SYM = 2051, ARKUI_KEYCODE_EXPLORER = 2052, ARKUI_KEYCODE_ENVELOPE = 2053,<br>ARKUI_KEYCODE_ENTER = 2054, ARKUI_KEYCODE_DEL = 2055, ARKUI_KEYCODE_GRAVE = 2056, ARKUI_KEYCODE_MINUS = 2057,<br>ARKUI_KEYCODE_EQUALS = 2058, ARKUI_KEYCODE_LEFT_BRACKET = 2059, ARKUI_KEYCODE_RIGHT_BRACKET = 2060, ARKUI_KEYCODE_BACKSLASH = 2061,<br>ARKUI_KEYCODE_SEMICOLON = 2062, ARKUI_KEYCODE_APOSTROPHE = 2063, ARKUI_KEYCODE_SLASH = 2064, ARKUI_KEYCODE_AT = 2065,<br>ARKUI_KEYCODE_PLUS = 2066, ARKUI_KEYCODE_MENU = 2067, ARKUI_KEYCODE_PAGE_UP = 2068, ARKUI_KEYCODE_PAGE_DOWN = 2069,<br>ARKUI_KEYCODE_ESCAPE = 2070, ARKUI_KEYCODE_FORWARD_DEL = 2071, ARKUI_KEYCODE_CTRL_LEFT = 2072, ARKUI_KEYCODE_CTRL_RIGHT = 2073,<br>ARKUI_KEYCODE_CAPS_LOCK = 2074, ARKUI_KEYCODE_SCROLL_LOCK = 2075, ARKUI_KEYCODE_META_LEFT = 2076, ARKUI_KEYCODE_META_RIGHT = 2077,<br>ARKUI_KEYCODE_FUNCTION = 2078, ARKUI_KEYCODE_SYSRQ = 2079, ARKUI_KEYCODE_BREAK = 2080, ARKUI_KEYCODE_MOVE_HOME = 2081,<br>ARKUI_KEYCODE_MOVE_END = 2082, ARKUI_KEYCODE_INSERT = 2083, ARKUI_KEYCODE_FORWARD = 2084, ARKUI_KEYCODE_MEDIA_PLAY = 2085,<br>ARKUI_KEYCODE_MEDIA_PAUSE = 2086, ARKUI_KEYCODE_MEDIA_CLOSE = 2087, ARKUI_KEYCODE_MEDIA_EJECT = 2088, ARKUI_KEYCODE_MEDIA_RECORD = 2089,<br>ARKUI_KEYCODE_F1 = 2090, ARKUI_KEYCODE_F2 = 2091, ARKUI_KEYCODE_F3 = 2092, ARKUI_KEYCODE_F4 = 2093,<br>ARKUI_KEYCODE_F5 = 2094, ARKUI_KEYCODE_F6 = 2095, ARKUI_KEYCODE_F7 = 2096, ARKUI_KEYCODE_F8 = 2097,<br>ARKUI_KEYCODE_F9 = 2098, ARKUI_KEYCODE_F10 = 2099, ARKUI_KEYCODE_F11 = 2100, ARKUI_KEYCODE_F12 = 2101,<br>ARKUI_KEYCODE_NUM_LOCK = 2102, ARKUI_KEYCODE_NUMPAD_0 = 2103, ARKUI_KEYCODE_NUMPAD_1 = 2104, ARKUI_KEYCODE_NUMPAD_2 = 2105,<br>ARKUI_KEYCODE_NUMPAD_3 = 2106, ARKUI_KEYCODE_NUMPAD_4 = 2107, ARKUI_KEYCODE_NUMPAD_5 = 2108, ARKUI_KEYCODE_NUMPAD_6 = 2109,<br>ARKUI_KEYCODE_NUMPAD_7 = 2110, ARKUI_KEYCODE_NUMPAD_8 = 2111, ARKUI_KEYCODE_NUMPAD_9 = 2112, ARKUI_KEYCODE_NUMPAD_DIVIDE = 2113,<br>ARKUI_KEYCODE_NUMPAD_MULTIPLY = 2114, ARKUI_KEYCODE_NUMPAD_SUBTRACT = 2115, ARKUI_KEYCODE_NUMPAD_ADD = 2116, ARKUI_KEYCODE_NUMPAD_DOT = 2117,<br>ARKUI_KEYCODE_NUMPAD_COMMA = 2118, ARKUI_KEYCODE_NUMPAD_ENTER = 2119, ARKUI_KEYCODE_NUMPAD_EQUALS = 2120, ARKUI_KEYCODE_NUMPAD_LEFT_PAREN = 2121,<br>ARKUI_KEYCODE_NUMPAD_RIGHT_PAREN = 2122<br>} | Enumerates the key codes for key events. |
167| [ArkUI_KeyEventType](#arkui_keyeventtype) {<br>ARKUI_KEY_EVENT_UNKNOWN = -1, ARKUI_KEY_EVENT_DOWN = 0, ARKUI_KEY_EVENT_UP = 1, ARKUI_KEY_EVENT_LONG_PRESS = 2,<br>ARKUI_KEY_EVENT_CLICK = 3<br>} | Enumerates the types of key events. |
168| [ArkUI_KeySourceType](#arkui_keysourcetype) { ARKUI_KEY_SOURCE_UNKNOWN = 0, ARKUI_KEY_SOURCE_TYPE_MOUSE = 1, ARKUI_KEY_SOURCE_TYPE_KEYBOARD = 4, ARKUI_KEY_SOURCE_TYPE_JOYSTICK = 5 } | Enumerates the types of input devices that trigger key events. |
169| [ArkUI_KeyIntension](#arkui_keyintension) {<br>ARKUI_KEY_INTENSION_UNKNOWN = -1, ARKUI_KEY_INTENSION_UP = 1, ARKUI_KEY_INTENSION_DOWN = 2, ARKUI_KEY_INTENSION_LEFT = 3,<br>ARKUI_KEY_INTENSION_RIGHT = 4, ARKUI_KEY_INTENSION_SELECT = 5, ARKUI_KEY_INTENSION_ESCAPE = 6, ARKUI_KEY_INTENSION_BACK = 7,<br>ARKUI_KEY_INTENSION_FORWARD = 8, ARKUI_KEY_INTENSION_MENU = 9, ARKUI_KEY_INTENSION_HOME = 10, ARKUI_KEY_INTENSION_PAGE_UP = 11,<br>ARKUI_KEY_INTENSION_PAGE_DOWN = 12, ARKUI_KEY_INTENSION_ZOOM_OUT = 13, ARKUI_KEY_INTENSION_ZOOM_IN = 14, ARKUI_KEY_INTENTION_MEDIA_PLAY_PAUSE = 100,<br>ARKUI_KEY_INTENTION_MEDIA_FAST_FORWARD = 101, ARKUI_KEY_INTENTION_MEDIA_FAST_PLAYBACK = 103, ARKUI_KEY_INTENTION_MEDIA_NEXT = 104, ARKUI_KEY_INTENTION_MEDIA_PREVIOUS = 105,<br>ARKUI_KEY_INTENTION_MEDIA_MUTE = 106, ARKUI_KEY_INTENTION_VOLUME_UP = 107, ARKUI_KEY_INTENTION_VOLUME_DOWN = 108, ARKUI_KEY_INTENTION_CALL = 200,<br>ARKUI_KEY_INTENTION_CAMERA = 300<br>} | Enumerates the intentions corresponding to key events. |
170| [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_XCOMPONENT_TEXTURE = 20,<br>ARKUI_NODE_CHECKBOX_GROUP = 21,<br>ARKUI_NODE_STACK = MAX_NODE_SCOPE_NUM, ARKUI_NODE_SWIPER, ARKUI_NODE_SCROLL,<br>ARKUI_NODE_LIST, ARKUI_NODE_LIST_ITEM, ARKUI_NODE_LIST_ITEM_GROUP, ARKUI_NODE_COLUMN,<br>ARKUI_NODE_ROW, ARKUI_NODE_FLEX, ARKUI_NODE_REFRESH, ARKUI_NODE_WATER_FLOW,<br>ARKUI_NODE_FLOW_ITEM, ARKUI_NODE_RELATIVE_CONTAINER, ARKUI_NODE_GRID, ARKUI_NODE_GRID_ITEM,<br>ARKUI_NODE_CUSTOM_SPAN<br>} | Enumerates ArkUI component types that can be created on the native side. |
171| [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, NODE_FOCUS_BOX = 96,<br>NODE_CLICK_DISTANCE = 97, NODE_TAB_STOP = 98, NODE_BACKGROUND_IMAGE_RESIZABLE_WITH_SLICE = 100, NODE_NEXT_FOCUS = 101, NODE_VISIBLE_AREA_APPROXIMATE_CHANGE_RATIO = 102, NODE_TEXT_CONTENT = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TEXT, NODE_FONT_COLOR,<br>NODE_FONT_SIZE, NODE_FONT_STYLE, NODE_FONT_WEIGHT, NODE_TEXT_LINE_HEIGHT,<br>NODE_TEXT_DECORATION, NODE_TEXT_CASE, NODE_TEXT_LETTER_SPACING, NODE_TEXT_MAX_LINES,<br>NODE_TEXT_ALIGN, NODE_TEXT_OVERFLOW, NODE_FONT_FAMILY, NODE_TEXT_COPY_OPTION,<br>NODE_TEXT_BASELINE_OFFSET, NODE_TEXT_TEXT_SHADOW, NODE_TEXT_MIN_FONT_SIZE, NODE_TEXT_MAX_FONT_SIZE,<br>NODE_TEXT_FONT, NODE_TEXT_HEIGHT_ADAPTIVE_POLICY, NODE_TEXT_INDENT, NODE_TEXT_WORD_BREAK,<br>NODE_TEXT_ELLIPSIS_MODE, NODE_TEXT_LINE_SPACING, NODE_FONT_FEATURE, NODE_TEXT_ENABLE_DATA_DETECTOR,<br>NODE_TEXT_ENABLE_DATA_DETECTOR_CONFIG, NODE_TEXT_SELECTED_BACKGROUND_COLOR, NODE_TEXT_CONTENT_WITH_STYLED_STRING, NODE_TEXT_HALF_LEADING = 1029,NODE_IMMUTABLE_FONT_WEIGHT = 1030,<br>NODE_SPAN_CONTENT = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_SPAN, NODE_SPAN_TEXT_BACKGROUND_STYLE, NODE_SPAN_BASELINE_OFFSET, NODE_IMAGE_SPAN_SRC = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_IMAGE_SPAN,<br>NODE_IMAGE_SPAN_VERTICAL_ALIGNMENT, NODE_IMAGE_SPAN_ALT, NODE_IMAGE_SPAN_BASELINE_OFFSET = 3003, NODE_IMAGE_SRC = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_IMAGE,<br>NODE_IMAGE_OBJECT_FIT, NODE_IMAGE_INTERPOLATION, NODE_IMAGE_OBJECT_REPEAT, NODE_IMAGE_COLOR_FILTER,<br>NODE_IMAGE_AUTO_RESIZE, NODE_IMAGE_ALT, NODE_IMAGE_DRAGGABLE, NODE_IMAGE_RENDER_MODE,<br>NODE_IMAGE_FIT_ORIGINAL_SIZE, NODE_IMAGE_FILL_COLOR, NODE_IMAGE_RESIZABLE, NODE_TOGGLE_SELECTED_COLOR = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TOGGLE,<br>NODE_TOGGLE_SWITCH_POINT_COLOR, NODE_TOGGLE_VALUE, NODE_TOGGLE_UNSELECTED_COLOR, NODE_LOADING_PROGRESS_COLOR = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_LOADING_PROGRESS,<br>NODE_LOADING_PROGRESS_ENABLE_LOADING, NODE_TEXT_INPUT_PLACEHOLDER = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TEXT_INPUT, NODE_TEXT_INPUT_TEXT, NODE_TEXT_INPUT_CARET_COLOR,<br>NODE_TEXT_INPUT_CARET_STYLE, NODE_TEXT_INPUT_SHOW_UNDERLINE, NODE_TEXT_INPUT_MAX_LENGTH, NODE_TEXT_INPUT_ENTER_KEY_TYPE,<br>NODE_TEXT_INPUT_PLACEHOLDER_COLOR, NODE_TEXT_INPUT_PLACEHOLDER_FONT, NODE_TEXT_INPUT_ENABLE_KEYBOARD_ON_FOCUS, NODE_TEXT_INPUT_TYPE,<br>NODE_TEXT_INPUT_SELECTED_BACKGROUND_COLOR, NODE_TEXT_INPUT_SHOW_PASSWORD_ICON, NODE_TEXT_INPUT_EDITING, NODE_TEXT_INPUT_CANCEL_BUTTON,<br>NODE_TEXT_INPUT_TEXT_SELECTION, NODE_TEXT_INPUT_UNDERLINE_COLOR, NODE_TEXT_INPUT_ENABLE_AUTO_FILL, NODE_TEXT_INPUT_CONTENT_TYPE,<br>NODE_TEXT_INPUT_PASSWORD_RULES, NODE_TEXT_INPUT_SELECT_ALL, NODE_TEXT_INPUT_INPUT_FILTER, NODE_TEXT_INPUT_STYLE,<br>NODE_TEXT_INPUT_CARET_OFFSET, NODE_TEXT_INPUT_CONTENT_RECT, NODE_TEXT_INPUT_CONTENT_LINE_COUNT, NODE_TEXT_INPUT_SELECTION_MENU_HIDDEN,<br>NODE_TEXT_INPUT_BLUR_ON_SUBMIT, NODE_TEXT_INPUT_CUSTOM_KEYBOARD, NODE_TEXT_INPUT_WORD_BREAK, NODE_TEXT_INPUT_NUMBER_OF_LINES,<br>NODE_TEXT_INPUT_SHOW_KEYBOARD_ON_FOCUS, NODE_TEXT_INPUT_LETTER_SPACING = 7032, NODE_TEXT_INPUT_ENABLE_PREVIEW_TEXT = 7033, NODE_TEXT_INPUT_KEYBOARD_APPEARANCE = 7035, NODE_TEXT_AREA_PLACEHOLDER = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TEXT_AREA, NODE_TEXT_AREA_TEXT, NODE_TEXT_AREA_MAX_LENGTH,<br>NODE_TEXT_AREA_PLACEHOLDER_COLOR, NODE_TEXT_AREA_PLACEHOLDER_FONT, NODE_TEXT_AREA_CARET_COLOR, NODE_TEXT_AREA_EDITING,<br>NODE_TEXT_AREA_TYPE, NODE_TEXT_AREA_SHOW_COUNTER, NODE_TEXT_AREA_SELECTION_MENU_HIDDEN, NODE_TEXT_AREA_BLUR_ON_SUBMIT,<br>NODE_TEXT_AREA_INPUT_FILTER, NODE_TEXT_AREA_SELECTED_BACKGROUND_COLOR, NODE_TEXT_AREA_ENTER_KEY_TYPE, NODE_TEXT_AREA_ENABLE_KEYBOARD_ON_FOCUS,<br>NODE_TEXT_AREA_CARET_OFFSET, NODE_TEXT_AREA_CONTENT_RECT, NODE_TEXT_AREA_CONTENT_LINE_COUNT, NODE_TEXT_AREA_TEXT_SELECTION,<br>NODE_TEXT_AREA_ENABLE_AUTO_FILL, NODE_TEXT_AREA_CONTENT_TYPE, NODE_TEXT_AREA_NUMBER_OF_LINES, NODE_TEXT_AREA_SHOW_KEYBOARD_ON_FOCUS, NODE_TEXT_AREA_LETTER_SPACING = 8023, NODE_TEXT_AREA_ENABLE_PREVIEW_TEXT = 8024, NODE_TEXT_AREA_KEYBOARD_APPEARANCE = 8026,<br>NODE_BUTTON_LABEL = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_BUTTON, NODE_BUTTON_TYPE, NODE_BUTTON_MIN_FONT_SCALE, NODE_BUTTON_MAX_FONT_SCALE, NODE_PROGRESS_VALUE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_PROGRESS, NODE_PROGRESS_TOTAL,<br>NODE_PROGRESS_COLOR, NODE_PROGRESS_TYPE, NODE_PROGRESS_LINEAR_STYLE, NODE_CHECKBOX_SELECT = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_CHECKBOX, NODE_CHECKBOX_SELECT_COLOR,<br>NODE_CHECKBOX_UNSELECT_COLOR, NODE_CHECKBOX_MARK, NODE_CHECKBOX_SHAPE, NODE_XCOMPONENT_ID = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_XCOMPONENT,<br>NODE_XCOMPONENT_TYPE, NODE_XCOMPONENT_SURFACE_SIZE, NODE_XCOMPONENT_SURFACE_RECT, NODE_XCOMPONENT_ENABLE_ANALYZER, NODE_DATE_PICKER_LUNAR = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_DATE_PICKER, NODE_DATE_PICKER_START,<br>NODE_DATE_PICKER_END, NODE_DATE_PICKER_SELECTED, NODE_DATE_PICKER_DISAPPEAR_TEXT_STYLE, NODE_DATE_PICKER_TEXT_STYLE,<br>NODE_DATE_PICKER_SELECTED_TEXT_STYLE, NODE_DATE_PICKER_MODE,NODE_DATE_PICKER_ENABLE_HAPTIC_FEEDBACK = 13008,NODE_TIME_PICKER_SELECTED = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TIME_PICKER, NODE_TIME_PICKER_USE_MILITARY_TIME, NODE_TIME_PICKER_DISAPPEAR_TEXT_STYLE,<br>NODE_TIME_PICKER_TEXT_STYLE, NODE_TIME_PICKER_SELECTED_TEXT_STYLE, NODE_TIME_PICKER_START, NODE_TIME_PICKER_END, NODE_TIME_PICKER_ENABLE_CASCADE = 14007, NODE_TEXT_PICKER_OPTION_RANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TEXT_PICKER, NODE_TEXT_PICKER_OPTION_SELECTED,<br>NODE_TEXT_PICKER_OPTION_VALUE, NODE_TEXT_PICKER_DISAPPEAR_TEXT_STYLE, NODE_TEXT_PICKER_TEXT_STYLE, NODE_TEXT_PICKER_SELECTED_TEXT_STYLE,<br>NODE_TEXT_PICKER_SELECTED_INDEX, NODE_TEXT_PICKER_CAN_LOOP, NODE_TEXT_PICKER_DEFAULT_PICKER_ITEM_HEIGHT,NODE_TEXT_PICKER_ENABLE_HAPTIC_FEEDBACK = 15010, NODE_CALENDAR_PICKER_HINT_RADIUS = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_CALENDAR_PICKER,<br>NODE_CALENDAR_PICKER_SELECTED_DATE, NODE_CALENDAR_PICKER_EDGE_ALIGNMENT, NODE_CALENDAR_PICKER_TEXT_STYLE, NODE_CALENDAR_PICKER_START = 16004, NODE_CALENDAR_PICKER_END = 16005,<br>NODE_CALENDAR_PICKER_DISABLED_DATE_RANGE = 16006, NODE_CALENDAR_PICKER_MARK_TODAY = 16007,<br>NODE_SLIDER_BLOCK_COLOR = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_SLIDER,<br>NODE_SLIDER_TRACK_COLOR, NODE_SLIDER_SELECTED_COLOR, NODE_SLIDER_SHOW_STEPS, NODE_SLIDER_BLOCK_STYLE,<br>NODE_SLIDER_VALUE, NODE_SLIDER_MIN_VALUE, NODE_SLIDER_MAX_VALUE, NODE_SLIDER_STEP,<br>NODE_SLIDER_DIRECTION, NODE_SLIDER_REVERSE, NODE_SLIDER_STYLE, NODE_SLIDER_TRACK_THICKNESS,NODE_SLIDER_ENABLE_HAPTIC_FEEDBACK = 17013,<br>NODE_RADIO_CHECKED = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_RADIO, NODE_RADIO_STYLE, NODE_RADIO_VALUE, NODE_RADIO_GROUP,<br>NODE_CHECKBOX_GROUP_NAME = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_CHECKBOX_GROUP, NODE_CHECKBOX_GROUP_SELECT_ALL, NODE_CHECKBOX_GROUP_SELECTED_COLOR, NODE_CHECKBOX_GROUP_UNSELECTED_COLOR, NODE_CHECKBOX_GROUP_MARK, NODE_CHECKBOX_GROUP_SHAPE,<br>NODE_STACK_ALIGN_CONTENT = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_STACK, NODE_SCROLL_BAR_DISPLAY_MODE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_SCROLL, NODE_SCROLL_BAR_WIDTH, NODE_SCROLL_BAR_COLOR,<br>NODE_SCROLL_SCROLL_DIRECTION, NODE_SCROLL_EDGE_EFFECT, NODE_SCROLL_ENABLE_SCROLL_INTERACTION, NODE_SCROLL_FRICTION,<br>NODE_SCROLL_SNAP, NODE_SCROLL_NESTED_SCROLL, NODE_SCROLL_OFFSET, NODE_SCROLL_EDGE,<br>NODE_SCROLL_ENABLE_PAGING, NODE_SCROLL_PAGE, NODE_SCROLL_BY, NODE_SCROLL_FLING,<br>NODE_SCROLL_FADING_EDGE, NODE_SCROLL_SIZE, NODE_SCROLL_CONTENT_END_OFFSET, NODE_SCROLL_CONTENT_START_OFFSET, NODE_LIST_DIRECTION = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_LIST, NODE_LIST_STICKY,<br>NODE_LIST_SPACE, NODE_LIST_NODE_ADAPTER, NODE_LIST_CACHED_COUNT, NODE_LIST_SCROLL_TO_INDEX,<br>NODE_LIST_ALIGN_LIST_ITEM, NODE_LIST_CHILDREN_MAIN_SIZE = 1003007, NODE_LIST_INITIAL_INDEX = 1003008, NODE_LIST_DIVIDER = 1003009, NODE_LIST_SCROLL_TO_INDEX_IN_GROUP = 1003010, NODE_LIST_LANES = 1003011, NODE_LIST_SCROLL_SNAP_ALIGN = 1003012, NODE_LIST_MAINTAIN_VISIBLE_CONTENT_POSITION = 1003013, NODE_LIST_STACK_FROM_END = 1003014,<br>NODE_SWIPER_LOOP = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_SWIPER, NODE_SWIPER_AUTO_PLAY, NODE_SWIPER_SHOW_INDICATOR, NODE_SWIPER_INTERVAL,<br>NODE_SWIPER_VERTICAL, NODE_SWIPER_DURATION, NODE_SWIPER_CURVE, NODE_SWIPER_ITEM_SPACE,<br>NODE_SWIPER_INDEX, NODE_SWIPER_DISPLAY_COUNT, NODE_SWIPER_DISABLE_SWIPE, NODE_SWIPER_SHOW_DISPLAY_ARROW,<br>NODE_SWIPER_EDGE_EFFECT_MODE, NODE_SWIPER_NODE_ADAPTER, NODE_SWIPER_CACHED_COUNT, NODE_SWIPER_PREV_MARGIN,<br>NODE_SWIPER_NEXT_MARGIN, NODE_SWIPER_INDICATOR, NODE_SWIPER_NESTED_SCROLL, NODE_SWIPER_SWIPE_TO_INDEX,<br>NODE_SWIPER_INDICATOR_INTERACTIVE, NODE_SWIPER_PAGE_FLIP_MODE, NODE_SWIPER_AUTO_FILL, NODE_LIST_ITEM_SWIPE_ACTION = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_LIST_ITEM, NODE_LIST_ITEM_GROUP_SET_HEADER = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_LIST_ITEM_GROUP,<br>NODE_LIST_ITEM_GROUP_SET_FOOTER, NODE_LIST_ITEM_GROUP_SET_DIVIDER, NODE_LIST_ITEM_GROUP_CHILDREN_MAIN_SIZE = 1005003, NODE_LIST_ITEM_GROUP_NODE_ADAPTER = 1005004, NODE_COLUMN_ALIGN_ITEMS = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_COLUMN,<br>NODE_COLUMN_JUSTIFY_CONTENT, NODE_ROW_ALIGN_ITEMS = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_ROW, NODE_ROW_JUSTIFY_CONTENT, NODE_FLEX_OPTION = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_FLEX,<br>NODE_REFRESH_REFRESHING = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_REFRESH, NODE_REFRESH_CONTENT, NODE_REFRESH_PULL_DOWN_RATIO = 1009002, NODE_REFRESH_OFFSET = 1009003,<br>NODE_REFRESH_PULL_TO_REFRESH = 1009004, NODE_WATER_FLOW_LAYOUT_DIRECTION = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_WATER_FLOW, NODE_WATER_FLOW_COLUMN_TEMPLATE, NODE_WATER_FLOW_ROW_TEMPLATE,<br>NODE_WATER_FLOW_COLUMN_GAP, NODE_WATER_FLOW_ROW_GAP, NODE_WATER_FLOW_SECTION_OPTION, NODE_WATER_FLOW_NODE_ADAPTER,<br>NODE_WATER_FLOW_CACHED_COUNT, NODE_WATER_FLOW_FOOTER, NODE_WATER_FLOW_SCROLL_TO_INDEX, NODE_WATER_FLOW_ITEM_CONSTRAINT_SIZE,<br>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, NODE_GRID_ROW_TEMPLATE,<br>NODE_GRID_COLUMN_GAP, NODE_GRID_ROW_GAP, NODE_GRID_NODE_ADAPTER, NODE_GRID_CACHED_COUNT, NODE_TEXT_PICKER_COLUMN_WIDTHS = 15009,<br>NODE_IMAGE_ANIMATOR_IMAGES = ARKUI_NODE_IMAGE_ANIMATOR \* MAX_NODE_SCOPE_NUM, NODE_IMAGE_ANIMATOR_STATE, NODE_IMAGE_ANIMATOR_DURATION, NODE_IMAGE_ANIMATOR_REVERSE,<br>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. |
172| [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_ON_KEY_EVENT = 21, NODE_ON_KEY_PRE_IME = 22, NODE_DISPATCH_KEY_EVENT = 24, NODE_ON_AXIS = 25, NODE_ON_CLICK_EVENT = 26, NODE_ON_HOVER_EVENT = 27, NODE_VISIBLE_AREA_APPROXIMATE_CHANGE_EVENT = 28, NODE_TEXT_ON_DETECT_RESULT_UPDATE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TEXT,<br>NODE_IMAGE_ON_COMPLETE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_IMAGE, NODE_IMAGE_ON_ERROR, NODE_IMAGE_ON_SVG_PLAY_FINISH, NODE_IMAGE_ON_DOWNLOAD_PROGRESS,<br>NODE_TOGGLE_ON_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TOGGLE, NODE_TEXT_INPUT_ON_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TEXT_INPUT, NODE_TEXT_INPUT_ON_SUBMIT, NODE_TEXT_INPUT_ON_CUT,<br>NODE_TEXT_INPUT_ON_PASTE, NODE_TEXT_INPUT_ON_TEXT_SELECTION_CHANGE, NODE_TEXT_INPUT_ON_EDIT_CHANGE, NODE_TEXT_INPUT_ON_INPUT_FILTER_ERROR,<br>NODE_TEXT_INPUT_ON_CONTENT_SCROLL, NODE_TEXT_INPUT_ON_CONTENT_SIZE_CHANGE, NODE_TEXT_INPUT_ON_WILL_INSERT = 7009, NODE_TEXT_INPUT_ON_DID_INSERT = 7010,<br>NODE_TEXT_INPUT_ON_WILL_DELETE = 7011, NODE_TEXT_INPUT_ON_DID_DELETE = 7012, NODE_TEXT_INPUT_ON_CHANGE_WITH_PREVIEW_TEXT = 7013, NODE_TEXT_AREA_ON_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_TEXT_AREA, NODE_TEXT_AREA_ON_PASTE,<br>NODE_TEXT_AREA_ON_TEXT_SELECTION_CHANGE, NODE_TEXT_AREA_ON_EDIT_CHANGE, NODE_TEXT_AREA_ON_SUBMIT, NODE_TEXT_AREA_ON_INPUT_FILTER_ERROR,<br>NODE_TEXT_AREA_ON_CONTENT_SCROLL, NODE_TEXT_AREA_ON_CONTENT_SIZE_CHANGE, NODE_TEXT_AREA_ON_WILL_INSERT = 8008, NODE_TEXT_AREA_ON_DID_INSERT = 8009,<br>NODE_TEXT_AREA_ON_WILL_DELETE = 8010, NODE_TEXT_AREA_ON_DID_DELETE = 8011, NODE_TEXT_AREA_ON_CHANGE_WITH_PREVIEW_TEXT = 8012, 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,<br>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, 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,<br>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, NODE_IMAGE_ANIMATOR_EVENT_ON_PAUSE, NODE_IMAGE_ANIMATOR_EVENT_ON_REPEAT,<br>NODE_IMAGE_ANIMATOR_EVENT_ON_CANCEL, NODE_IMAGE_ANIMATOR_EVENT_ON_FINISH, <br>NODE_CHECKBOX_GROUP_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_CHECKBOX_GROUP,<br> NODE_SWIPER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_SWIPER, NODE_SWIPER_EVENT_ON_ANIMATION_START,<br>NODE_SWIPER_EVENT_ON_ANIMATION_END, NODE_SWIPER_EVENT_ON_GESTURE_SWIPE, NODE_SWIPER_EVENT_ON_CONTENT_DID_SCROLL, NODE_SWIPER_EVENT_ON_SELECTED = 1001005, NODE_SWIPER_EVENT_ON_UNSELECTED = 1001006, NODE_SWIPER_EVENT_ON_CONTENT_WILL_SCROLL = 1001007, NODE_SCROLL_EVENT_ON_SCROLL = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_SCROLL,<br>NODE_SCROLL_EVENT_ON_SCROLL_FRAME_BEGIN, NODE_SCROLL_EVENT_ON_WILL_SCROLL, NODE_SCROLL_EVENT_ON_DID_SCROLL, NODE_SCROLL_EVENT_ON_SCROLL_START,<br>NODE_SCROLL_EVENT_ON_SCROLL_STOP, NODE_SCROLL_EVENT_ON_SCROLL_EDGE, NODE_SCROLL_EVENT_ON_REACH_START, NODE_SCROLL_EVENT_ON_REACH_END,<br>NODE_LIST_ON_SCROLL_INDEX = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_LIST, NODE_LIST_ON_WILL_SCROLL, NODE_LIST_ON_DID_SCROLL, NODE_LIST_ON_SCROLL_VISIBLE_CONTENT_CHANGE, NODE_REFRESH_STATE_CHANGE = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_REFRESH,<br>NODE_REFRESH_ON_REFRESH, NODE_REFRESH_ON_OFFSET_CHANGE, NODE_ON_WILL_SCROLL = MAX_NODE_SCOPE_NUM \* ARKUI_NODE_WATER_FLOW, NODE_WATER_FLOW_ON_DID_SCROLL,<br>NODE_WATER_FLOW_ON_SCROLL_INDEX<br>} | Enumerates the event types supported by the NativeNode component. |
173| [ArkUI_NodeDirtyFlag](#arkui_nodedirtyflag) { NODE_NEED_MEASURE = 1, NODE_NEED_LAYOUT, NODE_NEED_RENDER } | Enumerates the dirty area flags passed in the **::markDirty** API. |
174| [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. |
175| [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. |
176| [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. |
177| [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. |
178| [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. |
179| [ArkUI_FontStyle](#arkui_fontstyle) { ARKUI_FONT_STYLE_NORMAL = 0, ARKUI_FONT_STYLE_ITALIC } | Enumerates the font styles. |
180| [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. |
181| [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. |
182| [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. |
183| [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. |
184| [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. |
185| [ArkUI_CancelButtonStyle](#arkui_cancelbuttonstyle) { ARKUI_CANCELBUTTON_STYLE_CONSTANT = 0, ARKUI_CANCELBUTTON_STYLE_INVISIBLE, ARKUI_CANCELBUTTON_STYLE_INPUT } | Enumerates the styles of the Cancel button. |
186| [ArkUI_XComponentType](#arkui_xcomponenttype) { ARKUI_XCOMPONENT_TYPE_SURFACE = 0, ARKUI_XCOMPONENT_TYPE_TEXTURE = 2 } | Defines the enumerated values of the XComponent type. |
187| [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. |
188| [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. |
189| [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. |
190| [ArkUI_TextCase](#arkui_textcase) { ARKUI_TEXT_CASE_NORMAL = 0, ARKUI_TEXT_CASE_LOWER, ARKUI_TEXT_CASE_UPPER } | Defines the enumerated values of text case. |
191| [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. |
192| [ArkUI_ShadowType](#arkui_shadowtype) { ARKUI_SHADOW_TYPE_COLOR = 0, ARKUI_SHADOW_TYPE_BLUR } | Defines the enumerated values of the shadow type. |
193| [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. |
194| [ArkUI_AccessibilityCheckedState](#arkui_accessibilitycheckedstate) { ARKUI_ACCESSIBILITY_UNCHECKED = 0, ARKUI_ACCESSIBILITY_CHECKED } | Enumerates the accessibility check box states. |
195| [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. |
196| [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. |
197| [ArkUI_EffectEdge](#arkui_effectedge) { ARKUI_EFFECT_EDGE_START = 1, ARKUI_EFFECT_EDGE_END = 2 } | Enumerates the edges for which the effect takes effect when the boundary of the scrollable content is reached. |
198| [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. |
199| [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. |
200| [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. |
201| [ArkUI_Axis](#arkui_axis) { ARKUI_AXIS_VERTICAL = 0, ARKUI_AXIS_HORIZONTAL } | Enumerates the scroll directions. |
202| [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. |
203| [ArkUI_BorderStyle](#arkui_borderstyle) { ARKUI_BORDER_STYLE_SOLID = 0, ARKUI_BORDER_STYLE_DASHED, ARKUI_BORDER_STYLE_DOTTED } | Enumerates the border styles. |
204| [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. |
205| [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. |
206| [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. |
207| [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 indicator. |
208| [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. |
209| [ArkUI_PageFlipMode](#arkui_pageflipmode) { ARKUI_PAGE_FLIP_MODE_CONTINUOUS = 0, ARKUI_PAGE_FLIP_MODE_SINGLE } | Enumerates the page flipping modes using the mouse wheel for the <b>Swiper</b> component. |
210| [ArkUI_SwiperAnimationMode](#arkui_swiperanimationmode) { ARKUI_SWIPER_NO_ANIMATION = 0, ARKUI_SWIPER_DEFAULT_ANIMATION, ARKUI_SWIPER_FAST_ANIMATION } | Enumerates the animation modes for the **Swiper** component when jumping to the page with the specified index. |
211| [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. |
212| [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. |
213| [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. |
214| [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 nested scrolling options. |
215| [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. |
216| [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. |
217| [ArkUI_ScrollState](#arkui_scrollstate) { ARKUI_SCROLL_STATE_IDLE = 0, ARKUI_SCROLL_STATE_SCROLL, ARKUI_SCROLL_STATE_FLING } | Enumerates the scrolling states. |
218| [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. |
219| [ArkUI_SliderDirection](#arkui_sliderdirection) { ARKUI_SLIDER_DIRECTION_VERTICAL = 0, ARKUI_SLIDER_DIRECTION_HORIZONTAL } | Enumerates the scroll directions of the slider. |
220| [ArkUI_SliderStyle](#arkui_sliderstyle) { ARKUI_SLIDER_STYLE_OUT_SET = 0, ARKUI_SLIDER_STYLE_IN_SET, ARKUI_SLIDER_STYLE_NONE } | Enumerates the slider styles. |
221| [ArkUI_CheckboxShape](#arkui_checkboxshape) { ArkUI_CHECKBOX_SHAPE_CIRCLE = 0, ArkUI_CHECKBOX_SHAPE_ROUNDED_SQUARE } | Enumerates the shapes of the check box. |
222| [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. |
223| [ArkUI_ImageSize](#arkui_imagesize) { ARKUI_IMAGE_SIZE_AUTO = 0, ARKUI_IMAGE_SIZE_COVER, ARKUI_IMAGE_SIZE_CONTAIN } | Defines the image size. |
224| [ArkUI_AdaptiveColor](#arkui_adaptivecolor) { ARKUI_ADAPTIVE_COLOR_DEFAULT = 0, ARKUI_ADAPTIVE_COLOR_AVERAGE } | Enumerates the adaptive color modes. |
225| [ArkUI_ColorMode](#arkui_colormode) { ARKUI_COLOR_MODE_SYSTEM = 0, ARKUI_COLOR_MODE_LIGHT, ARKUI_COLOR_MODE_DARK } | Enumerates the color modes. |
226| [ArkUI_SystemColorMode](#arkui_systemcolormode) { ARKUI_SYSTEM_COLOR_MODE_LIGHT = 0, ARKUI_SYSTEM_COLOR_MODE_DARK } | Enumerates the system color modes. |
227| [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. |
228| [ArkUI_VerticalAlignment](#arkui_verticalalignment) { ARKUI_VERTICAL_ALIGNMENT_TOP = 0, ARKUI_VERTICAL_ALIGNMENT_CENTER, ARKUI_VERTICAL_ALIGNMENT_BOTTOM } | Enumerates the vertical alignment modes. |
229| [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. |
230| [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. |
231| [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. |
232| [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. ImageSpanAlignment  |
233| [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. |
234| [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. |
235| [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. |
236| [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. |
237| [ArkUI_ColorStrategy](#arkui_colorstrategy) { ARKUI_COLOR_STRATEGY_INVERT = 0, ARKUI_COLOR_STRATEGY_AVERAGE, ARKUI_COLOR_STRATEGY_PRIMARY } | Enumerates the foreground colors. |
238| [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. |
239| [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. |
240| [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. |
241| [ArkUI_Visibility](#arkui_visibility) { ARKUI_VISIBILITY_VISIBLE = 0, ARKUI_VISIBILITY_HIDDEN, ARKUI_VISIBILITY_NONE } | Enumerates the visibility values. |
242| [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. |
243| [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. |
244| [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. |
245| [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. |
246| [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. |
247| [ArkUI_WordBreak](#arkui_wordbreak) { ARKUI_WORD_BREAK_NORMAL = 0, ARKUI_WORD_BREAK_BREAK_ALL, ARKUI_WORD_BREAK_BREAK_WORD, ARKUI_WORD_BREAK_HYPHENATION } | Enumerates the word break rules. |
248| [ArkUI_EllipsisMode](#arkui_ellipsismode) { ARKUI_ELLIPSIS_MODE_START = 0, ARKUI_ELLIPSIS_MODE_CENTER, ARKUI_ELLIPSIS_MODE_END } | Enumerates the ellipsis positions. |
249| [ArkUI_ImageRenderMode](#arkui_imagerendermode) { ARKUI_IMAGE_RENDER_MODE_ORIGINAL = 0, ARKUI_IMAGE_RENDER_MODE_TEMPLATE } | Enumerates the image rendering modes. |
250| [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. |
251| [ArkUI_FinishCallbackType](#arkui_finishcallbacktype) { ARKUI_FINISH_CALLBACK_REMOVED = 0, ARKUI_FINISH_CALLBACK_LOGICALLY } | Enumerates the animation **onFinish** callback types. |
252| [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. |
253| [ArkUI_BlendApplyType](#arkui_blendapplytype) { BLEND_APPLY_TYPE_FAST = 0, BLEND_APPLY_TYPE_OFFSCREEN } | Defines how the specified blend mode is applied. |
254| [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. |
255| [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>ARKUI_TEXTINPUT_CONTENT_TYPE_PASSPORT_NUMBER,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_VALIDITY,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_ISSUE_AT,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_ORGANIZATION,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_TAX_ID,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_ADDRESS_CITY_AND_STATE,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_FLIGHT_NUMBER,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_LICENSE_NUMBER,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_LICENSE_FILE_NUMBER,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_LICENSE_PLATE,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_ENGINE_NUMBER,<br>ARKUI_TEXTINPUT_CONTENT_TYPE_LICENSE_CHASSIS_NUMBER,<br>} | Enumerates the autofill types. |
256| [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. |
257| [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. |
258| [ArkUI_TextInputStyle](#arkui_textinputstyle) { ARKUI_TEXTINPUT_STYLE_DEFAULT = 0, ARKUI_TEXTINPUT_STYLE_INLINE } | Enumerates the text input styles. |
259| [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. |
260| [ArkUI_ButtonType](#arkui_buttontype) { ARKUI_BUTTON_TYPE_NORMAL = 0, ARKUI_BUTTON_TYPE_CAPSULE, ARKUI_BUTTON_TYPE_CIRCLE } | Enumerates the button types. |
261| [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>} |  |
262| [ArkUI_ThemeColorMode](#arkui_themecolormode) { ARKUI_THEME_COLOR_MODE_SYSTEM = 0, ARKUI_THEME_COLOR_MODE_LIGHT, ARKUI_THEME_COLOR_MODE_DARK } |  |
263| [ArkUI_SwiperIndicatorType](#arkui_swiperindicatortype) { ARKUI_SWIPER_INDICATOR_TYPE_DOT, ARKUI_SWIPER_INDICATOR_TYPE_DIGIT } | Enumerates the navigation indicator types of the **Swiper** component. |
264| [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. |
265| [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. |
266| [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. |
267| [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. |
268| [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. |
269| [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. |
270| [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. |
271| [ArkUI_ErrorCode](#arkui_errorcode) {<br>ARKUI_ERROR_CODE_NO_ERROR = 0, ARKUI_ERROR_CODE_PARAM_INVALID = 401,<br>ARKUI_ERROR_CODE_FOCUS_NON_FOCUSABLE = 150001, ARKUI_ERROR_CODE_FOCUS_NON_FOCUSABLE_ANCESTOR = 150002, ARKUI_ERROR_CODE_FOCUS_NON_EXISTENT = 150003, <br>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_NODE_NOT_ON_MAIN_TREE = 106203, ARKUI_ERROR_CODE_NON_SCROLLABLE_CONTAINER = 180001, ARKUI_ERROR_CODE_BUFFER_SIZE_NOT_ENOUGH = 180002, ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT = 180003, ARKUI_ERROR_CODE_POST_CLONED_COMPONENT_STATUS_ABNORMAL = 180004, ARKUI_ERROR_CODE_POST_CLONED_NO_COMPONENT_HIT_TO_RESPOND_TO_THE_EVENT  = 180005, ARKUI_ERROR_CODE_INVALID_STYLED_STRING = 180101<br>} | Defines an enum for the error codes. |
272| [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. |
273| [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. |
274| [ArkUI_ListItemGroupArea](#arkui_listitemgrouparea) { ARKUI_LIST_ITEM_GROUP_AREA_OUTSIDE = 0, ARKUI_LIST_ITEM_SWIPE_AREA_NONE = 1, ARKUI_LIST_ITEM_SWIPE_AREA_ITEM = 2, ARKUI_LIST_ITEM_SWIPE_AREA_HEADER = 3, ARKUI_LIST_ITEM_SWIPE_AREA_FOOTER = 4<br>} | Enumerates the component areas.|
275| [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. |
276| [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. |
277| [ArkUI_FocusMove](#arkui_focusmove) { ARKUI_FOCUS_MOVE_FORWARD = 0, ARKUI_FOCUS_MOVE_BACKWARD, ARKUI_FOCUS_MOVE_UP, ARKUI_FOCUS_MOVE_DOWN, ARKUI_FOCUS_MOVE_LEFT, ARKUI_FOCUS_MOVE_RIGHT, } | Enumerates the focus movement directions. |
278| [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. |
279| [ArkUI_DatePickerMode](#arkui_datepickermode) {<br>ARKUI_DATEPICKER_MODE_DATE = 0, ARKUI_DATEPICKER_YEAR_AND_MONTH = 1, ARKUI_DATEPICKER_MONTH_AND_DAY = 2<br> } | Enumerates the column display modes of the date picker. |
280
281
282### Functions
283
284| Name| Description|
285| -------- | -------- |
286| [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. |
287| [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. |
288| 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. |
289| int32_t [OH_ArkUI_DragEvent_SetSuggestedDropOperation](#oh_arkui_dragevent_setsuggesteddropoperation) ([ArkUI_DragEvent](#arkui_dragevent) \*event, [ArkUI_DropOperation](#arkui_dropoperation) dropOperation) | Sets the data processing mode. |
290| 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. |
291| 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. |
292| 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. |
293| int32_t [OH_ArkUI_DragEvent_GetDataTypeCount](#oh_arkui_dragevent_getdatatypecount) ([ArkUI_DragEvent](#arkui_dragevent) \*event, int32_t \*count) | Obtains the number of drag data types from a drag event. |
294| 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. |
295| 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. |
296| int32_t [OH_ArkUI_DragEvent_GetDropOperation](#oh_arkui_dragevent_getdropoperation) ([ArkUI_DragEvent](#arkui_dragevent) \*event, [ArkUI_DropOperation](#arkui_dropoperation) \*operation) | Obtains the data handling method from the drag event. |
297| 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. |
298| 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. |
299| 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. |
300| 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. |
301| 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. |
302| 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. |
303| 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. |
304| 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. |
305| float [OH_ArkUI_DragEvent_GetVelocityX](#oh_arkui_dragevent_getvelocityx) ([ArkUI_DragEvent](#arkui_dragevent) \*event) | Obtains the dragging velocity along the x-axis. |
306| float [OH_ArkUI_DragEvent_GetVelocityY](#oh_arkui_dragevent_getvelocityy) ([ArkUI_DragEvent](#arkui_dragevent) \*event) | Obtains the dragging velocity along the y-axis. |
307| float [OH_ArkUI_DragEvent_GetVelocity](#oh_arkui_dragevent_getvelocity) ([ArkUI_DragEvent](#arkui_dragevent) \*event) | Obtains the dragging velocity along the main axis. |
308| int32_t [OH_ArkUI_DragEvent_GetModifierKeyStates](#oh_arkui_dragevent_getmodifierkeystates) ([ArkUI_DragEvent](#arkui_dragevent) \*event, uint64_t \*keys) | Obtains the pressed status of modifier keys from a drag event. |
309| 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. |
310| 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. |
311| 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). |
312| 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). |
313| 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). |
314| int32_t [OH_ArkUI_SetNodeDraggable](#oh_arkui_setnodedraggable) ([ArkUI_NodeHandle](#arkui_nodehandle) node, bool enabled) | Sets whether the component is draggable. |
315| 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. |
316| [ArkUI_DragPreviewOption](#arkui_dragpreviewoption) \* [OH_ArkUI_CreateDragPreviewOption](#oh_arkui_createdragpreviewoption) (void) | Creates an **ArkUI_DragPreviewOption** object. |
317| void [OH_ArkUI_DragPreviewOption_Dispose](#oh_arkui_dragpreviewoption_dispose) ([ArkUI_DragPreviewOption](#arkui_dragpreviewoption) \*option) | Disposes of an **ArkUI_DragPreviewOption** object. |
318| 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. |
319| 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. |
320| 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. |
321| 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. |
322| 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. |
323| 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. |
324| 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. |
325| [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. |
326| [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. |
327| void [OH_ArkUI_DragAction_Dispose](#oh_arkui_dragaction_dispose) ([ArkUI_DragAction](#arkui_dragaction) \*dragAction) | Disposes of an **ArkUI_DragAction** object. |
328| 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. |
329| 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. |
330| 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). |
331| 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). |
332| int32_t [OH_ArkUI_DragAction_SetData](#oh_arkui_dragaction_setdata) ([ArkUI_DragAction](#arkui_dragaction) \*dragAction, [OH_UdmfData](#oh_udmfdata) \*data) | Sets the drag data. |
333| 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. |
334| 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. |
335| void [OH_ArkUI_DragAction_UnregisterStatusListener](#oh_arkui_dragaction_unregisterstatuslistener) ([ArkUI_DragAction](#arkui_dragaction) \*dragAction) | Unregisters a drag status listener. |
336| [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. |
337| [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. |
338| int32_t [OH_ArkUI_StartDrag](#oh_arkui_startdrag) ([ArkUI_DragAction](#arkui_dragaction) \*dragAction) | Initiates a drag action through the specified **DragAction** object. |
339| [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. |
340| [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. |
341| void [OH_ArkUI_DrawableDescriptor_Dispose](#oh_arkui_drawabledescriptor_dispose) ([ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) \*drawableDescriptor) | Disposes of the pointer to a **DrawableDescriptor** object. |
342| [OH_PixelmapNativeHandle](#oh_pixelmapnativehandle) [OH_ArkUI_DrawableDescriptor_GetStaticPixelMap](#oh_arkui_drawabledescriptor_getstaticpixelmap) ([ArkUI_DrawableDescriptor](#arkui_drawabledescriptor) \*drawableDescriptor) | Obtains the pointer to a **PixelMap** object. |
343| [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. |
344| 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. |
345| 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. |
346| 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. |
347| 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. |
348| 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. |
349| [ArkUI_AnimateOption](#arkui_animateoption) \* [OH_ArkUI_AnimateOption_Create](#oh_arkui_animateoption_create) () | Creates an animation configuration. |
350| void [OH_ArkUI_AnimateOption_Dispose](#oh_arkui_animateoption_dispose) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Destroys an animation configuration. |
351| int32_t [OH_ArkUI_AnimateOption_GetDuration](#oh_arkui_animateoption_getduration) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Obtains the animation duration, in milliseconds. |
352| float [OH_ArkUI_AnimateOption_GetTempo](#oh_arkui_animateoption_gettempo) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Obtains the playback speed of an animation. |
353| [ArkUI_AnimationCurve](#arkui_animationcurve) [OH_ArkUI_AnimateOption_GetCurve](#oh_arkui_animateoption_getcurve) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Obtains an animation curve. |
354| int32_t [OH_ArkUI_AnimateOption_GetDelay](#oh_arkui_animateoption_getdelay) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Obtains the animation delay, in milliseconds. |
355| 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. |
356| [ArkUI_AnimationPlayMode](#arkui_animationplaymode) [OH_ArkUI_AnimateOption_GetPlayMode](#oh_arkui_animateoption_getplaymode) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Obtains the playback mode of an animation. |
357| [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. |
358| void [OH_ArkUI_AnimateOption_SetDuration](#oh_arkui_animateoption_setduration) ([ArkUI_AnimateOption](#arkui_animateoption) \*option, int32_t value) | Sets the animation duration. |
359| void [OH_ArkUI_AnimateOption_SetTempo](#oh_arkui_animateoption_settempo) ([ArkUI_AnimateOption](#arkui_animateoption) \*option, float value) | Sets the playback speed of an animation. |
360| void [OH_ArkUI_AnimateOption_SetCurve](#oh_arkui_animateoption_setcurve) ([ArkUI_AnimateOption](#arkui_animateoption) \*option, [ArkUI_AnimationCurve](#arkui_animationcurve) value) | Animation curve. |
361| void [OH_ArkUI_AnimateOption_SetDelay](#oh_arkui_animateoption_setdelay) ([ArkUI_AnimateOption](#arkui_animateoption) \*option, int32_t value) | Sets the animation delay. |
362| 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. |
363| 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. |
364| 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. |
365| 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. |
366| [ArkUI_CurveHandle](#arkui_curvehandle) [OH_ArkUI_AnimateOption_GetICurve](#oh_arkui_animateoption_geticurve) ([ArkUI_AnimateOption](#arkui_animateoption) \*option) | Obtains the animation curve of an animation. |
367| [ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) \* [OH_ArkUI_KeyframeAnimateOption_Create](#oh_arkui_keyframeanimateoption_create) (int32_t size) | Obtains the keyframe animation parameters. |
368| void [OH_ArkUI_KeyframeAnimateOption_Dispose](#oh_arkui_keyframeanimateoption_dispose) ([ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) \*option) | Destroys a keyframe animation parameter object. |
369| 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. |
370| 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. |
371| 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. |
372| 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. |
373| 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. |
374| 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. |
375| int32_t [OH_ArkUI_KeyframeAnimateOption_GetDelay](#oh_arkui_keyframeanimateoption_getdelay) ([ArkUI_KeyframeAnimateOption](#arkui_keyframeanimateoption) \*option) | Obtains the overall delay of a keyframe animation |
376| 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. |
377| 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. |
378| [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. |
379| [ArkUI_AnimatorOption](#arkui_animatoroption) \* [OH_ArkUI_AnimatorOption_Create](#oh_arkui_animatoroption_create) (int32_t keyframeSize) | Creates an animator parameter object. |
380| void [OH_ArkUI_AnimatorOption_Dispose](#oh_arkui_animatoroption_dispose) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Destroys an animator parameter object. |
381| 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. |
382| 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. |
383| 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. |
384| 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. |
385| int32_t [OH_ArkUI_AnimatorOption_SetDirection](#oh_arkui_animatoroption_setdirection) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, [ArkUI_AnimationDirection](#arkui_animationdirection) value) | Sets the playback direction. |
386| 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. |
387| 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. |
388| 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. |
389| 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. |
390| 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. |
391| 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. |
392| int32_t [OH_ArkUI_AnimatorOption_GetDuration](#oh_arkui_animatoroption_getduration) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Obtains the duration for playing an animation. |
393| int32_t [OH_ArkUI_AnimatorOption_GetDelay](#oh_arkui_animatoroption_getdelay) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Obtains the delay for playing an animation. |
394| 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. |
395| [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. |
396| [ArkUI_AnimationDirection](#arkui_animationdirection) [OH_ArkUI_AnimatorOption_GetDirection](#oh_arkui_animatoroption_getdirection) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Obtains the playback direction of an animation. |
397| [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. |
398| float [OH_ArkUI_AnimatorOption_GetBegin](#oh_arkui_animatoroption_getbegin) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Obtains the interpolation start point of an animation. |
399| float [OH_ArkUI_AnimatorOption_GetEnd](#oh_arkui_animatoroption_getend) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Obtains the interpolation end point of an animation. |
400| [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. |
401| float [OH_ArkUI_AnimatorOption_GetKeyframeTime](#oh_arkui_animatoroption_getkeyframetime) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, int32_t index) | Obtains the keyframe time of an animation. |
402| float [OH_ArkUI_AnimatorOption_GetKeyframeValue](#oh_arkui_animatoroption_getkeyframevalue) ([ArkUI_AnimatorOption](#arkui_animatoroption) \*option, int32_t index) | Obtains the keyframe value of an animation. |
403| [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. |
404| void \* [OH_ArkUI_AnimatorEvent_GetUserData](#oh_arkui_animatorevent_getuserdata) (ArkUI_AnimatorEvent \*event) | Obtains the custom object in an animation event object. |
405| void \* [OH_ArkUI_AnimatorOnFrameEvent_GetUserData](#oh_arkui_animatoronframeevent_getuserdata) (ArkUI_AnimatorOnFrameEvent \*event) | Obtains the custom object in an animation event object. |
406| float [OH_ArkUI_AnimatorOnFrameEvent_GetValue](#oh_arkui_animatoronframeevent_getvalue) (ArkUI_AnimatorOnFrameEvent \*event) | Obtains the current progress in an animation event object. |
407| 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. |
408| 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. |
409| 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. |
410| 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. |
411| int32_t [OH_ArkUI_Animator_ResetAnimatorOption](#oh_arkui_animator_resetanimatoroption) ([ArkUI_AnimatorHandle](#arkui_animatorhandle) animator, [ArkUI_AnimatorOption](#arkui_animatoroption) \*option) | Resets an animator configuration. |
412| int32_t [OH_ArkUI_Animator_Play](#oh_arkui_animator_play) ([ArkUI_AnimatorHandle](#arkui_animatorhandle) animator) | Starts the animation of an animator. |
413| int32_t [OH_ArkUI_Animator_Finish](#oh_arkui_animator_finish) ([ArkUI_AnimatorHandle](#arkui_animatorhandle) animator) | Ends the animation of an animator. |
414| int32_t [OH_ArkUI_Animator_Pause](#oh_arkui_animator_pause) ([ArkUI_AnimatorHandle](#arkui_animatorhandle) animator) | Pauses the animation of an animator. |
415| int32_t [OH_ArkUI_Animator_Cancel](#oh_arkui_animator_cancel) ([ArkUI_AnimatorHandle](#arkui_animatorhandle) animator) | Cancels the animation of an animator. |
416| int32_t [OH_ArkUI_Animator_Reverse](#oh_arkui_animator_reverse) ([ArkUI_AnimatorHandle](#arkui_animatorhandle) animator) | Plays this animation in reverse order. |
417| [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. |
418| [ArkUI_CurveHandle](#arkui_curvehandle) [OH_ArkUI_Curve_CreateStepsCurve](#oh_arkui_curve_createstepscurve) (int32_t count, bool end) | Creates a step curve. |
419| [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. |
420| [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**. |
421| [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. |
422| [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**. |
423| [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. |
424| [ArkUI_CurveHandle](#arkui_curvehandle) [OH_ArkUI_Curve_CreateCustomCurve](#oh_arkui_curve_createcustomcurve) (void \*userData, float(\*interpolate)(float fraction, void \*userdata)) | Creates a custom curve. |
425| void [OH_ArkUI_Curve_DisposeCurve](#oh_arkui_curve_disposecurve) ([ArkUI_CurveHandle](#arkui_curvehandle) curveHandle) | Disposes of a custom curve. |
426| [ArkUI_TransitionEffect](#arkui_transitioneffect) \* [OH_ArkUI_CreateOpacityTransitionEffect](#oh_arkui_createopacitytransitioneffect) (float opacity) | Creates an opacity object for component transition. |
427| [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. |
428| [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. |
429| [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. |
430| [ArkUI_TransitionEffect](#arkui_transitioneffect) \* [OH_ArkUI_CreateMovementTransitionEffect](#oh_arkui_createmovementtransitioneffect) ([ArkUI_TransitionEdge](#arkui_transitionedge) move) | Creates a movement object for component transition. |
431| [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. |
432| void [OH_ArkUI_TransitionEffect_Dispose](#oh_arkui_transitioneffect_dispose) ([ArkUI_TransitionEffect](#arkui_transitioneffect) \*option) | Disposes of a transition effect. |
433| 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. |
434| 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. |
435| 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. |
436| 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. |
437| 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. |
438| int32_t [OH_ArkUI_CustomDialog_OpenDialog](#oh_arkui_customdialog_opendialog) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, void (\*callback)(int32_t dialogId)) | Displays a custom dialog box. |
439| int32_t [OH_ArkUI_CustomDialog_UpdateDialog](#oh_arkui_customdialog_updatedialog) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, void (\*callback)(int32_t dialogId)) | Updates a custom dialog box. |
440| int32_t [OH_ArkUI_CustomDialog_CloseDialog](#oh_arkui_customdialog_closedialog) (int32_t dialogId) | Closes a custom dialog box. |
441| ArkUI_CustomDialogOptions\* [OH_ArkUI_CustomDialog_CreateOptions](#oh_arkui_customdialog_createoptions) ([ArkUI_NodeHandle](#arkui_nodehandle) content) | Creates options for a custom dialog. |
442| void [OH_ArkUI_CustomDialog_DisposeOptions](#oh_arkui_customdialog_disposeoptions) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options) | Destroys custom dialog box options. |
443| int32_t [OH_ArkUI_CustomDialog_SetLevelMode](#oh_arkui_customdialog_setlevelmode) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, [ArkUI_LevelMode](#arkui_levelmode) levelMode) | Sets the display level of the dialog box. |
444| int32_t [OH_ArkUI_CustomDialog_SetLevelUniqueId](#oh_arkui_customdialog_setleveluniqueid) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, int32_t uniqueId) | Sets the ID of the node under the dialog box's display level. |
445| int32_t [OH_ArkUI_CustomDialog_SetImmersiveMode](#oh_arkui_customdialog_setimmersivemode) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, [ArkUI_ImmersiveMode](#arkui_immersivemode) immersiveMode) | Sets the display area of the embedded dialog box overlay. |
446| int32_t [OH_ArkUI_CustomDialog_SetBackgroundColor](#oh_arkui_customdialog_setbackgroundcolor) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, uint32_t backgroundColor) | Sets the background color of a dialog box. |
447| int32_t [OH_ArkUI_CustomDialog_SetCornerRadius](#oh_arkui_customdialog_setcornerradius) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, float topLeft, float topRight, float bottomLeft, float bottomRight) | Sets the corner radius for a custom dialog box. |
448| int32_t [OH_ArkUI_CustomDialog_SetBorderWidth](#oh_arkui_customdialog_setborderwidth) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, float top, float right, float bottom, float left, [ArkUI_LengthMetricUnit](#arkui_lengthmetricunit) unit) | Sets the border width of a dialog box. |
449| int32_t [OH_ArkUI_CustomDialog_SetBorderColor](#oh_arkui_customdialog_setbordercolor) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, uint32_t top, uint32_t right, uint32_t bottom, uint32_t left) | Sets the border color of the dialog box. |
450| int32_t [OH_ArkUI_CustomDialog_SetBorderStyle](#oh_arkui_customdialog_setborderstyle) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, int32_t top, int32_t right, int32_t bottom, int32_t left) | Sets the border style of a dialog box. |
451| int32_t [OH_ArkUI_CustomDialog_SetWidth](#oh_arkui_customdialog_setwidth) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, float width, [ArkUI_LengthMetricUnit](#arkui_lengthmetricunit) unit) | Sets the width of the dialog box background. |
452| int32_t [OH_ArkUI_CustomDialog_SetHeight](#oh_arkui_customdialog_setheight) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, float height, [ArkUI_LengthMetricUnit](#arkui_lengthmetricunit) unit) | Sets the height of the dialog box background. |
453| int32_t [OH_ArkUI_CustomDialog_SetShadow](#oh_arkui_customdialog_setshadow) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, [ArkUI_ShadowStyle](#arkui_shadowstyle) shadow) | Sets the shadow of the dialog box background. |
454| int32_t [OH_ArkUI_CustomDialog_SetCustomShadow](#oh_arkui_customdialog_setcustomshadow) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, const [ArkUI_AttributeItem](_ark_u_i___attribute_item.md#arkui_attributeitem) \*customShadow) | Sets the custom shadow of the dialog box background. |
455| int32_t [OH_ArkUI_CustomDialog_SetBackgroundBlurStyle](#oh_arkui_customdialog_setbackgroundblurstyle) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, [ArkUI_BlurStyle](#arkui_blurstyle) blurStyle) | Sets the background blur style of the dialog box. |
456| int32_t [OH_ArkUI_CustomDialog_SetAlignment](#oh_arkui_customdialog_setalignment) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, int32_t alignment, float offsetX, float offsetY) | Sets the alignment mode of a dialog box. |
457| int32_t [OH_ArkUI_CustomDialog_SetModalMode](#oh_arkui_customdialog_setmodalmode) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, bool isModal) | Sets the modal mode for a custom dialog box. |
458| int32_t [OH_ArkUI_CustomDialog_SetAutoCancel](#oh_arkui_customdialog_setautocancel) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, bool autoCancel) | Specifies whether to allow users to touch the mask to dismiss the custom dialog box. |
459| int32_t [OH_ArkUI_CustomDialog_SetSubwindowMode](#oh_arkui_customdialog_setsubwindowmode) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, bool showInSubwindow) | Sets whether to display the dialog box in a subwindow. |
460| int32_t [OH_ArkUI_CustomDialog_SetMask](#oh_arkui_customdialog_setmask) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, uint32_t maskColor, const [ArkUI_Rect](_ark_u_i___rect.md#arkui_rect) \*maskRect) | Sets the mask for a custom dialog box. |
461| int32_t [OH_ArkUI_CustomDialog_SetKeyboardAvoidMode](#oh_arkui_customdialog_setkeyboardavoidmode) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, [ArkUI_KeyboardAvoidMode](_ark_u_i___native_module.md#arkui_keyboardavoidmode) keyboardAvoidMode) | Sets the keyboard avoidance mode of a dialog box. |
462| int32_t [OH_ArkUI_CustomDialog_SetHoverModeEnabled](#oh_arkui_customdialog_sethovermodeenabled) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, bool enabled) | Sets whether to enable the hover mode for a dialog box. |
463| int32_t [OH_ArkUI_CustomDialog_SetHoverModeArea](#oh_arkui_customdialog_sethovermodearea) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, [ArkUI_HoverModeAreaType](#arkui_hovermodeareatype) hoverModeAreaType) | Sets the default display area of a dialog box in hover mode. |
464| int32_t [OH_ArkUI_CustomDialog_RegisterOnWillDismissCallback](#oh_arkui_customdialog_registeronwilldismisscallback) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, void\* userData, void (\*callback)([ArkUI_DialogDismissEvent](#arkui_dialogdismissevent) \*event)) | Registers a callback for the dismissal event of a custom dialog box. |
465| int32_t [OH_ArkUI_CustomDialog_RegisterOnWillAppearCallback](#oh_arkui_customdialog_registeronwillappearcallback) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, void\* userData, void (\*callback)(void\* userData)) | Registers a callback to be invoked when the specified custom dialog box is about to appear. |
466| int32_t [OH_ArkUI_CustomDialog_RegisterOnDidAppearCallback](#oh_arkui_customdialog_registerondidappearcallback) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, void\* userData, void (\*callback)(void\* userData)) | Registers a callback to be invoked when the specifiedcustom dialog box appears. |
467| int32_t [OH_ArkUI_CustomDialog_RegisterOnWillDisappearCallback](#oh_arkui_customdialog_registeronwilldisappearcallback) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, void\* userData, void (\*callback)(void\* userData)) | Registers a callback to be invoked when the specified custom dialog box is about to disappear. |
468| int32_t [OH_ArkUI_CustomDialog_RegisterOnDidDisappearCallback](#oh_arkui_customdialog_registerondiddisappearcallback) ([ArkUI_CustomDialogOptions](#arkui_customdialogoptions) \*options, void\* userData, void (\*callback)(void\* userData)) | Registers a callback to be invoked when the specified custom dialog box disappears. |
469| 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. |
470| ArkUI_GestureRecognizer \* [OH_ArkUI_GestureInterruptInfo_GetRecognizer](#oh_arkui_gestureinterruptinfo_getrecognizer) (const ArkUI_GestureInterruptInfo \*event) | Obtains the pointer to interrupted gesture recognizer. |
471| ArkUI_GestureEvent \* [OH_ArkUI_GestureInterruptInfo_GetGestureEvent](#oh_arkui_gestureinterruptinfo_getgestureevent) (const ArkUI_GestureInterruptInfo \*event) | Obtains the pointer to the interrupted gesture event. |
472| int32_t [OH_ArkUI_GestureInterruptInfo_GetSystemRecognizerType](#oh_arkui_gestureinterruptinfo_getsystemrecognizertype) (const ArkUI_GestureInterruptInfo \*event) | Obtains the type of the system gesture to trigger. |
473| int32_t [OH_ArkUI_GestureInterruptInfo_GetTouchRecognizers](#oh_arkui_gestureinterruptinfo_gettouchrecognizers) (const ArkUI_GestureInterruptInfo \*info, ArkUI_TouchRecognizerHandleArray\* recognizers, int32_t\* size) | Obtains touch recognizers from gesture interruption information. |
474| int32_t [OH_ArkUI_TouchRecognizer_GetNodeHandle](#oh_arkui_touchrecognizer_getnodehandle) (const ArkUI_TouchRecognizerHandle recognizer) | Obtains the component handle corresponding to a touch recognizer. |
475| int32_t [OH_ArkUI_TouchRecognizer_CancelTouch](#oh_arkui_touchrecognizer_canceltouch) (ArkUI_TouchRecognizerHandle recognizer, ArkUI_GestureInterruptInfo\* info) | Sends a cancel touch event to a touch recognizer in a gesture interruption callback. |
476| [ArkUI_GestureEventActionType](#arkui_gestureeventactiontype) [OH_ArkUI_GestureEvent_GetActionType](#oh_arkui_gestureevent_getactiontype) (const ArkUI_GestureEvent \*event) | Obtains the gesture event type. |
477| [ArkUI_NodeHandle](#arkui_nodehandle) [OH_ArkUI_GestureEvent_GetResponseNode](#oh_arkui_gestureevent_getresponsenode) (ArkUI_GestureEvent \*event) | Obtains the node that responds to the gesture. |
478| 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. |
479| 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. |
480| float [OH_ArkUI_PanGesture_GetVelocity](#oh_arkui_pangesture_getvelocity) (const ArkUI_GestureEvent \*event) | Obtains the velocity of a pan gesture along the main axis. |
481| float [OH_ArkUI_PanGesture_GetVelocityX](#oh_arkui_pangesture_getvelocityx) (const ArkUI_GestureEvent \*event) | Obtains the velocity of a pan gesture along the x-axis. |
482| float [OH_ArkUI_PanGesture_GetVelocityY](#oh_arkui_pangesture_getvelocityy) (const ArkUI_GestureEvent \*event) | Obtains the velocity of a pan gesture along the y-axis. |
483| 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. |
484| 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. |
485| float [OH_ArkUI_SwipeGesture_GetAngle](#oh_arkui_swipegesture_getangle) (const ArkUI_GestureEvent \*event) | Obtains the angle information of the swipe gesture. |
486| 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. |
487| float [OH_ArkUI_RotationGesture_GetAngle](#oh_arkui_rotationgesture_getangle) (const ArkUI_GestureEvent \*event) | Obtains the angle information of a rotation gesture. |
488| float [OH_ArkUI_PinchGesture_GetScale](#oh_arkui_pinchgesture_getscale) (const ArkUI_GestureEvent \*event) | Obtains the scale ratio of a pinch gesture. |
489| 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. |
490| 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. |
491| [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. |
492| 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. |
493| int32_t [OH_ArkUI_SetGestureRecognizerEnabled](#oh_arkui_setgesturerecognizerenabled) (ArkUI_GestureRecognizer \*recognizer, bool enabled) | Sets the enabled state of a gesture recognizer. |
494| int32_t(\* [OH_ArkUI_SetGestureRecognizerLimitFingerCount](#oh_arkui_setgesturerecognizerlimitfingercount) )(ArkUI_GestureRecognizer \*recognizer, bool limitFingerCount) | Sets whether to check the number of fingers touching the screen. |
495| bool [OH_ArkUI_GetGestureRecognizerEnabled](#oh_arkui_getgesturerecognizerenabled) (ArkUI_GestureRecognizer \*recognizer) | Obtains the enabled state of a gesture recognizer. |
496| int32_t [OH_ArkUI_GetGestureRecognizerState](#oh_arkui_getgesturerecognizerstate) (ArkUI_GestureRecognizer \*recognizer, [ArkUI_GestureRecognizerState](#arkui_gesturerecognizerstate) \*state) | Obtains the state of a gesture recognizer. |
497| int32_t [OH_ArkUI_GetGestureEventTargetInfo](#oh_arkui_getgestureeventtargetinfo) (ArkUI_GestureRecognizer \*recognizer, [ArkUI_GestureEventTargetInfo](#arkui_gestureeventtargetinfo) \*\*info) | Obtains the information about a gesture event target. |
498| 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. |
499| 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. |
500| int32_t [OH_ArkUI_GetPanGestureDirectionMask](#oh_arkui_getpangesturedirectionmask) (ArkUI_GestureRecognizer \*recognizer, [ArkUI_GestureDirectionMask](#arkui_gesturedirectionmask) \*directionMask) | Obtains the direction of a pan gesture. |
501| bool [OH_ArkUI_IsBuiltInGesture](#oh_arkui_isbuiltingesture) (ArkUI_GestureRecognizer \*recognizer) | Obtains whether a gesture is a built-in gesture. |
502| 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. |
503| 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. |
504| bool [OH_ArkUI_IsGestureRecognizerValid](#oh_arkui_isgesturerecognizervalid) (ArkUI_GestureRecognizer \*recognizer) | Obtains whether a gesture recognizer is valid. |
505| void \* [OH_ArkUI_ParallelInnerGestureEvent_GetUserData](#oh_arkui_parallelinnergestureevent_getuserdata) ([ArkUI_ParallelInnerGestureEvent](#arkui_parallelinnergestureevent) \*event) | Obtains custom data in the parallel internal gesture event. |
506| void* [OH_ArkUI_GestureInterrupter_GetUserData](#oh_arkui_gestureinterrupter_getuserdata) ([ArkUI_GestureInterruptInfo](#arkui_gestureinterruptinfo)* event) | Obtains the custom data from a gesture interruption event.|
507| 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. |
508| 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. |
509| 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. |
510| void \* [OH_ArkUI_QueryModuleInterfaceByName](#oh_arkui_querymoduleinterfacebyname) ([ArkUI_NativeAPIVariantKind](#arkui_nativeapivariantkind) type, const char \*structName) | Obtains the native API set of a specified type. |
511| [ArkUI_KeyEventType](#arkui_keyeventtype) [OH_ArkUI_KeyEvent_GetType](#oh_arkui_keyevent_gettype) (const [ArkUI_UIInputEvent](_ark_u_i___event_module.md#arkui_uiinputevent) \*event) | Obtains the type of a key event. |
512| int32_t [OH_ArkUI_KeyEvent_GetKeyCode](#oh_arkui_keyevent_getkeycode) (const [ArkUI_UIInputEvent](_ark_u_i___event_module.md#arkui_uiinputevent) \*event) | Obtains the key code from a key event. |
513| const char \* [OH_ArkUI_KeyEvent_GetKeyText](#oh_arkui_keyevent_getkeytext) (const [ArkUI_UIInputEvent](_ark_u_i___event_module.md#arkui_uiinputevent) \*event) | Obtains the key value from a key event. |
514| [ArkUI_KeySourceType](#arkui_keysourcetype) [OH_ArkUI_KeyEvent_GetKeySource](#oh_arkui_keyevent_getkeysource) (const [ArkUI_UIInputEvent](_ark_u_i___event_module.md#arkui_uiinputevent) \*event) | Obtains the type of input device that triggers a key event. |
515| void [OH_ArkUI_KeyEvent_StopPropagation](#oh_arkui_keyevent_stoppropagation) (const [ArkUI_UIInputEvent](_ark_u_i___event_module.md#arkui_uiinputevent) \*event, bool stopPropagation) | Stops a key event from bubbling upwards or downwards. |
516| void [OH_ArkUI_KeyEvent_Dispatch](#oh_arkui_keyevent_dispatch) ([ArkUI_NodeHandle](#arkui_nodehandle) \*node, const [ArkUI_UIInputEvent](_ark_u_i___event_module.md#arkui_uiinputevent) \*event) | Dispatches a key event to a specific node. |
517| [ArkUI_KeyIntension](#arkui_keyintension) [OH_ArkUI_KeyEvent_GetKeyIntensionCode](#oh_arkui_keyevent_getkeyintensioncode) (const [ArkUI_UIInputEvent](_ark_u_i___event_module.md#arkui_uiinputevent) \*event) | Obtains the intention code associated with a key event. |
518| uint32_t [OH_ArkUI_KeyEvent_GetUnicode](#oh_arkui_keyevent_getunicode) (const [ArkUI_UIInputEvent](_ark_u_i___event_module.md#arkui_uiinputevent) \*event) | Obtains the Unicode value of a key event. Non-space basic Latin characters in the 0x0021-0x007E range are supported. Characters with a value of 0 are not supported. In the case of key combination, this API returns the Unicode value of the key corresponding to the key event. |
519| void [OH_ArkUI_KeyEvent_SetConsumed](#oh_arkui_keyevent_setconsumed) (const [ArkUI_UIInputEvent](_ark_u_i___event_module.md#arkui_uiinputevent) \*event, bool isConsumed) | Sets whether a key event is consumed in the key event callback. |
520| [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. |
521| int32_t [OH_ArkUI_NodeEvent_GetTargetId](#oh_arkui_nodeevent_gettargetid) ([ArkUI_NodeEvent](#arkui_nodeevent-12) \*event) | Obtains the custom ID of a component event. |
522| [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. |
523| [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. |
524| [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. |
525| [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. |
526| void \* [OH_ArkUI_NodeEvent_GetUserData](#oh_arkui_nodeevent_getuserdata) ([ArkUI_NodeEvent](#arkui_nodeevent-12) \*event) | Obtains the custom data in a component event. |
527| 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. |
528| 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. |
529| 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. |
530| [ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) [OH_ArkUI_NodeAdapter_Create](#oh_arkui_nodeadapter_create) () | Creates a component adapter. |
531| void [OH_ArkUI_NodeAdapter_Dispose](#oh_arkui_nodeadapter_dispose) ([ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) handle) | Destroys a component adapter. |
532| 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. |
533| 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. |
534| 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. |
535| void [OH_ArkUI_NodeAdapter_UnregisterEventReceiver](#oh_arkui_nodeadapter_unregistereventreceiver) ([ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) handle) | Unregisters an event callback for the specified adapter. |
536| int32_t [OH_ArkUI_NodeAdapter_ReloadAllItems](#oh_arkui_nodeadapter_reloadallitems) ([ArkUI_NodeAdapterHandle](#arkui_nodeadapterhandle) handle) | Instructs the specified adapter to reload all elements. |
537| 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. |
538| 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. |
539| 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. |
540| 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. |
541| 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. |
542| 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. |
543| [ArkUI_NodeAdapterEventType](#arkui_nodeadaptereventtype) [OH_ArkUI_NodeAdapterEvent_GetType](#oh_arkui_nodeadapterevent_gettype) ([ArkUI_NodeAdapterEvent](#arkui_nodeadapterevent) \*event) | Obtains the event type. |
544| [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. |
545| 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. |
546| [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. |
547| 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. |
548| 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. |
549| [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. |
550| [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. |
551| [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. |
552| int32_t [OH_ArkUI_NodeCustomEvent_GetEventTargetId](#oh_arkui_nodecustomevent_geteventtargetid) ([ArkUI_NodeCustomEvent](#arkui_nodecustomevent) \*event) | Obtains the ID of a custom component event. |
553| void \* [OH_ArkUI_NodeCustomEvent_GetUserData](#oh_arkui_nodecustomevent_getuserdata) ([ArkUI_NodeCustomEvent](#arkui_nodecustomevent) \*event) | Obtains custom event parameters through a custom component event. |
554| [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. |
555| [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. |
556| 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. |
557| 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. |
558| 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. |
559| 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. |
560| [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. |
561| [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. |
562| 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. |
563| void \* [OH_ArkUI_NodeContent_GetUserData](#oh_arkui_nodecontent_getuserdata) ([ArkUI_NodeContentHandle](#arkui_nodecontenthandle) content) | Obtains the custom data saved on the specified NodeContent object. |
564| 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. |
565| 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. |
566| 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. |
567| 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. |
568| 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. |
569| 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. |
570| 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. |
571| 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. |
572| 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. |
573| 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. |
574| 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. |
575| int32_t [OH_ArkUI_NodeUtils_GetCustomProperty](#oh_arkui_nodeutils_getcustomproperty) ([ArkUI_NodeHandle](#arkui_nodehandle) node, const char \*name, ArkUI_CustomProperty \*\*handle) | Obtains the value of a custom property of the specified component. |
576| [ArkUI_NodeHandle](#arkui_nodehandle) [OH_ArkUI_NodeUtils_GetParentInPageTree](#oh_arkui_nodeutils_getparentinpagetree) ([ArkUI_NodeHandle](#arkui_nodehandle) node) | Obtains the parent node, which can be a component node created with ArkTS. |
577| int32_t [OH_ArkUI_NodeUtils_GetActiveChildrenInfo](#oh_arkui_nodeutils_getactivechildreninfo) ([ArkUI_NodeHandle](#arkui_nodehandle) head, ArkUI_ActiveChildrenInfo \*\*handle) | Obtains all active child nodes of the specified node. Spans are not counted as child nodes. |
578| [ArkUI_NodeHandle](#arkui_nodehandle) [OH_ArkUI_NodeUtils_GetCurrentPageRootNode](#oh_arkui_nodeutils_getcurrentpagerootnode) ([ArkUI_NodeHandle](#arkui_nodehandle) node) | Obtains the root node of the current page. |
579| bool [OH_ArkUI_NodeUtils_IsCreatedByNDK](#oh_arkui_nodeutils_iscreatedbyndk) ([ArkUI_NodeHandle](#arkui_nodehandle) node) | Checks whether the specified component is created with the C API. |
580| int32_t [OH_ArkUI_NodeUtils_GetNodeType](#oh_arkui_nodeutils_getnodetype) ([ArkUI_NodeHandle](#arkui_nodehandle) node) | Obtains the type of the specified node. |
581| 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. |
582| [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. |
583| 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. |
584| void [OH_ArkUI_UnregisterSystemColorModeChangeEvent](#oh_arkui_unregistersystemcolormodechangeevent) ([ArkUI_NodeHandle](#arkui_nodehandle) node) | Unregisters the event listener for system color mode changes. |
585| 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. |
586| void [OH_ArkUI_UnregisterSystemFontStyleChangeEvent](#oh_arkui_unregistersystemfontstylechangeevent) ([ArkUI_NodeHandle](#arkui_nodehandle) node) | Unregisters the event listener for system font style changes. |
587| 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. |
588| 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. |
589| 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. |
590| 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. |
591| 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. |
592| 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. |
593| 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. |
594| [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. |
595| [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. |
596| [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. |
597| [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. |
598| [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. |
599| [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. |
600| [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. |
601| 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. |
602| [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. |
603| [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. |
604| [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. |
605| [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. |
606| [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. |
607| [ArkUI_LayoutConstraint](#arkui_layoutconstraint) \* [OH_ArkUI_LayoutConstraint_Create](#oh_arkui_layoutconstraint_create) () | Creates a size constraint. |
608| [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. |
609| void \* [OH_ArkUI_LayoutConstraint_Dispose](#oh_arkui_layoutconstraint_dispose) ([ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint) | Disposes of the pointer to a size constraint. |
610| 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. |
611| 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. |
612| 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. |
613| 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. |
614| 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. |
615| 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. |
616| void [OH_ArkUI_LayoutConstraint_SetMaxWidth](#oh_arkui_layoutconstraint_setmaxwidth) ([ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint, int32_t value) | Sets the maximum width. |
617| void [OH_ArkUI_LayoutConstraint_SetMinWidth](#oh_arkui_layoutconstraint_setminwidth) ([ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint, int32_t value) | Sets the minimum width. |
618| void [OH_ArkUI_LayoutConstraint_SetMaxHeight](#oh_arkui_layoutconstraint_setmaxheight) ([ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint, int32_t value) | Sets the maximum height. |
619| void [OH_ArkUI_LayoutConstraint_SetMinHeight](#oh_arkui_layoutconstraint_setminheight) ([ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint, int32_t value) | Sets the minimum height. |
620| void [OH_ArkUI_LayoutConstraint_SetPercentReferenceWidth](#oh_arkui_layoutconstraint_setpercentreferencewidth) ([ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint, int32_t value) | Sets the width percentage reference. |
621| void [OH_ArkUI_LayoutConstraint_SetPercentReferenceHeight](#oh_arkui_layoutconstraint_setpercentreferenceheight) ([ArkUI_LayoutConstraint](#arkui_layoutconstraint) \*Constraint, int32_t value) | Sets the height percentage reference. |
622| 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. |
623| [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. |
624| [ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \* [OH_ArkUI_WaterFlowSectionOption_Create](#oh_arkui_waterflowsectionoption_create) () | Creates a water flow section configuration. |
625| void [OH_ArkUI_WaterFlowSectionOption_Dispose](#oh_arkui_waterflowsectionoption_dispose) ([ArkUI_WaterFlowSectionOption](#arkui_waterflowsectionoption) \*option) | Disposes of the pointer to a water flow section configuration. |
626| 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. |
627| 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. |
628| 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. |
629| 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. |
630| 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. |
631| 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. |
632| 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. |
633| 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. |
634| 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. |
635| 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. |
636| 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. |
637| [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. |
638| 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. |
639| 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. |
640| [ArkUI_GuidelineOption](#arkui_guidelineoption) \* [OH_ArkUI_GuidelineOption_Create](#oh_arkui_guidelineoption_create) (int32_t size) | Creates a guideline configuration for this **RelativeContainer** component. |
641| void [OH_ArkUI_GuidelineOption_Dispose](#oh_arkui_guidelineoption_dispose) ([ArkUI_GuidelineOption](#arkui_guidelineoption) \*guideline) | Disposes of a guideline configuration. |
642| 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. |
643| 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. |
644| 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. |
645| 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. |
646| const char \* [OH_ArkUI_GuidelineOption_GetId](#oh_arkui_guidelineoption_getid) ([ArkUI_GuidelineOption](#arkui_guidelineoption) \*guideline, int32_t index) | Obtains the ID of a guideline. |
647| [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. |
648| 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. |
649| 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. |
650| [ArkUI_BarrierOption](#arkui_barrieroption) \* [OH_ArkUI_BarrierOption_Create](#oh_arkui_barrieroption_create) (int32_t size) | Creates a barrier configuration for this **RelativeContainer** component. |
651| void [OH_ArkUI_BarrierOption_Dispose](#oh_arkui_barrieroption_dispose) ([ArkUI_BarrierOption](#arkui_barrieroption) \*barrierStyle) | Disposes of a barrier configuration. |
652| 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. |
653| 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. |
654| 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. |
655| const char \* [OH_ArkUI_BarrierOption_GetId](#oh_arkui_barrieroption_getid) ([ArkUI_BarrierOption](#arkui_barrieroption) \*barrierStyle, int32_t index) | Obtains the ID of a barrier. |
656| [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. |
657| 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. |
658| 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. |
659| [ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \* [OH_ArkUI_AlignmentRuleOption_Create](#oh_arkui_alignmentruleoption_create) () | Creates an alignment rule configuration for this **RelativeContainer** component. |
660| void [OH_ArkUI_AlignmentRuleOption_Dispose](#oh_arkui_alignmentruleoption_dispose) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Disposes of an alignment rule configuration of this **RelativeContainer** component. |
661| 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. |
662| 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. |
663| 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. |
664| 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. |
665| 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. |
666| 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. |
667| 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. |
668| 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. |
669| const char \* [OH_ArkUI_AlignmentRuleOption_GetStartId](#oh_arkui_alignmentruleoption_getstartid) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in the left alignment parameters. |
670| [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. |
671| const char \* [OH_ArkUI_AlignmentRuleOption_GetEndId](#oh_arkui_alignmentruleoption_getendid) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in the right alignment parameters. |
672| [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. |
673| const char \* [OH_ArkUI_AlignmentRuleOption_GetCenterIdHorizontal](#oh_arkui_alignmentruleoption_getcenteridhorizontal) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in horizontal center alignment parameters. |
674| [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. |
675| const char \* [OH_ArkUI_AlignmentRuleOption_GetTopId](#oh_arkui_alignmentruleoption_gettopid) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in top alignment parameters. |
676| [ArkUI_VerticalAlignment](#arkui_verticalalignment) [OH_ArkUI_AlignmentRuleOption_GetTopAlignment](#oh_arkui_alignmentruleoption_gettopalignment) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in top alignment parameters. |
677| const char \* [OH_ArkUI_AlignmentRuleOption_GetBottomId](#oh_arkui_alignmentruleoption_getbottomid) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in bottom alignment parameters. |
678| [ArkUI_VerticalAlignment](#arkui_verticalalignment) [OH_ArkUI_AlignmentRuleOption_GetBottomAlignment](#oh_arkui_alignmentruleoption_getbottomalignment) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in bottom alignment parameters. |
679| const char \* [OH_ArkUI_AlignmentRuleOption_GetCenterIdVertical](#oh_arkui_alignmentruleoption_getcenteridvertical) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the ID in vertical center alignment parameters. |
680| [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. |
681| float [OH_ArkUI_AlignmentRuleOption_GetBiasHorizontal](#oh_arkui_alignmentruleoption_getbiashorizontal) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the bias value in the horizontal direction. |
682| float [OH_ArkUI_AlignmentRuleOption_GetBiasVertical](#oh_arkui_alignmentruleoption_getbiasvertical) ([ArkUI_AlignmentRuleOption](#arkui_alignmentruleoption) \*option) | Obtains the bias value in the vertical direction. |
683| [ArkUI_SwiperIndicator](#arkui_swiperindicator) \* [OH_ArkUI_SwiperIndicator_Create](#oh_arkui_swiperindicator_create) ([ArkUI_SwiperIndicatorType](#arkui_swiperindicatortype) type) | Creates a navigation indicator for this **Swiper** component. |
684| void [OH_ArkUI_SwiperIndicator_Dispose](#oh_arkui_swiperindicator_dispose) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Disposes of the navigation indicator of this **Swiper** component. |
685| void [OH_ArkUI_SwiperIndicator_SetStartPosition](#oh_arkui_swiperindicator_setstartposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the distance between the navigation indicator and the left edge of the **Swiper** component. |
686| float [OH_ArkUI_SwiperIndicator_GetStartPosition](#oh_arkui_swiperindicator_getstartposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the distance between a navigation indicator and the left edge of the **Swiper** component. |
687| void [OH_ArkUI_SwiperIndicator_SetTopPosition](#oh_arkui_swiperindicator_settopposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the distance between the navigation indicator and the top edge of the **Swiper** component. |
688| float [OH_ArkUI_SwiperIndicator_GetTopPosition](#oh_arkui_swiperindicator_gettopposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the distance between the navigation indicator and the top edge of the **Swiper** component. |
689| void [OH_ArkUI_SwiperIndicator_SetEndPosition](#oh_arkui_swiperindicator_setendposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the distance between the navigation indicator and the right edge of the **Swiper** component. |
690| float [OH_ArkUI_SwiperIndicator_GetEndPosition](#oh_arkui_swiperindicator_getendposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the distance between the navigation indicator and the right edge of the **Swiper** component. |
691| void [OH_ArkUI_SwiperIndicator_SetBottomPosition](#oh_arkui_swiperindicator_setbottomposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the distance between the navigation indicator and the bottom edge of the **Swiper** component. |
692| float [OH_ArkUI_SwiperIndicator_GetBottomPosition](#oh_arkui_swiperindicator_getbottomposition) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the distance between the navigation indicator and the bottom edge of the **Swiper** component. |
693| void [OH_ArkUI_SwiperIndicator_SetItemWidth](#oh_arkui_swiperindicator_setitemwidth) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the width of a dot-style navigation indicator for the **Swiper** component. |
694| float [OH_ArkUI_SwiperIndicator_GetItemWidth](#oh_arkui_swiperindicator_getitemwidth) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the width of a dot-style navigation indicator of the **Swiper** component. |
695| void [OH_ArkUI_SwiperIndicator_SetItemHeight](#oh_arkui_swiperindicator_setitemheight) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the height of a dot-style navigation indicator for the **Swiper** component. |
696| float [OH_ArkUI_SwiperIndicator_GetItemHeight](#oh_arkui_swiperindicator_getitemheight) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the height of a dot-style navigation indicator of the **Swiper** component. |
697| void [OH_ArkUI_SwiperIndicator_SetSelectedItemWidth](#oh_arkui_swiperindicator_setselecteditemwidth) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the width of the selected dot-style navigation indicator for the **Swiper** component. |
698| float [OH_ArkUI_SwiperIndicator_GetSelectedItemWidth](#oh_arkui_swiperindicator_getselecteditemwidth) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the width of the selected dot-style navigation indicator of the **Swiper** component. |
699| void [OH_ArkUI_SwiperIndicator_SetSelectedItemHeight](#oh_arkui_swiperindicator_setselecteditemheight) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, float value) | Sets the height of the selected dot-style navigation indicator for the **Swiper** component. |
700| float [OH_ArkUI_SwiperIndicator_GetSelectedItemHeight](#oh_arkui_swiperindicator_getselecteditemheight) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the height of the selected dot-style navigation indicator of the **Swiper** component. |
701| 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 dot-style navigation indicator for the **Swiper** component. |
702| int32_t [OH_ArkUI_SwiperIndicator_GetMask](#oh_arkui_swiperindicator_getmask) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains whether the mask is enabled for a dot-style navigation indicator of the **Swiper** component. |
703| void [OH_ArkUI_SwiperIndicator_SetColor](#oh_arkui_swiperindicator_setcolor) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, uint32_t color) | Sets the color of a dot-style navigation indicator for the **Swiper** component. |
704| uint32_t [OH_ArkUI_SwiperIndicator_GetColor](#oh_arkui_swiperindicator_getcolor) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the color of a dot-style navigation indicator of the **Swiper** component. |
705| void [OH_ArkUI_SwiperIndicator_SetSelectedColor](#oh_arkui_swiperindicator_setselectedcolor) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator, uint32_t selectedColor) | Sets the color of the selected dot-style navigation indicator for the **Swiper** component. |
706| uint32_t [OH_ArkUI_SwiperIndicator_GetSelectedColor](#oh_arkui_swiperindicator_getselectedcolor) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the color of the selected dot-style navigation indicator of the **Swiper** component. |
707| 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 dot-style navigation indicator. |
708| int32_t [OH_ArkUI_SwiperIndicator_GetMaxDisplayCount](#oh_arkui_swiperindicator_getmaxdisplaycount) ([ArkUI_SwiperIndicator](#arkui_swiperindicator) \*indicator) | Obtains the maximum number of points for the navigation indicator. |
709| [ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* [OH_ArkUI_SwiperDigitIndicator_Create](#oh_arkui_swiperdigitindicator_create)() | Creates a digit-style navigation indicator for this **Swiper** component. |
710| void [OH_ArkUI_SwiperDigitIndicator_SetStartPosition](#oh_arkui_swiperdigitindicator_setstartposition)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator, float value) | Sets the start position of the digit-style navigation indicator for the **Swiper** component. This determines the distance from the left edge of the **Swiper** component. For right-to-left scripts, this determines the distance from the right edge. |
711| float [OH_ArkUI_SwiperDigitIndicator_GetStartPosition](#oh_arkui_swiperdigitindicator_getstartposition)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator) | Obtains the start position of the digit-style navigation indicator for the **Swiper** component. This indicates the distance from the left edge of the **Swiper** component. For right-to-left scripts, this indicates the distance from the right edge. |
712| void [OH_ArkUI_SwiperDigitIndicator_SetTopPosition](#oh_arkui_swiperdigitindicator_settopposition)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator, float value) | Sets the distance from the digit-style navigation indicator to the top of the **Swiper** component.|
713| float [OH_ArkUI_SwiperDigitIndicator_GetTopPosition](#oh_arkui_swiperdigitindicator_gettopposition)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator) | Obtains the distance from the digit-style navigation indicator to the top of the **Swiper** component. |
714| void [OH_ArkUI_SwiperDigitIndicator_SetEndPosition](#oh_arkui_swiperdigitindicator_setendposition)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator, float value) | Sets the end position of the digit-style navigation indicator for the **Swiper** component. This determines the distance from the right edge of the **Swiper** component. For right-to-left scripts, this determines the distance from the left edge.|
715| float [OH_ArkUI_SwiperDigitIndicator_GetEndPosition](#oh_arkui_swiperdigitindicator_getendposition)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator) | Obtains the end position of the digit-style navigation indicator for the **Swiper** component. This indicates the distance from the right edge of the **Swiper** component. For right-to-left scripts, this indicates the distance from the left edge. |
716| void [OH_ArkUI_SwiperDigitIndicator_SetBottomPosition](#oh_arkui_swiperdigitindicator_setbottomposition)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator, float value) | Sets the distance from the digit-style navigation indicator to the bottom of the **Swiper** component.|
717| float [OH_ArkUI_SwiperDigitIndicator_GetBottomPosition](#oh_arkui_swiperdigitindicator_getbottomposition)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator) | Obtains the distance from the digit-style navigation indicator to the bottom of the **Swiper** component. |
718| void [OH_ArkUI_SwiperDigitIndicator_SetFontColor](#oh_arkui_swiperdigitindicator_setfontcolor)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator, uint32_t color) | Sets the font color of the digit-style navigation indicator for the **Swiper** component.|
719| uint32_t [OH_ArkUI_SwiperDigitIndicator_GetFontColor](#oh_arkui_swiperdigitindicator_getfontcolor)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator) | Obtains the font color of the digit-style navigation indicator for the **Swiper** component. |
720| void [OH_ArkUI_SwiperDigitIndicator_SetSelectedFontColor](#oh_arkui_swiperdigitindicator_setselectedfontcolor)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator, uint32_t selectedColor) | Sets the font color of the selected digit-style navigation indicator for the **Swiper** component.|
721| uint32_t [OH_ArkUI_SwiperDigitIndicator_GetSelectedFontColor](#oh_arkui_swiperdigitindicator_getselectedfontcolor)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator) | Obtains the font color of the selected digit-style navigation indicator for the **Swiper** component. |
722| void [OH_ArkUI_SwiperDigitIndicator_SetFontSize](#oh_arkui_swiperdigitindicator_setfontsize)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator, float size) | Sets the font size of the digit-style navigation indicator for the **Swiper** component.|
723| float [OH_ArkUI_SwiperDigitIndicator_GetFontSize](#oh_arkui_swiperdigitindicator_getfontsize)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator) | Obtains the font size of the digit-style navigation indicator for the **Swiper** component. |
724| void [OH_ArkUI_SwiperDigitIndicator_SetSelectedFontSize](#oh_arkui_swiperdigitindicator_setselectedfontsize)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator, float size) | Sets the font size of the selected digit-style navigation indicator for the **Swiper** component.|
725| float [OH_ArkUI_SwiperDigitIndicator_GetSelectedFontSize](#oh_arkui_swiperdigitindicator_getselectedfontsize)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator) | Obtains the font size of the selected digit-style navigation indicator for the **Swiper** component. |
726| void [OH_ArkUI_SwiperDigitIndicator_SetFontWeight](#oh_arkui_swiperdigitindicator_setfontweight)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator, [ArkUI_FontWeight](#arkui_fontweight) fontWeight) | Sets the font weight of the digit-style navigation indicator for the **Swiper** component.|
727| [ArkUI_FontWeight](#arkui_fontweight) [OH_ArkUI_SwiperDigitIndicator_GetFontWeight](#oh_arkui_swiperdigitindicator_getfontweight)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator) | Obtains the font weight of the digit-style navigation indicator for the **Swiper** component. |
728| void [OH_ArkUI_SwiperDigitIndicator_SetSelectedFontWeight](#oh_arkui_swiperdigitindicator_setselectedfontweight)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator, [ArkUI_FontWeight](#arkui_fontweight) selectedFontWeight) | Sets the font weight of the selected digit-style navigation indicator for the **Swiper** component.|
729| [ArkUI_FontWeight](#arkui_fontweight) [OH_ArkUI_SwiperDigitIndicator_GetSelectedFontWeight](#oh_arkui_swiperdigitindicator_getselectedfontweight)([ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator)* indicator) | Obtains the font weight of the selected digit-style navigation indicator for the **Swiper** component. |
730|void [OH_ArkUI_SwiperDigitIndicator_Dispose](#oh_arkui_swiperdigitindicator_dispose)() | Disposes of the digit-style navigation indicator of this **Swiper** component. |
731| [ArkUI_SwiperArrowStyle](#arkui_swiperarrowstyle)* [OH_ArkUI_SwiperArrowStyle_Create](#oh_arkui_swiperarrowstyle_create)() | Creates an arrow style for the **Swiper** component. |
732| void [OH_ArkUI_SwiperArrowStyle_SetShowBackground](#oh_arkui_swiperarrowstyle_setshowbackground)([ArkUI_SwiperArrowStyle](#arkui_swiperarrowstyle)* indicator, int32_t showBackground) | Sets whether to display the background of the arrow for the **Swiper** component.|
733| int32_t [OH_ArkUI_SwiperArrowStyle_GetShowBackground](#oh_arkui_swiperarrowstyle_getshowbackground)([ArkUI_SwiperArrowStyle](#arkui_swiperarrowstyle)* indicator) | Checks whether the background of the arrow is displayed for the **Swiper** component. |
734| void [OH_ArkUI_SwiperArrowStyle_SetShowSidebarMiddle](#oh_arkui_swiperarrowstyle_setshowsidebarmiddle)([ArkUI_SwiperArrowStyle](#arkui_swiperarrowstyle)* indicator, int32_t showSidebarMiddle) | Sets the position of the arrow for the **Swiper** component.|
735| int32_t [OH_ArkUI_SwiperArrowStyle_GetShowSidebarMiddle](#oh_arkui_swiperarrowstyle_getshowsidebarmiddle)([ArkUI_SwiperArrowStyle](#arkui_swiperarrowstyle)* indicator) | Obtains the position of the arrow for the **Swiper** component. |
736| void [OH_ArkUI_SwiperArrowStyle_SetBackgroundSize](#oh_arkui_swiperarrowstyle_setbackgroundsize)([ArkUI_SwiperArrowStyle](#arkui_swiperarrowstyle)* indicator, float backgroundSize) | Sets the background size for the arrow of the **Swiper** component.|
737| float [OH_ArkUI_SwiperArrowStyle_GetBackgroundSize](#oh_arkui_swiperarrowstyle_getbackgroundsize)([ArkUI_SwiperArrowStyle](#arkui_swiperarrowstyle)* indicator) | Obtains the background size for the arrow of the **Swiper** component. |
738| void [OH_ArkUI_SwiperArrowStyle_SetBackgroundColor](#oh_arkui_swiperarrowstyle_setbackgroundcolor)([ArkUI_SwiperArrowStyle](#arkui_swiperarrowstyle)* indicator, uint32_t backgroundColor) | Sets the background color for the arrow of the **Swiper** component.|
739| uint32_t [OH_ArkUI_SwiperArrowStyle_GetBackgroundColor](#oh_arkui_swiperarrowstyle_getbackgroundcolor)([ArkUI_SwiperArrowStyle](#arkui_swiperarrowstyle)* indicator) | Obtains the background color for the arrow of the **Swiper** component. |
740| void [OH_ArkUI_SwiperArrowStyle_SetArrowSize](#oh_arkui_swiperarrowstyle_setarrowsize)([ArkUI_SwiperArrowStyle](#arkui_swiperarrowstyle)* indicator, float arrowSize) | Sets the size for the arrow of the **Swiper** component.|
741| float [OH_ArkUI_SwiperArrowStyle_GetArrowSize](#oh_arkui_swiperarrowstyle_getarrowsize)([ArkUI_SwiperArrowStyle](#arkui_swiperarrowstyle)* indicator) | Obtains the size of the arrow of the **Swiper** component. |
742| void [OH_ArkUI_SwiperArrowStyle_SetArrowColor](#oh_arkui_swiperarrowstyle_setarrowcolor)([ArkUI_SwiperArrowStyle](#arkui_swiperarrowstyle)* indicator, uint32_t arrowColor) | Sets the color for the arrow of the **Swiper** component.|
743| uint32_t [OH_ArkUI_SwiperArrowStyle_GetArrowColor](#oh_arkui_swiperarrowstyle_getarrowcolor)([ArkUI_SwiperArrowStyle](#arkui_swiperarrowstyle)* indicator) | Obtains the color of the arrow of the **Swiper** component. |
744|void [OH_ArkUI_SwiperArrowStyle_Dispose](#oh_arkui_swiperarrowstyle_dispose)() | Disposes of the arrow style of the **Swiper** component. |
745| [ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \* [OH_ArkUI_ListItemSwipeActionItem_Create](#oh_arkui_listitemswipeactionitem_create) () | Creates a **ListItemSwipeActionItem** instance. |
746| void [OH_ArkUI_ListItemSwipeActionItem_Dispose](#oh_arkui_listitemswipeactionitem_dispose) ([ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item) | Disposes of a **ListItemSwipeActionItem** instance. |
747| 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. |
748| 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. |
749| float [OH_ArkUI_ListItemSwipeActionItem_GetActionAreaDistance](#oh_arkui_listitemswipeactionitem_getactionareadistance) ([ArkUI_ListItemSwipeActionItem](#arkui_listitemswipeactionitem) \*item) | Obtains the swipe distance threshold for deleting the list item. |
750| 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. |
751| 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. |
752| 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. |
753| 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. |
754| 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. |
755| 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. |
756| 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. |
757| 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. |
758| [ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) \* [OH_ArkUI_ListItemSwipeActionOption_Create](#oh_arkui_listitemswipeactionoption_create) () | Creates a **ListItemSwipeActionOption** instance. |
759| void [OH_ArkUI_ListItemSwipeActionOption_Dispose](#oh_arkui_listitemswipeactionoption_dispose) ([ArkUI_ListItemSwipeActionOption](#arkui_listitemswipeactionoption) \*option) | Disposes of a **ListItemSwipeActionOption** instance. |
760| 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. |
761| 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. |
762| 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. |
763| 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. |
764| 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. |
765| 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. |
766| [ArkUI_AccessibilityState](#arkui_accessibilitystate) \* [OH_ArkUI_AccessibilityState_Create](#oh_arkui_accessibilitystate_create) (void) | Creates an accessibility state. |
767| void [OH_ArkUI_AccessibilityState_Dispose](#oh_arkui_accessibilitystate_dispose) ([ArkUI_AccessibilityState](#arkui_accessibilitystate) \*state) | Disposes of the pointer to an accessibility state. |
768| void [OH_ArkUI_AccessibilityState_SetDisabled](#oh_arkui_accessibilitystate_setdisabled) ([ArkUI_AccessibilityState](#arkui_accessibilitystate) \*state, int32_t isDisabled) | Sets whether an accessibility state is disabled. |
769| int32_t [OH_ArkUI_AccessibilityState_IsDisabled](#oh_arkui_accessibilitystate_isdisabled) ([ArkUI_AccessibilityState](#arkui_accessibilitystate) \*state) | Obtains whether an accessibility state is disabled. |
770| void [OH_ArkUI_AccessibilityState_SetSelected](#oh_arkui_accessibilitystate_setselected) ([ArkUI_AccessibilityState](#arkui_accessibilitystate) \*state, int32_t isSelected) | Sets whether an accessibility state is selected. |
771| int32_t [OH_ArkUI_AccessibilityState_IsSelected](#oh_arkui_accessibilitystate_isselected) ([ArkUI_AccessibilityState](#arkui_accessibilitystate) \*state) | Obtains whether an accessibility state is selected. |
772| 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. |
773| int32_t [OH_ArkUI_AccessibilityState_GetCheckedState](#oh_arkui_accessibilitystate_getcheckedstate) ([ArkUI_AccessibilityState](#arkui_accessibilitystate) \*state) | Obtains the check box state of an accessibility state. |
774| [ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \* [OH_ArkUI_AccessibilityValue_Create](#oh_arkui_accessibilityvalue_create) (void) | Creates an **AccessibilityValue** instance. |
775| void [OH_ArkUI_AccessibilityValue_Dispose](#oh_arkui_accessibilityvalue_dispose) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value) | Disposes of the pointer to an **AccessibilityValue** instance. |
776| void [OH_ArkUI_AccessibilityValue_SetMin](#oh_arkui_accessibilityvalue_setmin) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value, int32_t min) | Sets the minimum accessibility value. |
777| int32_t [OH_ArkUI_AccessibilityValue_GetMin](#oh_arkui_accessibilityvalue_getmin) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value) | Obtains the minimum accessibility value. |
778| void [OH_ArkUI_AccessibilityValue_SetMax](#oh_arkui_accessibilityvalue_setmax) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value, int32_t max) | Sets the maximum accessibility value. |
779| int32_t [OH_ArkUI_AccessibilityValue_GetMax](#oh_arkui_accessibilityvalue_getmax) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value) | Obtains the maximum accessibility value. |
780| void [OH_ArkUI_AccessibilityValue_SetCurrent](#oh_arkui_accessibilityvalue_setcurrent) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value, int32_t current) | Sets the current accessibility value. |
781| int32_t [OH_ArkUI_AccessibilityValue_GetCurrent](#oh_arkui_accessibilityvalue_getcurrent) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value) | Obtains the current accessibility value. |
782| 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. |
783| const char \* [OH_ArkUI_AccessibilityValue_GetText](#oh_arkui_accessibilityvalue_gettext) ([ArkUI_AccessibilityValue](#arkui_accessibilityvalue) \*value) | Obtains the text description of an **AccessibilityValue** instance. |
784| [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. |
785| [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. |
786| void [OH_ArkUI_ImageAnimatorFrameInfo_Dispose](#oh_arkui_imageanimatorframeinfo_dispose) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo) | Disposes of the pointer to an image frame information object. |
787| void [OH_ArkUI_ImageAnimatorFrameInfo_SetWidth](#oh_arkui_imageanimatorframeinfo_setwidth) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo, int32_t width) | Sets the image width. |
788| int32_t [OH_ArkUI_ImageAnimatorFrameInfo_GetWidth](#oh_arkui_imageanimatorframeinfo_getwidth) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo) | Obtains the image width. |
789| void [OH_ArkUI_ImageAnimatorFrameInfo_SetHeight](#oh_arkui_imageanimatorframeinfo_setheight) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo, int32_t height) | Sets the image height. |
790| int32_t [OH_ArkUI_ImageAnimatorFrameInfo_GetHeight](#oh_arkui_imageanimatorframeinfo_getheight) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo) | Obtains the image height. |
791| 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. |
792| 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. |
793| 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. |
794| 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. |
795| void [OH_ArkUI_ImageAnimatorFrameInfo_SetDuration](#oh_arkui_imageanimatorframeinfo_setduration) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo, int32_t duration) | Sets the playback duration of an image. |
796| int32_t [OH_ArkUI_ImageAnimatorFrameInfo_GetDuration](#oh_arkui_imageanimatorframeinfo_getduration) ([ArkUI_ImageAnimatorFrameInfo](#arkui_imageanimatorframeinfo) \*imageInfo) | Obtains the playback duration of an image. |
797| [ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) \* [OH_ArkUI_ListChildrenMainSizeOption_Create](#oh_arkui_listchildrenmainsizeoption_create) () | Creates a **ListChildrenMainSize** instance. |
798| void [OH_ArkUI_ListChildrenMainSizeOption_Dispose](#oh_arkui_listchildrenmainsizeoption_dispose) ([ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) \*option) | Disposes of a **ListChildrenMainSize** instance. |
799| 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. |
800| float [OH_ArkUI_ListChildrenMainSizeOption_GetDefaultMainSize](#oh_arkui_listchildrenmainsizeoption_getdefaultmainsize) ([ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) \*option) | Obtains the default size in a **ListChildrenMainSize** instance. |
801| 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. |
802| 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. |
803| 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. |
804| float [OH_ArkUI_ListChildrenMainSizeOption_GetMainSize](#oh_arkui_listchildrenmainsizeoption_getmainsize) ([ArkUI_ListChildrenMainSize](#arkui_listchildrenmainsize) \*option, int32_t index) | Obtains the values of a **ChildrenMainSizeOption** array. |
805| [ArkUI_CustomSpanMeasureInfo](#arkui_customspanmeasureinfo) \* [OH_ArkUI_CustomSpanMeasureInfo_Create](#oh_arkui_customspanmeasureinfo_create) (void) | Creates measurement information for this custom span. |
806| void [OH_ArkUI_CustomSpanMeasureInfo_Dispose](#oh_arkui_customspanmeasureinfo_dispose) ([ArkUI_CustomSpanMeasureInfo](#arkui_customspanmeasureinfo) \*info) | Disposes of measurement information of a custom span. |
807| 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. |
808| [ArkUI_CustomSpanMetrics](#arkui_customspanmetrics) \* [OH_ArkUI_CustomSpanMetrics_Create](#oh_arkui_customspanmetrics_create) (void) | Creates measurement metrics for this custom span. |
809| void [OH_ArkUI_CustomSpanMetrics_Dispose](#oh_arkui_customspanmetrics_dispose) ([ArkUI_CustomSpanMetrics](#arkui_customspanmetrics) \*metrics) | Disposes of measurement metrics of this custom span. |
810| int32_t [OH_ArkUI_CustomSpanMetrics_SetWidth](#oh_arkui_customspanmetrics_setwidth) ([ArkUI_CustomSpanMetrics](#arkui_customspanmetrics) \*metrics, float width) | Sets the width for a custom span. |
811| int32_t [OH_ArkUI_CustomSpanMetrics_SetHeight](#oh_arkui_customspanmetrics_setheight) ([ArkUI_CustomSpanMetrics](#arkui_customspanmetrics) \*metrics, float height) | Sets the height for a custom span. |
812| [ArkUI_CustomSpanDrawInfo](#arkui_customspandrawinfo) \* [OH_ArkUI_CustomSpanDrawInfo_Create](#oh_arkui_customspandrawinfo_create) (void) | Creates drawing information for this custom span. |
813| void [OH_ArkUI_CustomSpanDrawInfo_Dispose](#oh_arkui_customspandrawinfo_dispose) ([ArkUI_CustomSpanDrawInfo](#arkui_customspandrawinfo) \*info) | Disposes of drawing information for this custom span. |
814| 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. |
815| 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. |
816| 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. |
817| 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. |
818| void [OH_ArkUI_CustomProperty_Destroy](#oh_arkui_customproperty_destroy) (ArkUI_CustomProperty \*handle) | Destroys a **CustomProperty** instance. |
819| const char \* [OH_ArkUI_CustomProperty_GetStringValue](#oh_arkui_customproperty_getstringvalue) (ArkUI_CustomProperty \*handle) | Obtains the value of a custom property. |
820| void [OH_ArkUI_ActiveChildrenInfo_Destroy](#oh_arkui_activechildreninfo_destroy) (ArkUI_ActiveChildrenInfo \*handle) | Destroys an **ActiveChildrenInfo** instance. |
821| [ArkUI_NodeHandle](#arkui_nodehandle) [OH_ArkUI_ActiveChildrenInfo_GetNodeByIndex](#oh_arkui_activechildreninfo_getnodebyindex) (ArkUI_ActiveChildrenInfo \*handle, int32_t index) | Obtains the child node at the specified index in the specified **ActiveChildrenInfo** instance. |
822| int32_t [OH_ArkUI_ActiveChildrenInfo_GetCount](#oh_arkui_activechildreninfo_getcount) (ArkUI_ActiveChildrenInfo \*handle) | Obtains the number of nodes in the specified **ActiveChildrenInfo** instance. |
823| [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. |
824| 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. |
825| 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. |
826| void [OH_ArkUI_StyledString_AddText](#oh_arkui_styledstring_addtext) ([ArkUI_StyledString](#arkui_styledstring) \*handle, const char \*content) | Adds text for a styled string. |
827| 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. |
828| 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. |
829| void [OH_ArkUI_StyledString_AddPlaceholder](#oh_arkui_styledstring_addplaceholder) ([ArkUI_StyledString](#arkui_styledstring) \*handle, OH_Drawing_PlaceholderSpan \*placeholder) | Adds a placeholder. |
830| [ArkUI_StyledString_Descriptor](#arkui_styledstring_descriptor) \* [OH_ArkUI_StyledString_Descriptor_Create](#oh_arkui_styledstring_descriptor_create) (void) | Creates an **ArkUI_StyledString_Descriptor** object. |
831| 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. |
832| int32_t [OH_ArkUI_UnmarshallStyledStringDescriptor](#oh_arkui_unmarshallstyledstringdescriptor) (uint8_t \*buffer, size_t bufferSize, [ArkUI_StyledString_Descriptor](#arkui_styledstring_descriptor) \*descriptor, size_t \*resultSize) | Deserializes a byte array containing styled string information into a styled string. |
833| 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. |
834| const char \* [OH_ArkUI_ConvertToHtml](#oh_arkui_converttohtml) ([ArkUI_StyledString_Descriptor](#arkui_styledstring_descriptor) \*descriptor) | Converts styled string information into HTML. |
835| int32_t [OH_ArkUI_PostFrameCallback](#oh_arkui_postframecallback)([ArkUI_ContextHandle](#arkui_contexthandle-12) uiContext, void\* userData, void (\*callback)(uint64_t nanoTimestamp, uint32_t frameCount, void\* userData))| Registers a callback to be executed after the next frame is rendered. This callback must not be called from a non-UI thread. The application will abort if a non-UI thread call is detected.|
836| int32_t [OH_ArkUI_RegisterLayoutCallbackOnNodeHandle](#oh_arkui_registerlayoutcallbackonnodehandle)([ArkUI_NodeHandle](#arkui_nodehandle) node, void\* userData, void (\*onLayoutCompleted)(void\* userData))| Registers a layout completion callback function for a specific component. Only one layout completion callback can be registered per component. |
837| int32_t [OH_ArkUI_RegisterDrawCallbackOnNodeHandle](#oh_arkui_registerdrawcallbackonnodehandle)([ArkUI_NodeHandle](#arkui_nodehandle) node, void\* userData, void (\*onDrawCompleted)(void\* userData))| Registers a drawing completion callback function for a specific component. Only one drawing completion callback can be registered per component. |
838| int32_t [OH_ArkUI_UnregisterLayoutCallbackOnNodeHandle](#oh_arkui_unregisterlayoutcallbackonnodehandle)([ArkUI_NodeHandle](#arkui_nodehandle) node)| Unregisters the layout completion callback function for a specific component. |
839| int32_t [OH_ArkUI_UnregisterDrawCallbackOnNodeHandle](#oh_arkui_unregisterdrawcallbackonnodehandle)([ArkUI_NodeHandle](#arkui_nodehandle) node)| Unregisters the drawing completion callback function for a specific component. |
840| [ArkUI_TextChangeEvent](_ark_u_i___text_change_event.md) [OH_ArkUI_NodeEvent_GetTextChangeEvent](#oh_arkui_nodeevent_gettextchangeevent)([ArkUI_NodeEvent](#arkui_nodeevent-12) \*event) | Obtains the data related to a text change (including preview text content change) event in the text box. |
841|[ArkUI_ErrorCode](_ark_u_i___native_module.md#arkui_errorcode)  OH_ArkUI_FocusRequest([ArkUI_NodeHandle](_ark_u_i___native_module.md#arkui_nodehandle) node); | Requests focus for a specific node.|
842| void OH_ArkUI_FocusClear([ArkUI_ContextHandle](_ark_u_i___native_module.md#arkui_contexthandle-12) uiContext); | Clears the focus to the root container node.|
843| void OH_ArkUI_FocusActivate([ArkUI_ContextHandle](_ark_u_i___native_module.md#arkui_contexthandle-12) uiContext, bool isActive, bool isAutoInactive); | Sets the focus activation state for the current page. When activated, the focused node displays a focus box.|
844| void OH_ArkUI_FocusSetAutoTransfer([ArkUI_ContextHandle](_ark_u_i___native_module.md#arkui_contexthandle-12) uiContext, bool autoTransfer); | Configures the focus transfer behavior when pages are switched.|
845| void OH_ArkUI_FocusSetKeyProcessingMode([ArkUI_ContextHandle](_ark_u_i___native_module.md#arkui_contexthandle-12) uiContext, ArkUI_KeyProcessingMode mode); | Sets the mode for processing key events.|
846| void [OH_ArkUI_DragEvent_StartDataLoading](#oh_arkui_dragevent_startdataloading)([ArkUI_DragEvent](_ark_u_i___native_module.md#arkui_dragevent)\* event, [OH_UdmfGetDataParams](#oh_udmfgetdataparams)\* options, char\* key, unsigned int keyLen); | Sets whether to enable data prefetching for drag and drop operations on a specified node.|
847| void OH_ArkUI_[CancelDataLoading](#oh_arkui_canceldataloading)([ArkUI_Context](_ark_u_i___native_module.md#arkui_context) uiContext, const char\* key); | Cancels the asynchronous obtaining of drag data.|
848| void OH_ArkUI_[DisableDropDataPrefetchOnNode](#oh_arkui_disabledropdataprefetchonnode)([ArkUI_NodeHandle](_ark_u_i___native_module.md#arkui_nodehandle) node, bool disable); | Sets whether to enable data prefetching for drag and drop operations on a specified node. The value **true** means to disable data prefetching, and **false** means to enable data prefetching. The default value is **false**.|
849| [ArkUI_ProgressLinearStyleOption](#arkui_progresslinearstyleoption)\* [OH_ArkUI_ProgressLinearStyleOption_Create](#oh_arkui_progresslinearstyleoption_create)(void) | Creates a **ProgressLinearStyleOption** instance.|
850| void [OH_ArkUI_ProgressLinearStyleOption_Destroy](#oh_arkui_progresslinearstyleoption_destroy)([ArkUI_ProgressLinearStyleOption](#arkui_progresslinearstyleoption)* option) | Destroys a **ProgressLinearStyleOption** instance.|
851| void [OH_ArkUI_ProgressLinearStyleOption_SetScanEffectEnabled](#oh_arkui_progresslinearstyleoption_setscaneffectenabled)([ArkUI_ProgressLinearStyleOption](#arkui_progresslinearstyleoption)\* option, bool enabled) | Sets whether to enable the smooth progress effect for the linear progress indicator.|
852| void [OH_ArkUI_ProgressLinearStyleOption_SetSmoothEffectEnabled](#oh_arkui_progresslinearstyleoption_setsmootheffectenabled)([ArkUI_ProgressLinearStyleOption](#arkui_progresslinearstyleoption)\* option, bool enabled) | Sets whether to enable the scan effect for the linear progress indicator.|
853| void [OH_ArkUI_ProgressLinearStyleOption_SetStrokeWidth](#oh_arkui_progresslinearstyleoption_setstrokewidth)([ArkUI_ProgressLinearStyleOption](#arkui_progresslinearstyleoption)\* option, float strokeWidth) | Sets the stroke width of the linear progress indicator.|
854| void [OH_ArkUI_ProgressLinearStyleOption_SetStrokeRadius](#oh_arkui_progresslinearstyleoption_setstrokeradius)([ArkUI_ProgressLinearStyleOption](#arkui_progresslinearstyleoption)\* option, float strokeRadius) | Sets the corner radius of the linear progress indicator.|
855| bool [OH_ArkUI_ProgressLinearStyleOption_GetScanEffectEnabled](#oh_arkui_progresslinearstyleoption_getscaneffectenabled)([ArkUI_ProgressLinearStyleOption](#arkui_progresslinearstyleoption)\* option) | Obtains the enabled status of the smooth progress effect for the linear progress indicator.|
856| bool [OH_ArkUI_ProgressLinearStyleOption_GetSmoothEffectEnabled](#oh_arkui_progresslinearstyleoption_getsmootheffectenabled)([ArkUI_ProgressLinearStyleOption](#arkui_progresslinearstyleoption)\* option) | Obtains the enabled status of the scan effect for the linear progress indicator.|
857| float [OH_ArkUI_ProgressLinearStyleOption_GetStrokeWidth](#oh_arkui_progresslinearstyleoption_getstrokewidth)([ArkUI_ProgressLinearStyleOption](#arkui_progresslinearstyleoption)\* option) | Obtains the stroke width of the linear progress indicator.|
858| float [OH_ArkUI_ProgressLinearStyleOption_GetStrokeRadius](#oh_arkui_progresslinearstyleoption_getstrokeradius)([ArkUI_ProgressLinearStyleOption](#arkui_progresslinearstyleoption)\* option) | Obtains the corner radius of the linear progress indicator.|
859| int32_t [OH_ArkUI_NodeUtils_GetPositionToParent](#oh_arkui_nodeutils_getpositiontoparent) ([ArkUI_NodeHandle](#arkui_nodehandle) node, [ArkUI_IntOffset](_ark_u_i___int_offset.md)\* globalOffset) | Obtains the offset of a specific node relative to its parent node. |
860| int32_t [OH_ArkUI_GetGestureParam_DirectMask](#oh_arkui_getgestureparam_directmask) (ArkUI_GestureRecognizer \*recognizer, [ArkUI_GestureDirectionMask](#arkui_gesturedirectionmask)\* directMask) | Obtains the swipe direction of a gesture recognizer.|
861| int32_t [OH_ArkUI_GetGestureParam_FingerCount](#oh_arkui_getgestureparam_fingercount) (ArkUI_GestureRecognizer \*recognizer, int\* finger) | Obtains the number of fingers used by a gesture recognizer.|
862| int32_t [OH_ArkUI_GetGestureParam_limitFingerCount](#oh_arkui_getgestureparam_limitfingercount) (ArkUI_GestureRecognizer \*recognizer, bool\* isLimited) | Checks whether a gesture recognizer has a finger count limit. |
863| int32_t [OH_ArkUI_GetGestureParam_repeat](#oh_arkui_getgestureparam_repeat) (ArkUI_GestureRecognizer \*recognizer, bool\* isRepeat) | Checks whether a gesture recognizer supports repeated event callbacks.|
864| int32_t [OH_ArkUI_GetGestureParam_distance](#oh_arkui_getgestureparam_distance) (ArkUI_GestureRecognizer \*recognizer, double\* distance) | Obtains the allowed movement distance range for a gesture recognizer.|
865| int32_t [OH_ArkUI_GetGestureParam_speed](#oh_arkui_getgestureparam_speed) (ArkUI_GestureRecognizer \*recognizer, double\* speed) | Obtains the minimum swipe speed recognized by a gesture recognizer.|
866| int32_t [OH_ArkUI_GetGestureParam_duration](#oh_arkui_getgestureparam_duration) (ArkUI_GestureRecognizer \*recognizer, int\* duration) | Obtains the minimum duration required to trigger a long press by a gesture recognizer.|
867| int32_t [OH_ArkUI_GetGestureParam_angle](#oh_arkui_getgestureparam_angle) (ArkUI_GestureRecognizer \*recognizer, double\* angle) | Obtains the minimum angle change required for a rotation gesture to be recognized by a gesture recognizer.|
868| int32_t [OH_ArkUI_GetGestureParam_distanceThreshold](#oh_arkui_getgestureparam_distancethreshold) (ArkUI_GestureRecognizer \*recognizer, double\* distanceThreshold) | Obtains the movement threshold for gestures to be recognized by a gesture recognizer.|
869
870
871## Macro Description
872
873
874### OH_ArkUI_GetModuleInterface
875
876```
877#define OH_ArkUI_GetModuleInterface( nativeAPIVariantKind,  structType,  structPtr )
878```
879**Value:**
880```
881 do { \
882 void* anyNativeAPI = OH_ArkUI_QueryModuleInterfaceByName(nativeAPIVariantKind, #structType); \
883 if (anyNativeAPI) { \
884 structPtr = (structType*)(anyNativeAPI); \
885 } \
886 } while (0)
887#include<arkui/native_interface.h>
888#include<arkui/native_node.h>
889
890ArkUI_NativeNodeAPI_1* nativeNodeApi = nullptr;
891OH_ArkUI_GetModuleInterface(ARKUI_NATIVE_NODE, ArkUI_NativeNodeAPI_1, nativeNodeApi);
892```
893**Description**
894
895Obtains the macro function corresponding to a struct pointer based on the struct type.
896
897**Since**: 12
898
899
900## Type Description
901
902
903### ArkUI_AccessibilityState
904
905```
906typedef struct ArkUI_AccessibilityState ArkUI_AccessibilityState
907```
908**Description**
909
910Defines a struct for the component accessibility state.
911
912**Since**: 12
913
914
915### ArkUI_AccessibilityValue
916
917```
918typedef struct ArkUI_AccessibilityValue ArkUI_AccessibilityValue
919```
920**Description**
921
922Defines a struct for the component accessibility value.
923
924**Since**: 12
925
926
927### ArkUI_AlignmentRuleOption
928
929```
930typedef struct ArkUI_AlignmentRuleOption ArkUI_AlignmentRuleOption
931```
932**Description**
933
934Defines the alignment rule in the relative container.
935
936**Since**: 12
937
938
939### ArkUI_AnimateOption
940
941```
942typedef struct ArkUI_AnimateOption ArkUI_AnimateOption
943```
944**Description**
945
946Defines a struct for the animation configuration.
947
948**Since**: 12
949
950
951### ArkUI_AnimatorHandle
952
953```
954typedef struct ArkUI_Animator* ArkUI_AnimatorHandle
955```
956**Description**
957
958Defines a struct for the pointer to an animator object.
959
960**Since**: 12
961
962
963### ArkUI_AnimatorOption
964
965```
966typedef struct ArkUI_AnimatorOption ArkUI_AnimatorOption
967```
968**Description**
969
970Defines the animator parameter object.
971
972**Since**: 12
973
974
975### ArkUI_BarrierOption
976
977```
978typedef struct ArkUI_BarrierOption ArkUI_BarrierOption
979```
980**Description**
981
982Defines the ID, direction, and referenced component of a barrier.
983
984**Since**: 12
985
986
987### ArkUI_Context
988
989```
990typedef struct ArkUI_Context ArkUI_Context
991```
992**Description**
993
994Defines a struct for a UI context object.
995
996**Since**: 12
997
998
999### ArkUI_ContextHandle [1/2]
1000
1001```
1002typedef struct ArkUI_Context* ArkUI_ContextHandle
1003```
1004**Description**
1005
1006Defines a struct for the handle to the ArkUI native UI context.
1007
1008**Since**: 12
1009
1010
1011### ArkUI_ContextHandle [2/2]
1012
1013```
1014typedef struct ArkUI_Context* ArkUI_ContextHandle
1015```
1016**Description**
1017
1018Defines the handle to the ArkUI native UI context.
1019
1020**Since**: 12
1021
1022
1023### ArkUI_CurveHandle
1024
1025```
1026typedef struct ArkUI_Curve* ArkUI_CurveHandle
1027```
1028**Description**
1029
1030Defines a struct for the pointer to an interpolation curve.
1031
1032**Since**: 12
1033
1034
1035### ArkUI_CustomSpanDrawInfo
1036
1037```
1038typedef struct ArkUI_CustomSpanDrawInfo ArkUI_CustomSpanDrawInfo
1039```
1040**Description**
1041
1042Defines a struct for the drawing information of a custom span.
1043
1044**Since**: 12
1045
1046
1047### ArkUI_CustomSpanMeasureInfo
1048
1049```
1050typedef struct ArkUI_CustomSpanMeasureInfo ArkUI_CustomSpanMeasureInfo
1051```
1052**Description**
1053
1054Defines a struct for the measurement information of a custom span.
1055
1056**Since**: 12
1057
1058
1059### ArkUI_CustomSpanMetrics
1060
1061```
1062typedef struct ArkUI_CustomSpanMetrics ArkUI_CustomSpanMetrics
1063```
1064**Description**
1065
1066Defines a struct for the measurement metrics of a custom span.
1067
1068**Since**: 12
1069
1070
1071### ArkUI_DialogDismissEvent
1072
1073```
1074typedef struct ArkUI_DialogDismissEvent ArkUI_DialogDismissEvent
1075```
1076**Description**
1077
1078Defines a struct for a dialog box dismiss event.
1079
1080**Since**: 12
1081
1082### ArkUI_CustomDialogOptions
1083
1084```
1085typedef struct ArkUI_CustomDialogOptions ArkUI_CustomDialogOptions
1086```
1087**Description**
1088
1089Defines a struct for custom dialog box options.
1090
1091**Since**: 16
1092
1093
1094### ArkUI_DragAction
1095
1096```
1097typedef struct ArkUI_DragAction ArkUI_DragAction
1098```
1099**Description**
1100
1101Defines a struct for a drag action.
1102
1103**Since**: 12
1104
1105
1106### ArkUI_DragAndDropInfo
1107
1108```
1109typedef struct ArkUI_DragAndDropInfo ArkUI_DragAndDropInfo
1110```
1111**Description**
1112
1113Defines a struct for drag and drop information returned through a drag status listener.
1114
1115**Since**: 12
1116
1117### ArkUI_DragEvent
1118
1119```
1120typedef struct ArkUI_DragEvent ArkUI_DragEvent
1121```
1122**Description**
1123
1124Defines a struct for a drag event.
1125
1126**Since**: 12
1127
1128
1129### ArkUI_DragPreviewOption
1130
1131```
1132typedef struct ArkUI_DragPreviewOption ArkUI_DragPreviewOption
1133```
1134**Description**
1135
1136Defines a struct for custom drag preview options.
1137
1138**Since**: 12
1139
1140
1141### ArkUI_DrawableDescriptor
1142
1143```
1144typedef struct ArkUI_DrawableDescriptor ArkUI_DrawableDescriptor
1145```
1146**Description**
1147
1148Defines a struct for the **DrawableDescriptor** object.
1149
1150**Since**: 12
1151
1152
1153### ArkUI_DrawContext
1154
1155```
1156typedef struct ArkUI_DrawContext ArkUI_DrawContext
1157```
1158**Description**
1159
1160Defines the component drawing context.
1161
1162**Since**: 12
1163
1164
1165### ArkUI_GestureDirectionMask
1166
1167```
1168typedef uint32_t ArkUI_GestureDirectionMask
1169```
1170**Description**
1171
1172Defines a set of gesture directions.
1173
1174**Since**: 12
1175
1176
1177### ArkUI_GestureEventActionTypeMask
1178
1179```
1180typedef uint32_t ArkUI_GestureEventActionTypeMask
1181```
1182**Description**
1183
1184Defines a set of gesture event types.
1185
1186Example: **ArkUI_GestureEventActionTypeMask actions = GESTURE_EVENT_ACTION_ACCEPT | GESTURE_EVENT_ACTION_UPDATE**
1187
1188**Since**: 12
1189
1190
1191### ArkUI_GestureEventTargetInfo
1192
1193```
1194typedef struct ArkUI_GestureEventTargetInfo ArkUI_GestureEventTargetInfo
1195```
1196**Description**
1197
1198Defines a struct for a **GestureEventTargetInfo** object that provides information about a gesture event target.
1199
1200**Since**: 12
1201
1202
1203### ArkUI_GestureRecognizerDestructNotifyCallback
1204
1205```
1206typedef void(* ArkUI_GestureRecognizerDestructNotifyCallback) (ArkUI_GestureRecognizer *recognizer, void *userData)
1207```
1208**Description**
1209
1210Defines a callback function for notifying gesture recognizer destruction.
1211
1212**Since**: 12
1213
1214
1215### ArkUI_GestureRecognizerHandle
1216
1217```
1218typedef ArkUI_GestureRecognizer* ArkUI_GestureRecognizerHandle
1219```
1220**Description**
1221
1222Defines the gesture recognizer handle.
1223
1224**Since**: 12
1225
1226
1227### ArkUI_GestureRecognizerHandleArray
1228
1229```
1230typedef ArkUI_GestureRecognizerHandle* ArkUI_GestureRecognizerHandleArray
1231```
1232**Description**
1233
1234Defines the gesture recognizer handle array.
1235
1236**Since**: 12
1237
1238
1239### ArkUI_TouchRecognizerHandle
1240
1241```
1242typedef ArkUI_TouchRecognizer* ArkUI_TouchRecognizerHandle
1243```
1244**Description**
1245
1246Defines the gesture recognizer handle.
1247
1248**Since**: 15
1249
1250
1251### ArkUI_TouchRecognizerHandleArray
1252
1253```
1254typedef ArkUI_TouchRecognizerHandle* ArkUI_TouchRecognizerHandleArray
1255```
1256**Description**
1257
1258Defines an array of gesture recognizer handles.
1259
1260**Since**: 15
1261
1262### ArkUI_GuidelineOption
1263
1264```
1265typedef struct ArkUI_GuidelineOption ArkUI_GuidelineOption
1266```
1267**Description**
1268
1269Defines the ID, direction, and position of a guideline.
1270
1271**Since**: 12
1272
1273
1274### ArkUI_ImageAnimatorFrameInfo
1275
1276```
1277typedef struct ArkUI_ImageAnimatorFrameInfo ArkUI_ImageAnimatorFrameInfo
1278```
1279**Description**
1280
1281Defines the image frame information.
1282
1283**Since**: 12
1284
1285
1286### ArkUI_KeyframeAnimateOption
1287
1288```
1289typedef struct ArkUI_KeyframeAnimateOption ArkUI_KeyframeAnimateOption
1290```
1291**Description**
1292
1293Defines a struct for the keyframe animation parameter object.
1294
1295**Since**: 12
1296
1297
1298### ArkUI_LayoutConstraint
1299
1300```
1301typedef struct ArkUI_LayoutConstraint ArkUI_LayoutConstraint
1302```
1303**Description**
1304
1305Defines the size constraints of a component during component layout.
1306
1307**Since**: 12
1308
1309
1310### ArkUI_ListChildrenMainSize
1311
1312```
1313typedef struct ArkUI_ListChildrenMainSize ArkUI_ListChildrenMainSize
1314```
1315**Description**
1316
1317Defines the **ChildrenMainSize** information of the **List** component.
1318
1319**Since**: 12
1320
1321
1322### ArkUI_ListItemSwipeActionItem
1323
1324```
1325typedef struct ArkUI_ListItemSwipeActionItem ArkUI_ListItemSwipeActionItem
1326```
1327**Description**
1328
1329Defines the item configuration for **ListItemSwipeActionOption**.
1330
1331**Since**: 12
1332
1333
1334### ArkUI_ListItemSwipeActionOption
1335
1336```
1337typedef struct ArkUI_ListItemSwipeActionOption ArkUI_ListItemSwipeActionOption
1338```
1339**Description**
1340
1341Defines the configuration for **ListItemSwipeActionOption**.
1342
1343**Since**: 12
1344
1345
1346### ArkUI_NativeDialogHandle
1347
1348```
1349typedef struct ArkUI_NativeDialog* ArkUI_NativeDialogHandle
1350```
1351**Description**
1352
1353Defines the handle to the custom dialog box controller of ArkUI on the native side.
1354
1355**Since**: 12
1356
1357
1358### ArkUI_NodeAdapterEvent
1359
1360```
1361typedef struct ArkUI_NodeAdapterEvent ArkUI_NodeAdapterEvent
1362```
1363**Description**
1364
1365Defines the component adapter event.
1366
1367**Since**: 12
1368
1369
1370### ArkUI_NodeAdapterHandle
1371
1372```
1373typedef struct ArkUI_NodeAdapter* ArkUI_NodeAdapterHandle
1374```
1375**Description**
1376
1377Defines the component adapter, which is used for lazy loading of elements of scrollable components.
1378
1379**Since**: 12
1380
1381
1382### ArkUI_NodeContentCallback
1383
1384```
1385typedef void(* ArkUI_NodeContentCallback) (ArkUI_NodeContentEvent *event)
1386```
1387**Description**
1388
1389Defines the callback for the NodeContent event.
1390
1391**Since**: 12
1392
1393
1394### ArkUI_NodeContentEvent
1395
1396```
1397typedef struct ArkUI_NodeContentEvent ArkUI_NodeContentEvent
1398```
1399**Description**
1400
1401Defines the common structure type of a NodeContent event.
1402
1403**Since**: 12
1404
1405
1406### ArkUI_NodeContentHandle
1407
1408```
1409typedef struct ArkUI_NodeContent* ArkUI_NodeContentHandle
1410```
1411**Description**
1412
1413Defines the handle to the ArkUI NodeContent instance on the native side.
1414
1415**Since**: 12
1416
1417
1418### ArkUI_NodeCustomEvent
1419
1420```
1421typedef struct ArkUI_NodeCustomEvent ArkUI_NodeCustomEvent
1422```
1423**Description**
1424
1425Defines the common structure of a custom component event.
1426
1427**Since**: 12
1428
1429
1430### ArkUI_NodeEvent [1/2]
1431
1432```
1433typedef struct ArkUI_NodeEvent ArkUI_NodeEvent
1434```
1435**Description**
1436
1437Defines a struct for a component event.
1438
1439**Since**: 12
1440
1441
1442### ArkUI_NodeEvent [2/2]
1443
1444```
1445typedef struct ArkUI_NodeEventArkUI_NodeEvent
1446```
1447**Description**
1448
1449Defines the common structure of a component event.
1450
1451**Since**: 12
1452
1453
1454### ArkUI_NodeHandle
1455
1456```
1457typedef struct ArkUI_Node* ArkUI_NodeHandle
1458```
1459**Description**
1460
1461Defines the pointer to the ArkUI native component object.
1462
1463**Since**: 12
1464
1465
1466### ArkUI_OnWillDismissEvent
1467
1468```
1469typedef bool(* ArkUI_OnWillDismissEvent) (int32_t reason)
1470```
1471**Description**
1472
1473Defines a pointer to the callback invoked when the dialog box is closed.
1474
1475**Since**: 12
1476
1477
1478### ArkUI_ParallelInnerGestureEvent
1479
1480```
1481typedef struct ArkUI_ParallelInnerGestureEvent ArkUI_ParallelInnerGestureEvent
1482```
1483**Description**
1484
1485Defines a parallel internal gesture event.
1486
1487**Since**: 12
1488
1489
1490### ArkUI_GestureInterruptInfo
1491
1492```
1493typedef struct ArkUI_GestureInterruptInfo ArkUI_GestureInterruptInfo
1494```
1495
1496**Description**
1497
1498Defines the gesture interruption information.
1499
1500**Since**: 12
1501
1502
1503### ArkUI_StyledString
1504
1505```
1506typedef struct ArkUI_StyledString ArkUI_StyledString
1507```
1508**Description**
1509
1510Defines a struct for the styled string object supported by the text component.
1511
1512**Since**: 12
1513
1514
1515### ArkUI_StyledString_Descriptor
1516
1517```
1518typedef struct ArkUI_StyledString_Descriptor ArkUI_StyledString_Descriptor
1519```
1520**Description**
1521
1522Defines a struct for the styled string descriptor object supported by the text component.
1523
1524**Since**: 14
1525
1526
1527### ArkUI_SwiperIndicator
1528
1529```
1530typedef struct ArkUI_SwiperIndicator ArkUI_SwiperIndicator
1531```
1532**Description**
1533
1534Defines the navigation indicator style of the **Swiper** component.
1535
1536**Since**: 12
1537
1538
1539### ArkUI_SystemFontStyleEvent
1540
1541```
1542typedef struct ArkUI_SystemFontStyleEvent ArkUI_SystemFontStyleEvent
1543```
1544**Description**
1545
1546Defines a struct for the system font style event.
1547
1548**Since**: 12
1549
1550### ArkUI_SwiperDigitIndicator
1551
1552```
1553typedef struct ArkUI_SwiperDigitIndicator ArkUI_SwiperDigitIndicator
1554```
1555**Description**
1556
1557Defines the digit-style navigation indicator of the **Swiper** component.
1558
1559**Since**: 18
1560
1561### ArkUI_SwiperArrowStyle
1562
1563```
1564typedef struct ArkUI_SwiperArrowStyle ArkUI_SwiperArrowStyle
1565```
1566**Description**
1567
1568Defines the arrow style for the **Swiper** component.
1569
1570**Since**: 18
1571
1572### ArkUI_TransitionEffect
1573
1574```
1575typedef struct ArkUI_TransitionEffect ArkUI_TransitionEffect
1576```
1577**Description**
1578
1579Defines a struct for the transition effect.
1580
1581**Since**: 12
1582
1583
1584### ArkUI_WaterFlowSectionOption
1585
1586```
1587typedef struct ArkUI_WaterFlowSectionOption ArkUI_WaterFlowSectionOption
1588```
1589**Description**
1590
1591Defines the water flow section configuration.
1592
1593**Since**: 12
1594
1595
1596### OH_PixelmapNative
1597
1598```
1599typedef struct OH_PixelmapNative OH_PixelmapNative
1600```
1601**Description**
1602
1603Defines the **Pixelmap** struct, which is used to perform operations related to a pixel map.
1604
1605**Since**: 12
1606
1607
1608### OH_PixelmapNativeHandle
1609
1610```
1611typedef struct OH_PixelmapNative* OH_PixelmapNativeHandle
1612```
1613**Description**
1614
1615Defines a struct for the pointer to an **OH_PixelmapNative** object.
1616
1617**Since**: 12
1618
1619
1620### OH_UdmfData
1621
1622```
1623typedef struct OH_UdmfData OH_UdmfData
1624```
1625**Description**
1626
1627Defines a struct for UDMF unified data.
1628
1629**Since**: 12
1630
1631
1632### ArkUI_ProgressLinearStyleOption
1633
1634```
1635typedef struct ArkUI_ProgressLinearStyleOption ArkUI_ProgressLinearStyleOption
1636```
1637**Description**
1638
1639Defines the style information for a linear progress indicator in the **Progress** component.
1640
1641**Since**: 15
1642
1643### OH_HostWindowInfo
1644
1645```
1646typedef struct ArkUI_HostWindowInfo ArkUI_HostWindowInfo
1647```
1648**Description**
1649
1650Defines a struct for the host window information.
1651
1652**Since**: 15
1653
1654
1655### OH_UdmfGetDataParams
1656
1657```
1658typedef struct OH_UdmfGetDataParams OH_UdmfGetDataParams
1659```
1660**Description**
1661
1662Defines the parameters used for obtaining data from UDMF.
1663
1664**Since**: 15
1665
1666### ArkUI_VisibleAreaEventOptions
1667
1668```
1669typedef struct ArkUI_VisibleAreaEventOptions ArkUI_VisibleAreaEventOptions
1670```
1671**Description**
1672
1673Defines the parameters for visible area change events.
1674
1675**Since**: 18
1676
1677
1678### ArkUI_TextPickerRangeContentArray
1679```
1680typedef struct ArkUI_TextPickerRangeContentArray ArkUI_TextPickerRangeContentArray
1681```
1682**Description**
1683
1684Defines the data selection list for the text picker.
1685
1686**Since**: 18
1687
1688### ArkUI_TextCascadePickerRangeContentArray
1689
1690```
1691typedef struct ArkUI_TextCascadePickerRangeContentArray ArkUI_TextCascadePickerRangeContentArray
1692```
1693**Description**
1694
1695Defines the content array for a multi-column cascading data picker.
1696
1697**Since**: 18
1698
1699## Enum Description
1700
1701
1702### ArkUI_AccessibilityActionType
1703
1704```
1705enum ArkUI_AccessibilityActionType
1706```
1707**Description**
1708
1709Defines an enum for the accessibility action types.
1710
1711**Since**: 12
1712
1713| Enum| Description|
1714| -------- | -------- |
1715| ARKUI_ACCESSIBILITY_ACTION_CLICK  | Tapping |
1716| ARKUI_ACCESSIBILITY_ACTION_LONG_CLICK  | Long press |
1717| ARKUI_ACCESSIBILITY_ACTION_CUT  | Cut. |
1718| ARKUI_ACCESSIBILITY_ACTION_COPY  |   |
1719| ARKUI_ACCESSIBILITY_ACTION_PASTE  | Paste. |
1720
1721
1722### ArkUI_AccessibilityCheckedState
1723
1724```
1725enum ArkUI_AccessibilityCheckedState
1726```
1727**Description**
1728
1729Enumerates the accessibility check box states.
1730
1731**Since**: 12
1732
1733| Enum| Description|
1734| -------- | -------- |
1735| ARKUI_ACCESSIBILITY_UNCHECKED  | The check box is not selected. |
1736| ARKUI_ACCESSIBILITY_CHECKED  | The check box is selected. |
1737
1738
1739### ArkUI_AccessibilityMode
1740
1741```
1742enum ArkUI_AccessibilityMode
1743```
1744**Description**
1745
1746Enumerates the accessibility modes.
1747
1748**Since**: 12
1749
1750| Enum| Description|
1751| -------- | -------- |
1752| ARKUI_ACCESSIBILITY_MODE_AUTO  | The mode is automatically set to enabled or disabled based on the component. |
1753| ARKUI_ACCESSIBILITY_MODE_ENABLED  | The component can be identified by the accessibility service. |
1754| ARKUI_ACCESSIBILITY_MODE_DISABLED  | The component cannot be identified by the accessibility service. |
1755| ARKUI_ACCESSIBILITY_MODE_DISABLED_FOR_DESCENDANTS  | The component and all its child components cannot be identified by the accessibility service. |
1756
1757
1758### ArkUI_AdaptiveColor
1759
1760```
1761enum ArkUI_AdaptiveColor
1762```
1763**Description**
1764
1765Enumerates the adaptive color modes.
1766
1767**Since**: 12
1768
1769| Enum| Description|
1770| -------- | -------- |
1771| ARKUI_ADAPTIVE_COLOR_DEFAULT  | Adaptive color mode is not used. |
1772| ARKUI_ADAPTIVE_COLOR_AVERAGE  | Adaptive color mode is used. |
1773
1774
1775### ArkUI_Alignment
1776
1777```
1778enum ArkUI_Alignment
1779```
1780**Description**
1781
1782Enumerates the alignment modes.
1783
1784**Since**: 12
1785
1786| Enum| Description|
1787| -------- | -------- |
1788| ARKUI_ALIGNMENT_TOP_START  | Top start. |
1789| ARKUI_ALIGNMENT_TOP  | Top center. |
1790| ARKUI_ALIGNMENT_TOP_END  | Top end. |
1791| ARKUI_ALIGNMENT_START  | Vertically centered start. |
1792| ARKUI_ALIGNMENT_CENTER  | Horizontally and vertically centered. |
1793| ARKUI_ALIGNMENT_END  | Vertically centered end. |
1794| ARKUI_ALIGNMENT_BOTTOM_START  | Bottom start. |
1795| ARKUI_ALIGNMENT_BOTTOM  | Horizontally centered on the bottom. |
1796| ARKUI_ALIGNMENT_BOTTOM_END  | Bottom end. |
1797
1798
1799### ArkUI_AnimationCurve
1800
1801```
1802enum ArkUI_AnimationCurve
1803```
1804**Description**
1805
1806Enumerates the animation curves.
1807
1808**Since**: 12
1809
1810| Enum| Description|
1811| -------- | -------- |
1812| ARKUI_CURVE_LINEAR  | The animation speed keeps unchanged. |
1813| ARKUI_CURVE_EASE  | The animation starts slowly, accelerates, and then slows down towards the end. |
1814| ARKUI_CURVE_EASE_IN  | The animation starts at a low speed and then picks up speed until the end. |
1815| ARKUI_CURVE_EASE_OUT  | The animation ends at a low speed. |
1816| ARKUI_CURVE_EASE_IN_OUT  | The animation starts and ends at a low speed. |
1817| ARKUI_CURVE_FAST_OUT_SLOW_IN  | The animation uses the standard curve |
1818| ARKUI_CURVE_LINEAR_OUT_SLOW_IN  | The animation uses the deceleration curve. |
1819| ARKUI_CURVE_FAST_OUT_LINEAR_IN  | The animation uses the acceleration curve. |
1820| ARKUI_CURVE_EXTREME_DECELERATION  | The animation uses the extreme deceleration curve. |
1821| ARKUI_CURVE_SHARP  | The animation uses the sharp curve. |
1822| ARKUI_CURVE_RHYTHM  | The animation uses the rhythm curve. |
1823| ARKUI_CURVE_SMOOTH  | The animation uses the smooth curve. |
1824| ARKUI_CURVE_FRICTION  | The animation uses the friction curve |
1825
1826
1827### ArkUI_AnimationDirection
1828
1829```
1830enum ArkUI_AnimationDirection
1831```
1832**Description**
1833
1834Enumerates the animation playback modes.
1835
1836**Since**: 12
1837
1838| Enum| Description|
1839| -------- | -------- |
1840| ARKUI_ANIMATION_DIRECTION_NORMAL  | The animation plays in forward loop mode. |
1841| ARKUI_ANIMATION_DIRECTION_REVERSE  | The animation plays in reverse loop mode. |
1842| 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. |
1843| 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. |
1844
1845
1846### ArkUI_AnimationFill
1847
1848```
1849enum ArkUI_AnimationFill
1850```
1851**Description**
1852
1853Enumerates the state of the animated target after the animation is executed.
1854
1855**Since**: 12
1856
1857| Enum| Description|
1858| -------- | -------- |
1859| ARKUI_ANIMATION_FILL_NONE  | No style is applied to the target before or after the animation is executed. |
1860| 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. |
1861| ARKUI_ANIMATION_FILL_BACKWARDS  | The animation uses the value defined in the first key frame during the duration defined by **animation-delay**. |
1862| ARKUI_ANIMATION_FILL_BOTH  | The animation follows the **forwards** and **backwards** rules. |
1863
1864
1865### ArkUI_AnimationFillMode
1866
1867```
1868enum ArkUI_AnimationFillMode
1869```
1870**Description**
1871
1872Enumerates the states before and after execution of the frame-by-frame animation.
1873
1874**Since**: 12
1875
1876| Enum| Description|
1877| -------- | -------- |
1878| 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. |
1879| ARKUI_ANIMATION_FILL_MODE_FORWARDS  | The target component retains the state set by the last keyframe encountered during execution of the animation. |
1880| 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**. |
1881| ARKUI_ANIMATION_FILL_MODE_BOTH  | The animation follows the rules for both **Forwards** and **Backwards**, extending the animation attributes in both directions. |
1882
1883
1884### ArkUI_AnimationPlayMode
1885
1886```
1887enum ArkUI_AnimationPlayMode
1888```
1889**Description**
1890
1891Enumerates the animation playback modes.
1892
1893**Since**: 12
1894
1895| Enum| Description|
1896| -------- | -------- |
1897| ARKUI_ANIMATION_PLAY_MODE_NORMAL  | The animation is played forwards. |
1898| ARKUI_ANIMATION_PLAY_MODE_REVERSE  | The animation is played backwards. |
1899| 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...). |
1900| 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...). |
1901
1902
1903### ArkUI_AnimationStatus
1904
1905```
1906enum ArkUI_AnimationStatus
1907```
1908**Description**
1909
1910Enumerates the playback states of the frame-by-frame animation.
1911
1912**Since**: 12
1913
1914| Enum| Description|
1915| -------- | -------- |
1916| ARKUI_ANIMATION_STATUS_INITIAL  | The animation is in the initial state. |
1917| ARKUI_ANIMATION_STATUS_RUNNING  | The animation is being played. |
1918| ARKUI_ANIMATION_STATUS_PAUSED  | The animation is paused. |
1919| ARKUI_ANIMATION_STATUS_STOPPED  | The animation is stopped. |
1920
1921
1922### ArkUI_Axis
1923
1924```
1925enum ArkUI_Axis
1926```
1927**Description**
1928
1929Enumerates the scroll directions.
1930
1931**Since**: 12
1932
1933| Enum| Description|
1934| -------- | -------- |
1935| ARKUI_AXIS_VERTICAL  | Only vertical scrolling is supported. |
1936| ARKUI_AXIS_HORIZONTAL  | Only horizontal scrolling is supported. |
1937
1938
1939### ArkUI_BarrierDirection
1940
1941```
1942enum ArkUI_BarrierDirection
1943```
1944**Description**
1945
1946Enumerates the barrier directions.
1947
1948**Since**: 12
1949
1950| Enum| Description|
1951| -------- | -------- |
1952| ARKUI_BARRIER_DIRECTION_START  | The barrier is on the left side of all the referenced components specified by referencedId. |
1953| ARKUI_BARRIER_DIRECTION_END  | The barrier is on the right side of all the referenced components specified by referencedId. |
1954| ARKUI_BARRIER_DIRECTION_TOP  | The barrier is at the top of all the referenced components specified by referencedId. |
1955| ARKUI_BARRIER_DIRECTION_BOTTOM  | The barrier is at the bottom of all the referenced components specified by referencedId. |
1956
1957
1958### ArkUI_BlendApplyType
1959
1960```
1961enum ArkUI_BlendApplyType
1962```
1963**Description**
1964
1965Defines how the specified blend mode is applied.
1966
1967**Since**: 12
1968
1969| Enum| Description|
1970| -------- | -------- |
1971| BLEND_APPLY_TYPE_FAST  | The content of the view is blended in sequence on the target image. |
1972| 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.|
1973
1974
1975### ArkUI_BlendMode
1976
1977```
1978enum ArkUI_BlendMode
1979```
1980**Description**
1981
1982Enumerates the blend modes.
1983
1984**Since**: 12
1985
1986| Enum| Description|
1987| -------- | -------- |
1988| ARKUI_BLEND_MODE_NONE  | The top image is superimposed on the bottom image without any blending. |
1989| ARKUI_BLEND_MODE_CLEAR  | The target pixels covered by the source pixels are erased by being turned to completely transparent. |
1990| ARKUI_BLEND_MODE_SRC  | r = s: Only the source pixels are displayed. |
1991| ARKUI_BLEND_MODE_DST  | r = d: Only the target pixels are displayed. |
1992| ARKUI_BLEND_MODE_SRC_OVER  | r = s + (1 - sa) \d: The source pixels are blended based on opacity and cover the target pixels. |
1993| ARKUI_BLEND_MODE_DST_OVER  | r = d + (1 - da) *\ s: The target pixels are blended based on opacity and cover on the source pixels. |
1994| ARKUI_BLEND_MODE_SRC_IN  | r = s \* da: Only the part of the source pixels that overlap with the target pixels is displayed. |
1995| ARKUI_BLEND_MODE_DST_IN  | r = d \* sa: Only the part of the target pixels that overlap with the source pixels is displayed. |
1996| 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. |
1997| 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. |
1998| 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. |
1999| 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. |
2000| 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. |
2001| ARKUI_BLEND_MODE_PLUS  | r = min(s + d, 1): New pixels resulting from adding the source pixels to the target pixels are displayed. |
2002| ARKUI_BLEND_MODE_MODULATE  | r = s \* d: New pixels resulting from multiplying the source pixels with the target pixels are displayed. |
2003| 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. |
2004| ARKUI_BLEND_MODE_OVERLAY  | The MULTIPLY or SCREEN mode is used based on the target pixels. |
2005| ARKUI_BLEND_MODE_DARKEN  | rc = s + d - max(s \da, d \sa), ra = kSrcOver: When two colors overlap, whichever is darker is used. |
2006| ARKUI_BLEND_MODE_LIGHTEN  | rc = s + d - min(s \da, d \sa), ra = kSrcOver: The darker of the pixels (source and target) is used. |
2007| ARKUI_BLEND_MODE_COLOR_DODGE  | The colors of the target pixels are lightened to reflect the source pixels. |
2008| ARKUI_BLEND_MODE_COLOR_BURN  | The colors of the target pixels are darkened to reflect the source pixels. |
2009| ARKUI_BLEND_MODE_HARD_LIGHT  | The MULTIPLY or SCREEN mode is used, depending on the source pixels. |
2010| ARKUI_BLEND_MODE_SOFT_LIGHT  | The LIGHTEN or DARKEN mode is used, depending on the source pixels. |
2011| 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. |
2012| ARKUI_BLEND_MODE_EXCLUSION  | rc = s + d - two(s \* d), ra = kSrcOver: The final pixel is similar to **DIFFERENCE**, but with less contrast. |
2013| 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.|
2014| 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. |
2015| 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. |
2016| 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. |
2017| 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. |
2018
2019
2020### ArkUI_BlurStyle
2021
2022```
2023enum ArkUI_BlurStyle
2024```
2025**Description**
2026
2027Enumerates the blur styles.
2028
2029**Since**: 12
2030
2031| Enum| Description|
2032| -------- | -------- |
2033| ARKUI_BLUR_STYLE_THIN  | Thin material. |
2034| ARKUI_BLUR_STYLE_REGULAR  | Regular material. |
2035| ARKUI_BLUR_STYLE_THICK  | Thick material. |
2036| ARKUI_BLUR_STYLE_BACKGROUND_THIN  | Material that creates the minimum depth of field effect. |
2037| ARKUI_BLUR_STYLE_BACKGROUND_REGULAR  | Material that creates a medium shallow depth of field effect. |
2038| ARKUI_BLUR_STYLE_BACKGROUND_THICK  | Material that creates a high shallow depth of field effect. |
2039| ARKUI_BLUR_STYLE_BACKGROUND_ULTRA_THICK  | Material that creates the maximum depth of field effect. |
2040| ARKUI_BLUR_STYLE_NONE  | No blur. |
2041| ARKUI_BLUR_STYLE_COMPONENT_ULTRA_THIN  | Component ultra-thin material. |
2042| ARKUI_BLUR_STYLE_COMPONENT_THIN  | Component thin material. |
2043| ARKUI_BLUR_STYLE_COMPONENT_REGULAR  | Component regular material. |
2044| ARKUI_BLUR_STYLE_COMPONENT_THICK  | Component thick material. |
2045| ARKUI_BLUR_STYLE_COMPONENT_ULTRA_THICK  | Component ultra-thick material. |
2046
2047
2048### ArkUI_BorderStyle
2049
2050```
2051enum ArkUI_BorderStyle
2052```
2053**Description**
2054
2055Enumerates the border styles.
2056
2057**Since**: 12
2058
2059| Enum| Description|
2060| -------- | -------- |
2061| ARKUI_BORDER_STYLE_SOLID  | Solid border. |
2062| ARKUI_BORDER_STYLE_DASHED  | Dashed border. |
2063| ARKUI_BORDER_STYLE_DOTTED  | Dotted border. |
2064
2065
2066### ArkUI_ButtonType
2067
2068```
2069enum ArkUI_ButtonType
2070```
2071**Description**
2072
2073Enumerates the button types.
2074
2075**Since**: 12
2076
2077| Enum| Description|
2078| -------- | -------- |
2079| ARKUI_BUTTON_TYPE_NORMAL  | Normal button (without rounded corners by default). |
2080| ARKUI_BUTTON_TYPE_CAPSULE  | Capsule-type button (the round corner is half of the height by default). |
2081| ARKUI_BUTTON_TYPE_CIRCLE  | Circle button. |
2082
2083
2084### ArkUI_CalendarAlignment
2085
2086```
2087enum ArkUI_CalendarAlignment
2088```
2089**Description**
2090
2091Enumerates the alignment modes between the calendar picker and the entry component.
2092
2093**Since**: 12
2094
2095| Enum| Description|
2096| -------- | -------- |
2097| ARKUI_CALENDAR_ALIGNMENT_START  | Left aligned. |
2098| ARKUI_CALENDAR_ALIGNMENT_CENTER  | Center aligned. |
2099| ARKUI_CALENDAR_ALIGNMENT_END  | Right aligned. |
2100
2101
2102### ArkUI_CancelButtonStyle
2103
2104```
2105enum ArkUI_CancelButtonStyle
2106```
2107**Description**
2108
2109Enumerates the styles of the Cancel button.
2110
2111**Since**: 12
2112
2113| Enum| Description|
2114| -------- | -------- |
2115| ARKUI_CANCELBUTTON_STYLE_CONSTANT  | The Cancel button is always displayed. |
2116| ARKUI_CANCELBUTTON_STYLE_INVISIBLE  | The Cancel button is always hidden. |
2117| ARKUI_CANCELBUTTON_STYLE_INPUT  | The Cancel button is displayed when there is text input. |
2118
2119
2120### ArkUI_CheckboxShape
2121
2122```
2123enum ArkUI_CheckboxShape
2124```
2125**Description**
2126
2127Enumerates the shapes of the check box.
2128
2129**Since**: 12
2130
2131| Enum| Description|
2132| -------- | -------- |
2133| ArkUI_CHECKBOX_SHAPE_CIRCLE  | Circle. |
2134| ArkUI_CHECKBOX_SHAPE_ROUNDED_SQUARE  | Rounded square. |
2135
2136
2137### ArkUI_ClipType
2138
2139```
2140enum ArkUI_ClipType
2141```
2142**Description**
2143
2144Enumerates the clipping region types.
2145
2146**Since**: 12
2147
2148| Enum| Description|
2149| -------- | -------- |
2150| ARKUI_CLIP_TYPE_RECTANGLE  | Rectangle. |
2151| ARKUI_CLIP_TYPE_CIRCLE  | **(circle)** |
2152| ARKUI_CLIP_TYPE_ELLIPSE  | Ellipse. |
2153| ARKUI_CLIP_TYPE_PATH  | Path Type |
2154
2155
2156### ArkUI_ColorMode
2157
2158```
2159enum ArkUI_ColorMode
2160```
2161**Description**
2162
2163Enumerates the color modes.
2164
2165**Since**: 12
2166
2167| Enum| Description|
2168| -------- | -------- |
2169| ARKUI_COLOR_MODE_SYSTEM  | Following the system color mode. |
2170| ARKUI_COLOR_MODE_LIGHT  | Light color mode. |
2171| ARKUI_COLOR_MODE_DARK  | Dark color mode. |
2172
2173
2174### ArkUI_ColorStrategy
2175
2176```
2177enum ArkUI_ColorStrategy
2178```
2179**Description**
2180
2181Enumerates the foreground colors.
2182
2183**Since**: 12
2184
2185| Enum| Description|
2186| -------- | -------- |
2187| ARKUI_COLOR_STRATEGY_INVERT  | The foreground colors are the inverse of the component background colors. |
2188| ARKUI_COLOR_STRATEGY_AVERAGE  | The shadow colors of the component are the average color obtained from the component background shadow area. |
2189| ARKUI_COLOR_STRATEGY_PRIMARY  | The shadow colors of the component are the primary color obtained from the component background shadow area. |
2190
2191
2192### ArkUI_CopyOptions
2193
2194```
2195enum ArkUI_CopyOptions
2196```
2197**Description**
2198
2199Enumerates the text copy and paste modes.
2200
2201**Since**: 12
2202
2203| Enum| Description|
2204| -------- | -------- |
2205| ARKUI_COPY_OPTIONS_NONE  | Copy is not allowed. |
2206| ARKUI_COPY_OPTIONS_IN_APP  | Intra-application copy is allowed. |
2207| ARKUI_COPY_OPTIONS_LOCAL_DEVICE  | Intra-device copy is allowed. |
2208| ARKUI_COPY_OPTIONS_CROSS_DEVICE  | Cross-device copy is allowed. |
2209
2210
2211### ArkUI_Direction
2212
2213```
2214enum ArkUI_Direction
2215```
2216**Description**
2217
2218Enumerates the modes in which components are laid out along the main axis of the container.
2219
2220**Since**: 12
2221
2222| Enum| Description|
2223| -------- | -------- |
2224| ARKUI_DIRECTION_LTR  | Components are arranged from left to right. |
2225| ARKUI_DIRECTION_RTL  | Components are arranged from right to left. |
2226| ARKUI_DIRECTION_AUTO  | The default layout direction is used. |
2227
2228
2229### ArkUI_DismissReason
2230
2231```
2232enum ArkUI_DismissReason
2233```
2234**Description**
2235
2236Enumerates the actions for triggering closure of the dialog box.
2237
2238**Since**: 12
2239
2240| Enum| Description|
2241| -------- | -------- |
2242| DIALOG_DISMISS_BACK_PRESS  | Touching the system-defined Back button or pressing the Esc key. |
2243| DIALOG_DISMISS_TOUCH_OUTSIDE  | Touching the mask. |
2244| DIALOG_DISMISS_CLOSE_BUTTON  | Touching the Close button. |
2245| DIALOG_DISMISS_SLIDE_DOWN  | Sliding down. |
2246
2247
2248### ArkUI_LevelMode
2249
2250```
2251enum ArkUI_LevelMode
2252```
2253**Description**
2254
2255Enumerates the display level modes of the dialog box.
2256
2257**Since**: 15
2258
2259| Enum| Description|
2260| -------- | -------- |
2261| ARKUI_LEVEL_MODE_OVERLAY  | The dialog box is displayed on top of all other application content. |
2262| ARKUI_LEVEL_MODE_EMBEDDED  | The dialog box is embedded within the application's page content. |
2263
2264### ArkUI_ImmersiveMode
2265
2266```
2267enum ArkUI_ImmersiveMode
2268```
2269**Description**
2270
2271Enumerates the display areas of the embedded dialog box overlay.
2272
2273**Since**: 15
2274
2275| Enum| Description|
2276| -------- | -------- |
2277| ARKUI_IMMERSIVE_MODE_DEFAULT  | The dialog box overlay follows the layout constraints of its parent node. |
2278| ARKUI_IMMERSIVE_MODE_EXTEND  | The dialog box overlay can extend to cover the status bar and navigation bar for a more immersive look. |
2279
2280### ArkUI_DragPreviewScaleMode
2281
2282```
2283enum ArkUI_DragPreviewScaleMode
2284```
2285**Description**
2286
2287Defines an enum for drag preview scale modes.
2288
2289**Since**: 12
2290
2291| Enum| Description|
2292| -------- | -------- |
2293| 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. |
2294| ARKUI_DRAG_PREVIEW_SCALE_DISABLED  | The system does not scale the drag preview. |
2295
2296
2297### ArkUI_DragResult
2298
2299```
2300enum ArkUI_DragResult
2301```
2302**Description**
2303
2304Defines 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.
2305
2306**Since**: 12
2307
2308| Enum| Description|
2309| -------- | -------- |
2310| ARKUI_DRAG_RESULT_SUCCESSFUL  | The drag and drop operation succeeded. |
2311| ARKUI_DRAG_RESULT_FAILED  | The drag and drop operation failed. |
2312| ARKUI_DRAG_RESULT_CANCELED  | The drag and drop operation was canceled. |
2313
2314
2315### ArkUI_DragStatus
2316
2317```
2318enum ArkUI_DragStatus
2319```
2320**Description**
2321
2322Enumerates dragging states.
2323
2324**Since**: 12
2325
2326| Enum| Description|
2327| -------- | -------- |
2328| ArkUI_DRAG_STATUS_UNKNOWN  | Unknown. |
2329| ArkUI_DRAG_STATUS_STARTED  | Started. |
2330| ArkUI_DRAG_STATUS_ENDED  | Ended. |
2331
2332
2333### ArkUI_DropOperation
2334
2335```
2336enum ArkUI_DropOperation
2337```
2338**Description**
2339
2340Defines an enum for data processing modes used when data is dropped, which affects the display of the badge.
2341
2342**Since**: 12
2343
2344| Enum| Description|
2345| -------- | -------- |
2346| ARKUI_DROP_OPERATION_COPY  | Copy. |
2347| ARKUI_DROP_OPERATION_MOVE  | Cut. |
2348
2349
2350### ArkUI_EdgeEffect
2351
2352```
2353enum ArkUI_EdgeEffect
2354```
2355**Description**
2356
2357Enumerates the effects used at the edges of the component when the boundary of the scrollable content is reached.
2358
2359**Since**: 12
2360
2361| Enum| Description|
2362| -------- | -------- |
2363| 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. |
2364| ARKUI_EDGE_EFFECT_FADE  | Fade effect. When at one of the edges, the component produces a fade effect. |
2365| ARKUI_EDGE_EFFECT_NONE  | No effect when the component is at one of the edges. |
2366
2367
2368### ArkUI_EffectEdge
2369
2370```
2371enum ArkUI_EffectEdge
2372```
2373**Description**
2374
2375Enumerates the edges for which the effect takes effect when the boundary of the scrollable content is reached.
2376
2377**Since**: 17
2378
2379| Enum| Description|
2380| -------- | -------- |
2381| ARKUI_EFFECT_EDGE_START  | Start edge. |
2382| ARKUI_EFFECT_EDGE_END  | End edge. |
2383
2384
2385### ArkUI_EllipsisMode
2386
2387```
2388enum ArkUI_EllipsisMode
2389```
2390**Description**
2391
2392Enumerates the ellipsis positions.
2393
2394**Since**: 12
2395
2396| Enum| Description|
2397| -------- | -------- |
2398| ARKUI_ELLIPSIS_MODE_START  | An ellipsis is used at the start of the line of text. |
2399| ARKUI_ELLIPSIS_MODE_CENTER  | An ellipsis is used at the center of the line of text. |
2400| ARKUI_ELLIPSIS_MODE_END  | An ellipsis is used at the end of the line of text. |
2401
2402
2403### ArkUI_EnterKeyType
2404
2405```
2406enum ArkUI_EnterKeyType
2407```
2408**Description**
2409
2410Enumerates the types of the Enter key for a single-line text box.
2411
2412**Since**: 12
2413
2414| Enum| Description|
2415| -------- | -------- |
2416| ARKUI_ENTER_KEY_TYPE_GO  | The Enter key is labeled "Go." |
2417| ARKUI_ENTER_KEY_TYPE_SEARCH  | The Enter key is labeled "Search." |
2418| ARKUI_ENTER_KEY_TYPE_SEND  | The Enter key is labeled "Send." |
2419| ARKUI_ENTER_KEY_TYPE_NEXT  | The Enter key is labeled "Next." |
2420| ARKUI_ENTER_KEY_TYPE_DONE  | The Enter key is labeled "Done." |
2421| ARKUI_ENTER_KEY_TYPE_PREVIOUS  | The Enter key is labeled "Previous." |
2422| ARKUI_ENTER_KEY_TYPE_NEW_LINE  | The Enter key is labeled "Return." |
2423
2424
2425### ArkUI_ErrorCode
2426
2427```
2428enum ArkUI_ErrorCode
2429```
2430**Description**
2431
2432Defines an enum for the error codes.
2433
2434**Since**: 12
2435
2436| Enum| Description|
2437| -------- | -------- |
2438| ARKUI_ERROR_CODE_NO_ERROR  | No error. |
2439| ARKUI_ERROR_CODE_PARAM_INVALID  | Parameter error. |
2440| ARKUI_ERROR_CODE_ATTRIBUTE_OR_EVENT_NOT_SUPPORTED  | The component does not support specific attributes or events. |
2441| ARKUI_ERROR_CODE_NOT_SUPPROTED_FOR_ARKTS_NODE  | The specific operation is not allowed on the node created by ArkTS. |
2442| ARKUI_ERROR_CODE_NODE_ADAPTER_NONE_HOST  | The adapter for lazy loading is not bound to the component. |
2443| ARKUI_ERROR_CODE_NODE_ADAPTER_EXIST_IN_HOST  | The adapter already exists. |
2444| ARKUI_ERROR_CODE_NODE_ADAPTER_CHILD_NODE_EXIST  | Failed to add the adapter because the corresponding node already has a subnode. |
2445| ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INDEX_OUT_OF_RANGE  | The parameter length in the parameter event exceeds the limit. |
2446| ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INVALID  | The data does not exist in the component event. |
2447| ARKUI_ERROR_CODE_NODE_EVENT_NO_RETURN  | The component event does not support return values. |
2448| ARKUI_ERROR_CODE_NODE_INDEX_INVALID  | Invalid index. |
2449| ARKUI_ERROR_CODE_GET_INFO_FAILED  | Failed to obtain the route navigation information. |
2450| ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR  | Buffer size error. |
2451| ARKUI_ERROR_CODE_FOCUS_NON_FOCUSABLE | The current node is not focusable.|
2452| ARKUI_ERROR_CODE_FOCUS_NON_FOCUSABLE_ANCESTOR | An ancestor of the current node is not focusable.|
2453| ARKUI_ERROR_CODE_FOCUS_NON_EXISTENT | The current node does not exist.|
2454| ARKUI_ERROR_CODE_NON_SCROLLABLE_CONTAINER  | The component is not a scrollable container. |
2455| ARKUI_ERROR_CODE_BUFFER_SIZE_NOT_ENOUGH  | The buffer is not large enough. |
2456| ARKUI_ERROR_CODE_INVALID_STYLED_STRING  | Invalid styled string. |
2457| ARKUI_ERROR_CODE_RECOGNIZER_TYPE_NOT_SUPPORTED  | The gesture recognizer type is not supported. |
2458
2459
2460### ArkUI_FinishCallbackType
2461
2462```
2463enum ArkUI_FinishCallbackType
2464```
2465**Description**
2466
2467Enumerates the animation **onFinish** callback types.
2468
2469**Since**: 12
2470
2471| Enum| Description|
2472| -------- | -------- |
2473| ARKUI_FINISH_CALLBACK_REMOVED  | The callback is invoked when the entire animation is removed once it has finished. |
2474| 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. |
2475
2476
2477### ArkUI_FlexAlignment
2478
2479```
2480enum ArkUI_FlexAlignment
2481```
2482**Description**
2483
2484Enumerates the vertical alignment modes.
2485
2486**Since**: 12
2487
2488| Enum| Description|
2489| -------- | -------- |
2490| ARKUI_FLEX_ALIGNMENT_START  | The child components are aligned with the start edge of the main axis. |
2491| ARKUI_FLEX_ALIGNMENT_CENTER  | The child components are aligned in the center of the main axis. |
2492| ARKUI_FLEX_ALIGNMENT_END  | The child components are aligned with the end edge of the main axis. |
2493| 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. |
2494| 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. |
2495| 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. |
2496
2497
2498### ArkUI_FlexDirection
2499
2500```
2501enum ArkUI_FlexDirection
2502```
2503**Description**
2504
2505Enumerates the directions of the main axis in the flex container.
2506
2507**Since**: 12
2508
2509| Enum| Description|
2510| -------- | -------- |
2511| ARKUI_FLEX_DIRECTION_ROW  | The child components are arranged in the same direction as the main axis runs along the rows. |
2512| ARKUI_FLEX_DIRECTION_COLUMN  | The child components are arranged in the same direction as the main axis runs down the columns. |
2513| ARKUI_FLEX_DIRECTION_ROW_REVERSE  | The child components are arranged opposite to the **ROW** direction. |
2514| ARKUI_FLEX_DIRECTION_COLUMN_REVERSE  | The child components are arranged opposite to the **COLUMN** direction. |
2515
2516
2517### ArkUI_FlexWrap
2518
2519```
2520enum ArkUI_FlexWrap
2521```
2522**Description**
2523
2524Defines whether the flex container has a single line or multiple lines.
2525
2526**Since**: 12
2527
2528| Enum| Description|
2529| -------- | -------- |
2530| ARKUI_FLEX_WRAP_NO_WRAP  | The child components in the flex container are arranged in a single line, and they cannot overflow. |
2531| ARKUI_FLEX_WRAP_WRAP  | The child components in the flex container are arranged in multiple lines, and they may overflow. |
2532| ARKUI_FLEX_WRAP_WRAP_REVERSE  | The child components in the flex container are reversely arranged in multiple lines, and they may overflow. |
2533
2534
2535### ArkUI_FontStyle
2536
2537```
2538enum ArkUI_FontStyle
2539```
2540**Description**
2541
2542Enumerates the font styles.
2543
2544**Since**: 12
2545
2546| Enum| Description|
2547| -------- | -------- |
2548| ARKUI_FONT_STYLE_NORMAL  | Standard font style. |
2549| ARKUI_FONT_STYLE_ITALIC  | Italic font style. |
2550
2551
2552### ArkUI_FontWeight
2553
2554```
2555enum ArkUI_FontWeight
2556```
2557**Description**
2558
2559Enumerates the font weights.
2560
2561**Since**: 12
2562
2563| Enum| Description|
2564| -------- | -------- |
2565| ARKUI_FONT_WEIGHT_W100  | 100  |
2566| ARKUI_FONT_WEIGHT_W200  | 200  |
2567| ARKUI_FONT_WEIGHT_W300  | 300  |
2568| ARKUI_FONT_WEIGHT_W400  | 400  |
2569| ARKUI_FONT_WEIGHT_W500  | 500  |
2570| ARKUI_FONT_WEIGHT_W600  | 600  |
2571| ARKUI_FONT_WEIGHT_W700  | 700  |
2572| ARKUI_FONT_WEIGHT_W800  | 800  |
2573| ARKUI_FONT_WEIGHT_W900  | 900  |
2574| ARKUI_FONT_WEIGHT_BOLD  | The font weight is bold. |
2575| ARKUI_FONT_WEIGHT_NORMAL  | The font weight is normal. |
2576| ARKUI_FONT_WEIGHT_BOLDER  | The font weight is bolder. |
2577| ARKUI_FONT_WEIGHT_LIGHTER  | The font weight is lighter. |
2578| ARKUI_FONT_WEIGHT_MEDIUM  | The font weight is medium. |
2579| ARKUI_FONT_WEIGHT_REGULAR  | The font weight is normal. |
2580
2581
2582### ArkUI_GestureDirection
2583
2584```
2585enum ArkUI_GestureDirection
2586```
2587**Description**
2588
2589Enumerates gesture directions.
2590
2591**Since**: 12
2592
2593| Enum| Description|
2594| -------- | -------- |
2595| GESTURE_DIRECTION_ALL  | All directions. |
2596| GESTURE_DIRECTION_HORIZONTAL  | Horizontal direction. |
2597| GESTURE_DIRECTION_VERTICAL  | Vertical direction. |
2598| GESTURE_DIRECTION_LEFT  | Leftward. |
2599| GESTURE_DIRECTION_RIGHT  | Rightward. |
2600| GESTURE_DIRECTION_UP  | Upward. |
2601| GESTURE_DIRECTION_DOWN  | Downward. |
2602| GESTURE_DIRECTION_NONE  | None. |
2603
2604
2605### ArkUI_GestureEventActionType
2606
2607```
2608enum ArkUI_GestureEventActionType
2609```
2610**Description**
2611
2612Enumerates gesture event types.
2613
2614**Since**: 12
2615
2616| Enum| Description|
2617| -------- | -------- |
2618| GESTURE_EVENT_ACTION_ACCEPT  | Triggered. |
2619| GESTURE_EVENT_ACTION_UPDATE  | Updated. |
2620| GESTURE_EVENT_ACTION_END  | Ended. |
2621| GESTURE_EVENT_ACTION_CANCEL  | Canceled. |
2622
2623
2624### ArkUI_GestureInterruptResult
2625
2626```
2627enum ArkUI_GestureInterruptResult
2628```
2629**Description**
2630
2631Enumerates gesture interruption results.
2632
2633**Since**: 12
2634
2635| Enum| Description|
2636| -------- | -------- |
2637| GESTURE_INTERRUPT_RESULT_CONTINUE  | The gesture recognition process continues. |
2638| GESTURE_INTERRUPT_RESULT_REJECT  | The gesture recognition process is paused. |
2639
2640
2641### ArkUI_GestureMask
2642
2643```
2644enum ArkUI_GestureMask
2645```
2646**Description**
2647
2648Enumerates gesture masking modes.
2649
2650**Since**: 12
2651
2652| Enum| Description|
2653| -------- | -------- |
2654| NORMAL_GESTURE_MASK  | The gestures of child components are enabled and recognized based on the default gesture recognition sequence. |
2655| IGNORE_INTERNAL_GESTURE_MASK  | The gestures of child components are disabled, including the built-in gestures. |
2656
2657
2658### ArkUI_GesturePriority
2659
2660```
2661enum ArkUI_GesturePriority
2662```
2663**Description**
2664
2665Enumerates gesture event modes.
2666
2667**Since**: 12
2668
2669| Enum| Description|
2670| -------- | -------- |
2671| NORMAL  | Normal. |
2672| PRIORITY  | High-priority. |
2673| PARALLEL  | Parallel. |
2674
2675
2676### ArkUI_GestureRecognizerState
2677
2678```
2679enum ArkUI_GestureRecognizerState
2680```
2681**Description**
2682
2683Enumerates the gesture recognizer states.
2684
2685**Since**: 12
2686
2687| Enum| Description|
2688| -------- | -------- |
2689| ARKUI_GESTURE_RECOGNIZER_STATE_REDAY  | Prepared. |
2690| ARKUI_GESTURE_RECOGNIZER_STATE_DETECTING  | Check status. |
2691| ARKUI_GESTURE_RECOGNIZER_STATE_PENDING  | Waiting |
2692| ARKUI_GESTURE_RECOGNIZER_STATE_BLOCKED  | Blocked. |
2693| ARKUI_GESTURE_RECOGNIZER_STATE_SUCCESSFUL  | (Success status) |
2694| ARKUI_GESTURE_RECOGNIZER_STATE_FAILED  | Failed. |
2695
2696
2697### ArkUI_GestureRecognizerType
2698
2699```
2700enum ArkUI_GestureRecognizerType
2701```
2702**Description**
2703
2704Enumerates gesture recognizer types.
2705
2706**Since**: 12
2707
2708| Enum| Description|
2709| -------- | -------- |
2710| TAP_GESTURE  | Tap. |
2711| LONG_PRESS_GESTURE  | Long press gesture. |
2712| PAN_GESTURE  | Pan gesture. |
2713| PINCH_GESTURE  | Pinch gesture. |
2714| ROTATION_GESTURE  | Rotation gesture. |
2715| SWIPE_GESTURE  | Swipe gesture. |
2716| GROUP_GESTURE  | A group of gestures. |
2717
2718
2719### ArkUI_GroupGestureMode
2720
2721```
2722enum ArkUI_GroupGestureMode
2723```
2724**Description**
2725
2726Enumerates gesture group modes.
2727
2728**Since**: 12
2729
2730| Enum| Description|
2731| -------- | -------- |
2732| 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. |
2733| 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. |
2734| EXCLUSIVE_GROUP  | Exclusive recognition. Registered gestures are identified concurrently. If one gesture is successfully recognized, gesture recognition ends. |
2735
2736
2737### ArkUI_HitTestMode
2738
2739```
2740enum ArkUI_HitTestMode
2741```
2742**Description**
2743
2744Enumerates the hit test modes.
2745
2746**Since**: 12
2747
2748| Enum| Description|
2749| -------- | -------- |
2750| 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. |
2751| 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. |
2752| 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. |
2753| ARKUI_HIT_TEST_MODE_NONE  | The node does not respond to the hit test of a touch event. |
2754
2755
2756### ArkUI_HorizontalAlignment
2757
2758```
2759enum ArkUI_HorizontalAlignment
2760```
2761**Description**
2762
2763Enumerates the alignment mode in the horizontal direction.
2764
2765**Since**: 12
2766
2767| Enum| Description|
2768| -------- | -------- |
2769| ARKUI_HORIZONTAL_ALIGNMENT_START  | Aligned with the start edge in the same direction as the language in use. |
2770| ARKUI_HORIZONTAL_ALIGNMENT_CENTER  | Aligned with the center. This is the default alignment mode. |
2771| ARKUI_HORIZONTAL_ALIGNMENT_END  | Aligned with the end edge in the same direction as the language in use. |
2772
2773
2774### ArkUI_ImageInterpolation
2775
2776```
2777enum ArkUI_ImageInterpolation
2778```
2779**Description**
2780
2781Enumerates the image interpolation effects.
2782
2783**Since**: 12
2784
2785| Enum| Description|
2786| -------- | -------- |
2787| ARKUI_IMAGE_INTERPOLATION_NONE  | No image interpolation. |
2788| ARKUI_IMAGE_INTERPOLATION_LOW  | Low quality interpolation. |
2789| ARKUI_IMAGE_INTERPOLATION_MEDIUM  | Medium quality interpolation. |
2790| ARKUI_IMAGE_INTERPOLATION_HIGH  | High quality interpolation. This mode produces scaled images of the highest possible quality. |
2791
2792
2793### ArkUI_ImageRenderMode
2794
2795```
2796enum ArkUI_ImageRenderMode
2797```
2798**Description**
2799
2800Enumerates the image rendering modes.
2801
2802**Since**: 12
2803
2804| Enum| Description|
2805| -------- | -------- |
2806| ARKUI_IMAGE_RENDER_MODE_ORIGINAL  | Render image pixels as they are in the original source image. |
2807| ARKUI_IMAGE_RENDER_MODE_TEMPLATE  | Render image pixels to create a monochrome template image. |
2808
2809
2810### ArkUI_ImageRepeat
2811
2812```
2813enum ArkUI_ImageRepeat
2814```
2815**Description**
2816
2817Enumerates the image repeat patterns.
2818
2819**Since**: 12
2820
2821| Enum| Description|
2822| -------- | -------- |
2823| ARKUI_IMAGE_REPEAT_NONE  | The image is not repeatedly drawn. |
2824| ARKUI_IMAGE_REPEAT_X  | The image is repeatedly drawn only along the x-axis. |
2825| ARKUI_IMAGE_REPEAT_Y  | The image is repeatedly drawn only along the y-axis. |
2826| ARKUI_IMAGE_REPEAT_XY  | The image is repeatedly drawn along both axes. |
2827
2828
2829### ArkUI_ImageSize
2830
2831```
2832enum ArkUI_ImageSize
2833```
2834**Description**
2835
2836Defines the image size.
2837
2838**Since**: 12
2839
2840| Enum| Description|
2841| -------- | -------- |
2842| ARKUI_IMAGE_SIZE_AUTO  | The original image aspect ratio is retained. |
2843| 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. |
2844| ARKUI_IMAGE_SIZE_CONTAIN  | The image is scaled with its aspect ratio retained for the content to be completely displayed within the display boundaries. |
2845
2846
2847### ArkUI_ImageSpanAlignment
2848
2849```
2850enum ArkUI_ImageSpanAlignment
2851```
2852**Description**
2853
2854Enumerates the alignment mode of the image with the text.
2855
2856**Since**: 12
2857
2858| Enum| Description|
2859| -------- | -------- |
2860| ARKUI_IMAGE_SPAN_ALIGNMENT_BASELINE  | The image is bottom aligned with the text baseline. |
2861| ARKUI_IMAGE_SPAN_ALIGNMENT_BOTTOM  | The image is bottom aligned with the text. |
2862| ARKUI_IMAGE_SPAN_ALIGNMENT_CENTER  | The image is centered aligned with the text. |
2863| ARKUI_IMAGE_SPAN_ALIGNMENT_TOP  | The image is top aligned with the text. |
2864
2865
2866### ArkUI_ItemAlignment
2867
2868```
2869enum ArkUI_ItemAlignment
2870```
2871**Description**
2872
2873Enumerates the modes in which components are laid out along the cross axis of the container.
2874
2875**Since**: 12
2876
2877| Enum| Description|
2878| -------- | -------- |
2879| ARKUI_ITEM_ALIGNMENT_AUTO  | The default configuration of the flex container is used. |
2880| ARKUI_ITEM_ALIGNMENT_START  | The items in the flex container are aligned with the cross-start edge. |
2881| ARKUI_ITEM_ALIGNMENT_CENTER  | The items in the flex container are centered along the cross axis. |
2882| ARKUI_ITEM_ALIGNMENT_END  | The items in the flex container are aligned with the cross-end edge. |
2883| ARKUI_ITEM_ALIGNMENT_STRETCH  | The items in the flex container are stretched and padded along the cross axis. |
2884| 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. |
2885
2886
2887### ArkUI_KeyCode
2888
2889```
2890enum ArkUI_KeyCode
2891```
2892**Description**
2893
2894Enumerates the key codes for key events.
2895
2896**Since**: 14
2897
2898| Enum| Description|
2899| -------- | -------- |
2900| ARKUI_KEYCODE_UNKNOWN  | Unknown key. |
2901| ARKUI_KEYCODE_FN  | Function (Fn) key. |
2902| ARKUI_KEYCODE_VOLUME_UP  | Volume Up key. |
2903| ARKUI_KEYCODE_VOLUME_DOWN  | Volume Down key. |
2904| ARKUI_KEYCODE_POWER  | Power key. |
2905| ARKUI_KEYCODE_CAMERA  | Camera key. |
2906| ARKUI_KEYCODE_VOLUME_MUTE  | Speaker Mute key. |
2907| ARKUI_KEYCODE_MUTE  | Mute key. |
2908| ARKUI_KEYCODE_BRIGHTNESS_UP  | Brightness Up key. |
2909| ARKUI_KEYCODE_BRIGHTNESS_DOWN  | Brightness Down key. |
2910| ARKUI_KEYCODE_0  | Key 0. |
2911| ARKUI_KEYCODE_1  | Key 1. |
2912| ARKUI_KEYCODE_2  | Key 2. |
2913| ARKUI_KEYCODE_3  | Key 3. |
2914| ARKUI_KEYCODE_4  | Key 4. |
2915| ARKUI_KEYCODE_5  | Key 5. |
2916| ARKUI_KEYCODE_6  | Key 6. |
2917| ARKUI_KEYCODE_7  | Key 7. |
2918| ARKUI_KEYCODE_8  | Key 8. |
2919| ARKUI_KEYCODE_9  | Key 9. |
2920| ARKUI_KEYCODE_STAR  | Key *. |
2921| ARKUI_KEYCODE_POUND  | Key #. |
2922| ARKUI_KEYCODE_DPAD_UP  |  Up key on D-pad. |
2923| ARKUI_KEYCODE_DPAD_DOWN  | Down key on D-pad. |
2924| ARKUI_KEYCODE_DPAD_LEFT  | Left key on D-pad. |
2925| ARKUI_KEYCODE_DPAD_RIGHT  | Right key on D-pad. |
2926| ARKUI_KEYCODE_DPAD_CENTER  | Center key on D-pad. |
2927| ARKUI_KEYCODE_A  | Key A. |
2928| ARKUI_KEYCODE_B  | Key B. |
2929| ARKUI_KEYCODE_C  | Key C. |
2930| ARKUI_KEYCODE_D  | Key D. |
2931| ARKUI_KEYCODE_E  | Key E. |
2932| ARKUI_KEYCODE_F  | Key F. |
2933| ARKUI_KEYCODE_G  | Key G. |
2934| ARKUI_KEYCODE_H  | Key H. |
2935| ARKUI_KEYCODE_I  | Key I. |
2936| ARKUI_KEYCODE_J  | Key J. |
2937| ARKUI_KEYCODE_K  | Key K. |
2938| ARKUI_KEYCODE_L  | Key L. |
2939| ARKUI_KEYCODE_M  | Key M. |
2940| ARKUI_KEYCODE_N  | Key N. |
2941| ARKUI_KEYCODE_O  | Key O. |
2942| ARKUI_KEYCODE_P  | Key P. |
2943| ARKUI_KEYCODE_Q  | Key R. |
2944| ARKUI_KEYCODE_R  | Key R. |
2945| ARKUI_KEYCODE_S  | Key S. |
2946| ARKUI_KEYCODE_T  | Key T. |
2947| ARKUI_KEYCODE_U  | Key U. |
2948| ARKUI_KEYCODE_V  | Key V. |
2949| ARKUI_KEYCODE_W  | Key W. |
2950| ARKUI_KEYCODE_X  | Key X. |
2951| ARKUI_KEYCODE_Y  | Key Y. |
2952| ARKUI_KEYCODE_Z  | Key Z. |
2953| ARKUI_KEYCODE_COMMA  | Key ,. |
2954| ARKUI_KEYCODE_PERIOD  | Key .. |
2955| ARKUI_KEYCODE_ALT_LEFT  | Left Alt key. |
2956| ARKUI_KEYCODE_ALT_RIGHT  | Right Alt key. |
2957| ARKUI_KEYCODE_SHIFT_LEFT  | Left Shift key. |
2958| ARKUI_KEYCODE_SHIFT_RIGHT  | Right Shift key. |
2959| ARKUI_KEYCODE_TAB  | Tab key. |
2960| ARKUI_KEYCODE_SPACE  | Space key. |
2961| ARKUI_KEYCODE_SYM  | Symbol key. |
2962| ARKUI_KEYCODE_EXPLORER  | Explorer key, which is used to start the explorer application. |
2963| ARKUI_KEYCODE_ENVELOPE  | Email key, which is used to start the email application. |
2964| ARKUI_KEYCODE_ENTER  | Enter key. |
2965| ARKUI_KEYCODE_DEL  | Delete key. |
2966| ARKUI_KEYCODE_GRAVE  | Key `. |
2967| ARKUI_KEYCODE_MINUS  | Key -. |
2968| ARKUI_KEYCODE_EQUALS  | Key =. |
2969| ARKUI_KEYCODE_LEFT_BRACKET  | Key [. |
2970| ARKUI_KEYCODE_RIGHT_BRACKET  | Key ]. |
2971| ARKUI_KEYCODE_BACKSLASH  | Key \. |
2972| ARKUI_KEYCODE_SEMICOLON  | Key ;. |
2973| ARKUI_KEYCODE_APOSTROPHE  | Key '. |
2974| ARKUI_KEYCODE_SLASH  | Key /. |
2975| ARKUI_KEYCODE_AT  | Key @. |
2976| ARKUI_KEYCODE_PLUS  | Key +. |
2977| ARKUI_KEYCODE_MENU  | Menu key. |
2978| ARKUI_KEYCODE_PAGE_UP  | Page Up key. |
2979| ARKUI_KEYCODE_PAGE_DOWN  | Page Down key. |
2980| ARKUI_KEYCODE_ESCAPE  | ESC key. |
2981| ARKUI_KEYCODE_FORWARD_DEL  | Forward Delete key. |
2982| ARKUI_KEYCODE_CTRL_LEFT  | Left Ctrl key. |
2983| ARKUI_KEYCODE_CTRL_RIGHT  | Right Ctrl key. |
2984| ARKUI_KEYCODE_CAPS_LOCK  | Caps Lock key. |
2985| ARKUI_KEYCODE_SCROLL_LOCK  | Scroll Lock key. |
2986| ARKUI_KEYCODE_META_LEFT  | Left Meta key. |
2987| ARKUI_KEYCODE_META_RIGHT  | Right Meta key. |
2988| ARKUI_KEYCODE_FUNCTION  | Function key. |
2989| ARKUI_KEYCODE_SYSRQ  | System Request/Print Screen key. |
2990| ARKUI_KEYCODE_BREAK  | Break/Pause key. |
2991| ARKUI_KEYCODE_MOVE_HOME  | Move to Home key. |
2992| ARKUI_KEYCODE_MOVE_END  | Move to End key. |
2993| ARKUI_KEYCODE_INSERT  | Insert key. |
2994| ARKUI_KEYCODE_FORWARD  | Forward key. |
2995| ARKUI_KEYCODE_MEDIA_PLAY  | Play key. |
2996| ARKUI_KEYCODE_MEDIA_PAUSE  | Pause key. |
2997| ARKUI_KEYCODE_MEDIA_CLOSE  | Close key. |
2998| ARKUI_KEYCODE_MEDIA_EJECT  | Eject key. |
2999| ARKUI_KEYCODE_MEDIA_RECORD  | Record key. |
3000| ARKUI_KEYCODE_F1  | F1 key. |
3001| ARKUI_KEYCODE_F2  | F2 key. |
3002| ARKUI_KEYCODE_F3  | F3 key. |
3003| ARKUI_KEYCODE_F4  | F4 key. |
3004| ARKUI_KEYCODE_F5  | F5 key. |
3005| ARKUI_KEYCODE_F6  | F6 key. |
3006| ARKUI_KEYCODE_F7  | F7 key. |
3007| ARKUI_KEYCODE_F8  | F8 key. |
3008| ARKUI_KEYCODE_F9  | F9 key. |
3009| ARKUI_KEYCODE_F10  | F10 key. |
3010| ARKUI_KEYCODE_F11  | F11 key. |
3011| ARKUI_KEYCODE_F12  | F12 key. |
3012| ARKUI_KEYCODE_NUM_LOCK  | Number Lock key. |
3013| ARKUI_KEYCODE_NUMPAD_0  | Key 0 on numeric keypad. |
3014| ARKUI_KEYCODE_NUMPAD_1  | Key 1 on numeric keypad. |
3015| ARKUI_KEYCODE_NUMPAD_2  | Key 2 on numeric keypad. |
3016| ARKUI_KEYCODE_NUMPAD_3  | Key 3 on numeric keypad. |
3017| ARKUI_KEYCODE_NUMPAD_4  | Key 4 on numeric keypad. |
3018| ARKUI_KEYCODE_NUMPAD_5  | Key 5 on numeric keypad. |
3019| ARKUI_KEYCODE_NUMPAD_6  | Key 6 on numeric keypad. |
3020| ARKUI_KEYCODE_NUMPAD_7  | Key 7 on numeric keypad. |
3021| ARKUI_KEYCODE_NUMPAD_8  | Key 8 on numeric keypad. |
3022| ARKUI_KEYCODE_NUMPAD_9  | Key 9 on numeric keypad. |
3023| ARKUI_KEYCODE_NUMPAD_DIVIDE  | Key / on numeric keypad. |
3024| ARKUI_KEYCODE_NUMPAD_MULTIPLY  | Key * on numeric keypad. |
3025| ARKUI_KEYCODE_NUMPAD_SUBTRACT  | Key - on numeric keypad. |
3026| ARKUI_KEYCODE_NUMPAD_ADD  | Key + on numeric keypad. |
3027| ARKUI_KEYCODE_NUMPAD_DOT  | Key . on numeric keypad. |
3028| ARKUI_KEYCODE_NUMPAD_COMMA  | Key , on numeric keypad. |
3029| ARKUI_KEYCODE_NUMPAD_ENTER  | Enter key on numeric keypad. |
3030| ARKUI_KEYCODE_NUMPAD_EQUALS  | Key = on numeric keypad. |
3031| ARKUI_KEYCODE_NUMPAD_LEFT_PAREN  | Key ( on numeric keypad. |
3032| ARKUI_KEYCODE_NUMPAD_RIGHT_PAREN  | Key ) on numeric keypad. |
3033
3034
3035### ArkUI_KeyEventType
3036
3037```
3038enum ArkUI_KeyEventType
3039```
3040**Description**
3041
3042Type of a key.
3043
3044**Since**: 14
3045
3046| Enum| Description|
3047| -------- | -------- |
3048| ARKUI_KEY_EVENT_UNKNOWN  | Unknown. |
3049| ARKUI_KEY_EVENT_DOWN  | Pressing of a key. |
3050| ARKUI_KEY_EVENT_UP  | Release of a key. |
3051| ARKUI_KEY_EVENT_LONG_PRESS  | Long press of a key. |
3052| ARKUI_KEY_EVENT_CLICK  | Click of a key. |
3053
3054
3055### ArkUI_KeyIntension
3056
3057```
3058enum ArkUI_KeyIntension
3059```
3060**Description**
3061
3062Enumerates the key intentions.
3063
3064**Since**: 14
3065
3066| Enum| Description|
3067| -------- | -------- |
3068| ARKUI_KEY_INTENSION_UNKNOWN  | Unknown intention. |
3069| ARKUI_KEY_INTENSION_UP  | Upward. |
3070| ARKUI_KEY_INTENSION_DOWN  | Downward. |
3071| ARKUI_KEY_INTENSION_LEFT  | Leftward. |
3072| ARKUI_KEY_INTENSION_RIGHT  | Rightward. |
3073| ARKUI_KEY_INTENSION_SELECT  | Select. |
3074| ARKUI_KEY_INTENSION_ESCAPE  |   |
3075| ARKUI_KEY_INTENSION_BACK  | Back. |
3076| ARKUI_KEY_INTENSION_FORWARD  | Forward. |
3077| ARKUI_KEY_INTENSION_MENU  | Menu. |
3078| ARKUI_KEY_INTENSION_HOME  | Home. |
3079| ARKUI_KEY_INTENSION_PAGE_UP  | Page up. |
3080| ARKUI_KEY_INTENSION_PAGE_DOWN  | Page down. |
3081| ARKUI_KEY_INTENSION_ZOOM_OUT  | Zoom out. |
3082| ARKUI_KEY_INTENSION_ZOOM_IN  | Zoom in. |
3083| ARKUI_KEY_INTENTION_MEDIA_PLAY_PAUSE  | Play. |
3084| ARKUI_KEY_INTENTION_MEDIA_FAST_FORWARD  | Fast-forward. |
3085| ARKUI_KEY_INTENTION_MEDIA_FAST_PLAYBACK  | Fast playback. |
3086| ARKUI_KEY_INTENTION_MEDIA_NEXT  | Play next. |
3087| ARKUI_KEY_INTENTION_MEDIA_PREVIOUS  | Play previous. |
3088| ARKUI_KEY_INTENTION_MEDIA_MUTE  | Mute. |
3089| ARKUI_KEY_INTENTION_VOLUME_UP  | Volume up. |
3090| ARKUI_KEY_INTENTION_VOLUME_DOWN  | Volume down. |
3091| ARKUI_KEY_INTENTION_CALL  | Answer a call. |
3092| ARKUI_KEY_INTENTION_CAMERA  | Camera. |
3093
3094
3095### ArkUI_KeySourceType
3096
3097```
3098enum ArkUI_KeySourceType
3099```
3100**Description**
3101
3102Enumerates the types of input devices that trigger key events.
3103
3104**Since**: 14
3105
3106| Enum| Description|
3107| -------- | -------- |
3108| ARKUI_KEY_SOURCE_UNKNOWN  | Unknown type. |
3109| ARKUI_KEY_SOURCE_TYPE_MOUSE  | Mouse. |
3110| ARKUI_KEY_SOURCE_TYPE_KEYBOARD  | Keyboard. |
3111| ARKUI_KEY_SOURCE_TYPE_JOYSTICK  | Joystick. |
3112
3113
3114### ArkUI_LengthMetricUnit
3115
3116```
3117enum ArkUI_LengthMetricUnit
3118```
3119**Description**
3120
3121Enumerates the component units.
3122
3123**Since**: 12
3124
3125| Enum| Description|
3126| -------- | -------- |
3127| ARKUI_LENGTH_METRIC_UNIT_DEFAULT  | Default, which is fp for fonts and vp for non-fonts. |
3128| ARKUI_LENGTH_METRIC_UNIT_PX  | px. |
3129| ARKUI_LENGTH_METRIC_UNIT_VP  | vp. |
3130| ARKUI_LENGTH_METRIC_UNIT_FP  | fp. |
3131
3132
3133### ArkUI_LinearGradientDirection
3134
3135```
3136enum ArkUI_LinearGradientDirection
3137```
3138**Description**
3139
3140Enumerates the gradient directions.
3141
3142**Since**: 12
3143
3144| Enum| Description|
3145| -------- | -------- |
3146| ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT  | From right to left. |
3147| ARKUI_LINEAR_GRADIENT_DIRECTION_TOP  | From bottom to top. |
3148| ARKUI_LINEAR_GRADIENT_DIRECTION_RIGHT  | From left to right. |
3149| ARKUI_LINEAR_GRADIENT_DIRECTION_BOTTOM  | From top to bottom. |
3150| ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT_TOP  | From lower right to upper left. |
3151| ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT_BOTTOM  | From upper right to lower left. |
3152| ARKUI_LINEAR_GRADIENT_DIRECTION_RIGHT_TOP  | From lower left to upper right. |
3153| ARKUI_LINEAR_GRADIENT_DIRECTION_RIGHT_BOTTOM  | From upper left to lower right. |
3154| ARKUI_LINEAR_GRADIENT_DIRECTION_NONE  | No gradient. |
3155| ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM  | Custom direction. |
3156
3157
3158### ArkUI_ListItemAlignment
3159
3160```
3161enum ArkUI_ListItemAlignment
3162```
3163**Description**
3164
3165Enumerates the alignment modes of items along the cross axis.
3166
3167**Since**: 12
3168
3169| Enum| Description|
3170| -------- | -------- |
3171| ARKUI_LIST_ITEM_ALIGNMENT_START  | The list items are packed toward the start edge of the **List** component along the cross axis. |
3172| ARKUI_LIST_ITEM_ALIGNMENT_CENTER  | The list items are centered in the **List** component along the cross axis. |
3173| ARKUI_LIST_ITEM_ALIGNMENT_END  | The list items are packed toward the end edge of the **List** component along the cross axis. |
3174
3175
3176### ArkUI_ListItemSwipeActionState
3177
3178```
3179enum ArkUI_ListItemSwipeActionState
3180```
3181**Description**
3182
3183Enumerates the swipe action item states of list items.
3184
3185**Since**: 12
3186
3187| Enum| Description|
3188| -------- | -------- |
3189| 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. |
3190| 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. |
3191| ARKUI_LIST_ITEM_SWIPE_ACTION_STATE_ACTIONING  | In-action state. The list item is in this state when it enters the delete area. |
3192
3193
3194### ArkUI_ListItemSwipeEdgeEffect
3195
3196```
3197enum ArkUI_ListItemSwipeEdgeEffect
3198```
3199**Description**
3200
3201Enumerates the swipe action item edge effects of list items.
3202
3203**Since**: 12
3204
3205| Enum| Description|
3206| -------- | -------- |
3207| 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. |
3208| ARKUI_LIST_ITEM_SWIPE_EDGE_EFFECT_NONE  | The list item cannot scroll beyond the edge of the list. |
3209
3210
3211### ArkUI_MaskType
3212
3213```
3214enum ArkUI_MaskType
3215```
3216**Description**
3217
3218Enumerates the mask types.
3219
3220**Since**: 12
3221
3222| Enum| Description|
3223| -------- | -------- |
3224| ARKUI_MASK_TYPE_RECTANGLE  | Rectangle. |
3225| ARKUI_MASK_TYPE_CIRCLE  | **(circle)** |
3226| ARKUI_MASK_TYPE_ELLIPSE  | Ellipse. |
3227| ARKUI_MASK_TYPE_PATH  | Path Type |
3228| ARKUI_MASK_TYPE_PROGRESS  | Progress indicator. |
3229
3230
3231### ArkUI_NativeAPIVariantKind
3232
3233```
3234enum ArkUI_NativeAPIVariantKind
3235```
3236**Description**
3237
3238Defines the native API types.
3239
3240**Since**: 12
3241
3242| Enum| Description|
3243| -------- | -------- |
3244| ARKUI_NATIVE_NODE  | API related to UI components. For details, see the struct definition in &lt;arkui/native_node.h&gt;. |
3245| ARKUI_NATIVE_DIALOG  | API related to dialog boxes. For details, see the struct definition in &lt;arkui/native_dialog.h&gt;. |
3246| ARKUI_NATIVE_GESTURE  | API related to gestures. For details, see the struct definition in &lt;arkui/native_gesture.h&gt;. |
3247| ARKUI_NATIVE_ANIMATE  | API related to animations. For details, see the struct definition in &lt;arkui/native_animate.h&gt;. |
3248
3249
3250### ArkUI_NavDestinationState
3251
3252```
3253enum ArkUI_NavDestinationState
3254```
3255**Description**
3256
3257Defines an enum for the **NavDestination** component states.
3258
3259**Since**: 12
3260
3261| Enum| Description|
3262| -------- | -------- |
3263| ARKUI_NAV_DESTINATION_STATE_ON_SHOW  | The **NavDestination** component is displayed. |
3264| ARKUI_NAV_DESTINATION_STATE_ON_HIDE  | The **NavDestination** component is hidden. |
3265| ARKUI_NAV_DESTINATION_STATE_ON_APPEAR  | The **NavDestination** component is mounted to the component tree. |
3266| ARKUI_NAV_DESTINATION_STATE_ON_DISAPPEAR  | The **NavDestination** component is unmounted from the component tree. |
3267| ARKUI_NAV_DESTINATION_STATE_ON_WILL_SHOW  | The **NavDestination** is about to be displayed. |
3268| ARKUI_NAV_DESTINATION_STATE_ON_WILL_HIDE  | The **NavDestination** is about to be hidden. |
3269| ARKUI_NAV_DESTINATION_STATE_ON_WILL_APPEAR  | The **NavDestination** is about to be mounted to the component tree. |
3270| ARKUI_NAV_DESTINATION_STATE_ON_WILL_DISAPPEAR  | The **NavDestination** component is about to be unmounted from the component tree. |
3271| ARKUI_NAV_DESTINATION_STATE_ON_BACK_PRESS  | The back button is pressed for the **NavDestination** component. |
3272
3273
3274### ArkUI_NodeAdapterEventType
3275
3276```
3277enum ArkUI_NodeAdapterEventType
3278```
3279**Description**
3280
3281Enumerates node adapter events.
3282
3283**Since**: 12
3284
3285| Enum| Description|
3286| -------- | -------- |
3287| NODE_ADAPTER_EVENT_WILL_ATTACH_TO_NODE  | This event occurs when the component is attached to the adapter. |
3288| NODE_ADAPTER_EVENT_WILL_DETACH_FROM_NODE  | This event occurs when the component is detached from the adapter. |
3289| NODE_ADAPTER_EVENT_ON_GET_NODE_ID  | This event occurs when the adapter obtains the unique ID of the new element to add. |
3290| NODE_ADAPTER_EVENT_ON_ADD_NODE_TO_ADAPTER  | This event occurs when the adapter obtains the content of the new element to add. |
3291| NODE_ADAPTER_EVENT_ON_REMOVE_NODE_FROM_ADAPTER  | This event occurs when the adapter removes an element. |
3292
3293### ArkUI_NodeAttributeType
3294
3295```
3296enum ArkUI_NodeAttributeType
3297```
3298**Description**
3299
3300Defines the ArkUI style attributes that can be set on the native side.
3301
3302**Since**: 12
3303
3304
3305| Enum| Description|
3306| -------- | -------- |
3307| 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.|
3308| 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.|
3309| 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.|
3310| 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, which can be an online URL, a local path, a Base64-encoded string, or a PixelMap object. Note that SVG images are not supported.<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, which can be an online URL, a local path, a Base64-encoded string, or a PixelMap object. Note that SVG images are not supported.<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.|
3311| 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.|
3312| 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.|
3313| 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. |
3314| 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.|
3315| 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.<br>**NOTE**<br>If more than three parameters are set, the setting does not take effect and no error code is returned.|
3316| 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.|
3317| 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.|
3318| 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.|
3319| 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.|
3320| 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. A larger value indicates a higher blur degree. If the value is **0**, the component is not blurred. If the value is less than 0, it is treated as **0** and no error code is returned. 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.|
3321| 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 to any value other than **ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM**, the **angle** setting becomes ineffective. 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: - **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.|
3322| 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).|
3323| 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.|
3324| 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.|
3325| 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.|
3326| 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**.|
3327| 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.|
3328| NODE_Z_INDEX  | Defines the z-index attribute for the stack sequence. 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: z-index value.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: z-index value.|
3329| 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**.|
3330| 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.|
3331| 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.|
3332| NODE_TRANSFORM  | Defines the transform attribute, which can be used to translate, rotate, and scale images. 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...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.|
3333| 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**.|
3334| 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.|
3335| 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).|
3336| 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.|
3337| NODE_BACKGROUND_IMAGE_SIZE  | Defines the background image width and height. 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 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.|
3338| NODE_BACKGROUND_IMAGE_SIZE_WITH_STYLE  | Defines the background image 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].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).|
3339| 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.|
3340| 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.|
3341| 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.|
3342| 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.|
3343| 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.|
3344| 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.|
3345| 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.|
3346| 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.|
3347| 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.|
3348| 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.|
3349| 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.|
3350| NODE_SWEEP_GRADIENT  | Defines the sweep gradient 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: 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.|
3351| NODE_RADIAL_GRADIENT  | Defines the radial gradient 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: 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.|
3352| 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.|
3353| NODE_BLEND_MODE  | Blends the component's background with the content of the component's child node. 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: 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**.|
3354| NODE_DIRECTION  | Sets the direction of the main axis. 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 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**.|
3355| NODE_CONSTRAINT_SIZE  | Defines the size constraints. 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, 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.|
3356| NODE_GRAY_SCALE  | Defines the grayscale 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: 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.|
3357| NODE_INVERT  | Inverts 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: 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.|
3358| NODE_SEPIA  | Defines the sepia conversion ratio. 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: 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.|
3359| 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).|
3360| NODE_FOREGROUND_COLOR  | Sets the foreground color attribute. This attribute can be set and reset as required through APIs. However, the reset API has no effect on this attribute.<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.|
3361| NODE_OFFSET  | Defines the offset of the component's child relative 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 : 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.|
3362| NODE_MARK_ANCHOR  | Sets the anchor for locating the component's child. 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 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.|
3363| 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. 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: 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.|
3364| NODE_ALIGN_RULES  | Sets the alignment rules in the relative container. This attribute can be set, reset, and obtained as required through APIs.<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.|
3365| NODE_ALIGN_SELF  | Sets the alignment mode of the child components along the cross axis of the parent 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: 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**.|
3366| 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.|
3367| 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.|
3368| NODE_FLEX_BASIS  | Sets the base size of 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: 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.|
3369| NODE_ACCESSIBILITY_GROUP  | Sets the accessibility group. 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: 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**.|
3370| NODE_ACCESSIBILITY_TEXT  | Sets the accessibility 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>.string: accessibility text.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: accessibility text.|
3371| 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).|
3372| NODE_ACCESSIBILITY_DESCRIPTION  | Sets the accessibility description. 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: accessibility description.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: accessibility description.|
3373| 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.|
3374| 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.|
3375| 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.|
3376| 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.|
3377| 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.|
3378| 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. |
3379| 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. |
3380| 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. |
3381| 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. |
3382| 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.|
3383| 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).|
3384| 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.|
3385| 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**.|
3386| 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.|
3387| 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.|
3388| 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**.|
3389| 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].|
3390| 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. |
3391| 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.|
3392| 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.|
3393| 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.|
3394| 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.|
3395| 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).|
3396| 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).|
3397| 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).|
3398| 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).|
3399| 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> |
3400| 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> |
3401| 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).|
3402| 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.|
3403| NODE_FOCUS_BOX  | Sets the style of the system focus box for this component.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: distance between the focus box and the edge of the component A positive number indicates the outside, and a negative number indicates the inside. The value cannot be in percentage.<br>.value[1].f32: width of the focus box. Negative numbers and percentages are not supported.<br>.value[2].u32: color of the focus box.|
3404| 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.|
3405| NODE_TAB_STOP  | Sets whether the focus can be placed on this component. 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.|
3406| NODE_BACKGROUND_IMAGE_RESIZABLE_WITH_SLICE  | Sets the resizable attribute of a background image when it is stretched. 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: pixel value of the image that remains unchanged when the left side of the image is stretched, in vp.<br>.value[1].f32: pixel value of the image that remains unchanged when the top side of the image is stretched, in vp.<br>.value[2].f32: pixel value of the image that remains unchanged when the right side of the image is stretched, in vp.<br>.value[3].f32: pixel value of the image that remains unchanged when the bottom side of the image is stretched, in vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: pixel value of the image that remains unchanged when the left side of the image is stretched, in vp.<br>.value[1].f32: pixel value of the image that remains unchanged when the top side of the image is stretched, in vp.<br>.value[2].f32: pixel value of the image that remains unchanged when the right side of the image is stretched, in vp.<br>.value[3].f32: pixel value of the image that remains unchanged when the bottom side of the image is stretched, in vp.<br>**Since**<br>18 |
3407| NODE_VISIBLE_AREA_APPROXIMATE_CHANGE_RATIO  | Sets the threshold ratio for triggering a visible area change event.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: parameter for visible area change events. The parameter type is **ArkUI_VisibleAreaEventOptions**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>object: parameter for visible area change events. The parameter type is **ArkUI_VisibleAreaEventOptions**.<br>**Since**<br>18 |
3408| 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.|
3409| 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.|
3410| 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.|
3411| 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).|
3412| 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).|
3413| 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.|
3414| 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).|
3415| 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.|
3416| 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.|
3417| NODE_TEXT_MAX_LINES  | Sets the maximum number of lines in 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: 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.|
3418| 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).|
3419| 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} |
3420| 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 (,).|
3421| 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).|
3422| 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.|
3423| 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.|
3424| 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.|
3425| 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.|
3426| 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**.|
3427| 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).|
3428| 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.|
3429| 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).|
3430| 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).|
3431| 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. |
3432| 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 (,).|
3433| 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.|
3434| 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).|
3435| 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.|
3436| 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).|
3437| 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.|
3438| NODE_IMMUTABLE_FONT_WEIGHT  | Defines the font weight attribute, which can be set, reset, and obtained as required through APIs. The font weight specified by this API is not affected by any changes in the system font weight settings.<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).|
3439| 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.|
3440| 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.|
3441| 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.|
3442| 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.|
3443| 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.|
3444| 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).|
3445| 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.|
3446| 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).|
3447| 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.|
3448| 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.|
3449| 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.|
3450| 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**.|
3451| 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.|
3452| 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).|
3453| 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.|
3454| 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).|
3455| 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.|
3456| 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.|
3457| 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.|
3458| 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.|
3459| 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.|
3460| 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.|
3461| 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.|
3462| 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.|
3463| 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.|
3464| 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.|
3465| 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.|
3466| 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. |
3467| NODE_TEXT_INPUT_CARET_STYLE  | Defines the caret style 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: 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.|
3468| 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.|
3469| 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.|
3470| 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).|
3471| 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.|
3472| 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 (,).|
3473| 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.|
3474| 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).|
3475| 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.|
3476| 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.|
3477| 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.|
3478| 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.|
3479| 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. |
3480| 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. |
3481| 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.|
3482| 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).|
3483| 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.|
3484| 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.|
3485| 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.|
3486| 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).|
3487| 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.|
3488| 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.|
3489| 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.|
3490| 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.|
3491| 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.|
3492| 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.|
3493| 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).|
3494| 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.|
3495| 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.|
3496| NODE_TEXT_INPUT_LETTER_SPACING  | Sets the letter spacing 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: letter spacing. The default unit is fp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: letter spacing. The default unit is fp.|
3497| NODE_TEXT_INPUT_ENABLE_PREVIEW_TEXT  | Sets whether to enable preview text for the 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 enable preview tex.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to enable preview tex.|
3498| NODE_TEXT_INPUT_KEYBOARD_APPEARANCE  | Sets the appearance of the keyboard when the text box is focused.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: appearance of the keyboard, specified by an enumeration value of [ArkUI_KeyboardAppearance](#arkui_keyboardappearance).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: appearance of the keyboard, specified by an enumeration value of [ArkUI_KeyboardAppearance](#arkui_keyboardappearance).<br>**Since**<br>15 |
3499| 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.|
3500| 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.|
3501| 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.|
3502| 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.|
3503| 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 (,).|
3504| 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.|
3505| 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.|
3506| 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).|
3507| 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**.|
3508| 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.|
3509| 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.|
3510| 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.|
3511| 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.|
3512| 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).|
3513| 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.|
3514| 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.|
3515| 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.|
3516| 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.|
3517| 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. |
3518| 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.|
3519| 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).|
3520| 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.|
3521| 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.|
3522| NODE_TEXT_AREA_LETTER_SPACING  | Sets the letter spacing 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: letter spacing. The default unit is fp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: letter spacing. The default unit is fp.|
3523| NODE_TEXT_AREA_ENABLE_PREVIEW_TEXT  | Sets whether to enable preview text for the 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 enable preview tex.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to enable preview tex.|
3524| NODE_TEXT_AREA_KEYBOARD_APPEARANCE  | Sets the appearance of the keyboard when the text box is focused.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: appearance of the keyboard, specified by an enumeration value of [ArkUI_KeyboardAppearance](#arkui_keyboardappearance).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: appearance of the keyboard, specified by an enumeration value of [ArkUI_KeyboardAppearance](#arkui_keyboardappearance).<br>**Since**<br>15 |
3525| 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.|
3526| 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: style of the button. The parameter type is [ArkUI_ButtonType](#arkui_buttontype). The default value is **ARKUI_BUTTON_ROUNDED_RECTANGLE**. API version 18 and later versions: **ButtonType.ROUNDED_RECTANGLE**<br> Versions earlier than API version 18: **ButtonType.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.|
3527| NODE_BUTTON_MIN_FONT_SCALE<sup>18+</sup>  | Sets the minimum font scale factor for the button. 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 font scale factor. The default unit is fp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: minimum font scale factor. The default unit is fp.|
3528| NODE_BUTTON_MAX_FONT_SCALE<sup>18+</sup>  | Sets the maximum font scale factor for the button. 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: maximum font scale factor. The default unit is fp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: maximum font scale factor. The default unit is fp.|
3529| 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.|
3530| 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.|
3531| 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.|
3532| 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).|
3533| NODE_PROGRESS_LINEAR_STYLE | Defines the linear progress indicator style. This attribute can be set, reset, and obtained as required through APIs. Note that the settings are effective only if the progress indicator type is linear.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.object: [ArkUI_ProgressLinearStyleOption](#arkui_progresslinearstyleoption) object that defines the linear progress indicator style.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.object: [ArkUI_ProgressLinearStyleOption](#arkui_progresslinearstyleoption) object that defines the linear progress indicator style.|
3534| 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.|
3535| 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**.|
3536| 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**.|
3537| 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**.|
3538| 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).|
3539| NODE_CHECKBOX_NAME  | Sets the name 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>.string: name of the check box.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: name of the check box.|
3540| NODE_CHECKBOX_GROUP  | Sets the name of the check box group to which the check box belongs. 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 check box group.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: name of the check box group.|
3541| 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.|
3542| 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).|
3543| 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. |
3544| NODE_XCOMPONENT_SURFACE_RECT | Sets the rectangle for the surface held by the **XComponent**. This API works only when type of the **XComponent** is set to **SURFACE("surface")** or **TEXTURE**.<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 surface display area relative to the upper left corner of the **XComponent** component, in px.<br>.value[1].i32: Y coordinate of the surface display area relative to the upper left corner of the **XComponent** component, in px.<br>.value[2].i32: width of the surface display area, in px.<br>.value[3].i32: height of the surface display area, in px.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: X coordinate of the surface display area relative to the upper left corner of the **XComponent** component, in px.<br>.value[1].i32: Y coordinate of the surface display area relative to the upper left corner of the **XComponent** component, in px.<br>.value[2].i32: width of the surface display area, in px.<br>.value[3].i32: height of the surface display area, in px.|
3545| NODE_XCOMPONENT_ENABLE_ANALYZER | Sets whether to enable the AI analyzer, which supports subject recognition, text recognition, and object lookup. For the settings to take effect, this API must be used together with **StartImageAnalyzer** and StopImageAnalyzer of **XComponentController**. This feature cannot be used together with the **overlay** attribute. If both are set, the **CustomBuilder** property in **overlay** has no effect. This feature also depends on device capabilities.<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 AI image analyzer.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether to enable the AI image analyzer.
3546| 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.|
3547| 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.|
3548| 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.|
3549| 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.|
3550| 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"**.|
3551| 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"**.|
3552| 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"**.|
3553| NODE_DATE_PICKER_MODE | Sets the date columns to be displayed. This attribute can be set, reset, and obtained as required through APIs. **DatePicker** displays different styles of date columns.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: type of date column to be displayed. The parameter type is [ArkUI_DatePickerMode](#arkui_datepickermode).<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: type of date column to be displayed. The parameter type is [ArkUI_DatePickerMode](#arkui_datepickermode).|
3554| NODE_DATE_PICKER_ENABLE_HAPTIC_FEEDBACK | Specifies whether to enable haptic feedback. 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 haptic feedback. The default value is **true**. The value **true** means to enable haptic feedback, 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 haptic feedback.
3555| 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.|
3556| 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.|
3557| 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"**.|
3558| 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"**.|
3559| 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"**.|
3560| NODE_TIME_PICKER_START  | Sets the start time for 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 **"1970-01-01 00:00:00"**. Only the hour and minute parts of the time are effective.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: time. The default value is **"1970-01-01 00:00:00"**.|
3561| NODE_TIME_PICKER_END  | Sets the end time for 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 **"1970-01-01 23:59:59"**. Only the hour and minute parts of the time are effective.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: time. The default value is **"1970-01-01 23:59:59"**.|
3562| NODE_TIME_PICKER_ENABLE_CASCADE  | Sets whether the AM/PM indicator automatically switches based on the hour in 12-hour format.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether the AM/PM indicator automatically switches based on the hour in 12-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 AM/PM indicator automatically switches based on the hour in 12-hour format.|
3563| 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).|
3564| 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.|
3565| 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 (;).|
3566| 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"**.|
3567| 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"**.|
3568| 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"**.|
3569| 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.|
3570| 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.|
3571| 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.|
3572| NODE_TEXT_PICKER_ENABLE_HAPTIC_FEEDBACK | Specifies whether to enable haptic feedback. 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 haptic feedback. The value **true** means to enable haptic feedback, and **false** means the opposite. 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 haptic feedback.|
3573| 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.|
3574| 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.|
3575| 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.|
3576| 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).|
3577| NODE_CALENDAR_PICKER_START<sup>18+</sup>  | Sets the start date for the calendar picker.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: year.<br>.value[1].u32: month.<br>.value[2].u32: day.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: year.<br>.value[1].u32: month.<br>.value[2].u32: day.
3578| NODE_CALENDAR_PICKER_END<sup>18+</sup>  | Sets the end date for the calendar picker.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: year.<br>.value[1].u32: month.<br>.value[2].u32: day.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: year.<br>.value[1].u32: month.<br>.value[2].u32: day.
3579| NODE_CALENDAR_PICKER_DISABLED_DATE_RANGE<sup>16+</sup>  | Sets the disabled date ranges for 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>.string: string representing the disabled date ranges. The format is "start_date,end_date" for each range, with multiple ranges separated by commas (,).<br>Example: "1910-01-01,1910-12-31,2020-01-01,2020-12-31".<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: string representing the disabled date ranges.|
3580| NODE_CALENDAR_PICKER_MARK_TODAY<sup>16+</sup>  | Sets whether to highlight the current system date. 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: true indicates that the calendar selector is highlighted when the current date is displayed. 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 highlight the current system date in the calendar picker. The value **1** means to highlight the current system date, and **0** means the opposite.|
3581| 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**.|
3582| 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**.|
3583| 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**.|
3584| 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.|
3585| 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.|
3586| 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.|
3587| 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.|
3588| 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.|
3589| 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].|
3590| 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).|
3591| 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.|
3592| 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).|
3593| 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. |
3594| NODE_SLIDER_ENABLE_HAPTIC_FEEDBACK | Specifies whether to enable haptic feedback. 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 haptic feedback. The value **true** means to enable haptic feedback, and **false** means the opposite. 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 haptic feedback.|
3595| 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.|
3596| 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**.|
3597| 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.|
3598| 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. |
3599| NODE_CHECKBOX_GROUP_NAME  | Sets the name of the check box group. This attribute can be set, reset, and obtained as required through APIs. If there are multiple check box groups with the same group name, only the first check box group takes effect.<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: name of the check box group.<br> Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.string: name of the check box group.|
3600| NODE_CHECKBOX_GROUP_SELECT_ALL  | Sets whether to select all check boxes in the check box group. This attribute can be set, reset, and obtained as required through APIs. If the **select** attribute is set for a check box in the group, the setting of the check box has a higher priority.<br>Default value: **false**<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether all check boxes are selected in the check box group. The value **1** means all check boxes are selected in the check box group, and **0** means the opposite.<br> Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether all check boxes are selected in the check box group. The value **1** means all check boxes are selected in the check box group, and **0** means the opposite.|
3601| NODE_CHECKBOX_GROUP_SELECTED_COLOR  | Sets the color for the selected state of the check box group. This attribute can be set, reset, and obtained as required through APIs.<br>Default value: **false**<br>Parameter format of the attribute setting method [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].u32: color of the selected state 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 state in 0xARGB format, for example, **0xFF1122FF**.|
3602| NODE_CHECKBOX_GROUP_UNSELECTED_COLOR  | Sets the color for the unselected state of the check box group. This attribute can be set, reset, and obtained as required through APIs.<br>Default value: **false**<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**.|
3603| NODE_CHECKBOX_GROUP_MARK  | Sets the check mark style of the check box group. This attribute can be set, reset, and obtained as required through APIs.<br>Default value: **false**<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 check 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 check mark, in vp. Optional.<br>.value[2]?.f32: stroke width of the internal mark, in vp. Optional. The default value is **2**.|
3604| NODE_CHECKBOX_GROUP_SHAPE  | Sets the shape of the check box group. This attribute can be set, reset, and obtained as required through APIs.<br>Default value: **false**<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).|
3605| 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).|
3606| 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).|
3607| 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.|
3608| 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.|
3609| 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).|
3610| 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.<br>Sets 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>.value[2]?.i32: direction in which the effect takes effect. The parameter type is [ArkUI_EffectEdge](#arkui_effectedge). The default value is ARKUI_EFFECT_EDGE_START \| ARKUI_EFFECT_EDGE_END.<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.<br>.value[2].i32: direction in which the effect takes effect. The parameter type is [ArkUI_EffectEdge](#arkui_effectedge).<br>**Since**<br>17 |
3611| 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.|
3612| 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.|
3613| 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.|
3614| 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).|
3615| 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.|
3616| 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).|
3617| 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.|
3618| 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.|
3619| 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.|
3620| 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.|
3621| 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**<br>14 |
3622| NODE_SCROLL_SIZE  | Obtains the total size of all child components when fully expanded in the scrollable component.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: total width of all child components when fully expanded in the scrollable component. The default unit is vp.<br>.value[1].f32: total height of all child components when fully expanded in the scrollable component. The default unit is vp.<br>When **NODE_PADDING**, **NODE_MARGIN**, **NODE_BORDER_WIDTH** is set, the values are rounded to the nearest pixel when being converted from vp to px. The return values are calculated based on these rounded pixel values.<br>**Since**<br>14 |
3623| NODE_SCROLL_CONTENT_START_OFFSET | Sets the offset from the start of the list content to the boundary of the list display area. 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: offset from the start of the list content. The default value 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: offset from the start of the list content, in vp.|
3624| NODE_SCROLL_CONTENT_END_OFFSET | Sets the offset from the end of the list content to the boundary of the list display area. 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: offset from the end of the list content. The default value 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: offset from the end of the list content, in vp.|
3625| 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).|
3626| 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).|
3627| 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.|
3628| 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.|
3629| 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>.value[1].i32: whether to show cached items. The value **0** means to hide cached items, and **1** means to show cached items. Default value: 0.<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.<br>.value[1].i32: whether to show cached items. The value **0** means to hide cached items, and **1** means to show cached items. Default value: 0.|
3630| 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**.<br>.value[3]?.f32: Options for scrolling to a specified index, for example, an extra offset for the scroll. The unit is vp.|
3631| 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**.|
3632| 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**.|
3633| 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**.|
3634| 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.|
3635| NODE_LIST_SCROLL_TO_INDEX_IN_GROUP | Scrolls to the specified list item in the specified list item group.<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 list item group in the current container that contains the target list item.<br>.value[1].i32: index of the target list item in the list item group.<br>.value[2]?.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[3]?.i32: how the target 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**.|
3636| NODE_LIST_LANES | Sets the number of lanes (columns or rows) in the list. This attribute can be set, reset, and obtained as required through APIs.<br>Observe the following when using this API:<br>If the value is set to a number, the column width is calculated by dividing the cross-axis width of the **List** component by the specified number.<br>If the value is set to {minLength, maxLength}, the number of columns is adjusted adaptively based on the width of the **List** component, ensuring that the width respects the {minLength, maxLength} constraints during adaptation. The **minLength** constraint is prioritized to ensure that the cross-axis size of the list item meets the minimum requirement. If the cross-axis width constraint of the parent component is infinite, the parent component is arranged by column, and the column width is calculated based on the largest list item in the display area. Each list item group occupies one row in multi-column mode. Its child list items are arranged based on the **lanes** attribute of the list. The number of columns is calculated based on the cross-axis width of the list item group. If the cross-axis width of the list item group is different from that of the list, the number of columns in the list item group may be different from that in the list.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].u32: number of lanes (rows or columns) in the list. The default value is **0**.<br>.value[1]?.f32: minimum length of the list item. The default value is **1**, and the unit is vp.<br>.value[2]?.f32: maximum length of the list item. The default value is **1**, and the unit is vp.<br>.value[3]?.f32: column spacing of the list item. This parameter is effective when the number of columns is greater than 1. The default value is **1**. The unit is vp.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: number of lanes (rows or columns) in the list. If {minLength, maxLength} is set, the return value is **1**.<br>.value[1].f32: minimum length of the list item, in vp.<br>.value[2].f32: maximum length of the list item, in vp.<br>.value[3].f32: column spacing of the list item, in vp.|
3637| NODE_LIST_SCROLL_SNAP_ALIGN | Sets the scroll snap alignment effect for list items. This effect aligns list items to the nearest snap point when scrolling ends. This attribute is effective only when all list items have the same height. It does not take effect when scrolling ends using a touchpad or mouse device. During the alignment animation, the scroll operation source type reported by the **onWillScroll** event is **ScrollSource.FLING**. 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 the scroll snap position. Data type: [ArkUI_ScrollSnapAlign] (#arkui_scrollsnapalign). The default value is ARKUI_SCROLL_SNAP_ALIGN_NONE.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: alignment mode of the scroll snap position. The parameter type is [ArkUI_ScrollSnapAlign](#arkui_scrollsnapalign).|
3638| NODE_LIST_MAINTAIN_VISIBLE_CONTENT_POSITION | Sets whether to maintain the visible content's position when data is inserted or deleted outside the display area of the component.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether to maintain the visible content's position when data is inserted or deleted outside the display area of the component. The value **0** means not to maintain the visible content's position, and **1** 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 maintain the visible content's position when data is inserted or deleted outside the display area of the component. The value **0** means not to maintain the visible content's position, and **1** means the opposite.|
3639| NODE_LIST_STACK_FROM_END | Sets whether the **List** component starts layout from the end.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: whether the **List** component starts layout from the end. The value **0** means layout starts from the top, and **1** means layout starts from the end. The default value is **0**.<br> Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether the **List** component starts layout from the end. The value **0** means layout starts from the top, and **1** means layout starts from the end.|
3640| 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**.|
3641| 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**.|
3642| NODE_SWIPER_SHOW_INDICATOR  | Defines whether to enable the navigation 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 indicator. The value **1** means to enable the navigation 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 indicator. The value **1** means to enable the navigation indicator, and **0** means the opposite. The default value is **1**.|
3643| 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.|
3644| 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**.|
3645| 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**.|
3646| 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.|
3647| 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.|
3648| 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>.value[1]?.i32: switching animation mode. The parameter type is [ArkUI_SwiperAnimationMode] (#arkui_swiperanimationmode). The setting is only effective for the current call.<br>This parameter is supported since API version 15.<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.|
3649| 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 within the viewport.<br>.value[1]?.i32: whether to paginate by group. The value **0** means to paginate by individual child elements, and **1** means to paginate by groups of child elements displayed within the viewport. The default value is **0**.<br>.string?: This parameter can only be set to **"auto"**. When the value is set to **"auto"**, the **value[]** parameter is ignored.<br>**Since**: 18<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: number of elements to display within the viewport.<br> .value[1].i32: whether to paginate by group.<br>**Since**: 18|
3650| 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**.|
3651| NODE_SWIPER_SHOW_DISPLAY_ARROW  | Defines whether to show the arrow when the mouse pointer hovers over the navigation 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: whether to show the arrow when the mouse pointer hovers over the navigation indicator. The parameter type is [ArkUI_SwiperArrow](#arkui_swiperarrow).<br>The default value is **ARKUI_SWIPER_ARROW_HIDE**.<br> .?object: style of the arrow displayed when the mouse pointer hovers over the navigation indicator. The parameter type is [ArkUI_SwiperArrowStyle](#arkui_swiperarrowstyle).<br>**Since**<br>18 <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**.<br> .object: style of the arrow displayed when the mouse pointer hovers over the navigation indicator. The parameter type is [ArkUI_SwiperArrowStyle](#arkui_swiperarrowstyle).<br>**Since**<br>18 |
3652| 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).|
3653| 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.|
3654| 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>.value[1]?.i32: whether to show cached items. The value **0** means to hide cached items, and **1** means to show cached items. The default value is **0**.<br>**Since**<br>18<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.<br>.value[1].i32: whether to show cached items. The value **0** means to hide cached items, and **1** means to show cached items.<br>**Since**<br>18 |
3655| 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.|
3656| 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.|
3657| 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: additional configuration for the navigation indicator, depending on the type. For [ArkUI_SwiperIndicator](#arkui_swiperindicator), the parameter type is [ArkUI_SwiperIndicator](#arkui_swiperindicator).<br> For **ARKUI_SWIPER_INDICATOR_TYPE_DIGIT**, the parameter type is [ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator).<br>  <br>**Since**<br>18 <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: additional configuration for the navigation indicator, depending on the type. For [ArkUI_SwiperIndicator](#arkui_swiperindicator), the parameter type is [ArkUI_SwiperIndicator](#arkui_swiperindicator).<br> For **ARKUI_SWIPER_INDICATOR_TYPE_DIGIT**, the parameter type is [ArkUI_SwiperDigitIndicator](#arkui_swiperdigitindicator).<br>  <br>**Since**<br>18 |
3658| 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).|
3659| 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.|
3660| NODE_SWIPER_INDICATOR_INTERACTIVE  | Sets whether the navigation 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 indicator is interactive. The default value **true** means that the navigation indicator is interactive.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].i32: whether the navigation indicator is interactive.|
3661| NODE_SWIPER_PAGE_FLIP_MODE  | Sets the page flipping mode using the mouse wheel.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].i32: page flipping mode using the mouse wheel. The parameter type is [ArkUI_PageFlipMode](#arkui_pageflipmode).<br>Format of the return value [ArkUI_PageFlipMode](#arkui_pageflipmode)):<br>.value[0].i32: page flipping mode using the mouse wheel.<br>**Since**<br>14 |
3662| NODE_SWIPER_AUTO_FILL  | Configures the **Swiper** component to automatically adjust the number of elements displayed per page based on the minimum width of the elements. 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 of the elements to be displayed, in vp.<br> .value[1]?.i32: whether to paginate by group. The value **0** means to paginate by individual child elements, and **1** means to paginate by groups of child elements displayed within the viewport. The default value is **0**.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: minimum width of the elements to be displayed, in vp.<br> .value[1].i32: whether to paginate by group.<br>**Since**<br>18 |
3663| 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.|
3664| 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.|
3665| 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.|
3666| 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.|
3667| 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: The parameter format is **ArkUI_ListChildrenMainSize**.|
3668| NODE_LIST_ITEM_GROUP_NODE_ADAPTER | Defines the list item group 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. |
3669| 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).|
3670| 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).|
3671| 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).|
3672| 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).|
3673| 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.|
3674| 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.|
3675| 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**.|
3676| 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.|
3677| 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.|
3678| 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.|
3679| 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**.|
3680| 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.|
3681| 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.|
3682| 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.|
3683| 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.|
3684| 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.|
3685| 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.|
3686| 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. <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.|
3687| 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).|
3688| 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**.|
3689| 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. |
3690| 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**.|
3691| 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.|
3692| 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.|
3693| 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.|
3694| 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.|
3695| 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.|
3696| 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.|
3697| 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. |
3698| NODE_TEXT_PICKER_COLUMN_WIDTHS<sup>18+</sup>  | Sets the width of columns in the picker.<br>Format of the [ArkUI_AttributeItem](_ark_u_i___attribute_item.md) parameter for setting the attribute:<br>.value[0].f32: width of the first column, specified as a percentage of the total width. By default, all columns have equal widths.<br>.value[1]?.f32: width of the second column, specified as a percentage of the total width. By default, all columns have equal widths.<br>.value[2]?.f32: width of the third column, specified as a percentage of the total width. By default, all columns have equal widths.<br>...<br>.value[n]?.f32: width of the (n+1)-th column, specified as a percentage of the total width. By default, all columns have equal widths.<br>Format of the return value [ArkUI_AttributeItem](_ark_u_i___attribute_item.md):<br>.value[0].f32: width of the first column as a percentage of the total width.<br>.value[1].f32: width of the second column as a percentage of the total width.<br>.value[2].f32: width of the third column as a percentage of the total width.<br>...<br>.value[n].f32: width of the (n+1)-th column as a percentage of the total width.|
3699| 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**. |
3700| 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).|
3701| 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**.|
3702| 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.|
3703| 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.|
3704| 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**.|
3705| NODE_IMAGE_ANIMATOR_ITERATION  | Sets the number of times that the frame-by-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.|
3706| NODE_BACKDROP_BLUR  | Sets the background blur 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: background blur radius. The value range is [0, +∞). The unit is px. The default value is **0.0**.<br>.value[1]?.f32: brightness of black in the grayscale blur. The value range is [0, 127].<br>.value[2]?.f32: 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].f32: background blur radius. The value range is [0, +∞). The unit is px.<br>.value[1].f32: brightness of black in the grayscale blur. The value range is [0, 127].<br>.value[2].f32: degree of darkening the white color in the grayscale blur. The value range is [0, 127].<br>**Since**: 15|
3707
3708
3709### ArkUI_DatePickerMode
3710
3711```
3712enum ArkUI_DatePickerMode
3713```
3714**Description**
3715
3716Enumerates the column display modes of the date picker.
3717
3718**Since**: 18
3719
3720| Enum| Description|
3721| -------- | -------- |
3722| ARKUI_DATEPICKER_MODE_DATE  | Default value. The date displays three columns: year, month, and day.|
3723| ARKUI_DATEPICKER_YEAR_AND_MONTH  | The date displays two columns: year and month.|
3724| ARKUI_DATEPICKER_MONTH_AND_DAY  | The date displays two columns: month and day.<br>In this mode, if the month changes from December to January, the year does not increment by one; if the month changes from January to December, the year does not decrement by one. The year remains fixed at the currently set value.|
3725
3726### ArkUI_NodeContentEventType
3727
3728```
3729enum ArkUI_NodeContentEventType
3730```
3731**Description**
3732
3733Defines the NodeContent event type.
3734
3735**Since**: 12
3736
3737| Enum| Description|
3738| -------- | -------- |
3739| NODE_CONTENT_EVENT_ON_ATTACH_TO_WINDOW  | Attach event. |
3740| NODE_CONTENT_EVENT_ON_DETACH_FROM_WINDOW  | Detach event. |
3741
3742
3743### ArkUI_NodeCustomEventType
3744
3745```
3746enum ArkUI_NodeCustomEventType
3747```
3748**Description**
3749
3750Enumerates the custom component event types.
3751
3752**Since**: 12
3753
3754| Enum| Description|
3755| -------- | -------- |
3756| ARKUI_NODE_CUSTOM_EVENT_ON_MEASURE  | Measure. |
3757| ARKUI_NODE_CUSTOM_EVENT_ON_LAYOUT  | Layout. |
3758| ARKUI_NODE_CUSTOM_EVENT_ON_DRAW  | Draw. |
3759| ARKUI_NODE_CUSTOM_EVENT_ON_FOREGROUND_DRAW  | Foreground. |
3760| ARKUI_NODE_CUSTOM_EVENT_ON_OVERLAY_DRAW  | Overlay. |
3761
3762### ArkUI_NodeDirtyFlag
3763
3764```
3765enum ArkUI_NodeDirtyFlag
3766```
3767**Description**
3768
3769Enumerates the dirty area flags passed in the **::markDirty** API.
3770
3771**Since**: 12
3772
3773| Enum| Description|
3774| -------- | -------- |
3775| NODE_NEED_MEASURE  | Remeasure.<br>When this type of flag is specified, re-layout is triggered by default.|
3776| NODE_NEED_LAYOUT  | Re-layout. |
3777| NODE_NEED_RENDER  | Re-rendering. |
3778
3779
3780### ArkUI_NodeEventType
3781
3782```
3783enum ArkUI_NodeEventType
3784```
3785**Description**
3786
3787Enumerates the event types supported by the NativeNode component.
3788
3789**Since**: 12
3790
3791| Enum| Description|
3792| -------- | -------- |
3793| 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).|
3794| 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.|
3795| 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.|
3796| 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.|
3797| 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.|
3798| 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.|
3799| 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 click relative to the upper left corner of the clicked component's original area, in px.<br>**[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].f32**: Y coordinate of the click relative to the upper left corner of the clicked component's original area, in px.<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 click relative to the upper left corner of the application window, in px.<br>**[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[5].f32**: Y coordinate of the click relative to the upper left corner of the application window, in px.<br>**[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[6].f32**: X coordinate of the click relative to the upper left corner of the application screen, in px.<br>**[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[7].f32**: Y coordinate of the click relative to the upper left corner of the application screen, in px.|
3800| NODE_ON_CLICK_EVENT | Click event.<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).|
3801| 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).|
3802| 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.|
3803| 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.|
3804| NODE_ON_HOVER_EVENT  | Called when the mouse pointer is moved over or away from 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).|
3805| 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).|
3806| 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.|
3807| 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.|
3808| 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).|
3809| 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).|
3810| 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.|
3811| 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.|
3812| 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.|
3813| 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.|
3814| 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.|
3815| 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.|
3816| NODE_ON_KEY_EVENT  | Triggered when a key event occurs.<br>The callback can be triggered during interactions with a focused window using an external keyboard or other input device.<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>**Since**<br>14 |
3817| NODE_ON_KEY_PRE_IME  | Defines the event triggered before the input method responds to the key action.<br>If the return value of this callback is **true**, the key event is considered consumed, and subsequent event callbacks (**keyboardShortcut**, input method events, **onKeyEvent**) will be intercepted and no longer triggered. The callback can be triggered during interactions with a focused window using an external keyboard or other input device.<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>**Since**<br>14 |
3818| NODE_ON_AXIS | Defines the event triggered when the bound component receives an axis event.<br>Defines the event triggered when the bound component receives an axis event.<br>When an event occurs, the union type in the [ArkUI_NodeEvent] (#arkui_nodeevent-12) object is [ArkUI_UIInputEvent](_ark_u_i___event_module.md#arkui_uiinputevent).<br>**Since**<br>18|
3819| NODE_DISPATCH_KEY_EVENT  | Defines the component key event re-dispatch event. When a component node receives a key event, this callback is triggered instead of dispatching the event to its child nodes.<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>**Since**<br>15 |
3820| NODE_VISIBLE_AREA_APPROXIMATE_CHANGE_EVENT  | 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_APPROXIMATE_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.<br>**Since**<br>18 |
3821| 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.|
3822| 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.|
3823| 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.|
3824| 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.|
3825| 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:.|
3826| 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.|
3827| 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.|
3828| NODE_TEXT_INPUT_ON_SUBMIT  | This event is triggered when the Enter key of the textInput input method is pressed.<br>This event is triggered when the Enter key of the 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.|
3829| 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.|
3830| 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.|
3831| 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.|
3832| 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.|
3833| 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.|
3834| 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.|
3835| 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.|
3836| 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**.|
3837| 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**.|
3838| 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**.|
3839| 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**.|
3840| NODE_TEXT_INPUT_ON_CHANGE_WITH_PREVIEW_TEXT  | Defines the event triggered when content (including preview text) changes in the component.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_TextChangeEvent](_ark_u_i___text_change_event.md).<br>[ArkUI_TextChangeEvent](_ark_u_i___text_change_event.md) contains the following parameters:<br>**[ArkUI_TextChangeEvent.pStr](_ark_u_i___text_change_event.md#pstr)**: text content.<br>**[ArkUI_TextChangeEvent.pExtendStr](_ark_u_i___text_change_event.md#pextendstr)**: preview text content.<br>**[ArkUI_TextChangeEvent.number](_ark_u_i___text_change_event.md#number)**: position where the preview text is inserted.|
3841| 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.|
3842| 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>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.|
3843| NODE_TEXT_AREA_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: end position of the text selection area.|
3844| 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.|
3845| 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.|
3846| 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.|
3847| 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.|
3848| 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.|
3849| 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**.|
3850| 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**.|
3851| 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**.|
3852| 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**.|
3853| NODE_TEXT_AREA_ON_CHANGE_WITH_PREVIEW_TEXT  | Defines the event triggered when content (including preview text) changes in the component.<br>When the event callback occurs, the union type in the [ArkUI_NodeEvent](#arkui_nodeevent-12) object is [ArkUI_TextChangeEvent](_ark_u_i___text_change_event.md).<br>[ArkUI_TextChangeEvent](_ark_u_i___text_change_event.md) contains the following parameters:<br>**[ArkUI_TextChangeEvent.pStr](_ark_u_i___text_change_event.md#pstr)**: text content.<br>**[ArkUI_TextChangeEvent.pExtendStr](_ark_u_i___text_change_event.md#pextendstr)**: preview text content.<br>**[ArkUI_TextChangeEvent.number](_ark_u_i___text_change_event.md#number)**: position where the preview text is inserted.|
3854| 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|
3855| 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.|
3856| 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.|
3857| 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.|
3858| 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.|
3859| 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.|
3860| 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.|
3861| NODE_CHECKBOX_GROUP_EVENT_ON_CHANGE  | Defines the event triggered when the selection state of **ARKUI_NODE_CHECKBOX_GROUP** or any check box in the group 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)**:<br>Name: name of the selected check box.<br>Status: **0**: All check boxes in the group are selected. **1**: Some check boxes in the group are selected. **2**: No check box in the group is selected.|
3862| 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.|
3863| 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.|
3864| 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.|
3865| 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.|
3866| 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.|
3867| 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.|
3868| 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.|
3869| 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.|
3870| 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.|
3871| 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.|
3872| NODE_SWIPER_EVENT_ON_SELECTED<sup>18+</sup>  | Defines the event triggered when the selection changes in the **ARKUI_NODE_SWIPER**.<br>**NOTE**<br>1. When the page switching animation starts after the user lifts their finger after swiping and the swipe meets the threshold for page turning.<br>2. When the page is changed programmatically using either **NODE_SWIPER_INDEX** or **NODE_SWIPER_SWIPE_TO_INDEX**.<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 selected element.|
3873| NODE_SWIPER_EVENT_ON_UNSELECTED<sup>16+</sup>  | Defines the event triggered when the selection changes in the **ARKUI_NODE_SWIPER**.<br>**NOTE**<br>1. When the page switching animation starts after the user lifts their finger after swiping and the swipe meets the threshold for page turning.<br>2. When the page is changed programmatically using either **NODE_SWIPER_INDEX** or **NODE_SWIPER_SWIPE_TO_INDEX**.<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 item that is about to be hidden.|
3874| NODE_SWIPER_EVENT_ON_CONTENT_WILL_SCROLL<sup>15+</sup>  | Defines the event for intercepting swipe behavior in the **Swiper** component. Instructions:<br>1. This event is only triggered by gesture operations, including finger swipes, scrolling the mouse wheel, and moving focus using keyboard arrow keys.<br>2. During finger swipes, the event is triggered for each frame. The system uses the return value of the event to determine whether to respond to the swipe for each frame.<br>3. For scrolling the mouse wheel and moving focus using keyboard arrow keys, the event is triggered once per page turning. The system uses the return value to decide whether to allow the page turning.<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 current page. During a finger swipe, this value remains constant as long as the finger is on the screen, even if the page has completely moved out of view.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[1].i32: index of the page that will be displayed in the direction of the swipe.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[2].f32: translation of the swipe, with a sign indicating the direction. A positive value indicates a swipe from index=1 to index=0, while a negative value indicates a swipe from index=0 to index=1.<br>This value represents the offset for each frame during a finger swipe and the distance for page turning when the mouse wheel or keyboard navigation is used.<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].i32: whether to allow the swipe. The **Swiper** component will use this return value to decide whether to respond to the swipe.|
3875| 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.|
3876| 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.|
3877| 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.|
3878| 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).|
3879| 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.|
3880| 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.|
3881| 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.|
3882| 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.|
3883| 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.|
3884| 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.|
3885| 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.|
3886| NODE_LIST_ON_DID_SCROLL  | Called when the list 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: 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.|
3887| NODE_LIST_ON_SCROLL_VISIBLE_CONTENT_CHANGE | Called when a child component enters or leaves the list display area. During index calculation, the list item, header of the list item group, and footer of the list item group each are counted as a child component. When the list edge scrolling effect is the spring effect, the **NODE_LIST_ON_SCROLL_VISIBLE_CONTENT_CHANGE** event is not triggered when the user scrolls the list to the edge or releases the list to rebound.<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: area in the list item group where the list display area starts. The parameter type is [ArkUI_ListItemGroupArea](#arkui_listitemgrouparea).<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[2].i32: index of the list item at the start of the list display area in the list item group. If the start of the list display area is not on a list item, the value is **1**.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[3].i32: index of the last child component in the list display area.<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[4].i32: area in the list item group where the list display area ends. The parameter type is [ArkUI_ListItemGroupArea](#arkui_listitemgrouparea).<br>[ArkUI_NodeComponentEvent.data](_ark_u_i___node_component_event.md#data)[5].i32: index of the list item at the end of the list display area in the list item group. If the end of the list display area is not on a list item, the value is **1**.|
3888| 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.|
3889| 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.|
3890| 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.|
3891| 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 **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: 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.|
3892| 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 **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: 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:.|
3893| 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:.|
3894
3895
3896### ArkUI_NodeType
3897
3898```
3899enum ArkUI_NodeType
3900```
3901**Description**
3902
3903Enumerates ArkUI component types that can be created on the native side.
3904
3905**Since**: 12
3906
3907| Enum| Description|
3908| -------- | -------- |
3909| ARKUI_NODE_CUSTOM  | *Custom nodes* |
3910| ARKUI_NODE_TEXT  | Text to insert. |
3911| ARKUI_NODE_SPAN  | Text span. |
3912| ARKUI_NODE_IMAGE_SPAN  | Image span. |
3913| ARKUI_NODE_IMAGE  | Image. |
3914| ARKUI_NODE_TOGGLE  | Toggle. |
3915| ARKUI_NODE_LOADING_PROGRESS  | Loading icon. |
3916| ARKUI_NODE_TEXT_INPUT  | Single-line text input. |
3917| ARKUI_NODE_TEXT_AREA  | Multi-line text input. |
3918| ARKUI_NODE_BUTTON  | Icon |
3919| ARKUI_NODE_PROGRESS  | Progress indicator. |
3920| ARKUI_NODE_CHECKBOX  | Check box. |
3921| ARKUI_NODE_XCOMPONENT  | XComponent of the SURFACE type. |
3922| ARKUI_NODE_DATE_PICKER  | Date picker. |
3923| ARKUI_NODE_TIME_PICKER  | Time picker. |
3924| ARKUI_NODE_TEXT_PICKER  | Text picker. |
3925| ARKUI_NODE_CALENDAR_PICKER  | Calendar picker. |
3926| ARKUI_NODE_SLIDER  | Slider. |
3927| ARKUI_NODE_RADIO  | Radio button. |
3928| ARKUI_NODE_IMAGE_ANIMATOR  | Frame animation component. |
3929| ARKUI_NODE_XCOMPONENT_TEXTURE  | XComponent of the TEXTURE type. |
3930| ARKUI_NODE_CHECKBOX_GROUP | Check box group.|
3931| ARKUI_NODE_STACK  | Stack container. |
3932| ARKUI_NODE_SWIPER  | Swiper. |
3933| ARKUI_NODE_SCROLL  | Scrolling container. |
3934| ARKUI_NODE_LIST  | List. |
3935| ARKUI_NODE_LIST_ITEM  | List item. |
3936| ARKUI_NODE_LIST_ITEM_GROUP  | List item group. |
3937| ARKUI_NODE_COLUMN  | Column container. |
3938| ARKUI_NODE_ROW  | Row container. |
3939| ARKUI_NODE_FLEX  | Flex container. |
3940| ARKUI_NODE_REFRESH  | Refresh component. |
3941| ARKUI_NODE_WATER_FLOW  | Water flow container. |
3942| ARKUI_NODE_FLOW_ITEM  | Water flow item. |
3943| ARKUI_NODE_RELATIVE_CONTAINER  | Relative layout component. |
3944| ARKUI_NODE_GRID  | Grid. |
3945| ARKUI_NODE_GRID_ITEM  | Grid item. |
3946| ARKUI_NODE_CUSTOM_SPAN  | Custom span. |
3947
3948
3949### ArkUI_ObjectFit
3950
3951```
3952enum ArkUI_ObjectFit
3953```
3954**Description**
3955
3956Enumerates the image filling effects. ImageSpanAlignment
3957
3958**Since**: 12
3959
3960| Enum| Description|
3961| -------- | -------- |
3962| ARKUI_OBJECT_FIT_CONTAIN  | The image is scaled with its aspect ratio retained for the content to be completely displayed within the display boundaries. |
3963| 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. |
3964| ARKUI_OBJECT_FIT_AUTO  | The image is scaled automatically to fit the display area. |
3965| ARKUI_OBJECT_FIT_FILL  | The image is scaled to fill the display area, and its aspect ratio is not retained. |
3966| 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. |
3967| ARKUI_OBJECT_FIT_NONE  | The original size is retained. |
3968| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_TOP_START  | Not resized, the image is aligned with the start edge of the top of the container. |
3969| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_TOP  | Not resized, the image is horizontally centered at the top of the container. |
3970| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_TOP_END  | Not resized, the image is aligned with the end edge at the top of the container. |
3971| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_START  | Not resized, the image is vertically centered on the start edge of the container. |
3972| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_CENTER  | Not resized, the image is horizontally and vertically centered in the container. |
3973| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_END  | Not resized, the image is vertically centered on the end edge of the container. |
3974| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_BOTTOM_START  | Not resized, the image is aligned with the start edge at the bottom of the container. |
3975| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_BOTTOM  | Not resized, the image is horizontally centered at the bottom of the container. |
3976| ARKUI_OBJECT_FIT_NONE_AND_ALIGN_BOTTOM_END  | Not resized, the image is aligned with the end edge at the bottom of the container. |
3977
3978
3979### ArkUI_PageFlipMode
3980
3981```
3982enum ArkUI_PageFlipMode
3983```
3984**Description**
3985
3986Enumerates the page flipping modes using the mouse wheel for the <b>Swiper</b> component.
3987
3988**Since**: 14
3989
3990| Enum| Description|
3991| -------- | -------- |
3992| ARKUI_PAGE_FLIP_MODE_CONTINUOUS  | When the mouse wheel is scrolled continuously, multiple pages are flipped, which is determined by the number of times that mouse events are reported. |
3993| ARKUI_PAGE_FLIP_MODE_SINGLE  | The system does not respond to other mouse wheel events until the page flipping animation ends. |
3994
3995
3996### ArkUI_SwiperAnimationMode
3997
3998```
3999enum ArkUI_SwiperAnimationMode
4000```
4001**Description**
4002
4003Enumerates the animation modes for the **Swiper** component when jumping to the page with the specified index.
4004
4005**Since**: 15
4006
4007| Enum| Description|
4008| -------- | -------- |
4009| ARKUI_SWIPER_NO_ANIMATION  | Jumps to the target page without any animation. |
4010| ARKUI_SWIPER_DEFAULT_ANIMATION  | Animates smoothly to the target page. |
4011| ARKUI_SWIPER_FAST_ANIMATION  | First jumps to a position near the target page without animation, then animates to the target page. |
4012
4013
4014### ArkUI_PreDragStatus
4015
4016```
4017enum ArkUI_PreDragStatus
4018```
4019**Description**
4020
4021Defines an enum for interaction states prior to a drop and drop operation.
4022
4023**Since**: 12
4024
4025| Enum| Description|
4026| -------- | -------- |
4027| ARKUI_PRE_DRAG_STATUS_UNKNOWN  | Unknown. |
4028| ARKUI_PRE_DRAG_STATUS_ACTION_DETECTING  | A drag gesture is being detected. |
4029| ARKUI_PRE_DRAG_STATUS_READY_TO_TRIGGER_DRAG  | The component is ready to be dragged. |
4030| ARKUI_PRE_DRAG_STATUS_PREVIEW_LIFT_STARTED  | A lift animation is started. |
4031| ARKUI_PRE_DRAG_STATUS_PREVIEW_LIFT_FINISHED  | A lift animation is finished. |
4032| ARKUI_PRE_DRAG_STATUS_PREVIEW_LANDING_STARTED  | A drop animation is started. |
4033| ARKUI_PRE_DRAG_STATUS_PREVIEW_LANDING_FINISHED  | A drop animation is finished. |
4034| ARKUI_PRE_DRAG_STATUS_CANCELED_BEFORE_DRAG  | A drop animation is terminated. |
4035
4036
4037### ArkUI_ProgressType
4038
4039```
4040enum ArkUI_ProgressType
4041```
4042**Description**
4043
4044Enumerates the styles of the progress indicator.
4045
4046**Since**: 12
4047
4048| Enum| Description|
4049| -------- | -------- |
4050| ARKUI_PROGRESS_TYPE_LINEAR  | Linear type. |
4051| ARKUI_PROGRESS_TYPE_RING  | Indeterminate ring style. |
4052| ARKUI_PROGRESS_TYPE_ECLIPSE  | Eclipse style. |
4053| ARKUI_PROGRESS_TYPE_SCALE_RING  | Determinate ring style. |
4054| ARKUI_PROGRESS_TYPE_CAPSULE  | Capsule style. |
4055
4056
4057### ArkUI_RelativeLayoutChainStyle
4058
4059```
4060enum ArkUI_RelativeLayoutChainStyle
4061```
4062**Description**
4063
4064Enumerates the chain styles.
4065
4066**Since**: 12
4067
4068| Enum| Description|
4069| -------- | -------- |
4070| ARKUI_RELATIVE_LAYOUT_CHAIN_STYLE_SPREAD  | Child components are evenly distributed among constraint anchors. |
4071| ARKUI_RELATIVE_LAYOUT_CHAIN_STYLE_SPREAD_INSIDE  | All child components except the first and last ones are evenly distributed among constraint anchors. |
4072| ARKUI_RELATIVE_LAYOUT_CHAIN_STYLE_PACKED  | There is no gap between child components in the chain. |
4073
4074
4075### ArkUI_RenderFit
4076
4077```
4078enum ArkUI_RenderFit
4079```
4080
4081| Enum| Description|
4082| -------- | -------- |
4083| ARKUI_RENDER_FIT_CENTER  | The component's content stays at the final size and always aligned with the center of the component. |
4084| ARKUI_RENDER_FIT_TOP  | The component's content stays at the final size and always aligned with the top center of the component. |
4085| ARKUI_RENDER_FIT_BOTTOM  | The component's content stays at the final size and always aligned with the bottom center of the component. |
4086| ARKUI_RENDER_FIT_LEFT  | The component's content stays at the final size and always aligned with the left of the component. |
4087| ARKUI_RENDER_FIT_RIGHT  | The component's content stays at the final size and always aligned with the right of the component. |
4088| 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. |
4089| 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. |
4090| 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. |
4091| 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. |
4092| 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. |
4093| 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. |
4094| 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. |
4095| 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. |
4096| 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. |
4097| 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. |
4098| 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. |
4099
4100
4101### ArkUI_RouterPageState
4102
4103```
4104enum ArkUI_RouterPageState
4105```
4106**Description**
4107
4108Enumerates the states of a page during routing.
4109
4110**Since**: 12
4111
4112| Enum| Description|
4113| -------- | -------- |
4114| ARKUI_ROUTER_PAGE_STATE_ON_WILL_APPEAR  | The page is about to be displayed. |
4115| ARKUI_ROUTER_PAGE_STATE_ON_WILL_DISAPPEAR  | The page is about to be destroyed. |
4116| ARKUI_ROUTER_PAGE_STATE_ON_SHOW  | The page is displayed. |
4117| ARKUI_ROUTER_PAGE_STATE_ON_HIDE  | The page is hidden. |
4118| ARKUI_ROUTER_PAGE_STATE_ON_BACK_PRESS  | The back button is pressed for the page. |
4119
4120
4121### ArkUI_SafeAreaEdge
4122
4123```
4124enum ArkUI_SafeAreaEdge
4125```
4126**Description**
4127
4128Enumerates the edges for expanding the safe area.
4129
4130**Since**: 12
4131
4132| Enum| Description|
4133| -------- | -------- |
4134| ARKUI_SAFE_AREA_EDGE_TOP  | Top edge. |
4135| ARKUI_SAFE_AREA_EDGE_BOTTOM  | Bottom edge. |
4136| ARKUI_SAFE_AREA_EDGE_START  | Start edge. |
4137| ARKUI_SAFE_AREA_EDGE_END  | End edge. |
4138
4139
4140### ArkUI_SafeAreaType
4141
4142```
4143enum ArkUI_SafeAreaType
4144```
4145**Description**
4146
4147Enumerates the types of expanded safe areas.
4148
4149**Since**: 12
4150
4151| Enum| Description|
4152| -------- | -------- |
4153| ARKUI_SAFE_AREA_TYPE_SYSTEM  | Default non-safe area of the system, including the status bar and navigation bar. |
4154| ARKUI_SAFE_AREA_TYPE_CUTOUT  | Non-safe area of the device, for example, the notch area. |
4155| ARKUI_SAFE_AREA_TYPE_KEYBOARD  | Soft keyboard area. |
4156
4157
4158### ArkUI_ListItemGroupArea
4159
4160```
4161enum ArkUI_ListItemGroupArea
4162```
4163**Description**
4164
4165Enumerates the component areas.
4166
4167**Since**: 15
4168
4169| Enum| Description|
4170| -------- | -------- |
4171| ARKUI_LIST_ITEM_GROUP_AREA_OUTSIDE   | Outside the component area. |
4172| ARKUI_LIST_ITEM_SWIPE_AREA_NONE  | Area when the component has no header, footer, or list items. |
4173| ARKUI_LIST_ITEM_SWIPE_AREA_ITEM  | Area of the component's list items. |
4174| ARKUI_LIST_ITEM_SWIPE_AREA_HEADER  | Header area of the component. |
4175| ARKUI_LIST_ITEM_SWIPE_AREA_FOOTER  | Footer area of the component. |
4176
4177
4178### ArkUI_FocusMove
4179
4180```
4181enum ArkUI_FocusMove
4182```
4183**Description**
4184
4185Enumerates the focus movement directions.
4186
4187**Since**: 18
4188
4189| Enum| Description|
4190| -------- | -------- |
4191| ARKUI_FOCUS_MOVE_FORWARD  | Tab key. |
4192| ARKUI_FOCUS_MOVE_BACKWARD  | Shift+Tab key. |
4193| ARKUI_FOCUS_MOVE_UP  | Up arrow key. |
4194| ARKUI_FOCUS_MOVE_DOWN  | Down arrow key. |
4195| ARKUI_FOCUS_MOVE_LEFT  | Left arrow key. |
4196| ARKUI_FOCUS_MOVE_RIGHT  | Right arrow key. |
4197
4198### ArkUI_ScrollAlignment
4199
4200```
4201enum ArkUI_ScrollAlignment
4202```
4203**Description**
4204
4205Defines how the list item to scroll to is aligned with the container.
4206
4207**Since**: 12
4208
4209| Enum| Description|
4210| -------- | -------- |
4211| ARKUI_SCROLL_ALIGNMENT_START  | The start edge of the list item is flush with the start edge of the container. |
4212| ARKUI_SCROLL_ALIGNMENT_CENTER  | The list item is centered along the main axis of the list. |
4213| ARKUI_SCROLL_ALIGNMENT_END  | The end edge of the list item Aligns the tail of an item with that of a container. |
4214| 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. |
4215
4216
4217### ArkUI_ScrollBarDisplayMode
4218
4219```
4220enum ArkUI_ScrollBarDisplayMode
4221```
4222**Description**
4223
4224Enumerates the scrollbar display modes.
4225
4226**Since**: 12
4227
4228| Enum| Description|
4229| -------- | -------- |
4230| ARKUI_SCROLL_BAR_DISPLAY_MODE_OFF  | Not displayed. |
4231| ARKUI_SCROLL_BAR_DISPLAY_MODE_AUTO  | Displayed when the screen is touched and hidden after 2s. |
4232| ARKUI_SCROLL_BAR_DISPLAY_MODE_ON  | Always displayed. |
4233
4234
4235### ArkUI_ScrollDirection
4236
4237```
4238enum ArkUI_ScrollDirection
4239```
4240**Description**
4241
4242Enumerates the scroll directions of scrollable components.
4243
4244**Since**: 12
4245
4246| Enum| Description|
4247| -------- | -------- |
4248| ARKUI_SCROLL_DIRECTION_VERTICAL  | Only vertical scrolling is supported. |
4249| ARKUI_SCROLL_DIRECTION_HORIZONTAL  | Only horizontal scrolling is supported. |
4250| ARKUI_SCROLL_DIRECTION_NONE  | Scrolling is forbidden. |
4251
4252
4253### ArkUI_ScrollEdge
4254
4255```
4256enum ArkUI_ScrollEdge
4257```
4258**Description**
4259
4260Defines the edge to which the component scrolls.
4261
4262**Since**: 12
4263
4264| Enum| Description|
4265| -------- | -------- |
4266| ARKUI_SCROLL_EDGE_TOP  | Top edge in the vertical direction. |
4267| ARKUI_SCROLL_EDGE_BOTTOM  | Bottom edge in the vertical direction. |
4268| ARKUI_SCROLL_EDGE_START  | Start position in the horizontal direction. |
4269| ARKUI_SCROLL_EDGE_END  | End position in the horizontal direction. |
4270
4271
4272### ArkUI_ScrollNestedMode
4273
4274```
4275enum ArkUI_ScrollNestedMode
4276```
4277**Description**
4278
4279Enumerates nested scrolling options.
4280
4281**Since**: 12
4282
4283| Enum| Description|
4284| -------- | -------- |
4285| 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. |
4286| 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. |
4287| 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. |
4288| 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. |
4289
4290
4291### ArkUI_ScrollSnapAlign
4292
4293```
4294enum ArkUI_ScrollSnapAlign
4295```
4296**Description**
4297
4298Enumerates the alignment modes of list items when scrolling ends.
4299
4300**Since**: 12
4301
4302| Enum| Description|
4303| -------- | -------- |
4304| ARKUI_SCROLL_SNAP_ALIGN_NONE  | No alignment. This is the default value. |
4305| ARKUI_SCROLL_SNAP_ALIGN_START  | The first item in the view is aligned at the start of the list. |
4306| ARKUI_SCROLL_SNAP_ALIGN_CENTER  | The middle items in the view are aligned in the center of the list. |
4307| ARKUI_SCROLL_SNAP_ALIGN_END  | The last item in the view is aligned at the end of the list. |
4308
4309
4310### ArkUI_ScrollSource
4311
4312```
4313enum ArkUI_ScrollSource
4314```
4315**Description**
4316
4317Enumerates the scrolling sources.
4318
4319**Since**: 12
4320
4321| Enum| Description|
4322| -------- | -------- |
4323| ARKUI_SCROLL_SOURCE_DRAG  | Drag your finger. |
4324| ARKUI_SCROLL_SOURCE_FLING  | Inertia scrolling after finger dragging. |
4325| ARKUI_SCROLL_SOURCE_EDGE_EFFECT  | Executes the EdgeEffect.Spring edge special effect when the boundary is crossed. |
4326| ARKUI_SCROLL_SOURCE_OTHER_USER_INPUT  | User input other than dragging, such as mouse wheel and keyboard events. |
4327| ARKUI_SCROLL_SOURCE_SCROLL_BAR  | Scrollbar dragging |
4328| ARKUI_SCROLL_SOURCE_SCROLL_BAR_FLING  | Inertial scrolling after the scroll bar is dragged. |
4329| ARKUI_SCROLL_SOURCE_SCROLLER  | Scrolling by the scroll controller (without animation). |
4330| ARKUI_SCROLL_SOURCE_ANIMATION  | Scrolling by the scroll controller (with animation). |
4331
4332
4333### ArkUI_ScrollState
4334
4335```
4336enum ArkUI_ScrollState
4337```
4338**Description**
4339
4340Enumerates the scrolling states.
4341
4342**Since**: 12
4343
4344| Enum| Description|
4345| -------- | -------- |
4346| 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. |
4347| ARKUI_SCROLL_STATE_SCROLL  | Scrolling. The container enters this state when the user drags the container to scroll. |
4348| 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. |
4349
4350
4351### ArkUI_ShadowStyle
4352
4353```
4354enum ArkUI_ShadowStyle
4355```
4356**Description**
4357
4358Enumerated value of the shadow effect.
4359
4360**Since**: 12
4361
4362| Enum| Description|
4363| -------- | -------- |
4364| ARKUI_SHADOW_STYLE_OUTER_DEFAULT_XS  | Mini shadow. |
4365| ARKUI_SHADOW_STYLE_OUTER_DEFAULT_SM  | Small shadow. |
4366| ARKUI_SHADOW_STYLE_OUTER_DEFAULT_MD  | Medium shadow. |
4367| ARKUI_SHADOW_STYLE_OUTER_DEFAULT_LG  | Large shadow. |
4368| ARKUI_SHADOW_STYLE_OUTER_FLOATING_SM  | Floating small shadow. |
4369| ARKUI_SHADOW_STYLE_OUTER_FLOATING_MD  | Floating medium shadow. |
4370
4371
4372### ArkUI_ShadowType
4373
4374```
4375enum ArkUI_ShadowType
4376```
4377**Description**
4378
4379Defines the enumerated values of the shadow type.
4380
4381**Since**: 12
4382
4383| Enum| Description|
4384| -------- | -------- |
4385| ARKUI_SHADOW_TYPE_COLOR  | Color. |
4386| ARKUI_SHADOW_TYPE_BLUR  | Blur. |
4387
4388### ArkUI_ShapeType
4389
4390```
4391enum ArkUI_ShapeType
4392```
4393**Description**
4394
4395Enumerates custom shape types.
4396
4397**Since**: 12
4398
4399| Enum| Description|
4400| -------- | -------- |
4401| ARKUI_SHAPE_TYPE_RECTANGLE  | Rectangle. |
4402| ARKUI_SHAPE_TYPE_CIRCLE  | **(circle)** |
4403| ARKUI_SHAPE_TYPE_ELLIPSE  | Ellipse. |
4404| ARKUI_SHAPE_TYPE_PATH  | Path Type |
4405
4406
4407### ArkUI_SliderBlockStyle
4408
4409```
4410enum ArkUI_SliderBlockStyle
4411```
4412**Description**
4413
4414Enumerates the styles of the slider in the block direction.
4415
4416**Since**: 12
4417
4418| Enum| Description|
4419| -------- | -------- |
4420| ARKUI_SLIDER_BLOCK_STYLE_DEFAULT  | Round slider. |
4421| ARKUI_SLIDER_BLOCK_STYLE_IMAGE  | Slider with an image background. |
4422| ARKUI_SLIDER_BLOCK_STYLE_SHAPE  | Slider in a custom shape. |
4423
4424
4425### ArkUI_SliderDirection
4426
4427```
4428enum ArkUI_SliderDirection
4429```
4430**Description**
4431
4432Enumerates the scroll directions of the slider.
4433
4434**Since**: 12
4435
4436| Enum| Description|
4437| -------- | -------- |
4438| ARKUI_SLIDER_DIRECTION_VERTICAL  | Vertical direction. |
4439| ARKUI_SLIDER_DIRECTION_HORIZONTAL  | Horizontal direction. |
4440
4441
4442### ArkUI_SliderStyle
4443
4444```
4445enum ArkUI_SliderStyle
4446```
4447**Description**
4448
4449Enumerates the slider styles.
4450
4451**Since**: 12
4452
4453| Enum| Description|
4454| -------- | -------- |
4455| ARKUI_SLIDER_STYLE_OUT_SET  | The slider is on the slider rail. |
4456| ARKUI_SLIDER_STYLE_IN_SET  | The slider is in the slider rail. |
4457| ARKUI_SLIDER_STYLE_NONE  | There is no thumb. |
4458
4459
4460### ArkUI_StickyStyle
4461
4462```
4463enum ArkUI_StickyStyle
4464```
4465**Description**
4466
4467Enumerates the modes for pinning the header to the top or the footer to the bottom.
4468
4469**Since**: 12
4470
4471| Enum| Description|
4472| -------- | -------- |
4473| 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. |
4474| 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. |
4475| 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. |
4476| ARKUI_STICKY_STYLE_BOTH  | In the list item group, the footer is pinned to the bottom, and the header is pinned to the top. |
4477
4478
4479### ArkUI_SwiperArrow
4480
4481```
4482enum ArkUI_SwiperArrow
4483```
4484**Description**
4485
4486Enumerates arrow styles of the navigation indicator.
4487
4488**Since**: 12
4489
4490| Enum| Description|
4491| -------- | -------- |
4492| ARKUI_SWIPER_ARROW_HIDE  | The arrow is not displayed for the navigation indicator. |
4493| ARKUI_SWIPER_ARROW_SHOW  | The arrow is displayed for the navigation indicator. |
4494| ARKUI_SWIPER_ARROW_SHOW_ON_HOVER  | The arrow is displayed only when the mouse pointer hovers over the navigation indicator. |
4495
4496
4497### ArkUI_SwiperDisplayModeType
4498
4499```
4500enum ArkUI_SwiperDisplayModeType
4501```
4502**Description**
4503
4504Enumerates the modes in which elements are displayed along the main axis of the **Swiper** component.
4505
4506**Since**: 12
4507
4508| Enum| Description|
4509| -------- | -------- |
4510| ARKUI_SWIPER_DISPLAY_MODE_STRETCH  | The slide width of the **Swiper** component is equal to the width of the component. |
4511| 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. |
4512
4513
4514### ArkUI_SwiperIndicatorType
4515
4516```
4517enum ArkUI_SwiperIndicatorType
4518```
4519**Description**
4520
4521Enumerates the navigation indicator types of the **Swiper** component.
4522
4523**Since**: 12
4524
4525| Enum| Description|
4526| -------- | -------- |
4527| ARKUI_SWIPER_INDICATOR_TYPE_DOT  | Dot type. |
4528| ARKUI_SWIPER_INDICATOR_TYPE_DIGIT  | Digit type. |
4529
4530
4531### ArkUI_SwiperNestedScrollMode
4532
4533```
4534enum ArkUI_SwiperNestedScrollMode
4535```
4536**Description**
4537
4538Enumerates the nested scrolling mode of the **Swiper** component and its parent container.
4539
4540**Since**: 12
4541
4542| Enum| Description|
4543| -------- | -------- |
4544| 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. |
4545| 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. |
4546
4547
4548### ArkUI_SystemColorMode
4549
4550```
4551enum ArkUI_SystemColorMode
4552```
4553**Description**
4554
4555Enumerates the system color modes.
4556
4557**Since**: 12
4558
4559| Enum| Description|
4560| -------- | -------- |
4561| ARKUI_SYSTEM_COLOR_MODE_LIGHT  | Light mode. |
4562| ARKUI_SYSTEM_COLOR_MODE_DARK  | Dark mode. |
4563
4564
4565### ArkUI_TextAlignment
4566
4567```
4568enum ArkUI_TextAlignment
4569```
4570**Description**
4571
4572Enumerates the text alignment mode.
4573
4574**Since**: 12
4575
4576| Enum| Description|
4577| -------- | -------- |
4578| ARKUI_TEXT_ALIGNMENT_START  | Aligned with the start. |
4579| ARKUI_TEXT_ALIGNMENT_CENTER  | Horizontally centered. |
4580| ARKUI_TEXT_ALIGNMENT_END  | Aligned with the end. |
4581| ARKUI_TEXT_ALIGNMENT_JUSTIFY  | Aligned with both margins. |
4582
4583
4584### ArkUI_TextAreaType
4585
4586```
4587enum ArkUI_TextAreaType
4588```
4589**Description**
4590
4591Enumerates the text box types.
4592
4593**Since**: 12
4594
4595| Enum| Description|
4596| -------- | -------- |
4597| ARKUI_TEXTAREA_TYPE_NORMAL  | Normal input mode. |
4598| ARKUI_TEXTAREA_TYPE_NUMBER  | Number input mode. |
4599| ARKUI_TEXTAREA_TYPE_PHONE_NUMBER  | Phone number input mode. |
4600| ARKUI_TEXTAREA_TYPE_EMAIL  | Email address input mode. |
4601
4602
4603### ArkUI_TextCase
4604
4605```
4606enum ArkUI_TextCase
4607```
4608**Description**
4609
4610Defines the enumerated values of text case.
4611
4612**Since**: 12
4613
4614| Enum| Description|
4615| -------- | -------- |
4616| ARKUI_TEXT_CASE_NORMAL  | The original case of the text is retained. |
4617| ARKUI_TEXT_CASE_LOWER  | All letters in the text are in lowercase. |
4618| ARKUI_TEXT_CASE_UPPER  | All letters in the text are in uppercase. |
4619
4620
4621### ArkUI_TextCopyOptions
4622
4623```
4624enum ArkUI_TextCopyOptions
4625```
4626**Description**
4627
4628Enumerates copy options, which define whether copy and paste is allowed for text content.
4629
4630**Since**: 12
4631
4632| Enum| Description|
4633| -------- | -------- |
4634| ARKUI_TEXT_COPY_OPTIONS_NONE  | Copy is not allowed. |
4635| ARKUI_TEXT_COPY_OPTIONS_IN_APP  | Intra-application copy is allowed. |
4636| ARKUI_TEXT_COPY_OPTIONS_LOCAL_DEVICE  | Intra-device copy is allowed. |
4637| ARKUI_TEXT_COPY_OPTIONS_CROSS_DEVICE  | Cross-device copy is allowed. |
4638
4639
4640### ArkUI_TextDataDetectorType
4641
4642```
4643enum ArkUI_TextDataDetectorType
4644```
4645**Description**
4646
4647Enumerates the entity types of text recognition.
4648
4649**Since**: 12
4650
4651| Enum| Description|
4652| -------- | -------- |
4653| ARKUI_TEXT_DATA_DETECTOR_TYPE_PHONE_NUMBER  | Phone number. |
4654| ARKUI_TEXT_DATA_DETECTOR_TYPE_URL  | Link. |
4655| ARKUI_TEXT_DATA_DETECTOR_TYPE_EMAIL  | Email  |
4656| ARKUI_TEXT_DATA_DETECTOR_TYPE_ADDRESS  | Network address. |
4657
4658
4659### ArkUI_TextDecorationStyle
4660
4661```
4662enum ArkUI_TextDecorationStyle
4663```
4664**Description**
4665
4666Enumerates the text decoration styles.
4667
4668**Since**: 12
4669
4670| Enum| Description|
4671| -------- | -------- |
4672| ARKUI_TEXT_DECORATION_STYLE_SOLID  | Single solid line. |
4673| ARKUI_TEXT_DECORATION_STYLE_DOUBLE  | Double solid line. |
4674| ARKUI_TEXT_DECORATION_STYLE_DOTTED  | Dotted line. |
4675| ARKUI_TEXT_DECORATION_STYLE_DASHED  | Dashed style. |
4676| ARKUI_TEXT_DECORATION_STYLE_WAVY  | Wavy line. |
4677
4678
4679### ArkUI_TextDecorationType
4680
4681```
4682enum ArkUI_TextDecorationType
4683```
4684**Description**
4685
4686Enumerates the text decoration types.
4687
4688**Since**: 12
4689
4690| Enum| Description|
4691| -------- | -------- |
4692| ARKUI_TEXT_DECORATION_TYPE_NONE  | No text decoration. |
4693| ARKUI_TEXT_DECORATION_TYPE_UNDERLINE  | Line under the text. |
4694| ARKUI_TEXT_DECORATION_TYPE_OVERLINE  | Line over the text. |
4695| ARKUI_TEXT_DECORATION_TYPE_LINE_THROUGH  | Line through the text. |
4696
4697
4698### ArkUI_TextHeightAdaptivePolicy
4699
4700```
4701enum ArkUI_TextHeightAdaptivePolicy
4702```
4703**Description**
4704
4705Defines how the adaptive height is determined for the text.
4706
4707**Since**: 12
4708
4709| Enum| Description|
4710| -------- | -------- |
4711| ARKUI_TEXT_HEIGHT_ADAPTIVE_POLICY_MAX_LINES_FIRST  | Prioritize the **maxLines** settings. |
4712| ARKUI_TEXT_HEIGHT_ADAPTIVE_POLICY_MIN_FONT_SIZE_FIRST  | Prioritize the **minFontSize** settings. |
4713| ARKUI_TEXT_HEIGHT_ADAPTIVE_POLICY_LAYOUT_CONSTRAINT_FIRST  | Prioritize the layout constraint settings in terms of height. |
4714
4715
4716### ArkUI_TextInputContentType
4717
4718```
4719enum ArkUI_TextInputContentType
4720```
4721**Description**
4722
4723Enumerates the autofill types.
4724
4725**Since**: 12
4726
4727| Enum| Description|
4728| -------- | -------- |
4729| ARKUI_TEXTINPUT_CONTENT_TYPE_USER_NAME  | Username. Password Vault, when enabled, can automatically save and fill in usernames. |
4730| ARKUI_TEXTINPUT_CONTENT_TYPE_PASSWORD  | Password. Password Vault, when enabled, can automatically save and fill in passwords. |
4731| ARKUI_TEXTINPUT_CONTENT_TYPE_NEW_PASSWORD  | New password. Password Vault, when enabled, can automatically generate a new password. |
4732| 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. |
4733| ARKUI_TEXTINPUT_CONTENT_TYPE_HOUSE_NUMBER  | House number. The scenario-based autofill feature, when enabled, can automatically save and fill in house numbers. |
4734| 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. |
4735| ARKUI_TEXTINPUT_CONTENT_TYPE_CITY_ADDRESS  | City. The scenario-based autofill feature, when enabled, can automatically save and fill in cities. |
4736| ARKUI_TEXTINPUT_CONTENT_TYPE_PROVINCE_ADDRESS  | Province. The scenario-based autofill feature, when enabled, can automatically save and fill in provinces. |
4737| ARKUI_TEXTINPUT_CONTENT_TYPE_COUNTRY_ADDRESS  | Country. The scenario-based autofill feature, when enabled, can automatically save and fill in countries. |
4738| ARKUI_TEXTINPUT_CONTENT_TYPE_PERSON_FULL_NAME  | Full name. The scenario-based autofill feature, when enabled, can automatically save and fill in full names. |
4739| ARKUI_TEXTINPUT_CONTENT_TYPE_PERSON_LAST_NAME  | Last name. The scenario-based autofill feature, when enabled, can automatically save and fill in last names. |
4740| ARKUI_TEXTINPUT_CONTENT_TYPE_PERSON_FIRST_NAME  | First name. The scenario-based autofill feature, when enabled, can automatically save and fill in first names. |
4741| ARKUI_TEXTINPUT_CONTENT_TYPE_PHONE_NUMBER  | Phone number. The scenario-based autofill feature, when enabled, can automatically save and fill in phone numbers. |
4742| ARKUI_TEXTINPUT_CONTENT_TYPE_PHONE_COUNTRY_CODE  | Country code. The scenario-based autofill feature, when enabled, can automatically save and fill in country codes. |
4743| 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. |
4744| ARKUI_TEXTINPUT_CONTENT_EMAIL_ADDRESS  | Email address. The scenario-based autofill feature, when enabled, can automatically save and fill in email addresses. |
4745| 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. |
4746| 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. |
4747| ARKUI_TEXTINPUT_CONTENT_TYPE_NICKNAME  | Nickname. The scenario-based autofill feature, when enabled, can automatically save and fill in nicknames. |
4748| 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. |
4749| ARKUI_TEXTINPUT_CONTENT_TYPE_FORMAT_ADDRESS  | Standard address. The scenario-based autofill feature, when enabled, can automatically save and fill in standard addresses. |
4750| ARKUI_TEXTINPUT_CONTENT_TYPE_PASSPORT_NUMBER  | Passport number. The scenario-based autofill feature, when enabled, can automatically save and fill in passport numbers. |
4751| ARKUI_TEXTINPUT_CONTENT_TYPE_VALIDITY  | Passport validity period. The scenario-based autofill feature, when enabled, can automatically save and fill in passport validity periods. |
4752| ARKUI_TEXTINPUT_CONTENT_TYPE_ISSUE_AT  | Passport place of issue. The scenario-based autofill feature, when enabled, can automatically save and fill in the place of issue for passports. |
4753| ARKUI_TEXTINPUT_CONTENT_TYPE_ORGANIZATION  | Invoice title. The scenario-based autofill feature, when enabled, can automatically save and fill in invoice titles. |
4754| ARKUI_TEXTINPUT_CONTENT_TYPE_TAX_ID  | Tax ID. The scenario-based autofill feature, when enabled, can automatically save and fill in tax IDs. |
4755| ARKUI_TEXTINPUT_CONTENT_TYPE_ADDRESS_CITY_AND_STATE  | Location. The scenario-based autofill feature, when enabled, can automatically save and fill in locations. |
4756| ARKUI_TEXTINPUT_CONTENT_TYPE_FLIGHT_NUMBER  | Flight number. Currently not supported for automatic saving and auto-filling. |
4757| ARKUI_TEXTINPUT_CONTENT_TYPE_LICENSE_NUMBER  | Driver's license number. Currently not supported for automatic saving and auto-filling. |
4758| ARKUI_TEXTINPUT_CONTENT_TYPE_LICENSE_FILE_NUMBER  | Driver's license file number. Currently not supported for automatic saving and auto-filling.|
4759| ARKUI_TEXTINPUT_CONTENT_TYPE_LICENSE_PLATE  | License plate number. The scenario-based autofill feature, when enabled, can automatically save and fill in license plate numbers. |
4760| ARKUI_TEXTINPUT_CONTENT_TYPE_ENGINE_NUMBER  | Vehicle registration engine number. Currently not supported for automatic saving and auto-filling. |
4761| ARKUI_TEXTINPUT_CONTENT_TYPE_LICENSE_CHASSIS_NUMBER  | Chassis number. Currently not supported for automatic saving and auto-filling. |
4762
4763
4764### ArkUI_TextInputStyle
4765
4766```
4767enum ArkUI_TextInputStyle
4768```
4769**Description**
4770
4771Enumerates the text input styles.
4772
4773**Since**: 12
4774
4775| Enum| Description|
4776| -------- | -------- |
4777| 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. |
4778| ARKUI_TEXTINPUT_STYLE_INLINE  | Inline input style. The background height of the selected text is the same as the height of the text box. |
4779
4780
4781### ArkUI_TextInputType
4782
4783```
4784enum ArkUI_TextInputType
4785```
4786**Description**
4787
4788Enumerates the text input types.
4789
4790**Since**: 12
4791
4792| Enum| Description|
4793| -------- | -------- |
4794| ARKUI_TEXTINPUT_TYPE_NORMAL  | Normal input mode. |
4795| ARKUI_TEXTINPUT_TYPE_NUMBER  | Number input mode. |
4796| ARKUI_TEXTINPUT_TYPE_PHONE_NUMBER  | Phone number input mode. |
4797| ARKUI_TEXTINPUT_TYPE_EMAIL  | Email address input mode. |
4798| ARKUI_TEXTINPUT_TYPE_PASSWORD  | Password input mode. |
4799| ARKUI_TEXTINPUT_TYPE_NUMBER_PASSWORD  | Numeric password input mode. |
4800| ARKUI_TEXTINPUT_TYPE_SCREEN_LOCK_PASSWORD  | Lock screen password input mode. |
4801| ARKUI_TEXTINPUT_TYPE_USER_NAME  | Username input mode. |
4802| ARKUI_TEXTINPUT_TYPE_NEW_PASSWORD  | New password input mode. |
4803| ARKUI_TEXTINPUT_TYPE_NUMBER_DECIMAL  | Number input mode with a decimal point. |
4804
4805
4806### ArkUI_TextOverflow
4807
4808```
4809enum ArkUI_TextOverflow
4810```
4811**Description**
4812
4813Enumerates the display modes when the text is too long.
4814
4815**Since**: 12
4816
4817| Enum| Description|
4818| -------- | -------- |
4819| ARKUI_TEXT_OVERFLOW_NONE  | Extra-long text is not clipped. |
4820| ARKUI_TEXT_OVERFLOW_CLIP  | Extra-long text is clipped. |
4821| ARKUI_TEXT_OVERFLOW_ELLIPSIS  | An ellipsis (...) is used to represent text overflow. |
4822| ARKUI_TEXT_OVERFLOW_MARQUEE  | Text continuously scrolls when text overflow occurs. |
4823
4824
4825### ArkUI_TextPickerRangeType
4826
4827```
4828enum ArkUI_TextPickerRangeType
4829```
4830**Description**
4831
4832Enumerates the types of the text picker.
4833
4834**Since**: 12
4835
4836| Enum| Description|
4837| -------- | -------- |
4838| ARKUI_TEXTPICKER_RANGETYPE_SINGLE  | Single-column text picker. |
4839| ARKUI_TEXTPICKER_RANGETYPE_MULTI  | Multi-column text picker. |
4840| ARKUI_TEXTPICKER_RANGETYPE_RANGE_CONTENT  | Single-column text picker with image resources. |
4841| ARKUI_TEXTPICKER_RANGETYPE_CASCADE_RANGE_CONTENT  | Interconnected multi-column text picker. |
4842
4843
4844### ArkUI_ThemeColorMode
4845
4846```
4847enum ArkUI_ThemeColorMode
4848```
4849
4850| Enum| Description|
4851| -------- | -------- |
4852| ARKUI_THEME_COLOR_MODE_SYSTEM  | Following the system color mode. |
4853| ARKUI_THEME_COLOR_MODE_LIGHT  | Light color mode. |
4854| ARKUI_THEME_COLOR_MODE_DARK  | Dark color mode. |
4855
4856
4857### ArkUI_TransitionEdge
4858
4859```
4860enum ArkUI_TransitionEdge
4861```
4862**Description**
4863
4864Enumerates the slide-in and slide-out positions of the component from the screen edge during transition.
4865
4866**Since**: 12
4867
4868| Enum| Description|
4869| -------- | -------- |
4870| ARKUI_TRANSITION_EDGE_TOP  | Top edge of the window. |
4871| ARKUI_TRANSITION_EDGE_BOTTOM  | Bottom edge of the window. |
4872| ARKUI_TRANSITION_EDGE_START  | Left edge of the window. |
4873| ARKUI_TRANSITION_EDGE_END  | Right edge of the window. |
4874
4875
4876### ArkUI_VerticalAlignment
4877
4878```
4879enum ArkUI_VerticalAlignment
4880```
4881**Description**
4882
4883Enumerates the vertical alignment modes.
4884
4885**Since**: 12
4886
4887| Enum| Description|
4888| -------- | -------- |
4889| ARKUI_VERTICAL_ALIGNMENT_TOP  | Top aligned. |
4890| ARKUI_VERTICAL_ALIGNMENT_CENTER  | Aligned with the center. This is the default alignment mode. |
4891| ARKUI_VERTICAL_ALIGNMENT_BOTTOM  | Bottom aligned. |
4892
4893
4894### ArkUI_Visibility
4895
4896```
4897enum ArkUI_Visibility
4898```
4899**Description**
4900
4901Enumerates the visibility values.
4902
4903**Since**: 12
4904
4905| Enum| Description|
4906| -------- | -------- |
4907| ARKUI_VISIBILITY_VISIBLE  | Display |
4908| ARKUI_VISIBILITY_HIDDEN  | The component is hidden, and a placeholder is used for it in the layout. |
4909| ARKUI_VISIBILITY_NONE  | The component is hidden. It is not involved in the layout, and no placeholder is used for it. |
4910
4911
4912### ArkUI_WordBreak
4913
4914```
4915enum ArkUI_WordBreak
4916```
4917**Description**
4918
4919Enumerates the word break rules.
4920
4921**Since**: 12
4922
4923| Enum| Description|
4924| -------- | -------- |
4925| 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). |
4926| 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**. |
4927| 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**. |
4928| ARKUI_WORD_BREAK_HYPHENATION  | **Since**: 16 Line breaks can occur between any two syllabic units for non-CJK text. CJK text behavior is the same as for **NORMAL**. |
4929
4930
4931### ArkUI_XComponentType
4932
4933```
4934enum ArkUI_XComponentType
4935```
4936**Description**
4937
4938Defines the enumerated values of the XComponent type.
4939
4940**Since**: 12
4941
4942| Enum| Description|
4943| -------- | -------- |
4944| ARKUI_XCOMPONENT_TYPE_SURFACE  | The custom content of EGL/OpenGL ES and media data is displayed individually on the screen. |
4945| ARKUI_XCOMPONENT_TYPE_TEXTURE  | The custom content of EGL/OpenGL ES and media data is grouped and displayed together with content of the component. |
4946
4947### ArkUI_KeyboardAppearance
4948
4949```
4950enum ArkUI_KeyboardAppearance
4951```
4952**Description**
4953
4954Enumerates the appearance modes of the keyboard when the text box is focused.
4955
4956**Since**: 15
4957
4958| Enum| Description|
4959| -------- | -------- |
4960| ARKUI_KEYBOARD_APPEARANCE_NONE_IMMERSIVE   | Default appearance mode, not using the immersive style. |
4961| ARKUI_KEYBOARD_APPEARANCE_IMMERSIVE   | Immersive style, following the system color mode. |
4962| ARKUI_KEYBOARD_APPEARANCE_LIGHT_IMMERSIVE   | Immersive style in light mode. |
4963| ARKUI_KEYBOARD_APPEARANCE_DARK_IMMERSIVE   | Immersive style in dark mode. |
4964
4965### ArkUI_KeyboardAvoidMode
4966
4967```
4968enum ArkUI_KeyboardAvoidMode
4969```
4970**Description**
4971
4972Enumerates the keyboard avoidance modes of the dialog box.
4973
4974**Since**: 15
4975
4976| Enum| Description|
4977| -------- | -------- |
4978| ARKUI_KEYBOARD_AVOID_MODE_DEFAULT   | Automatically avoids the soft keyboard and compresses the height when reaching the maximum limit. |
4979| ARKUI_KEYBOARD_AVOID_MODE_NONE   | Does not avoid the soft keyboard. |
4980
4981### ArkUI_HoverModeAreaType
4982
4983```
4984enum ArkUI_HoverModeAreaType
4985```
4986**Description**
4987
4988Enumerates the default display areas of a dialog box in hover mode.
4989
4990**Since**: 15
4991
4992| Enum| Description|
4993| -------- | -------- |
4994| ARKUI_HOVER_MODE_AREA_TYPE_TOP   | Upper half screen. |
4995| ARKUI_HOVER_MODE_AREA_TYPE_BOTTOM   | Lower half screen. |
4996
4997
4998## Function Description
4999
5000
5001### OH_ArkUI_AccessibilityState_Create()
5002
5003```
5004ArkUI_AccessibilityState* OH_ArkUI_AccessibilityState_Create (void )
5005```
5006**Description**
5007
5008Creates an accessibility state.
5009
5010**Since**: 12
5011
5012**Returns**
5013
5014Returns 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.
5015
5016
5017### OH_ArkUI_AccessibilityState_Dispose()
5018
5019```
5020void OH_ArkUI_AccessibilityState_Dispose (ArkUI_AccessibilityState * state)
5021```
5022**Description**
5023
5024Disposes of the pointer to an accessibility state.
5025
5026**Since**: 12
5027
5028**Parameters**
5029
5030| Name| Description|
5031| -------- | -------- |
5032| state | Pointer to an accessibility state object. |
5033
5034
5035### OH_ArkUI_AccessibilityState_GetCheckedState()
5036
5037```
5038int32_t OH_ArkUI_AccessibilityState_GetCheckedState (ArkUI_AccessibilityState * state)
5039```
5040**Description**
5041
5042Obtains the check box state of an accessibility state.
5043
5044**Since**: 12
5045
5046**Parameters**
5047
5048| Name| Description|
5049| -------- | -------- |
5050| state | Pointer to an accessibility state object. |
5051
5052**Returns**
5053
5054Returns 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.
5055
5056
5057### OH_ArkUI_AccessibilityState_IsDisabled()
5058
5059```
5060int32_t OH_ArkUI_AccessibilityState_IsDisabled (ArkUI_AccessibilityState * state)
5061```
5062**Description**
5063
5064Obtains whether an accessibility state is disabled.
5065
5066**Since**: 12
5067
5068**Parameters**
5069
5070| Name| Description|
5071| -------- | -------- |
5072| state | Pointer to an accessibility state object. |
5073
5074**Returns**
5075
5076Returns 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.
5077
5078
5079### OH_ArkUI_AccessibilityState_IsSelected()
5080
5081```
5082int32_t OH_ArkUI_AccessibilityState_IsSelected (ArkUI_AccessibilityState * state)
5083```
5084**Description**
5085
5086Obtains whether an accessibility state is selected.
5087
5088**Since**: 12
5089
5090**Parameters**
5091
5092| Name| Description|
5093| -------- | -------- |
5094| state | Pointer to an accessibility state object. |
5095
5096**Returns**
5097
5098Returns 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.
5099
5100
5101### OH_ArkUI_AccessibilityState_SetCheckedState()
5102
5103```
5104void OH_ArkUI_AccessibilityState_SetCheckedState (ArkUI_AccessibilityState * state, int32_t checkedState )
5105```
5106**Description**
5107
5108Sets the check box state of an accessibility state.
5109
5110**Since**: 12
5111
5112**Parameters**
5113
5114| Name| Description|
5115| -------- | -------- |
5116| state | Pointer to an accessibility state object. |
5117| checkedState | Check box status. The parameter type is [ArkUI_AccessibilityCheckedState](#arkui_accessibilitycheckedstate). The default value is **ARKUI_ACCESSIBILITY_UNCHECKED**. |
5118
5119
5120### OH_ArkUI_AccessibilityState_SetDisabled()
5121
5122```
5123void OH_ArkUI_AccessibilityState_SetDisabled (ArkUI_AccessibilityState * state, int32_t isDisabled )
5124```
5125**Description**
5126
5127Sets whether an accessibility state is disabled.
5128
5129**Since**: 12
5130
5131**Parameters**
5132
5133| Name| Description|
5134| -------- | -------- |
5135| state | Pointer to an accessibility state object. |
5136| 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**. |
5137
5138
5139### OH_ArkUI_AccessibilityState_SetSelected()
5140
5141```
5142void OH_ArkUI_AccessibilityState_SetSelected (ArkUI_AccessibilityState * state, int32_t isSelected )
5143```
5144**Description**
5145
5146Sets whether an accessibility state is selected.
5147
5148**Since**: 12
5149
5150**Parameters**
5151
5152| Name| Description|
5153| -------- | -------- |
5154| state | Pointer to an accessibility state object. |
5155| 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**. |
5156
5157
5158### OH_ArkUI_AccessibilityValue_Create()
5159
5160```
5161ArkUI_AccessibilityValue* OH_ArkUI_AccessibilityValue_Create (void )
5162```
5163**Description**
5164
5165Creates an **AccessibilityValue** instance.
5166
5167**Since**: 12
5168
5169**Returns**
5170
5171Returns the pointer to the created **AccessibilityValue** instance.
5172
5173
5174### OH_ArkUI_AccessibilityValue_Dispose()
5175
5176```
5177void OH_ArkUI_AccessibilityValue_Dispose (ArkUI_AccessibilityValue * value)
5178```
5179**Description**
5180
5181Disposes of the pointer to an **AccessibilityValue** instance.
5182
5183**Since**: 12
5184
5185**Parameters**
5186
5187| Name| Description|
5188| -------- | -------- |
5189| state | Pointer to an **AccessibilityValue** instance. |
5190
5191
5192### OH_ArkUI_AccessibilityValue_GetCurrent()
5193
5194```
5195int32_t OH_ArkUI_AccessibilityValue_GetCurrent (ArkUI_AccessibilityValue * value)
5196```
5197**Description**
5198
5199Obtains the current accessibility value.
5200
5201**Since**: 12
5202
5203**Parameters**
5204
5205| Name| Description|
5206| -------- | -------- |
5207| value | Pointer to an **AccessibilityValue** instance. |
5208
5209**Returns**
5210
5211Returns the current value based on the range component. The default value is **-1**. If a parameter error occurs, **-1** is returned.
5212
5213
5214### OH_ArkUI_AccessibilityValue_GetMax()
5215
5216```
5217int32_t OH_ArkUI_AccessibilityValue_GetMax (ArkUI_AccessibilityValue * value)
5218```
5219**Description**
5220
5221Obtains the maximum accessibility value.
5222
5223**Since**: 12
5224
5225**Parameters**
5226
5227| Name| Description|
5228| -------- | -------- |
5229| value | Pointer to an **AccessibilityValue** instance. |
5230
5231**Returns**
5232
5233Returns the maximum value based on the range component. The default value is **-1**. If a parameter error occurs, **-1** is returned.
5234
5235
5236### OH_ArkUI_AccessibilityValue_GetMin()
5237
5238```
5239int32_t OH_ArkUI_AccessibilityValue_GetMin (ArkUI_AccessibilityValue * value)
5240```
5241**Description**
5242
5243Obtains the minimum accessibility value.
5244
5245**Since**: 12
5246
5247**Parameters**
5248
5249| Name| Description|
5250| -------- | -------- |
5251| value | Pointer to an **AccessibilityValue** instance. |
5252
5253**Returns**
5254
5255Returns the minimum value based on the range component. The default value is **-1**. If a parameter error occurs, **-1** is returned.
5256
5257
5258### OH_ArkUI_AccessibilityValue_GetText()
5259
5260```
5261const char* OH_ArkUI_AccessibilityValue_GetText (ArkUI_AccessibilityValue * value)
5262```
5263**Description**
5264
5265Obtains the text description of an **AccessibilityValue** instance.
5266
5267**Since**: 12
5268
5269**Parameters**
5270
5271| Name| Description|
5272| -------- | -------- |
5273| value | Pointer to an **AccessibilityValue** instance. |
5274
5275**Returns**
5276
5277Returns the text description. The default value is an empty string. If a parameter error occurs, a null pointer is returned.
5278
5279
5280### OH_ArkUI_AccessibilityValue_SetCurrent()
5281
5282```
5283void OH_ArkUI_AccessibilityValue_SetCurrent (ArkUI_AccessibilityValue * value, int32_t current )
5284```
5285**Description**
5286
5287Sets the current accessibility value.
5288
5289**Since**: 12
5290
5291**Parameters**
5292
5293| Name| Description|
5294| -------- | -------- |
5295| value | Pointer to an **AccessibilityValue** instance. |
5296| current | Current value based on the range component. The default value is **-1**. |
5297
5298
5299### OH_ArkUI_AccessibilityValue_SetMax()
5300
5301```
5302void OH_ArkUI_AccessibilityValue_SetMax (ArkUI_AccessibilityValue * value, int32_t max )
5303```
5304**Description**
5305
5306Sets the maximum accessibility value.
5307
5308**Since**: 12
5309
5310**Parameters**
5311
5312| Name| Description|
5313| -------- | -------- |
5314| value | Pointer to an **AccessibilityValue** instance. |
5315| max | Maximum value based on the range component. The default value is **-1**. |
5316
5317
5318### OH_ArkUI_AccessibilityValue_SetMin()
5319
5320```
5321void OH_ArkUI_AccessibilityValue_SetMin (ArkUI_AccessibilityValue * value, int32_t min )
5322```
5323**Description**
5324
5325Sets the minimum accessibility value.
5326
5327**Since**: 12
5328
5329**Parameters**
5330
5331| Name| Description|
5332| -------- | -------- |
5333| value | Pointer to an **AccessibilityValue** instance. |
5334| min | Minimum value based on the range component. The default value is **-1**. |
5335
5336
5337### OH_ArkUI_AccessibilityValue_SetText()
5338
5339```
5340void OH_ArkUI_AccessibilityValue_SetText (ArkUI_AccessibilityValue * value, const char * text )
5341```
5342**Description**
5343
5344Sets the text description of an **AccessibilityValue** instance.
5345
5346**Since**: 12
5347
5348**Parameters**
5349
5350| Name| Description|
5351| -------- | -------- |
5352| value | Pointer to an **AccessibilityValue** instance. |
5353| text | Text description. The default value is an empty string. |
5354
5355
5356### OH_ArkUI_ActiveChildrenInfo_Destroy()
5357
5358```
5359void OH_ArkUI_ActiveChildrenInfo_Destroy (ArkUI_ActiveChildrenInfo * handle)
5360```
5361**Description**
5362
5363Destroys an **ActiveChildrenInfo** instance.
5364
5365**Since**: 14
5366
5367**Parameters**
5368
5369| Name| Description|
5370| -------- | -------- |
5371| handle | **ActiveChildrenInfo** instance to destroy. |
5372
5373
5374### OH_ArkUI_ActiveChildrenInfo_GetCount()
5375
5376```
5377int32_t OH_ArkUI_ActiveChildrenInfo_GetCount (ArkUI_ActiveChildrenInfo * handle)
5378```
5379**Description**
5380
5381Obtains the number of nodes in the specified **ActiveChildrenInfo** instance.
5382
5383**Since**: 14
5384
5385**Parameters**
5386
5387| Name| Description|
5388| -------- | -------- |
5389| handle | **ActiveChildrenInfo** instance from which to obtain the information. |
5390
5391
5392### OH_ArkUI_ActiveChildrenInfo_GetNodeByIndex()
5393
5394```
5395ArkUI_NodeHandle OH_ArkUI_ActiveChildrenInfo_GetNodeByIndex (ArkUI_ActiveChildrenInfo * handle, int32_t index )
5396```
5397**Description**
5398
5399Obtains the child node at the specified index in the specified **ActiveChildrenInfo** instance.
5400
5401**Since**: 14
5402
5403**Parameters**
5404
5405| Name| Description|
5406| -------- | -------- |
5407| handle | **ActiveChildrenInfo** instance from which to obtain the information. |
5408
5409
5410### OH_ArkUI_AlignmentRuleOption_Create()
5411
5412```
5413ArkUI_AlignmentRuleOption* OH_ArkUI_AlignmentRuleOption_Create ()
5414```
5415**Description**
5416
5417Creates an alignment rule configuration for this **RelativeContainer** component.
5418
5419**Since**: 12
5420
5421**Returns**
5422
5423Alignment rule information.
5424
5425
5426### OH_ArkUI_AlignmentRuleOption_Dispose()
5427
5428```
5429void OH_ArkUI_AlignmentRuleOption_Dispose (ArkUI_AlignmentRuleOption * option)
5430```
5431**Description**
5432
5433Disposes of an alignment rule configuration of this **RelativeContainer** component.
5434
5435**Since**: 12
5436
5437**Parameters**
5438
5439| Name| Description|
5440| -------- | -------- |
5441| option | Pointer to an alignment rule configuration. |
5442
5443
5444### OH_ArkUI_AlignmentRuleOption_GetBiasHorizontal()
5445
5446```
5447float OH_ArkUI_AlignmentRuleOption_GetBiasHorizontal (ArkUI_AlignmentRuleOption * option)
5448```
5449**Description**
5450
5451Obtains the bias value in the horizontal direction.
5452
5453**Since**: 12
5454
5455**Parameters**
5456
5457| Name| Description|
5458| -------- | -------- |
5459| option | Pointer to an alignment rule configuration. |
5460
5461**Returns**
5462
5463Bias value in the horizontal direction.
5464
5465
5466### OH_ArkUI_AlignmentRuleOption_GetBiasVertical()
5467
5468```
5469float OH_ArkUI_AlignmentRuleOption_GetBiasVertical (ArkUI_AlignmentRuleOption * option)
5470```
5471**Description**
5472
5473Obtains the bias value in the vertical direction.
5474
5475**Since**: 12
5476
5477**Parameters**
5478
5479| Name| Description|
5480| -------- | -------- |
5481| option | Pointer to an alignment rule configuration. |
5482
5483**Returns**
5484
5485Returns the bias value in the vertical direction.
5486
5487
5488### OH_ArkUI_AlignmentRuleOption_GetBottomAlignment()
5489
5490```
5491ArkUI_VerticalAlignment OH_ArkUI_AlignmentRuleOption_GetBottomAlignment (ArkUI_AlignmentRuleOption * option)
5492```
5493**Description**
5494
5495Obtains the alignment mode in bottom alignment parameters.
5496
5497**Since**: 12
5498
5499**Parameters**
5500
5501| Name| Description|
5502| -------- | -------- |
5503| option | Pointer to an alignment rule configuration. |
5504
5505**Returns**
5506
5507Returns the alignment mode in bottom alignment parameters.
5508
5509
5510### OH_ArkUI_AlignmentRuleOption_GetBottomId()
5511
5512```
5513const char* OH_ArkUI_AlignmentRuleOption_GetBottomId (ArkUI_AlignmentRuleOption * option)
5514```
5515**Description**
5516
5517Obtains the alignment mode in bottom alignment parameters.
5518
5519**Since**: 12
5520
5521**Parameters**
5522
5523| Name| Description|
5524| -------- | -------- |
5525| option | Pointer to an alignment rule configuration. |
5526
5527**Returns**
5528
5529Returns the ID in bottom alignment parameters.
5530
5531
5532### OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentHorizontal()
5533
5534```
5535ArkUI_HorizontalAlignment OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentHorizontal (ArkUI_AlignmentRuleOption * option)
5536```
5537**Description**
5538
5539Obtains the alignment mode in horizontal center alignment parameters.
5540
5541**Since**: 12
5542
5543**Parameters**
5544
5545| Name| Description|
5546| -------- | -------- |
5547| option | Pointer to an alignment rule configuration. |
5548
5549**Returns**
5550
5551Returns the alignment mode in horizontal center alignment parameters.
5552
5553
5554### OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentVertical()
5555
5556```
5557ArkUI_VerticalAlignment OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentVertical (ArkUI_AlignmentRuleOption * option)
5558```
5559**Description**
5560
5561Obtains the ID in vertical center alignment parameters.
5562
5563**Since**: 12
5564
5565**Parameters**
5566
5567| Name| Description|
5568| -------- | -------- |
5569| option | Pointer to an alignment rule configuration. |
5570
5571**Returns**
5572
5573Returns the vertical center alignment parameters.
5574
5575
5576### OH_ArkUI_AlignmentRuleOption_GetCenterIdHorizontal()
5577
5578```
5579const char* OH_ArkUI_AlignmentRuleOption_GetCenterIdHorizontal (ArkUI_AlignmentRuleOption * option)
5580```
5581**Description**
5582
5583Obtains the alignment mode in horizontal center alignment parameters.
5584
5585**Since**: 12
5586
5587**Parameters**
5588
5589| Name| Description|
5590| -------- | -------- |
5591| option | Pointer to an alignment rule configuration. |
5592
5593**Returns**
5594
5595Returns the ID in horizontal center alignment parameters.
5596
5597
5598### OH_ArkUI_AlignmentRuleOption_GetCenterIdVertical()
5599
5600```
5601const char* OH_ArkUI_AlignmentRuleOption_GetCenterIdVertical (ArkUI_AlignmentRuleOption * option)
5602```
5603**Description**
5604
5605Obtains the ID in vertical center alignment parameters.
5606
5607**Since**: 12
5608
5609**Parameters**
5610
5611| Name| Description|
5612| -------- | -------- |
5613| option | Pointer to an alignment rule configuration. |
5614
5615**Returns**
5616
5617Returns the ID in vertical center alignment parameters.
5618
5619
5620### OH_ArkUI_AlignmentRuleOption_GetEndAlignment()
5621
5622```
5623ArkUI_HorizontalAlignment OH_ArkUI_AlignmentRuleOption_GetEndAlignment (ArkUI_AlignmentRuleOption * option)
5624```
5625**Description**
5626
5627Obtains the alignment mode in the right alignment parameters.
5628
5629**Since**: 12
5630
5631**Parameters**
5632
5633| Name| Description|
5634| -------- | -------- |
5635| option | Pointer to an alignment rule configuration. |
5636
5637**Returns**
5638
5639Returns the alignment mode in the right alignment parameters.
5640
5641
5642### OH_ArkUI_AlignmentRuleOption_GetEndId()
5643
5644```
5645const char* OH_ArkUI_AlignmentRuleOption_GetEndId (ArkUI_AlignmentRuleOption * option)
5646```
5647**Description**
5648
5649Obtains the alignment mode in the right alignment parameters.
5650
5651**Since**: 12
5652
5653**Parameters**
5654
5655| Name| Description|
5656| -------- | -------- |
5657| option | Pointer to an alignment rule configuration. |
5658
5659**Returns**
5660
5661Returns the ID in the right alignment parameters.
5662
5663
5664### OH_ArkUI_AlignmentRuleOption_GetStartAlignment()
5665
5666```
5667ArkUI_HorizontalAlignment OH_ArkUI_AlignmentRuleOption_GetStartAlignment (ArkUI_AlignmentRuleOption * option)
5668```
5669**Description**
5670
5671Obtains the alignment mode in left alignment parameters.
5672
5673**Since**: 12
5674
5675**Parameters**
5676
5677| Name| Description|
5678| -------- | -------- |
5679| option | Pointer to an alignment rule configuration. |
5680
5681**Returns**
5682
5683Returns the alignment mode in left alignment parameters.
5684
5685
5686### OH_ArkUI_AlignmentRuleOption_GetStartId()
5687
5688```
5689const char* OH_ArkUI_AlignmentRuleOption_GetStartId (ArkUI_AlignmentRuleOption * option)
5690```
5691**Description**
5692
5693Obtains the ID in the left alignment parameters.
5694
5695**Since**: 12
5696
5697**Parameters**
5698
5699| Name| Description|
5700| -------- | -------- |
5701| option | Pointer to an alignment rule configuration. |
5702
5703**Returns**
5704
5705Returns the ID in left alignment parameters.
5706
5707
5708### OH_ArkUI_AlignmentRuleOption_GetTopAlignment()
5709
5710```
5711ArkUI_VerticalAlignment OH_ArkUI_AlignmentRuleOption_GetTopAlignment (ArkUI_AlignmentRuleOption * option)
5712```
5713**Description**
5714
5715Obtains the alignment mode in top alignment parameters.
5716
5717**Since**: 12
5718
5719**Parameters**
5720
5721| Name| Description|
5722| -------- | -------- |
5723| option | Pointer to an alignment rule configuration. |
5724
5725**Returns**
5726
5727Returns the alignment mode in top alignment parameters.
5728
5729
5730### OH_ArkUI_AlignmentRuleOption_GetTopId()
5731
5732```
5733const char* OH_ArkUI_AlignmentRuleOption_GetTopId (ArkUI_AlignmentRuleOption * option)
5734```
5735**Description**
5736
5737Obtains the alignment mode in top alignment parameters.
5738
5739**Since**: 12
5740
5741**Parameters**
5742
5743| Name| Description|
5744| -------- | -------- |
5745| option | Pointer to an alignment rule configuration. |
5746
5747**Returns**
5748
5749Returns the ID in top alignment parameters.
5750
5751
5752### OH_ArkUI_AlignmentRuleOption_SetBiasHorizontal()
5753
5754```
5755void OH_ArkUI_AlignmentRuleOption_SetBiasHorizontal (ArkUI_AlignmentRuleOption * option, float horizontal )
5756```
5757**Description**
5758
5759Sets the bias value of the component in the horizontal direction under the anchor constraints.
5760
5761**Since**: 12
5762
5763**Parameters**
5764
5765| Name| Description|
5766| -------- | -------- |
5767| option | Pointer to an alignment rule configuration. |
5768| horizontal | Bias value in the horizontal direction. |
5769
5770
5771### OH_ArkUI_AlignmentRuleOption_SetBiasVertical()
5772
5773```
5774void OH_ArkUI_AlignmentRuleOption_SetBiasVertical (ArkUI_AlignmentRuleOption * option, float vertical )
5775```
5776**Description**
5777
5778Sets the bias value of the component in the vertical direction under the anchor constraints.
5779
5780**Since**: 12
5781
5782**Parameters**
5783
5784| Name| Description|
5785| -------- | -------- |
5786| option | Pointer to an alignment rule configuration. |
5787| horizontal | Bias value in the vertical direction. |
5788
5789
5790### OH_ArkUI_AlignmentRuleOption_SetBottom()
5791
5792```
5793void OH_ArkUI_AlignmentRuleOption_SetBottom (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_VerticalAlignment alignment )
5794```
5795**Description**
5796
5797Sets the bottom alignment parameters.
5798
5799**Since**: 12
5800
5801**Parameters**
5802
5803| Name| Description|
5804| -------- | -------- |
5805| option | Pointer to an alignment rule configuration. |
5806| id | ID of the anchor component. |
5807| value | Alignment mode relative to the anchor component. |
5808
5809
5810### OH_ArkUI_AlignmentRuleOption_SetCenterHorizontal()
5811
5812```
5813void OH_ArkUI_AlignmentRuleOption_SetCenterHorizontal (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_HorizontalAlignment alignment )
5814```
5815**Description**
5816
5817Sets the horizontal center alignment parameters.
5818
5819**Since**: 12
5820
5821**Parameters**
5822
5823| Name| Description|
5824| -------- | -------- |
5825| option | Pointer to an alignment rule configuration. |
5826| id | ID of the anchor component. |
5827| value | Alignment mode relative to the anchor component. |
5828
5829
5830### OH_ArkUI_AlignmentRuleOption_SetCenterVertical()
5831
5832```
5833void OH_ArkUI_AlignmentRuleOption_SetCenterVertical (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_VerticalAlignment alignment )
5834```
5835**Description**
5836
5837Sets the vertical center alignment parameters.
5838
5839**Since**: 12
5840
5841**Parameters**
5842
5843| Name| Description|
5844| -------- | -------- |
5845| option | Pointer to an alignment rule configuration. |
5846| id | ID of the anchor component. |
5847| value | Alignment mode relative to the anchor component. |
5848
5849
5850### OH_ArkUI_AlignmentRuleOption_SetEnd()
5851
5852```
5853void OH_ArkUI_AlignmentRuleOption_SetEnd (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_HorizontalAlignment alignment )
5854```
5855**Description**
5856
5857Sets the right alignment parameters.
5858
5859**Since**: 12
5860
5861**Parameters**
5862
5863| Name| Description|
5864| -------- | -------- |
5865| option | Pointer to an alignment rule configuration. |
5866| id | ID of the anchor component. |
5867| value | Alignment mode relative to the anchor component. |
5868
5869
5870### OH_ArkUI_AlignmentRuleOption_SetStart()
5871
5872```
5873void OH_ArkUI_AlignmentRuleOption_SetStart (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_HorizontalAlignment alignment )
5874```
5875**Description**
5876
5877Sets the left alignment parameters.
5878
5879**Since**: 12
5880
5881**Parameters**
5882
5883| Name| Description|
5884| -------- | -------- |
5885| option | Pointer to an alignment rule configuration. |
5886| id | ID of the anchor component. |
5887| value | Alignment mode relative to the anchor component. |
5888
5889
5890### OH_ArkUI_AlignmentRuleOption_SetTop()
5891
5892```
5893void OH_ArkUI_AlignmentRuleOption_SetTop (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_VerticalAlignment alignment )
5894```
5895**Description**
5896
5897Sets the top alignment parameters.
5898
5899**Since**: 12
5900
5901**Parameters**
5902
5903| Name| Description|
5904| -------- | -------- |
5905| option | Pointer to an alignment rule configuration. |
5906| id | ID of the anchor component. |
5907| value | Alignment mode relative to the anchor component. |
5908
5909
5910### OH_ArkUI_AllowNodeAllDropDataTypes()
5911
5912```
5913int32_t OH_ArkUI_AllowNodeAllDropDataTypes (ArkUI_NodeHandle node)
5914```
5915**Description**
5916
5917Configures the specified component to allow any data types. This API resets the settings configured through [OH_ArkUI_SetNodeAllowedDropDataTypes](#oh_arkui_setnodealloweddropdatatypes).
5918
5919**Since**: 12
5920
5921**Parameters**
5922
5923| Name| Description|
5924| -------- | -------- |
5925| node | Pointer to a component node. |
5926
5927**Returns**
5928
5929Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
5930
5931
5932### OH_ArkUI_AnimateOption_Create()
5933
5934```
5935ArkUI_AnimateOption* OH_ArkUI_AnimateOption_Create ()
5936```
5937**Description**
5938
5939Creates an animation configuration.
5940
5941**Since**: 12
5942
5943**Returns**
5944
5945Returns the pointer to the created animation configuration.
5946
5947
5948### OH_ArkUI_AnimateOption_Dispose()
5949
5950```
5951void OH_ArkUI_AnimateOption_Dispose (ArkUI_AnimateOption * option)
5952```
5953**Description**
5954
5955Disposes of an animation configuration.
5956
5957**Since**: 12
5958
5959
5960### OH_ArkUI_AnimateOption_GetCurve()
5961
5962```
5963ArkUI_AnimationCurve OH_ArkUI_AnimateOption_GetCurve (ArkUI_AnimateOption * option)
5964```
5965**Description**
5966
5967Obtains an animation curve.
5968
5969**Since**: 12
5970
5971**Parameters**
5972
5973| Name| Description|
5974| -------- | -------- |
5975| option | Pointer to an animation configuration. |
5976
5977**Returns**
5978
5979Returns the animation curve.
5980
5981
5982### OH_ArkUI_AnimateOption_GetDelay()
5983
5984```
5985int32_t OH_ArkUI_AnimateOption_GetDelay (ArkUI_AnimateOption * option)
5986```
5987**Description**
5988
5989Obtains the animation delay, in milliseconds.
5990
5991**Since**: 12
5992
5993**Parameters**
5994
5995| Name| Description|
5996| -------- | -------- |
5997| option | Pointer to an animation configuration. |
5998
5999**Returns**
6000
6001Returns the animation delay.
6002
6003
6004### OH_ArkUI_AnimateOption_GetDuration()
6005
6006```
6007int32_t OH_ArkUI_AnimateOption_GetDuration (ArkUI_AnimateOption * option)
6008```
6009**Description**
6010
6011Obtains the animation duration, in milliseconds.
6012
6013**Since**: 12
6014
6015**Parameters**
6016
6017| Name| Description|
6018| -------- | -------- |
6019| option | Pointer to an animation configuration. |
6020
6021**Returns**
6022
6023Returns the animation duration.
6024
6025
6026### OH_ArkUI_AnimateOption_GetExpectedFrameRateRange()
6027
6028```
6029ArkUI_ExpectedFrameRateRange* OH_ArkUI_AnimateOption_GetExpectedFrameRateRange (ArkUI_AnimateOption * option)
6030```
6031**Description**
6032
6033Obtains the expected frame rate range of an animation.
6034
6035**Since**: 12
6036
6037**Parameters**
6038
6039| Name| Description|
6040| -------- | -------- |
6041| option | Pointer to an animation configuration. |
6042
6043**Returns**
6044
6045Returns the expected frame rate range.
6046
6047
6048### OH_ArkUI_AnimateOption_GetICurve()
6049
6050```
6051ArkUI_CurveHandle OH_ArkUI_AnimateOption_GetICurve (ArkUI_AnimateOption * option)
6052```
6053**Description**
6054
6055Obtains the animation curve of an animation.
6056
6057**Since**: 12
6058
6059**Parameters**
6060
6061| Name| Description|
6062| -------- | -------- |
6063| option | Pointer to an animation configuration. |
6064
6065**Returns**
6066
6067Returns the animation curve of the specified animation.
6068
6069
6070### OH_ArkUI_AnimateOption_GetIterations()
6071
6072```
6073int32_t OH_ArkUI_AnimateOption_GetIterations (ArkUI_AnimateOption * option)
6074```
6075**Description**
6076
6077Obtains the number of times that an animation is played.
6078
6079**Since**: 12
6080
6081**Parameters**
6082
6083| Name| Description|
6084| -------- | -------- |
6085| option | Pointer to an animation configuration. |
6086
6087**Returns**
6088
6089Returns the number of times that the animation is played.
6090
6091### OH_ArkUI_AnimateOption_GetPlayMode()
6092
6093```
6094ArkUI_AnimationPlayMode OH_ArkUI_AnimateOption_GetPlayMode (ArkUI_AnimateOption * option)
6095```
6096**Description**
6097
6098Obtains the playback mode of an animation.
6099
6100**Since**: 12
6101
6102**Parameters**
6103
6104| Name| Description|
6105| -------- | -------- |
6106| option | Pointer to an animation configuration. |
6107
6108**Returns**
6109
6110Returns the animation playback mode.
6111
6112
6113### OH_ArkUI_AnimateOption_GetTempo()
6114
6115```
6116float OH_ArkUI_AnimateOption_GetTempo (ArkUI_AnimateOption * option)
6117```
6118**Description**
6119
6120Obtains the playback speed of an animation.
6121
6122**Since**: 12
6123
6124**Parameters**
6125
6126| Name| Description|
6127| -------- | -------- |
6128| option | Pointer to an animation configuration. |
6129
6130**Returns**
6131
6132Animation playback speed.
6133
6134
6135### OH_ArkUI_AnimateOption_SetCurve()
6136
6137```
6138void OH_ArkUI_AnimateOption_SetCurve (ArkUI_AnimateOption * option, ArkUI_AnimationCurve value )
6139```
6140**Description**
6141
6142Sets the animation curve.
6143
6144**Since**: 12
6145
6146**Parameters**
6147
6148| Name| Description|
6149| -------- | -------- |
6150| option | Pointer to an animation configuration. |
6151| value | Returns the animation curve. Default value: **ARKUI_CURVE_LINEAR**. |
6152
6153
6154### OH_ArkUI_AnimateOption_SetDelay()
6155
6156```
6157void OH_ArkUI_AnimateOption_SetDelay (ArkUI_AnimateOption * option, int32_t value )
6158```
6159**Description**
6160
6161Sets the animation delay.
6162
6163**Since**: 12
6164
6165**Parameters**
6166
6167| Name| Description|
6168| -------- | -------- |
6169| option | Pointer to an animation configuration. |
6170| value | Delay of animation playback. |
6171
6172
6173### OH_ArkUI_AnimateOption_SetDuration()
6174
6175```
6176void OH_ArkUI_AnimateOption_SetDuration (ArkUI_AnimateOption * option, int32_t value )
6177```
6178**Description**
6179
6180Sets the animation duration.
6181
6182**Since**: 12
6183
6184**Parameters**
6185
6186| Name| Description|
6187| -------- | -------- |
6188| option | Pointer to an animation configuration. |
6189| value | Duration, in milliseconds. |
6190
6191
6192### OH_ArkUI_AnimateOption_SetExpectedFrameRateRange()
6193
6194```
6195void OH_ArkUI_AnimateOption_SetExpectedFrameRateRange (ArkUI_AnimateOption * option, ArkUI_ExpectedFrameRateRange * value )
6196```
6197**Description**
6198
6199Sets the expected frame rate range of the animation.
6200
6201**Since**: 12
6202
6203**Parameters**
6204
6205| Name| Description|
6206| -------- | -------- |
6207| option | Pointer to an animation configuration. |
6208| value | Expected frame rate range of the animation. |
6209
6210
6211### OH_ArkUI_AnimateOption_SetICurve()
6212
6213```
6214void OH_ArkUI_AnimateOption_SetICurve (ArkUI_AnimateOption * option, ArkUI_CurveHandle value )
6215```
6216**Description**
6217
6218Sets the animation curve for an animation.
6219
6220**Since**: 12
6221
6222**Parameters**
6223
6224| Name| Description|
6225| -------- | -------- |
6226| option | Pointer to an animation configuration. |
6227| value | Animation curve settings. |
6228
6229**NOTE**
6230
6231This API is preferred over the value set by **OH_ArkUI_AnimateOption_SetCurve**.
6232
6233
6234### OH_ArkUI_AnimateOption_SetIterations()
6235
6236```
6237void OH_ArkUI_AnimateOption_SetIterations (ArkUI_AnimateOption * option, int32_t value )
6238```
6239**Description**
6240
6241Sets the number of times that an animation is played.
6242
6243**Since**: 12
6244
6245**Parameters**
6246
6247| Name| Description|
6248| -------- | -------- |
6249| option | Pointer to an animation configuration. |
6250| value | Number of times that the animation is played. |
6251
6252
6253### OH_ArkUI_AnimateOption_SetPlayMode()
6254
6255```
6256void OH_ArkUI_AnimateOption_SetPlayMode (ArkUI_AnimateOption * option, ArkUI_AnimationPlayMode value )
6257```
6258**Description**
6259
6260Sets the playback mode for an animation.
6261
6262**Since**: 12
6263
6264**Parameters**
6265
6266| Name| Description|
6267| -------- | -------- |
6268| option | Pointer to an animation configuration. |
6269| value | Animation playback mode. |
6270
6271
6272### OH_ArkUI_AnimateOption_SetTempo()
6273
6274```
6275void OH_ArkUI_AnimateOption_SetTempo (ArkUI_AnimateOption * option, float value )
6276```
6277**Description**
6278
6279Sets the playback speed of an animation.
6280
6281**Since**: 12
6282
6283**Parameters**
6284
6285| Name| Description|
6286| -------- | -------- |
6287| option | Pointer to an animation configuration. |
6288| value | Animation playback speed. |
6289
6290
6291### OH_ArkUI_Animator_Cancel()
6292
6293```
6294int32_t OH_ArkUI_Animator_Cancel (ArkUI_AnimatorHandle animator)
6295```
6296**Description**
6297
6298Cancels the animation of an animator.
6299
6300**Parameters**
6301
6302| Name| Description|
6303| -------- | -------- |
6304| animator | Animator object. |
6305
6306**Returns**
6307
6308Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6309
6310
6311### OH_ArkUI_Animator_Finish()
6312
6313```
6314int32_t OH_ArkUI_Animator_Finish (ArkUI_AnimatorHandle animator)
6315```
6316**Description**
6317
6318Ends the animation of an animator.
6319
6320**Parameters**
6321
6322| Name| Description|
6323| -------- | -------- |
6324| animator | Animator object. |
6325
6326**Returns**
6327
6328Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6329
6330
6331### OH_ArkUI_Animator_Pause()
6332
6333```
6334int32_t OH_ArkUI_Animator_Pause (ArkUI_AnimatorHandle animator)
6335```
6336**Description**
6337
6338Pauses the animation of an animator.
6339
6340**Parameters**
6341
6342| Name| Description|
6343| -------- | -------- |
6344| animator | Animator object. |
6345
6346**Returns**
6347
6348Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6349
6350
6351### OH_ArkUI_Animator_Play()
6352
6353```
6354int32_t OH_ArkUI_Animator_Play (ArkUI_AnimatorHandle animator)
6355```
6356**Description**
6357
6358Starts the animation of an animator.
6359
6360**Parameters**
6361
6362| Name| Description|
6363| -------- | -------- |
6364| animator | Animator object. |
6365
6366**Returns**
6367
6368Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6369
6370
6371### OH_ArkUI_Animator_ResetAnimatorOption()
6372
6373```
6374int32_t OH_ArkUI_Animator_ResetAnimatorOption (ArkUI_AnimatorHandle animator, ArkUI_AnimatorOption * option )
6375```
6376**Description**
6377
6378Resets an animator configuration.
6379
6380**Parameters**
6381
6382| Name| Description|
6383| -------- | -------- |
6384| animator | Animator object. |
6385| option | Pointer to an animation configuration. |
6386
6387**Returns**
6388
6389Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6390
6391
6392### OH_ArkUI_Animator_Reverse()
6393
6394```
6395int32_t OH_ArkUI_Animator_Reverse (ArkUI_AnimatorHandle animator)
6396```
6397**Description**
6398
6399Plays the animation of an animator in reverse order.
6400
6401**Parameters**
6402
6403| Name| Description|
6404| -------- | -------- |
6405| animator | Animator object. |
6406
6407**Returns**
6408
6409Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6410
6411
6412### OH_ArkUI_AnimatorEvent_GetUserData()
6413
6414```
6415void* OH_ArkUI_AnimatorEvent_GetUserData (ArkUI_AnimatorEvent * event)
6416```
6417**Description**
6418
6419Obtains the custom object in an animation event object.
6420
6421**Since**: 12
6422
6423**Parameters**
6424
6425| Name| Description|
6426| -------- | -------- |
6427| event | Animation event object. |
6428
6429**Returns**
6430
6431Returns the custom object.
6432
6433
6434### OH_ArkUI_AnimatorOnFrameEvent_GetUserData()
6435
6436```
6437void* OH_ArkUI_AnimatorOnFrameEvent_GetUserData (ArkUI_AnimatorOnFrameEvent * event)
6438```
6439**Description**
6440
6441Obtains the custom object in an animation event object.
6442
6443**Since**: 12
6444
6445**Parameters**
6446
6447| Name| Description|
6448| -------- | -------- |
6449| event | Animation event object. |
6450
6451**Returns**
6452
6453Returns the custom object.
6454
6455
6456### OH_ArkUI_AnimatorOnFrameEvent_GetValue()
6457
6458```
6459float OH_ArkUI_AnimatorOnFrameEvent_GetValue (ArkUI_AnimatorOnFrameEvent * event)
6460```
6461**Description**
6462
6463Obtains the current progress in an animation event object.
6464
6465**Since**: 12
6466
6467**Parameters**
6468
6469| Name| Description|
6470| -------- | -------- |
6471| event | Animation event object. |
6472
6473**Returns**
6474
6475Returns the animation progress.
6476
6477
6478### OH_ArkUI_AnimatorOption_Create()
6479
6480```
6481ArkUI_AnimatorOption* OH_ArkUI_AnimatorOption_Create (int32_t keyframeSize)
6482```
6483**Description**
6484
6485Creates an animator parameter object.
6486
6487**Since**: 12
6488
6489**Parameters**
6490
6491| Name| Description|
6492| -------- | -------- |
6493| keyframeSize | Number of keyframes. |
6494
6495**NOTE**
6496
6497If 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.
6498
6499**Returns**
6500
6501Returns the pointer to the animator parameter object.
6502
6503
6504### OH_ArkUI_AnimatorOption_Dispose()
6505
6506```
6507void OH_ArkUI_AnimatorOption_Dispose (ArkUI_AnimatorOption * option)
6508```
6509**Description**
6510
6511Disposes of an **AnimatorOption** object.
6512
6513**Since**: 12
6514
6515
6516### OH_ArkUI_AnimatorOption_GetBegin()
6517
6518```
6519float OH_ArkUI_AnimatorOption_GetBegin (ArkUI_AnimatorOption * option)
6520```
6521**Description**
6522
6523Obtains the interpolation start point of an animation.
6524
6525**Since**: 12
6526
6527**Parameters**
6528
6529| Name| Description|
6530| -------- | -------- |
6531| option | Pointer to an animation configuration. |
6532
6533**Returns**
6534
6535Returns the start point of the animation interpolation.
6536
6537
6538### OH_ArkUI_AnimatorOption_GetCurve()
6539
6540```
6541ArkUI_CurveHandle OH_ArkUI_AnimatorOption_GetCurve (ArkUI_AnimatorOption * option)
6542```
6543**Description**
6544
6545Obtains the interpolation curve of the animation of an animator.
6546
6547**Since**: 12
6548
6549**Parameters**
6550
6551| Name| Description|
6552| -------- | -------- |
6553| option | Pointer to an animation configuration. |
6554
6555**Returns**
6556
6557Returns the interpolation curve of the animation.
6558
6559
6560### OH_ArkUI_AnimatorOption_GetDelay()
6561
6562```
6563int32_t OH_ArkUI_AnimatorOption_GetDelay (ArkUI_AnimatorOption * option)
6564```
6565**Description**
6566
6567Obtains the delay for playing an animation.
6568
6569**Since**: 12
6570
6571**Parameters**
6572
6573| Name| Description|
6574| -------- | -------- |
6575| option | Pointer to an animation configuration. |
6576
6577**Returns**
6578
6579Returns the delay for playing the animation, in milliseconds.
6580
6581
6582### OH_ArkUI_AnimatorOption_GetDirection()
6583
6584```
6585ArkUI_AnimationDirection OH_ArkUI_AnimatorOption_GetDirection (ArkUI_AnimatorOption * option)
6586```
6587**Description**
6588
6589Obtains the playback direction of an animation.
6590
6591**Since**: 12
6592
6593**Parameters**
6594
6595| Name| Description|
6596| -------- | -------- |
6597| option | Pointer to an animation configuration. |
6598
6599**Returns**
6600
6601Returns the animation playback direction.
6602
6603
6604### OH_ArkUI_AnimatorOption_GetDuration()
6605
6606```
6607int32_t OH_ArkUI_AnimatorOption_GetDuration (ArkUI_AnimatorOption * option)
6608```
6609**Description**
6610
6611Obtains the duration for playing an animation.
6612
6613**Since**: 12
6614
6615**Parameters**
6616
6617| Name| Description|
6618| -------- | -------- |
6619| option | Pointer to an animation configuration. |
6620
6621**Returns**
6622
6623Returns the duration for playing the animation, in milliseconds.
6624
6625
6626### OH_ArkUI_AnimatorOption_GetEnd()
6627
6628```
6629float OH_ArkUI_AnimatorOption_GetEnd (ArkUI_AnimatorOption * option)
6630```
6631**Description**
6632
6633Obtains the interpolation end point of an animation.
6634
6635**Since**: 12
6636
6637**Parameters**
6638
6639| Name| Description|
6640| -------- | -------- |
6641| option | Pointer to an animation configuration. |
6642
6643**Returns**
6644
6645Returns the interpolation end point of the animation.
6646
6647
6648### OH_ArkUI_AnimatorOption_GetExpectedFrameRateRange()
6649
6650```
6651ArkUI_ExpectedFrameRateRange* OH_ArkUI_AnimatorOption_GetExpectedFrameRateRange (ArkUI_AnimatorOption * option)
6652```
6653**Description**
6654
6655Obtains the expected frame rate range of an animation.
6656
6657**Since**: 12
6658
6659**Parameters**
6660
6661| Name| Description|
6662| -------- | -------- |
6663| option | Pointer to an animation configuration. |
6664
6665**Returns**
6666
6667Returns the pointer to the expected frame rate range object.
6668
6669
6670### OH_ArkUI_AnimatorOption_GetFill()
6671
6672```
6673ArkUI_AnimationFill OH_ArkUI_AnimatorOption_GetFill (ArkUI_AnimatorOption * option)
6674```
6675**Description**
6676
6677Obtains whether the animator animation is restored to the initial state after being executed.
6678
6679**Since**: 12
6680
6681**Parameters**
6682
6683| Name| Description|
6684| -------- | -------- |
6685| option | Pointer to an animation configuration. |
6686
6687**Returns**
6688
6689Returns whether the animator animation is restored to the initial state after being executed.
6690
6691
6692### OH_ArkUI_AnimatorOption_GetIterations()
6693
6694```
6695int32_t OH_ArkUI_AnimatorOption_GetIterations (ArkUI_AnimatorOption * option)
6696```
6697**Description**
6698
6699Obtains the number of times that an animation is played.
6700
6701**Since**: 12
6702
6703**Parameters**
6704
6705| Name| Description|
6706| -------- | -------- |
6707| option | Pointer to an **AnimatorOption** object. |
6708
6709**Returns**
6710
6711Number of times that the animation is played.
6712
6713
6714### OH_ArkUI_AnimatorOption_GetKeyframeCurve()
6715
6716```
6717ArkUI_CurveHandle OH_ArkUI_AnimatorOption_GetKeyframeCurve (ArkUI_AnimatorOption * option, int32_t index )
6718```
6719**Description**
6720
6721Obtains the interpolation curve for a keyframe in the animation of an animator.
6722
6723**Since**: 12
6724
6725**Parameters**
6726
6727| Name| Description|
6728| -------- | -------- |
6729| option | Pointer to an **AnimatorOption** object. |
6730| index | Keyframe index. |
6731
6732**Returns**
6733
6734Returns the interpolation curve.
6735
6736
6737### OH_ArkUI_AnimatorOption_GetKeyframeTime()
6738
6739```
6740float OH_ArkUI_AnimatorOption_GetKeyframeTime (ArkUI_AnimatorOption * option, int32_t index )
6741```
6742**Description**
6743
6744Obtains the keyframe time of an animation.
6745
6746**Since**: 12
6747
6748**Parameters**
6749
6750| Name| Description|
6751| -------- | -------- |
6752| option | Pointer to an **AnimatorOption** object. |
6753| index | Keyframe index. |
6754
6755**Returns**
6756
6757Keyframe time.
6758
6759
6760### OH_ArkUI_AnimatorOption_GetKeyframeValue()
6761
6762```
6763float OH_ArkUI_AnimatorOption_GetKeyframeValue (ArkUI_AnimatorOption * option, int32_t index )
6764```
6765**Description**
6766
6767Obtains the keyframe value of an animation.
6768
6769**Since**: 12
6770
6771**Parameters**
6772
6773| Name| Description|
6774| -------- | -------- |
6775| option | Pointer to an **AnimatorOption** object. |
6776| index | Keyframe index. |
6777
6778**Returns**
6779
6780Keyframe value.
6781
6782
6783### OH_ArkUI_AnimatorOption_RegisterOnCancelCallback()
6784
6785```
6786int32_t OH_ArkUI_AnimatorOption_RegisterOnCancelCallback (ArkUI_AnimatorOption * option, void * userData, void(*)(ArkUI_AnimatorEvent *event) callback )
6787```
6788**Description**
6789
6790Sets the callback invoked when the animation playback is canceled.
6791
6792**Parameters**
6793
6794| Name| Description|
6795| -------- | -------- |
6796| option | Pointer to an animation configuration. |
6797| userData | Custom parameter. |
6798| callback | Callback used to return the result. |
6799
6800**Returns**
6801
6802Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6803
6804
6805### OH_ArkUI_AnimatorOption_RegisterOnFinishCallback()
6806
6807```
6808int32_t OH_ArkUI_AnimatorOption_RegisterOnFinishCallback (ArkUI_AnimatorOption * option, void * userData, void(*)(ArkUI_AnimatorEvent *event) callback )
6809```
6810**Description**
6811
6812Sets the callback invoked when the animation playback is complete.
6813
6814**Parameters**
6815
6816| Name| Description|
6817| -------- | -------- |
6818| option | Pointer to an animation configuration. |
6819| userData | Custom parameter. |
6820| callback | Callback used to return the result. |
6821
6822**Returns**
6823
6824Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6825
6826
6827### OH_ArkUI_AnimatorOption_RegisterOnFrameCallback()
6828
6829```
6830int32_t OH_ArkUI_AnimatorOption_RegisterOnFrameCallback (ArkUI_AnimatorOption * option, void * userData, void(*)(ArkUI_AnimatorOnFrameEvent *event) callback )
6831```
6832**Description**
6833
6834Sets the callback invoked when the animator receives a frame.
6835
6836**Parameters**
6837
6838| Name| Description|
6839| -------- | -------- |
6840| option | Pointer to an animation configuration. |
6841| userData | Custom parameter. |
6842| callback | Callback used to return the result. |
6843
6844**Returns**
6845
6846Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6847
6848
6849### OH_ArkUI_AnimatorOption_RegisterOnRepeatCallback()
6850
6851```
6852int32_t OH_ArkUI_AnimatorOption_RegisterOnRepeatCallback (ArkUI_AnimatorOption * option, void * userData, void(*)(ArkUI_AnimatorEvent *event) callback )
6853```
6854**Description**
6855
6856Sets the callback invoked when the animation playback is repeated.
6857
6858**Parameters**
6859
6860| Name| Description|
6861| -------- | -------- |
6862| option | Pointer to an animation configuration. |
6863| userData | Custom parameter. |
6864| callback | Callback used to return the result. |
6865
6866**Returns**
6867
6868Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6869
6870
6871### OH_ArkUI_AnimatorOption_SetBegin()
6872
6873```
6874int32_t OH_ArkUI_AnimatorOption_SetBegin (ArkUI_AnimatorOption * option, float value )
6875```
6876**Description**
6877
6878Sets the interpolation start point for the animation of an animator.
6879
6880**Parameters**
6881
6882| Name| Description|
6883| -------- | -------- |
6884| option | Pointer to an **AnimatorOption** object. |
6885| value | Start point of the animation interpolation. |
6886
6887**NOTE**
6888
6889This API does not take effect when the animation is a keyframe animation.
6890
6891**Returns**
6892
6893Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6894
6895
6896### OH_ArkUI_AnimatorOption_SetCurve()
6897
6898```
6899int32_t OH_ArkUI_AnimatorOption_SetCurve (ArkUI_AnimatorOption * option, ArkUI_CurveHandle value )
6900```
6901**Description**
6902
6903Sets the interpolation curve for the animation of an animator.
6904
6905**Parameters**
6906
6907| Name| Description|
6908| -------- | -------- |
6909| option | Pointer to an **AnimatorOption** object. |
6910| value | Returns the interpolation curve of the animation. Default value: **ARKUI_CURVE_LINEAR**. |
6911
6912**NOTE**
6913
6914The **springCurve**, **springMotion**, **responsiveSpringMotion**, and **interpolatingSpring customCurve** curves are not supported.
6915
6916**Returns**
6917
6918Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6919
6920
6921### OH_ArkUI_AnimatorOption_SetDelay()
6922
6923```
6924int32_t OH_ArkUI_AnimatorOption_SetDelay (ArkUI_AnimatorOption * option, int32_t value )
6925```
6926**Description**
6927
6928Sets the delay of animation playback, in milliseconds.
6929
6930**Parameters**
6931
6932| Name| Description|
6933| -------- | -------- |
6934| option | Pointer to an **AnimatorOption** object. |
6935| value | Animation delay, in milliseconds. |
6936
6937**Returns**
6938
6939Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6940
6941
6942### OH_ArkUI_AnimatorOption_SetDirection()
6943
6944```
6945int32_t OH_ArkUI_AnimatorOption_SetDirection (ArkUI_AnimatorOption * option, ArkUI_AnimationDirection value )
6946```
6947**Description**
6948
6949Sets the playback direction.
6950
6951**Parameters**
6952
6953| Name| Description|
6954| -------- | -------- |
6955| option | Pointer to an **AnimatorOption** object. |
6956| value | Animation playback direction. |
6957
6958**Returns**
6959
6960Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6961
6962
6963### OH_ArkUI_AnimatorOption_SetDuration()
6964
6965```
6966int32_t OH_ArkUI_AnimatorOption_SetDuration (ArkUI_AnimatorOption * option, int32_t value )
6967```
6968**Description**
6969
6970Sets the duration of an animation, in milliseconds.
6971
6972**Parameters**
6973
6974| Name| Description|
6975| -------- | -------- |
6976| option | Pointer to an **AnimatorOption** object. |
6977| value | Duration for playing the animation, in milliseconds. |
6978
6979**Returns**
6980
6981Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
6982
6983
6984### OH_ArkUI_AnimatorOption_SetEnd()
6985
6986```
6987int32_t OH_ArkUI_AnimatorOption_SetEnd (ArkUI_AnimatorOption * option, float value )
6988```
6989**Description**
6990
6991Sets the interpolation end point for the animation of an animator.
6992
6993**Parameters**
6994
6995| Name| Description|
6996| -------- | -------- |
6997| option | Pointer to an **AnimatorOption** object. |
6998| value | End point of animation interpolation. |
6999
7000**NOTE**
7001
7002This API does not take effect when the animation is a keyframe animation.
7003
7004**Returns**
7005
7006Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7007
7008
7009### OH_ArkUI_AnimatorOption_SetExpectedFrameRateRange()
7010
7011```
7012int32_t OH_ArkUI_AnimatorOption_SetExpectedFrameRateRange (ArkUI_AnimatorOption * option, ArkUI_ExpectedFrameRateRange * value )
7013```
7014**Description**
7015
7016Sets the expected frame rate range of an animation.
7017
7018**Parameters**
7019
7020| Name| Description|
7021| -------- | -------- |
7022| option | Pointer to an **AnimatorOption** object. |
7023| value | Expected frame rate range. |
7024
7025**Returns**
7026
7027Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7028
7029
7030### OH_ArkUI_AnimatorOption_SetFill()
7031
7032```
7033int32_t OH_ArkUI_AnimatorOption_SetFill (ArkUI_AnimatorOption * option, ArkUI_AnimationFill value )
7034```
7035**Description**
7036
7037Sets whether the animator animation is restored to the initial state after being executed.
7038
7039**Parameters**
7040
7041| Name| Description|
7042| -------- | -------- |
7043| option | Pointer to an **AnimatorOption** object. |
7044| value | Whether to restore the animation to the initial state after the animation is executed. |
7045
7046**Returns**
7047
7048Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7049
7050
7051### OH_ArkUI_AnimatorOption_SetIterations()
7052
7053```
7054int32_t OH_ArkUI_AnimatorOption_SetIterations (ArkUI_AnimatorOption * option, int32_t value )
7055```
7056**Description**
7057
7058Sets 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.
7059
7060**Parameters**
7061
7062| Name| Description|
7063| -------- | -------- |
7064| option | Pointer to an **AnimatorOption** object. |
7065| value | Number of times that the animation is played. |
7066
7067**NOTE**
7068
7069If this parameter is set to a negative value other than **-1**, the value is invalid. In this case, the animation is played once.
7070
7071**Returns**
7072
7073Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7074
7075
7076### OH_ArkUI_AnimatorOption_SetKeyframe()
7077
7078```
7079int32_t OH_ArkUI_AnimatorOption_SetKeyframe (ArkUI_AnimatorOption * option, float time, float value, int32_t index )
7080```
7081**Description**
7082
7083Sets the keyframe parameters of an animation.
7084
7085**Parameters**
7086
7087| Name| Description|
7088| -------- | -------- |
7089| option | Pointer to an **AnimatorOption** object. |
7090| time | Keyframe time. Value range: [0, 1]. The value must be in ascending order. |
7091| value | Keyframe value. |
7092| index | Keyframe index. |
7093
7094**Returns**
7095
7096Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7097
7098
7099### OH_ArkUI_AnimatorOption_SetKeyframeCurve()
7100
7101```
7102int32_t OH_ArkUI_AnimatorOption_SetKeyframeCurve (ArkUI_AnimatorOption * option, ArkUI_CurveHandle value, int32_t index )
7103```
7104**Description**
7105
7106Sets the keyframe curve type for the animation of an animator.
7107
7108**Parameters**
7109
7110| Name| Description|
7111| -------- | -------- |
7112| option | Pointer to an **AnimatorOption** object. |
7113| value | Animation interpolation curve. |
7114| index | Keyframe index. |
7115
7116**NOTE**
7117
7118The **springCurve**, **springMotion**, **responsiveSpringMotion**, and **interpolatingSpring customCurve** curves are not supported.
7119
7120**Returns**
7121
7122Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7123
7124
7125### OH_ArkUI_BarrierOption_Create()
7126
7127```
7128ArkUI_BarrierOption* OH_ArkUI_BarrierOption_Create (int32_t size)
7129```
7130**Description**
7131
7132Creates a barrier configuration for this **RelativeContainer** component.
7133
7134**Since**: 12
7135
7136**Parameters**
7137
7138| Name| Description|
7139| -------- | -------- |
7140| size | Number of barriers. |
7141
7142**Returns**
7143
7144Returns the barrier configuration.
7145
7146
7147### OH_ArkUI_BarrierOption_Dispose()
7148
7149```
7150void OH_ArkUI_BarrierOption_Dispose (ArkUI_BarrierOption * barrierStyle)
7151```
7152**Description**
7153
7154Disposes of a barrier configuration.
7155
7156**Since**: 12
7157
7158**Parameters**
7159
7160| Name| Description|
7161| -------- | -------- |
7162| barrierStyle | Pointer to a barrier configuration. |
7163
7164
7165### OH_ArkUI_BarrierOption_GetDirection()
7166
7167```
7168ArkUI_BarrierDirection OH_ArkUI_BarrierOption_GetDirection (ArkUI_BarrierOption * barrierStyle, int32_t index )
7169```
7170**Description**
7171
7172Obtains the direction of a barrier.
7173
7174**Since**: 12
7175
7176**Parameters**
7177
7178| Name| Description|
7179| -------- | -------- |
7180| barrierStyle | Pointer to a barrier configuration. |
7181| index | Index of the barrier. |
7182
7183**Returns**
7184
7185Returns the direction of the barrier.
7186
7187
7188### OH_ArkUI_BarrierOption_GetId()
7189
7190```
7191const char* OH_ArkUI_BarrierOption_GetId (ArkUI_BarrierOption * barrierStyle, int32_t index )
7192```
7193**Description**
7194
7195Obtains the ID of a barrier.
7196
7197**Since**: 12
7198
7199**Parameters**
7200
7201| Name| Description|
7202| -------- | -------- |
7203| barrierStyle | Pointer to a barrier configuration. |
7204| index | Index of the barrier. |
7205
7206**Returns**
7207
7208Returns the ID of the barrier.
7209
7210
7211### OH_ArkUI_BarrierOption_GetReferencedId()
7212
7213```
7214const char* OH_ArkUI_BarrierOption_GetReferencedId (ArkUI_BarrierOption * barrierStyle, int32_t index, int32_t referencedIndex )
7215```
7216**Description**
7217
7218Obtains the referenced components of a barrier.
7219
7220**Since**: 12
7221
7222**Parameters**
7223
7224| Name| Description|
7225| -------- | -------- |
7226| barrierStyle | Pointer to a barrier configuration. |
7227| index | Index of the barrier. |
7228| referencedIndex | Index of the referenced component ID. |
7229
7230**Returns**
7231
7232Returns the referenced components of the barrier.
7233
7234
7235### OH_ArkUI_BarrierOption_GetReferencedIdSize()
7236
7237```
7238int32_t OH_ArkUI_BarrierOption_GetReferencedIdSize (ArkUI_BarrierOption * barrierStyle, int32_t index )
7239```
7240**Description**
7241
7242Obtains the number of referenced components of a barrier.
7243
7244**Since**: 12
7245
7246**Parameters**
7247
7248| Name| Description|
7249| -------- | -------- |
7250| barrierStyle | Pointer to a barrier configuration. |
7251| index | Index of the barrier. |
7252
7253**Returns**
7254
7255Returns the number of referenced components of the barrier.
7256
7257
7258### OH_ArkUI_BarrierOption_SetDirection()
7259
7260```
7261void OH_ArkUI_BarrierOption_SetDirection (ArkUI_BarrierOption * barrierStyle, ArkUI_BarrierDirection value, int32_t index )
7262```
7263**Description**
7264
7265Sets the direction of a barrier.
7266
7267**Since**: 12
7268
7269**Parameters**
7270
7271| Name| Description|
7272| -------- | -------- |
7273| barrierStyle | Pointer to a barrier configuration. |
7274| value | Direction.  |
7275| index | Index of the barrier. |
7276
7277
7278### OH_ArkUI_BarrierOption_SetId()
7279
7280```
7281void OH_ArkUI_BarrierOption_SetId (ArkUI_BarrierOption * barrierStyle, const char * value, int32_t index )
7282```
7283**Description**
7284
7285Sets the ID of a barrier.
7286
7287**Since**: 12
7288
7289**Parameters**
7290
7291| Name| Description|
7292| -------- | -------- |
7293| barrierStyle | Pointer to a barrier configuration. |
7294| value | ID of the barrier, which must be unique and cannot be the same as the name of any component in the container. |
7295| index | Index of the barrier. |
7296
7297
7298### OH_ArkUI_BarrierOption_SetReferencedId()
7299
7300```
7301void OH_ArkUI_BarrierOption_SetReferencedId (ArkUI_BarrierOption * barrierStyle, const char * value, int32_t index )
7302```
7303**Description**
7304
7305Sets the referenced components of a barrier.
7306
7307**Since**: 12
7308
7309**Parameters**
7310
7311| Name| Description|
7312| -------- | -------- |
7313| barrierStyle | Pointer to a barrier configuration. |
7314| value | Referenced component IDs. |
7315| index | Index of the barrier. |
7316
7317
7318### OH_ArkUI_ConvertToHtml()
7319
7320```
7321const char* OH_ArkUI_ConvertToHtml (ArkUI_StyledString_Descriptor * descriptor)
7322```
7323**Description**
7324
7325Converts styled string information into HTML.
7326
7327**Since**: 14
7328
7329**Parameters**
7330
7331| Name| Description|
7332| -------- | -------- |
7333| descriptor | Pointer to an **ArkUI_StyledString_Descriptor** object. |
7334
7335**Returns**
7336
7337Returns 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.
7338
7339
7340### OH_ArkUI_CreateAsymmetricTransitionEffect()
7341
7342```
7343ArkUI_TransitionEffect* OH_ArkUI_CreateAsymmetricTransitionEffect (ArkUI_TransitionEffect * appear, ArkUI_TransitionEffect * disappear )
7344```
7345**Description**
7346
7347Creates an asymmetric transition effect.
7348
7349**Since**: 12
7350
7351**Parameters**
7352
7353| Name| Description|
7354| -------- | -------- |
7355| appear | Transition effect for appearance. |
7356| disappear | Transition effect for disappearance. |
7357
7358**NOTE**
7359
7360If the **asymmetric** function is not used for constructing **TransitionEffect**, the transition effect takes effect for both appearance and disappearance of the component.
7361
7362**Returns**
7363
7364Returns the asymmetric transition effect; returns **NULL** if a parameter error occurs.
7365
7366
7367### OH_ArkUI_CreateDragActionWithContext()
7368
7369```
7370ArkUI_DragAction* OH_ArkUI_CreateDragActionWithContext (ArkUI_ContextHandle uiContext)
7371```
7372**Description**
7373
7374Creates a drag action object for the specified UI instance.
7375
7376**Since**: 12
7377
7378**Parameters**
7379
7380| Name| Description|
7381| -------- | -------- |
7382| uiContext | Pointer to the UI instance object. |
7383
7384**Returns**
7385
7386Returns the pointer to the created drag action object; returns null if the operation fails.
7387
7388
7389### OH_ArkUI_CreateDragActionWithNode()
7390
7391```
7392ArkUI_DragAction* OH_ArkUI_CreateDragActionWithNode (ArkUI_NodeHandle node)
7393```
7394**Description**
7395
7396Creates 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.
7397
7398**Since**: 12
7399
7400**Parameters**
7401
7402| Name| Description|
7403| -------- | -------- |
7404| node | Pointer to a component node. |
7405
7406**Returns**
7407
7408Returns the pointer to the created drag action object; returns null if the operation fails.
7409
7410
7411### OH_ArkUI_CreateDragPreviewOption()
7412
7413```
7414ArkUI_DragPreviewOption* OH_ArkUI_CreateDragPreviewOption (void )
7415```
7416**Description**
7417
7418Creates an **ArkUI_DragPreviewOption** object.
7419
7420**Since**: 12
7421
7422**Returns**
7423
7424ArkUI_DragPreviewOption object.
7425
7426
7427### OH_ArkUI_CreateMovementTransitionEffect()
7428
7429```
7430ArkUI_TransitionEffect* OH_ArkUI_CreateMovementTransitionEffect (ArkUI_TransitionEdge move)
7431```
7432**Description**
7433
7434Creates a movement object for component transition.
7435
7436**Since**: 12
7437
7438**Parameters**
7439
7440| Name| Description|
7441| -------- | -------- |
7442| move | Panning type. |
7443
7444**Returns**
7445
7446Returns the movement object created for component transition; returns **NULL** if a parameter error occurs.
7447
7448
7449### OH_ArkUI_CreateOpacityTransitionEffect()
7450
7451```
7452ArkUI_TransitionEffect* OH_ArkUI_CreateOpacityTransitionEffect (float opacity)
7453```
7454**Description**
7455
7456Creates an opacity object for component transition.
7457
7458**Since**: 12
7459
7460**Parameters**
7461
7462| Name| Description|
7463| -------- | -------- |
7464| opacity | Opacity. The value range is [0, 1]. |
7465
7466**NOTE**
7467
7468If 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.
7469
7470**Returns**
7471
7472Returns the created opacity object for component transition.
7473
7474
7475### OH_ArkUI_CreateRotationTransitionEffect()
7476
7477```
7478ArkUI_TransitionEffect* OH_ArkUI_CreateRotationTransitionEffect (ArkUI_RotationOptions * rotate)
7479```
7480**Description**
7481
7482Creates a rotation object for component transition.
7483
7484**Since**: 12
7485
7486**Parameters**
7487
7488| Name| Description|
7489| -------- | -------- |
7490| rotate | Rotation parameter object during component transition. |
7491
7492**Returns**
7493
7494Returns the rotation object created for component transition; returns **NULL** if a parameter error occurs.
7495
7496
7497### OH_ArkUI_CreateScaleTransitionEffect()
7498
7499```
7500ArkUI_TransitionEffect* OH_ArkUI_CreateScaleTransitionEffect (ArkUI_ScaleOptions * scale)
7501```
7502**Description**
7503
7504Creates a scaling transition effect object.
7505
7506**Since**: 12
7507
7508**Parameters**
7509
7510| Name| Description|
7511| -------- | -------- |
7512| scale | Scaling settings for component transition. |
7513
7514**Returns**
7515
7516Returns the created scaling transition effect object; returns **NULL** if a parameter error occurs.
7517
7518
7519### OH_ArkUI_CreateTranslationTransitionEffect()
7520
7521```
7522ArkUI_TransitionEffect* OH_ArkUI_CreateTranslationTransitionEffect (ArkUI_TranslationOptions * translate)
7523```
7524**Description**
7525
7526Creates a translation transition effect object.
7527
7528**Since**: 12
7529
7530**Parameters**
7531
7532| Name| Description|
7533| -------- | -------- |
7534| translate | Translation settings for component transition. |
7535
7536**Returns**
7537
7538Returns the created translation transition effect object; returns **NULL** if a parameter error occurs.
7539
7540### OH_ArkUI_Curve_CreateCubicBezierCurve()
7541
7542```
7543ArkUI_CurveHandle OH_ArkUI_Curve_CreateCubicBezierCurve (float x1, float y1, float x2, float y2 )
7544```
7545**Description**
7546
7547Creates a cubic Bezier curve.
7548
7549**Parameters**
7550
7551| Name| Description|
7552| -------- | -------- |
7553| 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**. |
7554| y1 | Y coordinate of the first point on the Bezier curve. |
7555| 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**. |
7556| y2 | Y coordinate of the second point on the Bezier curve. |
7557
7558**Returns**
7559
7560Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
7561
7562
7563### OH_ArkUI_Curve_CreateCurveByType()
7564
7565```
7566ArkUI_CurveHandle OH_ArkUI_Curve_CreateCurveByType (ArkUI_AnimationCurve curve)
7567```
7568**Description**
7569
7570Implements initialization for the interpolation curve, which is used to create an interpolation curve based on the input parameter.
7571
7572**Parameters**
7573
7574| Name| Description|
7575| -------- | -------- |
7576| curve | Curve type. |
7577
7578**Returns**
7579
7580Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
7581
7582
7583### OH_ArkUI_Curve_CreateCustomCurve()
7584
7585```
7586ArkUI_CurveHandle OH_ArkUI_Curve_CreateCustomCurve (void * userData, float(*)(float fraction, void *userdata) interpolate )
7587```
7588**Description**
7589
7590Creates a custom curve.
7591
7592**Parameters**
7593
7594| Name| Description|
7595| -------- | -------- |
7596| userData | Custom data. |
7597| 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. |
7598
7599**Returns**
7600
7601Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
7602
7603
7604### OH_ArkUI_Curve_CreateInterpolatingSpring()
7605
7606```
7607ArkUI_CurveHandle OH_ArkUI_Curve_CreateInterpolatingSpring (float velocity, float mass, float stiffness, float damping )
7608```
7609**Description**
7610
7611Creates an interpolating spring curve animated from 0 to 1. The actual animation value is calculated based on the curve.
7612
7613**Parameters**
7614
7615| Name| Description|
7616| -------- | -------- |
7617| 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. |
7618| 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. |
7619| 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. |
7620| 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. |
7621
7622**NOTE**
7623
7624The animation duration is subject to the curve parameters, rather than the **duration** parameter in **animation** or **animateTo**.
7625
7626**Returns**
7627
7628Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
7629
7630
7631### OH_ArkUI_Curve_CreateResponsiveSpringMotion()
7632
7633```
7634ArkUI_CurveHandle OH_ArkUI_Curve_CreateResponsiveSpringMotion (float response, float dampingFraction, float overlapDuration )
7635```
7636**Description**
7637
7638Creates 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**.
7639
7640**Parameters**
7641
7642| Name| Description|
7643| -------- | -------- |
7644| response | Duration of one complete oscillation. |
7645| 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. |
7646| 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. |
7647
7648**NOTE**
7649
7650The animation duration is subject to the curve parameters, rather than the **duration** parameter in **animation** or **animateTo**.
7651
7652**Returns**
7653
7654Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
7655
7656
7657### OH_ArkUI_Curve_CreateSpringCurve()
7658
7659```
7660ArkUI_CurveHandle OH_ArkUI_Curve_CreateSpringCurve (float velocity, float mass, float stiffness, float damping )
7661```
7662**Description**
7663
7664Creates 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**.
7665
7666**Parameters**
7667
7668| Name| Description|
7669| -------- | -------- |
7670| 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. |
7671| 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. |
7672| 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. |
7673| 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. |
7674
7675**Returns**
7676
7677Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
7678
7679
7680### OH_ArkUI_Curve_CreateSpringMotion()
7681
7682```
7683ArkUI_CurveHandle OH_ArkUI_Curve_CreateSpringMotion (float response, float dampingFraction, float overlapDuration )
7684```
7685**Description**
7686
7687Creates 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.
7688
7689**Parameters**
7690
7691| Name| Description|
7692| -------- | -------- |
7693| response | Duration of one complete oscillation. |
7694| 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. |
7695| 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. |
7696
7697**NOTE**
7698
7699The animation duration is subject to the curve parameters, rather than the **duration** parameter in **animation** or **animateTo**.
7700
7701**Returns**
7702
7703Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
7704
7705
7706### OH_ArkUI_Curve_CreateStepsCurve()
7707
7708```
7709ArkUI_CurveHandle OH_ArkUI_Curve_CreateStepsCurve (int32_t count, bool end )
7710```
7711**Description**
7712
7713Creates a step curve.
7714
7715**Parameters**
7716
7717| Name| Description|
7718| -------- | -------- |
7719| count | Number of tiers. The value must be a positive integer. Value range: [1, +∞). |
7720| 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. |
7721
7722**Returns**
7723
7724Returns the pointer to the interpolation object of the curve; returns **NULL** if a parameter error occurs.
7725
7726
7727### OH_ArkUI_Curve_DisposeCurve()
7728
7729```
7730void OH_ArkUI_Curve_DisposeCurve (ArkUI_CurveHandle curveHandle)
7731```
7732**Description**
7733
7734Disposes of a custom curve.
7735
7736**Parameters**
7737
7738| Name| Description|
7739| -------- | -------- |
7740| curve | Returns the pointer to the interpolation object of the curve; |
7741
7742
7743### OH_ArkUI_CustomProperty_Destroy()
7744
7745```
7746void OH_ArkUI_CustomProperty_Destroy (ArkUI_CustomProperty * handle)
7747```
7748**Description**
7749
7750Destroys a **CustomProperty** instance.
7751
7752**Since**: 14
7753
7754**Parameters**
7755
7756| Name| Description|
7757| -------- | -------- |
7758| handle | **CustomProperty** instance to destroy. |
7759
7760
7761### OH_ArkUI_CustomProperty_GetStringValue()
7762
7763```
7764const char* OH_ArkUI_CustomProperty_GetStringValue (ArkUI_CustomProperty * handle)
7765```
7766**Description**
7767
7768Obtains the value of a custom property.
7769
7770**Since**: 14
7771
7772**Parameters**
7773
7774| Name| Description|
7775| -------- | -------- |
7776| handle | Pointer to the custom property object. |
7777
7778**Returns**
7779
7780Returns the value of the custom property.
7781
7782
7783### OH_ArkUI_CustomSpanDrawInfo_Create()
7784
7785```
7786ArkUI_CustomSpanDrawInfo* OH_ArkUI_CustomSpanDrawInfo_Create (void )
7787```
7788**Description**
7789
7790Creates drawing information for this custom span.
7791
7792**Since**: 12
7793
7794**Returns**
7795
7796Returns a **CustomSpanDrawInfo** instance. If a null pointer is returned, the memory may be insufficient.
7797
7798
7799### OH_ArkUI_CustomSpanDrawInfo_Dispose()
7800
7801```
7802void OH_ArkUI_CustomSpanDrawInfo_Dispose (ArkUI_CustomSpanDrawInfo * info)
7803```
7804**Description**
7805
7806Disposes of drawing information for this custom span.
7807
7808**Since**: 12
7809
7810**Parameters**
7811
7812| Name| Description|
7813| -------- | -------- |
7814| info | Pointer to the drawing information of a custom span. |
7815
7816
7817### OH_ArkUI_CustomSpanDrawInfo_GetBaseline()
7818
7819```
7820float OH_ArkUI_CustomSpanDrawInfo_GetBaseline (ArkUI_CustomSpanDrawInfo * info)
7821```
7822**Description**
7823
7824Obtains the baseline offset of the custom span relative to the mounted component.
7825
7826**Since**: 12
7827
7828**Parameters**
7829
7830| Name| Description|
7831| -------- | -------- |
7832| info | Pointer to the drawing information of a custom span. |
7833
7834**Returns**
7835
7836Returns the baseline offset. If a parameter error occurs, **0.0f** is returned. A possible cause is that mandatory parameters are left unspecified.
7837
7838### OH_ArkUI_NodeUtils_GetWindowInfo()
7839
7840```
7841int32_t OH_ArkUI_NodeUtils_GetWindowInfo(ArkUI_NodeHandle node, ArkUI_HostWindowInfo** info)
7842```
7843**Description**
7844
7845Obtains the information about the window to which a node belongs.
7846
7847**Since**: 15
7848
7849**Parameters**
7850
7851| Name| Description|
7852| -------- | -------- |
7853| node | Pointer to the target node.|
7854| info | Pointer to the window information object.|
7855
7856**Returns**
7857
7858Returns the result code. Returns **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_NODE_NOT_ON_MAIN_TREE** if the node is not mounted on the main component tree.
7859
7860### OH_ArkUI_HostWindowInfo_GetName()
7861
7862```
7863const char* OH_ArkUI_HostWindowInfo_GetName(ArkUI_HostWindowInfo* info)
7864```
7865**Description**
7866
7867Obtains the window name from a **HostWindowInfo** object.
7868
7869**Since**: 15
7870
7871**Parameters**
7872
7873| Name| Description|
7874| -------- | -------- |
7875| info | **HostWindowInfo** object.|
7876
7877**Returns**
7878
7879Returns the window name obtained from the **HostWindowInfo** object.
7880
7881### OH_ArkUI_HostWindowInfo_Destroy()
7882
7883```
7884void OH_ArkUI_HostWindowInfo_Destroy(ArkUI_HostWindowInfo* info)
7885```
7886**Description**
7887
7888Destroys n **HostWindowInfo** object.
7889
7890**Since**: 15
7891
7892**Parameters**
7893
7894| Name| Description|
7895| -------- | -------- |
7896| info | **HostWindowInfo** object to be destroyed.|
7897
7898### OH_ArkUI_NodeUtils_MoveTo()
7899
7900```
7901int32_t OH_ArkUI_NodeUtils_MoveTo(ArkUI_NodeHandle node, ArkUI_NodeHandle target_parent, int32_t index)
7902```
7903**Description**
7904
7905Moves a node to a target parent node as a child.
7906
7907**Since**: 16
7908
7909**Parameters**
7910
7911| Name| Description|
7912| -------- | -------- |
7913| node | Node to be moved.|
7914| target_parent | Pointer to the target parent node.|
7915| index | Index of the node after the movement. If the index is invalid, the node will be added to the end of the target parent node.|
7916
7917**Returns**
7918
7919Returns the result code. Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful; returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7920
7921### OH_ArkUI_NodeUtils_GetAttachedNodeHandleById()
7922
7923```
7924int32_t OH_ArkUI_NodeUtils_GetAttachedNodeHandleById(const char* id, ArkUI_NodeHandle* node)
7925```
7926**Description**
7927
7928Obtains the target node based on the provided user ID.
7929
7930**Since**: 15
7931
7932**Parameters**
7933
7934| Name| Description|
7935| -------- | -------- |
7936| id | ID of the target node.|
7937| node | Pointer to the target parent node.|
7938
7939**Returns**
7940
7941Returns the result code. Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful; returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7942
7943### OH_ArkUI_NodeUtils_SetCrossLanguageOption()
7944
7945```
7946int32_t OH_ArkUI_NodeUtils_SetCrossLanguageOption(ArkUI_NodeHandle node, ArkUI_CrossLanguageOption* option)
7947```
7948**Description**
7949
7950Sets the cross-language options for the target node.
7951
7952**Since**: 15
7953
7954**Parameters**
7955
7956| Name| Description|
7957| -------- | -------- |
7958| node | Pointer to the target node.|
7959| option | Cross-language configuration class. For details, see **ArkUI_CrossLanguageOption**.|
7960
7961**Returns**
7962
7963Returns the result code. Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful; returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7964
7965### OH_ArkUI_NodeUtils_GetCrossLanguageOption()
7966
7967```
7968int32_t OH_ArkUI_NodeUtils_GetCrossLanguageOption(ArkUI_NodeHandle node, ArkUI_CrossLanguageOption* option)
7969```
7970**Description**
7971
7972Obtains the cross-language options for the target node.
7973
7974**Since**: 15
7975
7976**Parameters**
7977
7978| Name| Description|
7979| -------- | -------- |
7980| node | Pointer to the target node.|
7981| option | Cross-language configuration class. For details, see **ArkUI_CrossLanguageOption**.|
7982
7983**Returns**
7984
7985Returns the result code. Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful; returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
7986
7987### OH_ArkUI_NodeUtils_GetFirstChildIndexWithoutExpand()
7988
7989```
7990int32_t OH_ArkUI_NodeUtils_GetFirstChildIndexWithoutExpand(ArkUI_NodeHandle node, uint32_t* index)
7991```
7992**Description**
7993
7994Obtains the index of the first child node of the target node in the tree without expanding any nodes.
7995
7996**Since**: 15
7997
7998**Parameters**
7999
8000| Name| Description|
8001| -------- | -------- |
8002| node | Pointer to the target node.|
8003| index | Pointer to a variable where the index of the first child node is stored.|
8004
8005**Returns**
8006
8007Returns the result code. Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful; returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
8008
8009### OH_ArkUI_NodeUtils_GetLastChildIndexWithoutExpand()
8010
8011```
8012int32_t OH_ArkUI_NodeUtils_GetLastChildIndexWithoutExpand(ArkUI_NodeHandle node, uint32_t* index)
8013```
8014**Description**
8015
8016Obtains the index of the last child node of the target node in the tree without expanding any nodes.
8017
8018**Since**: 15
8019
8020**Parameters**
8021
8022| Name| Description|
8023| -------- | -------- |
8024| node | Pointer to the target node.|
8025| index | Pointer to a variable where the index of the last child node is stored.|
8026
8027**Returns**
8028
8029Returns the result code. Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful; returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
8030
8031### OH_ArkUI_NodeUtils_GetChildWithExpandMode()
8032
8033```
8034int32_t OH_ArkUI_NodeUtils_GetChildWithExpandMode(ArkUI_NodeHandle node, int32_t position,
8035    ArkUI_NodeHandle* subnode, uint32_t expandMode)
8036```
8037**Description**
8038
8039Obtains a child node at the specified index using different expansion modes.
8040
8041**Since**: 15
8042
8043**Parameters**
8044
8045| Name| Description|
8046| -------- | -------- |
8047| node | Pointer to the target node.|
8048| position | Index of the child node to obtain.|
8049| subnode | Pointer to the obtained child node.|
8050| expandMode | Expansion mode for node traversal. For details, see **ArkUI_ExpandMode**.|
8051
8052**Returns**
8053
8054Returns the result code. Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful; returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
8055
8056### OH_ArkUI_CustomSpanDrawInfo_GetLineBottom()
8057
8058```
8059float OH_ArkUI_CustomSpanDrawInfo_GetLineBottom (ArkUI_CustomSpanDrawInfo * info)
8060```
8061**Description**
8062
8063Obtains the bottom margin of the custom span relative to the mounted component.
8064
8065**Since**: 12
8066
8067**Parameters**
8068
8069| Name| Description|
8070| -------- | -------- |
8071| info | Pointer to the drawing information of a custom span. |
8072
8073**Returns**
8074
8075Returns the bottom margin. If a parameter error occurs, **0.0f** is returned. A possible cause is that mandatory parameters are left unspecified.
8076
8077
8078### OH_ArkUI_CustomSpanDrawInfo_GetLineTop()
8079
8080```
8081float OH_ArkUI_CustomSpanDrawInfo_GetLineTop (ArkUI_CustomSpanDrawInfo * info)
8082```
8083**Description**
8084
8085Obtains the top margin of the custom span relative to the mounted component.
8086
8087**Since**: 12
8088
8089**Parameters**
8090
8091| Name| Description|
8092| -------- | -------- |
8093| info | Pointer to the drawing information of a custom span. |
8094
8095**Returns**
8096
8097Returns the top margin. If a parameter error occurs, **0.0f** is returned. A possible cause is that mandatory parameters are left unspecified.
8098
8099
8100### OH_ArkUI_CustomSpanDrawInfo_GetXOffset()
8101
8102```
8103float OH_ArkUI_CustomSpanDrawInfo_GetXOffset (ArkUI_CustomSpanDrawInfo * info)
8104```
8105**Description**
8106
8107Obtains the x-axis offset of the custom span relative to the mounted component.
8108
8109**Since**: 12
8110
8111**Parameters**
8112
8113| Name| Description|
8114| -------- | -------- |
8115| info | Pointer to the drawing information of a custom span. |
8116
8117**Returns**
8118
8119Returns the x-axis offset. If a parameter error occurs, **0.0f** is returned. A possible cause is that mandatory parameters are left unspecified.
8120
8121
8122### OH_ArkUI_CustomSpanMeasureInfo_Create()
8123
8124```
8125ArkUI_CustomSpanMeasureInfo* OH_ArkUI_CustomSpanMeasureInfo_Create (void )
8126```
8127**Description**
8128
8129Creates measurement information for this custom span.
8130
8131**Since**: 12
8132
8133**Returns**
8134
8135Returns a **CustomSpanMeasureInfo** instance. If a null pointer is returned, the memory may be insufficient.
8136
8137
8138### OH_ArkUI_CustomSpanMeasureInfo_Dispose()
8139
8140```
8141void OH_ArkUI_CustomSpanMeasureInfo_Dispose (ArkUI_CustomSpanMeasureInfo * info)
8142```
8143**Description**
8144
8145Disposes of measurement information of a custom span.
8146
8147**Since**: 12
8148
8149**Parameters**
8150
8151| Name| Description|
8152| -------- | -------- |
8153| info | Pointer to the measurement information of a custom span. |
8154
8155
8156### OH_ArkUI_CustomSpanMeasureInfo_GetFontSize()
8157
8158```
8159float OH_ArkUI_CustomSpanMeasureInfo_GetFontSize (ArkUI_CustomSpanMeasureInfo * info)
8160```
8161**Description**
8162
8163Obtains the font size of the parent text node of a custom span.
8164
8165**Since**: 12
8166
8167**Parameters**
8168
8169| Name| Description|
8170| -------- | -------- |
8171| info | Pointer to the measurement information of a custom span. |
8172
8173**Returns**
8174
8175Returns 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.
8176
8177
8178### OH_ArkUI_CustomSpanMetrics_Create()
8179
8180```
8181ArkUI_CustomSpanMetrics* OH_ArkUI_CustomSpanMetrics_Create (void )
8182```
8183**Description**
8184
8185Creates measurement metrics for this custom span.
8186
8187**Since**: 12
8188
8189**Returns**
8190
8191Returns a **CustomSpanMetrics** instance. If a null pointer is returned, the memory may be insufficient.
8192
8193
8194### OH_ArkUI_CustomSpanMetrics_Dispose()
8195
8196```
8197void OH_ArkUI_CustomSpanMetrics_Dispose (ArkUI_CustomSpanMetrics * metrics)
8198```
8199**Description**
8200
8201Disposes of measurement metrics of this custom span.
8202
8203**Since**: 12
8204
8205**Parameters**
8206
8207| Name| Description|
8208| -------- | -------- |
8209| metrics | Returns a **CustomSpanMetrics** instance. |
8210
8211
8212### OH_ArkUI_CustomSpanMetrics_SetHeight()
8213
8214```
8215int32_t OH_ArkUI_CustomSpanMetrics_SetHeight (ArkUI_CustomSpanMetrics * metrics, float height )
8216```
8217**Description**
8218
8219Sets the height for a custom span.
8220
8221**Since**: 12
8222
8223**Parameters**
8224
8225| Name| Description|
8226| -------- | -------- |
8227| metrics | Returns a **CustomSpanMetrics** instance. |
8228| height | Height, in vp. |
8229
8230**Returns**
8231
8232Returns **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.
8233
8234
8235### OH_ArkUI_CustomSpanMetrics_SetWidth()
8236
8237```
8238int32_t OH_ArkUI_CustomSpanMetrics_SetWidth (ArkUI_CustomSpanMetrics * metrics, float width )
8239```
8240**Description**
8241
8242Sets the width for a custom span.
8243
8244**Since**: 12
8245
8246**Parameters**
8247
8248| Name| Description|
8249| -------- | -------- |
8250| metrics | Returns a **CustomSpanMetrics** instance. |
8251| width | Width, in vp. |
8252
8253**Returns**
8254
8255Returns **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.
8256
8257
8258### OH_ArkUI_DialogDismissEvent_GetDismissReason()
8259
8260```
8261int32_t OH_ArkUI_DialogDismissEvent_GetDismissReason (ArkUI_DialogDismissEvent * event)
8262```
8263**Description**
8264
8265Obtains the dismissal reason from a dialog box dismiss event object.
8266
8267**Since**: 12
8268
8269**Parameters**
8270
8271| Name| Description|
8272| -------- | -------- |
8273| event | Pointer to a dialog box dismiss event object.|
8274
8275**Returns**
8276
8277Returns 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.
8278
8279### OH_ArkUI_CustomDialog_OpenDialog()
8280
8281```
8282int32_t OH_ArkUI_CustomDialog_OpenDialog(ArkUI_CustomDialogOptions* options, void (*callback)(int32_t dialogId))
8283```
8284**Description**
8285
8286Displays a custom dialog box.
8287
8288**Since**: 18
8289
8290**Parameters**
8291
8292| Name| Description|
8293| -------- | -------- |
8294| options | Dialog box parameters.|
8295| callback | Callback invoked when the dialog box is displayed. The parameter is the dialog box ID.|
8296
8297**Returns**
8298
8299Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8300
8301### OH_ArkUI_CustomDialog_UpdateDialog()
8302
8303```
8304int32_t OH_ArkUI_CustomDialog_UpdateDialog(ArkUI_CustomDialogOptions* options, void (*callback)(int32_t dialogId))
8305```
8306**Description**
8307
8308Updates a custom dialog box.
8309
8310**Since**: 18
8311
8312**Parameters**
8313
8314| Name| Description|
8315| -------- | -------- |
8316| options | Dialog box parameters.|
8317| callback | Callback invoked when the dialog box is updated. The parameter is the dialog box ID.|
8318
8319**Returns**
8320
8321Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8322
8323### OH_ArkUI_CustomDialog_CloseDialog()
8324
8325```
8326int32_t OH_ArkUI_CustomDialog_CloseDialog(int32_t dialogId)
8327```
8328**Description**
8329
8330Closes a custom dialog box.
8331
8332**Since**: 18
8333
8334**Parameters**
8335
8336| Name| Description|
8337| -------- | -------- |
8338| dialogId | ID of the dialog box to close.|
8339
8340**Returns**
8341
8342Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8343
8344### OH_ArkUI_CustomDialog_CreateOptions()
8345
8346```
8347ArkUI_CustomDialogOptions* OH_ArkUI_CustomDialog_CreateOptions(ArkUI_NodeHandle content)
8348```
8349**Description**
8350
8351Creates options for a custom dialog.
8352
8353**Since**: 18
8354
8355**Parameters**
8356
8357| Name| Description|
8358| -------- | -------- |
8359| content | Content of the custom dialog box.|
8360
8361**Returns**
8362
8363Returns the pointer to the custom dialog box options.
8364
8365### OH_ArkUI_CustomDialog_DisposeOptions()
8366
8367```
8368void OH_ArkUI_CustomDialog_DisposeOptions(ArkUI_CustomDialogOptions* options)
8369```
8370**Description**
8371
8372Destroys custom dialog box options.
8373
8374**Since**: 18
8375
8376**Parameters**
8377
8378| Name| Description|
8379| -------- | -------- |
8380| options | Pointer to the custom dialog box options.|
8381
8382
8383### OH_ArkUI_CustomDialog_SetLevelMode()
8384
8385```
8386int32_t OH_ArkUI_CustomDialog_SetLevelMode(ArkUI_CustomDialogOptions* options, ArkUI_LevelMode levelMode)
8387```
8388**Description**
8389
8390Sets the display level of a dialog box.
8391
8392**Since**: 18
8393
8394**Parameters**
8395
8396| Name| Description|
8397| -------- | -------- |
8398| options | Pointer to the custom dialog box options.|
8399| levelMode | Display level to set, specified by an enumeration value of **ArkUI_LevelMode**.|
8400
8401**NOTE**
8402
8403This method must be called before the **OH_ArkUI_CustomDialog_OpenDialog** method.
8404
8405**Returns**
8406
8407Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8408
8409### OH_ArkUI_CustomDialog_SetLevelUniqueId()
8410
8411```
8412int32_t OH_ArkUI_CustomDialog_SetLevelUniqueId(ArkUI_CustomDialogOptions* options, int32_t uniqueId)
8413```
8414**Description**
8415
8416Sets the ID of the node under the dialog box's display level.
8417
8418**Since**: 18
8419
8420**Parameters**
8421
8422| Name| Description|
8423| -------- | -------- |
8424| options | Pointer to the custom dialog box options.|
8425| uniqueId | ID of the node under the dialog box's display level. The dialog box will be displayed on the same page as this node.|
8426
8427**NOTE**
8428
8429This method must be called before the **OH_ArkUI_CustomDialog_OpenDialog** method.
8430
8431**Returns**
8432
8433Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8434
8435### OH_ArkUI_CustomDialog_SetImmersiveMode()
8436
8437```
8438int32_t OH_ArkUI_CustomDialog_SetImmersiveMode(ArkUI_CustomDialogOptions* options, ArkUI_ImmersiveMode immersiveMode)
8439```
8440**Description**
8441
8442Sets the display area of the embedded pop-up window mask.
8443
8444**Since**: 18
8445
8446**Parameters**
8447
8448| Name| Description|
8449| -------- | -------- |
8450| options | Pointer to the custom dialog box options.|
8451| immersiveMode | Display area, specified by an enumeration value of **ArkUI_ImmersiveMode**.|
8452
8453**NOTE**
8454
8455This method must be called before the **OH_ArkUI_CustomDialog_OpenDialog** method.
8456
8457**Returns**
8458
8459Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8460
8461### OH_ArkUI_CustomDialog_SetBackgroundColor()
8462
8463```
8464int32_t OH_ArkUI_CustomDialog_SetBackgroundColor(ArkUI_CustomDialogOptions* options, uint32_t backgroundColor)
8465```
8466**Description**
8467
8468Sets the background color of a dialog box.
8469
8470**Since**: 18
8471
8472**Parameters**
8473
8474| Name| Description|
8475| -------- | -------- |
8476| options | Dialog box parameters.|
8477| backgroundColor | Background color of the dialog box.|
8478
8479**Returns**
8480
8481Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8482
8483### OH_ArkUI_CustomDialog_SetCornerRadius()
8484
8485```
8486int32_t OH_ArkUI_CustomDialog_SetCornerRadius(
8487    ArkUI_CustomDialogOptions* options, float topLeft, float topRight, float bottomLeft, float bottomRight)
8488```
8489**Description**
8490
8491Sets the corner radius for a dialog box.
8492
8493**Since**: 18
8494
8495**Parameters**
8496
8497| Name| Description|
8498| -------- | -------- |
8499| options | Dialog box parameters.|
8500| topLeft | Radius of the upper left corner of the dialog box.|
8501| topRight | Radius of the upper right corner of the dialog box.|
8502| bottomLeft |Radius of the lower left corner of the dialog box.|
8503| bottomRight | Radius of the lower right corner of the dialog box.|
8504
8505**Returns**
8506
8507Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8508
8509### OH_ArkUI_CustomDialog_SetBorderWidth()
8510
8511```
8512int32_t OH_ArkUI_CustomDialog_SetBorderWidth(
8513    ArkUI_CustomDialogOptions* options, float top, float right, float bottom, float left, ArkUI_LengthMetricUnit unit)
8514```
8515**Description**
8516
8517Sets the border width of a dialog box.
8518
8519**Since**: 18
8520
8521**Parameters**
8522
8523| Name| Description|
8524| -------- | -------- |
8525| options | Dialog box parameters.|
8526| top | Width of the top border of the dialog box.|
8527| right | Width of the right border of the dialog box.|
8528| bottom |Width of the bottom border of the dialog box.|
8529| left | Width of the left border of the dialog box.|
8530| unit | Unit of the width. The default value is vp.|
8531
8532**Returns**
8533
8534Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8535
8536### OH_ArkUI_CustomDialog_SetBorderColor()
8537
8538```
8539int32_t OH_ArkUI_CustomDialog_SetBorderColor(
8540    ArkUI_CustomDialogOptions* options, uint32_t top, uint32_t right, uint32_t bottom, uint32_t left)
8541```
8542**Description**
8543
8544Sets the border color of the dialog box.
8545
8546**Since**: 18
8547
8548**Parameters**
8549
8550| Name| Description|
8551| -------- | -------- |
8552| options | Dialog box parameters.|
8553| top | Color of the top border of the dialog box.|
8554| right | Color of the right border of the dialog box.|
8555| bottom |Color of the bottom border of the dialog box.|
8556| left | Color of the left border of the dialog box.|
8557
8558**Returns**
8559
8560Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8561
8562### OH_ArkUI_CustomDialog_SetBorderStyle()
8563
8564```
8565int32_t OH_ArkUI_CustomDialog_SetBorderStyle(
8566    ArkUI_CustomDialogOptions* options, int32_t top, int32_t right, int32_t bottom, int32_t left)
8567```
8568**Description**
8569
8570Sets the border style of a dialog box.
8571
8572**Since**: 18
8573
8574**Parameters**
8575
8576| Name| Description|
8577| -------- | -------- |
8578| options | Dialog box parameters.|
8579| top | Style of the top border of the dialog box.|
8580| right | Style of the right border of the dialog box.|
8581| bottom | Style of the bottom border of the dialog box.|
8582| left | Style of the left border of the dialog box.|
8583
8584**Returns**
8585
8586Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8587
8588### OH_ArkUI_CustomDialog_SetWidth()
8589
8590```
8591int32_t OH_ArkUI_CustomDialog_SetWidth(ArkUI_CustomDialogOptions* options, float width, ArkUI_LengthMetricUnit unit)
8592```
8593**Description**
8594
8595Sets the width of the dialog box background.
8596
8597**Since**: 18
8598
8599**Parameters**
8600
8601| Name| Description|
8602| -------- | -------- |
8603| options | Dialog box parameters.|
8604| width | Width of the dialog box background.|
8605| unit | Unit of the width. The default value is vp.|
8606
8607**Returns**
8608
8609Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8610
8611### OH_ArkUI_CustomDialog_SetHeight()
8612
8613```
8614int32_t OH_ArkUI_CustomDialog_SetHeight(ArkUI_CustomDialogOptions* options, float height, ArkUI_LengthMetricUnit unit)
8615```
8616**Description**
8617
8618Sets the height of the dialog box background.
8619
8620**Since**: 18
8621
8622**Parameters**
8623
8624| Name| Description|
8625| -------- | -------- |
8626| options | Dialog box parameters.|
8627| height | Height of the dialog box background.|
8628| unit | Unit of the height. The default value is vp.|
8629
8630**Returns**
8631
8632Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8633
8634### OH_ArkUI_CustomDialog_SetShadow()
8635
8636```
8637int32_t OH_ArkUI_CustomDialog_SetShadow(ArkUI_CustomDialogOptions* options, ArkUI_ShadowStyle shadow)
8638```
8639**Description**
8640
8641Sets the shadow of the dialog box background.
8642
8643**Since**: 18
8644
8645**Parameters**
8646
8647| Name| Description|
8648| -------- | -------- |
8649| options | Dialog box parameters.|
8650| shadow | Shadow style of the background, specified by an enumerated value.|
8651
8652**Returns**
8653
8654Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8655
8656### OH_ArkUI_CustomDialog_SetCustomShadow()
8657
8658```
8659int32_t OH_ArkUI_CustomDialog_SetCustomShadow(
8660    ArkUI_CustomDialogOptions* options, const ArkUI_AttributeItem* customShadow)
8661```
8662**Description**
8663
8664Sets the custom shadow of the dialog box background.
8665
8666**Since**: 18
8667
8668**Parameters**
8669
8670| Name| Description|
8671| -------- | -------- |
8672| options | Dialog box parameters.|
8673| customShadow | Custom shadow parameter. The format is the same as that of the **NODE_SHADOW** property.|
8674
8675**Returns**
8676
8677Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8678
8679### OH_ArkUI_CustomDialog_SetBackgroundBlurStyle()
8680
8681```
8682int32_t OH_ArkUI_CustomDialog_SetBackgroundBlurStyle(ArkUI_CustomDialogOptions* options, ArkUI_BlurStyle blurStyle)
8683```
8684**Description**
8685
8686Sets the background blur style of the dialog box.
8687
8688**Since**: 18
8689
8690**Parameters**
8691
8692| Name| Description|
8693| -------- | -------- |
8694| options | Dialog box parameters.|
8695| blurStyle | Background blur style, specified by an enumerated value.|
8696
8697**Returns**
8698
8699Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8700
8701### OH_ArkUI_CustomDialog_SetAlignment()
8702
8703```
8704int32_t OH_ArkUI_CustomDialog_SetAlignment(
8705    ArkUI_CustomDialogOptions* options, int32_t alignment, float offsetX, float offsetY)
8706```
8707**Description**
8708
8709Sets the alignment mode of a dialog box.
8710
8711**Since**: 18
8712
8713**Parameters**
8714
8715| Name| Description|
8716| -------- | -------- |
8717| options | Dialog box parameters.|
8718| alignment | Alignment mode of the dialog box. The parameter type is **ArkUI_Alignment**.|
8719| offsetX | Horizontal offset of the dialog box. The value is a floating point number.|
8720| offsetY | Vertical offset of the dialog box. The value is a floating point number.|
8721
8722**Returns**
8723
8724Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8725
8726### OH_ArkUI_CustomDialog_SetModalMode()
8727
8728```
8729int32_t OH_ArkUI_CustomDialog_SetModalMode(ArkUI_CustomDialogOptions* options, bool isModal)
8730```
8731**Description**
8732
8733Sets the modal mode for a custom dialog box.
8734
8735**Since**: 18
8736
8737**Parameters**
8738
8739| Name| Description|
8740| -------- | -------- |
8741| options | Dialog box parameters.|
8742| isModal | Whether the dialog box is a modal. A modal dialog box has a mask applied, while a non-modal dialog box does not. The value **true** means that the dialog box is a modal.|
8743
8744**Returns**
8745
8746Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8747
8748### OH_ArkUI_CustomDialog_SetAutoCancel()
8749
8750```
8751int32_t OH_ArkUI_CustomDialog_SetAutoCancel(ArkUI_CustomDialogOptions* options, bool autoCancel)
8752```
8753**Description**
8754
8755Specifies whether to allow users to touch the mask to dismiss the custom dialog box.
8756
8757**Since**: 18
8758
8759**Parameters**
8760
8761| Name| Description|
8762| -------- | -------- |
8763| options | Dialog box parameters.|
8764| autoCancel | Whether to allow users to touch the mask to dismiss the dialog box. The value **true** means to allow users to do so, and **false** means the opposite.|
8765
8766**Returns**
8767
8768Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8769
8770### OH_ArkUI_CustomDialog_SetSubwindowMode()
8771
8772```
8773int32_t OH_ArkUI_CustomDialog_SetSubwindowMode(ArkUI_CustomDialogOptions* options, bool isShowInSubwindow)
8774```
8775**Description**
8776
8777Sets whether to display the dialog box in a subwindow.
8778
8779**Since**: 18
8780
8781**Parameters**
8782
8783| Name| Description|
8784| -------- | -------- |
8785| options | Dialog box parameters.|
8786| isShowInSubwindow | Whether to show the dialog box in a subwindow when the dialog box needs to be displayed outside the main window. The default value is **false**, meaning the dialog box is displayed within the application, not in a separate subwindow.|
8787
8788**Returns**
8789
8790Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8791
8792### OH_ArkUI_CustomDialog_SetMask()
8793
8794```
8795int32_t OH_ArkUI_CustomDialog_SetMask(
8796    ArkUI_CustomDialogOptions* options, uint32_t maskColor, const ArkUI_Rect* maskRect)
8797```
8798**Description**
8799
8800Sets the mask for a custom dialog box.
8801
8802**Since**: 18
8803
8804**Parameters**
8805
8806| Name| Description|
8807| -------- | -------- |
8808| options | Dialog box parameters.|
8809| maskColor | Mask color, in 0xargb format.|
8810| maskRect | Pointer to the mask area. Events outside the mask area are transparently transmitted, and events within the mask area are not. The parameter type is **ArkUI_Rect**.|
8811
8812**Returns**
8813
8814Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8815
8816### OH_ArkUI_CustomDialog_SetKeyboardAvoidMode()
8817
8818```
8819int32_t OH_ArkUI_CustomDialog_SetKeyboardAvoidMode(
8820    ArkUI_CustomDialogOptions* options, ArkUI_KeyboardAvoidMode keyboardAvoidMode)
8821```
8822**Description**
8823
8824Sets the keyboard avoidance mode of a dialog box.
8825
8826**Since**: 18
8827
8828**Parameters**
8829
8830| Name| Description|
8831| -------- | -------- |
8832| options | Dialog box parameters.|
8833| keyboardAvoidMode | Keyboard avoidance mode, specified by an enumerated value.|
8834
8835**Returns**
8836
8837Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8838
8839### OH_ArkUI_CustomDialog_SetHoverModeEnabled()
8840
8841```
8842int32_t OH_ArkUI_CustomDialog_SetHoverModeEnabled(ArkUI_CustomDialogOptions* options, bool enabled)
8843```
8844**Description**
8845
8846Sets whether to enable the hover mode for a dialog box.
8847
8848**Since**: 18
8849
8850**Parameters**
8851
8852| Name| Description|
8853| -------- | -------- |
8854| options | Dialog box parameters.|
8855| enabled | Whether to enable the hover mode. The default value is **false**.|
8856
8857**Returns**
8858
8859Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8860
8861### OH_ArkUI_CustomDialog_SetHoverModeArea()
8862
8863```
8864int32_t OH_ArkUI_CustomDialog_SetHoverModeArea(
8865    ArkUI_CustomDialogOptions* options, ArkUI_HoverModeAreaType hoverModeAreaType)
8866```
8867**Description**
8868
8869Sets the default display area of a dialog box in hover mode.
8870
8871**Since**: 18
8872
8873**Parameters**
8874
8875| Name| Description|
8876| -------- | -------- |
8877| options | Dialog box parameters.|
8878| hoverModeAreaType | Display area in hover mode, specified by an enumerated value.|
8879
8880**Returns**
8881
8882Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8883
8884### OH_ArkUI_CustomDialog_RegisterOnWillDismissCallback()
8885
8886```
8887int32_t OH_ArkUI_CustomDialog_RegisterOnWillDismissCallback(
8888    ArkUI_CustomDialogOptions* options, void* userData, void (*callback)(ArkUI_DialogDismissEvent* event))
8889```
8890**Description**
8891
8892Registers a callback for the dismissal event of a custom dialog box.
8893
8894**Since**: 18
8895
8896**Parameters**
8897
8898| Name| Description|
8899| -------- | -------- |
8900| options | Dialog box parameters.|
8901| userData | Returns the pointer to user data.|
8902| callback | Callback for the dismissal event of the custom dialog box.|
8903
8904**Returns**
8905
8906Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8907
8908### OH_ArkUI_CustomDialog_RegisterOnWillAppearCallback()
8909
8910```
8911int32_t OH_ArkUI_CustomDialog_RegisterOnWillAppearCallback(
8912    ArkUI_CustomDialogOptions* options, void* userData, void (*callback)(void* userData))
8913```
8914**Description**
8915
8916Registers a callback to be invoked when the specified custom dialog box is about to appear.
8917
8918**Since**: 18
8919
8920**Parameters**
8921
8922| Name| Description|
8923| -------- | -------- |
8924| options | Dialog box parameters.|
8925| userData | Returns the pointer to user data.|
8926| callback | Event callback when the dialog box is about to appear.|
8927
8928**Returns**
8929
8930Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8931
8932### OH_ArkUI_CustomDialog_RegisterOnDidAppearCallback()
8933
8934```
8935int32_t OH_ArkUI_CustomDialog_RegisterOnDidAppearCallback(
8936    ArkUI_CustomDialogOptions* options, void* userData, void (*callback)(void* userData))
8937```
8938**Description**
8939
8940Registers a callback to be invoked when the specifiedcustom dialog box appears.
8941
8942**Since**: 18
8943
8944**Parameters**
8945
8946| Name| Description|
8947| -------- | -------- |
8948| options | Dialog box parameters.|
8949| userData | Returns the pointer to user data.|
8950| callback | Event callback when the dialog box appears.|
8951
8952**Returns**
8953
8954Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8955
8956### OH_ArkUI_CustomDialog_RegisterOnWillDisappearCallback()
8957
8958```
8959int32_t OH_ArkUI_CustomDialog_RegisterOnWillDisappearCallback(
8960    ArkUI_CustomDialogOptions* options, void* userData, void (*callback)(void* userData))
8961```
8962**Description**
8963
8964Registers a callback to be invoked when the specified custom dialog box is about to disappear.
8965
8966**Since**: 18
8967
8968**Parameters**
8969
8970| Name| Description|
8971| -------- | -------- |
8972| options | Dialog box parameters.|
8973| userData | Returns the pointer to user data.|
8974| callback | Event callback when the dialog box is about to disappear.|
8975
8976**Returns**
8977
8978Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
8979
8980### OH_ArkUI_CustomDialog_RegisterOnDidDisappearCallback()
8981
8982```
8983int32_t OH_ArkUI_CustomDialog_RegisterOnDidDisappearCallback(
8984    ArkUI_CustomDialogOptions* options, void* userData, void (*callback)(void* userData))
8985```
8986**Description**
8987
8988* @brief Registers a callback to be invoked when the specified custom dialog box disappears.
8989
8990**Since**: 18
8991
8992**Parameters**
8993
8994| Name| Description|
8995| -------- | -------- |
8996| options | Dialog box parameters.|
8997| userData | Returns the pointer to user data.|
8998| callback | Event callback when the dialog box disappears.|
8999
9000**Returns**
9001
9002Returns [ARKUI_ERROR_CODE_NO_ERROR](_ark_u_i___native_module.md) if the operation is successful; returns [ARKUI_ERROR_CODE_PARAM_INVALID](_ark_u_i___native_module.md) if a parameter error occurs.
9003
9004### OH_ArkUI_DialogDismissEvent_GetUserData()
9005
9006```
9007void* OH_ArkUI_DialogDismissEvent_GetUserData (ArkUI_DialogDismissEvent * event)
9008```
9009**Description**
9010
9011Obtains the pointer to user data in a dialog box dismiss event object.
9012
9013**Since**: 12
9014
9015**Parameters**
9016
9017| Name| Description|
9018| -------- | -------- |
9019| event | Pointer to a dialog box dismiss event object.|
9020
9021**Returns**
9022
9023Returns the pointer to user data.
9024
9025
9026### OH_ArkUI_DialogDismissEvent_SetShouldBlockDismiss()
9027
9028```
9029void OH_ArkUI_DialogDismissEvent_SetShouldBlockDismiss (ArkUI_DialogDismissEvent * event, bool shouldBlockDismiss )
9030```
9031**Description**
9032
9033Sets whether to block the system behavior of dismissing a dialog box.
9034
9035**Since**: 12
9036
9037**Parameters**
9038
9039| Name| Description|
9040| -------- | -------- |
9041| event | Pointer to a dialog box dismiss event object. |
9042| 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. |
9043
9044
9045### OH_ArkUI_DisallowNodeAnyDropDataTypes()
9046
9047```
9048int32_t OH_ArkUI_DisallowNodeAnyDropDataTypes (ArkUI_NodeHandle node)
9049```
9050**Description**
9051
9052The configuration component is not allowed to accept any data type. This interface resets the data type configured through [OH_ArkUI_SetNodeAllowedDropDataTypes](#oh_arkui_setnodealloweddropdatatypes).
9053
9054**Since**: 12
9055
9056**Parameters**
9057
9058| Name| Description|
9059| -------- | -------- |
9060| node | Pointer to a component node. |
9061
9062**Returns**
9063
9064Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9065
9066
9067### OH_ArkUI_DragAction_Dispose()
9068
9069```
9070void OH_ArkUI_DragAction_Dispose (ArkUI_DragAction * dragAction)
9071```
9072**Description**
9073
9074Disposes of an **ArkUI_DragAction** object.
9075
9076**Since**: 12
9077
9078**Parameters**
9079
9080| Name| Description|
9081| -------- | -------- |
9082| dragAction | Pointer to the target drag action object. |
9083
9084
9085### OH_ArkUI_DragAction_RegisterStatusListener()
9086
9087```
9088int32_t OH_ArkUI_DragAction_RegisterStatusListener (ArkUI_DragAction * dragAction, void * userData, void(*)(ArkUI_DragAndDropInfo *dragAndDropInfo, void *userData) listener )
9089```
9090**Description**
9091
9092Registers a drag status listener. This listener can be used to check whether the data is successfully received and processed.
9093
9094**Since**: 12
9095
9096**Parameters**
9097
9098| Name| Description|
9099| -------- | -------- |
9100| dragAction | Pointer to the target drag action object. |
9101| userData | Custom user data. |
9102| 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. |
9103
9104**Returns**
9105
9106Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9107
9108
9109### OH_ArkUI_DragAction_SetData()
9110
9111```
9112int32_t OH_ArkUI_DragAction_SetData (ArkUI_DragAction * dragAction, OH_UdmfData * data )
9113```
9114**Description**
9115
9116Sets the drag data.
9117
9118**Since**: 12
9119
9120**Parameters**
9121
9122| Name| Description|
9123| -------- | -------- |
9124| dragAction | Pointer to the target drag action object. |
9125| data | Drag data. |
9126
9127**Returns**
9128
9129Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9130
9131
9132### OH_ArkUI_DragAction_SetDragPreviewOption()
9133
9134```
9135int32_t OH_ArkUI_DragAction_SetDragPreviewOption (ArkUI_DragAction * dragAction, ArkUI_DragPreviewOption * option )
9136```
9137**Description**
9138
9139Sets an **ArkUI_DragPreviewOption** object for the specified drag action object.
9140
9141**Since**: 12
9142
9143**Parameters**
9144
9145| Name| Description|
9146| -------- | -------- |
9147| dragAction | Pointer to the target drag action object. |
9148| option | Custom parameters. |
9149
9150**Returns**
9151
9152Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9153
9154
9155### OH_ArkUI_DragAction_SetPixelMaps()
9156
9157```
9158int32_t OH_ArkUI_DragAction_SetPixelMaps (ArkUI_DragAction * dragAction, OH_PixelmapNative * pixelmapArray[], int32_t size )
9159```
9160**Description**
9161
9162Sets the drag previews for a drag action.
9163
9164**Since**: 12
9165
9166**Parameters**
9167
9168| Name| Description|
9169| -------- | -------- |
9170| dragAction | Pointer to the target drag action object. |
9171| pixelmapArray | Drag the bitmap array of the follower map. |
9172| size | Number of drag-and-drop images. |
9173
9174**Returns**
9175
9176Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9177
9178
9179### OH_ArkUI_DragAction_SetPointerId()
9180
9181```
9182int32_t OH_ArkUI_DragAction_SetPointerId (ArkUI_DragAction * dragAction, int32_t pointer )
9183```
9184**Description**
9185
9186Sets 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.
9187
9188**Since**: 12
9189
9190**Parameters**
9191
9192| Name| Description|
9193| -------- | -------- |
9194| dragAction | Pointer to the target drag action object. |
9195| pointer | Pointer ID. The value ranges from 0 to 9. |
9196
9197**Returns**
9198
9199Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9200
9201
9202### OH_ArkUI_DragAction_SetTouchPointX()
9203
9204```
9205int32_t OH_ArkUI_DragAction_SetTouchPointX (ArkUI_DragAction * dragAction, float x )
9206```
9207**Description**
9208
9209Sets the touch point relative to the upper left corner of the first drag preview (pixel map).
9210
9211**Since**: 12
9212
9213**Parameters**
9214
9215| Name| Description|
9216| -------- | -------- |
9217| dragAction | Pointer to the target drag action object. |
9218| x | X value of the hand point coordinate. |
9219
9220**Returns**
9221
9222Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9223
9224
9225### OH_ArkUI_DragAction_SetTouchPointY()
9226
9227```
9228int32_t OH_ArkUI_DragAction_SetTouchPointY (ArkUI_DragAction * dragAction, float y )
9229```
9230**Description**
9231
9232Sets the touch point relative to the upper left corner of the first drag preview (pixel map).
9233
9234**Since**: 12
9235
9236**Parameters**
9237
9238| Name| Description|
9239| -------- | -------- |
9240| dragAction | Pointer to the target drag action object. |
9241| y | Y value of the hand point coordinate. |
9242
9243**Returns**
9244
9245Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9246
9247
9248### OH_ArkUI_DragAction_UnregisterStatusListener()
9249
9250```
9251void OH_ArkUI_DragAction_UnregisterStatusListener (ArkUI_DragAction * dragAction)
9252```
9253**Description**
9254
9255Unregisters a drag status listener.
9256
9257**Since**: 12
9258
9259**Parameters**
9260
9261| Name| Description|
9262| -------- | -------- |
9263| dragAction | Pointer to the target drag action object. |
9264
9265
9266### OH_ArkUI_DragAndDropInfo_GetDragEvent()
9267
9268```
9269ArkUI_DragEvent* OH_ArkUI_DragAndDropInfo_GetDragEvent (ArkUI_DragAndDropInfo * dragAndDropInfo)
9270```
9271**Description**
9272
9273Obtains a drag event based on the specified drag and drop information. The drag event can then be used to obtain the drag result.
9274
9275**Since**: 12
9276
9277**Parameters**
9278
9279| Name| Description|
9280| -------- | -------- |
9281| dragAndDropInfo | Drag-related information returned by the drag status listener. |
9282
9283**Returns**
9284
9285Returns an **ArkUI_DragEvent** object; returns null if an error occurs.
9286
9287
9288### OH_ArkUI_DragAndDropInfo_GetDragStatus()
9289
9290```
9291ArkUI_DragStatus OH_ArkUI_DragAndDropInfo_GetDragStatus (ArkUI_DragAndDropInfo * dragAndDropInfo)
9292```
9293**Description**
9294
9295Obtains the drag status of a drag action.
9296
9297**Since**: 12
9298
9299**Parameters**
9300
9301| Name| Description|
9302| -------- | -------- |
9303| dragAndDropInfo | Drag-related information returned by the drag status listener. |
9304
9305**Returns**
9306
9307Returns an **ArkUI_DragStatus** object; returns **ArkUI_DRAG_STATUS_UNKNOWN** if an error occurs.
9308
9309
9310### OH_ArkUI_DragEvent_DisableDefaultDropAnimation()
9311
9312```
9313int32_t OH_ArkUI_DragEvent_DisableDefaultDropAnimation (ArkUI_DragEvent * event, bool disable )
9314```
9315**Description**
9316
9317Sets whether to disable the default drop animation, which is enabled by default. Use this API to apply a custom drop animation.
9318
9319**Since**: 12
9320
9321**Parameters**
9322
9323| Name| Description|
9324| -------- | -------- |
9325| event | Pointer to an **ArkUI_DragEvent** object. |
9326| disable | Whether to disable the default drop animation. The value **true** means to disable the default drop animation, and **false** means the opposite. |
9327
9328**Returns**
9329
9330Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9331
9332
9333### OH_ArkUI_DragEvent_GetDataTypes()
9334
9335```
9336int32_t OH_ArkUI_DragEvent_GetDataTypes (ArkUI_DragEvent * event, char * eventTypeArray[], int32_t length, int32_t maxStrLen)
9337```
9338**Description**
9339
9340Obtains the type list of drag data types from a drag event.
9341
9342**Since**: 12
9343
9344**Parameters**
9345
9346| Name| Description|
9347| -------- | -------- |
9348| event | Pointer to an **ArkUI_DragEvent** object. |
9349| char | List of the drag data types. You need to create a string array first. |
9350| length | Total length of the array, which cannot be less than the number obtained using [OH_ArkUI_DragEvent_GetDataTypeCount](#oh_arkui_dragevent_getdatatypecount). |
9351| maxStrLen | Maximum length of each data type string. |
9352
9353**Returns**
9354
9355Returns **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_BUFFER_SIZE_ERROR** if the provided buffer size is insufficient.
9356
9357
9358### OH_ArkUI_DragEvent_GetDataTypeCount()
9359
9360```
9361int32_t OH_ArkUI_DragEvent_GetDataTypeCount (ArkUI_DragEvent * event, int32_t * count )
9362```
9363**Description**
9364
9365Obtains the number of drag data types from a drag event.
9366
9367**Since**: 12
9368
9369**Parameters**
9370
9371| Name| Description|
9372| -------- | -------- |
9373| event | Pointer to an **ArkUI_DragEvent** object. |
9374| count | Number of drag data types returned. |
9375
9376**Returns**
9377
9378Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9379
9380
9381### OH_ArkUI_DragEvent_GetDragResult()
9382
9383```
9384int32_t OH_ArkUI_DragEvent_GetDragResult (ArkUI_DragEvent * event, ArkUI_DragResult * result )
9385```
9386**Description**
9387
9388Obtains the drag and drop result from the drag event.
9389
9390**Since**: 12
9391
9392**Parameters**
9393
9394| Name| Description|
9395| -------- | -------- |
9396| event | Pointer to an **ArkUI_DragEvent** object. |
9397| result | Drag result returned. |
9398
9399**Returns**
9400
9401Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9402
9403
9404### OH_ArkUI_DragEvent_GetDropOperation()
9405
9406```
9407int32_t OH_ArkUI_DragEvent_GetDropOperation (ArkUI_DragEvent * event, ArkUI_DropOperation * operation)
9408```
9409**Description**
9410
9411Obtains the data handling method from the drag event.
9412
9413**Since**: 12
9414
9415**Parameters**
9416
9417| Name| Description|
9418| -------- | -------- |
9419| event | Pointer to an **ArkUI_DragEvent** object. |
9420| operation | Data handling method returned. |
9421
9422**Returns**
9423
9424Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9425
9426
9427### OH_ArkUI_DragEvent_GetModifierKeyStates()
9428
9429```
9430int32_t OH_ArkUI_DragEvent_GetModifierKeyStates (ArkUI_DragEvent * event, uint64_t * keys )
9431```
9432**Description**
9433
9434Obtains the pressed status of modifier keys from a drag event.
9435
9436**Since**: 12
9437
9438**Parameters**
9439
9440| Name| Description|
9441| -------- | -------- |
9442| event | Pointer to an **ArkUI_DragEvent** object. |
9443| keys | Returns the modifier key combination that is currently pressed. The application can determine the modifier key combination through bitwise operations. |
9444
9445**Returns**
9446
9447Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9448
9449
9450### OH_ArkUI_DragEvent_GetPreviewRectHeight()
9451
9452```
9453float OH_ArkUI_DragEvent_GetPreviewRectHeight (ArkUI_DragEvent * event)
9454```
9455**Description**
9456
9457Obtains the height of a drag preview from a drag event.
9458
9459**Since**: 12
9460
9461**Parameters**
9462
9463| Name| Description|
9464| -------- | -------- |
9465| event | Pointer to an **ArkUI_DragEvent** object. |
9466
9467**Returns**
9468
9469Returns the height of the drag preview, in px; returns the default value **0** if the input parameter is invalid.
9470
9471
9472### OH_ArkUI_DragEvent_GetPreviewRectWidth()
9473
9474```
9475float OH_ArkUI_DragEvent_GetPreviewRectWidth (ArkUI_DragEvent * event)
9476```
9477**Description**
9478
9479Obtains the width of a drag preview from a drag event.
9480
9481**Since**: 12
9482
9483**Parameters**
9484
9485| Name| Description|
9486| -------- | -------- |
9487| event | Pointer to an **ArkUI_DragEvent** object. |
9488
9489**Returns**
9490
9491Returns the width of the drag preview, in px; returns the default value **0** if the input parameter is invalid.
9492
9493
9494### OH_ArkUI_DragEvent_GetPreviewTouchPointX()
9495
9496```
9497float OH_ArkUI_DragEvent_GetPreviewTouchPointX (ArkUI_DragEvent * event)
9498```
9499**Description**
9500
9501Obtains the X coordinate of the touch point for a drag preview from a drag event.
9502
9503**Since**: 12
9504
9505**Parameters**
9506
9507| Name| Description|
9508| -------- | -------- |
9509| event | Pointer to an **ArkUI_DragEvent** object. |
9510
9511**Returns**
9512
9513Returns the X coordinate of the touch point, in px; returns the default value **0** if the input parameter is invalid.
9514
9515
9516### OH_ArkUI_DragEvent_GetPreviewTouchPointY()
9517
9518```
9519float OH_ArkUI_DragEvent_GetPreviewTouchPointY (ArkUI_DragEvent * event)
9520```
9521**Description**
9522
9523Obtains the Y coordinate of the touch point for a drag preview from a drag event.
9524
9525**Since**: 12
9526
9527**Parameters**
9528
9529| Name| Description|
9530| -------- | -------- |
9531| event | Pointer to an **ArkUI_DragEvent** object. |
9532
9533**Returns**
9534
9535Returns the Y coordinate of the touch point, in px; returns the default value **0** if the input parameter is invalid.
9536
9537
9538### OH_ArkUI_DragEvent_GetTouchPointXToDisplay()
9539
9540```
9541float OH_ArkUI_DragEvent_GetTouchPointXToDisplay (ArkUI_DragEvent * event)
9542```
9543**Description**
9544
9545Obtains the X coordinate of the touch point relative to the display from a drag event.
9546
9547**Since**: 12
9548
9549**Parameters**
9550
9551| Name| Description|
9552| -------- | -------- |
9553| event | Pointer to an **ArkUI_DragEvent** object. |
9554
9555**Returns**
9556
9557Returns the X coordinate of the touch point relative to the display, in px; returns the default value **0** if the input parameter is invalid.
9558
9559
9560### OH_ArkUI_DragEvent_GetTouchPointXToWindow()
9561
9562```
9563float OH_ArkUI_DragEvent_GetTouchPointXToWindow (ArkUI_DragEvent * event)
9564```
9565**Description**
9566
9567Obtains the X coordinate of the touch point relative to the window from a drag event.
9568
9569**Since**: 12
9570
9571**Parameters**
9572
9573| Name| Description|
9574| -------- | -------- |
9575| event | Pointer to an **ArkUI_DragEvent** object. |
9576
9577**Returns**
9578
9579Returns the X coordinate of the touch point relative to the window, in px; returns the default value **0** if the input parameter is invalid.
9580
9581
9582### OH_ArkUI_DragEvent_GetTouchPointYToDisplay()
9583
9584```
9585float OH_ArkUI_DragEvent_GetTouchPointYToDisplay (ArkUI_DragEvent * event)
9586```
9587**Description**
9588
9589Obtains the Y coordinate of the touch point relative to the display from a drag event.
9590
9591**Since**: 12
9592
9593**Parameters**
9594
9595| Name| Description|
9596| -------- | -------- |
9597| event | Pointer to an **ArkUI_DragEvent** object. |
9598
9599**Returns**
9600
9601Returns the Y coordinate of the touch point relative to the display, in px; returns the default value **0** if the input parameter is invalid.
9602
9603
9604### OH_ArkUI_DragEvent_GetTouchPointYToWindow()
9605
9606```
9607float OH_ArkUI_DragEvent_GetTouchPointYToWindow (ArkUI_DragEvent * event)
9608```
9609**Description**
9610
9611Obtains the Y coordinate of the touch point relative to the window from a drag event.
9612
9613**Since**: 12
9614
9615**Parameters**
9616
9617| Name| Description|
9618| -------- | -------- |
9619| event | Pointer to an **ArkUI_DragEvent** object. |
9620
9621**Returns**
9622
9623Returns the Y coordinate of the touch point relative to the window, in px; returns the default value **0** if the input parameter is invalid.
9624
9625
9626### OH_ArkUI_DragEvent_GetUdmfData()
9627
9628```
9629int32_t OH_ArkUI_DragEvent_GetUdmfData (ArkUI_DragEvent * event, OH_UdmfData * data )
9630```
9631**Description**
9632
9633Obtain the default drag-and-drop data from ArkUI_DragEvent.
9634
9635**Since**: 12
9636
9637**Parameters**
9638
9639| Name| Description|
9640| -------- | -------- |
9641| event | Pointer to an **ArkUI_DragEvent** object. |
9642| 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. |
9643
9644**Returns**
9645
9646Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9647
9648
9649### OH_ArkUI_DragEvent_GetVelocity()
9650
9651```
9652float OH_ArkUI_DragEvent_GetVelocity (ArkUI_DragEvent * event)
9653```
9654**Description**
9655
9656Obtains the dragging velocity along the main axis.
9657
9658**Since**: 12
9659
9660**Parameters**
9661
9662| Name| Description|
9663| -------- | -------- |
9664| event | Pointer to an **ArkUI_DragEvent** object. |
9665
9666**Returns**
9667
9668Returns the dragging velocity along the main axis, in px; returns the default value **0** if the input parameter is invalid.
9669
9670
9671### OH_ArkUI_DragEvent_GetVelocityX()
9672
9673```
9674float OH_ArkUI_DragEvent_GetVelocityX (ArkUI_DragEvent * event)
9675```
9676**Description**
9677
9678Obtains the dragging velocity along the x-axis.
9679
9680**Since**: 12
9681
9682**Parameters**
9683
9684| Name| Description|
9685| -------- | -------- |
9686| event | Pointer to an **ArkUI_DragEvent** object. |
9687
9688**Returns**
9689
9690Returns the dragging velocity along the x-axis, in px; returns the default value **0** if the input parameter is invalid.
9691
9692
9693### OH_ArkUI_DragEvent_GetVelocityY()
9694
9695```
9696float OH_ArkUI_DragEvent_GetVelocityY (ArkUI_DragEvent * event)
9697```
9698**Description**
9699
9700Obtains the dragging velocity along the y-axis.
9701
9702**Since**: 12
9703
9704**Parameters**
9705
9706| Name| Description|
9707| -------- | -------- |
9708| event | Pointer to an **ArkUI_DragEvent** object. |
9709
9710**Returns**
9711
9712Returns the dragging velocity along the y-axis, in px; returns the default value **0** if the input parameter is invalid.
9713
9714
9715### OH_ArkUI_DragEvent_SetData()
9716
9717```
9718int32_t OH_ArkUI_DragEvent_SetData (ArkUI_DragEvent * event, OH_UdmfData * data )
9719```
9720**Description**
9721
9722Sets drag data for a drag event.
9723
9724**Since**: 12
9725
9726**Parameters**
9727
9728| Name| Description|
9729| -------- | -------- |
9730| event | Pointer to an **ArkUI_DragEvent** object. |
9731| data | Drag data. |
9732
9733**Returns**
9734
9735Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9736
9737
9738### OH_ArkUI_DragEvent_SetDragResult()
9739
9740```
9741int32_t OH_ArkUI_DragEvent_SetDragResult (ArkUI_DragEvent * event, ArkUI_DragResult result )
9742```
9743**Description**
9744
9745Sets the result for a drag event.
9746
9747**Since**: 12
9748
9749**Parameters**
9750
9751| Name| Description|
9752| -------- | -------- |
9753| event | Pointer to an **ArkUI_DragEvent** object. |
9754| result | Drag the data processing result. |
9755
9756**Returns**
9757
9758Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9759
9760
9761### OH_ArkUI_DragEvent_SetSuggestedDropOperation()
9762
9763```
9764int32_t OH_ArkUI_DragEvent_SetSuggestedDropOperation (ArkUI_DragEvent * event, ArkUI_DropOperation dropOperation)
9765```
9766**Description**
9767
9768Sets the data processing mode.
9769
9770**Since**: 12
9771
9772**Parameters**
9773
9774| Name| Description|
9775| -------- | -------- |
9776| proposal | Recommended data processing mode |
9777| proposal | Type of the badge display status. |
9778
9779**Returns**
9780
9781Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9782
9783
9784### OH_ArkUI_DragPreviewOption_Dispose()
9785
9786```
9787void OH_ArkUI_DragPreviewOption_Dispose (ArkUI_DragPreviewOption * option)
9788```
9789**Description**
9790
9791Disposes of an **ArkUI_DragPreviewOption** object.
9792
9793**Since**: 12
9794
9795**Parameters**
9796
9797| Name| Description|
9798| -------- | -------- |
9799| option | Custom parameters. |
9800
9801
9802### OH_ArkUI_DragPreviewOption_SetBadgeNumber()
9803
9804```
9805int32_t OH_ArkUI_DragPreviewOption_SetBadgeNumber (ArkUI_DragPreviewOption * option, uint32_t forcedNumber )
9806```
9807**Description**
9808
9809Sets the count on the badge. The settings will overwrite the value in the **SetDragPreviewNumberBadgeEnabled** API.
9810
9811**Since**: 12
9812
9813**Parameters**
9814
9815| Name| Description|
9816| -------- | -------- |
9817| option | Custom parameters. |
9818| forcedNumber | Number of corner marks. |
9819
9820**Returns**
9821
9822Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9823
9824
9825### OH_ArkUI_DragPreviewOption_SetDefaultAnimationBeforeLiftingEnabled()
9826
9827```
9828int32_t OH_ArkUI_DragPreviewOption_SetDefaultAnimationBeforeLiftingEnabled (ArkUI_DragPreviewOption * option, bool enabled )
9829```
9830**Description**
9831
9832Sets whether to enable the default animation on a click or touch.
9833
9834**Since**: 12
9835
9836**Parameters**
9837
9838| Name| Description|
9839| -------- | -------- |
9840| option | Custom parameters. |
9841| enabled | Whether to enable the default click effect. |
9842
9843**Returns**
9844
9845Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9846
9847
9848### OH_ArkUI_DragPreviewOption_SetDefaultRadiusEnabled()
9849
9850```
9851int32_t OH_ArkUI_DragPreviewOption_SetDefaultRadiusEnabled (ArkUI_DragPreviewOption * option, bool enabled )
9852```
9853**Description**
9854
9855Sets whether to enable the default corner radius effect for an **ArkUI_DragPreviewOption** object. The effect is disabled by default.
9856
9857**Since**: 12
9858
9859**Parameters**
9860
9861| Name| Description|
9862| -------- | -------- |
9863| option | Custom parameters. |
9864| enabled | Whether to enable the default corner radius effect. |
9865
9866**Returns**
9867
9868Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9869
9870
9871### OH_ArkUI_DragPreviewOption_SetDefaultShadowEnabled()
9872
9873```
9874int32_t OH_ArkUI_DragPreviewOption_SetDefaultShadowEnabled (ArkUI_DragPreviewOption * option, bool enabled )
9875```
9876**Description**
9877
9878Sets whether to enable the default shadow effect for an **ArkUI_DragPreviewOption** object. The effect is disabled by default.
9879
9880**Since**: 12
9881
9882**Parameters**
9883
9884| Name| Description|
9885| -------- | -------- |
9886| option | Custom parameters. |
9887| enabled | Whether to enable the default shadow effect. |
9888
9889**Returns**
9890
9891Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9892
9893
9894### OH_ArkUI_DragPreviewOption_SetNumberBadgeEnabled()
9895
9896```
9897int32_t OH_ArkUI_DragPreviewOption_SetNumberBadgeEnabled (ArkUI_DragPreviewOption * option, bool enabled )
9898```
9899**Description**
9900
9901Sets 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.
9902
9903**Since**: 12
9904
9905**Parameters**
9906
9907| Name| Description|
9908| -------- | -------- |
9909| option | Custom parameters. |
9910| enabled | Whether to enable the badge. |
9911
9912**Returns**
9913
9914Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9915
9916
9917### OH_ArkUI_DragPreviewOption_SetScaleMode()
9918
9919```
9920int32_t OH_ArkUI_DragPreviewOption_SetScaleMode (ArkUI_DragPreviewOption * option, ArkUI_DragPreviewScaleMode scaleMode )
9921```
9922**Description**
9923
9924Sets the scale mode for an **ArkUI_DragPreviewOption** object.
9925
9926**Since**: 12
9927
9928**Parameters**
9929
9930| Name| Description|
9931| -------- | -------- |
9932| option | Custom parameters. |
9933| scaleMode | Scale mode to set. |
9934
9935**Returns**
9936
9937Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
9938
9939
9940### OH_ArkUI_DrawableDescriptor_CreateFromAnimatedPixelMap()
9941
9942```
9943ArkUI_DrawableDescriptor* OH_ArkUI_DrawableDescriptor_CreateFromAnimatedPixelMap (OH_PixelmapNativeHandle * array, int32_t size )
9944```
9945**Description**
9946
9947Creates a **DrawableDescriptor** object from an array of **PixelMap** objects.
9948
9949**Since**: 12
9950
9951**Parameters**
9952
9953| Name| Description|
9954| -------- | -------- |
9955| array | Pointer to the array of **PixelMap** objects. |
9956| size | Size of the **PixelMap** object array. |
9957
9958**Returns**
9959
9960Returns the pointer to the created **DrawableDescriptor** object.
9961
9962
9963### OH_ArkUI_DrawableDescriptor_CreateFromPixelMap()
9964
9965```
9966ArkUI_DrawableDescriptor* OH_ArkUI_DrawableDescriptor_CreateFromPixelMap (OH_PixelmapNativeHandle pixelMap)
9967```
9968**Description**
9969
9970Creates a **DrawableDescriptor** object from a **PixelMap** object.
9971
9972**Since**: 12
9973
9974**Parameters**
9975
9976| Name| Description|
9977| -------- | -------- |
9978| pixelMap | Pointer to the **PixelMap** object. |
9979
9980**Returns**
9981
9982Returns the pointer to the created **DrawableDescriptor** object.
9983
9984
9985### OH_ArkUI_DrawableDescriptor_Dispose()
9986
9987```
9988void OH_ArkUI_DrawableDescriptor_Dispose (ArkUI_DrawableDescriptor * drawableDescriptor)
9989```
9990**Description**
9991
9992Disposes of the pointer to a **DrawableDescriptor** object.
9993
9994**Since**: 12
9995
9996**Parameters**
9997
9998| Name| Description|
9999| -------- | -------- |
10000| drawableDescriptor | Pointer to a **DrawableDescriptor** object. |
10001
10002
10003### OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArray()
10004
10005```
10006OH_PixelmapNativeHandle* OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArray (ArkUI_DrawableDescriptor * drawableDescriptor)
10007```
10008**Description**
10009
10010Obtains an array of **PixelMap** objects for playing an animation.
10011
10012**Since**: 12
10013
10014**Parameters**
10015
10016| Name| Description|
10017| -------- | -------- |
10018| drawableDescriptor | Pointer to a **DrawableDescriptor** object. |
10019
10020**Returns**
10021
10022Pointer to the PixelMap image array.
10023
10024
10025### OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArraySize()
10026
10027```
10028int32_t OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArraySize (ArkUI_DrawableDescriptor * drawableDescriptor)
10029```
10030**Description**
10031
10032Obtains an array of **PixelMap** objects for playing an animation.
10033
10034**Since**: 12
10035
10036**Parameters**
10037
10038| Name| Description|
10039| -------- | -------- |
10040| drawableDescriptor | Pointer to a **DrawableDescriptor** object. |
10041
10042**Returns**
10043
10044Size of the PixelMap image array.
10045
10046
10047### OH_ArkUI_DrawableDescriptor_GetAnimationDuration()
10048
10049```
10050int32_t OH_ArkUI_DrawableDescriptor_GetAnimationDuration (ArkUI_DrawableDescriptor * drawableDescriptor)
10051```
10052**Description**
10053
10054Obtains the total playback duration of a PixelMap image array.
10055
10056**Since**: 12
10057
10058**Parameters**
10059
10060| Name| Description|
10061| -------- | -------- |
10062| drawableDescriptor | Pointer to a **DrawableDescriptor** object. |
10063
10064**Returns**
10065
10066Total playback duration, in milliseconds.
10067
10068
10069### OH_ArkUI_DrawableDescriptor_GetAnimationIteration()
10070
10071```
10072int32_t OH_ArkUI_DrawableDescriptor_GetAnimationIteration (ArkUI_DrawableDescriptor * drawableDescriptor)
10073```
10074**Description**
10075
10076Obtains the number of times that a **PixelMap** object array is played.
10077
10078**Since**: 12
10079
10080**Parameters**
10081
10082| Name| Description|
10083| -------- | -------- |
10084| drawableDescriptor | Pointer to a **DrawableDescriptor** object. |
10085
10086**Returns**
10087
10088Returns the number of playback times.
10089
10090
10091### OH_ArkUI_DrawableDescriptor_GetStaticPixelMap()
10092
10093```
10094OH_PixelmapNativeHandle OH_ArkUI_DrawableDescriptor_GetStaticPixelMap (ArkUI_DrawableDescriptor * drawableDescriptor)
10095```
10096**Description**
10097
10098Obtains the pointer to a **PixelMap** object.
10099
10100**Since**: 12
10101
10102**Parameters**
10103
10104| Name| Description|
10105| -------- | -------- |
10106| drawableDescriptor | Pointer to a **DrawableDescriptor** object. |
10107
10108**Returns**
10109
10110Pointer to the PixelMap object.
10111
10112
10113### OH_ArkUI_DrawableDescriptor_SetAnimationDuration()
10114
10115```
10116void OH_ArkUI_DrawableDescriptor_SetAnimationDuration (ArkUI_DrawableDescriptor * drawableDescriptor, int32_t duration )
10117```
10118**Description**
10119
10120Sets the total playback duration of a PixelMap image array.
10121
10122**Since**: 12
10123
10124**Parameters**
10125
10126| Name| Description|
10127| -------- | -------- |
10128| drawableDescriptor | Pointer to a **DrawableDescriptor** object. |
10129| duration | Total playback duration, in milliseconds. |
10130
10131
10132### OH_ArkUI_DrawableDescriptor_SetAnimationIteration()
10133
10134```
10135void OH_ArkUI_DrawableDescriptor_SetAnimationIteration (ArkUI_DrawableDescriptor * drawableDescriptor, int32_t iteration )
10136```
10137**Description**
10138
10139Sets the number of times that a pixel map image array is played.
10140
10141**Since**: 12
10142
10143**Parameters**
10144
10145| Name| Description|
10146| -------- | -------- |
10147| drawableDescriptor | Pointer to a **DrawableDescriptor** object. |
10148| iterations | Number of playback times. |
10149
10150
10151### OH_ArkUI_DrawContext_GetCanvas()
10152
10153```
10154void* OH_ArkUI_DrawContext_GetCanvas (ArkUI_DrawContext * context)
10155```
10156**Description**
10157
10158Obtains the drawing canvas pointer, which can be converted into the OH_Drawing_Canvas pointer of the graphics library for drawing.
10159
10160**Since**: 12
10161
10162**Parameters**
10163
10164| Name| Description|
10165| -------- | -------- |
10166| context | Drawing context. |
10167
10168**Returns**
10169
10170Returns the pointer to the canvas for drawing.
10171
10172
10173### OH_ArkUI_DrawContext_GetSize()
10174
10175```
10176ArkUI_IntSize OH_ArkUI_DrawContext_GetSize (ArkUI_DrawContext * context)
10177```
10178**Description**
10179
10180Obtains the size of a drawing area.
10181
10182**Since**: 12
10183
10184**Parameters**
10185
10186| Name| Description|
10187| -------- | -------- |
10188| context | Drawing context. |
10189
10190**Returns**
10191
10192Returns the size of the drawing area.
10193
10194### OH_ArkUI_FocusActivate()
10195```
10196void OH_ArkUI_FocusActivate(ArkUI_ContextHandle uiContext, bool isActive, bool isAutoInactive);
10197```
10198**Description**
10199
10200Sets the focus activation state for the current page. When activated, the focused node displays a focus box.
10201
10202**Since**: 15
10203
10204**Parameters**
10205
10206| Name| Description|
10207| -------- | -------- |
10208| uiContext | Pointer to the UI instance object.|
10209| isActive | Whether to enter or exit the focus active state.|
10210| isAutoInactive | Whether to automatically exit the focus active state on touch or mouse down events.<br>**true**: Automatically exit the focus active state.<br>**false**: Maintain the current state until the corresponding setting API is called.|
10211
10212### OH_ArkUI_FocusClear()
10213```
10214void OH_ArkUI_FocusClear(ArkUI_ContextHandle uiContext);
10215```
10216**Description**
10217
10218Clears the focus to the root container node.
10219
10220**Since**: 15
10221
10222**Parameters**
10223
10224| Name| Description|
10225| -------- | -------- |
10226| uiContext | Pointer to the UI instance object.|
10227
10228### OH_ArkUI_FocusRequest()
10229```
10230ArkUI_ErrorCode OH_ArkUI_FocusRequest(ArkUI_NodeHandle node);
10231```
10232**Description**
10233
10234Requests focus for a specific node.
10235
10236**Since**: 15
10237
10238**Parameters**
10239
10240| Name| Description|
10241| -------- | -------- |
10242| node | Pointer to a component node. |
10243
10244### OH_ArkUI_FocusSetAutoTransfer()
10245```
10246void OH_ArkUI_FocusSetAutoTransfer(ArkUI_ContextHandle uiContext, bool autoTransfer);
10247```
10248**Description**
10249
10250 Configures the focus transfer behavior when pages are switched.
10251
10252**Since**: 15
10253
10254**Parameters**
10255
10256| Name| Description|
10257| -------- | -------- |
10258| uiContext | Pointer to the UI instance object.|
10259| autoTransfer | Whether to automatically transfer focus when pages are switched.|
10260
10261### OH_ArkUI_FocusSetKeyProcessingMode()
10262```
10263void OH_ArkUI_FocusSetKeyProcessingMode(ArkUI_ContextHandle uiContext, ArkUI_KeyProcessingMode mode)
10264```
10265**Description**
10266
10267Sets the mode for processing key events.
10268
10269**Since**: 15
10270
10271**Parameters**
10272
10273| Name| Description|
10274| -------- | -------- |
10275| uiContext | Pointer to the UI instance object.|
10276| mode | Mode for processing key events.|
10277
10278### OH_ArkUI_GestureEvent_GetActionType()
10279
10280```
10281ArkUI_GestureEventActionType OH_ArkUI_GestureEvent_GetActionType (const ArkUI_GestureEvent * event)
10282```
10283**Description**
10284
10285Obtains the gesture event type.
10286
10287**Since**: 12
10288
10289**Parameters**
10290
10291| Name| Description|
10292| -------- | -------- |
10293| event | Gesture event. |
10294
10295**Returns**
10296
10297Returns the gesture event type.
10298
10299
10300### OH_ArkUI_GestureEvent_GetNode()
10301
10302```
10303ArkUI_NodeHandle OH_ArkUI_GestureEvent_GetNode (const ArkUI_GestureEvent * event)
10304```
10305**Description**
10306
10307Obtains the ArkUI component to which the gesture is bound.
10308
10309**Since**: 12
10310
10311**Parameters**
10312
10313| Name| Description|
10314| -------- | -------- |
10315| event | Gesture event. |
10316
10317**Returns**
10318
10319Returns the ArkUI component.
10320
10321
10322### OH_ArkUI_GestureEvent_GetRawInputEvent()
10323
10324```
10325const ArkUI_UIInputEvent* OH_ArkUI_GestureEvent_GetRawInputEvent (const ArkUI_GestureEvent * event)
10326```
10327**Description**
10328
10329Obtains gesture input.
10330
10331**Since**: 12
10332
10333**Parameters**
10334
10335| Name| Description|
10336| -------- | -------- |
10337| event | Gesture event. |
10338
10339**Returns**
10340
10341Returns the pointer to the input event of the gesture event.
10342
10343
10344### OH_ArkUI_GestureEvent_GetResponseNode()
10345
10346```
10347ArkUI_NodeHandle OH_ArkUI_GestureEvent_GetResponseNode (ArkUI_GestureEvent * event)
10348```
10349**Description**
10350
10351Obtains the node that responds to the gesture.
10352
10353**Since**: 12
10354
10355**Parameters**
10356
10357| Name| Description|
10358| -------- | -------- |
10359| event | Gesture event. |
10360
10361**Returns**
10362
10363Returns the pointer to the node if the node exists; returns **NULL** otherwise.
10364
10365
10366### OH_ArkUI_GestureEventTargetInfo_IsScrollBegin()
10367
10368```
10369int32_t OH_ArkUI_GestureEventTargetInfo_IsScrollBegin (ArkUI_GestureEventTargetInfo * info, bool * ret )
10370```
10371**Description**
10372
10373Obtains whether this scroll container is scrolled to the top.
10374
10375**Since**: 12
10376
10377**Parameters**
10378
10379| Name| Description|
10380| -------- | -------- |
10381| info | Gesture event target information. |
10382| ret | Obtains whether this scroll container is scrolled to the top. |
10383
10384**Returns**
10385
10386Returns **0** if the operation is successful. Returns **401** if a parameter error occurs. Returns **180001** if the component is not a scroll container.
10387
10388
10389### OH_ArkUI_GestureEventTargetInfo_IsScrollEnd()
10390
10391```
10392int32_t OH_ArkUI_GestureEventTargetInfo_IsScrollEnd (ArkUI_GestureEventTargetInfo * info, bool * ret )
10393```
10394**Description**
10395
10396Obtains whether this scroll container is scrolled to the bottom.
10397
10398**Since**: 12
10399
10400**Parameters**
10401
10402| Name| Description|
10403| -------- | -------- |
10404| info | Gesture event target information. |
10405| ret | Obtains whether this scroll container is scrolled to the bottom. |
10406
10407**Returns**
10408
10409Returns **0** if the operation is successful. Returns **401** if a parameter error occurs. Returns **180001** if the component is not a scroll container.
10410
10411
10412### OH_ArkUI_GestureInterruptInfo_GetGestureEvent()
10413
10414```
10415ArkUI_GestureEvent* OH_ArkUI_GestureInterruptInfo_GetGestureEvent (const ArkUI_GestureInterruptInfo * event)
10416```
10417**Description**
10418
10419Obtains the pointer to the interrupted gesture event.
10420
10421**Since**: 12
10422
10423**Parameters**
10424
10425| Name| Description|
10426| -------- | -------- |
10427| event | Interrupt callback event. |
10428
10429**Returns**
10430
10431Returns the pointer to the interrupted gesture event.
10432
10433### OH_ArkUI_GestureInterruptInfo_GetRecognizer()
10434
10435```
10436ArkUI_GestureRecognizer* OH_ArkUI_GestureInterruptInfo_GetRecognizer (const ArkUI_GestureInterruptInfo * event)
10437```
10438**Description**
10439
10440Returns the pointer to interrupted gesture recognizer.
10441
10442**Since**: 12
10443
10444**Parameters**
10445
10446| Name| Description|
10447| -------- | -------- |
10448| event | Interrupt callback event. |
10449
10450**Returns**
10451
10452Pointer to the interrupted gesture.
10453
10454
10455### OH_ArkUI_GestureInterruptInfo_GetSystemFlag()
10456
10457```
10458bool OH_ArkUI_GestureInterruptInfo_GetSystemFlag (const ArkUI_GestureInterruptInfo * event)
10459```
10460**Description**
10461
10462Checks whether a gesture is a built-in gesture of the component.
10463
10464**Since**: 12
10465
10466**Parameters**
10467
10468| Name| Description|
10469| -------- | -------- |
10470| event | Gesture interrupt callback event. |
10471
10472**Returns**
10473
10474true: built-in gestures; false: non-built-in gestures.
10475
10476
10477### OH_ArkUI_GestureInterruptInfo_GetSystemRecognizerType()
10478
10479```
10480int32_t OH_ArkUI_GestureInterruptInfo_GetSystemRecognizerType (const ArkUI_GestureInterruptInfo * event)
10481```
10482**Description**
10483
10484Obtains the type of the system gesture to trigger.
10485
10486**Since**: 12
10487
10488**Parameters**
10489
10490| Name| Description|
10491| -------- | -------- |
10492| event | Interrupt callback event. |
10493
10494**Returns**
10495
10496Returns the type of the system gesture to trigger. If the gesture to trigger is not a system gesture, **-1** is returned.
10497
10498
10499### OH_ArkUI_GestureInterruptInfo_GetTouchRecognizers()
10500
10501```
10502int32_t OH_ArkUI_GestureInterruptInfo_GetTouchRecognizers(const ArkUI_GestureInterruptInfo* info,
10503    ArkUI_TouchRecognizerHandleArray* recognizers, int32_t* size)
10504```
10505**Description**
10506
10507Obtains touch recognizers from gesture interruption information.
10508
10509**Since**: 15
10510
10511**Parameters**
10512
10513| Name| Description|
10514| -------- | -------- |
10515| info | Interrupt callback event. |
10516| recognizers | Pointer to the array of touch recognizers. |
10517| size | Pointer to the size of the touch recognizer array. |
10518
10519**Returns**
10520
10521Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
10522
10523
10524### OH_ArkUI_TouchRecognizer_GetNodeHandle()
10525
10526```
10527ArkUI_NodeHandle OH_ArkUI_TouchRecognizer_GetNodeHandle(const ArkUI_TouchRecognizerHandle recognizer)
10528```
10529**Description**
10530
10531Obtains the component handle corresponding to a touch recognizer.
10532
10533**Since**: 15
10534
10535**Parameters**
10536
10537| Name| Description|
10538| -------- | -------- |
10539| recognizer | Handle to the touch recognizer. |
10540
10541**Returns**
10542
10543Returns the component handle corresponding to the touch recognizer.
10544
10545
10546### OH_ArkUI_TouchRecognizer_CancelTouch()
10547
10548```
10549int32_t OH_ArkUI_TouchRecognizer_CancelTouch(ArkUI_TouchRecognizerHandle recognizer, ArkUI_GestureInterruptInfo* info)
10550```
10551**Description**
10552
10553Sends a cancel touch event to a touch recognizer in a gesture interruption callback.
10554
10555**Since**: 15
10556
10557**Parameters**
10558
10559| Name| Description|
10560| -------- | -------- |
10561| recognizer | Handle to the touch recognizer. |
10562| info | Interrupt callback event. |
10563
10564**Returns**
10565
10566Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
10567
10568
10569### OH_ArkUI_GetContextByNode()
10570
10571```
10572ArkUI_ContextHandle OH_ArkUI_GetContextByNode (ArkUI_NodeHandle node)
10573```
10574**Description**
10575
10576Obtains the pointer to the UI context object of the specified node.
10577
10578**Since**: 12
10579
10580**Parameters**
10581
10582| Name| Description|
10583| -------- | -------- |
10584| node | Specified node. |
10585
10586**Returns**
10587
10588Returns the pointer to the UI context object.
10589
10590
10591### OH_ArkUI_GetContextFromNapiValue()
10592
10593```
10594int32_t OH_ArkUI_GetContextFromNapiValue (napi_env env, napi_value value, ArkUI_ContextHandle * context )
10595```
10596**Description**
10597
10598Obtains a **UIContext** object on the ArkTS side and maps it to an **ArkUI_ContextHandle** object on the native side.
10599
10600**Since**: 12
10601
10602**Parameters**
10603
10604| Name| Description|
10605| -------- | -------- |
10606| env | Pointer to the NAPI environment. |
10607| value | Context object created on the ArkTS side. |
10608| context | ArkUI_ContextHandle pointer. |
10609
10610**Returns**
10611
10612Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
10613
10614
10615### OH_ArkUI_GetDrawableDescriptorFromNapiValue()
10616
10617```
10618int32_t OH_ArkUI_GetDrawableDescriptorFromNapiValue (napi_env env, napi_value value, ArkUI_DrawableDescriptor ** drawableDescriptor )
10619```
10620**Description**
10621
10622Maps a **DrawableDescriptor** object on the ArkTS side to an **ArkUI_DrawableDescriptor** object on the native side.
10623
10624**Since**: 12
10625
10626**Parameters**
10627
10628| Name| Description|
10629| -------- | -------- |
10630| env | Pointer to the NAPI environment. |
10631| value | **DrawableDescriptor** object created on the ArkTS side. |
10632| drawableDescriptor | Object that receives the pointer to the **ArkUI_DrawableDescriptor** object. |
10633
10634**Returns**
10635
10636Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
10637
10638
10639### OH_ArkUI_GetDrawableDescriptorFromResourceNapiValue()
10640
10641```
10642int32_t OH_ArkUI_GetDrawableDescriptorFromResourceNapiValue (napi_env env, napi_value value, ArkUI_DrawableDescriptor ** drawableDescriptor )
10643```
10644**Description**
10645
10646Maps an $r resource object on the ArkTS side to an **ArkUI_DrawableDescriptor** object on the native side.
10647
10648**Since**: 12
10649
10650**Parameters**
10651
10652| Name| Description|
10653| -------- | -------- |
10654| env | Pointer to the NAPI environment. |
10655| value | $r resource object created on ArkTS. |
10656| drawableDescriptor | Object that receives the pointer to the **ArkUI_DrawableDescriptor** object. |
10657
10658**Returns**
10659
10660Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
10661
10662
10663### OH_ArkUI_GetGestureBindNodeId()
10664
10665```
10666int32_t OH_ArkUI_GetGestureBindNodeId (ArkUI_GestureRecognizer * recognizer, char * nodeId, int32_t size, int32_t * result )
10667```
10668**Description**
10669
10670Obtains the ID of the component linked to a gesture recognizer.
10671
10672**Since**: 12
10673
10674**Parameters**
10675
10676| Name| Description|
10677| -------- | -------- |
10678| recognizer | Pointer to the gesture recognizer. |
10679| nodeId | ID of a component. |
10680| size | Size of the storage area. |
10681| result | Length of the string to be copied. |
10682
10683**Returns**
10684
10685Returns **0** if the operation is successful. Returns **401** if a parameter error occurs. Returns **180002** if the buffer is not large enough.
10686
10687
10688### OH_ArkUI_GetGestureEventTargetInfo()
10689
10690```
10691int32_t OH_ArkUI_GetGestureEventTargetInfo (ArkUI_GestureRecognizer * recognizer, ArkUI_GestureEventTargetInfo ** info )
10692```
10693**Description**
10694
10695Obtains the information about a gesture event target.
10696
10697**Since**: 12
10698
10699**Parameters**
10700
10701| Name| Description|
10702| -------- | -------- |
10703| recognizer | Pointer to the gesture recognizer. |
10704| info | Gesture event target information. |
10705
10706**Returns**
10707
10708Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
10709
10710
10711### OH_ArkUI_GetGestureRecognizerEnabled()
10712
10713```
10714bool OH_ArkUI_GetGestureRecognizerEnabled (ArkUI_GestureRecognizer * recognizer)
10715```
10716**Description**
10717
10718Obtains the enabled state of a gesture recognizer.
10719
10720**Since**: 12
10721
10722**Parameters**
10723
10724| Name| Description|
10725| -------- | -------- |
10726| recognizer | Pointer to the gesture recognizer. |
10727
10728**Returns**
10729
10730**true**: enabled false: disabled
10731
10732
10733### OH_ArkUI_GetGestureRecognizerState()
10734
10735```
10736int32_t OH_ArkUI_GetGestureRecognizerState (ArkUI_GestureRecognizer * recognizer, ArkUI_GestureRecognizerState * state )
10737```
10738**Description**
10739
10740Obtains the state of a gesture recognizer.
10741
10742**Since**: 12
10743
10744**Parameters**
10745
10746| Name| Description|
10747| -------- | -------- |
10748| recognizer | Pointer to the gesture recognizer. |
10749| state | Status of the gesture recognizer. |
10750
10751**Returns**
10752
10753Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
10754
10755
10756### OH_ArkUI_GetGestureTag()
10757
10758```
10759int32_t OH_ArkUI_GetGestureTag (ArkUI_GestureRecognizer * recognizer, char * buffer, int32_t bufferSize, int32_t * result )
10760```
10761**Description**
10762
10763Obtains the mark of the gesture recognizer.
10764
10765**Since**: 12
10766
10767**Parameters**
10768
10769| Name| Description|
10770| -------- | -------- |
10771| recognizer | Pointer to the gesture recognizer. |
10772| buffer | Storage zone |
10773| bufferSize | Size of the storage area. |
10774| result | Length of the string to be copied. |
10775
10776**Returns**
10777
10778Returns **0** if the operation is successful. Returns **401** if a parameter error occurs. Returns **180002** if the buffer is not large enough.
10779
10780
10781### OH_ArkUI_GetNavDestinationId()
10782
10783```
10784ArkUI_ErrorCode OH_ArkUI_GetNavDestinationId (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )
10785```
10786**Description**
10787
10788Obtains the ID of the **NavDestination** component where the specified node is located.
10789
10790**Since**: 12
10791
10792**Parameters**
10793
10794| Name| Description|
10795| -------- | -------- |
10796| node | Specified node. |
10797| buffer | buffer. NavDestinationID is written to this memory area. |
10798| bufferSize | Pointer to the buffer size. |
10799| 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. |
10800
10801**Returns**
10802
10803Returns **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.
10804
10805
10806### OH_ArkUI_GetNavDestinationIndex()
10807
10808```
10809ArkUI_ErrorCode OH_ArkUI_GetNavDestinationIndex (ArkUI_NodeHandle node, int32_t * index )
10810```
10811**Description**
10812
10813Obtains the index of the **NavDestination** component where the specified node is located in the navigation stack.
10814
10815**Since**: 12
10816
10817**Parameters**
10818
10819| Name| Description|
10820| -------- | -------- |
10821| node | Specified node. |
10822| index | Returns the index, starting from 0. |
10823
10824**Returns**
10825
10826Returns **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.
10827
10828
10829### OH_ArkUI_GetNavDestinationName()
10830
10831```
10832ArkUI_ErrorCode OH_ArkUI_GetNavDestinationName (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )
10833```
10834**Description**
10835
10836Obtains the name of the **NavDestination** component where the specified node is located.
10837
10838**Since**: 12
10839
10840**Parameters**
10841
10842| Name| Description|
10843| -------- | -------- |
10844| node | Specified node. |
10845| buffer | Buffer. The queried NavDestination name is written to this memory area. |
10846| bufferSize | Pointer to the buffer size. |
10847| 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. |
10848
10849**Returns**
10850
10851Returns **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.
10852
10853
10854### OH_ArkUI_GetNavDestinationNameByIndex()
10855
10856```
10857ArkUI_ErrorCode OH_ArkUI_GetNavDestinationNameByIndex (ArkUI_NodeHandle node, int32_t index, char * buffer, int32_t bufferSize, int32_t * writeLength )
10858```
10859**Description**
10860
10861Obtains 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.
10862
10863**Since**: 12
10864
10865**Parameters**
10866
10867| Name| Description|
10868| -------- | -------- |
10869| node | Specified node. |
10870| index | Index of the queried NavDestination in the stack. |
10871| buffer | Buffer. The name of the queried page is written to this memory area. |
10872| bufferSize | Pointer to the buffer size. |
10873| 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. |
10874
10875**Returns**
10876
10877Returns **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.
10878
10879
10880### OH_ArkUI_GetNavDestinationParam()
10881
10882```
10883napi_value OH_ArkUI_GetNavDestinationParam (ArkUI_NodeHandle node)
10884```
10885**Description**
10886
10887Obtains the parameters of the **NavDestination** component where the specified node is located.
10888
10889**Since**: 12
10890
10891**Parameters**
10892
10893| Name| Description|
10894| -------- | -------- |
10895| node | Specified node. |
10896
10897**Returns**
10898
10899Parameter object.
10900
10901
10902### OH_ArkUI_GetNavDestinationState()
10903
10904```
10905ArkUI_ErrorCode OH_ArkUI_GetNavDestinationState (ArkUI_NodeHandle node, ArkUI_NavDestinationState * state )
10906```
10907**Description**
10908
10909Obtains the state of the **NavDestination** component where the specified node is located.
10910
10911**Since**: 12
10912
10913**Parameters**
10914
10915| Name| Description|
10916| -------- | -------- |
10917| node | Specified node. |
10918| state | The status value of NavDestination is written back to this parameter. |
10919
10920**Returns**
10921
10922The 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.
10923
10924
10925### OH_ArkUI_GetNavigationId()
10926
10927```
10928ArkUI_ErrorCode OH_ArkUI_GetNavigationId (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )
10929```
10930**Description**
10931
10932Obtains the ID of the **Navigation** component where the specified node is located.
10933
10934**Since**: 12
10935
10936**Parameters**
10937
10938| Name| Description|
10939| -------- | -------- |
10940| node | Specified node. |
10941| buffer | buffer. The NavigationID is written to this memory area. |
10942| bufferSize | Pointer to the buffer size. |
10943| 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. |
10944
10945**Returns**
10946
10947Returns **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.
10948
10949
10950### OH_ArkUI_GetNavStackLength()
10951
10952```
10953ArkUI_ErrorCode OH_ArkUI_GetNavStackLength (ArkUI_NodeHandle node, int32_t * length )
10954```
10955**Description**
10956
10957Obtains the length of the navigation stack where the specified node is located.
10958
10959**Since**: 12
10960
10961**Parameters**
10962
10963| Name| Description|
10964| -------- | -------- |
10965| node | Specified node. |
10966| length | Length of the stack. The result, if obtained successfully, is written back to this parameter. |
10967
10968**Returns**
10969
10970Returns **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.
10971
10972
10973### OH_ArkUI_GetNodeContentFromNapiValue()
10974
10975```
10976int32_t OH_ArkUI_GetNodeContentFromNapiValue (napi_env env, napi_value value, ArkUI_NodeContentHandle * content )
10977```
10978**Description**
10979
10980Obtains a **NodeContent** object on the ArkTS side and maps it to an **ArkUI_NodeContentHandle** object on the native side.
10981
10982**Since**: 12
10983
10984**Parameters**
10985
10986| Name| Description|
10987| -------- | -------- |
10988| env | Pointer to the NAPI environment. |
10989| value | NodeContent object created on ArkTS. |
10990| context | ArkUI_NodeContentHandle pointer. |
10991
10992**Returns**
10993
10994Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
10995
10996
10997### OH_ArkUI_GetNodeHandleFromNapiValue()
10998
10999```
11000int32_t OH_ArkUI_GetNodeHandleFromNapiValue (napi_env env, napi_value frameNode, ArkUI_NodeHandle * handle )
11001```
11002**Description**
11003
11004Obtains a **FrameNode** object on the ArkTS side and maps it to an **ArkUI_NodeHandle** object on the native side.
11005
11006**Since**: 12
11007
11008**Parameters**
11009
11010| Name| Description|
11011| -------- | -------- |
11012| env | Pointer to the NAPI environment. |
11013| frameNode | FrameNode object created on the ArkTS side. |
11014| handle | **ArkUI_NodeHandle** pointer. |
11015
11016**Returns**
11017
11018Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
11019
11020
11021### OH_ArkUI_GetPanGestureDirectionMask()
11022
11023```
11024int32_t OH_ArkUI_GetPanGestureDirectionMask (ArkUI_GestureRecognizer * recognizer, ArkUI_GestureDirectionMask * directionMask )
11025```
11026**Description**
11027
11028Obtains the direction of a pan gesture.
11029
11030**Since**: 12
11031
11032**Parameters**
11033
11034| Name| Description|
11035| -------- | -------- |
11036| recognizer | Pointer to the gesture recognizer. |
11037| directionMask | Sliding direction of the sliding gesture. |
11038
11039**Returns**
11040
11041Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
11042
11043
11044### OH_ArkUI_GetResponseRecognizersFromInterruptInfo()
11045
11046```
11047int32_t OH_ArkUI_GetResponseRecognizersFromInterruptInfo (const ArkUI_GestureInterruptInfo * event, ArkUI_GestureRecognizerHandleArray * responseChain, int32_t * count )
11048```
11049**Description**
11050
11051Obtains information about a gesture response chain.
11052
11053**Since**: 12
11054
11055**Parameters**
11056
11057| Name| Description|
11058| -------- | -------- |
11059| event | Gesture interrupt callback event. |
11060| responseChain | Gesture recognizer on the response chain component. |
11061| count | Number of gesture recognizers on the response chain component. |
11062
11063**Returns**
11064
11065Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
11066
11067
11068### OH_ArkUI_GetRouterPageId()
11069
11070```
11071ArkUI_ErrorCode OH_ArkUI_GetRouterPageId (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )
11072```
11073**Description**
11074
11075Obtains the ID of the page where the specified node is located.
11076
11077**Since**: 12
11078
11079**Parameters**
11080
11081| Name| Description|
11082| -------- | -------- |
11083| node | Specified node. |
11084| buffer | buffer. Page Id is written to this memory area. |
11085| bufferSize | Pointer to the buffer size. |
11086| 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. |
11087
11088**Returns**
11089
11090Returns **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.
11091
11092
11093### OH_ArkUI_GetRouterPageIndex()
11094
11095```
11096ArkUI_ErrorCode OH_ArkUI_GetRouterPageIndex (ArkUI_NodeHandle node, int32_t * index )
11097```
11098**Description**
11099
11100Obtains the index of the page where the specified node is located in the page stack for routing.
11101
11102**Since**: 12
11103
11104**Parameters**
11105
11106| Name| Description|
11107| -------- | -------- |
11108| node | Specified node. |
11109| index | Returns the index, starting from 1. |
11110
11111**Returns**
11112
11113Returns **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.
11114
11115
11116### OH_ArkUI_GetRouterPageName()
11117
11118```
11119ArkUI_ErrorCode OH_ArkUI_GetRouterPageName (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )
11120```
11121**Description**
11122
11123Obtains the name of the page where the specified node is located.
11124
11125**Since**: 12
11126
11127**Parameters**
11128
11129| Name| Description|
11130| -------- | -------- |
11131| node | Specified node. |
11132| buffer | Buffer. The page name is written to this memory area. |
11133| bufferSize | Pointer to the buffer size. |
11134| 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. |
11135
11136**Returns**
11137
11138Returns **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.
11139
11140
11141### OH_ArkUI_GetRouterPagePath()
11142
11143```
11144ArkUI_ErrorCode OH_ArkUI_GetRouterPagePath (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )
11145```
11146**Description**
11147
11148Obtains the path to the page where the specified node is located.
11149
11150**Since**: 12
11151
11152**Parameters**
11153
11154| Name| Description|
11155| -------- | -------- |
11156| node | Specified node. |
11157| buffer | buffer. Page Path is written to this memory area. |
11158| bufferSize | Pointer to the buffer size. |
11159| 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. |
11160
11161**Returns**
11162
11163Returns **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.
11164
11165
11166### OH_ArkUI_GetRouterPageState()
11167
11168```
11169ArkUI_ErrorCode OH_ArkUI_GetRouterPageState (ArkUI_NodeHandle node, ArkUI_RouterPageState * state )
11170```
11171**Description**
11172
11173Obtains the state of the page where the specified node is located.
11174
11175**Since**: 12
11176
11177**Parameters**
11178
11179| Name| Description|
11180| -------- | -------- |
11181| node | Specified node. |
11182| state | The status value of Router Page is written back to this parameter. |
11183
11184**Returns**
11185
11186The error code ARKUI_ERROR_CODE_NO_ERROR is returned. The ARKUI_ERROR_CODE_GET_INFO_FAILED fails to query information.
11187
11188
11189### OH_ArkUI_GuidelineOption_Create()
11190
11191```
11192ArkUI_GuidelineOption* OH_ArkUI_GuidelineOption_Create (int32_t size)
11193```
11194**Description**
11195
11196Creates a guideline configuration for this **RelativeContainer**.
11197
11198**Since**: 12
11199
11200**Parameters**
11201
11202| Name| Description|
11203| -------- | -------- |
11204| size | Number of guidelines. |
11205
11206**Returns**
11207
11208Returns the guideline configuration.
11209
11210
11211### OH_ArkUI_GuidelineOption_Dispose()
11212
11213```
11214void OH_ArkUI_GuidelineOption_Dispose (ArkUI_GuidelineOption * guideline)
11215```
11216**Description**
11217
11218Destroys auxiliary line information.
11219
11220**Since**: 12
11221
11222**Parameters**
11223
11224| Name| Description|
11225| -------- | -------- |
11226| guideline | Pointer to a guideline configuration. |
11227
11228
11229### OH_ArkUI_GuidelineOption_GetDirection()
11230
11231```
11232ArkUI_Axis OH_ArkUI_GuidelineOption_GetDirection (ArkUI_GuidelineOption * guideline, int32_t index )
11233```
11234**Description**
11235
11236Obtains the direction of a guideline.
11237
11238**Since**: 12
11239
11240**Parameters**
11241
11242| Name| Description|
11243| -------- | -------- |
11244| guideline | Pointer to a guideline configuration. |
11245| index | Index of the barrier. |
11246
11247**Returns**
11248
11249Returns the direction of the guideline.
11250
11251
11252### OH_ArkUI_GuidelineOption_GetId()
11253
11254```
11255const char* OH_ArkUI_GuidelineOption_GetId (ArkUI_GuidelineOption * guideline, int32_t index )
11256```
11257**Description**
11258
11259Obtains the ID of a guideline.
11260
11261**Since**: 12
11262
11263**Parameters**
11264
11265| Name| Description|
11266| -------- | -------- |
11267| guideline | Pointer to a guideline configuration. |
11268| index | Index of the barrier. |
11269
11270**Returns**
11271
11272Returns the ID of the guideline.
11273
11274
11275### OH_ArkUI_GuidelineOption_GetPositionEnd()
11276
11277```
11278float OH_ArkUI_GuidelineOption_GetPositionEnd (ArkUI_GuidelineOption * guideline, int32_t index )
11279```
11280**Description**
11281
11282Obtains the distance between a guideline and the right or bottom of the container.
11283
11284**Since**: 12
11285
11286**Parameters**
11287
11288| Name| Description|
11289| -------- | -------- |
11290| guideline | Pointer to a guideline configuration. |
11291| index | Index of the barrier. |
11292
11293**Returns**
11294
11295Distance between the guideline and the right or bottom of the container.
11296
11297
11298### OH_ArkUI_GuidelineOption_GetPositionStart()
11299
11300```
11301float OH_ArkUI_GuidelineOption_GetPositionStart (ArkUI_GuidelineOption * guideline, int32_t index )
11302```
11303**Description**
11304
11305Obtains the distance between a guideline and the left or top of the container.
11306
11307**Since**: 12
11308
11309**Parameters**
11310
11311| Name| Description|
11312| -------- | -------- |
11313| guideline | Pointer to a guideline configuration. |
11314| index | Index of the barrier. |
11315
11316**Returns**
11317
11318Distance between the guideline and the left or top of the container.
11319
11320
11321### OH_ArkUI_GuidelineOption_SetDirection()
11322
11323```
11324void OH_ArkUI_GuidelineOption_SetDirection (ArkUI_GuidelineOption * guideline, ArkUI_Axis value, int32_t index )
11325```
11326**Description**
11327
11328Sets the direction of a guideline.
11329
11330**Since**: 12
11331
11332**Parameters**
11333
11334| Name| Description|
11335| -------- | -------- |
11336| guideline | Pointer to a guideline configuration. |
11337| value | Direction.  |
11338| index | Index of the guideline. |
11339
11340
11341### OH_ArkUI_GuidelineOption_SetId()
11342
11343```
11344void OH_ArkUI_GuidelineOption_SetId (ArkUI_GuidelineOption * guideline, const char * value, int32_t index )
11345```
11346**Description**
11347
11348Sets the ID of a guideline.
11349
11350**Since**: 12
11351
11352**Parameters**
11353
11354| Name| Description|
11355| -------- | -------- |
11356| guideline | Pointer to a guideline configuration. |
11357| value | ID of the barrier, which must be unique and cannot be the same as the name of any component in the container. |
11358| index | Index of the guideline. |
11359
11360
11361### OH_ArkUI_GuidelineOption_SetPositionEnd()
11362
11363```
11364void OH_ArkUI_GuidelineOption_SetPositionEnd (ArkUI_GuidelineOption * guideline, float value, int32_t index )
11365```
11366**Description**
11367
11368Sets the distance between a guideline and the right or bottom of the container.
11369
11370**Since**: 12
11371
11372**Parameters**
11373
11374| Name| Description|
11375| -------- | -------- |
11376| guideline | Pointer to a guideline configuration. |
11377| value | Distance between the guideline and the right or bottom of the container. |
11378| index | Index of the guideline. |
11379
11380
11381### OH_ArkUI_GuidelineOption_SetPositionStart()
11382
11383```
11384void OH_ArkUI_GuidelineOption_SetPositionStart (ArkUI_GuidelineOption * guideline, float value, int32_t index )
11385```
11386**Description**
11387
11388Sets the distance between a guideline and the left or top of the container.
11389
11390**Since**: 12
11391
11392**Parameters**
11393
11394| Name| Description|
11395| -------- | -------- |
11396| guideline | Pointer to a guideline configuration. |
11397| value | Distance between the guideline and the left or top of the container. |
11398| index | Index of the guideline. |
11399
11400
11401### OH_ArkUI_ImageAnimatorFrameInfo_CreateFromDrawableDescriptor()
11402
11403```
11404ArkUI_ImageAnimatorFrameInfo* OH_ArkUI_ImageAnimatorFrameInfo_CreateFromDrawableDescriptor (ArkUI_DrawableDescriptor * drawable)
11405```
11406**Description**
11407
11408Creates an image frame information object based on a **DrawableDescriptor** object, with the image format being Resource or PixelMap.
11409
11410**Since**: 12
11411
11412**Parameters**
11413
11414| Name| Description|
11415| -------- | -------- |
11416| drawable | Pointer to an **ArkUI_DrawableDescriptor** object created using Resource or PixelMap. |
11417
11418**Returns**
11419
11420Returns the pointer to the created frame image object.
11421
11422
11423### OH_ArkUI_ImageAnimatorFrameInfo_CreateFromString()
11424
11425```
11426ArkUI_ImageAnimatorFrameInfo* OH_ArkUI_ImageAnimatorFrameInfo_CreateFromString (char * src)
11427```
11428**Description**
11429
11430Creates an image frame information object based on an image path, with the image format being SVG, PNG, or JPG.
11431
11432**Since**: 12
11433
11434**Parameters**
11435
11436| Name| Description|
11437| -------- | -------- |
11438| src | Image path. |
11439
11440**Returns**
11441
11442Returns the pointer to the created frame image object.
11443
11444
11445### OH_ArkUI_ImageAnimatorFrameInfo_Dispose()
11446
11447```
11448void OH_ArkUI_ImageAnimatorFrameInfo_Dispose (ArkUI_ImageAnimatorFrameInfo * imageInfo)
11449```
11450**Description**
11451
11452Disposes of the pointer to an image frame information object.
11453
11454**Since**: 12
11455
11456**Parameters**
11457
11458| Name| Description|
11459| -------- | -------- |
11460| imageInfo | Pointer to the frame image object. |
11461
11462
11463### OH_ArkUI_ImageAnimatorFrameInfo_GetDuration()
11464
11465```
11466int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetDuration (ArkUI_ImageAnimatorFrameInfo * imageInfo)
11467```
11468**Description**
11469
11470Obtains the playback duration of an image.
11471
11472**Since**: 12
11473
11474**Parameters**
11475
11476| Name| Description|
11477| -------- | -------- |
11478| imageInfo | Pointer to the frame image object. |
11479
11480**Returns**
11481
11482Returns the playback duration of the image, in milliseconds. If **imageInfo** is a null pointer, **0** is returned.
11483
11484
11485### OH_ArkUI_ImageAnimatorFrameInfo_GetHeight()
11486
11487```
11488int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetHeight (ArkUI_ImageAnimatorFrameInfo * imageInfo)
11489```
11490**Description**
11491
11492Obtains the image height.
11493
11494**Since**: 12
11495
11496**Parameters**
11497
11498| Name| Description|
11499| -------- | -------- |
11500| imageInfo | Pointer to the frame image object. |
11501
11502**Returns**
11503
11504Returns the image height, in PX. If **imageInfo** is a null pointer, **0** is returned.
11505
11506
11507### OH_ArkUI_ImageAnimatorFrameInfo_GetLeft()
11508
11509```
11510int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetLeft (ArkUI_ImageAnimatorFrameInfo * imageInfo)
11511```
11512**Description**
11513
11514Obtains the horizontal coordinate of an image relative to the upper left corner of the component.
11515
11516**Since**: 12
11517
11518**Parameters**
11519
11520| Name| Description|
11521| -------- | -------- |
11522| imageInfo | Pointer to the frame image object. |
11523
11524**Returns**
11525
11526Returns 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.
11527
11528
11529### OH_ArkUI_ImageAnimatorFrameInfo_GetTop()
11530
11531```
11532int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetTop (ArkUI_ImageAnimatorFrameInfo * imageInfo)
11533```
11534**Description**
11535
11536Obtains the vertical coordinate of an image relative to the upper left corner of the component.
11537
11538**Since**: 12
11539
11540**Parameters**
11541
11542| Name| Description|
11543| -------- | -------- |
11544| imageInfo | Pointer to the frame image object. |
11545
11546**Returns**
11547
11548Returns 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.
11549
11550
11551### OH_ArkUI_ImageAnimatorFrameInfo_GetWidth()
11552
11553```
11554int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetWidth (ArkUI_ImageAnimatorFrameInfo * imageInfo)
11555```
11556**Description**
11557
11558Obtains the image width.
11559
11560**Since**: 12
11561
11562**Parameters**
11563
11564| Name| Description|
11565| -------- | -------- |
11566| imageInfo | Pointer to the frame image object. |
11567
11568**Returns**
11569
11570Returns the image width, in PX. If **imageInfo** is a null pointer, **0** is returned.
11571
11572
11573### OH_ArkUI_ImageAnimatorFrameInfo_SetDuration()
11574
11575```
11576void OH_ArkUI_ImageAnimatorFrameInfo_SetDuration (ArkUI_ImageAnimatorFrameInfo * imageInfo, int32_t duration )
11577```
11578**Description**
11579
11580Sets the playback duration of an image.
11581
11582**Since**: 12
11583
11584**Parameters**
11585
11586| Name| Description|
11587| -------- | -------- |
11588| imageInfo | Pointer to the frame image object. |
11589| duration | Playback duration of an image, in milliseconds. |
11590
11591
11592### OH_ArkUI_ImageAnimatorFrameInfo_SetHeight()
11593
11594```
11595void OH_ArkUI_ImageAnimatorFrameInfo_SetHeight (ArkUI_ImageAnimatorFrameInfo * imageInfo, int32_t height )
11596```
11597**Description**
11598
11599Sets the image height.
11600
11601**Since**: 12
11602
11603**Parameters**
11604
11605| Name| Description|
11606| -------- | -------- |
11607| imageInfo | Pointer to the frame image object. |
11608| height | Image height, in px. |
11609
11610
11611### OH_ArkUI_ImageAnimatorFrameInfo_SetLeft()
11612
11613```
11614void OH_ArkUI_ImageAnimatorFrameInfo_SetLeft (ArkUI_ImageAnimatorFrameInfo * imageInfo, int32_t left )
11615```
11616**Description**
11617
11618Sets the horizontal coordinate of an image relative to the upper left corner of the component.
11619
11620**Since**: 12
11621
11622**Parameters**
11623
11624| Name| Description|
11625| -------- | -------- |
11626| imageInfo | Pointer to the frame image object. |
11627| left | Horizontal coordinate of the image relative to the upper left corner of the component, in px. |
11628
11629
11630### OH_ArkUI_ImageAnimatorFrameInfo_SetTop()
11631
11632```
11633void OH_ArkUI_ImageAnimatorFrameInfo_SetTop (ArkUI_ImageAnimatorFrameInfo * imageInfo, int32_t top )
11634```
11635**Description**
11636
11637Sets the vertical coordinate of an image relative to the upper left corner of the component.
11638
11639**Since**: 12
11640
11641**Parameters**
11642
11643| Name| Description|
11644| -------- | -------- |
11645| imageInfo | Pointer to the frame image object. |
11646| top | Vertical coordinate of the image relative to the upper left corner of the component, in px. |
11647
11648
11649### OH_ArkUI_ImageAnimatorFrameInfo_SetWidth()
11650
11651```
11652void OH_ArkUI_ImageAnimatorFrameInfo_SetWidth (ArkUI_ImageAnimatorFrameInfo * imageInfo, int32_t width )
11653```
11654**Description**
11655
11656Sets the image width.
11657
11658**Since**: 12
11659
11660**Parameters**
11661
11662| Name| Description|
11663| -------- | -------- |
11664| imageInfo | Pointer to the frame image object. |
11665| width | Image width, in px. |
11666
11667
11668### OH_ArkUI_IsBuiltInGesture()
11669
11670```
11671bool OH_ArkUI_IsBuiltInGesture (ArkUI_GestureRecognizer * recognizer)
11672```
11673**Description**
11674
11675Obtains whether a gesture is a built-in gesture.
11676
11677**Since**: 12
11678
11679**Parameters**
11680
11681| Name| Description|
11682| -------- | -------- |
11683| recognizer | Pointer to the gesture recognizer. |
11684
11685**Returns**
11686
11687true: built-in gestures. false: The gesture is not a built-in gesture.
11688
11689
11690### OH_ArkUI_IsGestureRecognizerValid()
11691
11692```
11693bool OH_ArkUI_IsGestureRecognizerValid (ArkUI_GestureRecognizer * recognizer)
11694```
11695**Description**
11696
11697Obtains whether a gesture recognizer is valid.
11698
11699**Since**: 12
11700
11701**Parameters**
11702
11703| Name| Description|
11704| -------- | -------- |
11705| recognizer | Pointer to the gesture recognizer. |
11706
11707**Returns**
11708
11709true: The gesture recognizer is valid. Returns **false** if the gesture recognizer is invalid.
11710
11711
11712### OH_ArkUI_KeyEvent_GetKeyCode()
11713
11714```
11715int32_t OH_ArkUI_KeyEvent_GetKeyCode (const ArkUI_UIInputEvent * event)
11716```
11717**Description**
11718
11719Obtains the key code from a key event.
11720
11721**Since**: 14
11722
11723**Parameters**
11724
11725| Name| Description|
11726| -------- | -------- |
11727| event | Pointer to an **ArkUI_UIInputEvent** object. |
11728
11729**Returns**
11730
11731Key code.
11732
11733
11734### OH_ArkUI_KeyEvent_GetKeyIntensionCode()
11735
11736```
11737ArkUI_KeyIntension OH_ArkUI_KeyEvent_GetKeyIntensionCode (const ArkUI_UIInputEvent * event)
11738```
11739**Description**
11740
11741Obtains the intention code associated with a key event.
11742
11743**Since**: 14
11744
11745**Parameters**
11746
11747| Name| Description|
11748| -------- | -------- |
11749| event | Pointer to an **ArkUI_UIInputEvent** object. |
11750
11751**Returns**
11752
11753Returns the intention code associated with the key event.
11754
11755
11756### OH_ArkUI_KeyEvent_GetKeySource()
11757
11758```
11759ArkUI_KeySourceType OH_ArkUI_KeyEvent_GetKeySource (const ArkUI_UIInputEvent * event)
11760```
11761**Description**
11762
11763Obtains the type of input device that triggers a key event.
11764
11765**Since**: 14
11766
11767**Parameters**
11768
11769| Name| Description|
11770| -------- | -------- |
11771| event | Pointer to an **ArkUI_UIInputEvent** object. |
11772
11773**Returns**
11774
11775Returns the device type.
11776
11777
11778### OH_ArkUI_KeyEvent_GetKeyText()
11779
11780```
11781const char* OH_ArkUI_KeyEvent_GetKeyText (const ArkUI_UIInputEvent * event)
11782```
11783**Description**
11784
11785Obtains the key value from a key event.
11786
11787**Since**: 14
11788
11789**Parameters**
11790
11791| Name| Description|
11792| -------- | -------- |
11793| event | Pointer to an **ArkUI_UIInputEvent** object. |
11794
11795**Returns**
11796
11797Key value.
11798
11799
11800### OH_ArkUI_KeyEvent_GetType()
11801
11802```
11803ArkUI_KeyEventType OH_ArkUI_KeyEvent_GetType (const ArkUI_UIInputEvent * event)
11804```
11805**Description**
11806
11807Obtains the type of a key event.
11808
11809**Since**: 14
11810
11811**Parameters**
11812
11813| Name| Description|
11814| -------- | -------- |
11815| event | Pointer to an **ArkUI_UIInputEvent** object. |
11816
11817**Returns**
11818
11819Returns the key event type.
11820
11821
11822### OH_ArkUI_KeyEvent_GetUnicode()
11823
11824```
11825uint32_t OH_ArkUI_KeyEvent_GetUnicode (const ArkUI_UIInputEvent * event)
11826```
11827**Description**
11828
11829Obtains the Unicode value of a key event. Non-space basic Latin characters in the 0x0021-0x007E range are supported. Characters with a value of 0 are not supported. In the case of key combination, this API returns the Unicode value of the key corresponding to the key event.
11830
11831**Since**: 14
11832
11833**Parameters**
11834
11835| Name| Description|
11836| -------- | -------- |
11837| event | Pointer to an **ArkUI_UIInputEvent** object. |
11838
11839**Returns**
11840
11841Returns the Unicode value.
11842
11843
11844### OH_ArkUI_KeyEvent_SetConsumed()
11845
11846```
11847void OH_ArkUI_KeyEvent_SetConsumed (const ArkUI_UIInputEvent * event, bool isConsumed )
11848```
11849**Description**
11850
11851Sets whether a key event is consumed in the key event callback.
11852
11853**Since**: 14
11854
11855**Parameters**
11856
11857| Name| Description|
11858| -------- | -------- |
11859| event | Pointer to an **ArkUI_UIInputEvent** object. |
11860| isConsumed | Whether the event is consumed. |
11861
11862
11863### OH_ArkUI_KeyEvent_StopPropagation()
11864
11865```
11866void OH_ArkUI_KeyEvent_StopPropagation (const ArkUI_UIInputEvent * event, bool stopPropagation )
11867```
11868**Description**
11869
11870Stops the event from bubbling upwards or downwards.
11871
11872**Since**: 14
11873
11874**Parameters**
11875
11876| Name| Description|
11877| -------- | -------- |
11878| event | Pointer to an **ArkUI_UIInputEvent** object. |
11879| stopPropagation | Whether to stop event propagation. |
11880
11881
11882### OH_ArkUI_KeyEvent_Dispatch()
11883
11884```
11885void OH_ArkUI_KeyEvent_Dispatch(ArkUI_NodeHandle node, const ArkUI_UIInputEvent* event)
11886```
11887**Description**
11888
11889Dispatches a key event to a specific node.
11890
11891**Since**: 15
11892
11893**Parameters**
11894
11895| Name| Description|
11896| -------- | -------- |
11897| node | Node object for which an event needs to be registered. |
11898| event | Pointer to an **ArkUI_UIInputEvent** object. |
11899
11900### OH_ArkUI_KeyframeAnimateOption_Create()
11901
11902```
11903ArkUI_KeyframeAnimateOption* OH_ArkUI_KeyframeAnimateOption_Create (int32_t size)
11904```
11905**Description**
11906
11907Obtains the keyframe animation parameters.
11908
11909**Since**: 12
11910
11911**Parameters**
11912
11913| Name| Description|
11914| -------- | -------- |
11915| size | Number of key frame animation states. |
11916
11917**Returns**
11918
11919Returns the keyframe animation parameter object; returns **NULL** if the value of **size** is less than 0.
11920
11921
11922### OH_ArkUI_KeyframeAnimateOption_Dispose()
11923
11924```
11925void OH_ArkUI_KeyframeAnimateOption_Dispose (ArkUI_KeyframeAnimateOption * option)
11926```
11927**Description**
11928
11929Destroys a keyframe animation parameter object.
11930
11931**Since**: 12
11932
11933**Parameters**
11934
11935| Name| Description|
11936| -------- | -------- |
11937| option | Returns the keyframe animation parameter object; |
11938
11939
11940### OH_ArkUI_KeyframeAnimateOption_GetCurve()
11941
11942```
11943ArkUI_CurveHandle OH_ArkUI_KeyframeAnimateOption_GetCurve (ArkUI_KeyframeAnimateOption * option, int32_t index )
11944```
11945**Description**
11946
11947Obtains the animation curve of a specific state in a keyframe animation.
11948
11949**Since**: 12
11950
11951**Parameters**
11952
11953| Name| Description|
11954| -------- | -------- |
11955| option | Keyframe animation parameters. |
11956| index | Status index. |
11957
11958**Returns**
11959
11960Returns the animation curve.
11961
11962
11963### OH_ArkUI_KeyframeAnimateOption_GetDelay()
11964
11965```
11966int32_t OH_ArkUI_KeyframeAnimateOption_GetDelay (ArkUI_KeyframeAnimateOption * option)
11967```
11968**Description**
11969
11970Obtains the overall delay of a keyframe animation
11971
11972**Since**: 12
11973
11974**Parameters**
11975
11976| Name| Description|
11977| -------- | -------- |
11978| option | Keyframe animation parameters. |
11979
11980**Returns**
11981
11982Returns the overall delay.
11983
11984
11985### OH_ArkUI_KeyframeAnimateOption_GetDuration()
11986
11987```
11988int32_t OH_ArkUI_KeyframeAnimateOption_GetDuration (ArkUI_KeyframeAnimateOption * option, int32_t index )
11989```
11990**Description**
11991
11992Obtains the duration of a specific state in a keyframe animation.
11993
11994**Since**: 12
11995
11996**Parameters**
11997
11998| Name| Description|
11999| -------- | -------- |
12000| option | Keyframe animation parameters. |
12001| index | Status index. |
12002
12003**Returns**
12004
12005Duration, in milliseconds.
12006
12007
12008### OH_ArkUI_KeyframeAnimateOption_GetIterations()
12009
12010```
12011int32_t OH_ArkUI_KeyframeAnimateOption_GetIterations (ArkUI_KeyframeAnimateOption * option)
12012```
12013**Description**
12014
12015Obtains the number of times that a keyframe animation is played.
12016
12017**Since**: 12
12018
12019**Parameters**
12020
12021| Name| Description|
12022| -------- | -------- |
12023| option | Keyframe animation parameters. |
12024
12025**Returns**
12026
12027Returns the number of times that the animation is played.
12028
12029### OH_ArkUI_KeyframeAnimateOption_GetExpectedFrameRate()
12030
12031```
12032ArkUI_ExpectedFrameRateRange* OH_ArkUI_KeyframeAnimateOption_GetExpectedFrameRate(ArkUI_KeyframeAnimateOption* option)
12033```
12034**Description**
12035
12036Obtains the expected frame rate from keyframe animation parameters.
12037
12038**Since**: 18
12039
12040**Parameters**
12041
12042| Name| Description|
12043| -------- | -------- |
12044| option | Keyframe animation parameters. |
12045
12046**Returns**
12047
12048Returns the expected frame rate obtained.
12049
12050
12051### OH_ArkUI_KeyframeAnimateOption_RegisterOnEventCallback()
12052
12053```
12054int32_t OH_ArkUI_KeyframeAnimateOption_RegisterOnEventCallback (ArkUI_KeyframeAnimateOption * option, void * userData, void(*)(void *userData) event, int32_t index )
12055```
12056**Description**
12057
12058Sets 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.
12059
12060**Parameters**
12061
12062| Name| Description|
12063| -------- | -------- |
12064| option | Keyframe animation parameters. |
12065| event | Closure function. |
12066| userData | Pointer to a custom object. |
12067| index | Status index. |
12068
12069**Returns**
12070
12071Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12072
12073
12074### OH_ArkUI_KeyframeAnimateOption_RegisterOnFinishCallback()
12075
12076```
12077int32_t OH_ArkUI_KeyframeAnimateOption_RegisterOnFinishCallback (ArkUI_KeyframeAnimateOption * option, void * userData, void(*)(void *userData) onFinish )
12078```
12079**Description**
12080
12081Sets 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.
12082
12083**Parameters**
12084
12085| Name| Description|
12086| -------- | -------- |
12087| option | Keyframe animation parameters. |
12088| userData | Pointer to a custom object. |
12089| onFinish | Callback used to return the result. |
12090
12091**Returns**
12092
12093Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12094
12095
12096### OH_ArkUI_KeyframeAnimateOption_SetCurve()
12097
12098```
12099int32_t OH_ArkUI_KeyframeAnimateOption_SetCurve (ArkUI_KeyframeAnimateOption * option, ArkUI_CurveHandle value, int32_t index )
12100```
12101**Description**
12102
12103Sets the animation curve for a specific keyframe in a keyframe animation.
12104
12105**Parameters**
12106
12107| Name| Description|
12108| -------- | -------- |
12109| option | Keyframe animation parameters. |
12110| value | Animation curve used by the key frame. Default value: **EASE_IN_OUT**. |
12111| index | Status index. |
12112
12113**NOTE**
12114
12115Because the **springMotion**, **responsiveSpringMotion**, and **interpolatingSpring** curves do not have effective duration settings, they are not supported.
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_KeyframeAnimateOption_SetDelay()
12123
12124```
12125int32_t OH_ArkUI_KeyframeAnimateOption_SetDelay (ArkUI_KeyframeAnimateOption * option, int32_t value )
12126```
12127**Description**
12128
12129Sets the overall delay of a keyframe animation, in milliseconds. By default, the keyframe animation is played without delay.
12130
12131**Parameters**
12132
12133| Name| Description|
12134| -------- | -------- |
12135| option | Keyframe animation parameters. |
12136| value | Delay time, in milliseconds. |
12137
12138**Returns**
12139
12140Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12141
12142
12143### OH_ArkUI_KeyframeAnimateOption_SetDuration()
12144
12145```
12146int32_t OH_ArkUI_KeyframeAnimateOption_SetDuration (ArkUI_KeyframeAnimateOption * option, int32_t value, int32_t index )
12147```
12148**Description**
12149
12150Sets the duration of a keyframe animation, in milliseconds.
12151
12152**Parameters**
12153
12154| Name| Description|
12155| -------- | -------- |
12156| option | Keyframe animation parameters. |
12157| value | Duration, in milliseconds. |
12158| index | Status index. |
12159
12160**Returns**
12161
12162Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12163
12164
12165### OH_ArkUI_KeyframeAnimateOption_SetIterations()
12166
12167```
12168int32_t OH_ArkUI_KeyframeAnimateOption_SetIterations (ArkUI_KeyframeAnimateOption * option, int32_t value )
12169```
12170**Description**
12171
12172Sets 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.
12173
12174**Parameters**
12175
12176| Name| Description|
12177| -------- | -------- |
12178| option | Keyframe animation parameters. |
12179| value | Number of times that the animation is played. |
12180
12181**Returns**
12182
12183Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12184
12185### OH_ArkUI_KeyframeAnimateOption_SetExpectedFrameRate()
12186
12187```
12188int32_t OH_ArkUI_KeyframeAnimateOption_SetExpectedFrameRate(
12189    ArkUI_KeyframeAnimateOption* option, ArkUI_ExpectedFrameRateRange* frameRate)
12190```
12191**Description**
12192
12193Sets the expected frame rate for a keyframe animation.
12194
12195**Since**: 18
12196
12197**Parameters**
12198
12199| Name| Description|
12200| -------- | -------- |
12201| option | Keyframe animation parameters. |
12202| frameRate | Expected frame rate to set. |
12203
12204**Returns**
12205
12206Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
12207Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12208
12209
12210### OH_ArkUI_LayoutConstraint_Copy()
12211
12212```
12213ArkUI_LayoutConstraint* OH_ArkUI_LayoutConstraint_Copy (const ArkUI_LayoutConstraint * Constraint)
12214```
12215**Description**
12216
12217Constraint size deep copy.
12218
12219**Since**: 12
12220
12221**Parameters**
12222
12223| Name| Description|
12224| -------- | -------- |
12225| Constraint | Size constraint. |
12226
12227**Returns**
12228
12229Pointer to the new constraint size.
12230
12231
12232### OH_ArkUI_LayoutConstraint_Create()
12233
12234```
12235ArkUI_LayoutConstraint* OH_ArkUI_LayoutConstraint_Create ()
12236```
12237**Description**
12238
12239Create a constraint size.
12240
12241**Since**: 12
12242
12243
12244### OH_ArkUI_LayoutConstraint_Dispose()
12245
12246```
12247void* OH_ArkUI_LayoutConstraint_Dispose (ArkUI_LayoutConstraint * Constraint)
12248```
12249**Description**
12250
12251Pointer to the size of the destruction constraint.
12252
12253**Since**: 12
12254
12255**Parameters**
12256
12257| Name| Description|
12258| -------- | -------- |
12259| Constraint | Size constraint. |
12260
12261
12262### OH_ArkUI_LayoutConstraint_GetMaxHeight()
12263
12264```
12265int32_t OH_ArkUI_LayoutConstraint_GetMaxHeight (const ArkUI_LayoutConstraint * Constraint)
12266```
12267**Description**
12268
12269Obtains the maximum height for a size constraint, in px.
12270
12271**Since**: 12
12272
12273**Parameters**
12274
12275| Name| Description|
12276| -------- | -------- |
12277| Constraint | Size constraint. |
12278
12279**Returns**
12280
12281Maximum height.
12282
12283
12284### OH_ArkUI_LayoutConstraint_GetMaxWidth()
12285
12286```
12287int32_t OH_ArkUI_LayoutConstraint_GetMaxWidth (const ArkUI_LayoutConstraint * Constraint)
12288```
12289**Description**
12290
12291Obtains the maximum width for a size constraint, in px.
12292
12293**Since**: 12
12294
12295**Parameters**
12296
12297| Name| Description|
12298| -------- | -------- |
12299| Constraint | Size constraint. |
12300
12301**Returns**
12302
12303Maximum width.
12304
12305
12306### OH_ArkUI_LayoutConstraint_GetMinHeight()
12307
12308```
12309int32_t OH_ArkUI_LayoutConstraint_GetMinHeight (const ArkUI_LayoutConstraint * Constraint)
12310```
12311**Description**
12312
12313Obtains the minimum height for a size constraint, in px.
12314
12315**Since**: 12
12316
12317**Parameters**
12318
12319| Name| Description|
12320| -------- | -------- |
12321| Constraint | Size constraint. |
12322
12323**Returns**
12324
12325Minimum Height
12326
12327
12328### OH_ArkUI_LayoutConstraint_GetMinWidth()
12329
12330```
12331int32_t OH_ArkUI_LayoutConstraint_GetMinWidth (const ArkUI_LayoutConstraint * Constraint)
12332```
12333**Description**
12334
12335Obtains the minimum width for a size constraint, in px.
12336
12337**Since**: 12
12338
12339**Parameters**
12340
12341| Name| Description|
12342| -------- | -------- |
12343| Constraint | Size constraint. |
12344
12345**Returns**
12346
12347Minimum Width
12348
12349
12350### OH_ArkUI_LayoutConstraint_GetPercentReferenceHeight()
12351
12352```
12353int32_t OH_ArkUI_LayoutConstraint_GetPercentReferenceHeight (const ArkUI_LayoutConstraint * Constraint)
12354```
12355**Description**
12356
12357Obtains the height percentage reference for a size constraint, in px.
12358
12359**Since**: 12
12360
12361**Parameters**
12362
12363| Name| Description|
12364| -------- | -------- |
12365| Constraint | Size constraint. |
12366
12367**Returns**
12368
12369Height percentage benchmark.
12370
12371
12372### OH_ArkUI_LayoutConstraint_GetPercentReferenceWidth()
12373
12374```
12375int32_t OH_ArkUI_LayoutConstraint_GetPercentReferenceWidth (const ArkUI_LayoutConstraint * Constraint)
12376```
12377**Description**
12378
12379Obtains the width percentage reference for a size constraint, in px.
12380
12381**Since**: 12
12382
12383**Parameters**
12384
12385| Name| Description|
12386| -------- | -------- |
12387| Constraint | Size constraint. |
12388
12389**Returns**
12390
12391Width percentage reference.
12392
12393
12394### OH_ArkUI_LayoutConstraint_SetMaxHeight()
12395
12396```
12397void OH_ArkUI_LayoutConstraint_SetMaxHeight (ArkUI_LayoutConstraint * Constraint, int32_t value )
12398```
12399**Description**
12400
12401Sets the maximum height.
12402
12403**Since**: 12
12404
12405**Parameters**
12406
12407| Name| Description|
12408| -------- | -------- |
12409| Constraint | Size constraint. |
12410| value | Maximum height, in pixels. |
12411
12412
12413### OH_ArkUI_LayoutConstraint_SetMaxWidth()
12414
12415```
12416void OH_ArkUI_LayoutConstraint_SetMaxWidth (ArkUI_LayoutConstraint * Constraint, int32_t value )
12417```
12418**Description**
12419
12420Sets the maximum width.
12421
12422**Since**: 12
12423
12424**Parameters**
12425
12426| Name| Description|
12427| -------- | -------- |
12428| Constraint | Size constraint. |
12429| value | Maximum width, in pixels. |
12430
12431
12432### OH_ArkUI_LayoutConstraint_SetMinHeight()
12433
12434```
12435void OH_ArkUI_LayoutConstraint_SetMinHeight (ArkUI_LayoutConstraint * Constraint, int32_t value )
12436```
12437**Description**
12438
12439Sets the minimum height.
12440
12441**Since**: 12
12442
12443**Parameters**
12444
12445| Name| Description|
12446| -------- | -------- |
12447| Constraint | Size constraint. |
12448| value | Minimum height, in pixels. |
12449
12450
12451### OH_ArkUI_LayoutConstraint_SetMinWidth()
12452
12453```
12454void OH_ArkUI_LayoutConstraint_SetMinWidth (ArkUI_LayoutConstraint * Constraint, int32_t value )
12455```
12456**Description**
12457
12458Sets the minimum width.
12459
12460**Since**: 12
12461
12462**Parameters**
12463
12464| Name| Description|
12465| -------- | -------- |
12466| Constraint | Size constraint. |
12467| value | Minimum width, in pixels. |
12468
12469
12470### OH_ArkUI_LayoutConstraint_SetPercentReferenceHeight()
12471
12472```
12473void OH_ArkUI_LayoutConstraint_SetPercentReferenceHeight (ArkUI_LayoutConstraint * Constraint, int32_t value )
12474```
12475**Description**
12476
12477Sets the height percentage reference.
12478
12479**Since**: 12
12480
12481**Parameters**
12482
12483| Name| Description|
12484| -------- | -------- |
12485| Constraint | Size constraint. |
12486| value | Height percentage base, in px. |
12487
12488
12489### OH_ArkUI_LayoutConstraint_SetPercentReferenceWidth()
12490
12491```
12492void OH_ArkUI_LayoutConstraint_SetPercentReferenceWidth (ArkUI_LayoutConstraint * Constraint, int32_t value )
12493```
12494**Description**
12495
12496Sets the width percentage reference.
12497
12498**Since**: 12
12499
12500**Parameters**
12501
12502| Name| Description|
12503| -------- | -------- |
12504| Constraint | Size constraint. |
12505| value | Width percentage benchmark, in px. |
12506
12507
12508### OH_ArkUI_List_CloseAllSwipeActions()
12509
12510```
12511int32_t OH_ArkUI_List_CloseAllSwipeActions (ArkUI_NodeHandle node, void * userData, void(*)(void *userData) onFinish )
12512```
12513**Description**
12514
12515Collapse the expanded ListItem.
12516
12517**Since**: 12
12518
12519**Parameters**
12520
12521| Name| Description|
12522| -------- | -------- |
12523| node | Node object for which an event needs to be registered. |
12524| userData | Custom event parameter, which is passed in the callback when the event is triggered. |
12525| onFinish | Callback triggered after the collapse animation is complete. |
12526
12527**Returns**
12528
12529Returns **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.
12530
12531
12532### OH_ArkUI_ListChildrenMainSizeOption_Create()
12533
12534```
12535ArkUI_ListChildrenMainSize* OH_ArkUI_ListChildrenMainSizeOption_Create ()
12536```
12537**Description**
12538
12539Creates a **ListChildrenMainSize** instance.
12540
12541**Since**: 12
12542
12543**Returns**
12544
12545Returns the created **ListChildrenMainSize** instance.
12546
12547### OH_ArkUI_ListChildrenMainSizeOption_Dispose()
12548
12549```
12550void OH_ArkUI_ListChildrenMainSizeOption_Dispose (ArkUI_ListChildrenMainSize * option)
12551```
12552**Description**
12553
12554Destroys a ListChildrenMainSize instance.
12555
12556**Since**: 12
12557
12558**Parameters**
12559
12560| Name| Description|
12561| -------- | -------- |
12562| option | ListChildrenMainSize instance to be destroyed. |
12563
12564
12565### OH_ArkUI_ListChildrenMainSizeOption_GetDefaultMainSize()
12566
12567```
12568float OH_ArkUI_ListChildrenMainSizeOption_GetDefaultMainSize (ArkUI_ListChildrenMainSize * option)
12569```
12570**Description**
12571
12572Obtains the default size in a **ListChildrenMainSize** instance.
12573
12574**Since**: 12
12575
12576**Parameters**
12577
12578| Name| Description|
12579| -------- | -------- |
12580| option | **ListChildrenMainSize** instance. |
12581
12582**Returns**
12583
12584Returns the default size, in vp. The default value is **0**. If **option** is a null pointer, **-1** is returned.
12585
12586
12587### OH_ArkUI_ListChildrenMainSizeOption_GetMainSize()
12588
12589```
12590float OH_ArkUI_ListChildrenMainSizeOption_GetMainSize (ArkUI_ListChildrenMainSize * option, int32_t index )
12591```
12592**Description**
12593
12594Obtains the value of the **ChildrenMainSizeOption** array of the **List** component.
12595
12596**Since**: 12
12597
12598**Parameters**
12599
12600| Name| Description|
12601| -------- | -------- |
12602| option | **ListChildrenMainSize** instance. |
12603| index | Subscript position of the value to be obtained. |
12604
12605**Returns**
12606
12607Value of the specific position of the array. If a parameter error occurs, **-1** is returned.
12608
12609
12610### OH_ArkUI_ListChildrenMainSizeOption_Resize()
12611
12612```
12613void OH_ArkUI_ListChildrenMainSizeOption_Resize (ArkUI_ListChildrenMainSize * option, int32_t totalSize )
12614```
12615**Description**
12616
12617Resets the array size of ChildrenMainSizeOption of the List component.
12618
12619**Since**: 12
12620
12621**Parameters**
12622
12623| Name| Description|
12624| -------- | -------- |
12625| option | **ListChildrenMainSize** instance. |
12626| totalSize | Array size. |
12627
12628
12629### OH_ArkUI_ListChildrenMainSizeOption_SetDefaultMainSize()
12630
12631```
12632int32_t OH_ArkUI_ListChildrenMainSizeOption_SetDefaultMainSize (ArkUI_ListChildrenMainSize * option, float defaultMainSize )
12633```
12634**Description**
12635
12636Sets the default size in a **ListChildrenMainSize** instance.
12637
12638**Since**: 12
12639
12640**Parameters**
12641
12642| Name| Description|
12643| -------- | -------- |
12644| option | **ListChildrenMainSize** instance. |
12645| defaultMainSize | Default size of a list item in a list. The unit is vp. |
12646
12647**Returns**
12648
12649Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12650
12651
12652### OH_ArkUI_ListChildrenMainSizeOption_Splice()
12653
12654```
12655int32_t OH_ArkUI_ListChildrenMainSizeOption_Splice (ArkUI_ListChildrenMainSize * option, int32_t index, int32_t deleteCount, int32_t addCount )
12656```
12657**Description**
12658
12659The size of the ChildrenMainSizeOption array of the List component is adjusted.
12660
12661**Since**: 12
12662
12663**Parameters**
12664
12665| Name| Description|
12666| -------- | -------- |
12667| option | **ListChildrenMainSize** instance. |
12668| index | Start position of the array whose MainSize is to be modified. |
12669| deleteCount | Number of MainSize arrays to be deleted starting from index. |
12670| addCount | Number of MainSize arrays to be added starting from index. |
12671
12672**Returns**
12673
12674Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12675
12676
12677### OH_ArkUI_ListChildrenMainSizeOption_UpdateSize()
12678
12679```
12680int32_t OH_ArkUI_ListChildrenMainSizeOption_UpdateSize (ArkUI_ListChildrenMainSize * option, int32_t index, float mainSize )
12681```
12682**Description**
12683
12684Updates the values in a **ChildrenMainSizeOption** array of a **List** component.
12685
12686**Since**: 12
12687
12688**Parameters**
12689
12690| Name| Description|
12691| -------- | -------- |
12692| option | **ListChildrenMainSize** instance. |
12693| index | Index at which to start changing the values in the array. |
12694| mainSize | New size value to set at the specified index. |
12695
12696**Returns**
12697
12698Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
12699
12700
12701### OH_ArkUI_ListItemSwipeActionItem_Create()
12702
12703```
12704ArkUI_ListItemSwipeActionItem* OH_ArkUI_ListItemSwipeActionItem_Create ()
12705```
12706**Description**
12707
12708Creates a **ListItemSwipeActionItem** instance.
12709
12710**Since**: 12
12711
12712**Returns**
12713
12714Returns the created **ListItemSwipeActionItem** instance.
12715
12716
12717### OH_ArkUI_ListItemSwipeActionItem_Dispose()
12718
12719```
12720void OH_ArkUI_ListItemSwipeActionItem_Dispose (ArkUI_ListItemSwipeActionItem * item)
12721```
12722**Description**
12723
12724Disposes of a **ListItemSwipeActionItem** instance.
12725
12726**Since**: 12
12727
12728**Parameters**
12729
12730| Name| Description|
12731| -------- | -------- |
12732| item | **ListItemSwipeActionItem** instance to dispose of. |
12733
12734
12735### OH_ArkUI_ListItemSwipeActionItem_GetActionAreaDistance()
12736
12737```
12738float OH_ArkUI_ListItemSwipeActionItem_GetActionAreaDistance (ArkUI_ListItemSwipeActionItem * item)
12739```
12740**Description**
12741
12742Obtains the swipe distance threshold for deleting the list item.
12743
12744**Since**: 12
12745
12746**Parameters**
12747
12748| Name| Description|
12749| -------- | -------- |
12750| item | Target **ListItemSwipeActionItem** instance. |
12751
12752**Returns**
12753
12754Returns the swipe distance threshold for deleting the list item. Return **0** if an error occurs.
12755
12756
12757### OH_ArkUI_ListItemSwipeActionItem_SetActionAreaDistance()
12758
12759```
12760void OH_ArkUI_ListItemSwipeActionItem_SetActionAreaDistance (ArkUI_ListItemSwipeActionItem * item, float distance )
12761```
12762**Description**
12763
12764Swipe distance threshold for deleting the list item.
12765
12766**Since**: 12
12767
12768**Parameters**
12769
12770| Name| Description|
12771| -------- | -------- |
12772| item | Target **ListItemSwipeActionItem** instance. |
12773| distance | Returns the swipe distance threshold for deleting the list item. |
12774
12775
12776### OH_ArkUI_ListItemSwipeActionItem_SetContent()
12777
12778```
12779void OH_ArkUI_ListItemSwipeActionItem_SetContent (ArkUI_ListItemSwipeActionItem * item, ArkUI_NodeHandle node )
12780```
12781**Description**
12782
12783Sets the layout content of ListItemSwipeActionItem.
12784
12785**Since**: 12
12786
12787**Parameters**
12788
12789| Name| Description|
12790| -------- | -------- |
12791| item | Target **ListItemSwipeActionItem** instance. |
12792| node | Layout information |
12793
12794
12795### OH_ArkUI_ListItemSwipeActionItem_SetOnAction()
12796
12797```
12798void OH_ArkUI_ListItemSwipeActionItem_SetOnAction (ArkUI_ListItemSwipeActionItem * item, void(*)() callback )
12799```
12800**Description**
12801
12802Sets the callback invoked when the list item is deleted while in the delete area.
12803
12804**Since**: 12
12805
12806**Parameters**
12807
12808| Name| Description|
12809| -------- | -------- |
12810| item | Target **ListItemSwipeActionItem** instance. |
12811| callback | Callback to invoke when an event of the specified type occurs. |
12812
12813
12814### OH_ArkUI_ListItemSwipeActionItem_SetOnActionWithUserData()
12815
12816```
12817void OH_ArkUI_ListItemSwipeActionItem_SetOnActionWithUserData (ArkUI_ListItemSwipeActionItem * item, void * userData, void(*)(void *userData) callback )
12818```
12819**Description**
12820
12821Sets the callback invoked when the list item is deleted while in the delete area.
12822
12823**Since**: 12
12824
12825**Parameters**
12826
12827| Name| Description|
12828| -------- | -------- |
12829| item | Target **ListItemSwipeActionItem** instance. |
12830| userData | Custom data. |
12831| callback | Callback to invoke when an event of the specified type occurs. |
12832
12833
12834### OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionArea()
12835
12836```
12837void OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionArea (ArkUI_ListItemSwipeActionItem * item, void(*)() callback )
12838```
12839**Description**
12840
12841Sets the callback invoked each time the list item enters the delete area.
12842
12843**Since**: 12
12844
12845**Parameters**
12846
12847| Name| Description|
12848| -------- | -------- |
12849| item | Target **ListItemSwipeActionItem** instance. |
12850| callback | Callback to invoke when an event of the specified type occurs. |
12851
12852
12853### OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionAreaWithUserData()
12854
12855```
12856void OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionAreaWithUserData (ArkUI_ListItemSwipeActionItem * item, void * userData, void(*)(void *userData) callback )
12857```
12858**Description**
12859
12860Sets the callback invoked each time the list item enters the delete area.
12861
12862**Since**: 12
12863
12864**Parameters**
12865
12866| Name| Description|
12867| -------- | -------- |
12868| item | Target **ListItemSwipeActionItem** instance. |
12869| userData | Custom data. |
12870| callback | Callback to invoke when an event of the specified type occurs. |
12871
12872
12873### OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionArea()
12874
12875```
12876void OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionArea (ArkUI_ListItemSwipeActionItem * item, void(*)() callback )
12877```
12878**Description**
12879
12880Sets the callback invoked each time the list item exits the delete area.
12881
12882**Since**: 12
12883
12884**Parameters**
12885
12886| Name| Description|
12887| -------- | -------- |
12888| item | Target **ListItemSwipeActionItem** instance. |
12889| callback | Callback to invoke when an event of the specified type occurs. |
12890
12891
12892### OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionAreaWithUserData()
12893
12894```
12895void OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionAreaWithUserData (ArkUI_ListItemSwipeActionItem * item, void * userData, void(*)(void *userData) callback )
12896```
12897**Description**
12898
12899Sets the callback invoked each time the list item exits the delete area.
12900
12901**Since**: 12
12902
12903**Parameters**
12904
12905| Name| Description|
12906| -------- | -------- |
12907| item | Target **ListItemSwipeActionItem** instance. |
12908| userData | Custom data. |
12909| callback | Callback to invoke when an event of the specified type occurs. |
12910
12911
12912### OH_ArkUI_ListItemSwipeActionItem_SetOnStateChange()
12913
12914```
12915void OH_ArkUI_ListItemSwipeActionItem_SetOnStateChange (ArkUI_ListItemSwipeActionItem * item, void(*)(ArkUI_ListItemSwipeActionState swipeActionState) callback )
12916```
12917**Description**
12918
12919Sets the callback invoked when the swipe state of the list item changes.
12920
12921**Since**: 12
12922
12923**Parameters**
12924
12925| Name| Description|
12926| -------- | -------- |
12927| item | Target **ListItemSwipeActionItem** instance. |
12928| callback | Status after the callback event swipeActionState changes. |
12929
12930
12931### OH_ArkUI_ListItemSwipeActionItem_SetOnStateChangeWithUserData()
12932
12933```
12934void OH_ArkUI_ListItemSwipeActionItem_SetOnStateChangeWithUserData (ArkUI_ListItemSwipeActionItem * item, void * userData, void(*)(ArkUI_ListItemSwipeActionState swipeActionState, void *userData) callback )
12935```
12936**Description**
12937
12938Sets the callback invoked when the swipe state of the list item changes.
12939
12940**Since**: 12
12941
12942**Parameters**
12943
12944| Name| Description|
12945| -------- | -------- |
12946| item | Target **ListItemSwipeActionItem** instance. |
12947| userData | Custom data. |
12948| callback | Status after the callback event swipeActionState changes. |
12949
12950
12951### OH_ArkUI_ListItemSwipeActionOption_Create()
12952
12953```
12954ArkUI_ListItemSwipeActionOption* OH_ArkUI_ListItemSwipeActionOption_Create ()
12955```
12956**Description**
12957
12958Creates a **ListItemSwipeActionOption** instance.
12959
12960**Since**: 12
12961
12962**Returns**
12963
12964ListItemSwipeActionOption configuration item instance.
12965
12966
12967### OH_ArkUI_ListItemSwipeActionOption_Dispose()
12968
12969```
12970void OH_ArkUI_ListItemSwipeActionOption_Dispose (ArkUI_ListItemSwipeActionOption * option)
12971```
12972**Description**
12973
12974Destroys a ListItemSwipeActionOption instance.
12975
12976**Since**: 12
12977
12978**Parameters**
12979
12980| Name| Description|
12981| -------- | -------- |
12982| option | ListItemSwipeActionOption instance to destroy. |
12983
12984
12985### OH_ArkUI_ListItemSwipeActionOption_GetEdgeEffect()
12986
12987```
12988int32_t OH_ArkUI_ListItemSwipeActionOption_GetEdgeEffect (ArkUI_ListItemSwipeActionOption * option)
12989```
12990**Description**
12991
12992Obtains the sliding effect.
12993
12994**Since**: 12
12995
12996**Parameters**
12997
12998| Name| Description|
12999| -------- | -------- |
13000| option | Target **ListItemSwipeActionItem** instance. |
13001
13002**Returns**
13003
13004Scroll effect. The default return value is **ARKUI_LIST_ITEM_SWIPE_EDGE_EFFECT_SPRING**.
13005
13006
13007### OH_ArkUI_ListItemSwipeActionOption_SetEdgeEffect()
13008
13009```
13010void OH_ArkUI_ListItemSwipeActionOption_SetEdgeEffect (ArkUI_ListItemSwipeActionOption * option, ArkUI_ListItemSwipeEdgeEffect edgeEffect )
13011```
13012**Description**
13013
13014Sets the sliding effect.
13015
13016**Since**: 12
13017
13018**Parameters**
13019
13020| Name| Description|
13021| -------- | -------- |
13022| option | Target **ListItemSwipeActionItem** instance. |
13023| edgeEffect | Scroll effect. |
13024
13025
13026### OH_ArkUI_ListItemSwipeActionOption_SetEnd()
13027
13028```
13029void OH_ArkUI_ListItemSwipeActionOption_SetEnd (ArkUI_ListItemSwipeActionOption * option, ArkUI_ListItemSwipeActionItem * item )
13030```
13031**Description**
13032
13033Sets the layout content for the right edge (for a vertical layout) or bottom edge (for a horizontal layout) of a **ListItemSwipeActionItem** instance.
13034
13035**Since**: 12
13036
13037**Parameters**
13038
13039| Name| Description|
13040| -------- | -------- |
13041| option | Target **ListItemSwipeActionItem** instance. |
13042| builder | Layout information |
13043
13044
13045### OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChange()
13046
13047```
13048void OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChange (ArkUI_ListItemSwipeActionOption * option, void(*)(float offset) callback )
13049```
13050**Description**
13051
13052Sets the callback invoked when the scroll offset changes.
13053
13054**Since**: 12
13055
13056**Parameters**
13057
13058| Name| Description|
13059| -------- | -------- |
13060| option | Target **ListItemSwipeActionItem** instance. |
13061| callback | Sliding offset of the callback event offset. |
13062
13063
13064### OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChangeWithUserData()
13065
13066```
13067void OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChangeWithUserData (ArkUI_ListItemSwipeActionOption * option, void * userData, void(*)(float offset, void *userData) callback )
13068```
13069**Description**
13070
13071Sets the callback invoked when the scroll offset changes.
13072
13073**Since**: 12
13074
13075**Parameters**
13076
13077| Name| Description|
13078| -------- | -------- |
13079| option | Target **ListItemSwipeActionItem** instance. |
13080| userData | Custom data. |
13081| callback | Sliding offset of the callback event offset. |
13082
13083
13084### OH_ArkUI_ListItemSwipeActionOption_SetStart()
13085
13086```
13087void OH_ArkUI_ListItemSwipeActionOption_SetStart (ArkUI_ListItemSwipeActionOption * option, ArkUI_ListItemSwipeActionItem * item )
13088```
13089**Description**
13090
13091Sets the layout content for the left edge (for a vertical layout) or top edge (for a horizontal layout) of a **ListItemSwipeActionItem** instance.
13092
13093**Since**: 12
13094
13095**Parameters**
13096
13097| Name| Description|
13098| -------- | -------- |
13099| option | Target **ListItemSwipeActionItem** instance. |
13100| builder | Layout information |
13101
13102
13103### OH_ArkUI_LongPress_GetRepeatCount()
13104
13105```
13106int32_t OH_ArkUI_LongPress_GetRepeatCount (const ArkUI_GestureEvent * event)
13107```
13108**Description**
13109
13110Obtains the number of times that a long press gesture is triggered periodically.
13111
13112**Since**: 12
13113
13114**Parameters**
13115
13116| Name| Description|
13117| -------- | -------- |
13118| event | Gesture event. |
13119
13120**Returns**
13121
13122Returns the number of times that the long press gesture is triggered periodically.
13123
13124
13125### OH_ArkUI_MarshallStyledStringDescriptor()
13126
13127```
13128int32_t OH_ArkUI_MarshallStyledStringDescriptor (uint8_t * buffer, size_t bufferSize, ArkUI_StyledString_Descriptor * descriptor )
13129```
13130**Description**
13131
13132Serializes the styled string information into a byte array.
13133
13134**Since**: 14
13135
13136**Parameters**
13137
13138| Name| Description|
13139| -------- | -------- |
13140| buffer | Byte array where the serialized data will be stored. |
13141| bufferSize | Length of the byte array. |
13142| descriptor | Pointer to an **ArkUI_StyledString_Descriptor** object. |
13143
13144**Returns**
13145
13146Returns **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.
13147
13148
13149### OH_ArkUI_NodeAdapter_Create()
13150
13151```
13152ArkUI_NodeAdapterHandle OH_ArkUI_NodeAdapter_Create ()
13153```
13154**Description**
13155
13156Creates a component adapter.
13157
13158**Since**: 12
13159
13160
13161### OH_ArkUI_NodeAdapter_Dispose()
13162
13163```
13164void OH_ArkUI_NodeAdapter_Dispose (ArkUI_NodeAdapterHandle handle)
13165```
13166**Description**
13167
13168Destroys a component adapter.
13169
13170**Since**: 12
13171
13172**Parameters**
13173
13174| Name| Description|
13175| -------- | -------- |
13176| handle | Component adapter object. |
13177
13178
13179### OH_ArkUI_NodeAdapter_GetAllItems()
13180
13181```
13182int32_t OH_ArkUI_NodeAdapter_GetAllItems (ArkUI_NodeAdapterHandle handle, ArkUI_NodeHandle ** items, uint32_t * size )
13183```
13184**Description**
13185
13186Obtains all elements stored in the specified adapter.
13187
13188When 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.
13189
13190**Since**: 12
13191
13192**Parameters**
13193
13194| Name| Description|
13195| -------- | -------- |
13196| handle | Component adapter object. |
13197| items | Array of nodes in the adapter. |
13198| size | Number of elements. |
13199
13200**Returns**
13201
13202Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13203
13204
13205### OH_ArkUI_NodeAdapter_GetTotalNodeCount()
13206
13207```
13208uint32_t OH_ArkUI_NodeAdapter_GetTotalNodeCount (ArkUI_NodeAdapterHandle handle)
13209```
13210**Description**
13211
13212Obtains the total number of elements in the Adapter.
13213
13214**Since**: 12
13215
13216**Parameters**
13217
13218| Name| Description|
13219| -------- | -------- |
13220| handle | Component adapter object. |
13221
13222**Returns**
13223
13224Total number of elements in the Adapter.
13225
13226
13227### OH_ArkUI_NodeAdapter_InsertItem()
13228
13229```
13230int32_t OH_ArkUI_NodeAdapter_InsertItem (ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount )
13231```
13232**Description**
13233
13234Instructs the specified adapter to insert certain elements.
13235
13236**Since**: 12
13237
13238**Parameters**
13239
13240| Name| Description|
13241| -------- | -------- |
13242| handle | Component adapter object. |
13243| startPosition | Start position for inserting an element. |
13244| itemCount | Number of inserted elements. |
13245
13246**Returns**
13247
13248Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13249
13250
13251### OH_ArkUI_NodeAdapter_MoveItem()
13252
13253```
13254int32_t OH_ArkUI_NodeAdapter_MoveItem (ArkUI_NodeAdapterHandle handle, uint32_t from, uint32_t to )
13255```
13256**Description**
13257
13258Instructs the specified adapter to move certain elements.
13259
13260**Since**: 12
13261
13262**Parameters**
13263
13264| Name| Description|
13265| -------- | -------- |
13266| handle | Component adapter object. |
13267| from | Start position of the element shift. |
13268| to | End position of the element shift. |
13269
13270**Returns**
13271
13272Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13273
13274
13275### OH_ArkUI_NodeAdapter_RegisterEventReceiver()
13276
13277```
13278int32_t OH_ArkUI_NodeAdapter_RegisterEventReceiver (ArkUI_NodeAdapterHandle handle, void * userData, void(*)(ArkUI_NodeAdapterEvent *event) receiver )
13279```
13280**Description**
13281
13282Registers callback events related to the Adapter.
13283
13284**Since**: 12
13285
13286**Parameters**
13287
13288| Name| Description|
13289| -------- | -------- |
13290| handle | Component adapter object. |
13291| userData | Custom data. |
13292| receiver | Event receiving callback. |
13293
13294**Returns**
13295
13296Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13297
13298
13299### OH_ArkUI_NodeAdapter_ReloadAllItems()
13300
13301```
13302int32_t OH_ArkUI_NodeAdapter_ReloadAllItems (ArkUI_NodeAdapterHandle handle)
13303```
13304**Description**
13305
13306Instructs the specified adapter to reload all elements.
13307
13308**Since**: 12
13309
13310**Parameters**
13311
13312| Name| Description|
13313| -------- | -------- |
13314| handle | Component adapter object. |
13315
13316**Returns**
13317
13318Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13319
13320
13321### OH_ArkUI_NodeAdapter_ReloadItem()
13322
13323```
13324int32_t OH_ArkUI_NodeAdapter_ReloadItem (ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount )
13325```
13326**Description**
13327
13328Instructs the specified adapter to reload certain elements.
13329
13330**Since**: 12
13331
13332**Parameters**
13333
13334| Name| Description|
13335| -------- | -------- |
13336| handle | Component adapter object. |
13337| startPosition | Start position of an element change. |
13338| itemCount | Number of changed elements. |
13339
13340**Returns**
13341
13342Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13343
13344
13345### OH_ArkUI_NodeAdapter_RemoveItem()
13346
13347```
13348int32_t OH_ArkUI_NodeAdapter_RemoveItem (ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount )
13349```
13350**Description**
13351
13352Instructs the specified adapter to remove certain elements.
13353
13354**Since**: 12
13355
13356**Parameters**
13357
13358| Name| Description|
13359| -------- | -------- |
13360| handle | Component adapter object. |
13361| startPosition | Start position for deleting an element. |
13362| itemCount | Number of deleted elements. |
13363
13364**Returns**
13365
13366Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13367
13368
13369### OH_ArkUI_NodeAdapter_SetTotalNodeCount()
13370
13371```
13372int32_t OH_ArkUI_NodeAdapter_SetTotalNodeCount (ArkUI_NodeAdapterHandle handle, uint32_t size )
13373```
13374**Description**
13375
13376Sets the total number of elements in the specified adapter.
13377
13378**Since**: 12
13379
13380**Parameters**
13381
13382| Name| Description|
13383| -------- | -------- |
13384| handle | Component adapter object. |
13385| size | Number of elements. |
13386
13387**Returns**
13388
13389Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13390
13391
13392### OH_ArkUI_NodeAdapter_UnregisterEventReceiver()
13393
13394```
13395void OH_ArkUI_NodeAdapter_UnregisterEventReceiver (ArkUI_NodeAdapterHandle handle)
13396```
13397**Description**
13398
13399Deregisters Adapter-related callback events.
13400
13401**Since**: 12
13402
13403**Parameters**
13404
13405| Name| Description|
13406| -------- | -------- |
13407| handle | Component adapter object. |
13408
13409
13410### OH_ArkUI_NodeAdapterEvent_GetHostNode()
13411
13412```
13413ArkUI_NodeHandle OH_ArkUI_NodeAdapterEvent_GetHostNode (ArkUI_NodeAdapterEvent * event)
13414```
13415**Description**
13416
13417Obtains the scrolling class container node that uses the adapter.
13418
13419**Since**: 12
13420
13421**Parameters**
13422
13423| Name| Description|
13424| -------- | -------- |
13425| event | Adapter event object. |
13426
13427**Returns**
13428
13429Returns the scrollable container node that uses the specified adapter.
13430
13431
13432### OH_ArkUI_NodeAdapterEvent_GetItemIndex()
13433
13434```
13435uint32_t OH_ArkUI_NodeAdapterEvent_GetItemIndex (ArkUI_NodeAdapterEvent * event)
13436```
13437**Description**
13438
13439Sequence number of the element to be operated when the adapter event is obtained.
13440
13441**Since**: 12
13442
13443**Parameters**
13444
13445| Name| Description|
13446| -------- | -------- |
13447| event | Adapter event object. |
13448
13449**Returns**
13450
13451Sequence number of an element.
13452
13453
13454### OH_ArkUI_NodeAdapterEvent_GetRemovedNode()
13455
13456```
13457ArkUI_NodeHandle OH_ArkUI_NodeAdapterEvent_GetRemovedNode (ArkUI_NodeAdapterEvent * event)
13458```
13459**Description**
13460
13461Obtains the element to be destroyed in the event to be destroyed.
13462
13463**Since**: 12
13464
13465**Parameters**
13466
13467| Name| Description|
13468| -------- | -------- |
13469| event | Adapter event object. |
13470
13471**Returns**
13472
13473Element to be destroyed.
13474
13475
13476### OH_ArkUI_NodeAdapterEvent_GetType()
13477
13478```
13479ArkUI_NodeAdapterEventType OH_ArkUI_NodeAdapterEvent_GetType (ArkUI_NodeAdapterEvent * event)
13480```
13481**Description**
13482
13483Obtains the event type.
13484
13485**Since**: 12
13486
13487**Parameters**
13488
13489| Name| Description|
13490| -------- | -------- |
13491| event | Adapter event object. |
13492
13493**Returns**
13494
13495Represents an event type.
13496
13497
13498### OH_ArkUI_NodeAdapterEvent_GetUserData()
13499
13500```
13501void* OH_ArkUI_NodeAdapterEvent_GetUserData (ArkUI_NodeAdapterEvent * event)
13502```
13503**Description**
13504
13505Obtains the custom data passed in during registration of the specified event.
13506
13507**Since**: 12
13508
13509**Parameters**
13510
13511| Name| Description|
13512| -------- | -------- |
13513| event | Adapter event object. |
13514
13515
13516### OH_ArkUI_NodeAdapterEvent_SetItem()
13517
13518```
13519int32_t OH_ArkUI_NodeAdapterEvent_SetItem (ArkUI_NodeAdapterEvent * event, ArkUI_NodeHandle node )
13520```
13521**Description**
13522
13523Sets the component to be added to the specified adapter.
13524
13525**Since**: 12
13526
13527**Parameters**
13528
13529| Name| Description|
13530| -------- | -------- |
13531| event | Adapter event object. |
13532| node | Component to be added. |
13533
13534**Returns**
13535
13536Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13537
13538
13539### OH_ArkUI_NodeAdapterEvent_SetNodeId()
13540
13541```
13542int32_t OH_ArkUI_NodeAdapterEvent_SetNodeId (ArkUI_NodeAdapterEvent * event, int32_t id )
13543```
13544**Description**
13545
13546Sets the generated component ID.
13547
13548**Since**: 12
13549
13550**Parameters**
13551
13552| Name| Description|
13553| -------- | -------- |
13554| event | Adapter event object. |
13555| id | Sets the returned component ID. |
13556
13557**Returns**
13558
13559Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13560
13561
13562### OH_ArkUI_NodeContent_AddNode()
13563
13564```
13565int32_t OH_ArkUI_NodeContent_AddNode (ArkUI_NodeContentHandle content, ArkUI_NodeHandle node )
13566```
13567**Description**
13568
13569Adds an ArkUI component node to the specified NodeContent object.
13570
13571**Since**: 12
13572
13573**Parameters**
13574
13575| Name| Description|
13576| -------- | -------- |
13577| content | NodeContent object to which a node is to be added. |
13578| node | Node to be added. |
13579
13580**Returns**
13581
13582Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13583
13584
13585### OH_ArkUI_NodeContent_GetUserData()
13586
13587```
13588void* OH_ArkUI_NodeContent_GetUserData (ArkUI_NodeContentHandle content)
13589```
13590**Description**
13591
13592Obtains the user-defined data saved on the NodeContent object.
13593
13594**Since**: 12
13595
13596**Parameters**
13597
13598| Name| Description|
13599| -------- | -------- |
13600| content | NodeContent object whose user-defined data needs to be saved. |
13601
13602**Returns**
13603
13604Custom data.
13605
13606
13607### OH_ArkUI_NodeContent_InsertNode()
13608
13609```
13610int32_t OH_ArkUI_NodeContent_InsertNode (ArkUI_NodeContentHandle content, ArkUI_NodeHandle node, int32_t position )
13611```
13612**Description**
13613
13614Inserts an ArkUI component node into a specific location of the corresponding NodeContent object.
13615
13616**Since**: 12
13617
13618**Parameters**
13619
13620| Name| Description|
13621| -------- | -------- |
13622| content | NodeContent object of the node to be inserted. |
13623| node | Node to be inserted. |
13624| position | Start time for an asset to be inserted, |
13625
13626**Returns**
13627
13628Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13629
13630
13631### OH_ArkUI_NodeContent_RegisterCallback()
13632
13633```
13634int32_t OH_ArkUI_NodeContent_RegisterCallback (ArkUI_NodeContentHandle content, ArkUI_NodeContentCallback callback )
13635```
13636**Description**
13637
13638Registers the NodeContent event function.
13639
13640**Since**: 12
13641
13642**Parameters**
13643
13644| Name| Description|
13645| -------- | -------- |
13646| content | NodeContent object for which an event needs to be registered. |
13647| callback | Callback to be executed when the event is triggered. |
13648
13649**Returns**
13650
13651Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13652
13653
13654### OH_ArkUI_NodeContent_RemoveNode()
13655
13656```
13657int32_t OH_ArkUI_NodeContent_RemoveNode (ArkUI_NodeContentHandle content, ArkUI_NodeHandle node )
13658```
13659**Description**
13660
13661Removes an ArkUI component node from the specified NodeContent object.
13662
13663**Since**: 12
13664
13665**Parameters**
13666
13667| Name| Description|
13668| -------- | -------- |
13669| content | NodeContent object of the node to be deleted. |
13670| node | Node to be deleted. |
13671
13672**Returns**
13673
13674Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13675
13676
13677### OH_ArkUI_NodeContent_SetUserData()
13678
13679```
13680int32_t OH_ArkUI_NodeContent_SetUserData (ArkUI_NodeContentHandle content, void * userData )
13681```
13682**Description**
13683
13684Saves user-defined data on the NodeContent object.
13685
13686**Since**: 12
13687
13688**Parameters**
13689
13690| Name| Description|
13691| -------- | -------- |
13692| content | NodeContent object whose user-defined data needs to be saved. |
13693| userData | User-defined data to be saved. |
13694
13695**Returns**
13696
13697Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
13698
13699
13700### OH_ArkUI_NodeContentEvent_GetEventType()
13701
13702```
13703ArkUI_NodeContentEventType OH_ArkUI_NodeContentEvent_GetEventType (ArkUI_NodeContentEvent * event)
13704```
13705**Description**
13706
13707Obtains the type of the specified NodeContent event.
13708
13709**Since**: 12
13710
13711**Parameters**
13712
13713| Name| Description|
13714| -------- | -------- |
13715| event | Pointer to the NodeContent event. |
13716
13717**Returns**
13718
13719NodeContent event type.
13720
13721
13722### OH_ArkUI_NodeContentEvent_GetNodeContentHandle()
13723
13724```
13725ArkUI_NodeContentHandle OH_ArkUI_NodeContentEvent_GetNodeContentHandle (ArkUI_NodeContentEvent * event)
13726```
13727**Description**
13728
13729Obtains the object that triggers the specified NodeContent event.
13730
13731**Since**: 12
13732
13733**Parameters**
13734
13735| Name| Description|
13736| -------- | -------- |
13737| event | Pointer to the NodeContent event. |
13738
13739**Returns**
13740
13741Returns the NodeContent object that triggers the event.
13742
13743
13744### OH_ArkUI_NodeCustomEvent_GetCustomSpanDrawInfo()
13745
13746```
13747int32_t OH_ArkUI_NodeCustomEvent_GetCustomSpanDrawInfo (ArkUI_NodeCustomEvent * event, ArkUI_CustomSpanDrawInfo * info )
13748```
13749**Description**
13750
13751Obtains the drawing information of a custom span through a custom component event.
13752
13753**Since**: 12
13754
13755**Parameters**
13756
13757| Name| Description|
13758| -------- | -------- |
13759| event | Pointer to the custom component event. |
13760| info | Drawing information to obtain. |
13761
13762**Returns**
13763
13764Returns **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.
13765
13766
13767### OH_ArkUI_NodeCustomEvent_GetCustomSpanMeasureInfo()
13768
13769```
13770int32_t OH_ArkUI_NodeCustomEvent_GetCustomSpanMeasureInfo (ArkUI_NodeCustomEvent * event, ArkUI_CustomSpanMeasureInfo * info )
13771```
13772**Description**
13773
13774Obtains the measurement information of a custom span through a custom component event.
13775
13776**Since**: 12
13777
13778**Parameters**
13779
13780| Name| Description|
13781| -------- | -------- |
13782| event | Pointer to the custom component event. |
13783| info | Measurement information to obtain. |
13784
13785**Returns**
13786
13787Returns **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.
13788
13789
13790### OH_ArkUI_NodeCustomEvent_GetDrawContextInDraw()
13791
13792```
13793ArkUI_DrawContext* OH_ArkUI_NodeCustomEvent_GetDrawContextInDraw (ArkUI_NodeCustomEvent * event)
13794```
13795**Description**
13796
13797Obtains the drawing context through a custom component event.
13798
13799**Since**: 12
13800
13801**Parameters**
13802
13803| Name| Description|
13804| -------- | -------- |
13805| event | Pointer to the custom component event. |
13806
13807**Returns**
13808
13809Returns the drawing context.
13810
13811
13812### OH_ArkUI_NodeCustomEvent_GetEventTargetId()
13813
13814```
13815int32_t OH_ArkUI_NodeCustomEvent_GetEventTargetId (ArkUI_NodeCustomEvent * event)
13816```
13817**Description**
13818
13819Obtains the ID of a custom component event.
13820
13821**Since**: 12
13822
13823**Parameters**
13824
13825| Name| Description|
13826| -------- | -------- |
13827| event | Pointer to the custom component event. |
13828
13829**Returns**
13830
13831Returns the custom event ID.
13832
13833
13834### OH_ArkUI_NodeCustomEvent_GetEventType()
13835
13836```
13837ArkUI_NodeCustomEventType OH_ArkUI_NodeCustomEvent_GetEventType (ArkUI_NodeCustomEvent * event)
13838```
13839**Description**
13840
13841Obtains the event type through a custom component event.
13842
13843**Since**: 12
13844
13845**Parameters**
13846
13847| Name| Description|
13848| -------- | -------- |
13849| event | Pointer to the custom component event. |
13850
13851**Returns**
13852
13853Returns the type of the custom component event.
13854
13855
13856### OH_ArkUI_NodeCustomEvent_GetLayoutConstraintInMeasure()
13857
13858```
13859ArkUI_LayoutConstraint* OH_ArkUI_NodeCustomEvent_GetLayoutConstraintInMeasure (ArkUI_NodeCustomEvent * event)
13860```
13861**Description**
13862
13863Obtains the size constraint for measurement through a custom component event.
13864
13865**Since**: 12
13866
13867**Parameters**
13868
13869| Name| Description|
13870| -------- | -------- |
13871| event | Pointer to the custom component event. |
13872
13873**Returns**
13874
13875Pointer to the constraint size.
13876
13877
13878### OH_ArkUI_NodeCustomEvent_GetNodeHandle()
13879
13880```
13881ArkUI_NodeHandle OH_ArkUI_NodeCustomEvent_GetNodeHandle (ArkUI_NodeCustomEvent * event)
13882```
13883**Description**
13884
13885Obtains a component object through a custom component event.
13886
13887**Since**: 12
13888
13889**Parameters**
13890
13891| Name| Description|
13892| -------- | -------- |
13893| event | Pointer to the custom component event. |
13894
13895**Returns**
13896
13897Returns the obtained component object.
13898
13899
13900### OH_ArkUI_NodeCustomEvent_GetPositionInLayout()
13901
13902```
13903ArkUI_IntOffset OH_ArkUI_NodeCustomEvent_GetPositionInLayout (ArkUI_NodeCustomEvent * event)
13904```
13905**Description**
13906
13907Obtains the expected position of a component relative to its parent component in the layout phase through a custom component event.
13908
13909**Since**: 12
13910
13911**Parameters**
13912
13913| Name| Description|
13914| -------- | -------- |
13915| event | Pointer to the custom component event. |
13916
13917**Returns**
13918
13919Returns the expected position relative to the parent component.
13920
13921
13922### OH_ArkUI_NodeCustomEvent_GetUserData()
13923
13924```
13925void* OH_ArkUI_NodeCustomEvent_GetUserData (ArkUI_NodeCustomEvent * event)
13926```
13927**Description**
13928
13929Obtains custom event parameters through a custom component event.
13930
13931**Since**: 12
13932
13933**Parameters**
13934
13935| Name| Description|
13936| -------- | -------- |
13937| event | Pointer to the custom component event. |
13938
13939**Returns**
13940
13941Returns the custom event parameters.
13942
13943
13944### OH_ArkUI_NodeCustomEvent_SetCustomSpanMetrics()
13945
13946```
13947int32_t OH_ArkUI_NodeCustomEvent_SetCustomSpanMetrics (ArkUI_NodeCustomEvent * event, ArkUI_CustomSpanMetrics * metrics )
13948```
13949**Description**
13950
13951Sets the measurement metrics of a custom span through a custom component event.
13952
13953**Since**: 12
13954
13955**Parameters**
13956
13957| Name| Description|
13958| -------- | -------- |
13959| event | Pointer to the custom component event. |
13960| metrics | Measurement metrics to set. |
13961
13962**Returns**
13963
13964Returns **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.
13965
13966
13967### OH_ArkUI_NodeEvent_GetDragEvent()
13968
13969```
13970ArkUI_DragEvent* OH_ArkUI_NodeEvent_GetDragEvent (ArkUI_NodeEvent * nodeEvent)
13971```
13972**Description**
13973
13974Obtains an **ArkUI_DragEvent** object from the specified **ArkUI_DragEvent** object.
13975
13976**Since**: 12
13977
13978**Parameters**
13979
13980| Name| Description|
13981| -------- | -------- |
13982| node | Pointer to an **ArkUI_NodeEvent** object. |
13983
13984**Returns**
13985
13986Returns the pointer to an **ArkUI_DragEvent** object; returns null if the parameter passed in is invalid or is not a drag-related event.
13987
13988
13989### OH_ArkUI_NodeEvent_GetEventType()
13990
13991```
13992ArkUI_NodeEventType OH_ArkUI_NodeEvent_GetEventType (ArkUI_NodeEvent * event)
13993```
13994**Description**
13995
13996Obtains the type of a component event.
13997
13998**Since**: 12
13999
14000**Parameters**
14001
14002| Name| Description|
14003| -------- | -------- |
14004| event | Pointer to the component event. |
14005
14006**Returns**
14007
14008Returns the type of the component event.
14009
14010
14011### OH_ArkUI_NodeEvent_GetInputEvent()
14012
14013```
14014ArkUI_UIInputEvent* OH_ArkUI_NodeEvent_GetInputEvent (ArkUI_NodeEvent * event)
14015```
14016**Description**
14017
14018Obtains input event (for example, touch event) data for a component event.
14019
14020**Since**: 12
14021
14022**Parameters**
14023
14024| Name| Description|
14025| -------- | -------- |
14026| event | Pointer to the component event. |
14027
14028**Returns**
14029
14030Returns the pointer to the input event data.
14031
14032
14033### OH_ArkUI_NodeEvent_GetNodeComponentEvent()
14034
14035```
14036ArkUI_NodeComponentEvent* OH_ArkUI_NodeEvent_GetNodeComponentEvent (ArkUI_NodeEvent * event)
14037```
14038**Description**
14039
14040Obtains the numerical data in a component event.
14041
14042**Since**: 12
14043
14044**Parameters**
14045
14046| Name| Description|
14047| -------- | -------- |
14048| event | Pointer to the component event. |
14049
14050**Returns**
14051
14052Returns the pointer to the numerical data.
14053
14054
14055### OH_ArkUI_NodeEvent_GetNodeHandle()
14056
14057```
14058ArkUI_NodeHandle OH_ArkUI_NodeEvent_GetNodeHandle (ArkUI_NodeEvent * event)
14059```
14060**Description**
14061
14062Obtains the component object that triggers an event.
14063
14064**Since**: 12
14065
14066**Parameters**
14067
14068| Name| Description|
14069| -------- | -------- |
14070| event | Pointer to the component event. |
14071
14072**Returns**
14073
14074Component object that triggers the event.
14075
14076
14077### OH_ArkUI_NodeEvent_GetNumberValue()
14078
14079```
14080int32_t OH_ArkUI_NodeEvent_GetNumberValue (ArkUI_NodeEvent * event, int32_t index, ArkUI_NumberValue * value )
14081```
14082**Description**
14083
14084Obtains the numeric-type parameter of a component event.
14085
14086**Since**: 12
14087
14088**Parameters**
14089
14090| Name| Description|
14091| -------- | -------- |
14092| event | Pointer to the component event. |
14093| index | Return value index. |
14094| value | Return value. |
14095
14096**Returns**
14097
14098Returns **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.
14099
14100
14101### OH_ArkUI_NodeEvent_GetPreDragStatus()
14102
14103```
14104ArkUI_PreDragStatus OH_ArkUI_NodeEvent_GetPreDragStatus (ArkUI_NodeEvent * nodeEvent)
14105```
14106**Description**
14107
14108Obtains the state prior to a drop and drop operation.
14109
14110**Since**: 12
14111
14112**Parameters**
14113
14114| Name| Description|
14115| -------- | -------- |
14116| node | ArkUI_NodeEvent node object. |
14117
14118**Returns**
14119
14120Returns the state prior to the drop and drop operation.
14121
14122
14123### OH_ArkUI_NodeEvent_GetStringAsyncEvent()
14124
14125```
14126ArkUI_StringAsyncEvent* OH_ArkUI_NodeEvent_GetStringAsyncEvent (ArkUI_NodeEvent * event)
14127```
14128**Description**
14129
14130Obtains the string data in a component event.
14131
14132**Since**: 12
14133
14134**Parameters**
14135
14136| Name| Description|
14137| -------- | -------- |
14138| event | Pointer to the component event. |
14139
14140**Returns**
14141
14142ArkUI_StringAsyncEvent\Pointer to string data.
14143
14144
14145### OH_ArkUI_NodeEvent_GetStringValue()
14146
14147```
14148int32_t OH_ArkUI_NodeEvent_GetStringValue (ArkUI_NodeEvent * event, int32_t index, char ** string, int32_t * stringSize )
14149```
14150**Description**
14151
14152Obtains 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.
14153
14154**Since**: 12
14155
14156**Parameters**
14157
14158| Name| Description|
14159| -------- | -------- |
14160| event | Pointer to the component event. |
14161| index | Return value index. |
14162| string | Pointer to the string array. |
14163| stringSize | Length of the string array. |
14164
14165**Returns**
14166
14167Returns **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.
14168
14169
14170### OH_ArkUI_NodeEvent_GetTargetId()
14171
14172```
14173int32_t OH_ArkUI_NodeEvent_GetTargetId (ArkUI_NodeEvent * event)
14174```
14175**Description**
14176
14177Obtains the custom ID of a component event.
14178
14179The 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.
14180
14181**Since**: 12
14182
14183**Parameters**
14184
14185| Name| Description|
14186| -------- | -------- |
14187| event | Pointer to the component event. |
14188
14189**Returns**
14190
14191Returns the custom ID of the component event.
14192
14193
14194### OH_ArkUI_NodeEvent_GetUserData()
14195
14196```
14197void* OH_ArkUI_NodeEvent_GetUserData (ArkUI_NodeEvent * event)
14198```
14199**Description**
14200
14201Obtains the custom data in a component event.
14202
14203This parameter is passed in **registerNodeEvent** and can be applied to the service logic when the event is triggered.
14204
14205**Since**: 12
14206
14207**Parameters**
14208
14209| Name| Description|
14210| -------- | -------- |
14211| event | Pointer to the component event. |
14212
14213**Returns**
14214
14215Returns the pointer to user data.
14216
14217
14218### OH_ArkUI_NodeEvent_SetReturnNumberValue()
14219
14220```
14221int32_t OH_ArkUI_NodeEvent_SetReturnNumberValue (ArkUI_NodeEvent * event, ArkUI_NumberValue * value, int32_t size )
14222```
14223**Description**
14224
14225Sets the return value for a component event.
14226
14227**Since**: 12
14228
14229**Parameters**
14230
14231| Name| Description|
14232| -------- | -------- |
14233| event | Pointer to the component event. |
14234| value | Event numeric type array. |
14235| size | Size of the array. |
14236
14237**Returns**
14238
14239Returns **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.
14240
14241
14242### OH_ArkUI_NodeUtils_AddCustomProperty()
14243
14244```
14245void OH_ArkUI_NodeUtils_AddCustomProperty (ArkUI_NodeHandle node, const char * name, const char * value )
14246```
14247**Description**
14248
14249Sets a custom property for a component. This API takes effect only in the main thread.
14250
14251**Since**: 13
14252
14253**Parameters**
14254
14255| Name| Description|
14256| -------- | -------- |
14257| node | **ArkUI_NodeHandle** pointer. |
14258| name | Name of the custom property. A null pointer is not allowed. |
14259| value | Value of the custom property. A null pointer is not allowed. |
14260
14261
14262### OH_ArkUI_NodeUtils_GetActiveChildrenInfo()
14263
14264```
14265int32_t OH_ArkUI_NodeUtils_GetActiveChildrenInfo (ArkUI_NodeHandle head, ArkUI_ActiveChildrenInfo ** handle )
14266```
14267**Description**
14268
14269Obtains all active child nodes of the specified node. Spans are not counted as child nodes.
14270
14271**Since**: 14
14272
14273**Parameters**
14274
14275| Name| Description|
14276| -------- | -------- |
14277| head | Node for which to obtain the child nodes. |
14278| handle | Pointer to the struct containing information about the child nodes of the head node. |
14279
14280**Returns**
14281
14282Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
14283
14284
14285### OH_ArkUI_NodeUtils_GetCurrentPageRootNode()
14286
14287```
14288ArkUI_NodeHandle OH_ArkUI_NodeUtils_GetCurrentPageRootNode (ArkUI_NodeHandle node)
14289```
14290**Description**
14291
14292Obtains the root node of the current page.
14293
14294**Since**: 14
14295
14296**Parameters**
14297
14298| Name| Description|
14299| -------- | -------- |
14300| node | Target node. |
14301
14302**Returns**
14303
14304Returns the pointer to the root node if the node exists; returns **NULL** otherwise.
14305
14306
14307### OH_ArkUI_NodeUtils_GetCustomProperty()
14308
14309```
14310int32_t OH_ArkUI_NodeUtils_GetCustomProperty (ArkUI_NodeHandle node, const char * name, ArkUI_CustomProperty ** handle )
14311```
14312**Description**
14313
14314Obtains the value of a custom property of the specified component.
14315
14316**Since**: 14
14317
14318**Parameters**
14319
14320| Name| Description|
14321| -------- | -------- |
14322| node | **ArkUI_NodeHandle** pointer. |
14323| name | Name of the custom property. |
14324| handle | Pointer to the struct that receives the custom property corresponding to the key parameter name. |
14325
14326**Returns**
14327
14328Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
14329
14330
14331### OH_ArkUI_NodeUtils_GetLayoutPosition()
14332
14333```
14334int32_t OH_ArkUI_NodeUtils_GetLayoutPosition (ArkUI_NodeHandle node, ArkUI_IntOffset * localOffset )
14335```
14336**Description**
14337
14338Obtains 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.
14339
14340**Since**: 12
14341
14342**Parameters**
14343
14344| Name| Description|
14345| -------- | -------- |
14346| node | **ArkUI_NodeHandle** pointer. |
14347| localOffset | Offset of the component handle relative to the parent component, in pixels. |
14348
14349**Returns**
14350
14351Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
14352
14353
14354### OH_ArkUI_NodeUtils_GetLayoutPositionInScreen()
14355
14356```
14357int32_t OH_ArkUI_NodeUtils_GetLayoutPositionInScreen (ArkUI_NodeHandle node, ArkUI_IntOffset * screenOffset )
14358```
14359**Description**
14360
14361Obtains the position of the component's layout area relative to the screen. The relative position does not count in transformation attributes, such as translate.
14362
14363**Since**: 12
14364
14365**Parameters**
14366
14367| Name| Description|
14368| -------- | -------- |
14369| node | **ArkUI_NodeHandle** pointer. |
14370| screenOffset | Offset of the component handle relative to the screen, in pixels. |
14371
14372**Returns**
14373
14374Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
14375
14376
14377### OH_ArkUI_NodeUtils_GetLayoutPositionInWindow()
14378
14379```
14380int32_t OH_ArkUI_NodeUtils_GetLayoutPositionInWindow (ArkUI_NodeHandle node, ArkUI_IntOffset * globalOffset )
14381```
14382**Description**
14383
14384Obtains the position of the component's layout area relative to the window. The relative position does not count in transformation attributes, such as translate.
14385
14386**Since**: 12
14387
14388**Parameters**
14389
14390| Name| Description|
14391| -------- | -------- |
14392| node | **ArkUI_NodeHandle** pointer. |
14393| globalOffset | Offset of the component handle relative to the window, in pixels. |
14394
14395**Returns**
14396
14397Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
14398
14399
14400### OH_ArkUI_NodeUtils_GetLayoutSize()
14401
14402```
14403int32_t OH_ArkUI_NodeUtils_GetLayoutSize (ArkUI_NodeHandle node, ArkUI_IntSize * size )
14404```
14405**Description**
14406
14407Obtains the layout area size of a component. The size does not count in transformation attributes, such as scale.
14408
14409**Since**: 12
14410
14411**Parameters**
14412
14413| Name| Description|
14414| -------- | -------- |
14415| node | **ArkUI_NodeHandle** pointer. |
14416| size | Size of the layout area, in px. |
14417
14418**Returns**
14419
14420Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
14421
14422
14423### OH_ArkUI_NodeUtils_GetNodeType()
14424
14425```
14426int32_t OH_ArkUI_NodeUtils_GetNodeType (ArkUI_NodeHandle node)
14427```
14428**Description**
14429
14430Obtains the type of the specified node.
14431
14432**Since**: 14
14433
14434**Parameters**
14435
14436| Name| Description|
14437| -------- | -------- |
14438| node | Target node. |
14439
14440**Returns**
14441
14442Returns the type of the node. Returns **-1** if the type is not supported yet. For details about the available types, see [ArkUI_NodeType](#arkui_nodetype).
14443
14444
14445### OH_ArkUI_NodeUtils_GetParentInPageTree()
14446
14447```
14448ArkUI_NodeHandle OH_ArkUI_NodeUtils_GetParentInPageTree (ArkUI_NodeHandle node)
14449```
14450**Description**
14451
14452Obtains the parent node, which can be a component node created with ArkTS.
14453
14454**Since**: 14
14455
14456**Parameters**
14457
14458| Name| Description|
14459| -------- | -------- |
14460| node | Target node. |
14461
14462**Returns**
14463
14464Returns the pointer to the component if the component exists; returns **NULL** otherwise.
14465
14466
14467### OH_ArkUI_NodeUtils_GetPositionWithTranslateInScreen()
14468
14469```
14470int32_t OH_ArkUI_NodeUtils_GetPositionWithTranslateInScreen (ArkUI_NodeHandle node, ArkUI_IntOffset * translateOffset )
14471```
14472**Description**
14473
14474Obtains the position of a component on the screen, including the translate attribute.
14475
14476**Since**: 12
14477
14478**Parameters**
14479
14480| Name| Description|
14481| -------- | -------- |
14482| node | **ArkUI_NodeHandle** pointer. |
14483| translateOffset | Accumulated offset of the component, its parent component, and its ancestor node, in px. |
14484
14485**Returns**
14486
14487Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
14488
14489
14490### OH_ArkUI_NodeUtils_GetPositionWithTranslateInWindow()
14491
14492```
14493int32_t OH_ArkUI_NodeUtils_GetPositionWithTranslateInWindow (ArkUI_NodeHandle node, ArkUI_IntOffset * translateOffset )
14494```
14495**Description**
14496
14497Obtains the position of a component in the window, including the translate attribute.
14498
14499**Since**: 12
14500
14501**Parameters**
14502
14503| Name| Description|
14504| -------- | -------- |
14505| node | **ArkUI_NodeHandle** pointer. |
14506| translateOffset | Accumulated offset of the component, its parent component, and its ancestor node, in px. |
14507
14508**Returns**
14509
14510Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
14511
14512
14513### OH_ArkUI_NodeUtils_IsCreatedByNDK()
14514
14515```
14516bool OH_ArkUI_NodeUtils_IsCreatedByNDK (ArkUI_NodeHandle node)
14517```
14518**Description**
14519
14520Checks whether the specified component is created with the C API.
14521
14522**Since**: 14
14523
14524**Parameters**
14525
14526| Name| Description|
14527| -------- | -------- |
14528| node | Target node. |
14529
14530**Returns**
14531
14532Returns whether the node is created with the C API. The value **true** means that the node is created with the C API, and **false** means the opposite.
14533
14534
14535### OH_ArkUI_NodeUtils_RemoveCustomProperty()
14536
14537```
14538void OH_ArkUI_NodeUtils_RemoveCustomProperty (ArkUI_NodeHandle node, const char * name )
14539```
14540**Description**
14541
14542Removes a custom property that has been set for the specified component.
14543
14544**Since**: 13
14545
14546**Parameters**
14547
14548| Name| Description|
14549| -------- | -------- |
14550| node | **ArkUI_NodeHandle** pointer. |
14551| name | Name of the custom property. |
14552
14553
14554### OH_ArkUI_PanGesture_GetOffsetX()
14555
14556```
14557float OH_ArkUI_PanGesture_GetOffsetX (const ArkUI_GestureEvent * event)
14558```
14559**Description**
14560
14561Obtains the relative offset of a pan gesture along the x-axis.
14562
14563**Since**: 12
14564
14565**Parameters**
14566
14567| Name| Description|
14568| -------- | -------- |
14569| event | Gesture event. |
14570
14571**Returns**
14572
14573Returns the relative offset of the gesture along the x-axis, in px.
14574
14575
14576### OH_ArkUI_PanGesture_GetOffsetY()
14577
14578```
14579float OH_ArkUI_PanGesture_GetOffsetY (const ArkUI_GestureEvent * event)
14580```
14581**Description**
14582
14583Obtains the relative offset of a pan gesture along the y-axis.
14584
14585**Since**: 12
14586
14587**Parameters**
14588
14589| Name| Description|
14590| -------- | -------- |
14591| event | Gesture event. |
14592
14593**Returns**
14594
14595Returns the relative offset of the gesture along the y-axis, in px.
14596
14597
14598### OH_ArkUI_PanGesture_GetVelocity()
14599
14600```
14601float OH_ArkUI_PanGesture_GetVelocity (const ArkUI_GestureEvent * event)
14602```
14603**Description**
14604
14605Obtains the velocity of a pan gesture along the main axis.
14606
14607**Since**: 12
14608
14609**Parameters**
14610
14611| Name| Description|
14612| -------- | -------- |
14613| event | Gesture event. |
14614
14615**Returns**
14616
14617Returns 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.
14618
14619
14620### OH_ArkUI_PanGesture_GetVelocityX()
14621
14622```
14623float OH_ArkUI_PanGesture_GetVelocityX (const ArkUI_GestureEvent * event)
14624```
14625**Description**
14626
14627Obtains the velocity of a pan gesture along the x-axis.
14628
14629**Since**: 12
14630
14631**Parameters**
14632
14633| Name| Description|
14634| -------- | -------- |
14635| event | Gesture event. |
14636
14637**Returns**
14638
14639Returns the velocity of the pan gesture along the x-axis, in px/s.
14640
14641
14642### OH_ArkUI_PanGesture_GetVelocityY()
14643
14644```
14645float OH_ArkUI_PanGesture_GetVelocityY (const ArkUI_GestureEvent * event)
14646```
14647**Description**
14648
14649Obtains the velocity of a pan gesture along the y-axis.
14650
14651**Since**: 12
14652
14653**Parameters**
14654
14655| Name| Description|
14656| -------- | -------- |
14657| event | Gesture event. |
14658
14659**Returns**
14660
14661Returns the velocity of the pan gesture along the y-axis, in px/s.
14662
14663
14664### OH_ArkUI_ParallelInnerGestureEvent_GetConflictRecognizers()
14665
14666```
14667int32_t OH_ArkUI_ParallelInnerGestureEvent_GetConflictRecognizers (ArkUI_ParallelInnerGestureEvent * event, ArkUI_GestureRecognizerHandleArray * array, int32_t * size )
14668```
14669**Description**
14670
14671Obtains the conflicting gesture recognizers in a parallel internal gesture event.
14672
14673**Since**: 12
14674
14675**Parameters**
14676
14677| Name| Description|
14678| -------- | -------- |
14679| event | Parallel internal gesture event. |
14680| array | Array of conflicting gesture recognizers. |
14681| size | Size of the conflicting gesture recognizer array. |
14682
14683**Returns**
14684
14685Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
14686
14687
14688### OH_ArkUI_ParallelInnerGestureEvent_GetCurrentRecognizer()
14689
14690```
14691ArkUI_GestureRecognizer* OH_ArkUI_ParallelInnerGestureEvent_GetCurrentRecognizer (ArkUI_ParallelInnerGestureEvent * event)
14692```
14693**Description**
14694
14695Obtains the current gesture recognizer in a parallel internal gesture event.
14696
14697**Since**: 12
14698
14699**Parameters**
14700
14701| Name| Description|
14702| -------- | -------- |
14703| event | Parallel internal gesture event. |
14704
14705**Returns**
14706
14707Returns the pointer to the current gesture recognizer.
14708
14709### OH_ArkUI_ParallelInnerGestureEvent_GetUserData()
14710
14711```
14712void* OH_ArkUI_ParallelInnerGestureEvent_GetUserData (ArkUI_ParallelInnerGestureEvent * event)
14713```
14714**Description**
14715
14716Obtains custom data in the parallel internal gesture event.
14717
14718**Since**: 12
14719
14720**Parameters**
14721
14722| Name| Description|
14723| -------- | -------- |
14724| event | Parallel internal gesture event. |
14725
14726**Returns**
14727
14728Returns the pointer to custom data.
14729
14730### OH_ArkUI_GestureInterrupter_GetUserData
14731
14732```
14733void* OH_ArkUI_GestureInterrupter_GetUserData(ArkUI_GestureInterruptInfo* event)
14734```
14735
14736**Description**
14737
14738Obtains the custom data from a gesture interruption event.
14739
14740**Since**: 18
14741
14742**Parameters**
14743
14744| Name | Description                      |
14745| ----- | -------------------------- |
14746| event | Pointer to the gesture interruption information.|
14747
14748**Returns**
14749
14750Returns the pointer to the custom data.
14751
14752
14753### OH_ArkUI_PinchGesture_GetCenterX()
14754
14755```
14756float OH_ArkUI_PinchGesture_GetCenterX (const ArkUI_GestureEvent * event)
14757```
14758**Description**
14759
14760Obtains the X coordinate of the center of the pinch gesture, in vp, relative to the upper left corner of the current component.
14761
14762**Since**: 12
14763
14764**Parameters**
14765
14766| Name| Description|
14767| -------- | -------- |
14768| event | Gesture event. |
14769
14770**Returns**
14771
14772Returns the X coordinate of the center of the pinch gesture, in vp, relative to the upper left corner of the current component.
14773
14774
14775### OH_ArkUI_PinchGesture_GetCenterY()
14776
14777```
14778float OH_ArkUI_PinchGesture_GetCenterY (const ArkUI_GestureEvent * event)
14779```
14780**Description**
14781
14782Obtains the Y coordinate of the center of the pinch gesture, in vp, relative to the upper left corner of the current component.
14783
14784**Since**: 12
14785
14786**Parameters**
14787
14788| Name| Description|
14789| -------- | -------- |
14790| event | Gesture event. |
14791
14792**Returns**
14793
14794Returns the Y coordinate of the center of the pinch gesture, in vp, relative to the upper left corner of the current component.
14795
14796
14797### OH_ArkUI_PinchGesture_GetScale()
14798
14799```
14800float OH_ArkUI_PinchGesture_GetScale (const ArkUI_GestureEvent * event)
14801```
14802**Description**
14803
14804Obtains the scale ratio of a pinch gesture.
14805
14806**Since**: 12
14807
14808**Parameters**
14809
14810| Name| Description|
14811| -------- | -------- |
14812| event | Gesture event. |
14813
14814**Returns**
14815
14816Scale.
14817
14818
14819### OH_ArkUI_QueryModuleInterfaceByName()
14820
14821```
14822void* OH_ArkUI_QueryModuleInterfaceByName (ArkUI_NativeAPIVariantKind type, const char * structName )
14823```
14824**Description**
14825
14826Obtains the native API set of a specified type.
14827
14828**Since**: 12
14829
14830**Parameters**
14831
14832| Name| Description|
14833| -------- | -------- |
14834| type | Type of the native API set provided by ArkUI, for example, **ARKUI_NATIVE_NODE** or **ARKUI_NATIVE_GESTURE**. |
14835| sturctName | Name of a native struct defined in the corresponding header file, for example, **ArkUI_NativeNodeAPI_1** in &lt;arkui/native_node.h&gt. |
14836
14837**Returns**
14838
14839Returns 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); }
14840
14841
14842### OH_ArkUI_RegisterSystemColorModeChangeEvent()
14843
14844```
14845int32_t OH_ArkUI_RegisterSystemColorModeChangeEvent (ArkUI_NodeHandle node, void * userData, void(*)(ArkUI_SystemColorMode colorMode, void *userData) onColorModeChange )
14846```
14847**Description**
14848
14849Registers an event listener for system color mode changes. A single component can only register one callback for system color mode changes.
14850
14851**Since**: 12
14852
14853**Parameters**
14854
14855| Name| Description|
14856| -------- | -------- |
14857| node | Specified node. |
14858| userData | Custom event parameter, which is passed in the callback when the event is triggered. |
14859| onColorModeChange | Callback to be executed when the event is triggered. |
14860
14861**Returns**
14862
14863Returns **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.
14864
14865
14866### OH_ArkUI_RegisterSystemFontStyleChangeEvent()
14867
14868```
14869int32_t OH_ArkUI_RegisterSystemFontStyleChangeEvent (ArkUI_NodeHandle node, void * userData, void(*)(ArkUI_SystemFontStyleEvent *event, void *userData) onFontStyleChange )
14870```
14871**Description**
14872
14873Registers an event listener for system font style changes. A single component can only register one callback for system font style changes.
14874
14875**Since**: 12
14876
14877**Parameters**
14878
14879| Name| Description|
14880| -------- | -------- |
14881| node | Specified node. |
14882| userData | Custom event parameter, which is passed in the callback when the event is triggered. |
14883| onFontStyleChange | Callback to be executed when the event is triggered. |
14884
14885**Returns**
14886
14887Returns **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.
14888
14889
14890### OH_ArkUI_RotationGesture_GetAngle()
14891
14892```
14893float OH_ArkUI_RotationGesture_GetAngle (const ArkUI_GestureEvent * event)
14894```
14895**Description**
14896
14897Obtains the angle information of a rotation gesture.
14898
14899**Since**: 12
14900
14901**Parameters**
14902
14903| Name| Description|
14904| -------- | -------- |
14905| event | Gesture event. |
14906
14907**Returns**
14908
14909Rotation angle.
14910
14911
14912### OH_ArkUI_SetArkUIGestureRecognizerDisposeNotify()
14913
14914```
14915int32_t OH_ArkUI_SetArkUIGestureRecognizerDisposeNotify (ArkUI_GestureRecognizer * recognizer, ArkUI_GestureRecognizerDestructNotifyCallback callback, void * userData )
14916```
14917**Description**
14918
14919Sets a callback function for notifying gesture recognizer destruction.
14920
14921**Parameters**
14922
14923| Name| Description|
14924| -------- | -------- |
14925| recognizer | Pointer to the gesture recognizer. |
14926| callback | Callback function for notifying gesture recognizer destruction. |
14927| userData | Custom data. |
14928
14929**Returns**
14930
14931Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
14932
14933
14934### OH_ArkUI_SetDragEventStrictReportWithContext()
14935
14936```
14937int32_t OH_ArkUI_SetDragEventStrictReportWithContext (ArkUI_ContextHandle uiContext, bool enabled )
14938```
14939**Description**
14940
14941Sets 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.
14942
14943**Since**: 12
14944
14945**Parameters**
14946
14947| Name| Description|
14948| -------- | -------- |
14949| uiContext | Pointer to the UI instance. |
14950| enabled | Whether to enable strict reporting on drag events. |
14951
14952**Returns**
14953
14954Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
14955
14956
14957### OH_ArkUI_SetDragEventStrictReportWithNode()
14958
14959```
14960int32_t OH_ArkUI_SetDragEventStrictReportWithNode (ArkUI_NodeHandle node, bool enabled )
14961```
14962**Description**
14963
14964Sets 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.
14965
14966**Since**: 12
14967
14968**Parameters**
14969
14970| Name| Description|
14971| -------- | -------- |
14972| node | Pointer to a component node. |
14973| enabled | Whether to enable strict reporting on drag events. |
14974
14975**Returns**
14976
14977Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
14978
14979
14980### OH_ArkUI_SetGestureRecognizerEnabled()
14981
14982```
14983int32_t OH_ArkUI_SetGestureRecognizerEnabled (ArkUI_GestureRecognizer * recognizer, bool enabled )
14984```
14985**Description**
14986
14987Sets the enabled state of a gesture recognizer.
14988
14989**Since**: 12
14990
14991**Parameters**
14992
14993| Name| Description|
14994| -------- | -------- |
14995| recognizer | Pointer to the gesture recognizer. |
14996| enabled | Whether to enable notification. |
14997
14998**Returns**
14999
15000Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
15001
15002### OH_ArkUI_SetGestureRecognizerLimitFingerCount
15003
15004```
15005int32_t OH_ArkUI_SetGestureRecognizerLimitFingerCount (ArkUI_GestureRecognizer * recognizer, bool limitFingerCount )
15006```
15007**Description**
15008
15009Sets whether to enforce the exact number of fingers touching the screen.
15010
15011**Parameters**
15012
15013| Name| Description|
15014| -------- | -------- |
15015| recognizer | Pointer to the gesture recognizer. |
15016| limitFingerCount | Whether to enforce the exact number of fingers touching the screen. |
15017
15018**Returns**
15019
15020Returns **0** if the operation is successful. Returns **401** if a parameter error occurs.
15021
15022
15023
15024
15025### OH_ArkUI_SetNodeAllowedDropDataTypes()
15026
15027```
15028int32_t OH_ArkUI_SetNodeAllowedDropDataTypes (ArkUI_NodeHandle node, const char * typesArray[], int32_t count )
15029```
15030**Description**
15031
15032Sets 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).
15033
15034**Since**: 12
15035
15036**Parameters**
15037
15038| Name| Description|
15039| -------- | -------- |
15040| node | Pointer to a component node. |
15041| typesArray | Array of data types that can fall into. |
15042| count | Length of an array. |
15043
15044**Returns**
15045
15046Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
15047
15048
15049### OH_ArkUI_SetNodeDraggable()
15050
15051```
15052int32_t OH_ArkUI_SetNodeDraggable (ArkUI_NodeHandle node, bool enabled )
15053```
15054**Description**
15055
15056Sets whether the component is draggable.
15057
15058**Since**: 12
15059
15060**Parameters**
15061
15062| Name| Description|
15063| -------- | -------- |
15064| node | Pointer to a component node. |
15065| bool | Whether the component is draggable. |
15066
15067**Returns**
15068
15069Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
15070
15071
15072### OH_ArkUI_SetNodeDragPreview()
15073
15074```
15075int32_t OH_ArkUI_SetNodeDragPreview (ArkUI_NodeHandle node, OH_PixelmapNative * preview )
15076```
15077**Description**
15078
15079Sets a custom drag preview for the specified component.
15080
15081**Since**: 12
15082
15083**Parameters**
15084
15085| Name| Description|
15086| -------- | -------- |
15087| node | Pointer to the target component node. |
15088| preview | Custom drag preview, which is a pixel map. |
15089
15090**Returns**
15091
15092Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
15093
15094
15095### OH_ArkUI_SetNodeDragPreviewOption()
15096
15097```
15098int32_t OH_ArkUI_SetNodeDragPreviewOption (ArkUI_NodeHandle node, ArkUI_DragPreviewOption * option )
15099```
15100**Description**
15101
15102Sets an **ArkUI_DragPreviewOption** object for the specified component.
15103
15104**Since**: 12
15105
15106**Parameters**
15107
15108| Name| Description|
15109| -------- | -------- |
15110| node | Pointer to a component node. |
15111| option | Custom parameters. |
15112
15113**Returns**
15114
15115Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
15116
15117
15118### OH_ArkUI_StartDrag()
15119
15120```
15121int32_t OH_ArkUI_StartDrag (ArkUI_DragAction * dragAction)
15122```
15123**Description**
15124
15125Initiates a drag action through the specified drag action object.
15126
15127**Since**: 12
15128
15129**Parameters**
15130
15131| Name| Description|
15132| -------- | -------- |
15133| dragAction | Drag action object. |
15134
15135**Returns**
15136
15137Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
15138
15139
15140### OH_ArkUI_StyledString_AddPlaceholder()
15141
15142```
15143void OH_ArkUI_StyledString_AddPlaceholder (ArkUI_StyledString * handle, OH_Drawing_PlaceholderSpan * placeholder )
15144```
15145**Description**
15146
15147Adds a placeholder.
15148
15149**Since**: 12
15150
15151**Parameters**
15152
15153| Name| Description|
15154| -------- | -------- |
15155| handle | Pointer to an **ArkUI_StyledString** object. |
15156| placeholder | Pointer to an **OH_Drawing_PlaceholderSpan** object. |
15157
15158
15159### OH_ArkUI_StyledString_AddText()
15160
15161```
15162void OH_ArkUI_StyledString_AddText (ArkUI_StyledString * handle, const char * content )
15163```
15164**Description**
15165
15166Sets the text content based on the current format string style.
15167
15168**Since**: 12
15169
15170**Parameters**
15171
15172| Name| Description|
15173| -------- | -------- |
15174| handle | Pointer to an **ArkUI_StyledString** object. |
15175| content | Pointer to the text content. |
15176
15177
15178### OH_ArkUI_StyledString_Create()
15179
15180```
15181ArkUI_StyledString* OH_ArkUI_StyledString_Create (OH_Drawing_TypographyStyle * style, OH_Drawing_FontCollection * collection )
15182```
15183**Description**
15184
15185Creates an **ArkUI_StyledString** object.
15186
15187**Since**: 12
15188
15189**Parameters**
15190
15191| Name| Description|
15192| -------- | -------- |
15193| style | Pointer to an **OH_Drawing_TypographyStyle** object, which is obtained by calling **OH_Drawing_CreateTypographyStyle**. |
15194| collection | Pointer to an **OH_Drawing_FontCollection** object, which is obtained by calling **OH_Drawing_CreateFontCollection**. |
15195
15196**Returns**
15197
15198Returns 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.
15199
15200
15201### OH_ArkUI_StyledString_CreateTypography()
15202
15203```
15204OH_Drawing_Typography* OH_ArkUI_StyledString_CreateTypography (ArkUI_StyledString * handle)
15205```
15206**Description**
15207
15208Creates an **OH_Drawing_Typography** object based on an **ArkUI_StyledString** object.
15209
15210**Since**: 12
15211
15212**Parameters**
15213
15214| Name| Description|
15215| -------- | -------- |
15216| handle | Pointer to an **ArkUI_StyledString** object. |
15217
15218**Returns**
15219
15220Returns 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.
15221
15222
15223### OH_ArkUI_StyledString_Descriptor_Create()
15224
15225```
15226ArkUI_StyledString_Descriptor* OH_ArkUI_StyledString_Descriptor_Create (void )
15227```
15228**Description**
15229
15230Creates an **ArkUI_StyledString_Descriptor** object.
15231
15232**Since**: 14
15233
15234**Returns**
15235
15236Pointer to an **ArkUI_StyledString_Descriptor** object.
15237
15238
15239### OH_ArkUI_StyledString_Descriptor_Destroy()
15240
15241```
15242void OH_ArkUI_StyledString_Descriptor_Destroy (ArkUI_StyledString_Descriptor * descriptor)
15243```
15244**Description**
15245
15246Destroys an **ArkUI_StyledString_Descriptor** object and reclaims the memory occupied by the object.
15247
15248**Since**: 14
15249
15250**Parameters**
15251
15252| Name| Description|
15253| -------- | -------- |
15254| descriptor | Pointer to an **ArkUI_StyledString_Descriptor** object. |
15255
15256
15257### OH_ArkUI_StyledString_Destroy()
15258
15259```
15260void OH_ArkUI_StyledString_Destroy (ArkUI_StyledString * handle)
15261```
15262**Description**
15263
15264Destroys an **OH_Drawing_TextStyle** object and reclaims the memory occupied by the object.
15265
15266**Since**: 12
15267
15268**Parameters**
15269
15270| Name| Description|
15271| -------- | -------- |
15272| handle | Pointer to an **ArkUI_StyledString** object. |
15273
15274
15275### OH_ArkUI_StyledString_PopTextStyle()
15276
15277```
15278void OH_ArkUI_StyledString_PopTextStyle (ArkUI_StyledString * handle)
15279```
15280**Description**
15281
15282Removes the top style from the current formatted string object.
15283
15284**Since**: 12
15285
15286**Parameters**
15287
15288| Name| Description|
15289| -------- | -------- |
15290| handle | Pointer to an **ArkUI_StyledString** object. |
15291
15292
15293### OH_ArkUI_StyledString_PushTextStyle()
15294
15295```
15296void OH_ArkUI_StyledString_PushTextStyle (ArkUI_StyledString * handle, OH_Drawing_TextStyle * style )
15297```
15298**Description**
15299
15300Sets the new typesetting style to the top of the current format string style stack.
15301
15302**Since**: 12
15303
15304**Parameters**
15305
15306| Name| Description|
15307| -------- | -------- |
15308| handle | Pointer to an **ArkUI_StyledString** object. |
15309| style | Pointer to an **OH_Drawing_TextStyle** object. |
15310
15311
15312### OH_ArkUI_SwipeGesture_GetAngle()
15313
15314```
15315float OH_ArkUI_SwipeGesture_GetAngle (const ArkUI_GestureEvent * event)
15316```
15317**Description**
15318
15319Obtains the angle information of the swipe gesture.
15320
15321**Since**: 12
15322
15323**Parameters**
15324
15325| Name| Description|
15326| -------- | -------- |
15327| event | Gesture event. |
15328
15329**Returns**
15330
15331Returns the angle of the swipe gesture, which is the result obtained based on the aforementioned formula.
15332
15333
15334### OH_ArkUI_SwipeGesture_GetVelocity()
15335
15336```
15337float OH_ArkUI_SwipeGesture_GetVelocity (const ArkUI_GestureEvent * event)
15338```
15339**Description**
15340
15341Obtains the average velocity of all fingers used in the swipe gesture.
15342
15343**Since**: 12
15344
15345**Parameters**
15346
15347| Name| Description|
15348| -------- | -------- |
15349| event | Gesture event. |
15350
15351**Returns**
15352
15353Returns the average velocity of all fingers used in the swipe gesture, in px/s.
15354
15355
15356### OH_ArkUI_SwiperIndicator_Create()
15357
15358```
15359ArkUI_SwiperIndicator* OH_ArkUI_SwiperIndicator_Create (ArkUI_SwiperIndicatorType type)
15360```
15361**Description**
15362
15363Creates a navigation indicator for the Swiper component.
15364
15365**Since**: 12
15366
15367**Parameters**
15368
15369| Name| Description|
15370| -------- | -------- |
15371| type | Type of the navigation indicator. |
15372
15373**Returns**
15374
15375Returns the pointer to the navigation indicator.
15376
15377
15378### OH_ArkUI_SwiperIndicator_Dispose()
15379
15380```
15381void OH_ArkUI_SwiperIndicator_Dispose (ArkUI_SwiperIndicator * indicator)
15382```
15383**Description**
15384
15385Disposes of the navigation indicator of this **Swiper** component.
15386
15387**Since**: 12
15388
15389**Parameters**
15390
15391| Name| Description|
15392| -------- | -------- |
15393| indicator | Returns the pointer to the navigation indicator. |
15394
15395
15396### OH_ArkUI_SwiperIndicator_GetBottomPosition()
15397
15398```
15399float OH_ArkUI_SwiperIndicator_GetBottomPosition (ArkUI_SwiperIndicator * indicator)
15400```
15401**Description**
15402
15403Obtains the distance between the navigation indicator and the bottom edge of the **Swiper** component.
15404
15405**Since**: 12
15406
15407**Parameters**
15408
15409| Name| Description|
15410| -------- | -------- |
15411| indicator | Returns the pointer to the navigation indicator. |
15412
15413**Returns**
15414
15415Returns the distance between a navigation indicator and the bottom edge of the **Swiper** component.
15416
15417
15418### OH_ArkUI_SwiperIndicator_GetColor()
15419
15420```
15421uint32_t OH_ArkUI_SwiperIndicator_GetColor (ArkUI_SwiperIndicator * indicator)
15422```
15423**Description**
15424
15425Obtains the color of a dot-style navigation indicator of the **Swiper** component.
15426
15427**Since**: 12
15428
15429**Parameters**
15430
15431| Name| Description|
15432| -------- | -------- |
15433| indicator | Returns the pointer to the navigation indicator. |
15434
15435**Returns**
15436
15437Returns the color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
15438
15439
15440### OH_ArkUI_SwiperIndicator_GetEndPosition()
15441
15442```
15443float OH_ArkUI_SwiperIndicator_GetEndPosition (ArkUI_SwiperIndicator * indicator)
15444```
15445**Description**
15446
15447Obtains the distance between a navigation indicator and the right edge of the **Swiper** component.
15448
15449**Since**: 12
15450
15451**Parameters**
15452
15453| Name| Description|
15454| -------- | -------- |
15455| indicator | Returns the pointer to the navigation indicator. |
15456
15457**Returns**
15458
15459Returns the distance between the navigation indicator and the right edge of the **Swiper** component.
15460
15461
15462### OH_ArkUI_SwiperIndicator_GetItemHeight()
15463
15464```
15465float OH_ArkUI_SwiperIndicator_GetItemHeight (ArkUI_SwiperIndicator * indicator)
15466```
15467**Description**
15468
15469Obtains the height of a dot-style navigation indicator of the **Swiper** component.
15470
15471**Since**: 12
15472
15473**Parameters**
15474
15475| Name| Description|
15476| -------- | -------- |
15477| indicator | Returns the pointer to the navigation indicator. |
15478
15479**Returns**
15480
15481Returns the height of the dot-style navigation indicator.
15482
15483
15484### OH_ArkUI_SwiperIndicator_GetItemWidth()
15485
15486```
15487float OH_ArkUI_SwiperIndicator_GetItemWidth (ArkUI_SwiperIndicator * indicator)
15488```
15489**Description**
15490
15491Obtains the width of a dot-style navigation indicator of the **Swiper** component.
15492
15493**Since**: 12
15494
15495**Parameters**
15496
15497| Name| Description|
15498| -------- | -------- |
15499| indicator | Returns the pointer to the navigation indicator. |
15500
15501**Returns**
15502
15503Returns the width of the dot-style navigation indicator.
15504
15505
15506### OH_ArkUI_SwiperIndicator_GetMask()
15507
15508```
15509int32_t OH_ArkUI_SwiperIndicator_GetMask (ArkUI_SwiperIndicator * indicator)
15510```
15511**Description**
15512
15513Obtains whether the mask is enabled for a dot-style navigation indicator of the **Swiper** component.
15514
15515**Since**: 12
15516
15517**Parameters**
15518
15519| Name| Description|
15520| -------- | -------- |
15521| indicator | Returns the pointer to the navigation indicator. |
15522
15523**Returns**
15524
15525Returns **1** if the mask is enabled; returns **0** otherwise.
15526
15527
15528### OH_ArkUI_SwiperIndicator_GetMaxDisplayCount()
15529
15530```
15531int32_t OH_ArkUI_SwiperIndicator_GetMaxDisplayCount (ArkUI_SwiperIndicator * indicator)
15532```
15533**Description**
15534
15535Obtains the maximum number of dots for the dot-style navigation indicator.
15536
15537**Since**: 12
15538
15539**Parameters**
15540
15541| Name| Description|
15542| -------- | -------- |
15543| indicator | Returns the pointer to the navigation indicator. |
15544
15545**Returns**
15546
15547Returns the maximum number of dots. The value ranges from 6 to 9.
15548
15549
15550### OH_ArkUI_SwiperDigitIndicator_Create()
15551
15552```
15553ArkUI_SwiperDigitIndicator *OH_ArkUI_SwiperDigitIndicator_Create()
15554```
15555**Description**
15556
15557Creates a digit-style navigation indicator for this **Swiper** component.
15558
15559**Since**: 18
15560
15561**Returns**
15562
15563Returns the pointer to the digit-style navigation indicator.
15564
15565### OH_ArkUI_SwiperDigitIndicator_SetStartPosition()
15566
15567```
15568void OH_ArkUI_SwiperDigitIndicator_SetStartPosition(ArkUI_SwiperDigitIndicator* indicator, float value)
15569```
15570**Description**
15571
15572Sets the start position of the digit-style navigation indicator for the **Swiper** component. This determines the distance from the left edge of the **Swiper** component. For right-to-left scripts, this determines the distance from the right edge.
15573
15574**Since**: 18
15575
15576**Parameters**
15577
15578| Name| Description|
15579| -------- | -------- |
15580| indicator | Pointer to a digit-style navigation indicator. |
15581| value | Distance from the left edge of the **Swiper** component. For right-to-left scripts, this indicates the distance from the right edge. |
15582
15583### OH_ArkUI_SwiperDigitIndicator_GetStartPosition()
15584
15585```
15586float OH_ArkUI_SwiperDigitIndicator_GetStartPosition(ArkUI_SwiperDigitIndicator* indicator)
15587```
15588**Description**
15589
15590Obtains the start position of the digit-style navigation indicator for the **Swiper** component. This indicates the distance from the left edge of the **Swiper** component. For right-to-left scripts, this indicates the distance from the right edge.
15591
15592**Since**: 18
15593
15594**Parameters**
15595
15596| Name| Description|
15597| -------- | -------- |
15598| indicator | Pointer to a digit-style navigation indicator.|
15599
15600**Returns**
15601
15602Returns the distance from the left edge of the **Swiper** component. For right-to-left scripts, this indicates the distance from the right edge.
15603
15604### OH_ArkUI_SwiperDigitIndicator_SetTopPosition()
15605
15606```
15607void OH_ArkUI_SwiperDigitIndicator_SetTopPosition(ArkUI_SwiperDigitIndicator* indicator, float value)
15608```
15609**Description**
15610
15611Sets the distance from the digit-style navigation indicator to the top of the **Swiper** component.
15612
15613**Since**: 18
15614
15615**Parameters**
15616
15617| Name| Description|
15618| -------- | -------- |
15619| indicator | Pointer to a digit-style navigation indicator. |
15620| value | Distance from the digit-style navigation indicator to the top of the **Swiper** component. |
15621
15622### OH_ArkUI_SwiperDigitIndicator_GetTopPosition()
15623
15624```
15625float OH_ArkUI_SwiperDigitIndicator_GetTopPosition(ArkUI_SwiperDigitIndicator* indicator)
15626```
15627**Description**
15628
15629Obtains the distance from the digit-style navigation indicator to the top of the **Swiper** component.
15630
15631**Since**: 18
15632
15633**Parameters**
15634
15635| Name| Description|
15636| -------- | -------- |
15637| indicator | Pointer to a digit-style navigation indicator.|
15638
15639**Returns**
15640
15641Returns the distance from the digit-style navigation indicator to the top of the **Swiper** component.
15642
15643### OH_ArkUI_SwiperDigitIndicator_SetEndPosition()
15644
15645```
15646void OH_ArkUI_SwiperDigitIndicator_SetEndPosition(ArkUI_SwiperDigitIndicator* indicator, float value)
15647```
15648**Description**
15649
15650Sets the end position of the digit-style navigation indicator for the **Swiper** component. This determines the distance from the right edge of the **Swiper** component. For right-to-left scripts, this determines the distance from the left edge.
15651
15652**Since**: 18
15653
15654**Parameters**
15655
15656| Name| Description|
15657| -------- | -------- |
15658| indicator | Pointer to a digit-style navigation indicator. |
15659| value | Distance from the right edge of the **Swiper** component. For right-to-left scripts, this indicates the distance from the left edge. |
15660
15661### OH_ArkUI_SwiperDigitIndicator_GetEndPosition()
15662
15663```
15664float OH_ArkUI_SwiperDigitIndicator_GetEndPosition(ArkUI_SwiperDigitIndicator* indicator)
15665```
15666**Description**
15667
15668Obtains the end position of the digit-style navigation indicator for the **Swiper** component. This indicates the distance from the right edge of the **Swiper** component. For right-to-left scripts, this indicates the distance from the left edge.
15669
15670**Since**: 18
15671
15672**Parameters**
15673
15674| Name| Description|
15675| -------- | -------- |
15676| indicator | Pointer to a digit-style navigation indicator.|
15677
15678**Returns**
15679
15680Returns the distance from the right edge of the **Swiper** component. For right-to-left scripts, this indicates the distance from the left edge.
15681
15682### OH_ArkUI_SwiperDigitIndicator_SetBottomPosition()
15683
15684```
15685void OH_ArkUI_SwiperDigitIndicator_SetBottomPosition(ArkUI_SwiperDigitIndicator* indicator, float value)
15686```
15687**Description**
15688
15689Sets the distance from the digit-style navigation indicator to the bottom of the **Swiper** component.
15690
15691**Since**: 18
15692
15693**Parameters**
15694
15695| Name| Description|
15696| -------- | -------- |
15697| indicator | Pointer to a digit-style navigation indicator. |
15698| value | Distance from the digit-style navigation indicator to the bottom of the **Swiper** component. |
15699
15700### OH_ArkUI_SwiperDigitIndicator_GetBottomPosition()
15701
15702```
15703float OH_ArkUI_SwiperDigitIndicator_GetBottomPosition(ArkUI_SwiperDigitIndicator* indicator)
15704```
15705**Description**
15706
15707Obtains the distance from the digit-style navigation indicator to the bottom of the **Swiper** component.
15708
15709**Since**: 18
15710
15711**Parameters**
15712
15713| Name| Description|
15714| -------- | -------- |
15715| indicator | Pointer to a digit-style navigation indicator.|
15716
15717**Returns**
15718
15719Returns the distance from the digit-style navigation indicator to the bottom of the **Swiper** component.
15720
15721### OH_ArkUI_SwiperDigitIndicator_SetFontColor()
15722
15723```
15724void OH_ArkUI_SwiperDigitIndicator_SetFontColor(ArkUI_SwiperDigitIndicator* indicator, uint32_t color)
15725```
15726**Description**
15727
15728Sets the font color of the digit-style navigation indicator for the **Swiper** component.
15729
15730**Since**: 18
15731
15732**Parameters**
15733
15734| Name| Description|
15735| -------- | -------- |
15736| indicator | Pointer to a digit-style navigation indicator. |
15737| color | Color, in 0xARGB format. For example, 0xFFFF0000 indicates red. |
15738
15739### OH_ArkUI_SwiperDigitIndicator_GetFontColor()
15740
15741```
15742uint32_t OH_ArkUI_SwiperDigitIndicator_GetFontColor(ArkUI_SwiperDigitIndicator* indicator)
15743```
15744**Description**
15745
15746Obtains the font color of the digit-style navigation indicator for the **Swiper** component.
15747
15748**Since**: 18
15749
15750**Parameters**
15751
15752| Name| Description|
15753| -------- | -------- |
15754| indicator | Pointer to a digit-style navigation indicator.|
15755
15756**Returns**
15757
15758Returns the color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
15759
15760### OH_ArkUI_SwiperDigitIndicator_SetSelectedFontColor()
15761
15762```
15763void OH_ArkUI_SwiperDigitIndicator_SetSelectedFontColor(ArkUI_SwiperDigitIndicator* indicator, uint32_t selectedColor)
15764```
15765**Description**
15766
15767Sets the font color of the selected digit-style navigation indicator for the **Swiper** component.
15768
15769**Since**: 18
15770
15771**Parameters**
15772
15773| Name| Description|
15774| -------- | -------- |
15775| indicator | Pointer to a digit-style navigation indicator. |
15776| selectedColor | Color, in 0xARGB format. For example, 0xFFFF0000 indicates red. |
15777
15778### OH_ArkUI_SwiperDigitIndicator_GetSelectedFontColor()
15779
15780```
15781uint32_t OH_ArkUI_SwiperDigitIndicator_GetSelectedFontColor(ArkUI_SwiperDigitIndicator* indicator)
15782```
15783**Description**
15784
15785Obtains the font color of the selected digit-style navigation indicator for the **Swiper** component.
15786
15787**Since**: 18
15788
15789**Parameters**
15790
15791| Name| Description|
15792| -------- | -------- |
15793| indicator | Pointer to a digit-style navigation indicator.|
15794
15795**Returns**
15796
15797Returns the color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
15798
15799### OH_ArkUI_SwiperDigitIndicator_SetFontSize()
15800
15801```
15802void OH_ArkUI_SwiperDigitIndicator_SetFontSize(ArkUI_SwiperDigitIndicator* indicator, float size)
15803```
15804**Description**
15805
15806Sets the font size of the digit-style navigation indicator for the **Swiper** component.
15807
15808**Since**: 18
15809
15810**Parameters**
15811
15812| Name| Description|
15813| -------- | -------- |
15814| indicator | Pointer to a digit-style navigation indicator. |
15815| size | Font size, in fp. |
15816
15817### OH_ArkUI_SwiperDigitIndicator_GetFontSize()
15818
15819```
15820float OH_ArkUI_SwiperDigitIndicator_GetFontSize(ArkUI_SwiperDigitIndicator* indicator)
15821```
15822**Description**
15823
15824Obtains the font size of the digit-style navigation indicator for the **Swiper** component.
15825
15826**Since**: 18
15827
15828**Parameters**
15829
15830| Name| Description|
15831| -------- | -------- |
15832| indicator | Pointer to a digit-style navigation indicator.|
15833
15834**Returns**
15835
15836Font size, in fp.
15837
15838### OH_ArkUI_SwiperDigitIndicator_SetSelectedFontSize()
15839
15840```
15841void OH_ArkUI_SwiperDigitIndicator_SetSelectedFontSize(ArkUI_SwiperDigitIndicator* indicator, float size)
15842```
15843**Description**
15844
15845Sets the font size of the selected digit-style navigation indicator for the **Swiper** component.
15846
15847**Since**: 18
15848
15849**Parameters**
15850
15851| Name| Description|
15852| -------- | -------- |
15853| indicator | Pointer to a digit-style navigation indicator. |
15854| size | Font size, in fp. |
15855
15856### OH_ArkUI_SwiperDigitIndicator_GetSelectedFontSize()
15857
15858```
15859float OH_ArkUI_SwiperDigitIndicator_GetSelectedFontSize(ArkUI_SwiperDigitIndicator* indicator)
15860```
15861**Description**
15862
15863Obtains the font size of the selected digit-style navigation indicator for the **Swiper** component.
15864
15865**Since**: 18
15866
15867**Parameters**
15868
15869| Name| Description|
15870| -------- | -------- |
15871| indicator | Pointer to a digit-style navigation indicator.|
15872
15873**Returns**
15874
15875Returns the font size, in fp.
15876
15877### OH_ArkUI_SwiperDigitIndicator_SetFontWeight()
15878
15879```
15880void OH_ArkUI_SwiperDigitIndicator_SetFontWeight(ArkUI_SwiperDigitIndicator* indicator, ArkUI_FontWeight fontWeight)
15881```
15882**Description**
15883
15884Sets the font weight of the digit-style navigation indicator for the **Swiper** component.
15885
15886**Since**: 18
15887
15888**Parameters**
15889
15890| Name| Description|
15891| -------- | -------- |
15892| indicator | Pointer to a digit-style navigation indicator. |
15893| fontWeight | Font weight, specified by an enumeration value of [ArkUI_FontWeight](#arkui_fontweight). |
15894
15895### OH_ArkUI_SwiperDigitIndicator_GetFontWeight()
15896
15897```
15898ArkUI_FontWeight OH_ArkUI_SwiperDigitIndicator_GetFontWeight(ArkUI_SwiperDigitIndicator* indicator)
15899```
15900**Description**
15901
15902 Obtains the font weight of the digit-style navigation indicator for the **Swiper** component.
15903
15904**Since**: 18
15905
15906**Parameters**
15907
15908| Name| Description|
15909| -------- | -------- |
15910| indicator | Pointer to a digit-style navigation indicator.|
15911
15912**Returns**
15913
15914Returns the font weight, specified by an enumeration value of [ArkUI_FontWeight](#arkui_fontweight).
15915
15916### OH_ArkUI_SwiperDigitIndicator_SetSelectedFontWeight()
15917
15918```
15919void OH_ArkUI_SwiperDigitIndicator_SetSelectedFontWeight(ArkUI_SwiperDigitIndicator* indicator, ArkUI_FontWeight fontWeight)
15920```
15921**Description**
15922
15923Sets the font weight of the selected digit-style navigation indicator for the **Swiper** component.
15924
15925**Since**: 18
15926
15927**Parameters**
15928
15929| Name| Description|
15930| -------- | -------- |
15931| indicator | Pointer to a digit-style navigation indicator. |
15932| fontWeight | Font weight, specified by an enumeration value of [ArkUI_FontWeight](#arkui_fontweight). |
15933
15934### OH_ArkUI_SwiperDigitIndicator_GetSelectedFontWeight()
15935
15936```
15937ArkUI_FontWeight OH_ArkUI_SwiperDigitIndicator_GetSelectedFontWeight(ArkUI_SwiperDigitIndicator* indicator)
15938```
15939**Description**
15940
15941 Obtains the font weight of the selected digit-style navigation indicator for the **Swiper** component.
15942
15943**Since**: 18
15944
15945**Parameters**
15946
15947| Name| Description|
15948| -------- | -------- |
15949| indicator | Pointer to a digit-style navigation indicator.|
15950
15951**Returns**
15952
15953Returns the font weight, specified by an enumeration value of [ArkUI_FontWeight](#arkui_fontweight).
15954
15955### OH_ArkUI_SwiperDigitIndicator_Dispose
15956
15957```
15958void OH_ArkUI_SwiperDigitIndicator_Dispose(ArkUI_SwiperDigitIndicator* indicator)
15959```
15960**Description**
15961
15962Disposes of the digit-style navigation indicator of this **Swiper** component.
15963
15964**Since**: 18
15965
15966**Parameters**
15967
15968| Name| Description|
15969| -------- | -------- |
15970| indicator | Pointer to a digit-style navigation indicator. |
15971
15972### OH_ArkUI_SwiperArrowStyle_Create()
15973
15974```
15975ArkUI_SwiperArrowStyle *OH_ArkUI_SwiperArrowStyle_Create()
15976```
15977**Description**
15978
15979Creates an arrow style for the **Swiper** component.
15980
15981**Since**: 18
15982
15983**Returns**
15984
15985Returns the pointer to the arrow object.
15986
15987### OH_ArkUI_SwiperArrowStyle_SetShowBackground()
15988
15989```
15990void OH_ArkUI_SwiperArrowStyle_SetShowBackground(ArkUI_SwiperArrowStyle *arrowStyle, int32_t showBackground)
15991```
15992**Description**
15993
15994Sets whether to display the background of the arrow for the **Swiper** component.
15995
15996**Since**: 18
15997
15998**Parameters**
15999
16000| Name| Description|
16001| -------- | -------- |
16002| arrowStyle | Pointer to the arrow object. |
16003| showBackground | Whether to show the arrow background. The value **1** means to show the background, and **0** means the opposite. The default value is **0**. |
16004
16005### OH_ArkUI_SwiperArrowStyle_GetShowBackground()
16006
16007```
16008int32_t OH_ArkUI_SwiperArrowStyle_GetShowBackground(ArkUI_SwiperArrowStyle* arrowStyle)
16009```
16010**Description**
16011
16012 Checks whether the background of the arrow is displayed for the **Swiper** component.
16013
16014**Since**: 18
16015
16016**Parameters**
16017
16018| Name| Description|
16019| -------- | -------- |
16020| arrowStyle | Pointer to the arrow object.|
16021
16022**Returns**
16023
16024Returns whether the arrow background is displayed. The value **1** means that the background is displayed, and **0** means the opposite.
16025
16026### OH_ArkUI_SwiperArrowStyle_SetShowSidebarMiddle()
16027
16028```
16029void OH_ArkUI_SwiperArrowStyle_SetShowSidebarMiddle(ArkUI_SwiperArrowStyle *arrowStyle, int32_t showSidebarMiddle)
16030```
16031**Description**
16032
16033Sets the position of the arrow for the **Swiper** component.
16034
16035**Since**: 18
16036
16037**Parameters**
16038
16039| Name| Description|
16040| -------- | -------- |
16041| arrowStyle | Pointer to the arrow object. |
16042| showSidebarMiddle | Position of the arrow. **0**: The arrow is displayed on both sides of the navigation indicator. **1**: The arrow is displayed on both sides of the **Swiper** component. The default value is **0**. |
16043
16044### OH_ArkUI_SwiperArrowStyle_GetShowSidebarMiddle()
16045
16046```
16047int32_t OH_ArkUI_SwiperArrowStyle_GetShowSidebarMiddle(ArkUI_SwiperArrowStyle* arrowStyle)
16048```
16049**Description**
16050
16051Obtains the position of the arrow for the **Swiper** component.
16052
16053**Since**: 18
16054
16055**Parameters**
16056
16057| Name| Description|
16058| -------- | -------- |
16059| arrowStyle | Pointer to the arrow object.|
16060
16061**Returns**
16062
16063Returns the position of the arrow. **0**: The arrow is displayed on both sides of the navigation indicator. **1**: The arrow is displayed on both sides of the **Swiper** component.
16064
16065### OH_ArkUI_SwiperArrowStyle_SetBackgroundSize()
16066
16067```
16068void OH_ArkUI_SwiperArrowStyle_SetBackgroundSize(ArkUI_SwiperArrowStyle* arrowStyle, float backgroundSize)
16069```
16070**Description**
16071
16072Sets the background size for the arrow of the **Swiper** component.
16073
16074**Since**: 18
16075
16076**Parameters**
16077
16078| Name| Description|
16079| -------- | -------- |
16080| arrowStyle | Pointer to the arrow object. |
16081| backgroundSize | Background size of the arrow, in vp. Default value: 24 vp when displayed on both sides of the navigation indicator and 32 vp when displayed on both sides of the **Swiper** component. |
16082
16083### OH_ArkUI_SwiperArrowStyle_GetBackgroundSize()
16084
16085```
16086float OH_ArkUI_SwiperArrowStyle_GetBackgroundSize(ArkUI_SwiperArrowStyle* arrowStyle)
16087```
16088**Description**
16089
16090Obtains the background size of the arrow of the **Swiper** component.
16091
16092**Since**: 18
16093
16094**Parameters**
16095
16096| Name| Description|
16097| -------- | -------- |
16098| arrowStyle | Pointer to the arrow object.|
16099
16100**Returns**
16101
16102Returns the background size of the arrow, in vp.
16103
16104### OH_ArkUI_SwiperArrowStyle_SetBackgroundColor()
16105
16106```
16107void OH_ArkUI_SwiperArrowStyle_SetBackgroundColor(ArkUI_SwiperArrowStyle* arrowStyle, uint32_t backgroundColor)
16108```
16109**Description**
16110
16111Sets the background color for the arrow of the **Swiper** component.
16112
16113**Since**: 18
16114
16115**Parameters**
16116
16117| Name| Description|
16118| -------- | -------- |
16119| arrowStyle | Pointer to the arrow object. |
16120| backgroundColor | Background color of the arrow, in 0xARGB format. For example, 0xFFFF0000 indicates red. |
16121
16122### OH_ArkUI_SwiperArrowStyle_GetBackgroundColor()
16123
16124```
16125uint32_t OH_ArkUI_SwiperArrowStyle_GetBackgroundColor(ArkUI_SwiperArrowStyle* arrowStyle)
16126```
16127**Description**
16128
16129Obtains the background color for the arrow of the **Swiper** component.
16130
16131**Since**: 18
16132
16133**Parameters**
16134
16135| Name| Description|
16136| -------- | -------- |
16137| arrowStyle | Pointer to the arrow object.|
16138
16139**Returns**
16140
16141Returns the background color of the arrow, in 0xARGB format. For example, 0xFFFF0000 indicates red.
16142
16143### OH_ArkUI_SwiperArrowStyle_SetArrowSize()
16144
16145```
16146void OH_ArkUI_SwiperArrowStyle_SetArrowSize(ArkUI_SwiperArrowStyle* arrowStyle, float arrowSize)
16147```
16148**Description**
16149
16150Sets the size for the arrow of the **Swiper** component.
16151
16152**Since**: 18
16153
16154**Parameters**
16155
16156| Name| Description|
16157| -------- | -------- |
16158| arrowStyle | Pointer to the arrow object. |
16159| arrowSize |  Size of the arrow, in vp. Default value: 18 vp when displayed on both sides of the navigation indicator and 24 vp when displayed on both sides of the **Swiper** component. When the arrow background is displayed, the value of **arrowSize** is fixed at 3/4 of the value of **backgroundSize**.|
16160
16161### OH_ArkUI_SwiperArrowStyle_GetArrowSize()
16162
16163```
16164float OH_ArkUI_SwiperArrowStyle_GetArrowSize(ArkUI_SwiperArrowStyle* arrowStyle)
16165```
16166**Description**
16167
16168Obtains the size of the arrow of the **Swiper** component.
16169
16170**Since**: 18
16171
16172**Parameters**
16173
16174| Name| Description|
16175| -------- | -------- |
16176| arrowStyle | Pointer to the arrow object.|
16177
16178**Returns**
16179
16180Returns the size of the arrow, in vp.
16181
16182### OH_ArkUI_SwiperArrowStyle_SetArrowColor()
16183
16184```
16185void OH_ArkUI_SwiperArrowStyle_SetArrowColor(ArkUI_SwiperArrowStyle* arrowStyle, uint32_t arrowColor)
16186```
16187**Description**
16188
16189Sets the color for the arrow of the **Swiper** component.
16190
16191**Since**: 18
16192
16193**Parameters**
16194
16195| Name| Description|
16196| -------- | -------- |
16197| arrowStyle | Pointer to the arrow object. |
16198| arrowColor |  Color of the arrow, in 0xARGB format. For example, 0xFFFF0000 indicates red.|
16199
16200### OH_ArkUI_SwiperArrowStyle_GetArrowColor()
16201
16202```
16203uint32_t OH_ArkUI_SwiperArrowStyle_GetArrowColor(ArkUI_SwiperArrowStyle* arrowStyle)
16204```
16205**Description**
16206
16207Obtains the color of the arrow of the **Swiper** component.
16208
16209**Since**: 18
16210
16211**Parameters**
16212
16213| Name| Description|
16214| -------- | -------- |
16215| arrowStyle | Pointer to the arrow object.|
16216
16217**Returns**
16218
16219Returns the color of the arrow, in 0xARGB format. For example, 0xFFFF0000 indicates red.
16220
16221### OH_ArkUI_SwiperArrowStyle_Dispose
16222
16223```
16224void OH_ArkUI_SwiperArrowStyle_Dispose(ArkUI_SwiperArrowStyle* arrowStyle)
16225```
16226**Description**
16227
16228Disposes of the arrow of the **Swiper** component.
16229
16230**Since**: 18
16231
16232**Parameters**
16233
16234| Name| Description|
16235| -------- | -------- |
16236| arrowStyle | Pointer to the arrow object. |
16237
16238### OH_ArkUI_SwiperIndicator_GetSelectedColor()
16239
16240```
16241uint32_t OH_ArkUI_SwiperIndicator_GetSelectedColor (ArkUI_SwiperIndicator * indicator)
16242```
16243**Description**
16244
16245Obtains the color of the selected dot-style navigation indicator of the **Swiper** component.
16246
16247**Since**: 12
16248
16249**Parameters**
16250
16251| Name| Description|
16252| -------- | -------- |
16253| indicator | Returns the pointer to the navigation indicator. |
16254
16255**Returns**
16256
16257Returns the color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
16258
16259
16260### OH_ArkUI_SwiperIndicator_GetSelectedItemHeight()
16261
16262```
16263float OH_ArkUI_SwiperIndicator_GetSelectedItemHeight (ArkUI_SwiperIndicator * indicator)
16264```
16265**Description**
16266
16267Obtains the height of the selected dot-style navigation indicator of the **Swiper** component.
16268
16269**Since**: 12
16270
16271**Parameters**
16272
16273| Name| Description|
16274| -------- | -------- |
16275| indicator | Returns the pointer to the navigation indicator. |
16276
16277**Returns**
16278
16279Returns the height of the dot-style navigation indicator.
16280
16281
16282### OH_ArkUI_SwiperIndicator_GetSelectedItemWidth()
16283
16284```
16285float OH_ArkUI_SwiperIndicator_GetSelectedItemWidth (ArkUI_SwiperIndicator * indicator)
16286```
16287**Description**
16288
16289Obtains the width of the selected dot-style navigation indicator of the **Swiper** component.
16290
16291**Since**: 12
16292
16293**Parameters**
16294
16295| Name| Description|
16296| -------- | -------- |
16297| indicator | Returns the pointer to the navigation indicator. |
16298
16299**Returns**
16300
16301Returns the width of the dot-style navigation indicator.
16302
16303
16304### OH_ArkUI_SwiperIndicator_GetStartPosition()
16305
16306```
16307float OH_ArkUI_SwiperIndicator_GetStartPosition (ArkUI_SwiperIndicator * indicator)
16308```
16309**Description**
16310
16311Obtains the distance between a navigation indicator and the left edge of the **Swiper** component.
16312
16313**Since**: 12
16314
16315**Parameters**
16316
16317| Name| Description|
16318| -------- | -------- |
16319| indicator | Returns the pointer to the navigation indicator. |
16320
16321**Returns**
16322
16323Returns the distance between the navigation indicator and the left edge of the **Swiper** component.
16324
16325
16326### OH_ArkUI_SwiperIndicator_GetTopPosition()
16327
16328```
16329float OH_ArkUI_SwiperIndicator_GetTopPosition (ArkUI_SwiperIndicator * indicator)
16330```
16331**Description**
16332
16333Obtains the distance between the navigation indicator and the top edge of the **Swiper** component.
16334
16335**Since**: 12
16336
16337**Parameters**
16338
16339| Name| Description|
16340| -------- | -------- |
16341| indicator | Returns the pointer to the navigation indicator. |
16342
16343**Returns**
16344
16345Returns the distance between a navigation indicator and the top edge of the **Swiper** component.
16346
16347
16348### OH_ArkUI_SwiperIndicator_SetBottomPosition()
16349
16350```
16351void OH_ArkUI_SwiperIndicator_SetBottomPosition (ArkUI_SwiperIndicator * indicator, float value )
16352```
16353**Description**
16354
16355Sets the distance between the navigation indicator and the bottom edge of the **Swiper** component.
16356
16357**Since**: 12
16358
16359**Parameters**
16360
16361| Name| Description|
16362| -------- | -------- |
16363| indicator | Pointer to a navigation indicator. |
16364| value | Distance between a navigation indicator and the bottom edge of the **Swiper** component. |
16365
16366
16367### OH_ArkUI_SwiperIndicator_SetColor()
16368
16369```
16370void OH_ArkUI_SwiperIndicator_SetColor (ArkUI_SwiperIndicator * indicator, uint32_t color )
16371```
16372**Description**
16373
16374Sets the color of a dot-style navigation indicator for the **Swiper** component.
16375
16376**Since**: 12
16377
16378**Parameters**
16379
16380| Name| Description|
16381| -------- | -------- |
16382| indicator | Returns the pointer to the navigation indicator. |
16383| color | Color, in 0xARGB format. For example, 0xFFFF0000 indicates red. |
16384
16385
16386### OH_ArkUI_SwiperIndicator_SetEndPosition()
16387
16388```
16389void OH_ArkUI_SwiperIndicator_SetEndPosition (ArkUI_SwiperIndicator * indicator, float value )
16390```
16391**Description**
16392
16393Distance between the navigation indicator and the left edge of the **Swiper** component.
16394
16395**Since**: 12
16396
16397**Parameters**
16398
16399| Name| Description|
16400| -------- | -------- |
16401| indicator | Pointer to a navigation indicator. |
16402| value | Returns the distance between the navigation indicator and the right edge of the **Swiper** component. |
16403
16404
16405### OH_ArkUI_SwiperIndicator_SetItemHeight()
16406
16407```
16408void OH_ArkUI_SwiperIndicator_SetItemHeight (ArkUI_SwiperIndicator * indicator, float value )
16409```
16410**Description**
16411
16412Sets the height of a dot-style navigation indicator for the **Swiper** component.
16413
16414**Since**: 12
16415
16416**Parameters**
16417
16418| Name| Description|
16419| -------- | -------- |
16420| indicator | Pointer to a navigation indicator. |
16421| value | Returns the height of the dot-style navigation indicator. |
16422
16423
16424### OH_ArkUI_SwiperIndicator_SetItemWidth()
16425
16426```
16427void OH_ArkUI_SwiperIndicator_SetItemWidth (ArkUI_SwiperIndicator * indicator, float value )
16428```
16429**Description**
16430
16431Sets the width of a dot-style navigation indicator for the **Swiper** component.
16432
16433**Since**: 12
16434
16435**Parameters**
16436
16437| Name| Description|
16438| -------- | -------- |
16439| indicator | Pointer to a navigation indicator. |
16440| value | Returns the width of the dot-style navigation indicator. |
16441
16442
16443### OH_ArkUI_SwiperIndicator_SetMask()
16444
16445```
16446void OH_ArkUI_SwiperIndicator_SetMask (ArkUI_SwiperIndicator * indicator, int32_t mask )
16447```
16448**Description**
16449
16450Sets whether to enable the mask for a dot-style navigation indicator for the **Swiper** component.
16451
16452**Since**: 12
16453
16454**Parameters**
16455
16456| Name| Description|
16457| -------- | -------- |
16458| indicator | Pointer to a navigation indicator. |
16459| mask | Whether to enable the mask. The value **1** means to enable the mask, and **0** means the opposite. |
16460
16461
16462### OH_ArkUI_SwiperIndicator_SetMaxDisplayCount()
16463
16464```
16465int32_t OH_ArkUI_SwiperIndicator_SetMaxDisplayCount (ArkUI_SwiperIndicator * indicator, int32_t maxDisplayCount )
16466```
16467**Description**
16468
16469Sets the maximum number of dots for the dot-style navigation indicator.
16470
16471**Since**: 12
16472
16473**Parameters**
16474
16475| Name| Description|
16476| -------- | -------- |
16477| indicator | Pointer to a navigation indicator. |
16478| maxDisplayCount | Maximum number of navigation points. The value ranges from 6 to 9. |
16479
16480**Returns**
16481
16482Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if **maxDisplayCount** is set to an invalid value.
16483
16484
16485### OH_ArkUI_SwiperIndicator_SetSelectedColor()
16486
16487```
16488void OH_ArkUI_SwiperIndicator_SetSelectedColor (ArkUI_SwiperIndicator * indicator, uint32_t selectedColor )
16489```
16490**Description**
16491
16492Sets the color of the selected dot-style navigation indicator for the **Swiper** component.
16493
16494**Since**: 12
16495
16496**Parameters**
16497
16498| Name| Description|
16499| -------- | -------- |
16500| indicator | Pointer to a navigation indicator. |
16501| selectedColor | Color, in 0xARGB format. For example, 0xFFFF0000 indicates red. |
16502
16503
16504### OH_ArkUI_SwiperIndicator_SetSelectedItemHeight()
16505
16506```
16507void OH_ArkUI_SwiperIndicator_SetSelectedItemHeight (ArkUI_SwiperIndicator * indicator, float value )
16508```
16509**Description**
16510
16511Sets the height of the selected dot-style navigation indicator for the **Swiper** component.
16512
16513**Since**: 12
16514
16515**Parameters**
16516
16517| Name| Description|
16518| -------- | -------- |
16519| indicator | Pointer to a navigation indicator. |
16520| value | Height of the dot-style navigation indicator. |
16521
16522
16523### OH_ArkUI_SwiperIndicator_SetSelectedItemWidth()
16524
16525```
16526void OH_ArkUI_SwiperIndicator_SetSelectedItemWidth (ArkUI_SwiperIndicator * indicator, float value )
16527```
16528**Description**
16529
16530Sets the width of the selected dot-style navigation indicator for the **Swiper** component.
16531
16532**Since**: 12
16533
16534**Parameters**
16535
16536| Name| Description|
16537| -------- | -------- |
16538| indicator | Pointer to a navigation indicator. |
16539| value | Width of the dot-style navigation indicator. |
16540
16541
16542### OH_ArkUI_SwiperIndicator_SetStartPosition()
16543
16544```
16545void OH_ArkUI_SwiperIndicator_SetStartPosition (ArkUI_SwiperIndicator * indicator, float value )
16546```
16547**Description**
16548
16549Sets the distance between the navigation indicator and the left edge of the **Swiper** component.
16550
16551**Since**: 12
16552
16553**Parameters**
16554
16555| Name| Description|
16556| -------- | -------- |
16557| indicator | Pointer to a navigation indicator. |
16558| value | Distance between the navigation indicator and the left edge of the **Swiper** component. |
16559
16560
16561### OH_ArkUI_SwiperIndicator_SetTopPosition()
16562
16563```
16564void OH_ArkUI_SwiperIndicator_SetTopPosition (ArkUI_SwiperIndicator * indicator, float value )
16565```
16566**Description**
16567
16568Sets the distance between the navigation indicator and the top edge of the **Swiper** component.
16569
16570**Since**: 12
16571
16572**Parameters**
16573
16574| Name| Description|
16575| -------- | -------- |
16576| indicator | Pointer to a navigation indicator. |
16577| value | Distance between a navigation indicator and the top edge of the **Swiper** component. |
16578
16579
16580### OH_ArkUI_SystemFontStyleEvent_GetFontSizeScale()
16581
16582```
16583float OH_ArkUI_SystemFontStyleEvent_GetFontSizeScale (const ArkUI_SystemFontStyleEvent * event)
16584```
16585**Description**
16586
16587Obtains the font size scale from the system font style change event.
16588
16589**Since**: 12
16590
16591**Parameters**
16592
16593| Name| Description|
16594| -------- | -------- |
16595| event | Pointer to the current system font style change event. |
16596
16597**Returns**
16598
16599Returns the font size scale after the change. Default value: **1.0**.
16600
16601
16602### OH_ArkUI_SystemFontStyleEvent_GetFontWeightScale()
16603
16604```
16605float OH_ArkUI_SystemFontStyleEvent_GetFontWeightScale (const ArkUI_SystemFontStyleEvent * event)
16606```
16607**Description**
16608
16609Obtains the font weight scale from the system font style change event.
16610
16611**Since**: 12
16612
16613**Parameters**
16614
16615| Name| Description|
16616| -------- | -------- |
16617| event | Pointer to the current system font style change event. |
16618
16619**Returns**
16620
16621Returns the font weight scale after the change. Default value: **1.0**.
16622
16623
16624### OH_ArkUI_TransitionEffect_Combine()
16625
16626```
16627int32_t OH_ArkUI_TransitionEffect_Combine (ArkUI_TransitionEffect * option, ArkUI_TransitionEffect * combine )
16628```
16629**Description**
16630
16631Sets a combination of transition effects.
16632
16633**Since**: 12
16634
16635**Parameters**
16636
16637| Name| Description|
16638| -------- | -------- |
16639| option | Transition effect options. |
16640| combine | Combination of transition effects. |
16641
16642**Returns**
16643
16644Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
16645
16646
16647### OH_ArkUI_TransitionEffect_Dispose()
16648
16649```
16650void OH_ArkUI_TransitionEffect_Dispose (ArkUI_TransitionEffect * option)
16651```
16652**Description**
16653
16654Destroys a transition effect object.
16655
16656**Since**: 12
16657
16658**Parameters**
16659
16660| Name| Description|
16661| -------- | -------- |
16662| option | Transition effect object. |
16663
16664
16665### OH_ArkUI_TransitionEffect_SetAnimation()
16666
16667```
16668int32_t OH_ArkUI_TransitionEffect_SetAnimation (ArkUI_TransitionEffect * option, ArkUI_AnimateOption * animation )
16669```
16670**Description**
16671
16672Sets transition effect animation settings.
16673
16674**Since**: 12
16675
16676**Parameters**
16677
16678| Name| Description|
16679| -------- | -------- |
16680| option | Transition effect options. |
16681| animation | Animation settings. |
16682
16683**NOTE**
16684
16685If **combine** is used for combining transition effects, the animation settings of a transition effect are applicable to the one following it.
16686
16687**Returns**
16688
16689Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
16690
16691
16692### OH_ArkUI_UnmarshallStyledStringDescriptor()
16693
16694```
16695int32_t OH_ArkUI_UnmarshallStyledStringDescriptor (uint8_t * buffer, size_t bufferSize, ArkUI_StyledString_Descriptor * descriptor, size_t * resultSize )
16696```
16697**Description**
16698
16699Deserializes a byte array containing styled string information into a styled string.
16700
16701**Since**: 14
16702
16703**Parameters**
16704
16705| Name| Description|
16706| -------- | -------- |
16707| buffer | Byte array to be deserialized. |
16708| bufferSize | Length of the byte array. |
16709| descriptor | Pointer to an **ArkUI_StyledString_Descriptor** object. |
16710| resultSize | Actual length of the resulting byte array after deserialization. |
16711
16712**Returns**
16713
16714Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful. Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
16715
16716
16717### OH_ArkUI_UnregisterSystemColorModeChangeEvent()
16718
16719```
16720void OH_ArkUI_UnregisterSystemColorModeChangeEvent (ArkUI_NodeHandle node)
16721```
16722**Description**
16723
16724Unregisters the event listener for system color mode changes.
16725
16726**Since**: 12
16727
16728**Parameters**
16729
16730| Name| Description|
16731| -------- | -------- |
16732| node | Specified node. |
16733
16734
16735### OH_ArkUI_UnregisterSystemFontStyleChangeEvent()
16736
16737```
16738void OH_ArkUI_UnregisterSystemFontStyleChangeEvent (ArkUI_NodeHandle node)
16739```
16740**Description**
16741
16742Unregisters the event listener for system font style changes.
16743
16744**Since**: 12
16745
16746**Parameters**
16747
16748| Name| Description|
16749| -------- | -------- |
16750| node | Specified node. |
16751
16752
16753### OH_ArkUI_WaterFlowSectionOption_Create()
16754
16755```
16756ArkUI_WaterFlowSectionOption* OH_ArkUI_WaterFlowSectionOption_Create ()
16757```
16758**Description**
16759
16760Creates a water flow section configuration.
16761
16762**Since**: 12
16763
16764**Returns**
16765
16766Return the pointer to the created water flow section configuration.
16767
16768
16769### OH_ArkUI_WaterFlowSectionOption_Dispose()
16770
16771```
16772void OH_ArkUI_WaterFlowSectionOption_Dispose (ArkUI_WaterFlowSectionOption * option)
16773```
16774**Description**
16775
16776Disposes of the pointer to a water flow section configuration.
16777
16778**Since**: 12
16779
16780**Parameters**
16781
16782| Name| Description|
16783| -------- | -------- |
16784| option | Pointer to a water flow section configuration. |
16785
16786
16787### OH_ArkUI_WaterFlowSectionOption_GetColumnGap()
16788
16789```
16790float OH_ArkUI_WaterFlowSectionOption_GetColumnGap (ArkUI_WaterFlowSectionOption * option, int32_t index )
16791```
16792**Description**
16793
16794Obtains the gap between columns in the water flow section that matches the specified index.
16795
16796**Since**: 12
16797
16798**Parameters**
16799
16800| Name| Description|
16801| -------- | -------- |
16802| option | Pointer to a water flow section configuration. |
16803| index | Index of the target water flow section. |
16804
16805**Returns**
16806
16807Returns the gap between columns.
16808
16809
16810### OH_ArkUI_WaterFlowSectionOption_GetCrossCount()
16811
16812```
16813int32_t OH_ArkUI_WaterFlowSectionOption_GetCrossCount (ArkUI_WaterFlowSectionOption * option, int32_t index )
16814```
16815**Description**
16816
16817Obtains the number of columns (in a vertical layout) or rows (in a horizontal layout) of a water flow.
16818
16819**Since**: 12
16820
16821**Parameters**
16822
16823| Name| Description|
16824| -------- | -------- |
16825| option | Pointer to a water flow section configuration. |
16826| index | Index of the target water flow section. |
16827
16828**Returns**
16829
16830Returns the number of columns (in a vertical layout) or rows (in a horizontal layout) of a water flow.
16831
16832
16833### OH_ArkUI_WaterFlowSectionOption_GetItemCount()
16834
16835```
16836int32_t OH_ArkUI_WaterFlowSectionOption_GetItemCount (ArkUI_WaterFlowSectionOption * option, int32_t index )
16837```
16838**Description**
16839
16840Obtains the number of items in the water flow section that matches the specified index.
16841
16842**Since**: 12
16843
16844**Parameters**
16845
16846| Name| Description|
16847| -------- | -------- |
16848| option | Pointer to a water flow section configuration. |
16849| index | Index of the target water flow section. |
16850
16851**Returns**
16852
16853Returns the number of items in the water flow section.
16854
16855
16856### OH_ArkUI_WaterFlowSectionOption_GetMargin()
16857
16858```
16859ArkUI_Margin OH_ArkUI_WaterFlowSectionOption_GetMargin (ArkUI_WaterFlowSectionOption * option, int32_t index )
16860```
16861**Description**
16862
16863Obtains the margins of the water flow section that matches the specified index.
16864
16865**Since**: 12
16866
16867**Parameters**
16868
16869| Name| Description|
16870| -------- | -------- |
16871| option | Pointer to a water flow section configuration. |
16872| index | Index of the target water flow section. |
16873
16874**Returns**
16875
16876Returns the margins.
16877
16878
16879### OH_ArkUI_WaterFlowSectionOption_GetRowGap()
16880
16881```
16882float OH_ArkUI_WaterFlowSectionOption_GetRowGap (ArkUI_WaterFlowSectionOption * option, int32_t index )
16883```
16884**Description**
16885
16886Obtains the gap between rows in the water flow section that matches the specified index.
16887
16888**Since**: 12
16889
16890**Parameters**
16891
16892| Name| Description|
16893| -------- | -------- |
16894| option | Pointer to a water flow section configuration. |
16895| index | Index of the target water flow section. |
16896
16897**Returns**
16898
16899Returns the gap between rows.
16900
16901
16902### OH_ArkUI_WaterFlowSectionOption_GetSize()
16903
16904```
16905int32_t OH_ArkUI_WaterFlowSectionOption_GetSize (ArkUI_WaterFlowSectionOption * option)
16906```
16907**Description**
16908
16909Sets the array length for a water flow section configuration.
16910
16911**Since**: 12
16912
16913**Parameters**
16914
16915| Name| Description|
16916| -------- | -------- |
16917| option | Pointer to a water flow section configuration. |
16918
16919**Returns**
16920
16921Returns 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.
16922
16923
16924### OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndex()
16925
16926```
16927void OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndex (ArkUI_WaterFlowSectionOption * option, int32_t index, float(*)(int32_t itemIndex) callback )
16928```
16929**Description**
16930
16931Obtains the main axis size of a specified item based on **flowItemIndex** through a water flow section configuration.
16932
16933**Since**: 12
16934
16935**Parameters**
16936
16937| Name| Description|
16938| -------- | -------- |
16939| option | Pointer to a water flow section configuration. |
16940| index | Index of the target water flow section. |
16941| callback | Callback used to return the result. |
16942
16943
16944### OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndexWithUserData()
16945
16946```
16947void OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndexWithUserData (ArkUI_WaterFlowSectionOption * option, int32_t index, void * userData, float(*)(int32_t itemIndex, void *userData) callback )
16948```
16949**Description**
16950
16951Obtains the main axis size of a specified item based on **flowItemIndex** through a water flow section configuration.
16952
16953**Since**: 12
16954
16955**Parameters**
16956
16957| Name| Description|
16958| -------- | -------- |
16959| option | Pointer to a water flow section configuration. |
16960| index | Index of the target water flow section. |
16961| userData | Custom data of the water flow item. |
16962| callback | Callback used to return the result. |
16963
16964
16965### OH_ArkUI_WaterFlowSectionOption_SetColumnGap()
16966
16967```
16968void OH_ArkUI_WaterFlowSectionOption_SetColumnGap (ArkUI_WaterFlowSectionOption * , int32_t index, float columnGap )
16969```
16970**Description**
16971
16972Sets the gap between columns in the specified water flow section.
16973
16974**Since**: 12
16975
16976**Parameters**
16977
16978| Name| Description|
16979| -------- | -------- |
16980| option | Pointer to a water flow section configuration. |
16981| index | Index of the target water flow section. |
16982| columnGap | Gap between columns. |
16983
16984
16985### OH_ArkUI_WaterFlowSectionOption_SetCrossCount()
16986
16987```
16988void OH_ArkUI_WaterFlowSectionOption_SetCrossCount (ArkUI_WaterFlowSectionOption * option, int32_t index, int32_t crossCount )
16989```
16990**Description**
16991
16992Sets the number of columns (in a vertical layout) or rows (in a horizontal layout) of a water flow.
16993
16994**Since**: 12
16995
16996**Parameters**
16997
16998| Name| Description|
16999| -------- | -------- |
17000| option | Pointer to a water flow section configuration. |
17001| index | Index of the target water flow section. |
17002| crossCount | Number of columns or rows, depending on the layout direction. |
17003
17004
17005### OH_ArkUI_WaterFlowSectionOption_SetItemCount()
17006
17007```
17008void OH_ArkUI_WaterFlowSectionOption_SetItemCount (ArkUI_WaterFlowSectionOption * option, int32_t index, int32_t itemCount )
17009```
17010**Description**
17011
17012Sets the number of items in a water flow section.
17013
17014**Since**: 12
17015
17016**Parameters**
17017
17018| Name| Description|
17019| -------- | -------- |
17020| option | Pointer to a water flow section configuration. |
17021| index | Index of the target water flow section. |
17022| itemCount | Number of items in the water flow section. |
17023
17024
17025### OH_ArkUI_WaterFlowSectionOption_SetMargin()
17026
17027```
17028void OH_ArkUI_WaterFlowSectionOption_SetMargin (ArkUI_WaterFlowSectionOption * option, int32_t index, float marginTop, float marginRight, float marginBottom, float marginLeft )
17029```
17030**Description**
17031
17032Sets the margins for the specified water flow section.
17033
17034**Since**: 12
17035
17036**Parameters**
17037
17038| Name| Description|
17039| -------- | -------- |
17040| option | Pointer to a water flow section configuration. |
17041| index | Index of the target water flow section. |
17042| marginTop | Top margin of the water flow section. |
17043| marginRight | Right margin of the water flow section. |
17044| marginBottom | Bottom margin of the water flow section. |
17045| marginLeft | Left margin of the water flow section. |
17046
17047
17048### OH_ArkUI_WaterFlowSectionOption_SetRowGap()
17049
17050```
17051void OH_ArkUI_WaterFlowSectionOption_SetRowGap (ArkUI_WaterFlowSectionOption * option, int32_t index, float rowGap )
17052```
17053**Description**
17054
17055Sets the gap between rows in the specified water flow section.
17056
17057**Since**: 12
17058
17059**Parameters**
17060
17061| Name| Description|
17062| -------- | -------- |
17063| option | Pointer to a water flow section configuration. |
17064| index | Index of the target water flow section. |
17065| rowGap | Gap between rows to set. |
17066
17067
17068### OH_ArkUI_WaterFlowSectionOption_SetSize()
17069
17070```
17071void OH_ArkUI_WaterFlowSectionOption_SetSize (ArkUI_WaterFlowSectionOption * option, int32_t size )
17072```
17073**Description**
17074
17075Sets the array length for a water flow section configuration.
17076
17077**Since**: 12
17078
17079**Parameters**
17080
17081| Name| Description|
17082| -------- | -------- |
17083| option | Pointer to a water flow section configuration. |
17084| size | Size of the array. |
17085
17086
17087### OH_ArkUI_PostFrameCallback()
17088
17089```
17090int32_t OH_ArkUI_PostFrameCallback(ArkUI_ContextHandle uiContext, void* userData, void (*callback)(uint64_t nanoTimestamp, uint32_t frameCount, void* userData))
17091```
17092**Description**
17093
17094Registers a callback to be executed after the next frame is rendered. This callback must not be called from a non-UI thread. The application will abort if a non-UI thread call is detected.
17095
17096**Since**: 16
17097
17098**Parameters**
17099
17100| Name| Description|
17101| -------- | -------- |
17102| uiContext | UI context object used to bind the instance.|
17103| userData | Custom event parameter, which is passed in the callback when the event is triggered.|
17104| callback | Custom callback to be invoked after the next frame event completes.|
17105| nanoTimestamp | Timestamp of the frame signal.|
17106| frameCount | Frame number.|
17107
17108**Returns**
17109
17110Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17111Returns **ARKUI_ERROR_CODE_CAPI_INIT_ERROR** if there is an API initialization error.
17112Returns **ARKUI_ERROR_CODE_UI_CONTEXT_INVALID** if the UIContext object is invalid.
17113Returns **ARKUI_ERROR_CODE_CALLBACK_INVALID** if the callback is invalid.
17114
17115
17116### OH_ArkUI_RegisterLayoutCallbackOnNodeHandle()
17117
17118```
17119int32_t OH_ArkUI_RegisterLayoutCallbackOnNodeHandle (ArkUI_NodeHandle node, void* userData, void (*onLayoutCompleted)(void* userData))
17120```
17121**Description**
17122
17123Registers a layout completion callback function for a specific component. Only one layout completion callback can be registered per component.
17124
17125**Since**: 16
17126
17127**Parameters**
17128
17129| Name| Description|
17130| -------- | -------- |
17131| node | Specified node. |
17132| userData | Custom event parameter, which is passed in the callback when the event is triggered. |
17133| onLayoutCompleted | Callback to be executed when the event is triggered. |
17134
17135**Returns**
17136
17137Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17138Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
17139
17140
17141### OH_ArkUI_RegisterDrawCallbackOnNodeHandle()
17142
17143```
17144int32_t OH_ArkUI_RegisterDrawCallbackOnNodeHandle (ArkUI_NodeHandle node, void* userData, void (*onDrawCompleted)(void* userData))
17145```
17146**Description**
17147
17148Registers a drawing completion callback function for a specific component. Only one drawing completion callback can be registered per component.
17149
17150**Since**: 16
17151
17152**Parameters**
17153
17154| Name| Description|
17155| -------- | -------- |
17156| node | Specified node. |
17157| userData | Custom event parameter, which is passed in the callback when the event is triggered. |
17158| onDrawCompleted | Callback to be executed when the event is triggered. |
17159
17160**Returns**
17161
17162Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17163Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
17164
17165
17166### OH_ArkUI_UnregisterLayoutCallbackOnNodeHandle()
17167
17168```
17169int32_t OH_ArkUI_UnregisterLayoutCallbackOnNodeHandle (ArkUI_NodeHandle node)
17170```
17171**Description**
17172
17173Unregisters the layout completion callback function for a specific component.
17174
17175**Since**: 16
17176
17177**Parameters**
17178
17179| Name| Description|
17180| -------- | -------- |
17181| node | Specified node. |
17182
17183**Returns**
17184
17185Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17186Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
17187
17188
17189### OH_ArkUI_UnregisterDrawCallbackOnNodeHandle()
17190
17191```
17192int32_t OH_ArkUI_UnregisterDrawCallbackOnNodeHandle (ArkUI_NodeHandle node)
17193```
17194**Description**
17195
17196Unregisters the drawing completion callback function for a specific component.
17197
17198**Since**: 16
17199
17200**Parameters**
17201
17202| Name| Description|
17203| -------- | -------- |
17204| node | Specified node. |
17205
17206**Returns**
17207
17208Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17209Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
17210
17211
17212### OH_ArkUI_ProgressLinearStyleOption_Create
17213
17214```
17215ArkUI_ProgressLinearStyleOption* OH_ArkUI_ProgressLinearStyleOption_Create(void)
17216```
17217**Description**
17218
17219Creates a **ProgressLinearStyleOption** instance.
17220
17221**Since**: 15
17222
17223**Returns**
17224
17225Returns the **ProgressLinearStyleOption** instance created.
17226
17227
17228### OH_ArkUI_ProgressLinearStyleOption_Destroy
17229
17230```
17231void OH_ArkUI_ProgressLinearStyleOption_Destroy(ArkUI_ProgressLinearStyleOption* option)
17232```
17233**Description**
17234
17235Destroys a **ProgressLinearStyleOption** instance.
17236
17237**Since**: 15
17238
17239**Parameters**
17240
17241| Name| Description|
17242| -------- | -------- |
17243| option | **ProgressLinearStyleOption** instance to destroy. |
17244
17245
17246### OH_ArkUI_ProgressLinearStyleOption_SetScanEffectEnabled
17247
17248```
17249void OH_ArkUI_ProgressLinearStyleOption_SetSmoothEffectEnabled(ArkUI_ProgressLinearStyleOption* option, bool enabled)
17250```
17251**Description**
17252
17253Sets whether to enable the scan effect.
17254
17255**Since**: 15
17256
17257
17258**Parameters**
17259
17260| Name| Description|
17261| -------- | -------- |
17262| option | Pointer to the **ProgressLinearStyleOption** instance. |
17263| enabled | Whether to enable the scan effect. The default value is **false**.|
17264
17265
17266### OH_ArkUI_ProgressLinearStyleOption_SetSmoothEffectEnabled
17267
17268```
17269void OH_ArkUI_ProgressLinearStyleOption_SetSmoothEffectEnabled(ArkUI_ProgressLinearStyleOption* option, bool enabled)
17270```
17271**Description**
17272
17273Sets whether to enable the smooth progress effect.
17274
17275**Since**: 15
17276
17277
17278**Parameters**
17279
17280| Name| Description|
17281| -------- | -------- |
17282| option | Pointer to the **ProgressLinearStyleOption** instance. |
17283| enabled | Whether to enable the smooth effect. When this effect is enabled, the progress changes smoothly from the current value to the target value. When this effect is disabled, the progress changes abruptly to the target value. The default value is **true**.|
17284
17285
17286### OH_ArkUI_ProgressLinearStyleOption_SetStrokeWidth
17287
17288```
17289void OH_ArkUI_ProgressLinearStyleOption_SetStrokeWidth(ArkUI_ProgressLinearStyleOption* option, float strokeWidth)
17290```
17291**Description**
17292
17293Sets the stroke width of the linear progress indicator.
17294
17295**Since**: 15
17296
17297
17298**Parameters**
17299
17300| Name| Description|
17301| -------- | -------- |
17302| option | Pointer to the **ProgressLinearStyleOption** instance. |
17303| strokeWidth | Stroke width of the progress indicator. The value cannot be set in percentage. The default value is **4.0vp**.|
17304
17305
17306### OH_ArkUI_ProgressLinearStyleOption_SetStrokeRadius
17307
17308```
17309void OH_ArkUI_ProgressLinearStyleOption_SetStrokeRadius(ArkUI_ProgressLinearStyleOption* option, float strokeRadius)
17310```
17311**Description**
17312
17313Sets the corner radius of the linear progress indicator.
17314
17315**Since**: 15
17316
17317
17318**Parameters**
17319
17320| Name| Description|
17321| -------- | -------- |
17322| option | Pointer to the **ProgressLinearStyleOption** instance. |
17323| strokeRadius | Corner radius of the progress indicator. The value range is [0, strokeWidth/2]. Default value: **strokeWidth/2**.|
17324
17325
17326### OH_ArkUI_ProgressLinearStyleOption_GetScanEffectEnabled
17327
17328```
17329bool OH_ArkUI_ProgressLinearStyleOption_GetScanEffectEnabled(ArkUI_ProgressLinearStyleOption* option)
17330```
17331**Description**
17332
17333Obtains the enabled status of the scan effect for the linear progress indicator.
17334
17335**Since**: 15
17336
17337**Parameters**
17338
17339| Name| Description|
17340| -------- | -------- |
17341| option | Pointer to the **ProgressLinearStyleOption** instance. |
17342
17343**Returns**
17344
17345Returns the enabled status of the scan effect.
17346
17347
17348### OH_ArkUI_ProgressLinearStyleOption_GetSmoothEffectEnabled
17349
17350```
17351bool OH_ArkUI_ProgressLinearStyleOption_GetSmoothEffectEnabled(ArkUI_ProgressLinearStyleOption* option)
17352```
17353**Description**
17354
17355Obtains the enabled status of the smooth progress effect for the linear progress indicator.
17356
17357**Since**: 15
17358
17359**Parameters**
17360
17361| Name| Description|
17362| -------- | -------- |
17363| option | Pointer to the **ProgressLinearStyleOption** instance. |
17364
17365**Returns**
17366
17367Returns the enabled status of the smooth progress effect.
17368
17369
17370### OH_ArkUI_ProgressLinearStyleOption_GetStrokeWidth
17371
17372```
17373float OH_ArkUI_ProgressLinearStyleOption_GetStrokeWidth(ArkUI_ProgressLinearStyleOption* option)
17374```
17375**Description**
17376
17377Obtains the stroke width of the linear progress indicator.
17378
17379**Since**: 15
17380
17381**Parameters**
17382
17383| Name| Description|
17384| -------- | -------- |
17385| option | Pointer to the **ProgressLinearStyleOption** instance. |
17386
17387**Returns**
17388
17389Returns the stroke width of the progress indicator.
17390
17391
17392### OH_ArkUI_ProgressLinearStyleOption_GetStrokeRadius
17393
17394```
17395float OH_ArkUI_ProgressLinearStyleOption_GetStrokeRadius(ArkUI_ProgressLinearStyleOption* option)
17396```
17397**Description**
17398
17399Obtains the corner radius of the linear progress indicator.
17400
17401**Since**: 15
17402
17403**Parameters**
17404
17405| Name| Description|
17406| -------- | -------- |
17407| option | Pointer to the **ProgressLinearStyleOption** instance. |
17408
17409**Returns**
17410
17411Returns the corner radius of the progress indicator.
17412
17413
17414### OH_ArkUI_DragEvent_StartDataLoading()
17415
17416```
17417int32_t OH_ArkUI_DragEvent_StartDataLoading (ArkUI_DragEvent* event, OH_UdmfGetDataParams* options, char* key, unsigned int keyLen)
17418```
17419**Description**
17420
17421Asynchronously obtains drag data.
17422
17423**Since**: 15
17424
17425**Parameters**
17426
17427| Name| Description|
17428| -------- | -------- |
17429| event | Pointer to an **ArkUI_DragEvent** object. |
17430| options | Parameters for obtaining data from UDMF. |
17431| key | Unique ID of data, which is returned in the callback parameters when the event is triggered. |
17432| keyLen | Length of **key**, which must be greater than or equal to the value of **UDMF_KEY_BUFFER_LEN**. |
17433
17434**Returns**
17435
17436Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17437Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
17438
17439
17440### OH_ArkUI_CancelDataLoading()
17441
17442```
17443int32_t OH_ArkUI_CancelDataLoading (ArkUI_ContextHandle uiContext, const char* key)
17444```
17445**Description**
17446
17447Cancels the asynchronous obtaining of drag data.
17448
17449**Since**: 15
17450
17451**Parameters**
17452
17453| Name| Description|
17454| -------- | -------- |
17455| uiContext | UI context object used to bind the instance.|
17456| key | Unique ID of data.|
17457
17458**Returns**
17459
17460Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17461Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
17462
17463
17464### OH_ArkUI_DisableDropDataPrefetchOnNode()
17465
17466```
17467int32_t OH_ArkUI_DisableDropDataPrefetchOnNode (ArkUI_NodeHandle node, bool disable)
17468```
17469**Description**
17470
17471Sets whether to enable data prefetching for drag and drop operations on a specified node.
17472
17473**Since**: 15
17474
17475**Parameters**
17476
17477| Name| Description|
17478| -------- | -------- |
17479| node | Specified node. |
17480| disable | Whether to enable data prefetching for the drop and drop operation. The value **true** means to disable data prefetching, and **false** means to enable data prefetching. The default value is **false**. To use **OH_ArkUI_DragEvent_StartDataLoading** to obtain data, set this parameter to **true**.|
17481
17482
17483**Returns**
17484
17485Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17486Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
17487
17488### OH_ArkUI_CrossLanguageOption_Create()
17489
17490```
17491ArkUI_CrossLanguageOption* OH_ArkUI_CrossLanguageOption_Create(void)
17492```
17493**Description**
17494
17495Creates an instance of the cross-language configuration option.
17496
17497**Since**: 15
17498
17499**Returns**
17500
17501Returns the pointer to the **ArkUI_CrossLanguageOption** instance created. If a null pointer is returned, creation failed, possibly due to insufficient memory.
17502
17503
17504### OH_ArkUI_CrossLanguageOption_Destroy()
17505
17506```
17507void OH_ArkUI_CrossLanguageOption_Destroy(ArkUI_CrossLanguageOption* option)
17508```
17509**Description**
17510
17511Destroys an instance of the cross-language configuration option.
17512
17513**Since**: 15
17514
17515**Parameters**
17516
17517| Name| Description|
17518| -------- | -------- |
17519| option | Cross-language configuration option instance to be destroyed. |
17520
17521### OH_ArkUI_CrossLanguageOption_SetAttributeSettingStatus()
17522
17523```
17524void OH_ArkUI_CrossLanguageOption_SetAttributeSettingStatus(ArkUI_CrossLanguageOption* option, bool enable)
17525```
17526**Description**
17527
17528Sets whether cross-language attribute setting is allowed in the configuration option.
17529
17530**Since**: 15
17531
17532**Parameters**
17533
17534| Name| Description|
17535| -------- | -------- |
17536| option | Pointer to the cross-language configuration option instance. |
17537| enable | Whether cross-language attribute setting is allowed. The default value is **false**. |
17538
17539### OH_ArkUI_CrossLanguageOption_GetAttributeSettingStatus()
17540
17541```
17542bool OH_ArkUI_CrossLanguageOption_GetAttributeSettingStatus(ArkUI_CrossLanguageOption* option)
17543```
17544**Description**
17545
17546Checks whether cross-language attribute setting is allowed in the configuration option.
17547
17548**Since**: 15
17549
17550**Parameters**
17551
17552| Name| Description|
17553| -------- | -------- |
17554| option | Pointer to the cross-language configuration option instance. |
17555
17556**Returns**
17557
17558Whether cross-language attribute setting is allowed.
17559
17560### OH_ArkUI_VisibleAreaEventOptions_Create()
17561
17562```
17563ArkUI_VisibleAreaEventOptions* OH_ArkUI_VisibleAreaEventOptions_Create()
17564```
17565**Description**
17566
17567Creates an instance of visible area change event parameters.
17568
17569**Since**: 18
17570
17571**Returns**
17572Returns the created instance of visible area change event parameters.
17573
17574### OH_ArkUI_VisibleAreaEventOptions_Dispose()
17575
17576```
17577void OH_ArkUI_VisibleAreaEventOptions_Dispose(ArkUI_VisibleAreaEventOptions* option)
17578```
17579**Description**
17580
17581Disposes of an instance of visible area change event parameters.
17582
17583**Since**: 18
17584
17585**Parameters**
17586
17587| Name| Description|
17588| -------- | -------- |
17589| option | Instance of visible area change event parameters to be destroyed. |
17590
17591### OH_ArkUI_VisibleAreaEventOptions_SetRatios()
17592
17593```
17594int32_t OH_ArkUI_VisibleAreaEventOptions_SetRatios(ArkUI_VisibleAreaEventOptions* option, float* value, int32_t size)
17595```
17596**Description**
17597
17598Sets the threshold ratios for visible area changes.
17599
17600**Since**: 18
17601
17602**Parameters**
17603
17604| Name| Description|
17605| -------- | -------- |
17606| option | Pointer to the instance of visible area change event parameters.|
17607| value | Array of threshold ratios.|
17608| size | Size of the array of threshold ratios.|
17609
17610**Returns**
17611
17612Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17613Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
17614
17615### OH_ArkUI_VisibleAreaEventOptions_SetExpectedUpdateInterval()
17616
17617```
17618int32_t OH_ArkUI_VisibleAreaEventOptions_SetExpectedUpdateInterval(
17619    ArkUI_VisibleAreaEventOptions *option, int32_t value)
17620```
17621**Description**
17622
17623Sets the expected update interval for visible area changes.
17624
17625**Since**: 18
17626
17627**Parameters**
17628
17629| Name| Description|
17630| -------- | -------- |
17631| option | Pointer to the instance of visible area change event parameters.|
17632| value | Expected update interval, in ms.   |
17633
17634**Returns**
17635
17636Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17637Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
17638
17639### OH_ArkUI_VisibleAreaEventOptions_GetRatios()
17640
17641```
17642int32_t OH_ArkUI_VisibleAreaEventOptions_GetRatios(ArkUI_VisibleAreaEventOptions* option, float* value, int32_t* size)
17643```
17644**Description**
17645
17646 Obtains the threshold ratios for visible area changes.
17647
17648**Since**: 18
17649
17650**Parameters**
17651
17652| Name| Description|
17653| -------- | -------- |
17654| option | Pointer to the instance of visible area change event parameters.|
17655| value | Array of threshold ratios.|
17656| size | Size of the array of threshold ratios.|
17657
17658**Returns**
17659
17660Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17661Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
17662Returns **ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR** if the provided buffer size is insufficient.
17663
17664### OH_ArkUI_VisibleAreaEventOptions_GetExpectedUpdateInterval()
17665
17666```
17667int32_t OH_ArkUI_VisibleAreaEventOptions_GetExpectedUpdateInterval(ArkUI_VisibleAreaEventOptions* option)
17668```
17669**Description**
17670
17671 Obtains the expected update interval for visible area changes.
17672
17673**Since**: 18
17674
17675**Parameters**
17676
17677| Name| Description|
17678| -------- | -------- |
17679| option | Pointer to the instance of visible area change event parameters.|
17680
17681**Returns**
17682Returns the expected update interval, in ms.
17683
17684### OH_ArkUI_NodeUtils_GetPositionToParent()
17685
17686```
17687int32_t OH_ArkUI_NodeUtils_GetPositionToParent (ArkUI_NodeHandle node, ArkUI_IntOffset* globalOffset )
17688```
17689**Description**
17690
17691Obtains the offset of a specific node relative to its parent node.
17692
17693**Since**: 15
17694
17695**Parameters**
17696
17697| Name| Description|
17698| -------- | -------- |
17699| node | **ArkUI_NodeHandle** pointer. |
17700| globalOffset | Offset of the target node relative to its parent node, in px. |
17701
17702**Returns**
17703
17704Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17705Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
17706
17707### OH_ArkUI_GetGestureParam_DirectMask()
17708
17709```
17710int32_t OH_ArkUI_GetGestureParam_DirectMask(ArkUI_GestureRecognizer* recognizer, ArkUI_GestureDirectionMask* directMask)
17711```
17712**Description**
17713
17714Obtains the swipe direction of a gesture recognizer.
17715
17716**Since**: 18
17717
17718**Parameters**
17719
17720| Name| Description|
17721| -------- | -------- |
17722| recognizer | Pointer to the gesture recognizer. |
17723| directMask | Swipe direction of the gesture recognizer. |
17724
17725**Returns**
17726
17727Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17728Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
17729
17730### OH_ArkUI_GetGestureParam_FingerCount()
17731
17732```
17733int32_t OH_ArkUI_GetGestureParam_FingerCount(ArkUI_GestureRecognizer* recognizer, int* finger)
17734```
17735**Description**
17736
17737Obtains the number of fingers used by a gesture recognizer.
17738
17739**Since**: 18
17740
17741**Parameters**
17742
17743| Name| Description|
17744| -------- | -------- |
17745| recognizer | Pointer to the gesture recognizer. |
17746| finger | Number of fingers used by the gesture recognizer. |
17747
17748**Returns**
17749
17750Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17751Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
17752
17753### OH_ArkUI_GetGestureParam_limitFingerCount()
17754
17755```
17756int32_t OH_ArkUI_GetGestureParam_limitFingerCount(ArkUI_GestureRecognizer* recognizer, bool* isLimited)
17757```
17758**Description**
17759
17760Checks whether a gesture recognizer has a finger count limit.
17761
17762**Since**: 18
17763
17764**Parameters**
17765
17766| Name| Description|
17767| -------- | -------- |
17768| recognizer | Pointer to the gesture recognizer. |
17769| isLimited | Whether the gesture recognizer has a finger count limit. |
17770
17771**Returns**
17772
17773Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17774Returns **ARKUI_ERROR_CODE_PARAM_INVALID** if a parameter error occurs.
17775
17776### OH_ArkUI_GetGestureParam_repeat()
17777
17778```
17779int32_t OH_ArkUI_GetGestureParam_repeat(ArkUI_GestureRecognizer* recognizer, bool* isRepeat)
17780```
17781**Description**
17782
17783Checks whether a gesture recognizer supports repeated event callbacks.
17784
17785**Since**: 18
17786
17787**Parameters**
17788
17789| Name| Description|
17790| -------- | -------- |
17791| recognizer | Pointer to the gesture recognizer. |
17792| isRepeat | Whether the gesture recognizer supports repeated event callbacks. |
17793
17794**Returns**
17795
17796Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17797Returns **ARKUI_ERROR_CODE_RECOGNIZER_TYPE_NOT_SUPPORTED** if the gesture recognizer type is not supported.
17798
17799### OH_ArkUI_GetGestureParam_distance()
17800
17801```
17802int32_t OH_ArkUI_GetGestureParam_distance(ArkUI_GestureRecognizer* recognizer, double* distance)
17803```
17804**Description**
17805
17806Obtains the allowed movement distance range for a gesture recognizer.
17807
17808**Since**: 18
17809
17810**Parameters**
17811
17812| Name| Description|
17813| -------- | -------- |
17814| recognizer | Pointer to the gesture recognizer. |
17815| distance | Allowed movement distance range of the gesture recognizer. |
17816
17817**Returns**
17818
17819Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17820Returns **ARKUI_ERROR_CODE_RECOGNIZER_TYPE_NOT_SUPPORTED** if the gesture recognizer type is not supported.
17821
17822### OH_ArkUI_GetGestureParam_speed()
17823
17824```
17825int32_t OH_ArkUI_GetGestureParam_speed(ArkUI_GestureRecognizer* recognizer, double* speed)
17826```
17827**Description**
17828
17829Obtains the minimum swipe speed recognized by a gesture recognizer.
17830
17831**Since**: 18
17832
17833**Parameters**
17834
17835| Name| Description|
17836| -------- | -------- |
17837| recognizer | Pointer to the gesture recognizer. |
17838| speed | Minimum swipe speed recognized by the gesture recognizer. |
17839
17840**Returns**
17841
17842Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17843Returns **ARKUI_ERROR_CODE_RECOGNIZER_TYPE_NOT_SUPPORTED** if the gesture recognizer type is not supported.
17844
17845### OH_ArkUI_GetGestureParam_duration()
17846
17847```
17848int32_t OH_ArkUI_GetGestureParam_duration(ArkUI_GestureRecognizer* recognizer, int* duration)
17849```
17850**Description**
17851
17852Obtains the minimum duration required to trigger a long press by a gesture recognizer.
17853
17854**Since**: 18
17855
17856**Parameters**
17857
17858| Name| Description|
17859| -------- | -------- |
17860| recognizer | Pointer to the gesture recognizer. |
17861| duration | Minimum duration for a long press. |
17862
17863**Returns**
17864
17865Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17866Returns **ARKUI_ERROR_CODE_RECOGNIZER_TYPE_NOT_SUPPORTED** if the gesture recognizer type is not supported.
17867
17868### OH_ArkUI_GetGestureParam_angle()
17869
17870```
17871int32_t OH_ArkUI_GetGestureParam_angle(ArkUI_GestureRecognizer* recognizer, double* angle)
17872```
17873**Description**
17874
17875Obtains the minimum angle change required for a rotation gesture to be recognized by a gesture recognizer.
17876
17877**Since**: 18
17878
17879**Parameters**
17880
17881| Name| Description|
17882| -------- | -------- |
17883| recognizer | Pointer to the gesture recognizer. |
17884| angle | Minimum angle change. |
17885
17886**Returns**
17887
17888Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17889Returns **ARKUI_ERROR_CODE_RECOGNIZER_TYPE_NOT_SUPPORTED** if the gesture recognizer type is not supported.
17890
17891### OH_ArkUI_GetGestureParam_distanceThreshold()
17892
17893```
17894int32_t OH_ArkUI_GetGestureParam_distanceThreshold(ArkUI_GestureRecognizer* recognizer, double* distanceThreshold)
17895```
17896**Description**
17897
17898Obtains the movement threshold for gestures to be recognized by a gesture recognizer.
17899
17900**Since**: 18
17901
17902**Parameters**
17903
17904| Name| Description|
17905| -------- | -------- |
17906| recognizer | Pointer to the gesture recognizer. |
17907| distanceThreshold | Gesture movement threshold of the gesture recognizer. |
17908
17909**Returns**
17910
17911Returns **ARKUI_ERROR_CODE_NO_ERROR** if the operation is successful.
17912Returns **ARKUI_ERROR_CODE_RECOGNIZER_TYPE_NOT_SUPPORTED** if the gesture recognizer type is not supported.
17913
17914### OH_ArkUI_TextPickerRangeContentArray_Create()
17915
17916```
17917ArkUI_TextPickerRangeContentArray* OH_ArkUI_TextPickerRangeContentArray_Create(int32_t length)
17918```
17919**Description**
17920
17921Creates a **TextPickerRangeContent** array object.
17922
17923**Since**: 18
17924
17925**Parameters**
17926
17927| Name| Description|
17928| -------- | -------- |
17929| length | Length of the **TextPickerRangeContent** array. |
17930
17931**Returns**
17932
17933Returns a pointer to an empty **TextPickerRangeContent** array.
17934
17935### OH_ArkUI_TextPickerRangeArray_SetIconAtIndex()
17936
17937```
17938void OH_ArkUI_TextPickerRangeArray_SetIconAtIndex(ArkUI_TextPickerRangeContentArray* handle,char* icon,int32_t index);
17939```
17940**Description**
17941
17942 Sets the icon data at the specified position in the **TextPickerRangeContent** array.
17943
17944**Since**: 18
17945
17946**Parameters**
17947
17948| Name| Description|
17949| -------- | -------- |
17950| handle | Pointer to the **TextPickerRangeContent** array.|
17951| icon | Pointer to the icon image address.|
17952| index | Position in the array, starting from 0.|
17953
17954
17955### OH_ArkUI_TextPickerRangeContentArray_SetTextAtIndex()
17956
17957```
17958void OH_ArkUI_TextPickerRangeContentArray_SetTextAtIndex(ArkUI_TextPickerRangeContentArray* handle,char* text,int32_t index);
17959```
17960**Description**
17961
17962 Sets the text data at the specified position in the **TextPickerRangeContent** array.
17963
17964**Since**: 18
17965
17966**Parameters**
17967
17968| Name| Description|
17969| -------- | -------- |
17970| handle | Pointer to the **TextPickerRangeContent** array.|
17971| text | Pointer to the text content.|
17972| index | Position in the array, starting from 0.|
17973
17974
17975### OH_ArkUI_TextPickerRangeContentArray_Destroy()
17976
17977```
17978void OH_ArkUI_TextPickerRangeContentArray_Destroy(ArkUI_TextPickerRangeContentArray* handle);
17979```
17980**Description**
17981
17982 Destroys a **TextPickerRangeContent** array object.
17983
17984**Since**: 18
17985
17986**Parameters**
17987
17988| Name| Description|
17989| -------- | -------- |
17990| handle | Pointer to the **TextPickerRangeContent** array.|
17991
17992
17993### OH_ArkUI_TextCascadePickerRangeContentArray_Create()
17994
17995```
17996ArkUI_TextCascadePickerRangeContentArray* OH_ArkUI_TextCascadePickerRangeContentArray_Create(int32_t length);
17997```
17998**Description**
17999
18000Creates a **TextCascadePickerRangeContent** array object.
18001
18002**Since**: 18
18003
18004**Parameters**
18005
18006| Name| Description|
18007| -------- | -------- |
18008| length | Length of the **TextPickerRangeContent** array.|
18009
18010**Returns**
18011
18012Returns a pointer to an empty **TextCascadePickerRangeContent** array.
18013
18014### OH_ArkUI_TextCascadePickerRangeContentArray_SetTextAtIndex()
18015
18016```
18017void OH_ArkUI_TextCascadePickerRangeContentArray_SetTextAtIndex(ArkUI_TextCascadePickerRangeContentArray* handle,char* text,int32_t index);
18018```
18019**Description**
18020
18021 Sets the text data at the specified position in the **TextCascadePickerRangeContent** array.
18022
18023**Since**: 18
18024
18025**Parameters**
18026
18027| Name| Description|
18028| -------- | -------- |
18029| handle | Pointer to the **TextCascadePickerRangeContent** array.|
18030| text | Pointer to the text content.|
18031| index | Position in the array, starting from 0.|
18032
18033
18034### OH_ArkUI_TextCascadePickerRangeContentArray_setChildAtIndex()
18035
18036```
18037void OH_ArkUI_TextCascadePickerRangeContentArray_setChildAtIndex(ArkUI_TextCascadePickerRangeContentArray* handle,ArkUI_TextCascadePickerRangeContentArray* child,int32_t index);
18038```
18039**Description**
18040
18041 Sets the child data at the specified position in the **TextCascadePickerRangeContent** array.
18042
18043**Since**: 18
18044
18045**Parameters**
18046
18047| Name| Description|
18048| -------- | -------- |
18049| handle | Pointer to the **TextCascadePickerRangeContent** array.|
18050| child | Pointer to the child node array.|
18051| index | Position in the array, starting from 0.|
18052
18053
18054### OH_ArkUI_TextCascadePickerRangeContentArray_Destroy()
18055
18056```
18057void OH_ArkUI_TextCascadePickerRangeContentArray_Destroy(ArkUI_TextCascadePickerRangeContentArray* handle);
18058```
18059**Description**
18060
18061 Destroys a **TextCascadePickerRangeContent** array object.
18062
18063**Since**: 18
18064
18065**Parameters**
18066
18067| Name| Description|
18068| -------- | -------- |
18069| handle | Pointer to the **TextCascadePickerRangeContent** array.|
18070