changeset 31590:76b1df61fa5d

New.
author Dave Love <fx@gnu.org>
date Thu, 14 Sep 2000 11:55:46 +0000
parents 3a8d028a9095
children f115e74e9dd1
files lisp/toolbar/toolbar.el
diffstat 1 files changed, 152 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/lisp/toolbar/toolbar.el	Thu Sep 14 11:55:46 2000 +0000
@@ -0,0 +1,152 @@
+;;; toolbar.el --- Setting up the toolbar
+;;
+;; Copyright (C) 2000 Free Software Foundation, Inc.
+;;
+;; Author: Dave Love <fx@gnu.org>
+;; Keywords: mouse frames
+
+;; This file is part of GNU Emacs.
+
+;; GNU Emacs is free software; you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation; either version 2, or (at your option)
+;; any later version.
+
+;; GNU Emacs is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with GNU Emacs; see the file COPYING.  If not, write to the
+;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+;; Boston, MA 02111-1307, USA.
+
+;;; Commentary:
+
+;; Provides `toolbar-mode' to control display of the toolbar and
+;; bindings for the global toolbar with convenience functions
+;; `toolbar-add-item' and `toolbar-like-menu-item'.
+
+;;; Code:
+
+;;;###autoload
+(define-minor-mode toolbar-mode
+  "Toggle use of the toolbar.
+With ARG, display the toolbar if and only if ARG is positive.
+
+See `toolbar-add-item' and `toolbar-like-menu-item' for conveniently
+adding toolbar items."  nil nil nil
+  :global t
+  :group 'mouse
+  :group 'frames
+  (let ((lines (if toolbar-mode 1 0)))
+    ;; Alter existing frames...
+    (mapc (lambda (frame)
+	    (modify-frame-parameters frame
+				     (list (cons 'tool-bar-lines lines))))
+	  (frame-list))
+    ;; ...and future ones.
+    (let ((elt (assq 'tool-bar-lines default-frame-alist)))
+      (if elt
+	  (setcdr elt lines)
+	(add-to-list 'default-frame-alist (cons 'tool-bar-lines lines))))))
+
+(defvar toolbar-global-map (let ((map (make-sparse-keymap "Toolbar")))
+			     (global-set-key [tool-bar] map))
+  "Keymap for the toolbar in the global map.")
+
+;;;###autoload
+(defun toolbar-add-item (icon def key &optional map &rest props)
+  "Add an item to the toolbar.
+ICON names the image, DEF is the key definition and KEY is a symbol
+for the fake function key in the menu keymap.  MAP is the toolbar
+keymap in which to define the item; it defaults to
+`toolbar-global-map'.  Remaining arguments PROPS are additional items
+to add to the menu item specification.  See Info node `(elisp)Tool
+Bar'.  Items are added from left to right.
+
+ICON is the base name of a file cnntaining the image to use.  The
+function will try to use first ICON.xpm, then ICON.xbm using
+`find-image'.  If PROPS contains `:enable', a `disabled' version of
+the icon is generated automatically using the Laplace algorithm (see
+Info node `(elisp)Image Descriptors')."
+  (let ((image (find-image `((:type xbm :file ,(concat icon ".xbm"))
+			     (:type xpm :file ,(concat icon ".xpm"))))))
+    (when image
+      (unless (memq 'xbm image)
+	(setq image (append image '(:heuristic-mask t))))
+       (if (memq :enable props)
+ 	(let ((dis (append image '(:algorithm laplace))))
+ 	  (setq image (vector image image dis dis))))
+      (define-key-after (or map toolbar-global-map) (vector key)
+	`(menu-item ,(symbol-name key) ,def :image ,image ,@props)))))
+
+(defun toolbar-like-menu-item (command icon &optional map)
+  "Define toolbar binding for COMMAND using the given ICON in keymap MAP.
+The binding of COMMAND is looked up in the menu bar in MAP (default
+`global-map') and modified to add an image specification for ICON.
+MAP must contain appropriate keymaps bound to `[menu-bar]' and
+`[tool-bar]'."
+  (unless map
+    (setq map global-map))
+  (let* ((menu-bar-map (lookup-key map [menu-bar]))
+	 (keys (where-is-internal command menu-bar-map))
+	 (tb-map (key-binding [tool-bar] map))
+	 (image (find-image `((:type xpm :file ,(concat icon ".xpm"))
+			      (:type xbm :file ,(concat icon ".xbm")))))
+	 submap key)
+    (when image
+      ;; We'll pick up the last valid entry in the list of keys if
+      ;; there's more than one.
+      (dolist (k keys)
+	;; We're looking for a binding of the command in a submap of
+	;; the menu bar map, so the key sequence must be two or more
+	;; long.
+	(if (and (vectorp k)
+		 (> (length k) 1))
+	    (let ((m (lookup-key menu-bar-map (substring k 0 -1)))
+		  ;; Last element in the bound key sequence:
+		  (kk (aref k (1- (length k)))))
+	      (if (and (keymapp m)
+		       (symbolp kk))
+		  (setq submap m
+			key kk)))))
+      (when (and (symbolp submap) (boundp submap))
+	(setq submap (eval submap)))
+      (define-key-after tb-map (vector key)
+	(append (cdr (assq key (cdr submap))) (list :image image))))))
+
+;;; Set up some global items.  Additions/deletions up for grabs.
+
+(toolbar-like-menu-item 'save-buffers-kill-emacs "exit")
+(toolbar-like-menu-item 'find-file "new")
+(toolbar-like-menu-item 'dired "fld_open")
+(toolbar-like-menu-item 'kill-this-buffer "close")
+(toolbar-like-menu-item 'save-buffer "save")
+(toolbar-like-menu-item 'write-file "saveas")
+(toolbar-like-menu-item 'undo "undo")
+(toolbar-like-menu-item 'kill-region "cut")
+(toolbar-like-menu-item 'menu-bar-kill-ring-save "copy")
+(toolbar-like-menu-item 'yank "paste")
+(toolbar-like-menu-item 'nonincremental-search-forward "search")
+;;(toolbar-like-menu-item 'ispell-buffer "spell")
+
+;; There's no icon appropriate for News and we need a command rather
+;; than a lambda for Read Mail.
+;;(toolbar-like-menu-item 'compose-mail "mail_compose")
+
+(toolbar-like-menu-item 'print-buffer "print")
+(toolbar-add-item "preferences" 'customize 'customize nil
+		  :help "Edit preferences (customize)")
+(toolbar-add-item "help"
+		  (lambda ()
+		    (interactive)
+		    (let ((p (mouse-position)))
+		      (x-popup-menu (list (list (cadr p) (cddr p)) (car p))
+				    menu-bar-help-menu)))
+		  'help nil :help "Pop up the Help menu")
+
+(provide 'toolbar)
+
+;;; toolbar.el ends here