aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorPo Lu2023-10-02 15:38:30 +0800
committerPo Lu2023-10-02 15:38:30 +0800
commitad2bb3e9f36d1a4f25e1e2228586331b40a30a46 (patch)
tree8acee39df39d07b131ff38832d63c8d55fe9a976 /doc
parentdb704687bb9992212cec0d5435f6dcd75161e229 (diff)
downloademacs-ad2bb3e9f36d1a4f25e1e2228586331b40a30a46.tar.gz
emacs-ad2bb3e9f36d1a4f25e1e2228586331b40a30a46.zip
Properly translate touch screen events into mouse drag ones
* doc/lispref/commands.texi (Drag Events): Correct misleading example form and reword subsequent elaboration. * lisp/touch-screen.el (touch-screen-handle-point-up) <mouse-drag>: Set posns representing drag start and terminus to mouse position lists, in lieu of pairs between windows and posns employed previously.
Diffstat (limited to 'doc')
-rw-r--r--doc/lispref/commands.texi17
1 files changed, 8 insertions, 9 deletions
diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index a69879c30a9..6601135cb85 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -1854,20 +1854,19 @@ represented in Lisp as lists. The lists record both the starting mouse
1854position and the final position, like this: 1854position and the final position, like this:
1855 1855
1856@example 1856@example
1857(@var{event-type} 1857(@var{event-type} @var{start-position} @var{end-position})
1858 (@var{window1} START-POSITION)
1859 (@var{window2} END-POSITION))
1860@end example 1858@end example
1861 1859
1862For a drag event, the name of the symbol @var{event-type} contains the 1860For a drag event, the name of the symbol @var{event-type} contains the
1863prefix @samp{drag-}. For example, dragging the mouse with button 2 1861prefix @samp{drag-}. For example, dragging the mouse with button 2
1864held down generates a @code{drag-mouse-2} event. The second and third 1862held down generates a @code{drag-mouse-2} event. The second and third
1865elements of the event give the starting and ending position of the 1863elements of the event, @var{start-position} and @var{end-position} in
1866drag, as mouse position lists (@pxref{Click Events}). You can access 1864the foregoing illustration, are set to the start and end positions of
1867the second element of any mouse event in the same way. However, the 1865the drag as mouse position lists (@pxref{Click Events}). You can
1868drag event may end outside the boundaries of the frame that was 1866access the second element of any mouse event in the same way.
1869initially selected. In that case, the third element's position list 1867However, the drag event may end outside the boundaries of the frame
1870contains that frame in place of a window. 1868that was initially selected. In that case, the third element's
1869position list contains that frame in place of a window.
1871 1870
1872The @samp{drag-} prefix follows the modifier key prefixes such as 1871The @samp{drag-} prefix follows the modifier key prefixes such as
1873@samp{C-} and @samp{M-}. 1872@samp{C-} and @samp{M-}.