diff --git a/zh-cn/native_sdk/arkui/ace_engine/native/drag_and_drop.h b/zh-cn/native_sdk/arkui/ace_engine/native/drag_and_drop.h index 73848182ae2d24e65e4d9648fa1ead0f8d84af26..15729e636d4140c7b4dacc555ab8d01ac55fd905 100644 --- a/zh-cn/native_sdk/arkui/ace_engine/native/drag_and_drop.h +++ b/zh-cn/native_sdk/arkui/ace_engine/native/drag_and_drop.h @@ -308,7 +308,7 @@ int32_t OH_ArkUI_DragEvent_GetDataTypes( int32_t OH_ArkUI_DragEvent_GetDragResult(ArkUI_DragEvent* event, ArkUI_DragResult* result); /** - * @brief 从ArkUI_DragEvent中获取拖拽结果。 + * @brief 从ArkUI_DragEvent中获取数据处理方式。 * * @param event ArkUI_DragEvent事件指针。 * @param operation 数据的处理方式. @@ -432,7 +432,7 @@ float OH_ArkUI_DragEvent_GetVelocity(ArkUI_DragEvent* event); int32_t OH_ArkUI_DragEvent_GetModifierKeyStates(ArkUI_DragEvent* event, uint64_t* keys); /** - * @brief Request to start the data sync process with the sync option. + * @brief 使用同步参数开始数据同步。 * * @param event ArkUI_DragEvent事件指针。 * @param options OH_UdmfGetDataParams参数指针。 @@ -448,7 +448,7 @@ int32_t OH_ArkUI_DragEvent_StartDataLoading( ArkUI_DragEvent* event, OH_UdmfGetDataParams* options, char* key, unsigned int keyLen); /** - * @brief Cancel the data sync process. + * @brief 取消数据同步。 * * @param uiContext UI实例对象指针。 * @param key 表示数据的key值并通过 {@link OH_ArkUI_DragEvent_StartDataLoading} 返回。 @@ -835,19 +835,6 @@ ArkUI_DragStatus OH_ArkUI_DragAndDropInfo_GetDragStatus(ArkUI_DragAndDropInfo* d */ ArkUI_DragEvent* OH_ArkUI_DragAndDropInfo_GetDragEvent(ArkUI_DragAndDropInfo* dragAndDropInfo); -/** - * @brief 通过调用该方法，系统可以判断目标组件上配置的可支持数据类型是否包含所拖拽的数据类型。如何在组件上配置所支持的数据类型，可参考{@link OH_ArkUI_SetNodeAllowedDropDataTypes}。 - * 系统默认仅进行数据类型的严格匹配。例如，当声明支持"general.image"数据类型时，仅当数据分享方填充的数据类型为"general.image"时，才会判定为允许落入。 - * 调用该方法后，系统在进行判断时，会考虑数据类型之间的关系，如"general.image.jpeg"类型是"general.image"的子类型之一，即使不完全相等，也会判定为允许落入。 - * - * @param node 组件节点指针。 - * @return 错误码。 - * {@link ARKUI_ERROR_CODE_NO_ERROR} 成功。 - * {@link ARKUI_ERROR_CODE_PARAM_INVALID} 函数参数异常。 - * @since 20 - */ -ArkUI_ErrorCode OH_ArkUI_EnableDragDataTypeRelationCheck(ArkUI_NodeHandle node); - /** * @brief 通过构造的DragAction对象发起拖拽。 * @@ -859,19 +846,6 @@ ArkUI_ErrorCode OH_ArkUI_EnableDragDataTypeRelationCheck(ArkUI_NodeHandle node); */ int32_t OH_ArkUI_StartDrag(ArkUI_DragAction* dragAction); -/** - * @brief 设置是否开启禁止角标显示。默认情况下，如果组件无法接收或处理用户拖动的数据，系统将显示一个与移动操作相匹配的角标图标，即没有角标显示。 - * 应用程序可以在相应的UI实例上调用此方法，以明确声明在无法处理数据的情况下需要显示一个明确的“禁止”指示符。 - * - * @param uiContext UI实例对象指针。 - * @param enabled 是否禁止角标显示。 - * @return 错误码。 - * {@link ARKUI_ERROR_CODE_NO_ERROR} 成功。 - * {@link ARKUI_ERROR_CODE_PARAM_INVALID} 函数参数异常。 - * @since 20 - */ -ArkUI_ErrorCode OH_ArkUI_SetDragDisallowStatusShowingEnabled(ArkUI_ContextHandle uiContext, bool enabled); - /** * @brief 请求延迟处理拖拽结束事件，等待应用程序确认操作结果。应用程序需通过 {@link OH_ArkUI_NotifyDragResult} * 接口将最终结果回传至系统，并在所有处理完成后调用 {@link OH_ArkUI_NotifyDragEndPendingDone}。 diff --git a/zh-cn/native_sdk/arkui/ace_engine/native/native_gesture.h b/zh-cn/native_sdk/arkui/ace_engine/native/native_gesture.h index 686430c07f6f111bbbd072dd94f36523a4fecca0..a0436510bfc5da63df18345c4af9bf759b1b33c6 100644 --- a/zh-cn/native_sdk/arkui/ace_engine/native/native_gesture.h +++ b/zh-cn/native_sdk/arkui/ace_engine/native/native_gesture.h @@ -314,7 +314,7 @@ bool OH_ArkUI_GestureInterruptInfo_GetSystemFlag(const ArkUI_GestureInterruptInf /** * @brief 返回被打断的手势指针。 * -* @param event 打断回调事件。 +* @param event 手势打断回调事件。 * @return 被打断的手势指针。 * @since 12 */ @@ -323,7 +323,7 @@ ArkUI_GestureRecognizer* OH_ArkUI_GestureInterruptInfo_GetRecognizer(const ArkUI /** * @brief 返回打断的手势事件数据。 * -* @param event 打断回调事件。 +* @param event 手势打断回调事件。 * @return 打断的手势事件数据。 * @since 12 */ @@ -332,7 +332,7 @@ ArkUI_GestureEvent* OH_ArkUI_GestureInterruptInfo_GetGestureEvent(const ArkUI_Ge /** * @brief 当要触发的是系统内部手势时，使用该方法可返回该系统内部手势的类型。 * -* @param event 打断回调事件。 +* @param event 手势打断回调事件。 * @return 要触发的内部手势对应的手势类型，如果当前触发的手势不是系统内部手势，则返回 -1。 * @since 12 */ @@ -503,10 +503,10 @@ float OH_ArkUI_PinchGesture_GetCenterX(const ArkUI_GestureEvent* event); float OH_ArkUI_PinchGesture_GetCenterY(const ArkUI_GestureEvent* event); /** -* @brief 获取被绑定手势的ARKUI组件。 +* @brief 获取绑定该手势的ARKUI组件 * * @param event 手势事件。 -* @return ARKUI组件。 +* @return 绑定该手势的ARKUI组件。若返回Null，则表示event是无效值。 * @since 12 */ ArkUI_NodeHandle OH_ArkUI_GestureEvent_GetNode(const ArkUI_GestureEvent* event); diff --git a/zh-cn/native_sdk/arkui/ace_engine/native/native_key_event.h b/zh-cn/native_sdk/arkui/ace_engine/native/native_key_event.h index 5ba1eff6c88f4525b540945afc57cc89296d93ab..2b7b65ccd586d9b13e043daab4a758836ca75059 100644 --- a/zh-cn/native_sdk/arkui/ace_engine/native/native_key_event.h +++ b/zh-cn/native_sdk/arkui/ace_engine/native/native_key_event.h @@ -416,7 +416,10 @@ typedef enum { ARKUI_KEY_SOURCE_TYPE_MOUSE = 1, /** 键盘。 **/ ARKUI_KEY_SOURCE_TYPE_KEYBOARD = 4, - /** 游戏手柄。 **/ + /** 游戏手柄。 + * + * @since 15 + **/ ARKUI_KEY_SOURCE_TYPE_JOYSTICK = 5, } ArkUI_KeySourceType; diff --git a/zh-cn/native_sdk/arkui/ace_engine/native/native_node.h b/zh-cn/native_sdk/arkui/ace_engine/native/native_node.h index 2dfa870c2e26dc6d6ca9cf816248583572e21c72..857a6319ffb36879158de2e260c1887343d4ae59 100644 --- a/zh-cn/native_sdk/arkui/ace_engine/native/native_node.h +++ b/zh-cn/native_sdk/arkui/ace_engine/native/native_node.h @@ -6429,7 +6429,7 @@ typedef enum { */ NODE_ON_KEY_PRE_IME = 22, /** - * @brief 绑定该方法的组件获焦后，收到焦点轴事件时触发该回调. + * @brief 绑定该方法的组件获焦后，收到焦点轴事件时触发该回调。 * * 触发该事件的条件 ：由游戏手柄与获焦组件交互触发此回调。 \n * 事件回调发生时，事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_UIInputEvent}。 \n @@ -7592,9 +7592,15 @@ typedef enum { ARKUI_NODE_CUSTOM_EVENT_ON_FOREGROUND_DRAW = 1 << 3, /** overlay 类型。*/ ARKUI_NODE_CUSTOM_EVENT_ON_OVERLAY_DRAW = 1 << 4, - /** front 类型。*/ + /** + * front 类型。 + * @since 20 + */ ARKUI_NODE_CUSTOM_EVENT_ON_DRAW_FRONT = 1 << 5, - /** behind 类型。*/ + /** + * behind 类型。 + * @since 20 + */ ARKUI_NODE_CUSTOM_EVENT_ON_DRAW_BEHIND = 1 << 6, } ArkUI_NodeCustomEventType; diff --git a/zh-cn/native_sdk/arkui/ace_engine/native/ui_input_event.h b/zh-cn/native_sdk/arkui/ace_engine/native/ui_input_event.h index eab3649ba7a5c821de9cf3e9f6569e7b9f0caa18..6d79192614b0f7c48d6bd68d8d4f0dbf050a7e8e 100644 --- a/zh-cn/native_sdk/arkui/ace_engine/native/ui_input_event.h +++ b/zh-cn/native_sdk/arkui/ace_engine/native/ui_input_event.h @@ -306,7 +306,7 @@ int32_t OH_ArkUI_UIInputEvent_GetAction(const ArkUI_UIInputEvent* event); int32_t OH_ArkUI_UIInputEvent_GetSourceType(const ArkUI_UIInputEvent* event); /** - * @brief 获取UI输入事件的触发源类型。 + * @brief 获取UI输入事件的工具类型。 * * 输入工具为操作输入源设备来产生事件的操作方，如手指、触控笔，他们自身不真实产生事件， * 但可以驱动输入源设备不断产生事件。返回的类型由UI_INPUT_EVENT_TOOL_TYPE_XXX枚举值定义。 @@ -570,7 +570,7 @@ float OH_ArkUI_PointerEvent_GetTiltY(const ArkUI_UIInputEvent* event, uint32_t p * @return 错误码。 * Returns {@link ARKUI_ERROR_CODE_NO_ERROR} 成功。 * Returns {@link ARKUI_ERROR_CODE_PARAM_INVALID} 函数参数异常。 - * @since 18 + * @since 17 */ int32_t OH_ArkUI_PointerEvent_GetRollAngle(const ArkUI_UIInputEvent* event, double* rollAngle);