> For the complete documentation index, see [llms.txt](https://changkun.gitbook.io/leapmotion_v2_cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changkun.gitbook.io/leapmotion_v2_cn/yu-yan/cpp/api-can-kao/leap.screentapgesture.md).

# ScreenTapGesture

属性：

* [direction](/leapmotion_v2_cn/yu-yan/cpp/api-can-kao/leap.screentapgesture.md#direction)
* [position](/leapmotion_v2_cn/yu-yan/cpp/api-can-kao/leap.screentapgesture.md#position)
* [pointable](/leapmotion_v2_cn/yu-yan/cpp/api-can-kao/leap.screentapgesture.md#pointable)
* [class\_type](/leapmotion_v2_cn/yu-yan/cpp/api-can-kao/leap.screentapgesture.md#class_type)

## ***class*** **Leap. ScreenTapGesture**

扩展自 [Gesture](/leapmotion_v2_cn/yu-yan/cpp/api-can-kao/leap.gesture.md)

ScreenTapGesture(屏幕点击手势) 类表示一根手指在竖直方向上向前移动手指并回到原始位置的手势。点击的手指必须在点击前短暂的停留一下。

![](https://3708604558-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LmAGnx6ThZjQnyNN4Sg%2F-LmAGpETZPiOMDijInN-%2F-LmAGz5kV8rK9qcIkRu_%2FLeap_Gesture_Tap2.png?generation=1565704874435744\&alt=media)

重要：要在应用中使用屏幕点击手势，你需要激活屏幕点击手势识别。你可以通过下面的代码激活这种识别：

```python
controller.enable_gesture(Leap.Gesture.TYPE_SCREEN_TAP);
```

ScreenTap 手势是离散的，ScreenTapGesture 对象总是表示一个点击的状态 STATE\_STOP。仅当识别到屏幕点击手势后才会被创建。

你可以设置手指移动范围和速度的最小值。使用下面的键值可以进行设置：

|                  键值                  |  值类型  | 默认值 |  单位  |
| :----------------------------------: | :---: | :-: | :--: |
| Gesture.ScreenTap.MinForwardVelocity | float |  50 | mm/s |
|  Gesture.screen\_tap.HistorySeconds  | float | 0.1 |  mm  |
|     Gesture.ScreenTap.MinDistance    | float | 5.0 |  mm  |

下面的代码展示了如何设置这些值：

```python
controller.config.set("Gesture.ScreenTap.MinForwardVelocity", 30.0)
controller.config.set("Gesture.ScreenTap.HistorySeconds", .5)
controller.config.set("Gesture.ScreenTap.MinDistance", 1.0)
controller.config.save()
```

*New in Version 1.0*

### 构造函数

*classmethod* **ScreenTapGesture(\[gesture])**

从 Gesture 类实例中构造一个 ScreenTapGesture 对象。

```python
for gesture in frame.gestures():
    if gesture.type is Leap.Gesture.TYPE_SCREEN_TAP:
        screen_tap = Leap.ScreenTapGesture(gesture)
```

参数：

gesture([Gesture](/leapmotion_v2_cn/yu-yan/cpp/api-can-kao/leap.gesture.md)) - Gesture 实例专用。这个 Gesture 实例必须是一个 ScreenTapGesture 对象。如果没有给出参数，那么一个无效的 ScreenTapGesture 对象会被创建。

*New in Version 1.0*

### 属性

**position**

类型：[Vector](/leapmotion_v2_cn/yu-yan/cpp/api-can-kao/leap.vector.md)

点击手势的位置。

```python
tap_point = screen_tap.position
```

*New in Version 1.0*

\--

**position**

类型：[Vector](/leapmotion_v2_cn/yu-yan/cpp/api-can-kao/leap.vector.md)

屏幕点击手势的当前位置

```python
current = screen_tap.position
```

*New in Version 1.0*

\--

**direction**

类型：[Vector](/leapmotion_v2_cn/yu-yan/cpp/api-can-kao/leap.vector.md)

手指指尖的方向。如果手指不动，那么这个手势也会被记录，并被记录为零向量。

```python
tap_direction = screen_tap.direction
```

*New in Version 1.0*

\--

**progress**

类型：float

progress 值总是 1。

*New in Version 1.0*

\--

**pointable**

类型：[Pointable](/leapmotion_v2_cn/yu-yan/cpp/api-can-kao/leap.pointable.md)

执行轻点手势的手指。

```python
tapper = screen_tap.pintable
```

*New in Version 1.0*

### 类属性

*classmethod* **class\_type()**

类型：integer

屏幕点击手势类型指示器：`Gesture.TYPE_SCREEN_TAP`