鸿蒙OS ManipulationEvent

ManipulationEvent

java.lang.Object

|—ohos.multimodalinput.event.MultimodalEvent

|—|—ohos.multimodalinput.event.ManipulationEvent

public abstract class ManipulationEvent
extends MultimodalEvent

报告操纵事件。

ManipulationEvent 定义并抽象了所有操作事件，例如手指触摸事件。 这样的事件携带包括事件位置和阶段的信息。 一般将事件作为回调的输入来捕获和处理事件。 回调将一个动作分为三个阶段：开始、操作和结束。 例如，对于单指触摸，开始表示手指触摸屏幕，操作表示手指在屏幕上移动，结束表示手指从屏幕上抬起。

Since:

1

嵌套类摘要

字段摘要

构造函数摘要

方法总结

字段详细信息

PHASE_CANCEL

public static final int PHASE_CANCEL

表示操作已被取消。 一个动作被取消后视为结束。

Since:

1

PHASE_COMPLETED

public static final int PHASE_COMPLETED

表示动作已经结束。

Since:

1

PHASE_MOVE

public static final int PHASE_MOVE

表示操作正在进行中。

Since:

1

PHASE_NONE

public static final int PHASE_NONE

表示无效操作。

Since:

1

PHASE_START

public static final int PHASE_START

表示动作已经开始。

Since:

1

构造函数详细信息

ManipulationEvent

public ManipulationEvent()

方法详情

getStartTime

public abstract long getStartTime()

获取操作开始阶段的时间（以毫秒为单位）。

返回:

返回操作开始阶段的时间（以毫秒为单位）。

Since:

1

getPhase

public abstract int getPhase()

获取事件的运行阶段。

操作阶段可以是 PHASE_NONE、PHASE_START、PHASE_MOVE、PHASE_COMPLETED 或 PHASE_CANCEL。

返回:

返回事件的操作阶段。 返回值可以是 PHASE_NONE、PHASE_START、PHASE_MOVE、PHASE_COMPLETED 或 PHASE_CANCEL。

Since:

1

getPointerPosition

public abstract MmiPoint getPointerPosition(int index)

获取事件中触摸控制或轨迹跟踪时指针索引相对于偏移位置的x和y坐标。

参数：

返回:

返回指针索引的 x 和 y 坐标。 如果已指定控件的位置，则返回相对于控件的 x 和 y 坐标。 如果尚未指定控件的位置，则返回相对于屏幕的 x 和 y 坐标。

Since:

1

setScreenOffset

public abstract void setScreenOffset(float offsetX, float offsetY)

设置相对于屏幕的偏移位置。

参数：

Since:

1

getPointerScreenPosition

public abstract MmiPoint getPointerScreenPosition(int index)

获取事件中触摸控制或轨迹跟踪时指针索引相对于屏幕坐标原点的x和y坐标。

参数：

返回:

返回指针索引相对于屏幕的 x 和 y 坐标。

Since:

1

getPointerCount

public abstract int getPointerCount()

获取事件中触控或轨迹跟踪的指针数量。

返回:

返回事件中用于触摸控制或轨迹跟踪的指针数。

Since:

1

getPointerId

public abstract int getPointerId(int index)

获取事件中指针的唯一 ID。

参数：

返回:

返回事件中指针的唯一 ID。

Since:

1

getForce

public abstract float getForce(int index)

获取指定索引的手指的触摸压力。

手指的触摸压力一般在0到1.0之间。 根据输入设备的校准，有时可能会生成大于 1 的值。

参数：

返回:

返回触摸压力。

Since:

1

getRadius

public abstract float getRadius(int index)

获取指定索引的手指的触摸半径。

触摸半径表示手指在屏幕上触摸的区域。

参数：

返回:

返回具有指定索引的手指的触摸半径。

Since:

1