java.lang.Object
|---ohos.multimodalinput.event.MultimodalEvent
|---|---ohos.multimodalinput.event.ManipulationEvent
public abstract class ManipulationEvent
extends MultimodalEvent
报告操纵事件。
ManipulationEvent 定义并抽象了所有操作事件，例如手指触摸事件。 这样的事件携带包括事件位置和阶段的信息。 一般将事件作为回调的输入来捕获和处理事件。 回调将一个动作分为三个阶段：开始、操作和结束。 例如，对于单指触摸，开始表示手指触摸屏幕，操作表示手指在屏幕上移动，结束表示手指从屏幕上抬起。
Since:
1
| 从接口 ohos.utils.Sequenceable 继承的嵌套类/接口 |
|---|
| Sequenceable.ProducerT |
| 修饰符和类型 | 字段 | 描述 |
|---|---|---|
| static int | PHASE_CANCEL | 表示操作已被取消。 |
| static int | PHASE_COMPLETED | 表示动作已经结束。 |
| static int | PHASE_MOVE | 表示操作正在进行中。 |
| static int | PHASE_NONE | 表示无效操作。 |
| static int | PHASE_START | 表示动作已经开始。 |
| 从类 ohos.multimodalinput.event.MultimodalEvent 继承的字段 |
|---|
| BUILTIN_KEY, DEFAULT_TYPE, highLevelEvent, KEYBOARD, MOUSE, ROTATION, SPEECH, STYLUS, TOUCH_PANEL, UNSUPPORTED_DEVICE, uuid |
| 构造函数 | 描述 |
|---|---|
| ManipulationEvent() |
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| abstract float | getForce(int index) | 获取指定索引的手指的触摸压力。 |
| abstract int | getPhase() | 获取事件的运行阶段。 |
| abstract int | getPointerCount() | 获取事件中触控或轨迹跟踪的指针数量。 |
| abstract int | getPointerId(int index) | 获取事件中指针的唯一 ID。 |
| abstract MmiPoint | getPointerPosition(int index) | 获取事件中触摸控制或轨迹跟踪时指针索引相对于偏移位置的x和y坐标。 |
| abstract MmiPoint | getPointerScreenPosition(int index) | 获取事件中触摸控制或轨迹跟踪时指针索引相对于屏幕坐标原点的x和y坐标。 |
| abstract float | getRadius(int index) | 获取指定索引的手指的触摸半径。 |
| abstract long | getStartTime() | 获取操作开始阶段的时间（以毫秒为单位）。 |
| abstract void | setScreenOffset(float offsetX, float offsetY) | 设置相对于屏幕的偏移位置。 |
| 从类 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 |
public static final int PHASE_CANCEL
表示操作已被取消。 一个动作被取消后视为结束。
Since:
1
public static final int PHASE_COMPLETED
表示动作已经结束。
Since:
1
public static final int PHASE_MOVE
表示操作正在进行中。
Since:
1
public static final int PHASE_NONE
表示无效操作。
Since:
1
public static final int PHASE_START
表示动作已经开始。
Since:
1
public ManipulationEvent()
public abstract long getStartTime()
获取操作开始阶段的时间（以毫秒为单位）。
返回:
返回操作开始阶段的时间（以毫秒为单位）。
Since:
1
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
public abstract MmiPoint getPointerPosition(int index)
获取事件中触摸控制或轨迹跟踪时指针索引相对于偏移位置的x和y坐标。
参数：
| 参数名称 | 参数描述 |
|---|---|
| index | 指示指针索引映射到事件中的指针动作。 取值范围从 0 到 getPointerCount()-1。 对于鼠标和触控笔，仅支持单个指针操作。 获取位置信息后，指针索引设置为0。 |
返回:
返回指针索引的 x 和 y 坐标。 如果已指定控件的位置，则返回相对于控件的 x 和 y 坐标。 如果尚未指定控件的位置，则返回相对于屏幕的 x 和 y 坐标。
Since:
1
public abstract void setScreenOffset(float offsetX, float offsetY)
设置相对于屏幕的偏移位置。
参数：
| 参数名称 | 参数描述 |
|---|---|
| offsetX | 表示相对于屏幕左上角 x 的偏移量。 |
| offsetY | 表示相对于屏幕左上角 y 的偏移量。 |
Since:
1
public abstract MmiPoint getPointerScreenPosition(int index)
获取事件中触摸控制或轨迹跟踪时指针索引相对于屏幕坐标原点的x和y坐标。
参数：
| 参数名称 | 参数描述 |
|---|---|
| index | 指示指针索引映射到事件中的指针ID。 取值范围从 0 到 getPointerCount()-1。 对于鼠标和触控笔，仅支持单个指针操作。 获取指针 ID 后，指针索引设置为 0。 |
返回:
返回指针索引相对于屏幕的 x 和 y 坐标。
Since:
1
public abstract int getPointerCount()
获取事件中触控或轨迹跟踪的指针数量。
返回:
返回事件中用于触摸控制或轨迹跟踪的指针数。
Since:
1
public abstract int getPointerId(int index)
获取事件中指针的唯一 ID。
参数：
| 参数名称 | 参数描述 |
|---|---|
| index | 指示指针索引映射到事件中的指针ID。 取值范围从 0 到 getPointerCount()-1。 对于鼠标和触控笔，仅支持单个指针操作。 获取指针 ID 后，指针索引设置为 0。 |
返回:
返回事件中指针的唯一 ID。
Since:
1
public abstract float getForce(int index)
获取指定索引的手指的触摸压力。
手指的触摸压力一般在0到1.0之间。 根据输入设备的校准，有时可能会生成大于 1 的值。
参数：
| 参数名称 | 参数描述 |
|---|---|
| index | 指示触摸手指的索引。 取值范围从 0 到 getPointerCount()-1。 可以根据其唯一ID获取当前事件中触摸手指的位置。 对于鼠标和触控笔动作事件，仅支持单个指针动作。 获取压力信息时，索引设置为0。对于鼠标动作事件，左键按下时的触摸压力为1.0，其他情况下为0。 |
返回:
返回触摸压力。
Since:
1
public abstract float getRadius(int index)
获取指定索引的手指的触摸半径。
触摸半径表示手指在屏幕上触摸的区域。
参数：
| 参数名称 | 参数描述 |
|---|---|
| index | 指示触摸手指的索引。 取值范围从 0 到 getPointerCount()-1。 可以根据其唯一ID获取当前事件中触摸手指的位置。 对于鼠标和触控笔动作事件，仅支持单个指针动作。 获取屏幕大小时，索引设置为0。对于鼠标动作事件，触摸半径有一个固定值0。 |
返回:
返回具有指定索引的手指的触摸半径。
Since:
1
备案信息： 粤ICP备15087711号-2
Copyright © 2008-2024 啊嘎哇在线工具箱 All Rights.
本站所有资料来源于网络，版权归原作者所有，仅作学习交流使用，如不慎侵犯了您的权利，请联系我们。