428
|
1 ;;; toolbar.el --- Toolbar support for XEmacs
|
|
2
|
|
3 ;; Copyright (C) 1995, 1997 Free Software Foundation, Inc.
|
771
|
4 ;; Copyright (C) 2002 Ben Wing.
|
428
|
5
|
|
6 ;; Maintainer: XEmacs Development Team
|
|
7 ;; Keywords: extensions, internal, dumped
|
|
8
|
|
9 ;; This file is part of XEmacs.
|
|
10
|
|
11 ;; XEmacs is free software; you can redistribute it and/or modify it
|
|
12 ;; under the terms of the GNU General Public License as published by
|
|
13 ;; the Free Software Foundation; either version 2, or (at your option)
|
|
14 ;; any later version.
|
|
15
|
|
16 ;; XEmacs is distributed in the hope that it will be useful, but
|
|
17 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
19 ;; General Public License for more details.
|
|
20
|
|
21 ;; You should have received a copy of the GNU General Public License
|
|
22 ;; along with XEmacs; see the file COPYING. If not, write to the
|
|
23 ;; Free Software Foundation, 59 Temple Place - Suite 330,
|
|
24 ;; Boston, MA 02111-1307, USA.
|
|
25
|
|
26 ;;; Synched up with: Not in FSF.
|
|
27
|
|
28 ;;; Commentary:
|
|
29
|
|
30 ;; This file is dumped with XEmacs (when toolbar support is compiled in).
|
|
31
|
|
32 ;;; Code:
|
|
33
|
|
34 (defcustom toolbar-visible-p ;; added for the options menu - dverna apr. 98
|
|
35 (specifier-instance default-toolbar-visible-p)
|
763
|
36 "*Whether the default toolbar is globally visible.
|
771
|
37 This option only has an effect when set using `customize-set-variable',
|
|
38 or through the Options menu."
|
428
|
39 :group 'display
|
|
40 :type 'boolean
|
|
41 :set #'(lambda (var val)
|
|
42 (set-specifier default-toolbar-visible-p val)
|
|
43 (setq toolbar-visible-p val))
|
|
44 )
|
|
45
|
|
46 (defcustom toolbar-captioned-p ;; added for the options menu - dverna apr. 98
|
|
47 (specifier-instance toolbar-buttons-captioned-p)
|
763
|
48 "*Whether the toolbars buttons are globally captioned.
|
771
|
49 This option only has an effect when set using `customize-set-variable',
|
|
50 or through the Options menu."
|
428
|
51 :group 'display
|
|
52 :type 'boolean
|
|
53 :set #'(lambda (var val)
|
|
54 (set-specifier toolbar-buttons-captioned-p val)
|
|
55 (setq toolbar-captioned-p val))
|
|
56 )
|
|
57
|
|
58 (defcustom default-toolbar-position ;; added for the options menu - dverna
|
|
59 (default-toolbar-position)
|
771
|
60 "*The location of the default toolbar: 'top, 'bottom, 'left or 'right.
|
|
61 This option only has an effect when set using `customize-set-variable',
|
|
62 or through the Options menu."
|
428
|
63 :group 'display
|
442
|
64 :type '(choice (const :tag "top" top)
|
|
65 (const :tag "bottom" bottom)
|
|
66 (const :tag "left" left)
|
|
67 (const :tag "right" right))
|
428
|
68 :set #'(lambda (var val)
|
763
|
69 (let* ((height (window-height))
|
|
70 (hdiff (- (frame-height) height))
|
|
71 (width (window-width)))
|
|
72 (set-default-toolbar-position val)
|
|
73 (setq default-toolbar-position val)
|
|
74 ;; needed or dimensions don't update?
|
|
75 (redisplay-frame)
|
|
76 ;; This probably only works correctly if there is only one
|
|
77 ;; Emacs window. If windows are split, it probably results in
|
|
78 ;; small adjustments in their sizes.
|
|
79 (set-frame-size (selected-frame) width (+ height hdiff))
|
767
|
80 )))
|
428
|
81
|
|
82 (defvar toolbar-help-enabled t
|
|
83 "If non-nil help is echoed for toolbar buttons.")
|
|
84
|
|
85 (defvar toolbar-icon-directory nil
|
|
86 "Location of standard toolbar icon bitmaps.")
|
|
87
|
|
88 (defun toolbar-make-button-list (up &optional down disabled cap-up cap-down cap-disabled)
|
|
89 "Call make-glyph on each arg and return a list of the results."
|
|
90 (let ((up-glyph (make-glyph up))
|
|
91 (down-glyph (and down (make-glyph down)))
|
|
92 (disabled-glyph (and disabled (make-glyph disabled)))
|
|
93 (cap-up-glyph (and cap-up (make-glyph cap-up)))
|
|
94 (cap-down-glyph (and cap-down (make-glyph cap-down)))
|
|
95 (cap-disabled-glyph (and cap-disabled (make-glyph cap-disabled))))
|
|
96 (if cap-disabled
|
|
97 (list up-glyph down-glyph disabled-glyph
|
|
98 cap-up-glyph cap-down-glyph cap-disabled-glyph)
|
|
99 (if cap-down
|
|
100 (list up-glyph down-glyph disabled-glyph
|
|
101 cap-up-glyph cap-down-glyph)
|
|
102 (if cap-up
|
|
103 (list up-glyph down-glyph disabled-glyph cap-up-glyph)
|
|
104 (if disabled-glyph
|
|
105 (list up-glyph down-glyph disabled-glyph)
|
|
106 (if down-glyph
|
|
107 (list up-glyph down-glyph)
|
|
108 (list up-glyph))))))))
|
|
109
|
|
110 (defun init-toolbar-location ()
|
|
111 (if (not toolbar-icon-directory)
|
|
112 (let ((name (locate-data-directory "toolbar")))
|
|
113 (if name
|
|
114 (setq toolbar-icon-directory
|
|
115 (file-name-as-directory name))))))
|
|
116
|
487
|
117 ;; called from toolbar.c during device and frame initialization
|
428
|
118 (defun init-toolbar-from-resources (locale)
|
|
119 (if (and (featurep 'x)
|
|
120 (not (featurep 'infodock))
|
|
121 (or (eq locale 'global)
|
|
122 (eq 'x (device-or-frame-type locale))))
|
502
|
123 (declare-fboundp (x-init-toolbar-from-resources locale))))
|
428
|
124
|
|
125
|
|
126 ;; #### Is this actually needed or will the code in
|
|
127 ;; default-mouse-motion-handler suffice?
|
|
128 (define-key global-map 'button1up 'release-toolbar-button)
|
|
129
|
|
130 (defvar toolbar-map (let ((m (make-sparse-keymap)))
|
|
131 (set-keymap-name m 'toolbar-map)
|
|
132 m)
|
|
133 "Keymap consulted for mouse-clicks over a toolbar.")
|
|
134
|
|
135 (define-key toolbar-map 'button1 'press-toolbar-button)
|
|
136 (define-key toolbar-map 'button1up 'release-and-activate-toolbar-button)
|
|
137 (defvar last-pressed-toolbar-button nil)
|
|
138 (defvar toolbar-active nil)
|
|
139
|
442
|
140 (defvar toolbar-blank-press-function nil
|
|
141 "Function to call if a blank area of the toolbar is pressed.")
|
|
142
|
428
|
143 ;;
|
|
144 ;; It really sucks that we also have to tie onto
|
|
145 ;; default-mouse-motion-handler to make sliding buttons work right.
|
|
146 ;;
|
|
147 (defun press-toolbar-button (event)
|
|
148 "Press a toolbar button. This only changes its appearance.
|
3061
|
149 Call function stored in `toolbar-blank-press-function', if any, with EVENT as
|
428
|
150 an argument if press is over a blank area of the toolbar."
|
|
151 (interactive "_e")
|
|
152 (setq this-command last-command)
|
|
153 (let ((button (event-toolbar-button event)))
|
|
154 ;; We silently ignore non-buttons. This most likely means we are
|
|
155 ;; over a blank part of the toolbar.
|
|
156 (setq toolbar-active t)
|
|
157 (if (toolbar-button-p button)
|
|
158 (progn
|
|
159 (set-toolbar-button-down-flag button t)
|
|
160 (setq last-pressed-toolbar-button button))
|
|
161 ;; Added by Bob Weiner, Motorola Inc., 10/6/95, to handle
|
|
162 ;; presses on blank portions of toolbars.
|
442
|
163 (when (functionp toolbar-blank-press-function)
|
|
164 (funcall toolbar-blank-press-function event)))))
|
428
|
165
|
|
166 (defun release-and-activate-toolbar-button (event)
|
|
167 "Release a toolbar button and activate its callback.
|
3061
|
168 Call function stored in `toolbar-blank-release-function', if any, with EVENT
|
428
|
169 as an argument if release is over a blank area of the toolbar."
|
|
170 (interactive "_e")
|
|
171 (or (button-release-event-p event)
|
|
172 (error "%s must be invoked by a mouse-release" this-command))
|
|
173 (release-toolbar-button event)
|
|
174 (let ((button (event-toolbar-button event)))
|
|
175 (if (and (toolbar-button-p button)
|
|
176 (toolbar-button-enabled-p button)
|
|
177 (toolbar-button-callback button))
|
|
178 (let ((callback (toolbar-button-callback button)))
|
|
179 (setq this-command callback)
|
|
180 ;; Handle arbitrary functions.
|
|
181 (if (functionp callback)
|
|
182 (if (commandp callback)
|
|
183 (call-interactively callback)
|
|
184 (funcall callback))
|
|
185 (eval callback))))))
|
|
186
|
|
187 ;; If current is not t, then only release the toolbar button stored in
|
|
188 ;; last-pressed-toolbar-button
|
|
189 (defun release-toolbar-button-internal (event current)
|
|
190 (let ((button (event-toolbar-button event)))
|
|
191 (setq zmacs-region-stays t)
|
|
192 (if (and last-pressed-toolbar-button
|
|
193 (not (eq last-pressed-toolbar-button button))
|
|
194 (toolbar-button-p last-pressed-toolbar-button))
|
|
195 (progn
|
|
196 (set-toolbar-button-down-flag last-pressed-toolbar-button nil)
|
|
197 (setq last-pressed-toolbar-button nil)))
|
|
198 (if (and current (toolbar-button-p button))
|
|
199 (set-toolbar-button-down-flag button nil))))
|
|
200
|
|
201 (defun release-toolbar-button (event)
|
|
202 "Release all pressed toolbar buttons."
|
|
203 (interactive "_e")
|
|
204 (or (button-release-event-p event)
|
|
205 (error "%s must be invoked by a mouse-release" this-command))
|
|
206 (release-toolbar-button-internal event t)
|
|
207 ;; Don't set this-command if we're being called
|
|
208 ;; from release-and-activate-toolbar-button.
|
|
209 (if (interactive-p)
|
|
210 (setq this-command last-command))
|
|
211 (setq toolbar-active nil))
|
|
212
|
|
213 (defun release-previous-toolbar-button (event)
|
|
214 (setq zmacs-region-stays t)
|
|
215 (release-toolbar-button-internal event nil))
|
|
216
|
442
|
217 (defun make-toolbar-specifier (spec-list)
|
|
218 "Return a new `toolbar' specifier object with the given specification list.
|
|
219 SPEC-LIST can be a list of specifications (each of which is a cons of a
|
|
220 locale and a list of instantiators), a single instantiator, or a list
|
|
221 of instantiators. See `make-specifier' for more information about
|
|
222 specifiers.
|
|
223
|
|
224 Toolbar specifiers are used to specify the format of a toolbar.
|
|
225 The values of the variables `default-toolbar', `top-toolbar',
|
|
226 `left-toolbar', `right-toolbar', and `bottom-toolbar' are always
|
|
227 toolbar specifiers.
|
|
228
|
|
229 Valid toolbar instantiators are called \"toolbar descriptors\"
|
|
230 and are lists of vectors. See `default-toolbar' for a description
|
|
231 of the exact format."
|
|
232 (make-specifier-and-init 'toolbar spec-list))
|
|
233
|
428
|
234 ;;; toolbar.el ends here
|