Previous: Specifying the Toolbar, Up: Toolbar [Contents][Index]
The variables to control the toolbar thickness, visibility status, and captioned status are all specifiers. See Specifiers.
This specifies the height of the default toolbar, if it’s oriented
horizontally. The position of the default toolbar is specified by the
function set-default-toolbar-position
. If the corresponding
position-specific toolbar thickness specifier
(e.g. top-toolbar-height
if default-toolbar-position
is
top
) does not specify a thickness in a particular domain (a
window or a frame), then the value of default-toolbar-height
or
default-toolbar-width
(depending on the toolbar orientation) in
that domain, if any, will be used instead.
This specifies the width of the default toolbar, if it’s oriented
vertically. This behaves like default-toolbar-height
.
Note that default-toolbar-height
is only used when
default-toolbar-position
is top
or bottom
, and
default-toolbar-width
is only used when
default-toolbar-position
is left
or right
.
This specifies the height of the top toolbar.
This specifies the height of the bottom toolbar.
This specifies the width of the left toolbar.
This specifies the width of the right toolbar.
Note that all of the position-specific toolbar thickness specifiers have a fallback value of zero when they do not correspond to the default toolbar. Therefore, you will have to set a non-zero thickness value if you want a position-specific toolbar to be displayed.
This specifies whether the default toolbar is visible. The position of
the default toolbar is specified by the function
set-default-toolbar-position
. If the corresponding position-specific
toolbar visibility specifier (e.g. top-toolbar-visible-p
if
default-toolbar-position
is top
) does not specify a
visible-p value in a particular domain (a window or a frame), then the
value of default-toolbar-visible-p
in that domain, if any, will
be used instead.
This specifies whether the top toolbar is visible.
This specifies whether the bottom toolbar is visible.
This specifies whether the left toolbar is visible.
This specifies whether the right toolbar is visible.
default-toolbar-visible-p
and all of the position-specific
toolbar visibility specifiers have a fallback value of true.
Internally, toolbar thickness and visibility specifiers are instantiated in both window and frame domains, for different purposes. The value in the domain of a frame’s selected window specifies the actual toolbar thickness or visibility that you will see in that frame. The value in the domain of a frame itself specifies the toolbar thickness or visibility that is used in frame geometry calculations.
Thus, for example, if you set the frame width to 80 characters and the
left toolbar width for that frame to 68 pixels, then the frame will be
sized to fit 80 characters plus a 68-pixel left toolbar. If you then
set the left toolbar width to 0 for a particular buffer (or if that
buffer does not specify a left toolbar or has a nil
value specified for
left-toolbar-visible-p
), you will find that, when that buffer is
displayed in the selected window, the window will have a width of 86 or
87 characters—the frame is sized for a 68-pixel left toolbar but the
selected window specifies that the left toolbar is not visible, so it is
expanded to take up the slack.
Whether toolbar buttons are captioned. This affects which glyphs from a toolbar button descriptor are chosen. See Toolbar Descriptor Format.
You can also reset the toolbar to what it was when SXEmacs started up.
The toolbar descriptor used to initialize default-toolbar
at
startup.
Previous: Specifying the Toolbar, Up: Toolbar [Contents][Index]