annotate lisp/menubar.el @ 331:c9ae480b1fff r21-0-63

Import from CVS: tag r21-0-63
author cvs
date Mon, 13 Aug 2007 10:49:07 +0200
parents 19dcec799385
children cc15677e0335
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
1 ;;; menubar.el --- Menubar support for XEmacs
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
2
259
11cf20601dec Import from CVS: tag r20-5b28
cvs
parents: 241
diff changeset
3 ;; Copyright (C) 1991-4, 1997-1998 Free Software Foundation, Inc.
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
4 ;; Copyright (C) 1995 Tinker Systems and INS Engineering Corp.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
5 ;; Copyright (C) 1995, 1996 Ben Wing.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
6
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
7 ;; Maintainer: XEmacs Development Team
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
8 ;; Keywords: internal, extensions, dumped
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
9
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
10 ;; This file is part of XEmacs.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
11
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
12 ;; XEmacs is free software; you can redistribute it and/or modify it
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
13 ;; under the terms of the GNU General Public License as published by
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
14 ;; the Free Software Foundation; either version 2, or (at your option)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
15 ;; any later version.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
16
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
17 ;; XEmacs is distributed in the hope that it will be useful, but
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
18 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
20 ;; General Public License for more details.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
21
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
22 ;; You should have received a copy of the GNU General Public License
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
23 ;; along with XEmacs; see the file COPYING. If not, write to the
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
24 ;; Free Software Foundation, 59 Temple Place - Suite 330,
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
25 ;; Boston, MA 02111-1307, USA.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
26
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
27 ;;; Synched up with: Not in FSF. (Completely divergent from FSF menu-bar.el)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
28
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
29 ;;; Commentary:
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
30
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
31 ;; This file is dumped with XEmacs (when menubar support is compiled in).
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
32
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
33 ;; Some stuff in FSF menu-bar.el is in x-menubar.el
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
34
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
35 ;;; Code:
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
36
227
0e522484dd2a Import from CVS: tag r20-5b12
cvs
parents: 225
diff changeset
37 (defgroup menu nil
0e522484dd2a Import from CVS: tag r20-5b12
cvs
parents: 225
diff changeset
38 "Input from the menus."
0e522484dd2a Import from CVS: tag r20-5b12
cvs
parents: 225
diff changeset
39 :group 'environment)
0e522484dd2a Import from CVS: tag r20-5b12
cvs
parents: 225
diff changeset
40
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
41 (defvar default-menubar nil)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
42
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
43 ;; this function is considered "part of the lexicon" by many,
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
44 ;; so we'll leave it here.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
45 (defun kill-this-buffer () ; for the menubar
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
46 "Kill the current buffer."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
47 (interactive)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
48 (kill-buffer (current-buffer)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
49
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
50 (defun set-menubar-dirty-flag ()
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
51 "Tell XEmacs that the menubar has to be updated.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
52 NOTE: XEmacs now recognizes when you set a different value for
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
53 `current-menubar'. You *only* need to call this function if you
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
54 destructively modify a part of the menubar and don't set `current-menubar'.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
55 Note that all the functions that modify a menu call this automatically."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
56 (setq-default current-menubar (default-value 'current-menubar)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
57
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
58 ;; #### shouldn't this perhaps be `copy-tree'?
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
59 (defun set-menubar (menubar)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
60 "Set the default menubar to be MENUBAR.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
61 See `current-menubar' for a description of the syntax of a menubar."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
62 (check-menu-syntax menubar t)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
63 (setq-default current-menubar (copy-sequence menubar)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
64
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
65 (defun set-buffer-menubar (menubar)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
66 "Set the buffer-local menubar to be MENUBAR.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
67 See `current-menubar' for a description of the syntax of a menubar."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
68 (check-menu-syntax menubar t)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
69 (make-local-variable 'current-menubar)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
70 (setq current-menubar (copy-sequence menubar)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
71
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
72 (defun check-menu-syntax (menu &optional menubar-p)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
73 ;; The C code does syntax checking on the value of `current-menubar',
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
74 ;; but it's better to do it early, before things have gotten messed up.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
75 (if menubar-p
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
76 nil
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
77 (or (stringp (car menu))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
78 (signal 'error
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
79 (list "menu name (first element) must be a string" menu)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
80 ;;(or (cdr menu) (signal 'error (list "menu is empty" menu)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
81 (setq menu (cdr menu)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
82 (let (menuitem item)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
83 (while (keywordp (setq item (car menu)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
84 (or (memq item '(:config :included :filter :accelerator))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
85 (signal 'error
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
86 (list "menu keyword must be :config, :included, :accelerator or :filter"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
87 item)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
88 (if (or (not (cdr menu))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
89 (vectorp (nth 1 menu))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
90 (keywordp (nth 1 menu)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
91 (signal 'error (list "strange keyword value" item (nth 1 menu))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
92 (setq menu (nthcdr 2 menu)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
93 (while menu
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
94 (setq menuitem (car menu))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
95 (cond
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
96 ((stringp menuitem)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
97 (and (string-match "^\\(-+\\|=+\\):\\(.*\\)" menuitem)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
98 (setq item (match-string 2 menuitem))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
99 (or (member item '(;; Motif-compatible
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
100 "singleLine"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
101 "doubleLine"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
102 "singleDashedLine"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
103 "doubleDashedLine"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
104 "noLine"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
105 "shadowEtchedIn"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
106 "shadowEtchedOut"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
107 "shadowEtchedInDash"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
108 "shadowEtchedOutDash"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
109 ;; non-Motif (Lucid menubar widget only)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
110 "shadowDoubleEtchedIn"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
111 "shadowDoubleEtchedOut"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
112 "shadowDoubleEtchedInDash"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
113 "shadowDoubleEtchedOutDash"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
114 ))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
115 (signal 'error (list "bogus separator style in menu item" item)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
116 ))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
117 ((null menuitem)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
118 (or menubar-p
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
119 (signal 'error (list "nil is only permitted in the top level of menubars"))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
120 ((consp menuitem)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
121 (check-menu-syntax menuitem))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
122 ((vectorp menuitem)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
123 (let ((L (length menuitem))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
124 plistp)
259
11cf20601dec Import from CVS: tag r20-5b28
cvs
parents: 241
diff changeset
125 (and (< L 2)
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
126 (signal 'error
259
11cf20601dec Import from CVS: tag r20-5b28
cvs
parents: 241
diff changeset
127 (list "button descriptors must be at least 2 long"
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
128 menuitem)))
259
11cf20601dec Import from CVS: tag r20-5b28
cvs
parents: 241
diff changeset
129 (setq plistp (or (>= L 5)
11cf20601dec Import from CVS: tag r20-5b28
cvs
parents: 241
diff changeset
130 (and (> L 2) (keywordp (aref menuitem 2)))))
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
131 (or (stringp (aref menuitem 0))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
132 (signal 'error
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
133 (list
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
134 "first element of a button must be a string (the label)"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
135 menuitem)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
136 (or plistp
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
137 (< L 4)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
138 (null (aref menuitem 3))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
139 (stringp (aref menuitem 3))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
140 (signal 'error
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
141 (list
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
142 "fourth element of a button must be a string (the label suffix)"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
143 menuitem)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
144 (if plistp
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
145 (let ((i 2)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
146 selp
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
147 style
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
148 item)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
149 (while (< i L)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
150 (setq item (aref menuitem i))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
151 (cond ((not (memq item '(:active :suffix :keys :style
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
152 :full :included :selected
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
153 :accelerator)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
154 (signal 'error
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
155 (list (if (keywordp item)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
156 "unknown menu item keyword"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
157 "not a keyword")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
158 item menuitem)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
159 ((eq item :style)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
160 (setq style (aref menuitem (1+ i)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
161 (or (memq style '(nil toggle radio button text))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
162 (signal 'error (list "unknown style" style
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
163 menuitem))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
164 ((eq item :selected) (setq selp t))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
165 )
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
166 (setq i (+ i (if (eq item :full) 1 2))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
167 (if (and selp (not (memq style '(toggle button radio))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
168 (signal 'error
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
169 (list
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
170 ":selected only makes sense with :style toggle, radio, or button"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
171 menuitem)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
172 )))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
173 )
241
f955c73f5258 Import from CVS: tag r20-5b19
cvs
parents: 227
diff changeset
174 ;; (t (signal 'error (list "unrecognised menu descriptor" menuitem))))
f955c73f5258 Import from CVS: tag r20-5b19
cvs
parents: 227
diff changeset
175 (t (message "unrecognised menu descriptor %s" (prin1-to-string menuitem))))
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
176 (setq menu (cdr menu)))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
177
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
178
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
179 ;;; menu manipulation functions
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
180
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
181 (defun find-menu-item (menubar item-path-list &optional parent)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
182 "Search MENUBAR for item given by ITEM-PATH-LIST starting from PARENT.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
183 Returns (ITEM . PARENT), where PARENT is the immediate parent of
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
184 the item found.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
185 If the item does not exist, the car of the returned value is nil.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
186 If some menu in the ITEM-PATH-LIST does not exist, an error is signalled."
225
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
187 (check-argument-type 'listp item-path-list)
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
188 (unless parent
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
189 (setq item-path-list (mapcar 'normalize-menu-item-name item-path-list)))
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
190 (if (not (consp menubar))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
191 nil
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
192 (let ((rest menubar)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
193 result)
225
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
194 (when (stringp (car rest))
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
195 (setq rest (cdr rest)))
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
196 (while (keywordp (car rest))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
197 (setq rest (cddr rest)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
198 (while rest
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
199 (if (and (car rest)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
200 (equal (car item-path-list)
225
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
201 (normalize-menu-item-name
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
202 (cond ((vectorp (car rest))
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
203 (aref (car rest) 0))
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
204 ((stringp (car rest))
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
205 (car rest))
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
206 (t
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
207 (caar rest))))))
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
208 (setq result (car rest)
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
209 rest nil)
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
210 (setq rest (cdr rest))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
211 (if (cdr item-path-list)
225
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
212 (cond ((consp result)
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
213 (find-menu-item (cdr result) (cdr item-path-list) result))
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
214 (result
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
215 (signal 'error (list (gettext "not a submenu") result)))
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
216 (t
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
217 (signal 'error (list (gettext "no such submenu")
12579d965149 Import from CVS: tag r20-4b11
cvs
parents: 209
diff changeset
218 (car item-path-list)))))
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
219 (cons result parent)))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
220
321
19dcec799385 Import from CVS: tag r21-0-58
cvs
parents: 259
diff changeset
221 (defun add-menu-item-1 (leaf-p menu-path new-item before in-menu)
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
222 ;; This code looks like it could be cleaned up some more
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
223 ;; Do we really need 6 calls to find-menu-item?
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
224 (when before (setq before (normalize-menu-item-name before)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
225 (let* ((item-name
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
226 (cond ((vectorp new-item) (aref new-item 0))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
227 ((consp new-item) (car new-item))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
228 (t nil)))
321
19dcec799385 Import from CVS: tag r21-0-58
cvs
parents: 259
diff changeset
229 (menubar (or in-menu current-menubar))
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
230 (menu (condition-case ()
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
231 (car (find-menu-item menubar menu-path))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
232 (error nil)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
233 (item-found (cond
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
234 ((null item-name)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
235 nil)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
236 ((not (listp menu))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
237 (signal 'error (list (gettext "not a submenu")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
238 menu-path)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
239 (menu
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
240 (find-menu-item (cdr menu) (list item-name)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
241 (t
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
242 (find-menu-item menubar (list item-name)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
243 )))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
244 (unless menubar
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
245 (error "`current-menubar' is nil: can't add menus to it."))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
246 (unless menu
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
247 (let ((rest menu-path)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
248 (so-far menubar))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
249 (while rest
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
250 ;;; (setq menu (car (find-menu-item (cdr so-far) (list (car rest)))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
251 (setq menu
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
252 (if (eq so-far menubar)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
253 (car (find-menu-item so-far (list (car rest))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
254 (car (find-menu-item (cdr so-far) (list (car rest))))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
255 (unless menu
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
256 (let ((rest2 so-far))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
257 (while (and (cdr rest2) (car (cdr rest2)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
258 (setq rest2 (cdr rest2)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
259 (setcdr rest2
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
260 (nconc (list (setq menu (list (car rest))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
261 (cdr rest2)))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
262 (setq so-far menu)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
263 (setq rest (cdr rest)))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
264 (if (and item-found (car item-found))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
265 ;; hack the item in place.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
266 (if menu
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
267 ;; Isn't it very bad form to use nsubstitute for side effects?
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
268 (nsubstitute new-item (car item-found) menu)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
269 (setq current-menubar (nsubstitute new-item
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
270 (car item-found)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
271 current-menubar)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
272 ;; OK, we have to add the whole thing...
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
273 ;; if BEFORE is specified, try to add it there.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
274 (unless menu (setq menu current-menubar))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
275 (when before
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
276 (setq before (car (find-menu-item menu (list before)))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
277 (let ((rest menu)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
278 (added-before nil))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
279 (while rest
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
280 (if (eq before (car (cdr rest)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
281 (progn
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
282 (setcdr rest (cons new-item (cdr rest)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
283 (setq rest nil added-before t))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
284 (setq rest (cdr rest))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
285 (when (not added-before)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
286 ;; adding before the first item on the menubar itself is harder
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
287 (if (and (eq menu menubar) (eq before (car menu)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
288 (setq menu (cons new-item menu)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
289 current-menubar menu)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
290 ;; otherwise, add the item to the end.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
291 (nconc menu (list new-item))))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
292 (set-menubar-dirty-flag)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
293 new-item))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
294
321
19dcec799385 Import from CVS: tag r21-0-58
cvs
parents: 259
diff changeset
295 (defun add-menu-button (menu-path menu-leaf &optional before in-menu)
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
296 "Add a menu item to some menu, creating the menu first if necessary.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
297 If the named item exists already, it is changed.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
298 MENU-PATH identifies the menu under which the new menu item should be inserted.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
299 It is a list of strings; for example, (\"File\") names the top-level \"File\"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
300 menu. (\"File\" \"Foo\") names a hypothetical submenu of \"File\".
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
301 MENU-LEAF is a menubar leaf node. See the documentation of `current-menubar'.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
302 BEFORE, if provided, is the name of a menu item before which this item should
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
303 be added, if this item is not on the menu already. If the item is already
321
19dcec799385 Import from CVS: tag r21-0-58
cvs
parents: 259
diff changeset
304 present, it will not be moved.
19dcec799385 Import from CVS: tag r21-0-58
cvs
parents: 259
diff changeset
305 If IN-MENU is present use that instead of `current-menubar' as the menu to
19dcec799385 Import from CVS: tag r21-0-58
cvs
parents: 259
diff changeset
306 change.
19dcec799385 Import from CVS: tag r21-0-58
cvs
parents: 259
diff changeset
307 "
19dcec799385 Import from CVS: tag r21-0-58
cvs
parents: 259
diff changeset
308 ;; Note easymenu.el uses the fact that menu-leaf can be a submenu.
19dcec799385 Import from CVS: tag r21-0-58
cvs
parents: 259
diff changeset
309 (add-menu-item-1 t menu-path menu-leaf before in-menu))
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
310
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
311 ;; I actually liked the old name better, but the interface has changed too
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
312 ;; drastically to keep it. --Stig
321
19dcec799385 Import from CVS: tag r21-0-58
cvs
parents: 259
diff changeset
313 (defun add-submenu (menu-path submenu &optional before in-menu)
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
314 "Add a menu to the menubar or one of its submenus.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
315 If the named menu exists already, it is changed.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
316 MENU-PATH identifies the menu under which the new menu should be inserted.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
317 It is a list of strings; for example, (\"File\") names the top-level \"File\"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
318 menu. (\"File\" \"Foo\") names a hypothetical submenu of \"File\".
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
319 If MENU-PATH is nil, then the menu will be added to the menubar itself.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
320 SUBMENU is the new menu to add.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
321 See the documentation of `current-menubar' for the syntax.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
322 BEFORE, if provided, is the name of a menu before which this menu should
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
323 be added, if this menu is not on its parent already. If the menu is already
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
324 present, it will not be moved."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
325 (check-menu-syntax submenu nil)
321
19dcec799385 Import from CVS: tag r21-0-58
cvs
parents: 259
diff changeset
326 (add-menu-item-1 nil menu-path submenu before in-menu))
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
327
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
328 (defun purecopy-menubar (x)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
329 ;; this calls purecopy on the strings, and the contents of the vectors,
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
330 ;; but not on the vectors themselves, or the conses - those must be
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
331 ;; writable.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
332 (cond ((vectorp x)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
333 (let ((i (length x)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
334 (while (> i 0)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
335 (aset x (1- i) (purecopy (aref x (1- i))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
336 (setq i (1- i))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
337 x)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
338 ((consp x)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
339 (let ((rest x))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
340 (while rest
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
341 (setcar rest (purecopy-menubar (car rest)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
342 (setq rest (cdr rest))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
343 x)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
344 (t
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
345 (purecopy x))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
346
321
19dcec799385 Import from CVS: tag r21-0-58
cvs
parents: 259
diff changeset
347 (defun delete-menu-item (path &optional from-menu)
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
348 "Remove the named menu item from the menu hierarchy.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
349 PATH is a list of strings which identify the position of the menu item in
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
350 the menu hierarchy. The documentation of `add-submenu' describes menu-paths."
321
19dcec799385 Import from CVS: tag r21-0-58
cvs
parents: 259
diff changeset
351 (let* ((pair (condition-case nil (find-menu-item (or from-menu
19dcec799385 Import from CVS: tag r21-0-58
cvs
parents: 259
diff changeset
352 current-menubar) path)
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
353 (error nil)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
354 (item (car pair))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
355 (parent (or (cdr pair) current-menubar)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
356 (if (not item)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
357 nil
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
358 ;; the menubar is the only special case, because other menus begin
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
359 ;; with their name.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
360 (if (eq parent current-menubar)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
361 (setq current-menubar (delq item parent))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
362 (delq item parent))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
363 (set-menubar-dirty-flag)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
364 item)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
365
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
366 (defun relabel-menu-item (path new-name)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
367 "Change the string of the specified menu item.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
368 PATH is a list of strings which identify the position of the menu item in
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
369 the menu hierarchy. (\"File\" \"Save\") means the menu item called \"Save\"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
370 under the toplevel \"File\" menu. (\"Menu\" \"Foo\" \"Item\") means the
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
371 menu item called \"Item\" under the \"Foo\" submenu of \"Menu\".
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
372 NEW-NAME is the string that the menu item will be printed as from now on."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
373 (or (stringp new-name)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
374 (setq new-name (signal 'wrong-type-argument (list 'stringp new-name))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
375 (let* ((menubar current-menubar)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
376 (pair (find-menu-item menubar path))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
377 (item (car pair))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
378 (menu (cdr pair)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
379 (or item
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
380 (signal 'error (list (if menu (gettext "No such menu item")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
381 (gettext "No such menu"))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
382 path)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
383 (if (and (consp item)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
384 (stringp (car item)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
385 (setcar item new-name)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
386 (aset item 0 new-name))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
387 (set-menubar-dirty-flag)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
388 item))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
389
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
390 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
391 ;;
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
392 ;; these are all bad style. Why in the world would we put evaluable forms
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
393 ;; into the menubar if we didn't want people to use 'em?
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
394 ;; x-font-menu.el is the only known offender right now and that ought to be
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
395 ;; rehashed a bit.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
396 ;;
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
397
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
398 (defun enable-menu-item-1 (path toggle-p on-p)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
399 (let (menu item)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
400 (if (and (vectorp path) (> (length path) 2)) ; limited syntax checking...
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
401 (setq item path)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
402 (let* ((menubar current-menubar)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
403 (pair (find-menu-item menubar path)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
404 (setq item (car pair)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
405 menu (cdr pair))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
406 (or item
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
407 (signal 'error (list (if menu
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
408 "No such menu item"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
409 "No such menu")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
410 path)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
411 (if (consp item)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
412 (error "%S is a menu, not a menu item" path))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
413 (if (or (> (length item) 4)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
414 (and (symbolp (aref item 2))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
415 (= ?: (aref (symbol-name (aref item 2)) 0))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
416 ;; plist-like syntax
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
417 (let ((i 2)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
418 (keyword (if toggle-p :selected :active))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
419 (ok nil))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
420 (while (< i (length item))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
421 (cond ((eq (aref item i) keyword)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
422 (aset item (1+ i) on-p)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
423 (setq ok t)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
424 (setq i (+ i 2)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
425 (cond (ok nil)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
426 (toggle-p
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
427 (signal 'error (list "not a toggle menu item" item)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
428 (t
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
429 ;; Need to copy the item to extend it, sigh...
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
430 (let ((cons (memq item menu))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
431 (new-item (vconcat item (list keyword on-p))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
432 (if cons
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
433 (setcar cons (setq item new-item))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
434 (if menu
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
435 (error "couldn't find %S on its parent?" item)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
436 (error "no %S slot to set: %S" keyword item)))))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
437 ;; positional syntax
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
438 (if toggle-p
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
439 (signal 'error (list "not a toggle menu item" item))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
440 (aset item 2 on-p)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
441 (set-menubar-dirty-flag)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
442 item))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
443
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
444 (defun enable-menu-item (path)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
445 "Make the named menu item be selectable.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
446 PATH is a list of strings which identify the position of the menu item in
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
447 the menu hierarchy. (\"File\" \"Save\") means the menu item called \"Save\"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
448 under the toplevel \"File\" menu. (\"Menu\" \"Foo\" \"Item\") means the
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
449 menu item called \"Item\" under the \"Foo\" submenu of \"Menu\"."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
450 (enable-menu-item-1 path nil t))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
451
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
452 (defun disable-menu-item (path)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
453 "Make the named menu item be unselectable.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
454 PATH is a list of strings which identify the position of the menu item in
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
455 the menu hierarchy. (\"File\" \"Save\") means the menu item called \"Save\"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
456 under the toplevel \"File\" menu. (\"Menu\" \"Foo\" \"Item\") means the
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
457 menu item called \"Item\" under the \"Foo\" submenu of \"Menu\"."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
458 (enable-menu-item-1 path nil nil))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
459
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
460 (defun select-toggle-menu-item (path)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
461 "Make the named toggle- or radio-style menu item be in the `selected' state.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
462 PATH is a list of strings which identify the position of the menu item in
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
463 the menu hierarchy. (\"File\" \"Save\") means the menu item called \"Save\"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
464 under the toplevel \"File\" menu. (\"Menu\" \"Foo\" \"Item\") means the
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
465 menu item called \"Item\" under the \"Foo\" submenu of \"Menu\"."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
466 (enable-menu-item-1 path t t))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
467
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
468 (defun deselect-toggle-menu-item (path)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
469 "Make the named toggle- or radio-style menu item be in the `unselected' state.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
470 PATH is a list of strings which identify the position of the menu item in
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
471 the menu hierarchy. (\"File\" \"Save\") means the menu item called \"Save\"
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
472 under the toplevel \"File\" menu. (\"Menu\" \"Foo\" \"Item\") means the
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
473 menu item called \"Item\" under the \"Foo\" submenu of \"Menu\"."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
474 (enable-menu-item-1 path t nil))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
475
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
476
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
477 (defun get-popup-menu-response (menu-desc &optional event)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
478 "Pop up the given menu and wait for a response.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
479 This blocks until the response is received, and returns the misc-user
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
480 event that encapsulates the response. To execute it, you can do
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
481 (funcall (event-function response) (event-object response))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
482 If no response was received, nil is returned.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
483
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
484 MENU-DESC and EVENT are as in the call to `popup-menu'."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
485 ;; partially stolen from w3
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
486 (let ((echo-keystrokes 0)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
487 new-event)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
488 (popup-menu menu-desc event)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
489 (catch 'popup-done
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
490 (while t
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
491 (setq new-event (next-command-event new-event))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
492 (cond ((misc-user-event-p new-event)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
493 (throw 'popup-done new-event))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
494 ((not (popup-up-p))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
495 (setq unread-command-events (cons new-event
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
496 unread-command-events))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
497 (throw 'popup-done nil))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
498 ((button-release-event-p new-event);; don't beep twice
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
499 nil)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
500 ((event-matches-key-specifier-p (quit-char))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
501 (signal 'quit nil))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
502 (t
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
503 (beep)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
504 (message "please make a choice from the menu.")))))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
505
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
506 (defun popup-menu-and-execute-in-window (menu-desc event)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
507 "Pop up the given menu and execute its response in EVENT's window.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
508 This blocks until the response is received, temporarily selects
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
509 EVENT's window, and executes the command specified in the response.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
510 EVENT can also be a window. See `popup-menu' for the semantics of
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
511 MENU-DESC."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
512 (let ((response
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
513 (get-popup-menu-response menu-desc
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
514 (and (eventp event) event))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
515 (and (misc-user-event-p response)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
516 (save-selected-window
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
517 (select-window (if (windowp event) event
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
518 (event-window event)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
519 (funcall (event-function response)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
520 (event-object response))))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
521
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
522 ;; provide default bindings for menu accelerator map
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
523 (and (boundp 'menu-accelerator-map)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
524 (keymapp menu-accelerator-map)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
525 (progn
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
526 (define-key menu-accelerator-map "\e" 'menu-escape)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
527 (define-key menu-accelerator-map [left] 'menu-left)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
528 (define-key menu-accelerator-map [right] 'menu-right)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
529 (define-key menu-accelerator-map [up] 'menu-up)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
530 (define-key menu-accelerator-map [down] 'menu-down)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
531 (define-key menu-accelerator-map [return] 'menu-select)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
532 (define-key menu-accelerator-map [kp_down] 'menu-down)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
533 (define-key menu-accelerator-map [kp_up] 'menu-down)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
534 (define-key menu-accelerator-map [kp_left] 'menu-left)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
535 (define-key menu-accelerator-map [kp_right] 'menu-right)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
536 (define-key menu-accelerator-map [kp_enter] 'menu-select)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
537 (define-key menu-accelerator-map "\C-g" 'menu-quit)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
538
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
539
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
540 (provide 'menubar)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
541
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
542 ;;; menubar.el ends here