comparison man/lispref/toolbar.texi @ 442:abe6d1db359e r21-2-36

Import from CVS: tag r21-2-36
author cvs
date Mon, 13 Aug 2007 11:35:02 +0200
parents 8de8e3f6228a
children 576fb035e263
comparison
equal deleted inserted replaced
441:72a7cfa4a488 442:abe6d1db359e
1 @c -*-texinfo-*- 1 @c -*-texinfo-*-
2 @c This is part of the XEmacs Lisp Reference Manual. 2 @c This is part of the XEmacs Lisp Reference Manual.
3 @c Copyright (C) 1995, 1996 Ben Wing. 3 @c Copyright (C) 1995, 1996 Ben Wing.
4 @c See the file lispref.texi for copying conditions. 4 @c See the file lispref.texi for copying conditions.
5 @setfilename ../../info/toolbar.info 5 @setfilename ../../info/toolbar.info
6 @node Toolbar, Scrollbars, Dialog Boxes, top 6 @node Toolbar, Gutter, Dialog Boxes, top
7 @chapter Toolbar 7 @chapter Toolbar
8 @cindex toolbar 8 @cindex toolbar
9 9
10 @menu 10 @menu
11 * Toolbar Intro:: An introduction. 11 * Toolbar Intro:: An introduction.
12 * Toolbar Descriptor Format:: How to create a toolbar. 12 * Creating Toolbar:: How to create a toolbar.
13 * Toolbar Descriptor Format:: Accessing and modifying a toolbar's
14 properties.
13 * Specifying the Toolbar:: Setting a toolbar's contents. 15 * Specifying the Toolbar:: Setting a toolbar's contents.
14 * Other Toolbar Variables:: Controlling the size of toolbars. 16 * Other Toolbar Variables:: Controlling the size of toolbars.
15 @end menu 17 @end menu
16 18
17 @node Toolbar Intro 19 @node Toolbar Intro
55 such as VM that wants to put its own toolbar in a different location 57 such as VM that wants to put its own toolbar in a different location
56 from the default just sets the position-specific specifiers, and if 58 from the default just sets the position-specific specifiers, and if
57 the user sets the default toolbar to the same position, it will just 59 the user sets the default toolbar to the same position, it will just
58 not be visible. 60 not be visible.
59 61
62 @node Creating Toolbar
63 @section Creating Toolbar
64
65 @defun make-toolbar-specifier spec-list
66
67 Return a new @code{toolbar} specifier object with the given
68 specification list. @var{spec-list} can be a list of specifications
69 (each of which is a cons of a locale and a list of instantiators), a
70 single instantiator, or a list of instantiators. @xref{Specifiers}, for
71 more information about specifiers.
72
73 Toolbar specifiers are used to specify the format of a toolbar. The
74 values of the variables @code{default-toolbar}, @code{top-toolbar},
75 @code{left-toolbar}, @code{right-toolbar}, and @code{bottom-toolbar} are
76 always toolbar specifiers.
77
78 Valid toolbar instantiators are called "toolbar descriptors"
79 and are lists of vectors. See @code{default-toolbar} for a description
80 of the exact format.
81 @end defun
82
60 @node Toolbar Descriptor Format 83 @node Toolbar Descriptor Format
61 @section Toolbar Descriptor Format 84 @section Toolbar Descriptor Format
62 85
63 The contents of a toolbar are specified using a @dfn{toolbar descriptor}. 86 The contents of a toolbar are specified using a @dfn{toolbar descriptor}.
64 The format of a toolbar descriptor is a list of @dfn{toolbar button 87 The format of a toolbar descriptor is a list of @dfn{toolbar button