ArkUI_NativeModule

Overview

Provides drag and drop APIs of ArkUI on the native side.

Provides the general key event APIs of ArkUI on the native side.

Provides the APIs of ArkUI to register gesture callbacks on the native side.

Provides animation callbacks of ArkUI on the native side.

Provides UI capabilities of ArkUI on the native side, such as UI component creation and destruction, tree node operations, attribute setting, and event listening.

Since: 12

Summary

Files

Name Description
drag_and_drop.h Declares the APIs of NativeDrag.
drawable_descriptor.h Declares the APIs of NativeDrawableDescriptor.
native_animate.h Declares a set of animation APIs of ArkUI on the native side.
native_dialog.h Declares a set of custom dialog box APIs of ArkUI on the native side.
native_gesture.h Declares the APIs of NativeGesture.
native_interface.h Declares a unified entry for the native module APIs.
native_key_event.h Declares the APIs of NativeKeyEvent.
native_node.h Declares the APIs of NativeNode.
native_node_napi.h Declares the functions used to convert FrameNodes on the ArkTS side into NodeHandles.
native_type.h Defines the common types for the native module.
styled_string.h Declares styled string APIs of ArkUI on the native side.

Structs

Name Description
struct ArkUI_ExpectedFrameRateRange Defines a struct for the expected frame rate range of the animation.
struct ArkUI_AnimateCompleteCallback Defines a struct for the callback type for when the animation playback is complete.
struct ArkUI_NativeAnimateAPI_1 Defines a struct for the animation APIs of ArkUI on the native side.
struct ArkUI_NativeDialogAPI_1 Defines a struct for the custom dialog box APIs on the native side.
struct ArkUI_NativeGestureAPI_1 Defines a struct for the gesture APIs.
struct ArkUI_AttributeItem Defines the general input parameter structure of the setAttribute function.
struct ArkUI_NodeComponentEvent Defines a struct for the parameter type of the component callback event.
struct ArkUI_StringAsyncEvent Defines the string type parameter used by the component callback event.
struct ArkUI_NativeNodeAPI_1 Defines a struct for node APIs of ArkUI on the native side.
struct ArkUI_ContextCallback Defines event callback.
union ArkUI_NumberValue Provides the number types of ArkUI in the native code.
struct ARKUI_TextPickerRangeContent Defines the input structure of the single-column text picker with image resources.
struct ARKUI_TextPickerCascadeRangeContent Defines the input structure of the interconnected multi-column text picker.
struct ArkUI_ColorStop Defines a gradient color stop.
struct ArkUI_Rect Defines a mask area.
struct ArkUI_IntSize Describes the width and height of a component.
struct ArkUI_IntOffset Describes the position of a component.
struct ArkUI_Margin Describes the margins of a component.
struct ArkUI_TranslationOptions Defines the translation options for component transition.
struct ArkUI_ScaleOptions Defines the scaling options for component transition.
struct ArkUI_RotationOptions Defines the rotation options for component transition.

Macros

Name Description
OH_ArkUI_GetModuleInterface(nativeAPIVariantKind, structType, structPtr) Obtains the macro function corresponding to a struct pointer based on the struct type.
MAX_NODE_SCOPE_NUM 1000
MAX_COMPONENT_EVENT_ARG_NUM 12

Types

Name Description
typedef struct ArkUI_NodeEvent ArkUI_NodeEvent Defines a struct for a component event.
typedef struct ArkUI_Context ArkUI_Context Defines a struct for a UI context object.
typedef struct ArkUI_Context * ArkUI_ContextHandle Defines a struct for the handle to the ArkUI native UI context.
typedef struct ArkUI_DragEvent ArkUI_DragEvent Defines a struct for a drag event.
typedef struct ArkUI_DragPreviewOption ArkUI_DragPreviewOption Defines a struct for custom drag preview options.
typedef struct ArkUI_DragAction ArkUI_DragAction Defines a struct for a drag action.
typedef struct ArkUI_DragAndDropInfo ArkUI_DragAndDropInfo Defines a struct for drag and drop information returned through a drag status listener.
typedef struct OH_UdmfData OH_UdmfData Defines a struct for UDMF unified data.
typedef struct OH_PixelmapNative OH_PixelmapNative Defines the Pixelmap struct, which is used to perform operations related to a pixel map.
typedef struct ArkUI_DrawableDescriptor ArkUI_DrawableDescriptor Defines a struct for the DrawableDescriptor object.
typedef struct OH_PixelmapNative * OH_PixelmapNativeHandle Defines a struct for the pointer to an OH_PixelmapNative object.
typedef struct ArkUI_AnimateOption ArkUI_AnimateOption Defines a struct for the animation configuration.
typedef struct ArkUI_Curve * ArkUI_CurveHandle Defines a struct for the pointer to an interpolation curve.
typedef struct ArkUI_KeyframeAnimateOption ArkUI_KeyframeAnimateOption Defines a struct for the keyframe animation parameter object.
typedef struct ArkUI_AnimatorOption ArkUI_AnimatorOption Defines the animator parameter object.
typedef struct ArkUI_Animator * ArkUI_AnimatorHandle Defines a struct for the pointer to an animator object.
typedef struct ArkUI_TransitionEffect ArkUI_TransitionEffect Defines a struct for the transition effect.
typedef bool(* ArkUI_OnWillDismissEvent) (int32_t reason) Defines a pointer to the callback invoked when the dialog box is closed.
typedef struct ArkUI_DialogDismissEvent ArkUI_DialogDismissEvent Defines a struct for a dialog box dismiss event.
typedef uint32_t ArkUI_GestureEventActionTypeMask Defines a set of gesture event types.
typedef uint32_t ArkUI_GestureDirectionMask Defines a set of gesture directions.
typedef ArkUI_GestureRecognizer * ArkUI_GestureRecognizerHandle Defines the gesture recognizer handle.
typedef ArkUI_GestureRecognizerHandle * ArkUI_GestureRecognizerHandleArray Defines the gesture recognizer handle array.
typedef struct ArkUI_GestureEventTargetInfo ArkUI_GestureEventTargetInfo Defines a struct for a GestureEventTargetInfo object that provides information about a gesture event target.
typedef struct ArkUI_ParallelInnerGestureEvent ArkUI_ParallelInnerGestureEvent Defines a parallel internal gesture event.
typedef void(* ArkUI_GestureRecognizerDestructNotifyCallback) (ArkUI_GestureRecognizer *recognizer, void *userData) Defines a callback function for notifying gesture recognizer destruction.
typedef struct ArkUI_NodeEvent ArkUI_NodeEvent Defines the common structure of a component event.
typedef struct ArkUI_NodeCustomEvent ArkUI_NodeCustomEvent Defines the common structure of a custom component event.
typedef struct ArkUI_NodeAdapter * ArkUI_NodeAdapterHandle Defines the component adapter, which is used for lazy loading of elements of scrollable components.
typedef struct ArkUI_NodeAdapterEvent ArkUI_NodeAdapterEvent Defines the component adapter event.
typedef struct ArkUI_NodeContentEvent ArkUI_NodeContentEvent Defines the common structure type of a NodeContent event.
typedef void(* ArkUI_NodeContentCallback) (ArkUI_NodeContentEvent *event) Defines the callback for the NodeContent event.
typedef struct ArkUI_LayoutConstraint ArkUI_LayoutConstraint Defines the size constraints of a component during component layout.
typedef struct ArkUI_DrawContext ArkUI_DrawContext Defines the component drawing context.
typedef struct ArkUI_Node * ArkUI_NodeHandle Defines the pointer to the ArkUI native component object.
typedef struct ArkUI_NativeDialog * ArkUI_NativeDialogHandle Defines the handle to the custom dialog box controller of ArkUI on the native side.
typedef struct ArkUI_WaterFlowSectionOption ArkUI_WaterFlowSectionOption Defines the water flow section configuration.
typedef struct ArkUI_ListItemSwipeActionItem ArkUI_ListItemSwipeActionItem Defines the item configuration for ListItemSwipeActionOption.
typedef struct ArkUI_ListItemSwipeActionOption ArkUI_ListItemSwipeActionOption Defines the configuration for ListItemSwipeActionOption.
typedef struct ArkUI_Context * ArkUI_ContextHandle Defines the handle to the ArkUI native UI context.
typedef struct ArkUI_NodeContent * ArkUI_NodeContentHandle Defines the handle to the ArkUI NodeContent instance on the native side.
typedef struct ArkUI_AlignmentRuleOption ArkUI_AlignmentRuleOption Defines the alignment rule in the relative container.
typedef struct ArkUI_GuidelineOption ArkUI_GuidelineOption Defines the ID, direction, and position of a guideline.
typedef struct ArkUI_BarrierOption ArkUI_BarrierOption Defines the ID, direction, and referenced component of a barrier.
typedef struct ArkUI_ImageAnimatorFrameInfo ArkUI_ImageAnimatorFrameInfo Defines the image frame information.
typedef struct ArkUI_ListChildrenMainSize ArkUI_ListChildrenMainSize Defines the ChildrenMainSize information of the List component.
typedef struct ArkUI_AccessibilityState ArkUI_AccessibilityState Defines a struct for the component accessibility state.
typedef struct ArkUI_AccessibilityValue ArkUI_AccessibilityValue Defines a struct for the component accessibility value.
typedef struct ArkUI_SystemFontStyleEvent ArkUI_SystemFontStyleEvent Defines a struct for the system font style event.
typedef struct ArkUI_CustomSpanMeasureInfo ArkUI_CustomSpanMeasureInfo Defines a struct for the measurement information of a custom span.
typedef struct ArkUI_CustomSpanMetrics ArkUI_CustomSpanMetrics Defines a struct for the measurement metrics of a custom span.
typedef struct ArkUI_CustomSpanDrawInfo ArkUI_CustomSpanDrawInfo Defines a struct for the drawing information of a custom span.
typedef struct ArkUI_SwiperIndicator ArkUI_SwiperIndicator Defines the navigation point indicator style of the Swiper component.
typedef struct ArkUI_StyledString_Descriptor ArkUI_StyledString_Descriptor Defines a struct for the styled string descriptor object supported by the text component.
typedef struct ArkUI_StyledString ArkUI_StyledString Defines a struct for the styled string object supported by the text component.

Enums

Name Description
ArkUI_DragResult { ARKUI_DRAG_RESULT_SUCCESSFUL, ARKUI_DRAG_RESULT_FAILED, ARKUI_DRAG_RESULT_CANCELED } Defines an enum for drag results, which are set by the data receiver and transferred by the system to the drag source so that the drag source is aware of the data processing result of the receiver.
ArkUI_DropProposal { ARKUI_DROP_PROPOSAL_COPY, ARKUI_DROP_PROPOSAL_MOVE } Defines an enum for data processing modes used when data is dropped, which affects the display of the badge.
ArkUI_PreDragStatus {
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,
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
}
Defines an enum for interaction states prior to a drop and drop operation.
ArkUI_DragPreviewScaleMode { ARKUI_DRAG_PREVIEW_SCALE_AUTO, ARKUI_DRAG_PREVIEW_SCALE_DISABLED } Defines an enum for drag preview scale modes.
ArkUI_DragStatus { ArkUI_DRAG_STATUS_UNKNOWN, ArkUI_DRAG_STATUS_STARTED, ArkUI_DRAG_STATUS_ENDED } Enumerates dragging states.
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.
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.
ArkUI_GesturePriority { NORMAL = 0, PRIORITY = 1, PARALLEL = 2 } Enumerates gesture event modes.
ArkUI_GroupGestureMode { SEQUENTIAL_GROUP = 0, PARALLEL_GROUP = 1, EXCLUSIVE_GROUP = 2 } Enumerates gesture group modes.
ArkUI_GestureDirection {
GESTURE_DIRECTION_ALL = 0b1111, GESTURE_DIRECTION_HORIZONTAL = 0b0011, GESTURE_DIRECTION_VERTICAL = 0b1100, GESTURE_DIRECTION_LEFT = 0b0001,
GESTURE_DIRECTION_RIGHT = 0b0010, GESTURE_DIRECTION_UP = 0b0100, GESTURE_DIRECTION_DOWN = 0b1000, GESTURE_DIRECTION_NONE = 0
}
Enumerates gesture directions.
ArkUI_GestureMask { NORMAL_GESTURE_MASK = 0, IGNORE_INTERNAL_GESTURE_MASK } Enumerates gesture masking modes.
ArkUI_GestureRecognizerType {
TAP_GESTURE = 0, LONG_PRESS_GESTURE, PAN_GESTURE, PINCH_GESTURE,
ROTATION_GESTURE, SWIPE_GESTURE, GROUP_GESTURE
}
Enumerates gesture recognizer types.
ArkUI_GestureInterruptResult { GESTURE_INTERRUPT_RESULT_CONTINUE = 0, GESTURE_INTERRUPT_RESULT_REJECT } Enumerates gesture interruption results.
ArkUI_GestureRecognizerState {
ARKUI_GESTURE_RECOGNIZER_STATE_REDAY = 0, ARKUI_GESTURE_RECOGNIZER_STATE_DETECTING = 1, ARKUI_GESTURE_RECOGNIZER_STATE_PENDING = 2, ARKUI_GESTURE_RECOGNIZER_STATE_BLOCKED = 3,
ARKUI_GESTURE_RECOGNIZER_STATE_SUCCESSFUL = 4, ARKUI_GESTURE_RECOGNIZER_STATE_FAILED = 5
}
Enumerates the gesture recognizer states.
ArkUI_NativeAPIVariantKind { ARKUI_NATIVE_NODE, ARKUI_NATIVE_DIALOG, ARKUI_NATIVE_GESTURE, ARKUI_NATIVE_ANIMATE } Defines the native API types.
ArkUI_KeyCode {
ARKUI_KEYCODE_UNKNOWN = -1, ARKUI_KEYCODE_FN = 0, ARKUI_KEYCODE_VOLUME_UP = 16, ARKUI_KEYCODE_VOLUME_DOWN = 17,
ARKUI_KEYCODE_POWER = 18, ARKUI_KEYCODE_CAMERA = 19, ARKUI_KEYCODE_VOLUME_MUTE = 22, ARKUI_KEYCODE_MUTE = 23,
ARKUI_KEYCODE_BRIGHTNESS_UP = 40, ARKUI_KEYCODE_BRIGHTNESS_DOWN = 41, ARKUI_KEYCODE_0 = 2000, ARKUI_KEYCODE_1 = 2001,
ARKUI_KEYCODE_2 = 2002, ARKUI_KEYCODE_3 = 2003, ARKUI_KEYCODE_4 = 2004, ARKUI_KEYCODE_5 = 2005,
ARKUI_KEYCODE_6 = 2006, ARKUI_KEYCODE_7 = 2007, ARKUI_KEYCODE_8 = 2008, ARKUI_KEYCODE_9 = 2009,
ARKUI_KEYCODE_STAR = 2010, ARKUI_KEYCODE_POUND = 2011, ARKUI_KEYCODE_DPAD_UP = 2012, ARKUI_KEYCODE_DPAD_DOWN = 2013,
ARKUI_KEYCODE_DPAD_LEFT = 2014, ARKUI_KEYCODE_DPAD_RIGHT = 2015, ARKUI_KEYCODE_DPAD_CENTER = 2016, ARKUI_KEYCODE_A = 2017,
ARKUI_KEYCODE_B = 2018, ARKUI_KEYCODE_C = 2019, ARKUI_KEYCODE_D = 2020, ARKUI_KEYCODE_E = 2021,
ARKUI_KEYCODE_F = 2022, ARKUI_KEYCODE_G = 2023, ARKUI_KEYCODE_H = 2024, ARKUI_KEYCODE_I = 2025,
ARKUI_KEYCODE_J = 2026, ARKUI_KEYCODE_K = 2027, ARKUI_KEYCODE_L = 2028, ARKUI_KEYCODE_M = 2029,
ARKUI_KEYCODE_N = 2030, ARKUI_KEYCODE_O = 2031, ARKUI_KEYCODE_P = 2032, ARKUI_KEYCODE_Q = 2033,
ARKUI_KEYCODE_R = 2034, ARKUI_KEYCODE_S = 2035, ARKUI_KEYCODE_T = 2036, ARKUI_KEYCODE_U = 2037,
ARKUI_KEYCODE_V = 2038, ARKUI_KEYCODE_W = 2039, ARKUI_KEYCODE_X = 2040, ARKUI_KEYCODE_Y = 2041,
ARKUI_KEYCODE_Z = 2042, ARKUI_KEYCODE_COMMA = 2043, ARKUI_KEYCODE_PERIOD = 2044, ARKUI_KEYCODE_ALT_LEFT = 2045,
ARKUI_KEYCODE_ALT_RIGHT = 2046, ARKUI_KEYCODE_SHIFT_LEFT = 2047, ARKUI_KEYCODE_SHIFT_RIGHT = 2048, ARKUI_KEYCODE_TAB = 2049,
ARKUI_KEYCODE_SPACE = 2050, ARKUI_KEYCODE_SYM = 2051, ARKUI_KEYCODE_EXPLORER = 2052, ARKUI_KEYCODE_ENVELOPE = 2053,
ARKUI_KEYCODE_ENTER = 2054, ARKUI_KEYCODE_DEL = 2055, ARKUI_KEYCODE_GRAVE = 2056, ARKUI_KEYCODE_MINUS = 2057,
ARKUI_KEYCODE_EQUALS = 2058, ARKUI_KEYCODE_LEFT_BRACKET = 2059, ARKUI_KEYCODE_RIGHT_BRACKET = 2060, ARKUI_KEYCODE_BACKSLASH = 2061,
ARKUI_KEYCODE_SEMICOLON = 2062, ARKUI_KEYCODE_APOSTROPHE = 2063, ARKUI_KEYCODE_SLASH = 2064, ARKUI_KEYCODE_AT = 2065,
ARKUI_KEYCODE_PLUS = 2066, ARKUI_KEYCODE_MENU = 2067, ARKUI_KEYCODE_PAGE_UP = 2068, ARKUI_KEYCODE_PAGE_DOWN = 2069,
ARKUI_KEYCODE_ESCAPE = 2070, ARKUI_KEYCODE_FORWARD_DEL = 2071, ARKUI_KEYCODE_CTRL_LEFT = 2072, ARKUI_KEYCODE_CTRL_RIGHT = 2073,
ARKUI_KEYCODE_CAPS_LOCK = 2074, ARKUI_KEYCODE_SCROLL_LOCK = 2075, ARKUI_KEYCODE_META_LEFT = 2076, ARKUI_KEYCODE_META_RIGHT = 2077,
ARKUI_KEYCODE_FUNCTION = 2078, ARKUI_KEYCODE_SYSRQ = 2079, ARKUI_KEYCODE_BREAK = 2080, ARKUI_KEYCODE_MOVE_HOME = 2081,
ARKUI_KEYCODE_MOVE_END = 2082, ARKUI_KEYCODE_INSERT = 2083, ARKUI_KEYCODE_FORWARD = 2084, ARKUI_KEYCODE_MEDIA_PLAY = 2085,
ARKUI_KEYCODE_MEDIA_PAUSE = 2086, ARKUI_KEYCODE_MEDIA_CLOSE = 2087, ARKUI_KEYCODE_MEDIA_EJECT = 2088, ARKUI_KEYCODE_MEDIA_RECORD = 2089,
ARKUI_KEYCODE_F1 = 2090, ARKUI_KEYCODE_F2 = 2091, ARKUI_KEYCODE_F3 = 2092, ARKUI_KEYCODE_F4 = 2093,
ARKUI_KEYCODE_F5 = 2094, ARKUI_KEYCODE_F6 = 2095, ARKUI_KEYCODE_F7 = 2096, ARKUI_KEYCODE_F8 = 2097,
ARKUI_KEYCODE_F9 = 2098, ARKUI_KEYCODE_F10 = 2099, ARKUI_KEYCODE_F11 = 2100, ARKUI_KEYCODE_F12 = 2101,
ARKUI_KEYCODE_NUM_LOCK = 2102, ARKUI_KEYCODE_NUMPAD_0 = 2103, ARKUI_KEYCODE_NUMPAD_1 = 2104, ARKUI_KEYCODE_NUMPAD_2 = 2105,
ARKUI_KEYCODE_NUMPAD_3 = 2106, ARKUI_KEYCODE_NUMPAD_4 = 2107, ARKUI_KEYCODE_NUMPAD_5 = 2108, ARKUI_KEYCODE_NUMPAD_6 = 2109,
ARKUI_KEYCODE_NUMPAD_7 = 2110, ARKUI_KEYCODE_NUMPAD_8 = 2111, ARKUI_KEYCODE_NUMPAD_9 = 2112, ARKUI_KEYCODE_NUMPAD_DIVIDE = 2113,
ARKUI_KEYCODE_NUMPAD_MULTIPLY = 2114, ARKUI_KEYCODE_NUMPAD_SUBTRACT = 2115, ARKUI_KEYCODE_NUMPAD_ADD = 2116, ARKUI_KEYCODE_NUMPAD_DOT = 2117,
ARKUI_KEYCODE_NUMPAD_COMMA = 2118, ARKUI_KEYCODE_NUMPAD_ENTER = 2119, ARKUI_KEYCODE_NUMPAD_EQUALS = 2120, ARKUI_KEYCODE_NUMPAD_LEFT_PAREN = 2121,
ARKUI_KEYCODE_NUMPAD_RIGHT_PAREN = 2122
}
Enumerates the key codes for key events.
ArkUI_KeyEventType {
ARKUI_KEY_EVENT_UNKNOWN = -1, ARKUI_KEY_EVENT_DOWN = 0, ARKUI_KEY_EVENT_UP = 1, ARKUI_KEY_EVENT_LONG_PRESS = 2,
ARKUI_KEY_EVENT_CLICK = 3
}
Enumerates the types of key events.
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.
ArkUI_KeyIntension {
ARKUI_KEY_INTENSION_UNKNOWN = -1, ARKUI_KEY_INTENSION_UP = 1, ARKUI_KEY_INTENSION_DOWN = 2, ARKUI_KEY_INTENSION_LEFT = 3,
ARKUI_KEY_INTENSION_RIGHT = 4, ARKUI_KEY_INTENSION_SELECT = 5, ARKUI_KEY_INTENSION_ESCAPE = 6, ARKUI_KEY_INTENSION_BACK = 7,
ARKUI_KEY_INTENSION_FORWARD = 8, ARKUI_KEY_INTENSION_MENU = 9, ARKUI_KEY_INTENSION_HOME = 10, ARKUI_KEY_INTENSION_PAGE_UP = 11,
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,
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,
ARKUI_KEY_INTENTION_MEDIA_MUTE = 106, ARKUI_KEY_INTENTION_VOLUME_UP = 107, ARKUI_KEY_INTENTION_VOLUME_DOWN = 108, ARKUI_KEY_INTENTION_CALL = 200,
ARKUI_KEY_INTENTION_CAMERA = 300
}
Enumerates the intentions corresponding to key events.
ArkUI_NodeType {
ARKUI_NODE_CUSTOM = 0, ARKUI_NODE_TEXT = 1, ARKUI_NODE_SPAN = 2, ARKUI_NODE_IMAGE_SPAN = 3,
ARKUI_NODE_IMAGE = 4, ARKUI_NODE_TOGGLE = 5, ARKUI_NODE_LOADING_PROGRESS = 6, ARKUI_NODE_TEXT_INPUT = 7,
ARKUI_NODE_TEXT_AREA = 8, ARKUI_NODE_BUTTON = 9, ARKUI_NODE_PROGRESS = 10, ARKUI_NODE_CHECKBOX = 11,
ARKUI_NODE_XCOMPONENT = 12, ARKUI_NODE_DATE_PICKER = 13, ARKUI_NODE_TIME_PICKER = 14, ARKUI_NODE_TEXT_PICKER = 15,
ARKUI_NODE_CALENDAR_PICKER = 16, ARKUI_NODE_SLIDER = 17, ARKUI_NODE_RADIO = 18, ARKUI_NODE_IMAGE_ANIMATOR = 19,
ARKUI_NODE_XCOMPONENT_TEXTURE = 20,
ARKUI_NODE_CHECKBOX_GROUP = 21,
ARKUI_NODE_STACK = MAX_NODE_SCOPE_NUM, ARKUI_NODE_SWIPER, ARKUI_NODE_SCROLL,
ARKUI_NODE_LIST, ARKUI_NODE_LIST_ITEM, ARKUI_NODE_LIST_ITEM_GROUP, ARKUI_NODE_COLUMN,
ARKUI_NODE_ROW, ARKUI_NODE_FLEX, ARKUI_NODE_REFRESH, ARKUI_NODE_WATER_FLOW,
ARKUI_NODE_FLOW_ITEM, ARKUI_NODE_RELATIVE_CONTAINER, ARKUI_NODE_GRID, ARKUI_NODE_GRID_ITEM,
ARKUI_NODE_CUSTOM_SPAN
}
Enumerates ArkUI component types that can be created on the native side.
ArkUI_NodeAttributeType {
NODE_WIDTH = 0, NODE_HEIGHT, NODE_BACKGROUND_COLOR, NODE_BACKGROUND_IMAGE,
NODE_PADDING, NODE_ID, NODE_ENABLED, NODE_MARGIN,
NODE_TRANSLATE, NODE_SCALE, NODE_ROTATE, NODE_BRIGHTNESS,
NODE_SATURATION, NODE_BLUR, NODE_LINEAR_GRADIENT, NODE_ALIGNMENT,
NODE_OPACITY, NODE_BORDER_WIDTH, NODE_BORDER_RADIUS, NODE_BORDER_COLOR,
NODE_BORDER_STYLE, NODE_Z_INDEX, NODE_VISIBILITY, NODE_CLIP,
NODE_CLIP_SHAPE, NODE_TRANSFORM, NODE_HIT_TEST_BEHAVIOR, NODE_POSITION,
NODE_SHADOW, NODE_CUSTOM_SHADOW, NODE_BACKGROUND_IMAGE_SIZE, NODE_BACKGROUND_IMAGE_SIZE_WITH_STYLE,
NODE_BACKGROUND_BLUR_STYLE, NODE_TRANSFORM_CENTER, NODE_OPACITY_TRANSITION, NODE_ROTATE_TRANSITION,
NODE_SCALE_TRANSITION, NODE_TRANSLATE_TRANSITION, NODE_MOVE_TRANSITION, NODE_FOCUSABLE,
NODE_DEFAULT_FOCUS, NODE_RESPONSE_REGION, NODE_OVERLAY, NODE_SWEEP_GRADIENT,
NODE_RADIAL_GRADIENT, NODE_MASK, NODE_BLEND_MODE, NODE_DIRECTION,
NODE_CONSTRAINT_SIZE, NODE_GRAY_SCALE, NODE_INVERT, NODE_SEPIA,
NODE_CONTRAST, NODE_FOREGROUND_COLOR, NODE_OFFSET, NODE_MARK_ANCHOR,
NODE_BACKGROUND_IMAGE_POSITION, NODE_ALIGN_RULES, NODE_ALIGN_SELF, NODE_FLEX_GROW,
NODE_FLEX_SHRINK, NODE_FLEX_BASIS, NODE_ACCESSIBILITY_GROUP, NODE_ACCESSIBILITY_TEXT,
NODE_ACCESSIBILITY_MODE, NODE_ACCESSIBILITY_DESCRIPTION, NODE_FOCUS_STATUS, NODE_ASPECT_RATIO,
NODE_LAYOUT_WEIGHT, NODE_DISPLAY_PRIORITY, NODE_OUTLINE_WIDTH, NODE_WIDTH_PERCENT,
NODE_HEIGHT_PERCENT, NODE_PADDING_PERCENT, NODE_MARGIN_PERCENT, NODE_GEOMETRY_TRANSITION,
NODE_RELATIVE_LAYOUT_CHAIN_MODE, NODE_RENDER_FIT, NODE_OUTLINE_COLOR, NODE_SIZE,
NODE_RENDER_GROUP, NODE_COLOR_BLEND, NODE_FOREGROUND_BLUR_STYLE, NODE_LAYOUT_RECT,
NODE_FOCUS_ON_TOUCH, NODE_BORDER_WIDTH_PERCENT, NODE_BORDER_RADIUS_PERCENT, NODE_ACCESSIBILITY_ID = 87,
NODE_ACCESSIBILITY_ACTIONS = 88, NODE_ACCESSIBILITY_ROLE = 89, NODE_ACCESSIBILITY_STATE = 90, NODE_ACCESSIBILITY_VALUE = 91,
NODE_EXPAND_SAFE_AREA = 92, NODE_VISIBLE_AREA_CHANGE_RATIO = 93, NODE_TRANSITION = 94, NODE_UNIQUE_ID = 95, NODE_FOCUS_BOX = 96,
NODE_CLICK_DISTANCE = 97, NODE_TAB_STOP = 98, NODE_TEXT_CONTENT = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT, NODE_FONT_COLOR,
NODE_FONT_SIZE, NODE_FONT_STYLE, NODE_FONT_WEIGHT, NODE_TEXT_LINE_HEIGHT,
NODE_TEXT_DECORATION, NODE_TEXT_CASE, NODE_TEXT_LETTER_SPACING, NODE_TEXT_MAX_LINES,
NODE_TEXT_ALIGN, NODE_TEXT_OVERFLOW, NODE_FONT_FAMILY, NODE_TEXT_COPY_OPTION,
NODE_TEXT_BASELINE_OFFSET, NODE_TEXT_TEXT_SHADOW, NODE_TEXT_MIN_FONT_SIZE, NODE_TEXT_MAX_FONT_SIZE,
NODE_TEXT_FONT, NODE_TEXT_HEIGHT_ADAPTIVE_POLICY, NODE_TEXT_INDENT, NODE_TEXT_WORD_BREAK,
NODE_TEXT_ELLIPSIS_MODE, NODE_TEXT_LINE_SPACING, NODE_FONT_FEATURE, NODE_TEXT_ENABLE_DATA_DETECTOR,
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,
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,
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,
NODE_IMAGE_OBJECT_FIT, NODE_IMAGE_INTERPOLATION, NODE_IMAGE_OBJECT_REPEAT, NODE_IMAGE_COLOR_FILTER,
NODE_IMAGE_AUTO_RESIZE, NODE_IMAGE_ALT, NODE_IMAGE_DRAGGABLE, NODE_IMAGE_RENDER_MODE,
NODE_IMAGE_FIT_ORIGINAL_SIZE, NODE_IMAGE_FILL_COLOR, NODE_IMAGE_RESIZABLE, NODE_TOGGLE_SELECTED_COLOR = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TOGGLE,
NODE_TOGGLE_SWITCH_POINT_COLOR, NODE_TOGGLE_VALUE, NODE_TOGGLE_UNSELECTED_COLOR, NODE_LOADING_PROGRESS_COLOR = MAX_NODE_SCOPE_NUM * ARKUI_NODE_LOADING_PROGRESS,
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,
NODE_TEXT_INPUT_CARET_STYLE, NODE_TEXT_INPUT_SHOW_UNDERLINE, NODE_TEXT_INPUT_MAX_LENGTH, NODE_TEXT_INPUT_ENTER_KEY_TYPEY_TYPE,
NODE_TEXT_INPUT_PLACEHOLDER_COLOR, NODE_TEXT_INPUT_PLACEHOLDER_FONT, NODE_TEXT_INPUT_ENABLE_KEYBOARD_ON_FOCUS, NODE_TEXT_INPUT_TYPE,
NODE_TEXT_INPUT_SELECTED_BACKGROUND_COLOR, NODE_TEXT_INPUT_SHOW_PASSWORD_ICON, NODE_TEXT_INPUT_EDITING, NODE_TEXT_INPUT_CANCEL_BUTTON,
NODE_TEXT_INPUT_TEXT_SELECTION, NODE_TEXT_INPUT_UNDERLINE_COLOR, NODE_TEXT_INPUT_ENABLE_AUTO_FILL, NODE_TEXT_INPUT_CONTENT_TYPE,
NODE_TEXT_INPUT_PASSWORD_RULES, NODE_TEXT_INPUT_SELECT_ALL, NODE_TEXT_INPUT_INPUT_FILTER, NODE_TEXT_INPUT_STYLE,
NODE_TEXT_INPUT_CARET_OFFSET, NODE_TEXT_INPUT_CONTENT_RECT, NODE_TEXT_INPUT_CONTENT_LINE_COUNT, NODE_TEXT_INPUT_SELECTION_MENU_HIDDEN,
NODE_TEXT_INPUT_BLUR_ON_SUBMIT, NODE_TEXT_INPUT_CUSTOM_KEYBOARD, NODE_TEXT_INPUT_WORD_BREAK, NODE_TEXT_INPUT_NUMBER_OF_LINES,
NODE_TEXT_INPUT_SHOW_KEYBOARD_ON_FOCUS, NODE_TEXT_AREA_PLACEHOLDER = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT_AREA, NODE_TEXT_AREA_TEXT, NODE_TEXT_AREA_MAX_LENGTH,
NODE_TEXT_AREA_PLACEHOLDER_COLOR, NODE_TEXT_AREA_PLACEHOLDER_FONT, NODE_TEXT_AREA_CARET_COLOR, NODE_TEXT_AREA_EDITING,
NODE_TEXT_AREA_TYPE, NODE_TEXT_AREA_SHOW_COUNTER, NODE_TEXT_AREA_SELECTION_MENU_HIDDEN, NODE_TEXT_AREA_BLUR_ON_SUBMIT,
NODE_TEXT_AREA_INPUT_FILTER, NODE_TEXT_AREA_SELECTED_BACKGROUND_COLOR, NODE_TEXT_AREA_ENTER_KEY_TYPE, NODE_TEXT_AREA_ENABLE_KEYBOARD_ON_FOCUS,
NODE_TEXT_AREA_CARET_OFFSET, NODE_TEXT_AREA_CONTENT_RECT, NODE_TEXT_AREA_CONTENT_LINE_COUNT, NODE_TEXT_AREA_TEXT_SELECTION,
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_BUTTON_LABEL = MAX_NODE_SCOPE_NUM * ARKUI_NODE_BUTTON, NODE_BUTTON_TYPE, NODE_PROGRESS_VALUE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_PROGRESS, NODE_PROGRESS_TOTAL,
NODE_PROGRESS_COLOR, NODE_PROGRESS_TYPE, NODE_CHECKBOX_SELECT = MAX_NODE_SCOPE_NUM * ARKUI_NODE_CHECKBOX, NODE_CHECKBOX_SELECT_COLOR,
NODE_CHECKBOX_UNSELECT_COLOR, NODE_CHECKBOX_MARK, NODE_CHECKBOX_SHAPE, NODE_XCOMPONENT_ID = MAX_NODE_SCOPE_NUM * ARKUI_NODE_XCOMPONENT,
NODE_XCOMPONENT_TYPE, NODE_XCOMPONENT_SURFACE_SIZE, NODE_DATE_PICKER_LUNAR = MAX_NODE_SCOPE_NUM * ARKUI_NODE_DATE_PICKER, NODE_DATE_PICKER_START,
NODE_DATE_PICKER_END, NODE_DATE_PICKER_SELECTED, NODE_DATE_PICKER_DISAPPEAR_TEXT_STYLE, NODE_DATE_PICKER_TEXT_STYLE,
NODE_DATE_PICKER_SELECTED_TEXT_STYLE, NODE_TIME_PICKER_SELECTED = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TIME_PICKER, NODE_TIME_PICKER_USE_MILITARY_TIME, NODE_TIME_PICKER_DISAPPEAR_TEXT_STYLE,
NODE_TIME_PICKER_TEXT_STYLE, NODE_TIME_PICKER_SELECTED_TEXT_STYLE, NODE_TEXT_PICKER_OPTION_RANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT_PICKER, NODE_TEXT_PICKER_OPTION_SELECTED,
NODE_TEXT_PICKER_OPTION_VALUE, NODE_TEXT_PICKER_DISAPPEAR_TEXT_STYLE, NODE_TEXT_PICKER_TEXT_STYLE, NODE_TEXT_PICKER_SELECTED_TEXT_STYLE,
NODE_TEXT_PICKER_SELECTED_INDEX, NODE_TEXT_PICKER_CAN_LOOP, NODE_TEXT_PICKER_DEFAULT_PICKER_ITEM_HEIGHT, NODE_CALENDAR_PICKER_HINT_RADIUS = MAX_NODE_SCOPE_NUM * ARKUI_NODE_CALENDAR_PICKER,
NODE_CALENDAR_PICKER_SELECTED_DATE, NODE_CALENDAR_PICKER_EDGE_ALIGNMENT, NODE_CALENDAR_PICKER_TEXT_STYLE, NODE_SLIDER_BLOCK_COLOR = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SLIDER,
NODE_SLIDER_TRACK_COLOR, NODE_SLIDER_SELECTED_COLOR, NODE_SLIDER_SHOW_STEPS, NODE_SLIDER_BLOCK_STYLE,
NODE_SLIDER_VALUE, NODE_SLIDER_MIN_VALUE, NODE_SLIDER_MAX_VALUE, NODE_SLIDER_STEP,
NODE_SLIDER_DIRECTION, NODE_SLIDER_REVERSE, NODE_SLIDER_STYLE, NODE_SLIDER_TRACK_THICKNESS,
NODE_RADIO_CHECKED = MAX_NODE_SCOPE_NUM * ARKUI_NODE_RADIO, NODE_RADIO_STYLE, NODE_RADIO_VALUE, NODE_RADIO_GROUP,
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,
NODE_SCROLL_SCROLL_DIRECTION, NODE_SCROLL_EDGE_EFFECT, NODE_SCROLL_ENABLE_SCROLL_INTERACTION, NODE_SCROLL_FRICTION,
NODE_SCROLL_SNAP, NODE_SCROLL_NESTED_SCROLL, NODE_SCROLL_OFFSET, NODE_SCROLL_EDGE,
NODE_SCROLL_ENABLE_PAGING, NODE_SCROLL_PAGE, NODE_SCROLL_BY, NODE_SCROLL_FLING,
NODE_SCROLL_FADING_EDGE, NODE_SCROLL_SIZE, NODE_LIST_DIRECTION = MAX_NODE_SCOPE_NUM * ARKUI_NODE_LIST, NODE_LIST_STICKY,
NODE_LIST_SPACE, NODE_LIST_NODE_ADAPTER, NODE_LIST_CACHED_COUNT, NODE_LIST_SCROLL_TO_INDEX,
NODE_LIST_ALIGN_LIST_ITEM, NODE_LIST_CHILDREN_MAIN_SIZE = 1003007, NODE_LIST_INITIAL_INDEX = 1003008, NODE_LIST_DIVIDER = 1003009,
NODE_SWIPER_LOOP = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SWIPER, NODE_SWIPER_AUTO_PLAY, NODE_SWIPER_SHOW_INDICATOR, NODE_SWIPER_INTERVAL,
NODE_SWIPER_VERTICAL, NODE_SWIPER_DURATION, NODE_SWIPER_CURVE, NODE_SWIPER_ITEM_SPACE,
NODE_SWIPER_INDEX, NODE_SWIPER_DISPLAY_COUNT, NODE_SWIPER_DISABLE_SWIPE, NODE_SWIPER_SHOW_DISPLAY_ARROW,
NODE_SWIPER_EDGE_EFFECT_MODE, NODE_SWIPER_NODE_ADAPTER, NODE_SWIPER_CACHED_COUNT, NODE_SWIPER_PREV_MARGIN,
NODE_SWIPER_NEXT_MARGIN, NODE_SWIPER_INDICATOR, NODE_SWIPER_NESTED_SCROLL, NODE_SWIPER_SWIPE_TO_INDEX,
NODE_SWIPER_INDICATOR_INTERACTIVE, NODE_SWIPER_PAGE_FLIP_MODE, 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,
NODE_LIST_ITEM_GROUP_SET_FOOTER, NODE_LIST_ITEM_GROUP_SET_DIVIDER, NODE_LIST_ITEM_GROUP_CHILDREN_MAIN_SIZE = 1005003, NODE_COLUMN_ALIGN_ITEMS = MAX_NODE_SCOPE_NUM * ARKUI_NODE_COLUMN,
NODE_COLUMN_JUSTIFY_CONTENT, NODE_ROW_ALIGN_ITEMS = MAX_NODE_SCOPE_NUM * ARKUI_NODE_ROW, NODE_ROW_JUSTIFY_CONTENT, NODE_FLEX_OPTION = MAX_NODE_SCOPE_NUM * ARKUI_NODE_FLEX,
NODE_REFRESH_REFRESHING = MAX_NODE_SCOPE_NUM * ARKUI_NODE_REFRESH, NODE_REFRESH_CONTENT, NODE_REFRESH_PULL_DOWN_RATIO = 1009002, NODE_REFRESH_OFFSET = 1009003,
NODE_REFRESH_PULL_TO_REFRESH = 1009004, NODE_WATER_FLOW_LAYOUT_DIRECTION = MAX_NODE_SCOPE_NUM * ARKUI_NODE_WATER_FLOW, NODE_WATER_FLOW_COLUMN_TEMPLATE, NODE_WATER_FLOW_ROW_TEMPLATE,
NODE_WATER_FLOW_COLUMN_GAP, NODE_WATER_FLOW_ROW_GAP, NODE_WATER_FLOW_SECTION_OPTION, NODE_WATER_FLOW_NODE_ADAPTER,
NODE_WATER_FLOW_CACHED_COUNT, NODE_WATER_FLOW_FOOTER, NODE_WATER_FLOW_SCROLL_TO_INDEX, NODE_WATER_FLOW_ITEM_CONSTRAINT_SIZE,
NODE_RELATIVE_CONTAINER_GUIDE_LINE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_RELATIVE_CONTAINER, NODE_RELATIVE_CONTAINER_BARRIER, NODE_GRID_COLUMN_TEMPLATE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_GRID, NODE_GRID_ROW_TEMPLATE,
NODE_GRID_COLUMN_GAP, NODE_GRID_ROW_GAP, NODE_GRID_NODE_ADAPTER, NODE_GRID_CACHED_COUNT,
NODE_IMAGE_ANIMATOR_IMAGES = ARKUI_NODE_IMAGE_ANIMATOR * MAX_NODE_SCOPE_NUM, NODE_IMAGE_ANIMATOR_STATE, NODE_IMAGE_ANIMATOR_DURATION, NODE_IMAGE_ANIMATOR_REVERSE,
NODE_IMAGE_ANIMATOR_FIXED_SIZE, NODE_IMAGE_ANIMATOR_FILL_MODE, NODE_IMAGE_ANIMATOR_ITERATION
}
Defines the ArkUI style attributes that can be set on the native side.
ArkUI_NodeEventType {
NODE_TOUCH_EVENT = 0, NODE_EVENT_ON_APPEAR, NODE_EVENT_ON_DISAPPEAR, NODE_EVENT_ON_AREA_CHANGE,
NODE_ON_FOCUS, NODE_ON_BLUR, NODE_ON_CLICK, NODE_ON_TOUCH_INTERCEPT,
NODE_EVENT_ON_VISIBLE_AREA_CHANGE, NODE_ON_HOVER, NODE_ON_MOUSE, NODE_EVENT_ON_ATTACH,
NODE_EVENT_ON_DETACH, NODE_ON_ACCESSIBILITY_ACTIONS = 13, NODE_ON_PRE_DRAG = 14, NODE_ON_DRAG_START = 15,
NODE_ON_DRAG_ENTER = 16, NODE_ON_DRAG_MOVE = 17, NODE_ON_DRAG_LEAVE = 18, NODE_ON_DROP = 19,
NODE_ON_DRAG_END = 20, NODE_ON_KEY_EVENT = 21, NODE_ON_KEY_PRE_IME = 22, NODE_TEXT_ON_DETECT_RESULT_UPDATE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT,
NODE_IMAGE_ON_COMPLETE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_IMAGE, NODE_IMAGE_ON_ERROR, NODE_IMAGE_ON_SVG_PLAY_FINISH, NODE_IMAGE_ON_DOWNLOAD_PROGRESS,
NODE_TOGGLE_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TOGGLE, NODE_TEXT_INPUT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT_INPUT, NODE_TEXT_INPUT_ON_SUBMIT, NODE_TEXT_INPUT_ON_CUT,
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,
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,
NODE_TEXT_INPUT_ON_WILL_DELETE = 7011, NODE_TEXT_INPUT_ON_DID_DELETE = 7012, NODE_TEXT_AREA_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT_AREA, NODE_TEXT_AREA_ON_PASTE,
NODE_TEXT_AREA_ON_TEXT_SELECTION_CHANGE, NODE_TEXT_AREA_ON_EDIT_CHANGE, NODE_TEXT_AREA_ON_SUBMIT, NODE_TEXT_AREA_ON_INPUT_FILTER_ERROR,
NODE_TEXT_AREA_ON_CONTENT_SCROLL, NODE_TEXT_AREA_ON_CONTENT_SIZE_CHANGE, NODE_TEXT_AREA_ON_WILL_INSERT = 8008, NODE_TEXT_AREA_ON_DID_INSERT = 8009,
NODE_TEXT_AREA_ON_WILL_DELETE = 8010, NODE_TEXT_AREA_ON_DID_DELETE = 8011, NODE_CHECKBOX_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_CHECKBOX, NODE_DATE_PICKER_EVENT_ON_DATE_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_DATE_PICKER,
NODE_TIME_PICKER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TIME_PICKER, NODE_TEXT_PICKER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT_PICKER, NODE_CALENDAR_PICKER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_CALENDAR_PICKER, NODE_SLIDER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SLIDER,
NODE_RADIO_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_RADIO, NODE_IMAGE_ANIMATOR_EVENT_ON_START = MAX_NODE_SCOPE_NUM * ARKUI_NODE_IMAGE_ANIMATOR, NODE_IMAGE_ANIMATOR_EVENT_ON_PAUSE, NODE_IMAGE_ANIMATOR_EVENT_ON_REPEAT,
NODE_IMAGE_ANIMATOR_EVENT_ON_CANCEL, NODE_IMAGE_ANIMATOR_EVENT_ON_FINISH, NODE_SWIPER_EVENT_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SWIPER, NODE_SWIPER_EVENT_ON_ANIMATION_START,
NODE_SWIPER_EVENT_ON_ANIMATION_END, NODE_SWIPER_EVENT_ON_GESTURE_SWIPE, NODE_SWIPER_EVENT_ON_CONTENT_DID_SCROLL, NODE_SCROLL_EVENT_ON_SCROLL = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SCROLL,
NODE_SCROLL_EVENT_ON_SCROLL_FRAME_BEGIN, NODE_SCROLL_EVENT_ON_WILL_SCROLL, NODE_SCROLL_EVENT_ON_DID_SCROLL, NODE_SCROLL_EVENT_ON_SCROLL_START,
NODE_SCROLL_EVENT_ON_SCROLL_STOP, NODE_SCROLL_EVENT_ON_SCROLL_EDGE, NODE_SCROLL_EVENT_ON_REACH_START, NODE_SCROLL_EVENT_ON_REACH_END,
NODE_LIST_ON_SCROLL_INDEX = MAX_NODE_SCOPE_NUM * ARKUI_NODE_LIST, NODE_LIST_ON_WILL_SCROLL, NODE_LIST_ON_DID_SCROLL, NODE_REFRESH_STATE_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_REFRESH,
NODE_REFRESH_ON_REFRESH, NODE_REFRESH_ON_OFFSET_CHANGE, NODE_ON_WILL_SCROLL = MAX_NODE_SCOPE_NUM * ARKUI_NODE_WATER_FLOW, NODE_WATER_FLOW_ON_DID_SCROLL,
NODE_WATER_FLOW_ON_SCROLL_INDEX
}
Enumerates the event types supported by the NativeNode component.
ArkUI_NodeDirtyFlag { NODE_NEED_MEASURE = 1, NODE_NEED_LAYOUT, NODE_NEED_RENDER } Enumerates the dirty area flags passed in the ::markDirty API.
ArkUI_NodeCustomEventType {
ARKUI_NODE_CUSTOM_EVENT_ON_MEASURE = 1 << 0, ARKUI_NODE_CUSTOM_EVENT_ON_LAYOUT = 1 << 1, ARKUI_NODE_CUSTOM_EVENT_ON_DRAW = 1 << 2, ARKUI_NODE_CUSTOM_EVENT_ON_FOREGROUND_DRAW = 1 << 3,
ARKUI_NODE_CUSTOM_EVENT_ON_OVERLAY_DRAW = 1 << 4
}
Enumerates the custom component event types.
ArkUI_NodeAdapterEventType {
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,
NODE_ADAPTER_EVENT_ON_REMOVE_NODE_FROM_ADAPTER = 5
}
Enumerates node adapter events.
ArkUI_NodeContentEventType { NODE_CONTENT_EVENT_ON_ATTACH_TO_WINDOW = 0, NODE_CONTENT_EVENT_ON_DETACH_FROM_WINDOW = 1 } Defines the NodeContent event type.
ArkUI_Alignment {
ARKUI_ALIGNMENT_TOP_START = 0, ARKUI_ALIGNMENT_TOP, ARKUI_ALIGNMENT_TOP_END, ARKUI_ALIGNMENT_START,
ARKUI_ALIGNMENT_CENTER, ARKUI_ALIGNMENT_END, ARKUI_ALIGNMENT_BOTTOM_START, ARKUI_ALIGNMENT_BOTTOM,
ARKUI_ALIGNMENT_BOTTOM_END
}
Enumerates the alignment modes.
ArkUI_ImageRepeat { ARKUI_IMAGE_REPEAT_NONE = 0, ARKUI_IMAGE_REPEAT_X, ARKUI_IMAGE_REPEAT_Y, ARKUI_IMAGE_REPEAT_XY } Enumerates the image repeat patterns.
ArkUI_FontStyle { ARKUI_FONT_STYLE_NORMAL = 0, ARKUI_FONT_STYLE_ITALIC } Enumerates the font styles.
ArkUI_FontWeight {
ARKUI_FONT_WEIGHT_W100 = 0, ARKUI_FONT_WEIGHT_W200, ARKUI_FONT_WEIGHT_W300, ARKUI_FONT_WEIGHT_W400,
ARKUI_FONT_WEIGHT_W500, ARKUI_FONT_WEIGHT_W600, ARKUI_FONT_WEIGHT_W700, ARKUI_FONT_WEIGHT_W800,
ARKUI_FONT_WEIGHT_W900, ARKUI_FONT_WEIGHT_BOLD, ARKUI_FONT_WEIGHT_NORMAL, ARKUI_FONT_WEIGHT_BOLDER,
ARKUI_FONT_WEIGHT_LIGHTER, ARKUI_FONT_WEIGHT_MEDIUM, ARKUI_FONT_WEIGHT_REGULAR
}
Enumerates the font weights.
ArkUI_TextAlignment { ARKUI_TEXT_ALIGNMENT_START = 0, ARKUI_TEXT_ALIGNMENT_CENTER, ARKUI_TEXT_ALIGNMENT_END, ARKUI_TEXT_ALIGNMENT_JUSTIFY } Enumerates the text alignment mode.
ArkUI_EnterKeyType {
ARKUI_ENTER_KEY_TYPE_GO = 2, ARKUI_ENTER_KEY_TYPE_SEARCH = 3, ARKUI_ENTER_KEY_TYPE_SEND, ARKUI_ENTER_KEY_TYPE_NEXT,
ARKUI_ENTER_KEY_TYPE_DONE, ARKUI_ENTER_KEY_TYPE_PREVIOUS, ARKUI_ENTER_KEY_TYPE_NEW_LINE
}
Enumerates the types of the Enter key for a single-line text box.
ArkUI_TextInputType {
ARKUI_TEXTINPUT_TYPE_NORMAL = 0, ARKUI_TEXTINPUT_TYPE_NUMBER = 2, ARKUI_TEXTINPUT_TYPE_PHONE_NUMBER = 3, ARKUI_TEXTINPUT_TYPE_EMAIL = 5,
ARKUI_TEXTINPUT_TYPE_PASSWORD = 7, ARKUI_TEXTINPUT_TYPE_NUMBER_PASSWORD = 8, ARKUI_TEXTINPUT_TYPE_SCREEN_LOCK_PASSWORD = 9, ARKUI_TEXTINPUT_TYPE_USER_NAME = 10,
ARKUI_TEXTINPUT_TYPE_NEW_PASSWORD = 11, ARKUI_TEXTINPUT_TYPE_NUMBER_DECIMAL = 12
}
Enumerates the text input types.
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.
ArkUI_CancelButtonStyle { ARKUI_CANCELBUTTON_STYLE_CONSTANT = 0, ARKUI_CANCELBUTTON_STYLE_INVISIBLE, ARKUI_CANCELBUTTON_STYLE_INPUT } Enumerates the styles of the Cancel button.
ArkUI_XComponentType { ARKUI_XCOMPONENT_TYPE_SURFACE = 0, ARKUI_XCOMPONENT_TYPE_TEXTURE = 2 } Enumerates the XComponent types.
ArkUI_ProgressType {
ARKUI_PROGRESS_TYPE_LINEAR = 0, ARKUI_PROGRESS_TYPE_RING, ARKUI_PROGRESS_TYPE_ECLIPSE, ARKUI_PROGRESS_TYPE_SCALE_RING,
ARKUI_PROGRESS_TYPE_CAPSULE
}
Enumerates the styles of the progress indicator.
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.
ArkUI_TextDecorationStyle {
ARKUI_TEXT_DECORATION_STYLE_SOLID = 0, ARKUI_TEXT_DECORATION_STYLE_DOUBLE, ARKUI_TEXT_DECORATION_STYLE_DOTTED, ARKUI_TEXT_DECORATION_STYLE_DASHED,
ARKUI_TEXT_DECORATION_STYLE_WAVY
}
Enumerates the text decoration styles.
ArkUI_TextCase { ARKUI_TEXT_CASE_NORMAL = 0, ARKUI_TEXT_CASE_LOWER, ARKUI_TEXT_CASE_UPPER } Enumerates the text cases.
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.
ArkUI_ShadowType { ARKUI_SHADOW_TYPE_COLOR = 0, ARKUI_SHADOW_TYPE_BLUR } Enumerates the shadow types.
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.
ArkUI_AccessibilityCheckedState { ARKUI_ACCESSIBILITY_UNCHECKED = 0, ARKUI_ACCESSIBILITY_CHECKED } Enumerates the accessibility check box states.
ArkUI_AccessibilityActionType {
ARKUI_ACCESSIBILITY_ACTION_CLICK = 1 << 0, ARKUI_ACCESSIBILITY_ACTION_LONG_CLICK = 1 << 1, ARKUI_ACCESSIBILITY_ACTION_CUT = 1 << 2, ARKUI_ACCESSIBILITY_ACTION_COPY = 1 << 3,
ARKUI_ACCESSIBILITY_ACTION_PASTE = 1 << 4
}
Defines an enum for the accessibility action types.
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.
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.
ArkUI_ScrollDirection { ARKUI_SCROLL_DIRECTION_VERTICAL = 0, ARKUI_SCROLL_DIRECTION_HORIZONTAL, ARKUI_SCROLL_DIRECTION_NONE = 3 } Enumerates the scroll directions of scrollable components.
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.
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.
ArkUI_Axis { ARKUI_AXIS_VERTICAL = 0, ARKUI_AXIS_HORIZONTAL } Enumerates the scroll directions.
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.
ArkUI_BorderStyle { ARKUI_BORDER_STYLE_SOLID = 0, ARKUI_BORDER_STYLE_DASHED, ARKUI_BORDER_STYLE_DOTTED } Enumerates the border styles.
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.
ArkUI_ShadowStyle {
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,
ARKUI_SHADOW_STYLE_OUTER_FLOATING_SM, ARKUI_SHADOW_STYLE_OUTER_FLOATING_MD
}
Enumerated value of the shadow effect.
ArkUI_AnimationCurve {
ARKUI_CURVE_LINEAR = 0, ARKUI_CURVE_EASE, ARKUI_CURVE_EASE_IN, ARKUI_CURVE_EASE_OUT,
ARKUI_CURVE_EASE_IN_OUT, ARKUI_CURVE_FAST_OUT_SLOW_IN, ARKUI_CURVE_LINEAR_OUT_SLOW_IN, ARKUI_CURVE_FAST_OUT_LINEAR_IN,
ARKUI_CURVE_EXTREME_DECELERATION, ARKUI_CURVE_SHARP, ARKUI_CURVE_RHYTHM, ARKUI_CURVE_SMOOTH,
ARKUI_CURVE_FRICTION
}
Enumerates the animation curves.
ArkUI_SwiperArrow { ARKUI_SWIPER_ARROW_HIDE = 0, ARKUI_SWIPER_ARROW_SHOW, ARKUI_SWIPER_ARROW_SHOW_ON_HOVER } Enumerates arrow styles of the navigation point indicator.
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.
ArkUI_PageFlipMode { ARKUI_PAGE_FLIP_MODE_CONTINUOUS = 0, ARKUI_PAGE_FLIP_MODE_SINGLE } Enumerates the page flipping modes using the mouse wheel for the Swiper component.
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.
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.
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.
ArkUI_ScrollNestedMode { ARKUI_SCROLL_NESTED_MODE_SELF_ONLY = 0, ARKUI_SCROLL_NESTED_MODE_SELF_FIRST, ARKUI_SCROLL_NESTED_MODE_PARENT_FIRST, ARKUI_SCROLL_NESTED_MODE_PARALLEL } Enumerates the nested scrolling modes.
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.
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.
ArkUI_ScrollState { ARKUI_SCROLL_STATE_IDLE = 0, ARKUI_SCROLL_STATE_SCROLL, ARKUI_SCROLL_STATE_FLING } Enumerates the scrolling states.
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.
ArkUI_SliderDirection { ARKUI_SLIDER_DIRECTION_VERTICAL = 0, ARKUI_SLIDER_DIRECTION_HORIZONTAL } Enumerates the scroll directions of the slider.
ArkUI_SliderStyle { ARKUI_SLIDER_STYLE_OUT_SET = 0, ARKUI_SLIDER_STYLE_IN_SET, ARKUI_SLIDER_STYLE_NONE } Enumerates the slider styles.
ArkUI_CheckboxShape { ArkUI_CHECKBOX_SHAPE_CIRCLE = 0, ArkUI_CHECKBOX_SHAPE_ROUNDED_SQUARE } Enumerates the shapes of the check box.
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.
ArkUI_ImageSize { ARKUI_IMAGE_SIZE_AUTO = 0, ARKUI_IMAGE_SIZE_COVER, ARKUI_IMAGE_SIZE_CONTAIN } Defines the image size.
ArkUI_AdaptiveColor { ARKUI_ADAPTIVE_COLOR_DEFAULT = 0, ARKUI_ADAPTIVE_COLOR_AVERAGE } Enumerates the adaptive color modes.
ArkUI_ColorMode { ARKUI_COLOR_MODE_SYSTEM = 0, ARKUI_COLOR_MODE_LIGHT, ARKUI_COLOR_MODE_DARK } Enumerates the color modes.
ArkUI_SystemColorMode { ARKUI_SYSTEM_COLOR_MODE_LIGHT = 0, ARKUI_SYSTEM_COLOR_MODE_DARK } Enumerates the system color modes.
ArkUI_BlurStyle {
ARKUI_BLUR_STYLE_THIN = 0, ARKUI_BLUR_STYLE_REGULAR, ARKUI_BLUR_STYLE_THICK, ARKUI_BLUR_STYLE_BACKGROUND_THIN,
ARKUI_BLUR_STYLE_BACKGROUND_REGULAR, ARKUI_BLUR_STYLE_BACKGROUND_THICK, ARKUI_BLUR_STYLE_BACKGROUND_ULTRA_THICK, ARKUI_BLUR_STYLE_NONE,
ARKUI_BLUR_STYLE_COMPONENT_ULTRA_THIN, ARKUI_BLUR_STYLE_COMPONENT_THIN, ARKUI_BLUR_STYLE_COMPONENT_REGULAR, ARKUI_BLUR_STYLE_COMPONENT_THICK,
ARKUI_BLUR_STYLE_COMPONENT_ULTRA_THICK
}
Enumerates the blur styles.
ArkUI_VerticalAlignment { ARKUI_VERTICAL_ALIGNMENT_TOP = 0, ARKUI_VERTICAL_ALIGNMENT_CENTER, ARKUI_VERTICAL_ALIGNMENT_BOTTOM } Enumerates the vertical alignment modes.
ArkUI_HorizontalAlignment { ARKUI_HORIZONTAL_ALIGNMENT_START = 0, ARKUI_HORIZONTAL_ALIGNMENT_CENTER, ARKUI_HORIZONTAL_ALIGNMENT_END } Enumerates the alignment mode in the horizontal direction.
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.
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.
ArkUI_ObjectFit {
ARKUI_OBJECT_FIT_CONTAIN = 0, ARKUI_OBJECT_FIT_COVER, ARKUI_OBJECT_FIT_AUTO, ARKUI_OBJECT_FIT_FILL,
ARKUI_OBJECT_FIT_SCALE_DOWN, ARKUI_OBJECT_FIT_NONE, ARKUI_OBJECT_FIT_NONE_AND_ALIGN_TOP_START, ARKUI_OBJECT_FIT_NONE_AND_ALIGN_TOP,
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,
ARKUI_OBJECT_FIT_NONE_AND_ALIGN_BOTTOM_START, ARKUI_OBJECT_FIT_NONE_AND_ALIGN_BOTTOM, ARKUI_OBJECT_FIT_NONE_AND_ALIGN_BOTTOM_END
}
Enumerates the image filling effects.
ArkUI_ImageInterpolation { ARKUI_IMAGE_INTERPOLATION_NONE = 0, ARKUI_IMAGE_INTERPOLATION_LOW, ARKUI_IMAGE_INTERPOLATION_MEDIUM, ARKUI_IMAGE_INTERPOLATION_HIGH } Enumerates the image interpolation effects.
ArkUI_BlendMode {
ARKUI_BLEND_MODE_NONE = 0, ARKUI_BLEND_MODE_CLEAR, ARKUI_BLEND_MODE_SRC, ARKUI_BLEND_MODE_DST,
ARKUI_BLEND_MODE_SRC_OVER, ARKUI_BLEND_MODE_DST_OVER, ARKUI_BLEND_MODE_SRC_IN, ARKUI_BLEND_MODE_DST_IN,
ARKUI_BLEND_MODE_SRC_OUT, ARKUI_BLEND_MODE_DST_OUT, ARKUI_BLEND_MODE_SRC_ATOP, ARKUI_BLEND_MODE_DST_ATOP,
ARKUI_BLEND_MODE_XOR, ARKUI_BLEND_MODE_PLUS, ARKUI_BLEND_MODE_MODULATE, ARKUI_BLEND_MODE_SCREEN,
ARKUI_BLEND_MODE_OVERLAY, ARKUI_BLEND_MODE_DARKEN, ARKUI_BLEND_MODE_LIGHTEN, ARKUI_BLEND_MODE_COLOR_DODGE,
ARKUI_BLEND_MODE_COLOR_BURN, ARKUI_BLEND_MODE_HARD_LIGHT, ARKUI_BLEND_MODE_SOFT_LIGHT, ARKUI_BLEND_MODE_DIFFERENCE,
ARKUI_BLEND_MODE_EXCLUSION, ARKUI_BLEND_MODE_MULTIPLY, ARKUI_BLEND_MODE_HUE, ARKUI_BLEND_MODE_SATURATION,
ARKUI_BLEND_MODE_COLOR, ARKUI_BLEND_MODE_LUMINOSITY
}
Enumerates the blend modes.
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.
ArkUI_ItemAlignment {
ARKUI_ITEM_ALIGNMENT_AUTO = 0, ARKUI_ITEM_ALIGNMENT_START, ARKUI_ITEM_ALIGNMENT_CENTER, ARKUI_ITEM_ALIGNMENT_END,
ARKUI_ITEM_ALIGNMENT_STRETCH, ARKUI_ITEM_ALIGNMENT_BASELINE
}
Enumerates the modes in which components are laid out along the cross axis of the container.
ArkUI_ColorStrategy { ARKUI_COLOR_STRATEGY_INVERT = 0, ARKUI_COLOR_STRATEGY_AVERAGE, ARKUI_COLOR_STRATEGY_PRIMARY } Enumerates the foreground colors.
ArkUI_FlexAlignment {
ARKUI_FLEX_ALIGNMENT_START = 1, ARKUI_FLEX_ALIGNMENT_CENTER = 2, ARKUI_FLEX_ALIGNMENT_END = 3, ARKUI_FLEX_ALIGNMENT_SPACE_BETWEEN = 6,
ARKUI_FLEX_ALIGNMENT_SPACE_AROUND = 7, ARKUI_FLEX_ALIGNMENT_SPACE_EVENLY = 8
}
Enumerates the vertical alignment modes.
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.
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.
ArkUI_Visibility { ARKUI_VISIBILITY_VISIBLE = 0, ARKUI_VISIBILITY_HIDDEN, ARKUI_VISIBILITY_NONE } Enumerates the visibility values.
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.
ArkUI_MaskType {
ARKUI_MASK_TYPE_RECTANGLE = 0, ARKUI_MASK_TYPE_CIRCLE, ARKUI_MASK_TYPE_ELLIPSE, ARKUI_MASK_TYPE_PATH,
ARKUI_MASK_TYPE_PROGRESS
}
Enumerates the mask types.
ArkUI_ClipType { ARKUI_CLIP_TYPE_RECTANGLE = 0, ARKUI_CLIP_TYPE_CIRCLE, ARKUI_CLIP_TYPE_ELLIPSE, ARKUI_CLIP_TYPE_PATH } Enumerates the clipping region types.
ArkUI_ShapeType { ARKUI_SHAPE_TYPE_RECTANGLE = 0, ARKUI_SHAPE_TYPE_CIRCLE, ARKUI_SHAPE_TYPE_ELLIPSE, ARKUI_SHAPE_TYPE_PATH } Enumerates custom shape types.
ArkUI_LinearGradientDirection {
ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT = 0, ARKUI_LINEAR_GRADIENT_DIRECTION_TOP, ARKUI_LINEAR_GRADIENT_DIRECTION_RIGHT, ARKUI_LINEAR_GRADIENT_DIRECTION_BOTTOM,
ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT_TOP, ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT_BOTTOM, ARKUI_LINEAR_GRADIENT_DIRECTION_RIGHT_TOP, ARKUI_LINEAR_GRADIENT_DIRECTION_RIGHT_BOTTOM,
ARKUI_LINEAR_GRADIENT_DIRECTION_NONE, ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM
}
Enumerates the gradient directions.
ArkUI_WordBreak { ARKUI_WORD_BREAK_NORMAL = 0, ARKUI_WORD_BREAK_BREAK_ALL, ARKUI_WORD_BREAK_BREAK_WORD } Enumerates the word break rules.
ArkUI_EllipsisMode { ARKUI_ELLIPSIS_MODE_START = 0, ARKUI_ELLIPSIS_MODE_CENTER, ARKUI_ELLIPSIS_MODE_END } Enumerates the ellipsis positions.
ArkUI_ImageRenderMode { ARKUI_IMAGE_RENDER_MODE_ORIGINAL = 0, ARKUI_IMAGE_RENDER_MODE_TEMPLATE } Enumerates the image rendering modes.
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.
ArkUI_FinishCallbackType { ARKUI_FINISH_CALLBACK_REMOVED = 0, ARKUI_FINISH_CALLBACK_LOGICALLY } Enumerates the animation onFinish callback types.
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.
ArkUI_BlendApplyType { BLEND_APPLY_TYPE_FAST = 0, BLEND_APPLY_TYPE_OFFSCREEN } Defines how the specified blend mode is applied.
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.
ArkUI_TextInputContentType {
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,
ARKUI_TEXTINPUT_CONTENT_TYPE_HOUSE_NUMBER, ARKUI_TEXTINPUT_CONTENT_TYPE_DISTRICT_ADDRESS, ARKUI_TEXTINPUT_CONTENT_TYPE_CITY_ADDRESS, ARKUI_TEXTINPUT_CONTENT_TYPE_PROVINCE_ADDRESS,
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,
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,
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,
ARKUI_TEXTINPUT_CONTENT_TYPE_FORMAT_ADDRESS
}
Enumerates the autofill types.
ArkUI_BarrierDirection { ARKUI_BARRIER_DIRECTION_START = 0, ARKUI_BARRIER_DIRECTION_END, ARKUI_BARRIER_DIRECTION_TOP, ARKUI_BARRIER_DIRECTION_BOTTOM } Enumerates the barrier directions.
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.
ArkUI_TextInputStyle { ARKUI_TEXTINPUT_STYLE_DEFAULT = 0, ARKUI_TEXTINPUT_STYLE_INLINE } Enumerates the text input styles.
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.
ArkUI_ButtonType { ARKUI_BUTTON_TYPE_NORMAL = 0, ARKUI_BUTTON_TYPE_CAPSULE, ARKUI_BUTTON_TYPE_CIRCLE } Enumerates the button types.
ArkUI_RenderFit {
ARKUI_RENDER_FIT_CENTER = 0, ARKUI_RENDER_FIT_TOP, ARKUI_RENDER_FIT_BOTTOM, ARKUI_RENDER_FIT_LEFT,
ARKUI_RENDER_FIT_RIGHT, ARKUI_RENDER_FIT_TOP_LEFT, ARKUI_RENDER_FIT_TOP_RIGHT, ARKUI_RENDER_FIT_BOTTOM_LEFT,
ARKUI_RENDER_FIT_BOTTOM_RIGHT, ARKUI_RENDER_FIT_RESIZE_FILL, ARKUI_RENDER_FIT_RESIZE_CONTAIN, ARKUI_RENDER_FIT_RESIZE_CONTAIN_TOP_LEFT,
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
}
ArkUI_ThemeColorMode { ARKUI_THEME_COLOR_MODE_SYSTEM = 0, ARKUI_THEME_COLOR_MODE_LIGHT, ARKUI_THEME_COLOR_MODE_DARK }
ArkUI_SwiperIndicatorType { ARKUI_SWIPER_INDICATOR_TYPE_DOT, ARKUI_SWIPER_INDICATOR_TYPE_DIGIT } Enumerates the navigation point indicator types of the Swiper component.
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.
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.
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.
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.
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.
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.
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.
ArkUI_ErrorCode {
ARKUI_ERROR_CODE_NO_ERROR = 0, ARKUI_ERROR_CODE_PARAM_INVALID = 401, ARKUI_ERROR_CODE_ATTRIBUTE_OR_EVENT_NOT_SUPPORTED = 106102, ARKUI_ERROR_CODE_NOT_SUPPROTED_FOR_ARKTS_NODE = 106103,
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,
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,
ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR = 106202, ARKUI_ERROR_CODE_NON_SCROLLABLE_CONTAINER = 180001, ARKUI_ERROR_CODE_BUFFER_SIZE_NOT_ENOUGH = 180002, ARKUI_ERROR_CODE_INVALID_STYLED_STRING = 180101
}
Enumerates the error codes.
ArkUI_ScrollSource {
ARKUI_SCROLL_SOURCE_DRAG = 0, ARKUI_SCROLL_SOURCE_FLING, ARKUI_SCROLL_SOURCE_EDGE_EFFECT, ARKUI_SCROLL_SOURCE_OTHER_USER_INPUT,
ARKUI_SCROLL_SOURCE_SCROLL_BAR, ARKUI_SCROLL_SOURCE_SCROLL_BAR_FLING, ARKUI_SCROLL_SOURCE_SCROLLER, ARKUI_SCROLL_SOURCE_ANIMATION
}
Enumerates the scrolling sources.
ArkUI_SafeAreaType { ARKUI_SAFE_AREA_TYPE_SYSTEM = 1, ARKUI_SAFE_AREA_TYPE_CUTOUT = 1 << 1, ARKUI_SAFE_AREA_TYPE_KEYBOARD = 1 << 2 } Enumerates the types of expanded safe areas.
ArkUI_SafeAreaEdge { ARKUI_SAFE_AREA_EDGE_TOP = 1, ARKUI_SAFE_AREA_EDGE_BOTTOM = 1 << 1, ARKUI_SAFE_AREA_EDGE_START = 1 << 2, ARKUI_SAFE_AREA_EDGE_END = 1 << 3 } Enumerates the edges for expanding the safe area.
ArkUI_NavDestinationState {
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,
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,
ARKUI_NAV_DESTINATION_STATE_ON_BACK_PRESS = 100
}
Enumerates the NavDestination component states.
ArkUI_RouterPageState {
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,
ARKUI_ROUTER_PAGE_STATE_ON_BACK_PRESS = 4
}
Enumerates the states of a page during routing.

Functions

Name Description
ArkUI_DragEvent * OH_ArkUI_NodeEvent_GetDragEvent (ArkUI_NodeEvent *nodeEvent) Obtains a DragEvent object from the specified NodeEvent object.
ArkUI_PreDragStatus OH_ArkUI_NodeEvent_GetPreDragStatus (ArkUI_NodeEvent *nodeEvent) Obtains the state prior to a drop and drop operation.
int32_t OH_ArkUI_DragEvent_DisableDefaultDropAnimation (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.
int32_t OH_ArkUI_DragEvent_SetSuggestedDropOperation (ArkUI_DragEvent *event, ArkUI_DropProposal proposal) Sets the data processing mode.
int32_t OH_ArkUI_DragEvent_SetDragResult (ArkUI_DragEvent *event, ArkUI_DragResult result) Sets the result for a drag event.
int32_t OH_ArkUI_DragEvent_SetData (ArkUI_DragEvent *event, OH_UdmfData *data) Sets drag data for a drag event.
int32_t OH_ArkUI_DragEvent_GetUdmfData (ArkUI_DragEvent *event, OH_UdmfData *data) Obtains the default drag data from a drag event.
int32_t OH_ArkUI_DragEvent_GetDataTypesCount (ArkUI_DragEvent *event, int32_t *count) Obtains the number of drag data types from a drag event.
int32_t OH_ArkUI_DragEvent_GetDataTypes (ArkUI_DragEvent *event, char **result[], int32_t length) Obtains the type list of drag data types from a drag event.
int32_t OH_ArkUI_DragEvent_GetDragResult (ArkUI_DragEvent *event, ArkUI_DragResult *result) Obtains the drag and drop result from the drag event.
float OH_ArkUI_DragEvent_GetPreviewTouchPointX (ArkUI_DragEvent *event) Obtains the X coordinate of the touch point for a drag preview from a drag event.
float OH_ArkUI_DragEvent_GetPreviewTouchPointY (ArkUI_DragEvent *event) Obtains the Y coordinate of the touch point for a drag preview from a drag event.
float OH_ArkUI_DragEvent_GetPreviewRectWidth (ArkUI_DragEvent *event) Obtains the width of a drag preview from a drag event.
float OH_ArkUI_DragEvent_GetPreviewRectHeight (ArkUI_DragEvent *event) Obtains the height of a drag preview from a drag event.
float OH_ArkUI_DragEvent_GetTouchPointXToWindow (ArkUI_DragEvent *event) Obtains the X coordinate of the touch point relative to the window from a drag event.
float OH_ArkUI_DragEvent_GetTouchPointYToWindow (ArkUI_DragEvent *event) Obtains the Y coordinate of the touch point relative to the window from a drag event.
float OH_ArkUI_DragEvent_GetTouchPointXToDisplay (ArkUI_DragEvent *event) Obtains the X coordinate of the touch point relative to the display from a drag event.
float OH_ArkUI_DragEvent_GetTouchPointYToDisplay (ArkUI_DragEvent *event) Obtains the Y coordinate of the touch point relative to the display from a drag event.
float OH_ArkUI_DragEvent_GetVelocityX (ArkUI_DragEvent *event) Obtains the dragging velocity along the x-axis.
float OH_ArkUI_DragEvent_GetVelocityY (ArkUI_DragEvent *event) Obtains the dragging velocity along the y-axis.
float OH_ArkUI_DragEvent_GetVelocity (ArkUI_DragEvent *event) Obtains the dragging velocity along the main axis.
int32_t OH_ArkUI_DragEvent_GetModifierKeyStates (ArkUI_DragEvent *event, int64_t *keys) Obtains the pressed status of modifier keys from a drag event.
int32_t OH_ArkUI_SetDragEventStrictReportWithNode (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.
int32_t OH_ArkUI_SetDragEventStrictReportWithContext (ArkUI_ContextHandle 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.
int32_t OH_ArkUI_SetNodeAllowedDropDataTypes (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 or OH_ArkUI_AllowNodeAllDropDataTypes.
int32_t OH_ArkUI_DisallowNodeAnyDropDataTypes (ArkUI_NodeHandle node) Configures the specified component to disallow any data types. This API resets the settings configured through OH_ArkUI_SetNodeAllowedDropDataTypes.
int32_t OH_ArkUI_AllowNodeAllDropDataTypes (ArkUI_NodeHandle node) Configures the specified component to allow any data types. This API resets the settings configured through OH_ArkUI_SetNodeAllowedDropDataTypes.
int32_t OH_ArkUI_SetNodeDraggable (ArkUI_NodeHandle node, bool enabled) Sets whether the component is draggable.
int32_t OH_ArkUI_SetNodeDragPreview (ArkUI_NodeHandle node, OH_PixelmapNative *preview) Sets a custom drag preview for the specified component.
ArkUI_DragPreviewOption * OH_ArkUI_CreateDragPreviewOption (void) Creates an ArkUI_DragPreviewOption object.
void OH_ArkUI_DragPreviewOption_Dispose (ArkUI_DragPreviewOption *option) Disposes of an ArkUI_DragPreviewOption object.
int32_t OH_ArkUI_DragPreviewOption_SetScaleMode (ArkUI_DragPreviewOption *option, ArkUI_DragPreviewScaleMode scaleMode) Sets the scale mode for an ArkUI_DragPreviewOption object.
int32_t OH_ArkUI_DragPreviewOption_SetDefaultShadowEnabled (ArkUI_DragPreviewOption *option, bool enabled) Sets whether to enable the shadow effect for an ArkUI_DragPreviewOption object. The shadow effect is enabled by default.
int32_t OH_ArkUI_DragPreviewOption_SetDefaultRadiusEnabled (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.
int32_t OH_ArkUI_DragPreviewOption_SetNumberBadgeEnabled (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.
int32_t OH_ArkUI_DragPreviewOption_SetBadgeNumber (ArkUI_DragPreviewOption *option, uint32_t forcedNumber) Sets the count on the badge. The settings will overwrite the value in the SetDragPreviewNumberBadgeEnabled API.
int32_t OH_ArkUI_DragPreviewOption_SetDefaultAnimationBeforeLiftingEnabled (ArkUI_DragPreviewOption *option, bool enabled) Sets whether to enable the default animation on a click or touch.
int32_t OH_ArkUI_SetNodeDragPreviewOption (ArkUI_NodeHandle node, ArkUI_DragPreviewOption *option) Sets an ArkUI_DragPreviewOption object for the specified component.
ArkUI_DragAction * OH_ArkUI_CreateDragActionWithNode (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.
ArkUI_DragAction * OH_ArkUI_CreateDragActionWithContext (ArkUI_ContextHandle uiContext) Creates a drag action object for the specified UI instance.
void OH_ArkUI_DragAction_Dispose (ArkUI_DragAction *dragAction) Disposes of an ArkUI_DragAction object.
int32_t OH_ArkUI_DragAction_SetPointerId (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.
int32_t OH_ArkUI_DragAction_SetPixelMaps (ArkUI_DragAction *dragAction, OH_PixelmapNative *pixelmapArray[], int32_t size) Sets the drag previews for a drag action.
int32_t OH_ArkUI_DragAction_SetTouchPointX (ArkUI_DragAction *dragAction, float x) Sets the touch point relative to the upper left corner of the first drag preview (pixel map).
int32_t OH_ArkUI_DragAction_SetTouchPointY (ArkUI_DragAction *dragAction, float y) Sets the touch point relative to the upper left corner of the first drag preview (pixel map).
int32_t OH_ArkUI_DragAction_SetData (ArkUI_DragAction *dragAction, OH_UdmfData *data) Sets the drag data.
int32_t OH_ArkUI_DragAction_SetDragPreviewOption (ArkUI_DragAction *dragAction, ArkUI_DragPreviewOption *option) Sets an ArkUI_DragPreviewOption object for the specified drag action object.
int32_t OH_ArkUI_DragAction_RegisterStatusListener (ArkUI_DragAction *dragAction, void *userData, void(*listener)(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.
void OH_ArkUI_DragAction_UnregisterStatusListener (ArkUI_DragAction *dragAction) Unregisters a drag status listener.
ArkUI_DragStatus OH_ArkUI_DragAndDropInfo_GetDragStatus (ArkUI_DragAndDropInfo *dragAndDropInfo) Obtains the drag status of a drag action.
ArkUI_DragEvent * OH_ArkUI_DragAndDropInfo_GetDragEvent (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.
int32_t OH_ArkUI_StartDrag (ArkUI_DragAction *dragAction) Initiates a drag action through the specified DragAction object.
ArkUI_DrawableDescriptor * OH_ArkUI_DrawableDescriptor_CreateFromPixelMap (OH_PixelmapNativeHandle pixelMap) Creates a DrawableDescriptor object from a PixelMap object.
ArkUI_DrawableDescriptor * OH_ArkUI_DrawableDescriptor_CreateFromAnimatedPixelMap (OH_PixelmapNativeHandle *array, int32_t size) Creates a DrawableDescriptor object from an array of PixelMap objects.
void OH_ArkUI_DrawableDescriptor_Dispose (ArkUI_DrawableDescriptor *drawableDescriptor) Disposes of the pointer to a DrawableDescriptor object.
OH_PixelmapNativeHandle OH_ArkUI_DrawableDescriptor_GetStaticPixelMap (ArkUI_DrawableDescriptor *drawableDescriptor) Obtains the pointer to a PixelMap object.
OH_PixelmapNativeHandle * OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArray (ArkUI_DrawableDescriptor *drawableDescriptor) Obtains an array of PixelMap objects for playing an animation.
int32_t OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArraySize (ArkUI_DrawableDescriptor *drawableDescriptor) Obtains an array of PixelMap objects for playing an animation.
void OH_ArkUI_DrawableDescriptor_SetAnimationDuration (ArkUI_DrawableDescriptor *drawableDescriptor, int32_t duration) Sets the total playback duration for a pixel map image array.
int32_t OH_ArkUI_DrawableDescriptor_GetAnimationDuration (ArkUI_DrawableDescriptor *drawableDescriptor) Obtains the total playback duration for a pixel map image array.
void OH_ArkUI_DrawableDescriptor_SetAnimationIteration (ArkUI_DrawableDescriptor *drawableDescriptor, int32_t iteration) Sets the number of times that a pixel map image array is played.
int32_t OH_ArkUI_DrawableDescriptor_GetAnimationIteration (ArkUI_DrawableDescriptor *drawableDescriptor) Obtains the number of times that a pixel map image array is played.
ArkUI_AnimateOption * OH_ArkUI_AnimateOption_Create () Creates an animation configuration.
void OH_ArkUI_AnimateOption_Dispose (ArkUI_AnimateOption *option) Destroys an animation configuration.
int32_t OH_ArkUI_AnimateOption_GetDuration (ArkUI_AnimateOption *option) Obtains the animation duration, in milliseconds.
float OH_ArkUI_AnimateOption_GetTempo (ArkUI_AnimateOption *option) Obtains the playback speed of an animation.
ArkUI_AnimationCurve OH_ArkUI_AnimateOption_GetCurve (ArkUI_AnimateOption *option) Obtains an animation curve.
int32_t OH_ArkUI_AnimateOption_GetDelay (ArkUI_AnimateOption *option) Obtains the animation delay, in milliseconds.
int32_t OH_ArkUI_AnimateOption_GetIterations (ArkUI_AnimateOption *option) Obtains the number of times that an animation is played.
ArkUI_AnimationPlayMode OH_ArkUI_AnimateOption_GetPlayMode (ArkUI_AnimateOption *option) Obtains the playback mode of an animation.
ArkUI_ExpectedFrameRateRange * OH_ArkUI_AnimateOption_GetExpectedFrameRateRange (ArkUI_AnimateOption *option) Obtains the expected frame rate range of an animation.
void OH_ArkUI_AnimateOption_SetDuration (ArkUI_AnimateOption *option, int32_t value) Sets the animation duration.
void OH_ArkUI_AnimateOption_SetTempo (ArkUI_AnimateOption *option, float value) Sets the playback speed of an animation.
void OH_ArkUI_AnimateOption_SetCurve (ArkUI_AnimateOption *option, ArkUI_AnimationCurve value) Animation curve.
void OH_ArkUI_AnimateOption_SetDelay (ArkUI_AnimateOption *option, int32_t value) Sets the animation delay.
void OH_ArkUI_AnimateOption_SetIterations (ArkUI_AnimateOption *option, int32_t value) Number of times that the frame animation is played.
void OH_ArkUI_AnimateOption_SetPlayMode (ArkUI_AnimateOption *option, ArkUI_AnimationPlayMode value) Sets the playback mode for an animation.
void OH_ArkUI_AnimateOption_SetExpectedFrameRateRange (ArkUI_AnimateOption *option, ArkUI_ExpectedFrameRateRange *value) Defines the expected frame rate range of the animation.
void OH_ArkUI_AnimateOption_SetICurve (ArkUI_AnimateOption *option, ArkUI_CurveHandle value) Sets the animation curve for an animation.
ArkUI_CurveHandle OH_ArkUI_AnimateOption_GetICurve (ArkUI_AnimateOption *option) Obtains the animation curve of an animation.
ArkUI_KeyframeAnimateOption * OH_ArkUI_KeyframeAnimateOption_Create (int32_t size) Obtains the keyframe animation parameters.
void OH_ArkUI_KeyframeAnimateOption_Dispose (ArkUI_KeyframeAnimateOption *option) Destroys a keyframe animation parameter object.
int32_t OH_ArkUI_KeyframeAnimateOption_SetDelay (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.
int32_t OH_ArkUI_KeyframeAnimateOption_SetIterations (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.
int32_t OH_ArkUI_KeyframeAnimateOption_RegisterOnFinishCallback (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.
int32_t OH_ArkUI_KeyframeAnimateOption_SetDuration (ArkUI_KeyframeAnimateOption *option, int32_t value, int32_t index) Sets the duration of a keyframe animation, in milliseconds.
int32_t OH_ArkUI_KeyframeAnimateOption_SetCurve (ArkUI_KeyframeAnimateOption *option, ArkUI_CurveHandle value, int32_t index) Sets the animation curve for a specific keyframe in a keyframe animation.
int32_t OH_ArkUI_KeyframeAnimateOption_RegisterOnEventCallback (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.
int32_t OH_ArkUI_KeyframeAnimateOption_GetDelay (ArkUI_KeyframeAnimateOption *option) Obtains the overall delay of a keyframe animation
int32_t OH_ArkUI_KeyframeAnimateOption_GetIterations (ArkUI_KeyframeAnimateOption *option) Obtains the number of times that a keyframe animation is played.
int32_t OH_ArkUI_KeyframeAnimateOption_GetDuration (ArkUI_KeyframeAnimateOption *option, int32_t index) Obtains the duration of a specific state in a keyframe animation.
ArkUI_CurveHandle OH_ArkUI_KeyframeAnimateOption_GetCurve (ArkUI_KeyframeAnimateOption *option, int32_t index) Obtains the animation curve of a specific state in a keyframe animation.
ArkUI_AnimatorOption * OH_ArkUI_AnimatorOption_Create (int32_t keyframeSize) Creates an animator parameter object.
void OH_ArkUI_AnimatorOption_Dispose (ArkUI_AnimatorOption *option) Destroys an animator parameter object.
int32_t OH_ArkUI_AnimatorOption_SetDuration (ArkUI_AnimatorOption *option, int32_t value) Sets the duration of an animation, in milliseconds.
int32_t OH_ArkUI_AnimatorOption_SetDelay (ArkUI_AnimatorOption *option, int32_t value) Sets the delay of animation playback, in milliseconds.
int32_t OH_ArkUI_AnimatorOption_SetIterations (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.
int32_t OH_ArkUI_AnimatorOption_SetFill (ArkUI_AnimatorOption *option, ArkUI_AnimationFill value) Sets whether the animator animation is restored to the initial state after being executed.
int32_t OH_ArkUI_AnimatorOption_SetDirection (ArkUI_AnimatorOption *option, ArkUI_AnimationDirection value) Sets the playback direction.
int32_t OH_ArkUI_AnimatorOption_SetCurve (ArkUI_AnimatorOption *option, ArkUI_CurveHandle value) Sets the interpolation curve for the animation of an animator.
int32_t OH_ArkUI_AnimatorOption_SetBegin (ArkUI_AnimatorOption *option, float value) Sets the interpolation start point for the animation of an animator.
int32_t OH_ArkUI_AnimatorOption_SetEnd (ArkUI_AnimatorOption *option, float value) Sets the interpolation end point for the animation of an animator.
int32_t OH_ArkUI_AnimatorOption_SetExpectedFrameRateRange (ArkUI_AnimatorOption *option, ArkUI_ExpectedFrameRateRange *value) Sets the expected frame rate range of an animation.
int32_t OH_ArkUI_AnimatorOption_SetKeyframe (ArkUI_AnimatorOption *option, float time, float value, int32_t index) Sets the keyframe parameters of an animation.
int32_t OH_ArkUI_AnimatorOption_SetKeyframeCurve (ArkUI_AnimatorOption *option, ArkUI_CurveHandle value, int32_t index) Sets the keyframe curve type for the animation of an animator.
int32_t OH_ArkUI_AnimatorOption_GetDuration (ArkUI_AnimatorOption *option) Obtains the duration for playing an animation.
int32_t OH_ArkUI_AnimatorOption_GetDelay (ArkUI_AnimatorOption *option) Obtains the delay for playing an animation.
int32_t OH_ArkUI_AnimatorOption_GetIterations (ArkUI_AnimatorOption *option) Obtains the number of times that an animation is played.
ArkUI_AnimationFill OH_ArkUI_AnimatorOption_GetFill (ArkUI_AnimatorOption *option) Obtains whether the animator animation is restored to the initial state after being executed.
ArkUI_AnimationDirection OH_ArkUI_AnimatorOption_GetDirection (ArkUI_AnimatorOption *option) Obtains the playback direction of an animation.
ArkUI_CurveHandle OH_ArkUI_AnimatorOption_GetCurve (ArkUI_AnimatorOption *option) Obtains the interpolation curve of the animation of an animator.
float OH_ArkUI_AnimatorOption_GetBegin (ArkUI_AnimatorOption *option) Obtains the interpolation start point of an animation.
float OH_ArkUI_AnimatorOption_GetEnd (ArkUI_AnimatorOption *option) Obtains the interpolation end point of an animation.
ArkUI_ExpectedFrameRateRange * OH_ArkUI_AnimatorOption_GetExpectedFrameRateRange (ArkUI_AnimatorOption *option) Obtains the expected frame rate range of an animation.
float OH_ArkUI_AnimatorOption_GetKeyframeTime (ArkUI_AnimatorOption *option, int32_t index) Obtains the keyframe time of an animation.
float OH_ArkUI_AnimatorOption_GetKeyframeValue (ArkUI_AnimatorOption *option, int32_t index) Obtains the keyframe value of an animation.
ArkUI_CurveHandle OH_ArkUI_AnimatorOption_GetKeyframeCurve (ArkUI_AnimatorOption *option, int32_t index) Obtains the interpolation curve for a keyframe in the animation of an animator.
void * OH_ArkUI_AnimatorEvent_GetUserData (ArkUI_AnimatorEvent *event) Obtains the custom object in an animation event object.
void * OH_ArkUI_AnimatorOnFrameEvent_GetUserData (ArkUI_AnimatorOnFrameEvent *event) Obtains the custom object in an animation event object.
float OH_ArkUI_AnimatorOnFrameEvent_GetValue (ArkUI_AnimatorOnFrameEvent *event) Obtains the current progress in an animation event object.
int32_t OH_ArkUI_AnimatorOption_RegisterOnFrameCallback (ArkUI_AnimatorOption *option, void *userData, void(*callback)(ArkUI_AnimatorOnFrameEvent *event)) Sets the callback invoked when the animator receives a frame.
int32_t OH_ArkUI_AnimatorOption_RegisterOnFinishCallback (ArkUI_AnimatorOption *option, void *userData, void(*callback)(ArkUI_AnimatorEvent *event)) Sets the callback invoked when the animation playback is complete.
int32_t OH_ArkUI_AnimatorOption_RegisterOnCancelCallback (ArkUI_AnimatorOption *option, void *userData, void(*callback)(ArkUI_AnimatorEvent *event)) Sets the callback invoked when the animation playback is canceled.
int32_t OH_ArkUI_AnimatorOption_RegisterOnRepeatCallback (ArkUI_AnimatorOption *option, void *userData, void(*callback)(ArkUI_AnimatorEvent *event)) Sets the callback invoked when the animation playback is repeated.
int32_t OH_ArkUI_Animator_ResetAnimatorOption (ArkUI_AnimatorHandle animator, ArkUI_AnimatorOption *option) Resets an animator configuration.
int32_t OH_ArkUI_Animator_Play (ArkUI_AnimatorHandle animator) Starts the animation of an animator.
int32_t OH_ArkUI_Animator_Finish (ArkUI_AnimatorHandle animator) Ends the animation of an animator.
int32_t OH_ArkUI_Animator_Pause (ArkUI_AnimatorHandle animator) Pauses the animation of an animator.
int32_t OH_ArkUI_Animator_Cancel (ArkUI_AnimatorHandle animator) Cancels the animation of an animator.
int32_t OH_ArkUI_Animator_Reverse (ArkUI_AnimatorHandle animator) Plays this animation in reverse order.
ArkUI_CurveHandle OH_ArkUI_Curve_CreateCurveByType (ArkUI_AnimationCurve curve) Implements initialization for the interpolation curve, which is used to create an interpolation curve based on the input parameter.
ArkUI_CurveHandle OH_ArkUI_Curve_CreateStepsCurve (int32_t count, bool end) Creates a step curve.
ArkUI_CurveHandle OH_ArkUI_Curve_CreateCubicBezierCurve (float x1, float y1, float x2, float y2) Creates a cubic Bezier curve.
ArkUI_CurveHandle 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.
ArkUI_CurveHandle 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.
ArkUI_CurveHandle 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.
ArkUI_CurveHandle 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.
ArkUI_CurveHandle OH_ArkUI_Curve_CreateCustomCurve (void *userData, float(*interpolate)(float fraction, void *userdata)) Creates a custom curve.
void OH_ArkUI_Curve_DisposeCurve (ArkUI_CurveHandle curveHandle) Disposes of a custom curve.
ArkUI_TransitionEffect * OH_ArkUI_CreateOpacityTransitionEffect (float opacity) Creates an opacity object for component transition.
ArkUI_TransitionEffect * OH_ArkUI_CreateTranslationTransitionEffect (ArkUI_TranslationOptions *translate) Creates a translation object for component transition.
ArkUI_TransitionEffect * OH_ArkUI_CreateScaleTransitionEffect (ArkUI_ScaleOptions *scale) Creates a scaling object for component transition.
ArkUI_TransitionEffect * OH_ArkUI_CreateRotationTransitionEffect (ArkUI_RotationOptions *rotate) Creates a rotation object for component transition.
ArkUI_TransitionEffect * OH_ArkUI_CreateMovementTransitionEffect (ArkUI_TransitionEdge move) Creates a movement object for component transition.
ArkUI_TransitionEffect * OH_ArkUI_CreateAsymmetricTransitionEffect (ArkUI_TransitionEffect *appear, ArkUI_TransitionEffect *disappear) Creates an asymmetric transition effect.
void OH_ArkUI_TransitionEffect_Dispose (ArkUI_TransitionEffect *option) Disposes of a transition effect.
int32_t OH_ArkUI_TransitionEffect_Combine (ArkUI_TransitionEffect *option, ArkUI_TransitionEffect *combine) Sets a combination of transition effects.
int32_t OH_ArkUI_TransitionEffect_SetAnimation (ArkUI_TransitionEffect *option, ArkUI_AnimateOption *animation) Sets transition effect animation settings.
void OH_ArkUI_DialogDismissEvent_SetShouldBlockDismiss (ArkUI_DialogDismissEvent *event, bool shouldBlockDismiss) Sets whether to block the system behavior of dismissing a dialog box.
void * OH_ArkUI_DialogDismissEvent_GetUserData (ArkUI_DialogDismissEvent *event) Obtains the pointer to user data in a dialog box dismiss event object.
int32_t OH_ArkUI_DialogDismissEvent_GetDismissReason (ArkUI_DialogDismissEvent *event) Obtains the dismissal reason from a dialog box dismiss event object.
bool OH_ArkUI_GestureInterruptInfo_GetSystemFlag (const ArkUI_GestureInterruptInfo *event) Checks whether a gesture is a built-in gesture of the component.
ArkUI_GestureRecognizer * OH_ArkUI_GestureInterruptInfo_GetRecognizer (const ArkUI_GestureInterruptInfo *event) Obtains the pointer to interrupted gesture recognizer.
ArkUI_GestureEvent * OH_ArkUI_GestureInterruptInfo_GetGestureEvent (const ArkUI_GestureInterruptInfo *event) Obtains the pointer to the interrupted gesture event.
int32_t OH_ArkUI_GestureInterruptInfo_GetSystemRecognizerType (const ArkUI_GestureInterruptInfo *event) Obtains the type of the system gesture to trigger.
ArkUI_GestureEventActionType OH_ArkUI_GestureEvent_GetActionType (const ArkUI_GestureEvent *event) Obtains the gesture event type.
ArkUI_NodeHandle OH_ArkUI_GestureEvent_GetResponseNode (ArkUI_GestureEvent *event) Obtains the node that responds to the gesture.
const ArkUI_UIInputEvent * OH_ArkUI_GestureEvent_GetRawInputEvent (const ArkUI_GestureEvent *event) Obtains gesture input.
int32_t OH_ArkUI_LongPress_GetRepeatCount (const ArkUI_GestureEvent *event) Obtains the number of times that a long press gesture is triggered periodically.
float OH_ArkUI_PanGesture_GetVelocity (const ArkUI_GestureEvent *event) Obtains the velocity of a pan gesture along the main axis.
float OH_ArkUI_PanGesture_GetVelocityX (const ArkUI_GestureEvent *event) Obtains the velocity of a pan gesture along the x-axis.
float OH_ArkUI_PanGesture_GetVelocityY (const ArkUI_GestureEvent *event) Obtains the velocity of a pan gesture along the y-axis.
float OH_ArkUI_PanGesture_GetOffsetX (const ArkUI_GestureEvent *event) Obtains the relative offset of a pan gesture along the x-axis.
float OH_ArkUI_PanGesture_GetOffsetY (const ArkUI_GestureEvent *event) Obtains the relative offset of a pan gesture along the y-axis.
float OH_ArkUI_SwipeGesture_GetAngle (const ArkUI_GestureEvent *event) Obtains the angle information of the swipe gesture.
float OH_ArkUI_SwipeGesture_GetVelocity (const ArkUI_GestureEvent *event) Obtains the average velocity of all fingers used in the swipe gesture.
float OH_ArkUI_RotationGesture_GetAngle (const ArkUI_GestureEvent *event) Obtains the angle information of a rotation gesture.
float OH_ArkUI_PinchGesture_GetScale (const ArkUI_GestureEvent *event) Obtains the scale ratio of a pinch gesture.
float 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.
float 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.
ArkUI_NodeHandle OH_ArkUI_GestureEvent_GetNode (const ArkUI_GestureEvent *event) Obtains the ArkUI component to which the gesture is bound.
int32_t OH_ArkUI_GetResponseRecognizersFromInterruptInfo (const ArkUI_GestureInterruptInfo *event, ArkUI_GestureRecognizerHandleArray *responseChain, int32_t *count) Obtains information about a gesture response chain.
int32_t OH_ArkUI_SetGestureRecognizerEnabled (ArkUI_GestureRecognizer *recognizer, bool enabled) Sets the enabled state of a gesture recognizer.
bool OH_ArkUI_GetGestureRecognizerEnabled (ArkUI_GestureRecognizer *recognizer) Obtains the enabled state of a gesture recognizer.
int32_t OH_ArkUI_GetGestureRecognizerState (ArkUI_GestureRecognizer *recognizer, ArkUI_GestureRecognizerState *state) Obtains the state of a gesture recognizer.
int32_t OH_ArkUI_GetGestureEventTargetInfo (ArkUI_GestureRecognizer *recognizer, ArkUI_GestureEventTargetInfo **info) Obtains the information about a gesture event target.
int32_t OH_ArkUI_GestureEventTargetInfo_IsScrollBegin (ArkUI_GestureEventTargetInfo *info, bool *ret) Obtains whether this scroll container is scrolled to the top.
int32_t OH_ArkUI_GestureEventTargetInfo_IsScrollEnd (ArkUI_GestureEventTargetInfo *info, bool *ret) Obtains whether this scroll container is scrolled to the bottom.
int32_t OH_ArkUI_GetPanGestureDirectionMask (ArkUI_GestureRecognizer *recognizer, ArkUI_GestureDirectionMask *directionMask) Obtains the direction of a pan gesture.
bool OH_ArkUI_IsBuiltInGesture (ArkUI_GestureRecognizer *recognizer) Obtains whether a gesture is a built-in gesture.
int32_t OH_ArkUI_GetGestureTag (ArkUI_GestureRecognizer *recognizer, char *buffer, int32_t bufferSize, int32_t *result) Obtains the tag of a gesture recognizer.
int32_t 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.
bool OH_ArkUI_IsGestureRecognizerValid (ArkUI_GestureRecognizer *recognizer) Obtains whether a gesture recognizer is valid.
void * OH_ArkUI_ParallelInnerGestureEvent_GetUserData (ArkUI_ParallelInnerGestureEvent *event) Obtains custom data in the parallel internal gesture event.
ArkUI_GestureRecognizer * OH_ArkUI_ParallelInnerGestureEvent_GetCurrentRecognizer (ArkUI_ParallelInnerGestureEvent *event) Obtains the current gesture recognizer in a parallel internal gesture event.
int32_t OH_ArkUI_ParallelInnerGestureEvent_GetConflictRecognizers (ArkUI_ParallelInnerGestureEvent *event, ArkUI_GestureRecognizerHandleArray *array, int32_t *size) Obtains the conflicting gesture recognizers in a parallel internal gesture event.
int32_t OH_ArkUI_SetArkUIGestureRecognizerDisposeNotify (ArkUI_GestureRecognizer *recognizer, ArkUI_GestureRecognizerDestructNotifyCallback callback, void *userData) Sets a callback function for notifying gesture recognizer destruction.
void * OH_ArkUI_QueryModuleInterfaceByName (ArkUI_NativeAPIVariantKind type, const char *structName) Obtains the native API set of a specified type.
ArkUI_KeyEventType OH_ArkUI_KeyEvent_GetType (const ArkUI_UIInputEvent *event) Obtains the type of a key event.
int32_t OH_ArkUI_KeyEvent_GetKeyCode (const ArkUI_UIInputEvent *event) Obtains the key code from a key event.
const char * OH_ArkUI_KeyEvent_GetKeyText (const ArkUI_UIInputEvent *event) Obtains the key value from a key event.
ArkUI_KeySourceType OH_ArkUI_KeyEvent_GetKeySource (const ArkUI_UIInputEvent *event) Obtains the type of input device that triggers a key event.
void OH_ArkUI_KeyEvent_StopPropagation (const ArkUI_UIInputEvent *event, bool stopPropagation) Stops a key event from bubbling upwards or downwards.
ArkUI_KeyIntension OH_ArkUI_KeyEvent_GetKeyIntensionCode (const ArkUI_UIInputEvent *event) Obtains the intention code associated with a key event.
uint32_t OH_ArkUI_KeyEvent_GetUnicode (const 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.
void OH_ArkUI_KeyEvent_SetConsumed (const ArkUI_UIInputEvent *event, bool isConsumed) Sets whether a key event is consumed in the key event callback.
ArkUI_NodeEventType OH_ArkUI_NodeEvent_GetEventType (ArkUI_NodeEvent *event) Obtains the type of a component event.
int32_t OH_ArkUI_NodeEvent_GetTargetId (ArkUI_NodeEvent *event) Obtains the custom ID of a component event.
ArkUI_NodeHandle OH_ArkUI_NodeEvent_GetNodeHandle (ArkUI_NodeEvent *event) Obtains the component object that triggers an event.
ArkUI_UIInputEvent * OH_ArkUI_NodeEvent_GetInputEvent (ArkUI_NodeEvent *event) Obtains input event (for example, touch event) data for a component event.
ArkUI_NodeComponentEvent * OH_ArkUI_NodeEvent_GetNodeComponentEvent (ArkUI_NodeEvent *event) Obtains the numerical data in a component event.
ArkUI_StringAsyncEvent * OH_ArkUI_NodeEvent_GetStringAsyncEvent (ArkUI_NodeEvent *event) Obtains the string data in a component event.
void * OH_ArkUI_NodeEvent_GetUserData (ArkUI_NodeEvent *event) Obtains the custom data in a component event.
int32_t OH_ArkUI_NodeEvent_GetNumberValue (ArkUI_NodeEvent *event, int32_t index, ArkUI_NumberValue *value) Obtains the numeric-type parameter of a component event.
int32_t OH_ArkUI_NodeEvent_GetStringValue (ArkUI_NodeEvent *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.
int32_t OH_ArkUI_NodeEvent_SetReturnNumberValue (ArkUI_NodeEvent *event, ArkUI_NumberValue *value, int32_t size) Sets the return value for a component event.
ArkUI_NodeAdapterHandle OH_ArkUI_NodeAdapter_Create () Creates a component adapter.
void OH_ArkUI_NodeAdapter_Dispose (ArkUI_NodeAdapterHandle handle) Destroys a component adapter.
int32_t OH_ArkUI_NodeAdapter_SetTotalNodeCount (ArkUI_NodeAdapterHandle handle, uint32_t size) Sets the total number of elements in the specified adapter.
uint32_t OH_ArkUI_NodeAdapter_GetTotalNodeCount (ArkUI_NodeAdapterHandle handle) Obtains the total number of elements in the specified adapter.
int32_t OH_ArkUI_NodeAdapter_RegisterEventReceiver (ArkUI_NodeAdapterHandle handle, void *userData, void(*receiver)(ArkUI_NodeAdapterEvent *event)) Registers an event callback for the specified adapter.
void OH_ArkUI_NodeAdapter_UnregisterEventReceiver (ArkUI_NodeAdapterHandle handle) Unregisters an event callback for the specified adapter.
int32_t OH_ArkUI_NodeAdapter_ReloadAllItems (ArkUI_NodeAdapterHandle handle) Instructs the specified adapter to reload all elements.
int32_t OH_ArkUI_NodeAdapter_ReloadItem (ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount) Instructs the specified adapter to reload certain elements.
int32_t OH_ArkUI_NodeAdapter_RemoveItem (ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount) Instructs the specified adapter to remove certain elements.
int32_t OH_ArkUI_NodeAdapter_InsertItem (ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount) Instructs the specified adapter to insert certain elements.
int32_t OH_ArkUI_NodeAdapter_MoveItem (ArkUI_NodeAdapterHandle handle, uint32_t from, uint32_t to) Instructs the specified adapter to move certain elements.
int32_t OH_ArkUI_NodeAdapter_GetAllItems (ArkUI_NodeAdapterHandle handle, ArkUI_NodeHandle **items, uint32_t *size) Obtains all elements stored in the specified adapter.
void * OH_ArkUI_NodeAdapterEvent_GetUserData (ArkUI_NodeAdapterEvent *event) Obtains the custom data passed in during registration of the specified event.
ArkUI_NodeAdapterEventType OH_ArkUI_NodeAdapterEvent_GetType (ArkUI_NodeAdapterEvent *event) Obtains the event type.
ArkUI_NodeHandle OH_ArkUI_NodeAdapterEvent_GetRemovedNode (ArkUI_NodeAdapterEvent *event) Obtains the element to be removed for the event to be destroyed.
uint32_t OH_ArkUI_NodeAdapterEvent_GetItemIndex (ArkUI_NodeAdapterEvent *event) Obtains the index of the element to be operated for the specified adapter event.
ArkUI_NodeHandle OH_ArkUI_NodeAdapterEvent_GetHostNode (ArkUI_NodeAdapterEvent *event) Obtains the scrollable container node that uses the specified adapter.
int32_t OH_ArkUI_NodeAdapterEvent_SetItem (ArkUI_NodeAdapterEvent *event, ArkUI_NodeHandle node) Sets the component to be added to the specified adapter.
int32_t OH_ArkUI_NodeAdapterEvent_SetNodeId (ArkUI_NodeAdapterEvent *event, int32_t id) Sets the component ID to be generated.
ArkUI_LayoutConstraint * OH_ArkUI_NodeCustomEvent_GetLayoutConstraintInMeasure (ArkUI_NodeCustomEvent *event) Obtains the size constraint for measurement through a custom component event.
ArkUI_IntOffset OH_ArkUI_NodeCustomEvent_GetPositionInLayout (ArkUI_NodeCustomEvent *event) Obtains the expected position of a component relative to its parent component in the layout phase through a custom component event.
ArkUI_DrawContext * OH_ArkUI_NodeCustomEvent_GetDrawContextInDraw (ArkUI_NodeCustomEvent *event) Obtains the drawing context through a custom component event.
int32_t OH_ArkUI_NodeCustomEvent_GetEventTargetId (ArkUI_NodeCustomEvent *event) Obtains the ID of a custom component event.
void * OH_ArkUI_NodeCustomEvent_GetUserData (ArkUI_NodeCustomEvent *event) Obtains custom event parameters through a custom component event.
ArkUI_NodeHandle OH_ArkUI_NodeCustomEvent_GetNodeHandle (ArkUI_NodeCustomEvent *event) Obtains a component object through a custom component event.
ArkUI_NodeCustomEventType OH_ArkUI_NodeCustomEvent_GetEventType (ArkUI_NodeCustomEvent *event) Obtains the event type through a custom component event.
int32_t OH_ArkUI_NodeCustomEvent_GetCustomSpanMeasureInfo (ArkUI_NodeCustomEvent *event, ArkUI_CustomSpanMeasureInfo *info) Obtains the measurement information of a custom span through a custom component event.
int32_t OH_ArkUI_NodeCustomEvent_SetCustomSpanMetrics (ArkUI_NodeCustomEvent *event, ArkUI_CustomSpanMetrics *metrics) Sets the measurement metrics of a custom span through a custom component event.
int32_t OH_ArkUI_NodeCustomEvent_GetCustomSpanDrawInfo (ArkUI_NodeCustomEvent *event, ArkUI_CustomSpanDrawInfo *info) Obtains the drawing information of a custom span through a custom component event.
int32_t OH_ArkUI_NodeContent_RegisterCallback (ArkUI_NodeContentHandle content, ArkUI_NodeContentCallback callback) Registers the callback for the NodeContent event.
ArkUI_NodeContentEventType OH_ArkUI_NodeContentEvent_GetEventType (ArkUI_NodeContentEvent *event) Obtains the type of the specified NodeContent event.
ArkUI_NodeContentHandle OH_ArkUI_NodeContentEvent_GetNodeContentHandle (ArkUI_NodeContentEvent *event) Obtains the object that triggers the specified NodeContent event.
int32_t OH_ArkUI_NodeContent_SetUserData (ArkUI_NodeContentHandle content, void *userData) Saves custom data to the specified NodeContent object.
void * OH_ArkUI_NodeContent_GetUserData (ArkUI_NodeContentHandle content) Obtains the custom data saved on the specified NodeContent object.
int32_t OH_ArkUI_NodeContent_AddNode (ArkUI_NodeContentHandle content, ArkUI_NodeHandle node) Adds an ArkUI component node to the specified NodeContent object.
int32_t OH_ArkUI_NodeContent_RemoveNode (ArkUI_NodeContentHandle content, ArkUI_NodeHandle node) Removes an ArkUI component node from the specified NodeContent object.
int32_t OH_ArkUI_NodeContent_InsertNode (ArkUI_NodeContentHandle content, ArkUI_NodeHandle node, int32_t position) Inserts an ArkUI component node into a specific position of the specified NodeContent object.
int32_t OH_ArkUI_NodeUtils_GetLayoutSize (ArkUI_NodeHandle node, ArkUI_IntSize *size) Obtains the layout area size of a component. The size does not count in transformation attributes, such as scale.
int32_t OH_ArkUI_NodeUtils_GetLayoutPosition (ArkUI_NodeHandle node, ArkUI_IntOffset *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.
int32_t OH_ArkUI_NodeUtils_GetLayoutPositionInWindow (ArkUI_NodeHandle node, ArkUI_IntOffset *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.
int32_t OH_ArkUI_NodeUtils_GetLayoutPositionInScreen (ArkUI_NodeHandle node, ArkUI_IntOffset *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.
int32_t OH_ArkUI_NodeUtils_GetPositionWithTranslateInWindow (ArkUI_NodeHandle node, ArkUI_IntOffset *translateOffset) Obtains the position of the component in the window, including the translate attribute.
int32_t OH_ArkUI_NodeUtils_GetPositionWithTranslateInScreen (ArkUI_NodeHandle node, ArkUI_IntOffset *translateOffset) Obtains the position of the component on the screen, including the translate attribute.
void OH_ArkUI_NodeUtils_AddCustomProperty (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.
void OH_ArkUI_NodeUtils_RemoveCustomProperty (ArkUI_NodeHandle node, const char *name) Removes a custom property that has been set for the specified component.
int32_t OH_ArkUI_NodeUtils_GetCustomProperty (ArkUI_NodeHandle node, const char *name, ArkUI_CustomProperty **handle) Obtains the value of a custom property of the specified component.
ArkUI_NodeHandle OH_ArkUI_NodeUtils_GetParentInPageTree (ArkUI_NodeHandle node) Obtains the parent node, which can be a component node created with ArkTS.
int32_t OH_ArkUI_NodeUtils_GetActiveChildrenInfo (ArkUI_NodeHandle head, ArkUI_ActiveChildrenInfo **handle) Obtains all active child nodes of the specified node. Spans are not counted as child nodes.
ArkUI_NodeHandle OH_ArkUI_NodeUtils_GetCurrentPageRootNode (ArkUI_NodeHandle node) Obtains the root node of the current page.
bool OH_ArkUI_NodeUtils_IsCreatedByNDK (ArkUI_NodeHandle node) Checks whether the specified component is created with the C API.
int32_t OH_ArkUI_NodeUtils_GetNodeType (ArkUI_NodeHandle node) Obtains the type of the specified node.
int32_t OH_ArkUI_List_CloseAllSwipeActions (ArkUI_NodeHandle node, void *userData, void(*onFinish)(void *userData)) Collapses the list items in the expanded state.
ArkUI_ContextHandle OH_ArkUI_GetContextByNode (ArkUI_NodeHandle node) Obtains the pointer to the UI context object of the specified node.
int32_t OH_ArkUI_RegisterSystemColorModeChangeEvent (ArkUI_NodeHandle node, void *userData, void(*onColorModeChange)(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.
void OH_ArkUI_UnregisterSystemColorModeChangeEvent (ArkUI_NodeHandle node) Unregisters the event listener for system color mode changes.
int32_t OH_ArkUI_RegisterSystemFontStyleChangeEvent (ArkUI_NodeHandle node, void *userData, void(*onFontStyleChange)(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.
void OH_ArkUI_UnregisterSystemFontStyleChangeEvent (ArkUI_NodeHandle node) Unregisters the event listener for system font style changes.
float OH_ArkUI_SystemFontStyleEvent_GetFontSizeScale (const ArkUI_SystemFontStyleEvent *event) Obtains the font size from the system font style change event.
float OH_ArkUI_SystemFontStyleEvent_GetFontWeightScale (const ArkUI_SystemFontStyleEvent *event) Obtains the font weight from the system font style change event.
int32_t OH_ArkUI_GetNodeHandleFromNapiValue (napi_env env, napi_value frameNode, ArkUI_NodeHandle *handle) Obtains a FrameNode object on the ArkTS side and maps it to an ArkUI_NodeHandle object on the native side.
int32_t OH_ArkUI_GetContextFromNapiValue (napi_env env, napi_value value, ArkUI_ContextHandle *context) Obtains a UIContext object on the ArkTS side and maps it to an ArkUI_ContextHandle object on the native side.
int32_t OH_ArkUI_GetNodeContentFromNapiValue (napi_env env, napi_value value, ArkUI_NodeContentHandle *content) Obtains a NodeContent object on the ArkTS side and maps it to an ArkUI_NodeContentHandle object on the native side.
int32_t OH_ArkUI_GetDrawableDescriptorFromNapiValue (napi_env env, napi_value value, ArkUI_DrawableDescriptor **drawableDescriptor) Maps a DrawableDescriptor object on the ArkTS side to an ArkUI_DrawableDescriptor object on the native side.
int32_t OH_ArkUI_GetDrawableDescriptorFromResourceNapiValue (napi_env env, napi_value value, ArkUI_DrawableDescriptor **drawableDescriptor) Maps an $r resource object on the ArkTS side to an ArkUI_DrawableDescriptor object on the native side.
ArkUI_ErrorCode OH_ArkUI_GetNavigationId (ArkUI_NodeHandle node, char *buffer, int32_t bufferSize, int32_t *writeLength) Obtains the ID of the Navigation component where the specified node is located.
ArkUI_ErrorCode OH_ArkUI_GetNavDestinationName (ArkUI_NodeHandle node, char *buffer, int32_t bufferSize, int32_t *writeLength) Obtains the name of the NavDestination component where the specified node is located.
ArkUI_ErrorCode OH_ArkUI_GetNavStackLength (ArkUI_NodeHandle node, int32_t *length) Obtains the length of the navigation stack where the specified node is located.
ArkUI_ErrorCode OH_ArkUI_GetNavDestinationNameByIndex (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.
ArkUI_ErrorCode OH_ArkUI_GetNavDestinationId (ArkUI_NodeHandle node, char *buffer, int32_t bufferSize, int32_t *writeLength) Obtains the ID of the NavDestination component where the specified node is located.
ArkUI_ErrorCode OH_ArkUI_GetNavDestinationState (ArkUI_NodeHandle node, ArkUI_NavDestinationState *state) Obtains the state of the NavDestination component where the specified node is located.
ArkUI_ErrorCode OH_ArkUI_GetNavDestinationIndex (ArkUI_NodeHandle node, int32_t *index) Obtains the index of the NavDestination component where the specified node is located in the navigation stack.
napi_value OH_ArkUI_GetNavDestinationParam (ArkUI_NodeHandle node) Obtains the parameters of the NavDestination component where the specified node is located.
ArkUI_ErrorCode OH_ArkUI_GetRouterPageIndex (ArkUI_NodeHandle node, int32_t *index) Obtains the index of the page where the specified node is located in the page stack for routing.
ArkUI_ErrorCode OH_ArkUI_GetRouterPageName (ArkUI_NodeHandle node, char *buffer, int32_t bufferSize, int32_t *writeLength) Obtains the name of the page where the specified node is located.
ArkUI_ErrorCode OH_ArkUI_GetRouterPagePath (ArkUI_NodeHandle node, char *buffer, int32_t bufferSize, int32_t *writeLength) Obtains the path to the page where the specified node is located.
ArkUI_ErrorCode OH_ArkUI_GetRouterPageState (ArkUI_NodeHandle node, ArkUI_RouterPageState *state) Obtains the state of the page where the specified node is located.
ArkUI_ErrorCode OH_ArkUI_GetRouterPageId (ArkUI_NodeHandle node, char *buffer, int32_t bufferSize, int32_t *writeLength) Obtains the ID of the page where the specified node is located.
ArkUI_LayoutConstraint * OH_ArkUI_LayoutConstraint_Create () Creates a size constraint.
ArkUI_LayoutConstraint * OH_ArkUI_LayoutConstraint_Copy (const ArkUI_LayoutConstraint *Constraint) Performs a deep copy of a size constraint.
void * OH_ArkUI_LayoutConstraint_Dispose (ArkUI_LayoutConstraint *Constraint) Disposes of the pointer to a size constraint.
int32_t OH_ArkUI_LayoutConstraint_GetMaxWidth (const ArkUI_LayoutConstraint *Constraint) Obtains the maximum width for a size constraint, in px.
int32_t OH_ArkUI_LayoutConstraint_GetMinWidth (const ArkUI_LayoutConstraint *Constraint) Obtains the minimum width for a size constraint, in px.
int32_t OH_ArkUI_LayoutConstraint_GetMaxHeight (const ArkUI_LayoutConstraint *Constraint) Obtains the maximum height for a size constraint, in px.
int32_t OH_ArkUI_LayoutConstraint_GetMinHeight (const ArkUI_LayoutConstraint *Constraint) Obtains the minimum height for a size constraint, in px.
int32_t OH_ArkUI_LayoutConstraint_GetPercentReferenceWidth (const ArkUI_LayoutConstraint *Constraint) Obtains the width percentage reference for a size constraint, in px.
int32_t OH_ArkUI_LayoutConstraint_GetPercentReferenceHeight (const ArkUI_LayoutConstraint *Constraint) Obtains the height percentage reference for a size constraint, in px.
void OH_ArkUI_LayoutConstraint_SetMaxWidth (ArkUI_LayoutConstraint *Constraint, int32_t value) Sets the maximum width.
void OH_ArkUI_LayoutConstraint_SetMinWidth (ArkUI_LayoutConstraint *Constraint, int32_t value) Sets the minimum width.
void OH_ArkUI_LayoutConstraint_SetMaxHeight (ArkUI_LayoutConstraint *Constraint, int32_t value) Sets the maximum height.
void OH_ArkUI_LayoutConstraint_SetMinHeight (ArkUI_LayoutConstraint *Constraint, int32_t value) Sets the minimum height.
void OH_ArkUI_LayoutConstraint_SetPercentReferenceWidth (ArkUI_LayoutConstraint *Constraint, int32_t value) Sets the width percentage reference.
void OH_ArkUI_LayoutConstraint_SetPercentReferenceHeight (ArkUI_LayoutConstraint *Constraint, int32_t value) Sets the height percentage reference.
void * OH_ArkUI_DrawContext_GetCanvas (ArkUI_DrawContext *context) Obtains the pointer to a canvas for drawing, which can be converted into the OH_Drawing_Canvas in the Drawing module.
ArkUI_IntSize OH_ArkUI_DrawContext_GetSize (ArkUI_DrawContext *context) Obtains the size of a drawing area.
ArkUI_WaterFlowSectionOption * OH_ArkUI_WaterFlowSectionOption_Create () Creates a water flow section configuration.
void OH_ArkUI_WaterFlowSectionOption_Dispose (ArkUI_WaterFlowSectionOption *option) Disposes of the pointer to a water flow section configuration.
void OH_ArkUI_WaterFlowSectionOption_SetSize (ArkUI_WaterFlowSectionOption *option, int32_t size) Sets the array length for a water flow section configuration.
int32_t OH_ArkUI_WaterFlowSectionOption_GetSize (ArkUI_WaterFlowSectionOption *option) Sets the array length for a water flow section configuration.
void OH_ArkUI_WaterFlowSectionOption_SetItemCount (ArkUI_WaterFlowSectionOption *option, int32_t index, int32_t itemCount) Sets the number of items in a water flow section.
int32_t OH_ArkUI_WaterFlowSectionOption_GetItemCount (ArkUI_WaterFlowSectionOption *option, int32_t index) Obtains the number of items in the water flow section that matches the specified index.
void OH_ArkUI_WaterFlowSectionOption_SetCrossCount (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.
int32_t OH_ArkUI_WaterFlowSectionOption_GetCrossCount (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.
void OH_ArkUI_WaterFlowSectionOption_SetColumnGap (ArkUI_WaterFlowSectionOption *, int32_t index, float columnGap) Sets the gap between columns in the specified water flow section.
float OH_ArkUI_WaterFlowSectionOption_GetColumnGap (ArkUI_WaterFlowSectionOption *option, int32_t index) Obtains the gap between columns in the water flow section that matches the specified index.
void OH_ArkUI_WaterFlowSectionOption_SetRowGap (ArkUI_WaterFlowSectionOption *option, int32_t index, float rowGap) Sets the gap between rows in the specified water flow section.
float OH_ArkUI_WaterFlowSectionOption_GetRowGap (ArkUI_WaterFlowSectionOption *option, int32_t index) Obtains the gap between rows in the water flow section that matches the specified index.
void OH_ArkUI_WaterFlowSectionOption_SetMargin (ArkUI_WaterFlowSectionOption *option, int32_t index, float marginTop, float marginRight, float marginBottom, float marginLeft) Sets the margins for the specified water flow section.
ArkUI_Margin OH_ArkUI_WaterFlowSectionOption_GetMargin (ArkUI_WaterFlowSectionOption *option, int32_t index) Obtains the margins of the water flow section that matches the specified index.
void OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndex (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.
void OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndexWithUserData (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.
ArkUI_GuidelineOption * OH_ArkUI_GuidelineOption_Create (int32_t size) Creates a guideline configuration for this RelativeContainer component.
void OH_ArkUI_GuidelineOption_Dispose (ArkUI_GuidelineOption *guideline) Disposes of a guideline configuration.
void OH_ArkUI_GuidelineOption_SetId (ArkUI_GuidelineOption *guideline, const char *value, int32_t index) Sets the ID of a guideline.
void OH_ArkUI_GuidelineOption_SetDirection (ArkUI_GuidelineOption *guideline, ArkUI_Axis value, int32_t index) Sets the direction of a guideline.
void OH_ArkUI_GuidelineOption_SetPositionStart (ArkUI_GuidelineOption *guideline, float value, int32_t index) Sets the distance between a guideline and the left or top of the container.
void OH_ArkUI_GuidelineOption_SetPositionEnd (ArkUI_GuidelineOption *guideline, float value, int32_t index) Sets the distance between a guideline and the right or bottom of the container.
const char * OH_ArkUI_GuidelineOption_GetId (ArkUI_GuidelineOption *guideline, int32_t index) Obtains the ID of a guideline.
ArkUI_Axis OH_ArkUI_GuidelineOption_GetDirection (ArkUI_GuidelineOption *guideline, int32_t index) Obtains the direction of a guideline.
float OH_ArkUI_GuidelineOption_GetPositionStart (ArkUI_GuidelineOption *guideline, int32_t index) Obtains the distance between a guideline and the left or top of the container.
float OH_ArkUI_GuidelineOption_GetPositionEnd (ArkUI_GuidelineOption *guideline, int32_t index) Obtains the distance between a guideline and the right or bottom of the container.
ArkUI_BarrierOption * OH_ArkUI_BarrierOption_Create (int32_t size) Creates a barrier configuration for this RelativeContainer component.
void OH_ArkUI_BarrierOption_Dispose (ArkUI_BarrierOption *barrierStyle) Disposes of a barrier configuration.
void OH_ArkUI_BarrierOption_SetId (ArkUI_BarrierOption *barrierStyle, const char *value, int32_t index) Sets the ID of a barrier.
void OH_ArkUI_BarrierOption_SetDirection (ArkUI_BarrierOption *barrierStyle, ArkUI_BarrierDirection value, int32_t index) Sets the direction of a barrier.
void OH_ArkUI_BarrierOption_SetReferencedId (ArkUI_BarrierOption *barrierStyle, const char *value, int32_t index) Sets the referenced components of a barrier.
const char * OH_ArkUI_BarrierOption_GetId (ArkUI_BarrierOption *barrierStyle, int32_t index) Obtains the ID of a barrier.
ArkUI_BarrierDirection OH_ArkUI_BarrierOption_GetDirection (ArkUI_BarrierOption *barrierStyle, int32_t index) Obtains the direction of a barrier.
const char * OH_ArkUI_BarrierOption_GetReferencedId (ArkUI_BarrierOption *barrierStyle, int32_t index, int32_t referencedIndex) Obtains the referenced components of a barrier.
int32_t OH_ArkUI_BarrierOption_GetReferencedIdSize (ArkUI_BarrierOption *barrierStyle, int32_t index) Obtains the number of referenced components of a barrier.
ArkUI_AlignmentRuleOption * OH_ArkUI_AlignmentRuleOption_Create () Creates an alignment rule configuration for this RelativeContainer component.
void OH_ArkUI_AlignmentRuleOption_Dispose (ArkUI_AlignmentRuleOption *option) Disposes of an alignment rule configuration of this RelativeContainer component.
void OH_ArkUI_AlignmentRuleOption_SetStart (ArkUI_AlignmentRuleOption *option, const char *id, ArkUI_HorizontalAlignment alignment) Sets the left alignment parameters.
void OH_ArkUI_AlignmentRuleOption_SetEnd (ArkUI_AlignmentRuleOption *option, const char *id, ArkUI_HorizontalAlignment alignment) Sets the right alignment parameters.
void OH_ArkUI_AlignmentRuleOption_SetCenterHorizontal (ArkUI_AlignmentRuleOption *option, const char *id, ArkUI_HorizontalAlignment alignment) Sets the horizontal center alignment parameters.
void OH_ArkUI_AlignmentRuleOption_SetTop (ArkUI_AlignmentRuleOption *option, const char *id, ArkUI_VerticalAlignment alignment) Sets the top alignment parameters.
void OH_ArkUI_AlignmentRuleOption_SetBottom (ArkUI_AlignmentRuleOption *option, const char *id, ArkUI_VerticalAlignment alignment) Sets the bottom alignment parameters.
void OH_ArkUI_AlignmentRuleOption_SetCenterVertical (ArkUI_AlignmentRuleOption *option, const char *id, ArkUI_VerticalAlignment alignment) Sets the vertical center alignment parameters.
void OH_ArkUI_AlignmentRuleOption_SetBiasHorizontal (ArkUI_AlignmentRuleOption *option, float horizontal) Sets the bias value of the component in the horizontal direction under the anchor constraints.
void OH_ArkUI_AlignmentRuleOption_SetBiasVertical (ArkUI_AlignmentRuleOption *option, float vertical) Sets the bias value of the component in the vertical direction under the anchor constraints.
const char * OH_ArkUI_AlignmentRuleOption_GetStartId (ArkUI_AlignmentRuleOption *option) Obtains the ID in the left alignment parameters.
ArkUI_HorizontalAlignment OH_ArkUI_AlignmentRuleOption_GetStartAlignment (ArkUI_AlignmentRuleOption *option) Obtains the alignment mode in left alignment parameters.
const char * OH_ArkUI_AlignmentRuleOption_GetEndId (ArkUI_AlignmentRuleOption *option) Obtains the ID in the right alignment parameters.
ArkUI_HorizontalAlignment OH_ArkUI_AlignmentRuleOption_GetEndAlignment (ArkUI_AlignmentRuleOption *option) Obtains the ID in the right alignment parameters.
const char * OH_ArkUI_AlignmentRuleOption_GetCenterIdHorizontal (ArkUI_AlignmentRuleOption *option) Obtains the ID in horizontal center alignment parameters.
ArkUI_HorizontalAlignment OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentHorizontal (ArkUI_AlignmentRuleOption *option) Obtains the ID in horizontal center alignment parameters.
const char * OH_ArkUI_AlignmentRuleOption_GetTopId (ArkUI_AlignmentRuleOption *option) Obtains the ID in top alignment parameters.
ArkUI_VerticalAlignment OH_ArkUI_AlignmentRuleOption_GetTopAlignment (ArkUI_AlignmentRuleOption *option) Obtains the ID in top alignment parameters.
const char * OH_ArkUI_AlignmentRuleOption_GetBottomId (ArkUI_AlignmentRuleOption *option) Obtains the ID in bottom alignment parameters.
ArkUI_VerticalAlignment OH_ArkUI_AlignmentRuleOption_GetBottomAlignment (ArkUI_AlignmentRuleOption *option) Obtains the ID in bottom alignment parameters.
const char * OH_ArkUI_AlignmentRuleOption_GetCenterIdVertical (ArkUI_AlignmentRuleOption *option) Obtains the ID in vertical center alignment parameters.
ArkUI_VerticalAlignment OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentVertical (ArkUI_AlignmentRuleOption *option) Obtains the ID in vertical center alignment parameters.
float OH_ArkUI_AlignmentRuleOption_GetBiasHorizontal (ArkUI_AlignmentRuleOption *option) Obtains the bias value in the horizontal direction.
float OH_ArkUI_AlignmentRuleOption_GetBiasVertical (ArkUI_AlignmentRuleOption *option) Obtains the bias value in the vertical direction.
ArkUI_SwiperIndicator * OH_ArkUI_SwiperIndicator_Create (ArkUI_SwiperIndicatorType type) Creates a navigation point indicator for this Swiper component.
void OH_ArkUI_SwiperIndicator_Dispose (ArkUI_SwiperIndicator *indicator) Disposes of the navigation point indicator of this Swiper component.
void OH_ArkUI_SwiperIndicator_SetStartPosition (ArkUI_SwiperIndicator *indicator, float value) Sets the distance between the navigation point indicator and the left edge of the Swiper component.
float OH_ArkUI_SwiperIndicator_GetStartPosition (ArkUI_SwiperIndicator *indicator) Obtains the distance between a navigation point indicator and the left edge of the Swiper component.
void OH_ArkUI_SwiperIndicator_SetTopPosition (ArkUI_SwiperIndicator *indicator, float value) Sets the distance between the navigation point indicator and the top edge of the Swiper component.
float OH_ArkUI_SwiperIndicator_GetTopPosition (ArkUI_SwiperIndicator *indicator) Obtains the distance between the navigation point indicator and the top edge of the Swiper component.
void OH_ArkUI_SwiperIndicator_SetEndPosition (ArkUI_SwiperIndicator *indicator, float value) Sets the distance between the navigation point indicator and the right edge of the Swiper component.
float OH_ArkUI_SwiperIndicator_GetEndPosition (ArkUI_SwiperIndicator *indicator) Obtains the distance between the navigation point indicator and the right edge of the Swiper component.
void OH_ArkUI_SwiperIndicator_SetBottomPosition (ArkUI_SwiperIndicator *indicator, float value) Sets the distance between the navigation point indicator and the bottom edge of the Swiper component.
float OH_ArkUI_SwiperIndicator_GetBottomPosition (ArkUI_SwiperIndicator *indicator) Obtains the distance between the navigation point indicator and the bottom edge of the Swiper component.
void OH_ArkUI_SwiperIndicator_SetItemWidth (ArkUI_SwiperIndicator *indicator, float value) Sets the width of a navigation point indicator of the dot style for the Swiper component.
float OH_ArkUI_SwiperIndicator_GetItemWidth (ArkUI_SwiperIndicator *indicator) Obtains the width of a navigation point indicator of the dot style of the Swiper component.
void OH_ArkUI_SwiperIndicator_SetItemHeight (ArkUI_SwiperIndicator *indicator, float value) Sets the height of a navigation point indicator of the dot style for the Swiper component.
float OH_ArkUI_SwiperIndicator_GetItemHeight (ArkUI_SwiperIndicator *indicator) Obtains the height of a navigation point indicator of the dot style of the Swiper component.
void OH_ArkUI_SwiperIndicator_SetSelectedItemWidth (ArkUI_SwiperIndicator *indicator, float value) Sets the width of the selected navigation point indicator of the dot style for the Swiper component.
float OH_ArkUI_SwiperIndicator_GetSelectedItemWidth (ArkUI_SwiperIndicator *indicator) Obtains the width of the selected navigation point indicator of the dot style of the Swiper component.
void OH_ArkUI_SwiperIndicator_SetSelectedItemHeight (ArkUI_SwiperIndicator *indicator, float value) Sets the height of the selected navigation point indicator of the dot style for the Swiper component.
float OH_ArkUI_SwiperIndicator_GetSelectedItemHeight (ArkUI_SwiperIndicator *indicator) Obtains the height of the selected navigation point indicator of the dot style of the Swiper component.
void OH_ArkUI_SwiperIndicator_SetMask (ArkUI_SwiperIndicator *indicator, int32_t mask) Sets whether to enable the mask for a navigation point indicator of the dot style for the Swiper component.
int32_t OH_ArkUI_SwiperIndicator_GetMask (ArkUI_SwiperIndicator *indicator) Obtains whether the mask is enabled for a navigation point indicator of the dot style of the Swiper component.
void OH_ArkUI_SwiperIndicator_SetColor (ArkUI_SwiperIndicator *indicator, uint32_t color) Sets the color of a navigation point indicator of the dot style for the Swiper component.
uint32_t OH_ArkUI_SwiperIndicator_GetColor (ArkUI_SwiperIndicator *indicator) Obtains the color of a navigation point indicator of the dot style of the Swiper component.
void OH_ArkUI_SwiperIndicator_SetSelectedColor (ArkUI_SwiperIndicator *indicator, uint32_t selectedColor) Sets the color of the selected navigation point indicator of the dot style for the Swiper component.
uint32_t OH_ArkUI_SwiperIndicator_GetSelectedColor (ArkUI_SwiperIndicator *indicator) Obtains the color of the selected navigation point indicator of the dot style of the Swiper component.
int32_t OH_ArkUI_SwiperIndicator_SetMaxDisplayCount (ArkUI_SwiperIndicator *indicator, int32_t maxDisplayCount) Sets the maximum number of dots for the navigation point indicator of the dot style.
int32_t OH_ArkUI_SwiperIndicator_GetMaxDisplayCount (ArkUI_SwiperIndicator *indicator) Obtains the maximum number of points for the navigation point indicator.
ArkUI_ListItemSwipeActionItem * OH_ArkUI_ListItemSwipeActionItem_Create () Creates a ListItemSwipeActionItem instance.
void OH_ArkUI_ListItemSwipeActionItem_Dispose (ArkUI_ListItemSwipeActionItem *item) Disposes of a ListItemSwipeActionItem instance.
void OH_ArkUI_ListItemSwipeActionItem_SetContent (ArkUI_ListItemSwipeActionItem *item, ArkUI_NodeHandle node) Sets the layout content for a ListItemSwipeActionItem instance.
void OH_ArkUI_ListItemSwipeActionItem_SetActionAreaDistance (ArkUI_ListItemSwipeActionItem *item, float distance) Sets the swipe distance threshold for deleting the list item.
float OH_ArkUI_ListItemSwipeActionItem_GetActionAreaDistance (ArkUI_ListItemSwipeActionItem *item) Obtains the swipe distance threshold for deleting the list item.
void OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionArea (ArkUI_ListItemSwipeActionItem *item, void(*callback)()) Sets the callback invoked each time the list item enters the delete area.
void OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionAreaWithUserData (ArkUI_ListItemSwipeActionItem *item, void *userData, void(*callback)(void *userData)) Sets the callback invoked each time the list item enters the delete area.
void OH_ArkUI_ListItemSwipeActionItem_SetOnAction (ArkUI_ListItemSwipeActionItem *item, void(*callback)()) Sets the callback invoked when the list item is deleted while in the delete area.
void OH_ArkUI_ListItemSwipeActionItem_SetOnActionWithUserData (ArkUI_ListItemSwipeActionItem *item, void *userData, void(*callback)(void *userData)) Sets the callback invoked when the list item is deleted while in the delete area.
void OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionArea (ArkUI_ListItemSwipeActionItem *item, void(*callback)()) Sets the callback invoked each time the list item exits the delete area.
void OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionAreaWithUserData (ArkUI_ListItemSwipeActionItem *item, void *userData, void(*callback)(void *userData)) Sets the callback invoked each time the list item exits the delete area.
void OH_ArkUI_ListItemSwipeActionItem_SetOnStateChange (ArkUI_ListItemSwipeActionItem *item, void(*callback)(ArkUI_ListItemSwipeActionState swipeActionState)) Sets the callback invoked when the swipe state of the list item changes.
void OH_ArkUI_ListItemSwipeActionItem_SetOnStateChangeWithUserData (ArkUI_ListItemSwipeActionItem *item, void *userData, void(*callback)(ArkUI_ListItemSwipeActionState swipeActionState, void *userData)) Sets the callback invoked when the swipe state of the list item changes.
ArkUI_ListItemSwipeActionOption * OH_ArkUI_ListItemSwipeActionOption_Create () Creates a ListItemSwipeActionOption instance.
void OH_ArkUI_ListItemSwipeActionOption_Dispose (ArkUI_ListItemSwipeActionOption *option) Disposes of a ListItemSwipeActionOption instance.
void OH_ArkUI_ListItemSwipeActionOption_SetStart (ArkUI_ListItemSwipeActionOption *option, 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.
void OH_ArkUI_ListItemSwipeActionOption_SetEnd (ArkUI_ListItemSwipeActionOption *option, 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.
void OH_ArkUI_ListItemSwipeActionOption_SetEdgeEffect (ArkUI_ListItemSwipeActionOption *option, ArkUI_ListItemSwipeEdgeEffect edgeEffect) Sets the edge effect used when the boundary of the scrolling area is reached.
int32_t OH_ArkUI_ListItemSwipeActionOption_GetEdgeEffect (ArkUI_ListItemSwipeActionOption *option) Obtains the edge effect used when the boundary of the scrolling area is reached.
void OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChange (ArkUI_ListItemSwipeActionOption *option, void(*callback)(float offset)) Sets the callback invoked when the scroll offset changes.
void OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChangeWithUserData (ArkUI_ListItemSwipeActionOption *option, void *userData, void(*callback)(float offset, void *userData)) Sets the callback invoked when the scroll offset changes.
ArkUI_AccessibilityState * OH_ArkUI_AccessibilityState_Create (void) Creates an accessibility state.
void OH_ArkUI_AccessibilityState_Dispose (ArkUI_AccessibilityState *state) Disposes of the pointer to an accessibility state.
void OH_ArkUI_AccessibilityState_SetDisabled (ArkUI_AccessibilityState *state, int32_t isDisabled) Sets whether an accessibility state is disabled.
int32_t OH_ArkUI_AccessibilityState_IsDisabled (ArkUI_AccessibilityState *state) Obtains whether an accessibility state is disabled.
void OH_ArkUI_AccessibilityState_SetSelected (ArkUI_AccessibilityState *state, int32_t isSelected) Sets whether an accessibility state is selected.
int32_t OH_ArkUI_AccessibilityState_IsSelected (ArkUI_AccessibilityState *state) Obtains whether an accessibility state is selected.
void OH_ArkUI_AccessibilityState_SetCheckedState (ArkUI_AccessibilityState *state, int32_t checkedState) Sets the check box state of an accessibility state.
int32_t OH_ArkUI_AccessibilityState_GetCheckedState (ArkUI_AccessibilityState *state) Obtains the check box state of an accessibility state.
ArkUI_AccessibilityValue * OH_ArkUI_AccessibilityValue_Create (void) Creates an AccessibilityValue instance.
void OH_ArkUI_AccessibilityValue_Dispose (ArkUI_AccessibilityValue *value) Disposes of the pointer to an AccessibilityValue instance.
void OH_ArkUI_AccessibilityValue_SetMin (ArkUI_AccessibilityValue *value, int32_t min) Sets the minimum accessibility value.
int32_t OH_ArkUI_AccessibilityValue_GetMin (ArkUI_AccessibilityValue *value) Obtains the minimum accessibility value.
void OH_ArkUI_AccessibilityValue_SetMax (ArkUI_AccessibilityValue *value, int32_t max) Sets the maximum accessibility value.
int32_t OH_ArkUI_AccessibilityValue_GetMax (ArkUI_AccessibilityValue *value) Obtains the maximum accessibility value.
void OH_ArkUI_AccessibilityValue_SetCurrent (ArkUI_AccessibilityValue *value, int32_t current) Sets the current accessibility value.
int32_t OH_ArkUI_AccessibilityValue_GetCurrent (ArkUI_AccessibilityValue *value) Obtains the current accessibility value.
void OH_ArkUI_AccessibilityValue_SetText (ArkUI_AccessibilityValue *value, const char *text) Sets the text description of an AccessibilityValue instance.
const char * OH_ArkUI_AccessibilityValue_GetText (ArkUI_AccessibilityValue *value) Obtains the text description of an AccessibilityValue instance.
ArkUI_ImageAnimatorFrameInfo * 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.
ArkUI_ImageAnimatorFrameInfo * OH_ArkUI_ImageAnimatorFrameInfo_CreateFromDrawableDescriptor (ArkUI_DrawableDescriptor *drawable) Creates an image frame information object based on a DrawableDescriptor object, with the image format being Resource or PixelMap.
void OH_ArkUI_ImageAnimatorFrameInfo_Dispose (ArkUI_ImageAnimatorFrameInfo *imageInfo) Disposes of the pointer to an image frame information object.
void OH_ArkUI_ImageAnimatorFrameInfo_SetWidth (ArkUI_ImageAnimatorFrameInfo *imageInfo, int32_t width) Sets the image width.
int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetWidth (ArkUI_ImageAnimatorFrameInfo *imageInfo) Obtains the image width.
void OH_ArkUI_ImageAnimatorFrameInfo_SetHeight (ArkUI_ImageAnimatorFrameInfo *imageInfo, int32_t height) Sets the image height.
int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetHeight (ArkUI_ImageAnimatorFrameInfo *imageInfo) Obtains the image height.
void OH_ArkUI_ImageAnimatorFrameInfo_SetTop (ArkUI_ImageAnimatorFrameInfo *imageInfo, int32_t top) Sets the vertical coordinate of an image relative to the upper left corner of the component.
int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetTop (ArkUI_ImageAnimatorFrameInfo *imageInfo) Obtains the vertical coordinate of an image relative to the upper left corner of the component.
void OH_ArkUI_ImageAnimatorFrameInfo_SetLeft (ArkUI_ImageAnimatorFrameInfo *imageInfo, int32_t left) Sets the horizontal coordinate of an image relative to the upper left corner of the component.
int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetLeft (ArkUI_ImageAnimatorFrameInfo *imageInfo) Obtains the horizontal coordinate of an image relative to the upper left corner of the component.
void OH_ArkUI_ImageAnimatorFrameInfo_SetDuration (ArkUI_ImageAnimatorFrameInfo *imageInfo, int32_t duration) Sets the playback duration of an image.
int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetDuration (ArkUI_ImageAnimatorFrameInfo *imageInfo) Obtains the playback duration of an image.
ArkUI_ListChildrenMainSize * OH_ArkUI_ListChildrenMainSizeOption_Create () Creates a ListChildrenMainSize instance.
void OH_ArkUI_ListChildrenMainSizeOption_Dispose (ArkUI_ListChildrenMainSize *option) Disposes of a ListChildrenMainSize instance.
int32_t OH_ArkUI_ListChildrenMainSizeOption_SetDefaultMainSize (ArkUI_ListChildrenMainSize *option, float defaultMainSize) Sets the default size in a ListChildrenMainSize instance.
float OH_ArkUI_ListChildrenMainSizeOption_GetDefaultMainSize (ArkUI_ListChildrenMainSize *option) Obtains the default size in a ListChildrenMainSize instance.
void OH_ArkUI_ListChildrenMainSizeOption_Resize (ArkUI_ListChildrenMainSize *option, int32_t totalSize) Resets the array size in a ListChildrenMainSize instance.
int32_t OH_ArkUI_ListChildrenMainSizeOption_Splice (ArkUI_ListChildrenMainSize *option, int32_t index, int32_t deleteCount, int32_t addCount) Changes the content of a ChildrenMainSizeOption array.
int32_t OH_ArkUI_ListChildrenMainSizeOption_UpdateSize (ArkUI_ListChildrenMainSize *option, int32_t index, float mainSize) Updates the values of a ChildrenMainSizeOption array.
float OH_ArkUI_ListChildrenMainSizeOption_GetMainSize (ArkUI_ListChildrenMainSize *option, int32_t index) Obtains the values of a ChildrenMainSizeOption array.
ArkUI_CustomSpanMeasureInfo * OH_ArkUI_CustomSpanMeasureInfo_Create (void) Creates measurement information for this custom span.
void OH_ArkUI_CustomSpanMeasureInfo_Dispose (ArkUI_CustomSpanMeasureInfo *info) Disposes of measurement information of a custom span.
float OH_ArkUI_CustomSpanMeasureInfo_GetFontSize (ArkUI_CustomSpanMeasureInfo *info) Obtains the font size of the parent text node of a custom span.
ArkUI_CustomSpanMetrics * OH_ArkUI_CustomSpanMetrics_Create (void) Creates measurement metrics for this custom span.
void OH_ArkUI_CustomSpanMetrics_Dispose (ArkUI_CustomSpanMetrics *metrics) Disposes of measurement metrics of this custom span.
int32_t OH_ArkUI_CustomSpanMetrics_SetWidth (ArkUI_CustomSpanMetrics *metrics, float width) Sets the width for a custom span.
int32_t OH_ArkUI_CustomSpanMetrics_SetHeight (ArkUI_CustomSpanMetrics *metrics, float height) Sets the height for a custom span.
ArkUI_CustomSpanDrawInfo * OH_ArkUI_CustomSpanDrawInfo_Create (void) Creates drawing information for this custom span.
void OH_ArkUI_CustomSpanDrawInfo_Dispose (ArkUI_CustomSpanDrawInfo *info) Disposes of drawing information for this custom span.
float OH_ArkUI_CustomSpanDrawInfo_GetXOffset (ArkUI_CustomSpanDrawInfo *info) Obtains the x-axis offset of the custom span relative to the mounted component.
float OH_ArkUI_CustomSpanDrawInfo_GetLineTop (ArkUI_CustomSpanDrawInfo *info) Obtains the top margin of the custom span relative to the mounted component.
float OH_ArkUI_CustomSpanDrawInfo_GetLineBottom (ArkUI_CustomSpanDrawInfo *info) Obtains the bottom margin of the custom span relative to the mounted component.
float OH_ArkUI_CustomSpanDrawInfo_GetBaseline (ArkUI_CustomSpanDrawInfo *info) Obtains the baseline offset of the custom span relative to the mounted component.
void OH_ArkUI_CustomProperty_Destroy (ArkUI_CustomProperty *handle) Destroys a CustomProperty instance.
const char * OH_ArkUI_CustomProperty_GetStringValue (ArkUI_CustomProperty *handle) Obtains the value of a custom property.
void OH_ArkUI_ActiveChildrenInfo_Destroy (ArkUI_ActiveChildrenInfo *handle) Destroys an ActiveChildrenInfo instance.
ArkUI_NodeHandle OH_ArkUI_ActiveChildrenInfo_GetNodeByIndex (ArkUI_ActiveChildrenInfo *handle, int32_t index) Obtains the child node at the specified index in the specified ActiveChildrenInfo instance.
int32_t OH_ArkUI_ActiveChildrenInfo_GetCount (ArkUI_ActiveChildrenInfo *handle) Obtains the number of nodes in the specified ActiveChildrenInfo instance.
ArkUI_StyledString * OH_ArkUI_StyledString_Create (OH_Drawing_TypographyStyle *style, OH_Drawing_FontCollection *collection) Creates an OH_Drawing_TextStyle object.
void OH_ArkUI_StyledString_Destroy (ArkUI_StyledString *handle) Destroys an OH_Drawing_FontCollection object and reclaims the memory occupied by the object.
void OH_ArkUI_StyledString_PushTextStyle (ArkUI_StyledString *handle, OH_Drawing_TextStyle *style) Pushes a text style to the top of the style stack of a styled string.
void OH_ArkUI_StyledString_AddText (ArkUI_StyledString *handle, const char *content) Adds text for a styled string.
void OH_ArkUI_StyledString_PopTextStyle (ArkUI_StyledString *handle) Pops the style at the top of the style stack of a styled string.
OH_Drawing_Typography * OH_ArkUI_StyledString_CreateTypography (ArkUI_StyledString *handle) Creates an OH_Drawing_Typography object based on an ArkUI_StyledString object.
void OH_ArkUI_StyledString_AddPlaceholder (ArkUI_StyledString *handle, OH_Drawing_PlaceholderSpan *placeholder) Adds a placeholder.
ArkUI_StyledString_Descriptor * OH_ArkUI_StyledString_Descriptor_Create (void) Creates an ArkUI_StyledString_Descriptor object.
void OH_ArkUI_StyledString_Descriptor_Destroy (ArkUI_StyledString_Descriptor *descriptor) Destroys an ArkUI_StyledString_Descriptor object and reclaims the memory occupied by the object.
int32_t OH_ArkUI_UnmarshallStyledStringDescriptor (uint8_t *buffer, size_t bufferSize, ArkUI_StyledString_Descriptor *descriptor, size_t *resultSize) Deserializes a byte array containing styled string information into a styled string.
int32_t OH_ArkUI_MarshallStyledStringDescriptor (uint8_t *buffer, size_t bufferSize, ArkUI_StyledString_Descriptor *descriptor) Serializes the styled string information into a byte array.
const char * OH_ArkUI_ConvertToHtml (ArkUI_StyledString_Descriptor *descriptor) Converts styled string information into HTML.

Macro Description

OH_ArkUI_GetModuleInterface

#define OH_ArkUI_GetModuleInterface( nativeAPIVariantKind,  structType,  structPtr )

Value:

 do { \
 void* anyNativeAPI = OH_ArkUI_QueryModuleInterfaceByName(nativeAPIVariantKind, #structType); \
 if (anyNativeAPI) { \
 structPtr = (structType*)(anyNativeAPI); \
 } \
 } while (0)
#include<arkui/native_interface.h>
#include<arkui/native_node.h>
 
ArkUI_NativeNodeAPI_1* nativeNodeApi = nullptr;
OH_ArkUI_GetModuleInterface(ARKUI_NATIVE_NODE, ArkUI_NativeNodeAPI_1, nativeNodeApi);

Description

Obtains the macro function corresponding to a struct pointer based on the struct type.

Since: 12

Type Description

ArkUI_AccessibilityState

typedef struct ArkUI_AccessibilityState ArkUI_AccessibilityState

Description

Defines a struct for the component accessibility state.

Since: 12

ArkUI_AccessibilityValue

typedef struct ArkUI_AccessibilityValue ArkUI_AccessibilityValue

Description

Defines a struct for the component accessibility value.

Since: 12

ArkUI_AlignmentRuleOption

typedef struct ArkUI_AlignmentRuleOption ArkUI_AlignmentRuleOption

Description

Defines the alignment rule in the relative container.

Since: 12

ArkUI_AnimateOption

typedef struct ArkUI_AnimateOption ArkUI_AnimateOption

Description

Defines a struct for the animation configuration.

Since: 12

ArkUI_AnimatorHandle

typedef struct ArkUI_Animator* ArkUI_AnimatorHandle

Description

Defines a struct for the pointer to an animator object.

Since: 12

ArkUI_AnimatorOption

typedef struct ArkUI_AnimatorOption ArkUI_AnimatorOption

Description

Defines the animator parameter object.

Since: 12

ArkUI_BarrierOption

typedef struct ArkUI_BarrierOption ArkUI_BarrierOption

Description

Defines the ID, direction, and referenced component of a barrier.

Since: 12

ArkUI_Context

typedef struct ArkUI_Context ArkUI_Context

Description

Defines a struct for a UI context object.

Since: 12

ArkUI_ContextHandle [1/2]

typedef struct ArkUI_Context* ArkUI_ContextHandle

Description

Defines a struct for the handle to the ArkUI native UI context.

Since: 12

ArkUI_ContextHandle [2/2]

typedef struct ArkUI_Context* ArkUI_ContextHandle

Description

Defines the handle to the ArkUI native UI context.

Since: 12

ArkUI_CurveHandle

typedef struct ArkUI_Curve* ArkUI_CurveHandle

Description

Defines a struct for the pointer to an interpolation curve.

Since: 12

ArkUI_CustomSpanDrawInfo

typedef struct ArkUI_CustomSpanDrawInfo ArkUI_CustomSpanDrawInfo

Description

Defines a struct for the drawing information of a custom span.

Since: 12

ArkUI_CustomSpanMeasureInfo

typedef struct ArkUI_CustomSpanMeasureInfo ArkUI_CustomSpanMeasureInfo

Description

Defines a struct for the measurement information of a custom span.

Since: 12

ArkUI_CustomSpanMetrics

typedef struct ArkUI_CustomSpanMetrics ArkUI_CustomSpanMetrics

Description

Defines a struct for the measurement metrics of a custom span.

Since: 12

ArkUI_DialogDismissEvent

typedef struct ArkUI_DialogDismissEvent ArkUI_DialogDismissEvent

Description

Defines a struct for a dialog box dismiss event.

Since: 12

ArkUI_DragAction

typedef struct ArkUI_DragAction ArkUI_DragAction

Description

Defines a struct for a drag action.

Since: 12

ArkUI_DragAndDropInfo

typedef struct ArkUI_DragAndDropInfo ArkUI_DragAndDropInfo

Description

Defines a struct for drag and drop information returned through a drag status listener.

Since: 12

ArkUI_DragEvent

typedef struct ArkUI_DragEvent ArkUI_DragEvent

Description

Defines a struct for a drag event.

Since: 12

ArkUI_DragPreviewOption

typedef struct ArkUI_DragPreviewOption ArkUI_DragPreviewOption

Description

Defines a struct for custom drag preview options.

Since: 12

ArkUI_DrawableDescriptor

typedef struct ArkUI_DrawableDescriptor ArkUI_DrawableDescriptor

Description

Defines a struct for the DrawableDescriptor object.

Since: 12

ArkUI_DrawContext

typedef struct ArkUI_DrawContext ArkUI_DrawContext

Description

Defines the component drawing context.

Since: 12

ArkUI_GestureDirectionMask

typedef uint32_t ArkUI_GestureDirectionMask

Description

Defines a set of gesture directions.

Since: 12

ArkUI_GestureEventActionTypeMask

typedef uint32_t ArkUI_GestureEventActionTypeMask

Description

Defines a set of gesture event types.

Example: ArkUI_GestureEventActionTypeMask actions = GESTURE_EVENT_ACTION_ACCEPT | GESTURE_EVENT_ACTION_UPDATE

Since: 12

ArkUI_GestureEventTargetInfo

typedef struct ArkUI_GestureEventTargetInfo ArkUI_GestureEventTargetInfo

Description

Defines a struct for a GestureEventTargetInfo object that provides information about a gesture event target.

Since: 12

ArkUI_GestureRecognizerDestructNotifyCallback

typedef void(* ArkUI_GestureRecognizerDestructNotifyCallback) (ArkUI_GestureRecognizer *recognizer, void *userData)

Description

Defines a callback function for notifying gesture recognizer destruction.

Since: 12

ArkUI_GestureRecognizerHandle

typedef ArkUI_GestureRecognizer* ArkUI_GestureRecognizerHandle

Description

Defines the gesture recognizer handle.

Since: 12

ArkUI_GestureRecognizerHandleArray

typedef ArkUI_GestureRecognizerHandle* ArkUI_GestureRecognizerHandleArray

Description

Defines the gesture recognizer handle array.

Since: 12

ArkUI_GuidelineOption

typedef struct ArkUI_GuidelineOption ArkUI_GuidelineOption

Description

Defines the ID, direction, and position of a guideline.

Since: 12

ArkUI_ImageAnimatorFrameInfo

typedef struct ArkUI_ImageAnimatorFrameInfo ArkUI_ImageAnimatorFrameInfo

Description

Defines the image frame information.

Since: 12

ArkUI_KeyframeAnimateOption

typedef struct ArkUI_KeyframeAnimateOption ArkUI_KeyframeAnimateOption

Description

Defines a struct for the keyframe animation parameter object.

Since: 12

ArkUI_LayoutConstraint

typedef struct ArkUI_LayoutConstraint ArkUI_LayoutConstraint

Description

Defines the size constraints of a component during component layout.

Since: 12

ArkUI_ListChildrenMainSize

typedef struct ArkUI_ListChildrenMainSize ArkUI_ListChildrenMainSize

Description

Defines the ChildrenMainSize information of the List component.

Since: 12

ArkUI_ListItemSwipeActionItem

typedef struct ArkUI_ListItemSwipeActionItem ArkUI_ListItemSwipeActionItem

Description

Defines the item configuration for ListItemSwipeActionOption.

Since: 12

ArkUI_ListItemSwipeActionOption

typedef struct ArkUI_ListItemSwipeActionOption ArkUI_ListItemSwipeActionOption

Description

Defines the configuration for ListItemSwipeActionOption.

Since: 12

ArkUI_NativeDialogHandle

typedef struct ArkUI_NativeDialog* ArkUI_NativeDialogHandle

Description

Defines the handle to the custom dialog box controller of ArkUI on the native side.

Since: 12

ArkUI_NodeAdapterEvent

typedef struct ArkUI_NodeAdapterEvent ArkUI_NodeAdapterEvent

Description

Defines the component adapter event.

Since: 12

ArkUI_NodeAdapterHandle

typedef struct ArkUI_NodeAdapter* ArkUI_NodeAdapterHandle

Description

Defines the component adapter, which is used for lazy loading of elements of scrollable components.

Since: 12

ArkUI_NodeContentCallback

typedef void(* ArkUI_NodeContentCallback) (ArkUI_NodeContentEvent *event)

Description

Defines the callback for the NodeContent event.

Since: 12

ArkUI_NodeContentEvent

typedef struct ArkUI_NodeContentEvent ArkUI_NodeContentEvent

Description

Defines the common structure type of a NodeContent event.

Since: 12

ArkUI_NodeContentHandle

typedef struct ArkUI_NodeContent* ArkUI_NodeContentHandle

Description

Defines the handle to the ArkUI NodeContent instance on the native side.

Since: 12

ArkUI_NodeCustomEvent

typedef struct ArkUI_NodeCustomEvent ArkUI_NodeCustomEvent

Description

Defines the common structure of a custom component event.

Since: 12

ArkUI_NodeEvent [1/2]

typedef struct ArkUI_NodeEvent ArkUI_NodeEvent

Description

Defines a struct for a component event.

Since: 12

ArkUI_NodeEvent [2/2]

typedef struct ArkUI_NodeEventArkUI_NodeEvent

Description

Defines the common structure of a component event.

Since: 12

ArkUI_NodeHandle

typedef struct ArkUI_Node* ArkUI_NodeHandle

Description

Defines the pointer to the ArkUI native component object.

Since: 12

ArkUI_OnWillDismissEvent

typedef bool(* ArkUI_OnWillDismissEvent) (int32_t reason)

Description

Defines a pointer to the callback invoked when the dialog box is closed.

Since: 12

ArkUI_ParallelInnerGestureEvent

typedef struct ArkUI_ParallelInnerGestureEvent ArkUI_ParallelInnerGestureEvent

Description

Defines a parallel internal gesture event.

Since: 12

ArkUI_StyledString

typedef struct ArkUI_StyledString ArkUI_StyledString

Description

Defines a struct for the styled string object supported by the text component.

Since: 12

ArkUI_StyledString_Descriptor

typedef struct ArkUI_StyledString_Descriptor ArkUI_StyledString_Descriptor

Description

Defines a struct for the styled string descriptor object supported by the text component.

Since: 14

ArkUI_SwiperIndicator

typedef struct ArkUI_SwiperIndicator ArkUI_SwiperIndicator

Description

Defines the navigation point indicator style of the Swiper component.

Since: 12

ArkUI_SystemFontStyleEvent

typedef struct ArkUI_SystemFontStyleEvent ArkUI_SystemFontStyleEvent

Description

Defines a struct for the system font style event.

Since: 12

ArkUI_TransitionEffect

typedef struct ArkUI_TransitionEffect ArkUI_TransitionEffect

Description

Defines a struct for the transition effect.

Since: 12

ArkUI_WaterFlowSectionOption

typedef struct ArkUI_WaterFlowSectionOption ArkUI_WaterFlowSectionOption

Description

Defines the water flow section configuration.

Since: 12

OH_PixelmapNative

typedef struct OH_PixelmapNative OH_PixelmapNative

Description

Defines the Pixelmap struct, which is used to perform operations related to a pixel map.

Since: 12

OH_PixelmapNativeHandle

typedef struct OH_PixelmapNative* OH_PixelmapNativeHandle

Description

Defines a struct for the pointer to an OH_PixelmapNative object.

Since: 12

OH_UdmfData

typedef struct OH_UdmfData OH_UdmfData

Description

Defines a struct for UDMF unified data.

Since: 12

Enum Description

ArkUI_AccessibilityActionType

enum ArkUI_AccessibilityActionType

Description

Defines an enum for the accessibility action types.

Since: 12

Enum Description
ARKUI_ACCESSIBILITY_ACTION_CLICK Tapping.
ARKUI_ACCESSIBILITY_ACTION_LONG_CLICK Long press.
ARKUI_ACCESSIBILITY_ACTION_CUT Cut.
ARKUI_ACCESSIBILITY_ACTION_COPY Copy.
ARKUI_ACCESSIBILITY_ACTION_PASTE Paste.

ArkUI_AccessibilityCheckedState

enum ArkUI_AccessibilityCheckedState

Description

Enumerates the accessibility check box states.

Since: 12

Enum Description
ARKUI_ACCESSIBILITY_UNCHECKED The check box is not selected.
ARKUI_ACCESSIBILITY_CHECKED The check box is selected.

ArkUI_AccessibilityMode

enum ArkUI_AccessibilityMode

Description

Enumerates the accessibility modes.

Since: 12

Enum Description
ARKUI_ACCESSIBILITY_MODE_AUTO The mode is automatically set to enabled or disabled based on the component.
ARKUI_ACCESSIBILITY_MODE_ENABLED The component can be identified by the accessibility service.
ARKUI_ACCESSIBILITY_MODE_DISABLED The component cannot be identified by the accessibility service.
ARKUI_ACCESSIBILITY_MODE_DISABLED_FOR_DESCENDANTS The component and all its child components cannot be identified by the accessibility service.

ArkUI_AdaptiveColor

enum ArkUI_AdaptiveColor

Description

Enumerates the adaptive color modes.

Since: 12

Enum Description
ARKUI_ADAPTIVE_COLOR_DEFAULT Adaptive color mode is not used.
ARKUI_ADAPTIVE_COLOR_AVERAGE Adaptive color mode is used.

ArkUI_Alignment

enum ArkUI_Alignment

Description

Enumerates the alignment modes.

Since: 12

Enum Description
ARKUI_ALIGNMENT_TOP_START Top start.
ARKUI_ALIGNMENT_TOP Top center.
ARKUI_ALIGNMENT_TOP_END Top end.
ARKUI_ALIGNMENT_START Vertically centered start.
ARKUI_ALIGNMENT_CENTER Horizontally and vertically centered.
ARKUI_ALIGNMENT_END Vertically centered end.
ARKUI_ALIGNMENT_BOTTOM_START Bottom start.
ARKUI_ALIGNMENT_BOTTOM Horizontally centered on the bottom.
ARKUI_ALIGNMENT_BOTTOM_END Bottom end.

ArkUI_AnimationCurve

enum ArkUI_AnimationCurve

Description

Enumerates the animation curves.

Since: 12

Enum Description
ARKUI_CURVE_LINEAR The animation speed keeps unchanged.
ARKUI_CURVE_EASE The animation starts slowly, accelerates, and then slows down towards the end.
ARKUI_CURVE_EASE_IN The animation starts at a low speed and then picks up speed until the end.
ARKUI_CURVE_EASE_OUT The animation ends at a low speed.
ARKUI_CURVE_EASE_IN_OUT The animation starts and ends at a low speed.
ARKUI_CURVE_FAST_OUT_SLOW_IN The animation uses the standard curve
ARKUI_CURVE_LINEAR_OUT_SLOW_IN The animation uses the deceleration curve.
ARKUI_CURVE_FAST_OUT_LINEAR_IN The animation uses the acceleration curve.
ARKUI_CURVE_EXTREME_DECELERATION The animation uses the extreme deceleration curve.
ARKUI_CURVE_SHARP The animation uses the sharp curve.
ARKUI_CURVE_RHYTHM The animation uses the rhythm curve.
ARKUI_CURVE_SMOOTH The animation uses the smooth curve.
ARKUI_CURVE_FRICTION The animation uses the friction curve

ArkUI_AnimationDirection

enum ArkUI_AnimationDirection

Description

Enumerates the animation playback modes.

Since: 12

Enum Description
ARKUI_ANIMATION_DIRECTION_NORMAL The animation plays in forward loop mode.
ARKUI_ANIMATION_DIRECTION_REVERSE The animation plays in reverse loop mode.
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.
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.

ArkUI_AnimationFill

enum ArkUI_AnimationFill

Description

Enumerates the state of the animated target after the animation is executed.

Since: 12

Enum Description
ARKUI_ANIMATION_FILL_NONE No style is applied to the target before or after the animation is executed.
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.
ARKUI_ANIMATION_FILL_BACKWARDS The animation uses the value defined in the first key frame during the duration defined by animation-delay.
ARKUI_ANIMATION_FILL_BOTH The animation follows the forwards and backwards rules.

ArkUI_AnimationFillMode

enum ArkUI_AnimationFillMode

Description

Enumerates the states before and after execution of the frame-by-frame animation.

Since: 12

Enum Description
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.
ARKUI_ANIMATION_FILL_MODE_FORWARDS The target component retains the state set by the last keyframe encountered during execution of the animation.
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.
ARKUI_ANIMATION_FILL_MODE_BOTH The animation follows the rules for both Forwards and Backwards, extending the animation attributes in both directions.

ArkUI_AnimationPlayMode

enum ArkUI_AnimationPlayMode

Description

Enumerates the animation playback modes.

Since: 12

Enum Description
ARKUI_ANIMATION_PLAY_MODE_NORMAL The animation is played forwards.
ARKUI_ANIMATION_PLAY_MODE_REVERSE The animation is played backwards.
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...).
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...).

ArkUI_AnimationStatus

enum ArkUI_AnimationStatus

Description

Enumerates the playback states of the frame-by-frame animation.

Since: 12

Enum Description
ARKUI_ANIMATION_STATUS_INITIAL The animation is in the initial state.
ARKUI_ANIMATION_STATUS_RUNNING The animation is being played.
ARKUI_ANIMATION_STATUS_PAUSED The animation is paused.
ARKUI_ANIMATION_STATUS_STOPPED The animation is stopped.

ArkUI_Axis

enum ArkUI_Axis

Description

Enumerates the scroll directions.

Since: 12

Enum Description
ARKUI_AXIS_VERTICAL Only vertical scrolling is supported.
ARKUI_AXIS_HORIZONTAL Only horizontal scrolling is supported.

ArkUI_BarrierDirection

enum ArkUI_BarrierDirection

Description

Enumerates the barrier directions.

Since: 12

Enum Description
ARKUI_BARRIER_DIRECTION_START The barrier is on the left side of all the referenced components specified by referencedId.
ARKUI_BARRIER_DIRECTION_END The barrier is on the right side of all the referenced components specified by referencedId.
ARKUI_BARRIER_DIRECTION_TOP The barrier is at the top of all the referenced components specified by referencedId.
ARKUI_BARRIER_DIRECTION_BOTTOM The barrier is at the bottom of all the referenced components specified by referencedId.

ArkUI_BlendApplyType

enum ArkUI_BlendApplyType

Description

Defines how the specified blend mode is applied.

Since: 12

Enum Description
BLEND_APPLY_TYPE_FAST The content of the view is blended in sequence on the target image.
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.

ArkUI_BlendMode

enum ArkUI_BlendMode

Description

Enumerates the blend modes.

Since: 12

Enum Description
ARKUI_BLEND_MODE_NONE The top image is superimposed on the bottom image without any blending.
ARKUI_BLEND_MODE_CLEAR The target pixels covered by the source pixels are erased by being turned to completely transparent.
ARKUI_BLEND_MODE_SRC r = s: Only the source pixels are displayed.
ARKUI_BLEND_MODE_DST r = d: Only the target pixels are displayed.
ARKUI_BLEND_MODE_SRC_OVER r = s + (1 - sa) \d: The source pixels are blended based on opacity and cover the target pixels.
ARKUI_BLEND_MODE_DST_OVER r = d + (1 - da) *\ s: The target pixels are blended based on opacity and cover on the source pixels.
ARKUI_BLEND_MODE_SRC_IN r = s * da: Only the part of the source pixels that overlap with the target pixels is displayed.
ARKUI_BLEND_MODE_DST_IN r = d * sa: Only the part of the target pixels that overlap with the source pixels is displayed.
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.
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.
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.
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.
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.
ARKUI_BLEND_MODE_PLUS r = min(s + d, 1): New pixels resulting from adding the source pixels to the target pixels are displayed.
ARKUI_BLEND_MODE_MODULATE r = s * d: New pixels resulting from multiplying the source pixels with the target pixels are displayed.
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.
ARKUI_BLEND_MODE_OVERLAY The MULTIPLY or SCREEN mode is used based on the target pixels.
ARKUI_BLEND_MODE_DARKEN rc = s + d - max(s \da, d \sa), ra = kSrcOver: When two colors overlap, whichever is darker is used.
ARKUI_BLEND_MODE_LIGHTEN rc = s + d - min(s \da, d \sa), ra = kSrcOver: The darker of the pixels (source and target) is used.
ARKUI_BLEND_MODE_COLOR_DODGE The colors of the target pixels are lightened to reflect the source pixels.
ARKUI_BLEND_MODE_COLOR_BURN The colors of the target pixels are darkened to reflect the source pixels.
ARKUI_BLEND_MODE_HARD_LIGHT The MULTIPLY or SCREEN mode is used, depending on the source pixels.
ARKUI_BLEND_MODE_SOFT_LIGHT The LIGHTEN or DARKEN mode is used, depending on the source pixels.
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.
ARKUI_BLEND_MODE_EXCLUSION rc = s + d - two(s * d), ra = kSrcOver: The final pixel is similar to DIFFERENCE, but with less contrast.
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.
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.
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.
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.
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.

ArkUI_BlurStyle

enum ArkUI_BlurStyle

Description

Enumerates the blur styles.

Since: 12

Enum Description
ARKUI_BLUR_STYLE_THIN Thin material.
ARKUI_BLUR_STYLE_REGULAR Regular material.
ARKUI_BLUR_STYLE_THICK Thick material.
ARKUI_BLUR_STYLE_BACKGROUND_THIN Material that creates the minimum depth of field effect.
ARKUI_BLUR_STYLE_BACKGROUND_REGULAR Material that creates a medium shallow depth of field effect.
ARKUI_BLUR_STYLE_BACKGROUND_THICK Material that creates a high shallow depth of field effect.
ARKUI_BLUR_STYLE_BACKGROUND_ULTRA_THICK Material that creates the maximum depth of field effect.
ARKUI_BLUR_STYLE_NONE No blur.
ARKUI_BLUR_STYLE_COMPONENT_ULTRA_THIN Component ultra-thin material.
ARKUI_BLUR_STYLE_COMPONENT_THIN Component thin material.
ARKUI_BLUR_STYLE_COMPONENT_REGULAR Component regular material.
ARKUI_BLUR_STYLE_COMPONENT_THICK Component thick material.
ARKUI_BLUR_STYLE_COMPONENT_ULTRA_THICK Component ultra-thick material.

ArkUI_BorderStyle

enum ArkUI_BorderStyle

Description

Enumerates the border styles.

Since: 12

Enum Description
ARKUI_BORDER_STYLE_SOLID Solid border.
ARKUI_BORDER_STYLE_DASHED Dashed border.
ARKUI_BORDER_STYLE_DOTTED Dotted border.

ArkUI_ButtonType

enum ArkUI_ButtonType

Description

Enumerates the button types.

Since: 12

Enum Description
ARKUI_BUTTON_TYPE_NORMAL Normal button (without rounded corners by default).
ARKUI_BUTTON_TYPE_CAPSULE Capsule-type button (the round corner is half of the height by default).
ARKUI_BUTTON_TYPE_CIRCLE Circle button.

ArkUI_CalendarAlignment

enum ArkUI_CalendarAlignment

Description

Enumerates the alignment modes between the calendar picker and the entry component.

Since: 12

Enum Description
ARKUI_CALENDAR_ALIGNMENT_START Left aligned.
ARKUI_CALENDAR_ALIGNMENT_CENTER Center aligned.
ARKUI_CALENDAR_ALIGNMENT_END Right aligned.

ArkUI_CancelButtonStyle

enum ArkUI_CancelButtonStyle

Description

Enumerates the styles of the Cancel button.

Since: 12

Enum Description
ARKUI_CANCELBUTTON_STYLE_CONSTANT The Cancel button is always displayed.
ARKUI_CANCELBUTTON_STYLE_INVISIBLE The Cancel button is always hidden.
ARKUI_CANCELBUTTON_STYLE_INPUT The Cancel button is displayed when there is text input.

ArkUI_CheckboxShape

enum ArkUI_CheckboxShape

Description

Enumerates the shapes of the check box.

Since: 12

Enum Description
ArkUI_CHECKBOX_SHAPE_CIRCLE Circle.
ArkUI_CHECKBOX_SHAPE_ROUNDED_SQUARE Rounded square.

ArkUI_ClipType

enum ArkUI_ClipType

Description

Enumerates the clipping region types.

Since: 12

Enum Description
ARKUI_CLIP_TYPE_RECTANGLE Rectangle.
ARKUI_CLIP_TYPE_CIRCLE (circle)
ARKUI_CLIP_TYPE_ELLIPSE Ellipse.
ARKUI_CLIP_TYPE_PATH Path Type

ArkUI_ColorMode

enum ArkUI_ColorMode

Description

Enumerates the color modes.

Since: 12

Enum Description
ARKUI_COLOR_MODE_SYSTEM Following the system color mode.
ARKUI_COLOR_MODE_LIGHT Light color mode.
ARKUI_COLOR_MODE_DARK Dark color mode.

ArkUI_ColorStrategy

enum ArkUI_ColorStrategy

Description

Enumerates the foreground colors.

Since: 12

Enum Description
ARKUI_COLOR_STRATEGY_INVERT The foreground colors are the inverse of the component background colors.
ARKUI_COLOR_STRATEGY_AVERAGE The shadow colors of the component are the average color obtained from the component background shadow area.
ARKUI_COLOR_STRATEGY_PRIMARY The shadow colors of the component are the primary color obtained from the component background shadow area.

ArkUI_CopyOptions

enum ArkUI_CopyOptions

Description

Enumerates the text copy and paste modes.

Since: 12

Enum Description
ARKUI_COPY_OPTIONS_NONE Copy is not allowed.
ARKUI_COPY_OPTIONS_IN_APP Intra-application copy is allowed.
ARKUI_COPY_OPTIONS_LOCAL_DEVICE Intra-device copy is allowed.
ARKUI_COPY_OPTIONS_CROSS_DEVICE Cross-device copy is allowed.

ArkUI_Direction

enum ArkUI_Direction

Description

Enumerates the modes in which components are laid out along the main axis of the container.

Since: 12

Enum Description
ARKUI_DIRECTION_LTR Components are arranged from left to right.
ARKUI_DIRECTION_RTL Components are arranged from right to left.
ARKUI_DIRECTION_AUTO The default layout direction is used.

ArkUI_DismissReason

enum ArkUI_DismissReason

Description

Enumerates the actions for triggering closure of the dialog box.

Since: 12

Enum Description
DIALOG_DISMISS_BACK_PRESS Touching the system-defined Back button or pressing the Esc key.
DIALOG_DISMISS_TOUCH_OUTSIDE Touching the mask.
DIALOG_DISMISS_CLOSE_BUTTON Touching the Close button.
DIALOG_DISMISS_SLIDE_DOWN Sliding down.

ArkUI_DragPreviewScaleMode

enum ArkUI_DragPreviewScaleMode

Description

Defines an enum for drag preview scale modes.

Since: 12

Enum Description
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.
ARKUI_DRAG_PREVIEW_SCALE_DISABLED The system does not scale the drag preview.

ArkUI_DragResult

enum ArkUI_DragResult

Description

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.

Since: 12

Enum Description
ARKUI_DRAG_RESULT_SUCCESSFUL The drag and drop operation succeeded.
ARKUI_DRAG_RESULT_FAILED The drag and drop operation failed.
ARKUI_DRAG_RESULT_CANCELED The drag and drop operation was canceled.

ArkUI_DragStatus

enum ArkUI_DragStatus

Description

Enumerates dragging states.

Since: 12

Enum Description
ArkUI_DRAG_STATUS_UNKNOWN Unknown.
ArkUI_DRAG_STATUS_STARTED Started.
ArkUI_DRAG_STATUS_ENDED Ended.

ArkUI_DropProposal

enum ArkUI_DropProposal

Description

Defines an enum for data processing modes used when data is dropped, which affects the display of the badge.

Since: 12

Enum Description
ARKUI_DROP_PROPOSAL_COPY Copy.
ARKUI_DROP_PROPOSAL_MOVE Cut.

ArkUI_EdgeEffect

enum ArkUI_EdgeEffect

Description

Enumerates the effects used at the edges of the component when the boundary of the scrollable content is reached.

Since: 12

Enum Description
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.
ARKUI_EDGE_EFFECT_FADE Fade effect. When at one of the edges, the component produces a fade effect.
ARKUI_EDGE_EFFECT_NONE No effect when the component is at one of the edges.

ArkUI_EffectEdge

enum ArkUI_EffectEdge

Description

Enumerates the edges for which the effect takes effect when the boundary of the scrollable content is reached.

Since: 17

Enum Description
ARKUI_EFFECT_EDGE_START Start edge.
ARKUI_EFFECT_EDGE_END End edge.

ArkUI_EllipsisMode

enum ArkUI_EllipsisMode

Description

Enumerates the ellipsis positions.

Since: 12

Enum Description
ARKUI_ELLIPSIS_MODE_START An ellipsis is used at the start of the line of text.
ARKUI_ELLIPSIS_MODE_CENTER An ellipsis is used at the center of the line of text.
ARKUI_ELLIPSIS_MODE_END An ellipsis is used at the end of the line of text.

ArkUI_EnterKeyType

enum ArkUI_EnterKeyType

Description

Enumerates the types of the Enter key for a single-line text box.

Since: 12

Enum Description
ARKUI_ENTER_KEY_TYPE_GO The Enter key is labeled "Go."
ARKUI_ENTER_KEY_TYPE_SEARCH The Enter key is labeled "Search."
ARKUI_ENTER_KEY_TYPE_SEND The Enter key is labeled "Send."
ARKUI_ENTER_KEY_TYPE_NEXT The Enter key is labeled "Next."
ARKUI_ENTER_KEY_TYPE_DONE The Enter key is labeled "Done."
ARKUI_ENTER_KEY_TYPE_PREVIOUS The Enter key is labeled "Previous."
ARKUI_ENTER_KEY_TYPE_NEW_LINE The Enter key is labeled "Return."

ArkUI_ErrorCode

enum ArkUI_ErrorCode

Description

Defines an enum for the error codes.

Since: 12

Enum Description
ARKUI_ERROR_CODE_NO_ERROR No error.
ARKUI_ERROR_CODE_PARAM_INVALID Parameter error.
ARKUI_ERROR_CODE_ATTRIBUTE_OR_EVENT_NOT_SUPPORTED The component does not support specific attributes or events.
ARKUI_ERROR_CODE_NOT_SUPPROTED_FOR_ARKTS_NODE The specific operation is not allowed on the node created by ArkTS.
ARKUI_ERROR_CODE_NODE_ADAPTER_NONE_HOST The adapter for lazy loading is not bound to the component.
ARKUI_ERROR_CODE_NODE_ADAPTER_EXIST_IN_HOST The adapter already exists.
ARKUI_ERROR_CODE_NODE_ADAPTER_CHILD_NODE_EXIST Failed to add the adapter because the corresponding node already has a subnode.
ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INDEX_OUT_OF_RANGE The parameter length in the parameter event exceeds the limit.
ARKUI_ERROR_CODE_NODE_EVENT_PARAM_INVALID The data does not exist in the component event.
ARKUI_ERROR_CODE_NODE_EVENT_NO_RETURN The component event does not support return values.
ARKUI_ERROR_CODE_NODE_INDEX_INVALID Invalid index.
ARKUI_ERROR_CODE_GET_INFO_FAILED Failed to obtain the route navigation information.
ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR Buffer size error.
ARKUI_ERROR_CODE_NON_SCROLLABLE_CONTAINER The component is not a scrollable container.
ARKUI_ERROR_CODE_BUFFER_SIZE_NOT_ENOUGH The buffer is not large enough.
ARKUI_ERROR_CODE_INVALID_STYLED_STRING Invalid styled string.

ArkUI_FinishCallbackType

enum ArkUI_FinishCallbackType

Description

Enumerates the animation onFinish callback types.

Since: 12

Enum Description
ARKUI_FINISH_CALLBACK_REMOVED The callback is invoked when the entire animation is removed once it has finished.
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.

ArkUI_FlexAlignment

enum ArkUI_FlexAlignment

Description

Enumerates the vertical alignment modes.

Since: 12

Enum Description
ARKUI_FLEX_ALIGNMENT_START The child components are aligned with the start edge of the main axis.
ARKUI_FLEX_ALIGNMENT_CENTER The child components are aligned in the center of the main axis.
ARKUI_FLEX_ALIGNMENT_END The child components are aligned with the end edge of the main axis.
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.
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.
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.

ArkUI_FlexDirection

enum ArkUI_FlexDirection

Description

Enumerates the directions of the main axis in the flex container.

Since: 12

Enum Description
ARKUI_FLEX_DIRECTION_ROW The child components are arranged in the same direction as the main axis runs along the rows.
ARKUI_FLEX_DIRECTION_COLUMN The child components are arranged in the same direction as the main axis runs down the columns.
ARKUI_FLEX_DIRECTION_ROW_REVERSE The child components are arranged opposite to the ROW direction.
ARKUI_FLEX_DIRECTION_COLUMN_REVERSE The child components are arranged opposite to the COLUMN direction.

ArkUI_FlexWrap

enum ArkUI_FlexWrap

Description

Defines whether the flex container has a single line or multiple lines.

Since: 12

Enum Description
ARKUI_FLEX_WRAP_NO_WRAP The child components in the flex container are arranged in a single line, and they cannot overflow.
ARKUI_FLEX_WRAP_WRAP The child components in the flex container are arranged in multiple lines, and they may overflow.
ARKUI_FLEX_WRAP_WRAP_REVERSE The child components in the flex container are reversely arranged in multiple lines, and they may overflow.

ArkUI_FontStyle

enum ArkUI_FontStyle

Description

Enumerates the font styles.

Since: 12

Enum Description
ARKUI_FONT_STYLE_NORMAL Standard font style.
ARKUI_FONT_STYLE_ITALIC Italic font style.

ArkUI_FontWeight

enum ArkUI_FontWeight

Description

Enumerates the font weights.

Since: 12

Enum Description
ARKUI_FONT_WEIGHT_W100 100
ARKUI_FONT_WEIGHT_W200 200
ARKUI_FONT_WEIGHT_W300 300
ARKUI_FONT_WEIGHT_W400 400
ARKUI_FONT_WEIGHT_W500 500
ARKUI_FONT_WEIGHT_W600 600
ARKUI_FONT_WEIGHT_W700 700
ARKUI_FONT_WEIGHT_W800 800
ARKUI_FONT_WEIGHT_W900 900
ARKUI_FONT_WEIGHT_BOLD The font weight is bold.
ARKUI_FONT_WEIGHT_NORMAL The font weight is normal.
ARKUI_FONT_WEIGHT_BOLDER The font weight is bolder.
ARKUI_FONT_WEIGHT_LIGHTER The font weight is lighter.
ARKUI_FONT_WEIGHT_MEDIUM The font weight is medium.
ARKUI_FONT_WEIGHT_REGULAR The font weight is normal.

ArkUI_GestureDirection

enum ArkUI_GestureDirection

Description

Enumerates gesture directions.

Since: 12

Enum Description
GESTURE_DIRECTION_ALL All directions.
GESTURE_DIRECTION_HORIZONTAL Horizontal direction.
GESTURE_DIRECTION_VERTICAL Vertical direction.
GESTURE_DIRECTION_LEFT Leftward.
GESTURE_DIRECTION_RIGHT Rightward.
GESTURE_DIRECTION_UP Upward.
GESTURE_DIRECTION_DOWN Downward.
GESTURE_DIRECTION_NONE None.

ArkUI_GestureEventActionType

enum ArkUI_GestureEventActionType

Description

Enumerates gesture event types.

Since: 12

Enum Description
GESTURE_EVENT_ACTION_ACCEPT Triggered.
GESTURE_EVENT_ACTION_UPDATE Updated.
GESTURE_EVENT_ACTION_END Ended.
GESTURE_EVENT_ACTION_CANCEL Canceled.

ArkUI_GestureInterruptResult

enum ArkUI_GestureInterruptResult

Description

Enumerates gesture interruption results.

Since: 12

Enum Description
GESTURE_INTERRUPT_RESULT_CONTINUE The gesture recognition process continues.
GESTURE_INTERRUPT_RESULT_REJECT The gesture recognition process is paused.

ArkUI_GestureMask

enum ArkUI_GestureMask

Description

Enumerates gesture masking modes.

Since: 12

Enum Description
NORMAL_GESTURE_MASK The gestures of child components are enabled and recognized based on the default gesture recognition sequence.
IGNORE_INTERNAL_GESTURE_MASK The gestures of child components are disabled, including the built-in gestures.

ArkUI_GesturePriority

enum ArkUI_GesturePriority

Description

Enumerates gesture event modes.

Since: 12

Enum Description
NORMAL Normal.
PRIORITY High-priority.
PARALLEL Parallel.

ArkUI_GestureRecognizerState

enum ArkUI_GestureRecognizerState

Description

Enumerates the gesture recognizer states.

Since: 12

Enum Description
ARKUI_GESTURE_RECOGNIZER_STATE_REDAY Prepared.
ARKUI_GESTURE_RECOGNIZER_STATE_DETECTING Check status.
ARKUI_GESTURE_RECOGNIZER_STATE_PENDING Waiting
ARKUI_GESTURE_RECOGNIZER_STATE_BLOCKED Blocked.
ARKUI_GESTURE_RECOGNIZER_STATE_SUCCESSFUL (Success status)
ARKUI_GESTURE_RECOGNIZER_STATE_FAILED Failed.

ArkUI_GestureRecognizerType

enum ArkUI_GestureRecognizerType

Description

Enumerates gesture recognizer types.

Since: 12

Enum Description
TAP_GESTURE Tap.
LONG_PRESS_GESTURE Long press gesture.
PAN_GESTURE Pan gesture.
PINCH_GESTURE Pinch gesture.
ROTATION_GESTURE Rotation gesture.
SWIPE_GESTURE Swipe gesture.
GROUP_GESTURE A group of gestures.

ArkUI_GroupGestureMode

enum ArkUI_GroupGestureMode

Description

Enumerates gesture group modes.

Since: 12

Enum Description
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.
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.
EXCLUSIVE_GROUP Exclusive recognition. Registered gestures are identified concurrently. If one gesture is successfully recognized, gesture recognition ends.

ArkUI_HitTestMode

enum ArkUI_HitTestMode

Description

Enumerates the hit test modes.

Since: 12

Enum Description
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.
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.
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.
ARKUI_HIT_TEST_MODE_NONE The node does not respond to the hit test of a touch event.

ArkUI_HorizontalAlignment

enum ArkUI_HorizontalAlignment

Description

Enumerates the alignment mode in the horizontal direction.

Since: 12

Enum Description
ARKUI_HORIZONTAL_ALIGNMENT_START Aligned with the start edge in the same direction as the language in use.
ARKUI_HORIZONTAL_ALIGNMENT_CENTER Aligned with the center. This is the default alignment mode.
ARKUI_HORIZONTAL_ALIGNMENT_END Aligned with the end edge in the same direction as the language in use.

ArkUI_ImageInterpolation

enum ArkUI_ImageInterpolation

Description

Enumerates the image interpolation effects.

Since: 12

Enum Description
ARKUI_IMAGE_INTERPOLATION_NONE No image interpolation.
ARKUI_IMAGE_INTERPOLATION_LOW Low quality interpolation.
ARKUI_IMAGE_INTERPOLATION_MEDIUM Medium quality interpolation.
ARKUI_IMAGE_INTERPOLATION_HIGH High quality interpolation. This mode produces scaled images of the highest possible quality.

ArkUI_ImageRenderMode

enum ArkUI_ImageRenderMode

Description

Enumerates the image rendering modes.

Since: 12

Enum Description
ARKUI_IMAGE_RENDER_MODE_ORIGINAL Render image pixels as they are in the original source image.
ARKUI_IMAGE_RENDER_MODE_TEMPLATE Render image pixels to create a monochrome template image.

ArkUI_ImageRepeat

enum ArkUI_ImageRepeat

Description

Enumerates the image repeat patterns.

Since: 12

Enum Description
ARKUI_IMAGE_REPEAT_NONE The image is not repeatedly drawn.
ARKUI_IMAGE_REPEAT_X The image is repeatedly drawn only along the x-axis.
ARKUI_IMAGE_REPEAT_Y The image is repeatedly drawn only along the y-axis.
ARKUI_IMAGE_REPEAT_XY The image is repeatedly drawn along both axes.

ArkUI_ImageSize

enum ArkUI_ImageSize

Description

Defines the image size.

Since: 12

Enum Description
ARKUI_IMAGE_SIZE_AUTO The original image aspect ratio is retained.
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.
ARKUI_IMAGE_SIZE_CONTAIN The image is scaled with its aspect ratio retained for the content to be completely displayed within the display boundaries.

ArkUI_ImageSpanAlignment

enum ArkUI_ImageSpanAlignment

Description

Enumerates the alignment mode of the image with the text.

Since: 12

Enum Description
ARKUI_IMAGE_SPAN_ALIGNMENT_BASELINE The image is bottom aligned with the text baseline.
ARKUI_IMAGE_SPAN_ALIGNMENT_BOTTOM The image is bottom aligned with the text.
ARKUI_IMAGE_SPAN_ALIGNMENT_CENTER The image is centered aligned with the text.
ARKUI_IMAGE_SPAN_ALIGNMENT_TOP The image is top aligned with the text.

ArkUI_ItemAlignment

enum ArkUI_ItemAlignment

Description

Enumerates the modes in which components are laid out along the cross axis of the container.

Since: 12

Enum Description
ARKUI_ITEM_ALIGNMENT_AUTO The default configuration of the flex container is used.
ARKUI_ITEM_ALIGNMENT_START The items in the flex container are aligned with the cross-start edge.
ARKUI_ITEM_ALIGNMENT_CENTER The items in the flex container are centered along the cross axis.
ARKUI_ITEM_ALIGNMENT_END The items in the flex container are aligned with the cross-end edge.
ARKUI_ITEM_ALIGNMENT_STRETCH The items in the flex container are stretched and padded along the cross axis.
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.

ArkUI_KeyCode

enum ArkUI_KeyCode

Description

Enumerates the key codes for key events.

Since: 14

Enum Description
ARKUI_KEYCODE_UNKNOWN Unknown key.
ARKUI_KEYCODE_FN Function (Fn) key.
ARKUI_KEYCODE_VOLUME_UP Volume Up key.
ARKUI_KEYCODE_VOLUME_DOWN Volume Down key.
ARKUI_KEYCODE_POWER Power key.
ARKUI_KEYCODE_CAMERA Camera key.
ARKUI_KEYCODE_VOLUME_MUTE Speaker Mute key.
ARKUI_KEYCODE_MUTE Mute key.
ARKUI_KEYCODE_BRIGHTNESS_UP Brightness Up key.
ARKUI_KEYCODE_BRIGHTNESS_DOWN Brightness Down key.
ARKUI_KEYCODE_0 Key 0.
ARKUI_KEYCODE_1 Key 1.
ARKUI_KEYCODE_2 Key 2.
ARKUI_KEYCODE_3 Key 3.
ARKUI_KEYCODE_4 Key 4.
ARKUI_KEYCODE_5 Key 5.
ARKUI_KEYCODE_6 Key 6.
ARKUI_KEYCODE_7 Key 7.
ARKUI_KEYCODE_8 Key 8.
ARKUI_KEYCODE_9 Key 9.
ARKUI_KEYCODE_STAR Key *.
ARKUI_KEYCODE_POUND Key #.
ARKUI_KEYCODE_DPAD_UP Up key on D-pad.
ARKUI_KEYCODE_DPAD_DOWN Down key on D-pad.
ARKUI_KEYCODE_DPAD_LEFT Left key on D-pad.
ARKUI_KEYCODE_DPAD_RIGHT Right key on D-pad.
ARKUI_KEYCODE_DPAD_CENTER Center key on D-pad.
ARKUI_KEYCODE_A Key A.
ARKUI_KEYCODE_B Key B.
ARKUI_KEYCODE_C Key C.
ARKUI_KEYCODE_D Key D.
ARKUI_KEYCODE_E Key E.
ARKUI_KEYCODE_F Key F.
ARKUI_KEYCODE_G Key G.
ARKUI_KEYCODE_H Key H.
ARKUI_KEYCODE_I Key I.
ARKUI_KEYCODE_J Key J.
ARKUI_KEYCODE_K Key K.
ARKUI_KEYCODE_L Key L.
ARKUI_KEYCODE_M Key M.
ARKUI_KEYCODE_N Key N.
ARKUI_KEYCODE_O Key O.
ARKUI_KEYCODE_P Key P.
ARKUI_KEYCODE_Q Key R.
ARKUI_KEYCODE_R Key R.
ARKUI_KEYCODE_S Key S.
ARKUI_KEYCODE_T Key T.
ARKUI_KEYCODE_U Key U.
ARKUI_KEYCODE_V Key V.
ARKUI_KEYCODE_W Key W.
ARKUI_KEYCODE_X Key X.
ARKUI_KEYCODE_Y Key Y.
ARKUI_KEYCODE_Z Key Z.
ARKUI_KEYCODE_COMMA Key ,.
ARKUI_KEYCODE_PERIOD Key ..
ARKUI_KEYCODE_ALT_LEFT Left Alt key.
ARKUI_KEYCODE_ALT_RIGHT Right Alt key.
ARKUI_KEYCODE_SHIFT_LEFT Left Shift key.
ARKUI_KEYCODE_SHIFT_RIGHT Right Shift key.
ARKUI_KEYCODE_TAB Tab key.
ARKUI_KEYCODE_SPACE Space key.
ARKUI_KEYCODE_SYM Symbol key.
ARKUI_KEYCODE_EXPLORER Explorer key, which is used to start the explorer application.
ARKUI_KEYCODE_ENVELOPE Email key, which is used to start the email application.
ARKUI_KEYCODE_ENTER Enter key.
ARKUI_KEYCODE_DEL Delete key.
ARKUI_KEYCODE_GRAVE Key `.
ARKUI_KEYCODE_MINUS Key -.
ARKUI_KEYCODE_EQUALS Key =.
ARKUI_KEYCODE_LEFT_BRACKET Key [.
ARKUI_KEYCODE_RIGHT_BRACKET Key ].
ARKUI_KEYCODE_BACKSLASH Key .
ARKUI_KEYCODE_SEMICOLON Key ;.
ARKUI_KEYCODE_APOSTROPHE Key '.
ARKUI_KEYCODE_SLASH Key /.
ARKUI_KEYCODE_AT Key @.
ARKUI_KEYCODE_PLUS Key +.
ARKUI_KEYCODE_MENU Menu key.
ARKUI_KEYCODE_PAGE_UP Page Up key.
ARKUI_KEYCODE_PAGE_DOWN Page Down key.
ARKUI_KEYCODE_ESCAPE ESC key.
ARKUI_KEYCODE_FORWARD_DEL Forward Delete key.
ARKUI_KEYCODE_CTRL_LEFT Left Ctrl key.
ARKUI_KEYCODE_CTRL_RIGHT Right Ctrl key.
ARKUI_KEYCODE_CAPS_LOCK Caps Lock key.
ARKUI_KEYCODE_SCROLL_LOCK Scroll Lock key.
ARKUI_KEYCODE_META_LEFT Left Meta key.
ARKUI_KEYCODE_META_RIGHT Right Meta key.
ARKUI_KEYCODE_FUNCTION Function key.
ARKUI_KEYCODE_SYSRQ System Request/Print Screen key.
ARKUI_KEYCODE_BREAK Break/Pause key.
ARKUI_KEYCODE_MOVE_HOME Move to Home key.
ARKUI_KEYCODE_MOVE_END Move to End key.
ARKUI_KEYCODE_INSERT Insert key.
ARKUI_KEYCODE_FORWARD Forward key.
ARKUI_KEYCODE_MEDIA_PLAY Play key.
ARKUI_KEYCODE_MEDIA_PAUSE Pause key.
ARKUI_KEYCODE_MEDIA_CLOSE Close key.
ARKUI_KEYCODE_MEDIA_EJECT Eject key.
ARKUI_KEYCODE_MEDIA_RECORD Record key.
ARKUI_KEYCODE_F1 F1 key.
ARKUI_KEYCODE_F2 F2 key.
ARKUI_KEYCODE_F3 F3 key.
ARKUI_KEYCODE_F4 F4 key.
ARKUI_KEYCODE_F5 F5 key.
ARKUI_KEYCODE_F6 F6 key.
ARKUI_KEYCODE_F7 F7 key.
ARKUI_KEYCODE_F8 F8 key.
ARKUI_KEYCODE_F9 F9 key.
ARKUI_KEYCODE_F10 F10 key.
ARKUI_KEYCODE_F11 F11 key.
ARKUI_KEYCODE_F12 F12 key.
ARKUI_KEYCODE_NUM_LOCK Number Lock key.
ARKUI_KEYCODE_NUMPAD_0 Key 0 on numeric keypad.
ARKUI_KEYCODE_NUMPAD_1 Key 1 on numeric keypad.
ARKUI_KEYCODE_NUMPAD_2 Key 2 on numeric keypad.
ARKUI_KEYCODE_NUMPAD_3 Key 3 on numeric keypad.
ARKUI_KEYCODE_NUMPAD_4 Key 4 on numeric keypad.
ARKUI_KEYCODE_NUMPAD_5 Key 5 on numeric keypad.
ARKUI_KEYCODE_NUMPAD_6 Key 6 on numeric keypad.
ARKUI_KEYCODE_NUMPAD_7 Key 7 on numeric keypad.
ARKUI_KEYCODE_NUMPAD_8 Key 8 on numeric keypad.
ARKUI_KEYCODE_NUMPAD_9 Key 9 on numeric keypad.
ARKUI_KEYCODE_NUMPAD_DIVIDE Key / on numeric keypad.
ARKUI_KEYCODE_NUMPAD_MULTIPLY Key * on numeric keypad.
ARKUI_KEYCODE_NUMPAD_SUBTRACT Key - on numeric keypad.
ARKUI_KEYCODE_NUMPAD_ADD Key + on numeric keypad.
ARKUI_KEYCODE_NUMPAD_DOT Key . on numeric keypad.
ARKUI_KEYCODE_NUMPAD_COMMA Key , on numeric keypad.
ARKUI_KEYCODE_NUMPAD_ENTER Enter key on numeric keypad.
ARKUI_KEYCODE_NUMPAD_EQUALS Key = on numeric keypad.
ARKUI_KEYCODE_NUMPAD_LEFT_PAREN Key ( on numeric keypad.
ARKUI_KEYCODE_NUMPAD_RIGHT_PAREN Key ) on numeric keypad.

ArkUI_KeyEventType

enum ArkUI_KeyEventType

Description

Type of a key.

Since: 14

Enum Description
ARKUI_KEY_EVENT_UNKNOWN Unknown.
ARKUI_KEY_EVENT_DOWN Pressing of a key.
ARKUI_KEY_EVENT_UP Release of a key.
ARKUI_KEY_EVENT_LONG_PRESS Long press of a key.
ARKUI_KEY_EVENT_CLICK Click of a key.

ArkUI_KeyIntension

enum ArkUI_KeyIntension

Description

Enumerates the key intentions.

Since: 14

Enum Description
ARKUI_KEY_INTENSION_UNKNOWN Unknown intention.
ARKUI_KEY_INTENSION_UP Upward.
ARKUI_KEY_INTENSION_DOWN Downward.
ARKUI_KEY_INTENSION_LEFT Leftward.
ARKUI_KEY_INTENSION_RIGHT Rightward.
ARKUI_KEY_INTENSION_SELECT Select.
ARKUI_KEY_INTENSION_ESCAPE
ARKUI_KEY_INTENSION_BACK Back.
ARKUI_KEY_INTENSION_FORWARD Forward.
ARKUI_KEY_INTENSION_MENU Menu.
ARKUI_KEY_INTENSION_HOME Home.
ARKUI_KEY_INTENSION_PAGE_UP Page up.
ARKUI_KEY_INTENSION_PAGE_DOWN Page down.
ARKUI_KEY_INTENSION_ZOOM_OUT Zoom out.
ARKUI_KEY_INTENSION_ZOOM_IN Zoom in.
ARKUI_KEY_INTENTION_MEDIA_PLAY_PAUSE Play.
ARKUI_KEY_INTENTION_MEDIA_FAST_FORWARD Fast-forward.
ARKUI_KEY_INTENTION_MEDIA_FAST_PLAYBACK Fast playback.
ARKUI_KEY_INTENTION_MEDIA_NEXT Play next.
ARKUI_KEY_INTENTION_MEDIA_PREVIOUS Play previous.
ARKUI_KEY_INTENTION_MEDIA_MUTE Mute.
ARKUI_KEY_INTENTION_VOLUME_UP Volume up.
ARKUI_KEY_INTENTION_VOLUME_DOWN Volume down.
ARKUI_KEY_INTENTION_CALL Answer a call.
ARKUI_KEY_INTENTION_CAMERA Camera.

ArkUI_KeySourceType

enum ArkUI_KeySourceType

Description

Enumerates the types of input devices that trigger key events.

Since: 14

Enum Description
ARKUI_KEY_SOURCE_UNKNOWN Unknown type.
ARKUI_KEY_SOURCE_TYPE_MOUSE Mouse.
ARKUI_KEY_SOURCE_TYPE_KEYBOARD Keyboard.
ARKUI_KEY_SOURCE_TYPE_JOYSTICK Joystick.

ArkUI_LengthMetricUnit

enum ArkUI_LengthMetricUnit

Description

Enumerates the component units.

Since: 12

Enum Description
ARKUI_LENGTH_METRIC_UNIT_DEFAULT Default, which is fp for fonts and vp for non-fonts.
ARKUI_LENGTH_METRIC_UNIT_PX px.
ARKUI_LENGTH_METRIC_UNIT_VP vp.
ARKUI_LENGTH_METRIC_UNIT_FP fp.

ArkUI_LinearGradientDirection

enum ArkUI_LinearGradientDirection

Description

Enumerates the gradient directions.

Since: 12

Enum Description
ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT From right to left.
ARKUI_LINEAR_GRADIENT_DIRECTION_TOP From bottom to top.
ARKUI_LINEAR_GRADIENT_DIRECTION_RIGHT From left to right.
ARKUI_LINEAR_GRADIENT_DIRECTION_BOTTOM From top to bottom.
ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT_TOP From lower right to upper left.
ARKUI_LINEAR_GRADIENT_DIRECTION_LEFT_BOTTOM From upper right to lower left.
ARKUI_LINEAR_GRADIENT_DIRECTION_RIGHT_TOP From lower left to upper right.
ARKUI_LINEAR_GRADIENT_DIRECTION_RIGHT_BOTTOM From upper left to lower right.
ARKUI_LINEAR_GRADIENT_DIRECTION_NONE No gradient.
ARKUI_LINEAR_GRADIENT_DIRECTION_CUSTOM Custom direction.

ArkUI_ListItemAlignment

enum ArkUI_ListItemAlignment

Description

Enumerates the alignment modes of items along the cross axis.

Since: 12

Enum Description
ARKUI_LIST_ITEM_ALIGNMENT_START The list items are packed toward the start edge of the List component along the cross axis.
ARKUI_LIST_ITEM_ALIGNMENT_CENTER The list items are centered in the List component along the cross axis.
ARKUI_LIST_ITEM_ALIGNMENT_END The list items are packed toward the end edge of the List component along the cross axis.

ArkUI_ListItemSwipeActionState

enum ArkUI_ListItemSwipeActionState

Description

Enumerates the swipe action item states of list items.

Since: 12

Enum Description
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.
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.
ARKUI_LIST_ITEM_SWIPE_ACTION_STATE_ACTIONING In-action state. The list item is in this state when it enters the delete area.

ArkUI_ListItemSwipeEdgeEffect

enum ArkUI_ListItemSwipeEdgeEffect

Description

Enumerates the swipe action item edge effects of list items.

Since: 12

Enum Description
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.
ARKUI_LIST_ITEM_SWIPE_EDGE_EFFECT_NONE The list item cannot scroll beyond the edge of the list.

ArkUI_MaskType

enum ArkUI_MaskType

Description

Enumerates the mask types.

Since: 12

Enum Description
ARKUI_MASK_TYPE_RECTANGLE Rectangle.
ARKUI_MASK_TYPE_CIRCLE (circle)
ARKUI_MASK_TYPE_ELLIPSE Ellipse.
ARKUI_MASK_TYPE_PATH Path Type
ARKUI_MASK_TYPE_PROGRESS Progress indicator.

ArkUI_NativeAPIVariantKind

enum ArkUI_NativeAPIVariantKind

Description

Defines the native API types.

Since: 12

Enum Description
ARKUI_NATIVE_NODE API related to UI components. For details, see the struct definition in <arkui/native_node.h>.
ARKUI_NATIVE_DIALOG API related to dialog boxes. For details, see the struct definition in <arkui/native_dialog.h>.
ARKUI_NATIVE_GESTURE API related to gestures. For details, see the struct definition in <arkui/native_gesture.h>.
ARKUI_NATIVE_ANIMATE API related to animations. For details, see the struct definition in <arkui/native_animate.h>.

ArkUI_NavDestinationState

enum ArkUI_NavDestinationState

Description

Defines an enum for the NavDestination component states.

Since: 12

Enum Description
ARKUI_NAV_DESTINATION_STATE_ON_SHOW The NavDestination component is displayed.
ARKUI_NAV_DESTINATION_STATE_ON_HIDE The NavDestination component is hidden.
ARKUI_NAV_DESTINATION_STATE_ON_APPEAR The NavDestination component is mounted to the component tree.
ARKUI_NAV_DESTINATION_STATE_ON_DISAPPEAR The NavDestination component is unmounted from the component tree.
ARKUI_NAV_DESTINATION_STATE_ON_WILL_SHOW The NavDestination is about to be displayed.
ARKUI_NAV_DESTINATION_STATE_ON_WILL_HIDE The NavDestination is about to be hidden.
ARKUI_NAV_DESTINATION_STATE_ON_WILL_APPEAR The NavDestination is about to be mounted to the component tree.
ARKUI_NAV_DESTINATION_STATE_ON_WILL_DISAPPEAR The NavDestination component is about to be unmounted from the component tree.
ARKUI_NAV_DESTINATION_STATE_ON_BACK_PRESS The back button is pressed for the NavDestination component.

ArkUI_NodeAdapterEventType

enum ArkUI_NodeAdapterEventType

Description

Enumerates node adapter events.

Since: 12

Enum Description
NODE_ADAPTER_EVENT_WILL_ATTACH_TO_NODE This event occurs when the component is attached to the adapter.
NODE_ADAPTER_EVENT_WILL_DETACH_FROM_NODE This event occurs when the component is detached from the adapter.
NODE_ADAPTER_EVENT_ON_GET_NODE_ID This event occurs when the adapter obtains the unique ID of the new element to add.
NODE_ADAPTER_EVENT_ON_ADD_NODE_TO_ADAPTER This event occurs when the adapter obtains the content of the new element to add.
NODE_ADAPTER_EVENT_ON_REMOVE_NODE_FROM_ADAPTER This event occurs when the adapter removes an element.

ArkUI_NodeAttributeType

enum ArkUI_NodeAttributeType

Description

Defines the ArkUI style attributes that can be set on the native side.

Since: 12

Enum Description
NODE_WIDTH Defines the width attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: width, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: width, in vp.
NODE_HEIGHT Defines the height attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: height, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: height, in vp.
NODE_BACKGROUND_COLOR Defines the background color attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: background color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: background color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
NODE_BACKGROUND_IMAGE Defines the background image attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
.value[0]?.i32: whether to repeat the image. Optional. The parameter type is ArkUI_ImageRepeat. The default value is ARKUI_IMAGE_REPEAT_NONE.
.object: PixelMap object. The parameter type is ArkUI_DrawableDescriptor.
Format of the return value ArkUI_AttributeItem:
.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.
.value[0].i32: whether to repeat the image. The parameter type is ArkUI_ImageRepeat.
.object: PixelMap object. The parameter type is ArkUI_DrawableDescriptor. Either .object or .string must be set.
NODE_PADDING Defines the padding attribute, which can be set, reset, and obtained as required through APIs.
There are two formats of ArkUI_AttributeItem for setting the attribute value:
1: Specify the same padding for the four directions.
.value[0].f32: padding, in vp.
2: Specify different paddings for different directions.
.value[0].f32: top padding, in vp.
.value[1].f32: right padding, in vp.
.value[2].f32: bottom padding, in vp.
.value[3].f32: left padding, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: top padding, in vp.
.value[1].f32: right padding, in vp.
.value[2].f32: bottom padding, in vp.
.value[3].f32: left padding, in vp.
NODE_ID Defines the component ID attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: component ID.
Format of the return value ArkUI_AttributeItem:
.string: component ID.
NODE_ENABLED Defines the interactivity attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: The value true means that the component can interact with users, and false means the opposite.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: The value 1 means that the component can interact with users, and 0 means the opposite.
NODE_MARGIN Defines the margin attribute, which can be set, reset, and obtained as required through APIs.
There are two formats of ArkUI_AttributeItem for setting the attribute value:
1: Specify the same margin for the four directions.
.value[0].f32: margin, in vp.
2: Specify different margins for different directions.
.value[0].f32: top margin, in vp.
.value[1].f32: right margin, in vp.
.value[2].f32: bottom margin, in vp.
.value[3].f32: left margin, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: top margin, in vp.
.value[1].f32: right margin, in vp.
.value[2].f32: bottom margin, in vp.
.value[3].f32: left margin, in vp.
NODE_TRANSLATE Defines the translate attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: distance to translate along the x-axis, in vp. The default value is 0.
.value[1].f32: distance to translate along the y-axis, in vp. The default value is 0.
.value[2].f32: distance to translate along the z-axis, in vp. The default value is 0.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: distance to translate along the x-axis, in vp.
.value[1].f32: distance to translate along the y-axis, in vp.
.value[2].f32: distance to translate along the z-axis, in vp.
NOTE
If more than three parameters are set, the setting does not take effect and no error code is returned.
NODE_SCALE Defines the scale attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: scale factor along the x-axis. The default value is 1.
.value[1].f32: scale factor along the y-axis. The default value is 1.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: scale factor along the x-axis.
.value[1].f32: scale factor along the y-axis.
NODE_ROTATE Defines the rotate attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: X-coordinate of the rotation axis vector. The default value is 0.
.value[1].f32: Y-coordinate of the rotation axis vector. The default value is 0.
.value[2].f32: Z-coordinate of the rotation axis vector. The default value is 0.
.value[3].f32: rotation angle. The default value is 0.
.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.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: X-coordinate of the rotation axis vector.
.value[1].f32: Y-coordinate of the rotation axis vector.
.value[2].f32: Z-coordinate of the rotation axis vector.
.value[3].f32: rotation angle.
.value[4].f32: line of sight, that is, the distance from the viewpoint to the z=0 plane, in vp.
NODE_BRIGHTNESS Sets the brightness attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: brightness value. The default value is 1.0, and the recommended value range is [0, 2].
Format of the return value ArkUI_AttributeItem:
.value[0].f32: brightness value.
NODE_SATURATION Sets the saturation attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: saturation value. The default value is 1.0, and the recommended value range is [0, 50).
Format of the return value ArkUI_AttributeItem:
.value[0].f32: saturation value.
NODE_BLUR Sets the blur attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
NODE_LINEAR_GRADIENT Sets the gradient attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: start angle of the linear gradient. This attribute takes effect only when 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.
.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
.value[2].i32: whether the colors are repeated. The default value is false.
.object: The parameter type is ArkUI_ColorStop. - colors: array of color stops, each of which consists of a color and its stop position. Invalid colors are automatically skipped.
colors: colors of the color stops.
stops: stop positions of the color stops.
size: number of colors.
Format of the return value ArkUI_AttributeItem:
.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.
.value[1].i32: direction of the linear gradient.
.value[2].i32: whether the colors are repeated.
.object: - colors: array of color stops, each of which consists of a color and its stop position. Invalid colors are automatically skipped.
colors: colors of the color stops.
stops: stop positions of the color stops.
size: number of colors.
NODE_ALIGNMENT Sets the alignment attribute, which can be set, reset, and obtained as required through APIs.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: alignment mode. The parameter type is ArkUI_Alignment. The default value is ARKUI_ALIGNMENT_CENTER.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: alignment mode. The parameter type is ArkUI_Alignment.
NODE_OPACITY Defines the opacity attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: opacity value. The value ranges from 0 to 1.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: opacity value. The value ranges from 0 to 1.
NODE_BORDER_WIDTH Defines the border width attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
1: .value[0].f32: width of the four borders.
2: .value[0].f32: width of the top border.
.value[1].f32: width of the right border.
.value[2].f32: width of the bottom border.
.value[3].f32: width of the left border.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: width of the top border.
.value[1].f32: width of the right border.
.value[2].f32: width of the bottom border.
.value[3].f32: width of the left border.
NODE_BORDER_RADIUS Defines the border corner radius attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
1: .value[0].f32: radius of the four corners.
2: .value[0].f32: radius of the upper left corner.
.value[1].f32: radius of the upper right corner.
.value[2].f32: radius of the lower left corner.
.value[3].f32: radius of the lower right corner.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: radius of the upper left corner.
.value[1].f32: radius of the upper right corner.
.value[2].f32: radius of the lower left corner.
.value[3].f32: radius of the lower right corner.
NODE_BORDER_COLOR Defines the border color attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
1: .value[0].u32: color of the four borders, in 0xARGB format, for example, 0xFFFF11FF.
2: .value[0].u32: color of the top border, in 0xARGB format, for example, 0xFFFF11FF.
.value[1].u32: color of the right border, in 0xARGB format, for example, 0xFFFF11FF.
.value[2].u32: color of the lower border, in 0xARGB format, for example, 0xFFFF11FF.
.value[3].u32: color of the left border, in 0xARGB format, for example, 0xFFFF11FF.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color of the top border, in 0xARGB format, for example, 0xFFFF11FF.
.value[1].u32: color of the right border, in 0xARGB format, for example, 0xFFFF11FF.
.value[2].u32: color of the lower border, in 0xARGB format, for example, 0xFFFF11FF.
.value[3].u32: color of the left border, in 0xARGB format, for example, 0xFFFF11FF.
NODE_BORDER_STYLE Defines the border line style attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
1: .value[0].i32: line style of the four borders. The parameter type is ArkUI_BorderStyle. The default value is ARKUI_BORDER_STYLE_SOLID.
2: .value[0].i32: line style of the top border. The parameter type is ArkUI_BorderStyle. The default value is ARKUI_BORDER_STYLE_SOLID.
.value[1].i32: line style of the right border. The parameter type is ArkUI_BorderStyle. The default value is ARKUI_BORDER_STYLE_SOLID.
.value[2].i32: line style of the bottom border. The parameter type is ArkUI_BorderStyle. The default value is ARKUI_BORDER_STYLE_SOLID.
.value[3].i32: line style of the left border. The parameter type is ArkUI_BorderStyle. The default value is ARKUI_BORDER_STYLE_SOLID.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: line style of the top border.
.value[1].i32: line style of the right border.
.value[2].i32: line style of the bottom border.
.value[3].i32: line style of the left border.
NODE_Z_INDEX Defines the z-index attribute for the stack sequence. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: z-index value.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: z-index value.
NODE_VISIBILITY Defines the visibility attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to show or hide the component. The parameter type is ArkUI_Visibility. The default value is ARKUI_VISIBILITY_VISIBLE.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to show or hide the component. The parameter type is ArkUI_Visibility. The default value is ARKUI_VISIBILITY_VISIBLE.
NODE_CLIP Defines the clip attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
NODE_CLIP_SHAPE Defines the clipping region on the component. This attribute can be set and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute, which supports five types of shapes:
1. Rectangle:
.value[0].i32: type of shape. The parameter type is ArkUI_ClipType. The value is ARKUI_CLIP_TYPE_RECTANGLE for the rectangle shape.
.value[1].f32: width of the rectangle.
.value[2].f32: height of the rectangle.
.value[3].f32: width of the rounded corner of the rectangle.
.value[4].f32: height of the rounded corner of the rectangle.
.value[5]?.f32: radius of the upper left corner of the rectangle.
.value[6]?.f32: radius of the lower left corner of the rectangle.
.value[7]?.f32: radius of the upper right corner of the rectangle.
.value[8]?.f32: radius of the lower right corner of the rectangle.
2. Circle:
.value[0].i32: type of shape. The parameter type is ArkUI_ClipType. The value is ARKUI_CLIP_TYPE_CIRCLE for the circle shape.
.value[1].f32: width of the circle.
.value[2].f32: height of the circle.
3. Ellipse:
.value[0].i32: type of shape. The parameter type is ArkUI_ClipType. The value is ARKUI_CLIP_TYPE_ELLIPSE for the ellipse shape.
.value[1].f32: width of the ellipse.
.value[2].f32: height of the ellipse.
4. Path:
.value[0].i32: type of shape. The parameter type is ArkUI_ClipType. The value is ARKUI_CLIP_TYPE_PATH for the path shape.
.value[1].f32: width of the path.
.value[2].f32: height of the path.
.string: command for drawing the path.
Format of the return value ArkUI_AttributeItem, which supports five types of shapes:
1. Rectangle:
.value[0].i32: type of shape. The parameter type is ArkUI_ClipType. The value is ARKUI_CLIP_TYPE_RECTANGLE for the rectangle shape.
.value[1].f32: width of the rectangle.
.value[2].f32: height of the rectangle.
.value[3].f32: width of the rounded corner of the rectangle.
.value[4].f32: height of the rounded corner of the rectangle.
.value[5]?.f32: radius of the upper left corner of the rectangle.
.value[6]?.f32: radius of the lower left corner of the rectangle.
.value[7]?.f32: radius of the upper right corner of the rectangle.
.value[8]?.f32: radius of the lower right corner of the rectangle.
2. Circle:
.value[0].i32: type of shape. The parameter type is ArkUI_ClipType. The value is ARKUI_CLIP_TYPE_CIRCLE for the circle shape.
.value[1].f32: width of the circle.
.value[2].f32: height of the circle.
3. Ellipse:
.value[0].i32: type of shape. The parameter type is ArkUI_ClipType. The value is ARKUI_CLIP_TYPE_ELLIPSE for the ellipse shape.
.value[1].f32: width of the ellipse.
.value[2].f32: height of the ellipse.
4. Path:
.value[0].i32: type of shape. The parameter type is ArkUI_ClipType. The value is ARKUI_CLIP_TYPE_PATH for the path shape.
.value[1].f32: width of the path.
.value[2].f32: height of the path.
.string: command for drawing the path.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0...15].f32: 16 floating-point numbers.
Format of the return value ArkUI_AttributeItem:
.value[0...15].f32: 16 floating-point numbers.
NODE_HIT_TEST_BEHAVIOR Defines the hit test behavior attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: hit test mode. The parameter type is ArkUI_HitTestMode. The default value is ARKUI_HIT_TEST_MODE_DEFAULT.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: hit test mode. The parameter type is ArkKUI_HitTestMode. The default value is ARKUI_HIT_TEST_MODE_DEFAULT.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: X coordinate.
.value[1].f32: Y coordinate.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: X coordinate.
.value[1].f32: Y coordinate.
NODE_SHADOW Defines the shadow attribute. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: shadow effect. The parameter type is ArkUI_ShadowStyle.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: shadow effect. The parameter type is ArkUI_ShadowStyle.
NODE_CUSTOM_SHADOW Defines the custom shadow effect. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0]?.f32: blur radius of the shadow, in vp.
.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.
.value[2]?.f32: offset of the shadow along the x-axis, in px.
.value[3]?.f32: offset of the shadow along the y-axis, in px.
.value[4]?.i32: shadow type ArkUI_ShadowType. The default value is ARKUI_SHADOW_TYPE_COLOR.
.value[5]?.u32: shadow color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
.value[6]?.u32: whether to fill the shadow. The value 1 means to fill the shadow, and 0 means the opposite.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: blur radius of the shadow, in vp.
.value[1].i32: whether to enable the coloring strategy.
.value[2].f32: offset of the shadow along the x-axis, in px.
.value[3].f32: offset of the shadow along the y-axis, in px.
.value[4].i32: shadow type ArkUI_ShadowType. The default value is ARKUI_SHADOW_TYPE_COLOR.
.value[5].u32: shadow color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
.value[6].u32: whether to fill the shadow. The value 1 means to fill the shadow, and 0 means the opposite.
NODE_BACKGROUND_IMAGE_SIZE Defines the background image width and height. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: width of the image. The value range is [0, +∞), and the unit is vp.
.value[1].f32: height of the image. The value range is [0, +∞), and the unit is vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: width of the image, in vp.
.value[1].f32: height of the image, in vp.
NODE_BACKGROUND_IMAGE_SIZE_WITH_STYLE Defines the background image size. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: size of the background image. The value is an enumerated value of ArkUI_ImageSize.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: size of the background image. The value is an enumerated value of ArkUI_ImageSize.
NODE_BACKGROUND_BLUR_STYLE Defines the background blur attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: blur type. The value is an enumerated value of ArkUI_BlurStyle.
.value[1]?.i32: color mode. The value is an enumerated value of ArkUI_ColorMode.
.value[2]?.i32: adaptive color mode. The value is an enumerated value of ArkUI_AdaptiveColor.
.value[3]?.f32: blur degree. The value range is [0.0, 1.0].
.value[4]?.f32: start boundary of grayscale blur.
.value[5]?.f32: end boundary of grayscale blur.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: blur type. The value is an enumerated value of ArkUI_BlurStyle.
.value[1].i32: color mode. The value is an enumerated value of ArkUI_ColorMode.
.value[2].i32: adaptive color mode. The value is an enumerated value of ArkUI_AdaptiveColor.
.value[3].f32: blur degree. The value range is [0.0, 1.0].
.value[4].f32: start boundary of grayscale blur.
.value[5].f32: end boundary of grayscale blur.
NODE_TRANSFORM_CENTER Defines the transform center attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0]?.f32: X coordinate of the center point, in vp.
.value[1]?.f32: Y coordinate of the center point, in vp.
.value[2]?.f32: Z coordinate of the center point, in vp.
.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.
.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.
.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.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: X coordinate of the center point, in vp.
.value[1].f32: Y coordinate of the center point, in vp.
.value[2].f32: Z coordinate of the center point, in vp.
Note: If the coordinate is expressed in a number that represents a percentage, the attribute obtaining API returns the calculated value in vp.
NODE_OPACITY_TRANSITION Defines the transition opacity attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: opacity values of the start and end points.
.value[1].i32: animation duration, in milliseconds.
.value[2].i32: animation curve type. The value is an enumerated value of ArkUI_AnimationCurve.
.value[3]?.i32: animation delay duration, in milliseconds.
.value[4]?.i32: number of times that the animation is played.
.value[5]?.i32: animation playback mode. The value is an enumerated value of ArkUI_AnimationPlayMode.
.value[6]?.f32: animation playback speed.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: opacity values of the start and end points.
.value[1].i32: animation duration, in milliseconds.
.value[2].i32: animation curve type. The value is an enumerated value of ArkUI_AnimationCurve.
.value[3].i32: animation delay duration, in milliseconds.
.value[4].i32: number of times that the animation is played.
.value[5].i32: animation playback mode. The value is an enumerated value of ArkUI_AnimationPlayMode.
.value[6].f32: animation playback speed.
NODE_ROTATE_TRANSITION Defines the transition rotation attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: X-component of the rotation vector.
.value[1].f32: Y-component of the rotation vector.
.value[2].f32: Z-component of the rotation vector
.value[3].f32: angle.
.value[4].f32: line of sight. The default value is 0.0f.
.value[5].i32: animation duration, in milliseconds.
.value[6].i32: animation curve type. The value is an enumerated value of ArkUI_AnimationCurve.
.value[7]?.i32: animation delay duration, in milliseconds.
.value[8]?.i32: number of times that the animation is played.
.value[9]?.i32: animation playback mode. The value is an enumerated value of ArkUI_AnimationPlayMode.
.value[10]?.f32: animation playback speed.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: X-component of the rotation vector.
.value[1].f32: Y-component of the rotation vector.
.value[2].f32: Z-component of the rotation vector
.value[3].f32: angle.
.value[4].f32: line of sight.
.value[5].i32: animation duration, in milliseconds.
.value[6].i32: animation curve type. The value is an enumerated value of ArkUI_AnimationCurve.
.value[7].i32: animation delay duration, in milliseconds.
.value[8].i32: number of times that the animation is played.
.value[9].i32: animation playback mode. The value is an enumerated value of ArkUI_AnimationPlayMode.
.value[10].f32: animation playback speed.
NODE_SCALE_TRANSITION Defines the transition scaling attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: scale factor along the x-axis.
.value[1].f32: scale factor along the y-axis.
.value[2].f32: scale factor along the z-axis.
value[3].i32: animation duration, in milliseconds.
.value[4].i32: animation curve type. The value is an enumerated value of ArkUI_AnimationCurve.
.value[5]?.i32: animation delay duration, in milliseconds.
.value[6]?.i32: number of times that the animation is played.
.value[7]?.i32: animation playback mode. The value is an enumerated value of ArkUI_AnimationPlayMode.
value[8]?.f32: animation playback speed.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: scale factor along the x-axis.
.value[1].f32: scale factor along the y-axis.
.value[2].f32: scale factor along the z-axis.
value[3].i32: animation duration, in milliseconds.
.value[4].i32: animation curve type. The value is an enumerated value of ArkUI_AnimationCurve.
value[5].i32: animation delay duration, in milliseconds.
value[6].i32: number of times that the animation is played.
.value[7].i32: animation playback mode. The value is an enumerated value of ArkUI_AnimationPlayMode.
value[8].f32: animation playback speed.
NODE_TRANSLATE_TRANSITION Defines the transition translation attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
value[0].f32: translation distance along the x-axis, in vp.
value[1].f32: translation distance along the y-axis, in vp.
value[2].f32: translation distance along the z-axis, in vp.
value[3].i32: animation duration, in milliseconds.
value[4].i32: animation curve type. The value is an enumerated value of ArkUI_AnimationCurve.
value[5]?.i32: animation delay duration, in milliseconds.
value[6]?.i32: number of times that the animation is played.
value[7]?.i32: animation playback mode. The value is an enumerated value of ArkUI_AnimationPlayMode.
value[8]?.f32: animation playback speed.
Format of the return value ArkUI_AttributeItem:
value[0].f32: translation distance along the x-axis, in vp.
value[1].f32: translation distance along the y-axis, in vp.
value[2].f32: translation distance along the z-axis, in vp.
value[3].i32: animation duration, in milliseconds.
value[4].i32: animation curve type. The value is an enumerated value of ArkUI_AnimationCurve.
value[5].i32: animation delay duration, in milliseconds.
value[6].i32: number of times that the animation is played.
value[7].i32: animation playback mode. The value is an enumerated value of ArkUI_AnimationPlayMode.
value[8].f32: animation playback speed.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: ArkUI_TransitionEdge type.
.value[1].i32: animation duration, in milliseconds.
.value[2].i32: animation curve type. The value is an enumerated value of ArkUI_AnimationCurve.
.value[3]?.i32: animation delay duration, in milliseconds.
.value[4]?.i32: number of times that the animation is played.
.value[5]?.i32: animation playback mode. The value is an enumerated value of ArkUI_AnimationPlayMode.
.value[6]?.f32: animation playback speed.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: ArkUI_TransitionEdge type.
.value[1].i32: animation duration, in milliseconds.
.value[2].i32: animation curve type. The value is an enumerated value of ArkUI_AnimationCurve.
.value[3].i32: animation delay duration, in milliseconds.
.value[4].i32: number of times that the animation is played.
.value[5].i32: animation playback mode. The value is an enumerated value of ArkUI_AnimationPlayMode.
.value[6].f32: animation playback speed.
NODE_FOCUSABLE Defines the focus attribute, which can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: The parameter type is 1 or 0.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: The parameter type is 1 or 0.
NODE_DEFAULT_FOCUS Defines the default focus attribute, which can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
value[0].i32: The parameter type is 1 or 0.
Format of the return value ArkUI_AttributeItem:
value[0].i32: The parameter type is 1 or 0.
NODE_RESPONSE_REGION Defines the touch target attribute, which can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.data[0].f32: X coordinate of the touch point relative to the upper left corner of the component, in vp.
.data[1].f32: Y coordinate of the touch point relative to the upper left corner of the component, in vp.
.data[2].f32: width of the touch target, in percentage.
.data[3].f32: height of the touch target, in percentage.
.data[4...].f32: Multiple touch targets can be set. The sequence of the parameters is the same as the preceding.
Format of the return value ArkUI_AttributeItem:
.data[0].f32: X coordinate of the touch point relative to the upper left corner of the component, in vp.
.data[1].f32: Y coordinate of the touch point relative to the upper left corner of the component, in vp.
.data[2].f32: width of the touch target, in percentage.
.data[3].f32: height of the touch target, in percentage.
.data[4...].f32: Multiple touch targets can be set. The sequence of the parameters is the same as the preceding.
NODE_OVERLAY Defines the overlay attribute, which can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.string: mask text.
.value[0]?.i32: position of the overlay relative to the component. Optional. The parameter type is ArkUI_Alignment. The default value is ARKUI_ALIGNMENT_TOP_START.
.value[1]?.f32: offset of the overlay relative to the upper left corner of itself on the x-axis, in vp. Optional.
.value[2]?.f32: offset of the overlay relative to the upper left corner of itself on the y-axis, in vp. Optional.
Format of the return value ArkUI_AttributeItem:
.string: mask text.
.value[0].i32: position of the overlay relative to the component. The parameter type is ArkUI_Alignment. The default value is ARKUI_ALIGNMENT_TOP_START.
.value[1].f32: offset of the overlay relative to the upper left corner of itself on the x-axis, in vp.
.value[2].f32: offset of the overlay relative to the upper left corner of itself on the y-axis, in vp.
NODE_SWEEP_GRADIENT Defines the sweep gradient effect. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0]?.f32: X coordinate of the sweep gradient center relative to the upper left corner of the component.
.value[1]?.f32: Y coordinate of the sweep gradient center relative to the upper left corner of the component.
.value[2]?.f32: start point of the sweep gradient. The default value is 0.
.value[3]?.f32: end point of the sweep gradient. The default value is 0.
.value[4]?.f32: rotation angle of the sweep gradient. The default value is 0.
.value[5]?.i32: whether the colors are repeated. The value 1 means that the colors are repeated, and 0 means the opposite.
.object: The parameter type is ArkUI_ColorStop. - colors: array of color stops, each of which consists of a color and its stop position. Invalid colors are automatically skipped.
colors: colors of the color stops.
stops: stop positions of the color stops.
size: number of colors.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: X coordinate of the sweep gradient center relative to the upper left corner of the component.
.value[1].f32: Y coordinate of the sweep gradient center relative to the upper left corner of the component.
.value[2].f32: start point of the sweep gradient. The default value is 0.
.value[3].f32: end point of the sweep gradient. The default value is 0.
.value[4].f32: rotation angle of the sweep gradient. The default value is 0.
.value[5].i32: whether the colors are repeated. The value 1 means that the colors are repeated, and 0 means the opposite.
.object: The parameter type is ArkUI_ColorStop. - colors: array of color stops, each of which consists of a color and its stop position. Invalid colors are automatically skipped.
colors: colors of the color stops.
stops: stop positions of the color stops.
size: number of colors.
NODE_RADIAL_GRADIENT Defines the radial gradient effect. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0]?.f32: X coordinate of the radial gradient center relative to the upper left corner of the component.
.value[1]?.f32: Y coordinate of the radial gradient center relative to the upper left corner of the component.
.value[2]?.f32: radius of the radial gradient. The default value is 0.
.value[3]?.i32: whether the colors are repeated. The value 1 means that the colors are repeated, and 0 means the opposite.
.object: The parameter type is ArkUI_ColorStop. - colors: array of color stops, each of which consists of a color and its stop position. Invalid colors are automatically skipped.
colors: colors of the color stops.
stops: stop positions of the color stops.
size: number of colors.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: X coordinate of the radial gradient center relative to the upper left corner of the component.
.value[1].f32: Y coordinate of the radial gradient center relative to the upper left corner of the component.
.value[2].f32: radius of the radial gradient. The default value is 0.
.value[3].i32: whether the colors are repeated. The value 1 means that the colors are repeated, and 0 means the opposite.
.object: The parameter type is ArkUI_ColorStop. - colors: array of color stops, each of which consists of a color and its stop position. Invalid colors are automatically skipped.
colors: colors of the color stops.
stops: stop positions of the color stops.
size: number of colors.
NODE_MASK Adds a mask of the specified shape to the component. APIs are provided for setting and obtaining the attribute value.
Format of the ArkUI_AttributeItem parameter for setting the attribute, which supports five types of shapes:
1. Rectangle:
.value[0].u32 fill color, in 0xARGB format.
.value[1].u32: stroke color, in 0xARGB format.
.value[2].f32: stroke width, in vp.
.value[3].i32: mask type. The parameter type is ArkUI_MaskType. The value is ARKUI_MASK_TYPE_RECTANGLE for the rectangle shape.
.value[4].f32: width of the rectangle.
.value[5].f32: height of the rectangle.
.value[6].f32: width of the rounded corner of the rectangle.
.value[7].f32: height of the rounded corner of the rectangle.
.value[8]?.f32: radius of the upper left corner of the rectangle.
.value[9]?.f32: radius of the lower left corner of the rectangle.
.value[10]?.f32: radius of the upper right corner of the rectangle.
.value[11]?.f32: radius of the lower right corner of the rectangle.
2. Circle:
.value[0].u32 fill color, in 0xARGB format.
.value[1].u32: stroke color, in 0xARGB format.
.value[2].f32: stroke width, in vp.
.value[3].i32: mask type. The parameter type is ArkUI_MaskType. The value is ARKUI_MASK_TYPE_CIRCLE for the circle shape.
.value[4].f32: width of the circle.
.value[5].f32: height of the circle.
3. Ellipse:
.value[0].u32 fill color, in 0xARGB format.
.value[1].u32: stroke color, in 0xARGB format.
.value[2].f32: stroke width, in vp.
.value[3].i32: mask type. The parameter type is ArkUI_MaskType. The value is ARKUI_MASK_TYPE_ELLIPSE for the ellipse shape.
.value[4].f32: width of the ellipse.
.value[5].f32: height of the ellipse.
4. Path:
.value[0].u32 fill color, in 0xARGB format.
.value[1].u32: stroke color, in 0xARGB format.
.value[2].f32: stroke width, in vp.
.value[3].i32: mask type. The parameter type is ArkUI_MaskType. The value is ARKUI_MASK_TYPE_PATH for the path shape.
.value[4].f32: width of the path.
.value[5].f32: height of the path.
.string: command for drawing the path.
5. Progress:
.value[0].i32: mask type. The parameter type is ArkUI_MaskType. The value is ARKUI_MASK_TYPE_PROGRESS for the progress shape.
.value[1].f32: current value of the progress indicator.
.value[2].f32: maximum value of the progress indicator.
.value[3].u32: color of the progress indicator.
Format of the return value ArkUI_AttributeItem, which supports five types of shapes:
1. Rectangle:
.value[0].u32 fill color, in 0xARGB format.
.value[1].u32: stroke color, in 0xARGB format.
.value[2].f32: stroke width, in vp.
.value[3].i32: mask type.
.value[4].f32: width of the rectangle.
.value[5].f32: height of the rectangle.
.value[6].f32: width of the rounded corner of the rectangle.
.value[7].f32: height of the rounded corner of the rectangle.
.value[8]?.f32: radius of the upper left corner of the rectangle.
.value[9]?.f32: radius of the lower left corner of the rectangle.
.value[10]?.f32: radius of the upper right corner of the rectangle.
.value[11]?.f32: radius of the lower right corner of the rectangle.
2. Circle:
.value[0].u32 fill color, in 0xARGB format.
.value[1].u32: stroke color, in 0xARGB format.
.value[2].f32: stroke width, in vp.
.value[3].i32: mask type.
.value[4].f32: width of the circle.
.value[5].f32: height of the circle.
3. Ellipse:
.value[0].u32 fill color, in 0xARGB format.
.value[1].u32: stroke color, in 0xARGB format.
.value[2].f32: stroke width, in vp.
.value[3].i32: mask type.
.value[4].f32: width of the ellipse.
.value[5].f32: height of the ellipse.
4. Path:
.value[0].u32 fill color, in 0xARGB format.
.value[1].u32: stroke color, in 0xARGB format.
.value[2].f32: stroke width, in vp.
.value[3].i32: mask type.
.value[4].f32: width of the path.
.value[5].f32: height of the path.
.string: command for drawing the path.
5. Progress:
.value[0].i32: mask type.
.value[1].f32: current value of the progress indicator.
.value[2].f32: maximum value of the progress indicator.
.value[3].u32: color of the progress indicator.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: blend mode. The parameter type is ArkUI_BlendMode. The default value is ARKUI_BLEND_MODE_NONE.
.value[1].?i32: how the specified blend mode is applied. The parameter type is ArkUI_BlendApplyType. The default value is BLEND_APPLY_TYPE_FAST.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: blend mode. The parameter type is ArkUI_BlendMode. The default value is ARKUI_BLEND_MODE_NONE.
.value[1].i32: how the specified blend mode is applied. The parameter type is ArkUI_BlendApplyType. The default value is BLEND_APPLY_TYPE_FAST.
NODE_DIRECTION Sets the direction of the main axis. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: direction of the main axis.
The parameter type is ArkUI_Direction. The default value is ARKUI_DIRECTION_AUTO.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: direction of the main axis.
The parameter type is ArkUI_Direction. The default value is ARKUI_DIRECTION_AUTO.
NODE_CONSTRAINT_SIZE Defines the size constraints. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: minimum width, in vp.
.value[1].f32: maximum width, in vp.
.value[2].f32: minimum height, in vp.
.value[3].f32: maximum height, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: minimum width, in vp.
.value[1].f32: maximum width, in vp.
.value[2].f32: minimum height, in vp.
.value[3].f32: maximum height, in vp.
NODE_GRAY_SCALE Defines the grayscale effect. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: grayscale conversion ratio. The value ranges from 0 to 1. For example, 0.5 indicates a 50% grayscale conversion ratio.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: grayscale conversion ratio. The value ranges from 0 to 1.
NODE_INVERT Inverts the image. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: image inversion ratio. The value ranges from 0 to 1. For example, 0.5 indicates a 50% image inversion ratio.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: image inversion ratio. The value ranges from 0 to 1.
NODE_SEPIA Defines the sepia conversion ratio. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: sepia conversion ratio. The value ranges from 0 to 1. For example, 0.5 indicates that a 50% sepia conversion ratio.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: sepia conversion ratio. The value ranges from 0 to 1.
NODE_CONTRAST Defines the contrast attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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).
Format of the return value ArkUI_AttributeItem:
.value[0].f32: contrast. Value range: [0, 10).
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.
There are two parameter formats of ArkUI_AttributeItem for setting the attribute:\n
1: .value[0].u32: color value, in 0xARGB format. For example, 0xFFFF0000 indicates red.
2: .value[0].i32: color enum ArkUI_ColoringStrategy.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color value, in 0xARGB format.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32 : offset along the x-axis, in vp.
.value[1].f32 : offset along the y-axis, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32 : offset along the x-axis, in vp.
.value[1].f32 : offset along the y-axis, in vp.
NODE_MARK_ANCHOR Sets the anchor for locating the component's child. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: X coordinate of the anchor, in vp.
.value[1].f32: Y coordinate of the anchor, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: X coordinate of the anchor, in vp.
.value[1].f32: Y coordinate of the anchor, in vp.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: position along the x-axis, in px.
.value[1].f32: position along the y-axis, in px.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: position along the x-axis, in px.
.value[1].f32: position along the y-axis, in px.
NODE_ALIGN_RULES Sets the alignment rules in the relative container. This attribute can be set, reset, and obtained as required through APIs.
.object: ArkUI_AlignmentRuleOption object that defines the alignment rules.
Format of the return value ArkUI_AttributeItem:
.object: ArkUI_AlignmentRuleOption object that defines the alignment rules.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: alignment mode of the child components along the cross axis of the parent container.
The parameter type is ArkUI_ItemAlignment. The default value is ARKUI_ITEM_ALIGNMENT_AUTO.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: alignment mode of the child components along the cross axis of the parent container.
The parameter type is ArkUI_ItemAlignment. The default value is ARKUI_ITEM_ALIGNMENT_AUTO.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: percentage of the parent container's remaining space that is allocated to the component.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: percentage of the parent container's remaining space that is allocated to the component.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: percentage of the parent container's shrink size that is allocated to the component.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: percentage of the parent container's shrink size that is allocated to the component.
NODE_FLEX_BASIS Sets the base size of the component. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: base size of the component on the main axis of the parent container.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: base size of the component on the main axis of the parent container.
NODE_ACCESSIBILITY_GROUP Sets the accessibility group. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
NODE_ACCESSIBILITY_TEXT Sets the accessibility text. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.string: accessibility text.
Format of the return value ArkUI_AttributeItem:
.string: accessibility text.
NODE_ACCESSIBILITY_MODE Defines the accessibility mode. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: auxiliary service mode. The parameter type is ArkUI_AccessibilityMode.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: auxiliary service mode. The parameter type is ArkUI_AccessibilityMode.
NODE_ACCESSIBILITY_DESCRIPTION Sets the accessibility description. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.string: accessibility description.
Format of the return value ArkUI_AttributeItem:
.string: accessibility description.
NODE_FOCUS_STATUS This interface is used to obtain focus attributes. Attributes can be set and obtained.
NOTE
Setting the parameter to 0 shifts focus from the currently focused component on the current level of the page to the root container.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: The parameter type is 1 or 0.
Format of the return value ArkUI_AttributeItem:
value[0].i32: The parameter type is 1 or 0.
NODE_ASPECT_RATIO Defines the aspect ratio attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: aspect ratio of the component, in width/height format.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: aspect ratio of the component, in width/height format.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: weight of the component along the main axis.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: weight of the component along the main axis.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: display priority of the component in the container.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: display priority of the component in the container.
NODE_OUTLINE_WIDTH Sets the thickness of an element's outline.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: thickness of the left outline.
.value[1].f32: thickness of the top outline.
.value[2].f32: thickness of the right outline.
.value[3].f32: thickness of the bottom outline.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: thickness of the left outline.
.value[1].f32: thickness of the top outline.
.value[2].f32: thickness of the right outline.
.value[3].f32: thickness of the bottom outline.
NODE_WIDTH_PERCENT Defines the width attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: width, in percentage.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: width, in percentage.
NODE_HEIGHT_PERCENT Defines the height attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: height, in percentage.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: height, in percentage.
NODE_PADDING_PERCENT Defines the padding attribute, which can be set, reset, and obtained as required through APIs.
There are two formats of ArkUI_AttributeItem for setting the attribute value:
1: Specify the same padding for the four directions.
.value[0].f32: padding, in percentage.
2: Specify different paddings for different directions.
.value[0].f32: top padding, in percentage.
.value[1].f32: right padding, in percentage.
.value[2].f32: bottom padding, in percentage.
.value[3].f32: left padding, in percentage.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: top padding, in percentage.
.value[1].f32: right padding, in percentage.
.value[2].f32: bottom padding, in percentage.
.value[3].f32: left padding, in percentage.
NODE_MARGIN_PERCENT Defines the margin attribute, which can be set, reset, and obtained as required through APIs.
There are two formats of ArkUI_AttributeItem for setting the attribute value:
1: Specify the same margin for the four directions.
.value[0].f32: margin, in percentage.
2: Specify different margins for different directions.
.value[0].f32: top margin, in percentage.
.value[1].f32: right margin, in percentage.
.value[2].f32: bottom margin, in percentage.
.value[3].f32: left margin, in percentage.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: top margin, in percentage.
.value[1].f32: right margin, in percentage.
.value[2].f32: bottom margin, in percentage.
.value[3].f32: left margin, in percentage.
NODE_GEOMETRY_TRANSITION Implements an implicit shared element transition. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
.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.
Format of the return value ArkUI_AttributeItem:
.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.
.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.
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.
This attribute has effect only when the parent container is RelativeContainer.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: direction of the chain. Enumeration ArkUI_Axis.
.value[1].i32: style of the chain. Enumeration ArkUI_RelativeLayoutChainStyle.
.value[0].i32: direction of the chain. Enumeration ArkUI_Axis.
.value[1].i32: style of the chain. Enumeration ArkUI_RelativeLayoutChainStyle.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32 Content filling mode. The enumerated values of ArkUI_RenderFit are used.
Format of the return value ArkUI_AttributeItem:
.value[0].i32 Content filling mode. The enumerated values of ArkUI_RenderFit are used.
NODE_OUTLINE_COLOR Defines the border color attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
1: .value[0].u32: color of the four borders, in 0xARGB format, for example, 0xFFFF11FF.
2: .value[0].u32: color of the top border, in 0xARGB format, for example, 0xFFFF11FF.
.value[1].u32: color of the right border, in 0xARGB format, for example, 0xFFFF11FF.
.value[2].u32: color of the lower border, in 0xARGB format, for example, 0xFFFF11FF.
.value[3].u32: color of the left border, in 0xARGB format, for example, 0xFFFF11FF.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color of the top border, in 0xARGB format, for example, 0xFFFF11FF.
.value[1].u32: color of the right border, in 0xARGB format, for example, 0xFFFF11FF.
.value[2].u32: color of the lower border, in 0xARGB format, for example, 0xFFFF11FF.
.value[3].u32: color of the left border, in 0xARGB format, for example, 0xFFFF11FF.
NODE_SIZE Sets the size. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: width, in vp.
.value[1].f32: height, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: width, in vp.
.value[1].f32: height, in vp.
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.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: The parameter type is 1 or 0.
Format of the return value ArkUI_AttributeItem:
value[0].i32: The parameter type is 1 or 0.
NODE_COLOR_BLEND The color overlay effect is added to the component. The attribute setting, attribute resetting, and attribute obtaining interfaces are supported.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: color to blend with the component, in 0xARGB format, for example, 0xFFFF11FF.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color to blend with the component, in 0xARGB format, for example, 0xFFFF11FF.
NODE_FOREGROUND_BLUR_STYLE Applies a foreground blur style to the component. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: foreground blur style. The value is an enum of ArkUI_BlurStyle.
.value[1]?.i32: color mode used for the foreground blur. The value is an enum of ArkUI_ColorMode.
.value[2]?.i32: adaptive color mode used for the foreground blur. The value is an enum of ArkUI_AdaptiveColor.
.value[3]?.f32: blur degree. The value range is [0.0, 1.0].
.value[4]?.i32: brightness of black in the grayscale blur. The value range is [0, 127].
.value[5]?.i32: degree of darkening the white color in the grayscale blur. The value range is [0, 127].
Format of the return value ArkUI_AttributeItem:
.value[0].i32: foreground blur style. The value is an enum of ArkUI_BlurStyle.
.value[1].i32: color mode used for the foreground blur. The value is an enum of ArkUI_ColorMode.
.value[2].i32: adaptive color mode used for the foreground blur. The value is an enum of ArkUI_AdaptiveColor.
.value[3].f32: blur degree. The value range is [0.0, 1.0].
.value[4].i32: brightness of black in the grayscale blur. The value range is [0, 127].
.value[5].i32: degree of darkening the white color in the grayscale blur. The value range is [0, 127].
NODE_LAYOUT_RECT Defines the component size and position for layout. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: X coordinate of the component, in px.
.value[1].i32: Y coordinate of the component, in px.
.value[2].i32: width of the component, in px.
.value[3].i32: height of the component, in px.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: X coordinate of the component, in px.
.value[1].i32: Y coordinate of the component, in px.
.value[2].i32: width of the component, in px.
.value[3].i32: height of the component, in px.
NODE_FOCUS_ON_TOUCH Sets whether the component is focusable on touch. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: The parameter type is 1 or 0.
Format of the return value ArkUI_AttributeItem:
value[0].i32: The parameter type is 1 or 0.
NODE_BORDER_WIDTH_PERCENT Defines the border width attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
1: .value[0].f32: width of the four borders, in percentage.
2: .value[0].f32: width of the top border, in percentage.
.value[1].f32: width of the right border, in percentage.
.value[2].f32: width of the bottom border, in percentage.
.value[3].f32: width of the left border, in percentage.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: width of the top border, in percentage.
.value[1].f32: width of the right border, in percentage.
.value[2].f32: width of the bottom border, in percentage.
.value[3].f32: width of the left border, in percentage.
NODE_BORDER_RADIUS_PERCENT Defines the border corner radius attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
1: .value[0].f32: radius of the four corners, in percentage.
2: .value[0].f32: radius of the upper left corner, in percentage.
.value[1].f32: radius of the upper right corner, in percentage.
.value[2].f32: radius of the lower left corner, in percentage.
.value[3].f32: radius of the lower right corner, in percentage.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: radius of the upper left corner, in percentage.
.value[1].f32: radius of the upper right corner, in percentage.
.value[2].f32: radius of the lower left corner, in percentage.
.value[3].f32: radius of the lower right corner, in percentage.
NODE_ACCESSIBILITY_ID Sets the custom accessibility ID. This attribute can be obtained.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: custom accessibility ID.
NODE_ACCESSIBILITY_ACTIONS Sets the accessibility action type. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].u32: accessibility operation type. The parameter type is ArkUI_AccessibilityActionType.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: accessibility operation type. The parameter type is ArkUI_AccessibilityActionType.
NODE_ACCESSIBILITY_ROLE Defines supported accessibility component types. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].u32: Accessibility component type. The parameter type is ArkUI_NodeType.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: Accessibility component type. The parameter type is ArkUI_NodeType.
NODE_ACCESSIBILITY_STATE Sets the accessibility state. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.object: accessibility state. The parameter type is ArkUI_AccessibilityState.
Format of the return value ArkUI_AttributeItem:
.object: accessibility state. The parameter type is ArkUI_AccessibilityState.
NODE_ACCESSIBILITY_VALUE Sets the accessibility value. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.object: accessibility value. The parameter type is ArkUI_AccessibilityValue.
Format of the return value ArkUI_AttributeItem:
.object: accessibility value. The parameter type is ArkUI_AccessibilityValue.
NODE_EXPAND_SAFE_AREA Sets the safe area to be expanded to. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0]?.u32: types of the expanded safe area, which are enumerated values of ArkUI_SafeAreaType. Example: ARKUI_SAFE_AREA_TYPE_SYSTEM | ARKUI_SAFE_AREA_TYPE_CUTOUT.
.value[1]?.u32: edges for expanding the safe area, which are enumerated values of ArkUI_SafeAreaEdge.
Example: ARKUI_SAFE_AREA_EDGE_TOP | ARKUI_SAFE_AREA_EDGE_BOTTOM.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: expanded safe area.
.
.value[1].u32: edges for expanding the safe area.
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.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[...].f32: threshold array. The value ranges from 0 to 1.
Format of the return value ArkUI_AttributeItem:
.value[...].f32: threshold array.
NODE_TRANSITION Sets the transition effect when the component is inserted or deleted. This attribute can be set and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.object: transition effect. The parameter type is ArkUI_TransitionEffect.
Format of the return value ArkUI_AttributeItem:
.object: transition effect. The parameter type is ArkUI_TransitionEffect.
NODE_UNIQUE_ID Defines the component ID. This attribute can be obtained through APIs.
NOTE
The component ID is read-only and unique in a process.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: component ID.
NODE_FOCUS_BOX Sets the style of the system focus box for this component.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
.value[1].f32: width of the focus box. Negative numbers and percentages are not supported.
.value[2].u32: color of the focus box.
NODE_CLICK_DISTANCE Defines the moving distance limit for the component-bound tap gesture. This attribute can be set as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: allowed moving distance of a finger, in vp.
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.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: The parameter type is 1 or 0.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: The parameter type is 1 or 0.
NODE_TEXT_CONTENT Defines the text content attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: text content.
Format of the return value ArkUI_AttributeItem:
.string: text content.
NODE_FONT_COLOR Defines the font color attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: font color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: font color value, in 0xARGB format.
NODE_FONT_SIZE Defines the font size attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: font size, in fp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: font size, in fp.
NODE_FONT_STYLE Defines the font style attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: font style ArkUI_FontStyle. The default value is ARKUI_FONT_STYLE_NORMAL.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: font style ArkUI_FontStyle.
NODE_FONT_WEIGHT Defines the font weight attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: font weight ArkUI_FontWeight. The default value is ARKUI_FONT_WEIGHT_NORMAL.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: font weight ArkUI_FontWeight.
NODE_TEXT_LINE_HEIGHT Defines the text line height attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: line height, in fp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: line height, in fp.
NODE_TEXT_DECORATION Defines the text decoration style and color. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: text decoration type ArkUI_TextDecorationType. The default value is ARKUI_TEXT_DECORATION_TYPE_NONE.
.value[1]?.u32: text decoration color, in 0xARGB format. For example, 0xFFFF0000 indicates red. Optional.
.value[2]?.i32: text decoration style ArkUI_TextDecorationStyle.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: text decoration type ArkUI_TextDecorationType.
.value[1].u32: text decoration color, in 0xARGB format.
.value[2].i32: text decoration style ArkUI_TextDecorationStyle.
NODE_TEXT_CASE Defines the text case attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: text case.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: text case.
NODE_TEXT_LETTER_SPACING Defines the letter spacing attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: letter spacing, in fp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: letter spacing, in fp.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: maximum number of lines in the text.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: maximum number of lines in the text.
NODE_TEXT_ALIGN Horizontal alignment mode of the text. The interfaces for setting, resetting, and obtaining attributes are supported.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: horizontal alignment mode of the text. The value is an enum of ArkUI_TextAlignment.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: horizontal alignment mode of the text. The value is an enum of ArkUI_TextAlignment.
NODE_TEXT_OVERFLOW Defines the text overflow attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: display mode when the text is too long.{@ArkUI_TextOverflow}
Format of the return value ArkUI_AttributeItem:
.value[0].i32: display mode when the text is too long.{@ArkUI_TextOverflow}
NODE_FONT_FAMILY Defines the font family attribute, which can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.string: fonts, separated by commas (,).
Format of the return value ArkUI_AttributeItem:
.string: fonts, separated by commas (,).
NODE_TEXT_COPY_OPTION Defines the copy option attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: copy option ArkUI_CopyOptions. The default value is ARKUI_COPY_OPTIONS_NONE.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: copy option ArkUI_CopyOptions.
NODE_TEXT_BASELINE_OFFSET Defines the text baseline offset attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: baseline offset, in fp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: baseline offset, in fp.
NODE_TEXT_TEXT_SHADOW Defines the shadow attribute. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: blur radius of the shadow, in vp.
.value[1].i32: shadow type ArkUI_ShadowType. The default value is ARKUI_SHADOW_TYPE_COLOR.
.value[2].u32: shadow color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
.value[3].f32: offset of the shadow along the x-axis, in vp.
.value[4].f32: offset of the shadow along the y-axis, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: blur radius of the shadow, in vp.
.value[1].i32: shadow type ArkUI_ShadowType.
.value[2].u32: shadow color, in 0xARGB format.
.value[3].f32: offset of the shadow along the x-axis, in vp.
.value[4].f32: offset of the shadow along the y-axis, in vp.
NODE_TEXT_MIN_FONT_SIZE Defines the minimum font size attribute, which can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].f32: minimum font size, in fp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: minimum font size, in fp.
NODE_TEXT_MAX_FONT_SIZE Defines the maximum font size attribute, which can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].f32: maximum font size, in fp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: maximum font size, in fp.
NODE_TEXT_FONT Defines the text style attribute, which can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.string?: font family. Optional. Use commas (,) to separate multiple fonts.
.value[0].f32: font size, in fp.
.value[1]? .i32: font weight. Optional. The parameter type is ArkUI_FontWeight. The default value is ARKUI_FONT_WEIGHT_NORMAL.
.value[2]?.i32: font style. Optional. The parameter type is ArkUI_FontStyle. The default value is ARKUI_FONT_STYLE_NORMAL.
Format of the return value ArkUI_AttributeItem:
.string: font family. Use commas (,) to separate multiple fonts.
.value[0].f32: font size, in fp.
.value[1].i32: font weight. The parameter type is ArkUI_FontWeight. The default value is ARKUI_FONT_WEIGHT_NORMAL.
.value[2].i32: font style. The parameter type is ArkUI_FontStyle. The default value is ARKUI_FONT_STYLE_NORMAL.
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.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: how the adaptive height is determined for the text. The parameter type is ArkUI_TextHeightAdaptivePolicy.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: how the adaptive height is determined for the text. The parameter type is ArkUI_TextHeightAdaptivePolicy.
NODE_TEXT_INDENT Defines the indentation of the first line. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: indentation of the first line.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: indentation of the first line.
NODE_TEXT_WORD_BREAK Defines the line break rule. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: line break rule. The parameter type is ArkUI_WordBreak.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: line break rule. The parameter type is ArkUI_WordBreak.
NODE_TEXT_ELLIPSIS_MODE Defines the ellipsis position. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: ellipsis position. The parameter type is ArkUI_EllipsisMode.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: ellipsis position. The parameter type is ArkUI_EllipsisMode.
NODE_TEXT_LINE_SPACING Defines the line spacing attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: line spacing, in fp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: line spacing, in fp.
NODE_FONT_FEATURE Sets the font feature. NODE_FONT_FEATURE provides advanced typographic features in OpenType fonts.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: string that complies with the text feature format. The format is normal.
NODE_TEXT_ENABLE_DATA_DETECTOR Sets whether to enable text recognition.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to enable text recognition. The default value is false.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to enable text recognition.
NODE_TEXT_ENABLE_DATA_DETECTOR_CONFIG Configures text recognition settings.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0...].i32: entity type array. The parameter type is ArkUI_TextDataDetectorType.
Format of the return value ArkUI_AttributeItem:
.value[0...].i32: entity type array. The parameter type is ArkUI_TextDataDetectorType.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: color value, in 0xARGB format. For example, 0xFFFF0000 indicates red.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color value, in 0xARGB format.
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:
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.
2. Ensure that the OH_Drawing_TypographyLayout API is called before the layout measurement of the Text component.
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
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.object: string to use in the styled string. The parameter type is ArkUI_StyledString.
Format of the return value ArkUI_AttributeItem:
.object: string to use in the styled string. The parameter type is ArkUI_StyledString.
NODE_TEXT_HALF_LEADING Sets whether to center text vertically in the Text component.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to center text vertically. The default value is false.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to center text vertically.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: font weight ArkUI_FontWeight. The default value is ARKUI_FONT_WEIGHT_NORMAL.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: font weight ArkUI_FontWeight.
NODE_SPAN_CONTENT Defines the text content attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: content of the text span.
Format of the return value ArkUI_AttributeItem:
.string: content of the text span.
NODE_SPAN_TEXT_BACKGROUND_STYLE Defines the text background style. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: color of the text background, in 0xARGB format, for example, 0xFFFF0000 indicating red.
The second parameter is used to set the rounded corner of the text background. The options are as follows:
1: .value[1].f32: The radiuses of rounded corners in the four directions are set in a unified manner. The unit is vp.
2: .value[1].f32: radius of the upper left corner, in vp.
.value[2].f32: radius of the upper right corner, in vp.
.value[3].f32: radius of the lower left corner, in vp.
.value[4].f32: radius of the lower right corner, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color of the text background, in 0xARGB format.
.value[1].f32: radius of the upper left corner, in vp.
.value[2].f32: radius of the upper right corner, in vp.
.value[3].f32: radius of the lower left corner, in vp.
.value[4].f32: radius of the lower right corner, in vp.
NODE_SPAN_BASELINE_OFFSET Defines the text baseline offset attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: baseline offset, in fp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: baseline offset, in fp.
NODE_IMAGE_SPAN_SRC Defines the image source for an image span. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: image address of the image span.
.object: PixelMap object. The parameter type is ArkUI_DrawableDescriptor.
Format of the return value ArkUI_AttributeItem:
.string: image address of the image span.
.object: PixelMap object. The parameter type is ArkUI_DrawableDescriptor. Either .object or .string must be set.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32 indicates the text-based image alignment mode. The enumerated values of ArkUI_ImageSpanAlignment are used.
Format of the return value ArkUI_AttributeItem:
.value[0].i32 indicates the text-based image alignment mode. The enumerated values of ArkUI_ImageSpanAlignment are used.
NODE_IMAGE_SPAN_ALT Defines the image source for an image span. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: placeholder image address for the image span. GIF images are not supported.
.object: PixelMap object. The parameter type is ArkUI_DrawableDescriptor. Either .object or .string must be set.
Format of the return value ArkUI_AttributeItem:
.string: image source for the image span.
.object: PixelMap object. The parameter type is ArkUI_DrawableDescriptor.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: baseline offset, in fp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: baseline offset, in fp.
NODE_IMAGE_SRC Defines the image source of the Image component. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: image source.
.object: PixelMap object. The parameter type is ArkUI_DrawableDescriptor. Either .object or .string must be set.
Format of the return value ArkUI_AttributeItem:
.string: image source.
.object: PixelMap object. The parameter type is ArkUI_DrawableDescriptor.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32 indicates the image filling effect. The enumerated values of ArkUI_ObjectFit are used.
Format of the return value ArkUI_AttributeItem:
.value[0].i32 indicates the image filling effect. The enumerated values of ArkUI_ObjectFit are used.
NODE_IMAGE_INTERPOLATION Defines the interpolation effect of the image. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32 indicates the interpolation effect. The enumerated values of ArkUI_ImageInterpolation are used.
Format of the return value ArkUI_AttributeItem:
.value[0].i32 indicates the interpolation effect. The enumerated values of ArkUI_ImageInterpolation are used.
NODE_IMAGE_OBJECT_REPEAT Defines how the image is repeated. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32 indicates the image repetition style. The enumerated values of ArkUI_ImageRepeat are used.
Format of the return value ArkUI_AttributeItem:
.value[0].i32 indicates the image repetition style. The enumerated values of ArkUI_ImageRepeat are used.
NODE_IMAGE_COLOR_FILTER Defines the color filter of the image. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32 to .value[19].f32: filter matrix array.
.size: 5 x 4 filter array size.
.object: pointer to the color filter. The parameter type is OH_Drawing_ColorFilter. Either .object or .size can be set.
Format of the return value ArkUI_AttributeItem:
.value[0].f32 to .value[19].f32: filter matrix array.
.size: 5 x 4 filter array size.
.object: pointer to the color filter. The parameter type is OH_Drawing_ColorFilter.
NODE_IMAGE_AUTO_RESIZE Defines the auto resize attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32 : whether to resize the image source.
Format of the return value ArkUI_AttributeItem:
.value[0].i32 : whether to resize the image source.
NODE_IMAGE_ALT Defines the placeholder image source. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: image source for the image span.
.object: PixelMap object. The parameter type is ArkUI_DrawableDescriptor. Either .object or .string must be set.
Format of the return value ArkUI_AttributeItem:
.string: image source for the image span.
.object: PixelMap object. The parameter type is ArkUI_DrawableDescriptor.
NODE_IMAGE_DRAGGABLE Defines whether the image is draggable. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether the image is draggable. The value true means that the image is draggable.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether the image is draggable.
NODE_IMAGE_RENDER_MODE Defines the image rendering mode. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: The parameter type is ArkUI_ImageRenderMode.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: The parameter type is ArkUI_ImageRenderMode.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: The value 1 means to fit the component to the size of the image source, and 0 means the opposite.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: fill color. The value is in 0xARGB format. For example, 0xFFFF0000 indicates red.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: fill color. The value is in 0xARGB format.
NODE_IMAGE_RESIZABLE Sets the resizable image options.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: width of the left edge. The unit is vp.
.value[1].f32: width of the top edge. The unit is vp.
.value[2].f32: width of the right edge. The unit is vp.
.value[3].f32: width of the bottom edge. The unit is vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: width of the left edge. The unit is vp.
.value[1].f32: width of the top edge. The unit is vp.
.value[2].f32: width of the right edge. The unit is vp.
.value[3].f32: width of the bottom edge. The unit is vp.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: background color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: background color, in 0xARGB format.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: color of the circular slider, in 0xARGB format. For example, 0xFFFF0000 indicates red.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color of the circular slider, in 0xARGB format.
NODE_TOGGLE_VALUE Defines the toggle switch value. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to enable the toggle. The value true means to enable the toggle.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to enable the toggle.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: background color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: background color, in 0xARGB format.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: foreground color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: foreground color, in 0xARGB format.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to show the loading animation. The value true means to show the loading animation, and false means the opposite.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to show the loading animation. The value true means to show the loading animation, and false means the opposite.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: default placeholder text.
Format of the return value ArkUI_AttributeItem:
.string: default placeholder text.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: default text content.
Format of the return value ArkUI_AttributeItem:
.string: default text content.
NODE_TEXT_INPUT_CARET_COLOR Defines the border color attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: caret color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: caret color, in 0xARGB format.
NODE_TEXT_INPUT_CARET_STYLE Defines the caret style attribute. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: caret width, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: caret width, in vp.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to show an underline. The value true means to show an underline, and false means the opposite.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: The value 1 means to show an underline, and 0 means the opposite.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: maximum number of characters in the text input, without a unit.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: maximum number of characters in the text input.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: Enter key type enumeration ArkUI_EnterKeyType. The default value is ARKUI_ENTER_KEY_TYPE_DONE.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: type of the Enter key. The value is an enum of ArkUI_EnterKeyType.
NODE_TEXT_INPUT_PLACEHOLDER_COLOR Defines the placeholder text color. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: color value, in 0xARGB format. For example, 0xFFFF0000 indicates red.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color value, in 0xARGB format.
NODE_TEXT_INPUT_PLACEHOLDER_FONT Defines the placeholder text font. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0]?.f32: font size, in fp. Optional. The default value is 16.0.
.value[1]?.i32: font style ArkUI_FontStyle. Optional. The default value is ARKUI_FONT_STYLE_NORMAL.
.value[2]?.i32: font weight ArkUI_FontWeight. Optional. The default value is ARKUI_FONT_WEIGHT_NORMAL.
?.string: font family. Multiple font families are separated by commas (,). For example, "font weight; font family 1, font family 2".
Format of the return value ArkUI_AttributeItem:
.value[0].f32: font size, in fp.
.value[1].i32: font style ArkUI_FontStyle.
.value[2].i32: font weight ArkUI_FontWeight.
.string: font family. Multiple font families are separated by commas (,).
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
NODE_TEXT_INPUT_TYPE Defines the text box type. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: input box type enumeration ArkUI_TextInputType. The default value is ARKUI_TEXTINPUT_TYPE_NORMAL.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: input box type enumeration ArkUI_TextInputType.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: color value, in 0xARGB format. For example, 0xFFFF0000 indicates red.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color value, in 0xARGB format.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
NODE_TEXT_INPUT_EDITING Defines the editable state for the single-line text box. This attribute can be set as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
The format of the attribute obtaining method parameter ArkUI_AttributeItem is as follows:
.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.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: button style ArkUI_CancelButtonStyle. The default value is ARKUI_CANCELBUTTON_STYLE_INPUT.
.value[1]?.f32: button icon size, in vp.
.value[2]?.u32: button icon color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
?.string: button icon image source. The value is the local address of the image, for example, /pages/icon.png.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: button style ArkUI_CancelButtonStyle.
.value[1].f32: icon size, in vp.
.value[2].u32: button icon color, in 0xARGB format.
.string: button icon image source.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: start position of the text selection.
.value[1].i32: end position of the text selection.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: start position of the text selection.
.value[1].i32: end position of the text selection.
NODE_TEXT_INPUT_UNDERLINE_COLOR Sets the color of the underline when it is shown.
The default underline color configured for the theme is '0x33182431'.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: color of the underline applied to the text being typed in. The value is in 0xARGB format.
.value[1].u32: color of the underline applied to the text in the normal state. The value is in 0xARGB format.
.value[2].u32: color of the underline applied to the text when an error is detected. The value is in 0xARGB format.
.value[3].u32: color of the underline applied to the text when it is disabled. The value is in 0xARGB format.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color of the underline applied to the text being typed in. The value is in 0xARGB format.
.value[1].u32: color of the underline applied to the text in the normal state. The value is in 0xARGB format.
.value[2].u32: color of the underline applied to the text when an error is detected. The value is in 0xARGB format.
.value[3].u32: color of the underline applied to the text when it is disabled. The value is in 0xARGB format.
NODE_TEXT_INPUT_ENABLE_AUTO_FILL Sets whether to enable autofill.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to enable autofill. The default value is true.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to enable autofill.
NODE_TEXT_INPUT_CONTENT_TYPE Sets the autofill type.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: autofill type. The parameter type is ArkUI_TextInputContentType.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: autofill type. The parameter type is ArkUI_TextInputContentType.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: rules for generating passwords.
Format of the return value ArkUI_AttributeItem:
.string: rules for generating passwords.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to select all text in the initial state. The default value is b>false.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to select all text in the initial state.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: regular expression.
Format of the return value ArkUI_AttributeItem:
.string: regular expression.
NODE_TEXT_INPUT_STYLE Sets the text box to the default style or inline input style.
For the inline input style, only InputType.Normal is supported.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: text input style. The parameter type is ArkUI_TextInputStyle.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: text input style. The parameter type is ArkUI_TextInputStyle.
NODE_TEXT_INPUT_CARET_OFFSET Sets or obtains the caret position.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
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.
Format of the return value ArkUI_AttributeItem:
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.
value[1].f32: X coordinate of the cursor relative to the text box.
value[2].f32: Y coordinate of the cursor relative to the text box.
NODE_TEXT_INPUT_CONTENT_RECT Position of the edited text area relative to the component and its size.
Format of the return value ArkUI_AttributeItem:
value[0].f32: horizontal coordinate.
value[1].f32: vertical coordinate.
value[2].f32: content width.
value[3].f32: content height.
NODE_TEXT_INPUT_CONTENT_LINE_COUNT Obtains the number of lines of the edited text.
Format of the return value ArkUI_AttributeItem:
value[0].i32: number of lines in the edited text.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to hide the text selection menu when the text box is long-pressed, double-click, or right-clicked.
NODE_TEXT_INPUT_BLUR_ON_SUBMIT Sets whether the text box loses focus after the Enter key is pressed to submit information.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether the text box loses focus.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether the text box loses focus.
NODE_TEXT_INPUT_CUSTOM_KEYBOARD Sets a custom keyboard.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.object: custom keyboard. The parameter type is ArkUI_NodeHandle.
.value[0]?.i32: whether the custom keyboard supports avoidance. The default value is false.
Format of the return value ArkUI_AttributeItem:
.object: custom keyboard. The parameter type is ArkUI_NodeHandle.
.value[0].i32: whether the custom keyboard supports avoidance.
NODE_TEXT_INPUT_WORD_BREAK Defines the line break rule. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: line break rule. The parameter type is ArkUI_WordBreak.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: line break rule. The parameter type is ArkUI_WordBreak.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: number of lines.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: number of lines.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to show the keyboard when the text box obtains focus.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to show the keyboard when the text box obtains focus.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: default placeholder text.
Format of the return value ArkUI_AttributeItem:
.string: default placeholder text.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: default text content.
Format of the return value ArkUI_AttributeItem:
.string: default text content.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: maximum number of characters in the text input.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: maximum number of characters in the text input.
NODE_TEXT_AREA_PLACEHOLDER_COLOR Defines the placeholder text color. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: color value, in 0xARGB format. For example, 0xFFFF0000 indicates red.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color value, in 0xARGB format.
NODE_TEXT_AREA_PLACEHOLDER_FONT Defines the placeholder text font. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0]?.f32: font size, in fp. Optional. The default value is 16.0.
.value[1]?.i32: font style ArkUI_FontStyle. Optional. The default value is ARKUI_FONT_STYLE_NORMAL.
.value[2]?.i32: font weight ArkUI_FontWeight. Optional. The default value is ARKUI_FONT_WEIGHT_NORMAL.
?.string: font family. Multiple font families are separated by commas (,). For example, "font weight; font family 1, font family 2".
Format of the return value ArkUI_AttributeItem:
.value[0].f32: font size, in fp.
.value[1].i32: font style ArkUI_FontStyle.
.value[2].i32: font weight ArkUI_FontWeight.
.string: font family. Multiple font families are separated by commas (,).
NODE_TEXT_AREA_CARET_COLOR Defines the border color attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: background color, in 0xARGB format. For example, 0xFFFF0000 indicates red.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: background color, in 0xARGB format.
NODE_TEXT_AREA_EDITING Defines the editable state for the multi-line text box. This attribute can be set as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
The format of the attribute obtaining method parameter ArkUI_AttributeItem is as follows:
.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.
NODE_TEXT_AREA_TYPE Defines the text box type. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: input box type enumeration ArkUI_TextAreaType. The default value is ARKUI_TEXTAREA_TYPE_NORMAL.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: input box type enumeration ArkUI_TextAreaType.
NODE_TEXT_AREA_SHOW_COUNTER Defines the counter settings. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to show a character counter. The value true means to show a character counter.
.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.
.value[2]?.i32: whether to highlight the border when the number of entered characters reaches the maximum.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to show a character counter.
.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.
.value[2].i32: whether to highlight the border when the number of entered characters reaches the maximum. The default value is true.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to hide the text selection menu when the text box is long-pressed, double-click, or right-clicked.
NODE_TEXT_AREA_BLUR_ON_SUBMIT Sets whether the multi-line text box loses focus after the Enter key is pressed to submit information.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether the text box loses focus.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether the text box loses focus.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: regular expression.
Format of the return value ArkUI_AttributeItem:
.string: regular expression.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: color value, in 0xARGB format. For example, 0xFFFF0000 indicates red.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color value, in 0xARGB format.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: Enter key type enumeration ArkUI_EnterKeyType. The default value is ARKUI_ENTER_KEY_TYPE_DONE.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: type of the Enter key. The value is an enum of ArkUI_EnterKeyType.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
NODE_TEXT_AREA_CARET_OFFSET Sets or obtains the caret position.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
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.
Format of the return value ArkUI_AttributeItem:
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.
value[1].f32: X coordinate of the cursor relative to the text box.
value[2].f32: Y coordinate of the cursor relative to the text box.
NODE_TEXT_AREA_CONTENT_RECT Position of the edited text area relative to the component and its size.
Format of the return value ArkUI_AttributeItem:
value[0].f32: horizontal coordinate.
value[1].f32: vertical coordinate.
value[2].f32: content width.
value[3].f32: content height.
NODE_TEXT_AREA_CONTENT_LINE_COUNT Obtains the number of lines of the edited text.
Format of the return value ArkUI_AttributeItem:
value[0].i32: number of lines in the edited text.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: start position of the text selection.
.value[1].i32: end position of the text selection.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: start position of the text selection.
.value[1].i32: end position of the text selection.
NODE_TEXT_AREA_ENABLE_AUTO_FILL Sets whether to enable autofill.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to enable autofill. The default value is true.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to enable autofill.
NODE_TEXT_AREA_CONTENT_TYPE Enumerates the content types for autofill.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: autofill type. The parameter type is ArkUI_TextInputContentType.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: autofill type. The parameter type is ArkUI_TextInputContentType.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: number of lines.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: number of lines.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to show the keyboard when the text box obtains focus.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to show the keyboard when the text box obtains focus.
NODE_BUTTON_LABEL Defines the button text content. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: default text content.
Format of the return value ArkUI_AttributeItem:
.string: default text content.
NODE_BUTTON_TYPE Sets the button type. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: button style. The parameter type is ArkUI_ButtonType. The default value is ARKUI_BUTTON_TYPE_CAPSULE.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: Obtains the style of the button. The parameter type is ArkUI_ButtonType. The default value is ARKUI_BUTTON_TYPE_CAPSULE.
NODE_PROGRESS_VALUE Defines the current value of the progress indicator. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: current value of the progress indicator.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: current value of the progress indicator.
NODE_PROGRESS_TOTAL Defines the total value of the progress indicator. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: total value of the progress indicator.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: total value of the progress indicator.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: color value, in 0xARGB format. For example, 0xFFFF0000 indicates red.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color value, in 0xARGB format.
NODE_PROGRESS_TYPE Defines the type of the progress indicator. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: progress bar type. The enumerated value is ArkUI_ProgressType. The default value is ARKUI_PROGRESS_TYPE_LINEAR.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: progress bar type enumeration value ArkUI_ProgressType.
NODE_CHECKBOX_SELECT Defines whether the check box is selected. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: whether the check box is selected. The value 1 means that the check box is selected, and 0 means the opposite.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether the check box is selected. The value 1 means that the check box is selected, and 0 means the opposite.
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.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].u32: color of the check box when it is selected, in 0xARGB format, for example, 0xFF1122FF.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color of the check box when it is selected, in 0xARGB format, for example, 0xFF1122FF.
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.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].u32: border color, in 0xARGB format, for example, 0xFF1122FF.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: border color, in 0xARGB format, for example, 0xFF1122FF.
NODE_CHECKBOX_MARK Defines the internal icon style of the check box. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].u32: border color, in 0xARGB format, for example, 0xFF1122FF.
.value[1]?.f32: size of the internal mark, in vp. Optional.
.value[2]?.f32: stroke width of the internal mark, in vp. Optional. The default value is 2.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: border color, in 0xARGB format, for example, 0xFF1122FF.
.value[1].f32: size of the internal mark, in vp.
.value[2].f32: stroke width of the internal mark, in vp. The default value is 2.
NODE_CHECKBOX_SHAPE Defines the shape of the check box. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: component shape. The parameter type is ArkUI_CheckboxShape.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: component shape. The parameter type is ArkUI_CheckboxShape.
NODE_XCOMPONENT_ID Defines the ID of the XComponent component. This attribute can be set and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: component ID.
Format of the return value ArkUI_AttributeItem:
.string: component ID.
NODE_XCOMPONENT_TYPE Defines the type of the XComponent component. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: type. The parameter type is ArkUI_XComponentType. The default value is ARKUI_XCOMPONENT_TYPE_SURFACE.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: type. The parameter type is ArkUI_XComponentType.
NODE_XCOMPONENT_SURFACE_SIZE Defines the width and height of the XComponent component. This attribute can be set and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: width, in px.
.value[1].u32: height, in px.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: width, in px.
.value[1].u32: height, in px.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to display the lunar calendar in the date picker. The default value is false.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to display the lunar calendar in the date picker.
NODE_DATE_PICKER_START Defines the start date of the date picker. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: date. The default value is "1970-1-1".
Format of the return value ArkUI_AttributeItem:
.string: date.
NODE_DATE_PICKER_END Defines the end date of the date picker. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: date. The default value is "2100-12-31".
Format of the return value ArkUI_AttributeItem:
.string: date.
NODE_DATE_PICKER_SELECTED Defines the selected date of the date picker. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: date. The default value is "2024-01-22".
Format of the return value ArkUI_AttributeItem:
.string: date.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
Format of the return value ArkUI_AttributeItem:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
Format of the return value ArkUI_AttributeItem:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
Format of the return value ArkUI_AttributeItem:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: time. The default value is the current system time.
Format of the return value ArkUI_AttributeItem:
.string: time.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether the display time is in 24-hour format. The default value is false.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether the display time is in 24-hour format.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
Format of the return value ArkUI_AttributeItem:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
Format of the return value ArkUI_AttributeItem:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
Format of the return value ArkUI_AttributeItem:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: type of the used selector ArkUI_TextPickerRangeType. The default value is ARKUI_TEXTPICKER_RANGETYPE_SINGLE.
?.string: string input, whose format varies by picker type.
1: single-column picker. The input format is a group of strings separated by semicolons (😉.
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 (,).
?.object: Object input, whose format varies by picker type.
1: A single column supports the image selector. The input structure is ARKUI_TextPickerRangeContent.
2: multi-column linkage selector. The input structure is ARKUI_TextPickerCascadeRangeContent.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: type of the text picker ArkUI_TextPickerRangeType.
?.string: string output, whose format varies by picker type.
1: single-column picker. The output format is a group of strings separated by semicolons (😉.
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 (,).
?.string: Object output, whose format varies by picker type.
1: A single column supports the image selector. The output structure is ARKUI_TextPickerRangeContent.
2: multi-column linkage selector. The output structure is ARKUI_TextPickerCascadeRangeContent.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: index. If there are multiple index values, add them one by one.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: index. If there are multiple index values, add them one by one.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: value of the selected item. If there are multiple values, add them one by one and separate them with semicolons (😉.
Format of the return value ArkUI_AttributeItem:
.string: value of the selected item. If there are multiple values, add them one by one and separate them with semicolons (😉.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
Format of the return value ArkUI_AttributeItem:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
Format of the return value ArkUI_AttributeItem:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: font color, in ::argb format.
Parameter 2: font size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.string: array of five parameters of the string type, separated by semicolons (😉.
Input parameter 1: text color. The value is of the argb type.
Input parameter 2: text size, in fp. The value is a number.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: fonts, separated by commas (,).
Parameter 5: font style. Available options are ("normal", "italic").
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
Format of the return value ArkUI_AttributeItem:
.string: array of five parameters of the string type, separated by semicolons (😉.
Parameter 1: text color. The value is of the argb type.
Parameter 2: text size. The value is a number, and the unit is fp.
Parameter 3: font weight. Available options are ("bold", "normal", "bolder", "lighter", "medium", "regular").
Parameter 4: text font list, which is separated by commas (,).
Parameter 5: text style, string enumeration ("normal", "italic")
Example: "#ff182431;14;normal;Arial,HarmonyOS Sans;normal".
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.
ArkUI_AttributeItem parameter type. The options are as follows:
.value[0...].i32: index of the default item in the data selection range.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to support scroll looping. The value true means to support scroll looping, and false means the opposite.
Format of the return value ArkUI_AttributeItem:
value[0].i32: The value 1 means to support scroll looping, and 0 means the opposite.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
value[0].f32: item height, in vp.
Format of the return value ArkUI_AttributeItem:
value[0].f32: item height, in vp.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: year of the selected date.
.value[1].u32: month of the selected date.
.value[2].u32: day of the selected date.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: year of the selected date.
.value[1].u32: month of the selected date.
.value[2].u32: day of the selected date.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: alignment mode type. The parameter type is ArkUI_CalendarAlignment.
.value[1].f32: offset of the picker relative to the entry component along the x-axis after alignment based on the specified alignment mode.
.value[2].f32: offset of the picker relative to the entry component along the y-axis after alignment based on the specified alignment mode.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: alignment mode type. The parameter type is ArkUI_CalendarAlignment.
.value[1].f32: offset of the picker relative to the entry component along the x-axis after alignment based on the specified alignment mode.
.value[2].f32: offset of the picker relative to the entry component along the y-axis after alignment based on the specified alignment mode.
NODE_CALENDAR_PICKER_TEXT_STYLE Defines the font color, font size, and font weight in the entry area of the calendar picker.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0]?.u32: font color of the entry area.
.value[1]?.f32: font size of the entry area, in fp.
.value[2]?.i32: font weight of the text in the entry area. The parameter type is ArkUI_FontWeight.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: font color of the entry area.
.value[1].f32: font size of the entry area, in fp.
.value[2].i32: font weight of the text in the entry area. The parameter type is ArkUI_FontWeight.
NODE_SLIDER_BLOCK_COLOR Defines the color of the slider. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].u32: color of the slider, in 0xARGB format, for example, 0xFF1122FF.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color of the slider, in 0xARGB format, for example, 0xFF1122FF.
NODE_SLIDER_TRACK_COLOR Defines the background color of the slider. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].u32: background color, in 0xARGB format, for example, 0xFF1122FF.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: background color, in 0xARGB format, for example, 0xFF1122FF.
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.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].u32: color of the selected part of the slider track, in 0xARGB format, for example, 0xFF1122FF.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color of the selected part of the slider track, in 0xARGB format, for example, 0xFF1122FF.
NODE_SLIDER_SHOW_STEPS Sets whether to display the step scale value. Attributes can be set, reset, and obtained.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
NODE_SLIDER_BLOCK_STYLE Defines the slider shape, which can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: shape. The parameter type is ArkUI_SliderBlockStyle.
.string? depending on the shape. Optional.
ARKUI_SLIDER_BLOCK_STYLE_IMAGE: image resource of the slider. Example: /pages/common/icon.png.
ARKUI_SLIDER_BLOCK_STYLE_SHAPE: custom shape of the slider.
There are five types:
1. Rectangle:
.value[1].i32: cropping type. The parameter type is ArkUI_ShapeType, ARKUI_SHAPE_TYPE_RECTANGLE.
.value[2].f32: height of the rectangle.
.value[3].f32: height of the rectangle.
.value[4].f32: height of the rounded corner of the rectangle.
.value[5].f32: height of the rounded corner of the rectangle.
2. Circle:
.value[1].i32: cropping type. The parameter type is ArkUI_ShapeType, ARKUI_SHAPE_TYPE_CIRCLE.
.value[2].f32: height of the circle.
.value[3].f32: height of the circle.
3. Ellipse:
.value[1].i32: cropping type. The parameter type is ArkUI_ShapeType, ARKUI_SHAPE_TYPE_ELLIPSE.
.value[2].f32: height of the ellipse.
.value[3].f32: height of the ellipse.
4. Path:
.value[1].i32: cropping type. The parameter type is ArkUI_ShapeType, ARKUI_SHAPE_TYPE_PATH.
.value[2].f32: width of the path.
.value[3].f32: height of the path.
.string: command for drawing the path.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: shape. The parameter type is ArkUI_SliderBlockStyle.
.string? depending on the shape. Optional.
ARKUI_SLIDER_BLOCK_STYLE_IMAGE: image resource of the slider. Example: /pages/common/icon.png.
ARKUI_SLIDER_BLOCK_STYLE_SHAPE: custom shape of the slider.
There are five types:
1. Rectangle:
.value[1].i32: cropping type. The parameter type is ArkUI_ShapeType, ARKUI_SHAPE_TYPE_RECTANGLE.
.value[2].f32: height of the rectangle.
.value[3].f32: height of the rectangle.
.value[4].f32: height of the rounded corner of the rectangle.
.value[5].f32: height of the rounded corner of the rectangle.
2. Circle:
.value[1].i32: cropping type. The parameter type is ArkUI_ShapeType, ARKUI_SHAPE_TYPE_CIRCLE.
.value[2].f32: height of the circle.
.value[3].f32: height of the circle.
3. Ellipse:
.value[1].i32: cropping type. The parameter type is ArkUI_ShapeType, ARKUI_SHAPE_TYPE_ELLIPSE.
.value[2].f32: height of the ellipse.
.value[3].f32: height of the ellipse.
4. Path:
.value[1].i32: cropping type. The parameter type is ArkUI_ShapeType, ARKUI_SHAPE_TYPE_PATH.
.value[2].f32: width of the path.
.value[3].f32: height of the path.
.string: command for drawing the path.
NODE_SLIDER_VALUE Defines the current value of the slider. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].f32: current value.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: current value.
NODE_SLIDER_MIN_VALUE Defines the minimum value of the slider. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].f32: minimum value.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: minimum value.
NODE_SLIDER_MAX_VALUE Defines the maximum value of the slider. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].f32: maximum value.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: maximum value.
NODE_SLIDER_STEP Defines the step of the slider. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].f32: step. The value range is [0.01, 100].
Format of the return value ArkUI_AttributeItem:
.value[0].f32: step. The value range is [0.01, 100].
NODE_SLIDER_DIRECTION Defines whether the slider moves horizontally or vertically. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: display style. The parameter type is ArkUI_SliderDirection.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: display style. The parameter type is ArkUI_SliderDirection.
NODE_SLIDER_REVERSE Defines whether the slider values are reversed. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: whether the slider values are reversed. The value 1 means that the slider values are reversed, and 0 means the opposite.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether the slider values are reversed. The value 1 means that the slider values are reversed, and 0 means the opposite.
NODE_SLIDER_STYLE Defines the style of the slider thumb and track. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: display style. The parameter type is ArkUI_SliderStyle.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: display style. The parameter type is ArkUI_SliderStyle.
NODE_SLIDER_TRACK_THICKNESS Sets the track thickness of the slider. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.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.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: track thickness of the slider, in vp.
NODE_RADIO_CHECKED Sets whether the radio button is selected. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: whether the radio button is selected. The default value is false. Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether the radio button is selected.
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.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0]?.u32: color of the background when the radio button is selected, in 0xARGB format. The default value is 0xFF007DFF.
.value[1]?.u32: color of the border when the radio button is deselected, in 0xARGB format. The default value is 0xFF182431.
.value[2]?.u32: color of the indicator when the radio button is selected, in 0xARGB format. The default value is 0xFFFFFFFF.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color of the background when the radio button is selected, in 0xARGB format. The default value is 0xFF007DFF.
.value[1].u32: color of the border when the radio button is deselected, in 0xARGB format. The default value is 0xFF182431.
.value[2].u32: color of the indicator when the radio button is selected, in 0xARGB format. The default value is 0xFFFFFFF.
NODE_RADIO_VALUE Sets the current value of the radio button. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.string: value of the option button.
Format of the return value ArkUI_AttributeItem:
.string: value of the option button.
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.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.string: name of the group to which the radio button belongs.
Format of the return value ArkUI_AttributeItem:
.string: name of the group to which the radio button belongs.
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.
If this attribute and the universal attribute NODE_ALIGNMENT are both set, whichever is set later takes effect.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: alignment mode. The parameter type is ArkUI_Alignment. The default value is ARKUI_ALIGNMENT_CENTER.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: alignment mode. The parameter type is ArkUI_Alignment.
NODE_SCROLL_BAR_DISPLAY_MODE Defines the scrollbar status. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: scroll bar status. The data type is ArkUI_ScrollBarDisplayMode, and the default value is ARKUI_SCROLL_BAR_DISPLAY_MODE_AUTO.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: scroll bar status. The data type is ArkUI_ScrollBarDisplayMode.
NODE_SCROLL_BAR_WIDTH Defines the width of the scrollbar. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: width of the scrollbar, in vp. The default value is 4.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: width of the scrollbar, in vp.
NODE_SCROLL_BAR_COLOR Defines the color of the scrollbar. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.data[0].u32: color of the scrollbar, in 0xARGB format.
Format of the return value ArkUI_AttributeItem:
.data[0].u32: color of the scrollbar, in 0xARGB format.
NODE_SCROLL_SCROLL_DIRECTION Defines the scroll direction. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: scrolling direction. The data type is ArkUI_ScrollDirection, and the default value is ARKUI_SCROLL_DIRECTION_VERTICAL.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: scrolling direction. The data type is ArkUI_ScrollDirection.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: edge sliding effect. The parameter type is ArkUI_EdgeEffect. The default value is ARKUI_EDGE_EFFECT_NONE.
.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.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: edge sliding effect. The parameter type is ArkUI_EdgeEffect.
.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.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: edge sliding effect. The parameter type is ArkUI_EdgeEffect. The default value is ARKUI_EDGE_EFFECT_NONE.
.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.
.value[2]?.i32: direction in which the effect takes effect. The parameter type is ArkUI_EffectEdge. The default value is ARKUI_EFFECT_EDGE_START | ARKUI_EFFECT_EDGE_END.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: edge sliding effect. The parameter type is ArkUI_EdgeEffect.
.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.
.value[2].i32: direction in which the effect takes effect. The parameter type is ArkUI_EffectEdge.
Since
17
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to support scroll gestures. The default value is true.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to support scroll gestures.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: friction coefficient. The default value is 0.6 for non-wearable devices and 0.9 for wearable devices.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: friction coefficient.
NODE_SCROLL_SNAP Defines the scroll snapping mode. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: limit scrolling mode of the scroll component. The data type is ArkUI_ScrollSnapAlign, and the default value is ARKUI_SCROLL_SNAP_ALIGN_NONE.
.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.
.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.
.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.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: alignment mode for the scroll snap position. The parameter type is ArkUI_ScrollSnapAlign.
.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.
.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.
.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.
NODE_SCROLL_NESTED_SCROLL Defines the nested scrolling options. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: nested scrolling when the scrollable component scrolls to the end. The parameter type is ArkUI_ScrollNestedMode.
.value[1].i32: nested scrolling when the scrollable component scrolls to the start end. The parameter type is ArkUI_ScrollNestedMode.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: nested scrolling when the scrollable component scrolls to the end. The parameter type is ArkUI_ScrollNestedMode.
.value[1].i32: nested scrolling when the scrollable component scrolls to the start end. The parameter type is ArkUI_ScrollNestedMode.
NODE_SCROLL_OFFSET Defines the specified position to scroll to. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].f32: horizontal scrolling offset, in vp.
.value[1].f32: vertical scrolling offset, in vp.
.value[2]?.i32: scrolling duration, in milliseconds. Optional.
.value[3]?.i32: (optional) scrolling curve. The parameter type is ArkUI_AnimationCurve. The default value is ARKUI_CURVE_EASE.
.value[4]?.i32: whether to enable the default spring animation. Optional. The default value 0 means not to enable the default spring animation.
.value[5]?.i32: whether to enable overscroll. Optional.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: horizontal scrolling offset, in vp.
.value[1].f32: vertical scrolling offset, in vp.
NODE_SCROLL_EDGE Defines the edge position to scroll to. This attribute can be set and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: container edge. The parameter type is ArkUI_ScrollEdge.
Format of the return value ArkUI_AttributeItem:
.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.
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.
If both enablePaging and scrollSnap are set, scrollSnap takes effect, but enablePaging does not.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to enable the swipe-to-turn-pages feature. The default value is false.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to enable the swipe-to-turn-pages feature.
NODE_SCROLL_PAGE Scrolls to the next or previous page.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
.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.
NODE_SCROLL_BY Scrolls by the specified amount.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: amount to scroll by in the horizontal direction, in vp by default.
.value[1].f32: amount to scroll by in the vertical direction, in vp by default.
NODE_SCROLL_FLING Performs inertial scrolling based on the initial velocity passed in.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
NODE_SCROLL_FADING_EDGE Sets the edge fade effect for the scrollable component.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to enable the edge fade effect. The value 0 means to disable edge fade effect, and 1 means the opposite.
.value[1]?.f32: length of the edge fade effect, in vp. The default value is 32.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to enable the edge fade effect. The value 0 means to disable edge fade effect, and 1 means the opposite.
.value[1].f32: length of the edge fade effect, in vp.
Since
14
NODE_SCROLL_SIZE Obtains the total size of all child components when fully expanded in the scrollable component.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: total width of all child components when fully expanded in the scrollable component. The default unit is vp.
.value[1].f32: total height of all child components when fully expanded in the scrollable component. The default unit is vp.
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.
Since
14
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: direction in which the list items are arranged. The parameter type is ArkUI_Axis. The default value is ARKUI_AXIS_VERTICAL.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: direction in which the list items are arranged. The parameter type is ArkUI_Axis.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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. The default value is ARKUI_STICKY_STYLE_NONE.
Format of the return value ArkUI_AttributeItem:
.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.
NODE_LIST_SPACE Defines the spacing between list items. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: spacing between list items along the main axis. The default value is 0.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: spacing between list items along the main axis.
NODE_LIST_NODE_ADAPTER Defines the list adapter. The attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.object: ArkUI_NodeAdapter object as the adapter.
Format of the return value ArkUI_AttributeItem:
.object: ArkUI_NodeAdapter object.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: number of cached items in the list adapter.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: number of cached items in the list adapter.
NODE_LIST_SCROLL_TO_INDEX Slide to the specified index.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: index of the item to be scrolled to in the container.
.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.
.value[2]?.i32: how the item to scroll to is aligned with the container. The parameter type is ArkUI_ScrollAlignment. The default value is ARKUI_SCROLL_ALIGNMENT_START.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: alignment mode of list items along the cross axis. The parameter type is ArkUI_ListItemAlign.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: alignment mode of list items along the cross axis. The parameter type is ArkUI_ListItemAlign.
NODE_LIST_CHILDREN_MAIN_SIZE Sets the default main axis size of the child components in this list.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
object: ArkUI_ListChildrenMainSize object.
Format of the return value ArkUI_AttributeItem:
.object: The parameter format is ArkUI_ListChildrenMainSize.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: color of the divider, in 0xARGB format.
.value[1].f32: stroke width of the divider.
.value[2].f32: distance between the divider and the start of the list, in vp.
.value[3].f32: distance between the divider and the end of the list, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color of the divider, in 0xARGB format.
.value[1].f32: stroke width of the divider.
.value[2].f32: distance between the divider and the start of the list, in vp.
.value[3].f32: distance between the divider and the end of the list, in vp.
NODE_SWIPER_LOOP Defines whether to enable loop playback for the swiper. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
NODE_SWIPER_SHOW_INDICATOR Defines whether to enable the navigation point indicator for the swiper. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether to enable the navigation point indicator. The value 1 means to enable the navigation point indicator, and 0 means the opposite. The default value is 1.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to enable the navigation point indicator. The value 1 means to enable the navigation point indicator, and 0 means the opposite. The default value is 1.
NODE_SWIPER_INTERVAL Defines the interval for automatic playback. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: interval for automatic playback, in milliseconds.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: interval for automatic playback, in milliseconds.
NODE_SWIPER_VERTICAL Defines whether vertical swiping is used for the swiper. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: duration of the animation for switching child components, in milliseconds. The default value is 400.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: duration of the animation for switching child components, in milliseconds. The default value is 400.
NODE_SWIPER_CURVE Defines the animation curve for the swiper. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: Sets the animation curve parameter. The parameter type is ArkUI_AnimationCurve. The default value is ARKUI_CURVE_LINEAR.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: Sets the animation curve parameter. The parameter type is ArkUI_AnimationCurve. The default value is ARKUI_CURVE_LINEAR.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: spacing between child components.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: spacing between child components.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: number of elements to display per page.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: number of elements to display per page.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: number of elements to display per page.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: number of elements to display per page.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
NODE_SWIPER_SHOW_DISPLAY_ARROW Defines whether to show the arrow when the mouse pointer hovers over the navigation point indicator. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: indicates whether to display the navigation arrow. The parameter type is ArkUI_SwiperArrow.
The default value is ARKUI_SWIPER_ARROW_HIDE.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: indicates whether to display the navigation arrow. The parameter type is ArkUI_SwiperArrow.
The default value is ARKUI_SWIPER_ARROW_HIDE.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
The default value is ARKUI_EDGE_EFFECT_SPRING.
Format of the return value ArkUI_AttributeItem:
.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.
NODE_SWIPER_NODE_ADAPTER Defines the swiper adapter. The attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.object: ArkUI_NodeAdapter object as the adapter.
Format of the return value ArkUI_AttributeItem:
.object: The format of the return value is ArkUI_NodeAdapter.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: number of cached items in the swiper adapter.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: number of cached items in the list adapter.
NODE_SWIPER_PREV_MARGIN Sets the previous margin of the swiper. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: previous margin, in vp. The default value is 0.
.value[1].i32: whether to ignore blank areas. The value 1 means to ignore blank areas, and 0 means the opposite.
Format of the return value ArkUI_AttributeItem:
.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.
NODE_SWIPER_NEXT_MARGIN Sets the next margin of the swiper. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: next margin, in vp. The default value is 0.
.value[1].i32: whether to ignore blank areas. The value 1 means to ignore blank areas, and 0 means the opposite.
Format of the return value ArkUI_AttributeItem:
.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.
NODE_SWIPER_INDICATOR Sets the navigation indicator type of the Swiper component. The attribute setting, attribute resetting, and attribute obtaining interfaces are supported.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: navigation indicator type. The parameter type is ArkUI_SwiperIndicatorType.
.object: The parameter type is ArkUI_SwiperIndicator.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: navigation indicator type. The parameter type is ArkUI_SwiperIndicatorType.
.object: The parameter type is ArkUI_SwiperIndicator.
NODE_SWIPER_NESTED_SCROLL Sets the nested scrolling mode of the Swiper component and its parent container.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: nested scrolling mode of the Swiper component and parent component. The parameter type is ArkUI_SwiperNestedScrollMode.
The default value is ARKUI_SWIPER_NESTED_SCROLL_SELF_ONLY.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: nested scrolling mode of the Swiper component and parent component. The parameter type is ArkUI_SwiperNestedScrollMode.
NODE_SWIPER_SWIPE_TO_INDEX Sets the swiper to switch to the specified page.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: index of the target page in the swiper.
.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.
NODE_SWIPER_INDICATOR_INTERACTIVE Sets whether the navigation point indicator is interactive.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: whether the navigation point indicator is interactive. The default value true means that the navigation point indicator is interactive.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether the navigation point indicator is interactive.
NODE_SWIPER_PAGE_FLIP_MODE Sets the page flipping mode using the mouse wheel.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: page flipping mode using the mouse wheel. The parameter type is ArkUI_PageFlipMode.
Format of the return value ArkUI_PageFlipMode):
.value[0].i32: page flipping mode using the mouse wheel.
Since
14
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.object: ArkUI_ListItemSwipeActionOption object.
Format of the return value ArkUI_AttributeItem:
.object: ArkUI_ListItemSwipeActionOption object.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.object: Use the ArkUI_NodeHandle object as the ListItemGroup header component.
Format of the return value ArkUI_AttributeItem:
.object: Use the ArkUI_NodeHandle object as the ListItemGroup header component.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.object: ArkUI_NodeHandle object to be used as the footer of the list item group.
Format of the return value ArkUI_AttributeItem:
.object: ArkUI_NodeHandle object to be used as the footer of the list item group.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].u32: color of the divider, in 0xARGB format.
.value[1].f32: stroke width of the divider, in vp.
.value[2].f32: distance between the divider and the start of the list, in vp.
.value[3].f32: distance between the divider and the end of the list, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].u32: color of the divider, in 0xARGB format.
.value[1].f32: stroke width of the divider, in vp.
.value[2].f32: distance between the divider and the start of the list, in vp.
.value[3].f32: distance between the divider and the end of the list, in vp.
NODE_LIST_ITEM_GROUP_CHILDREN_MAIN_SIZE Sets the default spindle size of the ListItemGroup child component.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
object: ArkUI_ListChildrenMainSize object.
Format of the return value ArkUI_AttributeItem:
.object: ArkUI_ListChildrenMainSize object.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: horizontal alignment format of a child component. The data type is ArkUI_HorizontalAlignment.
Default value: ARKUI_HORIZONTAL_ALIGNMENT_CENTER.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: horizontal alignment format of a child component. The data type is ArkUI_HorizontalAlignment.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: vertical alignment format of the child component. The data type is ArkUI_FlexAlignment.
Default value: ARKUI_FLEX_ALIGNMENT_START.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: vertical alignment format of a child component. The data type is ArkUI_FlexAlignment.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: vertical alignment format of a child component. The data type is ArkUI_VerticalAlignment.
Default value: ARKUI_VERTICAL_ALIGNMENT_CENTER.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: vertical alignment format of a child component. The data type is ArkUI_VerticalAlignment.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: horizontal alignment format of a child component. The data type is ArkUI_FlexAlignment.
Default value: ARKUI_FLEX_ALIGNMENT_START.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: horizontal alignment format of a child component. The data type is ArkUI_FlexAlignment.
NODE_FLEX_OPTION Defines the opacity attribute, which can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0]?.i32: arrangement direction of child components on the Flex container ArkUI_FlexDirection. The default value is ARKUI_FLEX_DIRECTION_ROW.
.value[1]?.i32: arrangement rule ArkUI_FlexWrap. The default value is ARKUI_FLEX_WRAP_NO_WRAP.
.value[2]?.i32: alignment format on the principal axis ArkUI_FlexAlignment. The default value is ARKUI_FLEX_ALIGNMENT_START.
.value[3]?.i32: alignment format on the cross axis ArkUI_ItemAlignment. The default value is ARKUI_ITEM_ALIGNMENT_START.
.value[4]?.i32: alignment mode of multiple lines when there is extra space in the cross axis ArkUI_FlexAlignment. The default value is ARKUI_FLEX_ALIGNMENT_START.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: direction in which flex items are arranged.
.value[1].i32: how the flex items are wrapped.
.value[2].i32: alignment mode along the main axis.
.value[3].i32: alignment mode along the cross axis.
.value[4].i32: alignment mode along the cross axis for multi-line content.
NODE_REFRESH_REFRESHING Sets whether a component is being refreshed. Attributes can be set and obtained.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: The parameter type is 1 or 0.
Format of the return value ArkUI_AttributeItem:
value[0].i32: The parameter type is 1 or 0.
NODE_REFRESH_CONTENT Sets the custom content in the pull-down area. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.object: The parameter type is ArkUI_NodeHandle.
NODE_REFRESH_PULL_DOWN_RATIO Sets the pull-down and hand coefficients. The interfaces for setting, resetting, and obtaining attributes are supported.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].f32: pull-down ratio. The value is in the range from 0 to 1.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: pull-down ratio. The value is in the range from 0 to 1.
NODE_REFRESH_OFFSET Sets the pull-down offset that initiates a refresh. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].f32: pull-down offset, in vp. The default value is 64 vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: pull-down offset, in vp. The default value is 64 vp.
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.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: whether to initiate a refresh. The value true means to initiate a refresh, and false means the opposite.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: whether to initiate a refresh. The value 1 means to initiate a refresh, and 0 means the opposite.
NODE_WATER_FLOW_LAYOUT_DIRECTION Defines the main axis direction of the waterfall component layout. Attributes can be set, reset, and obtained.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: main axis direction. The parameter type is ArkUI_FlexDirection.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: main axis direction. The parameter type is ArkUI_FlexDirection.
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.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.string: number of layout columns.
Format of the return value ArkUI_AttributeItem:
.string: number of layout columns.
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.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.string: number of layout rows.
Format of the return value ArkUI_AttributeItem:
.string: number of layout rows.
NODE_WATER_FLOW_COLUMN_GAP Sets the gap between columns. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].f32: gap between columns, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: gap between columns, in vp.
NODE_WATER_FLOW_ROW_GAP Sets the gap between rows. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].f32: gap between lines, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: gap between lines, in vp.
NODE_WATER_FLOW_SECTION_OPTION Defines the water flow section configuration. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].i32: zero-based index of the water flow item section to update. The value is converted to an integer.
.object: ArkUI_WaterFlowSectionOption object.
Format of the return value ArkUI_AttributeItem:
.object: ArkUI_WaterFlowSectionOption object.
NODE_WATER_FLOW_NODE_ADAPTER Defines the water flow adapter. The attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.object: ArkUI_NodeAdapter object as the adapter.
Format of the return value ArkUI_AttributeItem:
.object: ArkUI_NodeAdapter object.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: number of cached items in the water flow adapter.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: number of cached items in the list adapter.
NODE_WATER_FLOW_FOOTER Sets the custom footer for the water flow container.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.object: custom footer. The parameter type is ArkUI_NodeHandle.
NODE_WATER_FLOW_SCROLL_TO_INDEX Scrolls to the item with the specified index.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: index of the item to be scrolled to in the container.
.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.
.value[2]?.i32: how the item to scroll to is aligned with the container. The parameter type is ArkUI_ScrollAlignment. The default value is ARKUI_SCROLL_ALIGNMENT_START.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].f32: minimum width. The value -1 indicates that the minimum width is not set.
.value[1].f32: maximum width. The value -1 indicates that the maximum width is not set.
.value[2].f32: minimum height. The value -1 indicates that the minimum height is not set.
.value[3].f32: maximum height. The value -1 indicates that the maximum height is not set.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: minimum width. The value -1 indicates that the minimum width is not set.
.value[1].f32: maximum width. The value -1 indicates that the maximum width is not set.
.value[2].f32: minimum height. The value -1 indicates that the minimum height is not set.
.value[3].f32: maximum height. The value -1 indicates that the maximum height is not set.
NODE_RELATIVE_CONTAINER_GUIDE_LINE Sets the guideline in the RelativeContainer. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.object: guideline in the RelativeContainer.
Format of the return value ArkUI_AttributeItem:
.object: guideline in the RelativeContainer.
NODE_RELATIVE_CONTAINER_BARRIER Sets the barrier in the RelativeContainer. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.object: guideline in the RelativeContainer.
Format of the return value ArkUI_AttributeItem:
.object: barrier in the RelativeContainer component.
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.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.string: number of layout columns.
Format of the return value ArkUI_AttributeItem:
.string: number of layout columns.
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.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.string: number of layout rows.
Format of the return value ArkUI_AttributeItem:
.string: number of layout rows.
NODE_GRID_COLUMN_GAP Sets the gap between columns. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].f32: gap between columns, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: gap between columns, in vp.
NODE_GRID_ROW_GAP Sets the gap between rows. This attribute can be set, reset, and obtained as required through APIs.
Parameter format of the attribute setting method ArkUI_AttributeItem:
.value[0].f32: gap between lines, in vp.
Format of the return value ArkUI_AttributeItem:
.value[0].f32: gap between lines, in vp.
NODE_GRID_NODE_ADAPTER Defines the grid adapter. The attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.object: ArkUI_NodeAdapter object as the adapter.
Format of the return value ArkUI_AttributeItem:
.object: The format of the return value is ArkUI_NodeAdapter.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: number of cached items in the water flow adapter.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.size: number of image frames;
.object: image frame array. The parameter type is ArkUI_ImageAnimatorFrameInfo.
Format of the return value ArkUI_AttributeItem:
.size: number of image frames;
.object: image frame array. The parameter type is ArkUI_ImageAnimatorFrameInfo.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: controls the playing status of the animation. The parameter type is ArkUI_AnimationStatus. The default value is the initial status.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: controls the playing status of the animation. The parameter type is ArkUI_AnimationStatus.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: playback duration, in milliseconds. The default value is 1000.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: playback duration, in milliseconds. The default value is 1000.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
NODE_IMAGE_ANIMATOR_FIXED_SIZE Sets whether the image size is fixed at the component size.
This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
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.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.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.
Format of the return value ArkUI_AttributeItem:
.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.
NODE_IMAGE_ANIMATOR_ITERATION Sets the number of times that the frame animation is played. This attribute can be set, reset, and obtained as required through APIs.
Format of the ArkUI_AttributeItem parameter for setting the attribute:
.value[0].i32: number of times that the animation is played.
Format of the return value ArkUI_AttributeItem:
.value[0].i32: number of times that the animation is played.

ArkUI_NodeContentEventType

enum ArkUI_NodeContentEventType

Description

Defines the NodeContent event type.

Since: 12

Enum Description
NODE_CONTENT_EVENT_ON_ATTACH_TO_WINDOW Attach event.
NODE_CONTENT_EVENT_ON_DETACH_FROM_WINDOW Detach event.

ArkUI_NodeCustomEventType

enum ArkUI_NodeCustomEventType

Description

Enumerates the custom component event types.

Since: 12

Enum Description
ARKUI_NODE_CUSTOM_EVENT_ON_MEASURE Measure.
ARKUI_NODE_CUSTOM_EVENT_ON_LAYOUT Layout.
ARKUI_NODE_CUSTOM_EVENT_ON_DRAW Draw.
ARKUI_NODE_CUSTOM_EVENT_ON_FOREGROUND_DRAW Foreground.
ARKUI_NODE_CUSTOM_EVENT_ON_OVERLAY_DRAW Overlay.

ArkUI_NodeDirtyFlag

enum ArkUI_NodeDirtyFlag

Description

Enumerates the dirty area flags passed in the ::markDirty API.

Since: 12

Enum Description
NODE_NEED_MEASURE Recalculate the size.
When this type of flag is specified, re-layout is triggered by default.
NODE_NEED_LAYOUT Re-layout.
NODE_NEED_RENDER Re-rendering.

ArkUI_NodeEventType

enum ArkUI_NodeEventType

Description

Enumerates the event types supported by the NativeNode component.

Since: 12

Enum Description
NODE_TOUCH_EVENT Gesture event.
When the event callback occurs, the union type in the event parameter ArkUI_NodeEvent object is ArkUI_UIInputEvent.
NODE_EVENT_ON_APPEAR Mount event.
This event is triggered when the component is mounted to the component tree and displayed.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_EVENT_ON_DISAPPEAR Unmount event.
This event is triggered when the component is unmounted from the component tree and disappears.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_EVENT_ON_AREA_CHANGE Component area change event.
This event is triggered when the component's size, position, or any other attribute that may affect its display area changes.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].f32: original width of the target element, in vp. The value is a number.
ArkUI_NodeComponentEvent.data[1].f32: original height of the target element, in vp. The value is a number.
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.data[6].f32: new width of the target element, in vp. The value is a number.
ArkUI_NodeComponentEvent.data[1].f32: original height of the target element, in vp. The value is a number.
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.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.
NODE_ON_FOCUS Event of obtaining the focus.
This event is triggered when the component obtains the focus.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_ON_BLUR Event of losing the focus.
This event is triggered when the component loses the focus.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_ON_CLICK Click event.
This event is triggered when the component is clicked.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].f32: X coordinate of the click relative to the upper left corner of the clicked component's original area, in px.
ArkUI_NodeComponentEvent.data[1].f32: Y coordinate of the click relative to the upper left corner of the clicked component's original area, in px.
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.data[3].i32: event input device. The value 1 indicates the mouse, 2 indicates the touchscreen, and 4 indicates the key.
ArkUI_NodeComponentEvent.data[4].f32: X coordinate of the click relative to the upper left corner of the application window, in px.
ArkUI_NodeComponentEvent.data[5].f32: Y coordinate of the click relative to the upper left corner of the application window, in px.
ArkUI_NodeComponentEvent.data[6].f32: X coordinate of the click relative to the upper left corner of the application screen, in px.
ArkUI_NodeComponentEvent.data[7].f32: Y coordinate of the click relative to the upper left corner of the application screen, in px.
NODE_ON_TOUCH_INTERCEPT Custom component event interception.
This event is triggered when the component is clicked.
When the event callback occurs, the union type in the event parameter ArkUI_NodeEvent object is ArkUI_UIInputEvent.
NODE_EVENT_ON_VISIBLE_AREA_CHANGE Visible area change event.
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.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.data[1].f32: ratio of the component's visible area to its total area at the time the callback is triggered.
NODE_ON_HOVER Called when the mouse pointer is moved over or away from the component.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.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.
NODE_ON_MOUSE Mouse event.
This event is triggered when the component is clicked by a mouse device button or when the mouse pointer moves within the component.
When the event callback occurs, the union type in the event parameter ArkUI_NodeEvent object is ArkUI_UIInputEvent.
NODE_EVENT_ON_ATTACH Attach event.
This event is triggered when the component is attached to the component tree.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_EVENT_ON_DETACH Detach event.
This event is triggered when the component is detached from the component tree.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_ON_ACCESSIBILITY_ACTIONS Accessibility action.
This event is triggered when an accessibility action is performed after the corresponding accessibility action type is set.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].u32:: operation type for triggering callback. The parameter type is ArkUI_AccessibilityActionType.
NODE_ON_PRE_DRAG Notifies the listener of the interaction state prior to a drop and drop operation.
This event is triggered when a component is draggable and when a long press, lift, or drag initiation occurs.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: corresponds to ArkUI_PreDragStatus.
NODE_ON_DRAG_START Called when the user starts to drag an item.
A drag operation is recognized only when the dragged item is moved far enough.
When the event callback occurs, you can obtain ArkUI_DragEvent from the ArkUI_NodeEvent object.
NODE_ON_DRAG_ENTER Called when a dragged item enters the boundaries of the current component.
The current component refers to the component that listens for this event.
When the event callback occurs, you can obtain ArkUI_DragEvent from the ArkUI_NodeEvent object.
NODE_ON_DRAG_MOVE Called when a dragged item moves in the current component.
The current component refers to the component that listens for this event.
When the event callback occurs, you can obtain ArkUI_DragEvent from the ArkUI_NodeEvent object.
NODE_ON_DRAG_LEAVE Called when a dragged item leaves the boundaries of the current component.
The current component refers to the component that listens for this event.
When the event callback occurs, you can obtain ArkUI_DragEvent from the ArkUI_NodeEvent object.
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.
The current component refers to the component that listens for this event.
When the event callback occurs, you can obtain ArkUI_DragEvent from the ArkUI_NodeEvent object.
NODE_ON_DRAG_END Called when a drag operation ends. The drag source can obtain the drag result by registering this callback.
A drag operation ends when the dragged item is released. When the event callback occurs, the ArkUI_DragEvent object can be obtained from the ArkUI_NodeEvent object.
NODE_ON_KEY_EVENT Triggered when a key event occurs.
The callback can be triggered during interactions with a focused window using an external keyboard or other input device.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
Since
14
NODE_ON_KEY_PRE_IME Defines the event triggered before the input method responds to the key action.
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.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
Since
14
NODE_TEXT_ON_DETECT_RESULT_UPDATE Called when text recognition with the configured TextDataDetectorConfig settings succeeds.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_StringAsyncEvent.
ArkUI_StringAsyncEvent contains the following parameters:
ArkUI_StringAsyncEvent.pStr: text recognition result in JSON format.
NODE_IMAGE_ON_COMPLETE Image loading success event.
This event is triggered when an image is successfully loaded or decoded.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.data[1].f32: width of the image, in px.
ArkUI_NodeComponentEvent.data[2].f32: height of the image, in px.
ArkUI_NodeComponentEvent.data[3].f32: width of the component, in px.
ArkUI_NodeComponentEvent.data[4].f32: height of the component, in px.
ArkUI_NodeComponentEvent.data[5].f32: offset of the rendered content relative to the component on the x-axis, in px.
ArkUI_NodeComponentEvent.data[6].f32: offset of the rendered content relative to the component on the y-axis, in px.
ArkUI_NodeComponentEvent.data[7].f32: actual rendered width of the image, in px.
ArkUI_NodeComponentEvent.data[8].f32:actual rendered height of the image, in px.
NODE_IMAGE_ON_ERROR Image loading failure event.
This event is triggered when an error occurs during image loading.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32 error code information:
401: The image could not be obtained because the image path is invalid.
103101: The image format is not supported.
NODE_IMAGE_ON_SVG_PLAY_FINISH Defines the SVG animation playback completion event.
This event is triggered when the animation playback in the loaded SVG image is complete.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_IMAGE_ON_DOWNLOAD_PROGRESS Called during image download.
Condition for triggering this event: This event is triggered when the page component downloads a web page image.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
Number of bytes that have been downloaded by the ArkUI_NodeComponentEvent.data[0].u32: so far.
Total number of bytes of images to be downloaded by the ArkUI_NodeComponentEvent.data[1].u32:.
NODE_TOGGLE_ON_CHANGE Called when the toggle status changes.
This event is triggered when the switch status changes.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.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.
NODE_TEXT_INPUT_ON_CHANGE Called when the text input content changes.
Condition for triggering the event: The input content changes.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_StringAsyncEvent.
ArkUI_StringAsyncEvent contains the following parameters:
ArkUI_StringAsyncEvent.pStr: input text content.
NODE_TEXT_INPUT_ON_SUBMIT Called when the Enter key of the text input method is pressed.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: type of the Enter key.
NODE_TEXT_INPUT_ON_CUT Called when the cut button on the pasteboard, which displays when the text box is long pressed, is clicked.
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.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_StringAsyncEvent.
ArkUI_StringAsyncEvent contains the following parameters:
ArkUI_StringAsyncEvent.pStr: cut text content.
NODE_TEXT_INPUT_ON_PASTE Called when the paste button on the pasteboard, which displays when the text box is long pressed, is clicked.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_StringAsyncEvent.
ArkUI_StringAsyncEvent contains the following parameters:
ArkUI_StringAsyncEvent.pStr: text pasted.
NODE_TEXT_INPUT_ON_TEXT_SELECTION_CHANGE Called when the text selection position changes.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: indicates the start position of the selected text.
ArkUI_NodeComponentEvent.data[1].i32: indicates the end position of the selected text.
NODE_TEXT_INPUT_ON_EDIT_CHANGE Called when the input status changes.
Condition for triggering this event: The input status changes.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: true indicates that text input is in progress.
NODE_TEXT_INPUT_ON_INPUT_FILTER_ERROR Called when matching with the regular expression specified by NODE_TEXT_INPUT_INPUT_FILTER fails.
Condition for triggering the event: The regular expression fails to be matched.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_StringAsyncEvent.
ArkUI_StringAsyncEvent contains the following parameters:
ArkUI_StringAsyncEvent.pStr: content that is filtered out when regular expression matching fails.
NODE_TEXT_INPUT_ON_CONTENT_SCROLL Called when the text content is scrolled.
Condition for triggering this event: The text content is scrolled.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: horizontal coordinate offset of the text in the content area.
ArkUI_NodeComponentEvent.data[1].i32: offset in the Y coordinate of the text in the content area.
NODE_TEXT_INPUT_ON_CONTENT_SIZE_CHANGE Called when the text input content changes.
Condition for triggering the event: The input content changes.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].f32: indicates the width of the text.
ArkUI_NodeComponentEvent.data[1].f32: height of the text.
NODE_TEXT_INPUT_ON_WILL_INSERT Called when text is about to be entered.
The event parameter is ArkUI_NodeEvent.
value.f32: position of the text, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetNumberValue.
buffer: string value of the text, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetStringValue.

It returns true if the text is inserted; returns false otherwise. You can set the return value using OH_ArkUI_NodeEvent_SetReturnNumberValue.
NODE_TEXT_INPUT_ON_DID_INSERT Called when text is entered.
The event parameter is ArkUI_NodeEvent.
value.f32: position of the text, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetNumberValue.
buffer: string value of the text, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetStringValue.
NODE_TEXT_INPUT_ON_WILL_DELETE Called when text is about to be deleted.
The event parameter is ArkUI_NodeEvent.
value.f32: position of the text deleted, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetNumberValue.
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.
buffer: string value of the text, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetStringValue.

It returns true if the text is inserted; returns false otherwise.
You can set the return value using OH_ArkUI_NodeEvent_SetReturnNumberValue.
NODE_TEXT_INPUT_ON_DID_DELETE Called when text is deleted.
The event parameter is ArkUI_NodeEvent.
value.f32: position of the text deleted, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetNumberValue.
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.
buffer: string value of the text, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetStringValue.
NODE_TEXT_AREA_ON_CHANGE Called when the input in the text box changes.

When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_StringAsyncEvent.
ArkUI_StringAsyncEvent contains the following parameters:
ArkUI_StringAsyncEvent.pStr: text entered.
NODE_TEXT_AREA_ON_PASTE Called when the paste button on the pasteboard, which displays when the text box is long pressed, is clicked.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_StringAsyncEvent.
ArkUI_StringAsyncEvent contains the following parameters:
ArkUI_StringAsyncEvent.pStr: text pasted.
NODE_TEXT_AREA_ON_TEXT_SELECTION_CHANGE Called when the text selection position changes.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: indicates the start position of the selected text.
ArkUI_NodeComponentEvent.data[1].i32: end position of the text selection area.
NODE_TEXT_AREA_ON_EDIT_CHANGE Called when the input status changes.
Condition for triggering this event: The input status changes.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: true indicates that text input is in progress.
NODE_TEXT_AREA_ON_SUBMIT Called when the Enter key on the keyboard is pressed for the multi-line text box.
This event is not triggered when keyType is ARKUI_ENTER_KEY_TYPE_NEW_LINE.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: type of the Enter key.
NODE_TEXT_AREA_ON_INPUT_FILTER_ERROR Called when matching with the regular expression specified by NODE_TEXT_AREA_INPUT_FILTER fails.

When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_StringAsyncEvent.
ArkUI_StringAsyncEvent contains the following parameters:
ArkUI_StringAsyncEvent.pStr: content that is filtered out when regular expression matching fails.
NODE_TEXT_AREA_ON_CONTENT_SCROLL Called when the text content is scrolled.
Condition for triggering this event: The text content is scrolled.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: horizontal coordinate offset of the text in the content area.
ArkUI_NodeComponentEvent.data[1].i32: offset in the Y coordinate of the text in the content area.
NODE_TEXT_AREA_ON_CONTENT_SIZE_CHANGE Called when the text input content changes in the TextArea. component.

When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].f32: indicates the width of the text.
ArkUI_NodeComponentEvent.data[1].f32: height of the text.
NODE_TEXT_AREA_ON_WILL_INSERT Called when text is about to be entered.
The event parameter is ArkUI_NodeEvent.
value.f32: position of the text, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetNumberValue.
buffer: string value of the text, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetStringValue.

It returns true if the text is inserted; returns false otherwise. You can set the return value using OH_ArkUI_NodeEvent_SetReturnNumberValue.
NODE_TEXT_AREA_ON_DID_INSERT Called when text is entered.
The event parameter is ArkUI_NodeEvent.
value.f32: position of the text, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetNumberValue.
buffer: string value of the text, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetStringValue.
NODE_TEXT_AREA_ON_WILL_DELETE Called when text is about to be deleted.
The event parameter is ArkUI_NodeEvent.
value.f32: position of the text deleted, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetNumberValue.
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.
buffer: string value of the text, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetStringValue.

It returns true if the text is inserted; returns false otherwise.
You can set the return value using OH_ArkUI_NodeEvent_SetReturnNumberValue.
NODE_TEXT_AREA_ON_DID_DELETE Called when text is deleted.
The event parameter is ArkUI_NodeEvent.
value.f32: position of the text deleted, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetNumberValue.
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.
buffer: string value of the text, with the index of 0; obtained using OH_ArkUI_NodeEvent_GetStringValue.
NODE_CHECKBOX_EVENT_ON_CHANGE Called when the selected status of the ARKUI_NODE_CHECKBOX component changes.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent.data[0].i32: 1: selected; 0: not selected
NODE_DATE_PICKER_EVENT_ON_DATE_CHANGE Called when a date is selected in the ARKUI_NODE_DATE_PICKER component.

When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: year of the selected date.
ArkUI_NodeComponentEvent.data[1].i32: month of the selected date. Value range: 0–11.
ArkUI_NodeComponentEvent.data[2].i32: day of the selected date.
NODE_TIME_PICKER_EVENT_ON_CHANGE Called when a time is selected in the ARKUI_NODE_TIME_PICKER component.

When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: hour of the selected time. Value range: 0-23.
ArkUI_NodeComponentEvent.data[1].i32: minute of the selected time. Value range: 0-59.
NODE_TEXT_PICKER_EVENT_ON_CHANGE Called when an item is selected in the ARKUI_NODE_TEXT_PICKER component.

When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0...11].i32: value of the selected item.
NODE_CALENDAR_PICKER_EVENT_ON_CHANGE Called when a date is selected in the NODE_CALENDAR_PICKER.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponent.data[0].u32: year of the selected date.
ArkUI_NodeComponent.data[1].u32: month of the selected date.
ArkUI_NodeComponent.data[2].u32: day of the selected date.
NODE_SLIDER_EVENT_ON_CHANGE Called when the ARKUI_NODE_SLIDER component is dragged or clicked.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].f32: current slider value.
ArkUI_NodeComponentEvent.data[1].i32: state triggered by the event.
NODE_RADIO_EVENT_ON_CHANGE Called when the ARKUI_NODE_RADIO component is dragged or clicked.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: status of the radio button.
NODE_IMAGE_ANIMATOR_EVENT_ON_START Called when the frame-by-frame animation starts to play.


When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_IMAGE_ANIMATOR_EVENT_ON_PAUSE Called when the frame-by-frame animation playback is paused.


When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_IMAGE_ANIMATOR_EVENT_ON_REPEAT Called when the frame-by-frame animation playback is repeated.


When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_IMAGE_ANIMATOR_EVENT_ON_CANCEL Called when the frame-by-frame animation playback returns to the initial state.


When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_IMAGE_ANIMATOR_EVENT_ON_FINISH Called when the frame-by-frame animation playback is complete or stopped.


When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_SWIPER_EVENT_ON_CHANGE Called when the index of the currently displayed element of this ARKUI_NODE_SWIPER instance changes.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: index of the currently displayed element.
NODE_SWIPER_EVENT_ON_ANIMATION_START Called when the switching animation of this ARKUI_NODE_SWIPER instance starts.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: index of the currently displayed element.
ArkUI_NodeComponentEvent.data[1].i32: index of the target element to switch to.
ArkUI_NodeComponentEvent.data[2].f32: offset of the currently displayed element relative to the start position of the swiper along the main axis.
ArkUI_NodeComponentEvent.data[3].f32: offset of the target element relative to the start position of the swiper along the main axis.
ArkUI_NodeComponentEvent.data[4].f32: hands-off velocity.
NODE_SWIPER_EVENT_ON_ANIMATION_END Called when the switching animation of this ARKUI_NODE_SWIPER instance ends.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: index of the currently displayed element.
ArkUI_NodeComponentEvent.data[1].f32: offset of the currently displayed element relative to the start position of the swiper along the main axis.
NODE_SWIPER_EVENT_ON_GESTURE_SWIPE Triggered on a frame-by-frame basis when the page is turned by a swipe.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: index of the currently displayed element.
ArkUI_NodeComponentEvent.data[1].f32: offset of the currently displayed element relative to the start position of the swiper along the main axis.
NODE_SWIPER_EVENT_ON_CONTENT_DID_SCROLL Called when content in the ARKUI_NODE_SWIPER component scrolls. Instructions:
1. When ArkUI_SwiperDisplayModeType is set to ARKUI_SWIPER_DISPLAY_MODE_AUTO_LINEAR, this API does not take effect.
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.
3. During page scrolling, the ContentDidScrollCallback callback is invoked for all pages in the viewport on a frame-by-frame basis.
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.
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:
Callback is triggered for all pages in the same group.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: index of the Swiper component, which is the same as the index value in the onChange event.
ArkUI_NodeComponentEvent.data[1].i32: index of a page in the window.
ArkUI_NodeComponentEvent.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).
ArkUI_NodeComponentEvent.data[3].f32: page length in the principal axis direction.
NODE_SCROLL_EVENT_ON_SCROLL Defines the scrolling event enumeration values of the scrolling container component.
NOTE
1. This event is triggered when scrolling is started by the Scroll component or other input settings, such as keyboard and mouse operations.
2. This event is triggered when the controller API is called.
3. This event supports the out-of-bounds bounce effect.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].f32: horizontal scrolling offset.
ArkUI_NodeComponentEvent.data[1].f32: vertical scrolling offset.
NODE_SCROLL_EVENT_ON_SCROLL_FRAME_BEGIN Called when the container starts scrolling.
NOTE
1. This event is triggered when scrolling is started by the Scroll component or other input settings, such as keyboard and mouse operations.
2. This event is not triggered when the controller API is called.
3. This event does not support the out-of-bounds bounce effect.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].f32: indicates the upcoming scrolling amount.
ArkUI_NodeComponentEvent.data[1].i32: current scroll state.
The ArkUI_NodeComponentEvent parameter contains the following return value:
ArkUI_NodeComponentEvent.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.
NODE_SCROLL_EVENT_ON_WILL_SCROLL Called when the container is about to scroll.
NOTE
1. This event is triggered when scrolling is started by the Scroll component or other input settings, such as keyboard and mouse operations.
2. This event is triggered when the controller API is called.
3. This event supports the out-of-bounds bounce effect.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.data[2].i32: current scroll state. The parameter type is ArkUI_ScrollState.
ArkUI_NodeComponentEvent.data[3].i32: scroll source. The parameter type is ArkUI_ScrollSource.
Returns
Returns one or no number to indicate the actual amount by which the scroll component scrolls.
NODE_SCROLL_EVENT_ON_DID_SCROLL Called when the container scrolls.
NOTE
1. This event is triggered when scrolling is started by the Scroll component or other input settings, such as keyboard and mouse operations.
2. This event is triggered when the controller API is called.
3. This event supports the out-of-bounds bounce effect.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.data[2].i32: current scroll state. The parameter type is ArkUI_ScrollState.
NODE_SCROLL_EVENT_ON_SCROLL_START Called when the container starts scrolling.
NOTE
1. This event is triggered when scrolling is started by the Scroll component or other input settings, such as keyboard and mouse operations.
2. This event is triggered when the controller API is called, accompanied by a transition animation.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_SCROLL_EVENT_ON_SCROLL_STOP Called when the container stops scrolling.
NOTE
1. This event is triggered when scrolling is stopped by the Scroll component or other input settings, such as keyboard and mouse operations.
2. This event is triggered when the controller API is called, accompanied by a transition animation.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_SCROLL_EVENT_ON_SCROLL_EDGE Defines the scrolling edge event enumeration values of the scrolling container component.
NOTE
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.
2. This event is triggered when the controller API is called.
3. This event supports the out-of-bounds bounce effect.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32 indicates the top, bottom, left, and right edges that are touched.
NODE_SCROLL_EVENT_ON_REACH_START Called when the container reaches the start edge.
NOTE
This event is triggered when scrolling hits the start edge.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_SCROLL_EVENT_ON_REACH_END Called when the container reaches the end edge.
NOTE
This event is triggered when scrolling hits the end edge.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_LIST_ON_SCROLL_INDEX Called when a child component enters or leaves the list display area.
NOTE
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.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: index of the first child component in the list display area.
ArkUI_NodeComponentEvent.data[1].i32: index of the last child component in the list display area.
ArkUI_NodeComponentEvent.data[2].i32: index of the center child component in the list display area.
NODE_LIST_ON_WILL_SCROLL Called when the list is about to scroll.
NOTE
1. This event is triggered when scrolling is started by the Scroll component or other input settings, such as keyboard and mouse operations.
2. This event is triggered when the controller API is called.
3. This event supports the out-of-bounds bounce effect.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.data[1].i32: current scroll state. The parameter type is ArkUI_ScrollState.
ArkUI_NodeComponentEvent.data[2].i32: scroll source. The parameter type is ArkUI_ScrollSource.
Returns
Returns one or no number to indicate the actual amount by which the scroll component scrolls.
NODE_LIST_ON_DID_SCROLL Called when the list scrolls.
NOTE
1. This event is triggered when scrolling is started by the Scroll component or other input settings, such as keyboard and mouse operations.
2. This event is triggered when the controller API is called.
3. This event supports the out-of-bounds bounce effect.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.data[1].i32: current scroll state.
NODE_REFRESH_STATE_CHANGE Called when the refresh state of the ARKUI_NODE_REFRESH object changes.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].i32: refresh state.
NODE_REFRESH_ON_REFRESH Called when the ARKUI_NODE_REFRESH object enters the refresh state.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent does not contain parameters.
NODE_REFRESH_ON_OFFSET_CHANGE Called when the pull-down distance of the ARKUI_NODE_REFRESH object changes.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].f32: pull-down distance.
NODE_ON_WILL_SCROLL Called when the water flow container is about to scroll.
NOTE
1. This event is triggered when scrolling is started by the Scroll component or other input settings, such as keyboard and mouse operations.
2. This event is triggered when the controller API is called.
3. This event supports the out-of-bounds bounce effect.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.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.
ArkUI_NodeComponentEvent.data[1].i32: current scroll state. The parameter type is ArkUI_ScrollState.
ArkUI_NodeComponentEvent.data[2].i32: scroll source. The parameter type is ArkUI_ScrollSource.
Returns
Returns one or no number to indicate the actual amount by which the scroll component scrolls.
NODE_WATER_FLOW_ON_DID_SCROLL Called when the water flow container scrolls.
NOTE
1. This event is triggered when scrolling is started by the Scroll component or other input settings, such as keyboard and mouse operations.
2. This event is triggered when the controller API is called.
3. This event supports the out-of-bounds bounce effect.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
ArkUI_NodeComponentEvent.data[0].f32: Offset of scrolling each frame. The offset is positive when the content scrolls up and negative when the content scrolls down.
Current sliding status of the ArkUI_NodeComponentEvent.data[1].i32:.
NODE_WATER_FLOW_ON_SCROLL_INDEX Called when the first or last item displayed in the water flow container changes.
NOTE
This event is triggered when either of the preceding indexes changes.
When the event callback occurs, the union type in the ArkUI_NodeEvent object is ArkUI_NodeComponentEvent.
ArkUI_NodeComponentEvent contains the following parameters:
Index of the start position of the water flow displayed on the ArkUI_NodeComponentEvent.data[0].i32:.
Index of the end position of the waterfall currently displayed on the ArkUI_NodeComponentEvent.data[1].i32:.

ArkUI_NodeType

enum ArkUI_NodeType

Description

Enumerates ArkUI component types that can be created on the native side.

Since: 12

Enum Description
ARKUI_NODE_CUSTOM Custom node.
ARKUI_NODE_TEXT Text to insert.
ARKUI_NODE_SPAN Text span.
ARKUI_NODE_IMAGE_SPAN Image span.
ARKUI_NODE_IMAGE Image.
ARKUI_NODE_TOGGLE Toggle.
ARKUI_NODE_LOADING_PROGRESS Loading icon.
ARKUI_NODE_TEXT_INPUT Single-line text input.
ARKUI_NODE_TEXT_AREA Multi-line text input.
ARKUI_NODE_BUTTON Icon.
ARKUI_NODE_PROGRESS Progress indicator.
ARKUI_NODE_CHECKBOX Check box.
ARKUI_NODE_XCOMPONENT XComponent.
ARKUI_NODE_DATE_PICKER Date picker.
ARKUI_NODE_TIME_PICKER Time picker.
ARKUI_NODE_TEXT_PICKER Text picker.
ARKUI_NODE_CALENDAR_PICKER Calendar picker.
ARKUI_NODE_SLIDER Slider.
ARKUI_NODE_RADIO Radio button.
ARKUI_NODE_IMAGE_ANIMATOR Frame animation component.
ARKUI_NODE_STACK Stack container.
ARKUI_NODE_SWIPER Swiper.
ARKUI_NODE_SCROLL Scrolling container.
ARKUI_NODE_LIST List.
ARKUI_NODE_LIST_ITEM List item.
ARKUI_NODE_LIST_ITEM_GROUP List item group.
ARKUI_NODE_COLUMN Column container.
ARKUI_NODE_ROW Row container.
ARKUI_NODE_FLEX Flex container.
ARKUI_NODE_REFRESH Refresh component.
ARKUI_NODE_WATER_FLOW Water flow container.
ARKUI_NODE_FLOW_ITEM Water flow item.
ARKUI_NODE_RELATIVE_CONTAINER Relative layout component.
ARKUI_NODE_GRID Grid.
ARKUI_NODE_GRID_ITEM Grid item.
ARKUI_NODE_CUSTOM_SPAN Custom span.

ArkUI_ObjectFit

enum ArkUI_ObjectFit

Description

Enumerates the image filling effects. ImageSpanAlignment

Since: 12

Enum Description
ARKUI_OBJECT_FIT_CONTAIN The image is scaled with its aspect ratio retained for the content to be completely displayed within the display boundaries.
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.
ARKUI_OBJECT_FIT_AUTO The image is scaled automatically to fit the display area.
ARKUI_OBJECT_FIT_FILL The image is scaled to fill the display area, and its aspect ratio is not retained.
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.
ARKUI_OBJECT_FIT_NONE The original size is retained.
ARKUI_OBJECT_FIT_NONE_AND_ALIGN_TOP_START Not resized, the image is aligned with the start edge of the top of the container.
ARKUI_OBJECT_FIT_NONE_AND_ALIGN_TOP Not resized, the image is horizontally centered at the top of the container.
ARKUI_OBJECT_FIT_NONE_AND_ALIGN_TOP_END Not resized, the image is aligned with the end edge at the top of the container.
ARKUI_OBJECT_FIT_NONE_AND_ALIGN_START Not resized, the image is vertically centered on the start edge of the container.
ARKUI_OBJECT_FIT_NONE_AND_ALIGN_CENTER Not resized, the image is horizontally and vertically centered in the container.
ARKUI_OBJECT_FIT_NONE_AND_ALIGN_END Not resized, the image is vertically centered on the end edge of the container.
ARKUI_OBJECT_FIT_NONE_AND_ALIGN_BOTTOM_START Not resized, the image is aligned with the start edge at the bottom of the container.
ARKUI_OBJECT_FIT_NONE_AND_ALIGN_BOTTOM Not resized, the image is horizontally centered at the bottom of the container.
ARKUI_OBJECT_FIT_NONE_AND_ALIGN_BOTTOM_END Not resized, the image is aligned with the end edge at the bottom of the container.

ArkUI_PageFlipMode

enum ArkUI_PageFlipMode

Description

Enumerates the page flipping modes using the mouse wheel for the Swiper component.

Since: 14

Enum Description
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.
ARKUI_PAGE_FLIP_MODE_SINGLE The system does not respond to other mouse wheel events until the page flipping animation ends.

ArkUI_PreDragStatus

enum ArkUI_PreDragStatus

Description

Defines an enum for interaction states prior to a drop and drop operation.

Since: 12

Enum Description
ARKUI_PRE_DRAG_STATUS_UNKNOWN Unknown.
ARKUI_PRE_DRAG_STATUS_ACTION_DETECTING A drag gesture is being detected.
ARKUI_PRE_DRAG_STATUS_READY_TO_TRIGGER_DRAG The component is ready to be dragged.
ARKUI_PRE_DRAG_STATUS_PREVIEW_LIFT_STARTED A lift animation is started.
ARKUI_PRE_DRAG_STATUS_PREVIEW_LIFT_FINISHED A lift animation is finished.
ARKUI_PRE_DRAG_STATUS_PREVIEW_LANDING_STARTED A drop animation is started.
ARKUI_PRE_DRAG_STATUS_PREVIEW_LANDING_FINISHED A drop animation is finished.
ARKUI_PRE_DRAG_STATUS_CANCELED_BEFORE_DRAG A drop animation is terminated.

ArkUI_ProgressType

enum ArkUI_ProgressType

Description

Enumerates the styles of the progress indicator.

Since: 12

Enum Description
ARKUI_PROGRESS_TYPE_LINEAR Linear type.
ARKUI_PROGRESS_TYPE_RING Indeterminate ring style.
ARKUI_PROGRESS_TYPE_ECLIPSE Eclipse style.
ARKUI_PROGRESS_TYPE_SCALE_RING Determinate ring style.
ARKUI_PROGRESS_TYPE_CAPSULE Capsule style.

ArkUI_RelativeLayoutChainStyle

enum ArkUI_RelativeLayoutChainStyle

Description

Enumerates the chain styles.

Since: 12

Enum Description
ARKUI_RELATIVE_LAYOUT_CHAIN_STYLE_SPREAD Child components are evenly distributed among constraint anchors.
ARKUI_RELATIVE_LAYOUT_CHAIN_STYLE_SPREAD_INSIDE All child components except the first and last ones are evenly distributed among constraint anchors.
ARKUI_RELATIVE_LAYOUT_CHAIN_STYLE_PACKED There is no gap between child components in the chain.

ArkUI_RenderFit

enum ArkUI_RenderFit
Enum Description
ARKUI_RENDER_FIT_CENTER The component's content stays at the final size and always aligned with the center of the component.
ARKUI_RENDER_FIT_TOP The component's content stays at the final size and always aligned with the top center of the component.
ARKUI_RENDER_FIT_BOTTOM The component's content stays at the final size and always aligned with the bottom center of the component.
ARKUI_RENDER_FIT_LEFT The component's content stays at the final size and always aligned with the left of the component.
ARKUI_RENDER_FIT_RIGHT The component's content stays at the final size and always aligned with the right of the component.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.

ArkUI_RouterPageState

enum ArkUI_RouterPageState

Description

Enumerates the states of a page during routing.

Since: 12

Enum Description
ARKUI_ROUTER_PAGE_STATE_ON_WILL_APPEAR The page is about to be displayed.
ARKUI_ROUTER_PAGE_STATE_ON_WILL_DISAPPEAR The page is about to be destroyed.
ARKUI_ROUTER_PAGE_STATE_ON_SHOW The page is displayed.
ARKUI_ROUTER_PAGE_STATE_ON_HIDE The page is hidden.
ARKUI_ROUTER_PAGE_STATE_ON_BACK_PRESS The back button is pressed for the page.

ArkUI_SafeAreaEdge

enum ArkUI_SafeAreaEdge

Description

Enumerates the edges for expanding the safe area.

Since: 12

Enum Description
ARKUI_SAFE_AREA_EDGE_TOP Top edge.
ARKUI_SAFE_AREA_EDGE_BOTTOM Bottom edge.
ARKUI_SAFE_AREA_EDGE_START Start edge.
ARKUI_SAFE_AREA_EDGE_END End edge.

ArkUI_SafeAreaType

enum ArkUI_SafeAreaType

Description

Enumerates the types of expanded safe areas.

Since: 12

Enum Description
ARKUI_SAFE_AREA_TYPE_SYSTEM Default non-safe area of the system, including the status bar and navigation bar.
ARKUI_SAFE_AREA_TYPE_CUTOUT Non-safe area of the device, for example, the notch area.
ARKUI_SAFE_AREA_TYPE_KEYBOARD Soft keyboard area.

ArkUI_ScrollAlignment

enum ArkUI_ScrollAlignment

Description

Defines how the list item to scroll to is aligned with the container.

Since: 12

Enum Description
ARKUI_SCROLL_ALIGNMENT_START The start edge of the list item is flush with the start edge of the container.
ARKUI_SCROLL_ALIGNMENT_CENTER The list item is centered along the main axis of the list.
ARKUI_SCROLL_ALIGNMENT_END The end edge of the list item Aligns the tail of an item with that of a container.
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.

ArkUI_ScrollBarDisplayMode

enum ArkUI_ScrollBarDisplayMode

Description

Enumerates the scrollbar display modes.

Since: 12

Enum Description
ARKUI_SCROLL_BAR_DISPLAY_MODE_OFF Not displayed.
ARKUI_SCROLL_BAR_DISPLAY_MODE_AUTO Displayed when the screen is touched and hidden after 2s.
ARKUI_SCROLL_BAR_DISPLAY_MODE_ON Always displayed.

ArkUI_ScrollDirection

enum ArkUI_ScrollDirection

Description

Enumerates the scroll directions of scrollable components.

Since: 12

Enum Description
ARKUI_SCROLL_DIRECTION_VERTICAL Only vertical scrolling is supported.
ARKUI_SCROLL_DIRECTION_HORIZONTAL Only horizontal scrolling is supported.
ARKUI_SCROLL_DIRECTION_NONE Scrolling is forbidden.

ArkUI_ScrollEdge

enum ArkUI_ScrollEdge

Description

Defines the edge to which the component scrolls.

Since: 12

Enum Description
ARKUI_SCROLL_EDGE_TOP Top edge in the vertical direction.
ARKUI_SCROLL_EDGE_BOTTOM Bottom edge in the vertical direction.
ARKUI_SCROLL_EDGE_START Start position in the horizontal direction.
ARKUI_SCROLL_EDGE_END End position in the horizontal direction.

ArkUI_ScrollNestedMode

enum ArkUI_ScrollNestedMode

Description

Enumerates nested scrolling options.

Since: 12

Enum Description
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.
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.
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.
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.

ArkUI_ScrollSnapAlign

enum ArkUI_ScrollSnapAlign

Description

Enumerates the alignment modes of list items when scrolling ends.

Since: 12

Enum Description
ARKUI_SCROLL_SNAP_ALIGN_NONE No alignment. This is the default value.
ARKUI_SCROLL_SNAP_ALIGN_START The first item in the view is aligned at the start of the list.
ARKUI_SCROLL_SNAP_ALIGN_CENTER The middle items in the view are aligned in the center of the list.
ARKUI_SCROLL_SNAP_ALIGN_END The last item in the view is aligned at the end of the list.

ArkUI_ScrollSource

enum ArkUI_ScrollSource

Description

Enumerates the scrolling sources.

Since: 12

Enum Description
ARKUI_SCROLL_SOURCE_DRAG Drag your finger.
ARKUI_SCROLL_SOURCE_FLING Inertia scrolling after finger dragging.
ARKUI_SCROLL_SOURCE_EDGE_EFFECT Executes the EdgeEffect.Spring edge special effect when the boundary is crossed.
ARKUI_SCROLL_SOURCE_OTHER_USER_INPUT User input other than dragging, such as mouse wheel and keyboard events.
ARKUI_SCROLL_SOURCE_SCROLL_BAR Scrollbar dragging
ARKUI_SCROLL_SOURCE_SCROLL_BAR_FLING Inertial scrolling after the scroll bar is dragged.
ARKUI_SCROLL_SOURCE_SCROLLER Scrolling by the scroll controller (without animation).
ARKUI_SCROLL_SOURCE_ANIMATION Scrolling by the scroll controller (with animation).

ArkUI_ScrollState

enum ArkUI_ScrollState

Description

Enumerates the scrolling states.

Since: 12

Enum Description
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.
ARKUI_SCROLL_STATE_SCROLL Scrolling. The container enters this state when the user drags the container to scroll.
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.

ArkUI_ShadowStyle

enum ArkUI_ShadowStyle

Description

Enumerated value of the shadow effect.

Since: 12

Enum Description
ARKUI_SHADOW_STYLE_OUTER_DEFAULT_XS Mini shadow.
ARKUI_SHADOW_STYLE_OUTER_DEFAULT_SM Small shadow.
ARKUI_SHADOW_STYLE_OUTER_DEFAULT_MD Medium shadow.
ARKUI_SHADOW_STYLE_OUTER_DEFAULT_LG Large shadow.
ARKUI_SHADOW_STYLE_OUTER_FLOATING_SM Floating small shadow.
ARKUI_SHADOW_STYLE_OUTER_FLOATING_MD Floating medium shadow.

ArkUI_ShadowType

enum ArkUI_ShadowType

Description

Defines the enumerated values of the shadow type.

Since: 12

Enum Description
ARKUI_SHADOW_TYPE_COLOR Color.
ARKUI_SHADOW_TYPE_BLUR Blur.

ArkUI_ShapeType

enum ArkUI_ShapeType

Description

Enumerates custom shape types.

Since: 12

Enum Description
ARKUI_SHAPE_TYPE_RECTANGLE Rectangle.
ARKUI_SHAPE_TYPE_CIRCLE (circle)
ARKUI_SHAPE_TYPE_ELLIPSE Ellipse.
ARKUI_SHAPE_TYPE_PATH Path Type

ArkUI_SliderBlockStyle

enum ArkUI_SliderBlockStyle

Description

Enumerates the styles of the slider in the block direction.

Since: 12

Enum Description
ARKUI_SLIDER_BLOCK_STYLE_DEFAULT Round slider.
ARKUI_SLIDER_BLOCK_STYLE_IMAGE Slider with an image background.
ARKUI_SLIDER_BLOCK_STYLE_SHAPE Slider in a custom shape.

ArkUI_SliderDirection

enum ArkUI_SliderDirection

Description

Enumerates the scroll directions of the slider.

Since: 12

Enum Description
ARKUI_SLIDER_DIRECTION_VERTICAL Vertical direction.
ARKUI_SLIDER_DIRECTION_HORIZONTAL Horizontal direction.

ArkUI_SliderStyle

enum ArkUI_SliderStyle

Description

Enumerates the slider styles.

Since: 12

Enum Description
ARKUI_SLIDER_STYLE_OUT_SET The slider is on the slider rail.
ARKUI_SLIDER_STYLE_IN_SET The slider is in the slider rail.
ARKUI_SLIDER_STYLE_NONE There is no thumb.

ArkUI_StickyStyle

enum ArkUI_StickyStyle

Description

Enumerates the modes for pinning the header to the top or the footer to the bottom.

Since: 12

Enum Description
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.
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.
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.
ARKUI_STICKY_STYLE_BOTH In the list item group, the footer is pinned to the bottom, and the header is pinned to the top.

ArkUI_SwiperArrow

enum ArkUI_SwiperArrow

Description

Enumerates arrow styles of the navigation point indicator.

Since: 12

Enum Description
ARKUI_SWIPER_ARROW_HIDE The arrow is not displayed for the navigation point indicator.
ARKUI_SWIPER_ARROW_SHOW The arrow is displayed for the navigation point indicator.
ARKUI_SWIPER_ARROW_SHOW_ON_HOVER The arrow is displayed only when the mouse pointer hovers over the navigation point indicator.

ArkUI_SwiperDisplayModeType

enum ArkUI_SwiperDisplayModeType

Description

Enumerates the modes in which elements are displayed along the main axis of the Swiper component.

Since: 12

Enum Description
ARKUI_SWIPER_DISPLAY_MODE_STRETCH The slide width of the Swiper component is equal to the width of the component.
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.

ArkUI_SwiperIndicatorType

enum ArkUI_SwiperIndicatorType

Description

Enumerates the navigation point indicator types of the Swiper component.

Since: 12

Enum Description
ARKUI_SWIPER_INDICATOR_TYPE_DOT Dot type.
ARKUI_SWIPER_INDICATOR_TYPE_DIGIT Digit type.

ArkUI_SwiperNestedScrollMode

enum ArkUI_SwiperNestedScrollMode

Description

Enumerates the nested scrolling mode of the Swiper component and its parent container.

Since: 12

Enum Description
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.
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.

ArkUI_SystemColorMode

enum ArkUI_SystemColorMode

Description

Enumerates the system color modes.

Since: 12

Enum Description
ARKUI_SYSTEM_COLOR_MODE_LIGHT Light mode.
ARKUI_SYSTEM_COLOR_MODE_DARK Dark mode.

ArkUI_TextAlignment

enum ArkUI_TextAlignment

Description

Enumerates the text alignment mode.

Since: 12

Enum Description
ARKUI_TEXT_ALIGNMENT_START Aligned with the start.
ARKUI_TEXT_ALIGNMENT_CENTER Horizontally centered.
ARKUI_TEXT_ALIGNMENT_END Aligned with the end.
ARKUI_TEXT_ALIGNMENT_JUSTIFY Aligned with both margins.

ArkUI_TextAreaType

enum ArkUI_TextAreaType

Description

Enumerates the text box types.

Since: 12

Enum Description
ARKUI_TEXTAREA_TYPE_NORMAL Normal input mode.
ARKUI_TEXTAREA_TYPE_NUMBER Number input mode.
ARKUI_TEXTAREA_TYPE_PHONE_NUMBER Phone number input mode.
ARKUI_TEXTAREA_TYPE_EMAIL Email address input mode.

ArkUI_TextCase

enum ArkUI_TextCase

Description

Defines the enumerated values of text case.

Since: 12

Enum Description
ARKUI_TEXT_CASE_NORMAL The original case of the text is retained.
ARKUI_TEXT_CASE_LOWER All letters in the text are in lowercase.
ARKUI_TEXT_CASE_UPPER All letters in the text are in uppercase.

ArkUI_TextCopyOptions

enum ArkUI_TextCopyOptions

Description

Enumerates copy options, which define whether copy and paste is allowed for text content.

Since: 12

Enum Description
ARKUI_TEXT_COPY_OPTIONS_NONE Copy is not allowed.
ARKUI_TEXT_COPY_OPTIONS_IN_APP Intra-application copy is allowed.
ARKUI_TEXT_COPY_OPTIONS_LOCAL_DEVICE Intra-device copy is allowed.
ARKUI_TEXT_COPY_OPTIONS_CROSS_DEVICE Cross-device copy is allowed.

ArkUI_TextDataDetectorType

enum ArkUI_TextDataDetectorType

Description

Enumerates the entity types of text recognition.

Since: 12

Enum Description
ARKUI_TEXT_DATA_DETECTOR_TYPE_PHONE_NUMBER Phone number.
ARKUI_TEXT_DATA_DETECTOR_TYPE_URL Link.
ARKUI_TEXT_DATA_DETECTOR_TYPE_EMAIL Email
ARKUI_TEXT_DATA_DETECTOR_TYPE_ADDRESS Network address.

ArkUI_TextDecorationStyle

enum ArkUI_TextDecorationStyle

Description

Enumerates the text decoration styles.

Since: 12

Enum Description
ARKUI_TEXT_DECORATION_STYLE_SOLID Single solid line.
ARKUI_TEXT_DECORATION_STYLE_DOUBLE Double solid line.
ARKUI_TEXT_DECORATION_STYLE_DOTTED Dotted line.
ARKUI_TEXT_DECORATION_STYLE_DASHED Dashed style.
ARKUI_TEXT_DECORATION_STYLE_WAVY Wavy line.

ArkUI_TextDecorationType

enum ArkUI_TextDecorationType

Description

Enumerates the text decoration types.

Since: 12

Enum Description
ARKUI_TEXT_DECORATION_TYPE_NONE No text decoration.
ARKUI_TEXT_DECORATION_TYPE_UNDERLINE Line under the text.
ARKUI_TEXT_DECORATION_TYPE_OVERLINE Line over the text.
ARKUI_TEXT_DECORATION_TYPE_LINE_THROUGH Line through the text.

ArkUI_TextHeightAdaptivePolicy

enum ArkUI_TextHeightAdaptivePolicy

Description

Defines how the adaptive height is determined for the text.

Since: 12

Enum Description
ARKUI_TEXT_HEIGHT_ADAPTIVE_POLICY_MAX_LINES_FIRST Prioritize the maxLines settings.
ARKUI_TEXT_HEIGHT_ADAPTIVE_POLICY_MIN_FONT_SIZE_FIRST Prioritize the minFontSize settings.
ARKUI_TEXT_HEIGHT_ADAPTIVE_POLICY_LAYOUT_CONSTRAINT_FIRST Prioritize the layout constraint settings in terms of height.

ArkUI_TextInputContentType

enum ArkUI_TextInputContentType

Description

Enumerates the autofill types.

Since: 12

Enum Description
ARKUI_TEXTINPUT_CONTENT_TYPE_USER_NAME Username. Password Vault, when enabled, can automatically save and fill in usernames.
ARKUI_TEXTINPUT_CONTENT_TYPE_PASSWORD Password. Password Vault, when enabled, can automatically save and fill in passwords.
ARKUI_TEXTINPUT_CONTENT_TYPE_NEW_PASSWORD New password. Password Vault, when enabled, can automatically generate a new password.
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.
ARKUI_TEXTINPUT_CONTENT_TYPE_HOUSE_NUMBER House number. The scenario-based autofill feature, when enabled, can automatically save and fill in house numbers.
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.
ARKUI_TEXTINPUT_CONTENT_TYPE_CITY_ADDRESS City. The scenario-based autofill feature, when enabled, can automatically save and fill in cities.
ARKUI_TEXTINPUT_CONTENT_TYPE_PROVINCE_ADDRESS Province. The scenario-based autofill feature, when enabled, can automatically save and fill in provinces.
ARKUI_TEXTINPUT_CONTENT_TYPE_COUNTRY_ADDRESS Country. The scenario-based autofill feature, when enabled, can automatically save and fill in countries.
ARKUI_TEXTINPUT_CONTENT_TYPE_PERSON_FULL_NAME Full name. The scenario-based autofill feature, when enabled, can automatically save and fill in full names.
ARKUI_TEXTINPUT_CONTENT_TYPE_PERSON_LAST_NAME Last name. The scenario-based autofill feature, when enabled, can automatically save and fill in last names.
ARKUI_TEXTINPUT_CONTENT_TYPE_PERSON_FIRST_NAME First name. The scenario-based autofill feature, when enabled, can automatically save and fill in first names.
ARKUI_TEXTINPUT_CONTENT_TYPE_PHONE_NUMBER Phone number. The scenario-based autofill feature, when enabled, can automatically save and fill in phone numbers.
ARKUI_TEXTINPUT_CONTENT_TYPE_PHONE_COUNTRY_CODE Country code. The scenario-based autofill feature, when enabled, can automatically save and fill in country codes.
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.
ARKUI_TEXTINPUT_CONTENT_EMAIL_ADDRESS Email address. The scenario-based autofill feature, when enabled, can automatically save and fill in email addresses.
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.
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.
ARKUI_TEXTINPUT_CONTENT_TYPE_NICKNAME Nickname. The scenario-based autofill feature, when enabled, can automatically save and fill in nicknames.
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.
ARKUI_TEXTINPUT_CONTENT_TYPE_FORMAT_ADDRESS Standard address. The scenario-based autofill feature, when enabled, can automatically save and fill in standard addresses.

ArkUI_TextInputStyle

enum ArkUI_TextInputStyle

Description

Enumerates the text input styles.

Since: 12

Enum Description
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.
ARKUI_TEXTINPUT_STYLE_INLINE Inline input style. The background height of the selected text is the same as the height of the text box.

ArkUI_TextInputType

enum ArkUI_TextInputType

Description

Enumerates the text input types.

Since: 12

Enum Description
ARKUI_TEXTINPUT_TYPE_NORMAL Normal input mode.
ARKUI_TEXTINPUT_TYPE_NUMBER Number input mode.
ARKUI_TEXTINPUT_TYPE_PHONE_NUMBER Phone number input mode.
ARKUI_TEXTINPUT_TYPE_EMAIL Email address input mode.
ARKUI_TEXTINPUT_TYPE_PASSWORD Password input mode.
ARKUI_TEXTINPUT_TYPE_NUMBER_PASSWORD Numeric password input mode.
ARKUI_TEXTINPUT_TYPE_SCREEN_LOCK_PASSWORD Lock screen password input mode.
ARKUI_TEXTINPUT_TYPE_USER_NAME Username input mode.
ARKUI_TEXTINPUT_TYPE_NEW_PASSWORD New password input mode.
ARKUI_TEXTINPUT_TYPE_NUMBER_DECIMAL Number input mode with a decimal point.

ArkUI_TextOverflow

enum ArkUI_TextOverflow

Description

Enumerates the display modes when the text is too long.

Since: 12

Enum Description
ARKUI_TEXT_OVERFLOW_NONE Extra-long text is not clipped.
ARKUI_TEXT_OVERFLOW_CLIP Extra-long text is clipped.
ARKUI_TEXT_OVERFLOW_ELLIPSIS An ellipsis (...) is used to represent text overflow.
ARKUI_TEXT_OVERFLOW_MARQUEE Text continuously scrolls when text overflow occurs.

ArkUI_TextPickerRangeType

enum ArkUI_TextPickerRangeType

Description

Enumerates the types of the text picker.

Since: 12

Enum Description
ARKUI_TEXTPICKER_RANGETYPE_SINGLE Single-column text picker.
ARKUI_TEXTPICKER_RANGETYPE_MULTI Multi-column text picker.
ARKUI_TEXTPICKER_RANGETYPE_RANGE_CONTENT Single-column text picker with image resources.
ARKUI_TEXTPICKER_RANGETYPE_CASCADE_RANGE_CONTENT Interconnected multi-column text picker.

ArkUI_ThemeColorMode

enum ArkUI_ThemeColorMode
Enum Description
ARKUI_THEME_COLOR_MODE_SYSTEM Following the system color mode.
ARKUI_THEME_COLOR_MODE_LIGHT Light color mode.
ARKUI_THEME_COLOR_MODE_DARK Dark color mode.

ArkUI_TransitionEdge

enum ArkUI_TransitionEdge

Description

Enumerates the slide-in and slide-out positions of the component from the screen edge during transition.

Since: 12

Enum Description
ARKUI_TRANSITION_EDGE_TOP Top edge of the window.
ARKUI_TRANSITION_EDGE_BOTTOM Bottom edge of the window.
ARKUI_TRANSITION_EDGE_START Left edge of the window.
ARKUI_TRANSITION_EDGE_END Right edge of the window.

ArkUI_VerticalAlignment

enum ArkUI_VerticalAlignment

Description

Enumerates the vertical alignment modes.

Since: 12

Enum Description
ARKUI_VERTICAL_ALIGNMENT_TOP Top aligned.
ARKUI_VERTICAL_ALIGNMENT_CENTER Aligned with the center. This is the default alignment mode.
ARKUI_VERTICAL_ALIGNMENT_BOTTOM Bottom aligned.

ArkUI_Visibility

enum ArkUI_Visibility

Description

Enumerates the visibility values.

Since: 12

Enum Description
ARKUI_VISIBILITY_VISIBLE Display
ARKUI_VISIBILITY_HIDDEN The component is hidden, and a placeholder is used for it in the layout.
ARKUI_VISIBILITY_NONE The component is hidden. It is not involved in the layout, and no placeholder is used for it.

ArkUI_WordBreak

enum ArkUI_WordBreak

Description

Enumerates the word break rules.

Since: 12

Enum Description
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).
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.
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.

ArkUI_XComponentType

enum ArkUI_XComponentType

Description

Defines the enumerated values of the XComponent type.

Since: 12

Enum Description
ARKUI_XCOMPONENT_TYPE_SURFACE The custom content of EGL/OpenGL ES and media data is displayed individually on the screen.
ARKUI_XCOMPONENT_TYPE_TEXTURE The custom content of EGL/OpenGL ES and media data is grouped and displayed together with content of the component.

Function Description

OH_ArkUI_AccessibilityState_Create()

ArkUI_AccessibilityState* OH_ArkUI_AccessibilityState_Create (void )

Description

Creates an accessibility state.

Since: 12

Returns

Returns 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.

OH_ArkUI_AccessibilityState_Dispose()

void OH_ArkUI_AccessibilityState_Dispose (ArkUI_AccessibilityState * state)

Description

Disposes of the pointer to an accessibility state.

Since: 12

Parameters

Name Description
state Pointer to an accessibility state object.

OH_ArkUI_AccessibilityState_GetCheckedState()

int32_t OH_ArkUI_AccessibilityState_GetCheckedState (ArkUI_AccessibilityState * state)

Description

Obtains the check box state of an accessibility state.

Since: 12

Parameters

Name Description
state Pointer to an accessibility state object.

Returns

Returns the check box state. The parameter type is ArkUI_AccessibilityCheckedState. The default value is ARKUI_ACCESSIBILITY_UNCHECKED. If a parameter error occurs, the default value is returned.

OH_ArkUI_AccessibilityState_IsDisabled()

int32_t OH_ArkUI_AccessibilityState_IsDisabled (ArkUI_AccessibilityState * state)

Description

Obtains whether an accessibility state is disabled.

Since: 12

Parameters

Name Description
state Pointer to an accessibility state object.

Returns

Returns 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.

OH_ArkUI_AccessibilityState_IsSelected()

int32_t OH_ArkUI_AccessibilityState_IsSelected (ArkUI_AccessibilityState * state)

Description

Obtains whether an accessibility state is selected.

Since: 12

Parameters

Name Description
state Pointer to an accessibility state object.

Returns

Returns 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.

OH_ArkUI_AccessibilityState_SetCheckedState()

void OH_ArkUI_AccessibilityState_SetCheckedState (ArkUI_AccessibilityState * state, int32_t checkedState )

Description

Sets the check box state of an accessibility state.

Since: 12

Parameters

Name Description
state Pointer to an accessibility state object.
checkedState Check box status. The parameter type is ArkUI_AccessibilityCheckedState. The default value is ARKUI_ACCESSIBILITY_UNCHECKED.

OH_ArkUI_AccessibilityState_SetDisabled()

void OH_ArkUI_AccessibilityState_SetDisabled (ArkUI_AccessibilityState * state, int32_t isDisabled )

Description

Sets whether an accessibility state is disabled.

Since: 12

Parameters

Name Description
state Pointer to an accessibility state object.
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.

OH_ArkUI_AccessibilityState_SetSelected()

void OH_ArkUI_AccessibilityState_SetSelected (ArkUI_AccessibilityState * state, int32_t isSelected )

Description

Sets whether an accessibility state is selected.

Since: 12

Parameters

Name Description
state Pointer to an accessibility state object.
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.

OH_ArkUI_AccessibilityValue_Create()

ArkUI_AccessibilityValue* OH_ArkUI_AccessibilityValue_Create (void )

Description

Creates an AccessibilityValue instance.

Since: 12

Returns

Returns the pointer to the created AccessibilityValue instance.

OH_ArkUI_AccessibilityValue_Dispose()

void OH_ArkUI_AccessibilityValue_Dispose (ArkUI_AccessibilityValue * value)

Description

Disposes of the pointer to an AccessibilityValue instance.

Since: 12

Parameters

Name Description
state Pointer to an AccessibilityValue instance.

OH_ArkUI_AccessibilityValue_GetCurrent()

int32_t OH_ArkUI_AccessibilityValue_GetCurrent (ArkUI_AccessibilityValue * value)

Description

Obtains the current accessibility value.

Since: 12

Parameters

Name Description
value Pointer to an AccessibilityValue instance.

Returns

Returns the current value based on the range component. The default value is -1. If a parameter error occurs, -1 is returned.

OH_ArkUI_AccessibilityValue_GetMax()

int32_t OH_ArkUI_AccessibilityValue_GetMax (ArkUI_AccessibilityValue * value)

Description

Obtains the maximum accessibility value.

Since: 12

Parameters

Name Description
value Pointer to an AccessibilityValue instance.

Returns

Returns the maximum value based on the range component. The default value is -1. If a parameter error occurs, -1 is returned.

OH_ArkUI_AccessibilityValue_GetMin()

int32_t OH_ArkUI_AccessibilityValue_GetMin (ArkUI_AccessibilityValue * value)

Description

Obtains the minimum accessibility value.

Since: 12

Parameters

Name Description
value Pointer to an AccessibilityValue instance.

Returns

Returns the minimum value based on the range component. The default value is -1. If a parameter error occurs, -1 is returned.

OH_ArkUI_AccessibilityValue_GetText()

const char* OH_ArkUI_AccessibilityValue_GetText (ArkUI_AccessibilityValue * value)

Description

Obtains the text description of an AccessibilityValue instance.

Since: 12

Parameters

Name Description
value Pointer to an AccessibilityValue instance.

Returns

Returns the text description. The default value is an empty string. If a parameter error occurs, a null pointer is returned.

OH_ArkUI_AccessibilityValue_SetCurrent()

void OH_ArkUI_AccessibilityValue_SetCurrent (ArkUI_AccessibilityValue * value, int32_t current )

Description

Sets the current accessibility value.

Since: 12

Parameters

Name Description
value Pointer to an AccessibilityValue instance.
current Current value based on the range component. The default value is -1.

OH_ArkUI_AccessibilityValue_SetMax()

void OH_ArkUI_AccessibilityValue_SetMax (ArkUI_AccessibilityValue * value, int32_t max )

Description

Sets the maximum accessibility value.

Since: 12

Parameters

Name Description
value Pointer to an AccessibilityValue instance.
max Maximum value based on the range component. The default value is -1.

OH_ArkUI_AccessibilityValue_SetMin()

void OH_ArkUI_AccessibilityValue_SetMin (ArkUI_AccessibilityValue * value, int32_t min )

Description

Sets the minimum accessibility value.

Since: 12

Parameters

Name Description
value Pointer to an AccessibilityValue instance.
min Minimum value based on the range component. The default value is -1.

OH_ArkUI_AccessibilityValue_SetText()

void OH_ArkUI_AccessibilityValue_SetText (ArkUI_AccessibilityValue * value, const char * text )

Description

Sets the text description of an AccessibilityValue instance.

Since: 12

Parameters

Name Description
value Pointer to an AccessibilityValue instance.
text Text description. The default value is an empty string.

OH_ArkUI_ActiveChildrenInfo_Destroy()

void OH_ArkUI_ActiveChildrenInfo_Destroy (ArkUI_ActiveChildrenInfo * handle)

Description

Destroys an ActiveChildrenInfo instance.

Since: 14

Parameters

Name Description
handle ActiveChildrenInfo instance to destroy.

OH_ArkUI_ActiveChildrenInfo_GetCount()

int32_t OH_ArkUI_ActiveChildrenInfo_GetCount (ArkUI_ActiveChildrenInfo * handle)

Description

Obtains the number of nodes in the specified ActiveChildrenInfo instance.

Since: 14

Parameters

Name Description
handle ActiveChildrenInfo instance from which to obtain the information.

OH_ArkUI_ActiveChildrenInfo_GetNodeByIndex()

ArkUI_NodeHandle OH_ArkUI_ActiveChildrenInfo_GetNodeByIndex (ArkUI_ActiveChildrenInfo * handle, int32_t index )

Description

Obtains the child node at the specified index in the specified ActiveChildrenInfo instance.

Since: 14

Parameters

Name Description
handle ActiveChildrenInfo instance from which to obtain the information.

OH_ArkUI_AlignmentRuleOption_Create()

ArkUI_AlignmentRuleOption* OH_ArkUI_AlignmentRuleOption_Create ()

Description

Creates an alignment rule configuration for this RelativeContainer component.

Since: 12

Returns

Alignment rule information.

OH_ArkUI_AlignmentRuleOption_Dispose()

void OH_ArkUI_AlignmentRuleOption_Dispose (ArkUI_AlignmentRuleOption * option)

Description

Disposes of an alignment rule configuration of this RelativeContainer component.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.

OH_ArkUI_AlignmentRuleOption_GetBiasHorizontal()

float OH_ArkUI_AlignmentRuleOption_GetBiasHorizontal (ArkUI_AlignmentRuleOption * option)

Description

Obtains the bias value in the horizontal direction.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.

Returns

Bias value in the horizontal direction.

OH_ArkUI_AlignmentRuleOption_GetBiasVertical()

float OH_ArkUI_AlignmentRuleOption_GetBiasVertical (ArkUI_AlignmentRuleOption * option)

Description

Obtains the bias value in the vertical direction.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.

Returns

Returns the bias value in the vertical direction.

OH_ArkUI_AlignmentRuleOption_GetBottomAlignment()

ArkUI_VerticalAlignment OH_ArkUI_AlignmentRuleOption_GetBottomAlignment (ArkUI_AlignmentRuleOption * option)

Description

Obtains the alignment mode in bottom alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.

Returns

Returns the alignment mode in bottom alignment parameters.

OH_ArkUI_AlignmentRuleOption_GetBottomId()

const char* OH_ArkUI_AlignmentRuleOption_GetBottomId (ArkUI_AlignmentRuleOption * option)

Description

Obtains the ID in bottom alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.

Returns

Returns the ID in bottom alignment parameters.

OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentHorizontal()

ArkUI_HorizontalAlignment OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentHorizontal (ArkUI_AlignmentRuleOption * option)

Description

Obtains the alignment mode in horizontal center alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.

Returns

Returns the alignment mode in horizontal center alignment parameters.

OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentVertical()

ArkUI_VerticalAlignment OH_ArkUI_AlignmentRuleOption_GetCenterAlignmentVertical (ArkUI_AlignmentRuleOption * option)

Description

Obtains the alignment mode in vertical center alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.

Returns

Returns the alignment mode in vertical center alignment parameters.

OH_ArkUI_AlignmentRuleOption_GetCenterIdHorizontal()

const char* OH_ArkUI_AlignmentRuleOption_GetCenterIdHorizontal (ArkUI_AlignmentRuleOption * option)

Description

Obtains the alignment mode in horizontal center alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.

Returns

Returns the alignment mode in horizontal center alignment parameters.

OH_ArkUI_AlignmentRuleOption_GetCenterIdVertical()

const char* OH_ArkUI_AlignmentRuleOption_GetCenterIdVertical (ArkUI_AlignmentRuleOption * option)

Description

Obtains the ID in vertical center alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.

Returns

Returns the ID in vertical center alignment parameters.

OH_ArkUI_AlignmentRuleOption_GetEndAlignment()

ArkUI_HorizontalAlignment OH_ArkUI_AlignmentRuleOption_GetEndAlignment (ArkUI_AlignmentRuleOption * option)

Description

Obtains the alignment mode in the right alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.

Returns

Returns the alignment mode in the right alignment parameters.

OH_ArkUI_AlignmentRuleOption_GetEndId()

const char* OH_ArkUI_AlignmentRuleOption_GetEndId (ArkUI_AlignmentRuleOption * option)

Description

Obtains the ID in the right alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.

Returns

Returns the ID in the right alignment parameters.

OH_ArkUI_AlignmentRuleOption_GetStartAlignment()

ArkUI_HorizontalAlignment OH_ArkUI_AlignmentRuleOption_GetStartAlignment (ArkUI_AlignmentRuleOption * option)

Description

Obtains the alignment mode in left alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.

Returns

Returns the alignment mode in left alignment parameters.

OH_ArkUI_AlignmentRuleOption_GetStartId()

const char* OH_ArkUI_AlignmentRuleOption_GetStartId (ArkUI_AlignmentRuleOption * option)

Description

Obtains the ID in the left alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.

Returns

Returns the ID in left alignment parameters.

OH_ArkUI_AlignmentRuleOption_GetTopAlignment()

ArkUI_VerticalAlignment OH_ArkUI_AlignmentRuleOption_GetTopAlignment (ArkUI_AlignmentRuleOption * option)

Description

Obtains the alignment mode in top alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.

Returns

Returns the alignment mode in top alignment parameters.

OH_ArkUI_AlignmentRuleOption_GetTopId()

const char* OH_ArkUI_AlignmentRuleOption_GetTopId (ArkUI_AlignmentRuleOption * option)

Description

Obtains the ID in top alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.

Returns

Returns the ID in top alignment parameters.

OH_ArkUI_AlignmentRuleOption_SetBiasHorizontal()

void OH_ArkUI_AlignmentRuleOption_SetBiasHorizontal (ArkUI_AlignmentRuleOption * option, float horizontal )

Description

Sets the bias value of the component in the horizontal direction under the anchor constraints.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.
horizontal Bias value in the horizontal direction.

OH_ArkUI_AlignmentRuleOption_SetBiasVertical()

void OH_ArkUI_AlignmentRuleOption_SetBiasVertical (ArkUI_AlignmentRuleOption * option, float vertical )

Description

Sets the bias value of the component in the vertical direction under the anchor constraints.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.
horizontal Bias value in the vertical direction.

OH_ArkUI_AlignmentRuleOption_SetBottom()

void OH_ArkUI_AlignmentRuleOption_SetBottom (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_VerticalAlignment alignment )

Description

Sets the bottom alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.
id ID of the anchor component.
value Alignment mode relative to the anchor component.

OH_ArkUI_AlignmentRuleOption_SetCenterHorizontal()

void OH_ArkUI_AlignmentRuleOption_SetCenterHorizontal (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_HorizontalAlignment alignment )

Description

Sets the horizontal center alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.
id ID of the anchor component.
value Alignment mode relative to the anchor component.

OH_ArkUI_AlignmentRuleOption_SetCenterVertical()

void OH_ArkUI_AlignmentRuleOption_SetCenterVertical (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_VerticalAlignment alignment )

Description

Sets the vertical center alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.
id ID of the anchor component.
value Alignment mode relative to the anchor component.

OH_ArkUI_AlignmentRuleOption_SetEnd()

void OH_ArkUI_AlignmentRuleOption_SetEnd (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_HorizontalAlignment alignment )

Description

Sets the right alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.
id ID of the anchor component.
value Alignment mode relative to the anchor component.

OH_ArkUI_AlignmentRuleOption_SetStart()

void OH_ArkUI_AlignmentRuleOption_SetStart (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_HorizontalAlignment alignment )

Description

Sets the left alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.
id ID of the anchor component.
value Alignment mode relative to the anchor component.

OH_ArkUI_AlignmentRuleOption_SetTop()

void OH_ArkUI_AlignmentRuleOption_SetTop (ArkUI_AlignmentRuleOption * option, const char * id, ArkUI_VerticalAlignment alignment )

Description

Sets the top alignment parameters.

Since: 12

Parameters

Name Description
option Pointer to an alignment rule configuration.
id ID of the anchor component.
value Alignment mode relative to the anchor component.

OH_ArkUI_AllowNodeAllDropDataTypes()

int32_t OH_ArkUI_AllowNodeAllDropDataTypes (ArkUI_NodeHandle node)

Description

Configures the specified component to allow any data types. This API resets the settings configured through OH_ArkUI_SetNodeAllowedDropDataTypes.

Since: 12

Parameters

Name Description
node Pointer to a component node.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimateOption_Create()

ArkUI_AnimateOption* OH_ArkUI_AnimateOption_Create ()

Description

Creates an animation configuration.

Since: 12

Returns

Returns the pointer to the created animation configuration.

OH_ArkUI_AnimateOption_Dispose()

void OH_ArkUI_AnimateOption_Dispose (ArkUI_AnimateOption * option)

Description

Disposes of an animation configuration.

Since: 12

OH_ArkUI_AnimateOption_GetCurve()

ArkUI_AnimationCurve OH_ArkUI_AnimateOption_GetCurve (ArkUI_AnimateOption * option)

Description

Obtains an animation curve.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Returns the animation curve.

OH_ArkUI_AnimateOption_GetDelay()

int32_t OH_ArkUI_AnimateOption_GetDelay (ArkUI_AnimateOption * option)

Description

Obtains the animation delay, in milliseconds.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Returns the animation delay.

OH_ArkUI_AnimateOption_GetDuration()

int32_t OH_ArkUI_AnimateOption_GetDuration (ArkUI_AnimateOption * option)

Description

Obtains the animation duration, in milliseconds.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Returns the animation duration.

OH_ArkUI_AnimateOption_GetExpectedFrameRateRange()

ArkUI_ExpectedFrameRateRange* OH_ArkUI_AnimateOption_GetExpectedFrameRateRange (ArkUI_AnimateOption * option)

Description

Obtains the expected frame rate range of an animation.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Returns the expected frame rate range.

OH_ArkUI_AnimateOption_GetICurve()

ArkUI_CurveHandle OH_ArkUI_AnimateOption_GetICurve (ArkUI_AnimateOption * option)

Description

Obtains the animation curve of an animation.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Returns the animation curve of the specified animation.

OH_ArkUI_AnimateOption_GetIterations()

int32_t OH_ArkUI_AnimateOption_GetIterations (ArkUI_AnimateOption * option)

Description

Obtains the number of times that an animation is played.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Returns the number of times that the animation is played.

OH_ArkUI_AnimateOption_GetPlayMode()

ArkUI_AnimationPlayMode OH_ArkUI_AnimateOption_GetPlayMode (ArkUI_AnimateOption * option)

Description

Obtains the playback mode of an animation.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Returns the animation playback mode.

OH_ArkUI_AnimateOption_GetTempo()

float OH_ArkUI_AnimateOption_GetTempo (ArkUI_AnimateOption * option)

Description

Obtains the playback speed of an animation.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Animation playback speed.

OH_ArkUI_AnimateOption_SetCurve()

void OH_ArkUI_AnimateOption_SetCurve (ArkUI_AnimateOption * option, ArkUI_AnimationCurve value )

Description

Sets the animation curve.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.
value Animation curve. Default value: ARKUI_CURVE_LINEAR.

OH_ArkUI_AnimateOption_SetDelay()

void OH_ArkUI_AnimateOption_SetDelay (ArkUI_AnimateOption * option, int32_t value )

Description

Sets the animation delay.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.
value Delay of animation playback.

OH_ArkUI_AnimateOption_SetDuration()

void OH_ArkUI_AnimateOption_SetDuration (ArkUI_AnimateOption * option, int32_t value )

Description

Sets the animation duration.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.
value Duration, in milliseconds.

OH_ArkUI_AnimateOption_SetExpectedFrameRateRange()

void OH_ArkUI_AnimateOption_SetExpectedFrameRateRange (ArkUI_AnimateOption * option, ArkUI_ExpectedFrameRateRange * value )

Description

Sets the expected frame rate range of the animation.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.
value Expected frame rate range of the animation.

OH_ArkUI_AnimateOption_SetICurve()

void OH_ArkUI_AnimateOption_SetICurve (ArkUI_AnimateOption * option, ArkUI_CurveHandle value )

Description

Sets the animation curve for an animation.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.
value Animation curve settings.

NOTE

This API is preferred over the value set by OH_ArkUI_AnimateOption_SetCurve.

OH_ArkUI_AnimateOption_SetIterations()

void OH_ArkUI_AnimateOption_SetIterations (ArkUI_AnimateOption * option, int32_t value )

Description

Sets the number of times that an animation is played.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.
value Number of times that the animation is played.

OH_ArkUI_AnimateOption_SetPlayMode()

void OH_ArkUI_AnimateOption_SetPlayMode (ArkUI_AnimateOption * option, ArkUI_AnimationPlayMode value )

Description

Sets the playback mode for an animation.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.
value Animation playback mode.

OH_ArkUI_AnimateOption_SetTempo()

void OH_ArkUI_AnimateOption_SetTempo (ArkUI_AnimateOption * option, float value )

Description

Sets the playback speed of an animation.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.
value Animation playback speed.

OH_ArkUI_Animator_Cancel()

int32_t OH_ArkUI_Animator_Cancel (ArkUI_AnimatorHandle animator)

Description

Cancels the animation of an animator.

Parameters

Name Description
animator Animator object.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_Animator_Finish()

int32_t OH_ArkUI_Animator_Finish (ArkUI_AnimatorHandle animator)

Description

Ends the animation of an animator.

Parameters

Name Description
animator Animator object.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_Animator_Pause()

int32_t OH_ArkUI_Animator_Pause (ArkUI_AnimatorHandle animator)

Description

Pauses the animation of an animator.

Parameters

Name Description
animator Animator object.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_Animator_Play()

int32_t OH_ArkUI_Animator_Play (ArkUI_AnimatorHandle animator)

Description

Starts the animation of an animator.

Parameters

Name Description
animator Animator object.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_Animator_ResetAnimatorOption()

int32_t OH_ArkUI_Animator_ResetAnimatorOption (ArkUI_AnimatorHandle animator, ArkUI_AnimatorOption * option )

Description

Resets an animator configuration.

Parameters

Name Description
animator Animator object.
option Pointer to an animation configuration.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_Animator_Reverse()

int32_t OH_ArkUI_Animator_Reverse (ArkUI_AnimatorHandle animator)

Description

Plays the animation of an animator in reverse order.

Parameters

Name Description
animator Animator object.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimatorEvent_GetUserData()

void* OH_ArkUI_AnimatorEvent_GetUserData (ArkUI_AnimatorEvent * event)

Description

Obtains the custom object in an animation event object.

Since: 12

Parameters

Name Description
event Animation event object.

Returns

Returns the custom object.

OH_ArkUI_AnimatorOnFrameEvent_GetUserData()

void* OH_ArkUI_AnimatorOnFrameEvent_GetUserData (ArkUI_AnimatorOnFrameEvent * event)

Description

Obtains the custom object in an animation event object.

Since: 12

Parameters

Name Description
event Animation event object.

Returns

Returns the custom object.

OH_ArkUI_AnimatorOnFrameEvent_GetValue()

float OH_ArkUI_AnimatorOnFrameEvent_GetValue (ArkUI_AnimatorOnFrameEvent * event)

Description

Obtains the current progress in an animation event object.

Since: 12

Parameters

Name Description
event Animation event object.

Returns

Returns the animation progress.

OH_ArkUI_AnimatorOption_Create()

ArkUI_AnimatorOption* OH_ArkUI_AnimatorOption_Create (int32_t keyframeSize)

Description

Creates an animator parameter object.

Since: 12

Parameters

Name Description
keyframeSize Number of keyframes.

NOTE

If 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.

Returns

Returns the pointer to the animator parameter object.

OH_ArkUI_AnimatorOption_Dispose()

void OH_ArkUI_AnimatorOption_Dispose (ArkUI_AnimatorOption * option)

Description

Disposes of an AnimatorOption object.

Since: 12

OH_ArkUI_AnimatorOption_GetBegin()

float OH_ArkUI_AnimatorOption_GetBegin (ArkUI_AnimatorOption * option)

Description

Obtains the interpolation start point of an animation.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Returns the start point of the animation interpolation.

OH_ArkUI_AnimatorOption_GetCurve()

ArkUI_CurveHandle OH_ArkUI_AnimatorOption_GetCurve (ArkUI_AnimatorOption * option)

Description

Obtains the interpolation curve of the animation of an animator.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Returns the interpolation curve of the animation.

OH_ArkUI_AnimatorOption_GetDelay()

int32_t OH_ArkUI_AnimatorOption_GetDelay (ArkUI_AnimatorOption * option)

Description

Obtains the delay for playing an animation.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Returns the delay for playing the animation, in milliseconds.

OH_ArkUI_AnimatorOption_GetDirection()

ArkUI_AnimationDirection OH_ArkUI_AnimatorOption_GetDirection (ArkUI_AnimatorOption * option)

Description

Obtains the playback direction of an animation.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Returns the animation playback direction.

OH_ArkUI_AnimatorOption_GetDuration()

int32_t OH_ArkUI_AnimatorOption_GetDuration (ArkUI_AnimatorOption * option)

Description

Obtains the duration for playing an animation.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Returns the duration for playing the animation, in milliseconds.

OH_ArkUI_AnimatorOption_GetEnd()

float OH_ArkUI_AnimatorOption_GetEnd (ArkUI_AnimatorOption * option)

Description

Obtains the interpolation end point of an animation.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Returns the interpolation end point of the animation.

OH_ArkUI_AnimatorOption_GetExpectedFrameRateRange()

ArkUI_ExpectedFrameRateRange* OH_ArkUI_AnimatorOption_GetExpectedFrameRateRange (ArkUI_AnimatorOption * option)

Description

Obtains the expected frame rate range of an animation.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Returns the pointer to the expected frame rate range object.

OH_ArkUI_AnimatorOption_GetFill()

ArkUI_AnimationFill OH_ArkUI_AnimatorOption_GetFill (ArkUI_AnimatorOption * option)

Description

Obtains whether the animator animation is restored to the initial state after being executed.

Since: 12

Parameters

Name Description
option Pointer to an animation configuration.

Returns

Returns whether the animator animation is restored to the initial state after being executed.

OH_ArkUI_AnimatorOption_GetIterations()

int32_t OH_ArkUI_AnimatorOption_GetIterations (ArkUI_AnimatorOption * option)

Description

Obtains the number of times that an animation is played.

Since: 12

Parameters

Name Description
option Pointer to an AnimatorOption object.

Returns

Number of times that the animation is played.

OH_ArkUI_AnimatorOption_GetKeyframeCurve()

ArkUI_CurveHandle OH_ArkUI_AnimatorOption_GetKeyframeCurve (ArkUI_AnimatorOption * option, int32_t index )

Description

Obtains the interpolation curve for a keyframe in the animation of an animator.

Since: 12

Parameters

Name Description
option Pointer to an AnimatorOption object.
index Keyframe index.

Returns

Returns the interpolation curve.

OH_ArkUI_AnimatorOption_GetKeyframeTime()

float OH_ArkUI_AnimatorOption_GetKeyframeTime (ArkUI_AnimatorOption * option, int32_t index )

Description

Obtains the keyframe time of an animation.

Since: 12

Parameters

Name Description
option Pointer to an AnimatorOption object.
index Keyframe index.

Returns

Keyframe time.

OH_ArkUI_AnimatorOption_GetKeyframeValue()

float OH_ArkUI_AnimatorOption_GetKeyframeValue (ArkUI_AnimatorOption * option, int32_t index )

Description

Obtains the keyframe value of an animation.

Since: 12

Parameters

Name Description
option Pointer to an AnimatorOption object.
index Keyframe index.

Returns

Keyframe value.

OH_ArkUI_AnimatorOption_RegisterOnCancelCallback()

int32_t OH_ArkUI_AnimatorOption_RegisterOnCancelCallback (ArkUI_AnimatorOption * option, void * userData, void(*)(ArkUI_AnimatorEvent *event) callback )

Description

Sets the callback invoked when the animation playback is canceled.

Parameters

Name Description
option Pointer to an animation configuration.
userData Custom parameter.
callback Callback used to return the result.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimatorOption_RegisterOnFinishCallback()

int32_t OH_ArkUI_AnimatorOption_RegisterOnFinishCallback (ArkUI_AnimatorOption * option, void * userData, void(*)(ArkUI_AnimatorEvent *event) callback )

Description

Sets the callback invoked when the animation playback is complete.

Parameters

Name Description
option Pointer to an animation configuration.
userData Custom parameter.
callback Callback used to return the result.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimatorOption_RegisterOnFrameCallback()

int32_t OH_ArkUI_AnimatorOption_RegisterOnFrameCallback (ArkUI_AnimatorOption * option, void * userData, void(*)(ArkUI_AnimatorOnFrameEvent *event) callback )

Description

Sets the callback invoked when the animator receives a frame.

Parameters

Name Description
option Pointer to an animation configuration.
userData Custom parameter.
callback Callback used to return the result.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimatorOption_RegisterOnRepeatCallback()

int32_t OH_ArkUI_AnimatorOption_RegisterOnRepeatCallback (ArkUI_AnimatorOption * option, void * userData, void(*)(ArkUI_AnimatorEvent *event) callback )

Description

Sets the callback invoked when the animation playback is repeated.

Parameters

Name Description
option Pointer to an animation configuration.
userData Custom parameter.
callback Callback used to return the result.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimatorOption_SetBegin()

int32_t OH_ArkUI_AnimatorOption_SetBegin (ArkUI_AnimatorOption * option, float value )

Description

Sets the interpolation start point for the animation of an animator.

Parameters

Name Description
option Pointer to an AnimatorOption object.
value Start point of the animation interpolation.

NOTE

This API does not take effect when the animation is a keyframe animation.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimatorOption_SetCurve()

int32_t OH_ArkUI_AnimatorOption_SetCurve (ArkUI_AnimatorOption * option, ArkUI_CurveHandle value )

Description

Sets the interpolation curve for the animation of an animator.

Parameters

Name Description
option Pointer to an AnimatorOption object.
value Interpolation curve of the animation. Default value: ARKUI_CURVE_LINEAR.

NOTE

The springCurve, springMotion, responsiveSpringMotion, and interpolatingSpring customCurve curves are not supported.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimatorOption_SetDelay()

int32_t OH_ArkUI_AnimatorOption_SetDelay (ArkUI_AnimatorOption * option, int32_t value )

Description

Sets the delay of animation playback, in milliseconds.

Parameters

Name Description
option Pointer to an AnimatorOption object.
value Animation delay, in milliseconds.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimatorOption_SetDirection()

int32_t OH_ArkUI_AnimatorOption_SetDirection (ArkUI_AnimatorOption * option, ArkUI_AnimationDirection value )

Description

Sets the playback direction.

Parameters

Name Description
option Pointer to an AnimatorOption object.
value Animation playback direction.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimatorOption_SetDuration()

int32_t OH_ArkUI_AnimatorOption_SetDuration (ArkUI_AnimatorOption * option, int32_t value )

Description

Sets the duration of an animation, in milliseconds.

Parameters

Name Description
option Pointer to an AnimatorOption object.
value Duration for playing the animation, in milliseconds.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimatorOption_SetEnd()

int32_t OH_ArkUI_AnimatorOption_SetEnd (ArkUI_AnimatorOption * option, float value )

Description

Sets the interpolation end point for the animation of an animator.

Parameters

Name Description
option Pointer to an AnimatorOption object.
value End point of animation interpolation.

NOTE

This API does not take effect when the animation is a keyframe animation.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimatorOption_SetExpectedFrameRateRange()

int32_t OH_ArkUI_AnimatorOption_SetExpectedFrameRateRange (ArkUI_AnimatorOption * option, ArkUI_ExpectedFrameRateRange * value )

Description

Sets the expected frame rate range of an animation.

Parameters

Name Description
option Pointer to an AnimatorOption object.
value Expected frame rate range.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimatorOption_SetFill()

int32_t OH_ArkUI_AnimatorOption_SetFill (ArkUI_AnimatorOption * option, ArkUI_AnimationFill value )

Description

Sets whether the animator animation is restored to the initial state after being executed.

Parameters

Name Description
option Pointer to an AnimatorOption object.
value Whether to restore the animation to the initial state after the animation is executed.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimatorOption_SetIterations()

int32_t OH_ArkUI_AnimatorOption_SetIterations (ArkUI_AnimatorOption * option, int32_t value )

Description

Sets 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.

Parameters

Name Description
option Pointer to an AnimatorOption object.
value Number of times that the animation is played.

NOTE

If this parameter is set to a negative value other than -1, the value is invalid. In this case, the animation is played once.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimatorOption_SetKeyframe()

int32_t OH_ArkUI_AnimatorOption_SetKeyframe (ArkUI_AnimatorOption * option, float time, float value, int32_t index )

Description

Sets the keyframe parameters of an animation.

Parameters

Name Description
option Pointer to an AnimatorOption object.
time Keyframe time. Value range: [0, 1]. The value must be in ascending order.
value Keyframe value.
index Keyframe index.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_AnimatorOption_SetKeyframeCurve()

int32_t OH_ArkUI_AnimatorOption_SetKeyframeCurve (ArkUI_AnimatorOption * option, ArkUI_CurveHandle value, int32_t index )

Description

Sets the keyframe curve type for the animation of an animator.

Parameters

Name Description
option Pointer to an AnimatorOption object.
value Animation interpolation curve.
index Keyframe index.

NOTE

The springCurve, springMotion, responsiveSpringMotion, and interpolatingSpring customCurve curves are not supported.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_BarrierOption_Create()

ArkUI_BarrierOption* OH_ArkUI_BarrierOption_Create (int32_t size)

Description

Creates a barrier configuration for this RelativeContainer component.

Since: 12

Parameters

Name Description
size Number of barriers.

Returns

Returns the barrier configuration.

OH_ArkUI_BarrierOption_Dispose()

void OH_ArkUI_BarrierOption_Dispose (ArkUI_BarrierOption * barrierStyle)

Description

Disposes of a barrier configuration.

Since: 12

Parameters

Name Description
barrierStyle Pointer to a barrier configuration.

OH_ArkUI_BarrierOption_GetDirection()

ArkUI_BarrierDirection OH_ArkUI_BarrierOption_GetDirection (ArkUI_BarrierOption * barrierStyle, int32_t index )

Description

Obtains the direction of a barrier.

Since: 12

Parameters

Name Description
barrierStyle Pointer to a barrier configuration.
index Index of the barrier.

Returns

Returns the direction of the barrier.

OH_ArkUI_BarrierOption_GetId()

const char* OH_ArkUI_BarrierOption_GetId (ArkUI_BarrierOption * barrierStyle, int32_t index )

Description

Obtains the ID of a barrier.

Since: 12

Parameters

Name Description
barrierStyle Pointer to a barrier configuration.
index Index of the barrier.

Returns

Returns the ID of the barrier.

OH_ArkUI_BarrierOption_GetReferencedId()

const char* OH_ArkUI_BarrierOption_GetReferencedId (ArkUI_BarrierOption * barrierStyle, int32_t index, int32_t referencedIndex )

Description

Obtains the referenced components of a barrier.

Since: 12

Parameters

Name Description
barrierStyle Pointer to a barrier configuration.
index Index of the barrier.
referencedIndex Index of the referenced component ID.

Returns

Returns the referenced components of the barrier.

OH_ArkUI_BarrierOption_GetReferencedIdSize()

int32_t OH_ArkUI_BarrierOption_GetReferencedIdSize (ArkUI_BarrierOption * barrierStyle, int32_t index )

Description

Obtains the number of referenced components of a barrier.

Since: 12

Parameters

Name Description
barrierStyle Pointer to a barrier configuration.
index Index of the barrier.

Returns

Returns the number of referenced components of the barrier.

OH_ArkUI_BarrierOption_SetDirection()

void OH_ArkUI_BarrierOption_SetDirection (ArkUI_BarrierOption * barrierStyle, ArkUI_BarrierDirection value, int32_t index )

Description

Sets the direction of a barrier.

Since: 12

Parameters

Name Description
barrierStyle Pointer to a barrier configuration.
value Direction.
index Index of the barrier.

OH_ArkUI_BarrierOption_SetId()

void OH_ArkUI_BarrierOption_SetId (ArkUI_BarrierOption * barrierStyle, const char * value, int32_t index )

Description

Sets the ID of a barrier.

Since: 12

Parameters

Name Description
barrierStyle Pointer to a barrier configuration.
value ID of the barrier, which must be unique and cannot be the same as the name of any component in the container.
index Index of the barrier.

OH_ArkUI_BarrierOption_SetReferencedId()

void OH_ArkUI_BarrierOption_SetReferencedId (ArkUI_BarrierOption * barrierStyle, const char * value, int32_t index )

Description

Sets the referenced components of a barrier.

Since: 12

Parameters

Name Description
barrierStyle Pointer to a barrier configuration.
value Referenced component IDs.
index Index of the barrier.

OH_ArkUI_ConvertToHtml()

const char* OH_ArkUI_ConvertToHtml (ArkUI_StyledString_Descriptor * descriptor)

Description

Converts styled string information into HTML.

Since: 14

Parameters

Name Description
descriptor Pointer to an ArkUI_StyledString_Descriptor object.

Returns

Returns 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.

OH_ArkUI_CreateAsymmetricTransitionEffect()

ArkUI_TransitionEffect* OH_ArkUI_CreateAsymmetricTransitionEffect (ArkUI_TransitionEffect * appear, ArkUI_TransitionEffect * disappear )

Description

Creates an asymmetric transition effect.

Since: 12

Parameters

Name Description
appear Transition effect for appearance.
disappear Transition effect for disappearance.

NOTE

If the asymmetric function is not used for constructing TransitionEffect, the transition effect takes effect for both appearance and disappearance of the component.

Returns

Returns the asymmetric transition effect; returns NULL if a parameter error occurs.

OH_ArkUI_CreateDragActionWithContext()

ArkUI_DragAction* OH_ArkUI_CreateDragActionWithContext (ArkUI_ContextHandle uiContext)

Description

Creates a drag action object for the specified UI instance.

Since: 12

Parameters

Name Description
uiContext Pointer to the UI instance object.

Returns

Returns the pointer to the created drag action object; returns null if the operation fails.

OH_ArkUI_CreateDragActionWithNode()

ArkUI_DragAction* OH_ArkUI_CreateDragActionWithNode (ArkUI_NodeHandle node)

Description

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.

Since: 12

Parameters

Name Description
node Pointer to a component node.

Returns

Returns the pointer to the created drag action object; returns null if the operation fails.

OH_ArkUI_CreateDragPreviewOption()

ArkUI_DragPreviewOption* OH_ArkUI_CreateDragPreviewOption (void )

Description

Creates an ArkUI_DragPreviewOption object.

Since: 12

Returns

ArkUI_DragPreviewOption object.

OH_ArkUI_CreateMovementTransitionEffect()

ArkUI_TransitionEffect* OH_ArkUI_CreateMovementTransitionEffect (ArkUI_TransitionEdge move)

Description

Creates a movement object for component transition.

Since: 12

Parameters

Name Description
move Panning type.

Returns

Returns the movement object created for component transition; returns NULL if a parameter error occurs.

OH_ArkUI_CreateOpacityTransitionEffect()

ArkUI_TransitionEffect* OH_ArkUI_CreateOpacityTransitionEffect (float opacity)

Description

Creates an opacity object for component transition.

Since: 12

Parameters

Name Description
opacity Opacity. The value range is [0, 1].

NOTE

If 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.

Returns

Returns the created opacity object for component transition.

OH_ArkUI_CreateRotationTransitionEffect()

ArkUI_TransitionEffect* OH_ArkUI_CreateRotationTransitionEffect (ArkUI_RotationOptions * rotate)

Description

Creates a rotation object for component transition.

Since: 12

Parameters

Name Description
rotate Rotation parameter object during component transition.

Returns

Returns the rotation object created for component transition; returns NULL if a parameter error occurs.

OH_ArkUI_CreateScaleTransitionEffect()

ArkUI_TransitionEffect* OH_ArkUI_CreateScaleTransitionEffect (ArkUI_ScaleOptions * scale)

Description

Creates a scaling transition effect object.

Since: 12

Parameters

Name Description
scale Scaling settings for component transition.

Returns

Returns the created scaling transition effect object; returns NULL if a parameter error occurs.

OH_ArkUI_CreateTranslationTransitionEffect()

ArkUI_TransitionEffect* OH_ArkUI_CreateTranslationTransitionEffect (ArkUI_TranslationOptions * translate)

Description

Creates a translation transition effect object.

Since: 12

Parameters

Name Description
translate Translation settings for component transition.

Returns

Returns the created translation transition effect object; returns NULL if a parameter error occurs.

OH_ArkUI_Curve_CreateCubicBezierCurve()

ArkUI_CurveHandle OH_ArkUI_Curve_CreateCubicBezierCurve (float x1, float y1, float x2, float y2 )

Description

Creates a cubic Bezier curve.

Parameters

Name Description
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.
y1 Y coordinate of the first point on the Bezier curve.
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.
y2 Y coordinate of the second point on the Bezier curve.

Returns

Returns the pointer to the interpolation object of the curve; returns NULL if a parameter error occurs.

OH_ArkUI_Curve_CreateCurveByType()

ArkUI_CurveHandle OH_ArkUI_Curve_CreateCurveByType (ArkUI_AnimationCurve curve)

Description

Implements initialization for the interpolation curve, which is used to create an interpolation curve based on the input parameter.

Parameters

Name Description
curve Curve type.

Returns

Returns the pointer to the interpolation object of the curve; returns NULL if a parameter error occurs.

OH_ArkUI_Curve_CreateCustomCurve()

ArkUI_CurveHandle OH_ArkUI_Curve_CreateCustomCurve (void * userData, float(*)(float fraction, void *userdata) interpolate )

Description

Creates a custom curve.

Parameters

Name Description
userData Custom data.
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.

Returns

Returns the pointer to the interpolation object of the curve; returns NULL if a parameter error occurs.

OH_ArkUI_Curve_CreateInterpolatingSpring()

ArkUI_CurveHandle OH_ArkUI_Curve_CreateInterpolatingSpring (float velocity, float mass, float stiffness, float damping )

Description

Creates an interpolating spring curve animated from 0 to 1. The actual animation value is calculated based on the curve.

Parameters

Name Description
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.
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.
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.
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.

NOTE

The animation duration is subject to the curve parameters, rather than the duration parameter in animation or animateTo.

Returns

Returns the pointer to the interpolation object of the curve; returns NULL if a parameter error occurs.

OH_ArkUI_Curve_CreateResponsiveSpringMotion()

ArkUI_CurveHandle OH_ArkUI_Curve_CreateResponsiveSpringMotion (float response, float dampingFraction, float overlapDuration )

Description

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.

Parameters

Name Description
response Duration of one complete oscillation.
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.
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.

NOTE

The animation duration is subject to the curve parameters, rather than the duration parameter in animation or animateTo.

Returns

Returns the pointer to the interpolation object of the curve; returns NULL if a parameter error occurs.

OH_ArkUI_Curve_CreateSpringCurve()

ArkUI_CurveHandle OH_ArkUI_Curve_CreateSpringCurve (float velocity, float mass, float stiffness, float damping )

Description

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.

Parameters

Name Description
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.
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.
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.
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.

Returns

Returns the pointer to the interpolation object of the curve; returns NULL if a parameter error occurs.

OH_ArkUI_Curve_CreateSpringMotion()

ArkUI_CurveHandle OH_ArkUI_Curve_CreateSpringMotion (float response, float dampingFraction, float overlapDuration )

Description

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.

Parameters

Name Description
response Duration of one complete oscillation.
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.
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.

NOTE

The animation duration is subject to the curve parameters, rather than the duration parameter in animation or animateTo.

Returns

Returns the pointer to the interpolation object of the curve; returns NULL if a parameter error occurs.

OH_ArkUI_Curve_CreateStepsCurve()

ArkUI_CurveHandle OH_ArkUI_Curve_CreateStepsCurve (int32_t count, bool end )

Description

Creates a step curve.

Parameters

Name Description
count Number of tiers. The value must be a positive integer. Value range: [1, +∞).
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.

Returns

Returns the pointer to the interpolation object of the curve; returns NULL if a parameter error occurs.

OH_ArkUI_Curve_DisposeCurve()

void OH_ArkUI_Curve_DisposeCurve (ArkUI_CurveHandle curveHandle)

Description

Disposes of a custom curve.

Parameters

Name Description
curve Returns the pointer to the interpolation object of the curve;

OH_ArkUI_CustomProperty_Destroy()

void OH_ArkUI_CustomProperty_Destroy (ArkUI_CustomProperty * handle)

Description

Destroys a CustomProperty instance.

Since: 14

Parameters

Name Description
handle CustomProperty instance to destroy.

OH_ArkUI_CustomProperty_GetStringValue()

const char* OH_ArkUI_CustomProperty_GetStringValue (ArkUI_CustomProperty * handle)

Description

Obtains the value of a custom property.

Since: 14

Parameters

Name Description
handle Pointer to the custom property object.

Returns

Value of the custom property.

OH_ArkUI_CustomSpanDrawInfo_Create()

ArkUI_CustomSpanDrawInfo* OH_ArkUI_CustomSpanDrawInfo_Create (void )

Description

Creates drawing information for this custom span.

Since: 12

Returns

Returns a CustomSpanDrawInfo instance. If a null pointer is returned, the memory may be insufficient.

OH_ArkUI_CustomSpanDrawInfo_Dispose()

void OH_ArkUI_CustomSpanDrawInfo_Dispose (ArkUI_CustomSpanDrawInfo * info)

Description

Disposes of drawing information for this custom span.

Since: 12

Parameters

Name Description
info Pointer to the drawing information of a custom span.

OH_ArkUI_CustomSpanDrawInfo_GetBaseline()

float OH_ArkUI_CustomSpanDrawInfo_GetBaseline (ArkUI_CustomSpanDrawInfo * info)

Description

Obtains the baseline offset of the custom span relative to the mounted component.

Since: 12

Parameters

Name Description
info Pointer to the drawing information of a custom span.

Returns

Returns the baseline offset. If a parameter error occurs, 0.0f is returned. A possible cause is that mandatory parameters are left unspecified.

OH_ArkUI_CustomSpanDrawInfo_GetLineBottom()

float OH_ArkUI_CustomSpanDrawInfo_GetLineBottom (ArkUI_CustomSpanDrawInfo * info)

Description

Obtains the bottom margin of the custom span relative to the mounted component.

Since: 12

Parameters

Name Description
info Pointer to the drawing information of a custom span.

Returns

Returns the bottom margin. If a parameter error occurs, 0.0f is returned. A possible cause is that mandatory parameters are left unspecified.

OH_ArkUI_CustomSpanDrawInfo_GetLineTop()

float OH_ArkUI_CustomSpanDrawInfo_GetLineTop (ArkUI_CustomSpanDrawInfo * info)

Description

Obtains the top margin of the custom span relative to the mounted component.

Since: 12

Parameters

Name Description
info Pointer to the drawing information of a custom span.

Returns

Returns the top margin. If a parameter error occurs, 0.0f is returned. A possible cause is that mandatory parameters are left unspecified.

OH_ArkUI_CustomSpanDrawInfo_GetXOffset()

float OH_ArkUI_CustomSpanDrawInfo_GetXOffset (ArkUI_CustomSpanDrawInfo * info)

Description

Obtains the x-axis offset of the custom span relative to the mounted component.

Since: 12

Parameters

Name Description
info Pointer to the drawing information of a custom span.

Returns

Returns the x-axis offset. If a parameter error occurs, 0.0f is returned. A possible cause is that mandatory parameters are left unspecified.

OH_ArkUI_CustomSpanMeasureInfo_Create()

ArkUI_CustomSpanMeasureInfo* OH_ArkUI_CustomSpanMeasureInfo_Create (void )

Description

Creates measurement information for this custom span.

Since: 12

Returns

Returns a CustomSpanMeasureInfo instance. If a null pointer is returned, the memory may be insufficient.

OH_ArkUI_CustomSpanMeasureInfo_Dispose()

void OH_ArkUI_CustomSpanMeasureInfo_Dispose (ArkUI_CustomSpanMeasureInfo * info)

Description

Disposes of measurement information of a custom span.

Since: 12

Parameters

Name Description
info Pointer to the measurement information of a custom span.

OH_ArkUI_CustomSpanMeasureInfo_GetFontSize()

float OH_ArkUI_CustomSpanMeasureInfo_GetFontSize (ArkUI_CustomSpanMeasureInfo * info)

Description

Obtains the font size of the parent text node of a custom span.

Since: 12

Parameters

Name Description
info Pointer to the measurement information of a custom span.

Returns

Returns 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.

OH_ArkUI_CustomSpanMetrics_Create()

ArkUI_CustomSpanMetrics* OH_ArkUI_CustomSpanMetrics_Create (void )

Description

Creates measurement metrics for this custom span.

Since: 12

Returns

Returns a CustomSpanMetrics instance. If a null pointer is returned, the memory may be insufficient.

OH_ArkUI_CustomSpanMetrics_Dispose()

void OH_ArkUI_CustomSpanMetrics_Dispose (ArkUI_CustomSpanMetrics * metrics)

Description

Disposes of measurement metrics of this custom span.

Since: 12

Parameters

Name Description
metrics Returns a CustomSpanMetrics instance.

OH_ArkUI_CustomSpanMetrics_SetHeight()

int32_t OH_ArkUI_CustomSpanMetrics_SetHeight (ArkUI_CustomSpanMetrics * metrics, float height )

Description

Sets the height for a custom span.

Since: 12

Parameters

Name Description
metrics Returns a CustomSpanMetrics instance.
height Height, in vp.

Returns

Returns 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.

OH_ArkUI_CustomSpanMetrics_SetWidth()

int32_t OH_ArkUI_CustomSpanMetrics_SetWidth (ArkUI_CustomSpanMetrics * metrics, float width )

Description

Sets the width for a custom span.

Since: 12

Parameters

Name Description
metrics Returns a CustomSpanMetrics instance.
width Width, in vp.

Returns

Returns 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.

OH_ArkUI_DialogDismissEvent_GetDismissReason()

int32_t OH_ArkUI_DialogDismissEvent_GetDismissReason (ArkUI_DialogDismissEvent * event)

Description

Obtains the dismissal reason from a dialog box dismiss event object.

Since: 12

Parameters

Name Description
event Pointer to a dialog box dismiss event object.

Returns

Returns the dismissal reason. Returns -1 if an exception occurs.
DIALOG_DISMISS_BACK_PRESS: touching the Back button, swiping left or right on the screen, or pressing the Esc key.
DIALOG_DISMISS_TOUCH_OUTSIDE: touching the mask.
DIALOG_DISMISS_CLOSE_BUTTON: touching the Close button.
DIALOG_DISMISS_SLIDE_DOWN: sliding down.

OH_ArkUI_DialogDismissEvent_GetUserData()

void* OH_ArkUI_DialogDismissEvent_GetUserData (ArkUI_DialogDismissEvent * event)

Description

Obtains the pointer to user data in a dialog box dismiss event object.

Since: 12

Parameters

Name Description
event Pointer to a dialog box dismiss event object.

Returns

Returns the pointer to user data.

OH_ArkUI_DialogDismissEvent_SetShouldBlockDismiss()

void OH_ArkUI_DialogDismissEvent_SetShouldBlockDismiss (ArkUI_DialogDismissEvent * event, bool shouldBlockDismiss )

Description

Sets whether to block the system behavior of dismissing a dialog box.

Since: 12

Parameters

Name Description
event Pointer to a dialog box dismiss event object.
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.

OH_ArkUI_DisallowNodeAnyDropDataTypes()

int32_t OH_ArkUI_DisallowNodeAnyDropDataTypes (ArkUI_NodeHandle node)

Description

The configuration component is not allowed to accept any data type. This interface resets the data type configured through OH_ArkUI_SetNodeAllowedDropDataTypes.

Since: 12

Parameters

Name Description
node Pointer to a component node.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragAction_Dispose()

void OH_ArkUI_DragAction_Dispose (ArkUI_DragAction * dragAction)

Description

Disposes of an ArkUI_DragAction object.

Since: 12

Parameters

Name Description
dragAction Pointer to the target drag action object.

OH_ArkUI_DragAction_RegisterStatusListener()

int32_t OH_ArkUI_DragAction_RegisterStatusListener (ArkUI_DragAction * dragAction, void * userData, void(*)(ArkUI_DragAndDropInfo *dragAndDropInfo, void *userData) listener )

Description

Registers a drag status listener. This listener can be used to check whether the data is successfully received and processed.

Since: 12

Parameters

Name Description
dragAction Pointer to the target drag action object.
userData Custom user data.
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.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragAction_SetData()

int32_t OH_ArkUI_DragAction_SetData (ArkUI_DragAction * dragAction, OH_UdmfData * data )

Description

Sets the drag data.

Since: 12

Parameters

Name Description
dragAction Pointer to the target drag action object.
data Drag data.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragAction_SetDragPreviewOption()

int32_t OH_ArkUI_DragAction_SetDragPreviewOption (ArkUI_DragAction * dragAction, ArkUI_DragPreviewOption * option )

Description

Sets an ArkUI_DragPreviewOption object for the specified drag action object.

Since: 12

Parameters

Name Description
dragAction Pointer to the target drag action object.
option Custom parameters.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragAction_SetPixelMaps()

int32_t OH_ArkUI_DragAction_SetPixelMaps (ArkUI_DragAction * dragAction, OH_PixelmapNative * pixelmapArray[], int32_t size )

Description

Sets the drag previews for a drag action.

Since: 12

Parameters

Name Description
dragAction Pointer to the target drag action object.
pixelmapArray Drag the bitmap array of the follower map.
size Number of drag-and-drop images.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragAction_SetPointerId()

int32_t OH_ArkUI_DragAction_SetPointerId (ArkUI_DragAction * dragAction, int32_t pointer )

Description

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.

Since: 12

Parameters

Name Description
dragAction Pointer to the target drag action object.
pointer Pointer ID. The value ranges from 0 to 9.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragAction_SetTouchPointX()

int32_t OH_ArkUI_DragAction_SetTouchPointX (ArkUI_DragAction * dragAction, float x )

Description

Sets the touch point relative to the upper left corner of the first drag preview (pixel map).

Since: 12

Parameters

Name Description
dragAction Pointer to the target drag action object.
x X value of the hand point coordinate.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragAction_SetTouchPointY()

int32_t OH_ArkUI_DragAction_SetTouchPointY (ArkUI_DragAction * dragAction, float y )

Description

Sets the touch point relative to the upper left corner of the first drag preview (pixel map).

Since: 12

Parameters

Name Description
dragAction Pointer to the target drag action object.
y Y value of the hand point coordinate.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragAction_UnregisterStatusListener()

void OH_ArkUI_DragAction_UnregisterStatusListener (ArkUI_DragAction * dragAction)

Description

Unregisters a drag status listener.

Since: 12

Parameters

Name Description
dragAction Pointer to the target drag action object.

OH_ArkUI_DragAndDropInfo_GetDragEvent()

ArkUI_DragEvent* OH_ArkUI_DragAndDropInfo_GetDragEvent (ArkUI_DragAndDropInfo * dragAndDropInfo)

Description

Obtains a drag event based on the specified drag and drop information. The drag event can then be used to obtain the drag result.

Since: 12

Parameters

Name Description
dragAndDropInfo Drag-related information returned by the drag status listener.

Returns

Returns an ArkUI_DragEvent object; returns null if an error occurs.

OH_ArkUI_DragAndDropInfo_GetDragStatus()

ArkUI_DragStatus OH_ArkUI_DragAndDropInfo_GetDragStatus (ArkUI_DragAndDropInfo * dragAndDropInfo)

Description

Obtains the drag status of a drag action.

Since: 12

Parameters

Name Description
dragAndDropInfo Drag-related information returned by the drag status listener.

Returns

Returns an ArkUI_DragStatus object; returns ArkUI_DRAG_STATUS_UNKNOWN if an error occurs.

OH_ArkUI_DragEvent_DisableDefaultDropAnimation()

int32_t OH_ArkUI_DragEvent_DisableDefaultDropAnimation (ArkUI_DragEvent * event, bool disable )

Description

Sets whether to disable the default drop animation, which is enabled by default. Use this API to apply a custom drop animation.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.
disable Whether to disable the default drop animation. The value true means to disable the default drop animation, and false means the opposite.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragEvent_GetDataTypes()

int32_t OH_ArkUI_DragEvent_GetDataTypes (ArkUI_DragEvent * event, char ** result[], int32_t length )

Description

Obtains the type list of drag data types from a drag event.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.
char **result[] Returns the type list of the dragged data. You need to create a string array first.
length The total length of the array must be greater than or equal to the number obtained by using OH_ArkUI_DragEvent_GetDataTypesCount.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragEvent_GetDataTypesCount()

int32_t OH_ArkUI_DragEvent_GetDataTypesCount (ArkUI_DragEvent * event, int32_t * count )

Description

Obtains the number of drag data types from a drag event.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.
count Output parameter, which returns the number of types of dragged data.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragEvent_GetDragResult()

int32_t OH_ArkUI_DragEvent_GetDragResult (ArkUI_DragEvent * event, ArkUI_DragResult * result )

Description

Obtains the drag and drop result from the drag event.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.
result Output parameter, which returns the drag result corresponding to the drag event.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragEvent_GetModifierKeyStates()

int32_t OH_ArkUI_DragEvent_GetModifierKeyStates (ArkUI_DragEvent * event, int64_t * keys )

Description

Obtains the pressed status of modifier keys from a drag event.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.
keys Returns the modifier key combination that is currently pressed. The application can determine the modifier key combination through bitwise operations.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragEvent_GetPreviewRectHeight()

float OH_ArkUI_DragEvent_GetPreviewRectHeight (ArkUI_DragEvent * event)

Description

Obtains the height of a drag preview from a drag event.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.

Returns

Returns the height of the drag preview, in px; returns the default value 0 if the input parameter is invalid.

OH_ArkUI_DragEvent_GetPreviewRectWidth()

float OH_ArkUI_DragEvent_GetPreviewRectWidth (ArkUI_DragEvent * event)

Description

Obtains the width of a drag preview from a drag event.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.

Returns

Returns the width of the drag preview, in px; returns the default value 0 if the input parameter is invalid.

OH_ArkUI_DragEvent_GetPreviewTouchPointX()

float OH_ArkUI_DragEvent_GetPreviewTouchPointX (ArkUI_DragEvent * event)

Description

Obtains the X coordinate of the touch point for a drag preview from a drag event.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.

Returns

Returns the X coordinate of the touch point, in px; returns the default value 0 if the input parameter is invalid.

OH_ArkUI_DragEvent_GetPreviewTouchPointY()

float OH_ArkUI_DragEvent_GetPreviewTouchPointY (ArkUI_DragEvent * event)

Description

Obtains the Y coordinate of the touch point for a drag preview from a drag event.

Since: 12

Parameters

Name Description
event ArkUI_DragEvent event pointer. The unit is PX. If the input parameter is invalid, the default value 0 is returned.

Returns

float returns the y-axis coordinate of the drag and hand point.

OH_ArkUI_DragEvent_GetTouchPointXToDisplay()

float OH_ArkUI_DragEvent_GetTouchPointXToDisplay (ArkUI_DragEvent * event)

Description

Obtains the X coordinate of the touch point relative to the display from a drag event.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.

Returns

Returns the X coordinate of the touch point relative to the display, in px; returns the default value 0 if the input parameter is invalid.

OH_ArkUI_DragEvent_GetTouchPointXToWindow()

float OH_ArkUI_DragEvent_GetTouchPointXToWindow (ArkUI_DragEvent * event)

Description

Obtains the X coordinate of the touch point relative to the window from a drag event.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.

Returns

Returns the X coordinate of the touch point relative to the window, in px; returns the default value 0 if the input parameter is invalid.

OH_ArkUI_DragEvent_GetTouchPointYToDisplay()

float OH_ArkUI_DragEvent_GetTouchPointYToDisplay (ArkUI_DragEvent * event)

Description

Obtains the Y coordinate of the touch point relative to the display from a drag event.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.

Returns

Returns the Y coordinate of the touch point relative to the display, in px; returns the default value 0 if the input parameter is invalid.

OH_ArkUI_DragEvent_GetTouchPointYToWindow()

float OH_ArkUI_DragEvent_GetTouchPointYToWindow (ArkUI_DragEvent * event)

Description

Obtains the Y coordinate of the touch point relative to the window from a drag event.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.

Returns

Returns the Y coordinate of the touch point relative to the window, in px; returns the default value 0 if the input parameter is invalid.

OH_ArkUI_DragEvent_GetUdmfData()

int32_t OH_ArkUI_DragEvent_GetUdmfData (ArkUI_DragEvent * event, OH_UdmfData * data )

Description

Obtain the default drag-and-drop data from ArkUI_DragEvent.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.
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.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragEvent_GetVelocity()

float OH_ArkUI_DragEvent_GetVelocity (ArkUI_DragEvent * event)

Description

Obtains the dragging velocity along the main axis.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.

Returns

Returns the dragging velocity along the main axis, in px; returns the default value 0 if the input parameter is invalid.

OH_ArkUI_DragEvent_GetVelocityX()

float OH_ArkUI_DragEvent_GetVelocityX (ArkUI_DragEvent * event)

Description

Obtains the dragging velocity along the x-axis.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.

Returns

Returns the dragging velocity along the x-axis, in px; returns the default value 0 if the input parameter is invalid.

OH_ArkUI_DragEvent_GetVelocityY()

float OH_ArkUI_DragEvent_GetVelocityY (ArkUI_DragEvent * event)

Description

Obtains the dragging velocity along the y-axis.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.

Returns

Returns the dragging velocity along the y-axis, in px; returns the default value 0 if the input parameter is invalid.

OH_ArkUI_DragEvent_SetData()

int32_t OH_ArkUI_DragEvent_SetData (ArkUI_DragEvent * event, OH_UdmfData * data )

Description

Sets drag data for a drag event.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.
data Drag data.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragEvent_SetDragResult()

int32_t OH_ArkUI_DragEvent_SetDragResult (ArkUI_DragEvent * event, ArkUI_DragResult result )

Description

Sets the result for a drag event.

Since: 12

Parameters

Name Description
event Pointer to an ArkUI_DragEvent object.
result Drag the data processing result.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragEvent_SetSuggestedDropOperation()

int32_t OH_ArkUI_DragEvent_SetSuggestedDropOperation (ArkUI_DragEvent * event, ArkUI_DropProposal proposal )

Description

Sets the data processing mode.

Since: 12

Parameters

Name Description
proposal Recommended data processing mode
proposal Type of the badge display status.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragPreviewOption_Dispose()

void OH_ArkUI_DragPreviewOption_Dispose (ArkUI_DragPreviewOption * option)

Description

Disposes of an ArkUI_DragPreviewOption object.

Since: 12

Parameters

Name Description
option Custom parameters.

OH_ArkUI_DragPreviewOption_SetBadgeNumber()

int32_t OH_ArkUI_DragPreviewOption_SetBadgeNumber (ArkUI_DragPreviewOption * option, uint32_t forcedNumber )

Description

Sets the count on the badge. The settings will overwrite the value in the SetDragPreviewNumberBadgeEnabled API.

Since: 12

Parameters

Name Description
option Custom parameters.
forcedNumber Number of corner marks.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragPreviewOption_SetDefaultAnimationBeforeLiftingEnabled()

int32_t OH_ArkUI_DragPreviewOption_SetDefaultAnimationBeforeLiftingEnabled (ArkUI_DragPreviewOption * option, bool enabled )

Description

Sets whether to enable the default animation on a click or touch.

Since: 12

Parameters

Name Description
option Custom parameters.
enabled Whether to enable the default click effect.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragPreviewOption_SetDefaultRadiusEnabled()

int32_t OH_ArkUI_DragPreviewOption_SetDefaultRadiusEnabled (ArkUI_DragPreviewOption * option, bool enabled )

Description

Sets whether to enable the default corner radius effect for an ArkUI_DragPreviewOption object. The effect is enabled by default.

Since: 12

Parameters

Name Description
option Custom parameters.
enabled Whether to enable the default corner radius effect.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragPreviewOption_SetDefaultShadowEnabled()

int32_t OH_ArkUI_DragPreviewOption_SetDefaultShadowEnabled (ArkUI_DragPreviewOption * option, bool enabled )

Description

Sets whether to enable the default shadow effect for an ArkUI_DragPreviewOption object. The effect is enabled by default.

Since: 12

Parameters

Name Description
option Custom parameters.
enabled Whether to enable the default shadow effect.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragPreviewOption_SetNumberBadgeEnabled()

int32_t OH_ArkUI_DragPreviewOption_SetNumberBadgeEnabled (ArkUI_DragPreviewOption * option, bool enabled )

Description

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.

Since: 12

Parameters

Name Description
option Custom parameters.
enabled Whether to enable the badge.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DragPreviewOption_SetScaleMode()

int32_t OH_ArkUI_DragPreviewOption_SetScaleMode (ArkUI_DragPreviewOption * option, ArkUI_DragPreviewScaleMode scaleMode )

Description

Sets the scale mode for an ArkUI_DragPreviewOption object.

Since: 12

Parameters

Name Description
option Custom parameters.
scaleMode Scale mode to set.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_DrawableDescriptor_CreateFromAnimatedPixelMap()

ArkUI_DrawableDescriptor* OH_ArkUI_DrawableDescriptor_CreateFromAnimatedPixelMap (OH_PixelmapNativeHandle * array, int32_t size )

Description

Creates a DrawableDescriptor object from an array of PixelMap objects.

Since: 12

Parameters

Name Description
array Pointer to the array of PixelMap objects.
size Size of the PixelMap object array.

Returns

Returns the pointer to the created DrawableDescriptor object.

OH_ArkUI_DrawableDescriptor_CreateFromPixelMap()

ArkUI_DrawableDescriptor* OH_ArkUI_DrawableDescriptor_CreateFromPixelMap (OH_PixelmapNativeHandle pixelMap)

Description

Creates a DrawableDescriptor object from a PixelMap object.

Since: 12

Parameters

Name Description
pixelMap Pointer to the PixelMap object.

Returns

Returns the pointer to the created DrawableDescriptor object.

OH_ArkUI_DrawableDescriptor_Dispose()

void OH_ArkUI_DrawableDescriptor_Dispose (ArkUI_DrawableDescriptor * drawableDescriptor)

Description

Disposes of the pointer to a DrawableDescriptor object.

Since: 12

Parameters

Name Description
drawableDescriptor Pointer to a DrawableDescriptor object.

OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArray()

OH_PixelmapNativeHandle* OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArray (ArkUI_DrawableDescriptor * drawableDescriptor)

Description

Obtains an array of PixelMap objects for playing an animation.

Since: 12

Parameters

Name Description
drawableDescriptor Pointer to a DrawableDescriptor object.

Returns

Pointer to the PixelMap image array.

OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArraySize()

int32_t OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArraySize (ArkUI_DrawableDescriptor * drawableDescriptor)

Description

Obtains an array of PixelMap objects for playing an animation.

Since: 12

Parameters

Name Description
drawableDescriptor Pointer to a DrawableDescriptor object.

Returns

Size of the PixelMap image array.

OH_ArkUI_DrawableDescriptor_GetAnimationDuration()

int32_t OH_ArkUI_DrawableDescriptor_GetAnimationDuration (ArkUI_DrawableDescriptor * drawableDescriptor)

Description

Obtains the total playback duration of a PixelMap image array.

Since: 12

Parameters

Name Description
drawableDescriptor Pointer to a DrawableDescriptor object.

Returns

Total playback duration, in milliseconds.

OH_ArkUI_DrawableDescriptor_GetAnimationIteration()

int32_t OH_ArkUI_DrawableDescriptor_GetAnimationIteration (ArkUI_DrawableDescriptor * drawableDescriptor)

Description

Obtains the number of times that a PixelMap object array is played.

Since: 12

Parameters

Name Description
drawableDescriptor Pointer to a DrawableDescriptor object.

Returns

Returns the number of playback times.

OH_ArkUI_DrawableDescriptor_GetStaticPixelMap()

OH_PixelmapNativeHandle OH_ArkUI_DrawableDescriptor_GetStaticPixelMap (ArkUI_DrawableDescriptor * drawableDescriptor)

Description

Obtains the pointer to a PixelMap object.

Since: 12

Parameters

Name Description
drawableDescriptor Pointer to a DrawableDescriptor object.

Returns

Pointer to the PixelMap object.

OH_ArkUI_DrawableDescriptor_SetAnimationDuration()

void OH_ArkUI_DrawableDescriptor_SetAnimationDuration (ArkUI_DrawableDescriptor * drawableDescriptor, int32_t duration )

Description

Sets the total playback duration of a PixelMap image array.

Since: 12

Parameters

Name Description
drawableDescriptor Pointer to a DrawableDescriptor object.
duration Total playback duration, in milliseconds.

OH_ArkUI_DrawableDescriptor_SetAnimationIteration()

void OH_ArkUI_DrawableDescriptor_SetAnimationIteration (ArkUI_DrawableDescriptor * drawableDescriptor, int32_t iteration )

Description

Sets the number of times that a pixel map image array is played.

Since: 12

Parameters

Name Description
drawableDescriptor Pointer to a DrawableDescriptor object.
iterations Number of playback times.

OH_ArkUI_DrawContext_GetCanvas()

void* OH_ArkUI_DrawContext_GetCanvas (ArkUI_DrawContext * context)

Description

Obtains the drawing canvas pointer, which can be converted into the OH_Drawing_Canvas pointer of the graphics library for drawing.

Since: 12

Parameters

Name Description
context Drawing context.

Returns

Returns the pointer to the canvas for drawing.

OH_ArkUI_DrawContext_GetSize()

ArkUI_IntSize OH_ArkUI_DrawContext_GetSize (ArkUI_DrawContext * context)

Description

Obtains the size of a drawing area.

Since: 12

Parameters

Name Description
context Drawing context.

Returns

Returns the size of the drawing area.

OH_ArkUI_GestureEvent_GetActionType()

ArkUI_GestureEventActionType OH_ArkUI_GestureEvent_GetActionType (const ArkUI_GestureEvent * event)

Description

Obtains the gesture event type.

Since: 12

Parameters

Name Description
event Gesture event.

Returns

Returns the gesture event type.

OH_ArkUI_GestureEvent_GetNode()

ArkUI_NodeHandle OH_ArkUI_GestureEvent_GetNode (const ArkUI_GestureEvent * event)

Description

Obtains the ArkUI component to which the gesture is bound.

Since: 12

Parameters

Name Description
event Gesture event.

Returns

Returns the ArkUI component.

OH_ArkUI_GestureEvent_GetRawInputEvent()

const ArkUI_UIInputEvent* OH_ArkUI_GestureEvent_GetRawInputEvent (const ArkUI_GestureEvent * event)

Description

Obtains gesture input.

Since: 12

Parameters

Name Description
event Gesture event.

Returns

Returns the pointer to the input event of the gesture event.

OH_ArkUI_GestureEvent_GetResponseNode()

ArkUI_NodeHandle OH_ArkUI_GestureEvent_GetResponseNode (ArkUI_GestureEvent * event)

Description

Obtains the node that responds to the gesture.

Since: 12

Parameters

Name Description
event Gesture event.

Returns

Returns the pointer to the node if the node exists; returns NULL otherwise.

OH_ArkUI_GestureEventTargetInfo_IsScrollBegin()

int32_t OH_ArkUI_GestureEventTargetInfo_IsScrollBegin (ArkUI_GestureEventTargetInfo * info, bool * ret )

Description

Obtains whether this scroll container is scrolled to the top.

Since: 12

Parameters

Name Description
info Gesture event target information.
ret Obtains whether this scroll container is scrolled to the top.

Returns

Returns 0 if the operation is successful. Returns 401 if a parameter error occurs. Returns 180001 if the component is not a scroll container.

OH_ArkUI_GestureEventTargetInfo_IsScrollEnd()

int32_t OH_ArkUI_GestureEventTargetInfo_IsScrollEnd (ArkUI_GestureEventTargetInfo * info, bool * ret )

Description

Obtains whether this scroll container is scrolled to the bottom.

Since: 12

Parameters

Name Description
info Gesture event target information.
ret Obtains whether this scroll container is scrolled to the bottom.

Returns

Returns 0 if the operation is successful. Returns 401 if a parameter error occurs. Returns 180001 if the component is not a scroll container.

OH_ArkUI_GestureInterruptInfo_GetGestureEvent()

ArkUI_GestureEvent* OH_ArkUI_GestureInterruptInfo_GetGestureEvent (const ArkUI_GestureInterruptInfo * event)

Description

Obtains the pointer to the interrupted gesture event.

Since: 12

Parameters

Name Description
event Interrupt callback event.

Returns

Returns the pointer to the interrupted gesture event.

OH_ArkUI_GestureInterruptInfo_GetRecognizer()

ArkUI_GestureRecognizer* OH_ArkUI_GestureInterruptInfo_GetRecognizer (const ArkUI_GestureInterruptInfo * event)

Description

Returns the pointer to interrupted gesture recognizer.

Since: 12

Parameters

Name Description
event Interrupt callback event.

Returns

Pointer to the interrupted gesture.

OH_ArkUI_GestureInterruptInfo_GetSystemFlag()

bool OH_ArkUI_GestureInterruptInfo_GetSystemFlag (const ArkUI_GestureInterruptInfo * event)

Description

Checks whether a gesture is a built-in gesture of the component.

Since: 12

Parameters

Name Description
event Gesture interrupt callback event.

Returns

true: built-in gestures; false: non-built-in gestures.

OH_ArkUI_GestureInterruptInfo_GetSystemRecognizerType()

int32_t OH_ArkUI_GestureInterruptInfo_GetSystemRecognizerType (const ArkUI_GestureInterruptInfo * event)

Description

Obtains the type of the system gesture to trigger.

Since: 12

Parameters

Name Description
event Interrupt callback event.

Returns

Returns the type of the system gesture to trigger. If the gesture to trigger is not a system gesture, -1 is returned.

OH_ArkUI_GetContextByNode()

ArkUI_ContextHandle OH_ArkUI_GetContextByNode (ArkUI_NodeHandle node)

Description

Obtains the pointer to the UI context object of the specified node.

Since: 12

Parameters

Name Description
node Specified node.

Returns

Returns the pointer to the UI context object.

OH_ArkUI_GetContextFromNapiValue()

int32_t OH_ArkUI_GetContextFromNapiValue (napi_env env, napi_value value, ArkUI_ContextHandle * context )

Description

Obtains a UIContext object on the ArkTS side and maps it to an ArkUI_ContextHandle object on the native side.

Since: 12

Parameters

Name Description
env Pointer to the NAPI environment.
value Context object created on the ArkTS side.
context ArkUI_ContextHandle pointer.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_GetDrawableDescriptorFromNapiValue()

int32_t OH_ArkUI_GetDrawableDescriptorFromNapiValue (napi_env env, napi_value value, ArkUI_DrawableDescriptor ** drawableDescriptor )

Description

Maps a DrawableDescriptor object on the ArkTS side to an ArkUI_DrawableDescriptor object on the native side.

Since: 12

Parameters

Name Description
env Pointer to the NAPI environment.
value DrawableDescriptor object created on the ArkTS side.
drawableDescriptor Object that receives the pointer to the ArkUI_DrawableDescriptor object.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_GetDrawableDescriptorFromResourceNapiValue()

int32_t OH_ArkUI_GetDrawableDescriptorFromResourceNapiValue (napi_env env, napi_value value, ArkUI_DrawableDescriptor ** drawableDescriptor )

Description

Maps an $r resource object on the ArkTS side to an ArkUI_DrawableDescriptor object on the native side.

Since: 12

Parameters

Name Description
env Pointer to the NAPI environment.
value $r resource object created on ArkTS.
drawableDescriptor Object that receives the pointer to the ArkUI_DrawableDescriptor object.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_GetGestureBindNodeId()

int32_t OH_ArkUI_GetGestureBindNodeId (ArkUI_GestureRecognizer * recognizer, char * nodeId, int32_t size, int32_t * result )

Description

Obtains the ID of the component linked to a gesture recognizer.

Since: 12

Parameters

Name Description
recognizer Pointer to the gesture recognizer.
nodeId ID of a component.
size Size of the storage area.
result Length of the string to be copied.

Returns

Returns 0 if the operation is successful. Returns 401 if a parameter error occurs. Returns 180002 if the buffer is not large enough.

OH_ArkUI_GetGestureEventTargetInfo()

int32_t OH_ArkUI_GetGestureEventTargetInfo (ArkUI_GestureRecognizer * recognizer, ArkUI_GestureEventTargetInfo ** info )

Description

Obtains the information about a gesture event target.

Since: 12

Parameters

Name Description
recognizer Pointer to the gesture recognizer.
info Gesture event target information.

Returns

Returns 0 if the operation is successful. Returns 401 if a parameter error occurs.

OH_ArkUI_GetGestureRecognizerEnabled()

bool OH_ArkUI_GetGestureRecognizerEnabled (ArkUI_GestureRecognizer * recognizer)

Description

Obtains the enabled state of a gesture recognizer.

Since: 12

Parameters

Name Description
recognizer Pointer to the gesture recognizer.

Returns

true: enabled false: disabled

OH_ArkUI_GetGestureRecognizerState()

int32_t OH_ArkUI_GetGestureRecognizerState (ArkUI_GestureRecognizer * recognizer, ArkUI_GestureRecognizerState * state )

Description

Obtains the state of a gesture recognizer.

Since: 12

Parameters

Name Description
recognizer Pointer to the gesture recognizer.
state Status of the gesture recognizer.

Returns

Returns 0 if the operation is successful. Returns 401 if a parameter error occurs.

OH_ArkUI_GetGestureTag()

int32_t OH_ArkUI_GetGestureTag (ArkUI_GestureRecognizer * recognizer, char * buffer, int32_t bufferSize, int32_t * result )

Description

Obtains the mark of the gesture recognizer.

Since: 12

Parameters

Name Description
recognizer Pointer to the gesture recognizer.
buffer Storage zone
bufferSize Size of the storage area.
result Length of the string to be copied.

Returns

Returns 0 if the operation is successful. Returns 401 if a parameter error occurs. Returns 180002 if the buffer is not large enough.

OH_ArkUI_GetNavDestinationId()

ArkUI_ErrorCode OH_ArkUI_GetNavDestinationId (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )

Description

Obtains the ID of the NavDestination component where the specified node is located.

Since: 12

Parameters

Name Description
node Specified node.
buffer buffer. NavDestinationID is written to this memory area.
bufferSize Pointer to the buffer size.
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.

Returns

Returns 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.

OH_ArkUI_GetNavDestinationIndex()

ArkUI_ErrorCode OH_ArkUI_GetNavDestinationIndex (ArkUI_NodeHandle node, int32_t * index )

Description

Obtains the index of the NavDestination component where the specified node is located in the navigation stack.

Since: 12

Parameters

Name Description
node Specified node.
index Returns the index, starting from 0.

Returns

Returns 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.

OH_ArkUI_GetNavDestinationName()

ArkUI_ErrorCode OH_ArkUI_GetNavDestinationName (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )

Description

Obtains the name of the NavDestination component where the specified node is located.

Since: 12

Parameters

Name Description
node Specified node.
buffer Buffer. The queried NavDestination name is written to this memory area.
bufferSize Pointer to the buffer size.
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.

Returns

Returns 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.

OH_ArkUI_GetNavDestinationNameByIndex()

ArkUI_ErrorCode OH_ArkUI_GetNavDestinationNameByIndex (ArkUI_NodeHandle node, int32_t index, char * buffer, int32_t bufferSize, int32_t * writeLength )

Description

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.

Since: 12

Parameters

Name Description
node Specified node.
index Index of the queried NavDestination in the stack.
buffer Buffer. The name of the queried page is written to this memory area.
bufferSize Pointer to the buffer size.
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.

Returns

Returns 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.

OH_ArkUI_GetNavDestinationParam()

napi_value OH_ArkUI_GetNavDestinationParam (ArkUI_NodeHandle node)

Description

Obtains the parameters of the NavDestination component where the specified node is located.

Since: 12

Parameters

Name Description
node Specified node.

Returns

Parameter object.

OH_ArkUI_GetNavDestinationState()

ArkUI_ErrorCode OH_ArkUI_GetNavDestinationState (ArkUI_NodeHandle node, ArkUI_NavDestinationState * state )

Description

Obtains the state of the NavDestination component where the specified node is located.

Since: 12

Parameters

Name Description
node Specified node.
state The status value of NavDestination is written back to this parameter.

Returns

The 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.

OH_ArkUI_GetNavigationId()

ArkUI_ErrorCode OH_ArkUI_GetNavigationId (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )

Description

Obtains the ID of the Navigation component where the specified node is located.

Since: 12

Parameters

Name Description
node Specified node.
buffer buffer. The NavigationID is written to this memory area.
bufferSize Pointer to the buffer size.
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.

Returns

Returns 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.

OH_ArkUI_GetNavStackLength()

ArkUI_ErrorCode OH_ArkUI_GetNavStackLength (ArkUI_NodeHandle node, int32_t * length )

Description

Obtains the length of the navigation stack where the specified node is located.

Since: 12

Parameters

Name Description
node Specified node.
length Length of the stack. The result, if obtained successfully, is written back to this parameter.

Returns

Returns 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.

OH_ArkUI_GetNodeContentFromNapiValue()

int32_t OH_ArkUI_GetNodeContentFromNapiValue (napi_env env, napi_value value, ArkUI_NodeContentHandle * content )

Description

Obtains a NodeContent object on the ArkTS side and maps it to an ArkUI_NodeContentHandle object on the native side.

Since: 12

Parameters

Name Description
env Pointer to the NAPI environment.
value NodeContent object created on ArkTS.
context ArkUI_NodeContentHandle pointer.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_GetNodeHandleFromNapiValue()

int32_t OH_ArkUI_GetNodeHandleFromNapiValue (napi_env env, napi_value frameNode, ArkUI_NodeHandle * handle )

Description

Obtains a FrameNode object on the ArkTS side and maps it to an ArkUI_NodeHandle object on the native side.

Since: 12

Parameters

Name Description
env Pointer to the NAPI environment.
frameNode FrameNode object created on the ArkTS side.
handle ArkUI_NodeHandle pointer.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_GetPanGestureDirectionMask()

int32_t OH_ArkUI_GetPanGestureDirectionMask (ArkUI_GestureRecognizer * recognizer, ArkUI_GestureDirectionMask * directionMask )

Description

Obtains the direction of a pan gesture.

Since: 12

Parameters

Name Description
recognizer Pointer to the gesture recognizer.
directionMask Sliding direction of the sliding gesture.

Returns

Returns 0 if the operation is successful. Returns 401 if a parameter error occurs.

OH_ArkUI_GetResponseRecognizersFromInterruptInfo()

int32_t OH_ArkUI_GetResponseRecognizersFromInterruptInfo (const ArkUI_GestureInterruptInfo * event, ArkUI_GestureRecognizerHandleArray * responseChain, int32_t * count )

Description

Obtains information about a gesture response chain.

Since: 12

Parameters

Name Description
event Gesture interrupt callback event.
responseChain Gesture recognizer on the response chain component.
count Number of gesture recognizers on the response chain component.

Returns

Returns 0 if the operation is successful. Returns 401 if a parameter error occurs.

OH_ArkUI_GetRouterPageId()

ArkUI_ErrorCode OH_ArkUI_GetRouterPageId (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )

Description

Obtains the ID of the page where the specified node is located.

Since: 12

Parameters

Name Description
node Specified node.
buffer buffer. Page Id is written to this memory area.
bufferSize Pointer to the buffer size.
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.

Returns

Returns 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.

OH_ArkUI_GetRouterPageIndex()

ArkUI_ErrorCode OH_ArkUI_GetRouterPageIndex (ArkUI_NodeHandle node, int32_t * index )

Description

Obtains the index of the page where the specified node is located in the page stack for routing.

Since: 12

Parameters

Name Description
node Specified node.
index Returns the index, starting from 1.

Returns

Returns 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.

OH_ArkUI_GetRouterPageName()

ArkUI_ErrorCode OH_ArkUI_GetRouterPageName (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )

Description

Obtains the name of the page where the specified node is located.

Since: 12

Parameters

Name Description
node Specified node.
buffer Buffer. The page name is written to this memory area.
bufferSize Pointer to the buffer size.
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.

Returns

Returns 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.

OH_ArkUI_GetRouterPagePath()

ArkUI_ErrorCode OH_ArkUI_GetRouterPagePath (ArkUI_NodeHandle node, char * buffer, int32_t bufferSize, int32_t * writeLength )

Description

Obtains the path to the page where the specified node is located.

Since: 12

Parameters

Name Description
node Specified node.
buffer buffer. Page Path is written to this memory area.
bufferSize Pointer to the buffer size.
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.

Returns

Returns 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.

OH_ArkUI_GetRouterPageState()

ArkUI_ErrorCode OH_ArkUI_GetRouterPageState (ArkUI_NodeHandle node, ArkUI_RouterPageState * state )

Description

Obtains the state of the page where the specified node is located.

Since: 12

Parameters

Name Description
node Specified node.
state The status value of Router Page is written back to this parameter.

Returns

The error code ARKUI_ERROR_CODE_NO_ERROR is returned. The ARKUI_ERROR_CODE_GET_INFO_FAILED fails to query information.

OH_ArkUI_GuidelineOption_Create()

ArkUI_GuidelineOption* OH_ArkUI_GuidelineOption_Create (int32_t size)

Description

Creates a guideline configuration for this RelativeContainer.

Since: 12

Parameters

Name Description
size Number of guidelines.

Returns

Returns the guideline configuration.

OH_ArkUI_GuidelineOption_Dispose()

void OH_ArkUI_GuidelineOption_Dispose (ArkUI_GuidelineOption * guideline)

Description

Destroys auxiliary line information.

Since: 12

Parameters

Name Description
guideline Pointer to a guideline configuration.

OH_ArkUI_GuidelineOption_GetDirection()

ArkUI_Axis OH_ArkUI_GuidelineOption_GetDirection (ArkUI_GuidelineOption * guideline, int32_t index )

Description

Obtains the direction of a guideline.

Since: 12

Parameters

Name Description
guideline Pointer to a guideline configuration.
index Index of the guideline.

Returns

Returns the direction of the guideline.

OH_ArkUI_GuidelineOption_GetId()

const char* OH_ArkUI_GuidelineOption_GetId (ArkUI_GuidelineOption * guideline, int32_t index )

Description

Obtains the ID of a guideline.

Since: 12

Parameters

Name Description
guideline Pointer to a guideline configuration.
index Index of the guideline.

Returns

Returns the ID of the guideline.

OH_ArkUI_GuidelineOption_GetPositionEnd()

float OH_ArkUI_GuidelineOption_GetPositionEnd (ArkUI_GuidelineOption * guideline, int32_t index )

Description

Obtains the distance between a guideline and the right or bottom of the container.

Since: 12

Parameters

Name Description
guideline Pointer to a guideline configuration.
index Index of the guideline.

Returns

Distance between the guideline and the right or bottom of the container.

OH_ArkUI_GuidelineOption_GetPositionStart()

float OH_ArkUI_GuidelineOption_GetPositionStart (ArkUI_GuidelineOption * guideline, int32_t index )

Description

Obtains the distance between a guideline and the left or top of the container.

Since: 12

Parameters

Name Description
guideline Pointer to a guideline configuration.
index Index of the guideline.

Returns

Distance between the guideline and the left or top of the container.

OH_ArkUI_GuidelineOption_SetDirection()

void OH_ArkUI_GuidelineOption_SetDirection (ArkUI_GuidelineOption * guideline, ArkUI_Axis value, int32_t index )

Description

Sets the direction of a guideline.

Since: 12

Parameters

Name Description
guideline Pointer to a guideline configuration.
value Direction.
index Index of the guideline.

OH_ArkUI_GuidelineOption_SetId()

void OH_ArkUI_GuidelineOption_SetId (ArkUI_GuidelineOption * guideline, const char * value, int32_t index )

Description

Sets the ID of a guideline.

Since: 12

Parameters

Name Description
guideline Pointer to a guideline configuration.
value ID of the guideline, which must be unique and cannot be the same as the name of any component in the container.
index Index of the guideline.

OH_ArkUI_GuidelineOption_SetPositionEnd()

void OH_ArkUI_GuidelineOption_SetPositionEnd (ArkUI_GuidelineOption * guideline, float value, int32_t index )

Description

Sets the distance between a guideline and the right or bottom of the container.

Since: 12

Parameters

Name Description
guideline Pointer to a guideline configuration.
value Distance between the guideline and the right or bottom of the container.
index Index of the guideline.

OH_ArkUI_GuidelineOption_SetPositionStart()

void OH_ArkUI_GuidelineOption_SetPositionStart (ArkUI_GuidelineOption * guideline, float value, int32_t index )

Description

Sets the distance between a guideline and the left or top of the container.

Since: 12

Parameters

Name Description
guideline Pointer to a guideline configuration.
value Distance between the guideline and the left or top of the container.
index Index of the guideline.

OH_ArkUI_ImageAnimatorFrameInfo_CreateFromDrawableDescriptor()

ArkUI_ImageAnimatorFrameInfo* OH_ArkUI_ImageAnimatorFrameInfo_CreateFromDrawableDescriptor (ArkUI_DrawableDescriptor * drawable)

Description

Creates an image frame information object based on a DrawableDescriptor object, with the image format being Resource or PixelMap.

Since: 12

Parameters

Name Description
drawable Pointer to an ArkUI_DrawableDescriptor object created using Resource or PixelMap.

Returns

Returns the pointer to the created frame image object.

OH_ArkUI_ImageAnimatorFrameInfo_CreateFromString()

ArkUI_ImageAnimatorFrameInfo* OH_ArkUI_ImageAnimatorFrameInfo_CreateFromString (char * src)

Description

Creates an image frame information object based on an image path, with the image format being SVG, PNG, or JPG.

Since: 12

Parameters

Name Description
src Image path.

Returns

Returns the pointer to the created frame image object.

OH_ArkUI_ImageAnimatorFrameInfo_Dispose()

void OH_ArkUI_ImageAnimatorFrameInfo_Dispose (ArkUI_ImageAnimatorFrameInfo * imageInfo)

Description

Disposes of the pointer to an image frame information object.

Since: 12

Parameters

Name Description
imageInfo Pointer to the frame image object.

OH_ArkUI_ImageAnimatorFrameInfo_GetDuration()

int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetDuration (ArkUI_ImageAnimatorFrameInfo * imageInfo)

Description

Obtains the playback duration of an image.

Since: 12

Parameters

Name Description
imageInfo Pointer to the frame image object.

Returns

Returns the playback duration of the image, in milliseconds. If imageInfo is a null pointer, 0 is returned.

OH_ArkUI_ImageAnimatorFrameInfo_GetHeight()

int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetHeight (ArkUI_ImageAnimatorFrameInfo * imageInfo)

Description

Obtains the image height.

Since: 12

Parameters

Name Description
imageInfo Pointer to the frame image object.

Returns

Returns the image height, in PX. If imageInfo is a null pointer, 0 is returned.

OH_ArkUI_ImageAnimatorFrameInfo_GetLeft()

int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetLeft (ArkUI_ImageAnimatorFrameInfo * imageInfo)

Description

Obtains the horizontal coordinate of an image relative to the upper left corner of the component.

Since: 12

Parameters

Name Description
imageInfo Pointer to the frame image object.

Returns

Returns 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.

OH_ArkUI_ImageAnimatorFrameInfo_GetTop()

int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetTop (ArkUI_ImageAnimatorFrameInfo * imageInfo)

Description

Obtains the vertical coordinate of an image relative to the upper left corner of the component.

Since: 12

Parameters

Name Description
imageInfo Pointer to the frame image object.

Returns

Returns 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.

OH_ArkUI_ImageAnimatorFrameInfo_GetWidth()

int32_t OH_ArkUI_ImageAnimatorFrameInfo_GetWidth (ArkUI_ImageAnimatorFrameInfo * imageInfo)

Description

Obtains the image width.

Since: 12

Parameters

Name Description
imageInfo Pointer to the frame image object.

Returns

Returns the image width, in PX. If imageInfo is a null pointer, 0 is returned.

OH_ArkUI_ImageAnimatorFrameInfo_SetDuration()

void OH_ArkUI_ImageAnimatorFrameInfo_SetDuration (ArkUI_ImageAnimatorFrameInfo * imageInfo, int32_t duration )

Description

Sets the playback duration of an image.

Since: 12

Parameters

Name Description
imageInfo Pointer to the frame image object.
duration Playback duration of an image, in milliseconds.

OH_ArkUI_ImageAnimatorFrameInfo_SetHeight()

void OH_ArkUI_ImageAnimatorFrameInfo_SetHeight (ArkUI_ImageAnimatorFrameInfo * imageInfo, int32_t height )

Description

Sets the image height.

Since: 12

Parameters

Name Description
imageInfo Pointer to the frame image object.
height Image height, in px.

OH_ArkUI_ImageAnimatorFrameInfo_SetLeft()

void OH_ArkUI_ImageAnimatorFrameInfo_SetLeft (ArkUI_ImageAnimatorFrameInfo * imageInfo, int32_t left )

Description

Sets the horizontal coordinate of an image relative to the upper left corner of the component.

Since: 12

Parameters

Name Description
imageInfo Pointer to the frame image object.
left Horizontal coordinate of the image relative to the upper left corner of the component, in px.

OH_ArkUI_ImageAnimatorFrameInfo_SetTop()

void OH_ArkUI_ImageAnimatorFrameInfo_SetTop (ArkUI_ImageAnimatorFrameInfo * imageInfo, int32_t top )

Description

Sets the vertical coordinate of an image relative to the upper left corner of the component.

Since: 12

Parameters

Name Description
imageInfo Pointer to the frame image object.
top Vertical coordinate of the image relative to the upper left corner of the component, in px.

OH_ArkUI_ImageAnimatorFrameInfo_SetWidth()

void OH_ArkUI_ImageAnimatorFrameInfo_SetWidth (ArkUI_ImageAnimatorFrameInfo * imageInfo, int32_t width )

Description

Sets the image width.

Since: 12

Parameters

Name Description
imageInfo Pointer to the frame image object.
width Image width, in px.

OH_ArkUI_IsBuiltInGesture()

bool OH_ArkUI_IsBuiltInGesture (ArkUI_GestureRecognizer * recognizer)

Description

Obtains whether a gesture is a built-in gesture.

Since: 12

Parameters

Name Description
recognizer Pointer to the gesture recognizer.

Returns

true: built-in gestures. false: The gesture is not a built-in gesture.

OH_ArkUI_IsGestureRecognizerValid()

bool OH_ArkUI_IsGestureRecognizerValid (ArkUI_GestureRecognizer * recognizer)

Description

Obtains whether a gesture recognizer is valid.

Since: 12

Parameters

Name Description
recognizer Pointer to the gesture recognizer.

Returns

true: The gesture recognizer is valid. Returns false if the gesture recognizer is invalid.

OH_ArkUI_KeyEvent_GetKeyCode()

int32_t OH_ArkUI_KeyEvent_GetKeyCode (const ArkUI_UIInputEvent * event)

Description

Obtains the key code from a key event.

Since: 14

Parameters

Name Description
event Pointer to an ArkUI_UIInputEvent object.

Returns

Key code.

OH_ArkUI_KeyEvent_GetKeyIntensionCode()

ArkUI_KeyIntension OH_ArkUI_KeyEvent_GetKeyIntensionCode (const ArkUI_UIInputEvent * event)

Description

Obtains the intention code associated with a key event.

Since: 14

Parameters

Name Description
event Pointer to an ArkUI_UIInputEvent object.

Returns

Returns the intention code associated with the key event.

OH_ArkUI_KeyEvent_GetKeySource()

ArkUI_KeySourceType OH_ArkUI_KeyEvent_GetKeySource (const ArkUI_UIInputEvent * event)

Description

Obtains the type of input device that triggers a key event.

Since: 14

Parameters

Name Description
event Pointer to an ArkUI_UIInputEvent object.

Returns

Returns the device type.

OH_ArkUI_KeyEvent_GetKeyText()

const char* OH_ArkUI_KeyEvent_GetKeyText (const ArkUI_UIInputEvent * event)

Description

Obtains the key value from a key event.

Since: 14

Parameters

Name Description
event Pointer to an ArkUI_UIInputEvent object.

Returns

Key value.

OH_ArkUI_KeyEvent_GetType()

ArkUI_KeyEventType OH_ArkUI_KeyEvent_GetType (const ArkUI_UIInputEvent * event)

Description

Obtains the type of a key event.

Since: 14

Parameters

Name Description
event Pointer to an ArkUI_UIInputEvent object.

Returns

Returns the key event type.

OH_ArkUI_KeyEvent_GetUnicode()

uint32_t OH_ArkUI_KeyEvent_GetUnicode (const ArkUI_UIInputEvent * event)

Description

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.

Since: 14

Parameters

Name Description
event Pointer to an ArkUI_UIInputEvent object.

Returns

Returns the Unicode value.

OH_ArkUI_KeyEvent_SetConsumed()

void OH_ArkUI_KeyEvent_SetConsumed (const ArkUI_UIInputEvent * event, bool isConsumed )

Description

Sets whether a key event is consumed in the key event callback.

Since: 14

Parameters

Name Description
event Pointer to an ArkUI_UIInputEvent object.
isConsumed Whether the event is consumed.

OH_ArkUI_KeyEvent_StopPropagation()

void OH_ArkUI_KeyEvent_StopPropagation (const ArkUI_UIInputEvent * event, bool stopPropagation )

Description

Stops the event from bubbling upwards or downwards.

Since: 14

Parameters

Name Description
event Pointer to an ArkUI_UIInputEvent object.
stopPropagation Whether to stop event propagation.

OH_ArkUI_KeyframeAnimateOption_Create()

ArkUI_KeyframeAnimateOption* OH_ArkUI_KeyframeAnimateOption_Create (int32_t size)

Description

Obtains the keyframe animation parameters.

Since: 12

Parameters

Name Description
size Number of key frame animation states.

Returns

Returns the keyframe animation parameter object; returns NULL if the value of size is less than 0.

OH_ArkUI_KeyframeAnimateOption_Dispose()

void OH_ArkUI_KeyframeAnimateOption_Dispose (ArkUI_KeyframeAnimateOption * option)

Description

Destroys a keyframe animation parameter object.

Since: 12

Parameters

Name Description
option Returns the keyframe animation parameter object;

OH_ArkUI_KeyframeAnimateOption_GetCurve()

ArkUI_CurveHandle OH_ArkUI_KeyframeAnimateOption_GetCurve (ArkUI_KeyframeAnimateOption * option, int32_t index )

Description

Obtains the animation curve of a specific state in a keyframe animation.

Since: 12

Parameters

Name Description
option Keyframe animation parameters.
index Status index.

Returns

Returns the animation curve.

OH_ArkUI_KeyframeAnimateOption_GetDelay()

int32_t OH_ArkUI_KeyframeAnimateOption_GetDelay (ArkUI_KeyframeAnimateOption * option)

Description

Obtains the overall delay of a keyframe animation

Since: 12

Parameters

Name Description
option Keyframe animation parameters.

Returns

Returns the overall delay.

OH_ArkUI_KeyframeAnimateOption_GetDuration()

int32_t OH_ArkUI_KeyframeAnimateOption_GetDuration (ArkUI_KeyframeAnimateOption * option, int32_t index )

Description

Obtains the duration of a specific state in a keyframe animation.

Since: 12

Parameters

Name Description
option Keyframe animation parameters.
index Status index.

Returns

Duration, in milliseconds.

OH_ArkUI_KeyframeAnimateOption_GetIterations()

int32_t OH_ArkUI_KeyframeAnimateOption_GetIterations (ArkUI_KeyframeAnimateOption * option)

Description

Obtains the number of times that a keyframe animation is played.

Since: 12

Parameters

Name Description
option Keyframe animation parameters.

Returns

Number of times that the animation is played.

OH_ArkUI_KeyframeAnimateOption_RegisterOnEventCallback()

int32_t OH_ArkUI_KeyframeAnimateOption_RegisterOnEventCallback (ArkUI_KeyframeAnimateOption * option, void * userData, void(*)(void *userData) event, int32_t index )

Description

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.

Parameters

Name Description
option Keyframe animation parameters.
event Closure function.
userData Pointer to a custom object.
index Status index.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_KeyframeAnimateOption_RegisterOnFinishCallback()

int32_t OH_ArkUI_KeyframeAnimateOption_RegisterOnFinishCallback (ArkUI_KeyframeAnimateOption * option, void * userData, void(*)(void *userData) onFinish )

Description

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.

Parameters

Name Description
option Keyframe animation parameters.
userData Pointer to a custom object.
onFinish Callback used to return the result.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_KeyframeAnimateOption_SetCurve()

int32_t OH_ArkUI_KeyframeAnimateOption_SetCurve (ArkUI_KeyframeAnimateOption * option, ArkUI_CurveHandle value, int32_t index )

Description

Sets the animation curve for a specific keyframe in a keyframe animation.

Parameters

Name Description
option Keyframe animation parameters.
value Animation curve used by the key frame. Default value: EASE_IN_OUT.
index Status index.

NOTE

Because the springMotion, responsiveSpringMotion, and interpolatingSpring curves do not have effective duration settings, they are not supported.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_KeyframeAnimateOption_SetDelay()

int32_t OH_ArkUI_KeyframeAnimateOption_SetDelay (ArkUI_KeyframeAnimateOption * option, int32_t value )

Description

Sets the overall delay of a keyframe animation, in milliseconds. By default, the keyframe animation is played without delay.

Parameters

Name Description
option Keyframe animation parameters.
value Delay time, in milliseconds.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_KeyframeAnimateOption_SetDuration()

int32_t OH_ArkUI_KeyframeAnimateOption_SetDuration (ArkUI_KeyframeAnimateOption * option, int32_t value, int32_t index )

Description

Sets the duration of a keyframe animation, in milliseconds.

Parameters

Name Description
option Keyframe animation parameters.
value Duration, in milliseconds.
index Status index.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_KeyframeAnimateOption_SetIterations()

int32_t OH_ArkUI_KeyframeAnimateOption_SetIterations (ArkUI_KeyframeAnimateOption * option, int32_t value )

Description

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.

Parameters

Name Description
option Keyframe animation parameters.
value Number of times that the animation is played.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_LayoutConstraint_Copy()

ArkUI_LayoutConstraint* OH_ArkUI_LayoutConstraint_Copy (const ArkUI_LayoutConstraint * Constraint)

Description

Constraint size deep copy.

Since: 12

Parameters

Name Description
Constraint Size constraint.

Returns

Pointer to the new constraint size.

OH_ArkUI_LayoutConstraint_Create()

ArkUI_LayoutConstraint* OH_ArkUI_LayoutConstraint_Create ()

Description

Create a constraint size.

Since: 12

OH_ArkUI_LayoutConstraint_Dispose()

void* OH_ArkUI_LayoutConstraint_Dispose (ArkUI_LayoutConstraint * Constraint)

Description

Pointer to the size of the destruction constraint.

Since: 12

Parameters

Name Description
Constraint Size constraint.

OH_ArkUI_LayoutConstraint_GetMaxHeight()

int32_t OH_ArkUI_LayoutConstraint_GetMaxHeight (const ArkUI_LayoutConstraint * Constraint)

Description

Obtains the maximum height for a size constraint, in px.

Since: 12

Parameters

Name Description
Constraint Size constraint.

Returns

Maximum height.

OH_ArkUI_LayoutConstraint_GetMaxWidth()

int32_t OH_ArkUI_LayoutConstraint_GetMaxWidth (const ArkUI_LayoutConstraint * Constraint)

Description

Obtains the maximum width for a size constraint, in px.

Since: 12

Parameters

Name Description
Constraint Size constraint.

Returns

Maximum width.

OH_ArkUI_LayoutConstraint_GetMinHeight()

int32_t OH_ArkUI_LayoutConstraint_GetMinHeight (const ArkUI_LayoutConstraint * Constraint)

Description

Obtains the minimum height for a size constraint, in px.

Since: 12

Parameters

Name Description
Constraint Size constraint.

Returns

Minimum Height

OH_ArkUI_LayoutConstraint_GetMinWidth()

int32_t OH_ArkUI_LayoutConstraint_GetMinWidth (const ArkUI_LayoutConstraint * Constraint)

Description

Obtains the minimum width for a size constraint, in px.

Since: 12

Parameters

Name Description
Constraint Size constraint.

Returns

Minimum Width

OH_ArkUI_LayoutConstraint_GetPercentReferenceHeight()

int32_t OH_ArkUI_LayoutConstraint_GetPercentReferenceHeight (const ArkUI_LayoutConstraint * Constraint)

Description

Obtains the height percentage reference for a size constraint, in px.

Since: 12

Parameters

Name Description
Constraint Size constraint.

Returns

Height percentage benchmark.

OH_ArkUI_LayoutConstraint_GetPercentReferenceWidth()

int32_t OH_ArkUI_LayoutConstraint_GetPercentReferenceWidth (const ArkUI_LayoutConstraint * Constraint)

Description

Obtains the width percentage reference for a size constraint, in px.

Since: 12

Parameters

Name Description
Constraint Size constraint.

Returns

Width percentage reference.

OH_ArkUI_LayoutConstraint_SetMaxHeight()

void OH_ArkUI_LayoutConstraint_SetMaxHeight (ArkUI_LayoutConstraint * Constraint, int32_t value )

Description

Sets the maximum height.

Since: 12

Parameters

Name Description
Constraint Size constraint.
value Maximum height, in pixels.

OH_ArkUI_LayoutConstraint_SetMaxWidth()

void OH_ArkUI_LayoutConstraint_SetMaxWidth (ArkUI_LayoutConstraint * Constraint, int32_t value )

Description

Sets the maximum width.

Since: 12

Parameters

Name Description
Constraint Size constraint.
value Maximum width, in pixels.

OH_ArkUI_LayoutConstraint_SetMinHeight()

void OH_ArkUI_LayoutConstraint_SetMinHeight (ArkUI_LayoutConstraint * Constraint, int32_t value )

Description

Sets the minimum height.

Since: 12

Parameters

Name Description
Constraint Size constraint.
value Minimum height, in pixels.

OH_ArkUI_LayoutConstraint_SetMinWidth()

void OH_ArkUI_LayoutConstraint_SetMinWidth (ArkUI_LayoutConstraint * Constraint, int32_t value )

Description

Sets the minimum width.

Since: 12

Parameters

Name Description
Constraint Size constraint.
value Minimum width, in pixels.

OH_ArkUI_LayoutConstraint_SetPercentReferenceHeight()

void OH_ArkUI_LayoutConstraint_SetPercentReferenceHeight (ArkUI_LayoutConstraint * Constraint, int32_t value )

Description

Sets the height percentage reference.

Since: 12

Parameters

Name Description
Constraint Size constraint.
value Height percentage base, in px.

OH_ArkUI_LayoutConstraint_SetPercentReferenceWidth()

void OH_ArkUI_LayoutConstraint_SetPercentReferenceWidth (ArkUI_LayoutConstraint * Constraint, int32_t value )

Description

Sets the width percentage reference.

Since: 12

Parameters

Name Description
Constraint Size constraint.
value Width percentage benchmark, in px.

OH_ArkUI_List_CloseAllSwipeActions()

int32_t OH_ArkUI_List_CloseAllSwipeActions (ArkUI_NodeHandle node, void * userData, void(*)(void *userData) onFinish )

Description

Collapse the expanded ListItem.

Since: 12

Parameters

Name Description
node Node object for which an event needs to be registered.
userData Custom event parameter, which is passed in the callback when the event is triggered.
onFinish Callback triggered after the collapse animation is complete.

Returns

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_ATTRIBUTE_OR_EVENT_NOT_SUPPORTED if the event is not supported.

OH_ArkUI_ListChildrenMainSizeOption_Create()

ArkUI_ListChildrenMainSize* OH_ArkUI_ListChildrenMainSizeOption_Create ()

Description

Creates a ListChildrenMainSize instance.

Since: 12

Returns

Returns the created ListChildrenMainSize instance.

OH_ArkUI_ListChildrenMainSizeOption_Dispose()

void OH_ArkUI_ListChildrenMainSizeOption_Dispose (ArkUI_ListChildrenMainSize * option)

Description

Destroys a ListChildrenMainSize instance.

Since: 12

Parameters

Name Description
option ListChildrenMainSize instance to be destroyed.

OH_ArkUI_ListChildrenMainSizeOption_GetDefaultMainSize()

float OH_ArkUI_ListChildrenMainSizeOption_GetDefaultMainSize (ArkUI_ListChildrenMainSize * option)

Description

Obtains the default size in a ListChildrenMainSize instance.

Since: 12

Parameters

Name Description
option ListChildrenMainSize instance.

Returns

Returns the default size, in vp. The default value is 0. If option is a null pointer, -1 is returned.

OH_ArkUI_ListChildrenMainSizeOption_GetMainSize()

float OH_ArkUI_ListChildrenMainSizeOption_GetMainSize (ArkUI_ListChildrenMainSize * option, int32_t index )

Description

Obtains the value of the ChildrenMainSizeOption array of the List component.

Since: 12

Parameters

Name Description
option ListChildrenMainSize instance.
index Subscript position of the value to be obtained.

Returns

Value of the specific position of the array. If a parameter error occurs, -1 is returned.

OH_ArkUI_ListChildrenMainSizeOption_Resize()

void OH_ArkUI_ListChildrenMainSizeOption_Resize (ArkUI_ListChildrenMainSize * option, int32_t totalSize )

Description

Resets the array size of ChildrenMainSizeOption of the List component.

Since: 12

Parameters

Name Description
option ListChildrenMainSize instance.
totalSize Array size.

OH_ArkUI_ListChildrenMainSizeOption_SetDefaultMainSize()

int32_t OH_ArkUI_ListChildrenMainSizeOption_SetDefaultMainSize (ArkUI_ListChildrenMainSize * option, float defaultMainSize )

Description

Sets the default size in a ListChildrenMainSize instance.

Since: 12

Parameters

Name Description
option ListChildrenMainSize instance.
defaultMainSize Default size of a list item in a list. The unit is vp.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_ListChildrenMainSizeOption_Splice()

int32_t OH_ArkUI_ListChildrenMainSizeOption_Splice (ArkUI_ListChildrenMainSize * option, int32_t index, int32_t deleteCount, int32_t addCount )

Description

The size of the ChildrenMainSizeOption array of the List component is adjusted.

Since: 12

Parameters

Name Description
option ListChildrenMainSize instance.
index Start position of the array whose MainSize is to be modified.
deleteCount Number of MainSize arrays to be deleted starting from index.
addCount Number of MainSize arrays to be added starting from index.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_ListChildrenMainSizeOption_UpdateSize()

int32_t OH_ArkUI_ListChildrenMainSizeOption_UpdateSize (ArkUI_ListChildrenMainSize * option, int32_t index, float mainSize )

Description

Updates the values in a ChildrenMainSizeOption array of a List component.

Since: 12

Parameters

Name Description
option ListChildrenMainSize instance.
index Index at which to start changing the values in the array.
mainSize New size value to set at the specified index.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_ListItemSwipeActionItem_Create()

ArkUI_ListItemSwipeActionItem* OH_ArkUI_ListItemSwipeActionItem_Create ()

Description

Creates a ListItemSwipeActionItem instance.

Since: 12

Returns

Returns the created ListItemSwipeActionItem instance.

OH_ArkUI_ListItemSwipeActionItem_Dispose()

void OH_ArkUI_ListItemSwipeActionItem_Dispose (ArkUI_ListItemSwipeActionItem * item)

Description

Disposes of a ListItemSwipeActionItem instance.

Since: 12

Parameters

Name Description
item ListItemSwipeActionItem instance to dispose of.

OH_ArkUI_ListItemSwipeActionItem_GetActionAreaDistance()

float OH_ArkUI_ListItemSwipeActionItem_GetActionAreaDistance (ArkUI_ListItemSwipeActionItem * item)

Description

Obtains the swipe distance threshold for deleting the list item.

Since: 12

Parameters

Name Description
item Target ListItemSwipeActionItem instance.

Returns

Returns the swipe distance threshold for deleting the list item. Return 0 if an error occurs.

OH_ArkUI_ListItemSwipeActionItem_SetActionAreaDistance()

void OH_ArkUI_ListItemSwipeActionItem_SetActionAreaDistance (ArkUI_ListItemSwipeActionItem * item, float distance )

Description

Swipe distance threshold for deleting the list item.

Since: 12

Parameters

Name Description
item Target ListItemSwipeActionItem instance.
distance Returns the swipe distance threshold for deleting the list item.

OH_ArkUI_ListItemSwipeActionItem_SetContent()

void OH_ArkUI_ListItemSwipeActionItem_SetContent (ArkUI_ListItemSwipeActionItem * item, ArkUI_NodeHandle node )

Description

Sets the layout content of ListItemSwipeActionItem.

Since: 12

Parameters

Name Description
item Target ListItemSwipeActionItem instance.
node Layout information

OH_ArkUI_ListItemSwipeActionItem_SetOnAction()

void OH_ArkUI_ListItemSwipeActionItem_SetOnAction (ArkUI_ListItemSwipeActionItem * item, void(*)() callback )

Description

Sets the callback invoked when the list item is deleted while in the delete area.

Since: 12

Parameters

Name Description
item Target ListItemSwipeActionItem instance.
callback Callback to invoke when an event of the specified type occurs.

OH_ArkUI_ListItemSwipeActionItem_SetOnActionWithUserData()

void OH_ArkUI_ListItemSwipeActionItem_SetOnActionWithUserData (ArkUI_ListItemSwipeActionItem * item, void * userData, void(*)(void *userData) callback )

Description

Sets the callback invoked when the list item is deleted while in the delete area.

Since: 12

Parameters

Name Description
item Target ListItemSwipeActionItem instance.
userData Custom data.
callback Callback to invoke when an event of the specified type occurs.

OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionArea()

void OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionArea (ArkUI_ListItemSwipeActionItem * item, void(*)() callback )

Description

Sets the callback invoked each time the list item enters the delete area.

Since: 12

Parameters

Name Description
item Target ListItemSwipeActionItem instance.
callback Callback to invoke when an event of the specified type occurs.

OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionAreaWithUserData()

void OH_ArkUI_ListItemSwipeActionItem_SetOnEnterActionAreaWithUserData (ArkUI_ListItemSwipeActionItem * item, void * userData, void(*)(void *userData) callback )

Description

Sets the callback invoked each time the list item enters the delete area.

Since: 12

Parameters

Name Description
item Target ListItemSwipeActionItem instance.
userData Custom data.
callback Callback to invoke when an event of the specified type occurs.

OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionArea()

void OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionArea (ArkUI_ListItemSwipeActionItem * item, void(*)() callback )

Description

Sets the callback invoked each time the list item exits the delete area.

Since: 12

Parameters

Name Description
item Target ListItemSwipeActionItem instance.
callback Callback to invoke when an event of the specified type occurs.

OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionAreaWithUserData()

void OH_ArkUI_ListItemSwipeActionItem_SetOnExitActionAreaWithUserData (ArkUI_ListItemSwipeActionItem * item, void * userData, void(*)(void *userData) callback )

Description

Sets the callback invoked each time the list item exits the delete area.

Since: 12

Parameters

Name Description
item Target ListItemSwipeActionItem instance.
userData Custom data.
callback Callback to invoke when an event of the specified type occurs.

OH_ArkUI_ListItemSwipeActionItem_SetOnStateChange()

void OH_ArkUI_ListItemSwipeActionItem_SetOnStateChange (ArkUI_ListItemSwipeActionItem * item, void(*)(ArkUI_ListItemSwipeActionState swipeActionState) callback )

Description

Sets the callback invoked when the swipe state of the list item changes.

Since: 12

Parameters

Name Description
item Target ListItemSwipeActionItem instance.
callback Status after the callback event swipeActionState changes.

OH_ArkUI_ListItemSwipeActionItem_SetOnStateChangeWithUserData()

void OH_ArkUI_ListItemSwipeActionItem_SetOnStateChangeWithUserData (ArkUI_ListItemSwipeActionItem * item, void * userData, void(*)(ArkUI_ListItemSwipeActionState swipeActionState, void *userData) callback )

Description

Sets the callback invoked when the swipe state of the list item changes.

Since: 12

Parameters

Name Description
item Target ListItemSwipeActionItem instance.
userData Custom data.
callback Status after the callback event swipeActionState changes.

OH_ArkUI_ListItemSwipeActionOption_Create()

ArkUI_ListItemSwipeActionOption* OH_ArkUI_ListItemSwipeActionOption_Create ()

Description

Creates a ListItemSwipeActionOption instance.

Since: 12

Returns

ListItemSwipeActionOption configuration item instance.

OH_ArkUI_ListItemSwipeActionOption_Dispose()

void OH_ArkUI_ListItemSwipeActionOption_Dispose (ArkUI_ListItemSwipeActionOption * option)

Description

Destroys a ListItemSwipeActionOption instance.

Since: 12

Parameters

Name Description
option ListItemSwipeActionOption instance to destroy.

OH_ArkUI_ListItemSwipeActionOption_GetEdgeEffect()

int32_t OH_ArkUI_ListItemSwipeActionOption_GetEdgeEffect (ArkUI_ListItemSwipeActionOption * option)

Description

Obtains the sliding effect.

Since: 12

Parameters

Name Description
option Target ListItemSwipeActionItem instance.

Returns

Scroll effect. The default return value is ARKUI_LIST_ITEM_SWIPE_EDGE_EFFECT_SPRING.

OH_ArkUI_ListItemSwipeActionOption_SetEdgeEffect()

void OH_ArkUI_ListItemSwipeActionOption_SetEdgeEffect (ArkUI_ListItemSwipeActionOption * option, ArkUI_ListItemSwipeEdgeEffect edgeEffect )

Description

Sets the sliding effect.

Since: 12

Parameters

Name Description
option Target ListItemSwipeActionItem instance.
edgeEffect Scroll effect.

OH_ArkUI_ListItemSwipeActionOption_SetEnd()

void OH_ArkUI_ListItemSwipeActionOption_SetEnd (ArkUI_ListItemSwipeActionOption * option, ArkUI_ListItemSwipeActionItem * item )

Description

Sets the layout content for the right edge (for a vertical layout) or bottom edge (for a horizontal layout) of a ListItemSwipeActionItem instance.

Since: 12

Parameters

Name Description
option Target ListItemSwipeActionItem instance.
builder Layout information

OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChange()

void OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChange (ArkUI_ListItemSwipeActionOption * option, void(*)(float offset) callback )

Description

Sets the callback invoked when the scroll offset changes.

Since: 12

Parameters

Name Description
option Target ListItemSwipeActionItem instance.
callback Sliding offset of the callback event offset.

OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChangeWithUserData()

void OH_ArkUI_ListItemSwipeActionOption_SetOnOffsetChangeWithUserData (ArkUI_ListItemSwipeActionOption * option, void * userData, void(*)(float offset, void *userData) callback )

Description

Sets the callback invoked when the scroll offset changes.

Since: 12

Parameters

Name Description
option Target ListItemSwipeActionItem instance.
userData Custom data.
callback Sliding offset of the callback event offset.

OH_ArkUI_ListItemSwipeActionOption_SetStart()

void OH_ArkUI_ListItemSwipeActionOption_SetStart (ArkUI_ListItemSwipeActionOption * option, ArkUI_ListItemSwipeActionItem * item )

Description

Sets the layout content for the left edge (for a vertical layout) or top edge (for a horizontal layout) of a ListItemSwipeActionItem instance.

Since: 12

Parameters

Name Description
option Target ListItemSwipeActionItem instance.
builder Layout information

OH_ArkUI_LongPress_GetRepeatCount()

int32_t OH_ArkUI_LongPress_GetRepeatCount (const ArkUI_GestureEvent * event)

Description

Obtains the number of times that a long press gesture is triggered periodically.

Since: 12

Parameters

Name Description
event Gesture event.

Returns

Returns the number of times that the long press gesture is triggered periodically.

OH_ArkUI_MarshallStyledStringDescriptor()

int32_t OH_ArkUI_MarshallStyledStringDescriptor (uint8_t * buffer, size_t * bufferSize, ArkUI_StyledString_Descriptor * descriptor )

Description

Serializes the styled string information into a byte array.

Since: 14

Parameters

Name Description
buffer Byte array where the serialized data will be stored.
bufferSize Length of the byte array.
descriptor Pointer to an ArkUI_StyledString_Descriptor object.

Returns

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_INVALID_STYLED_STRING if the styled string is invalid.

OH_ArkUI_NodeAdapter_Create()

ArkUI_NodeAdapterHandle OH_ArkUI_NodeAdapter_Create ()

Description

Creates a component adapter.

Since: 12

OH_ArkUI_NodeAdapter_Dispose()

void OH_ArkUI_NodeAdapter_Dispose (ArkUI_NodeAdapterHandle handle)

Description

Destroys a component adapter.

Since: 12

Parameters

Name Description
handle Component adapter object.

OH_ArkUI_NodeAdapter_GetAllItems()

int32_t OH_ArkUI_NodeAdapter_GetAllItems (ArkUI_NodeAdapterHandle handle, ArkUI_NodeHandle ** items, uint32_t * size )

Description

Obtains all elements stored in the specified adapter.

When 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.

Since: 12

Parameters

Name Description
handle Component adapter object.
items Array of nodes in the adapter.
size Number of elements.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeAdapter_GetTotalNodeCount()

uint32_t OH_ArkUI_NodeAdapter_GetTotalNodeCount (ArkUI_NodeAdapterHandle handle)

Description

Obtains the total number of elements in the Adapter.

Since: 12

Parameters

Name Description
handle Component adapter object.

Returns

Total number of elements in the Adapter.

OH_ArkUI_NodeAdapter_InsertItem()

int32_t OH_ArkUI_NodeAdapter_InsertItem (ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount )

Description

Instructs the specified adapter to insert certain elements.

Since: 12

Parameters

Name Description
handle Component adapter object.
startPosition Start position for inserting an element.
itemCount Number of inserted elements.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeAdapter_MoveItem()

int32_t OH_ArkUI_NodeAdapter_MoveItem (ArkUI_NodeAdapterHandle handle, uint32_t from, uint32_t to )

Description

Instructs the specified adapter to move certain elements.

Since: 12

Parameters

Name Description
handle Component adapter object.
from Start position of the element shift.
to End position of the element shift.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeAdapter_RegisterEventReceiver()

int32_t OH_ArkUI_NodeAdapter_RegisterEventReceiver (ArkUI_NodeAdapterHandle handle, void * userData, void(*)(ArkUI_NodeAdapterEvent *event) receiver )

Description

Registers callback events related to the Adapter.

Since: 12

Parameters

Name Description
handle Component adapter object.
userData Custom data.
receiver Event receiving callback.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeAdapter_ReloadAllItems()

int32_t OH_ArkUI_NodeAdapter_ReloadAllItems (ArkUI_NodeAdapterHandle handle)

Description

Instructs the specified adapter to reload all elements.

Since: 12

Parameters

Name Description
handle Component adapter object.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeAdapter_ReloadItem()

int32_t OH_ArkUI_NodeAdapter_ReloadItem (ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount )

Description

Instructs the specified adapter to reload certain elements.

Since: 12

Parameters

Name Description
handle Component adapter object.
startPosition Start position of an element change.
itemCount Number of changed elements.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeAdapter_RemoveItem()

int32_t OH_ArkUI_NodeAdapter_RemoveItem (ArkUI_NodeAdapterHandle handle, uint32_t startPosition, uint32_t itemCount )

Description

Instructs the specified adapter to remove certain elements.

Since: 12

Parameters

Name Description
handle Component adapter object.
startPosition Start position for deleting an element.
itemCount Number of deleted elements.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeAdapter_SetTotalNodeCount()

int32_t OH_ArkUI_NodeAdapter_SetTotalNodeCount (ArkUI_NodeAdapterHandle handle, uint32_t size )

Description

Sets the total number of elements in the specified adapter.

Since: 12

Parameters

Name Description
handle Component adapter object.
size Number of elements.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeAdapter_UnregisterEventReceiver()

void OH_ArkUI_NodeAdapter_UnregisterEventReceiver (ArkUI_NodeAdapterHandle handle)

Description

Deregisters Adapter-related callback events.

Since: 12

Parameters

Name Description
handle Component adapter object.

OH_ArkUI_NodeAdapterEvent_GetHostNode()

ArkUI_NodeHandle OH_ArkUI_NodeAdapterEvent_GetHostNode (ArkUI_NodeAdapterEvent * event)

Description

Obtains the scrolling class container node that uses the adapter.

Since: 12

Parameters

Name Description
event Adapter event object.

Returns

Returns the scrollable container node that uses the specified adapter.

OH_ArkUI_NodeAdapterEvent_GetItemIndex()

uint32_t OH_ArkUI_NodeAdapterEvent_GetItemIndex (ArkUI_NodeAdapterEvent * event)

Description

Sequence number of the element to be operated when the adapter event is obtained.

Since: 12

Parameters

Name Description
event Adapter event object.

Returns

Sequence number of an element.

OH_ArkUI_NodeAdapterEvent_GetRemovedNode()

ArkUI_NodeHandle OH_ArkUI_NodeAdapterEvent_GetRemovedNode (ArkUI_NodeAdapterEvent * event)

Description

Obtains the element to be destroyed in the event to be destroyed.

Since: 12

Parameters

Name Description
event Adapter event object.

Returns

Element to be destroyed.

OH_ArkUI_NodeAdapterEvent_GetType()

ArkUI_NodeAdapterEventType OH_ArkUI_NodeAdapterEvent_GetType (ArkUI_NodeAdapterEvent * event)

Description

Obtains the event type.

Since: 12

Parameters

Name Description
event Adapter event object.

Returns

Represents an event type.

OH_ArkUI_NodeAdapterEvent_GetUserData()

void* OH_ArkUI_NodeAdapterEvent_GetUserData (ArkUI_NodeAdapterEvent * event)

Description

Obtains the custom data passed in during registration of the specified event.

Since: 12

Parameters

Name Description
event Adapter event object.

OH_ArkUI_NodeAdapterEvent_SetItem()

int32_t OH_ArkUI_NodeAdapterEvent_SetItem (ArkUI_NodeAdapterEvent * event, ArkUI_NodeHandle node )

Description

Sets the component to be added to the specified adapter.

Since: 12

Parameters

Name Description
event Adapter event object.
node Component to be added.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeAdapterEvent_SetNodeId()

int32_t OH_ArkUI_NodeAdapterEvent_SetNodeId (ArkUI_NodeAdapterEvent * event, int32_t id )

Description

Sets the generated component ID.

Since: 12

Parameters

Name Description
event Adapter event object.
id Sets the returned component ID.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeContent_AddNode()

int32_t OH_ArkUI_NodeContent_AddNode (ArkUI_NodeContentHandle content, ArkUI_NodeHandle node )

Description

Adds an ArkUI component node to the specified NodeContent object.

Since: 12

Parameters

Name Description
content NodeContent object to which a node is to be added.
node Node to be added.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeContent_GetUserData()

void* OH_ArkUI_NodeContent_GetUserData (ArkUI_NodeContentHandle content)

Description

Obtains the user-defined data saved on the NodeContent object.

Since: 12

Parameters

Name Description
content NodeContent object whose user-defined data needs to be saved.

Returns

Custom data.

OH_ArkUI_NodeContent_InsertNode()

int32_t OH_ArkUI_NodeContent_InsertNode (ArkUI_NodeContentHandle content, ArkUI_NodeHandle node, int32_t position )

Description

Inserts an ArkUI component node into a specific location of the corresponding NodeContent object.

Since: 12

Parameters

Name Description
content NodeContent object of the node to be inserted.
node Node to be inserted.
position Start time for an asset to be inserted,

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeContent_RegisterCallback()

int32_t OH_ArkUI_NodeContent_RegisterCallback (ArkUI_NodeContentHandle content, ArkUI_NodeContentCallback callback )

Description

Registers the NodeContent event function.

Since: 12

Parameters

Name Description
content NodeContent object for which an event needs to be registered.
callback Callback to be executed when the event is triggered.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeContent_RemoveNode()

int32_t OH_ArkUI_NodeContent_RemoveNode (ArkUI_NodeContentHandle content, ArkUI_NodeHandle node )

Description

Removes an ArkUI component node from the specified NodeContent object.

Since: 12

Parameters

Name Description
content NodeContent object of the node to be deleted.
node Node to be deleted.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeContent_SetUserData()

int32_t OH_ArkUI_NodeContent_SetUserData (ArkUI_NodeContentHandle content, void * userData )

Description

Saves user-defined data on the NodeContent object.

Since: 12

Parameters

Name Description
content NodeContent object whose user-defined data needs to be saved.
userData User-defined data to be saved.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeContentEvent_GetEventType()

ArkUI_NodeContentEventType OH_ArkUI_NodeContentEvent_GetEventType (ArkUI_NodeContentEvent * event)

Description

Obtains the type of the specified NodeContent event.

Since: 12

Parameters

Name Description
event Pointer to the NodeContent event.

Returns

NodeContent event type.

OH_ArkUI_NodeContentEvent_GetNodeContentHandle()

ArkUI_NodeContentHandle OH_ArkUI_NodeContentEvent_GetNodeContentHandle (ArkUI_NodeContentEvent * event)

Description

Obtains the object that triggers the specified NodeContent event.

Since: 12

Parameters

Name Description
event Pointer to the NodeContent event.

Returns

Returns the NodeContent object that triggers the event.

OH_ArkUI_NodeCustomEvent_GetCustomSpanDrawInfo()

int32_t OH_ArkUI_NodeCustomEvent_GetCustomSpanDrawInfo (ArkUI_NodeCustomEvent * event, ArkUI_CustomSpanDrawInfo * info )

Description

Obtains the drawing information of a custom span through a custom component event.

Since: 12

Parameters

Name Description
event Pointer to the custom component event.
info Drawing information to obtain.

Returns

Returns 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.

OH_ArkUI_NodeCustomEvent_GetCustomSpanMeasureInfo()

int32_t OH_ArkUI_NodeCustomEvent_GetCustomSpanMeasureInfo (ArkUI_NodeCustomEvent * event, ArkUI_CustomSpanMeasureInfo * info )

Description

Obtains the measurement information of a custom span through a custom component event.

Since: 12

Parameters

Name Description
event Pointer to the custom component event.
info Measurement information to obtain.

Returns

Returns 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.

OH_ArkUI_NodeCustomEvent_GetDrawContextInDraw()

ArkUI_DrawContext* OH_ArkUI_NodeCustomEvent_GetDrawContextInDraw (ArkUI_NodeCustomEvent * event)

Description

Obtains the drawing context through a custom component event.

Since: 12

Parameters

Name Description
event Pointer to the custom component event.

Returns

Returns the drawing context.

OH_ArkUI_NodeCustomEvent_GetEventTargetId()

int32_t OH_ArkUI_NodeCustomEvent_GetEventTargetId (ArkUI_NodeCustomEvent * event)

Description

Obtains the ID of a custom component event.

Since: 12

Parameters

Name Description
event Pointer to the custom component event.

Returns

Returns the custom event ID.

OH_ArkUI_NodeCustomEvent_GetEventType()

ArkUI_NodeCustomEventType OH_ArkUI_NodeCustomEvent_GetEventType (ArkUI_NodeCustomEvent * event)

Description

Obtains the event type through a custom component event.

Since: 12

Parameters

Name Description
event Pointer to the custom component event.

Returns

Returns the type of the custom component event.

OH_ArkUI_NodeCustomEvent_GetLayoutConstraintInMeasure()

ArkUI_LayoutConstraint* OH_ArkUI_NodeCustomEvent_GetLayoutConstraintInMeasure (ArkUI_NodeCustomEvent * event)

Description

Obtains the size constraint for measurement through a custom component event.

Since: 12

Parameters

Name Description
event Pointer to the custom component event.

Returns

Pointer to the constraint size.

OH_ArkUI_NodeCustomEvent_GetNodeHandle()

ArkUI_NodeHandle OH_ArkUI_NodeCustomEvent_GetNodeHandle (ArkUI_NodeCustomEvent * event)

Description

Obtains a component object through a custom component event.

Since: 12

Parameters

Name Description
event Pointer to the custom component event.

Returns

Returns the obtained component object.

OH_ArkUI_NodeCustomEvent_GetPositionInLayout()

ArkUI_IntOffset OH_ArkUI_NodeCustomEvent_GetPositionInLayout (ArkUI_NodeCustomEvent * event)

Description

Obtains the expected position of a component relative to its parent component in the layout phase through a custom component event.

Since: 12

Parameters

Name Description
event Pointer to the custom component event.

Returns

Returns the expected position relative to the parent component.

OH_ArkUI_NodeCustomEvent_GetUserData()

void* OH_ArkUI_NodeCustomEvent_GetUserData (ArkUI_NodeCustomEvent * event)

Description

Obtains custom event parameters through a custom component event.

Since: 12

Parameters

Name Description
event Pointer to the custom component event.

Returns

Returns the custom event parameters.

OH_ArkUI_NodeCustomEvent_SetCustomSpanMetrics()

int32_t OH_ArkUI_NodeCustomEvent_SetCustomSpanMetrics (ArkUI_NodeCustomEvent * event, ArkUI_CustomSpanMetrics * metrics )

Description

Sets the measurement metrics of a custom span through a custom component event.

Since: 12

Parameters

Name Description
event Pointer to the custom component event.
metrics Measurement metrics to set.

Returns

Returns 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.

OH_ArkUI_NodeEvent_GetDragEvent()

ArkUI_DragEvent* OH_ArkUI_NodeEvent_GetDragEvent (ArkUI_NodeEvent * nodeEvent)

Description

Obtains an ArkUI_DragEvent object from the specified ArkUI_DragEvent object.

Since: 12

Parameters

Name Description
node Pointer to an ArkUI_NodeEvent object.

Returns

Returns the pointer to an ArkUI_DragEvent object; returns null if the parameter passed in is invalid or is not a drag-related event.

OH_ArkUI_NodeEvent_GetEventType()

ArkUI_NodeEventType OH_ArkUI_NodeEvent_GetEventType (ArkUI_NodeEvent * event)

Description

Obtains the type of a component event.

Since: 12

Parameters

Name Description
event Pointer to the component event.

Returns

Returns the type of the component event.

OH_ArkUI_NodeEvent_GetInputEvent()

ArkUI_UIInputEvent* OH_ArkUI_NodeEvent_GetInputEvent (ArkUI_NodeEvent * event)

Description

Obtains input event (for example, touch event) data for a component event.

Since: 12

Parameters

Name Description
event Pointer to the component event.

Returns

Returns the pointer to the input event data.

OH_ArkUI_NodeEvent_GetNodeComponentEvent()

ArkUI_NodeComponentEvent* OH_ArkUI_NodeEvent_GetNodeComponentEvent (ArkUI_NodeEvent * event)

Description

Obtains the numerical data in a component event.

Since: 12

Parameters

Name Description
event Pointer to the component event.

Returns

Returns the pointer to the numerical data.

OH_ArkUI_NodeEvent_GetNodeHandle()

ArkUI_NodeHandle OH_ArkUI_NodeEvent_GetNodeHandle (ArkUI_NodeEvent * event)

Description

Obtains the component object that triggers an event.

Since: 12

Parameters

Name Description
event Pointer to the component event.

Returns

Component object that triggers the event.

OH_ArkUI_NodeEvent_GetNumberValue()

int32_t OH_ArkUI_NodeEvent_GetNumberValue (ArkUI_NodeEvent * event, int32_t index, ArkUI_NumberValue * value )

Description

Obtains the numeric-type parameter of a component event.

Since: 12

Parameters

Name Description
event Pointer to the component event.
index Return value index.
value Return value.

Returns

Returns 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.

OH_ArkUI_NodeEvent_GetPreDragStatus()

ArkUI_PreDragStatus OH_ArkUI_NodeEvent_GetPreDragStatus (ArkUI_NodeEvent * nodeEvent)

Description

Obtains the state prior to a drop and drop operation.

Since: 12

Parameters

Name Description
node ArkUI_NodeEvent node object.

Returns

Returns the state prior to the drop and drop operation.

OH_ArkUI_NodeEvent_GetStringAsyncEvent()

ArkUI_StringAsyncEvent* OH_ArkUI_NodeEvent_GetStringAsyncEvent (ArkUI_NodeEvent * event)

Description

Obtains the string data in a component event.

Since: 12

Parameters

Name Description
event Pointer to the component event.

Returns

ArkUI_StringAsyncEvent\Pointer to string data.

OH_ArkUI_NodeEvent_GetStringValue()

int32_t OH_ArkUI_NodeEvent_GetStringValue (ArkUI_NodeEvent * event, int32_t index, char ** string, int32_t * stringSize )

Description

Obtains 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.

Since: 12

Parameters

Name Description
event Pointer to the component event.
index Return value index.
string Pointer to the string array.
stringSize Length of the string array.

Returns

Returns 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.

OH_ArkUI_NodeEvent_GetTargetId()

int32_t OH_ArkUI_NodeEvent_GetTargetId (ArkUI_NodeEvent * event)

Description

Obtains the custom ID of a component event.

The 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.

Since: 12

Parameters

Name Description
event Pointer to the component event.

Returns

Returns the custom ID of the component event.

OH_ArkUI_NodeEvent_GetUserData()

void* OH_ArkUI_NodeEvent_GetUserData (ArkUI_NodeEvent * event)

Description

Obtains the custom data in a component event.

This parameter is passed in registerNodeEvent and can be applied to the service logic when the event is triggered.

Since: 12

Parameters

Name Description
event Pointer to the component event.

Returns

Returns the pointer to user data.

OH_ArkUI_NodeEvent_SetReturnNumberValue()

int32_t OH_ArkUI_NodeEvent_SetReturnNumberValue (ArkUI_NodeEvent * event, ArkUI_NumberValue * value, int32_t size )

Description

Sets the return value for a component event.

Since: 12

Parameters

Name Description
event Pointer to the component event.
value Event numeric type array.
size Size of the array.

Returns

Returns 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.

OH_ArkUI_NodeUtils_AddCustomProperty()

void OH_ArkUI_NodeUtils_AddCustomProperty (ArkUI_NodeHandle node, const char * name, const char * value )

Description

Sets a custom property for a component. This API takes effect only in the main thread.

Since: 13

Parameters

Name Description
node ArkUI_NodeHandle pointer.
name Name of the custom property. A null pointer is not allowed.
value Value of the custom property. A null pointer is not allowed.

OH_ArkUI_NodeUtils_GetActiveChildrenInfo()

int32_t OH_ArkUI_NodeUtils_GetActiveChildrenInfo (ArkUI_NodeHandle head, ArkUI_ActiveChildrenInfo ** handle )

Description

Obtains all active child nodes of the specified node. Spans are not counted as child nodes.

Since: 14

Parameters

Name Description
head Node for which to obtain the child nodes.
handle Pointer to the struct containing information about the child nodes of the head node.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeUtils_GetCurrentPageRootNode()

ArkUI_NodeHandle OH_ArkUI_NodeUtils_GetCurrentPageRootNode (ArkUI_NodeHandle node)

Description

Obtains the root node of the current page.

Since: 14

Parameters

Name Description
node Target node.

Returns

Returns the pointer to the root node if the node exists; returns NULL otherwise.

OH_ArkUI_NodeUtils_GetCustomProperty()

int32_t OH_ArkUI_NodeUtils_GetCustomProperty (ArkUI_NodeHandle node, const char * name, ArkUI_CustomProperty ** handle )

Description

Obtains the value of a custom property of the specified component.

Since: 14

Parameters

Name Description
node ArkUI_NodeHandle pointer.
name Name of the custom property.
handle Pointer to the struct that receives the custom property corresponding to the key parameter name.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeUtils_GetLayoutPosition()

int32_t OH_ArkUI_NodeUtils_GetLayoutPosition (ArkUI_NodeHandle node, ArkUI_IntOffset * localOffset )

Description

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.

Since: 12

Parameters

Name Description
node ArkUI_NodeHandle pointer.
localOffset Offset of the component handle relative to the parent component, in pixels.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeUtils_GetLayoutPositionInScreen()

int32_t OH_ArkUI_NodeUtils_GetLayoutPositionInScreen (ArkUI_NodeHandle node, ArkUI_IntOffset * screenOffset )

Description

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.

Since: 12

Parameters

Name Description
node ArkUI_NodeHandle pointer.
screenOffset Offset of the component handle relative to the screen, in pixels.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeUtils_GetLayoutPositionInWindow()

int32_t OH_ArkUI_NodeUtils_GetLayoutPositionInWindow (ArkUI_NodeHandle node, ArkUI_IntOffset * globalOffset )

Description

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.

Since: 12

Parameters

Name Description
node ArkUI_NodeHandle pointer.
globalOffset Offset of the component handle relative to the window, in pixels.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeUtils_GetLayoutSize()

int32_t OH_ArkUI_NodeUtils_GetLayoutSize (ArkUI_NodeHandle node, ArkUI_IntSize * size )

Description

Obtains the layout area size of a component. The size does not count in transformation attributes, such as scale.

Since: 12

Parameters

Name Description
node ArkUI_NodeHandle pointer.
size Size of the layout area, in px.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeUtils_GetNodeType()

int32_t OH_ArkUI_NodeUtils_GetNodeType (ArkUI_NodeHandle node)

Description

Obtains the type of the specified node.

Since: 14

Parameters

Name Description
node Target node.

Returns

Returns the type of the node. Returns -1 if the type is not supported yet. For details about the available types, see ArkUI_NodeType.

OH_ArkUI_NodeUtils_GetParentInPageTree()

ArkUI_NodeHandle OH_ArkUI_NodeUtils_GetParentInPageTree (ArkUI_NodeHandle node)

Description

Obtains the parent node, which can be a component node created with ArkTS.

Since: 14

Parameters

Name Description
node Target node.

Returns

Returns the pointer to the component if the component exists; returns NULL otherwise.

OH_ArkUI_NodeUtils_GetPositionWithTranslateInScreen()

int32_t OH_ArkUI_NodeUtils_GetPositionWithTranslateInScreen (ArkUI_NodeHandle node, ArkUI_IntOffset * translateOffset )

Description

Obtains the position of a component on the screen, including the translate attribute.

Since: 12

Parameters

Name Description
node ArkUI_NodeHandle pointer.
translateOffset Accumulated offset of the component, its parent component, and its ancestor node, in px.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeUtils_GetPositionWithTranslateInWindow()

int32_t OH_ArkUI_NodeUtils_GetPositionWithTranslateInWindow (ArkUI_NodeHandle node, ArkUI_IntOffset * translateOffset )

Description

Obtains the position of a component in the window, including the translate attribute.

Since: 12

Parameters

Name Description
node ArkUI_NodeHandle pointer.
translateOffset Accumulated offset of the component, its parent component, and its ancestor node, in px.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_NodeUtils_IsCreatedByNDK()

bool OH_ArkUI_NodeUtils_IsCreatedByNDK (ArkUI_NodeHandle node)

Description

Checks whether the specified component is created with the C API.

Since: 14

Parameters

Name Description
node Target node.

Returns

Returns 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.

OH_ArkUI_NodeUtils_RemoveCustomProperty()

void OH_ArkUI_NodeUtils_RemoveCustomProperty (ArkUI_NodeHandle node, const char * name )

Description

Removes a custom property that has been set for the specified component.

Since: 13

Parameters

Name Description
node ArkUI_NodeHandle pointer.
name Name of the custom property.

OH_ArkUI_PanGesture_GetOffsetX()

float OH_ArkUI_PanGesture_GetOffsetX (const ArkUI_GestureEvent * event)

Description

Obtains the relative offset of a pan gesture along the x-axis.

Since: 12

Parameters

Name Description
event Gesture event.

Returns

Returns the relative offset of the gesture along the x-axis, in px.

OH_ArkUI_PanGesture_GetOffsetY()

float OH_ArkUI_PanGesture_GetOffsetY (const ArkUI_GestureEvent * event)

Description

Obtains the relative offset of a pan gesture along the y-axis.

Since: 12

Parameters

Name Description
event Gesture event.

Returns

Returns the relative offset of the gesture along the y-axis, in px.

OH_ArkUI_PanGesture_GetVelocity()

float OH_ArkUI_PanGesture_GetVelocity (const ArkUI_GestureEvent * event)

Description

Obtains the velocity of a pan gesture along the main axis.

Since: 12

Parameters

Name Description
event Gesture event.

Returns

Returns 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.

OH_ArkUI_PanGesture_GetVelocityX()

float OH_ArkUI_PanGesture_GetVelocityX (const ArkUI_GestureEvent * event)

Description

Obtains the velocity of a pan gesture along the x-axis.

Since: 12

Parameters

Name Description
event Gesture event.

Returns

Returns the velocity of the pan gesture along the x-axis, in px/s.

OH_ArkUI_PanGesture_GetVelocityY()

float OH_ArkUI_PanGesture_GetVelocityY (const ArkUI_GestureEvent * event)

Description

Obtains the velocity of a pan gesture along the y-axis.

Since: 12

Parameters

Name Description
event Gesture event.

Returns

Returns the velocity of the pan gesture along the y-axis, in px/s.

OH_ArkUI_ParallelInnerGestureEvent_GetConflictRecognizers()

int32_t OH_ArkUI_ParallelInnerGestureEvent_GetConflictRecognizers (ArkUI_ParallelInnerGestureEvent * event, ArkUI_GestureRecognizerHandleArray * array, int32_t * size )

Description

Obtains the conflicting gesture recognizers in a parallel internal gesture event.

Since: 12

Parameters

Name Description
event Parallel internal gesture event.
array Array of conflicting gesture recognizers.
size Size of the conflicting gesture recognizer array.

Returns

Returns 0 if the operation is successful. Returns 401 if a parameter error occurs.

OH_ArkUI_ParallelInnerGestureEvent_GetCurrentRecognizer()

ArkUI_GestureRecognizer* OH_ArkUI_ParallelInnerGestureEvent_GetCurrentRecognizer (ArkUI_ParallelInnerGestureEvent * event)

Description

Obtains the current gesture recognizer in a parallel internal gesture event.

Since: 12

Parameters

Name Description
event Parallel internal gesture event.

Returns

Returns the pointer to the current gesture recognizer.

OH_ArkUI_ParallelInnerGestureEvent_GetUserData()

void* OH_ArkUI_ParallelInnerGestureEvent_GetUserData (ArkUI_ParallelInnerGestureEvent * event)

Description

Obtains custom data in the parallel internal gesture event.

Since: 12

Parameters

Name Description
event Parallel internal gesture event.

Returns

Returns the pointer to custom data.

OH_ArkUI_PinchGesture_GetCenterX()

float OH_ArkUI_PinchGesture_GetCenterX (const ArkUI_GestureEvent * event)

Description

Obtains the X coordinate of the center of the pinch gesture, in vp, relative to the upper left corner of the current component.

Since: 12

Parameters

Name Description
event Gesture event.

Returns Returns the X coordinate of the center of the pinch gesture, in vp, relative to the upper left corner of the current component.

OH_ArkUI_PinchGesture_GetCenterY()

float OH_ArkUI_PinchGesture_GetCenterY (const ArkUI_GestureEvent * event)

Description

Obtains the Y coordinate of the center of the pinch gesture, in vp, relative to the upper left corner of the current component.

Since: 12

Parameters

Name Description
event Gesture event.

Returns

Returns the Y coordinate of the center of the pinch gesture, in vp, relative to the upper left corner of the current component.

OH_ArkUI_PinchGesture_GetScale()

float OH_ArkUI_PinchGesture_GetScale (const ArkUI_GestureEvent * event)

Description

Obtains the scale ratio of a pinch gesture.

Since: 12

Parameters

Name Description
event Gesture event.

Returns

Scale.

OH_ArkUI_QueryModuleInterfaceByName()

void* OH_ArkUI_QueryModuleInterfaceByName (ArkUI_NativeAPIVariantKind type, const char * structName )

Description

Obtains the native API set of a specified type.

Since: 12

Parameters

Name Description
type Type of the native API set provided by ArkUI, for example, ARKUI_NATIVE_NODE or ARKUI_NATIVE_GESTURE.
sturctName Name of a native struct defined in the corresponding header file, for example, ArkUI_NativeNodeAPI_1 in <arkui/native_node.h&gt.

Returns

Returns the pointer to the abstract native API, which can be used after being converted into a specific type. #include<arkui/native_interface.h> #include<arkui/native_node.h> #include<arkui/native_gesture.h> auto* anyNativeAPI = OH_ArkUI_QueryModuleInterfaceByName(ARKUI_NATIVE_NODE, "ArkUI_NativeNodeAPI_1"); if (anyNativeAPI) { auto nativeNodeApi = reinterpret_cast<ArkUI_NativeNodeAPI_1*>(anyNativeAPI); } auto anyGestureAPI = OH_ArkUI_QueryModuleInterface(ARKUI_NATIVE_GESTURE, "ArkUI_NativeGestureAPI_1"); if (anyNativeAPI) { auto basicGestureApi = reinterpret_cast<ArkUI_NativeGestureAPI_1*>(anyGestureAPI); }

OH_ArkUI_RegisterSystemColorModeChangeEvent()

int32_t OH_ArkUI_RegisterSystemColorModeChangeEvent (ArkUI_NodeHandle node, void * userData, void(*)(ArkUI_SystemColorMode colorMode, void *userData) onColorModeChange )

Description

Registers an event listener for system color mode changes. A single component can only register one callback for system color mode changes.

Since: 12

Parameters

Name Description
node Specified node.
userData Custom event parameter, which is passed in the callback when the event is triggered.
onColorModeChange Callback to be executed when the event is triggered.

Returns

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_ATTRIBUTE_OR_EVENT_NOT_SUPPORTED if the event is not supported.

OH_ArkUI_RegisterSystemFontStyleChangeEvent()

int32_t OH_ArkUI_RegisterSystemFontStyleChangeEvent (ArkUI_NodeHandle node, void * userData, void(*)(ArkUI_SystemFontStyleEvent *event, void *userData) onFontStyleChange )

Description

Registers an event listener for system font style changes. A single component can only register one callback for system font style changes.

Since: 12

Parameters

Name Description
node Specified node.
userData Custom event parameter, which is passed in the callback when the event is triggered.
onFontStyleChange Callback to be executed when the event is triggered.

Returns

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_ATTRIBUTE_OR_EVENT_NOT_SUPPORTED if the event is not supported.

OH_ArkUI_RotationGesture_GetAngle()

float OH_ArkUI_RotationGesture_GetAngle (const ArkUI_GestureEvent * event)

Description

Obtains the angle information of a rotation gesture.

Since: 12

Parameters

Name Description
event Gesture event.

Returns

Rotation angle.

OH_ArkUI_SetArkUIGestureRecognizerDisposeNotify()

int32_t OH_ArkUI_SetArkUIGestureRecognizerDisposeNotify (ArkUI_GestureRecognizer * recognizer, ArkUI_GestureRecognizerDestructNotifyCallback callback, void * userData )

Description

Sets a callback function for notifying gesture recognizer destruction.

Parameters

Name Description
recognizer Pointer to the gesture recognizer.
callback Callback function for notifying gesture recognizer destruction.
userData Custom data.

Returns

Returns 0 if the operation is successful. Returns 401 if a parameter error occurs.

OH_ArkUI_SetDragEventStrictReportWithContext()

int32_t OH_ArkUI_SetDragEventStrictReportWithContext (ArkUI_ContextHandle uiContext, bool enabled )

Description

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 UI instance for association.

Since: 12

Parameters

Name Description
uiContext Pointer to the UI instance.
enabled Whether to enable strict reporting on drag events.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_SetDragEventStrictReportWithNode()

int32_t OH_ArkUI_SetDragEventStrictReportWithNode (ArkUI_NodeHandle node, bool enabled )

Description

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.

Since: 12

Parameters

Name Description
node Pointer to a component node.
enabled Whether to enable strict reporting on drag events.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_SetGestureRecognizerEnabled()

int32_t OH_ArkUI_SetGestureRecognizerEnabled (ArkUI_GestureRecognizer * recognizer, bool enabled )

Description

Sets the enabled state of a gesture recognizer.

Since: 12

Parameters

Name Description
recognizer Pointer to the gesture recognizer.
enabled Whether to enable notification.

Returns

Returns 0 if the operation is successful. Returns 401 if a parameter error occurs.

OH_ArkUI_SetNodeAllowedDropDataTypes()

int32_t OH_ArkUI_SetNodeAllowedDropDataTypes (ArkUI_NodeHandle node, const char * typesArray[], int32_t count )

Description

Sets the types of data that can be dropped to the specified component. This API resets the settings configured through OH_ArkUI_DisallowNodeAnyDropDataTypes or OH_ArkUI_AllowNodeAllDropDataTypes.

Since: 12

Parameters

Name Description
node Pointer to a component node.
typesArray Array of data types that can fall into.
count Length of an array.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_SetNodeDraggable()

int32_t OH_ArkUI_SetNodeDraggable (ArkUI_NodeHandle node, bool enabled )

Description

Sets whether the component is draggable.

Since: 12

Parameters

Name Description
node Pointer to a component node.
bool Whether the component is draggable.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_SetNodeDragPreview()

int32_t OH_ArkUI_SetNodeDragPreview (ArkUI_NodeHandle node, OH_PixelmapNative * preview )

Description

Sets a custom drag preview for the specified component.

Since: 12

Parameters

Name Description
node Pointer to the target component node.
preview Custom drag preview, which is a pixel map.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_SetNodeDragPreviewOption()

int32_t OH_ArkUI_SetNodeDragPreviewOption (ArkUI_NodeHandle node, ArkUI_DragPreviewOption * option )

Description

Sets an ArkUI_DragPreviewOption object for the specified component.

Since: 12

Parameters

Name Description
node Pointer to a component node.
option Custom parameters.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_StartDrag()

int32_t OH_ArkUI_StartDrag (ArkUI_DragAction * dragAction)

Description

Initiates a drag action through the specified drag action object.

Since: 12

Parameters

Name Description
dragAction Drag action object.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_StyledString_AddPlaceholder()

void OH_ArkUI_StyledString_AddPlaceholder (ArkUI_StyledString * handle, OH_Drawing_PlaceholderSpan * placeholder )

Description

Adds a placeholder.

Since: 12

Parameters

Name Description
handle Pointer to an ArkUI_StyledString object.
placeholder Pointer to an OH_Drawing_PlaceholderSpan object.

OH_ArkUI_StyledString_AddText()

void OH_ArkUI_StyledString_AddText (ArkUI_StyledString * handle, const char * content )

Description

Sets the text content based on the current format string style.

Since: 12

Parameters

Name Description
handle Pointer to an ArkUI_StyledString object.
content Pointer to the text content.

OH_ArkUI_StyledString_Create()

ArkUI_StyledString* OH_ArkUI_StyledString_Create (OH_Drawing_TypographyStyle * style, OH_Drawing_FontCollection * collection )

Description

Creates an ArkUI_StyledString object.

Since: 12

Parameters

Name Description
style Pointer to an OH_Drawing_TypographyStyle object, which is obtained by calling OH_Drawing_CreateTypographyStyle.
collection Pointer to an OH_Drawing_FontCollection object, which is obtained by calling OH_Drawing_CreateFontCollection.

Returns

Returns 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.

OH_ArkUI_StyledString_CreateTypography()

OH_Drawing_Typography* OH_ArkUI_StyledString_CreateTypography (ArkUI_StyledString * handle)

Description

Creates an OH_Drawing_Typography object based on an ArkUI_StyledString object.

Since: 12

Parameters

Name Description
handle Pointer to an ArkUI_StyledString object.

Returns

Returns 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.

OH_ArkUI_StyledString_Descriptor_Create()

ArkUI_StyledString_Descriptor* OH_ArkUI_StyledString_Descriptor_Create (void )

Description

Creates an ArkUI_StyledString_Descriptor object.

Since: 14

Returns

Pointer to an ArkUI_StyledString_Descriptor object.

OH_ArkUI_StyledString_Descriptor_Destroy()

void OH_ArkUI_StyledString_Descriptor_Destroy (ArkUI_StyledString_Descriptor * descriptor)

Description

Destroys an ArkUI_StyledString_Descriptor object and reclaims the memory occupied by the object.

Since: 14

Parameters

Name Description
descriptor Pointer to an ArkUI_StyledString_Descriptor object.

OH_ArkUI_StyledString_Destroy()

void OH_ArkUI_StyledString_Destroy (ArkUI_StyledString * handle)

Description

Destroys an OH_Drawing_TextStyle object and reclaims the memory occupied by the object.

Since: 12

Parameters

Name Description
handle Pointer to an ArkUI_StyledString object.

OH_ArkUI_StyledString_PopTextStyle()

void OH_ArkUI_StyledString_PopTextStyle (ArkUI_StyledString * handle)

Description

Removes the top style from the current formatted string object.

Since: 12

Parameters

Name Description
handle Pointer to an ArkUI_StyledString object.

OH_ArkUI_StyledString_PushTextStyle()

void OH_ArkUI_StyledString_PushTextStyle (ArkUI_StyledString * handle, OH_Drawing_TextStyle * style )

Description

Sets the new typesetting style to the top of the current format string style stack.

Since: 12

Parameters

Name Description
handle Pointer to an ArkUI_StyledString object.
style Pointer to an OH_Drawing_TextStyle object.

OH_ArkUI_SwipeGesture_GetAngle()

float OH_ArkUI_SwipeGesture_GetAngle (const ArkUI_GestureEvent * event)

Description

Obtains the angle information of the swipe gesture.

Since: 12

Parameters

Name Description
event Gesture event.

Returns

Returns the angle of the swipe gesture, which is the result obtained based on the aforementioned formula.

OH_ArkUI_SwipeGesture_GetVelocity()

float OH_ArkUI_SwipeGesture_GetVelocity (const ArkUI_GestureEvent * event)

Description

Obtains the average velocity of all fingers used in the swipe gesture.

Since: 12

Parameters

Name Description
event Gesture event.

Returns

Returns the average velocity of all fingers used in the swipe gesture, in px/s.

OH_ArkUI_SwiperIndicator_Create()

ArkUI_SwiperIndicator* OH_ArkUI_SwiperIndicator_Create (ArkUI_SwiperIndicatorType type)

Description

Creates a navigation indicator for the Swiper component.

Since: 12

Parameters

Name Description
type Type of the navigation indicator.

Returns

Returns the pointer to the navigation point indicator.

OH_ArkUI_SwiperIndicator_Dispose()

void OH_ArkUI_SwiperIndicator_Dispose (ArkUI_SwiperIndicator * indicator)

Description

Disposes of the navigation point indicator of this Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.

OH_ArkUI_SwiperIndicator_GetBottomPosition()

float OH_ArkUI_SwiperIndicator_GetBottomPosition (ArkUI_SwiperIndicator * indicator)

Description

Obtains the distance between the navigation point indicator and the bottom edge of the Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.

Returns

Returns the distance between a navigation point indicator and the bottom edge of the Swiper component.

OH_ArkUI_SwiperIndicator_GetColor()

uint32_t OH_ArkUI_SwiperIndicator_GetColor (ArkUI_SwiperIndicator * indicator)

Description

Obtains the color of a navigation point indicator of the dot style of the Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.

Returns

Returns the color, in 0xARGB format. For example, 0xFFFF0000 indicates red.

OH_ArkUI_SwiperIndicator_GetEndPosition()

float OH_ArkUI_SwiperIndicator_GetEndPosition (ArkUI_SwiperIndicator * indicator)

Description

Obtains the distance between a navigation point indicator and the right edge of the Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.

Returns

Returns the distance between the navigation point indicator and the right edge of the Swiper component.

OH_ArkUI_SwiperIndicator_GetItemHeight()

float OH_ArkUI_SwiperIndicator_GetItemHeight (ArkUI_SwiperIndicator * indicator)

Description

Obtains the height of a navigation point indicator of the dot style of the Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.

Returns

Returns the height of the navigation point indicator of the dot style.

OH_ArkUI_SwiperIndicator_GetItemWidth()

float OH_ArkUI_SwiperIndicator_GetItemWidth (ArkUI_SwiperIndicator * indicator)

Description

Obtains the width of a navigation point indicator of the dot style of the Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.

Returns

Returns the width of the navigation point indicator of the dot style.

OH_ArkUI_SwiperIndicator_GetMask()

int32_t OH_ArkUI_SwiperIndicator_GetMask (ArkUI_SwiperIndicator * indicator)

Description

Obtains whether the mask is enabled for a navigation point indicator of the dot style of the Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.

Returns

Returns 1 if the mask is enabled; returns 0 otherwise.

OH_ArkUI_SwiperIndicator_GetMaxDisplayCount()

int32_t OH_ArkUI_SwiperIndicator_GetMaxDisplayCount (ArkUI_SwiperIndicator * indicator)

Description

Obtains the maximum number of dots for the navigation point indicator of the dot style.

Since: 12

Parameters

Name Description
indicator Pointer to the navigation point indicator.

Returns

Returns the maximum number of dots. The value ranges from 6 to 9.

OH_ArkUI_SwiperIndicator_GetSelectedColor()

uint32_t OH_ArkUI_SwiperIndicator_GetSelectedColor (ArkUI_SwiperIndicator * indicator)

Description

Obtains the color of the selected navigation point indicator of the dot style of the Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.

Returns

Returns the color, in 0xARGB format. For example, 0xFFFF0000 indicates red.

OH_ArkUI_SwiperIndicator_GetSelectedItemHeight()

float OH_ArkUI_SwiperIndicator_GetSelectedItemHeight (ArkUI_SwiperIndicator * indicator)

Description

Obtains the height of the selected navigation point indicator of the dot style of the Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.

Returns

Returns the height of the navigation point indicator of the dot style.

OH_ArkUI_SwiperIndicator_GetSelectedItemWidth()

float OH_ArkUI_SwiperIndicator_GetSelectedItemWidth (ArkUI_SwiperIndicator * indicator)

Description

Obtains the width of the selected navigation point indicator of the dot style of the Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.

Returns

Returns the width of the navigation point indicator of the dot style.

OH_ArkUI_SwiperIndicator_GetStartPosition()

float OH_ArkUI_SwiperIndicator_GetStartPosition (ArkUI_SwiperIndicator * indicator)

Description

Obtains the distance between a navigation point indicator and the left edge of the Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.

Returns

Returns the distance between the navigation point indicator and the left edge of the Swiper component.

OH_ArkUI_SwiperIndicator_GetTopPosition()

float OH_ArkUI_SwiperIndicator_GetTopPosition (ArkUI_SwiperIndicator * indicator)

Description

Obtains the distance between the navigation point indicator and the top edge of the Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.

Returns

Returns the distance between a navigation point indicator and the top edge of the Swiper component.

OH_ArkUI_SwiperIndicator_SetBottomPosition()

void OH_ArkUI_SwiperIndicator_SetBottomPosition (ArkUI_SwiperIndicator * indicator, float value )

Description

Sets the distance between the navigation point indicator and the bottom edge of the Swiper component.

Since: 12

Parameters

Name Description
indicator Pointer to a navigation point indicator.
value Distance between a navigation point indicator and the bottom edge of the Swiper component.

OH_ArkUI_SwiperIndicator_SetColor()

void OH_ArkUI_SwiperIndicator_SetColor (ArkUI_SwiperIndicator * indicator, uint32_t color )

Description

Sets the color of a navigation point indicator of the dot style for the Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.
color Color, in 0xARGB format. For example, 0xFFFF0000 indicates red.

OH_ArkUI_SwiperIndicator_SetEndPosition()

void OH_ArkUI_SwiperIndicator_SetEndPosition (ArkUI_SwiperIndicator * indicator, float value )

Description

Distance between the navigation point indicator and the left edge of the Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.
value Returns the distance between the navigation point indicator and the right edge of the Swiper component.

OH_ArkUI_SwiperIndicator_SetItemHeight()

void OH_ArkUI_SwiperIndicator_SetItemHeight (ArkUI_SwiperIndicator * indicator, float value )

Description

Sets the height of a navigation point indicator of the dot style for the Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.
value Returns the height of the navigation point indicator of the dot style.

OH_ArkUI_SwiperIndicator_SetItemWidth()

void OH_ArkUI_SwiperIndicator_SetItemWidth (ArkUI_SwiperIndicator * indicator, float value )

Description

Sets the width of a navigation point indicator of the dot style for the Swiper component.

Since: 12

Parameters

Name Description
indicator Returns the pointer to the navigation point indicator.
value Returns the width of the navigation point indicator of the dot style.

OH_ArkUI_SwiperIndicator_SetMask()

void OH_ArkUI_SwiperIndicator_SetMask (ArkUI_SwiperIndicator * indicator, int32_t mask )

Description

Sets whether to enable the mask for a navigation point indicator of the dot style for the Swiper component.

Since: 12

Parameters

Name Description
indicator Pointer to a navigation point indicator.
mask Whether to enable the mask. The value 1 means to enable the mask, and 0 means the opposite.

OH_ArkUI_SwiperIndicator_SetMaxDisplayCount()

int32_t OH_ArkUI_SwiperIndicator_SetMaxDisplayCount (ArkUI_SwiperIndicator * indicator, int32_t maxDisplayCount )

Description

Sets the maximum number of dots for the navigation point indicator of the dot style.

Since: 12

Parameters

Name Description
indicator Pointer to a navigation point indicator.
maxDisplayCount Maximum number of navigation points. The value ranges from 6 to 9.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if maxDisplayCount is set to an invalid value.

OH_ArkUI_SwiperIndicator_SetSelectedColor()

void OH_ArkUI_SwiperIndicator_SetSelectedColor (ArkUI_SwiperIndicator * indicator, uint32_t selectedColor )

Description

Sets the color of the selected navigation point indicator of the dot style for the Swiper component.

Since: 12

Parameters

Name Description
indicator Pointer to a navigation point indicator.
selectedColor Color, in 0xARGB format. For example, 0xFFFF0000 indicates red.

OH_ArkUI_SwiperIndicator_SetSelectedItemHeight()

void OH_ArkUI_SwiperIndicator_SetSelectedItemHeight (ArkUI_SwiperIndicator * indicator, float value )

Description

Sets the height of the selected navigation point indicator of the dot style for the Swiper component.

Since: 12

Parameters

Name Description
indicator Pointer to a navigation point indicator.
value Height of the navigation point indicator of the dot style.

OH_ArkUI_SwiperIndicator_SetSelectedItemWidth()

void OH_ArkUI_SwiperIndicator_SetSelectedItemWidth (ArkUI_SwiperIndicator * indicator, float value )

Description

Sets the width of the selected navigation point indicator of the dot style for the Swiper component.

Since: 12

Parameters

Name Description
indicator Pointer to a navigation point indicator.
value Width of the navigation point indicator of the dot style.

OH_ArkUI_SwiperIndicator_SetStartPosition()

void OH_ArkUI_SwiperIndicator_SetStartPosition (ArkUI_SwiperIndicator * indicator, float value )

Description

Sets the distance between the navigation point indicator and the left edge of the Swiper component.

Since: 12

Parameters

Name Description
indicator Pointer to a navigation point indicator.
value Distance between the navigation point indicator and the left edge of the Swiper component.

OH_ArkUI_SwiperIndicator_SetTopPosition()

void OH_ArkUI_SwiperIndicator_SetTopPosition (ArkUI_SwiperIndicator * indicator, float value )

Description

Sets the distance between the navigation point indicator and the top edge of the Swiper component.

Since: 12

Parameters

Name Description
indicator Pointer to a navigation point indicator.
value Distance between a navigation point indicator and the top edge of the Swiper component.

OH_ArkUI_SystemFontStyleEvent_GetFontSizeScale()

float OH_ArkUI_SystemFontStyleEvent_GetFontSizeScale (const ArkUI_SystemFontStyleEvent * event)

Description

Obtains the font size scale from the system font style change event.

Since: 12

Parameters

Name Description
event Pointer to the current system font style change event.

Returns

Returns the font size scale after the change. Default value: 1.0.

OH_ArkUI_SystemFontStyleEvent_GetFontWeightScale()

float OH_ArkUI_SystemFontStyleEvent_GetFontWeightScale (const ArkUI_SystemFontStyleEvent * event)

Description

Obtains the font weight scale from the system font style change event.

Since: 12

Parameters

Name Description
event Pointer to the current system font style change event.

Returns

Returns the font weight scale after the change. Default value: 1.0.

OH_ArkUI_TransitionEffect_Combine()

int32_t OH_ArkUI_TransitionEffect_Combine (ArkUI_TransitionEffect * option, ArkUI_TransitionEffect * combine )

Description

Sets a combination of transition effects.

Since: 12

Parameters

Name Description
option Transition effect options.
combine Combination of transition effects.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_TransitionEffect_Dispose()

void OH_ArkUI_TransitionEffect_Dispose (ArkUI_TransitionEffect * option)

Description

Destroys a transition effect object.

Since: 12

Parameters

Name Description
option Transition effect object.

OH_ArkUI_TransitionEffect_SetAnimation()

int32_t OH_ArkUI_TransitionEffect_SetAnimation (ArkUI_TransitionEffect * option, ArkUI_AnimateOption * animation )

Description

Sets transition effect animation settings.

Since: 12

Parameters

Name Description
option Transition effect options.
animation Animation settings.

NOTE

If combine is used for combining transition effects, the animation settings of a transition effect are applicable to the one following it.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_UnmarshallStyledStringDescriptor()

int32_t OH_ArkUI_UnmarshallStyledStringDescriptor (uint8_t * buffer, size_t bufferSize, ArkUI_StyledString_Descriptor * descriptor, size_t * resultSize )

Description

Deserializes a byte array containing styled string information into a styled string.

Since: 14

Parameters

Name Description
buffer Byte array to be deserialized.
bufferSize Length of the byte array.
descriptor Pointer to an ArkUI_StyledString_Descriptor object.
resultSize Actual length of the resulting byte array after deserialization.

Returns

Returns ARKUI_ERROR_CODE_NO_ERROR if the operation is successful. Returns ARKUI_ERROR_CODE_PARAM_INVALID if a parameter error occurs.

OH_ArkUI_UnregisterSystemColorModeChangeEvent()

void OH_ArkUI_UnregisterSystemColorModeChangeEvent (ArkUI_NodeHandle node)

Description

Unregisters the event listener for system color mode changes.

Since: 12

Parameters

Name Description
node Specified node.

OH_ArkUI_UnregisterSystemFontStyleChangeEvent()

void OH_ArkUI_UnregisterSystemFontStyleChangeEvent (ArkUI_NodeHandle node)

Description

Unregisters the event listener for system font style changes.

Since: 12

Parameters

Name Description
node Specified node.

OH_ArkUI_WaterFlowSectionOption_Create()

ArkUI_WaterFlowSectionOption* OH_ArkUI_WaterFlowSectionOption_Create ()

Description

Creates a water flow section configuration.

Since: 12

Returns

Return the pointer to the created water flow section configuration.

OH_ArkUI_WaterFlowSectionOption_Dispose()

void OH_ArkUI_WaterFlowSectionOption_Dispose (ArkUI_WaterFlowSectionOption * option)

Description

Disposes of the pointer to a water flow section configuration.

Since: 12

Parameters

Name Description
option Pointer to a water flow section configuration.

OH_ArkUI_WaterFlowSectionOption_GetColumnGap()

float OH_ArkUI_WaterFlowSectionOption_GetColumnGap (ArkUI_WaterFlowSectionOption * option, int32_t index )

Description

Obtains the gap between columns in the water flow section that matches the specified index.

Since: 12

Parameters

Name Description
option Pointer to a water flow section configuration.
index Index of the target water flow section.

Returns

Returns the gap between columns.

OH_ArkUI_WaterFlowSectionOption_GetCrossCount()

int32_t OH_ArkUI_WaterFlowSectionOption_GetCrossCount (ArkUI_WaterFlowSectionOption * option, int32_t index )

Description

Obtains the number of columns (in a vertical layout) or rows (in a horizontal layout) of a water flow.

Since: 12

Parameters

Name Description
option Pointer to a water flow section configuration.
index Index of the target water flow section.

Returns

Returns the number of columns (in a vertical layout) or rows (in a horizontal layout) of a water flow.

OH_ArkUI_WaterFlowSectionOption_GetItemCount()

int32_t OH_ArkUI_WaterFlowSectionOption_GetItemCount (ArkUI_WaterFlowSectionOption * option, int32_t index )

Description

Obtains the number of items in the water flow section that matches the specified index.

Since: 12

Parameters

Name Description
option Pointer to a water flow section configuration.
index Index of the target water flow section.

Returns

Returns the number of items in the water flow section.

OH_ArkUI_WaterFlowSectionOption_GetMargin()

ArkUI_Margin OH_ArkUI_WaterFlowSectionOption_GetMargin (ArkUI_WaterFlowSectionOption * option, int32_t index )

Description

Obtains the margins of the water flow section that matches the specified index.

Since: 12

Parameters

Name Description
option Pointer to a water flow section configuration.
index Index of the target water flow section.

Returns

Returns the margins.

OH_ArkUI_WaterFlowSectionOption_GetRowGap()

float OH_ArkUI_WaterFlowSectionOption_GetRowGap (ArkUI_WaterFlowSectionOption * option, int32_t index )

Description

Obtains the gap between rows in the water flow section that matches the specified index.

Since: 12

Parameters

Name Description
option Pointer to a water flow section configuration.
index Index of the target water flow section.

Returns

Returns the gap between rows.

OH_ArkUI_WaterFlowSectionOption_GetSize()

int32_t OH_ArkUI_WaterFlowSectionOption_GetSize (ArkUI_WaterFlowSectionOption * option)

Description

Sets the array length for a water flow section configuration.

Since: 12

Parameters

Name Description
option Pointer to a water flow section configuration.

Returns

Returns 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.

OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndex()

void OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndex (ArkUI_WaterFlowSectionOption * option, int32_t index, float(*)(int32_t itemIndex) callback )

Description

Obtains the main axis size of a specified item based on flowItemIndex through a water flow section configuration.

Since: 12

Parameters

Name Description
option Pointer to a water flow section configuration.
index Index of the target water flow section.
callback Callback used to return the result.

OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndexWithUserData()

void OH_ArkUI_WaterFlowSectionOption_RegisterGetItemMainSizeCallbackByIndexWithUserData (ArkUI_WaterFlowSectionOption * option, int32_t index, void * userData, float(*)(int32_t itemIndex, void *userData) callback )

Description

Obtains the main axis size of a specified item based on flowItemIndex through a water flow section configuration.

Since: 12

Parameters

Name Description
option Pointer to a water flow section configuration.
index Index of the target water flow section.
userData Custom data of the water flow item.
callback Callback used to return the result.

OH_ArkUI_WaterFlowSectionOption_SetColumnGap()

void OH_ArkUI_WaterFlowSectionOption_SetColumnGap (ArkUI_WaterFlowSectionOption * , int32_t index, float columnGap )

Description

Sets the gap between columns in the specified water flow section.

Since: 12

Parameters

Name Description
option Pointer to a water flow section configuration.
index Index of the target water flow section.
columnGap Gap between columns.

OH_ArkUI_WaterFlowSectionOption_SetCrossCount()

void OH_ArkUI_WaterFlowSectionOption_SetCrossCount (ArkUI_WaterFlowSectionOption * option, int32_t index, int32_t crossCount )

Description

Sets the number of columns (in a vertical layout) or rows (in a horizontal layout) of a water flow.

Since: 12

Parameters

Name Description
option Pointer to a water flow section configuration.
index Index of the target water flow section.
crossCount Number of columns or rows, depending on the layout direction.

OH_ArkUI_WaterFlowSectionOption_SetItemCount()

void OH_ArkUI_WaterFlowSectionOption_SetItemCount (ArkUI_WaterFlowSectionOption * option, int32_t index, int32_t itemCount )

Description

Sets the number of items in a water flow section.

Since: 12

Parameters

Name Description
option Pointer to a water flow section configuration.
index Index of the target water flow section.
itemCount Number of items in the water flow section.

OH_ArkUI_WaterFlowSectionOption_SetMargin()

void OH_ArkUI_WaterFlowSectionOption_SetMargin (ArkUI_WaterFlowSectionOption * option, int32_t index, float marginTop, float marginRight, float marginBottom, float marginLeft )

Description

Sets the margins for the specified water flow section.

Since: 12

Parameters

Name Description
option Pointer to a water flow section configuration.
index Index of the target water flow section.
marginTop Top margin of the water flow section.
marginRight Right margin of the water flow section.
marginBottom Bottom margin of the water flow section.
marginLeft Left margin of the water flow section.

OH_ArkUI_WaterFlowSectionOption_SetRowGap()

void OH_ArkUI_WaterFlowSectionOption_SetRowGap (ArkUI_WaterFlowSectionOption * option, int32_t index, float rowGap )

Description

Sets the gap between rows in the specified water flow section.

Since: 12

Parameters

Name Description
option Pointer to a water flow section configuration.
index Index of the target water flow section.
rowGap Gap between rows to set.

OH_ArkUI_WaterFlowSectionOption_SetSize()

void OH_ArkUI_WaterFlowSectionOption_SetSize (ArkUI_WaterFlowSectionOption * option, int32_t size )

Description

Sets the array length for a water flow section configuration.

Since: 12

Parameters

Name Description
option Pointer to a water flow section configuration.
size Size of the array.