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-heightifdefault-toolbar-positionistop) does not specify a thickness in a particular domain (a window or a frame), then the value ofdefault-toolbar-heightordefault-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.
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-pifdefault-toolbar-positionistop) does not specify a visible-p value in a particular domain (a window or a frame), then the value ofdefault-toolbar-visible-pin that domain, if any, will be used instead.
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.