# Input

## 概述

提供多模态输入域的C接口。

**起始版本：** 12


## 汇总


### 文件

| 名称 | 描述 | 
| -------- | -------- |
| [oh_axis_type.h](oh__axis__type_8h.md) | 输入设备的轴事件结构和枚举。 | 
| [oh_input_manager.h](oh__input__manager_8h.md) | 提供事件注入和关键状态查询等功能。  | 
| [oh_key_code.h](oh__key__code_8h.md) | 按键设备的键码值。  | 

### 结构体

| 名称 | 描述 | 
| -------- | -------- |
| struct  [Input_InterceptorEventCallback](_input___interceptor_event_callback.md) | 拦截回调事件结构体，拦截鼠标事件、触摸事件和轴事件。  | 
| struct  [Input_DeviceListener](_input___device_listener.md) | 定义一个结构体用于监听设备热插拔。  | 


### 类型定义

| 名称 | 描述 | 
| -------- | -------- |
| typedef enum [InputEvent_AxisType](#inputevent_axistype) [InputEvent_AxisType](#inputevent_axistype) | 输入设备的轴类型。  | 
| typedef enum [InputEvent_AxisEventType](#inputevent_axiseventtype) [InputEvent_AxisEventType](#inputevent_axiseventtype) | 输入设备的轴事件类型。  | 
| typedef enum [InputEvent_AxisAction](#inputevent_axisaction) [InputEvent_AxisAction](#inputevent_axisaction) | 轴事件动作。  | 
| typedef enum [Input_KeyStateAction](#input_keystateaction) [Input_KeyStateAction](#input_keystateaction) | 按键状态的枚举值。  | 
| typedef enum [Input_KeyEventAction](#input_keyeventaction) [Input_KeyEventAction](#input_keyeventaction) | 按键事件类型的枚举值。  | 
| typedef enum [Input_MouseEventAction](#input_mouseeventaction) [Input_MouseEventAction](#input_mouseeventaction) | 鼠标动作的枚举值。  | 
| typedef enum [InputEvent_MouseAxis](#inputevent_mouseaxis) [InputEvent_MouseAxis](#inputevent_mouseaxis) | 鼠标轴事件类型。  | 
| typedef enum [Input_MouseEventButton](#input_mouseeventbutton) [Input_MouseEventButton](#input_mouseeventbutton) | 鼠标按键的枚举值。  | 
| typedef enum [Input_TouchEventAction](#input_toucheventaction) [Input_TouchEventAction](#input_toucheventaction) | 触摸动作的枚举值。  | 
| typedef enum [InputEvent_SourceType](#inputevent_sourcetype) [InputEvent_SourceType](#inputevent_sourcetype) | 输入事件源类型。  | 
| typedef enum [Input_KeyboardType](#input_keyboardtype) [Input_KeyboardType](#input_keyboardtype) | 输入设备的键盘类型。  | 
| typedef struct [Input_KeyState](#input_keystate) [Input_KeyState](#input_keystate) | 定义按键信息，用于标识按键行为。例如，“Ctrl”按键信息包含键值和键类型。  | 
| typedef struct [Input_KeyEvent](#input_keyevent) [Input_KeyEvent](#input_keyevent) | 要注入的按键事件。  | 
| typedef struct [Input_MouseEvent](#input_mouseevent) [Input_MouseEvent](#input_mouseevent) | 要注入的鼠标事件。  | 
| typedef struct [Input_TouchEvent](#input_touchevent) [Input_TouchEvent](#input_touchevent) | 要注入的触摸事件。  | 
| typedef struct [Input_AxisEvent](#input_axisevent) [Input_AxisEvent](#input_axisevent) | 轴事件。  | 
| typedef enum [Input_Result](#input_result) [Input_Result](#input_result) | 错误码枚举值。  | 
| typedef void(\* [Input_KeyEventCallback](#input_keyeventcallback)) (const [Input_KeyEvent](#input_keyevent) \*keyEvent) | 按键事件的回调函数，keyEvent的生命周期为回调函数内。  | 
| typedef void(\* [Input_MouseEventCallback](#input_mouseeventcallback)) (const [Input_MouseEvent](#input_mouseevent) \*mouseEvent) | 鼠标事件的回调函数，mouseEvent的生命周期为回调函数内。  | 
| typedef void(\* [Input_TouchEventCallback](#input_toucheventcallback)) (const [Input_TouchEvent](#input_touchevent) \*touchEvent) | 触摸事件的回调函数，touchEvent的生命周期为回调函数内。  | 
| typedef void(\* [Input_AxisEventCallback](#input_axiseventcallback)) (const [Input_AxisEvent](#input_axisevent) \*axisEvent) | 轴事件的回调函数，axisEvent的生命周期为回调函数内。  | 
| typedef void(\* [Input_HotkeyCallback](#input_hotkeycallback)) ([Input_Hotkey](#input_hotkey) \*hotkey) | 回调函数，用于回调快捷键事件。  | 
| typedef void(\* [Input_DeviceAddedCallback](#input_deviceaddedcallback)) (int32_t deviceId) | 回调函数，用于回调输入设备的热插事件。  | 
| typedef void(\* [Input_DeviceRemovedCallback](#input_deviceremovedcallback)) (int32_t deviceId) | 回调函数，用于回调输入设备的热拔事件。  | 
| typedef struct [Input_InterceptorEventCallback](_input___interceptor_event_callback.md) [Input_InterceptorEventCallback](#input_interceptoreventcallback) | 拦截回调事件结构体，拦截鼠标事件、触摸事件和轴事件。  | 
| typedef struct [Input_DeviceListener](_input___device_listener.md) [Input_DeviceListener](#input_devicelistener) |定义一个结构体用于监听设备热插拔。  | 
| typedef struct [Input_InterceptorOptions](#input_interceptoroptions) [Input_InterceptorOptions](#input_interceptoroptions) | 事件拦截选项。  | 
| typedef struct [Input_Hotkey](#input_hotkey) [Input_Hotkey](#input_hotkey) | 定义快捷键结构体。  | 
| typedef struct [Input_DeviceInfo](#input_deviceinfo) [Input_DeviceInfo](#input_deviceinfo) | 输入设备信息。  | 


### 枚举

| 名称 | 描述 | 
| -------- | -------- |
| [InputEvent_AxisType](#inputevent_axistype) {<br/>AXIS_TYPE_UNKNOWN, AXIS_TYPE_SCROLL_VERTICAL, AXIS_TYPE_SCROLL_HORIZONTAL, AXIS_TYPE_PINCH,<br/>AXIS_TYPE_ROTATE<br/>} | 输入设备的轴类型。  | 
| [InputEvent_AxisEventType](#inputevent_axiseventtype) { AXIS_EVENT_TYPE_PINCH = 1, AXIS_EVENT_TYPE_SCROLL = 2 } | 输入设备的轴事件类型。  | 
| [InputEvent_AxisAction](#inputevent_axisaction) { AXIS_ACTION_CANCEL = 0, AXIS_ACTION_BEGIN, AXIS_ACTION_UPDATE, AXIS_ACTION_END } | 轴事件动作。  | 
| [Input_KeyStateAction](#input_keystateaction) {<br/>KEY_DEFAULT = -1, KEY_PRESSED = 0, KEY_RELEASED = 1, KEY_SWITCH_ON = 2,<br/>KEY_SWITCH_OFF = 3<br/>} | 按键状态的枚举值。  | 
| [Input_KeyEventAction](#input_keyeventaction) { KEY_ACTION_CANCEL = 0, KEY_ACTION_DOWN = 1, KEY_ACTION_UP = 2 } | 按键事件类型的枚举值。  | 
| [Input_MouseEventAction](#input_mouseeventaction) {<br/>MOUSE_ACTION_CANCEL = 0, MOUSE_ACTION_MOVE = 1, MOUSE_ACTION_BUTTON_DOWN = 2, MOUSE_ACTION_BUTTON_UP = 3,<br/>MOUSE_ACTION_AXIS_BEGIN = 4, MOUSE_ACTION_AXIS_UPDATE = 5, MOUSE_ACTION_AXIS_END = 6<br/>} | 鼠标动作的枚举值。  | 
| [InputEvent_MouseAxis](#inputevent_mouseaxis) { MOUSE_AXIS_SCROLL_VERTICAL = 0, MOUSE_AXIS_SCROLL_HORIZONTAL = 1 } | 鼠标轴事件类型。  | 
| [Input_MouseEventButton](#input_mouseeventbutton) {<br/>MOUSE_BUTTON_NONE = -1, MOUSE_BUTTON_LEFT = 0, MOUSE_BUTTON_MIDDLE = 1, MOUSE_BUTTON_RIGHT = 2,<br/>MOUSE_BUTTON_FORWARD = 3, MOUSE_BUTTON_BACK = 4<br/>} | 鼠标按键的枚举值。  | 
| [Input_TouchEventAction](#input_toucheventaction) { TOUCH_ACTION_CANCEL = 0, TOUCH_ACTION_DOWN = 1, TOUCH_ACTION_MOVE = 2, TOUCH_ACTION_UP = 3 } | 触摸动作的枚举值。  | 
| [InputEvent_SourceType](#inputevent_sourcetype) { SOURCE_TYPE_MOUSE = 1, SOURCE_TYPE_TOUCHSCREEN = 2, SOURCE_TYPE_TOUCHPAD = 3 } | 输入事件源类型。  | 
| [Input_KeyboardType](#input_keyboardtype) {<br/>KEYBOARD_TYPE_NONE = 0, KEYBOARD_TYPE_UNKNOWN = 1, KEYBOARD_TYPE_ALPHABETIC = 2, KEYBOARD_TYPE_DIGITAL = 3,<br/>KEYBOARD_TYPE_STYLUS = 4, KEYBOARD_TYPE_REMOTE_CONTROL = 5<br/>} | 输入设备的键盘类型。  | 
| [Input_Result](#input_result) {<br/>INPUT_SUCCESS = 0, INPUT_PERMISSION_DENIED = 201, INPUT_NOT_SYSTEM_APPLICATION = 202, INPUT_PARAMETER_ERROR = 401,<br/>INPUT_SERVICE_EXCEPTION = 3800001, INPUT_REPEAT_INTERCEPTOR = 4200001, INPUT_OCCUPIED_BY_SYSTEM = 4200002, INPUT_OCCUPIED_BY_OTHER = 4200003<br/>} | 错误码枚举值。  | 
| [Input_KeyCode](#input_keycode) {<br/>KEYCODE_UNKNOWN = -1, KEYCODE_FN = 0, KEYCODE_VOLUME_UP = 16, KEYCODE_VOLUME_DOWN = 17,<br/>KEYCODE_POWER = 18, KEYCODE_CAMERA = 19, KEYCODE_VOLUME_MUTE = 22, KEYCODE_MUTE = 23,<br/>KEYCODE_BRIGHTNESS_UP = 40, KEYCODE_BRIGHTNESS_DOWN = 41, KEYCODE_0 = 2000, KEYCODE_1 = 2001,<br/>KEYCODE_2 = 2002, KEYCODE_3 = 2003, KEYCODE_4 = 2004, KEYCODE_5 = 2005,<br/>KEYCODE_6 = 2006, KEYCODE_7 = 2007, KEYCODE_8 = 2008, KEYCODE_9 = 2009,<br/>KEYCODE_STAR = 2010, KEYCODE_POUND = 2011, KEYCODE_DPAD_UP = 2012, KEYCODE_DPAD_DOWN = 2013,<br/>KEYCODE_DPAD_LEFT = 2014, KEYCODE_DPAD_RIGHT = 2015, KEYCODE_DPAD_CENTER = 2016, KEYCODE_A = 2017,<br/>KEYCODE_B = 2018, KEYCODE_C = 2019, KEYCODE_D = 2020, KEYCODE_E = 2021,<br/>KEYCODE_F = 2022, KEYCODE_G = 2023, KEYCODE_H = 2024, KEYCODE_I = 2025,<br/>KEYCODE_J = 2026, KEYCODE_K = 2027, KEYCODE_L = 2028, KEYCODE_M = 2029,<br/>KEYCODE_N = 2030, KEYCODE_O = 2031, KEYCODE_P = 2032, KEYCODE_Q = 2033,<br/>KEYCODE_R = 2034, KEYCODE_S = 2035, KEYCODE_T = 2036, KEYCODE_U = 2037,<br/>KEYCODE_V = 2038, KEYCODE_W = 2039, KEYCODE_X = 2040, KEYCODE_Y = 2041,<br/>KEYCODE_Z = 2042, KEYCODE_COMMA = 2043, KEYCODE_PERIOD = 2044, KEYCODE_ALT_LEFT = 2045,<br/>KEYCODE_ALT_RIGHT = 2046, KEYCODE_SHIFT_LEFT = 2047, KEYCODE_SHIFT_RIGHT = 2048, KEYCODE_TAB = 2049,<br/>KEYCODE_SPACE = 2050, KEYCODE_SYM = 2051, KEYCODE_EXPLORER = 2052, KEYCODE_ENVELOPE = 2053,<br/>KEYCODE_ENTER = 2054, KEYCODE_DEL = 2055, KEYCODE_GRAVE = 2056, KEYCODE_MINUS = 2057,<br/>KEYCODE_EQUALS = 2058, KEYCODE_LEFT_BRACKET = 2059, KEYCODE_RIGHT_BRACKET = 2060, KEYCODE_BACKSLASH = 2061,<br/>KEYCODE_SEMICOLON = 2062, KEYCODE_APOSTROPHE = 2063, KEYCODE_SLASH = 2064, KEYCODE_AT = 2065,<br/>KEYCODE_PLUS = 2066, KEYCODE_MENU = 2067, KEYCODE_PAGE_UP = 2068, KEYCODE_PAGE_DOWN = 2069,<br/>KEYCODE_ESCAPE = 2070, KEYCODE_FORWARD_DEL = 2071, KEYCODE_CTRL_LEFT = 2072, KEYCODE_CTRL_RIGHT = 2073,<br/>KEYCODE_CAPS_LOCK = 2074, KEYCODE_SCROLL_LOCK = 2075, KEYCODE_META_LEFT = 2076, KEYCODE_META_RIGHT = 2077,<br/>KEYCODE_FUNCTION = 2078, KEYCODE_SYSRQ = 2079, KEYCODE_BREAK = 2080, KEYCODE_MOVE_HOME = 2081,<br/>KEYCODE_MOVE_END = 2082, KEYCODE_INSERT = 2083, KEYCODE_FORWARD = 2084, KEYCODE_MEDIA_PLAY = 2085,<br/>KEYCODE_MEDIA_PAUSE = 2086, KEYCODE_MEDIA_CLOSE = 2087, KEYCODE_MEDIA_EJECT = 2088, KEYCODE_MEDIA_RECORD = 2089,<br/>KEYCODE_F1 = 2090, KEYCODE_F2 = 2091, KEYCODE_F3 = 2092, KEYCODE_F4 = 2093,<br/>KEYCODE_F5 = 2094, KEYCODE_F6 = 2095, KEYCODE_F7 = 2096, KEYCODE_F8 = 2097,<br/>KEYCODE_F9 = 2098, KEYCODE_F10 = 2099, KEYCODE_F11 = 2100, KEYCODE_F12 = 2101,<br/>KEYCODE_NUM_LOCK = 2102, KEYCODE_NUMPAD_0 = 2103, KEYCODE_NUMPAD_1 = 2104, KEYCODE_NUMPAD_2 = 2105,<br/>KEYCODE_NUMPAD_3 = 2106, KEYCODE_NUMPAD_4 = 2107, KEYCODE_NUMPAD_5 = 2108, KEYCODE_NUMPAD_6 = 2109,<br/>KEYCODE_NUMPAD_7 = 2110, KEYCODE_NUMPAD_8 = 2111, KEYCODE_NUMPAD_9 = 2112, KEYCODE_NUMPAD_DIVIDE = 2113,<br/>KEYCODE_NUMPAD_MULTIPLY = 2114, KEYCODE_NUMPAD_SUBTRACT = 2115, KEYCODE_NUMPAD_ADD = 2116, KEYCODE_NUMPAD_DOT = 2117,<br/>KEYCODE_NUMPAD_COMMA = 2118, KEYCODE_NUMPAD_ENTER = 2119, KEYCODE_NUMPAD_EQUALS = 2120, KEYCODE_NUMPAD_LEFT_PAREN = 2121,<br/>KEYCODE_NUMPAD_RIGHT_PAREN = 2122<br/>} | 键码值。  | 


### 函数

| 名称 | 描述 | 
| -------- | -------- |
| [Input_Result](#input_result) [OH_Input_GetKeyState](#oh_input_getkeystate) (struct [Input_KeyState](#input_keystate) \*keyState) | 查询按键状态的枚举对象。  | 
| struct [Input_KeyState](#input_keystate) \* [OH_Input_CreateKeyState](#oh_input_createkeystate) () | 创建按键状态的枚举对象。  | 
| void [OH_Input_DestroyKeyState](#oh_input_destroykeystate) (struct [Input_KeyState](#input_keystate) \*\*keyState) | 销毁按键状态的枚举对象。  | 
| void [OH_Input_SetKeyCode](#oh_input_setkeycode) (struct [Input_KeyState](#input_keystate) \*keyState, int32_t keyCode) | 设置按键状态对象的键值。  | 
| int32_t [OH_Input_GetKeyCode](#oh_input_getkeycode) (const struct [Input_KeyState](#input_keystate) \*keyState) | 获取按键状态对象的键值。  | 
| void [OH_Input_SetKeyPressed](#oh_input_setkeypressed) (struct [Input_KeyState](#input_keystate) \*keyState, int32_t keyAction) | 设置按键状态对象的按键是否按下。  | 
| int32_t [OH_Input_GetKeyPressed](#oh_input_getkeypressed) (const struct [Input_KeyState](#input_keystate) \*keyState) | 获取按键状态对象的按键是否按下。  | 
| void [OH_Input_SetKeySwitch](#oh_input_setkeyswitch) (struct [Input_KeyState](#input_keystate) \*keyState, int32_t keySwitch) | 设置按键状态对象的按键开关。  | 
| int32_t [OH_Input_GetKeySwitch](#oh_input_getkeyswitch) (const struct [Input_KeyState](#input_keystate) \*keyState) | 获取按键状态对象的按键开关。  | 
| int32_t [OH_Input_InjectKeyEvent](#oh_input_injectkeyevent) (const struct [Input_KeyEvent](#input_keyevent) \*keyEvent) | 注入按键事件。  | 
| struct [Input_KeyEvent](#input_keyevent) \* [OH_Input_CreateKeyEvent](#oh_input_createkeyevent) () | 创建按键事件对象。  | 
| void [OH_Input_DestroyKeyEvent](#oh_input_destroykeyevent) (struct [Input_KeyEvent](#input_keyevent) \*\*keyEvent) | 销毁按键事件对象。 | 
| void [OH_Input_SetKeyEventAction](#oh_input_setkeyeventaction) (struct [Input_KeyEvent](#input_keyevent) \*keyEvent, int32_t action) | 设置按键事件类型。  | 
| int32_t [OH_Input_GetKeyEventAction](#oh_input_getkeyeventaction) (const struct [Input_KeyEvent](#input_keyevent) \*keyEvent) | 获取按键事件类型  | 
| void [OH_Input_SetKeyEventKeyCode](#oh_input_setkeyeventkeycode) (struct [Input_KeyEvent](#input_keyevent) \*keyEvent, int32_t keyCode) | 设置按键事件的键值。  | 
| int32_t [OH_Input_GetKeyEventKeyCode](#oh_input_getkeyeventkeycode) (const struct [Input_KeyEvent](#input_keyevent) \*keyEvent) | 获取按键事件的键值。  | 
| void [OH_Input_SetKeyEventActionTime](#oh_input_setkeyeventactiontime) (struct [Input_KeyEvent](#input_keyevent) \*keyEvent, int64_t actionTime) | 设置按键事件发生的时间。  | 
| int64_t [OH_Input_GetKeyEventActionTime](#oh_input_getkeyeventactiontime) (const struct [Input_KeyEvent](#input_keyevent) \*keyEvent) | 获取按键事件发生的时间。  | 
| int32_t [OH_Input_InjectMouseEvent](#oh_input_injectmouseevent) (const struct [Input_MouseEvent](#input_mouseevent) \*mouseEvent) | 注入鼠标事件。  | 
| struct [Input_MouseEvent](#input_mouseevent) \* [OH_Input_CreateMouseEvent](#oh_input_createmouseevent) () | 创建鼠标事件对象。  | 
| void [OH_Input_DestroyMouseEvent](#oh_input_destroymouseevent) (struct [Input_MouseEvent](#input_mouseevent) \*\*mouseEvent) | 销毁鼠标事件对象 。 | 
| void [OH_Input_SetMouseEventAction](#oh_input_setmouseeventaction) (struct [Input_MouseEvent](#input_mouseevent) \*mouseEvent, int32_t action) | 设置鼠标事件的动作。  | 
| int32_t [OH_Input_GetMouseEventAction](#oh_input_getmouseeventaction) (const struct [Input_MouseEvent](#input_mouseevent) \*mouseEvent) | 获取鼠标事件的动作。  | 
| void [OH_Input_SetMouseEventDisplayX](#oh_input_setmouseeventdisplayx) (struct [Input_MouseEvent](#input_mouseevent) \*mouseEvent, int32_t displayX) | 设置鼠标事件的屏幕X坐标。  | 
| int32_t [OH_Input_GetMouseEventDisplayX](#oh_input_getmouseeventdisplayx) (const struct [Input_MouseEvent](#input_mouseevent) \*mouseEvent) | 获取鼠标事件的屏幕X坐标。  | 
| void [OH_Input_SetMouseEventDisplayY](#oh_input_setmouseeventdisplayy) (struct [Input_MouseEvent](#input_mouseevent) \*mouseEvent, int32_t displayY) | 设置鼠标事件的屏幕Y坐标。  | 
| int32_t [OH_Input_GetMouseEventDisplayY](#oh_input_getmouseeventdisplayy) (const struct [Input_MouseEvent](#input_mouseevent) \*mouseEvent) | 获取鼠标事件的屏幕Y坐标。  | 
| void [OH_Input_SetMouseEventButton](#oh_input_setmouseeventbutton) (struct [Input_MouseEvent](#input_mouseevent) \*mouseEvent, int32_t button) | 设置鼠标事件的按键。  | 
| int32_t [OH_Input_GetMouseEventButton](#oh_input_getmouseeventbutton) (const struct [Input_MouseEvent](#input_mouseevent) \*mouseEvent) | 获取鼠标事件的按键。  | 
| void [OH_Input_SetMouseEventAxisType](#oh_input_setmouseeventaxistype) (struct [Input_MouseEvent](#input_mouseevent) \*mouseEvent, int32_t axisType) | 设置鼠标轴事件的类型。  | 
| int32_t [OH_Input_GetMouseEventAxisType](#oh_input_getmouseeventaxistype) (const struct [Input_MouseEvent](#input_mouseevent) \*mouseEvent) | 获取鼠标轴事件的类型。  | 
| void [OH_Input_SetMouseEventAxisValue](#oh_input_setmouseeventaxisvalue) (struct [Input_MouseEvent](#input_mouseevent) \*mouseEvent, float axisValue) | 设置鼠标轴事件的值。  | 
| float [OH_Input_GetMouseEventAxisValue](#oh_input_getmouseeventaxisvalue) (const struct [Input_MouseEvent](#input_mouseevent) \*mouseEvent) | 获取鼠标轴事件的值。  | 
| void [OH_Input_SetMouseEventActionTime](#oh_input_setmouseeventactiontime) (struct [Input_MouseEvent](#input_mouseevent) \*mouseEvent, int64_t actionTime) | 设置鼠标事件发生的时间。  | 
| int64_t [OH_Input_GetMouseEventActionTime](#oh_input_getmouseeventactiontime) (const struct [Input_MouseEvent](#input_mouseevent) \*mouseEvent) | 获取鼠标事件发生的时间。  | 
| int32_t [OH_Input_InjectTouchEvent](#oh_input_injecttouchevent) (const struct [Input_TouchEvent](#input_touchevent) \*touchEvent) | 注入触摸事件。  | 
| struct [Input_TouchEvent](#input_touchevent) \* [OH_Input_CreateTouchEvent](#oh_input_createtouchevent) () | 创建触屏事件对象。  | 
| void [OH_Input_DestroyTouchEvent](#oh_input_destroytouchevent) (struct [Input_TouchEvent](#input_touchevent) \*\*touchEvent) | 销毁触屏事件对象。  | 
| void [OH_Input_SetTouchEventAction](#oh_input_settoucheventaction) (struct [Input_TouchEvent](#input_touchevent) \*touchEvent, int32_t action) | 设置触屏事件的动作。  | 
| int32_t [OH_Input_GetTouchEventAction](#oh_input_gettoucheventaction) (const struct [Input_TouchEvent](#input_touchevent) \*touchEvent) | 获取触屏事件的动作。  | 
| void [OH_Input_SetTouchEventFingerId](#oh_input_settoucheventfingerid) (struct [Input_TouchEvent](#input_touchevent) \*touchEvent, int32_t id) | 设置触屏事件的手指ID。  | 
| int32_t [OH_Input_GetTouchEventFingerId](#oh_input_gettoucheventfingerid) (const struct [Input_TouchEvent](#input_touchevent) \*touchEvent) | 获取触屏事件的手指ID。  | 
| void [OH_Input_SetTouchEventDisplayX](#oh_input_settoucheventdisplayx) (struct [Input_TouchEvent](#input_touchevent) \*touchEvent, int32_t displayX) | 设置触屏事件的屏幕X坐标。 | 
| int32_t [OH_Input_GetTouchEventDisplayX](#oh_input_gettoucheventdisplayx) (const struct [Input_TouchEvent](#input_touchevent) \*touchEvent) | 获取触屏事件的屏幕X坐标。  | 
| void [OH_Input_SetTouchEventDisplayY](#oh_input_settoucheventdisplayy) (struct [Input_TouchEvent](#input_touchevent) \*touchEvent, int32_t displayY) | 设置触屏事件的屏幕Y坐标。  | 
| int32_t [OH_Input_GetTouchEventDisplayY](#oh_input_gettoucheventdisplayy) (const struct [Input_TouchEvent](#input_touchevent) \*touchEvent) | 获取触屏事件的屏幕Y坐标。  | 
| void [OH_Input_SetTouchEventActionTime](#oh_input_settoucheventactiontime) (struct [Input_TouchEvent](#input_touchevent) \*touchEvent, int64_t actionTime) | 设置触摸事件发生的时间。  | 
| int64_t [OH_Input_GetTouchEventActionTime](#oh_input_gettoucheventactiontime) (const struct [Input_TouchEvent](#input_touchevent) \*touchEvent) | 获取触摸事件发生的时间。  | 
| void [OH_Input_CancelInjection](#oh_input_cancelinjection) () | 取消事件注入并撤销授权。  | 
| [Input_AxisEvent](#input_axisevent) \* [OH_Input_CreateAxisEvent](#oh_input_createaxisevent) (void) | 创建轴事件对象实例。  | 
| [Input_Result](#input_result) [OH_Input_DestroyAxisEvent](#oh_input_destroyaxisevent) ([Input_AxisEvent](#input_axisevent) \*\*axisEvent) | 销毁轴事件对象实例。  | 
| [Input_Result](#input_result) [OH_Input_SetAxisEventAction](#oh_input_setaxiseventaction) ([Input_AxisEvent](#input_axisevent) \*axisEvent, [InputEvent_AxisAction](#inputevent_axisaction) action) | 设置轴事件的动作。  | 
| [Input_Result](#input_result) [OH_Input_GetAxisEventAction](#oh_input_getaxiseventaction) (const [Input_AxisEvent](#input_axisevent) \*axisEvent, [InputEvent_AxisAction](#inputevent_axisaction) \*action) | 获取轴事件的动作。  | 
| [Input_Result](#input_result) [OH_Input_SetAxisEventDisplayX](#oh_input_setaxiseventdisplayx) ([Input_AxisEvent](#input_axisevent) \*axisEvent, float displayX) | 设置轴事件的X坐标。  | 
| [Input_Result](#input_result) [OH_Input_GetAxisEventDisplayX](#oh_input_getaxiseventdisplayx) (const [Input_AxisEvent](#input_axisevent) \*axisEvent, float \*displayX) | 获取轴事件的X坐标。  | 
| [Input_Result](#input_result) [OH_Input_SetAxisEventDisplayY](#oh_input_setaxiseventdisplayy) ([Input_AxisEvent](#input_axisevent) \*axisEvent, float displayY) | 设置轴事件的Y坐标。  | 
| [Input_Result](#input_result) [OH_Input_GetAxisEventDisplayY](#oh_input_getaxiseventdisplayy) (const [Input_AxisEvent](#input_axisevent) \*axisEvent, float \*displayY) | 获取轴事件的Y坐标。  | 
| [Input_Result](#input_result) [OH_Input_SetAxisEventAxisValue](#oh_input_setaxiseventaxisvalue) ([Input_AxisEvent](#input_axisevent) \*axisEvent, [InputEvent_AxisType](#inputevent_axistype) axisType, double axisValue) | 设置轴事件指定轴类型的轴值。  | 
| [Input_Result](#input_result) [OH_Input_GetAxisEventAxisValue](#oh_input_getaxiseventaxisvalue) (const [Input_AxisEvent](#input_axisevent) \*axisEvent, [InputEvent_AxisType](#inputevent_axistype) axisType, double \*axisValue) | 获取轴事件指定轴类型的轴值。  | 
| [Input_Result](#input_result) [OH_Input_SetAxisEventActionTime](#oh_input_setaxiseventactiontime) ([Input_AxisEvent](#input_axisevent) \*axisEvent, int64_t actionTime) | 设置轴事件发生的时间。  | 
| [Input_Result](#input_result) [OH_Input_GetAxisEventActionTime](#oh_input_getaxiseventactiontime) (const [Input_AxisEvent](#input_axisevent) \*axisEvent, int64_t \*actionTime) | 获取轴事件发生的时间。  | 
| [Input_Result](#input_result) [OH_Input_SetAxisEventType](#oh_input_setaxiseventtype) ([Input_AxisEvent](#input_axisevent) \*axisEvent, [InputEvent_AxisEventType](#inputevent_axiseventtype) axisEventType) | 设置轴事件类型。  | 
| [Input_Result](#input_result) [OH_Input_GetAxisEventType](#oh_input_getaxiseventtype) (const [Input_AxisEvent](#input_axisevent) \*axisEvent, [InputEvent_AxisEventType](#inputevent_axiseventtype) \*axisEventType) | 获取轴事件类型。  | 
| [Input_Result](#input_result) [OH_Input_SetAxisEventSourceType](#oh_input_setaxiseventsourcetype) ([Input_AxisEvent](#input_axisevent) \*axisEvent, [InputEvent_SourceType](#inputevent_sourcetype) sourceType) | 设置轴事件源类型。  | 
| [Input_Result](#input_result) [OH_Input_GetAxisEventSourceType](#oh_input_getaxiseventsourcetype) (const [Input_AxisEvent](#input_axisevent) \*axisEvent, [InputEvent_SourceType](#inputevent_sourcetype) \*sourceType) | 获取轴事件源类型。  | 
| [Input_Result](#input_result) [OH_Input_AddKeyEventMonitor](#oh_input_addkeyeventmonitor) ([Input_KeyEventCallback](#input_keyeventcallback) callback) | 添加按键事件监听。  | 
| [Input_Result](#input_result) [OH_Input_AddMouseEventMonitor](#oh_input_addmouseeventmonitor) ([Input_MouseEventCallback](#input_mouseeventcallback) callback) | 添加鼠标事件监听,包含鼠标点击，移动，不包含滚轮事件，滚轮事件归属于轴事件。  | 
| [Input_Result](#input_result) [OH_Input_AddTouchEventMonitor](#oh_input_addtoucheventmonitor) ([Input_TouchEventCallback](#input_toucheventcallback) callback) | 添加触摸事件监听。  | 
| [Input_Result](#input_result) [OH_Input_AddAxisEventMonitorForAll](#oh_input_addaxiseventmonitorforall) ([Input_AxisEventCallback](#input_axiseventcallback) callback) | 添加所有类型轴事件监听，轴事件类型定义在[InputEvent_AxisEventType](#inputevent_axiseventtype)中。  | 
| [Input_Result](#input_result) [OH_Input_AddAxisEventMonitor](#oh_input_addaxiseventmonitor) ([InputEvent_AxisEventType](#inputevent_axiseventtype) axisEventType, [Input_AxisEventCallback](#input_axiseventcallback) callback) | 添加指定类型的轴事件监听，轴事件类型定义在[InputEvent_AxisEventType](#inputevent_axiseventtype)中。  | 
| [Input_Result](#input_result) [OH_Input_RemoveKeyEventMonitor](#oh_input_removekeyeventmonitor) ([Input_KeyEventCallback](#input_keyeventcallback) callback) | 移除按键事件监听。  | 
| [Input_Result](#input_result) [OH_Input_RemoveMouseEventMonitor](#oh_input_removemouseeventmonitor) ([Input_MouseEventCallback](#input_mouseeventcallback) callback) | 移除鼠标事件监听。  | 
| [Input_Result](#input_result) [OH_Input_RemoveTouchEventMonitor](#oh_input_removetoucheventmonitor) ([Input_TouchEventCallback](#input_toucheventcallback) callback) | 移除触摸事件监听。  | 
| [Input_Result](#input_result) [OH_Input_RemoveAxisEventMonitorForAll](#oh_input_removeaxiseventmonitorforall) ([Input_AxisEventCallback](#input_axiseventcallback) callback) | 移除所有类型轴事件监听。  | 
| [Input_Result](#input_result) [OH_Input_RemoveAxisEventMonitor](#oh_input_removeaxiseventmonitor) ([InputEvent_AxisEventType](#inputevent_axiseventtype) axisEventType, [Input_AxisEventCallback](#input_axiseventcallback) callback) | 移除指定类型轴事件监听，轴事件类型定义在[InputEvent_AxisEventType](#inputevent_axiseventtype)中。  | 
| [Input_Result](#input_result) [OH_Input_AddKeyEventInterceptor](#oh_input_addkeyeventinterceptor) ([Input_KeyEventCallback](#input_keyeventcallback) callback, [Input_InterceptorOptions](#input_interceptoroptions) \*option) | 添加按键事件的拦截,重复添加只有第一次生效。  | 
| [Input_Result](#input_result) [OH_Input_AddInputEventInterceptor](#oh_input_addinputeventinterceptor) ([Input_InterceptorEventCallback](_input___interceptor_event_callback.md) \*callback [Input_InterceptorOptions](#input_interceptoroptions) \*option) | 添加输入事件拦截，包括鼠标、触摸和轴事件，重复添加只有第一次生效。  | 
| [Input_Result](#input_result) [OH_Input_RemoveKeyEventInterceptor](#oh_input_removekeyeventinterceptor) () | 移除按键事件拦截。  | 
| [Input_Result](#input_result) [OH_Input_RemoveInputEventInterceptor](#oh_input_removeinputeventinterceptor) () | 移除输入事件拦截，包括鼠标、触摸和轴事件。  | 
| int32_t [OH_Input_GetIntervalSinceLastInput](#oh_input_getintervalsincelastinput) (int64_t \*timeInterval) | 获取距离上次系统输入事件的时间间隔。  | 
| [Input_Hotkey](#input_hotkey) \* [OH_Input_CreateHotkey](#oh_input_createhotkey) () | 创建快捷键对象的实例。  | 
| void [OH_Input_DestroyHotkey](#oh_input_destroyhotkey) ([Input_Hotkey](#input_hotkey) \*\*hotkey) | 销毁快捷键对象的实例。  | 
| void [OH_Input_SetPreKeys](#oh_input_setprekeys) ([Input_Hotkey](#input_hotkey) \*hotkey, int32_t \*preKeys, int32_t size) | 设置修饰键。  | 
| [Input_Result](#input_result) [OH_Input_GetPreKeys](#oh_input_getprekeys) (const [Input_Hotkey](#input_hotkey) \*hotkey, int32_t \*\*preKeys, int32_t \*preKeyCount) | 获取修饰键。  | 
| void [OH_Input_SetFinalKey](#oh_input_setfinalkey) ([Input_Hotkey](#input_hotkey) \*hotkey, int32_t finalKey) | 设置被修饰键。  | 
| [Input_Result](#input_result) [OH_Input_GetFinalKey](#oh_input_getfinalkey) (const [Input_Hotkey](#input_hotkey) \*hotkey, int32_t \*finalKeyCode) | 获取被修饰键。  | 
| [Input_Hotkey](#input_hotkey) \*\* [OH_Input_CreateAllSystemHotkeys](#oh_input_createallsystemhotkeys) (int32_t count) | 创建[Input_Hotkey](#input_hotkey)类型实例的数组。  | 
| void [OH_Input_DestroyAllSystemHotkeys](#oh_input_destroyallsystemhotkeys) ([Input_Hotkey](#input_hotkey) \*\*hotkeys, int32_t count) | 销毁[Input_Hotkey](#input_hotkey)实例数组并回收内存。  | 
| [Input_Result](#input_result) [OH_Input_GetAllSystemHotkeys](#oh_input_getallsystemhotkeys) ([Input_Hotkey](#input_hotkey) \*\*hotkey, int32_t \*count) | 获取设置的所有快捷键。  | 
| void [OH_Input_SetRepeat](#oh_input_setrepeat) ([Input_Hotkey](#input_hotkey) \*hotkey, bool isRepeat) | 设置是否上报重复key事件。  | 
| [Input_Result](#input_result) [OH_Input_GetRepeat](#oh_input_getrepeat) (const [Input_Hotkey](#input_hotkey) \*hotkey, bool \*isRepeat) | 获取是否上报重复key事件。  | 
| [Input_Result](#input_result) [OH_Input_AddHotkeyMonitor](#oh_input_addhotkeymonitor) (const [Input_Hotkey](#input_hotkey) \*hotkey, [Input_HotkeyCallback](#input_hotkeycallback) callback) | 订阅快捷键事件。  | 
| [Input_Result](#input_result) [OH_Input_RemoveHotkeyMonitor](#oh_input_removehotkeymonitor) (const [Input_Hotkey](#input_hotkey) \*hotkey, [Input_HotkeyCallback](#input_hotkeycallback) callback) | 取消订阅快捷键。  | 
| [Input_Result](#input_result) [OH_Input_GetDeviceIds](#oh_input_getdeviceids) (int32_t \*deviceIds, int32_t inSize, int32_t \*outSize) | 获取所有输入设备的ID列表。  | 
| [Input_Result](#input_result) [OH_Input_GetDevice](#oh_input_getdevice) (int32_t deviceId, [Input_DeviceInfo](#input_deviceinfo) \*\*deviceInfo) | 获取输入设备信息。  | 
| [Input_DeviceInfo](#input_deviceinfo) \* [OH_Input_CreateDeviceInfo](#oh_input_createdeviceinfo) (void) | 创建输入设备信息的对象。  | 
| void [OH_Input_DestroyDeviceInfo](#oh_input_destroydeviceinfo) ([Input_DeviceInfo](#input_deviceinfo) \*\*deviceInfo) | 销毁输入设备信息的对象。  | 
| [Input_Result](#input_result) [OH_Input_GetKeyboardType](#oh_input_getkeyboardtype) (int32_t deviceId, int32_t \*keyboardType) | 获取输入设备的键盘类型。  | 
| [Input_Result](#input_result) [OH_Input_GetDeviceId](#oh_input_getdeviceid) ([Input_DeviceInfo](#input_deviceinfo) \*deviceInfo, int32_t \*id) | 获取输入设备的id。  | 
| [Input_Result](#input_result) [OH_Input_GetDeviceName](#oh_input_getdevicename) ([Input_DeviceInfo](#input_deviceinfo) \*deviceInfo, char \*\*name) | 获取输入设备的名称。  | 
| [Input_Result](#input_result) [OH_Input_GetCapabilities](#oh_input_getcapabilities) ([Input_DeviceInfo](#input_deviceinfo) \*deviceInfo, int32_t \*capabilities) | 获取有关输入设备能力信息，比如设备是触摸屏、触控板、键盘等。  | 
| [Input_Result](#input_result) [OH_Input_GetDeviceVersion](#oh_input_getdeviceversion) ([Input_DeviceInfo](#input_deviceinfo) \*deviceInfo, int32_t \*version) | 获取输入设备的版本信息。  | 
| [Input_Result](#input_result) [OH_Input_GetDeviceProduct](#oh_input_getdeviceproduct) ([Input_DeviceInfo](#input_deviceinfo) \*deviceInfo, int32_t \*product) | 获取输入设备的产品信息。  | 
| [Input_Result](#input_result) [OH_Input_GetDeviceVendor](#oh_input_getdevicevendor) ([Input_DeviceInfo](#input_deviceinfo) \*deviceInfo, int32_t \*vendor) | 获取输入设备的厂商信息。  | 
| [Input_Result](#input_result) [OH_Input_GetDeviceAddress](#oh_input_getdeviceaddress) ([Input_DeviceInfo](#input_deviceinfo) \*deviceInfo, char \*\*address) | 获取输入设备的物理地址。  | 
| [Input_Result](#input_result) [OH_Input_RegisterDeviceListener](#oh_input_registerdevicelistener) ([Input_DeviceListener](_input___device_listener.md) \*listener) | 注册设备热插拔的监听器。  | 
| [Input_Result](#input_result) [OH_Input_UnregisterDeviceListener](#oh_input_unregisterdevicelistener) ([Input_DeviceListener](_input___device_listener.md) \*listener) | 取消注册设备热插拔的监听。  | 
| [Input_Result](#input_result) [OH_Input_UnregisterDeviceListeners](#oh_input_unregisterdevicelisteners) () | 取消注册所有的设备热插拔的监听。  | 


## 类型定义说明


### Input_AxisEvent

```
typedef struct Input_AxisEventInput_AxisEvent
```
**描述**
轴事件。

**起始版本：** 12


### Input_AxisEventCallback

```
typedef void(* Input_AxisEventCallback) (const Input_AxisEvent *axisEvent)
```
**描述**
轴事件的回调函数，axisEvent的生命周期为回调函数内。

**起始版本：** 12

### Input_DeviceAddedCallback

```
typedef void(* Input_DeviceAddedCallback) (int32_t deviceId)
```
**描述**
回调函数，用于回调输入设备的热插事件。

**起始版本：** 13

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| deviceId | 设备的ID。  | 

### Input_DeviceInfo

```
typedef struct Input_DeviceInfoInput_DeviceInfo
```
**描述**
输入设备信息。

**起始版本：** 13

### Input_DeviceListener

```
typedef struct Input_DeviceListenerInput_DeviceListener
```
**描述**
定义一个结构体用于监听设备热插拔。

**起始版本：** 13

### Input_DeviceRemovedCallback

```
typedef void(* Input_DeviceRemovedCallback) (int32_t deviceId)
```
**描述**
回调函数，用于回调输入设备的热拔事件。

**起始版本：** 13

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| deviceId | 设备的ID。  | 


### Input_Hotkey

```
typedef struct Input_Hotkey Input_Hotkey
```
**描述**
定义快捷键结构体。

**起始版本：** 14


### Input_HotkeyCallback

```
typedef void(* Input_HotkeyCallback) (Input_Hotkey *hotkey)
```
**描述**
回调函数，用于回调快捷键事件。

**起始版本：** 14


### Input_InterceptorEventCallback

```
typedef struct Input_InterceptorEventCallbackInput_InterceptorEventCallback
```
**描述**
拦截回调事件结构体，拦截鼠标事件、触摸事件和轴事件。

**起始版本：** 12


### Input_InterceptorOptions

```
typedef struct Input_InterceptorOptionsInput_InterceptorOptions
```
**描述**
事件拦截选项。

**起始版本：** 12


### Input_KeyboardType

```
typedef enum Input_KeyboardTypeInput_KeyboardType
```
**描述**
输入设备的键盘类型。

**起始版本：** 13


### Input_KeyEvent

```
typedef struct Input_KeyEventInput_KeyEvent
```
**描述**
要注入的按键事件。

**起始版本：** 12


### Input_KeyEventAction

```
typedef enum Input_KeyEventActionInput_KeyEventAction
```
**描述**
按键事件类型的枚举值。

**起始版本：** 12


### Input_KeyEventCallback

```
typedef void(* Input_KeyEventCallback) (const Input_KeyEvent *keyEvent)
```
**描述**
按键事件的回调函数，keyEvent的生命周期为回调函数内。

**起始版本：** 12


### Input_KeyState

```
typedef struct Input_KeyStateInput_KeyState
```
**描述**
定义按键信息，用于标识按键行为。例如，“Ctrl”按键信息包含键值和键类型。

**起始版本：** 12


### Input_KeyStateAction

```
typedef enum Input_KeyStateActionInput_KeyStateAction
```
**描述**
按键状态的枚举值。

**起始版本：** 12


### Input_MouseEvent

```
typedef struct Input_MouseEventInput_MouseEvent
```
**描述**
要注入的鼠标事件。

**起始版本：** 12

### Input_MouseEventAction

```
typedef enum Input_MouseEventActionInput_MouseEventAction
```
**描述**
鼠标动作的枚举值。

**起始版本：** 12


### Input_MouseEventButton

```
typedef enum Input_MouseEventButtonInput_MouseEventButton
```
**描述**
鼠标按键的枚举值。

**起始版本：** 12


### Input_MouseEventCallback

```
typedef void(* Input_MouseEventCallback) (const Input_MouseEvent *mouseEvent)
```
**描述**
鼠标事件的回调函数，mouseEvent的生命周期为回调函数内。

**起始版本：** 12


### Input_Result

```
typedef enum Input_ResultInput_Result
```
**描述**
错误码枚举值。

**起始版本：** 12


### Input_TouchEvent

```
typedef struct Input_TouchEventInput_TouchEvent
```
**描述**
要注入的触摸事件。

**起始版本：** 12


### Input_TouchEventAction

```
typedef enum Input_TouchEventActionInput_TouchEventAction
```
**描述**
触摸动作的枚举值。

**起始版本：** 12


### Input_TouchEventCallback

```
typedef void(* Input_TouchEventCallback) (const Input_TouchEvent *touchEvent)
```
**描述**
触摸事件的回调函数，touchEvent的生命周期为回调函数内。

**起始版本：** 12


### InputEvent_AxisAction

```
typedef enum InputEvent_AxisActionInputEvent_AxisAction
```
**描述**
轴事件动作。

**起始版本：** 12


### InputEvent_AxisEventType

```
typedef enum InputEvent_AxisEventTypeInputEvent_AxisEventType
```
**描述**
输入设备的轴事件类型。

**起始版本：** 12


### InputEvent_AxisType

```
typedef enum InputEvent_AxisTypeInputEvent_AxisType
```
**描述**
输入设备的轴类型。

**起始版本：** 12


### InputEvent_MouseAxis

```
typedef enum InputEvent_MouseAxisInputEvent_MouseAxis
```
**描述**
鼠标轴事件类型。

**起始版本：** 12


### InputEvent_SourceType

```
typedef enum InputEvent_SourceTypeInputEvent_SourceType
```
**描述**
输入事件源类型。

**起始版本：** 12


## 枚举类型说明


### Input_KeyboardType

```
enum Input_KeyboardType
```
**描述**
输入设备的键盘类型。

**起始版本：** 13

| 枚举值 | 描述 | 
| -------- | -------- |
| KEYBOARD_TYPE_NONE  | 表示无按键设备。&nbsp;&nbsp; | 
| KEYBOARD_TYPE_UNKNOWN  | 表示未知按键设备。&nbsp;&nbsp; | 
| KEYBOARD_TYPE_ALPHABETIC  | 表示全键盘设备。&nbsp;&nbsp; | 
| KEYBOARD_TYPE_DIGITAL  | 表示数字键盘设备。&nbsp;&nbsp; | 
| KEYBOARD_TYPE_STYLUS  | 表示手写笔设备。&nbsp;&nbsp; | 
| KEYBOARD_TYPE_REMOTE_CONTROL  | 表示遥控器设备。&nbsp;&nbsp; | 


### Input_KeyCode

```
enum Input_KeyCode
```
**描述**
键码值。

**起始版本：** 12

| 枚举值 | 描述 | 
| -------- | -------- |
| KEYCODE_UNKNOWN  | 未知按键&nbsp;&nbsp; | 
| KEYCODE_FN  | 功能（Fn）键&nbsp;&nbsp; | 
| KEYCODE_VOLUME_UP  | 音量增加键&nbsp;&nbsp; | 
| KEYCODE_VOLUME_DOWN  | 音量减小键&nbsp;&nbsp; | 
| KEYCODE_POWER  | 电源键&nbsp;&nbsp; | 
| KEYCODE_CAMERA  | 拍照键&nbsp;&nbsp; | 
| KEYCODE_VOLUME_MUTE  | 扬声器静音键&nbsp;&nbsp; | 
| KEYCODE_MUTE  | 话筒静音键&nbsp;&nbsp; | 
| KEYCODE_BRIGHTNESS_UP  | 亮度调节按键：调亮&nbsp;&nbsp; | 
| KEYCODE_BRIGHTNESS_DOWN  | 亮度调节按键：调暗&nbsp;&nbsp; | 
| KEYCODE_0  | 按键'0'&nbsp;&nbsp; | 
| KEYCODE_1  | 按键'1'&nbsp;&nbsp; | 
| KEYCODE_2  | 按键'2'&nbsp;&nbsp; | 
| KEYCODE_3  | 按键'3'&nbsp;&nbsp; | 
| KEYCODE_4  | 按键'4'&nbsp;&nbsp; | 
| KEYCODE_5  | 按键'5'&nbsp;&nbsp; | 
| KEYCODE_6  | 按键'6'&nbsp;&nbsp; | 
| KEYCODE_7  | 按键'7'&nbsp;&nbsp; | 
| KEYCODE_8  | 按键'8'&nbsp;&nbsp; | 
| KEYCODE_9  | 按键'9'&nbsp;&nbsp; | 
| KEYCODE_STAR  | 按键'\*'&nbsp;&nbsp; | 
| KEYCODE_POUND  | 按键'\#'&nbsp;&nbsp; | 
| KEYCODE_DPAD_UP  | 导航键：向上&nbsp;&nbsp; | 
| KEYCODE_DPAD_DOWN  | 导航键：向下&nbsp;&nbsp; | 
| KEYCODE_DPAD_LEFT  | 导航键：向左&nbsp;&nbsp; | 
| KEYCODE_DPAD_RIGHT  | 导航键：向右&nbsp;&nbsp; | 
| KEYCODE_DPAD_CENTER  | 导航键：确定键&nbsp;&nbsp; | 
| KEYCODE_A  | 按键'A'&nbsp;&nbsp; | 
| KEYCODE_B  | 按键'B'&nbsp;&nbsp; | 
| KEYCODE_C  | 按键'C'&nbsp;&nbsp; | 
| KEYCODE_D  | 按键'D'&nbsp;&nbsp; | 
| KEYCODE_E  | 按键'E'&nbsp;&nbsp; | 
| KEYCODE_F  | 按键'F'&nbsp;&nbsp; | 
| KEYCODE_G  | 按键'G'&nbsp;&nbsp; | 
| KEYCODE_H  | 按键'H'&nbsp;&nbsp; | 
| KEYCODE_I  | 按键'I'&nbsp;&nbsp; | 
| KEYCODE_J  | 按键'J'&nbsp;&nbsp; | 
| KEYCODE_K  | 按键'K'&nbsp;&nbsp; | 
| KEYCODE_L  | 按键'L'&nbsp;&nbsp; | 
| KEYCODE_M  | 按键'M'&nbsp;&nbsp; | 
| KEYCODE_N  | 按键'N'&nbsp;&nbsp; | 
| KEYCODE_O  | 按键'O'&nbsp;&nbsp; | 
| KEYCODE_P  | 按键'P'&nbsp;&nbsp; | 
| KEYCODE_Q  | 按键'Q'&nbsp;&nbsp; | 
| KEYCODE_R  | 按键'R'&nbsp;&nbsp; | 
| KEYCODE_S  | 按键'S'&nbsp;&nbsp; | 
| KEYCODE_T  | 按键'T'&nbsp;&nbsp; | 
| KEYCODE_U  | 按键'U'&nbsp;&nbsp; | 
| KEYCODE_V  | 按键'V'&nbsp;&nbsp; | 
| KEYCODE_W  | 按键'W'&nbsp;&nbsp; | 
| KEYCODE_X  | 按键'X'&nbsp;&nbsp; | 
| KEYCODE_Y  | 按键'Y'&nbsp;&nbsp; | 
| KEYCODE_Z  | 按键'Z'&nbsp;&nbsp; | 
| KEYCODE_COMMA  | 按键','&nbsp;&nbsp; | 
| KEYCODE_PERIOD  | 按键'.'&nbsp;&nbsp; | 
| KEYCODE_ALT_LEFT  | å·¦Alté”®&nbsp;&nbsp; | 
| KEYCODE_ALT_RIGHT  | 右Alt键&nbsp;&nbsp; | 
| KEYCODE_SHIFT_LEFT  | å·¦Shifté”®&nbsp;&nbsp; | 
| KEYCODE_SHIFT_RIGHT  | 右Shift键&nbsp;&nbsp; | 
| KEYCODE_TAB  | Tabé”®&nbsp;&nbsp; | 
| KEYCODE_SPACE  | 空格键&nbsp;&nbsp; | 
| KEYCODE_SYM  | 符号修改器按键&nbsp;&nbsp; | 
| KEYCODE_EXPLORER  | 浏览器功能键，此键用于启动浏览器应用程序&nbsp;&nbsp; | 
| KEYCODE_ENVELOPE  | 电子邮件功能键，此键用于启动电子邮件应用程序&nbsp;&nbsp; | 
| KEYCODE_ENTER  | 回车键&nbsp;&nbsp; | 
| KEYCODE_DEL  | 退格键&nbsp;&nbsp; | 
| KEYCODE_GRAVE  | 按键'‘’&nbsp;&nbsp; | 
| KEYCODE_MINUS  | 按键'-'&nbsp;&nbsp; | 
| KEYCODE_EQUALS  | 按键'='&nbsp;&nbsp; | 
| KEYCODE_LEFT_BRACKET  | 按键'['&nbsp;&nbsp; | 
| KEYCODE_RIGHT_BRACKET  | 按键']'&nbsp;&nbsp; | 
| KEYCODE_BACKSLASH  | 按键'\'&nbsp;&nbsp; | 
| KEYCODE_SEMICOLON  | 按键';'&nbsp;&nbsp; | 
| KEYCODE_APOSTROPHE  | 按键''' (单引号)&nbsp;&nbsp; | 
| KEYCODE_SLASH  | 按键'/'&nbsp;&nbsp; | 
| KEYCODE_AT  | 按键'\@'&nbsp;&nbsp; | 
| KEYCODE_PLUS  | 按键'+'&nbsp;&nbsp; | 
| KEYCODE_MENU  | 菜单键&nbsp;&nbsp; | 
| KEYCODE_PAGE_UP  | 向上翻页键&nbsp;&nbsp; | 
| KEYCODE_PAGE_DOWN  | 向下翻页键&nbsp;&nbsp; | 
| KEYCODE_ESCAPE  | ESCé”®&nbsp;&nbsp; | 
| KEYCODE_FORWARD_DEL  | 删除键&nbsp;&nbsp; | 
| KEYCODE_CTRL_LEFT  | å·¦Ctrlé”®&nbsp;&nbsp; | 
| KEYCODE_CTRL_RIGHT  | 右Ctrl键&nbsp;&nbsp; | 
| KEYCODE_CAPS_LOCK  | 大写锁定键&nbsp;&nbsp; | 
| KEYCODE_SCROLL_LOCK  | 滚动锁定键&nbsp;&nbsp; | 
| KEYCODE_META_LEFT  | 左元修改器键&nbsp;&nbsp; | 
| KEYCODE_META_RIGHT  | 右元修改器键&nbsp;&nbsp; | 
| KEYCODE_FUNCTION  | 功能键&nbsp;&nbsp; | 
| KEYCODE_SYSRQ  | 系统请求/打印屏幕键&nbsp;&nbsp; | 
| KEYCODE_BREAK  | Break/Pauseé”®&nbsp;&nbsp; | 
| KEYCODE_MOVE_HOME  | 光标移动到开始键&nbsp;&nbsp; | 
| KEYCODE_MOVE_END  | 光标移动到末尾键&nbsp;&nbsp; | 
| KEYCODE_INSERT  | 插入键&nbsp;&nbsp; | 
| KEYCODE_FORWARD  | 前进键&nbsp;&nbsp; | 
| KEYCODE_MEDIA_PLAY  | 多媒体键：播放&nbsp;&nbsp; | 
| KEYCODE_MEDIA_PAUSE  | 多媒体键：暂停&nbsp;&nbsp; | 
| KEYCODE_MEDIA_CLOSE  | 多媒体键：关闭&nbsp;&nbsp; | 
| KEYCODE_MEDIA_EJECT  | 多媒体键：弹出&nbsp;&nbsp; | 
| KEYCODE_MEDIA_RECORD  | 多媒体键：录音&nbsp;&nbsp; | 
| KEYCODE_F1  | 按键'F1'&nbsp;&nbsp; | 
| KEYCODE_F2  | 按键'F2'&nbsp;&nbsp; | 
| KEYCODE_F3  | 按键'F3'&nbsp;&nbsp; | 
| KEYCODE_F4  | 按键'F4'&nbsp;&nbsp; | 
| KEYCODE_F5  | 按键'F5'&nbsp;&nbsp; | 
| KEYCODE_F6  | 按键'F6'&nbsp;&nbsp; | 
| KEYCODE_F7  | 按键'F7'&nbsp;&nbsp; | 
| KEYCODE_F8  | 按键'F8'&nbsp;&nbsp; | 
| KEYCODE_F9  | 按键'F9'&nbsp;&nbsp; | 
| KEYCODE_F10  | 按键'F10'&nbsp;&nbsp; | 
| KEYCODE_F11  | 按键'F11'&nbsp;&nbsp; | 
| KEYCODE_F12  | 按键'F12'&nbsp;&nbsp; | 
| KEYCODE_NUM_LOCK  | 小键盘锁&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_0  | 小键盘按键'0'&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_1  | 小键盘按键'1'&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_2  | 小键盘按键'2'&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_3  | 小键盘按键'3'&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_4  | 小键盘按键'4'&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_5  | 小键盘按键'5'&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_6  | 小键盘按键'6'&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_7  | 小键盘按键'7'&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_8  | 小键盘按键'8'&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_9  | 小键盘按键'9'&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_DIVIDE  | 小键盘按键'/'&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_MULTIPLY  | 小键盘按键'\*'&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_SUBTRACT  | 小键盘按键'-'&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_ADD  | 小键盘按键'+'&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_DOT  | 小键盘按键'.'&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_COMMA  | 小键盘按键','&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_ENTER  | 小键盘按键回车&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_EQUALS  | 小键盘按键'='&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_LEFT_PAREN  | 小键盘按键'('&nbsp;&nbsp; | 
| KEYCODE_NUMPAD_RIGHT_PAREN  | 小键盘按键')'&nbsp;&nbsp; | 


### Input_KeyEventAction

```
enum Input_KeyEventAction
```
**描述**
按键事件类型的枚举值。

**起始版本：** 12

| 枚举值 | 描述 | 
| -------- | -------- |
| KEY_ACTION_CANCEL  | 按键动作取消。| 
| KEY_ACTION_DOWN  | 按键按下。 | 
| KEY_ACTION_UP  | 按键抬起。 | 


### Input_KeyStateAction

```
enum Input_KeyStateAction
```
**描述**
按键状态的枚举值。

**起始版本：** 12

| 枚举值 | 描述 | 
| -------- | -------- |
| KEY_DEFAULT  | 默认状态。 | 
| KEY_PRESSED  | 按键按下。 | 
| KEY_RELEASED  | 按键抬起。 | 
| KEY_SWITCH_ON  | 按键开关使能。 | 
| KEY_SWITCH_OFF  | 按键开关去使能。 | 


### Input_MouseEventAction

```
enum Input_MouseEventAction
```
**描述**
鼠标动作的枚举值。

**起始版本：** 12

| 枚举值 | 描述 | 
| -------- | -------- |
| MOUSE_ACTION_CANCEL  | 取消鼠标动作。 | 
| MOUSE_ACTION_MOVE  | 移动鼠标。 | 
| MOUSE_ACTION_BUTTON_DOWN  | 按下鼠标。| 
| MOUSE_ACTION_BUTTON_UP  | 抬起鼠标按键。 | 
| MOUSE_ACTION_AXIS_BEGIN  | 鼠标轴事件开始。 | 
| MOUSE_ACTION_AXIS_UPDATE  | 更新鼠标轴事件。 | 
| MOUSE_ACTION_AXIS_END  | 鼠标轴事件结束。 | 


### Input_MouseEventButton

```
enum Input_MouseEventButton
```
**描述**
鼠标按键的枚举值。

**起始版本：** 12

| 枚举值 | 描述 | 
| -------- | -------- |
| MOUSE_BUTTON_NONE  | 无效按键&nbsp;&nbsp; | 
| MOUSE_BUTTON_LEFT  | 鼠标左键&nbsp;&nbsp; | 
| MOUSE_BUTTON_MIDDLE  | 鼠标中间键&nbsp;&nbsp; | 
| MOUSE_BUTTON_RIGHT  | 鼠标右键&nbsp;&nbsp; | 
| MOUSE_BUTTON_FORWARD  | 鼠标前进键&nbsp;&nbsp; | 
| MOUSE_BUTTON_BACK  | 鼠标返回键&nbsp;&nbsp; | 


### Input_Result

```
enum Input_Result
```
**描述**
错误码枚举值。

**起始版本：** 12

| 枚举值 | 描述 | 
| -------- | -------- |
| INPUT_SUCCESS  | 操作成功&nbsp;&nbsp; | 
| INPUT_PERMISSION_DENIED  | 权限验证失败&nbsp;&nbsp; | 
| INPUT_NOT_SYSTEM_APPLICATION  | 非系统应用&nbsp;&nbsp; | 
| INPUT_PARAMETER_ERROR  | 参数检查失败&nbsp;&nbsp; | 
| INPUT_SERVICE_EXCEPTION  | 服务异常&nbsp;&nbsp; | 
| INPUT_REPEAT_INTERCEPTOR  | 应用创建拦截后，再次执行创建拦截的操作&nbsp;&nbsp; | 
| INPUT_OCCUPIED_BY_SYSTEM  | 已经被系统应用占用，**起始版本：** 14 | 
| INPUT_OCCUPIED_BY_OTHER  | 已经被其他应用占用，**起始版本：** 14 | 


### Input_TouchEventAction

```
enum Input_TouchEventAction
```
**描述**
触摸动作的枚举值。

**起始版本：** 12

| 枚举值 | 描述 | 
| -------- | -------- |
| TOUCH_ACTION_CANCEL  | 触摸取消&nbsp;&nbsp; | 
| TOUCH_ACTION_DOWN  | 触摸按下&nbsp;&nbsp; | 
| TOUCH_ACTION_MOVE  | 触摸移动&nbsp;&nbsp; | 
| TOUCH_ACTION_UP  | 触摸抬起&nbsp;&nbsp; | 


### InputEvent_AxisAction

```
enum InputEvent_AxisAction
```
**描述**
轴事件动作。

**起始版本：** 12

| 枚举值 | 描述 | 
| -------- | -------- |
| AXIS_ACTION_CANCEL  | 取消轴输入事件。 | 
| AXIS_ACTION_BEGIN  | 开始轴输入事件。 | 
| AXIS_ACTION_UPDATE  | 轴输入事件中。| 
| AXIS_ACTION_END  | 结束轴输入事件。| 


### InputEvent_AxisEventType

```
enum InputEvent_AxisEventType
```
**描述**
输入设备的轴事件类型。

**起始版本：** 12

| 枚举值 | 描述 | 
| -------- | -------- |
| AXIS_EVENT_TYPE_PINCH  | 双指捏合事件，包含AXIS_TYPE_PINCH和AXIS_TYPE_ROTATE两种轴类型。 | 
| AXIS_EVENT_TYPE_SCROLL  | 滚轴事件，包含AXIS_TYPE_SCROLL_VERTICAL和AXIS_TYPE_SCROLL_HORIZONTAL两种轴类型， 其中鼠标滚轮事件仅包含AXIS_TYPE_SCROLL_VERTICAL一种轴类型。| 


### InputEvent_AxisType

```
enum InputEvent_AxisType
```
**描述**
输入设备的轴类型。

**起始版本：** 12

| 枚举值 | 描述 | 
| -------- | -------- |
| AXIS_TYPE_UNKNOWN  | 未知轴类型，通常作为初始值。 | 
| AXIS_TYPE_SCROLL_VERTICAL  | 垂直滚动轴，当您滚动鼠标滚轮或在触摸板上进行单指或双指滑动时，垂直滚动轴的状态改变。 | 
| AXIS_TYPE_SCROLL_HORIZONTAL  | 水平滚动轴，当您滚动鼠标滚轮或在触摸板上进行双指滑动时，水平滚动轴的状态发生变化。 | 
| AXIS_TYPE_PINCH  | 捏合轴，用于描述触摸板上的双指捏合手势。 | 
| AXIS_TYPE_ROTATE  | 旋转轴，用于描述触摸板上的双指旋转手势。 | 


### InputEvent_MouseAxis

```
enum InputEvent_MouseAxis
```
**描述**
鼠标轴事件类型。

**起始版本：** 12

| 枚举值 | 描述 | 
| -------- | -------- |
| MOUSE_AXIS_SCROLL_VERTICAL  | 垂直滚动轴&nbsp;&nbsp; | 
| MOUSE_AXIS_SCROLL_HORIZONTAL  | 水平滚动轴&nbsp;&nbsp; | 


### InputEvent_SourceType

```
enum InputEvent_SourceType
```
**描述**
输入事件源类型。

**起始版本：** 12

| 枚举值 | 描述 | 
| -------- | -------- |
| SOURCE_TYPE_MOUSE  | 表示输入源生成鼠标光标移动、按钮按下和释放以及滚轮滚动的事件。| 
| SOURCE_TYPE_TOUCHSCREEN  | 表示输入源产生触摸屏多点触摸事件。 | 
| SOURCE_TYPE_TOUCHPAD  | 表示输入源产生触摸板多点触摸事件。| 


## 函数说明


### OH_Input_AddAxisEventMonitor()

```
Input_Result OH_Input_AddAxisEventMonitor (InputEvent_AxisEventType axisEventType, Input_AxisEventCallback callback )
```
**描述**
添加指定类型的轴事件监听，轴事件类型定义在[InputEvent_AxisEventType](#inputevent_axiseventtype)中。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEventType | 要监听的轴事件类型，轴事件类型定义在[InputEvent_AxisEventType](#inputevent_axiseventtype)中。  | 
| callback | 回调函数，用于接收指定类型的轴事件  | 

**Permission：**

ohos.permission.INPUT_MONITORING

**返回：**

若添加轴事件监听成功，则返回**INTO_SUCCESS**；若权限校验失败，则返回INPUT_PERMISSION_DENIED； 若callback为空，则返回INPUT_PARAMETER_ERROR；若服务异常，则返回INPUT_SERVICE_EXCEPTION。


### OH_Input_AddAxisEventMonitorForAll()

```
Input_Result OH_Input_AddAxisEventMonitorForAll (Input_AxisEventCallback callback)
```
**描述**
添加所有类型轴事件监听，轴事件类型定义在[InputEvent_AxisEventType](#inputevent_axiseventtype)中。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| callback | 回调函数，用于接收轴事件。  | 

**Permission：**

ohos.permission.INPUT_MONITORING

**返回：**

若添加轴事件监听成功，则返回**INTO_SUCCESS**；若权限校验失败，则返回INPUT_PERMISSION_DENIED； 若callback为空，则返回INPUT_PARAMETER_ERROR；若服务异常，则返回INPUT_SERVICE_EXCEPTION。


### OH_Input_AddHotkeyMonitor()

```
Input_Result OH_Input_AddHotkeyMonitor (const Input_Hotkey * hotkey, Input_HotkeyCallback callback )
```
**描述**
订阅快捷键事件。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 14

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| hotkey | 指定要订阅的快捷键对象。  | 
| callback | 回调函数，用于回调快捷键事件。  | 

**返回：**

OH_Input_AddHotkeyMonitor 函数错误码。 

INPUT_SUCCESS 表示订阅组合按键成功。

INPUT_PARAMETER_ERROR 表示参数检查失败。

INPUT_OCCUPIED_BY_SYSTEM 该快捷键已被系统占用，可以通过接口[OH_Input_GetAllSystemHotkeys](#oh_input_getallsystemhotkeys)查询所有的系统快捷键。

INPUT_OCCUPIED_BY_OTHER 已被抢占订阅。


### OH_Input_AddInputEventInterceptor()

```
Input_Result OH_Input_AddInputEventInterceptor (Input_InterceptorEventCallback *callback Input_InterceptorOptions * option)
```
**描述**
添加输入事件拦截，包括鼠标、触摸和轴事件，重复添加只有第一次生效。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| callback | 用于回调输入事件的结构体指针，请参考定义[Input_InterceptorEventCallback](_input___interceptor_event_callback.md)。  | 
| option | 输入事件拦截的可选项，传null则使用默认值。  | 

**Permission：**

ohos.permission.INTERCEPT_INPUT_EVENT

**返回：**

若添加输入事件的拦截成功，则返回**INTO_SUCCESS**；

若权限校验失败，则返回INPUT_PERMISSION_DENIED；

若callback为空，则返回INPUT_PARAMETER_ERROR；

若重复添加拦截器，则返回INPUT_REPEAT_INTERCEPTOR；
 
若服务异常；则返回INPUT_SERVICE_EXCEPTION。


### OH_Input_AddKeyEventInterceptor()

```
Input_Result OH_Input_AddKeyEventInterceptor (Input_KeyEventCallback callback, Input_InterceptorOptions * option )
```
**描述**
添加按键事件的拦截,重复添加只有第一次生效。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| callback | 回调函数，用于接收按键事件。  | 
| option | 输入事件拦截的可选项，传null则使用默认值。  | 

**Permission：**

ohos.permission.INTERCEPT_INPUT_EVENT

**返回：**

若添加按键事件的拦截成功，则返回**INTO_SUCCESS**；

若权限校验失败，则返回INPUT_PERMISSION_DENIED； 

若callback为空，则返回INPUT_PARAMETER_ERROR；

若重复添加拦截器，则返回INPUT_REPEAT_INTERCEPTOR； 

若服务异常；则返回INPUT_SERVICE_EXCEPTION。


### OH_Input_AddKeyEventMonitor()

```
Input_Result OH_Input_AddKeyEventMonitor (Input_KeyEventCallback callback)
```
**描述**
添加按键事件监听。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| callback | 回调函数，用于接收按键事件。  | 

**Permission：**

ohos.permission.INPUT_MONITORING

**返回：**

若添加按键事件监听成功，则返回**INTO_SUCCESS**；

若权限校验失败，则返回INPUT_PERMISSION_DENIED； 

若callback为空，则返回INPUT_PARAMETER_ERROR；

若服务异常，则返回INPUT_SERVICE_EXCEPTION。


### OH_Input_AddMouseEventMonitor()

```
Input_Result OH_Input_AddMouseEventMonitor (Input_MouseEventCallback callback)
```
**描述**
添加鼠标事件监听,包含鼠标点击，移动，不包含滚轮事件，滚轮事件归属于轴事件。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| callback | 回调函数，用于接收鼠标事件。  | 

**Permission：**

ohos.permission.INPUT_MONITORING

**返回：**

若添加鼠标事件监听成功，则返回**INTO_SUCCESS**；

若权限校验失败，则返回INPUT_PERMISSION_DENIED； 

若callback为空，则返回INPUT_PARAMETER_ERROR；

若服务异常，则返回INPUT_SERVICE_EXCEPTION。


### OH_Input_AddTouchEventMonitor()

```
Input_Result OH_Input_AddTouchEventMonitor (Input_TouchEventCallback callback)
```
**描述**
添加触摸事件监听。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| callback | 回调函数，用于接收触摸事件。  | 

**Permission：**

ohos.permission.INPUT_MONITORING

**返回：**

若添加触摸事件监听成功，则返回**INTO_SUCCESS**；若权限校验失败，则返回INPUT_PERMISSION_DENIED； 若callback为空，则返回INPUT_PARAMETER_ERROR；若服务异常，则返回INPUT_SERVICE_EXCEPTION。


### OH_Input_CancelInjection()

```
void OH_Input_CancelInjection ()
```
**描述**
取消事件注入并撤销授权

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12


### OH_Input_CreateAllSystemHotkeys()

```
Input_Hotkey** OH_Input_CreateAllSystemHotkeys (int32_t count)
```
**描述**
创建[Input_Hotkey](#input_hotkey)类型实例的数组。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 14

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| count | 创建[Input_Hotkey](#input_hotkey)实例的数量。  | 

**返回：**

OH_Input_CreateAllSystemHotkey 函数错误码。 INPUT_SUCCESS 表示创建实例数组的双指针成功。


### OH_Input_CreateAxisEvent()

```
Input_AxisEvent* OH_Input_CreateAxisEvent (void )
```
**描述**
创建轴事件对象实例。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**返回：**

成功返回[Input_AxisEvent](#input_axisevent)对象实例，失败则返回null。


### OH_Input_CreateDeviceInfo()

```
Input_DeviceInfo* OH_Input_CreateDeviceInfo (void )
```
**描述**
创建输入设备信息的对象。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 13

**返回：**

如果操作成功，返回设备信息[Input_DeviceInfo](#input_deviceinfo)实例的指针。否则返回空指针，可能的原因是分配内存失败。


### OH_Input_CreateHotkey()

```
Input_Hotkey* OH_Input_CreateHotkey ()
```
**描述**
创建快捷键对象的实例。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 14

**返回：**

如果操作成功,则返回一个[Input_Hotkey](#input_hotkey)指针对象。 否则, 返回一个空指针， 可能的原因是内存分配失败。


### OH_Input_CreateKeyEvent()

```
struct Input_KeyEvent* OH_Input_CreateKeyEvent ()
```
**描述**
创建按键事件对象

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**返回：**

如果操作成功返回一个[Input_KeyEvent](#input_keyevent)指针对象 否则返回空指针。


### OH_Input_CreateKeyState()

```
struct Input_KeyState* OH_Input_CreateKeyState ()
```
**描述**
创建按键状态的枚举对象。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**返回：**

如果操作成功，返回一个[Input_KeyState](#input_keystate)指针对象， 否则返回空指针。


### OH_Input_CreateMouseEvent()

```
struct Input_MouseEvent* OH_Input_CreateMouseEvent ()
```
**描述**
创建鼠标事件对象

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**返回：**

如果操作成功返回一个[Input_MouseEvent](#input_mouseevent)指针对象 否则返回空指针。


### OH_Input_CreateTouchEvent()

```
struct Input_TouchEvent* OH_Input_CreateTouchEvent ()
```
**描述**
创建触屏事件对象

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**返回：**

如果操作成功返回一个[Input_TouchEvent](#input_touchevent)指针对象 否则返回空指针。


### OH_Input_DestroyAllSystemHotkeys()

```
void OH_Input_DestroyAllSystemHotkeys (Input_Hotkey ** hotkeys, int32_t count )
```
**描述**
销毁[Input_Hotkey](#input_hotkey)实例数组并回收内存。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 14

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| hotkeys | 指向[Input_Hotkey](#input_hotkey)实例数组的双指针。  | 
| count | 销毁[Input_Hotkey](#input_hotkey)实例的数量。  | 


### OH_Input_DestroyAxisEvent()

```
Input_Result OH_Input_DestroyAxisEvent (Input_AxisEvent ** axisEvent)
```
**描述**
销毁轴事件对象实例。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEvent | 轴事件对象实例的指针。  | 

**返回：**

若销毁成功，则返回INTO_SUCCESS；若axisEvent为NULL或者\*axisEvent为NULL，则返回INPUT_PARAMETER_ERROR。


### OH_Input_DestroyDeviceInfo()

```
void OH_Input_DestroyDeviceInfo (Input_DeviceInfo ** deviceInfo)
```
**描述**
销毁输入设备信息的对象。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 13

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| deviceInfo | 设备信息的对象。  | 


### OH_Input_DestroyHotkey()

```
void OH_Input_DestroyHotkey (Input_Hotkey ** hotkey)
```
**描述**
销毁快捷键对象的实例。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 14

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| hotkey | 快捷键对象的实例。  | 


### OH_Input_DestroyKeyEvent()

```
void OH_Input_DestroyKeyEvent (struct Input_KeyEvent ** keyEvent)
```
**描述**
销毁按键事件对象

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyEvent | 按键事件对象。  | 


### OH_Input_DestroyKeyState()

```
void OH_Input_DestroyKeyState (struct Input_KeyState ** keyState)
```
**描述**
销毁按键状态的枚举对象。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyState | 按键状态的枚举对象，具体请参考[Input_KeyStateAction](#input_keystateaction)。 | 


### OH_Input_DestroyMouseEvent()

```
void OH_Input_DestroyMouseEvent (struct Input_MouseEvent ** mouseEvent)
```
**描述**
销毁鼠标事件对象

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| mouseEvent | 鼠标事件对象。  | 


### OH_Input_DestroyTouchEvent()

```
void OH_Input_DestroyTouchEvent (struct Input_TouchEvent ** touchEvent)
```
**描述**
销毁触屏事件对象

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| touchEvent | 触屏事件对象。  | 


### OH_Input_GetAllSystemHotkeys()

```
Input_Result OH_Input_GetAllSystemHotkeys (Input_Hotkey ** hotkey, int32_t * count )
```
**描述**
获取设置的所有快捷键。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 14

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| hotkey | 返回[Input_Hotkey](#input_hotkey) 类型实例数组。首次调用可传入NULL，可获取数组长度。  | 
| count | 返回支持快捷键的个数。  | 

**返回：**

OH_Input_GetAllSystemHotkeys 函数错误码。 

若获取成功，返回INPUT_SUCCESS；若获取失败，返回INPUT_PARAMETER_ERROR。


### OH_Input_GetAxisEventAction()

```
Input_Result OH_Input_GetAxisEventAction (const Input_AxisEvent * axisEvent, InputEvent_AxisAction * action )
```
**描述**
获取轴事件的动作。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEvent | 轴事件对象。  | 
| action | 出参，返回轴事件动作，具体请参考在[InputEvent_AxisAction](#inputevent_axisaction)。  | 

**返回：**

若获取轴事件的动作成功，则返回**INTO_SUCCESS**；若axisEvent或者action为NULL，则返回INPUT_PARAMETER_ERROR。

### OH_Input_GetAxisEventActionTime()

```
Input_Result OH_Input_GetAxisEventActionTime (const Input_AxisEvent * axisEvent, int64_t * actionTime )
```
**描述**
获取轴事件发生的时间。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEvent | 轴事件对象，请参考[Input_AxisEvent](#input_axisevent)。  | 
| actionTime | 出参，返回轴事件发生的时间。  | 

**返回：**

若获取轴事件发生的时间成功，则返回**INTO_SUCCESS**；若axisEvent或者actionTime为NULL，则返回INPUT_PARAMETER_ERROR。


### OH_Input_GetAxisEventAxisValue()

```
Input_Result OH_Input_GetAxisEventAxisValue (const Input_AxisEvent * axisEvent, InputEvent_AxisType axisType, double * axisValue )
```
**描述**
获取轴事件指定轴类型的轴值。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEvent | 轴事件对象，请参考[Input_AxisEvent](#input_axisevent)。  | 
| axisType | 轴类型，具体请参考[InputEvent_AxisType](#inputevent_axistype)。  | 
| axisValue | 出参，返回轴事件轴值。  | 

**返回：**

若获取轴事件指定轴类型的轴值成功，则返回**INTO_SUCCESS**；若axisEvent或者axisValue为NULL，则返回INPUT_PARAMETER_ERROR。


### OH_Input_GetAxisEventDisplayX()

```
Input_Result OH_Input_GetAxisEventDisplayX (const Input_AxisEvent * axisEvent, float * displayX )
```
**描述**
获取轴事件的X坐标。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEvent | 轴事件对象。  | 
| displayX | 出参，返回轴事件X坐标。  | 

**返回：**

若获取轴事件的X坐标成功，则返回**INTO_SUCCESS**；若axisEvent或者displayX为NULL，则返回INPUT_PARAMETER_ERROR。


### OH_Input_GetAxisEventDisplayY()

```
Input_Result OH_Input_GetAxisEventDisplayY (const Input_AxisEvent * axisEvent, float * displayY )
```
**描述**
获取轴事件的Y坐标。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEvent | 轴事件对象，请参考[Input_AxisEvent](#input_axisevent)。  | 
| displayY | 出参，返回轴事件Y坐标。  | 

**返回：**

若获取轴事件的Y坐标成功，则返回**INTO_SUCCESS**；若axisEvent或者displayY为NULL，则返回INPUT_PARAMETER_ERROR。


### OH_Input_GetAxisEventSourceType()

```
Input_Result OH_Input_GetAxisEventSourceType (const Input_AxisEvent * axisEvent, InputEvent_SourceType * sourceType )
```
**描述**
获取轴事件源类型。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEvent | 轴事件对象。  | 
| sourceType | 出参，返回轴事件源类型，具体请参考[InputEvent_SourceType](#inputevent_sourcetype)。  | 

**返回：**

若获取轴事件源类型成功，则返回**INTO_SUCCESS**；若axisEvent或者sourceType为NULL，则返回INPUT_PARAMETER_ERROR。


### OH_Input_GetAxisEventType()

```
Input_Result OH_Input_GetAxisEventType (const Input_AxisEvent * axisEvent, InputEvent_AxisEventType * axisEventType )
```
**描述**
获取轴事件类型。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEvent | 轴事件对象。  | 
| axisEventType | 出参，返回轴事件类型，具体请参考[InputEvent_AxisEventType](#inputevent_axiseventtype)。  | 

**返回：**

若获取轴事件类型成功，则返回**INTO_SUCCESS**；若axisEvent或者axisEventType为NULL，则返回INPUT_PARAMETER_ERROR。


### OH_Input_GetCapabilities()

```
Input_Result OH_Input_GetCapabilities (Input_DeviceInfo * deviceInfo, int32_t * capabilities )
```
**描述**
获取有关输入设备能力信息，比如设备是触摸屏、触控板、键盘等。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 13

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| deviceInfo | 输入设备信息[Input_DeviceInfo](#input_deviceinfo)。  | 
| capabilities | 指向输入设备能力信息的指针。  | 

**返回：**

INPUT_SUCCESS 表示操作成功。 INPUT_PARAMETER_ERROR 表示deviceInfo或者capabilities是空指针。


### OH_Input_GetDevice()

```
Input_Result OH_Input_GetDevice (int32_t deviceId, Input_DeviceInfo ** deviceInfo )
```
**描述**
获取输入设备信息。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 13

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| deviceId | 设备ID。  | 
| deviceInfo | 指向输入设备信息[Input_DeviceInfo](#input_deviceinfo)的指针。  | 

**返回：**

INPUT_SUCCESS 表示操作成功。 

INPUT_PARAMETER_ERROR 表示deviceInfo为空指针或deviceId无效，可以通过 [OH_Input_GetDeviceIds](#oh_input_getdeviceids) 表示接口查询系统支持的设备ID。


### OH_Input_GetDeviceAddress()

```
Input_Result OH_Input_GetDeviceAddress (Input_DeviceInfo * deviceInfo, char ** address )
```
**描述**
获取输入设备的物理地址。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 13

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| deviceInfo | 输入设备信息[Input_DeviceInfo](#input_deviceinfo)。  | 
| address | 指向输入设备物理地址的指针。  | 

**返回：**

INPUT_SUCCESS 表示操作成功。 INPUT_PARAMETER_ERROR 表示deviceInfo或者address是空指针。


### OH_Input_GetDeviceId()

```
Input_Result OH_Input_GetDeviceId (Input_DeviceInfo * deviceInfo, int32_t * id )
```
**描述**
获取输入设备的id。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 13

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| deviceInfo | 输入设备信息[Input_DeviceInfo](#input_deviceinfo)。  | 
| id | 指向输入设备ID的指针。  | 

**返回：**

INPUT_SUCCESS 表示操作成功。 INPUT_PARAMETER_ERROR 表示deviceInfo或者id是空指针。


### OH_Input_GetDeviceIds()

```
Input_Result OH_Input_GetDeviceIds (int32_t * deviceIds, int32_t inSize, int32_t * outSize )
```
**描述**
获取所有输入设备的ID列表。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 13

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| deviceIds | 保存输入设备ID的列表。  | 
| inSize | 保存输入设备ID列表的大小。  | 
| outSize | 输出输入设备ID列表的长度，值小于等于inSize长度。  | 

**返回：**

INPUT_SUCCESS 表示操作成功。 INPUT_PARAMETER_ERROR 表示deviceIds或outSize为空指针或inSize小于0。


### OH_Input_GetDeviceName()

```
Input_Result OH_Input_GetDeviceName (Input_DeviceInfo * deviceInfo, char ** name )
```
**描述**
获取输入设备的名称。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 13

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| deviceInfo | 输入设备信息[Input_DeviceInfo](#input_deviceinfo)。  | 
| name | 指向输入设备名称的指针。  | 

**返回：**

INPUT_SUCCESS 表示操作成功。 INPUT_PARAMETER_ERROR 表示deviceInfo或者name是空指针。


### OH_Input_GetDeviceProduct()

```
Input_Result OH_Input_GetDeviceProduct (Input_DeviceInfo * deviceInfo, int32_t * product )
```
**描述**
获取输入设备的产品信息。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 13

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| deviceInfo | 输入设备信息[Input_DeviceInfo](#input_deviceinfo)。  | 
| product | 指向输入设备产品信息的指针。  | 

**返回：**

INPUT_SUCCESS 表示操作成功。 INPUT_PARAMETER_ERROR 表示deviceInfo或者product是空指针。


### OH_Input_GetDeviceVendor()

```
Input_Result OH_Input_GetDeviceVendor (Input_DeviceInfo * deviceInfo, int32_t * vendor )
```
**描述**
获取输入设备的厂商信息。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 13

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| deviceInfo | 输入设备信息[Input_DeviceInfo](#input_deviceinfo)。  | 
| vendor | 指向输入设备厂商信息的指针。  | 

**返回：**

INPUT_SUCCESS 表示操作成功。 INPUT_PARAMETER_ERROR 表示deviceInfo或者vendor是空指针。


### OH_Input_GetDeviceVersion()

```
Input_Result OH_Input_GetDeviceVersion (Input_DeviceInfo * deviceInfo, int32_t * version )
```
**描述**
获取输入设备的版本信息。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 13

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| deviceInfo | 输入设备信息[Input_DeviceInfo](#input_deviceinfo)。  | 
| version | 指向输入设备版本信息的指针。  | 

**返回：**

INPUT_SUCCESS 表示操作成功。 INPUT_PARAMETER_ERROR 表示deviceInfo或者version是空指针。


### OH_Input_GetFinalKey()

```
Input_Result OH_Input_GetFinalKey (const Input_Hotkey * hotkey, int32_t * finalKeyCode )
```
**描述**
获取被修饰键。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 14

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| hotkey | 快捷键对象的实例。  | 
| finalKeyCode | 返回被修饰键键值。  | 

**返回：**

OH_Input_GetfinalKey 函数错误码。 若获取成功，返回INPUT_SUCCESS；

若获取失败，返回INPUT_PARAMETER_ERROR。


### OH_Input_GetIntervalSinceLastInput()

```
int32_t OH_Input_GetIntervalSinceLastInput (int64_t * timeInterval)
```
**描述**
获取距离上次系统输入事件的时间间隔。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 14

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| timeInterval | 时间间隔，单位为微秒。  | 

**返回：**

OH_Input_GetIntervalSinceLastInput 函数错误码。 

若获取时间间隔成功，则返回INPUT_SUCCESS； 若获取失败，返回INPUT_SERVICE_EXCEPTION。


### OH_Input_GetKeyboardType()

```
Input_Result OH_Input_GetKeyboardType (int32_t deviceId, int32_t * keyboardType )
```
**描述**
获取输入设备的键盘类型。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 13

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| deviceId | 设备ID。  | 
| keyboardType | 指向输入设备的键盘指针。  | 

**返回：**

INPUT_SUCCESS 表示操作成功。 INPUT_PARAMETER_ERROR 表示设备ID为无效值或者keyboardType是空指针。


### OH_Input_GetKeyCode()

```
int32_t OH_Input_GetKeyCode (const struct Input_KeyState * keyState)
```
**描述**
获取按键状态对象的键值。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyState | 按键状态的枚举对象，具体请参考[Input_KeyStateAction](#input_keystateaction)。 | 

**返回：**

返回按键状态对象的键值。


### OH_Input_GetKeyEventAction()

```
int32_t OH_Input_GetKeyEventAction (const struct Input_KeyEvent * keyEvent)
```
**描述**
获取按键事件类型

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyEvent | 按键事件对象。 | 

**返回：**

返回按键事件类型


### OH_Input_GetKeyEventActionTime()

```
int64_t OH_Input_GetKeyEventActionTime (const struct Input_KeyEvent * keyEvent)
```
**描述**
获取按键事件发生的时间

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyEvent | 按键事件对象。  | 

**返回：**

返回按键事件发生的时间。


### OH_Input_GetKeyEventKeyCode()

```
int32_t OH_Input_GetKeyEventKeyCode (const struct Input_KeyEvent * keyEvent)
```
**描述**
获取按键事件的键值。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyEvent | 按键事件对象。  | 

**返回：**

Key code.


### OH_Input_GetKeyPressed()

```
int32_t OH_Input_GetKeyPressed (const struct Input_KeyState * keyState)
```
**描述**
获取按键状态对象的按键是否按下。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyState | 按键状态的枚举对象，具体请参考[Input_KeyStateAction](#input_keystateaction)。 | 

**返回：**

返回按键状态对象的按键按下状态。


### OH_Input_GetKeyState()

```
Input_Result OH_Input_GetKeyState (struct Input_KeyState * keyState)
```
**描述**
查询按键状态的枚举对象。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyState | 按键状态的枚举对象，具体请参考[Input_KeyStateAction](#input_keystateaction)。 | 

**返回：**

如果操作成功，

返回Input_Result#INPUT_SUCCESS; 否则返回[Input_Result](#input_result)中定义的其他错误代码。


### OH_Input_GetKeySwitch()

```
int32_t OH_Input_GetKeySwitch (const struct Input_KeyState * keyState)
```
**描述**
获取按键状态对象的按键开关。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyState | 按键状态的枚举对象，具体请参考[Input_KeyStateAction](#input_keystateaction)。 | 

**返回：**

返回按键状态对象的按键开关。


### OH_Input_GetMouseEventAction()

```
int32_t OH_Input_GetMouseEventAction (const struct Input_MouseEvent * mouseEvent)
```
**描述**
获取鼠标事件的动作

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| mouseEvent | 鼠标事件对象。  | 

**返回：**

鼠标的动作


### OH_Input_GetMouseEventActionTime()

```
int64_t OH_Input_GetMouseEventActionTime (const struct Input_MouseEvent * mouseEvent)
```
**描述**
获取鼠标事件发生的时间。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyEvent | 鼠标事件对象。  | 

**返回：**

返回鼠标事件发生的时间。


### OH_Input_GetMouseEventAxisType()

```
int32_t OH_Input_GetMouseEventAxisType (const struct Input_MouseEvent * mouseEvent)
```
**描述**
获取鼠标轴事件的类型。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| mouseEvent | 鼠标事件对象。  | 

**返回：**

轴类型


### OH_Input_GetMouseEventAxisValue()

```
float OH_Input_GetMouseEventAxisValue (const struct Input_MouseEvent * mouseEvent)
```
**描述**
获取鼠标轴事件的值

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| mouseEvent | 鼠标事件对象。  | 

**返回：**

轴事件的值。


### OH_Input_GetMouseEventButton()

```
int32_t OH_Input_GetMouseEventButton (const struct Input_MouseEvent * mouseEvent)
```
**描述**
获取鼠标事件的按键。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| mouseEvent | 鼠标事件对象。  | 

**返回：**

鼠标按键。


### OH_Input_GetMouseEventDisplayX()

```
int32_t OH_Input_GetMouseEventDisplayX (const struct Input_MouseEvent * mouseEvent)
```
**描述**
获取鼠标事件的屏幕X坐标。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| mouseEvent | 鼠标事件对象。  | 

**返回：**

屏幕X坐标


### OH_Input_GetMouseEventDisplayY()

```
int32_t OH_Input_GetMouseEventDisplayY (const struct Input_MouseEvent * mouseEvent)
```
**描述**
获取鼠标事件的屏幕Y坐标。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| mouseEvent | 鼠标事件对象。  | 

**返回：**

屏幕Y坐标。


### OH_Input_GetPreKeys()

```
Input_Result OH_Input_GetPreKeys (const Input_Hotkey * hotkey, int32_t ** preKeys, int32_t * preKeyCount )
```
**描述**
获取修饰键。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 14

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| hotkey | 快捷键对象的实例。  | 
| preKeys | 返回修饰键列表。  | 
| preKeyCount | 返回修饰键个数。  | 

**返回：**

OH_Input_GetpressedKeys 函数错误码。 若获取成功，返回INPUT_SUCCESS；

若获取失败，返回INPUT_PARAMETER_ERROR。

### OH_Input_GetRepeat()

```
Input_Result OH_Input_GetRepeat (const Input_Hotkey * hotkey, bool * isRepeat )
```
**描述**
获取是否上报重复key事件。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 14

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| hotkey | 快捷键对象的实例。  | 
| isRepeat | 返回Key事件是否重复。  | 

**返回：**

OH_Input_GetIsRepeat 函数错误码。 若获取成功，返回INPUT_SUCCESS；

若获取失败，返回INPUT_PARAMETER_ERROR。

### OH_Input_GetTouchEventAction()

```
int32_t OH_Input_GetTouchEventAction (const struct Input_TouchEvent * touchEvent)
```
**描述**
获取触屏事件的动作。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| touchEvent | 触屏事件对象。  | 

**返回：**

触屏的动作。


### OH_Input_GetTouchEventActionTime()

```
int64_t OH_Input_GetTouchEventActionTime (const struct Input_TouchEvent * touchEvent)
```
**描述**
获取触摸事件发生的时间。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyEvent | 触屏事件对象。  | 

**返回：**

返回触摸事件发生的时间。


### OH_Input_GetTouchEventDisplayX()

```
int32_t OH_Input_GetTouchEventDisplayX (const struct Input_TouchEvent * touchEvent)
```
**描述**
获取触屏事件的屏幕X坐标。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| touchEvent | 触屏事件对象。  | 

**返回：**

触屏的屏幕X坐标。


### OH_Input_GetTouchEventDisplayY()

```
int32_t OH_Input_GetTouchEventDisplayY (const struct Input_TouchEvent * touchEvent)
```
**描述**
获取触屏事件的屏幕Y坐标。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| touchEvent | 触屏事件对象。  | 

**返回：**

触屏的屏幕Y坐标。


### OH_Input_GetTouchEventFingerId()

```
int32_t OH_Input_GetTouchEventFingerId (const struct Input_TouchEvent * touchEvent)
```
**描述**
获取触屏事件的手指ID。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| touchEvent | 触屏事件对象。  | 

**返回：**

触屏的手指ID。


### OH_Input_InjectKeyEvent()

```
int32_t OH_Input_InjectKeyEvent (const struct Input_KeyEvent * keyEvent)
```
**描述**
注入按键事件。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyEvent | 要注入的按键事件。  | 

**返回：**

0表示成功，201表示缺少权限，401表示参数错误。


### OH_Input_InjectMouseEvent()

```
int32_t OH_Input_InjectMouseEvent (const struct Input_MouseEvent * mouseEvent)
```
**描述**
注入鼠标事件

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| mouseEvent |  要注入的鼠标事件。  | 

**返回：**

0表示成功，201表示缺少权限，401表示参数错误。


### OH_Input_InjectTouchEvent()

```
int32_t OH_Input_InjectTouchEvent (const struct Input_TouchEvent * touchEvent)
```
**描述**
注入触摸事件。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| touchEvent | 要注入的触摸事件。  | 

**返回：**

0表示成功，201表示缺少权限，401表示参数错误。

### OH_Input_RegisterDeviceListener()

```
Input_Result OH_Input_RegisterDeviceListener (Input_DeviceListener * listener)
```
**描述**
注册设备热插拔的监听器。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 13

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| listener | 指向设备热插拔监听器[Input_DeviceListener](_input___device_listener.md)的指针。  | 

**返回：**

OH_Input_RegisterDeviceListener 的返回值。 

INPUT_SUCCESS 表示注册成功，INPUT_PARAMETER_ERROR 表示listener 为NULL。

### OH_Input_RemoveAxisEventMonitor()

```
Input_Result OH_Input_RemoveAxisEventMonitor (InputEvent_AxisEventType axisEventType, Input_AxisEventCallback callback )
```
**描述**
移除指定类型轴事件监听，轴事件类型定义在[InputEvent_AxisEventType](#inputevent_axiseventtype)中。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEventType | 指定要移除监听的轴事件类型，轴事件类型定义在[InputEvent_AxisEventType](#inputevent_axiseventtype)中。  | 
| callback | 指定要被移除的用于指定类型轴事件监听的回调函数。  | 

**Permission：**

ohos.permission.INPUT_MONITORING

**返回：**

若移除轴事件监听成功，则返回**INTO_SUCCESS**；若权限校验失败，则返回INPUT_PERMISSION_DENIED； 若callback为空或者没有被添加监听，则返回INPUT_PARAMETER_ERROR；若服务异常，则返回INPUT_SERVICE_EXCEPTION。


### OH_Input_RemoveAxisEventMonitorForAll()

```
Input_Result OH_Input_RemoveAxisEventMonitorForAll (Input_AxisEventCallback callback)
```
**描述**
移除所有类型轴事件监听。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| callback | 指定要被移除的用于所有类型轴事件监听的回调函数。  | 

**Permission：**

ohos.permission.INPUT_MONITORING

**返回：**

若移除轴事件监听成功，则返回**INTO_SUCCESS**；若权限校验失败，则返回INPUT_PERMISSION_DENIED； 若callback为空或者没有被添加监听，则返回INPUT_PARAMETER_ERROR；若服务异常，则返回INPUT_SERVICE_EXCEPTION。


### OH_Input_RemoveHotkeyMonitor()

```
Input_Result OH_Input_RemoveHotkeyMonitor (const Input_Hotkey * hotkey, Input_HotkeyCallback callback )
```
**描述**
取消订阅快捷键。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 14

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| hotkey | 指定要取消订阅的快捷键对象。  | 
| callback | 回调函数，用于回调快捷键事件。  | 

**返回：**

OH_Input_RemoveHotkeyMonitor 函数错误码。 INPUT_SUCCESS 表示取消订阅组合按键成功。

INPUT_PARAMETER_ERROR 表示参数检查失败。


### OH_Input_RemoveInputEventInterceptor()

```
Input_Result OH_Input_RemoveInputEventInterceptor ()
```
**描述**
移除输入事件拦截，包括鼠标、触摸和轴事件。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**Permission：**

ohos.permission.INTERCEPT_INPUT_EVENT

**返回：**

若移除输入事件拦截成功，则返回**INTO_SUCCESS**；若权限校验失败，则返回INPUT_PERMISSION_DENIED； 若服务异常，则返回INPUT_SERVICE_EXCEPTION。


### OH_Input_RemoveKeyEventInterceptor()

```
Input_Result OH_Input_RemoveKeyEventInterceptor ()
```
**描述**
移除按键事件拦截。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**Permission：**

ohos.permission.INTERCEPT_INPUT_EVENT

**返回：**

若移除按键事件拦截成功，则返回**INTO_SUCCESS**；若权限校验失败，则返回INPUT_PERMISSION_DENIED； 若服务异常，则返回INPUT_SERVICE_EXCEPTION。


### OH_Input_RemoveKeyEventMonitor()

```
Input_Result OH_Input_RemoveKeyEventMonitor (Input_KeyEventCallback callback)
```
**描述**
移除按键事件监听。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| callback | 指定要被移除的用于按键事件监听的回调函数。  | 

**Permission：**

ohos.permission.INPUT_MONITORING

**返回：**

若移除按键事件监听成功，则返回**INTO_SUCCESS**；若权限校验失败，则返回INPUT_PERMISSION_DENIED； 若callback为空或者没有被添加监听，则返回INPUT_PARAMETER_ERROR；若服务异常，则返回INPUT_SERVICE_EXCEPTION。


### OH_Input_RemoveMouseEventMonitor()

```
Input_Result OH_Input_RemoveMouseEventMonitor (Input_MouseEventCallback callback)
```
**描述**
移除鼠标事件监听。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| callback | 指定要被移除的用于鼠标事件监听的回调函数。  | 

**Permission：**

ohos.permission.INPUT_MONITORING

**返回：**

若移除鼠标事件监听成功，则返回**INTO_SUCCESS**；若权限校验失败，则返回INPUT_PERMISSION_DENIED； 若callback为空或者没有被添加监听，则返回INPUT_PARAMETER_ERROR；若服务异常，则返回INPUT_SERVICE_EXCEPTION。


### OH_Input_RemoveTouchEventMonitor()

```
Input_Result OH_Input_RemoveTouchEventMonitor (Input_TouchEventCallback callback)
```
**描述**
移除触摸事件监听。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| callback | 指定要被移除的用于触摸事件监听的回调函数。  | 

**Permission：**

ohos.permission.INPUT_MONITORING

**返回：**

若移除触摸事件监听成功，则返回**INTO_SUCCESS**；若权限校验失败，则返回INPUT_PERMISSION_DENIED； 若callback为空或者没有被添加监听，则返回INPUT_PARAMETER_ERROR；若服务异常，则返回INPUT_SERVICE_EXCEPTION。


### OH_Input_SetAxisEventAction()

```
Input_Result OH_Input_SetAxisEventAction (Input_AxisEvent * axisEvent, InputEvent_AxisAction action )
```
**描述**
设置轴事件的动作。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEvent | 轴事件对象。  | 
| action | 轴事件动作，具体请参考[InputEvent_AxisAction](#inputevent_axisaction)。  | 

**返回：**

若设置轴事件的动作成功，则返回**INTO_SUCCESS**；若axisEvent为NULL，则返回INPUT_PARAMETER_ERROR。

### OH_Input_SetAxisEventActionTime()

```
Input_Result OH_Input_SetAxisEventActionTime (Input_AxisEvent * axisEvent, int64_t actionTime )
```
**描述**
设置轴事件发生的时间。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEvent | 轴事件对象，请参考[Input_AxisEvent](#input_axisevent)。  | 
| actionTime | 轴事件发生的时间。  | 

**返回：**

若设置轴事件发生的时间成功，则返回**INTO_SUCCESS**；若axisEvent为NULL，则返回INPUT_PARAMETER_ERROR。


### OH_Input_SetAxisEventAxisValue()

```
Input_Result OH_Input_SetAxisEventAxisValue (Input_AxisEvent * axisEvent, InputEvent_AxisType axisType, double axisValue )
```
**描述**
设置轴事件指定轴类型的轴值。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEvent | 轴事件对象，请参考[Input_AxisEvent](#input_axisevent)。  | 
| axisType | 轴类型，具体请参考[InputEvent_AxisType](#inputevent_axistype)。  | 
| axisValue | 轴事件轴值。  | 

**返回：**

若设置轴事件指定轴类型的轴值成功，则返回**INTO_SUCCESS**；若axisEvent为NULL，则返回INPUT_PARAMETER_ERROR。


### OH_Input_SetAxisEventDisplayX()

```
Input_Result OH_Input_SetAxisEventDisplayX (Input_AxisEvent * axisEvent, float displayX )
```
**描述**
设置轴事件的X坐标。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEvent | 轴事件对象。  | 
| displayX | 轴事件X坐标。  | 

**返回：**

若设置轴事件的X坐标成功，则返回**INTO_SUCCESS**；若axisEvent为NULL，则返回INPUT_PARAMETER_ERROR。


### OH_Input_SetAxisEventDisplayY()

```
Input_Result OH_Input_SetAxisEventDisplayY (Input_AxisEvent * axisEvent, float displayY )
```
**描述**
设置轴事件的Y坐标。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEvent | 轴事件对象，请参考[Input_AxisEvent](#input_axisevent)。  | 
| displayY | 轴事件Y坐标。  | 

**返回：**

若设置轴事件的Y坐标成功，则返回**INTO_SUCCESS**；若axisEvent为NULL，则返回INPUT_PARAMETER_ERROR。


### OH_Input_SetAxisEventSourceType()

```
Input_Result OH_Input_SetAxisEventSourceType (Input_AxisEvent * axisEvent, InputEvent_SourceType sourceType )
```
**描述**
设置轴事件源类型。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEvent | 轴事件对象。  | 
| sourceType | 轴事件源类型,具体请参考[InputEvent_SourceType](#inputevent_sourcetype)。  | 

**返回：**

若设置轴事件源类型成功，则返回**INTO_SUCCESS**；若axisEvent为NULL，则返回INPUT_PARAMETER_ERROR。


### OH_Input_SetAxisEventType()

```
Input_Result OH_Input_SetAxisEventType (Input_AxisEvent * axisEvent, InputEvent_AxisEventType axisEventType )
```
**描述**
设置轴事件类型。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| axisEvent | 轴事件对象，请参考[Input_AxisEvent](#input_axisevent)。  | 
| axisEventType | 轴事件类型，具体请参考[InputEvent_AxisEventType](#inputevent_axiseventtype)。  | 

**返回：**

若设置轴事件类型成功，则返回**INTO_SUCCESS**；若axisEvent为NULL，则返回INPUT_PARAMETER_ERROR。


### OH_Input_SetFinalKey()

```
void OH_Input_SetFinalKey (Input_Hotkey * hotkey, int32_t finalKey )
```
**描述**
设置被修饰键。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 14

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| hotkey | 快捷键对象的实例。  | 
| finalKey | 被修饰键值，被修饰键值只能是1个。  | 


### OH_Input_SetKeyCode()

```
void OH_Input_SetKeyCode (struct Input_KeyState * keyState, int32_t keyCode )
```
**描述**
设置按键状态对象的键值。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyState | 按键状态的枚举对象，具体请参考[Input_KeyStateAction](#input_keystateaction)。 | 
| keyCode | 按键键值。  | 


### OH_Input_SetKeyEventAction()

```
void OH_Input_SetKeyEventAction (struct Input_KeyEvent * keyEvent, int32_t action )
```
**描述**
设置按键事件类型

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyEvent | 按键事件对象。  | 
| action | 按键事件类型。 | 


### OH_Input_SetKeyEventActionTime()

```
void OH_Input_SetKeyEventActionTime (struct Input_KeyEvent * keyEvent, int64_t actionTime )
```
**描述**
设置按键事件发生的时间。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyEvent | 按键事件对象。 | 
| actionTime | 按键事件发生的时间。  | 


### OH_Input_SetKeyEventKeyCode()

```
void OH_Input_SetKeyEventKeyCode (struct Input_KeyEvent * keyEvent, int32_t keyCode )
```
**描述**
设置按键事件的键值。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyEvent | 按键事件对象。  | 
| keyCode | 按键的键值。  | 


### OH_Input_SetKeyPressed()

```
void OH_Input_SetKeyPressed (struct Input_KeyState * keyState, int32_t keyAction )
```
**描述**
设置按键状态对象的按键是否按下。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyState | 按键状态的枚举对象，具体请参考[Input_KeyStateAction](#input_keystateaction)。 | 
| keyAction | 按键是否按下，具体请参考[Input_KeyEventAction](#input_keyeventaction)。 | 


### OH_Input_SetKeySwitch()

```
void OH_Input_SetKeySwitch (struct Input_KeyState * keyState, int32_t keySwitch )
```
**描述**
设置按键状态对象的按键开关。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyState | 按键状态的枚举对象，具体请参考[Input_KeyStateAction](#input_keystateaction)。 | 
| keySwitch | 按键开关。  | 


### OH_Input_SetMouseEventAction()

```
void OH_Input_SetMouseEventAction (struct Input_MouseEvent * mouseEvent, int32_t action )
```
**描述**
设置鼠标事件的动作。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| mouseEvent | 鼠标事件对象。  | 
| action | 鼠标的动作。  | 


### OH_Input_SetMouseEventActionTime()

```
void OH_Input_SetMouseEventActionTime (struct Input_MouseEvent * mouseEvent, int64_t actionTime )
```
**描述**
设置鼠标事件发生的时间。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| mouseEvent | 鼠标事件对象。  | 
| actionTime | 鼠标事件发生的时间。  | 


### OH_Input_SetMouseEventAxisType()

```
void OH_Input_SetMouseEventAxisType (struct Input_MouseEvent * mouseEvent, int32_t axisType )
```
**描述**
设置鼠标轴事件的类型。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| mouseEvent | 鼠标事件对象。 | 
| axisType | 轴类型，比如垂直轴、水平轴。  | 


### OH_Input_SetMouseEventAxisValue()

```
void OH_Input_SetMouseEventAxisValue (struct Input_MouseEvent * mouseEvent, float axisValue )
```
**描述**
设置鼠标轴事件的值。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| mouseEvent | 鼠标事件对象。  | 
| axisValue | 轴事件的值，正数向前滚动，负数向后滚动。  | 


### OH_Input_SetMouseEventButton()

```
void OH_Input_SetMouseEventButton (struct Input_MouseEvent * mouseEvent, int32_t button )
```
**描述**
设置鼠标事件的按键。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| mouseEvent | 鼠标事件对象。  | 
| button | 鼠标按键。  | 


### OH_Input_SetMouseEventDisplayX()

```
void OH_Input_SetMouseEventDisplayX (struct Input_MouseEvent * mouseEvent, int32_t displayX )
```
**描述**
设置鼠标事件的屏幕X坐标。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| mouseEvent | 鼠标事件对象。  | 
| displayX | 屏幕X坐标。  | 


### OH_Input_SetMouseEventDisplayY()

```
void OH_Input_SetMouseEventDisplayY (struct Input_MouseEvent * mouseEvent, int32_t displayY )
```
**描述**
设置鼠标事件的屏幕Y坐标。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| mouseEvent | 鼠标事件对象。  | 
| displayY | 屏幕Y坐标。  | 


### OH_Input_SetPreKeys()

```
void OH_Input_SetPreKeys (Input_Hotkey * hotkey, int32_t * preKeys, int32_t size )
```
**描述**
设置修饰键。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 14

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| hotkey | 快捷键对象的实例。  | 
| preKeys | 修饰键列表。  | 
| size | 修饰键个数， 取值范围1~2个。  | 


### OH_Input_SetRepeat()

```
void OH_Input_SetRepeat (Input_Hotkey * hotkey, bool isRepeat )
```
**描述**
设置是否上报重复key事件。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 14

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| hotkey | 快捷键对象的实例。  | 
| isRepeat | 是否上报重复key事件。true表示上报，false表示不上报。  | 


### OH_Input_SetTouchEventAction()

```
void OH_Input_SetTouchEventAction (struct Input_TouchEvent * touchEvent, int32_t action )
```
**描述**
设置触屏事件的动作。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| touchEvent | 触屏事件对象。  | 
|  action| 触屏的动作。 | 


### OH_Input_SetTouchEventActionTime()

```
void OH_Input_SetTouchEventActionTime (struct Input_TouchEvent * touchEvent, int64_t actionTime )
```
**描述**
设置触摸事件发生的时间。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| keyEvent | 触屏事件对象。 | 
| actionTime | 触摸事件发生的时间。  | 


### OH_Input_SetTouchEventDisplayX()

```
void OH_Input_SetTouchEventDisplayX (struct Input_TouchEvent * touchEvent, int32_t displayX )
```
**描述**
设置触屏事件的屏幕X坐标。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| touchEvent | 触屏事件对象。  | 
|   displayX| 触屏的屏幕X坐标。 |


### OH_Input_SetTouchEventDisplayY()

```
void OH_Input_SetTouchEventDisplayY (struct Input_TouchEvent * touchEvent, int32_t displayY )
```
**描述**
设置触屏事件的屏幕Y坐标。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| touchEvent | 触屏事件对象。  | 
|  displayY | 触屏的屏幕Y坐标。 |


### OH_Input_SetTouchEventFingerId()

```
void OH_Input_SetTouchEventFingerId (struct Input_TouchEvent * touchEvent, int32_t id )
```
**描述**
设置触屏事件的手指ID。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 12

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| touchEvent | 触屏事件对象。 | 
| id | 触屏的手指ID。 | 

### OH_Input_UnregisterDeviceListener()

```
Input_Result OH_Input_UnregisterDeviceListener (Input_DeviceListener * listener)
```
**描述**
取消注册设备热插拔的监听。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 13

**参数:**

| 名称 | 描述 | 
| -------- | -------- |
| listener | 指向设备热插拔监听器[Input_DeviceListener](_input___device_listener.md)的指针。  | 

**返回：**

OH_Input_UnregisterDeviceListener 的返回值。

INPUT_SUCCESS 表示取消注册成功。

INPUT_PARAMETER_ERROR 表示listener 为 NULL 或者 listener 未被注册。

INPUT_SERVICE_EXCEPTION 表示由于服务异常调用失败。


### OH_Input_UnregisterDeviceListeners()

```
Input_Result OH_Input_UnregisterDeviceListeners ()
```
**描述**
取消注册所有的设备热插拔的监听。

**系统能力：** SystemCapability.MultimodalInput.Input.Core

**起始版本：** 13

**返回：**

OH_Input_UnregisterDeviceListener 的返回值。 

INPUT_SUCCESS 表示调用成功，INPUT_SERVICE_EXCEPTION 表示由于服务异常调用失败。