为组件提供自定义手势判定能力。开发者可根据需要，在手势识别期间，决定是否响应手势。
说明：
从API Version 11开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
onGestureJudgeBegin
onGestureJudgeBegin(callback: (gestureInfo: GestureInfo, event: BaseGestureEvent) => GestureJudgeResult)
参数：
| 参数名 | 参数类型 | 必填 | 参数描述 |
|---|---|---|---|
| callback | (gestureInfo: GestureInfo, event: BaseGestureEvent) => GestureJudgeResult | 是 | 给组件绑定自定义手势判定回调，当绑定到该组件的手势被接受时，会触发用户定义的回调来获取结果。 |
GestureInfo对象说明
| 名称 | 类型 | 描述 |
|---|---|---|
| tag | string | 手势标记。 |
| type | GestureControl.GestureType | 手势类型。 |
| isSystemGesture | boolean | 判断当前手势是否为系统手势。 |
BaseEvent对象说明
| 名称 | 类型 | 描述 |
|---|---|---|
| target | EventTarget | 触发手势事件的元素对象显示区域。 |
| timestamp | number | 事件时间戳。 |
| source | SourceType | 事件输入设备。 |
| pressure | number | 按压的压力大小。 |
| titleX | number | 手写笔在设备平面上的投影与设备平面X轴的夹角。 |
| titleY | number | 手写笔在设备平面上的投影与设备平面Y轴的夹角。 |
| sourceTool | SourceTool | 事件输入源。 |
BaseGestureEvent对象说明
继承于BaseEvent。
| 名称 | 类型 | 描述 |
|---|---|---|
| fingerList | FingerInfo[] | 触发事件的所有手指信息。 |
TapGestureEvent对象说明
继承于BaseGestureEvent。可将该对象作为onGestureJudgeBegin的event参数来传递。
LongPressGestureEvent对象说明
继承于BaseGestureEvent。可将该对象作为onGestureJudgeBegin的event参数来传递。
| 名称 | 类型 | 描述 |
|---|---|---|
| repeat | boolean | 是否为重复触发事件。 |
PanGestureEvent对象说明
继承于BaseGestureEvent。可将该对象作为onGestureJudgeBegin的event参数来传递。
| 名称 | 类型 | 描述 |
|---|---|---|
| offsetX | number | 手势事件x轴相对当前组件元素原始区域的偏移量，单位为vp，从左向右滑动offsetX为正，反之为负。 |
| offsetY | number | 手势事件y轴相对当前组件元素原始区域的偏移量，单位为vp，从上向下滑动offsetY为正，反之为负。 |
| velocityX | number | 获取当前手势的x轴方向速度。坐标轴原点为屏幕左上角，分正负方向速度，从左往右为正，反之为负。 |
| velocityY | number | 获取当前手势的y轴方向速度。坐标轴原点为屏幕左上角，分正负方向速度，从上往下为正，反之为负。 |
| velocity | number | 获取当前的主方向速度。为xy轴方向速度的平方和的算术平方根。 |
PinchGestureEvent对象说明
继承于BaseGestureEvent。可将该对象作为onGestureJudgeBegin的event参数来传递。
| 名称 | 类型 | 描述 |
|---|---|---|
| scale | number | 缩放比例。 |
| pinchCenterX | number | 捏合手势中心点相对于当前组件元素原始区域左上角x轴坐标，单位为vp。 |
| pinchCenterY | number | 捏合手势中心点相对于当前组件元素原始区域左上角y轴坐标，单位为vp。 |
RotationGestureEvent对象说明
继承于BaseGestureEvent。可将该对象作为onGestureJudgeBegin的event参数来传递。
| 名称 | 类型 | 描述 |
|---|---|---|
| angle | number | 表示旋转角度，单位为deg。 说明： 角度计算方式：滑动手势被识别到后，连接两根手指之间的线被识别为起始线条，随着手指的滑动，手指之间的线条会发生旋转，根据起始线条两端点和当前线条两端点的坐标，使用反正切函数分别计算其相对于水平方向的夹角，最后arctan2(cy2-cy1,cx2-cx1)-arctan2(y2-y1,x2-x1)为旋转的角度。以起始线条为坐标系，顺时针旋转为0到180度，逆时针旋转为-180到0度。 |
SwipeGestureEvent对象说明
继承于BaseGestureEvent。可将该对象作为onGestureJudgeBegin的event参数来传递。
| 名称 | 类型 | 描述 |
|---|---|---|
| angle | number | 表示滑动手势的角度，即两根手指间的线段与水平方向的夹角变化的度数，单位为deg。 说明： 角度计算方式：滑动手势被识别到后，连接两根手指之间的线被识别为起始线条，随着手指的滑动，手指之间的线条会发生旋转，根据起始线条两端点和当前线条两端点的坐标，使用反正切函数分别计算其相对于水平方向的夹角，最后arctan2(cy2-cy1,cx2-cx1)-arctan2(y2-y1,x2-x1)为旋转的角度。以起始线条为坐标系，顺时针旋转为0到180度，逆时针旋转为-180到0度。 |
| speed | number | 滑动手势速度，即所有手指相对当前组件元素原始区域滑动的平均速度，单位为vp/秒。 |
示例
示例1
// xxx.ets
@Entry
@Component
struct Index {
@State message: string = '';
build() {
Column() {
Row({ space: 20 }) {
Text(this.message).width(100).height(40).backgroundColor(Color.Pink)
}.margin(20)
}
.width('100%')
.height(200)
.borderWidth(2)
.onDragStart(() => {
this.message = 'drag'
console.log("Drag start.")
})
.gesture(
TapGesture()
.tag("tap1")// 设置点击手势标志
)
.gesture(
LongPressGesture()
.tag("longPress1")// 设置长按手势标志
.onAction(() => {
this.message = 'longPress'
})
)
.gesture(
SwipeGesture()
.tag("swipe1")// 设置滑动手势标志
)
.gesture(
PanGesture()
.tag("pan1")// 设置拖动手势标志
)
.onGestureJudgeBegin((gestureInfo: GestureInfo, event: BaseGestureEvent) => {
// 若该手势类型为长按手势，转换为长按手势事件
if (gestureInfo.type == GestureControl.GestureType.LONG_PRESS_GESTURE) {
let longPressEvent = event as LongPressGestureEvent;
console.log("repeat " + longPressEvent.repeat)
}
// 若该手势类型为滑动手势，转换为滑动手势事件
if (gestureInfo.type == GestureControl.GestureType.SWIPE_GESTURE) {
let swipeEvent = event as SwipeGestureEvent;
console.log("angle " + swipeEvent.angle)
}
// 若该手势类型为拖动手势，转换为拖动手势事件
if (gestureInfo.type == GestureControl.GestureType.PAN_GESTURE) {
let panEvent = event as PanGestureEvent;
console.log("velocity " + panEvent.velocity)
}
// 自定义判定标准
if (gestureInfo.type == GestureControl.GestureType.DRAG) {
// 返回 REJECT 会使拖动手势失败
return GestureJudgeResult.REJECT;
} else if (gestureInfo.tag == 'longPress1' && event.fingerList.length > 0 && event.fingerList[0].localY < 100) {
// 返回 CONTINUE 将保持系统判定。
return GestureJudgeResult.CONTINUE;
}
return GestureJudgeResult.CONTINUE;
})
}
}示例2
// xxx.ets
import promptAction from '@ohos.promptAction';
@Entry
@Component
struct Index {
scroller: Scroller = new Scroller()
build() {
Scroll(this.scroller) {
Column({ space: 8 }) {
Text("Drag 上下两层 上层绑定长按，下层绑定拖拽。先长按后平移上半区红色区域只会响应长按，先长按后平移下半区蓝色区域只会响应拖拽").width('100%').fontSize(20).fontColor('0xffdd00')
.backgroundColor(0xeeddaa00)
Stack({ alignContent: Alignment.Center }) {
Column() {
// 模拟上半区和下半区
Stack().width('200vp').height('100vp').backgroundColor(Color.Red)
Stack().width('200vp').height('100vp').backgroundColor(Color.Blue)
}.width('200vp').height('200vp')
// Stack的下半区是绑定了拖动手势的图像区域。
Image($r('sys.media.ohos_app_icon'))
.onDragStart(()=>{
promptAction.showToast({ message: "Drag 下半区蓝色区域，Image响应" })
})
.width('200vp').height('200vp')
// Stack的上半区是绑定了长按手势的浮动区域。
Stack() {
}
.width('200vp')
.height('200vp')
.hitTestBehavior(HitTestMode.Transparent)
.onGestureJudgeBegin((gestureInfo: GestureInfo, event: BaseGestureEvent) => {
// 确定tag标志是否有值
if (gestureInfo.tag) {
console.log("gestureInfo tag" + gestureInfo.tag.toString())
}
console.log("gestureInfo Type " + gestureInfo.type.toString() + " isSystemGesture " + gestureInfo.isSystemGesture);
console.log("pressure " + event.pressure + " fingerList.length " + event.fingerList.length
+ " timeStamp " + event.timestamp + " sourceType " + event.source.toString() + " titleX " + event.tiltX + " titleY " + event.tiltY + " sourcePool " + event.sourceTool.toString());
// 如果是长按类型手势，判断点击的位置是否在上半区
if (gestureInfo.type == GestureControl.GestureType.LONG_PRESS_GESTURE) {
if (event.fingerList.length > 0 && event.fingerList[0].localY < 100) {
return GestureJudgeResult.CONTINUE
} else {
return GestureJudgeResult.REJECT
}
}
return GestureJudgeResult.CONTINUE
})
.gesture(GestureGroup(GestureMode.Parallel,
LongPressGesture()
.onAction((event: GestureEvent) => {
promptAction.showToast({ message: "LongPressGesture 长按上半区 红色区域，红色区域响应" })
})
.tag("tap111")
))
}.width('100%')
}.width('100%')
}
}
}最后，有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（Harmony NEXT）资料用来跟着学习是非常有必要的。
这份鸿蒙（Harmony NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点。
希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！
获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料
鸿蒙（Harmony NEXT）最新学习路线
-
HarmonOS基础技能
- HarmonOS就业必备技能
- HarmonOS多媒体技术
- 鸿蒙NaPi组件进阶
- HarmonOS高级技能
- 初识HarmonOS内核
- 实战就业级设备开发
有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料
《鸿蒙 (OpenHarmony)开发入门教学视频》
《鸿蒙生态应用开发V2.0白皮书》
《鸿蒙 (OpenHarmony)开发基础到实战手册》
OpenHarmony北向、南向开发环境搭建
《鸿蒙开发基础》
《鸿蒙开发进阶》
- Stage模型入门
- 网络管理
- 数据管理
- 电话服务
- 分布式应用开发
- 通知与窗口管理
- 多媒体技术
- 安全技能
- 任务管理
- WebGL
- 国际化开发
- 应用测试
- DFX面向未来设计
- 鸿蒙系统移植和裁剪定制
- ……
《鸿蒙进阶实战》
- ArkTS实践
- UIAbility应用
- 网络案例
- ……
获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料
总结
总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。
