diff --git a/arkui/ace_engine/native/BUILD.gn b/arkui/ace_engine/native/BUILD.gn index fc81f31253973838bb3ca1c86feff3787eca73d5..d29b8ce34606a43936f4c274b40eedebf2168b5e 100644 --- a/arkui/ace_engine/native/BUILD.gn +++ b/arkui/ace_engine/native/BUILD.gn @@ -23,6 +23,16 @@ if (!is_arkui_x) { ] } + ohos_ndk_headers("arkui_header") { + dest_dir = "$ndk_headers_out_dir/arkui/" + sources = [ + "native_event.h", + "native_interface.h", + "native_node.h", + "native_type.h", + ] + } + ohos_ndk_library("libace_ndk") { ndk_description_file = "./libace.ndk.json" min_compact_version = "7" diff --git a/arkui/ace_engine/native/libace.ndk.json b/arkui/ace_engine/native/libace.ndk.json index c8af1edc168c53d2e35363f88aebf819190c8145..90e2f0ae30ea59d97b6a190fb9a052e0dc2f89df 100644 --- a/arkui/ace_engine/native/libace.ndk.json +++ b/arkui/ace_engine/native/libace.ndk.json @@ -90,5 +90,17 @@ { "first_introduced": "11", "name": "OH_NativeXComponent_UnregisterOnFrameCallback" + }, + { + "first_introduced": "12", + "name": "OH_NativeXComponent_AttachNativeRootNode" + }, + { + "first_introduced": "12", + "name": "OH_NativeXComponent_DetachNativeRootNode" + }, + { + "first_introduced": "12", + "name": "OH_ArkUI_GetNativeAPI" } ] \ No newline at end of file diff --git a/arkui/ace_engine/native/native_event.h b/arkui/ace_engine/native/native_event.h new file mode 100644 index 0000000000000000000000000000000000000000..2e39960ba6d80ae1ba6bf013a2895e375503581b --- /dev/null +++ b/arkui/ace_engine/native/native_event.h @@ -0,0 +1,228 @@ +/* + * Copyright (c) 2024 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * @addtogroup ArkUI_NativeModule + * @{ + * + * @brief 提供ArkUI在Native侧的UI能力，如UI组件创建销毁、树节点操作，属性设置，事件监听等。 + * + * @since 12 + */ + +/** + * @file native_event.h + * + * @brief 提供ArkUI在Native侧的事件类型定义集合。 + * + * @library libace_ndk.z.so + * @syscap SystemCapability.ArkUI.ArkUI.Full + * @since 12 + */ + +#ifndef ARKUI_NATIVE_EVENT +#define ARKUI_NATIVE_EVENT + +#include +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * @brief Touch事件的工具类型定义。 + * + * @since 12 + */ +typedef enum { + /** 不支持的工具类型。 */ + NODE_TOOL_TYPE_UNKNOWN = -1, + + /** 手指。 */ + NODE_TOOL_TYPE_FINGER = 0, + + /** 笔。 */ + NODE_TOOL_TYPE_PEN = 1, +} ArkUI_NodeToolType; + +/** + * @brief 产生Touch事件的来源类型定义。 + * + * @since 12 + */ +typedef enum { + /** 不支持的来源类型。 */ + NODE_SOURCE_TYPE_UNKNOWN = -1, + /** 触摸屏。 */ + NODE_SOURCE_TYPE_TOUCH_SCREEN = 0, + /** 手写笔。 */ + NODE_SOURCE_TYPE_PEN = 1, + /** 触控板。 */ + NODE_SOURCE_TYPE_TOUCH_PAD = 2, +} ArkUI_NodeSourceType; + +/** + * @brief 定义Touch事件触控点信息的数据结构。 + * + * @since 12 + */ +typedef struct { + /** 触控事件标识。 */ + int32_t id; + + /** 手指按下的时间戳，单位为微秒（us）。*/ + int64_t pressedTime; + + /** 触摸位置所属的屏幕X坐标。 */ + int32_t screenX; + + /** 触摸位置所属的屏幕Y坐标。 */ + int32_t screenY; + + /** 触摸位置在窗口中的X坐标。 */ + int32_t windowX; + + /** 触摸位置在窗口中的Y坐标。 */ + int32_t windowY; + + /** 触摸位置在当前触发事件组件中的X坐标。 */ + int32_t nodeX; + + /** 触摸位置在当前触发事件组件中的Y坐标。 */ + int32_t nodeY; + + /** 压力值，取值范围是[0.0, 1.0]，0.0表示不支持。 */ + double pressure; + + /** 触摸区域的宽度。 */ + int32_t contactAreaWidth; + + /** 触摸区域的高度。 */ + int32_t contactAreaHeight; + + /** 相对YZ平面的角度，取值范围是[-90, 90]，其中正值是向右倾斜。 */ + double tiltX; + + /** 相对XZ平面的角度，取值范围是[-90, 90]，其中正值是向下倾斜。 */ + double tiltY; + + /** 工具区域的中心点X坐标。 */ + int32_t toolX; + + /** 工具区域的中心点Y坐标。 */ + int32_t toolY; + + /** 工具接触区域的宽度。 */ + int32_t toolWidth; + + /** 工具接触区域的高度。 */ + int32_t toolHeight; + + /** 输入设备上的X坐标。 */ + int32_t rawX; + + /** 输入设备上的Y坐标。 */ + int32_t rawY; + + /** 工具类型。 */ + ArkUI_NodeToolType toolType; +} ArkUI_NodeTouchPoint; + +/** + * @brief 定义触屏事件类型的枚举值。 + * + * @since 12 + */ +typedef enum { + /** 触摸取消。 */ + NODE_ACTION_CANCEL = 0, + /** 触摸按下。 */ + NODE_ACTION_DOWN = 1, + /** 触摸移动。 */ + NODE_ACTION_MOVE = 2, + /** 触摸抬起。 */ + NODE_ACTION_UP = 3, +} ArkUI_NodeTouchEventAction; + +/** + * @brief 定义历史点信息的结构类型。 + * + * @since 12 + */ +typedef struct { + /** 触屏事件类型。*/ + ArkUI_NodeTouchEventAction action; + /** 触屏历史事件时间戳，单位为微秒（us）。*/ + int64_t timeStamp; + /** 历史触摸事件来源类型。*/ + ArkUI_NodeTouchPoint actionTouch; + /** 历史触摸事件来源类型。*/ + ArkUI_NodeSourceType sourceType; +} ArkUI_NodeHistoricalTouchPoint; + +/** + * @brief 定义Touch事件的结构类型。 + * + * @since 12 + */ +typedef struct { + /** 触屏事件的类型。*/ + ArkUI_NodeTouchEventAction action; + + /** 触屏事件时间戳，单位为微秒（us）。 */ + int64_t timeStamp; + + /** 当前触屏事件的触控点信息。*/ + ArkUI_NodeTouchPoint actionTouch; + + /** + * @brief 返回此事件发生时所有屏幕接触点信息。 + * + * ArkUI会在该函数调用时创建触控点信息数组的缓存内存对象并返回指针，开发者不需要调用delete删除内存，框架会在下次事件到来时覆盖该缓存。 + * + * @param points 用来接受数据的指针对象。 + * @return 屏幕接触点数据数组元素数量。 + * + */ + int32_t (*getTouches)(ArkUI_NodeTouchPoint** points); + + /** + * @brief 返回此事件中的历史点信息。这些是在此事件和上一个事件之间发生的运动。 + * + * ArkUI会在该函数调用时创建触控点信息数组的缓存内存对象并返回指针，开发者不需要调用delete删除内存，框架会在下次事件到来时覆盖该缓存。 + * + * @param points 用来接受数据的指针对象。 + * @return 历史点数据数组元素数量。 + * + */ + int32_t (*getHistoricalPoints)(ArkUI_NodeHistoricalTouchPoint** historicalPoints); + + /** 触发事件来源的类型。*/ + ArkUI_NodeSourceType sourceType; + + /** 阻止事件进一步向父节点冒泡处理。*/ + bool stopPropagation; + + /** 阻止当前节点的默认事件处理行为，允许事件进一步向上冒泡。*/ + bool preventDefault; +} ArkUI_NodeTouchEvent; + +#ifdef __cplusplus +}; +#endif + +#endif // ARKUI_NATIVE_EVENT +/** @} */ diff --git a/arkui/ace_engine/native/native_interface.h b/arkui/ace_engine/native/native_interface.h new file mode 100644 index 0000000000000000000000000000000000000000..759fcbf6b611f2991a027bf0d6ed5a85ef87c8c8 --- /dev/null +++ b/arkui/ace_engine/native/native_interface.h @@ -0,0 +1,93 @@ +/* + * Copyright (c) 2024 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * @addtogroup ArkUI_NativeModule + * @{ + * + * @brief 提供ArkUI在Native侧的UI能力，如UI组件创建销毁、树节点操作，属性设置，事件监听等。 + * + * @since 12 + */ + +/** + * @file native_interface.h + * + * @brief 提供NativeModule接口的统一入口函数。 + * + * @library libace_ndk.z.so + * @syscap SystemCapability.ArkUI.ArkUI.Full + * @since 12 + */ + +#ifndef ARKUI_NATIVE_INTERFACE_H +#define ARKUI_NATIVE_INTERFACE_H + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * @brief 定义任意版本的Native接口类型。 + * + * @since 12 + */ +typedef struct { + /** + * @brief 定义Native接口集合的版本信息。 + * + * 不同于NDK版本，NativeNode接口的version字段标识自身结构体的版本信息。 + */ + int32_t version; +} ArkUI_AnyNativeAPI; + +/** + * @brief 定义Native接口集合类型。 + * + * @since 12 + */ +typedef enum { + /** UI组件相关接口类型。*/ + ARKUI_NATIVE_NODE, +} ArkUI_NativeAPIVariantKind; + +/** + * @brief 获取指定版本的Native接口集合。 + * + * @param type ArkUI提供的Native接口集合大类，例如UI组件接口类：ARKUI_NATIVE_NODE。 + * @param version native接口结构体的版本信息，通过结构体定义的后缀获得，如版本1的UI组件结构体：ArkUI_NativeNodeAPI_1。 + * @return ArkUI_AnyNativeAPI* 返回携带版本的Native接口抽象对象。 + * @code {.cpp} + * #include + * #include + * + * auto anyNativeAPI = OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1); + * if (anyNativeAPI->version == 1) { + * auto basicNodeApi = reinterpret_cast(anyNativeAPI); + * } + * @endcode + * + * @since 12 + */ +ArkUI_AnyNativeAPI* OH_ArkUI_GetNativeAPI(ArkUI_NativeAPIVariantKind type, int32_t version); + +#ifdef __cplusplus +}; +#endif + +#endif // ARKUI_NATIVE_INTERFACE_H +/** @} */ diff --git a/arkui/ace_engine/native/native_interface_xcomponent.h b/arkui/ace_engine/native/native_interface_xcomponent.h index e68de8f0df35581a8a57c4bfdfaf38c6edc2e58a..071dffcd90737e2143dc27c9bece759b1b940087 100644 --- a/arkui/ace_engine/native/native_interface_xcomponent.h +++ b/arkui/ace_engine/native/native_interface_xcomponent.h @@ -42,6 +42,8 @@ #include #endif +#include "arkui/native_type.h" + #include "native_xcomponent_key_event.h" #ifdef __cplusplus @@ -624,6 +626,29 @@ int32_t OH_NativeXComponent_RegisterOnFrameCallback(OH_NativeXComponent* compone */ int32_t OH_NativeXComponent_UnregisterOnFrameCallback(OH_NativeXComponent* component); +/** + * @brief 将通过ArkUI的native接口创建出来的UI组件挂载到当前XComponent上。 + * + * @param component 表示指向OH_NativeXComponent实例的指针。 + * @param root 指向Native接口创建的组件实例的指针。 + * @return 0 - 成功。 + * 401 - 参数异常。 + * + * @since 12 + */ +int32_t OH_NativeXComponent_AttachNativeRootNode(OH_NativeXComponent* component, ArkUI_NodeHandle root); + +/** + * @brief 将ArkUI的native组件从当前XComponent上卸载. + * + * @param component 表示指向OH_NativeXComponent实例的指针。 + * @param root 指向Native接口创建的组件实例的指针。 + * @return 0 - 成功。 + * 401 - 参数异常。 + * + * @since 12 + */ +int32_t OH_NativeXComponent_DetachNativeRootNode(OH_NativeXComponent* component, ArkUI_NodeHandle root); #ifdef __cplusplus }; diff --git a/arkui/ace_engine/native/native_node.h b/arkui/ace_engine/native/native_node.h new file mode 100644 index 0000000000000000000000000000000000000000..369c6fa424678947911b42294f924c3e23d8994c --- /dev/null +++ b/arkui/ace_engine/native/native_node.h @@ -0,0 +1,3203 @@ +/* + * Copyright (c) 2024 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * @addtogroup ArkUI_NativeModule + * @{ + * + * @brief 提供ArkUI在Native侧的UI能力，如UI组件创建销毁、树节点操作，属性设置，事件监听等。 + * + * @since 12 + */ + +/** + * @file native_node.h + * + * @brief 提供NativeNode接口的类型定义。 + * + * @library libace_ndk.z.so + * @syscap SystemCapability.ArkUI.ArkUI.Full + * @since 12 + */ + +#ifndef ARKUI_NATIVE_NODE_H +#define ARKUI_NATIVE_NODE_H + +#include "native_event.h" +#include "native_type.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#define MAX_NODE_SCOPE_NUM 1000 + +/** + * @brief 提供ArkUI在Native侧可创建组件类型。 + * + * @since 12 + */ +typedef enum { + /** 文本。 */ + ARKUI_NODE_TEXT = 1, + /** 图片。 */ + ARKUI_NODE_IMAGE = 4, + /** 状态开关。 */ + ARKUI_NODE_TOGGLE = 5, + + /** 堆叠容器。 */ + ARKUI_NODE_STACK = MAX_NODE_SCOPE_NUM, + /** 翻页容器。 */ + ARKUI_NODE_SWIPER, + /** 滚动容器。 */ + ARKUI_NODE_SCROLL, + /** 列表。 */ + ARKUI_NODE_LIST, + /** 列表项。 */ + ARKUI_NODE_LIST_ITEM, + /** 列表item分组。 */ + ARKUI_NODE_LIST_ITEM_GROUP, +} ArkUI_NodeType; + +/** + * @brief 定义{@link setAttribute}函数通用入参结构。 + * + * @since 12 + */ +typedef struct { + /** 数字类型数组。*/ + const ArkUI_NumberValue* value; + /** 数字类型数组大小。*/ + int32_t size; + /** 字符串类型。*/ + const char* string; + /** 对象类型。*/ + void* object; +} ArkUI_AttributeItem; + +/** + * @brief 定义ArkUI在Native侧可以设置的属性样式集合。 + * + * @since 12 + */ +typedef enum { + /** + * @brief 宽度属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32：宽度数值，单位为vp；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32：宽度数值，单位为vp；\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 1.2 }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_WIDTH, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_WIDTH); + * auto nodeWidth = item->value[0].f32; + * @endcode + * + */ + NODE_WIDTH = 0, + /** + * @brief 高度属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32：高度数值，单位为vp；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32：高度数值，单位为vp；\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 1.2 }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_HEIGHT, &item);clang-tid + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_HEIGHT); + * auto nodeHeight = item->value[0].f32; + * @endcode + * + */ + NODE_HEIGHT, + /** + * @brief 背景色属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].u32：背景色数值，0xargb格式，形如 0xFFFF0000 表示红色；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].u32：背景色数值，0xargb格式，形如 0xFFFF0000 表示红色；\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.u32=0xFFFF0000} }; + * ArkUI_AttributeItem item = { value, 1 }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_BACKGROUND_COLOR, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_BACKGROUND_COLOR); + * auto nodeBackgroundColor = item->value[0].u32; + * @endcode + * + */ + NODE_BACKGROUND_COLOR, + /** + * @brief 背景色图片属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .string: 图片地址；\n + * .value[0]?.i32：可选值，repeat参数，参数类型{@link ArkUI_ImageRepeat}，默认值为ARKUI_IMAGE_REPEAT_NO_REPEAT；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .string: 图片地址；\n + * .value[0].i32：repeat参数，参数类型{@link ArkUI_ImageRepeat}；\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32 = ARKUI_IMAGE_REPEAT_NO_REPEAT} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue), "/pages/icon.png" }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_BACKGROUND_IMAGE, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_BACKGROUND_IMAGE); + * auto nodeBackgroundImageUrl = item->string; + * auto nodeBackgroundImageRepeat = item->value[0].i32; + * @endcode + * + */ + NODE_BACKGROUND_IMAGE, + /** + * @brief 内间距属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式有两种：\n + * 1：上下左右四个位置的内间距值相等。\n + * .value[0].f32：内间距数值，单位为vp；\n + * 2：分别指定上下左右四个位置的内间距值。\n + * .value[0].f32：上内间距数值，单位为vp；\n + * .value[1].f32：右内间距数值，单位为vp；\n + * .value[2].f32：下内间距数值，单位为vp；\n + * .value[3].f32：左内间距数值，单位为vp；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32：上内间距数值，单位为vp；\n + * .value[1].f32：右内间距数值，单位为vp；\n + * .value[2].f32：下内间距数值，单位为vp；\n + * .value[3].f32：左内间距数值，单位为vp；\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value1[] = { 1, 2, 3, 4}; + * ArkUI_AttributeItem item1 = { value1, sizeof(value1)/sizeof(ArkUI_NumberValue) }; + * ArkUI_NumberValue value2[] = { 10 }; + * ArkUI_AttributeItem item2 = { value2, sizeof(value2)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_PADDING, &item1); + * nativeNodeApi->setAttribute(nodeHandle, NODE_PADDING, &item2); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_PADDING); + * auto nodePaddingTop = item->value[0].f32; + * @endcode + * + */ + NODE_PADDING, + /** + * @brief 组件ID属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .string: ID的内容；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .string: ID的内容；\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_AttributeItem item = { .string = "test" }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_ID, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_ID); + * auto nodeId = item->string; + * @endcode + * + */ + NODE_ID, + /** + * @brief 通过{@link setAttribute}方法设置组件是否可交互，设置为false可不响应点击等操作。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：false表示不可交互，true表示可交互；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：0表示不可交互，1表示可交互；\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32 = false} }; + * ArkUI_AttributeItem item = { value, 1 }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_ENABLED, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_ENABLED); + * auto nodeEnabled = item->value[0].i32; + * @endcode + */ + NODE_ENABLED, + /** + * @brief 外间距属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式有两种：\n + * 1：上下左右四个位置的外间距值相等。\n + * .value[0].f32：外间距数值，单位为vp；\n + * 2：分别指定上下左右四个位置的外间距值。\n + * .value[0].f32：上外间距数值，单位为vp；\n + * .value[1].f32：右外间距数值，单位为vp；\n + * .value[2].f32：下外间距数值，单位为vp；\n + * .value[3].f32：左外间距数值，单位为vp；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32：上外间距数值，单位为vp；\n + * .value[1].f32：右外间距数值，单位为vp；\n + * .value[2].f32：下外间距数值，单位为vp；\n + * .value[3].f32：左外间距数值，单位为vp；\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value1[] = { 1, 2, 3, 4}; + * ArkUI_AttributeItem item1 = { value1, sizeof(value1)/sizeof(ArkUI_NumberValue) }; + * ArkUI_NumberValue value2[] = { 10 }; + * ArkUI_AttributeItem item2 = { value2, sizeof(value2)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_MARGIN, &item1); + * nativeNodeApi->setAttribute(nodeHandle, NODE_MARGIN, &item2); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_MARGIN); + * auto nodeMarginTop = item->value[0].f32; + * @endcode + * + */ + NODE_MARGIN, + /** + * @brief 组件平移，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： x轴移动距离，单位vp，默认值0；\n + * .value[1].f32： y轴移动距离，单位vp，默认值0；\n + * .value[2].f32： z轴移动距离，单位vp，默认值0。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32： x轴移动距离，单位vp；\n + * .value[1].f32： y轴移动距离，单位vp；\n + * .value[2].f32： z轴移动距离，单位vp。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { 100, 20, 0 }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_TRANSLATE, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TRANSLATE); + * auto nodeTranslate = item->value[0].f32; + * @endcode + * + */ + NODE_TRANSLATE, + /** + * @brief 组件缩放，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： x轴的缩放系数，默认值1；\n + * .value[1].f32： y轴的缩放系数，默认值1。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32： x轴的缩放系数；\n + * .value[1].f32： y轴的缩放系数。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { 1.0, 0.5 }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_SCALE, &item); + * auto item = basicNodeApi->getAttribute(nodeHandle, NODE_SCALE); + * auto nodeScale = item->value[0].f32; + * @endcode + * + */ + NODE_SCALE, + /** + * @brief 组件旋转属性，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： 旋转轴向量x坐标，默认值0；\n + * .value[1].f32： 旋转轴向量y坐标，默认值0；\n + * .value[2].f32： 旋转轴向量z坐标，默认值0；\n + * .value[3].f32： 旋转角度，默认值0；\n + * .value[4].f32： 视距，即视点到z=0平面的距离，单位vp，默认值0。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： 旋转轴向量x坐标；\n + * .value[1].f32： 旋转轴向量y坐标；\n + * .value[2].f32： 旋转轴向量z坐标；\n + * .value[3].f32： 旋转角度；\n + * .value[4].f32： 视距，即视点到z=0平面的距离，单位vp。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { 0, 0, 1, 300, 0 }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_ROTATE, &item); + * auto item = basicNodeApi->getAttribute(nodeHandle, NODE_ROTATE); + * auto nodeRotate = item->value[0].f32; + * @endcode + * + */ + NODE_ROTATE, + /** + * @brief 组件高光效果，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： 亮度值，默认值1.0，推荐取值范围[0,2]。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： 亮度值。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { 1.2 }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_BRIGHTNESS, &item); + * auto item = basicNodeApi->getAttribute(nodeHandle, NODE_BRIGHTNESS); + * auto nodeBrightness = item->value[0].f32; + * @endcode + * + */ + NODE_BRIGHTNESS, + /** + * @brief 组件饱和度效果，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： 饱和度值，默认值1.0，推荐取值范围[0,FLT_MAX]。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： 饱和度值。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { 1.0 }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_SATURATE, &item); + * auto item = basicNodeApi->getAttribute(nodeHandle, NODE_SATURATE); + * auto nodeSaturate = item->value[0].f32; + * @endcode + * + */ + NODE_SATURATE, + /** + * @brief 组件内容模糊效果，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： 模糊半径，模糊半径越大越模糊，为0时不模糊。单位vp，默认值0.0。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： 模糊半径，模糊半径越大越模糊，为0时不模糊。单位vp。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { 1.0 }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_BLUR, "1.0"); + * auto item = basicNodeApi->getAttribute(nodeHandle, NODE_BLUR); + * auto nodeBlur = item->value[0].f32; + * @endcode + * + */ + NODE_BLUR, + /** + * @brief 组件颜色线性渐变效果，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .string： 字符串组合参数，入参4个，以分号分割：\n + * 入参1： 指定某百分比位置处的渐变色颜色,设置非法颜色直接跳过。颜色和位置（单位vp）数组类型，以逗号分割；\n + * 入参2： 线性渐变的起始角度。0点方向顺时针旋转为正向角度，默认值：180；\n + * 入参3： + * 线性渐变的方向，设置angle后不生效。取值("left","top","right","bottom","left-top","left-bottom","right-top",\n + * "right-bottom","none", 默认值 "bottom")；\n + * 入参4： 为渐变的颜色重复着色，默认值 false；\n + * 如 "#ffff0000,0.0,#ff0000ff,0.3,#ffffff00,0.5;;left;true" 。 + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * * .string： 字符串组合参数，入参4个，以分号分割：\n + * 入参1： 指定某百分比位置处的渐变色颜色,设置非法颜色直接跳过。颜色和位置（单位vp）数组类型，以逗号分割；\n + * 入参2： 线性渐变的起始角度。0点方向顺时针旋转为正向角度；\n + * 入参3： 线性渐变的方向，设置angle后不生效；\n + * 入参4： 为渐变的颜色重复着色。\n + * @code {.cpp} + * ARKUI_AttributeItem item = { .string = "#ffff0000,0.0,#ff0000ff,0.3,#ffffff00,0.5;;left;true" }; + * basicNodeApi->setAttribute(nodeHandle, NODE_LINEAR_GRADIENT, &item); + * auto item = basicNodeApi->getAttribute(nodeHandle, NODE_LINEAR_GRADIENT); + * auto nodeLinearGradient = item->string; + * @endcode + * + */ + NODE_LINEAR_GRADIENT, + /** + * @brief 组件内容在元素绘制区域内的对齐方式，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32： 对齐方式，数据类型{@link ArkUI_Alignment}，默认值ARKUI_ALIGNMENT_CENTER。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32： 对齐方式，数据类型{@link ArkUI_Alignment}。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { { .i32 = ARKUI_ALIGNMENT_CENTER } }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_ALIGN, "center"); + * auto item = basicNodeApi->getAttribute(nodeHandle, NODE_ALIGN); + * auto nodeAlign = item->value[0].i32; + * @endcode + * + */ + NODE_ALIGN, + /** + * @brief 透明度属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：透明度数值，取值范围为0到1。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：透明度数值，取值范围为0到1。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 0.5 }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_OPACITY, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_OPACITY); + * auto nodeOpacity = item->value[0].f32; + * @endcode + * + */ + NODE_OPACITY, + /** + * @brief 边框宽度属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * 1: .value[0].f32：统一设置四条边的边框宽度。 \n + * 2: .value[0].f32：设置上边框的边框宽度。 \n + * .value[1].f32：设置右边框的边框宽度。 \n + * .value[2].f32：设置下边框的边框宽度。 \n + * .value[3].f32：设置左边框的边框宽度。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：设置上边框的边框宽度。 \n + * .value[1].f32：设置右边框的边框宽度。 \n + * .value[2].f32：设置下边框的边框宽度。 \n + * .value[3].f32：设置左边框的边框宽度。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 5 }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_BORDER_WIDTH, &item); + * ArkUI_NumberValue value[] = { 5, 5, 10, 10 }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_BORDER_WIDTH, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_BORDER_WIDTH); + * auto nodeBorderWidth = item->value[0].f32; + * @endcode + * + */ + NODE_BORDER_WIDTH, + /** + * @brief 边框圆角属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * 1: .value[0].f32：统一设置四条边的边框圆角。 \n + * 2: .value[0].f32：设置左上角圆角半径。 \n + * .value[1].f32：设置右上角圆角半径。 \n + * .value[2].f32：设置左下角圆角半径。 \n + * .value[3].f32：设置右下角圆角半径。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：设置左上角圆角半径。 \n + * .value[1].f32：设置右上角圆角半径。 \n + * .value[2].f32：设置左下角圆角半径。 \n + * .value[3].f32：设置右下角圆角半径。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 5 }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_BORDER_RADIUS, &item); + * ArkUI_NumberValue value[] = { 5, 5, 10, 10 }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_BORDER_RADIUS, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_BORDER_RADIUS); + * auto nodeBorderRadius = item->value[0].f32; + * @endcode + * + */ + NODE_BORDER_RADIUS, + /** + * @brief 边框颜色属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * 1: .value[0].u32：统一设置四条边的边框颜色，使用0xargb表示，如0xFFFF11FF。 \n + * 2: .value[0].u32：设置上侧边框颜色，使用0xargb表示，如0xFFFF11FF。 \n + * .value[1].u32：设置右侧边框颜色，使用0xargb表示，如0xFFFF11FF。 \n + * .value[2].u32：设置下侧边框颜色，使用0xargb表示，如0xFFFF11FF。 \n + * .value[3].u32：设置左侧边框颜色，使用0xargb表示，如0xFFFF11FF。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].u32：设置上侧边框颜色，使用0xargb表示，如0xFFFF11FF。 \n + * .value[1].u32：设置右侧边框颜色，使用0xargb表示，如0xFFFF11FF。 \n + * .value[2].u32：设置下侧边框颜色，使用0xargb表示，如0xFFFF11FF。 \n + * .value[3].u32：设置左侧边框颜色，使用0xargb表示，如0xFFFF11FF。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.u32 = 0xFFFF11FF} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_BORDER_COLOR, &item); + * ArkUI_NumberValue value[] = { {.u32 = 0xFFFF11FF}, {.u32 = 0xFFFF11FF}, {.u32 = 0xFFFFFFFF}, {.u32 = 0x000000} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_BORDER_COLOR, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_BORDER_COLOR); + * auto nodeBorderColor = item->value[0].u32; + * @endcode + * + */ + NODE_BORDER_COLOR, + /** + * @brief 边框线条样式属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * 1: .value[0].i32：统一设置四条边的边框线条样式，参数类型{@link ArkUI_BorderStyle}，默认值为ARKUI_BORDER_STYLE_SOLID。 \n + * 2:.value[0].i32：设置上侧边框线条样式，参数类型{@linkArkUI_BorderStyle}，默认值为ARKUI_BORDER_STYLE_SOLID。 \n + * .value[1].i32：设置右侧边框线条样式，参数类型{@link ArkUI_BorderStyle}，默认值为ARKUI_BORDER_STYLE_SOLID。 \n + * .value[2].i32：设置下侧边框线条样式，参数类型{@link ArkUI_BorderStyle}，默认值为ARKUI_BORDER_STYLE_SOLID。 \n + * .value[3].i32：设置左侧边框线条样式，参数类型{@link ArkUI_BorderStyle}，默认值为ARKUI_BORDER_STYLE_SOLID。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：上侧边框线条样式对应的数值。 \n + * .value[1].i32：右侧边框线条样式对应的数值。 \n + * .value[2].i32：下侧边框线条样式对应的数值。 \n + * .value[3].i32：左侧边框线条样式对应的数值。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32 = ARKUI_BORDER_STYLE_DOTTED} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_BORDER_STYLE, &item); + * ArkUI_NumberValue value[] = { {.i32 = ARKUI_BORDER_STYLE_DOTTED}, {.i32 = ARKUI_BORDER_STYLE_SOLID}, + * {.i32 = ARKUI_BORDER_STYLE_SOLID}, {.i32 = ARKUI_BORDER_STYLE_DOTTED} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_BORDER_STYLE, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_BORDER_STYLE); + * auto nodeBorderStyle = item->value[0].i32; + * @endcode + * + */ + NODE_BORDER_STYLE, + /** + * @brief 组件的堆叠顺序属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：堆叠顺序数值。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：堆叠顺序数值。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 2 }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_ZINDEX, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_ZINDEX); + * auto nodeZIndex = item->value[0].f32; + * @endcode + * + */ + NODE_ZINDEX, + /** + * @brief 组件是否可见属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：控制当前组件显示或隐藏，参数类型{@link ArkUI_Visibility}，默认值为ARKUI_VISIBILITY_VISIBLE。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：控制当前组件显示或隐藏，参数类型{@link ArkUI_Visibility}，默认值为ARKUI_VISIBILITY_VISIBLE。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32=ARKUI_VISIBILITY_NONE} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_VISIBILITY, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_VISIBILITY); + * auto nodeVisibility = item->value[0].i32; + * @endcode + * + */ + NODE_VISIBILITY, + /** + * @brief 组件进行裁剪、遮罩处理属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：控制是否按照父容器边缘轮廓进行裁剪，0表示不裁切，1表示裁切。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：控制是否按照父容器边缘轮廓进行裁剪，0表示不裁切，1表示裁切。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32 = 0} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_CLIP, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_CLIP); + * auto nodeClip = item->value[0].i32; + * @endcode + * + */ + NODE_CLIP, + /** + * @brief 组件进行裁剪、遮罩处理属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .string:形状描述，可选： \n + * "rect(10,10,10,10)"括号内分别为width、height、radiusWidth与radiusHeight"; \n + * "circle(10,10)"括号内分别为width、height; \n + * "ellipse(10,10)"括号内分别为width、height; \n + * "path(10,10,M0 0 L600 0)"括号内分别为width、height、commands; \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .string:形状描述： \n + * "rect(10,10,10,10)"括号内分别为width、height、radiusWidth与radiusHeight"; \n + * "circle(10,10)"括号内分别为width、height; \n + * "ellipse(10,10)"括号内分别为width、height; \n + * "path(10,10,M0 0 L600 0)"括号内分别为width、height、commands; \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_AttributeItem item = { .string = "rect(10,10,10,10)" }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_CLIP_SHAPE, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_CLIP); + * auto nodeClipShape = item->string; + * @endcode + * + */ + NODE_CLIP_SHAPE, + /** + * @brief 矩阵变换功能，可对图形进行平移、旋转和缩放等，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .data[0...15].f32: 16个浮点数字。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .data[0...15].f32: 16个浮点数字。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.f32 = 1}, {.f32 = 0}, {.f32 = 0}, {.f32 = 0}, {.f32 = 0}, {.f32 = 0}, {.f32 = 0}, + * {.f32 = 0}, {.f32 = 0}, {.f32 = 1}, {.f32 = 0}, {.f32 = 0}, {.f32 = 0}, {.f32 = 0}, {.f32 = 0}, {.f32 = 1} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TRANSFORM, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TRANSFORM); + * auto nodeTransform = item[0].value; + * @endcode + * + */ + NODE_TRANSFORM, + /** + * @brief 触摸测试类型，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：控制当前组件的触摸测试类型，参数类型{@link ArkUI_HitTestMode}，默认值为ARKUI_HIT_TEST_MODE_DEFAULT。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：控制当前组件的触摸测试类型，参数类型{@link ArkKUI_HitTestMode}，默认值为ARKUI_HIT_TEST_MODE_DEFAULT。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32=ARKUI_HIT_TEST_MODE_BLOCK} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_HIT_TEST_BEHAVIOR, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_HIT_TEST_BEHAVIOR); + * auto nodeHitTestBehavior = item->value[0].i32; + * @endcode + * + */ + NODE_HIT_TEST_BEHAVIOR, + /** + * @brief 元素左上角相对于父容器左上角偏移位置，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：x轴坐标。 \n + * .value[1].f32: y轴坐标。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：x轴坐标。 \n + * .value[1].f32: y轴坐标。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 50, 50 }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_POSITION, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_POSITION); + * auto nodePositionX = item->value[0].f32; + * auto nodePositionY = item->value[1].f32; + * @endcode + * + */ + NODE_POSITION, + /** + * @brief 阴影效果属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：设置当前组件阴影效果，参数类型{@link ArkUI_ShadowStyle}。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：设置当前组件阴影效果，参数类型{@link ArkUI_ShadowStyle}。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32 = ARKUI_SHADOW_STYLE_OUTER_DEFAULT_XS} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SHADOW, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SHADOW); + * auto nodePositionX = item->value[0].i32; + * @endcode + * + */ + NODE_SHADOW, + /** + * @brief 自定义阴影效果，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .string: 字符串组合参数，入参6个，以分号分割： \n + * 入参1：阴影模糊半径。 \n + * 入参2：阴影的X轴偏移量。 \n + * 入参3：阴影的Y轴偏移量。 \n + * 入参4：阴影类型。 \n + * 入参5：阴影的颜色。 \n + * 入参6：阴影是否内部填充。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .string: 字符串组合参数，入参6个，以分号分割： \n + * 入参1：阴影模糊半径。 \n + * 入参2：阴影的X轴偏移量。 \n + * 入参3：阴影的Y轴偏移量。 \n + * 入参4：阴影类型。 \n + * 入参5：阴影的颜色。 \n + * 入参6：阴影是否内部填充。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_AttributeItem item = { .string = "5; 10; 10; COLOR; 0xACCCCC; true" }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_CUSTOM_SHADOW, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_CUSTOM_SHADOW); + * auto nodeCustomShadow = item->string; + * @endcode + * + */ + NODE_CUSTOM_SHADOW, + /** + * @brief 背景图片的宽高属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 表示图片的宽度值，单位为vp。\n + * .value[1].f32 表示图片的高度值，单位为vp。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 表示图片的宽度值，单位为vp。\n + * .value[1].f32 表示图片的高度值，单位为vp。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue sizeArray[] = { 20, 0 } + * ARKUI_AttributeItem item = { .value = sizeArray, .size = 2}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_BACKGROUND_IMAGE_SIZE , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_BACKGROUND_IMAGE_SIZE); + * auto width = item->value[0].f32; + * @endcode + * + */ + NODE_BACKGROUND_IMAGE_SIZE, + /** + * @brief 背景图片的宽高样式属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示背景图片的宽高样式，取{@link ArkUI_ImageSize}枚举值。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示背景图片的宽高样式，取{@link ArkUI_ImageSize}枚举值。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue imageSizeStyle[] = { {.i32 = static_cast(ArkUI_ImageSize.ARKUI_IMAGE_SIZE_COVER) } } + * ARKUI_AttributeItem item = { .value = imageSizeStyle, .size = 1}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_BACKGROUND_IMAGE_SIZE_WITH_STYLE, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_BACKGROUND_IMAGE_SIZE_WITH_STYLE); + * auto blurStyle = item->value[0].i32 + * @endcode + */ + NODE_BACKGROUND_IMAGE_SIZE_WITH_STYLE, + /** + * @brief 背景和内容之间的模糊属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示模糊类型，取{@link ArkUI_BlurStyle}枚举值。\n + * .value[1]?.i32 表示深浅色模式，取{@link ArkUI_ColorMode}枚举值。\n + * .value[2]?.i32 表示取色模式，取{@link ArkUI_AdaptiveColor}枚举值。\n + * .value[3]?.f32 表示模糊效果程度，取[0.0,1.0]范围内的值。\n + * .value[4]?.f32 表示灰阶模糊起始边界。\n + * .value[5]?.f32 表示灰阶模糊终点边界。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示模糊类型，取{@link ArkUI_BlurStyle}枚举值。\n + * .value[1]?.i32 表示深浅色模式，取{@link ArkUI_ColorMode}枚举值。\n + * .value[2]?.i32 表示取色模式，取{@link ArkUI_AdaptiveColor}枚举值。\n + * .value[3]?.f32 表示模糊效果程度，取[0.0,1.0]范围内的值。\n + * .value[4]?.f32 表示灰阶模糊起始边界。\n + * .value[5]?.f32 表示灰阶模糊终点边界。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue blurStyle[] = { { .i32 = static_cast(ArkUI_BlurStyle.ARKUI_BLUR_STYLE_THICK)}} + * ARKUI_AttributeItem item = { .value = blurStyle, .size = 1}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_BACKGROUND_BLUR_STYLE , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_BACKGROUND_BLUR_STYLE); + * auto blurStyle = item->value[0].i32 + * @endcode + * + */ + NODE_BACKGROUND_BLUR_STYLE, + /** + * @brief 图形变换的中心点属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0]?.f32 表示中心点X轴坐标值，单位为vp \n + * .value[1]?.f32 表示中心点Y轴坐标，单位为vp \n + * .value[2]?.f32 表示中心点Z轴坐标，单位为vp \n + * .value[3]?.f32 表示中心点X轴坐标的百分比位置，如0.2表示百分之20的位置，该属性覆盖value[0].f32。\n + * .value[4]?.f32 表示中心点Y轴坐标的百分比位置，如0.2表示百分之20的位置，该属性覆盖value[1].f32。\n + * .value[5]?.f32 表示中心点Z轴坐标的百分比位置，如0.2表示百分之20的位置，该属性覆盖value[2].f32。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0]?.f32 表示中心点X轴坐标，单位为vp \n + * .value[1]?.f32 表示中心点Y轴坐标，单位为vp \n + * .value[2]?.f32 表示中心点Z轴坐标，单位为vp \n + * 注：如果设置坐标百分比位置，属性获取方法返回计算后的vp为单位的值。 + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue centerPointArray[] = { 20 } + * ARKUI_AttributeItem item = { .value = centerPointArray, .size = 1}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TRANSITION_CENTER , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TRANSITION_CENTER); + * auto centerX = item->value[0].f32 + * @endcode + */ + NODE_TRANSFORM_CENTER, + /** + * @brief 转场时的透明度效果属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 表示起终点的透明度值 \n + * .value[1].i32 表示动画时长，单位ms \n + * .value[2].i32 表示动画曲线类型，取{@link ArkUI_AnimationCurve}枚举值 \n + * .value[3]?.i32 表示动画延迟时长，单位ms \n + * .value[4]?.i32 表示动画播放次数 \n + * .value[5]?.i32 表示动画播放模式，取{@link ArkUI_AnimationPlayMode}枚举值 \n + * .value[6]?.f32 表示动画播放速度 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 表示起终点的透明度值 \n + * .value[1].i32 表示动画时长，单位ms \n + * .value[2].i32 表示动画曲线类型，取{@link ArkUI_AnimationCurve}枚举值 \n + * .value[3]?.i32 表示动画延迟时长，单位ms \n + * .value[4]?.i32 表示动画播放次数 \n + * .value[5]?.i32 表示动画播放模式，取{@link ArkUI_AnimationPlayMode}枚举值 \n + * .value[6]?.f32 表示动画播放速度 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue opacityTransition[] = { 20, { .i32 = 3000}, + * { .i32 = static_cast(ArkUI_AnimationCurve.ARKUI_CURVE_EASE_IN_OUT)}} + * ARKUI_AttributeItem item = { .value = opacityTransition, .size = 3}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_OPACITY_TRANSITION , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_OPACITY_TRANSITION); + * auto opacity = item->value[0].f32 + * @endcode + */ + NODE_OPACITY_TRANSITION, + /** + * @brief 转场时的旋转效果属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 表示横向旋转分量。\n + * .value[1].f32 表示纵向的旋转分量。\n + * .value[2].f32 表示竖向的旋转分量。\n + * .value[3].f32 表示角度。\n + * .value[4].f32 表示视距。\n + * .value[5].i32 表示动画时长，单位ms。\n + * .value[6].i32 表示动画曲线类型，取{@link ArkUI_AnimationCurve}枚举值。\n + * .value[7]?.i32 表示动画延迟时长，单位ms。\n + * .value[8]?.i32 表示动画播放次数。\n + * .value[9]?.i32 表示动画播放模式，取{@link ArkUI_AnimationPlayMode}枚举值。\n + * .value[10]?.f32 表示动画播放速度。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 表示横向旋转分量。\n + * .value[1].f32 表示纵向的旋转分量。\n + * .value[2].f32 表示竖向的旋转分量。\n + * .value[3].f32 表示角度。\n + * .value[4].f32 表示视距。\n + * .value[5].i32 表示动画时长，单位ms。\n + * .value[6].i32 表示动画曲线类型，取{@link ArkUI_AnimationCurve}枚举值。\n + * .value[7]?.i32 表示动画延迟时长，单位ms。\n + * .value[8]?.i32 表示动画播放次数。\n + * .value[9]?.i32 表示动画播放模式，取{@link ArkUI_AnimationPlayMode}枚举值。\n + * .value[10]?.f32 表示动画播放速度。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue rotateTransition[] = { 0.0f, 0.0f, 1.0f, 180, 0, { .i32 = 3000}, + * { .i32 = static_cast(ArkUI_AnimationCurve.ARKUI_CURVE_SHARP)}} + * ARKUI_AttributeItem item = { .value = rotateTransition, .size = 7}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_ROTATE_TRANSITION , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_ROTATE_TRANSITION); + * auto rotateX = item->value[0].f32 + * @endcode + */ + NODE_ROTATE_TRANSITION, + /** + * @brief 转场时的缩放效果属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 横向放大倍数。\n + * .value[1].f32 纵向放大倍数。\n + * .value[2].f32 竖向放大倍数。\n + * .value[3].i32 表示动画时长，单位ms。\n + * .value[4].i32 表示动画曲线类型，取{@link ArkUI_AnimationCurve}枚举值。\n + * .value[5]?.i32 表示动画延迟时长，单位ms。\n + * .value[6]?.i32 表示动画播放次数。\n + * .value[7]?.i32 表示动画播放模式，取{@link ArkUI_AnimationPlayMode}枚举值。\n + * .value[8]?.f32 表示动画播放速度。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 横向放大倍数。\n + * .value[1].f32 纵向放大倍数。\n + * .value[2].f32 竖向放大倍数。\n + * .value[3].i32 表示动画时长，单位ms。\n + * .value[4].i32 表示动画曲线类型，取{@link ArkUI_AnimationCurve}枚举值。\n + * .value[5]?.i32 表示动画延迟时长，单位ms。\n + * .value[6]?.i32 表示动画播放次数。\n + * .value[7]?.i32 表示动画播放模式，取{@link ArkUI_AnimationPlayMode}枚举值。\n + * .value[8]?.f32 表示动画播放速度。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue scaleTransition[] = { 0.0f, 0.0f, 0.0f, { .i32 = 3000}, + * { .i32 = static_cast(ArkUI_AnimationCurve.ARKUI_CURVE_SHARP)}} + * ARKUI_AttributeItem item = { .value = scaleTransition, .size = 5}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SCALE_TRANSITION , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SCALE_TRANSITION); + * auto scaleX = item->value[0].f32 + * @endcode + */ + NODE_SCALE_TRANSITION, + /** + * @brief 转场时的平移效果属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * value[0].f32 表示横向平移距离值，单位为vp \n + * value[1].f32 表示纵向平移距离值，单位为vp \n + * value[2].f32 表示竖向平移距离值，单位为vp \n + * value[3].i32 表示动画时长，单位ms。\n + * value[4].i32 表示动画曲线类型，取{@link ArkUI_AnimationCurve}枚举值。\n + * value[5]?.i32 表示动画延迟时长，单位ms。\n + * value[6]?.i32 表示动画播放次数。\n + * value[7]?.i32 表示动画播放模式，取{@link ArkUI_AnimationPlayMode}枚举值。\n + * value[8]?.f32 表示动画播放速度。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * value[0].f32 表示横向平移距离值，单位为vp \n + * value[1].f32 表示纵向平移距离值，单位为vp \n + * value[2].f32 表示竖向平移距离值，单位为vp \n + * value[3].i32 表示动画时长，单位ms。\n + * value[4].i32 表示动画曲线类型，取{@link ArkUI_AnimationCurve}枚举值。\n + * value[5]?.i32 表示动画延迟时长，单位ms。\n + * value[6]?.i32 表示动画播放次数。\n + * value[7]?.i32 表示动画播放模式，取{@link ArkUI_AnimationPlayMode}枚举值。\n + * value[8]?.f32 表示动画播放速度。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue translateTransition[] = { 0.0f, 0.0f, 0.0f, + * { .i32 = 3000}, { .i32 = static_cast(ArkUI_AnimationCurve.ARKUI_CURVE_SHARP)}} + * ARKUI_AttributeItem item = { .value = translateTransition, .size = 5}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TRANSLATE_TRANSITION , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TRANSLATE_TRANSITION); + * auto translateX = item->value[0].f32 + * @endcode + */ + NODE_TRANSLATE_TRANSITION, + + /** + * @brief 获焦属性，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式： \n + * .value[0].i32：参数类型为1或者0。 + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：参数类型为1或者0。 + * + * @code {.c} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { { .i32 = 1 } }; + * ArkUI_AttributeItem item = {value, sizeof(value)/sizeof(ArkUI_NumberValue)}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_FOCUSABLE, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_FOCUSABLE); + * auto value = item->value[0].i32; + * @endcode + * + */ + NODE_FOCUSABLE, + + /** + * @brief 默认焦点属性，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式： \n + * value[0].i32：参数类型为1或者0。 + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * value[0].i32：参数类型为1或者0。 + * + * @code {.c} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { { .i32 = 1 } }; + * ArkUI_AttributeItem item = {value, sizeof(value)/sizeof(ArkUI_NumberValue)}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_DEFAULT_FOCUS, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_DEFAULT_FOCUS); + * auto value = item->value[0].i32; + * @endcode + * + */ + NODE_DEFAULT_FOCUS, + + /** + * @brief 触摸热区属性，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式： \n + * .data[0].f32：触摸点相对于组件左上角的x轴坐标,单位为vp。 \n + * .data[1].f32：触摸点相对于组件左上角的y轴坐标,单位为vp。 \n + * .data[2].f32：触摸热区的宽度 ，单位为%。 \n + * .data[3].f32：触摸热区的高度，单位为%。 \n + * .data[4...].f32:可以设置多个手势响应区域，顺序和上述一致。 + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .data[0].f32：触摸点相对于组件左上角的x轴坐标,单位为vp。 \n + * .data[1].f32：触摸点相对于组件左上角的y轴坐标,单位为vp。 \n + * .data[2].f32：触摸热区的宽度 ，单位为%。 \n + * .data[3].f32：触摸热区的高度，单位为%。 \n + * .data[4...].f32:可以设置多个手势响应区域，顺序和上述一致。 + * + * @code {.c} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 0, 0, 100, 100 }; + * ArkUI_AttributeItem item = {value, sizeof(value)/sizeof(ArkUI_NumberValue)}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_RESPONSE_REGION, &item); + * + * ArkUI_NumberValue value[] = { 0, 0, 100, 100, 0, 0, 100, 100 }; + * ArkUI_AttributeItem item = {value, sizeof(value)/sizeof(ArkUI_NumberValue)}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_RESPONSE_REGION, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_RESPONSE_REGION); + * auto x = item->value[0].f32; + * auto y = item->value[1].f32; + * auto width = item->value[2].f32; + * auto height = item->value[3].f32; + * @endcode + * + */ + NODE_RESPONSE_REGION, + /** + * @brief 遮罩文本属性，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式： \n + * .string 遮罩文本；\n + * .value[0]?.i32：可选值，浮层相对于组件的位置，参数类型{@link ArkUI_Alignment}， + * 默认值为ARKUI_ALIGNMENT_TOP_START。 \n + * .value[1]?.i32：可选值，浮层基于自身左上角的偏移量X，单位为vp。 \n + * .value[2]?.i32：可选值，浮层基于自身左上角的偏移量Y，单位为vp。 + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .string 遮罩文本； \n + * .value[0]?.i32：可选值，浮层相对于组件的位置，参数类型{@link ArkUI_Alignment}， + * 默认值为ARKUI_ALIGNMENT_TOP_START。 \n + * .value[1]?.i32：可选值，浮层基于自身左上角的偏移量X，单位为vp。 \n + * .value[2]?.i32：可选值，浮层基于自身左上角的偏移量Y，单位为vp。 + * + * @code {.c} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { { .i32 = ARKUI_ALIGNMENT_TOP_START }, 1.2, 0.3 }; + * ArkUI_AttributeItem item = {value, sizeof(value)/sizeof(ArkUI_NumberValue), "test"}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_OVERLAY, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_OVERLAY); + * auto text = item->string; + * @endcode + * + */ + NODE_OVERLAY, + /** + * @brief 角度渐变效果，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .string: 字符串组合参数，入参6个，以分号分割： \n + * 入参1：为角度渐变的中心点，即相对于当前组件左上角的坐标,以逗号分隔。 \n + * 入参2：角度渐变的起点，默认值0。 \n + * 入参3：角度渐变的终点，默认值0。 \n + * 入参4：角度渐变的旋转角度，默认值0。 \n + * 入参5：指定某百分比位置处的渐变色颜色，设置非法颜色直接跳过。 \n + * 入参6：为渐变的颜色重复着色，默认值 false。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .string: 字符串组合参数，入参6个，以分号分割： \n + * 入参1：为角度渐变的中心点，即相对于当前组件左上角的坐标,以逗号分隔。 \n + * 入参2：角度渐变的起点，默认值0。 \n + * 入参3：角度渐变的终点，默认值0。 \n + * 入参4：角度渐变的旋转角度，默认值0。 \n + * 入参5：指定某百分比位置处的渐变色颜色，设置非法颜色直接跳过。 \n + * 入参6：为渐变的颜色重复着色，默认值 false。 \n + * + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_AttributeItem item = { .string = "5,10;60;180;60;0xFFFFFFFF,0xFFFFF000,0xFFFFFFFF,0xFFFFF000;true" }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SWEEP_GRADIENT, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SWEEP_GRADIENT); + * auto nodeCustomShadow = item->string; + * @endcode + * + */ + NODE_SWEEP_GRADIENT, + /** + * @brief 角度渐变效果，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .string: 字符串组合参数，入参4个，以分号分割： \n + * 入参1：为径向渐变的中心点，即相对于当前组件左上角的坐标,以逗号分隔。 \n + * 入参2：径向渐变的半径，默认值0。 \n + * 入参3：指定某百分比位置处的渐变色颜色，设置非法颜色直接跳过。 \n + * 入参4：为渐变的颜色重复着色。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .string: 字符串组合参数，入参4个，以分号分割： \n + * 入参1：为径向渐变的中心点，即相对于当前组件左上角的坐标,以逗号分隔。 \n + * 入参2：径向渐变的半径，默认值0。 \n + * 入参3：指定某百分比位置处的渐变色颜色，设置非法颜色直接跳过。 \n + * 入参4：为渐变的颜色重复着色。 \n + * + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_AttributeItem item = { .string = "5,10;50;0xFFFFFFFF,0xFFFFF000,0xFFFFFFFF,0xFFFFF000;true" }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_RADIAL_GRADIENT, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_RADIAL_GRADIENT); + * auto nodeCustomShadow = item->string; + * @endcode + * + */ + NODE_RADIAL_GRADIENT, + /** + * @brief 组件上加上指定形状的遮罩，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .data[0]?.u32：形状填充颜色；\n + * .data[1]?.u32：形状描边颜色；\n + * .data[2]?.f32：形状描边宽度；\n + * .string:形状描述，可选： \n + * "progressMask(10,10,#ff0000ff)"括号内分别为进度遮罩的当前值，进度遮罩的最大值与进度遮罩的颜色; \n + * "rect(10,10,10,10)"括号内分别为width、height、radiusWidth与radiusHeight"; \n + * "circle(10,10)"括号内分别为width、height; \n + * "ellipse(10,10)"括号内分别为width、height; \n + * "path(10,10,M0 0 L600 0)"括号内分别为width、height、commands; \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .data[0].u32：形状填充颜色；\n + * .data[1].u32：形状描边颜色；\n + * .data[2].f32：形状描边宽度，单位为vp；\n + * .string:形状描述： \n + * "progressMask(10,10,#ff0000ff)"括号内分别为进度遮罩的当前值，进度遮罩的最大值与进度遮罩的颜色; \n + * "rect(10,10,10,10)"括号内分别为width、height、radiusWidth与radiusHeight"; \n + * "circle(10,10)"括号内分别为width、height; \n + * "ellipse(10,10)"括号内分别为width、height; \n + * "path(10,10,M0 0 L600 0)"括号内分别为width、height、commands; \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_AttributeItem item = { .string = "rect(10,10,10,10)" }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_MASK, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_MASK); + * auto nodeClipShape = item->string; + * @endcode + * + */ + NODE_MASK, + /** + * @brief 当前控件背景与子节点内容进行混合，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：控制当前组件的混合模式类型，参数类型{@link ArkUI_BlendMode}，默认值为ARKUI_BLEND_MODE_NONE。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：控制当前组件的混合模式类型，参数类型{@link ArkUI_BlendMode}，默认值为ARKUI_BLEND_MODE_NONE。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32=ARKUI_BLEND_MODE_NONE} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_BLEND_MODE, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_BLEND_MODE); + * auto nodeHitTestBehavior = item->value[0].i32; + * @endcode + * + */ + NODE_BLEND_MODE, + /** + * @brief 设置容器元素内主轴方向上的布局，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：设置容器元素内主轴方向上的布局类型， \n + * 参数类型{@link ArkUI_Direction}，默认值为ARKUI_DIRECTION_AUTO。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：设置容器元素内主轴方向上的布局类型， \n + * 参数类型{@link ArkUI_Direction}，默认值为ARKUI_DIRECTION_AUTO。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32=ARKUI_DIRECTION_RTL} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_DIRECTION, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_DIRECTION); + * auto nodeHitTestBehavior = item->value[0].i32; + * @endcode + * + */ + NODE_DIRECTION, + /** + * @brief 约束尺寸属性，组件布局时，进行尺寸范围限制，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32：最小宽度，单位vp； \n + * .value[1].f32：最大宽度，单位vp； \n + * .value[2].f32：最小高度，单位vp； \n + * .value[3].f32：最大高度，单位vp； \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：最小宽度，单位vp； \n + * .value[1].f32：最大宽度，单位vp； \n + * .value[2].f32：最小高度，单位vp； \n + * .value[3].f32：最大高度，单位vp； \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_AttributeItem item = { 0, 5, 0, 5 }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_CONSTRAINT_SIZE, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_CONSTRAINT_SIZE); + * auto nodeMinWidth = item->value[0].f32; + * auto nodeMaxWidth = item->value[1].f32; + * auto nodeMinHeight = item->value[2].f32; + * auto nodeMaxHeight = item->value[3].f32; + * @endcode + * + */ + NODE_CONSTRAINT_SIZE, + /** + * @brief 灰度效果属性，支持属性设置，属性重置和属性获取接口. + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：灰度转换比例，范围0-1之间，比如0.5指按照50%进行灰度处理； \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：灰度转换比例，范围0-1之间； \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_AttributeItem item = { 0.5 }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_GRAY_SCALE, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_GRAY_SCALE); + * auto nodeGrayScale = item->value[0].f32; + * @endcode + */ + NODE_GRAY_SCALE, + /** + * @brief 反转输入的图像比例属性，支持属性设置，属性重置和属性获取接口. + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：图像反转比例，范围0-1之间，比如0.5指按照50%进行反转处理； \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：图像反转比例，范围0-1之间； \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_AttributeItem item = { 0.5 }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_INVERT, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_INVERT); + * auto nodeInvert = item->value[0].f32; + * @endcode + */ + NODE_INVERT, + /** + * @brief 图像转换为深褐色比例属性，支持属性设置，属性重置和属性获取接口. + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：图像转换为深褐色比例，范围0-1之间，比如0.5指按照50%进行深褐色处理； \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：图像转换为深褐色比例，范围0-1之间； \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_AttributeItem item = { 0.5 }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SEPIA, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_SEPIA); + * auto nodeSepia = item->value[0].f32; + * @endcode + */ + NODE_SEPIA, + /** + * @brief 对比度属性，支持属性设置，属性重置和属性获取接口. + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：对比度，等于1时为原图，越大则对比度越高； \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：对比度； \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_AttributeItem item = { 10 }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_CONTRAST, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_CONTRAST); + * auto nodeContrast = item->value[0].f32; + * @endcode + */ + NODE_CONTRAST, + /** + * @brief 前景颜色属性，支持属性设置，属性重置和属性获取接口. + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式，支持两种入参格式：\n + * 1：.value[0].u32：颜色数值，0xargb类型，如0xFFFF0000表示红色；\n + * 2：.value[0].i32：颜色数值枚举{@link ArkUI_ColoringStrategy}；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].u32：颜色数值，0xargb类型；\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_AttributeItem item = { {.u32=0xFFFF0000} }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_FOREGROUND_COLOR, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_FOREGROUND_COLOR); + * auto nodeForegroundColor = item->value[0].u32; + * @endcode + */ + NODE_FOREGROUND_COLOR, + /** + * @brief 组件子元素相对组件自身的额外偏移属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 表示x轴方向的偏移值, 单位为vp。 \n + * .value[1].f32 表示y轴方向的偏移值, 单位为vp。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 表示x轴方向的偏移值, 单位为vp。 \n + * .value[1].f32 表示y轴方向的偏移值, 单位为vp。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue offsetArray[] = { 20, 0 } + * ARKUI_AttributeItem item = { .value = offsetArray, .size = 2}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_OFFSET , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_OFFSET); + * auto offsetX = item->value[0].f32 + * @endcode + * + */ + NODE_OFFSET, + /** + * @brief 组件子元素在位置定位时的锚点属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 表示锚点x坐标值, 单位为vp \n + * .value[1].f32 表示锚点y坐标值, 单位为vp \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 表示锚点x坐标值, 单位为vp \n + * .value[1].f32 表示锚点y坐标值, 单位为vp \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue pointArray[] = { 20, 0 } + * ARKUI_AttributeItem item = { .value = pointArray, .size = 2}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_MARK_ANCHOR , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_MARK_ANCHOR); + * auto pointX = item->value[0].f32 + * @endcode + * + */ + NODE_MARK_ANCHOR, + + /** + * @brief text组件设置文本内容属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .string 表示文本内容 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .string 表示文本内容 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ARKUI_AttributeItem item = { .string = "https://www.example.com/xxx.png" }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TEXT_CONTENT , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TEXT_CONTENT); + * auto content = item->string + * @endcode + */ + NODE_TEXT_CONTENT = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TEXT, + /** + * @brief 组件字体颜色属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].u32：字体颜色数值，0xargb格式，形如 0xFFFF0000 表示红色；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].u32：字体颜色数值，0xargb格式；\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.u32=0xFFFF0000} }; + * ArkUI_AttributeItem item = { value, 1 }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_FONT_COLOR, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_FONT_COLOR); + * auto nodeFontColor = item->value[0].u32; + * @endcode + * + */ + NODE_FONT_COLOR, + /** + * @brief 组件字体大小属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32：字体大小数值，单位为fp；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32：字体大小数值，单位为fp；\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 10 }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_FONT_SIZE, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_FONT_SIZE); + * auto nodeFontSize = item->value[0].f32; + * @endcode + * + */ + NODE_FONT_SIZE, + /** + * @brief 组件字体样式属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：字体样式{@link ArkUI_FontStyle}，默认值为ARKUI_FONT_STYLE_NORMAL；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：字体样式{@link ArkUI_FontStyle}；\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32 = ARKUI_FONT_STYLE_NORMAL} }; + * ArkUI_AttributeItem item = { value, 1 }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_FONT_STYLE, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_FONT_STYLE); + * auto nodeFontStyle = item->value[0].i32; + * @endcode + * + */ + NODE_FONT_STYLE, + /** + * @brief 组件字体粗细属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：字体粗细样式{@link ArkUI_FontWeight}，默认值为ARKUI_FONT_WEIGHT_NORMAL；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：字体粗细样式{@link ArkUI_FontWeight}；\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32 = ARKUI_FONT_WEIGHT_NORMAL} }; + * ArkUI_AttributeItem item = { value, 1 }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_FONT_WEIGHT, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_FONT_WEIGHT); + * auto nodeFontWeight = item->value[0].i32; + * @endcode + * + */ + NODE_FONT_WEIGHT, + /** + * @brief 文本行高属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 表示lineHeight值，单位为fp \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 表示lineHeight值，单位为fp \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue lineHeight[] = { 20 } + * ARKUI_AttributeItem item = { .value = lineHeight, .size = 1}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TEXT_LINE_HEIGHT , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TEXT_LINE_HEIGHT); + * auto pointX = item->value[0].f32 + * @endcode + */ + NODE_TEXT_LINE_HEIGHT, + /** + * @brief 置文本装饰线样式及其颜色属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：文本装饰线样式{@link ArkUI_TextDecorationType}，默认值为ARKUI_TEXT_DECORATION_TYPE_NONE；\n + * .value[1]?.u32：可选值，装饰线颜色，0xargb格式，形如 0xFFFF0000 表示红色；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：文本装饰线样式{@link ArkUI_TextDecorationType}；\n + * .value[1].u32：装饰线颜色，0xargb格式。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32 = ARKUI_TEXT_DECORATION_TYPE_NONE}, {.u32=0xFFFF0000} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TEXT_DECORATION, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_TEXT_DECORATION); + * auto nodeDecorationStyle = item->value[0].i32; + * auto nodeDecorationColor = item->value[1].u32; + * @endcode + * + */ + NODE_TEXT_DECORATION, + /** + * @brief 文本大小写属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示文本大小写类型 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示文本大小写类型 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue textCase[] = { {.i32 = static_cast(ArkUI_TextCase.ArkUI_Text_Case_LowerCase) } } + * ARKUI_AttributeItem item = { .value = textCase, .size = 1}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TEXT_CASE, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TEXT_CASE); + * auto textCase = item->value[0].i32 + * @endcode + * + */ + NODE_TEXT_CASE, + /** + * @brief 文本字符间距属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 表示字符间距值，单位为fp \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32 表示字符间距值，单位为fp \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue letterSpacing[] = { 20 } + * ARKUI_AttributeItem item = { .value = letterSpacing, .size = 1}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TEXT_LETTER_SPACING , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TEXT_LETTER_SPACING); + * auto letterSpacing = item->value[0].f32 + * @endcode + * + */ + NODE_TEXT_LETTER_SPACING, + /** + * @brief 文本最大行数属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示最大行数 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示最大行数 \n + + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue maxLine[] = { { .i32 = 2 } }; + * ARKUI_AttributeItem item = { .value = maxLine, .size = 1}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TEXT_MAX_LINES , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TEXT_MAX_LINES); + * auto maxLines = item->value[0].i32 + * @endcode + */ + NODE_TEXT_MAX_LINES, + /** + * @brief 文本水平对齐方式, 支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：表示文本水平对齐方式，取{@link ArkUI_TextAlign}枚举值。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：表示文本水平对齐方式，取{@link ArkUI_TextAlign}枚举值。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue alignMent[] = { { .i32 = static_cast(ArkUI_TextAlign.ARKUI_TEXT_ALIGN_CENTER) } }; + * ARKUI_AttributeItem item = { .value = alignMent, .size = 1}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TEXT_ALIGN , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TEXT_ALIGN); + * auto alignMent = item->value[0].i32 + * @endcode + */ + NODE_TEXT_ALIGN, + /** + * @brief 文本超长时的显示方式属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：表示文本超长时的显示方式。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：表示文本超长时的显示方式。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue textOverFlow[] = { { .i32 = static_cast(ArkUI_TextOverFlow.ARKUI_TEXT_OVERFLOW_CLIP) } + * }; + * ARKUI_AttributeItem item = { .value = textOverFlow, .size = 1}; + * nativeNodeApi->setAttribute(nodeHandle,NODE_TEXT_OVER_FLOW , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TEXT_OVER_FLOW); + * auto textOverFlow = item->value[0].i32 + * @endcode + */ + NODE_TEXT_OVER_FLOW, + /** + * @brief Text字体列表属性，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式： \n + * .string：字体字符串，多个用,分隔。 + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .string：字体字符串，多个用,分隔。 + * + * @code {.c} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_AttributeItem item = {.string = "HarmonyOS Sans"}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_FONT_FAMILY, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_FONT_FAMILY); + * auto font = item->string; + * @endcode + * + */ + NODE_FONT_FAMILY, + /** + * @brief 文本复制粘贴属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：复制粘贴方式{@link ArkUI_CopyOptions}，默认值为ARKUI_COPY_OPTIONS_NONE；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：复制粘贴方式{@link ArkUI_CopyOptions}。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32 = ARKUI_COPY_OPTIONS_NONE} }; + * ArkUI_AttributeItem item = { value, 1 }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TEXT_COPY_OPTION, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_TEXT_COPY_OPTION); + * auto nodeTextCopyOption = item->value[0].i32; + * @endcode + * + */ + NODE_TEXT_COPY_OPTION, + /** + * @brief 文本基线的偏移量属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32：偏移量数值，单位为fp；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32：偏移量数值，单位为fp。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 10 }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TEXT_BASELINE_OFFSET, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_TEXT_BASELINE_OFFSET); + * auto nodeTextBaselineOffset = item->value[0].f32; + * @endcode + * + */ + NODE_TEXT_BASELINE_OFFSET, + /** + * @brief 文字阴影效果属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32：阴影模糊半径，单位为vp；\n + * .value[1].i32：阴影类型{@link ArkUI_ShadowType}，默认值为ARKUI_SHADOW_TYPE_COLOR；\n + * .value[2].u32：阴影颜色，0xargb格式，形如 0xFFFF0000 表示红色；\n + * .value[3].f32：阴影X轴偏移量，单位为vp；\n + * .value[4].f32：阴影Y轴偏移量，单位为vp；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32：阴影模糊半径，单位为vp；\n + * .value[1].i32：阴影类型{@link ArkUI_ShadowType}；\n + * .value[2].u32：阴影颜色，0xargb格式；\n + * .value[3].f32：阴影X轴偏移量，单位为vp；\n + * .value[4].f32：阴影Y轴偏移量，单位为vp；\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 10, {.i32=ARKUI_SHADOW_TYPE_COLOR}, {.u32=0xFFFF0000}, 10, 10 }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TEXT_TEXT_SHADOW, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_TEXT_TEXT_SHADOW); + * auto nodeTextShadowRadius = item->value[0].f32; + * auto nodeTextShadowType = item->value[1].i32; + * auto nodeTextShadowColor = item->value[2].u32; + * auto nodeTextShadowOffsetX = item->value[3].f32; + * auto nodeTextShadowOffsetY = item->value[4].f32; + * @endcode + * + */ + NODE_TEXT_TEXT_SHADOW, + + /** + * @brief Text最小显示字号，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式： \n + * .value[0].f32：文本最小显示字号，单位FP。 + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：文本最小显示字号，单位FP。 + * + * @code {.c} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 20 }; + * ArkUI_AttributeItem item = {value, sizeof(value)/sizeof(ArkUI_NumberValue)}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TEXT_MIN_FONT_SIZE, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TEXT_MIN_FONT_SIZE); + * auto value = item->value[0].f32; + * @endcode + * + */ + NODE_TEXT_MIN_FONT_SIZE, + + /** + * @brief Text最大显示字号，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式： \n + * .value[0].f32：文本最大显示字号 单位FP。 + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：文本最大显示字号 单位FP。 + * + * @code {.c} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 20 }; + * ArkUI_AttributeItem item = {value, sizeof(value)/sizeof(ArkUI_NumberValue)}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TEXT_MAX_FONT_SIZE, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TEXT_MAX_FONT_SIZE); + * auto value = item->value[0].f32; + * @endcode + * + */ + NODE_TEXT_MAX_FONT_SIZE, + + /** + * @brief Text样式，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式： \n + * .string?：可选值 字体列表，使用多个字体，使用','进行分割。 \n + * .value[0].f32：文本尺寸 单位FP。 \n + * .value[1]?.i32：可选值，文本的字体粗细，参数类型{@link ArkUI_FontWeight}。 + * 默认值为ARKUI_FONT_WEIGHT_NORMAL。 \n + * .value[2]?.i32：可选值，字体样式，参数类型{@link ArkUI_FontStyle}。 + * 默认值为ARKUI_TEXT_FONT_STYLE_NORMAL。 + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .string?：可选值 字体列表，使用多个字体，使用','进行分割。 \n + * .value[0].f32：文本尺寸 单位FP。 \n + * .value[1]?.i32：可选值，文本的字体粗细，参数类型{@link ArkUI_FontWeight}。 + * 默认值为ARKUI_FONT_WEIGHT_NORMAL。 \n + * .value[2]?.i32：可选值，字体样式，参数类型{@link ArkUI_FontStyle}。 + * 默认值为ARKUI_TEXT_FONT_STYLE_NORMAL。 + * + * @code {.c} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 16, { .i32 = ARKUI_FONT_STYLE_NORMAL }, + * { .i32 = ARKUI_TEXT_FONT_STYLE_NORMAL } }; + * ArkUI_AttributeItem item = {value, sizeof(value)/sizeof(ArkUI_NumberValue)}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TEXT_FONT, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TEXT_FONT); + * auto size = item->value[0].f32; + * @endcode + * + */ + NODE_TEXT_FONT, + + /** + * @brief Text自适应高度的方式，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式： \n + * .value[0].i32：参数类型{@link ArkUI_TextHeightAdaptivePolicy}。 + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：参数类型{@link ArkUI_TextHeightAdaptivePolicy}。 + * + * @code {.c} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { { .i32 = ARKUI_TEXT_HEIGHT_ADAPTIVE_POLICY_MAX_LINES_FIRST } }; + * ArkUI_AttributeItem item = {value, sizeof(value)/sizeof(ArkUI_NumberValue)}; + * basicNodeApi->setAttribute(nodeHandle, NODE_TEXT_HEIGHT_ADAPTIVE_POLICY, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TEXT_HEIGHT_ADAPTIVE_POLICY); + * auto size = item->value[0].i32; + * @endcode + * + */ + NODE_TEXT_HEIGHT_ADAPTIVE_POLICY, + + /** + * @brief 文本首行缩进属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32: 表示首行缩进值。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32: 表示首行缩进值。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue textIndent[] = { 20 } + * ARKUI_AttributeItem item = { .value = textIndent, .size = 1}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TEXT_INDENT , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_TEXT_INDENT); + * auto indentValue = item->value[0].f32 + * @endcode + */ + NODE_TEXT_INDENT, + + /** + * @brief image组件设置图片地址属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .string 表示image组件地址 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .string 表示image组件地址 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ARKUI_AttributeItem item = { .string = "https://www.example.com/xxx.png" }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_IMAGE_SRC , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_IMAGE_SRC); + * auto imageSrc = item->string + * @endcode + */ + NODE_IMAGE_SRC = MAX_NODE_SCOPE_NUM * ARKUI_NODE_IMAGE, + /** + * @brief 图片填充效果属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示图片填充效果，取{@link ArkUI_ObjectFit}枚举值。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示图片填充效果，取{@link ArkUI_ObjectFit}枚举值。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ARKUI_NumberValue objectFitValue[] = { .i32 = { static_cast(ArkUI_ObjectFit.ARKUI_OBJECT_FIT_FILL) } }; + * ARKUI_AttributeItem item = { .value = objectFitValue, .size = 1}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_IMAGE_OBJECT_FIT , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_IMAGE_OBJECT_FIT); + * auto objectFit = item->value[0].i32 + * @endcode + */ + NODE_IMAGE_OBJECT_FIT, + /** + * @brief 图片插值效果效果属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示插值效果效果，取{@link ArkUI_ImageInterpolation}枚举值 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示插值效果效果，取{@link ArkUI_ImageInterpolation}枚举值 \n + * + * @code {.c} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ARKUI_NumberValue interpolationValue[] = { .i32 = { + * static_cast(ArkUI_ImageInterpolation.ARKUI_INTERPOLATION_LOW) } }; + * ARKUI_AttributeItem item = { .value = interpolationValue, .size = 1}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_IMAGE_INTERPOLATION , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_IMAGE_INTERPOLATION); + * auto interpolation = item->value[0].i32 + * @endcode + */ + NODE_IMAGE_INTERPOLATION, + /** + * @brief 图片重复样式属性，支持属性设置，属性重置，属性获取接口. + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示图片重复样式，取{@link ArkUI_ImageRepeat}枚举值 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示图片重复样式，取{@link ArkUI_ImageRepeat}枚举值 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ARKUI_NumberValue repeatValue[] = { .i32 = { static_cast(ArkUI_ImageRepeat.ARKUI_IMAGE_REPEAT_X) } }; + * ARKUI_AttributeItem item = { .value = repeatValue, .size = 1}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_IMAGE_OBJECT_REPEAT , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_IMAGE_OBJECT_REPEAT); + * auto repeat = item->value[0].i32 + * @endcode + */ + NODE_IMAGE_OBJECT_REPEAT, + /** + * @brief 图片滤镜效果属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 ~ .value[19].i32 表示滤镜矩阵数组 \n + * .size 表示滤镜数组大小 5*4 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 ~ .value[19].i32 表示滤镜矩阵数组 \n + * .size 表示滤镜数组大小 5*4 \n + * + * @code {.c} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ARKUI_NumberValue filterValue[] = { .i32 = {1}, .i32 = {0}, .i32 = {0}, .i32 = {0}, .i32 = {0}, .i32 = {0}, .i32 + * = {1}, .i32 = {0}, .i32 = {0}, .i32 = {0}, .i32 = {0}, .i32 = {0}, .i32 = {1}, .i32 = {0}, .i32 = {0}, .i32 = + * {0}, .i32 = {0}, .i32 = {0}, .i32 = {1}, .i32 = {0} }; + * ARKUI_AttributeItem item = { .value = filterValue, .size = sizeof(filterValue)/ sizeof(ARKUI_NumberValue)}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_IMAGE_COLOR_FILTER , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_IMAGE_COLOR_FILTER); + * auto colorFilter = item->value + * @endcode + */ + NODE_IMAGE_COLOR_FILTER, + /** + * @brief 图源自动缩放属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示是否缩放布尔值。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32 表示是否缩放布尔值。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ARKUI_NumberValue resizeValue[] = { .i32 = true }; + * ARKUI_AttributeItem item = { .value = resizeValue, .size = 1}} + * nativeNodeApi->setAttribute(nodeHandle, NODE_IMAGE_AUTO_RESIZE , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_IMAGE_AUTO_RESIZE); + * auto autoResize = item->value[0].i32 + * @endcode + */ + NODE_IMAGE_AUTO_RESIZE, + /** + * @brief 占位图地址属性，支持属性设置，属性重置，属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .string 表示image组件占位图地址。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .string 表示image组件占位图地址。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ARKUI_AttributeItem item = { .string = "/pages/loading.png" } + * nativeNodeApi->setAttribute(nodeHandle, NODE_IMAGE_ALT , &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_IMAGE_ALT); + * auto altStr = item->string + * @endcode + */ + NODE_IMAGE_ALT, + + /** + * @brief 组件打开状态的背景颜色属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].u32：背景色数值，0xargb格式，形如 0xFFFF0000 表示红色；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].u32：背景色数值，0xargb格式。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.u32=0xFFFF0000} }; + * ArkUI_AttributeItem item = { value, 1 }; + * basicNodeApi->setAttribute(nodeHandle, NODE_TOGGLE_SELECTED_COLOR, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_TOGGLE_SELECTED_COLOR); + * auto nodeToggleSelectedColor = item->value[0].u32; + * @endcode + * + */ + NODE_TOGGLE_SELECTED_COLOR = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TOGGLE, + /** + * @brief Switch类型的圆形滑块颜色属性，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].u32：圆形滑块颜色数值，0xargb格式，形如 0xFFFF0000 表示红色；\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].u32：圆形滑块颜色数值，0xargb格式。\n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi - reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.u32=0xFFFF0000} }; + * ArkUI_AttributeItem item = { value, 1 }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_TOGGLE_SWITCH_POINT_COLOR, &item); + * auto item = nativeNodeApi=>getAttribute(nodeHandle, NODE_TOGGLE_SWITCH_POINT_COLOR); + * auto nodeSwitchPointColor = item->value[0].u32; + * @endcode + * + */ + NODE_TOGGLE_SWITCH_POINT_COLOR, + + /** + * @brief 子组件在容器内的对齐方式，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32： 对齐方式，数据类型{@link ArkUI_Alignment}，默认值ARKUI_ALIGNMENT_CENTER。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32： 对齐方式，数据类型{@link ArkUI_Alignment}。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { { .i32 = ARKUI_ALIGNMENT_CENTER } }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_STACK_ALIGN_CONTENT, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_STACK_ALIGN_CONTENT); + * auto nodeStackAlignContent = item->value[0].i32; + * @endcode + */ + NODE_STACK_ALIGN_CONTENT = MAX_NODE_SCOPE_NUM * ARKUI_NODE_STACK, + + /** + * @brief 滚动类组件的滚动条状态，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32： 滚动条状态，数据类型{@link + * ArkUI_ScrollBarDisplayMode}，默认值ARKUI_SCROLL_BAR_DISPLAY_MODE_AUTO。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32： 滚动条状态，数据类型{@link ArkUI_ScrollBarDisplayMode}。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { { .i32 = ARKUI_SCROLL_BAR_DISPLAY_MODE_AUTO } }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_SCROLL_BAR_DISPLAY_MODE, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_SCROLL_BAR_DISPLAY_MODE); + * auto nodeScrollBarDisplayMode = item->value[0].i32; + * @endcode + * + */ + NODE_SCROLL_BAR_DISPLAY_MODE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SCROLL, + /** + * @brief 滚动类组件的滚动条宽度，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： 滚动条宽度，单位vp，默认值4。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： 滚动条宽度，单位vp。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { 20 }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_SCROLL_BAR_WIDTH, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_SCROLL_BAR_WIDTH); + * auto nodeScrollBarWidth = item->value[0].f32; + * @endcode + * + */ + NODE_SCROLL_BAR_WIDTH, + /** + * @brief 滚动类组件的滚动条颜色，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .data[0].u32： 滚动条颜色，0xargb类型。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .data[0].u32： 滚动条颜色，0xargb类型。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { { .u32 = 0xFFFFFFFF } }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_SCROLL_BAR_COLOR, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_SCROLL_BAR_COLOR); + * auto nodeScrollBarColor = item->value[0].u32; + * @endcode + * + */ + NODE_SCROLL_BAR_COLOR, + /** + * @brief Scroll组件的滚动方向，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：滚动方向，数据类型{@link ArkUI_Axis}，默认值ARKUI_AXIS_VERTICAL。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：滚动方向，数据类型{@link ArkUI_Axis}。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { { .i32 = ARKUI_AXIS_VERTICAL } }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_SCROLL_SCROLL_DIRECTION, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_SCROLL_SCROLL_DIRECTION); + * auto nodeScrollBarDirection = item->value[0].i32; + * @endcode + * + */ + NODE_SCROLL_SCROLL_DIRECTION, + /** + * @brief 滚动类组件的边缘滑动效果，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32： 边缘滑动效果，参数类型{@link ArkUI_EdgeEffect}，默认值ARKUI_EDGE_EFFECT_NONE；\n + * .value[1]?.i32： 可选值，组件内容大小小于组件自身时，设置是否开启滑动效果，开启为1，关闭为0，默认值1。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32： 边缘滑动效果，参数类型{@link ArkUI_EdgeEffect}；\n + * .value[1]?.i32： 可选值，组件内容大小小于组件自身时，设置是否开启滑动效果，开启为1，关闭为0。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { { .i32 = ARKUI_EDGE_EFFECT_NONE }, { .i32 = 1 } }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_SCROLL_EDGE_EFFECT, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_SCROLL_EDGE_EFFECT); + * auto nodeScrollEdgeEffect = item->value[0].i32; + * @endcode + * + */ + NODE_SCROLL_EDGE_EFFECT, + /** + * @brief 滚动类组件是否支持滚动手势，当设置为false时，无法通过手指或者鼠标滚动，但不影响控制器的滚动接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32： 是否支持滚动手势，默认值true。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32： 是否支持滚动手势。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { { .i32 = true } }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_SCROLL_ENABLE_SCROLL_INTERACTION, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_SCROLL_ENABLE_SCROLL_INTERACTION); + * auto nodeScrollEnableScroll = item->value[0].i32; + * @endcode + * + */ + NODE_SCROLL_ENABLE_SCROLL_INTERACTION, + /** + * @brief 滚动类组件的滚动摩擦系数，手动划动滚动区域时生效，只对惯性滚动过程有影响，对惯性滚动过程中的链式效果有间接影响。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： 摩擦系数，默认值：非可穿戴设备为0.6，可穿戴设备为0.9。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： 摩擦系数。 + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { 0.6 }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_SCROLL_FRICTION, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_SCROLL_FRICTION); + * auto nodeScrollFriction = item->value[0].f32; + * @endcode + * + */ + NODE_SCROLL_FRICTION, + /** + * @brief 滚动类组件的限位滚动模式，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32： Scroll组件限位滚动时的对其方式，数据类型{@link ArkUI_ScrollSnapAlign}，默认值ARKUI_SCROLL_SNAP_ALIGN_NONE；\n + * .value[1].i32： 在Scroll组件限位滚动模式下，该属性设置为false后，运行Scroll在开头和第一个限位点间自由滑动。默认值true，仅在限位点为多个时生效；\n + * .value[2].i32： 在Scroll组件限位滚动模式下，该属性设置为false后，运行Scroll在最后一个限位点和末尾间自由滑动。默认值true，仅在限位点为多个时生效；\n + * .value[3...].f32： Scroll组件限位滚动时的限位点，限位点即为Scroll组件能滑动停靠的偏移量。可以1个或多个。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32： Scroll组件限位滚动时的对其方式，数据类型{@link ArkUI_ScrollSnapAlign}；\n + * .value[1].i32： 在Scroll组件限位滚动模式下，该属性设置为false后，运行Scroll在开头和第一个限位点间自由滑动；\n + * .value[2].i32： 在Scroll组件限位滚动模式下，该属性设置为false后，运行Scroll在最后一个限位点和末尾间自由滑动；\n + * .value[3...].f32： Scroll组件限位滚动时的限位点，限位点即为Scroll组件能滑动停靠的偏移量。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { + * { .i32=ARKUI_SCROLL_SNAP_ALIGN_NONE }, { .i32=true }, { .i32=true }, + * { .f32=0 }, { .f32=500 }, { .f32=1000 }, { .f32=1500 } + * }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_SCROLL_SNAP, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_SCROLL_SNAP); + * auto nodeScrollSnap = item->value[0].i32; + * @endcode + * + */ + NODE_SCROLL_SNAP, + + /** + * @brief 滚动类组件的嵌套滚动选项，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式： \n + * .value[0]?.i32：可滚动组件往末尾端滚动时的嵌套滚动，参数类型{@link ArkUI_ScrollNestedMode}。\n + * .value[1]?.i32：可滚动组件往起始端滚动时的嵌套滚动，参数类型{@link ArkUI_ScrollNestedMode}。 + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0]?.i32：可滚动组件往末尾端滚动时的嵌套滚动，参数类型{@link ArkUI_ScrollNestedMode}。\n + * .value[1]?.i32：可滚动组件往起始端滚动时的嵌套滚动，参数类型{@link ArkUI_ScrollNestedMode}。 + * + * @code {.c} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { { .i32 = ARKUI_SCROLL_NESTED_MODE_SELF_ONLY }, + * { .i32 = ARKUI_SCROLL_NESTED_OPTIONS_SELF_ONLY } }; + * ArkUI_AttributeItem item = {value, sizeof(value)/sizeof(ArkUI_NumberValue)}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SCROLL_NESTED_SCROLL, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SCROLL_NESTED_SCROLL); + * auto first = item->value[0].i32; + * auto second = item->value[1].i32; + * @endcode + * + */ + NODE_SCROLL_NESTED_SCROLL, + /** + * @brief Scroll滑动到指定位置，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式： \n + * .value[0].f32：水平滑动偏移，单位为vp。\n + * .value[1].f32：垂直滑动偏移，单位为vp。\n + * .value[2]?.i32：可选值，是否使能默认弹簧动效，默认值为0不使能。 + * .value[3]?.i32：可选值，滚动时长，单位为毫秒。\n + * .value[4]?.i32：可选值，滚动曲线，参数类型{@link ArkUI_AnimationCurve}。默认值为ARKUI_CURVE_EASE。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32：水平滑动偏移，单位为vp。\n + * .value[1].f32：垂直滑动偏移，单位为vp。\n + * + * @code {.c} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 10, 100, { .i32 = 1000 }, { .i32 = ARKUI_CURVE_EASE }, + * { .i32 = 1 } }; + * ArkUI_AttributeItem item = {value, sizeof(value)/sizeof(ArkUI_NumberValue)}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SCROLL_OFFSET, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SCROLL_OFFSET); + * auto x = item->value[0].f32; + * auto y = item->value[1].f32; + * @endcode + * + */ + NODE_SCROLL_OFFSET, + + /** + * @brief Scroll滚动到容器边缘，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式： \n + * .value[0].i32：容器边缘，参数类型{@link ArkUI_ScrollEdge}。 + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：容器边缘，参数类型{@link ArkUI_ScrollEdge}。 + * + * @code {.c} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { { .i32 = ARKUI_SCROLL_EDGE_TOP } }; + * ArkUI_AttributeItem item = {value, sizeof(value)/sizeof(ArkUI_NumberValue)}; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SCROLL_EDGE, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SCROLL_EDGE); + * auto value = item->value[0].i32; + * @endcode + * + */ + NODE_SCROLL_EDGE, + + /** + * @brief 是否支持滑动翻页，支持属性设置，属性重置和属性获取。 + * + * 如果同时设置了划动翻页enablePaging和限位滚动scrollSnap，则scrollSnap优先生效，enablePaging不生效。\n + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32： 是否支持划动翻页，默认值false。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32： 是否支持划动翻页。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { { .i32 = true } }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_SCROLL_ENABLE_PAGING, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_SCROLL_ENABLE_PAGING); + * auto nodeScrollEnablePaging = item->value[0].i32; + * @endcode + * + */ + NODE_SCROLL_ENABLE_PAGING, + + /** + * @brief 列表方向，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：List组件排列方向，数据类型{@link ArkUI_Axis}，默认值ARKUI_AXIS_VERTICAL。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：List组件排列方向，数据类型{@link ArkUI_Axis}。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { { .i32 = ARKUI_AXIS_VERTICAL } }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_LIST_LIST_DIRECTION, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_LIST_LIST_DIRECTION); + * auto nodeListDirection = item->value[0].i32; + * @endcode + * + */ + NODE_LIST_LIST_DIRECTION = MAX_NODE_SCOPE_NUM * ARKUI_NODE_LIST, + /** + * @brief 设置ListItemGroup中header和footer是否要吸顶或吸底。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：配合ListItemGroup组件使用，设置ListItemGroup中header和footer是否要吸顶或吸底。数据类型{@link ArkUI_StickyStyle}，默认值 + * ARKUI_STICKY_STYLE_NONE。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].i32：配合ListItemGroup组件使用，设置ListItemGroup中header和footer是否要吸顶或吸底。数据类型{@link ArkUI_StickyStyle}。 + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { { .i32 = ARKUI_STICKY_STYLE_NONE } }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_LIST_STICKY, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_LIST_STICKY); + * auto nodeListSticky = item->value[0].i32; + * @endcode + * + */ + NODE_LIST_STICKY, + + /** + * @brief 列表项间距，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： 子组件主轴方向的间隔。默认值0。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].f32： 子组件主轴方向的间隔。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { 10 }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_LIST_SPACE, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_LIST_SPACE); + * auto nodeListSpace = item->value[0].f32; + * @endcode + * + */ + NODE_LIST_SPACE, + + /** + * @brief Swiper是否开启循环，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：控制是否开启循环，0表示不循环，1表示循环，默认值为1。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：控制是否开启循环，0表示不循环，1表示循环，默认值为1。 \n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { {.i32 = 0} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SWIPER_LOOP, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SWIPER_LOOP); + * auto nodeSwiperLoop = item->value[0].i32; + * @endcode + * + */ + NODE_SWIPER_LOOP = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SWIPER, + /** + * @brief Swiper子组件是否自动播放，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：控制子组件是否自动播放，0表示不自动播放，1表示自动播放，默认值为0。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：控制子组件是否自动播放，0表示不自动播放，1表示自动播放，默认值为0。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32 = 1} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SWIPER_AUTO_PLAY, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SWIPER_AUTO_PLAY); + * auto nodeSwiperLoop = item->value[0].i32; + * @endcode + * + */ + NODE_SWIPER_AUTO_PLAY, + /** + * @brief Swiper是否显示导航点指示器，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：是否显示导航点指示器，0表示不显示导航点指示器，1表示显示导航点指示器，默认值为1。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：是否显示导航点指示器，0表示不显示导航点指示器，1表示显示导航点指示器，默认值为1。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32 = 0} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SWIPER_SHOW_INDICATOR, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SWIPER_SHOW_INDICATOR); + * auto nodeSwiperShowIndicator = item->value[0].i32; + * @endcode + * + */ + NODE_SWIPER_SHOW_INDICATOR, + /** + * @brief 设置Swiper自动播放时播放的时间间隔，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：使用自动播放时播放的时间间隔，单位为毫秒。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：使用自动播放时播放的时间间隔，单位为毫秒。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 3000 }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SWIPER_INTERVAL, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SWIPER_INTERVAL); + * auto nodeSwiperInterval = item->value[0].f32; + * @endcode + * + */ + NODE_SWIPER_INTERVAL, + /** + * @brief 设置Swiper是否为纵向滑动，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：是否为纵向滑动，0表示横向滑动，1表示纵向滑动，默认值为0。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：是否为纵向滑动，0表示横向滑动，1表示纵向滑动，默认值为0。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32 = 1} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SWIPER_VERTICAL, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SWIPER_VERTICAL); + * auto nodeSwiperVertical = item->value[0].i32; + * @endcode + * + */ + NODE_SWIPER_VERTICAL, + + /** + * @brief 设置Swiper子组件切换的动画时长，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：子组件切换的动画时长，单位为毫秒, 默认值为400。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：子组件切换的动画时长，单位为毫秒, 默认值为400。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 1000 }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SWIPER_DURATION, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SWIPER_DURATION); + * auto nodeSwiperVertical = item->value[0].f32; + * @endcode + * + */ + NODE_SWIPER_DURATION, + + /** + * @brief 设置Swiper的动画曲线，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：设置动画曲线参数，参数类型{@link ArkUI_AnimationCurve}，默认值为ARKUI_CURVE_LINEAR。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：设置动画曲线参数，参数类型{@link ArkUI_AnimationCurve}，默认值为ARKUI_CURVE_LINEAR。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32 = ARKUI_CURVE_SHARP} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SWIPER_CURVE, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SWIPER_CURVE); + * auto nodeSwiperVertical = item->value[0].i32; + * @endcode + * + */ + NODE_SWIPER_CURVE, + + /** + * @brief 设置Swiper子组件与子组件之间间隙，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：子组件与子组件之间间隙数值。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].f32：子组件与子组件之间间隙数值。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { 10 }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SWIPER_ITEM_SPACE, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SWIPER_ITEM_SPACE); + * auto nodeSwiperVertical = item->value[0].f32; + * @endcode + * + */ + NODE_SWIPER_ITEM_SPACE, + + /** + * @brief 设置Swiper当前在容器中显示的子组件的索引值，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：子组件的索引值。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：子组件的索引值。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {i32 = 3} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SWIPER_INDEX, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SWIPER_ITEM_SPACE); + * auto nodeSwiperIndex = item->value[0].i32; + * @endcode + * + */ + NODE_SWIPER_INDEX, + + /** + * @brief 设置Swiper一页内元素显示个数，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：子组件的索引值。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：子组件的索引值。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {i32 = 3} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SWIPER_DISPLAY_COUNT, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SWIPER_ITEM_SPACE); + * auto nodeSwiperDisplayCount = item->value[0].i32; + * @endcode + * + */ + NODE_SWIPER_DISPLAY_COUNT, + + /** + * @brief 设置Swiper禁用组件滑动切换功能，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：是否禁用组件滑动切换功能，0表示不禁用滑动切换功能，1表示禁用滑动切换功能，默认值为0。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：是否禁用组件滑动切换功能，0表示不禁用滑动切换功能，1表示禁用滑动切换功能，默认值为0。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32 = 1} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_SWIPER_DISABLE_SWIPE, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SWIPER_DISABLE_SWIPE); + * auto nodeSwiperDisplayCount = item->value[0].i32; + * @endcode + * + */ + NODE_SWIPER_DISABLE_SWIPE, + + /** + * @brief 设置Swiper是否显示导航点箭头，支持属性设置，属性重置和属性获取接口。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：设置是否显示导航点箭头，参数类型{@link ArkUI_SwiperDisplayArrow}， \n + * 默认值为ARKUI_SWIPER_ARROW_FALSE。 \n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式： \n + * .value[0].i32：设置是否显示导航点箭头，参数类型{@link ArkUI_SwiperDisplayArrow}， \n + * 默认值为ARKUI_SWIPER_ARROW_FALSE。 \n + * + * @code {.cpp} + * ArkUI_NativeNodeAPI_1* nativeNodeApi = + * reinterpret_cast(OH_ArkUI_GetNativeAPI(ARKUI_NATIVE_NODE, 1)); + * ArkUI_NumberValue value[] = { {.i32 = ARKUI_SWIPER_ARROW_SHOW_ON_HOVER} }; + * ArkUI_AttributeItem item = { value, sizeof(value)/sizeof(ArkUI_NumberValue) }; + * nativeNodeApi->setAttribute(nodeHandle, NODE_SWIPER_SHOW_DISPLAY_ARROW, &item); + * auto item = nativeNodeApi->getAttribute(nodeHandle, NODE_SWIPER_SHOW_DISPLAY_ARROW); + * auto nodeSwiperDisplayCount = item->value[0].i32; + * @endcode + * + */ + NODE_SWIPER_SHOW_DISPLAY_ARROW, + + /** + * @brief ListItemGroup头部组件。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .object：使用{@link ArkUI_NodeHandle}对象作为ListItemGroup头部组件。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .object：使用{@link ArkUI_NodeHandle}对象作为ListItemGroup头部组件。\n + * + * @code {.cpp} + * auto header = nodeAPI->createNode(ARKUI_NODE_TEXT); + * ARKUI_AttributeItem item = { .object = header }; + * basicNodeApi->setAttribute(nodeHandle, NODE_LIST_ITEM_GROUP_SET_HEADER, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_LIST_ITEM_GROUP_SET_HEADER); + * auto nodeListItemGroupSetHeader = item->object; + * @endcode + */ + NODE_LIST_ITEM_GROUP_SET_HEADER = MAX_NODE_SCOPE_NUM * ARKUI_NODE_LIST_ITEM_GROUP, + /** + * @brief ListItemGroup尾部组件。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .object：使用{@link ArkUI_NodeHandle}对象作为ListItemGroup尾部组件。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .object：使用{@link ArkUI_NodeHandle}对象作为ListItemGroup尾部组件。\n + * + * @code {.cpp} + * auto footer = nodeAPI->createNode(ARKUI_NODE_TEXT); + * ARKUI_AttributeItem item = { .object = footer }; + * basicNodeApi->setAttribute(nodeHandle, NODE_LIST_ITEM_GROUP_SET_FOOTER, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_LIST_ITEM_GROUP_SET_FOOTER); + * auto nodeListItemGroupSetFooter = item->value[0].object; + * @endcode + */ + NODE_LIST_ITEM_GROUP_SET_FOOTER, + /** + * @brief ListItemGroup分割线样式，默认无分割线，支持属性设置，属性重置和属性获取。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式：\n + * .value[0].u32： 颜色，0xargb类型；\n + * .value[1].f32： 分割线宽，单位vp；\n + * .value[2].f32： 分割线距离列表侧边起始端的距离，单位vp；\n + * .value[3].f32： 分割线距离列表侧边结束端的距离，单位vp。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式：\n + * .value[0].u32： 颜色，0xargb类型；\n + * .value[1].f32： 分割线宽，单位vp；\n + * .value[2].f32： 分割线距离列表侧边起始端的距离，单位vp；\n + * .value[3].f32： 分割线距离列表侧边结束端的距离，单位vp。\n + * + * @code {.cpp} + * ArkUI_NumberValue value[] = { { .u32 = 0xFFFFFFFF }, 1, 0, 0 }; + * ARKUI_AttributeItem item = { value, sizeof(value) / sizeof(ArkUI_NumberValue) }; + * basicNodeApi->setAttribute(nodeHandle, NODE_XCOMPONENT_SURFACE_SIZE, &item); + * auto item = basicNodeApi=>getAttribute(nodeHandle, NODE_XCOMPONENT_SURFACE_SIZE); + * auto nodeXcomponentSurfaceSize = item->value[0].i32; + * @endcode + */ + NODE_LIST_ITEM_GROUP_SET_DIVIDER, +} ArkUI_NodeAttributeType; + +#define MAX_COMPONENT_EVENT_ARG_NUM 12 +/** + * @brief 定义组件回调事件的参数类型。 + * + * @since 12 + */ +typedef struct { + /** 数据数组对象。*/ + ArkUI_NumberValue data[MAX_COMPONENT_EVENT_ARG_NUM]; +} ArkUI_NodeComponentEvent; + +/** + * @brief 定义组件回调事件使用字符串参数的类型。 + * + * @since 12 + */ +typedef struct { + /** 字符串数据。*/ + const char* pStr; +} ArkUI_StringAsyncEvent; + +/** + * @brief 提供NativeNode组件支持的事件类型定义。 + * + * @since 12 + */ +typedef enum { + /** + * @brief 手势事件类型。 + * + * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_TouchEvent}。 + */ + NODE_TOUCH_EVENT = 0, + + /** + * @brief 挂载事件。 + * + * 触发该事件的条件 ：组件挂载显示时触发此回调。\n + * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_NodeComponentEvent}。\n + * {@link ArkUI_NodeComponentEvent}中不包含参数。 + */ + NODE_EVENT_ON_APPEAR, + + /** + * @brief 组件区域变化事件 + * + * 触发该事件的条件 ：组件区域变化时触发该回调。\n + * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_NodeComponentEvent}。\n + * ::ArkUI_NodeComponentEvent中包含12个参数\n + * ArkUI_NodeComponent.data[0].f32表示 old Area 目标元素的宽度，类型为number，单位vp。\n + * ArkUI_NodeComponent.data[1].f32表示 old Area 目标元素的高度，类型为number，单位vp。\n + * ArkUI_NodeComponent.data[2].f32表示 old Area 目标元素左上角相对父元素左上角的位置的x轴坐标，类型为number，单位vp。\n + * ArkUI_NodeComponent.data[3].f32表示 old Area 目标元素左上角相对父元素左上角的位置的y轴坐标，类型为number，单位vp。\n + * ArkUI_NodeComponent.data[4].f32表示 old Area 目标元素目标元素左上角相对页面左上角的位置的x轴坐标，类型为number，单位vp。\n + * ArkUI_NodeComponent.data[5].f32表示 old Area 目标元素目标元素左上角相对页面左上角的位置的y轴坐标，类型为number，单位vp。\n + * ArkUI_NodeComponent.data[6].f32表示 new Area 目标元素的宽度，类型为number，单位vp。\n + * ArkUI_NodeComponent.data[7].f32表示 new Area 目标元素的高度，类型为number，单位vp。\n + * ArkUI_NodeComponent.data[8].f32表示 new Area 目标元素左上角相对父元素左上角的位置的x轴坐标，类型为number，单位vp。\n + * ArkUI_NodeComponent.data[9].f32表示 new Area 目标元素左上角相对父元素左上角的位置的y轴坐标，类型为number，单位vp。\n + * ArkUI_NodeComponent.data[10].f32表示 new Area 目标元素目标元素左上角相对页面左上角的位置的x轴坐标，类型为number，单位vp。\n + * ArkUI_NodeComponent.data[11].f32表示 new Area 目标元素目标元素左上角相对页面左上角的位置的y轴坐标，类型为number，单位vp。\n + */ + NODE_EVENT_ON_ON_AREA_CHANGE, + /** + * @brief 获焦事件。 + * + * 触发该事件的条件 ：组件获焦时触发此回调。\n + * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_NodeComponentEvent}。\n + * {@link ArkUI_NodeComponentEvent}中不包含参数。 + */ + NODE_ON_FOCUS, + /** + * @brief 获焦事件。 + * + * 触发该事件的条件 ：组件获焦时触发此回调。\n + * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_NodeComponentEvent}。\n + * {@link ArkUI_NodeComponentEvent}中不包含参数。 + */ + NODE_ON_BLUR, + /** + * @brief 点击事件类型。 + * + * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_TouchEvent}，包含了抬手阶段的触碰点信息。 + */ + NODE_ON_CLICK, + + /** + * @brief 图片加载成功事件。 + * + * 触发该事件的条件 ：图片数据加载成功和解码成功均触发该回调。\n + * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_NodeComponentEvent}。\n + * ::ArkUI_NodeComponentEvent中包含9个参数：\n + * ArkUI_NodeComponent.data[0].i32表示加载状态，0表示数据加载成功，1表示解码成功。\n + * ArkUI_NodeComponent.data[1].f32表示图片的宽度，单位px。\n + * ArkUI_NodeComponent.data[2].f32表示图片的高度，单位px。\n + * ArkUI_NodeComponent.data[3].f32表示当前组件的宽度，单位px。\n + * ArkUI_NodeComponent.data[4].f32表示当前组件的高度，单位px。\n + * ArkUI_NodeComponent.data[5].f32图片绘制区域相对组件X轴位置，单位px。\n + * ArkUI_NodeComponent.data[6].f32图片绘制区域相对组件Y轴位置，单位px。\n + * ArkUI_NodeComponent.data[7].f32图片绘制区域宽度，单位px。\n + * ArkUI_NodeComponent.data[8].f32图片绘制区域高度，单位px。\n + */ + NODE_IMAGE_ON_COMPLETE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_IMAGE, + + /** + * @brief 图片加载失败事件。 + * + * 触发该事件的条件 ：图片加载异常时触发该回调。\n + * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_NodeComponentEvent}。\n + * ::ArkUI_NodeComponentEvent中包含1个参数：\n + * ArkUI_NodeComponent.data[0].i32错误码信息：\n + * 401: 图片路径参数异常，无法获取到图片数据。\n + * 103101: 图片格式不支持。\n + */ + NODE_IMAGE_ON_ERROR, + + /** + * @brief 图片加载失败事件。 + * + * 触发该事件的条件 ：带动效的SVG图片动画结束时触发。\n + * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_NodeComponentEvent}。\n + * ::ArkUI_NodeComponentEvent中不包含参数。 + * + */ + NODE_IMAGE_ON_SVG_PLAY_FINISH, + + /** + * @brief 开关状态发生变化时触发给事件。 + * + * 触发该事件的条件 ：开关状态发生变化。\n + * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_NodeComponentEvent}。\n + * ::ArkUI_NodeComponentEvent中包含1个参数：\n + * ArkUI_NodeComponent.data[0].i32：当前开关状态，1表示开，0表示关。 + * + */ + NODE_TOGGLE_ON_CHANGE = MAX_NODE_SCOPE_NUM * ARKUI_NODE_TOGGLE, + + /** + * @brief 定义ARKUI_NODE_SCROLL滚动组件的滚动事件枚举值。 + * + * 触发该事件的条件 ：\n + * 1、滚动组件触发滚动时触发，支持键鼠操作等其他触发滚动的输入设置。\n + * 2、通过滚动控制器API接口调用。\n + * 3、越界回弹。\n + * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_NodeComponentEvent}。\n + * ::ArkUI_NodeComponentEvent中包含2个参数\n + * ArkUI_NodeComponent.data[0].f32表示距离上一次事件触发的X轴增量。\n + * ArkUI_NodeComponent.data[1].f32表示距离上一次事件触发的Y轴增量。\n + */ + NODE_SCROLL_EVENT_ON_SCROLL = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SCROLL, + /** + * @brief 定义ARKUI_NODE_SCROLL滚动组件的滚动帧始事件枚举值 + * + * 触发该事件的条件 ：\n + * 1、滚动组件触发滚动时触发，包括键鼠操作等其他触发滚动的输入设置。\n + * 2、调用控制器接口时不触发。\n + * 3、越界回弹不触发。\n + * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_NodeComponentEvent}。\n + * ::ArkUI_NodeComponentEvent中包含2个参数\n + * ArkUI_NodeComponent.data[0].f32表示即将发生的滚动量。\n + * ArkUI_NodeComponent.data[1].i32表示当前滚动状态。\n + * ::ArkUI_NodeComponentEvent中包含1个返回值\n + * ArkUI_NodeComponent.data[0].f32事件处理函数中可根据应用场景计算实际需要的滚动量并存于data[0].f32中，Scroll将按照返回值的实际滚动量进行滚动\n + */ + NODE_SCROLL_EVENT_ON_SCROLL_FRAME_BEGIN, + /** + * @brief 定义ARKUI_NODE_SCROLL滚动组件的滚动开始事件枚举值。 + * + * 触发该事件的条件 ：\n + * 1、滚动组件开始滚动时触发，支持键鼠操作等其他触发滚动的输入设置。\n + * 2、通过滚动控制器API接口调用后开始，带过渡动效。\n + * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_NodeComponentEvent}。\n + * ::ArkUI_NodeComponentEvent中不包含参数。\n + */ + NODE_SCROLL_EVENT_ON_SCROLL_START, + /** + * @brief 定义ARKUI_NODE_SCROLL滚动组件的滚动停止事件枚举值。 + * + * 触发该事件的条件 ：\n + * 1、滚动组件触发滚动后停止，支持键鼠操作等其他触发滚动的输入设置。\n + * 2、通过滚动控制器API接口调用后停止，带过渡动效。\n + * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_NodeComponentEvent}。\n + * ::ArkUI_NodeComponentEvent中不包含参数。\n + */ + NODE_SCROLL_EVENT_ON_SCROLL_STOP, + /** + * @brief 定义ARKUI_NODE_SCROLL滚动组件的滚动边缘事件枚举值。 + * + * 触发该事件的条件 ：\n + * 1、滚动组件滚动到边缘时触发，支持键鼠操作等其他触发滚动的输入设置。\n + * 2、通过滚动控制器API接口调用。\n + * 3、越界回弹。\n + * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_NodeComponentEvent}。\n + * ::ArkUI_NodeComponentEvent中包含1个参数。\n + * ArkUI_NodeComponent.data[0].i32表示当前碰到的是上下左右哪个边。\n + */ + NODE_SCROLL_EVENT_ON_SCROLL_EDGE, +} ArkUI_NodeEventType; + +/** + * @brief 定义组件事件的通用结构类型。 + * + * @since 12 + */ +typedef struct { + /** + * @brief 事件类型。 + * + * @see ArkUI_NodeEventType + */ + int32_t kind; + + /** + * @brief 事件自定义标识ID。 + * + * 该事件id在调用{@link registerNodeEvent}函数时作为参数传递进来，可应用于同一事件入口函数{@link + * registerNodeEventReceiver}分发逻辑。 + */ + int32_t eventId; + + /** 触发该组件的组件对象。*/ + ArkUI_NodeHandle node; + union { + /** touch事件类型回调参数。*/ + ArkUI_NodeTouchEvent touchEvent; + /** 通用组件事件使用数字类型回调参数。*/ + ArkUI_NodeComponentEvent componentEvent; + /** 通用组件事件使用字符串类型回调参数。*/ + ArkUI_StringAsyncEvent stringEvent; + }; +} ArkUI_NodeEvent; + +/** + * @brief 自定义组件调用::markDirty是传递的藏区标识类型。 + * + * @since 12 + */ +typedef enum { + /** + * @brief 重新测算大小。 + * + * 该flag类型触发时，同时也默认会触发重新布局。 + */ + NODE_NEED_MEASURE = 1, + + /** 重新布局位置。*/ + NODE_NEED_LAYOUT, + /** 重新进行绘制。*/ + NODE_NEED_RENDER, +} ArkUI_NodeDirtyFlag; + +/** + * @brief ArkUI提供的Native侧Node类型接口集合。 + * + * @version 1 + * @since 12 + */ +typedef struct { + /** 结构体版本。 */ + int32_t version; + + /** + * @brief 基于{@link ArkUI_NodeType}生成对应的组件并返回组件对象指针。 + * + * @param type 创建指定类型的UI组件节点。 + * @return 返回创建完成的组件操作指针，如果创建失败返回NULL。 + */ + ArkUI_NodeHandle (*createNode)(ArkUI_NodeType type); + + /** + * @brief 销毁组件指针指向的组件对象。 + * + * @param node 组件指针对象。 + */ + void (*disposeNode)(ArkUI_NodeHandle node); + + /** + * @brief 将组件挂载到某个父节点之下。 + * + * @param parent 父节点指针。 + * @param child 子节点指针。 + * @return 0 - 成功 + * 401 - 函数参数异常。 + */ + int32_t (*addChild)(ArkUI_NodeHandle parent, ArkUI_NodeHandle child); + + /** + * @brief 将组件从父节点中移除。 + * + * @param parent 父节点指针。 + * @param child 子节点指针。 + * @return 0 - 成功 + * 401 - 函数参数异常。 + */ + int32_t (*removeChild)(ArkUI_NodeHandle parent, ArkUI_NodeHandle child); + + /** + * @brief 将组件挂载到某个父节点之下，挂载位置在sibling节点之后。 + * + * @param parent 父节点指针。 + * @param child 子节点指针。 + * @param sibling 前一个兄弟节点指针，如果为空则插入位置在最前面。 + * @return 0 - 成功 + * 401 - 函数参数异常。 + */ + int32_t (*insertChildAfter)(ArkUI_NodeHandle parent, ArkUI_NodeHandle child, ArkUI_NodeHandle sibling); + + /** + * @brief 将组件挂载到某个父节点之下，挂载位置在sibling节点之前。 + * + * @param parent 父节点指针。 + * @param child 子节点指针。 + * @param sibling 后一个兄弟节点指针，如果为空则插入位置在最后面。 + * @return 0 - 成功 + * 401 - 函数参数异常。 + */ + int32_t (*insertChildBefore)(ArkUI_NodeHandle parent, ArkUI_NodeHandle child, ArkUI_NodeHandle sibling); + + /** + * @brief 将组件挂载到某个父节点之下，挂载位置由position指定。 + * + * @param parent 父节点指针。 + * @param child 子节点指针。 + * @param postion 插入位置，如果插入位置为负数或者不存在，则默认插入位置在最后面。 + * @return 0 - 成功 + * 401 - 函数参数异常。 + */ + int32_t (*insertChildAt)(ArkUI_NodeHandle parent, ArkUI_NodeHandle child, int32_t position); + + /** + * @brief 属性设置函数。 + * + * @param node 需要设置属性的节点对象。 + * @param attribute 需要设置的属性类型。 + * @param item 需要设置的属性值。 + * @return 0 - 成功。 + * 401 - 函数参数异常。 + * 106102 - 当前组件不支持该属性类型。 + */ + int32_t (*setAttribute)(ArkUI_NodeHandle node, ArkUI_NodeAttributeType attribute, const ArkUI_AttributeItem* item); + + /** + * @brief 属性获取函数。 + * + * 该接口返回的指针是ArkUI框架内部的缓冲区指针，不需要开发者主动调用delete释放内存，但是需要在该函数下一次被调用前使用，否则可能会被其他值所覆盖。 + * + * @param node 需要获取属性的节点对象。 + * @param attribute 需要获取的属性类型。 + * @return 当前属性类型的属性值，失败返回空指针。 + */ + const ArkUI_AttributeItem* (*getAttribute)(ArkUI_NodeHandle node, ArkUI_NodeAttributeType attribute); + + /** + * @brief 重置属性函数。 + * + * @param node 需要重置属性的节点对象。 + * @param attribute 需要重置的属性类型。 + * @return 0 - 成功。 + * 401 - 函数参数异常。 + * 106102 - 当前组件不支持该属性类型。 + */ + int32_t (*resetAttribute)(ArkUI_NodeHandle node, ArkUI_NodeAttributeType attribute); + + /** + * @brief 注册节点事件函数。 + * + * @param node 需要注册事件的节点对象。 + * @param eventType 需要注册的事件类型。 + * @param eventId 自定义事件ID，当事件触发时在回调参数<@link ArkUI_NodeEvent>中携带回来。 + * @return 0 - 成功。 + * 401 - 函数参数异常。 + * 106102 - 当前组件不支持该事件类型。 + */ + int32_t (*registerNodeEvent)(ArkUI_NodeHandle node, ArkUI_NodeEventType eventType, int32_t eventId); + + /** + * @brief 反注册节点事件函数。 + * + * @param node 需要反注册事件的节点对象。 + * @param eventType 需要反注册的事件类型。 + */ + void (*unregisterNodeEvent)(ArkUI_NodeHandle node, ArkUI_NodeEventType eventType); + + /** + * @brief 注册事件回调统一入口函数。 + * + * ArkUI框架会统一收集过程中产生的组件事件并通过注册的eventReceiver函数回调给开发者。\n + * 重复调用时会覆盖前一次注册的函数。 + * + * @param eventReceiver 事件回调统一入口函数。 + */ + void (*registerNodeEventReceiver)(void (*eventReceiver)(ArkUI_NodeEvent* event)); + + /** + * @brief 反注册事件回调统一入口函数。 + * + */ + void (*unregisterNodeEventReceiver)(); + + /** + * @brief 强制标记当前节点需要重新测算，布局或者绘制。 + * + * 系统属性设置更新场景下ArkUI框架会自动标记藏区并重新执行测算，布局或者绘制，不需要开发者主动调用该函数。 + * + * @param node 需要标记藏区的节点对象。 + * @param dirtyFlag 藏区类型。 + */ + void (*markDirty)(ArkUI_NodeHandle node, ArkUI_NodeDirtyFlag dirtyFlag); +} ArkUI_NativeNodeAPI_1; + +#ifdef __cplusplus +}; +#endif + +#endif // ARKUI_NATIVE_NODE_H +/** @}*/ diff --git a/arkui/ace_engine/native/native_type.h b/arkui/ace_engine/native/native_type.h new file mode 100644 index 0000000000000000000000000000000000000000..7d271a0ff878097cc80c41dd77120014990428c2 --- /dev/null +++ b/arkui/ace_engine/native/native_type.h @@ -0,0 +1,736 @@ +/* + * Copyright (c) 2024 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * @addtogroup ArkUI_NativeModule + * @{ + * + * @brief 提供ArkUI在Native侧的UI能力，如UI组件创建销毁、树节点操作，属性设置，事件监听等。 + * + * @since 12 + */ + +/** + * @file native_type.h + * + * @brief 提供NativeModule公共的类型定义。 + * + * @library libace_ndk.z.so + * @syscap SystemCapability.ArkUI.ArkUI.Full + * @since 12 + */ + +#ifndef ARKUI_NATIVE_TYPE_H +#define ARKUI_NATIVE_TYPE_H + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * @brief 提供ArkUI native组件实例对象定义。 + * + * @since 12 + */ +struct ArkUI_Node; + +/** + * @brief 定义ArkUI native组件实例对象指针定义。 + * + * @since 12 + */ +typedef struct ArkUI_Node* ArkUI_NodeHandle; + +/** + * @brief ArkUI在native侧的数字类型定义。 + * + * @since 12 + */ +typedef union { + /** 浮点类型。*/ + float f32; + /** 有符号整型。*/ + int32_t i32; + /** 无符号整型。*/ + uint32_t u32; +} ArkUI_NumberValue; + +/** + * @brief 定义布局对齐枚举值。 + * + * @since 12 + */ +typedef enum { + /** 顶部起始。 */ + 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, +} ArkUI_Alignment; + +/** + * @brief 定义图片重复铺设枚举值。 + * + * @since 12 + */ +typedef enum { + /** 不重复。 */ + ARKUI_IMAGE_REPEAT_NO_REPEAT = 0, + /** 在X轴方向重复。 */ + ARKUI_IMAGE_REPEAT_X, + /** 在Y轴方向重复。 */ + ARKUI_IMAGE_REPEAT_Y, + /** 在X轴和Y轴方向重复。 */ + ARKUI_IMAGE_REPEAT_XY, +} ArkUI_ImageRepeat; + +/** + * @brief 定义字体样式枚举值。 + * + * @since 12 + */ +typedef enum { + /** 标准字体样式。 */ + ARKUI_FONT_STYLE_NORMAL = 0, + /** 斜体字体样式。 */ + ARKUI_FONT_STYLE_ITALIC +} ArkUI_FontStyle; + +/** + * @brief 定义字体粗细/字重枚举值。 + * + * @since 12 + */ +typedef enum { + /** 100 */ + ARKUI_FONT_WEIGHT_W100 = 0, + /** 200 */ + ARKUI_FONT_WEIGHT_W200, + /** 300 */ + ARKUI_FONT_WEIGHT_W300, + /** 400 */ + ARKUI_FONT_WEIGHT_W400, + /** 500 */ + ARKUI_FONT_WEIGHT_W500, + /** 600 */ + ARKUI_FONT_WEIGHT_W600, + /** 700 */ + ARKUI_FONT_WEIGHT_W700, + /** 800 */ + ARKUI_FONT_WEIGHT_W800, + /** 900 */ + 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, +} ArkUI_FontWeight; + +/** + * @brief 定义字体水平对齐样式枚举值。 + * + * @since 12 + */ +typedef enum { + /** 水平对齐首部。 */ + ARKUI_TEXT_ALIGN_START = 0, + /** 水平居中对齐。 */ + ARKUI_TEXT_ALIGN_CENTER, + /** 水平对齐尾部。 */ + ARKUI_TEXT_ALIGN_END, + /** 双端对齐。 */ + ARKUI_TEXT_ALIGN_JUSTIFY, +} ArkUI_TextAlign; + +typedef enum { + /** 不使用装饰线。*/ + ARKUI_TEXT_DECORATION_TYPE_NONE = 0, + /** 文字下划线修饰。*/ + ARKUI_TEXT_DECORATION_TYPE_UNDERLINE, + /** 文字上划线修饰。*/ + ARKUI_TEXT_DECORATION_TYPE_OVERLINE, + /** 穿过文本的修饰线。*/ + ARKUI_TEXT_DECORATION_TYPE_LINE_THROUGH, +} ArkUI_TextDecorationType; + +typedef enum { + /** 保持原有大小写。*/ + ARKUI_TEXT_CASE_NORMAL = 0, + /** 文本全小写。*/ + ARKUI_TEXT_CASE_LOWER, + /** 文本全大写。*/ + ARKUI_TEXT_CASE_UPPER, +} ArkUI_TextCase; + +typedef enum { + /** 不支持复制。*/ + ARKUI_COPY_OPTIONS_NONE = 0, + /** 支持应用内复制。*/ + ARKUI_COPY_OPTIONS_IN_APP, + /** 支持设备内复制。*/ + ARKUI_COPY_OPTIONS_LOCAL_DEVICE, + /** 支持跨设备复制。*/ + ARKUI_COPY_OPTIONS_CROSS_DEVICE, +} ArkUI_CopyOptions; + +typedef enum { + /** 颜色。*/ + ARKUI_SHADOW_TYPE_COLOR = 0, + /** 模糊。*/ + ARKUI_SHADOW_TYPE_BLUR +} ArkUI_ShadowType; + +/** + * @brief 定义边缘滑动效果枚举值。 + * + * @since 12 + */ +typedef enum { + /** 弹性物理动效，滑动到边缘后可以根据初始速度或通过触摸事件继续滑动一段距离，松手后回弹。*/ + ARKUI_EDGE_EFFECT_SPRING = 0, + /** 阴影效果，滑动到边缘后会有圆弧状的阴影。*/ + ARKUI_EDGE_EFFECT_FADE, + /** 滑动到边缘后无效果。*/ + ARKUI_EDGE_EFFECT_NONE, +} ArkUI_EdgeEffect; + +/** + * @brief 定义列表项滚动结束对齐效果枚举值。 + * + * @since 12 + */ +typedef enum { + /** 默认无项目滚动对齐效果。*/ + ARKUI_SCROLL_SNAP_ALIGN_NONE = 0, + /** 视图中的第一项将在列表的开头对齐。*/ + ARKUI_SCROLL_SNAP_ALIGN_START, + /** 视图中的中间项将在列表中心对齐。*/ + ARKUI_SCROLL_SNAP_ALIGN_CENTER, + /** 视图中的最后一项将在列表末尾对齐。*/ + ARKUI_SCROLL_SNAP_ALIGN_END, +} ArkUI_ScrollSnapAlign; + +/** + * @brief 定义滚动条状态枚举值。 + * + * @since 12 + */ +typedef enum { + /** 不显示。*/ + ARKUI_SCROLL_BAR_DISPLAY_MODE_OFF = 0, + /** 按需显示(触摸时显示，2s后消失)。*/ + ARKUI_SCROLL_BAR_DISPLAY_MODE_AUTO, + /** 常驻显示。*/ + ARKUI_SCROLL_BAR_DISPLAY_MODE_ON, +} ArkUI_ScrollBarDisplayMode; + +/** + * @brief 定义滚动方向和List组件排列方向枚举值。 + * + * @since 12 + */ +typedef enum { + /** 仅支持竖直方向滚动。*/ + ARKUI_AXIS_VERTICAL = 0, + /** 仅支持水平方向滚动。*/ + ARKUI_AXIS_HORIZONTAL, +} ArkUI_Axis; + +/** + * @brief 定义列表是否吸顶和吸底枚举值。 + * + * @since 12 + */ +typedef enum { + /** ListItemGroup的header不吸顶，footer不吸底。*/ + ARKUI_STICKY_STYLE_NONE = 0, + /** ListItemGroup的header吸顶，footer不吸底。*/ + ARKUI_STICKY_STYLE_HEADER, + /** ListItemGroup的footer吸底，header不吸顶。*/ + ARKUI_STICKY_STYLE_FOOTER, + /** ListItemGroup的footer吸底，header吸顶。*/ + ARKUI_STICKY_STYLE_BOTH, +} ArkUI_StickyStyle; + + +/** + * @brief 边框线条样式枚举值。 + * + * @since 12 + */ +typedef enum { + /** 显示为一条实线。 */ + ARKUI_BORDER_STYLE_SOLID = 0, + /** 显示为一系列短的方形虚线。*/ + ARKUI_BORDER_STYLE_DASHED, + /** 显示为一系列圆点。*/ + ARKUI_BORDER_STYLE_DOTTED, +} ArkUI_BorderStyle; + +/** + * @brief 触摸测试控制枚举值。 + * + * @since 12 + */ +typedef enum { + /** 默认触摸测试效果。 */ + ARKUI_HIT_TEST_MODE_DEFAULT = 0, + /** 自身响应触摸测试。*/ + ARKUI_HIT_TEST_MODE_BLOCK, + /** 自身和子节点都响应触摸测试。*/ + ARKUI_HIT_TEST_MODE_TRANSPARENT, + /** 自身不响应触摸测试。*/ + ARKUI_HIT_TEST_MODE_NONE +} ArkUI_HitTestMode; + +/** + * @brief 阴影效果枚举值。 + * + * @since 12 + */ +typedef enum { + /** 超小阴影。 */ + 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, +} ArkUI_ShadowStyle; + +/** + * @brief 动画曲线枚举值。 + * + * @since 12 + */ +typedef enum { + /** 动画从头到尾的速度都是相同。 */ + 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, +} ArkUI_AnimationCurve; + +/** + * @brief Swiper导航点箭头枚举值。 + * + * @since 12 + */ +typedef enum { + /** 不显示swiper中导航点箭头。 */ + ARKUI_SWIPER_ARROW_FALSE = 0, + /** 显示swiper中导航点箭头。 */ + ARKUI_SWIPER_ARROW_TRUE, + /** 在hover状态下显示swiper中导航点箭头。 */ + ARKUI_SWIPER_ARROW__SHOW_ON_HOVER, +} ArkUI_SwiperDisplayArrow; + +/** + * @brief 定义组件支持设置文本是否可复制粘贴。 + * + * @since 12 + */ +typedef enum { + /** 不支持复制。 */ + ARKUI_TEXT_COPY_OPTIONS_NONE = 0, + /** 支持应用内复制。*/ + ARKUI_TEXT_COPY_OPTIONS_IN_APP, + /** 支持设备内复制。*/ + ARKUI_TEXT_COPY_OPTIONS_LOCAL_DEVICE, + /** 支持跨设备复制。*/ + ARKUI_TEXT_COPY_OPTIONS_CROSS_DEVICE, +} ArkUI_TextCopyOptions; + +/** + * @brief 定义文本自适应高度的方式。 + * + * @since 12 + */ +typedef enum { + /** 设置文本高度自适应方式为以MaxLines优先。 */ + 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, +} ArkUI_TextHeightAdaptivePolicy; + +/** + * @brief 定义嵌套滚动选项。 + * + * @since 12 + */ +typedef enum { + /** 只自身滚动，不与父组件联动。 */ + ARKUI_SCROLL_NESTED_MODE_SELF_ONLY = 0, + /** 自身先滚动，自身滚动到边缘以后父组件滚动。父组件滚动到边缘以后 + 如果父组件有边缘效果，则父组件触发边缘效果，否则子组件触发边缘效果。*/ + ARKUI_SCROLL_NESTED_MODE_SELF_FIRST, + /** 父组件先滚动，父组件滚动到边缘以后自身滚动。 + 身滚动到边缘后，如果有边缘效果，会触发自身的边缘效果，否则触发父组件的边缘效果。*/ + ARKUI_SCROLL_NESTED_MODE_PARENT_FIRST, + /** 自身和父组件同时滚动，自身和父组件都到达边缘以后 + 如果自身有边缘效果，则自身触发边缘效果，否则父组件触发边缘效果。*/ + ARKUI_SCROLL_NESTED_MODE_PARALLEL, +} ArkUI_ScrollNestedMode; + +/** + * @brief 定义滚动到的边缘位置。 + * + * @since 12 + */ +typedef enum { + /** 竖直方向上边缘。*/ + ARKUI_SCROLL_EDGE_TOP = 0, + /** 竖直方向居中位置。*/ + ARKUI_SCROLL_EDGE_CENTER, + /** 竖直方向下边缘。*/ + ARKUI_SCROLL_EDGE_BOTTOM, + /** 交叉轴方向文本基线位置。*/ + ARKUI_SCROLL_EDGE_BASELINE, + /** 水平方向起始位置。*/ + ARKUI_SCROLL_EDGE_START, + /** 水平方向居中位置。*/ + ARKUI_SCROLL_EDGE_MIDDLE, + /** 水平方向末尾位置。*/ + ARKUI_SCROLL_EDGE_END, +} ArkUI_ScrollEdge; + +/** + * @brief 混合模式枚举值。 + * + * @since 12 + */ +typedef enum { + /** 将上层图像直接覆盖到下层图像上，不进行任何混合操作。 */ + ARKUI_BLEND_MODE_NONE, + /** 将源像素覆盖的目标像素清除为完全透明。 */ + ARKUI_BLEND_MODE_CLEAR, + /** r = s，只显示源像素。 */ + ARKUI_BLEND_MODE_SRC, + /** r = d，只显示目标像素。 */ + ARKUI_BLEND_MODE_DST, + /** r = s + (1 - sa) * d，将源像素按照透明度进行混合，覆盖在目标像素上。 */ + ARKUI_BLEND_MODE_SRC_OVER, + /** r = d + (1 - da) * s，将目标像素按照透明度进行混合，覆盖在源像素上。 */ + ARKUI_BLEND_MODE_DST_OVER, + /** r = s * da，只显示源像素中与目标像素重叠的部分。 */ + ARKUI_BLEND_MODE_SRC_IN, + /** r = d * sa，只显示目标像素中与源像素重叠的部分。 */ + ARKUI_BLEND_MODE_DST_IN, + /** r = s * (1 - da)，只显示源像素中与目标像素不重叠的部分。 */ + ARKUI_BLEND_MODE_SRC_OUT, + /** r = d * (1 - sa)，只显示目标像素中与源像素不重叠的部分。 */ + ARKUI_BLEND_MODE_DST_OUT, + /** r = s * da + d * (1 - sa)，在源像素和目标像素重叠的地方绘制源像素，在源像素和目标像素不重叠的地方绘制目标像素。 + */ + ARKUI_BLEND_MODE_SRC_ATOP, + /** r = d * sa + s * (1 - da)，在源像素和目标像素重叠的地方绘制目标像素，在源像素和目标像素不重叠的地方绘制源像素。 + */ + ARKUI_BLEND_MODE_DST_ATOP, + /** r = s * (1 - da) + d * (1 - sa)，只显示源像素与目标像素不重叠的部分。 */ + ARKUI_BLEND_MODE_XOR, + /** r = min(s + d, 1)，将源像素值与目标像素值相加，并将结果作为新的像素值。 */ + ARKUI_BLEND_MODE_PLUS, + /** r = s * d，将源像素与目标像素进行乘法运算，并将结果作为新的像素值。 */ + ARKUI_BLEND_MODE_MODULATE, + /** r = s + d - s * d，将两个图像的像素值相加，然后减去它们的乘积来实现混合。 */ + ARKUI_BLEND_MODE_SCREEN, + /** 根据目标像素来决定使用MULTIPLY混合模式还是SCREEN混合模式。 */ + ARKUI_BLEND_MODE_OVERLAY, + /** rc = s + d - max(s * da, d * sa), ra = kSrcOver，当两个颜色重叠时，较暗的颜色会覆盖较亮的颜色。 */ + ARKUI_BLEND_MODE_DARKEN, + /** rc = s + d - min(s * da, d * sa), ra = + kSrcOver，将源图像和目标图像中的像素进行比较，选取两者中较亮的像素作为最终的混合结果。 */ + ARKUI_BLEND_MODE_LIGHTEN, + /** 使目标像素变得更亮来反映源像素。 */ + ARKUI_BLEND_MODE_COLOR_DODGE, + /** 使目标像素变得更暗来反映源像素。 */ + ARKUI_BLEND_MODE_COLOR_BURN, + /** 根据源像素的值来决定目标像素变得更亮或者更暗。根据源像素来决定使用MULTIPLY混合模式还是SCREEN混合模式。 */ + ARKUI_BLEND_MODE_HARD_LIGHT, + /** 根据源像素来决定使用LIGHTEN混合模式还是DARKEN混合模式。 */ + ARKUI_BLEND_MODE_SOFT_LIGHT, + /** rc = s + d - 2 * (min(s * da, d * sa)), ra = + kSrcOver，对比源像素和目标像素，亮度更高的像素减去亮度更低的像素，产生高对比度的效果。 */ + ARKUI_BLEND_MODE_DIFFERENCE, + /** rc = s + d - two(s * d), ra = kSrcOver，对比源像素和目标像素，亮度更高的像素减去亮度更低的像素，产生柔和的效果。 + */ + ARKUI_BLEND_MODE_EXCLUSION, + /** r = s * (1 - da) + d * (1 - sa) + s * d，将源图像与目标图像进行乘法混合，得到一张新的图像。 */ + ARKUI_BLEND_MODE_MULTIPLY, + /** 保留源图像的亮度和饱和度，但会使用目标图像的色调来替换源图像的色调。 */ + ARKUI_BLEND_MODE_HUE, + /** 保留目标像素的亮度和色调，但会使用源像素的饱和度来替换目标像素的饱和度。 */ + ARKUI_BLEND_MODE_SATURATION, + /** 保留源像素的饱和度和色调，但会使用目标像素的亮度来替换源像素的亮度。 */ + ARKUI_BLEND_MODE_COLOR, + /** 保留目标像素的色调和饱和度，但会用源像素的亮度替换目标像素的亮度。 */ + ARKUI_BLEND_MODE_LUMINOSITY, +} ArkUI_BlendMode; + +/** + * @brief 设置容器元素内主轴方向上的布局枚举值。 + * + * @since 12 + */ +typedef enum { + /** 元素从左到右布局。 */ + ARKUI_DIRECTION_LTR = 0, + /** 元素从右到左布局。 */ + ARKUI_DIRECTION_RTL, + /** 使用系统默认布局方向。 */ + ARKUI_DIRECTION_AUTO = 3, +} ArkUI_Direction; + +/** + * @brief 前景色枚举值。 + * + * @since 12 + */ +typedef enum { + /** 前景色为控件背景色的反色。 */ + ARKUI_COLOR_STRATEGY_INVERT = 0, + /** 控件背景阴影色为控件背景阴影区域的平均色。 */ + ARKUI_COLOR_STRATEGY_AVERAGE, + /** 控件背景阴影色为控件背景阴影区域的主色。 */ + ARKUI_COLOR_STRATEGY_PRIMARY, +} ArkUI_ColoringStrategy; + +/** + * @brief 定义水平方向对齐方式。 + * + * @since 12 + */ +typedef enum { + /** 按照语言方向起始端对齐。 */ + ARKUI_HORIZONTAL_ALIGN_START = 0, + /** 居中对齐，默认对齐方式。 */ + ARKUI_HORIZONTAL_ALIGN_CENTER, + /** 按照语言方向末端对齐。 */ + ARKUI_HORIZONTAL_ALIGN_END, +} ArkUI_HorizontalAlign; + +/** + * @brief 定义垂直对齐方式。 + * + * @since 12 + */ +typedef enum { + /** 顶部对齐。 */ + ARKUI_VERTICAL_ALIGN_TOP = 0, + /** 居中对齐，默认对齐方式。 */ + ARKUI_VERTICAL_ALIGN_CENTER, + /** 底部对齐。 */ + ARKUI_VERTICAL_ALIGN_BOTTOM, +} ArkUI_VerticalAlign; + +/** + * @brief 定义动画播放模式。 + * + * @since 12 + */ +typedef enum { + /** 动画正向播放。*/ + ARKUI_PLAY_MODE_NORMAL = 0, + /** 动画反向播放。*/ + ARKUI_PLAY_MODE_REVERSE, + /** 动画在奇数次（1、3、5...）正向播放，在偶数次（2、4、6...）反向播放。*/ + ARKUI_PLAY_MODE_ALTERNATE, + /** 动画在奇数次（1、3、5...）反向播放，在偶数次（2、4、6...）正向播放。*/ + ARKUI_PLAY_MODE_ALTERNATE_REVERSE, +} ArkUI_AnimationPlayMode; + +/** + * @brief 定义图片宽高样式。 + * + * @since 12 + */ +typedef enum { + /** 保持原图的比例不变。*/ + ARKUI_IMAGE_SIZE_AUTO = 0, + /** 默认值，保持宽高比进行缩小或者放大，使得图片两边都大于或等于显示边界。*/ + ARKUI_IMAGE_SIZE_COVER, + /** 保持宽高比进行缩小或者放大，使得图片完全显示在显示边界内。*/ + ARKUI_IMAGE_SIZE_CONTAIN, +} ArkUI_ImageSize; + +/** + * @brief 定义取色模式。 + * + * @since 12 + */ +typedef enum { + /** 不使用取色模糊。*/ + ARKUI_ADAPTIVE_COLOR_DEFAULT = 0, + /** 使用取色模糊。*/ + ARKUI_ADAPTIVE_COLOR_AVERAGE, +} ArkUI_AdaptiveColor; + +/** + * @brief 定义深浅色模式。 + * + * @since 12 + */ +typedef enum { + /** 跟随系统深浅色模式。*/ + ARKUI_COLOR_MODE_SYSTEM = 0, + /** 固定使用浅色模式。*/ + ARKUI_COLOR_MODE_LIGHT, + /** 固定使用深色模式。 */ + ARKUI_COLOR_MODE_DARK, +} ArkUI_ColorMode; + +/** + * @brief 定义背景模糊样式。 + * + * @since 12 + */ +typedef enum { + /** 轻薄材质模糊。 */ + 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, +} ArkUI_BlurStyle; + +/** + * @brief 定义文本超长时的显示方式。 + * + * @since 12 + */ +typedef enum { + /** 文本超长时不裁剪显示。 */ + ARKUI_TEXT_OVERFLOW_NONE = 0, + /** 文本超长时进行裁剪显示。 */ + ARKUI_TEXT_OVERFLOW_CLIP, + /** 文本超长时显示不下的文本用省略号代替。 */ + ARKUI_TEXT_OVERFLOW_ELLIPSIS, + /** 文本超长时以跑马灯的方式展示。 */ + ARKUI_TEXT_OVERFLOW_MARQUEE, +} ArkUI_TextOverFlow; + +/** + * @brief 定义image填充效果。 + *ImageSpanAlignment + * @since 12 + */ +typedef enum { + /** 保持宽高比进行缩小或者放大，使得图片完全显示在显示边界内。 */ + 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_ObjectFit; + +/** + * @brief 定义图片插值效果。 + * + * @since 12 + */ +typedef enum { + /** 不使用图片插值。*/ + ARKUI_INTERPOLATION_NONE = 0, + /** 低图片插值。*/ + ARKUI_INTERPOLATION_LOW, + /** 中图片插值。*/ + ARKUI_INTERPOLATION_MEDIUM, + /** 高图片插值，插值质量最高。*/ + ARKUI_INTERPOLATION_HIGH, +} ArkUI_ImageInterpolation; + +#ifdef __cplusplus +}; +#endif + +#endif // ARKUI_NATIVE_TYPE_H +/** @} */