harmony 鸿蒙@ohos.multimodalInput.touchEvent (Touch Event)

2025-06-12
浏览 (324)

@ohos.multimodalInput.touchEvent (Touch Event)

The touchEvent module provides touchscreen 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,ToolType,SourceType,Touch,TouchEvent } from '@kit.InputKit';

Action

Enumerates touch event types.

System capability: SystemCapability.MultimodalInput.Input.Core

Name	Value	Description
CANCEL	0	Cancellation of touch.
DOWN	1	Pressing of touch.
MOVE	2	Moving of touch.
UP	3	Lifting of touch.

ToolType

Enumerates touch tool types.

System capability: SystemCapability.MultimodalInput.Input.Core

Name	Value	Description
FINGER	0	Finger.
PEN	1	Stylus.
RUBBER	2	Eraser.
BRUSH	3	Brush.
PENCIL	4	Pencil.
AIRBRUSH	5	Air brush.
MOUSE	6	Mouse.
LENS	7	Lens.

SourceType

Enumerates touch source types.

System capability: SystemCapability.MultimodalInput.Input.Core

Name	Value	Description
TOUCH_SCREEN	0	Touchscreen.
PEN	1	Stylus.
TOUCH_PAD	2	Touchpad.

FixedMode¹⁹⁺

Enumerates coordinate correction modes. This API takes effect only for mobile phones.

System capability: SystemCapability.MultimodalInput.Input.Core

Name	Value	Description
NONE	0	Normal mode.
AUTO	1	One-handed mode.

Touch

Defines the touch point information.

System capability: SystemCapability.MultimodalInput.Input.Core

Name	Type	Readable	Writable	Description
id	number	Yes	No	Touch event ID.
pressedTime	number	Yes	No	Press timestamp, in μs.
screenX	number	Yes	No	X coordinate of the touch position on the screen.
screenY	number	Yes	No	Y coordinate of the touch position on the screen.
windowX	number	Yes	No	X coordinate of the touch position in the window.
windowY	number	Yes	No	Y coordinate of the touch position in the window.
pressure	number	Yes	No	Pressure value. The value range is [0.0, 1.0]. The value 0.0 indicates that the pressure is not supported.
width	number	Yes	No	Width of the touch area.
height	number	Yes	No	Height of the touch area.
tiltX	number	Yes	No	Angle relative to the YZ plane. The value range is [-90, 90]. A positive value indicates a rightward tilt.
tiltY	number	Yes	No	Angle relative to the XZ plane. The value range is [-90, 90]. A positive value indicates a downward tilt.
toolX	number	Yes	No	X coordinate of the center point of the tool area.
toolY	number	Yes	No	Y coordinate of the center point of the tool area.
toolWidth	number	Yes	No	Width of the tool area.
toolHeight	number	Yes	No	Height of the tool area.
rawX	number	Yes	No	X coordinate of the input device.
rawY	number	Yes	No	Y coordinate of the input device.
toolType	ToolType	Yes	No	Tool type.
fixedDisplayX¹⁹⁺	number	Yes	No	screenX correction value in one-hand mode. NOTE: This API takes effect only for mobile phones.
fixedDisplayY¹⁹⁺	number	Yes	No	screenY correction value in one-hand mode. This API takes effect only for mobile phones.

TouchEvent

Defines a touch event.

System capability: SystemCapability.MultimodalInput.Input.Core

Name	Type	Readable	Writable	Description
action	Action	Yes	No	Touch event type.
touch	Touch	Yes	No	Current touch point.
touches	Touch[]	Yes	No	All touch points.
sourceType	SourceType	Yes	No	Enumerates touch source types.
fixedMode¹⁹⁺	FixedMode	Yes	Yes	Coordinate correction mode. This API takes effect only for mobile phones.