Mercurial > emacs
annotate lisp/mouse-drag.el @ 94533:4bc924044f22
Remove unneeded TODO item in comment.
author | Eric S. Raymond <esr@snark.thyrsus.com> |
---|---|
date | Fri, 02 May 2008 03:23:53 +0000 |
parents | 075e26db0a2f |
children | ee5932bf781d |
rev | line source |
---|---|
17517 | 1 ;;; mouse-drag.el --- use mouse-2 to do a new style of scrolling |
2 | |
64762
41bb365f41c4
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64091
diff
changeset
|
3 ;; Copyright (C) 1996, 1997, 2001, 2002, 2003, 2004, |
79721 | 4 ;; 2005, 2006, 2007, 2008 Free Software Foundation, Inc. |
16319 | 5 |
16322 | 6 ;; Author: John Heidemann <johnh@ISI.EDU> |
7 ;; Keywords: mouse | |
16319 | 8 |
9 ;; This file is part of GNU Emacs. | |
10 | |
11 ;; GNU Emacs is free software; you can redistribute it and/or modify | |
12 ;; it under the terms of the GNU General Public License as published by | |
78236
9355f9b7bbff
Switch license to GPLv3 or later.
Glenn Morris <rgm@gnu.org>
parents:
75347
diff
changeset
|
13 ;; the Free Software Foundation; either version 3, or (at your option) |
16319 | 14 ;; any later version. |
15 | |
16 ;; GNU Emacs is distributed in the hope that it will be useful, | |
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
19 ;; GNU General Public License for more details. | |
20 | |
21 ;; You should have received a copy of the GNU General Public License | |
22 ;; along with GNU Emacs; see the file COPYING. If not, write to the | |
64091 | 23 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
24 ;; Boston, MA 02110-1301, USA. | |
16319 | 25 |
26 ;;; Commentary: | |
27 | |
94100
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
28 ;; What is ``mouse-drag.el''? |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
29 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
30 ;; Doesn't that scroll bar seem far away when you want to scroll? |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
31 ;; This module overloads mouse-2 to do ``throw'' scrolling. You |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
32 ;; click and drag. The distance you move from your original click |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
33 ;; turns into a scroll amount. The scroll amount is scaled |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
34 ;; exponentially to make both large moves and short adjustments easy. |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
35 ;; What this boils down to is that you can easily scroll around the |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
36 ;; buffer without much mouse movement. Finally, clicks which aren't |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
37 ;; drags are passed off to the old mouse-2 binding, so old mouse-2 |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
38 ;; operations (find-file in dired-mode, yanking in most other modes) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
39 ;; still work. |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
40 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
41 ;; There is an alternative way to scroll, ``drag'' scrolling. You |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
42 ;; can click on a character and then drag it around, scrolling the |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
43 ;; buffer with you. The character always stays under the mouse. |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
44 ;; Compared to throw-scrolling, this approach provides direct |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
45 ;; manipulation (nice) but requires more mouse movement |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
46 ;; (unfortunate). It is offered as an alternative for those who |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
47 ;; prefer it. |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
48 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
49 ;; If you like mouse-drag, you should also check out mouse-copy |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
50 ;; for ``one-click text copy and move''. |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
51 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
52 ;; To use mouse-drag, place the following in your .emacs file: |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
53 ;; (require 'mouse-drag) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
54 ;; -and either- |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
55 ;; (global-set-key [down-mouse-2] 'mouse-drag-throw) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
56 ;; -or- |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
57 ;; (global-set-key [down-mouse-2] 'mouse-drag-drag) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
58 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
59 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
60 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
61 ;; Options: |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
62 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
63 ;; - reverse the throw-scroll direction with \\[mouse-throw-with-scroll-bar] |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
64 ;; - work around a bug with \\[mouse-extras-work-around-drag-bug] |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
65 ;; - auto-enable horizontal scrolling with |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
66 ;; \\[mouse-drag-electric-col-scrolling] |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
67 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
68 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
69 ;; History and related work: |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
70 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
71 ;; One-click copying and moving was inspired by lemacs-19.8. |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
72 ;; Throw-scrolling was inspired by MacPaint's ``hand'' and by Tk's |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
73 ;; mouse-2 scrolling. The package mouse-scroll.el by Tom Wurgler |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
74 ;; <twurgler@goodyear.com> is similar to mouse-drag-throw, but |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
75 ;; doesn't pass clicks through. |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
76 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
77 ;; These functions have been tested in emacs version 19.30, |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
78 ;; and this package has run in the past on 19.25-19.29. |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
79 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
80 ;; Originally mouse-drag was part of a larger package. |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
81 ;; As of 11 July 96 the scrolling functions were split out |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
82 ;; in preparation for incorporation into (the future) emacs-19.32. |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
83 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
84 ;; Thanks: |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
85 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
86 ;; Thanks to Kai Grossjohann |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
87 ;; <grossjoh@dusty.informatik.uni-dortmund.de> for reporting bugs, to |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
88 ;; Tom Wurgler <twurgler@goodyear.com> for reporting bugs and |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
89 ;; suggesting fixes, and to Joel Graber <jgraber@ti.com> for |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
90 ;; prompting me to do drag-scrolling and for an initial |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
91 ;; implementation of horizontal drag-scrolling. |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
92 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
93 ;; -johnh@isi.edu, 11-Jul-96 |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
94 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
95 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
96 ;; What's new with mouse-drag 2.24? |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
97 ;; |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
98 ;; - mouse-drag-electric-col-scrolling (default: on) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
99 ;; auto-enables horizontal scrolling when clicks on wrapped |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
100 ;; lines occur |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
101 |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
102 ;; TODO: |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
103 ;; - For mouse-drag-throw, we should try and place some visual indicator |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
104 ;; of the original mouse position (like Firefox does). |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
105 |
16319 | 106 ;;; Code: |
107 | |
108 ;; | |
109 ;; scrolling code | |
110 ;; | |
111 | |
112 (defun mouse-drag-safe-scroll (row-delta &optional col-delta) | |
18134
2441b667abdd
(mouse-drag-safe-scroll): Doc fix.
Karl Heuer <kwzh@gnu.org>
parents:
18026
diff
changeset
|
113 "Scroll down ROW-DELTA lines and right COL-DELTA, ignoring buffer edge errors. |
16319 | 114 Keep the cursor on the screen as needed." |
35085
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
115 (let ((scroll-preserve-screen-position nil)) |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
116 (if (and row-delta |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
117 (/= 0 row-delta)) |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
118 (condition-case nil ;; catch and ignore movement errors |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
119 (scroll-down row-delta) |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
120 (beginning-of-buffer (message "Beginning of buffer")) |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
121 (end-of-buffer (message "End of buffer")))) |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
122 (if (and col-delta |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
123 (/= 0 col-delta)) |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
124 (progn |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
125 (scroll-right col-delta) |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
126 ;; Make sure that the point stays on the visible screen |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
127 ;; (if truncation-lines in set). |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
128 ;; This code mimics the behavior we automatically get |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
129 ;; when doing vertical scrolling. |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
130 ;; Problem identified and a fix suggested by Tom Wurgler. |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
131 (cond |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
132 ((< (current-column) (window-hscroll)) |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
133 (move-to-column (window-hscroll))) ; make on left column |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
134 ((> (- (current-column) (window-hscroll) (window-width) -2) 0) |
acc3474759c0
(mouse-drag-safe-scroll): Bind
Gerd Moellmann <gerd@gnu.org>
parents:
18134
diff
changeset
|
135 (move-to-column (+ (window-width) (window-hscroll) -3)))))))) |
16319 | 136 |
137 (defun mouse-drag-repeatedly-safe-scroll (row-delta &optional col-delta) | |
18134
2441b667abdd
(mouse-drag-safe-scroll): Doc fix.
Karl Heuer <kwzh@gnu.org>
parents:
18026
diff
changeset
|
138 "Scroll ROW-DELTA rows and COL-DELTA cols until an event happens." |
16319 | 139 (while (sit-for mouse-scroll-delay) |
140 (mouse-drag-safe-scroll row-delta col-delta))) | |
141 | |
142 (defun mouse-drag-events-are-point-events-p (start-posn end-posn) | |
18134
2441b667abdd
(mouse-drag-safe-scroll): Doc fix.
Karl Heuer <kwzh@gnu.org>
parents:
18026
diff
changeset
|
143 "Determine if START-POSN and END-POSN are \"close\"." |
16319 | 144 (let* |
145 ((start-col-row (posn-col-row start-posn)) | |
146 (end-col-row (posn-col-row end-posn))) | |
147 (and | |
94100
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
148 ;; ;; We no longer exclude things by time. |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
149 ;; (< (- (posn-timestamp end-posn) (posn-timestamp start-posn)) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
150 ;; (if (numberp double-click-time) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
151 ;; (* 2 double-click-time) ;; stretch it a little |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
152 ;; 999999)) ;; non-numeric => check by position alone |
16319 | 153 (= (car start-col-row) (car end-col-row)) |
154 (= (cdr start-col-row) (cdr end-col-row))))) | |
155 | |
18026
e3b0e7dc5efd
* mouse-drag.el (mouse-drag-electric-col-scrolling): New variable;
Karl Heuer <kwzh@gnu.org>
parents:
17517
diff
changeset
|
156 (defvar mouse-drag-electric-col-scrolling t |
e3b0e7dc5efd
* mouse-drag.el (mouse-drag-electric-col-scrolling): New variable;
Karl Heuer <kwzh@gnu.org>
parents:
17517
diff
changeset
|
157 "If non-nil, mouse-drag on a long line enables truncate-lines.") |
e3b0e7dc5efd
* mouse-drag.el (mouse-drag-electric-col-scrolling): New variable;
Karl Heuer <kwzh@gnu.org>
parents:
17517
diff
changeset
|
158 |
16319 | 159 (defun mouse-drag-should-do-col-scrolling () |
18134
2441b667abdd
(mouse-drag-safe-scroll): Doc fix.
Karl Heuer <kwzh@gnu.org>
parents:
18026
diff
changeset
|
160 "Determine if it's wise to enable col-scrolling for the current window. |
18026
e3b0e7dc5efd
* mouse-drag.el (mouse-drag-electric-col-scrolling): New variable;
Karl Heuer <kwzh@gnu.org>
parents:
17517
diff
changeset
|
161 Basically, we check for existing horizontal scrolling." |
16319 | 162 (or truncate-lines |
163 (> (window-hscroll (selected-window)) 0) | |
78463
ad7b04a38ce4
Use window-full-width-p instead of comparing frame-width and
Martin Rudalics <rudalics@gmx.at>
parents:
78236
diff
changeset
|
164 (not (window-full-width-p)) |
18026
e3b0e7dc5efd
* mouse-drag.el (mouse-drag-electric-col-scrolling): New variable;
Karl Heuer <kwzh@gnu.org>
parents:
17517
diff
changeset
|
165 (and |
e3b0e7dc5efd
* mouse-drag.el (mouse-drag-electric-col-scrolling): New variable;
Karl Heuer <kwzh@gnu.org>
parents:
17517
diff
changeset
|
166 mouse-drag-electric-col-scrolling |
e3b0e7dc5efd
* mouse-drag.el (mouse-drag-electric-col-scrolling): New variable;
Karl Heuer <kwzh@gnu.org>
parents:
17517
diff
changeset
|
167 (save-excursion ;; on a long line? |
e3b0e7dc5efd
* mouse-drag.el (mouse-drag-electric-col-scrolling): New variable;
Karl Heuer <kwzh@gnu.org>
parents:
17517
diff
changeset
|
168 (let |
e3b0e7dc5efd
* mouse-drag.el (mouse-drag-electric-col-scrolling): New variable;
Karl Heuer <kwzh@gnu.org>
parents:
17517
diff
changeset
|
169 ((beg (progn (beginning-of-line) (point))) |
e3b0e7dc5efd
* mouse-drag.el (mouse-drag-electric-col-scrolling): New variable;
Karl Heuer <kwzh@gnu.org>
parents:
17517
diff
changeset
|
170 (end (progn (end-of-line) (point)))) |
e3b0e7dc5efd
* mouse-drag.el (mouse-drag-electric-col-scrolling): New variable;
Karl Heuer <kwzh@gnu.org>
parents:
17517
diff
changeset
|
171 (if (> (- end beg) (window-width)) |
e3b0e7dc5efd
* mouse-drag.el (mouse-drag-electric-col-scrolling): New variable;
Karl Heuer <kwzh@gnu.org>
parents:
17517
diff
changeset
|
172 (setq truncate-lines t) |
e3b0e7dc5efd
* mouse-drag.el (mouse-drag-electric-col-scrolling): New variable;
Karl Heuer <kwzh@gnu.org>
parents:
17517
diff
changeset
|
173 nil)))))) |
16319 | 174 |
175 (defvar mouse-throw-with-scroll-bar nil | |
18134
2441b667abdd
(mouse-drag-safe-scroll): Doc fix.
Karl Heuer <kwzh@gnu.org>
parents:
18026
diff
changeset
|
176 "*Set direction of mouse-throwing. |
16319 | 177 If nil, the text moves in the direction the mouse moves. |
178 If t, the scroll bar moves in the direction the mouse moves.") | |
179 (defconst mouse-throw-magnifier-min -6) | |
180 (defconst mouse-throw-magnifier-max 6) | |
94100
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
181 (defconst mouse-throw-magnifier-base 1.5) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
182 |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
183 (defun mouse-drag-scroll-delta (mouse-delta) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
184 ;; Limit the exponential explosion. |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
185 (setq mouse-delta |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
186 (max mouse-throw-magnifier-min |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
187 (min mouse-throw-magnifier-max mouse-delta))) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
188 (* (round (exp (* (log mouse-throw-magnifier-base) (abs mouse-delta)))) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
189 (if (< mouse-delta 0) -1 1) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
190 (if mouse-throw-with-scroll-bar 1 -1))) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
191 |
16319 | 192 |
193 (defun mouse-drag-throw (start-event) | |
194 "\"Throw\" the page according to a mouse drag. | |
195 | |
196 A \"throw\" is scrolling the page at a speed relative to the distance | |
197 from the original mouse click to the current mouse location. Try it; | |
198 you'll like it. It's easier to observe than to explain. | |
199 | |
200 If the mouse is clicked and released in the same place of time we | |
201 assume that the user didn't want to scdebugroll but wanted to whatever | |
202 mouse-2 used to do, so we pass it through. | |
203 | |
204 Throw scrolling was inspired (but is not identical to) the \"hand\" | |
205 option in MacPaint, or the middle button in Tk text widgets. | |
206 | |
207 If `mouse-throw-with-scroll-bar' is non-nil, then this command scrolls | |
208 in the opposite direction. (Different people have different ideas | |
209 about which direction is natural. Perhaps it has to do with which | |
210 hemisphere you're in.) | |
211 | |
212 To test this function, evaluate: | |
213 (global-set-key [down-mouse-2] 'mouse-drag-throw)" | |
214 (interactive "e") | |
215 ;; we want to do save-selected-window, but that requires 19.29 | |
216 (let* ((start-posn (event-start start-event)) | |
217 (start-window (posn-window start-posn)) | |
218 (start-row (cdr (posn-col-row start-posn))) | |
219 (start-col (car (posn-col-row start-posn))) | |
220 (old-selected-window (selected-window)) | |
221 event end row mouse-delta scroll-delta | |
41217
096bd345e996
(mouse-drag-throw): Push back non-drag events
Richard M. Stallman <rms@gnu.org>
parents:
35141
diff
changeset
|
222 have-scrolled |
16319 | 223 window-last-row |
224 col mouse-col-delta window-last-col | |
225 (scroll-col-delta 0) | |
226 adjusted-mouse-col-delta | |
16320
56f494ed6b13
(mouse-drag-throw): Bind adjusted-mouse-delta.
Richard M. Stallman <rms@gnu.org>
parents:
16319
diff
changeset
|
227 adjusted-mouse-delta |
16319 | 228 ;; be conservative about allowing horizontal scrolling |
229 (col-scrolling-p (mouse-drag-should-do-col-scrolling))) | |
230 (select-window start-window) | |
231 (track-mouse | |
232 (while (progn | |
233 (setq event (read-event) | |
234 end (event-end event) | |
235 row (cdr (posn-col-row end)) | |
236 col (car (posn-col-row end))) | |
237 (or (mouse-movement-p event) | |
238 (eq (car-safe event) 'switch-frame))) | |
94100
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
239 (when (eq start-window (posn-window end)) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
240 (when col-scrolling-p |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
241 (setq scroll-col-delta (mouse-drag-scroll-delta (- start-col col)))) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
242 (setq scroll-delta (mouse-drag-scroll-delta (- start-row row)))) |
90fb63bd51c8
(mouse-throw-magnifier-with-scroll-bar)
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
93975
diff
changeset
|
243 |
16319 | 244 (if (or (/= 0 scroll-delta) |
245 (/= 0 scroll-col-delta)) | |
246 (progn | |
247 (setq have-scrolled t) | |
248 (mouse-drag-safe-scroll scroll-delta scroll-col-delta) | |
249 (mouse-drag-repeatedly-safe-scroll scroll-delta scroll-col-delta))))) ;xxx | |
250 ;; If it was a click and not a drag, prepare to pass the event on. | |
41217
096bd345e996
(mouse-drag-throw): Push back non-drag events
Richard M. Stallman <rms@gnu.org>
parents:
35141
diff
changeset
|
251 ;; Is there a more correct way to reconstruct the event? |
16319 | 252 (if (and (not have-scrolled) |
253 (mouse-drag-events-are-point-events-p start-posn end)) | |
41217
096bd345e996
(mouse-drag-throw): Push back non-drag events
Richard M. Stallman <rms@gnu.org>
parents:
35141
diff
changeset
|
254 (push (cons (event-basic-type start-event) (cdr start-event)) |
096bd345e996
(mouse-drag-throw): Push back non-drag events
Richard M. Stallman <rms@gnu.org>
parents:
35141
diff
changeset
|
255 unread-command-events)) |
16319 | 256 ;; Now restore the old window. |
41217
096bd345e996
(mouse-drag-throw): Push back non-drag events
Richard M. Stallman <rms@gnu.org>
parents:
35141
diff
changeset
|
257 (select-window old-selected-window))) |
16319 | 258 |
259 (defun mouse-drag-drag (start-event) | |
260 "\"Drag\" the page according to a mouse drag. | |
261 | |
262 Drag scrolling moves the page according to the movement of the mouse. | |
263 You \"grab\" the character under the mouse and move it around. | |
264 | |
265 If the mouse is clicked and released in the same place of time we | |
266 assume that the user didn't want to scroll but wanted to whatever | |
267 mouse-2 used to do, so we pass it through. | |
268 | |
269 Drag scrolling is identical to the \"hand\" option in MacPaint, or the | |
270 middle button in Tk text widgets. | |
271 | |
272 To test this function, evaluate: | |
273 (global-set-key [down-mouse-2] 'mouse-drag-drag)" | |
274 (interactive "e") | |
275 ;; we want to do save-selected-window, but that requires 19.29 | |
276 (let* ((start-posn (event-start start-event)) | |
277 (start-window (posn-window start-posn)) | |
278 (start-row (cdr (posn-col-row start-posn))) | |
279 (start-col (car (posn-col-row start-posn))) | |
280 (old-selected-window (selected-window)) | |
281 event end row mouse-delta scroll-delta | |
41217
096bd345e996
(mouse-drag-throw): Push back non-drag events
Richard M. Stallman <rms@gnu.org>
parents:
35141
diff
changeset
|
282 have-scrolled |
16319 | 283 window-last-row |
284 col mouse-col-delta window-last-col | |
285 (scroll-col-delta 0) | |
286 ;; be conservative about allowing horizontal scrolling | |
287 (col-scrolling-p (mouse-drag-should-do-col-scrolling))) | |
288 (select-window start-window) | |
289 (setq window-last-row (- (window-height) 2) | |
290 window-last-col (- (window-width) 2)) | |
291 (track-mouse | |
292 (while (progn | |
293 (setq event (read-event) | |
294 end (event-end event) | |
295 row (cdr (posn-col-row end)) | |
296 col (car (posn-col-row end))) | |
297 (or (mouse-movement-p event) | |
298 (eq (car-safe event) 'switch-frame))) | |
299 ;; Scroll if see if we're on the edge. | |
300 ;; NEEDSWORK: should handle mouse-in-other window. | |
301 (cond | |
302 ((not (eq start-window (posn-window end))) | |
303 t) ; wait for return to original window | |
304 ((<= row 0) (mouse-drag-repeatedly-safe-scroll -1 0)) | |
305 ((>= row window-last-row) (mouse-drag-repeatedly-safe-scroll 1 0)) | |
306 ((and col-scrolling-p (<= col 1)) (mouse-drag-repeatedly-safe-scroll 0 -1)) | |
307 ((and col-scrolling-p (>= col window-last-col)) (mouse-drag-repeatedly-safe-scroll 0 1)) | |
308 (t | |
309 (setq scroll-delta (- row start-row) | |
310 start-row row) | |
311 (if col-scrolling-p | |
312 (setq scroll-col-delta (- col start-col) | |
313 start-col col)) | |
314 (if (or (/= 0 scroll-delta) | |
315 (/= 0 scroll-col-delta)) | |
316 (progn | |
317 (setq have-scrolled t) | |
318 (mouse-drag-safe-scroll scroll-delta scroll-col-delta))))))) | |
319 ;; If it was a click and not a drag, prepare to pass the event on. | |
41217
096bd345e996
(mouse-drag-throw): Push back non-drag events
Richard M. Stallman <rms@gnu.org>
parents:
35141
diff
changeset
|
320 ;; Is there a more correct way to reconstruct the event? |
16319 | 321 (if (and (not have-scrolled) |
322 (mouse-drag-events-are-point-events-p start-posn end)) | |
41217
096bd345e996
(mouse-drag-throw): Push back non-drag events
Richard M. Stallman <rms@gnu.org>
parents:
35141
diff
changeset
|
323 (push (cons (event-basic-type start-event) (cdr start-event)) |
096bd345e996
(mouse-drag-throw): Push back non-drag events
Richard M. Stallman <rms@gnu.org>
parents:
35141
diff
changeset
|
324 unread-command-events)) |
16319 | 325 ;; Now restore the old window. |
41217
096bd345e996
(mouse-drag-throw): Push back non-drag events
Richard M. Stallman <rms@gnu.org>
parents:
35141
diff
changeset
|
326 (select-window old-selected-window))) |
096bd345e996
(mouse-drag-throw): Push back non-drag events
Richard M. Stallman <rms@gnu.org>
parents:
35141
diff
changeset
|
327 |
16319 | 328 |
329 (provide 'mouse-drag) | |
330 | |
93975
1e3a407766b9
Fix up comment convention on the arch-tag lines.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
79721
diff
changeset
|
331 ;; arch-tag: e47354ff-82f5-42c4-b3dc-88dd9c04b770 |
16319 | 332 ;;; mouse-drag.el ends here |