1# LongPressGesture 2 3用于触发长按手势事件，触发长按手势的最少手指数为1，最短长按时间为500毫秒。 4 5> **说明：** 6> 7> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 8 9 10## 接口 11 12LongPressGesture(value?: { fingers?: number, repeat?: boolean, duration?: number }) 13 14当组件默认支持可拖拽时，如Text、TextInput、TextArea、HyperLink、Image和RichEditor等组件。长按手势与拖拽会出现冲突，事件优先级如下： 15 16长按触发时间 < 500ms，长按事件优先拖拽事件响应。 17 18长按触发时间 >= 500ms，拖拽事件优先长按事件响应。 19 20**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 21 22**参数：** 23 24| 参数名称 | 参数类型 | 必填 | 参数描述 | 25| -------- | -------- | -------- | -------- | 26| fingers | number | 否 | 触发长按的最少手指数，最小为1指， 最大取值为10指。<br/>默认值：1 <br/> **说明：** <br/>手指按下后若发生超过15px的移动，则判定当前长按手势识别失败。| 27| repeat | boolean | 否 | 是否连续触发事件回调。true表示连续触发事件回调，false表示不连续触发事件回调。<br/>默认值：false | 28| duration | number | 否 | 触发长按的最短时间，单位为毫秒（ms）。<br/>默认值：500 <br/>**说明：** <br/>取值范围：[0, +∞)，设置小于等于0时，按照默认值500处理。| 29| isFingerCountLimited<sup>15+</sup> | boolean | 否 | 是否检查触摸屏幕的手指数量。若触摸屏幕的手指的数量不等于设置的触发长按的最少手指数（即上述fingers参数），手势识别将失败。<br>对于已成功识别的手势，后续触摸屏幕的手指数变化，将不触发repeat事件（若触摸屏幕的手指数恢复到设置的触发长按的最少手指数时，可以触发[onAction](ts-basic-gestures-longpressgesture.md#事件)事件），但可以触发[onActionEnd](ts-basic-gestures-longpressgesture.md#事件)事件。<br>默认值：false。| 30 31 32## 事件 33 34| 名称 | 功能描述 | 35| -------- | -------- | 36| onAction(event:(event: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | LongPress手势识别成功回调。 <br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| 37| onActionEnd(event:(event: [GestureEvent](ts-gesture-settings.md#gestureevent对象说明)) => void) | LongPress手势识别成功，最后一根手指抬起后触发回调。 <br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| 38| onActionCancel(event: () => void) | LongPress手势识别成功，接收到触摸取消事件触发回调。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| 39 40## 属性 41 42| 名称 | 类型 |描述 | 43| ---- | ------ | ---------------------------------------- | 44| tag<sup>11+</sup> | string | 设置LongPress手势标志，用于自定义手势判定时区分绑定的手势。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| 45| allowedTypes<sup>14+</sup> | Array\<[SourceTool](ts-gesture-settings.md#sourcetool枚举说明9)> | 设置LongPress手势支持的事件输入源。<br/>**原子化服务API：** 从API version 14开始，该接口支持在原子化服务中使用。 | 46 47 48## 示例 49 50该示例通过LongPressGesture实现了长按手势的识别。 51 52```ts 53// xxx.ets 54@Entry 55@Component 56struct LongPressGestureExample { 57 @State count: number = 0 58 59 build() { 60 Column() { 61 Text('LongPress onAction:' + this.count).fontSize(28) 62 // 单指长按文本触发该手势事件 63 .gesture( 64 LongPressGesture({ repeat: true }) 65 // 由于repeat设置为true，长按动作存在时会连续触发，触发间隔为duration（默认值500ms） 66 .onAction((event: GestureEvent) => { 67 if (event && event.repeat) { 68 this.count++ 69 } 70 }) 71 // 长按动作一结束触发 72 .onActionEnd((event: GestureEvent) => { 73 this.count = 0 74 }) 75 ) 76 } 77 .height(200) 78 .width(300) 79 .padding(20) 80 .border({ width: 3 }) 81 .margin(30) 82 } 83} 84``` 85 86 87
