Debian Codegraph @

doc/user/drag-3fg.rst

raw
1 .. _drag_3fg:
2
3 ==============================================================================
4 Three-finger drag
5 ==============================================================================
6
7 Three-finger drag is a feature available on touchpads that emulates logical
8 button presses if three fingers are moving on the touchpad.
9
10 Three-finger drag is independent from :ref:`tapping` though some specific
11 behaviors may change when both features are enabled. For example, with
12 tapping *disabled* a three-finger gesture will virtually always be a three-finger
13 drag. With tapping *enabled* a three finger gesture may be a three finger drag
14 and a short delay is required to disambiguate between the two.
15
16
17 The exact behavior of three-finger drag is implementation defined and may
18 subtly change. As a general rule, the following constraints can be expected:
19
20 - three fingers down and movement trigger a button down and subsequent motion
21 events (i.e. a drag)
22 - releasing one finger while keeping two fingers down will keep the drag
23 and *not* switch to :ref:`twofinger_scrolling`.
24 - releasing two fingers while keeping one finger down will end the drag
25 (and thus release the button) and switch to normal pointer motion
26 - releasing all three fingers and putting three fingers back on the touchpad
27 immediately will keep the drag (i.e. behave as if the fingers were
28 never lifted)
29
30 - if tapping is enabled: a three finger tap immediately after a three-finger
31 drag will *not* tap, the user needs to wait past the timeout to
32 three-finger tap
33
34 - releasing all three fingers and putting one or two fingers back on
35 the touchpad will end the drag (and thus release the button)
36 and proceed with pointer motion or two-finger scrolling, if applicable
37
38 - if tapping is enabled: a one or two finger tap immediately after a
39 three-finger drag will trigger a one or two finger tap. The user does
40 not have to wait past the drag release timeout