Previous: , Up: Toolbar   [Contents][Index]


29.5 Other Toolbar Variables

The variables to control the toolbar thickness, visibility status, and captioned status are all specifiers. See Specifiers.

Specifier: default-toolbar-height

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.

Specifier: default-toolbar-width

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.

Specifier: top-toolbar-height

This specifies the height of the top toolbar.

Specifier: bottom-toolbar-height

This specifies the height of the bottom toolbar.

Specifier: left-toolbar-width

This specifies the width of the left toolbar.

Specifier: right-toolbar-width

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.

Specifier: default-toolbar-visible-p

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.

Specifier: top-toolbar-visible-p

This specifies whether the top toolbar is visible.

Specifier: bottom-toolbar-visible-p

This specifies whether the bottom toolbar is visible.

Specifier: left-toolbar-visible-p

This specifies whether the left toolbar is visible.

Specifier: right-toolbar-visible-p

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.

Specifier: toolbar-buttons-captioned-p

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.

Constant: initial-toolbar-spec

The toolbar descriptor used to initialize default-toolbar at startup.


Previous: , Up: Toolbar   [Contents][Index]