48f382a7创建于 14 天前历史提交

ui_input_event.h

概述

提供ArkUI在Native侧的事件定义。

引用文件： <arkui/ui_input_event.h>

库： libace_ndk.z.so

系统能力： SystemCapability.ArkUI.ArkUI.Full

起始版本： 12

相关模块： ArkUI_EventModule

相关示例： NdkInputEvent、CoastingAxisEventNDK

汇总

结构体

名称	typedef关键字	描述
ArkUI_UIInputEvent	ArkUI_UIInputEvent	UI输入事件定义。
ArkUI_CoastingAxisEvent	ArkUI_CoastingAxisEvent	定义惯性滚动轴事件。
ArkUI_TouchTestInfo	ArkUI_TouchTestInfo	定义触摸测试信息。
ArkUI_TouchTestInfoItem	ArkUI_TouchTestInfoItem	定义触摸测试信息项。
ArkUI_TouchTestInfoItem*	ArkUI_TouchTestInfoItemHandle	定义触摸测试信息项句柄。
ArkUI_TouchTestInfoItemHandle*	ArkUI_TouchTestInfoItemArray	定义触摸测试信息项句柄数组。

枚举

名称	typedef关键字	描述
ArkUI_UIInputEvent_Type	ArkUI_UIInputEvent_Type	UI输入事件类型定义。
anonymous1	-	定义输入事件的行为类型。
anonymous2	-	产生输入事件的工具类型定义。
anonymous3	-	产生输入事件的来源类型定义。
HitTestMode	HitTestMode	定义触摸测试类型的枚举值。
anonymous4	-	定义鼠标事件的行为类型。
anonymous5	-	定义鼠标事件的按键类型。
ArkUI_ModifierKeyName	ArkUI_ModifierKeyName	定义modifier按键。
anonymous6	-	定义焦点轴事件的轴类型。
ArkUI_InteractionHand	ArkUI_InteractionHand	定义触摸事件是左手还是右手。
anonymous7	-	定义轴事件的操作类型。
anonymous8	-	定义轴事件的轴类型。
ArkUI_CoastingAxisEventPhase	ArkUI_CoastingAxisEventPhase	定义惯性滚动轴事件的阶段。
ArkUI_CompetitionStrategy	ArkUI_CompetitionStrategy	事件的注入方和被注入方间手势识别结果是否为竞争场景的策略。该策略决定了事件的注入方如何与被注入方的手势处理逻辑交互，非竞争场景会同时触发手势，竞争场景只触发其中一个。
ArkUI_TouchTestStrategy	ArkUI_TouchTestStrategy	定义触摸测试策略。

函数

