建站
咨詢
售后
建站咨詢
新聞中心
ManipulationEvent
java.lang.Object
|---ohos.multimodalinput.event.MultimodalEvent
|---|---ohos.multimodalinput.event.ManipulationEvent
public abstract class ManipulationEvent
extends MultimodalEvent報(bào)告操縱事件。
ManipulationEvent 定義并抽象了所有操作事件，例如手指觸摸事件。 這樣的事件攜帶包括事件位置和階段的信息。 一般將事件作為回調(diào)的輸入來(lái)捕獲和處理事件。 回調(diào)將一個(gè)動(dòng)作分為三個(gè)階段：開(kāi)始、操作和結(jié)束。 例如，對(duì)于單指觸摸，開(kāi)始表示手指觸摸屏幕，操作表示手指在屏幕上移動(dòng)，結(jié)束表示手指從屏幕上抬起。
Since:
1
嵌套類摘要
| 從接口 ohos.utils.Sequenceable 繼承的嵌套類/接口 |
|---|
| Sequenceable.ProducerT |
字段摘要
| 修飾符和類型 | 字段 | 描述 |
|---|---|---|
| static int | PHASE_CANCEL | 表示操作已被取消。 |
| static int | PHASE_COMPLETED | 表示動(dòng)作已經(jīng)結(jié)束。 |
| static int | PHASE_MOVE | 表示操作正在進(jìn)行中。 |
| static int | PHASE_NONE | 表示無(wú)效操作。 |
| static int | PHASE_START | 表示動(dòng)作已經(jīng)開(kāi)始。 |
| 從類 ohos.multimodalinput.event.MultimodalEvent 繼承的字段 |
|---|
| BUILTIN_KEY, DEFAULT_TYPE, highLevelEvent, KEYBOARD, MOUSE, ROTATION, SPEECH, STYLUS, TOUCH_PANEL, UNSUPPORTED_DEVICE, uuid |
構(gòu)造函數(shù)摘要
| 構(gòu)造函數(shù) | 描述 |
|---|---|
| ManipulationEvent() |
方法總結(jié)
| 修飾符和類型 | 方法 | 描述 |
|---|---|---|
| abstract float | getForce(int index) | 獲取指定索引的手指的觸摸壓力。 |
| abstract int | getPhase() | 獲取事件的運(yùn)行階段。 |
| abstract int | getPointerCount() | 獲取事件中觸控或軌跡跟蹤的指針數(shù)量。 |
| abstract int | getPointerId(int index) | 獲取事件中指針的唯一 ID。 |
| abstract MmiPoint | getPointerPosition(int index) | 獲取事件中觸摸控制或軌跡跟蹤時(shí)指針?biāo)饕鄬?duì)于偏移位置的x和y坐標(biāo)。 |
| abstract MmiPoint | getPointerScreenPosition(int index) | 獲取事件中觸摸控制或軌跡跟蹤時(shí)指針?biāo)饕鄬?duì)于屏幕坐標(biāo)原點(diǎn)的x和y坐標(biāo)。 |
| abstract float | getRadius(int index) | 獲取指定索引的手指的觸摸半徑。 |
| abstract long | getStartTime() | 獲取操作開(kāi)始階段的時(shí)間（以毫秒為單位）。 |
| abstract void | setScreenOffset(float offsetX, float offsetY) | 設(shè)置相對(duì)于屏幕的偏移位置。 |
| 從類 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 |
字段詳細(xì)信息
PHASE_CANCEL
public static final int PHASE_CANCEL
表示操作已被取消。 一個(gè)動(dòng)作被取消后視為結(jié)束。
Since:
1
PHASE_COMPLETED
public static final int PHASE_COMPLETED
表示動(dòng)作已經(jīng)結(jié)束。
Since:
1
PHASE_MOVE
public static final int PHASE_MOVE
表示操作正在進(jìn)行中。
Since:
1
PHASE_NONE
public static final int PHASE_NONE
表示無(wú)效操作。
Since:
1
PHASE_START
public static final int PHASE_START
表示動(dòng)作已經(jīng)開(kāi)始。
Since:
1
構(gòu)造函數(shù)詳細(xì)信息
ManipulationEvent
public ManipulationEvent()
方法詳情
getStartTime
public abstract long getStartTime()
獲取操作開(kāi)始階段的時(shí)間（以毫秒為單位）。
返回:
返回操作開(kāi)始階段的時(shí)間（以毫秒為單位）。
Since:
1
getPhase
public abstract int getPhase()
獲取事件的運(yùn)行階段。
操作階段可以是 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)
獲取事件中觸摸控制或軌跡跟蹤時(shí)指針?biāo)饕鄬?duì)于偏移位置的x和y坐標(biāo)。
參數(shù)：
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| index | 指示指針?biāo)饕成涞绞录械闹羔槃?dòng)作。 取值范圍從 0 到 getPointerCount()-1。 對(duì)于鼠標(biāo)和觸控筆，僅支持單個(gè)指針操作。 獲取位置信息后，指針?biāo)饕O(shè)置為0。 |
返回:
返回指針?biāo)饕?x 和 y 坐標(biāo)。 如果已指定控件的位置，則返回相對(duì)于控件的 x 和 y 坐標(biāo)。 如果尚未指定控件的位置，則返回相對(duì)于屏幕的 x 和 y 坐標(biāo)。
Since:
1
setScreenOffset
public abstract void setScreenOffset(float offsetX, float offsetY)
設(shè)置相對(duì)于屏幕的偏移位置。
參數(shù)：
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| offsetX | 表示相對(duì)于屏幕左上角 x 的偏移量。 |
| offsetY | 表示相對(duì)于屏幕左上角 y 的偏移量。 |
Since:
1
getPointerScreenPosition
public abstract MmiPoint getPointerScreenPosition(int index)
獲取事件中觸摸控制或軌跡跟蹤時(shí)指針?biāo)饕鄬?duì)于屏幕坐標(biāo)原點(diǎn)的x和y坐標(biāo)。
參數(shù)：
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| index | 指示指針?biāo)饕成涞绞录械闹羔業(yè)D。 取值范圍從 0 到 getPointerCount()-1。 對(duì)于鼠標(biāo)和觸控筆，僅支持單個(gè)指針操作。 獲取指針 ID 后，指針?biāo)饕O(shè)置為 0。 |
返回:
返回指針?biāo)饕鄬?duì)于屏幕的 x 和 y 坐標(biāo)。
Since:
1
getPointerCount
public abstract int getPointerCount()
獲取事件中觸控或軌跡跟蹤的指針數(shù)量。
返回:
返回事件中用于觸摸控制或軌跡跟蹤的指針數(shù)。
Since:
1
getPointerId
public abstract int getPointerId(int index)
獲取事件中指針的唯一 ID。
參數(shù)：
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| index | 指示指針?biāo)饕成涞绞录械闹羔業(yè)D。 取值范圍從 0 到 getPointerCount()-1。 對(duì)于鼠標(biāo)和觸控筆，僅支持單個(gè)指針操作。 獲取指針 ID 后，指針?biāo)饕O(shè)置為 0。 |
返回:
返回事件中指針的唯一 ID。
Since:
1
getForce
public abstract float getForce(int index)
獲取指定索引的手指的觸摸壓力。
手指的觸摸壓力一般在0到1.0之間。 根據(jù)輸入設(shè)備的校準(zhǔn)，有時(shí)可能會(huì)生成大于 1 的值。
參數(shù)：
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| index | 指示觸摸手指的索引。 取值范圍從 0 到 getPointerCount()-1。 可以根據(jù)其唯一ID獲取當(dāng)前事件中觸摸手指的位置。 對(duì)于鼠標(biāo)和觸控筆動(dòng)作事件，僅支持單個(gè)指針動(dòng)作。 獲取壓力信息時(shí)，索引設(shè)置為0。對(duì)于鼠標(biāo)動(dòng)作事件，左鍵按下時(shí)的觸摸壓力為1.0，其他情況下為0。 |
返回:
返回觸摸壓力。
Since:
1
getRadius
public abstract float getRadius(int index)
獲取指定索引的手指的觸摸半徑。
觸摸半徑表示手指在屏幕上觸摸的區(qū)域。
參數(shù)：
| 參數(shù)名稱 | 參數(shù)描述 |
|---|---|
| index | 指示觸摸手指的索引。 取值范圍從 0 到 getPointerCount()-1。 可以根據(jù)其唯一ID獲取當(dāng)前事件中觸摸手指的位置。 對(duì)于鼠標(biāo)和觸控筆動(dòng)作事件，僅支持單個(gè)指針動(dòng)作。 獲取屏幕大小時(shí)，索引設(shè)置為0。對(duì)于鼠標(biāo)動(dòng)作事件，觸摸半徑有一個(gè)固定值0。 |
返回:
返回具有指定索引的手指的觸摸半徑。
Since:
1
分享名稱：創(chuàng)新互聯(lián)鴻蒙OS教程：鴻蒙OSManipulationEvent
轉(zhuǎn)載來(lái)源：http://m.fisionsoft.com.cn/article/ccsjhjp.html
