# LongPressGesture >![](../../public_sys-resources/icon-note.gif) **NOTE:** >This gesture is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version. ## Required Permissions None ## APIs LongPressGesture\(options?: \{ fingers?: number, repeat?: boolean, duration?: number \}\) - Parameters

Name

Type

Mandatory

Default Value

Description

fingers

number

No

1

Minimum number of fingers to trigger a long press gesture. The value ranges from 1 to 10.

repeat

boolean

No

false

Whether to continuously trigger the event callback.

duration

number

No

500

Minimum hold-down time, in ms.

## Events

Name

Description

onAction((event?: LongPressGestureEvent) => void)

Callback invoked when a long press gesture is recognized.

onActionEnd((event?: LongPressGestureEvent) => void)

Callback invoked when the finger used for a long press gesture is lift.

onActionCancel(event: () => void)

Callback invoked when a tap cancellation event is received after a long press gesture is recognized.

- LongPressGestureEvent attributes8+ Inherited from [GestureEvent](ts-gesture-settings.md#table290mcpsimp).

Name

Type

Description

repeat

boolean

Whether the event is repeated.

## Example ``` @Entry @Component struct LongPressGestureExample { @State count: number = 0 build() { Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.SpaceBetween }) { Text('LongPress onAction:' + this.count) } .height(200).width(300).padding(60).border({ width:1 }).margin(30) .gesture( LongPressGesture({ repeat: true }) // Repeatedly triggered when the long press gesture exists. .onAction((event: LongPressGestureEvent) => { if (event.repeat) { this.count++ } }) // Triggered when the long press gesture ends. .onActionEnd(() => { this.count = 0 }) ) } } ``` ![](figures/longpressgesture.gif)