程序包 ohos.multimodalinput.event

类 TouchEvent

java.lang.Object

ohos.multimodalinput.event.MultimodalEvent

ohos.multimodalinput.event.ManipulationEvent

ohos.multimodalinput.event.TouchEvent

所有已实现的接口:

Sequenceable

public abstract class TouchEvent
extends ManipulationEvent

Defines touch events and mapped standard events.

Information about a touch event includes the finger positions in multi-finger touch, touch pressure, and touch radius. A standard event is used to indicate the user intent. Its definition is irrelevant of the input device type. The system maps a basic interaction event of another type of input to a standard interaction event of a touch input. The mapping is as follows: For basic mouse interaction events:

• Clicking and holding the left button on the mouse maps to touching the screen with a finger at the pointer position, as described in PRIMARY_POINT_DOWN.
• Clicking and holding the left button on the mouse and then moving the pointer maps to touching the screen and moving the finger on the screen, as described in POINT_MOVE.
• Releasing the left button on the mouse maps to lifting up a finger from the screen, as described in PRIMARY_POINT_UP.

Note: The touchscreen does not have a hover pointer state. Therefore, if the mouse is moved without any button pressed, no interaction event is mapped to the touchscreen. To map to this mouse input event, this class defines the hover states for the pointer, such as HOVER_POINTER_ENTER, HOVER_POINTER_MOVE, and HOVER_POINTER_EXIT. For basic stylus interaction events:

• Touching the screen with the stylus pen tip maps to touching the screen with a finger, as described in PRIMARY_POINT_DOWN.
• Touching the screen with the stylus pen tip and then moving on the screen maps to touching the screen and moving the finger on the screen, as described in POINT_MOVE.
• Lifting up the stylus from the screen maps to lifting up a finger from the screen, as described in PRIMARY_POINT_UP.

从以下版本开始:

1

另请参阅:

ManipulationEvent, MouseEvent, StylusEvent

SystemCapability

SystemCapability.MultimodalInput#MULTIMODAL_INPUT

嵌套类概要

从接口继承的嵌套类/接口 ohos.utils.Sequenceable

Sequenceable.Producer<T>

字段概要

字段

限定符和类型	字段	说明
static int	CANCEL	Indicates that the event is interrupted or canceled.
static int	HOVER_POINTER_ENTER	Indicates that the hover pointer enters a window or component.
static int	HOVER_POINTER_EXIT	Indicates that the hover pointer leaves a window or component.
static int	HOVER_POINTER_MOVE	Indicates that the hover pointer moves in a window or component.
static int	NONE	Indicates no touch activity.
static int	OTHER_POINT_DOWN	Indicates that another finger touches on the screen when one finger or more already touch on the screen.
static int	OTHER_POINT_UP	Indicates some fingers lift up from the screen while some remain on the screen.
static int	POINT_MOVE	Indicates that the finger moves on the screen.
static int	PRIMARY_POINT_DOWN	Indicates that the first finger touches the screen.
static int	PRIMARY_POINT_UP	Indicates that the last finger lifts up from the screen.

从类继承的字段 ohos.multimodalinput.event.ManipulationEvent

PHASE_CANCEL, PHASE_COMPLETED, PHASE_MOVE, PHASE_NONE, PHASE_START

从类继承的字段 ohos.multimodalinput.event.MultimodalEvent

BUILTIN_KEY, DEFAULT_TYPE, highLevelEvent, KEYBOARD, MOUSE, ROTATION, SPEECH, STYLUS, TOUCH_PANEL, UNSUPPORTED_DEVICE, uuid

构造器概要

构造器

构造器	说明
TouchEvent()

方法概要

限定符和类型	方法	说明
abstract int	getAction()	Obtains the current pointer action status.
abstract int	getIndex()	Obtains the index of the pointer action.
MultimodalEvent	getMultimodalEvent()	Obtains the original multimodal input event that has been mapped to a standard interaction event.

从类继承的方法 ohos.multimodalinput.event.ManipulationEvent

getForce, getPhase, getPointerCount, getPointerId, getPointerPosition, getPointerScreenPosition, getRadius, getStartTime, setScreenOffset

从类继承的方法 ohos.multimodalinput.event.MultimodalEvent

getDeviceId, getInputDeviceId, getOccurredTime, getSourceDevice, getUuid, isSameEvent, marshalling, unmarshalling

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 ohos.utils.Sequenceable

hasFileDescriptor

字段详细资料

CANCEL

public static final int CANCEL

Indicates that the event is interrupted or canceled.

从以下版本开始:

3

另请参阅:

常量字段值

HOVER_POINTER_ENTER

public static final int HOVER_POINTER_ENTER

Indicates that the hover pointer enters a window or component.

从以下版本开始:

5

另请参阅:

常量字段值

HOVER_POINTER_EXIT

public static final int HOVER_POINTER_EXIT

Indicates that the hover pointer leaves a window or component.

从以下版本开始:

5

另请参阅:

常量字段值

HOVER_POINTER_MOVE

public static final int HOVER_POINTER_MOVE

Indicates that the hover pointer moves in a window or component.

从以下版本开始:

5

另请参阅:

常量字段值

NONE

public static final int NONE

Indicates no touch activity.

从以下版本开始:

1

另请参阅:

常量字段值

OTHER_POINT_DOWN

public static final int OTHER_POINT_DOWN

Indicates that another finger touches on the screen when one finger or more already touch on the screen.

从以下版本开始:

1

另请参阅:

常量字段值

OTHER_POINT_UP

public static final int OTHER_POINT_UP

Indicates some fingers lift up from the screen while some remain on the screen.

从以下版本开始:

1

另请参阅:

常量字段值

POINT_MOVE

public static final int POINT_MOVE

Indicates that the finger moves on the screen.

从以下版本开始:

1

另请参阅:

常量字段值

PRIMARY_POINT_DOWN

public static final int PRIMARY_POINT_DOWN

Indicates that the first finger touches the screen. This indicates the beginning of an interaction.

从以下版本开始:

1

另请参阅:

常量字段值

PRIMARY_POINT_UP

public static final int PRIMARY_POINT_UP

Indicates that the last finger lifts up from the screen. This indicates the end of an interaction.

从以下版本开始:

1

另请参阅:

常量字段值

构造器详细资料

TouchEvent

public TouchEvent()

方法详细资料

getMultimodalEvent

public MultimodalEvent getMultimodalEvent()

Obtains the original multimodal input event that has been mapped to a standard interaction event.

After an original multimodal input event is mapped to a standard interaction event, you can call this method to obtain the original event. For example, after a mouse event is mapped to a touch event, this method returns the mouse event.

返回:

Returns the original event.

从以下版本开始:

5

另请参阅:

MultimodalEvent

getAction

public abstract int getAction()

Obtains the current pointer action status.

返回:

Returns the current pointer action status. The return value can be PRIMARY_POINT_DOWN, PRIMARY_POINT_UP, POINT_MOVE, OTHER_POINT_DOWN, or OTHER_POINT_UP.

从以下版本开始:

1

getIndex

public abstract int getIndex()

Obtains the index of the pointer action.

This method obtains the pointer index of the pointer action, for example, OTHER_POINT_DOWN or OTHER_POINT_UP. Based on the index, you can obtain information such as the touch pressure and touch radius.

返回:

Returns the index of the pointer action, which is in the range from 0 to ManipulationEvent#getPointerCount()-1.

从以下版本开始:

1