鸿蒙OpenHarmony【手势拦截加强】ArkTS组件手势处置惩罚

shouldBuiltInRecognizerParallelWith

shouldBuiltInRecognizerParallelWith(callback: ShouldBuiltInRecognizerParallelWithCallback): T
提供体系内置手势与响应链上其他组件的手势设置并行关系的回调变乱。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
参数：
参数名参数范例必填参数描述callback[ShouldBuiltInRecognizerParallelWithCallback]是提供体系内置手势与响应链上其他组件的手势设置并行关系的回调变乱，当该组件做触摸碰撞测试时，会触发用户界说的回调来形成手势并行关系。 返回值：
范例说明T返回当前组件。 ShouldBuiltInRecognizerParallelWithCallback

type ShouldBuiltInRecognizerParallelWithCallback = (current: GestureRecognizer, others: Array) => GestureRecognizer
提供体系内置手势与响应链上其他组件的手势设置并行关系的回调变乱范例。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
参数：
参数名范例必填说明current[GestureRecognizer]是当前组件的体系内置手势识别器，当前版本只提供内置的[PAN_GESTURE]范例的手势识别器。othersArray<[GestureRecognizer]>是响应链上更高优先级的其他组件相同种别的手势识别器。 返回值：
范例说明[GestureRecognizer]与current识别器绑定并行关系的某个手势识别器。 GestureRecognizer

手势识别器对象。
getTag

getTag(): string
返回当前手势识别器的tag。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
返回值：
范例说明string当前手势识别器的tag。 getType

getType(): GestureControl.GestureType
返回当前手势识别器的范例。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
返回值：
范例说明[GestureControl.GestureType]当前手势识别器的范例。 isBuiltIn

isBuiltIn(): boolean
返回当前手势识别器是否为体系内置手势。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
返回值：
范例说明boolean当前手势识别器是否为体系内置手势。 setEnabled

setEnabled(isEnabled: boolean): void
设置当前手势识别器的使能状态。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
参数：
参数名范例必填说明isEnabledboolean是手势识别器的使能状态。 isEnabled

isEnabled(): boolean
返回当前手势识别器的使能状态。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
返回值：
范例说明boolean当前手势识别器的使能状态。 getState

getState(): GestureRecognizerState
返回当前手势识别器的状态。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
返回值：
范例说明[GestureRecognizerState]当前手势识别器的状态。 getEventTargetInfo

getEventTargetInfo(): EventTargetInfo
返回当前手势识别器对应组件的信息。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
返回值：
范例说明[EventTargetInfo]当前手势识别器对应组件的信息。 isValid

isValid(): boolean;
返回当前手势识别器是否有效。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
返回值：
范例说明boolean当前手势识别器是否有效。当该识别器绑定的组件被析构或者该识别器不在响应链上时返回false。 GestureRecognizerState

界说手势识别器状态。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
名称值描述READY0预备状态。DETECTING1检测状态。PENDING2等待状态。BLOCKED3阻塞状态。SUCCESSFUL4成功状态。FAILED5失败状态。 EventTargetInfo

手势识别器对应组件的信息。
getId

getId(): string
返回当前组件的组件标识。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
返回值：
范例说明string当前组件的[组件标识]。 ScrollableTargetInfo

手势识别器对应的滚动类容器组件的信息，继承于[EventTargetInfo]。
isBegin

isBegin(): boolean
返回当前滚动类容器组件是否在顶部，假如为Swiper组件且在循环模式下返回false。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
返回值：
范例说明boolean当前滚动类容器组件是否在顶部。 isEnd

isEnd(): boolean
返回当前滚动类容器组件是否在底部，假如为Swiper组件且在循环模式下返回false。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
返回值：
范例说明boolean当前滚动类容器组件是否在底部。 PanRecognizer

拖动手势识别器对象，继承于[GestureRecognizer]。
getPanGestureOptions

getPanGestureOptions(): PanGestureOptions
返回当前拖动手势识别器的属性。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
返回值：
范例说明[PanGestureOptions]当前拖动手势识别器的属性。 onGestureRecognizerJudgeBegin

