Lines Matching refs:hold
83 A hold gesture is one where the user places one or more fingers on the
84 device without significant movement. The exact conditions when a hold gesture
88 The hold gesture is intended to allow for the implementation of two specific
92 subsequent hold gesture can be used to stop that kinetic scroll motion,
94 - hold-to-trigger interactions where the interaction could be a click, a
103 switching between hold gestures with different finger counts.
105 .. note:: By definition, a hold gesture does not move and thus no coordinate
120 A hold gesture may by be **cancelled**. This occurs
121 when the hold gesture changes into some other interaction and should no
122 longer be considered the current hold gesture. A **end(cancelled)** event
129 | | Finger 1 down | | **hold begin** |
131 | | Finger 1 motion | | **hold cancel** |
139 .. note:: Many interactions with a touchpad will start with a hold
141 pointer motion. A caller **must** handle hold gesture
149 | | Finger 1 down | | **hold begin** | | 1 |
151 | | Finger 2 down | | **hold cancel** | | 1 |
152 | | | | **hold begin** | | 2 |
154 | | Finger 1+2 motion | | **hold cancel** | | 2 |
168 | | Finger 1 down | | **hold begin** | | 1 |
170 | | Finger 2 down | | **hold cancel** | | 1 |
171 | | | | **hold begin** | | 2 |
173 | | Finger 3 down | | **hold cancel** | | 2 |
174 | | | | **hold begin** | | 3 |
176 | | Finger motion | | **hold cancel** | | 3 |
186 Single-finger hold gestures
190 to determine whether a single-finger hold gestures should start. In other
191 words, a caller **must not** rely on a hold gesture always being triggered
193 hold gesture but especially so for single-finger hold gestures.
196 On many devices it is impossible to hold a finger still enough for there to
198 movement thresholds to rely on hold gestures would reduce device
201 It is thus the responsibility of the caller to determine where hold gestures
202 transition in and out of other interactions. For example, a two-finger hold
203 may produce a cancelled single-finger hold gesture first:
208 | | Finger 1 down | | **hold begin** | | 1 | |
210 | | Finger 1 motion | | **hold cancel** | | 1 | | tiny deltas|
213 | | Finger 2 down | | **hold begin** | | 2 | |
215 | | Finger 1 up | | **hold end** | | | |
219 Note how the second hold gesture started with a finger count of 2 - without
220 the user ever lifting the first finger. Cancellation of hold gesture does
223 A hold gesture may start after a previous gesture completed. For example, a
224 single finger move-and-hold may trigger different sequences for the same
230 | | Finger 1 down | | **hold begin** | | **hold begin** | |
232 | | Finger 1 motion | | **hold cancel** | | | tiny deltas|
235 | | | **hold begin** | | |
237 | | Finger 1 up | | **hold end** | | **hold end** | |
240 A caller that wants to use hold gestures must thus be able to infer the same
243 libinput may start a new hold begin gesture once the pointer stops moving.
244 The time between the last pointer motion event and the hold begin event is
255 In the context of hold gestures, thumbs and palms are treated by libinput as
257 fingers remain on the device, an **hold update** event is sent. Otherwise,
258 the hold gesture terminates with a **hold cancel** event.
264 the hold gesture.
267 as a new finger is placed on the touchpad. In that case, the hold gesture
273 of the touchpad by a palm may trigger a **hold begin** followed by an
274 immediate **hold end** as libinput lacks sufficient information to identify
275 the touch as thumb/palm and send the corresponding **hold cancel**
276 event. A caller must not assume that a hold gesture always represents a
285 .. warning:: Summary: do not use hold gestures to do your own tap-to-click
288 In the context of hold gestures, tap-to-click cancels current hold gestures
289 and a finger dragging (see :ref:`tapndrag`) does not begin a hold
291 **hold begin** followed by a **hold end** event. Callers **must not** use
292 hold gestures for their own tap-to-click implementation as the data is not
294 depending on whether tap-to-click is enabled and the hold gesture event may