@ohos.multimodalInput.mouseEvent (Mouse Event)

The mouseEvent module provides mouse events reported by a device. It is inherited from InputEvent.

NOTE

The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Modules to Import

import { Action, Button, Axis, AxisValue, MouseEvent } from '@ohos.multimodalInput.mouseEvent';

Action

Enumerates mouse event types.

System capability: SystemCapability.MultimodalInput.Input.Core

Name	Value	Description
CANCEL	0	Cancellation of a mouse action.
MOVE	1	Moving of the mouse pointer.
BUTTON_DOWN	2	Pressing of a mouse button.
BUTTON_UP	3	Release of a mouse button.
AXIS_BEGIN	4	Beginning of the axis event associated with the mouse.
AXIS_UPDATE	5	Updating of the axis event associated with the mouse.
AXIS_END	6	Ending of the axis event associated with the mouse.
ACTION_DOWN¹¹⁺	7	Finger pressing on the touchpad.
ACTION_UP¹¹⁺	8	Finger lift from the touchpad.

Button

Enumerates mouse buttons.

System capability: SystemCapability.MultimodalInput.Input.Core

Name	Value	Description
LEFT	0	Left button on the mouse.
MIDDLE	1	Middle button on the mouse.
RIGHT	2	Right button on the mouse.
SIDE	3	Side button on the mouse.
EXTRA	4	Extended button on the mouse.
FORWARD	5	Forward button on the mouse.
BACK	6	Back button on the mouse.
TASK	7	Task button on the mouse.

Axis

Enumerates mouse axis types.

System capability: SystemCapability.MultimodalInput.Input.Core

Name	Value	Description
SCROLL_VERTICAL	0	Vertical scroll axis.
SCROLL_HORIZONTAL	1	Horizontal scroll axis.
PINCH	2	Pinch axis.

AxisValue

Defines the mouse axis type and axis value.

System capability: SystemCapability.MultimodalInput.Input.Core

Name	Type	Readable	Writable	Description
axis	Axis	Yes	No	Axis type.
value	number	Yes	No	Axis value.

ToolType¹¹⁺

Enumerates tool types.

System capability: SystemCapability.MultimodalInput.Input.Core

Name	Value	Description
UNKNOWN¹¹⁺	0	Unknown.
MOUSE¹¹⁺	1	Mouse.
TOUCHSCREEN¹¹⁺	2	Touchscreen.
TOUCHPAD¹¹⁺	3	Touchpad.
JOYSTICK¹¹⁺	4	Joystick.

MouseEvent

Defines the mouse event.

System capability: SystemCapability.MultimodalInput.Input.Core

Name	Type	Readable	Writable	Description
action	Action	Yes	No	Mouse event action.
screenX	number	Yes	No	Horizontal coordinate of the mouse pointer on the screen.
screenY	number	Yes	No	Vertical coordinate of the mouse pointer on the screen.
windowX	number	Yes	No	Horizontal coordinate of the mouse pointer in the window.
windowY	number	Yes	No	Vertical coordinate of the mouse pointer in the window.
rawDeltaX	number	Yes	No	Horizontal coordinate offset relative to the previous reported mouse pointer position.
rawDeltaY	number	Yes	No	Vertical coordinate offset relative to the previous reported mouse pointer position.
button	Button	Yes	No	Mouse button
pressedButtons	Button[]	Yes	No	Button being pressed.
axes	AxisValue[]	Yes	No	All axis data contained in the event.
pressedKeys	KeyCode[]	Yes	No	List of pressed keys.
ctrlKey	boolean	Yes	No	Whether ctrlKey is being pressed. The value true indicates that the key is pressed, and the value false indicates the opposite.
altKey	boolean	Yes	No	Whether altKey is being pressed.
shiftKey	boolean	Yes	No	Whether shiftKey is being pressed.
logoKey	boolean	Yes	No	Whether logoKey is being pressed.
fnKey	boolean	Yes	No	Whether fnKey is being pressed.
capsLock	boolean	Yes	No	Whether capsLock is active. The value true indicates that capsLock is active, and the value false indicates the opposite.
numLock	boolean	Yes	No	Whether numLock is active.
scrollLock	boolean	Yes	No	Whether scrollLock is active.
toolType¹¹⁺	ToolType	Yes	No	Tool type.