onGestureRecognizerJudgeBegin(callback: GestureRecognizerJudgeBeginCallback): T
给组件绑定自界说手势识别器判定回调。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
参数：
参数名参数范例必填参数描述callback[GestureRecognizerJudgeBeginCallback]是给组件绑定自界说手势识别器判定回调，当绑定到该组件的手势被接受时，会触发用户界说的回调来获取结果。 返回值：
范例说明T返回当前组件。 GestureRecognizerJudgeBeginCallback

type GestureRecognizerJudgeBeginCallback = (event: BaseGestureEvent, current: GestureRecognizer, recognizers: Array) => GestureJudgeResult
自界说手势识别器判定回调范例。
元服务API：  从API version 12开始，该接口支持在元服务中利用。
体系能力：  SystemCapability.ArkUI.ArkUI.Full
参数：
参数名范例必填说明event[BaseGestureEvent]是当前根本手势变乱信息。current[GestureRecognizer]是当前即将要响应的识别器对象。othersArray<[GestureRecognizer]>是响应链上的其他手势识别器对象。 返回值：
范例说明[GestureJudgeResult]手势是否裁决成功的判定结果。 示例

1. // xxx.ets
2. @Entry
3. @Component
4. struct FatherControlChild {
5.   scroller: Scroller = new Scroller()
6.   scroller2: Scroller = new Scroller()
7.   private arr: number[] = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
8.   private childRecognizer: GestureRecognizer = new GestureRecognizer()
9.   private currentRecognizer: GestureRecognizer = new GestureRecognizer()
10.   private lastOffset: number = 0
12.   build() {
13.     Stack({ alignContent: Alignment.TopStart }) {
14.       Scroll(this.scroller) { // 外部滚动容器
15.         Column() {
16.           Text("Scroll Area")
17.             .width('90%')
18.             .height(150)
19.             .backgroundColor(0xFFFFFF)
20.             .borderRadius(15)
21.             .fontSize(16)
22.             .textAlign(TextAlign.Center)
23.             .margin({ top: 10 })
24.           Scroll(this.scroller2) { // 内部滚动容器
25.             Column() {
26.               Text("Scroll Area2")
27.                 .width('90%')
28.                 .height(150)
29.                 .backgroundColor(0xFFFFFF)
30.                 .borderRadius(15)
31.                 .fontSize(16)
32.                 .textAlign(TextAlign.Center)
33.                 .margin({ top: 10 })
34.               Column() {
35.                 ForEach(this.arr, (item: number) => {
36.                   Text(item.toString())
37.                     .width('90%')
38.                     .height(150)
39.                     .backgroundColor(0xFFFFFF)
40.                     .borderRadius(15)
41.                     .fontSize(16)
42.                     .textAlign(TextAlign.Center)
43.                     .margin({ top: 10 })
44.                 }, (item: string) => item)
45.               }.width('100%')
46.             }
47.           }
48.           .id("inner")
49.           .width('100%')
50.           .height(800)
51.         }.width('100%')
52.       }
53.       .id("outer")
54.       .height(600)
55.       .scrollable(ScrollDirection.Vertical) // 滚动方向纵向
56.       .scrollBar(BarState.On) // 滚动条常驻显示
57.       .scrollBarColor(Color.Gray) // 滚动条颜色
58.       .scrollBarWidth(10) // 滚动条宽度
59.       .edgeEffect(EdgeEffect.None)
60.       .shouldBuiltInRecognizerParallelWith((current: GestureRecognizer, others: Array<GestureRecognizer>) => {
61.         for (let i = 0; i < others.length; i++) {
62.           let target = others[i].getEventTargetInfo();
63.           if (target) {
64.             if (target.getId() == "inner" && others[i].isBuiltIn() && others[i].getType() == GestureControl.GestureType.PAN_GESTURE) { // 找到将要组成并行手势的识别器
65.               this.currentRecognizer = current; // 保存当前组件的识别器
66.               this.childRecognizer = others[i]; // 保存将要组成并行手势的识别器
67.               return others[i]; // 返回将要组成并行手势的识别器
68.             }
69.           }
70.         }
71.         return undefined;
72.       })
73.       .onGestureRecognizerJudgeBegin((event: BaseGestureEvent, current: GestureRecognizer, others: Array<GestureRecognizer>) => { // 在识别器即将要成功时，根据当前组件状态，设置识别器使能状态
74.         if (current) {
75.           let target = current.getEventTargetInfo();
76.           if (target) {
77.             if (target.getId() == "outer" && current.isBuiltIn() && current.getType() == GestureControl.GestureType.PAN_GESTURE) {
78.               if (others) {
79.                 for (let i = 0; i < others.length; i++) {
80.                   let target = others[i].getEventTargetInfo() as ScrollableTargetInfo;
81.                   if (target instanceof ScrollableTargetInfo && target.getId() == "inner") { // 找到响应链上对应并行的识别器
82.                     let panEvent = event as PanGestureEvent;
83.                     if (target.isEnd()) { // 根据当前组件状态以及移动方向动态控制识别器使能状态
84.                       if (panEvent && panEvent.offsetY < 0) {
85.                         this.childRecognizer.setEnabled(false)
86.                         this.currentRecognizer.setEnabled(true)
87.                       } else {
88.                         this.childRecognizer.setEnabled(true)
89.                         this.currentRecognizer.setEnabled(false)
90.                       }
91.                     } else if (target.isBegin()) {
92.                       if (panEvent.offsetY > 0) {
93.                         this.childRecognizer.setEnabled(false)
94.                         this.currentRecognizer.setEnabled(true)
95.                       } else {
96.                         this.childRecognizer.setEnabled(true)
97.                         this.currentRecognizer.setEnabled(false)
98.                       }
99.                     } else {
100.                       this.childRecognizer.setEnabled(true)
101.                       this.currentRecognizer.setEnabled(false)
102.                     }
103.                   }
104.                 }
105.               }
106.             }
107.           }
108.         }
109.         return GestureJudgeResult.CONTINUE;
110.       })
111.       .parallelGesture( // 绑定一个Pan手势作为动态控制器
112.         PanGesture()
113.           .onActionUpdate((event: GestureEvent)=>{
114.             if (this.childRecognizer.getState() != GestureRecognizerState.SUCCESSFUL || this.currentRecognizer.getState() != GestureRecognizerState.SUCCESSFUL) { // 如果识别器状态不是SUCCESSFUL，则不做控制
115.               return;
116.             }
117.             let target = this.childRecognizer.getEventTargetInfo() as ScrollableTargetInfo;
118.             let currentTarget = this.currentRecognizer.getEventTargetInfo() as ScrollableTargetInfo;
119.             if (target instanceof ScrollableTargetInfo && currentTarget instanceof ScrollableTargetInfo) {
120.               if (target.isEnd()) { // 在移动过程中实时根据当前组件状态，控制识别器的开闭状态
121.                 if ((event.offsetY - this.lastOffset) < 0) {
122.                   this.childRecognizer.setEnabled(false)
123.                   if (currentTarget.isEnd()) {
124.                     this.currentRecognizer.setEnabled(false)
125.                   } else {
126.                     this.currentRecognizer.setEnabled(true)
127.                   }
128.                 } else {
129.                   this.childRecognizer.setEnabled(true)
130.                   this.currentRecognizer.setEnabled(false)
131.                 }
132.               } else if (target.isBegin()) {
133.                 if ((event.offsetY - this.lastOffset) > 0) {
134.                   this.childRecognizer.setEnabled(false)
135.                   if (currentTarget.isBegin()) {
136.                     this.currentRecognizer.setEnabled(false)
137.                   } else {
138.                     this.currentRecognizer.setEnabled(true)
139.                   }
140.                 } else {
141.                   this.childRecognizer.setEnabled(true)
142.                   this.currentRecognizer.setEnabled(false)
143.                 }
144.               } else {
145.                 this.childRecognizer.setEnabled(true)
146.                 this.currentRecognizer.setEnabled(false)
147.               }
148.             }
149.             this.lastOffset = event.offsetY
150.           })
151.       )
152.     }.width('100%').height('100%').backgroundColor(0xDCDCDC)
153.   }
154. }

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。