diff options
| author | Po Lu | 2023-10-02 15:38:30 +0800 |
|---|---|---|
| committer | Po Lu | 2023-10-02 15:38:30 +0800 |
| commit | ad2bb3e9f36d1a4f25e1e2228586331b40a30a46 (patch) | |
| tree | 8acee39df39d07b131ff38832d63c8d55fe9a976 /doc | |
| parent | db704687bb9992212cec0d5435f6dcd75161e229 (diff) | |
| download | emacs-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.texi | 17 |
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 | |||
| 1854 | position and the final position, like this: | 1854 | position 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 | ||
| 1862 | For a drag event, the name of the symbol @var{event-type} contains the | 1860 | For a drag event, the name of the symbol @var{event-type} contains the |
| 1863 | prefix @samp{drag-}. For example, dragging the mouse with button 2 | 1861 | prefix @samp{drag-}. For example, dragging the mouse with button 2 |
| 1864 | held down generates a @code{drag-mouse-2} event. The second and third | 1862 | held down generates a @code{drag-mouse-2} event. The second and third |
| 1865 | elements of the event give the starting and ending position of the | 1863 | elements of the event, @var{start-position} and @var{end-position} in |
| 1866 | drag, as mouse position lists (@pxref{Click Events}). You can access | 1864 | the foregoing illustration, are set to the start and end positions of |
| 1867 | the second element of any mouse event in the same way. However, the | 1865 | the drag as mouse position lists (@pxref{Click Events}). You can |
| 1868 | drag event may end outside the boundaries of the frame that was | 1866 | access the second element of any mouse event in the same way. |
| 1869 | initially selected. In that case, the third element's position list | 1867 | However, the drag event may end outside the boundaries of the frame |
| 1870 | contains that frame in place of a window. | 1868 | that was initially selected. In that case, the third element's |
| 1869 | position list contains that frame in place of a window. | ||
| 1871 | 1870 | ||
| 1872 | The @samp{drag-} prefix follows the modifier key prefixes such as | 1871 | The @samp{drag-} prefix follows the modifier key prefixes such as |
| 1873 | @samp{C-} and @samp{M-}. | 1872 | @samp{C-} and @samp{M-}. |