名称	描述
int32_t OH_ArkUI_UIInputEvent_GetType(const ArkUI_UIInputEvent* event)	获取UI输入事件的类型。在访问一个ArkUI_UIInputEvent指针对象之前，推荐使用该方法判断该输入事件的类型，该接口会返回ArkUI_UIInputEvent_Type枚举中的一种。比如，当事件是一个触控类型时，由于触控类型是指向性事件，那么使用OH_ArkUI_UIInputEvent_GetXXX及OH_ArkUI_PointerEvent_GetXXX系列接口，均可以正常访问；而如果使用OH_ArkUI_KeyEvent_GetXXX相关接口去访问它，则会有无法预期的结果。对于还未支持的事件类型，接口返回默认值0。
int32_t OH_ArkUI_UIInputEvent_GetAction(const ArkUI_UIInputEvent* event)	获取输入事件的action类型。action类型为基础事件在不同阶段的类型定义，通常代表了事件的特点，并表征事件的开始与结束，如touch down, touch up。触控事件的action类型为UI_TOUCH_EVENT_ACTION_XXX，鼠标事件的action类型为UI_MOUSE_EVENT_ACTION_XXX。
int32_t OH_ArkUI_UIInputEvent_GetSourceType(const ArkUI_UIInputEvent* event)	获取UI输入事件的触发源类型。输入源为产生输入事件的真实物理设备，如触摸屏，鼠标等，由UI_INPUT_EVENT_SOURCE_TYPE_XXX定义，而输入工具为操作输入源设备来产生事件的工具，如手指、触控笔。在某些情况下两者可能容易发生混淆，比如当用户在操作鼠标时，鼠标既是输入源，也是输入工具。
int32_t OH_ArkUI_UIInputEvent_GetToolType(const ArkUI_UIInputEvent* event)	获取UI输入事件的工具类型。输入工具为操作输入源设备来产生事件的操作方，如手指、触控笔，他们自身不真实产生事件，但可以驱动输入源设备不断产生事件。返回的类型由UI_INPUT_EVENT_TOOL_TYPE_XXX枚举值定义。
int64_t OH_ArkUI_UIInputEvent_GetEventTime(const ArkUI_UIInputEvent* event)	获取UI输入事件发生的时间。单位为ns。
uint32_t OH_ArkUI_PointerEvent_GetPointerCount(const ArkUI_UIInputEvent* event)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取多点触控的接触点数量。指向性事件一般是附带有事件发生位置信息的事件，如触摸事件，用户操作时，可以感知事件在什么位置发生。而非指向性事件，如按键事件，一般没有位置信息，没有触点的说法，所以该接口对按键事件无效。对于触摸事件，该接口多用于处理多指触控，判断用户有几根手指在操作当前控件。而对于鼠标和轴事件，可认为触点只有1个，该接口永远返回1。
int32_t OH_ArkUI_PointerEvent_GetPointerId(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取多点触控的接触点标识。返回事件发生时，事件触点的唯一标识符，用于区分同类输入设备的多点触控信息。其数值没有除标识触点外的其他含义。
int32_t OH_ArkUI_PointerEvent_GetChangedPointerId(const ArkUI_UIInputEvent* event, uint32_t* pointerIndex)	获取当前触摸事件触发的id。
float OH_ArkUI_PointerEvent_GetCurrentLocalX(const ArkUI_UIInputEvent* event)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中根据实时位置获取相对于当前组件左上角的X坐标。
float OH_ArkUI_PointerEvent_GetCurrentLocalXByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中根据实时位置获取特定接触点相对于当前组件左上角的X坐标。所有类型事件，若传入的索引值小于0时为非法值。对于鼠标和轴事件，当索引值非0时为非法值。对于触摸事件，根据给定的索引获取特定接触点相对于当前组件左上角的X坐标。
float OH_ArkUI_PointerEvent_GetCurrentLocalY(const ArkUI_UIInputEvent* event)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中根据实时位置获取相对于当前组件左上角的Y坐标。
float OH_ArkUI_PointerEvent_GetCurrentLocalYByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中根据实时位置获取特定接触点相对于当前组件左上角的Y坐标。所有类型事件，若传入的索引值小于0时为非法值。对于鼠标和轴事件，当索引值非0时为非法值。对于触摸事件。根据给定的索引获取特定接触点相对于当前组件左上角的Y坐标。
float OH_ArkUI_PointerEvent_GetX(const ArkUI_UIInputEvent* event)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于当前组件左上角的X坐标。
float OH_ArkUI_PointerEvent_GetXByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取特定接触点相对于当前组件左上角的X坐标。对于鼠标和轴事件，当给定的索引大于0时，返回默认值0.0f。
float OH_ArkUI_PointerEvent_GetY(const ArkUI_UIInputEvent* event)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于当前组件左上角的Y坐标。
float OH_ArkUI_PointerEvent_GetYByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取特定接触点相对于当前组件左上角的Y坐标。对于鼠标和轴事件，当给定的索引大于0时，返回默认值0.0f。
float OH_ArkUI_PointerEvent_GetWindowX(const ArkUI_UIInputEvent* event)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于当前应用窗口左上角的X坐标。
float OH_ArkUI_PointerEvent_GetWindowXByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取特定接触点相对于当前应用窗口左上角的X坐标。对于鼠标和轴事件，当给定的索引大于0时，总是返回默认值0.0f。
float OH_ArkUI_PointerEvent_GetWindowY(const ArkUI_UIInputEvent* event)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于当前应用窗口左上角的Y坐标。
float OH_ArkUI_PointerEvent_GetWindowYByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取特定接触点相对于当前应用窗口左上角的Y坐标。对于鼠标和轴事件，当给定的索引大于0时，总是返回默认值0.0f。
float OH_ArkUI_PointerEvent_GetDisplayX(const ArkUI_UIInputEvent* event)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于当前屏幕左上角的X坐标。
float OH_ArkUI_PointerEvent_GetDisplayXByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取特定接触点相对于当前屏幕左上角的X坐标。对于鼠标和轴事件，当给定的索引大于0时，总是返回默认值0.0f。
float OH_ArkUI_PointerEvent_GetDisplayY(const ArkUI_UIInputEvent* event)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于当前屏幕左上角的Y坐标。
float OH_ArkUI_PointerEvent_GetDisplayYByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取特定接触点相对于当前屏幕左上角的Y坐标。对于鼠标和轴事件，当给定的索引大于0时，总是返回默认值0.0f。
float OH_ArkUI_PointerEvent_GetGlobalDisplayX(const ArkUI_UIInputEvent* event)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于全局显示的X坐标。只能从ArkUI_UIInputEvent事件中获取位置信息。
float OH_ArkUI_PointerEvent_GetGlobalDisplayXByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于全局显示的X坐标。只能从指针事件中获取位置信息，对于鼠标和轴事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。
float OH_ArkUI_PointerEvent_GetGlobalDisplayY(const ArkUI_UIInputEvent* event)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于全局显示的Y坐标。只能从ArkUI_UIInputEvent事件中获取位置信息。
float OH_ArkUI_PointerEvent_GetGlobalDisplayYByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于全局显示的Y坐标。只能从指针事件中获取位置信息，对于鼠标和轴事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。
float OH_ArkUI_PointerEvent_GetPressure(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件）中获取触屏压力。
float OH_ArkUI_PointerEvent_GetTiltX(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件）中获取相对YZ平面的角度，取值的范围[-90, 90]，单位为deg，其中正值是向右倾斜。仅适用于支持倾角上报的触控笔操作产生的触控事件。
float OH_ArkUI_PointerEvent_GetTiltY(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件）中获取相对XZ平面的角度，取值的范围[-90, 90]，单位为deg，其中正值是向下倾斜。仅适用于支持倾角上报的触控笔操作产生的触控事件。
int32_t OH_ArkUI_PointerEvent_GetRollAngle(const ArkUI_UIInputEvent* event, double* rollAngle)	获取触控笔绕Z轴旋转的角度。
float OH_ArkUI_PointerEvent_GetTouchAreaWidth(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件）中获取触屏区域的宽度。仅适用于手指操作产生的触控事件，这通常是一个圆形区域的半径。
float OH_ArkUI_PointerEvent_GetTouchAreaHeight(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	从指向性输入事件（如触摸事件）中获取触屏区域的高度。仅适用于手指操作产生的触控事件，这通常是一个圆形区域的半径。
int32_t OH_ArkUI_PointerEvent_GetInteractionHand(const ArkUI_UIInputEvent event, ArkUI_InteractionHand hand)	获取当前触摸事件是左手点击触发还是右手点击触发。仅在部分触控产品上有效。
int32_t OH_ArkUI_PointerEvent_GetInteractionHandByIndex(const ArkUI_UIInputEvent event, int32_t pointerIndex, ArkUI_InteractionHand hand)	获取当前触摸事件是左手点击触发还是右手点击触发。仅在部分触控产品上有效。
uint32_t OH_ArkUI_PointerEvent_GetHistorySize(const ArkUI_UIInputEvent* event)	从指向性输入事件中获取历史事件数量。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。历史事件为此次事件与上一次事件之间发生的原始事件，仅在指向性输入事件的移动阶段（即触摸移动或鼠标移动）中适用，在其他状态中调用返回默认值0。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。
int64_t OH_ArkUI_PointerEvent_GetHistoryEventTime(const ArkUI_UIInputEvent* event, uint32_t historyIndex)	从指向性输入事件中获取历史事件发生的时间。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。
uint32_t OH_ArkUI_PointerEvent_GetHistoryPointerCount(const ArkUI_UIInputEvent* event, uint32_t historyIndex)	从指向性输入事件中获取特定历史事件中多点触控的接触点数量。本接口支持的指向性输入事件仅包含触摸事件。
int32_t OH_ArkUI_PointerEvent_GetHistoryPointerId(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)	从指向性输入事件的历史点中获取多点触控的接触点标识。本接口支持的指向性输入事件仅包含触摸事件。返回事件发生时，事件触点的唯一标识符，用于区分同类输入设备的多点触控信息。其数值没有除标识触点外的其他含义。
float OH_ArkUI_PointerEvent_GetHistoryX(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)	从指向性输入事件中获取特定历史事件中特定接触点相对于当前组件左上角的X坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。
float OH_ArkUI_PointerEvent_GetHistoryY(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)	从指向性输入事件中获取特定历史事件中特定接触点相对于当前组件左上角的Y坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。
float OH_ArkUI_PointerEvent_GetHistoryWindowX(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)	从指向性输入事件中获取特定历史事件中特定接触点相对于当前应用窗口左上角的X坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。
float OH_ArkUI_PointerEvent_GetHistoryWindowY(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)	从指向性输入事件中获取特定历史事件中特定接触点相对于当前应用窗口左上角的Y坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。
float OH_ArkUI_PointerEvent_GetHistoryDisplayX(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)	从指向性输入事件中获取特定历史事件中特定接触点相对于当前屏幕左上角的X坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。
float OH_ArkUI_PointerEvent_GetHistoryDisplayY(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)	从指向性输入事件中获取特定历史事件中特定接触点相对于当前屏幕左上角的Y坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。
float OH_ArkUI_PointerEvent_GetHistoryGlobalDisplayX(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)	从给定指针索引和历史记录索引的指向性输入事件中获取历史事件中相对于全局显示的特定触摸点的X坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。只能从指针事件中获取位置信息，对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 20开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。
float OH_ArkUI_PointerEvent_GetHistoryGlobalDisplayY(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)	从给定指针索引和历史记录索引的指向性输入事件中获取历史事件中相对于全局显示的特定触摸点的Y坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。只能从指针事件中获取位置信息，对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 20开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。
float OH_ArkUI_PointerEvent_GetHistoryPressure(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)	从指向性输入事件（如触摸事件）中获取特定历史事件中的触屏压力。
float OH_ArkUI_PointerEvent_GetHistoryTiltX(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)	从指向性输入事件（如触摸事件）中获取特定历史事件中的相对YZ平面的角度，取值的范围[-90, 90]，单位为deg，其中正值是向右倾斜。
float OH_ArkUI_PointerEvent_GetHistoryTiltY(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)	从指向性输入事件（如触摸事件）中获取特定历史事件中的相对XZ平面的角度，值的范围[-90, 90]，单位为deg，其中正值是向下倾斜。
float OH_ArkUI_PointerEvent_GetHistoryTouchAreaWidth(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)	从指向性输入事件（如触摸事件）中获取特定历史事件中的触屏区域的宽度。
float OH_ArkUI_PointerEvent_GetHistoryTouchAreaHeight(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)	从指向性输入事件（如触摸事件）中获取特定历史事件中的触屏区域的高度。
double OH_ArkUI_AxisEvent_GetVerticalAxisValue(const ArkUI_UIInputEvent* event)	获取当前轴事件的垂直滚动轴的值。通常由鼠标滚轮，或用户在触控板上双指竖向滑动产生。当通过鼠标滚动触发时：1.上报的数值单位为角度，为单次滚动角度增量，非滚动总量；2.上报的数值已与用户配置的放大系数OH_ArkUI_AxisEvent_GetScrollStep叠加运算；3.数值的正负代表方向，向前滚动鼠标滚轮时上报数值为正数，向后滚动鼠标滚轮时上报数值为负数；当通过触控板双指竖向滑动时：1.上报的数值单位为PX，为单次滚动增量，非滚动总量；2.上报的数值不受用户配置的放大系数OH_ArkUI_AxisEvent_GetScrollStep影响；3.数值的正负代表方向，双指从上往下滑动时上报数值为负数，双指从下往上滑动时上报数值为正数；4.方向会受系统设置中"自然滚动"配置的影响。通常情况下，垂直滚动轴事件只能驱动竖向的滑动手势响应，但当鼠标指针下命中的可滑动手势里，如果可响应的方向都是一致的，那么垂直滚动轴事件可以驱动这些滑动手势得到响应，即使这些手势所定义的方向是横向的。
double OH_ArkUI_AxisEvent_GetHorizontalAxisValue(const ArkUI_UIInputEvent* event)	获取当前轴事件的水平滚动轴的值，通过在触控板上双指横向滑动产生。
double OH_ArkUI_AxisEvent_GetPinchAxisScaleValue(const ArkUI_UIInputEvent* event)	获取当前轴事件的捏合轴缩放的值。通过触控板双指缩放/捏合操作产生。上报的scale数值，为相对于初始状态时的当前scale值。初始状态为系统识别到用户通过触控板发生了捏合操作时的两指位置状态，此时的scale数值为1.0。在手指抬起前的本次捏合操作过程中，所上报的scale数值均将初始状态作为参考系，从初始状态往中心捏合，则上报的scale会从1.0逐步往0.0缩小；当从初始化状态往外扩大双指距离时，会从1.0逐步变大。
int32_t OH_ArkUI_AxisEvent_GetAxisAction(const ArkUI_UIInputEvent* event)	获取当前轴事件的操作类型。
int32_t OH_ArkUI_AxisEvent_HasAxis(const ArkUI_UIInputEvent* event, int32_t axis)	检测此轴事件是否包含指定的轴类型。
int32_t OH_ArkUI_PointerEvent_SetInterceptHitTestMode(const ArkUI_UIInputEvent* event, HitTestMode mode)	配置触摸测试模式。仅适用于接收基础事件的场景，如使用NODE_ON_TOUCH接收触摸事件场景。对于通过OH_ArkUI_GestureEvent_GetRawInputEvent接口从一个手势事件中获取到的ArkUI_UIInputEvent对象，无法使用该接口。
int32_t OH_ArkUI_MouseEvent_GetMouseButton(const ArkUI_UIInputEvent* event)	获取鼠标事件的按键类型的值。
int32_t OH_ArkUI_MouseEvent_GetMouseAction(const ArkUI_UIInputEvent* event)	获取鼠标事件的鼠标动作类型的值。
int32_t OH_ArkUI_PointerEvent_SetStopPropagation(const ArkUI_UIInputEvent* event, bool stopPropagation)	设置是否阻止事件冒泡。仅适用于接收基础事件的场景，如使用NODE_ON_TOUCH接收触摸事件场景。对于通过 OH_ArkUI_GestureEvent_GetRawInputEvent接口从一个手势事件中获取到的ArkUI_UIInputEvent对象，无法使用该接口。
int32_t OH_ArkUI_UIInputEvent_GetDeviceId(const ArkUI_UIInputEvent* event)	获取当前按键的输入设备ID。
int32_t OH_ArkUI_UIInputEvent_GetPressedKeys(const ArkUI_UIInputEvent* event, int32_t* pressedKeyCodes, int32_t* length)	获取所有按下的按键，当前只支持按键事件。
double OH_ArkUI_FocusAxisEvent_GetAxisValue(const ArkUI_UIInputEvent* event, int32_t axis)	获取焦点轴事件的轴值。
int32_t OH_ArkUI_FocusAxisEvent_SetStopPropagation(const ArkUI_UIInputEvent* event, bool stopPropagation)	设置是否阻止焦点轴事件冒泡。
int32_t OH_ArkUI_UIInputEvent_GetModifierKeyStates(const ArkUI_UIInputEvent* event, uint64_t* keys)	获取UI输入事件的修饰键状态。该接口会通过keys传出当前事件发生时所有修饰键的状态，你可以通过与ArkUI_ModifierKeyName中定义的修饰键类型进行位计算操作获取哪些键处于按下状态。
int32_t OH_ArkUI_AxisEvent_SetPropagation(const ArkUI_UIInputEvent* event, bool propagation)	设置是否使能轴事件冒泡。默认不会进行冒泡传递，仅发送给第一个可响应轴事件的控件。可在接收到轴事件时，主动使能冒泡传递，以便当前事件可以继续传递给响应链上的下一个可响应轴事件的祖先组件处理。不支持对从手势事件中获取到的轴事件进行设置。
int32_t OH_ArkUI_AxisEvent_GetScrollStep(const ArkUI_UIInputEvent* event)	获取滚动轴事件的滚动步长系数，适用于鼠标滚轮产生的轴事件。这个值可以告诉你用户所配置的滚动放大系数。
float OH_ArkUI_UIInputEvent_GetEventTargetWidth(const ArkUI_UIInputEvent* event)	获取事件命中的组件的宽度。
float OH_ArkUI_UIInputEvent_GetEventTargetHeight(const ArkUI_UIInputEvent* event)	获取事件命中的组件的高度。
float OH_ArkUI_UIInputEvent_GetEventTargetPositionX(const ArkUI_UIInputEvent* event)	获取事件命中的组件的X坐标。
float OH_ArkUI_UIInputEvent_GetEventTargetPositionY(const ArkUI_UIInputEvent* event)	获取事件命中的组件的Y坐标。
float OH_ArkUI_UIInputEvent_GetEventTargetGlobalPositionX(const ArkUI_UIInputEvent* event)	获取事件命中的组件的全局X坐标。
float OH_ArkUI_UIInputEvent_GetEventTargetGlobalPositionY(const ArkUI_UIInputEvent* event)	获取事件命中的组件的全局Y坐标。
int64_t OH_ArkUI_PointerEvent_GetPressedTimeByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)	获取指定触点的按下时间。仅对触摸事件有效。
float OH_ArkUI_MouseEvent_GetRawDeltaX(const ArkUI_UIInputEvent* event)	获取鼠标设备在二维平面X轴的移动增量。其数值为鼠标硬件的原始移动数据，使用物理世界中鼠标移动的距离单位进行表示。上报数值由硬件本身决定，并非屏幕的物理/逻辑像素。
float OH_ArkUI_MouseEvent_GetRawDeltaY(const ArkUI_UIInputEvent* event)	获取鼠标设备在二维平面Y轴的移动增量。其数值为鼠标硬件的原始移动数据，使用物理世界中鼠标移动的距离单位进行表示。上报数值由硬件本身决定，并非屏幕的物理/逻辑像素。
int32_t OH_ArkUI_MouseEvent_GetPressedButtons(const ArkUI_UIInputEvent* event, int32_t* pressedButtons, int32_t* length)	从鼠标事件中获取按下的按键。
int32_t OH_ArkUI_UIInputEvent_GetTargetDisplayId(const ArkUI_UIInputEvent* event)	获取发生UI输入事件的屏幕ID。
bool OH_ArkUI_HoverEvent_IsHovered(const ArkUI_UIInputEvent* event)	获取鼠标是否悬浮在当前组件上
int32_t OH_ArkUI_PointerEvent_CreateClonedEvent(const ArkUI_UIInputEvent* event, ArkUI_UIInputEvent** clonedEvent)	基于原始事件指针创建克隆事件指针。仅对触摸事件有效。
int32_t OH_ArkUI_PointerEvent_DestroyClonedEvent(const ArkUI_UIInputEvent* event)	销毁克隆事件指针。
int32_t OH_ArkUI_PointerEvent_SetClonedEventLocalPosition(const ArkUI_UIInputEvent* event, float x, float y)	设置指向性事件相对于当前组件左上角的X坐标和Y坐标。
int32_t OH_ArkUI_PointerEvent_SetClonedEventLocalPositionByIndex(const ArkUI_UIInputEvent* event, float x, float y, int32_t pointerIndex)	设置指向性事件特有接触点相对于当前组件左上角的X坐标和Y坐标。
int32_t OH_ArkUI_PointerEvent_SetClonedEventActionType(const ArkUI_UIInputEvent* event, int32_t actionType)	设置当前带有指向性的克隆输入事件的事件类型。
int32_t OH_ArkUI_PointerEvent_SetClonedEventChangedFingerId(const ArkUI_UIInputEvent* event, int32_t fingerId)	设置当前带有指向性的克隆输入事件的触摸点ID。
int32_t OH_ArkUI_PointerEvent_SetClonedEventFingerIdByIndex(const ArkUI_UIInputEvent* event, int32_t fingerId, int32_t pointerIndex)	设置带有指向性的克隆输入事件特定接触点的触摸点ID。
int32_t OH_ArkUI_PointerEvent_PostClonedEvent(ArkUI_NodeHandle node, const ArkUI_UIInputEvent* event)	转发克隆事件到特定节点。
ArkUI_ErrorCode OH_ArkUI_PointerEvent_CreateClonedPointerEvent(const ArkUI_UIInputEvent* event, ArkUI_UIInputEvent** clonedEvent)	创建指定事件的克隆事件。该接口适用于触摸事件、鼠标事件和轴事件。
ArkUI_ErrorCode OH_ArkUI_PointerEvent_CreatePointerEvent(ArkUI_UIInputEvent** event, ArkUI_UIInputEvent_Type type)	创建新事件，不克隆现有事件。该接口适用于触摸事件、鼠标事件和轴事件。
ArkUI_ErrorCode OH_ArkUI_PointerEvent_DestroyClonedPointerEvent(const ArkUI_UIInputEvent* event)	销毁克隆事件指针。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetActionType(const ArkUI_UIInputEvent* event, int32_t type)	设置克隆事件的动作类型。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetSourceType(const ArkUI_UIInputEvent* event, int32_t sourceType)	设置克隆事件的源类型。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetToolType(const ArkUI_UIInputEvent* event, int32_t toolType)	设置克隆事件的工具类型。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetPressure(const ArkUI_UIInputEvent* event, float pressure)	设置克隆事件应用于触摸屏的压力。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetPressureByIndex(const ArkUI_UIInputEvent* event, float pressure, int32_t pointerIndex)	设置克隆事件指定触摸点应用于触摸屏的压力。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetEventTime(const ArkUI_UIInputEvent* event, int64_t timestamp)	设置克隆UI输入事件发生的时间。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetDeviceId(const ArkUI_UIInputEvent* event, int32_t deviceId)	设置触发克隆UI输入事件的设备ID。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetTargetDisplayId(const ArkUI_UIInputEvent* event, int32_t targetDisplayId)	设置克隆UI输入事件发生的屏幕ID。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetChangedFingerId(const ArkUI_UIInputEvent* event, int32_t fingerId)	设置克隆指针事件的触摸点ID。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetFingerIdByIndex(const ArkUI_UIInputEvent* event, int32_t fingerId, int32_t pointerIndex)	设置克隆事件特定接触点的触摸点ID。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetChangedWindowPosition(const ArkUI_UIInputEvent* event, float x, float y)	设置克隆事件相对于当前窗口左上角的X坐标和Y坐标。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetWindowPositionByIndex(const ArkUI_UIInputEvent* event, float x, float y, int32_t pointerIndex)	设置克隆事件特定接触点相对于当前窗口左上角的X坐标和Y坐标。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetChangedScreenPosition(const ArkUI_UIInputEvent* event, float x, float y)	设置克隆事件相对于当前屏幕左上角的X坐标和Y坐标。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetScreenPositionByIndex(const ArkUI_UIInputEvent* event, float x, float y, int32_t pointerIndex)	设置克隆事件特定接触点相对于当前屏幕左上角的X坐标和Y坐标。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetChangedGlobalDisplayPosition(const ArkUI_UIInputEvent* event, float x, float y)	设置克隆事件在全局坐标系的坐标。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetGlobalDisplayPositionByIndex(const ArkUI_UIInputEvent* event, float x, float y, int32_t pointerIndex)	设置克隆事件在全局坐标系的坐标。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetHandleId(const ArkUI_UIInputEvent* event, int32_t eventHandleId)	设置事件处理会话的唯一句柄。该句柄必须用于对该事件的任何进一步操作。对于给定的手指，同一时间只有一个具有此句柄的事件处于活动状态。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetTiltAngle(const ArkUI_UIInputEvent* event, float tiltX, float tiltY)	设置克隆事件相对于XZ平面和YZ平面的倾斜角度。取值范围为[-90, 90]，其中正值表示向右倾斜。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetRollAngle(const ArkUI_UIInputEvent* event, float rollAngle)	设置克隆事件触控笔绕Z轴的旋转角度。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetPressedKeys(const ArkUI_UIInputEvent* event, int32_t* pressedKeyCodes, int32_t length)	设置克隆事件中所有按下的按键。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetChangedTouchArea(const ArkUI_UIInputEvent* event, float width, float height)	设置克隆事件的手指接触区域的宽度和高度，该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetTouchAreaByIndex(const ArkUI_UIInputEvent* event, float width, float height, int32_t pointerIndex)	设置克隆事件特定接触点的手指接触区域的宽度和高度，该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetChangedInteractionHand(const ArkUI_UIInputEvent* event, int32_t hand)	设置克隆事件是左手或右手触发。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetInteractionHandByIndex(const ArkUI_UIInputEvent* event, int32_t hand, int32_t pointerIndex)	设置克隆事件特定接触点由左手或右手触发。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetPressedTimeByIndex(const ArkUI_UIInputEvent* event, int64_t pressedTime, int32_t pointerIndex)	设置克隆事件指定触摸点的按下时间。该接口仅适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetPinchAxisScaleValue(const ArkUI_UIInputEvent* event, double pinchAxisScaleValue)	设置克隆事件的捏合轴缩放值。该接口仅适用于轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetHorizontalAxisScaleValue(const ArkUI_UIInputEvent* event, double horizontalAxisScaleValue)	设置克隆事件水平滚动轴的值。该接口仅适用于轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetVerticalAxisScaleValue(const ArkUI_UIInputEvent* event, double verticalAxisScaleValue)	设置克隆事件垂直滚动轴的值。该接口仅适用于轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetScrollStep(const ArkUI_UIInputEvent* event, int32_t scrollStep)	设置克隆事件的滚动步长系数。该接口仅适用于轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetMouseButton(const ArkUI_UIInputEvent* event, int32_t button)	设置克隆事件的按钮类型值。该接口仅适用于鼠标事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetRawDeltaX(const ArkUI_UIInputEvent* event, float rawDeltaX)	设置鼠标设备在二维平面X轴的移动增量。其数值为鼠标硬件的原始移动数据，使用物理世界中鼠标移动的距离单位进行表示。该接口仅适用于鼠标事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetRawDeltaY(const ArkUI_UIInputEvent* event, float rawDeltaY)	设置鼠标设备在二维平面Y轴的移动增量。其数值为鼠标硬件的原始移动数据，使用物理世界中鼠标移动的距离单位进行表示。该接口仅适用于鼠标事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetPressedButtons(const ArkUI_UIInputEvent* event, const int32_t* pressedButtons, int32_t length)	设置克隆事件的按下的按键。该接口仅适用于鼠标事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_PointerEvent_PostClonedEventWithStrategy(ArkUI_NodeHandle node, const ArkUI_UIInputEvent* event, ArkUI_CompetitionStrategy strategy)	使用指定的竞争策略将克隆事件发送到特定节点。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。
ArkUI_ErrorCode OH_ArkUI_UIInputEvent_GetLatestStatus()	调用该方法获取最近一次UIInput相关方法的执行情况。通常情况下不需要使用该方法，仅在返回值结果不确定是否异常时使用。
ArkUI_CoastingAxisEvent OH_ArkUI_UIInputEvent_GetCoastingAxisEvent(ArkUI_UIInputEvent* event)	获取惯性滚动轴事件的指针。
int64_t OH_ArkUI_CoastingAxisEvent_GetEventTime(ArkUI_CoastingAxisEvent event)	获取惯性滚动轴事件发生的时间。
ArkUI_CoastingAxisEventPhase OH_ArkUI_CoastingAxisEvent_GetPhase(ArkUI_CoastingAxisEvent event)	获取惯性滚动轴事件发生时的滚动阶段。
float OH_ArkUI_CoastingAxisEvent_GetDeltaY(ArkUI_CoastingAxisEvent event)	获取惯性滚动轴事件垂直方向的增量值。单位为px，表示为单次滚动增量，非滚动总量。数值的正负代表方向，双指从上往下滑动时为负数，双指从下往上滑动时为正数。
float OH_ArkUI_CoastingAxisEvent_GetDeltaX(ArkUI_CoastingAxisEvent event)	获取惯性滚动轴事件水平方向的增量值。单位为px，表示为单次滚动增量，非滚动总量。数值的正负代表方向，双指从左往右滑动时为负数，双指从右往左滑动时为正数。
int32_t OH_ArkUI_CoastingAxisEvent_SetPropagation(ArkUI_CoastingAxisEvent event, bool propagation)	设置惯性滚动轴事件是否启用冒泡，默认禁止冒泡。
ArkUI_ErrorCode OH_ArkUI_TouchTestInfo_GetTouchTestInfoList(ArkUI_TouchTestInfo* info, ArkUI_TouchTestInfoItemArray* array, int32_t* size)	获取触摸测试信息中的触摸测试信息项数组。
float OH_ArkUI_TouchTestInfoItem_GetX(const ArkUI_TouchTestInfoItem* info)	从触摸测试信息项中获取相对于子组件左上角的X坐标，单位为px。
float OH_ArkUI_TouchTestInfoItem_GetY(const ArkUI_TouchTestInfoItem* info)	从触摸测试信息项中获取相对于子组件左上角的Y坐标，单位为px。
float OH_ArkUI_TouchTestInfoItem_GetWindowX(const ArkUI_TouchTestInfoItem* info)	从触摸测试信息项中获取相对于当前应用窗口左上角的X坐标，单位为px。
float OH_ArkUI_TouchTestInfoItem_GetWindowY(const ArkUI_TouchTestInfoItem* info)	从触摸测试信息项中获取相对于当前应用窗口左上角的Y坐标，单位为px。
float OH_ArkUI_TouchTestInfoItem_GetXRelativeToParent(const ArkUI_TouchTestInfoItem* info)	从触摸测试信息项中获取相对于父组件左上角的X坐标，单位为px。
float OH_ArkUI_TouchTestInfoItem_GetYRelativeToParent(const ArkUI_TouchTestInfoItem* info)	从触摸测试信息项中获取相对于父组件左上角的Y坐标，单位为px。
ArkUI_ErrorCode OH_ArkUI_TouchTestInfoItem_GetChildRect(const ArkUI_TouchTestInfoItem* info, ArkUI_Rect* childRect)	从触摸测试信息项中获取子组件的边界矩形信息。
ArkUI_ErrorCode OH_ArkUI_TouchTestInfoItem_GetChildId(const ArkUI_TouchTestInfoItem* info, char* buffer, int32_t bufferSize)	从触摸测试信息项中获取子组件的ID。
ArkUI_ErrorCode OH_ArkUI_TouchTestInfo_SetTouchResultStrategy(ArkUI_TouchTestInfo* info, ArkUI_TouchTestStrategy strategy)	设置触摸测试策略，即组件及其子组件在命中测试过程中的行为方式。
ArkUI_ErrorCode OH_ArkUI_TouchTestInfo_SetTouchResultId(ArkUI_TouchTestInfo* info, const char* id)	设置命中测试过程中需要作用的子组件ID。

枚举类型说明

ArkUI_UIInputEvent_Type

enum ArkUI_UIInputEvent_Type

描述：

UI输入事件类型定义。

起始版本： 12

枚举项	描述
ARKUI_UIINPUTEVENT_TYPE_UNKNOWN = 0	未知。
ARKUI_UIINPUTEVENT_TYPE_TOUCH = 1	触摸事件。
ARKUI_UIINPUTEVENT_TYPE_AXIS = 2	轴事件。
ARKUI_UIINPUTEVENT_TYPE_MOUSE = 3	鼠标事件。
ARKUI_UIINPUTEVENT_TYPE_KEY = 4	按键事件。起始版本： 20
ARKUI_UIINPUTEVENT_TYPE_DIGITAL_CROWN = 5	表冠事件。起始版本： 24

anonymous1

enum anonymous1

描述：

定义输入事件的行为类型。

起始版本： 12

枚举项	描述
UI_TOUCH_EVENT_ACTION_CANCEL = 0	触摸取消。
UI_TOUCH_EVENT_ACTION_DOWN = 1	触摸按下。
UI_TOUCH_EVENT_ACTION_MOVE = 2	触摸移动。
UI_TOUCH_EVENT_ACTION_UP = 3	触摸抬起。

anonymous2

enum anonymous2

描述：

产生输入事件的工具类型定义。

起始版本： 12

枚举项	描述
UI_INPUT_EVENT_TOOL_TYPE_UNKNOWN = 0	不支持的工具类型。
UI_INPUT_EVENT_TOOL_TYPE_FINGER = 1	手指。
UI_INPUT_EVENT_TOOL_TYPE_PEN = 2	笔。
UI_INPUT_EVENT_TOOL_TYPE_MOUSE = 3	鼠标。
UI_INPUT_EVENT_TOOL_TYPE_TOUCHPAD = 4	触控板。
UI_INPUT_EVENT_TOOL_TYPE_JOYSTICK = 5	操纵杆。

anonymous3

enum anonymous3

描述：

产生输入事件的来源类型定义。

起始版本： 12

枚举项	描述
UI_INPUT_EVENT_SOURCE_TYPE_UNKNOWN = 0	未知输入源。
UI_INPUT_EVENT_SOURCE_TYPE_MOUSE = 1	鼠标。
UI_INPUT_EVENT_SOURCE_TYPE_TOUCH_SCREEN = 2	触摸屏。
UI_INPUT_EVENT_SOURCE_TYPE_KEY = 4	按键。起始版本： 22
UI_INPUT_EVENT_SOURCE_TYPE_JOYSTICK = 5	手柄。起始版本： 22

HitTestMode

enum HitTestMode

描述：

定义触摸测试类型的枚举值。

起始版本： 12

枚举项	描述
HTM_DEFAULT = 0	默认触摸测试效果。自身及子节点响应触摸测试，但阻塞兄弟节点的触摸测试，不影响祖先节点的触摸测试。
HTM_BLOCK = 1	自身响应触摸测试，阻塞子节点、兄弟节点和祖先节点的触摸测试。
HTM_TRANSPARENT = 2	自身和子节点都响应触摸测试，不会阻塞兄弟节点和祖先节点的触摸测试。
HTM_NONE = 3	自身不响应触摸测试，不会阻塞子节点、兄弟节点和祖先节点的触摸测试。
HTM_BLOCK_HIERARCHY = 4	自身和子节点响应触摸测试，阻止所有优先级较低的兄弟节点和父节点参与触摸测试。起始版本： 20
HTM_BLOCK_DESCENDANTS = 5	自身不响应触摸测试，并且所有的后代（孩子，孙子等）也不响应触摸测试，不会影响祖先节点的触摸测试。起始版本： 20

anonymous4

enum anonymous4

描述：

定义鼠标事件的行为类型。

起始版本： 12

枚举项	描述
UI_MOUSE_EVENT_ACTION_UNKNOWN = 0	无效行为。
UI_MOUSE_EVENT_ACTION_PRESS = 1	鼠标按键按下。
UI_MOUSE_EVENT_ACTION_RELEASE = 2	鼠标按键松开。
UI_MOUSE_EVENT_ACTION_MOVE = 3	鼠标移动。
UI_MOUSE_EVENT_ACTION_CANCEL = 13	鼠标按键被取消。起始版本： 18

anonymous5

enum anonymous5

描述：

定义鼠标事件的按键类型。

起始版本： 12

枚举项	描述
UI_MOUSE_EVENT_BUTTON_NONE = 0	无按键。
UI_MOUSE_EVENT_BUTTON_LEFT = 1	鼠标左键。
UI_MOUSE_EVENT_BUTTON_RIGHT = 2	鼠标右键。
UI_MOUSE_EVENT_BUTTON_MIDDLE = 3	鼠标中键。
UI_MOUSE_EVENT_BUTTON_BACK = 4	鼠标左侧后退键。
UI_MOUSE_EVENT_BUTTON_FORWARD = 5	鼠标左侧前进键。

ArkUI_ModifierKeyName

enum ArkUI_ModifierKeyName

描述：

定义modifier按键。

起始版本： 12

枚举项	描述
ARKUI_MODIFIER_KEY_CTRL = 1 << 0	Ctrl.
ARKUI_MODIFIER_KEY_SHIFT = 1 << 1	Shift.
ARKUI_MODIFIER_KEY_ALT = 1 << 2	Alt.
ARKUI_MODIFIER_KEY_FN = 1 << 3	Fn（仅调试使用，通常不上报Fn状态）.

anonymous6

enum anonymous6

描述：

定义焦点轴事件的轴类型。

起始版本： 15

枚举项	描述
UI_FOCUS_AXIS_EVENT_ABS_X = 0	游戏手柄X轴。
UI_FOCUS_AXIS_EVENT_ABS_Y = 1	游戏手柄Y轴。
UI_FOCUS_AXIS_EVENT_ABS_Z = 2	游戏手柄Z轴。
UI_FOCUS_AXIS_EVENT_ABS_RZ = 3	游戏手柄RZ轴。
UI_FOCUS_AXIS_EVENT_ABS_GAS = 4	游戏手柄GAS轴。
UI_FOCUS_AXIS_EVENT_ABS_BRAKE = 5	游戏手柄BRAKE轴。
UI_FOCUS_AXIS_EVENT_ABS_HAT0X = 6	游戏手柄HAT0X轴。
UI_FOCUS_AXIS_EVENT_ABS_HAT0Y = 7	游戏手柄HAT0Y轴。
UI_FOCUS_AXIS_EVENT_ABS_RX = 8	游戏手柄RX轴。起始版本： 23
UI_FOCUS_AXIS_EVENT_ABS_RY = 9	游戏手柄RY轴。起始版本： 23
UI_FOCUS_AXIS_EVENT_ABS_THROTTLE = 10	游戏手柄THROTTLE轴。起始版本： 23
UI_FOCUS_AXIS_EVENT_ABS_RUDDER = 11	游戏手柄RUDDER轴。起始版本： 23
UI_FOCUS_AXIS_EVENT_ABS_WHEEL = 12	游戏手柄WHEEL轴。起始版本： 23
UI_FOCUS_AXIS_EVENT_ABS_HAT1X = 13	游戏手柄HAT1X轴。起始版本： 23
UI_FOCUS_AXIS_EVENT_ABS_HAT1Y = 14	游戏手柄HAT1Y轴。起始版本： 23
UI_FOCUS_AXIS_EVENT_ABS_HAT2X = 15	游戏手柄HAT2X轴。起始版本： 23
UI_FOCUS_AXIS_EVENT_ABS_HAT2Y = 16	游戏手柄HAT2Y轴。起始版本： 23
UI_FOCUS_AXIS_EVENT_ABS_HAT3X = 17	游戏手柄HAT3X轴。起始版本： 23
UI_FOCUS_AXIS_EVENT_ABS_HAT3Y = 18	游戏手柄HAT3Y轴。起始版本： 23

ArkUI_InteractionHand

enum ArkUI_InteractionHand

描述：

定义触摸事件是左手还是右手。

起始版本： 15

枚举项	描述
ARKUI_EVENT_HAND_NONE = 0	未知。
ARKUI_EVENT_HAND_LEFT = 1	左手。
ARKUI_EVENT_HAND_RIGHT = 2	右手。

anonymous7

enum anonymous7

描述：

定义轴事件的操作类型。

起始版本： 15

枚举项	描述
UI_AXIS_EVENT_ACTION_NONE = 0	轴事件异常。
UI_AXIS_EVENT_ACTION_BEGIN = 1	轴事件开始。
UI_AXIS_EVENT_ACTION_UPDATE = 2	轴事件更新。
UI_AXIS_EVENT_ACTION_END = 3	轴事件结束。
UI_AXIS_EVENT_ACTION_CANCEL = 4	轴事件取消。

anonymous8

enum anonymous8

描述：

定义轴事件的轴类型。

起始版本： 22

枚举项	描述
UI_AXIS_TYPE_VERTICAL_AXIS = 0	垂直滚动轴。
UI_AXIS_TYPE_HORIZONTAL_AXIS = 1	水平滚动轴。
UI_AXIS_TYPE_PINCH_AXIS = 2	捏合轴。

ArkUI_CoastingAxisEventPhase

enum ArkUI_CoastingAxisEventPhase

描述：

定义惯性滚动轴事件的阶段。

起始版本： 22

枚举项	描述
ARKUI_COASTING_AXIS_EVENT_PHASE_NONE = 0	非惯性轴事件阶段，异常默认值，可以通过检查惯性轴阶段值不为该值来判断当前惯性轴事件是有效的。
ARKUI_COASTING_AXIS_EVENT_PHASE_BEGIN = 1	惯性滚动轴事件开始，此为惯性阶段的第一个事件。
ARKUI_COASTING_AXIS_EVENT_PHASE_UPDATE = 2	惯性滚动轴事件更新，此阶段可以获取惯性轴值增量来处理滚动偏移。
ARKUI_COASTING_AXIS_EVENT_PHASE_END = 3	惯性滚动轴事件结束，此值在惯性被刹停（惯性滚动阶段用户重新触摸触控板或通过鼠标及触屏与组件产生交互等）或惯性衰减至自然停止时发送，到达此阶段时，应立即停止惯性滚动效果。

ArkUI_TouchTestStrategy

enum ArkUI_TouchTestStrategy

描述：

定义触摸测试策略。

起始版本： 22

枚举项	描述
ARKUI_TOUCH_TEST_STRATEGY_DEFAULT = 0	自定义分发不产生影响，系统按当前节点命中状态分发事件。
ARKUI_TOUCH_TEST_STRATEGY_FORWARD_COMPETITION = 1	应用指定分发事件到某个子节点，其他兄弟节点是否分发事件交由系统决定。
ARKUI_TOUCH_TEST_STRATEGY_FORWARD = 2	应用指定分发事件到某个子节点，系统不再分发事件到其他兄弟节点。

ArkUI_CompetitionStrategy

enum ArkUI_CompetitionStrategy

描述：

事件的注入方和被注入方间手势识别结果是否为竞争场景的策略。该策略决定了事件的注入方如何与被注入方的手势处理逻辑交互，非竞争场景会同时触发手势，竞争场景只触发其中一个。

起始版本： 24

枚举项	描述
ARKUI_COMPETITION_STRATEGY_DEFAULT = 0	无竞争策略。注入的事件不与任何现有手势竞争。注入的事件和现有手势可以独立并行处理。
ARKUI_COMPETITION_STRATEGY_COMPETITION = 1	竞争策略。事件注入方和被注入方间的手势为竞争关系，只能处理其中一方的手势。

ArkUI_CrownEvent_Action

enum ArkUI_CrownEvent_Action

描述：

定义表冠事件的阶段。

起始版本： 24

枚举项	描述
ARKUI_CROWNEVENT_ACTION_UNKNOWN = 0	未知的表冠事件阶段。
ARKUI_CROWNEVENT_ACTION_UPDATE = 1	表冠事件更新。
ARKUI_CROWNEVENT_ACTION_END = 2	表冠事件结束。

函数说明

OH_ArkUI_UIInputEvent_GetType()

int32_t OH_ArkUI_UIInputEvent_GetType(const ArkUI_UIInputEvent* event)

描述：

获取UI输入事件的类型。在访问一个ArkUI_UIInputEvent指针对象之前，推荐使用该方法判断该输入事件的类型，该接口会返回ArkUI_UIInputEvent_Type枚举中的一种。比如，当事件是一个触控类型时，由于触控类型是指向性事件，那么使用OH_ArkUI_UIInputEvent_GetXXX及OH_ArkUI_PointerEvent_GetXXX系列接口，均可以正常访问；而如果使用OH_ArkUI_KeyEvent_GetXXX相关接口去访问它，则会有无法预期的结果。对于还未支持的事件类型，接口返回默认值0。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
int32_t	返回当前UI输入事件的类型，如果参数异常则返回0。

OH_ArkUI_UIInputEvent_GetAction()

int32_t OH_ArkUI_UIInputEvent_GetAction(const ArkUI_UIInputEvent* event)

描述：

获取输入事件的action类型。action类型为基础事件在不同阶段的类型定义，通常代表了事件的特点，并表征事件的开始与结束，如touch down, touch up。触控事件的action类型为UI_TOUCH_EVENT_ACTION，鼠标事件的action类型为UI_MOUSE_EVENT_ACTION。轴事件的action类型获取请使用OH_ArkUI_AxisEvent_GetAxisAction接口，返回值类型为UI_AXIS_EVENT_ACTION，按键事件的action类型获取请使用OH_ArkUI_KeyEvent_GetType接口，返回值类型为ArkUI_KeyEventType。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
int32_t	返回当前UI输入事件的操作类型，如果参数异常则返回-1。

OH_ArkUI_UIInputEvent_GetSourceType()

int32_t OH_ArkUI_UIInputEvent_GetSourceType(const ArkUI_UIInputEvent* event)

描述：

获取UI输入事件的触发源类型。输入源为产生输入事件的真实物理设备，如触摸屏，鼠标等，由UI_INPUT_EVENT_SOURCE_TYPE定义，而输入工具为操作输入源设备来产生事件的工具，如手指、触控笔。在某些情况下两者可能容易发生混淆，比如当用户在操作鼠标时，鼠标既是输入源，也是输入工具。对于按键事件，并不支持获取输入源类型，返回unknown。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
int32_t	返回产生当前UI输入事件的来源类型。

OH_ArkUI_UIInputEvent_GetToolType()

int32_t OH_ArkUI_UIInputEvent_GetToolType(const ArkUI_UIInputEvent* event)

描述：

获取UI输入事件的工具类型。输入工具为操作输入源设备来产生事件的操作方，如手指、触控笔，他们自身不真实产生事件，但可以驱动输入源设备不断产生事件。返回的类型由UI_INPUT_EVENT_TOOL_TYPE枚举值定义。对于按键事件，并不支持获取输入工具类型，返回unknown。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
int32_t	返回产生当前UI输入事件的工具类型。

OH_ArkUI_UIInputEvent_GetEventTime()

int64_t OH_ArkUI_UIInputEvent_GetEventTime(const ArkUI_UIInputEvent* event)

描述：

获取UI输入事件发生的时间。单位为ns。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
int64_t	返回UI输入事件发生的时间，如果参数异常则返回0。

OH_ArkUI_PointerEvent_GetPointerCount()

uint32_t OH_ArkUI_PointerEvent_GetPointerCount(const ArkUI_UIInputEvent* event)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取多点触控的接触点数量。指向性事件一般是附带有事件发生位置信息的事件，如触摸事件，用户操作时，可以感知事件在什么位置发生。而非指向性事件，如按键事件，一般没有位置信息，没有触点的说法，该接口永远返回0。对于触摸事件，该接口多用于处理多指触控，判断用户有几根手指在操作当前控件。而对于鼠标和轴事件，可认为触点只有1个，该接口永远返回1。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
uint32_t	返回当前指向性输入事件的接触点数量。

OH_ArkUI_PointerEvent_GetPointerId()

int32_t OH_ArkUI_PointerEvent_GetPointerId(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取多点触控的接触点标识。返回事件发生时，事件触点的唯一标识符，用于区分同类输入设备的多点触控信息。其数值没有除标识触点外的其他含义。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。

返回：

类型	说明
int32_t	返回特定接触点标识。

OH_ArkUI_PointerEvent_GetChangedPointerId()

int32_t OH_ArkUI_PointerEvent_GetChangedPointerId(const ArkUI_UIInputEvent* event, uint32_t* pointerIndex)

描述：

获取触发当前事件的对应的手指id。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t* pointerIndex	表示多点触控数据列表中的序号。

返回：

类型	说明
int32_t	错误码。 ARKUI_ERROR_CODE_NO_ERROR 成功。 ARKUI_ERROR_CODE_PARAM_INVALID 函数参数异常。

OH_ArkUI_PointerEvent_GetX()

float OH_ArkUI_PointerEvent_GetX(const ArkUI_UIInputEvent* event)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于当前组件左上角的X坐标。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
float	返回当前指向性输入事件相对于当前组件左上角的X坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetXByIndex()

float OH_ArkUI_PointerEvent_GetXByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取特定接触点相对于当前组件左上角的X坐标。对于鼠标和轴事件，当给定的索引大于0时，返回默认值0.0f。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。

返回：

类型	说明
float	返回指向性输入事件中特定接触点相对于当前组件左上角的X坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetY()

float OH_ArkUI_PointerEvent_GetY(const ArkUI_UIInputEvent* event)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于当前组件左上角的Y坐标。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
float	返回当前指向性输入事件相对于当前组件左上角的Y坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetYByIndex()

float OH_ArkUI_PointerEvent_GetYByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取特定接触点相对于当前组件左上角的Y坐标。对于鼠标和轴事件，当给定的索引大于0时，返回默认值0.0f。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。

返回：

类型	说明
float	返回指向性输入事件事件中特定接触点相对于当前组件左上角的Y坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetCurrentLocalX()

float OH_ArkUI_PointerEvent_GetCurrentLocalX(const ArkUI_UIInputEvent* event)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中根据实时位置获取相对于当前组件左上角的X坐标。

起始版本： 26.0.0

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
float	返回当前指向性输入事件相对于当前组件左上角的X坐标；默认单位为px，单位可跟随setLengthMetricUnit的设置而变化；如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetCurrentLocalXByIndex()

float OH_ArkUI_PointerEvent_GetCurrentLocalXByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中根据实时位置获取特定接触点相对于当前组件左上角的X坐标。

所有类型事件，若传入的索引值小于0时为非法值。

对于鼠标和轴事件，当索引值非0时为非法值。

对于触摸事件，根据给定的索引获取特定接触点相对于当前组件左上角的X坐标。

起始版本： 26.0.0

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中目标触控点的索引。

返回：

类型	说明
float	返回特定接触点相对于当前组件左上角的X坐标；默认单位为px，单位可跟随setLengthMetricUnit的设置而变化；如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetCurrentLocalY()

float OH_ArkUI_PointerEvent_GetCurrentLocalY(const ArkUI_UIInputEvent* event)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中根据实时位置获取相对于当前组件左上角的Y坐标。

起始版本： 26.0.0

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
float	返回当前指向性输入事件相对于当前组件左上角的Y坐标；默认单位为px，单位可跟随setLengthMetricUnit的设置而变化；如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetCurrentLocalYByIndex()

float OH_ArkUI_PointerEvent_GetCurrentLocalYByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中根据实时位置获取特定接触点相对于当前组件左上角的Y坐标。

所有类型事件，若传入的索引值小于0时为非法值。

对于鼠标和轴事件，当索引值非0时为非法值。

对于触摸事件，根据给定的索引获取特定接触点相对于当前组件左上角的Y坐标。

起始版本： 26.0.0

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中目标触控点的索引。

返回：

类型	说明
float	返回特定接触点相对于当前组件左上角的Y坐标；默认单位为px，单位可跟随setLengthMetricUnit的设置而变化；如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetWindowX()

float OH_ArkUI_PointerEvent_GetWindowX(const ArkUI_UIInputEvent* event)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于当前应用窗口左上角的X坐标。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
float	返回当前指向性输入事件相对于当前应用窗口左上角的X坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetWindowXByIndex()

float OH_ArkUI_PointerEvent_GetWindowXByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取特定接触点相对于当前应用窗口左上角的X坐标。对于鼠标和轴事件，当给定的索引大于0时，总是返回默认值0.0f。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。

返回：

类型	说明
float	返回指向性输入事件中特定接触点相对于当前应用窗口左上角的X坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetWindowY()

float OH_ArkUI_PointerEvent_GetWindowY(const ArkUI_UIInputEvent* event)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于当前应用窗口左上角的Y坐标。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
float	返回当前指向性输入事件相对于当前应用窗口左上角的Y坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetWindowYByIndex()

float OH_ArkUI_PointerEvent_GetWindowYByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取特定接触点相对于当前应用窗口左上角的Y坐标。对于鼠标和轴事件，当给定的索引大于0时，总是返回默认值0.0f。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。

返回：

类型	说明
float	返回指向性输入事件中特定接触点相对于当前应用窗口左上角的Y坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetDisplayX()

float OH_ArkUI_PointerEvent_GetDisplayX(const ArkUI_UIInputEvent* event)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于当前屏幕左上角的X坐标。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
float	返回当前指向性输入事件相对于当前屏幕左上角的X坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetDisplayXByIndex()

float OH_ArkUI_PointerEvent_GetDisplayXByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取特定接触点相对于当前屏幕左上角的X坐标。对于鼠标和轴事件，当给定的索引大于0时，总是返回默认值0.0f。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。

返回：

类型	说明
float	返回指向性输入事件中特定接触点相对于当前屏幕左上角的X坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetDisplayY()

float OH_ArkUI_PointerEvent_GetDisplayY(const ArkUI_UIInputEvent* event)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于当前屏幕左上角的Y坐标。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
float	返回当前指向性输入事件相对于当前屏幕左上角的Y坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetDisplayYByIndex()

float OH_ArkUI_PointerEvent_GetDisplayYByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取特定接触点相对于当前屏幕左上角的Y坐标。对于鼠标和轴事件，当给定的索引大于0时，总是返回默认值0.0f。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。

返回：

类型	说明
float	返回指向性输入事件中特定接触点相对于当前屏幕左上角的Y坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetGlobalDisplayX()

float OH_ArkUI_PointerEvent_GetGlobalDisplayX(const ArkUI_UIInputEvent* event)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于全局显示的X坐标。只能从ArkUI_UIInputEvent事件中获取位置信息。

起始版本： 20

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
float	返回相对于全局显示的X坐标，单位为px。如果发生任何参数错误，例如传递的一个事件没有位置信息，则返回0.0f。

OH_ArkUI_PointerEvent_GetGlobalDisplayXByIndex()

float OH_ArkUI_PointerEvent_GetGlobalDisplayXByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于全局显示的X坐标。只能从指针事件中获取位置信息，对于鼠标和轴事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。

起始版本： 20

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中目标触控点的索引。有效值范围[0, OH_ArkUI_PointerEvent_GetPointerCount() - 1]

返回：

类型	说明
float	返回指向性输入事件中特定接触点相对于全局显示的X坐标，单位为px。如果发生任何参数错误，则返回0.0f。

OH_ArkUI_PointerEvent_GetGlobalDisplayY()

float OH_ArkUI_PointerEvent_GetGlobalDisplayY(const ArkUI_UIInputEvent* event)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于全局显示的Y坐标。只能从ArkUI_UIInputEvent事件中获取位置信息。

起始版本： 20

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
float	float 返回相对于全局显示的Y坐标，单位为px。如果发生任何参数错误，例如传递的一个事件没有位置信息，则返回0.0f。

OH_ArkUI_PointerEvent_GetGlobalDisplayYByIndex()

float OH_ArkUI_PointerEvent_GetGlobalDisplayYByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件、鼠标事件、轴事件）中获取相对于全局显示的Y坐标。只能从指针事件中获取位置信息，对于鼠标和轴事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。

起始版本： 20

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中目标触控点的索引。有效值范围[0, OH_ArkUI_PointerEvent_GetPointerCount() - 1]

返回：

类型	说明
float	float 返回相对于全局显示的Y坐标，单位为px。如果发生任何参数错误，则返回0.0f。

OH_ArkUI_PointerEvent_GetPressure()

float OH_ArkUI_PointerEvent_GetPressure(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件）中获取触屏压力。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。

返回：

类型	说明
float	返回当前指向性输入事件产生的触屏压力。取值范围为[0, 1]，压感大小与数值正相关。如果参数异常则返回默认值0.0f。在部分设备中，由于设备的硬件参数配置不同，可能会返回大于1的值。

OH_ArkUI_PointerEvent_GetTiltX()

float OH_ArkUI_PointerEvent_GetTiltX(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件）中获取相对YZ平面的角度，取值的范围[-90, 90]，单位为deg，其中正值是向右倾斜。仅适用于支持倾角上报的触控笔操作产生的触控事件。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。

返回：

类型	说明
float	返回当前指向性输入事件中相对YZ平面的角度。

OH_ArkUI_PointerEvent_GetTiltY()

float OH_ArkUI_PointerEvent_GetTiltY(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件）中获取相对XZ平面的角度，取值的范围[-90, 90]，单位为deg，其中正值是向下倾斜。仅适用于支持倾角上报的触控笔操作产生的触控事件。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。

返回：

类型	说明
float	返回当前指向性输入事件中相对XZ平面的角度。

OH_ArkUI_PointerEvent_GetRollAngle()

int32_t OH_ArkUI_PointerEvent_GetRollAngle(const ArkUI_UIInputEvent* event, double* rollAngle)

描述：

获取触控笔绕Z轴旋转的角度。

起始版本： 17

参数：

参数项	描述
const ArkUI_UIInputEvent* event	指向当前UI输入事件的指针。
double* rollAngle	触控笔绕Z轴旋转的角度，单位为deg。

返回：

类型	说明
int32_t	错误码。 Returns ARKUI_ERROR_CODE_NO_ERROR 成功。 Returns ARKUI_ERROR_CODE_PARAM_INVALID 函数参数异常。

OH_ArkUI_PointerEvent_GetTouchAreaWidth()

float OH_ArkUI_PointerEvent_GetTouchAreaWidth(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件）中获取触屏区域的宽度。仅适用于手指操作产生的触控事件，这通常是一个圆形区域的半径。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。

返回：

类型	说明
float	返回当前指向性输入事件中触屏区域的宽度，单位为px。

OH_ArkUI_PointerEvent_GetTouchAreaHeight()

float OH_ArkUI_PointerEvent_GetTouchAreaHeight(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

从指向性输入事件（如触摸事件）中获取触屏区域的高度。仅适用于手指操作产生的触控事件，这通常是一个圆形区域的半径。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。

返回：

类型	说明
float	返回当前指向性输入事件中触屏区域的高度，单位为px。

OH_ArkUI_PointerEvent_GetInteractionHand()

int32_t OH_ArkUI_PointerEvent_GetInteractionHand(const ArkUI_UIInputEvent *event, ArkUI_InteractionHand *hand)

描述：

获取当前触摸事件是左手点击触发还是右手点击触发。仅在部分触控产品上有效。该值并非在按下时就能实时获取，在系统完成结果推断之前，皆默认返回NONE，因此请不要过度依赖该接口返回的结果。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent *event	表示指向当前UI输入事件的指针。
ArkUI_InteractionHand *hand	表示触摸点是左手还是右手。

返回：

类型	说明
int32_t	返回结果。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果发生参数异常，则返回ARKUI_ERROR_CODE_PARAM_INVALID。

OH_ArkUI_PointerEvent_GetInteractionHandByIndex()

int32_t OH_ArkUI_PointerEvent_GetInteractionHandByIndex(const ArkUI_UIInputEvent *event, int32_t pointerIndex, ArkUI_InteractionHand *hand)

描述：

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent *event	表示指向当前UI输入事件的指针。
int32_t pointerIndex	表示多点触控数据列表中目标触控点的索引。
ArkUI_InteractionHand *hand	表示触摸点是左手还是右手。

返回：

类型	说明
int32_t	返回结果。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果发生参数异常，则返回ARKUI_ERROR_CODE_PARAM_INVALID。

OH_ArkUI_PointerEvent_GetHistorySize()

uint32_t OH_ArkUI_PointerEvent_GetHistorySize(const ArkUI_UIInputEvent* event)

描述：

从指向性输入事件中获取历史事件数量。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。历史事件为此次事件与上一次事件之间发生的原始事件，仅在指向性输入事件的移动阶段（即触摸移动或鼠标移动）中适用，在其他状态中调用返回默认值0。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
uint32_t	返回当前历史事件数量。

OH_ArkUI_PointerEvent_GetHistoryEventTime()

int64_t OH_ArkUI_PointerEvent_GetHistoryEventTime(const ArkUI_UIInputEvent* event, uint32_t historyIndex)

描述：

从指向性输入事件中获取历史事件发生的时间。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t historyIndex	表示历史事件数据列表的序号。

返回：

类型	说明
int64_t	返回UI输入事件发生的时间，单位为ns。如果参数异常则返回0。

OH_ArkUI_PointerEvent_GetHistoryPointerCount()

uint32_t OH_ArkUI_PointerEvent_GetHistoryPointerCount(const ArkUI_UIInputEvent* event, uint32_t historyIndex)

描述：

从指向性输入事件中获取特定历史事件中多点触控的接触点数量。本接口支持的指向性输入事件仅包含触摸事件。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t historyIndex	表示历史事件数据列表的序号。

返回：

类型	说明
uint32_t	特定历史事件中多点触控的接触点数量。

OH_ArkUI_PointerEvent_GetHistoryPointerId()

int32_t OH_ArkUI_PointerEvent_GetHistoryPointerId(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)

描述：

从指向性输入事件的历史点中获取多点触控的接触点标识。本接口支持的指向性输入事件仅包含触摸事件。返回事件发生时，事件触点的唯一标识符，用于区分同类输入设备的多点触控信息。其数值没有除标识触点外的其他含义。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表的序号。
uint32_t historyIndex	表示历史事件数据列表的序号。

返回：

类型	说明
int32_t	返回特定历史事件中的特定接触点标识。

OH_ArkUI_PointerEvent_GetHistoryX()

float OH_ArkUI_PointerEvent_GetHistoryX(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)

描述：

从指向性输入事件中获取特定历史事件中特定接触点相对于当前组件左上角的X坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表的序号。
uint32_t historyIndex	表示历史事件数据列表的序号。

返回：

类型	说明
float	返回在指向性输入事件中，特定历史事件内特定接触点相对于当前组件左上角的X坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetHistoryY()

float OH_ArkUI_PointerEvent_GetHistoryY(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)

描述：

从指向性输入事件中获取特定历史事件中特定接触点相对于当前组件左上角的Y坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表的序号。
uint32_t historyIndex	表示历史事件数据列表的序号。

返回：

类型	说明
float	返回在指向性输入事件中，特定历史事件内特定接触点相对于当前组件左上角的Y坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetHistoryWindowX()

float OH_ArkUI_PointerEvent_GetHistoryWindowX(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)

描述：

从指向性输入事件中获取特定历史事件中特定接触点相对于当前应用窗口左上角的X坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表的序号。
uint32_t historyIndex	表示历史事件数据列表的序号。

返回：

类型	说明
float	返回在指向性输入事件中，特定历史事件内特定接触点相对于当前应用窗口左上角的X坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetHistoryWindowY()

float OH_ArkUI_PointerEvent_GetHistoryWindowY(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)

描述：

从指向性输入事件中获取特定历史事件中特定接触点相对于当前应用窗口左上角的Y坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表的序号。
uint32_t historyIndex	表示历史事件数据列表的序号。

返回：

类型	说明
float	返回在指向性输入事件中，特定历史事件内特定接触点相对于当前应用窗口左上角的Y坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetHistoryDisplayX()

float OH_ArkUI_PointerEvent_GetHistoryDisplayX(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)

描述：

从指向性输入事件中获取特定历史事件中特定接触点相对于当前屏幕左上角的X坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表的序号。
uint32_t historyIndex	表示历史事件数据列表的序号。

返回：

类型	说明
float	返回在指向性输入事件中，特定历史事件内特定接触点相对于当前屏幕左上角的X坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetHistoryDisplayY()

float OH_ArkUI_PointerEvent_GetHistoryDisplayY(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)

描述：

从指向性输入事件中获取特定历史事件中特定接触点相对于当前屏幕左上角的Y坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 12开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表的序号。
uint32_t historyIndex	表示历史事件数据列表的序号。

返回：

类型	说明
float	返回在指向性输入事件中，特定历史事件内特定接触点相对于当前屏幕左上角的Y坐标，单位为px。如果参数异常则返回0.0f。

OH_ArkUI_PointerEvent_GetHistoryGlobalDisplayX()

float OH_ArkUI_PointerEvent_GetHistoryGlobalDisplayX(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)

描述：

从给定指针索引和历史记录索引的指向性输入事件中获取历史事件中相对于全局显示的特定触摸点的X坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。只能从指针事件中获取位置信息，对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 20开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。

起始版本： 20

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中目标触控点的索引。有效值范围[0, OH_ArkUI_PointerEvent_GetPointerCount() - 1]
uint32_t historyIndex	表示要返回的历史值，必须小于OH_ArkUI_PointerEvent_GetHistorySize。

返回：

类型	说明
float	返回在指向性输入事件中，特定历史事件内特定接触点相对于全局显示的X坐标，单位为px。如果发生任何参数错误，则返回0.0f。

OH_ArkUI_PointerEvent_GetHistoryGlobalDisplayY()

float OH_ArkUI_PointerEvent_GetHistoryGlobalDisplayY(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)

描述：

从给定指针索引和历史记录索引的指向性输入事件中获取历史事件中相对于全局显示的特定触摸点的Y坐标。本接口支持的指向性输入事件仅包含触摸事件、鼠标事件。只能从指针事件中获取位置信息，对于鼠标事件，当给定的pointerIndex大于0时，始终返回默认值0.0f。从API version 20开始支持触摸事件，从API version 26.0.0开始支持鼠标事件。

起始版本： 20

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中目标触控点的索引。有效值范围[0, OH_ArkUI_PointerEvent_GetPointerCount() - 1]
uint32_t historyIndex	表示要返回的历史值，必须小于OH_ArkUI_PointerEvent_GetHistorySize。

返回：

类型	说明
float	返回在指向性输入事件中，特定历史事件内特定接触点相对于全局显示的Y坐标，单位为px。如果发生任何参数错误，则返回0.0f。

OH_ArkUI_PointerEvent_GetHistoryPressure()

float OH_ArkUI_PointerEvent_GetHistoryPressure(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)

描述：

从指向性输入事件（如触摸事件）中获取特定历史事件中的触屏压力。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。
uint32_t historyIndex	表示历史事件数据列表的序号。

返回：

类型	说明
float	返回当前指向性输入事件产生的触屏压力。取值范围为[0, 1]，压感大小与数值正相关。如果参数异常则返回默认值0.0f。在部分设备中，由于设备的硬件参数配置不同，可能会返回大于1的值。

OH_ArkUI_PointerEvent_GetHistoryTiltX()

float OH_ArkUI_PointerEvent_GetHistoryTiltX(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)

描述：

从指向性输入事件（如触摸事件）中获取特定历史事件中的相对YZ平面的角度，取值的范围[-90, 90]，单位为deg，其中正值是向右倾斜。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。
uint32_t historyIndex	表示历史事件数据列表的序号。

返回：

类型	说明
float	返回当前指向性输入事件中相对YZ平面的角度。

OH_ArkUI_PointerEvent_GetHistoryTiltY()

float OH_ArkUI_PointerEvent_GetHistoryTiltY(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)

描述：

从指向性输入事件（如触摸事件）中获取特定历史事件中的相对XZ平面的角度，值的范围[-90, 90]，单位为deg，其中正值是向下倾斜。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。
uint32_t historyIndex	表示历史事件数据列表的序号。

返回：

类型	说明
float	返回当前指向性输入事件中相对XZ平面的角度。

OH_ArkUI_PointerEvent_GetHistoryTouchAreaWidth()

float OH_ArkUI_PointerEvent_GetHistoryTouchAreaWidth(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)

描述：

从指向性输入事件（如触摸事件）中获取特定历史事件中的触屏区域的宽度。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。
uint32_t historyIndex	表示历史事件数据列表的序号。

返回：

类型	说明
float	返回当前指向性输入事件中触屏区域的宽度，单位为px。

OH_ArkUI_PointerEvent_GetHistoryTouchAreaHeight()

float OH_ArkUI_PointerEvent_GetHistoryTouchAreaHeight(const ArkUI_UIInputEvent* event, uint32_t pointerIndex, uint32_t historyIndex)

描述：

从指向性输入事件（如触摸事件）中获取特定历史事件中的触屏区域的高度。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
uint32_t pointerIndex	表示多点触控数据列表中的序号。
uint32_t historyIndex	表示历史事件数据列表的序号。

返回：

类型	说明
float	返回当前指向性输入事件中触屏区域的高度，单位为px。

OH_ArkUI_AxisEvent_GetVerticalAxisValue()

double OH_ArkUI_AxisEvent_GetVerticalAxisValue(const ArkUI_UIInputEvent* event)

描述：

获取当前轴事件的垂直滚动轴的值。通常由鼠标滚轮，或用户在触控板上双指竖向滑动产生。当通过鼠标滚动触发时：1.上报的数值单位为角度，为单次滚动角度增量，非滚动总量；2.上报的数值已与用户配置的放大系数OH_ArkUI_AxisEvent_GetScrollStep叠加运算；3.数值的正负代表方向，向前滚动鼠标滚轮时上报数值为负数，向后滚动鼠标滚轮时上报数值为正数；当通过触控板双指竖向滑动时：1.上报的数值单位为PX，为单次滚动增量，非滚动总量；2.上报的数值不受用户配置的放大系数OH_ArkUI_AxisEvent_GetScrollStep影响；3.数值的正负代表方向，双指从上往下滑动时上报数值为负数，双指从下往上滑动时上报数值为正数；4.方向会受系统设置中"自然滚动"配置的影响。通常情况下，垂直滚动轴事件只能驱动竖向的滑动手势响应，但当鼠标指针下命中的可滑动手势里，如果可响应的方向都是一致的，那么垂直滚动轴事件可以驱动这些滑动手势得到响应，即使这些手势所定义的方向是横向的。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
double	返回当前轴事件的垂直滚动轴的值，如果参数异常则返回0.0。

OH_ArkUI_AxisEvent_GetHorizontalAxisValue()

double OH_ArkUI_AxisEvent_GetHorizontalAxisValue(const ArkUI_UIInputEvent* event)

描述：

获取当前轴事件的水平滚动轴的值，通过在触控板上双指横向滑动产生。1.上报的数值单位为PX，为单次滚动增量，非滚动总量；2.上报的数值不受用户配置的放大系数OH_ArkUI_AxisEvent_GetScrollStep影响；3.数值的正负代表方向，双指从左往右滑动时上报数值为负数，双指从右往左滑动时上报数值为正数；4.方向会受系统设置中"自然滚动"配置的影响。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
double	返回当前轴事件的水平滚动轴的值，如果参数异常则返回0.0。

OH_ArkUI_AxisEvent_GetPinchAxisScaleValue()

double OH_ArkUI_AxisEvent_GetPinchAxisScaleValue(const ArkUI_UIInputEvent* event)

描述：

获取当前轴事件的捏合轴缩放的值。通过触控板双指缩放/捏合操作产生。上报的scale数值，为相对于初始状态时的当前scale值。初始状态为系统识别到用户通过触控板发生了捏合操作时的两指位置状态，此时的scale数值为1.0。在手指抬起前的本次捏合操作过程中，所上报的scale数值均将初始状态作为参考系，从初始状态往中心捏合，则上报的scale会从1.0逐步往0.0缩小；当从初始化状态往外扩大双指距离时，会从1.0逐步变大。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
double	返回当前轴事件的捏合轴缩放的值，如果参数异常则返回0.0。

OH_ArkUI_AxisEvent_GetAxisAction()

int32_t OH_ArkUI_AxisEvent_GetAxisAction(const ArkUI_UIInputEvent* event)

描述：

获取当前轴事件的操作类型。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
int32_t	返回当前轴事件的操作类型，取值可参考anonymous7。当输入非轴事件时，默认返回0。

OH_ArkUI_AxisEvent_HasAxis()

int32_t OH_ArkUI_AxisEvent_HasAxis(const ArkUI_UIInputEvent* event, int32_t axis)

描述：

检测此轴事件是否包含指定的轴类型。

起始版本： 22

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
int32_t axis	表示轴事件的轴类型UI_AXIS_TYPE。

返回值：

类型	说明
int32_t	返回此轴事件是否包含指定的轴类型。返回true表示包含指定的轴类型，返回false表示不包含指定的轴类型。

OH_ArkUI_PointerEvent_SetInterceptHitTestMode()

int32_t OH_ArkUI_PointerEvent_SetInterceptHitTestMode(const ArkUI_UIInputEvent* event, HitTestMode mode)

描述：

配置触摸测试模式。仅适用于接收基础事件的场景，如使用NODE_ON_TOUCH接收触摸事件场景。对于通过OH_ArkUI_GestureEvent_GetRawInputEvent接口从一个手势事件中获取到的ArkUI_UIInputEvent对象，无法使用该接口。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
HitTestMode mode	指定触摸测试模式，参数类型HitTestMode。

返回：

类型	说明
int32_t	返回执行的状态代码。

OH_ArkUI_MouseEvent_GetMouseButton()

int32_t OH_ArkUI_MouseEvent_GetMouseButton(const ArkUI_UIInputEvent* event)

描述：

获取鼠标事件的按键类型的值。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
int32_t	返回鼠标按键类型，取值由anonymous5枚举定义，但在非鼠标事件中调用时返回值为-1。

OH_ArkUI_MouseEvent_GetMouseAction()

int32_t OH_ArkUI_MouseEvent_GetMouseAction(const ArkUI_UIInputEvent* event)

描述：

获取鼠标事件的鼠标动作类型的值。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
int32_t	返回鼠标动作类型，取值由anonymous4枚举定义，但在非鼠标事件中调用时返回值为-1。

OH_ArkUI_PointerEvent_SetStopPropagation()

int32_t OH_ArkUI_PointerEvent_SetStopPropagation(const ArkUI_UIInputEvent* event, bool stopPropagation)

描述：

设置是否阻止事件冒泡。仅适用于接收基础事件的场景，如使用NODE_ON_TOUCH接收触摸事件场景，不适用于轴事件。对于通过OH_ArkUI_GestureEvent_GetRawInputEvent接口从一个手势事件中获取到的ArkUI_UIInputEvent对象，无法使用该接口。

起始版本： 12

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
bool stopPropagation	表示是否阻止事件冒泡。true表示阻止事件冒泡，false表示不阻止事件冒泡。

返回：

类型	说明
int32_t	返回执行的状态代码。返回0表示设置成功，如果返回401，表示返回失败，可能的原因是参数异常，例如event是一个空指针。

OH_ArkUI_UIInputEvent_GetDeviceId()

int32_t OH_ArkUI_UIInputEvent_GetDeviceId(const ArkUI_UIInputEvent* event)

描述：

获取当前UI输入事件的设备ID。

起始版本： 14

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。

返回：

类型	说明
int32_t	当前UI输入事件的设备ID。

OH_ArkUI_UIInputEvent_GetPressedKeys()

int32_t OH_ArkUI_UIInputEvent_GetPressedKeys(const ArkUI_UIInputEvent* event, int32_t* pressedKeyCodes, int32_t* length)

描述：

获取所有按下的按键，当前只支持按键事件。

起始版本： 14

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t* pressedKeyCodes	输出参数，表示所有按下键的数组，指向的内存空间需要调用者申请。
int32_t* length	作为输入参数表示传入的pressedKeyCodes数组长度，作为输出参数表示实际按下按键的个数。

返回：

类型	说明
int32_t	错误码。 ARKUI_ERROR_CODE_NO_ERROR 成功。 ARKUI_ERROR_CODE_BUFFER_SIZE_NOT_ENOUGH 内存分配不足。 ARKUI_ERROR_CODE_PARAM_INVALID 函数参数异常。

OH_ArkUI_FocusAxisEvent_GetAxisValue()

double OH_ArkUI_FocusAxisEvent_GetAxisValue(const ArkUI_UIInputEvent* event, int32_t axis)

描述：

获取焦点轴事件的轴值。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t axis	焦点轴事件的轴类型，取值可参考anonymous6。

返回：

类型	说明
double	焦点轴事件的轴值，如果参数异常则返回0.0。

OH_ArkUI_FocusAxisEvent_SetStopPropagation()

int32_t OH_ArkUI_FocusAxisEvent_SetStopPropagation(const ArkUI_UIInputEvent* event, bool stopPropagation)

描述：

设置是否阻止焦点轴事件冒泡。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
bool stopPropagation	表示是否阻止事件冒泡。true表示阻止事件冒泡，false表示不阻止事件冒泡。

返回：

类型	说明
int32_t	错误码。 ARKUI_ERROR_CODE_NO_ERROR 成功。 ARKUI_ERROR_CODE_PARAM_INVALID 参数异常。

OH_ArkUI_UIInputEvent_GetModifierKeyStates()

int32_t OH_ArkUI_UIInputEvent_GetModifierKeyStates(const ArkUI_UIInputEvent* event, uint64_t* keys)

描述：

获取UI输入事件的修饰键状态。该接口会通过keys传出当前事件发生时所有修饰键的状态，你可以通过与ArkUI_ModifierKeyName中定义的修饰键类型进行位计算操作获取哪些键处于按下状态。

起始版本： 17

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
uint64_t* keys	返回当前处于按下状态的修饰键组合，应用可通过位运算进行判断。

返回：

类型	说明
int32_t	错误码。 ARKUI_ERROR_CODE_NO_ERROR 成功。 ARKUI_ERROR_CODE_PARAM_INVALID 函数参数异常。

OH_ArkUI_AxisEvent_SetPropagation()

int32_t OH_ArkUI_AxisEvent_SetPropagation(const ArkUI_UIInputEvent* event, bool propagation)

描述：

设置是否使能轴事件冒泡。默认不会进行冒泡传递，仅发送给第一个可响应轴事件的控件。可在接收到轴事件时，主动使能冒泡传递，以便当前事件可以继续传递给响应链上的下一个可响应轴事件的祖先组件处理。不支持对从手势事件中获取到的轴事件进行设置。

起始版本： 17

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前 UI 输入事件的指针。
bool propagation	表示是否激活事件冒泡。true表示激活事件冒泡，false表示不激活事件冒泡。

返回：

类型	说明
int32_t	错误码。 ARKUI_ERROR_CODE_NO_ERROR 成功。 ARKUI_ERROR_CODE_PARAM_INVALID 参数异常。

OH_ArkUI_AxisEvent_GetScrollStep()

int32_t OH_ArkUI_AxisEvent_GetScrollStep(const ArkUI_UIInputEvent* event)

描述：

获取滚动轴事件的滚动步长系数，适用于鼠标滚轮产生的轴事件。这个值可以告诉你用户所配置的滚动放大系数。

起始版本： 17

参数：

参数项	描述
const ArkUI_UIInputEvent* event	指向 ArkUI_UIInputEvent事件指针。

返回：

类型	说明
int32_t	返回鼠标滚轮轴滚动步长配置。在非鼠标事件返回默认值0。

OH_ArkUI_UIInputEvent_GetEventTargetWidth()

float OH_ArkUI_UIInputEvent_GetEventTargetWidth(const ArkUI_UIInputEvent* event)

描述：

获取事件命中的组件的宽度。

起始版本： 17

参数：

参数项	描述
const ArkUI_UIInputEvent* event	指向ArkUI_UIInputEvent对象的指针。

返回：

类型	说明
float	返回事件命中的组件的宽度，单位为px；如果发生任何参数错误，则返回 0.0f。

OH_ArkUI_UIInputEvent_GetEventTargetHeight()

float OH_ArkUI_UIInputEvent_GetEventTargetHeight(const ArkUI_UIInputEvent* event)

描述：

获取事件命中的组件的高度。

起始版本： 17

参数：

参数项	描述
const ArkUI_UIInputEvent* event	指向ArkUI_UIInputEvent对象的指针。

返回：

类型	说明
float	返回事件命中的组件的高度，单位为px；如果发生任何参数错误，则返回 0.0f。

OH_ArkUI_UIInputEvent_GetEventTargetPositionX()

float OH_ArkUI_UIInputEvent_GetEventTargetPositionX(const ArkUI_UIInputEvent* event)

描述：

获取事件命中的组件的X坐标。

起始版本： 17

参数：

参数项	描述
const ArkUI_UIInputEvent* event	指向ArkUI_UIInputEvent对象的指针。

返回：

类型	说明
float	返回事件命中的组件的X坐标，单位为px；如果发生任何参数错误，则返回 0.0f。

OH_ArkUI_UIInputEvent_GetEventTargetPositionY()

float OH_ArkUI_UIInputEvent_GetEventTargetPositionY(const ArkUI_UIInputEvent* event)

描述：

获取事件命中的组件的Y坐标。

起始版本： 17

参数：

参数项	描述
const ArkUI_UIInputEvent* event	指向ArkUI_UIInputEvent对象的指针。

返回：

类型	说明
float	返回事件命中的组件的Y坐标，单位为px；如果发生任何参数错误，则返回 0.0f。

OH_ArkUI_UIInputEvent_GetEventTargetGlobalPositionX()

float OH_ArkUI_UIInputEvent_GetEventTargetGlobalPositionX(const ArkUI_UIInputEvent* event)

描述：

获取事件命中的组件的全局X坐标。

起始版本： 17

参数：

参数项	描述
const ArkUI_UIInputEvent* event	指向ArkUI_UIInputEvent对象的指针。

返回：

类型	说明
float	返回事件命中的组件的全局X坐标，单位为px；如果发生任何参数错误，则返回 0.0f。

OH_ArkUI_UIInputEvent_GetEventTargetGlobalPositionY()

float OH_ArkUI_UIInputEvent_GetEventTargetGlobalPositionY(const ArkUI_UIInputEvent* event)

描述：

获取事件命中的组件的全局Y坐标。

起始版本： 17

参数：

参数项	描述
const ArkUI_UIInputEvent* event	指向ArkUI_UIInputEvent对象的指针。

返回：

类型	说明
float	返回事件命中的组件的全局Y坐标，单位为px；如果发生任何参数错误，则返回 0.0f。

OH_ArkUI_PointerEvent_GetPressedTimeByIndex()

int64_t OH_ArkUI_PointerEvent_GetPressedTimeByIndex(const ArkUI_UIInputEvent* event, uint32_t pointerIndex)

描述：

获取指定触点的按下时间。仅对触摸事件有效。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
uint32_t pointerIndex	指示多点触控数据列表中目标触控点的索引。

返回：

类型	说明
int64_t	返回特定触摸点的按下时间，单位为ns；如果发生任何参数错误，则返回0。

OH_ArkUI_MouseEvent_GetRawDeltaX()

float OH_ArkUI_MouseEvent_GetRawDeltaX(const ArkUI_UIInputEvent* event)

描述：

获取鼠标设备在二维平面X轴的移动增量。其数值为鼠标硬件的原始移动数据，使用物理世界中鼠标移动的距离单位进行表示。上报数值由硬件本身决定，并非屏幕的物理/逻辑像素。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。

返回：

类型	说明
float	返回鼠标设备在二维平面X轴的移动增量，使用物理世界中鼠标移动的距离单位进行表示；如果发生任何参数错误，则返回0.0f。说明： API版本26.0.0之前，返回值并非鼠标硬件的原始移动数据，而是原始数据缩小了X倍，X为系统的显示大小比例。API版本26.0.0开始，返回值为鼠标硬件的原始移动数据。

OH_ArkUI_MouseEvent_GetRawDeltaY()

float OH_ArkUI_MouseEvent_GetRawDeltaY(const ArkUI_UIInputEvent* event)

描述：

获取鼠标设备在二维平面Y轴的移动增量。其数值为鼠标硬件的原始移动数据，使用物理世界中鼠标移动的距离单位进行表示。上报数值由硬件本身决定，并非屏幕的物理/逻辑像素。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。

返回：

类型	说明
float	返回鼠标设备在二维平面Y轴的移动增量，使用物理世界中鼠标移动的距离单位进行表示；如果发生任何参数错误，则返回0.0f。说明： API版本26.0.0之前，返回值并非鼠标硬件的原始移动数据，而是原始数据缩小了X倍，X为系统的显示大小比例。API版本26.0.0开始，返回值为鼠标硬件的原始移动数据。

OH_ArkUI_MouseEvent_GetPressedButtons()

int32_t OH_ArkUI_MouseEvent_GetPressedButtons(const ArkUI_UIInputEvent* event, int32_t* pressedButtons, int32_t* length)

描述：

从鼠标事件中获取按下的按键。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t* pressedButtons	指示按下按键的列表。需要先创建一个int数组，用来储存按下的按键，按键的值请参考anonymous5。
int32_t* length	指示列表数组的总长度。

返回：

类型	说明
int32_t	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果传入的缓冲区大小异常，则返回ARKUI_ERROR_CODE_BUFFER_SIZE_ERROR。

OH_ArkUI_UIInputEvent_GetTargetDisplayId()

int32_t OH_ArkUI_UIInputEvent_GetTargetDisplayId(const ArkUI_UIInputEvent* event)

描述：

获取发生UI输入事件的屏幕ID。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。

返回：

类型	说明
int32_t	返回屏幕ID；如果发生任何参数错误，则返回0。

OH_ArkUI_HoverEvent_IsHovered()

bool OH_ArkUI_HoverEvent_IsHovered(const ArkUI_UIInputEvent* event)

描述：

获取鼠标是否悬浮在当前组件上

起始版本： 17

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。

返回：

类型	说明
bool	如果鼠标悬浮在当前组件上则返回true。如果鼠标没有悬浮在当前组件上，返回false

OH_ArkUI_PointerEvent_CreateClonedEvent()

int32_t OH_ArkUI_PointerEvent_CreateClonedEvent(const ArkUI_UIInputEvent* event, ArkUI_UIInputEvent** clonedEvent)

描述：

基于原始事件指针创建克隆事件指针。仅对触摸事件有效。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
ArkUI_UIInputEvent** clonedEvent	ArkUI_UIInputEvent克隆事件指针。

返回：

类型	说明
int32_t	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。

OH_ArkUI_PointerEvent_DestroyClonedEvent()

int32_t OH_ArkUI_PointerEvent_DestroyClonedEvent(const ArkUI_UIInputEvent* event)

描述：

销毁克隆事件指针。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。

返回：

类型	说明
int32_t	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_PointerEvent_SetClonedEventLocalPosition()

int32_t OH_ArkUI_PointerEvent_SetClonedEventLocalPosition(const ArkUI_UIInputEvent* event, float x, float y)

描述：

设置指向性事件相对于当前组件左上角的X坐标和Y坐标。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float x	当前指向性输入事件相对于当前组件左上角的X坐标，单位为px。
float y	当前指向性输入事件相对于当前组件左上角的Y坐标，单位为px。

返回：

类型	说明
int32_t	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_PointerEvent_SetClonedEventLocalPositionByIndex()

int32_t OH_ArkUI_PointerEvent_SetClonedEventLocalPositionByIndex(const ArkUI_UIInputEvent* event, float x, float y, int32_t pointerIndex)

描述：

设置指向性事件特有接触点相对于当前组件左上角的X坐标和Y坐标。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float x	当前指向性输入事件相对于当前组件左上角的X坐标，单位为px。
float y	当前指向性输入事件相对于当前组件左上角的Y坐标，单位为px。
int32_t pointerIndex	表示多点触控数据列表中的序号。

返回：

类型	说明
int32_t	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_PointerEvent_SetClonedEventActionType()

int32_t OH_ArkUI_PointerEvent_SetClonedEventActionType(const ArkUI_UIInputEvent* event, int32_t actionType)

描述：

设置当前带有指向性的克隆输入事件的事件类型。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t actionType	ArkUI_UIInputEvent克隆事件类型。

返回：

类型	说明
int32_t	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_PointerEvent_SetClonedEventChangedFingerId()

int32_t OH_ArkUI_PointerEvent_SetClonedEventChangedFingerId(const ArkUI_UIInputEvent* event, int32_t fingerId)

描述：

设置当前带有指向性的克隆输入事件的触摸点ID。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t fingerId	触发当前事件指针的触摸点ID。

返回：

类型	说明
int32_t	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_PointerEvent_SetClonedEventFingerIdByIndex()

int32_t OH_ArkUI_PointerEvent_SetClonedEventFingerIdByIndex(const ArkUI_UIInputEvent* event, int32_t fingerId, int32_t pointerIndex)

描述：

设置带有指向性的克隆输入事件特定接触点的触摸点ID。

起始版本： 15

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t fingerId	指向性的输入事件特定接触点的触摸点ID。
int32_t pointerIndex	表示多点触控数据列表中的序号。

返回：

类型	说明
int32_t	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_PointerEvent_PostClonedEvent()

int32_t OH_ArkUI_PointerEvent_PostClonedEvent(ArkUI_NodeHandle node, const ArkUI_UIInputEvent* event)

描述：

转发克隆事件到特定节点。

起始版本： 15

参数：

参数项	描述
ArkUI_NodeHandle node	目标节点。
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。

返回：

类型

说明

int32_t

返回结果代码。
如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。
如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。
如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。
如果组件状态异常，则返回ARKUI_ERROR_CODE_POST_CLONED_COMPONENT_STATUS_ABNORMAL。
如果未命中可响应事件的组件，则返回ARKUI_ERROR_CODE_POST_CLONED_NO_COMPONENT_HIT_TO_RESPOND_TO_THE_EVENT。

OH_ArkUI_PointerEvent_CreateClonedPointerEvent()

ArkUI_ErrorCode OH_ArkUI_PointerEvent_CreateClonedPointerEvent(const ArkUI_UIInputEvent* event, ArkUI_UIInputEvent** clonedEvent)

描述：

创建指定事件的克隆事件。该接口适用于触摸事件、鼠标事件和轴事件。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
ArkUI_UIInputEvent** clonedEvent	ArkUI_UIInputEvent克隆事件指针。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。

OH_ArkUI_PointerEvent_CreatePointerEvent()

ArkUI_ErrorCode OH_ArkUI_PointerEvent_CreatePointerEvent(ArkUI_UIInputEvent** event, ArkUI_UIInputEvent_Type type)

描述：

创建新事件，不克隆现有事件。该接口适用于触摸事件、鼠标事件和轴事件。

起始版本： 24

参数：

参数项	描述
ArkUI_UIInputEvent** event	指向新的ArkUI_UIInputEvent对象的指针。
ArkUI_UIInputEvent_Type type	ArkUI_UIInputEvent的事件类型。支持取值ARKUI_UIINPUTEVENT_TYPE_TOUCH、ARKUI_UIINPUTEVENT_TYPE_AXIS和ARKUI_UIINPUTEVENT_TYPE_MOUSE。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。

OH_ArkUI_PointerEvent_DestroyClonedPointerEvent()

ArkUI_ErrorCode OH_ArkUI_PointerEvent_DestroyClonedPointerEvent(const ArkUI_UIInputEvent* event)

描述：

销毁克隆事件指针。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_ClonedEvent_SetActionType()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetActionType(const ArkUI_UIInputEvent* event, int32_t type)

描述：

设置克隆事件的动作类型。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t type	克隆事件的类型，包括触摸事件的UI_TOUCH_EVENT_ACTION，鼠标事件的UI_MOUSE_EVENT_ACTION，轴事件的UI_AXIS_EVENT_ACTION。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_ClonedEvent_SetSourceType()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetSourceType(const ArkUI_UIInputEvent* event, int32_t sourceType)

描述：

设置克隆事件的源类型。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t sourceType	克隆事件的源类型。取值范围为[0,5]的整数，其中0表示未知，1表示鼠标，2表示触屏，4表示键盘，5表示手柄。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_ClonedEvent_SetToolType()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetToolType(const ArkUI_UIInputEvent* event, int32_t toolType)

描述：

设置克隆事件的工具类型。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t toolType	克隆事件的工具类型。由UI_INPUT_EVENT_TOOL_TYPE枚举定义。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_ClonedEvent_SetPressure()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetPressure(const ArkUI_UIInputEvent* event, float pressure)

描述：

设置克隆事件应用于触摸屏的压力。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float pressure	应用于触摸屏的压力，取值范围为[0,1]中的任意数值，部分设备中可能大于1。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetPressureByIndex()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetPressureByIndex(const ArkUI_UIInputEvent* event, float pressure, int32_t pointerIndex)

描述：

设置克隆事件指定触摸点应用于触摸屏的压力。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float pressure	应用于触摸屏的压力，取值范围为[0,1]中的任意数值，部分设备中可能大于1。
int32_t pointerIndex	表示多点触控数据列表中目标触控点的索引。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetEventTime()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetEventTime(const ArkUI_UIInputEvent* event, int64_t timestamp)

描述：

设置克隆UI输入事件发生的时间。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int64_t timestamp	克隆UI输入事件发生的时间，单位为ns。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_ClonedEvent_SetDeviceId()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetDeviceId(const ArkUI_UIInputEvent* event, int32_t deviceId)

描述：

设置触发克隆UI输入事件的设备ID。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t deviceId	触发克隆UI输入事件的设备ID，可用OH_ArkUI_UIInputEvent_GetDeviceId接口获取。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_ClonedEvent_SetTargetDisplayId()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetTargetDisplayId(const ArkUI_UIInputEvent* event, int32_t targetDisplayId)

描述：

设置克隆UI输入事件发生的屏幕ID。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t targetDisplayId	克隆UI输入事件发生的屏幕ID，可用OH_ArkUI_UIInputEvent_GetTargetDisplayId接口获取。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_ClonedEvent_SetChangedFingerId()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetChangedFingerId(const ArkUI_UIInputEvent* event, int32_t fingerId)

描述：

设置克隆指针事件的触摸点ID。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t fingerId	触发事件的触摸点ID，可以通过OH_ArkUI_PointerEvent_GetPointerId接口获取。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetFingerIdByIndex()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetFingerIdByIndex(const ArkUI_UIInputEvent* event, int32_t fingerId, int32_t pointerIndex)

描述：

设置克隆事件特定接触点的触摸点ID。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t fingerId	特定接触点的触摸点ID，可以通过OH_ArkUI_PointerEvent_GetChangedPointerId接口获取。
int32_t pointerIndex	表示多点触控数据列表中目标触控点的索引。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetChangedWindowPosition()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetChangedWindowPosition(const ArkUI_UIInputEvent* event, float x, float y)

描述：

设置克隆事件相对于当前窗口左上角的X坐标和Y坐标。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float x	事件相对于当前窗口左上角的X坐标，单位为px。
float y	事件相对于当前窗口左上角的Y坐标，单位为px。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_ClonedEvent_SetWindowPositionByIndex()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetWindowPositionByIndex(const ArkUI_UIInputEvent* event, float x, float y, int32_t pointerIndex)

描述：

设置克隆事件特定接触点相对于当前窗口左上角的X坐标和Y坐标。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float x	事件相对于当前窗口左上角的X坐标，单位为px。
float y	事件相对于当前窗口左上角的Y坐标，单位为px。
int32_t pointerIndex	表示多点触控数据列表中目标触控点的索引。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetChangedScreenPosition()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetChangedScreenPosition(const ArkUI_UIInputEvent* event, float x, float y)

描述：

设置克隆事件相对于当前屏幕左上角的X坐标和Y坐标。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float x	事件相对于当前屏幕左上角的X坐标，单位为px。
float y	事件相对于当前屏幕左上角的Y坐标，单位为px。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_ClonedEvent_SetScreenPositionByIndex()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetScreenPositionByIndex(const ArkUI_UIInputEvent* event, float x, float y, int32_t pointerIndex)

描述：

设置克隆事件特定接触点相对于当前屏幕左上角的X坐标和Y坐标。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float x	事件相对于当前屏幕左上角的X坐标，单位为px。
float y	事件相对于当前屏幕左上角的Y坐标，单位为px。
int32_t pointerIndex	表示多点触控数据列表中目标触控点的索引。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetChangedGlobalDisplayPosition()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetChangedGlobalDisplayPosition(const ArkUI_UIInputEvent* event, float x, float y)

描述：

设置克隆事件在全局坐标系的坐标。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float x	事件相对于全局显示的X坐标，单位为px。
float y	事件相对于全局显示的Y坐标，单位为px。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_ClonedEvent_SetGlobalDisplayPositionByIndex()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetGlobalDisplayPositionByIndex(const ArkUI_UIInputEvent* event, float x, float y, int32_t pointerIndex)

描述：

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float x	事件相对于全局显示的X坐标，单位为px。
float y	事件相对于全局显示的Y坐标，单位为px。
int32_t pointerIndex	表示多点触控数据列表中目标触控点的索引。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetHandleId()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetHandleId(const ArkUI_UIInputEvent* event, int32_t eventHandleId)

描述：

设置事件处理会话的唯一句柄。该句柄必须用于对该事件的任何进一步操作。对于给定的手指，同一时间只有一个具有此句柄的事件处于活动状态。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t eventHandleId	事件处理会话的唯一句柄。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_ClonedEvent_SetTiltAngle()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetTiltAngle(const ArkUI_UIInputEvent* event, float tiltX, float tiltY)

描述：

设置克隆事件相对于XZ平面和YZ平面的倾斜角度。取值范围为[-90, 90]，其中正值表示向右倾斜。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float tiltX	克隆事件相对于YZ平面的倾斜角度，单位为deg。
float tiltY	克隆事件相对于XZ平面的倾斜角度，单位为deg。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetRollAngle()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetRollAngle(const ArkUI_UIInputEvent* event, float rollAngle)

描述：

设置克隆事件触控笔绕Z轴的旋转角度。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float rollAngle	克隆事件触控笔绕Z轴的旋转角度，单位为deg。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetPressedKeys()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetPressedKeys(const ArkUI_UIInputEvent* event, int32_t* pressedKeyCodes, int32_t length)

描述：

设置克隆事件中所有按下的按键。该接口适用于触摸事件、鼠标事件和轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t* pressedKeyCodes	所有按下的按键键值数组，键值取值为ArkUI_KeyCode。
int32_t length	按下的按键数组长度。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。

OH_ArkUI_ClonedEvent_SetChangedTouchArea()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetChangedTouchArea(const ArkUI_UIInputEvent* event, float width, float height)

描述：

设置克隆事件的手指接触区域的宽度和高度，该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float width	克隆事件的接触区域的宽度，单位为px。
float height	克隆事件的接触区域的高度，单位为px。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetTouchAreaByIndex()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetTouchAreaByIndex(const ArkUI_UIInputEvent* event, float width, float height, int32_t pointerIndex)

描述：

设置克隆事件特定接触点的手指接触区域的宽度和高度，该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float width	克隆事件的接触区域的宽度，单位为px。
float height	克隆事件的接触区域的高度，单位为px。
int32_t pointerIndex	表示多点触控数据列表中目标触控点的索引。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetChangedInteractionHand()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetChangedInteractionHand(const ArkUI_UIInputEvent* event, int32_t hand)

描述：

设置克隆事件是左手或右手触发。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t hand	触摸点是左手还是右手，ARKUI_EVENT_HAND_LEFT为左手，ARKUI_EVENT_HAND_RIGHT为右手。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetInteractionHandByIndex()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetInteractionHandByIndex(const ArkUI_UIInputEvent* event, int32_t hand, int32_t pointerIndex)

描述：

设置克隆事件特定接触点由左手或右手触发。该接口适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t hand	触摸点是左手还是右手，ARKUI_EVENT_HAND_LEFT为左手，ARKUI_EVENT_HAND_RIGHT为右手。
int32_t pointerIndex	表示多点触控数据列表中目标触控点的索引。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetPressedTimeByIndex()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetPressedTimeByIndex(const ArkUI_UIInputEvent* event, int64_t pressedTime, int32_t pointerIndex)

描述：

设置克隆事件指定触摸点的按下时间。该接口仅适用于触摸事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int64_t pressedTime	指定触摸点的按下时间，单位为ns。
int32_t pointerIndex	表示多点触控数据列表中目标触控点的索引。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetPinchAxisScaleValue()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetPinchAxisScaleValue(const ArkUI_UIInputEvent* event, double pinchAxisScaleValue)

描述：

设置克隆事件的捏合轴缩放值。该接口仅适用于轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
double pinchAxisScaleValue	捏合轴的缩放值，单位为vp，取值[0, +∞)。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetHorizontalAxisScaleValue()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetHorizontalAxisScaleValue(const ArkUI_UIInputEvent* event, double horizontalAxisScaleValue)

描述：

设置克隆事件水平滚动轴的值。该接口仅适用于轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
double horizontalAxisScaleValue	水平滚动轴的值，单位为vp。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetVerticalAxisScaleValue()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetVerticalAxisScaleValue(const ArkUI_UIInputEvent* event, double verticalAxisScaleValue)

描述：

设置克隆事件垂直滚动轴的值。该接口仅适用于轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
double verticalAxisScaleValue	垂直滚动轴的值，单位为vp。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetScrollStep()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetScrollStep(const ArkUI_UIInputEvent* event, int32_t scrollStep)

描述：

设置克隆事件的滚动步长系数。该接口仅适用于轴事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t scrollStep	克隆事件的滚动步长系数，取值为[0, 65535]的整数。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetMouseButton()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetMouseButton(const ArkUI_UIInputEvent* event, int32_t button)

描述：

设置克隆事件的按钮类型值。该接口仅适用于鼠标事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
int32_t button	克隆事件的鼠标按钮类型，取值由anonymous5枚举定义。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetRawDeltaX()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetRawDeltaX(const ArkUI_UIInputEvent* event, float rawDeltaX)

描述：

设置鼠标设备在二维平面X轴的移动增量。其数值为鼠标硬件的原始移动数据，使用物理世界中鼠标移动的距离单位进行表示。该接口仅适用于鼠标事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float rawDeltaX	鼠标位置相对于之前上报的鼠标事件中位置的X轴偏移量。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetRawDeltaY()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetRawDeltaY(const ArkUI_UIInputEvent* event, float rawDeltaY)

描述：

设置鼠标设备在二维平面Y轴的移动增量。其数值为鼠标硬件的原始移动数据，使用物理世界中鼠标移动的距离单位进行表示。该接口仅适用于鼠标事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
float rawDeltaY	鼠标位置相对于之前上报的鼠标事件中位置的Y轴偏移量。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_ClonedEvent_SetPressedButtons()

ArkUI_ErrorCode OH_ArkUI_ClonedEvent_SetPressedButtons(const ArkUI_UIInputEvent* event, const int32_t* pressedButtons, int32_t length)

描述：

设置克隆事件的按下的按键。该接口仅适用于鼠标事件。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
const int32_t* pressedButtons	按下的按键数组，按键的值请参考anonymous5
int32_t length	按下的按键数组长度。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果输入的事件指针不是克隆事件指针，则返回ARKUI_ERROR_CODE_NOT_CLONED_POINTER_EVENT。如果事件类型不支持，则返回ARKUI_ERROR_INPUT_EVENT_TYPE_NOT_SUPPORTED。

OH_ArkUI_PointerEvent_PostClonedEventWithStrategy()

ArkUI_ErrorCode OH_ArkUI_PointerEvent_PostClonedEventWithStrategy(ArkUI_NodeHandle node, const ArkUI_UIInputEvent* event, ArkUI_CompetitionStrategy strategy)

描述：

使用指定的竞争策略将克隆事件发送到特定节点。只有通过OH_ArkUI_PointerEvent_CreateClonedPointerEvent和OH_ArkUI_PointerEvent_CreatePointerEvent接口创建的ArkUI_UIInputEvent对象才能使用此接口。

起始版本： 24

参数：

参数项	描述
ArkUI_NodeHandle node	目标节点。
const ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。
ArkUI_CompetitionStrategy strategy	竞争策略，取值为ArkUI_CompetitionStrategy。

返回：

类型

说明

ArkUI_ErrorCode

OH_ArkUI_UIInputEvent_GetLatestStatus()

ArkUI_ErrorCode OH_ArkUI_UIInputEvent_GetLatestStatus()

描述：

调用该方法获取最近一次UIInput相关方法的执行情况。通常情况下不需要使用该方法，仅在返回值结果不确定是否异常时使用。

起始版本： 20

返回：

类型	说明
ArkUI_ErrorCode	返回最近一次调用UIInput方法产生的结果代码。

OH_ArkUI_UIInputEvent_GetCoastingAxisEvent()

ArkUI_CoastingAxisEvent* OH_ArkUI_UIInputEvent_GetCoastingAxisEvent(ArkUI_UIInputEvent* event)

描述：

从组件事件中获取惯性滚动轴事件，仅当用户在触摸板上使用双指滑动一定距离并快速抬手，且指针位置下存在注册了NODE_ON_COASTING_AXIS_EVENT事件的组件时，才能获取到有效事件。在从ArkUI_NodeEvent对象获取到ArkUI_UIInputEvent对象后调用此方法。

惯性滚动轴事件仅在双指抛滑并离开触控板时触发，因此仅支持触控板。惯性滚动轴事件会在手指离开触控板后，根据抛滑速度产生轴值逐渐衰减的事件。由于刷新频率和性能的影响，当前事件轴值可能高于或低于上一个事件值。在惯性滚动轴事件期间，以下四种行为会中断事件，并立即收到ARKUI_COASTING_AXIS_EVENT_PHASE_END。

手指触摸触控板。
滚动鼠标滚轮。
手指或鼠标点击注册了惯性滚动轴事件的节点。需要注意的是，点击未注册此事件的节点不会产生任何效果。例如，A节点注册了惯性滚动轴事件，当事件发生时，让B节点滚动，但点击B节点不会中断此事件。点击事件的中断行为受OH_ArkUI_PointerEvent_SetInterceptHitTestMode的影响。此外，如果用户点击区域存在已收集的可响应惯性滚动轴事件的节点，本次惯性滚动轴事件会被强制终止。
应用休眠（例如最小化、锁屏）。

起始版本： 22

参数:

参数项	描述
ArkUI_UIInputEvent* event	ArkUI_UIInputEvent事件指针。

返回：

类型	说明
ArkUI_CoastingAxisEvent	返回指向惯性滚动轴事件的指针，如果未发生任何惯性滚动轴事件或发生任何参数错误，则返回空指针。

OH_ArkUI_CoastingAxisEvent_GetEventTime()

int64_t OH_ArkUI_CoastingAxisEvent_GetEventTime(ArkUI_CoastingAxisEvent* event)

描述：

获取惯性滚动轴事件发生的时间。

起始版本： 22

参数:

参数项	描述
ArkUI_CoastingAxisEvent* event	ArkUI_CoastingAxisEvent事件指针。

返回：

类型	说明
int64_t	返回UI输入事件发生的时间，单位为ns；如果发生任何参数错误则返回0。

OH_ArkUI_CoastingAxisEvent_GetPhase()

ArkUI_CoastingAxisEventPhase OH_ArkUI_CoastingAxisEvent_GetPhase(ArkUI_CoastingAxisEvent* event)

描述：

获取惯性滚动轴事件发生时的滚动阶段。

起始版本： 22

参数:

参数项	描述
ArkUI_CoastingAxisEvent* event	ArkUI_CoastingAxisEvent事件指针。

返回：

类型	说明
ArkUI_CoastingAxisEventPhase	返回事件阶段，参见ArkUI_CoastingAxisEventPhase。如果发生任何参数错误则返回ARKUI_COASTING_AXIS_EVENT_PHASE_NONE。

OH_ArkUI_CoastingAxisEvent_GetDeltaY

float OH_ArkUI_CoastingAxisEvent_GetDeltaY(ArkUI_CoastingAxisEvent* event)

描述：

获取惯性滚动轴事件垂直方向的增量值。单位为px，表示为单次滚动增量，非滚动总量。数值的正负代表方向，双指从上往下滑动时为负数，双指从下往上滑动时为正数。

起始版本： 22

参数:

参数项	描述
ArkUI_CoastingAxisEvent* event	ArkUI_CoastingAxisEvent事件指针。

返回：

类型	说明
float	返回Y轴增量值，以px为单位；如果发生任何参数错误则返回0.0f。

OH_ArkUI_CoastingAxisEvent_GetDeltaX

float OH_ArkUI_CoastingAxisEvent_GetDeltaX(ArkUI_CoastingAxisEvent* event)

描述：

获取惯性滚动轴事件水平方向的增量值。单位为px，表示为单次滚动增量，非滚动总量。数值的正负代表方向，双指从左往右滑动时为负数，双指从右往左滑动时为正数。

起始版本： 22

参数:

参数项	描述
ArkUI_CoastingAxisEvent* event	ArkUI_CoastingAxisEvent事件指针。

返回：

类型	说明
float	返回X轴增量值，以px为单位；如果发生任何参数错误则返回0.0f。

OH_ArkUI_CoastingAxisEvent_SetPropagation()

int32_t OH_ArkUI_CoastingAxisEvent_SetPropagation(ArkUI_CoastingAxisEvent* event, bool propagation)

描述：

设置惯性滚动轴事件是否启用冒泡，默认禁止冒泡。

起始版本： 22

参数:

参数项	描述
ArkUI_CoastingAxisEvent* event	ArkUI_CoastingAxisEvent事件指针。
bool propagation	是否启用事件冒泡。true表示启用，false表示禁用。

返回：

类型	说明
int32_t	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。

OH_ArkUI_TouchTestInfo_GetTouchTestInfoList

ArkUI_ErrorCode OH_ArkUI_TouchTestInfo_GetTouchTestInfoList(ArkUI_TouchTestInfo* info,
    ArkUI_TouchTestInfoItemArray* array, int32_t* size);

描述：

获取触摸测试信息项数组。

起始版本： 22

参数:

参数项	描述
ArkUI_TouchTestInfo* info	指向触摸测试信息的指针。
ArkUI_TouchTestInfoItemArray* array	指向触摸测试信息项数组的指针。
int32_t* size	触摸测试信息项数组的大小。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。

OH_ArkUI_TouchTestInfoItem_GetX

float OH_ArkUI_TouchTestInfoItem_GetX(const ArkUI_TouchTestInfoItem* info);

描述：

从触摸测试信息项中获取相对于子组件左上角的X坐标，单位为px。

起始版本： 22

参数:

参数项	描述
const ArkUI_TouchTestInfoItem* info	指向触摸测试信息项的指针。

返回：

类型	说明
float	相对于子组件左上角的X坐标，单位为px。若参数错误，返回0.0f。

OH_ArkUI_TouchTestInfoItem_GetY

float OH_ArkUI_TouchTestInfoItem_GetY(const ArkUI_TouchTestInfoItem* info);

描述：

从触摸测试信息项中获取相对于子组件左上角的Y坐标，单位为px。

起始版本： 22

参数:

参数项	描述
const ArkUI_TouchTestInfoItem* info	指向触摸测试信息项的指针。

返回：

类型	说明
float	相对于子组件左上角的Y坐标，单位为px。若参数错误，返回0.0f。

OH_ArkUI_TouchTestInfoItem_GetWindowX

float OH_ArkUI_TouchTestInfoItem_GetWindowX(const ArkUI_TouchTestInfoItem* info);

描述：

从触摸测试信息项中获取相对于当前应用窗口左上角的X坐标，单位为px。

起始版本： 22

参数:

参数项	描述
const ArkUI_TouchTestInfoItem* info	指向触摸测试信息项的指针。

返回：

类型	说明
float	相对于当前应用窗口左上角的X坐标，单位为px。若参数错误，返回0.0f。

OH_ArkUI_TouchTestInfoItem_GetWindowY

float OH_ArkUI_TouchTestInfoItem_GetWindowY(const ArkUI_TouchTestInfoItem* info);

描述：

从触摸测试信息项中获取相对于当前应用窗口左上角的Y坐标，单位为px。

起始版本： 22

参数:

参数项	描述
const ArkUI_TouchTestInfoItem* info	指向触摸测试信息项的指针。

返回：

类型	说明
float	相对于当前应用窗口左上角的Y坐标，单位为px。若参数错误，返回0.0f。

OH_ArkUI_TouchTestInfoItem_GetXRelativeToParent

float OH_ArkUI_TouchTestInfoItem_GetXRelativeToParent(const ArkUI_TouchTestInfoItem* info);

描述：

从触摸测试信息项中获取相对于父组件左上角的X坐标，单位为px。

起始版本： 22

参数:

参数项	描述
const ArkUI_TouchTestInfoItem* info	指向触摸测试信息项的指针。

返回：

类型	说明
float	相对于父组件左上角的X坐标，单位为px。若参数错误，返回0.0f。

OH_ArkUI_TouchTestInfoItem_GetYRelativeToParent

float OH_ArkUI_TouchTestInfoItem_GetYRelativeToParent(const ArkUI_TouchTestInfoItem* info);

描述：

从触摸测试信息项中获取相对于父组件左上角的Y坐标，单位为px。

起始版本： 22

参数:

参数项	描述
const ArkUI_TouchTestInfoItem* info	指向触摸测试信息项的指针。

返回：

类型	说明
float	相对于父组件左上角的Y坐标，单位为px。若参数错误，返回0.0f。

OH_ArkUI_TouchTestInfoItem_GetChildRect

ArkUI_ErrorCode OH_ArkUI_TouchTestInfoItem_GetChildRect(const ArkUI_TouchTestInfoItem* info, ArkUI_Rect* childRect);

描述：

从触摸测试信息项中获取子组件的边界矩形信息。

起始版本： 22

参数:

参数项	描述
const ArkUI_TouchTestInfoItem* info	指向触摸测试信息项的指针。
ArkUI_Rect* childRect	指向子组件边界矩形的指针，用于存储获取到的边界矩形信息。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。

OH_ArkUI_TouchTestInfoItem_GetChildId

ArkUI_ErrorCode OH_ArkUI_TouchTestInfoItem_GetChildId(const ArkUI_TouchTestInfoItem* info, char* buffer,
    int32_t bufferSize);

描述：

从触摸测试信息项中获取子组件的ID。

起始版本： 22

参数:

参数项	描述
const ArkUI_TouchTestInfoItem* info	指向触摸测试信息项的指针。
char* buffer	存储结果的缓冲区。
int32_t bufferSize	缓冲区的大小。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。如果缓冲区空间不足，则返回ARKUI_ERROR_CODE_BUFFER_SIZE_NOT_ENOUGH。

OH_ArkUI_TouchTestInfo_SetTouchResultStrategy

ArkUI_ErrorCode OH_ArkUI_TouchTestInfo_SetTouchResultStrategy(ArkUI_TouchTestInfo* info, ArkUI_TouchTestStrategy strategy);

描述：

设置触摸测试策略，即组件及其子组件在命中测试过程中的行为方式。

起始版本： 22

参数:

参数项	描述
ArkUI_TouchTestInfo* info	指向触摸测试信息的指针。
ArkUI_TouchTestStrategy strategy	触摸测试策略，定义组件及子组件在命中测试中的行为规则。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。

OH_ArkUI_TouchTestInfo_SetTouchResultId

ArkUI_ErrorCode OH_ArkUI_TouchTestInfo_SetTouchResultId(ArkUI_TouchTestInfo* info, const char* id);

描述：

设置命中测试过程中需要作用的子组件ID。

起始版本： 22

参数:

参数项	描述
ArkUI_TouchTestInfo* info	指向触摸测试信息的指针。
const char* id	子组件的ID，指定命中测试中需要作用的目标子组件。

返回：

类型	说明
ArkUI_ErrorCode	返回结果代码。如果操作成功，则返回ARKUI_ERROR_CODE_NO_ERROR。如果入参错误，则返回ARKUI_ERROR_CODE_PARAM_INVALID。

OH_ArkUI_DigitalCrownEvent_GetEventTime()

int64_t OH_ArkUI_DigitalCrownEvent_GetEventTime(const ArkUI_UIInputEvent* event)

描述：

获取表冠事件发生的时间。单位为ns。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
int64_t	返回UI输入事件发生的时间，如果参数有误，则返回0。

OH_ArkUI_DigitalCrownEvent_GetAngularVelocity()

double OH_ArkUI_DigitalCrownEvent_GetAngularVelocity(const ArkUI_UIInputEvent* event)

描述：

获取表冠事件发生的角速度。单位为°/s。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
double	返回UI输入事件发生的角速度，如果参数有误，则返回0.0。

OH_ArkUI_DigitalCrownEvent_GetDegree()

double OH_ArkUI_DigitalCrownEvent_GetDegree(const ArkUI_UIInputEvent* event)

描述：

获取表冠事件发生的旋转角度。单位为°。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
double	返回UI输入事件发生的旋转角度，如果参数有误，则返回0.0。

OH_ArkUI_DigitalCrownEvent_GetAction()

ArkUI_CrownEvent_Action OH_ArkUI_DigitalCrownEvent_GetAction(const ArkUI_UIInputEvent* event)

描述：

获取表冠事件发生的阶段。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。

返回：

类型	说明
ArkUI_CrownEvent_Action	返回UI输入事件发生时旋转表冠的行为。如果入参错误，则返回ARKUI_CROWNEVENT_ACTION_UNKNOWN。

OH_ArkUI_DigitalCrownEvent_SetStopPropagation()

ArkUI_ErrorCode OH_ArkUI_DigitalCrownEvent_SetStopPropagation(const ArkUI_UIInputEvent* event, bool stopPropagation)

描述：

设置是否阻止事件冒泡。仅适用于入参event里存储的是表冠事件对象的场景。

起始版本： 24

参数：

参数项	描述
const ArkUI_UIInputEvent* event	表示指向当前UI输入事件的指针。
bool stopPropagation	表示是否阻止事件冒泡。true表示阻止事件冒泡，false表示不阻止事件冒泡。

返回：

类型	说明
ArkUI_ErrorCode	错误码。 ARKUI_ERROR_CODE_NO_ERROR 成功。 ARKUI_ERROR_CODE_PARAM_INVALID 参数异常。