TapGesture
支持單擊、雙擊和多次點(diǎn)擊事件的識(shí)別。
說明:
開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
從API Version 7開始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。
接口
TapGesture(value?: { count?: number, fingers?: number })
參數(shù)名稱 | 參數(shù)類型 | 必填 | 參數(shù)描述 |
---|---|---|---|
count | number | 否 | 識(shí)別的連續(xù)點(diǎn)擊次數(shù)。當(dāng)設(shè)置的值小于1或不設(shè)置時(shí),會(huì)被轉(zhuǎn)化為默認(rèn)值。 默認(rèn)值:1**說明:**如配置多擊,上一次抬起和下一次按下的超時(shí)時(shí)間為300毫秒。 |
fingers | number | 否 | 觸發(fā)點(diǎn)擊的手指數(shù),最小為1指, 最大為10指。當(dāng)設(shè)置小于1的值或不設(shè)置時(shí),會(huì)被轉(zhuǎn)化為默認(rèn)值。 默認(rèn)值:1**說明:**1. 當(dāng)配置多指時(shí),第一根手指按下后300毫秒內(nèi)未有足夠的手指數(shù)按下,手勢(shì)識(shí)別失敗。 2. 實(shí)際點(diǎn)擊手指數(shù)超過配置值,手勢(shì)識(shí)別成功。 |
事件
名稱 | 功能描述HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿 |
---|---|
onAction(event: (event?: [GestureEvent]) => void) | Tap手勢(shì)識(shí)別成功回調(diào)。 |
示例
// xxx.ets
@Entry
@Component
struct TapGestureExample {
@State value: string = ''
build() {
Column() {
// 單指雙擊文本觸發(fā)手勢(shì)事件
Text('Click twice').fontSize(28)
.gesture(
TapGesture({ count: 2 })
.onAction((event?: GestureEvent) = > {
if (event) {
this.value = JSON.stringify(event.fingerList[0])
}
})
)
Text(this.value)
}
.height(200)
.width(300)
.padding(20)
.border({ width: 3 })
.margin(30)
}
}
審核編輯 黃宇
-
鴻蒙
+關(guān)注
關(guān)注
57文章
2358瀏覽量
42876
發(fā)布評(píng)論請(qǐng)先 登錄
相關(guān)推薦
評(píng)論