interface-toolbar-state

interface-toolbar-state Accessor

Summary

Reads or changes the properties of an interface toolbar that give information about its state.

Package

capi

Signature

interface-toolbar-state interface key => value

(setf interface-toolbar-state) value interface key => value

Arguments

`interface`⇩	An instance of interface or a subclass.
`key`⇩	One of the `toolbar-states` plist keys.
`value`	The value associated with the `toolbar-states` plist key.

Values

value

The value associated with the toolbar-states plist key.

Description

The accessor interface-toolbar-state reads or changes the properties of the interface toolbar of interface that give information about its state. The user can also change these properties by customizing the toolbar, so you cannot assume that the value will be the same each time you read it.

See 9 Adding Toolbars for information on how to specify an interface toolbar.

key can be one of the following, with the corresponding value:

`:visible`	`visible` is true if the toolbar is visible and false if it is hidden. The default is true.
`:items`	`items` is a list of the names of the `toolbar-items` which are shown on the toolbar, in the order they are shown. The built-in names `:separator`, `:space` and `:flexible-space` represent various kinds of gap between items. On Microsoft Windows, an item can be a list of the form `(:titled-separator title)` which starts a dockable group of items that displays `title` when it is undocked. The default `items` includes all items in `toolbar-items`, with `:separator` between each toolbar-component.
`:display`	`display` is a keyword describing what is displayed for each item. It can be `:image` (just shows an image), `:title` (just shows the title), `:image-and-title` (shows both title and image) or `:image-and-title-horizontal` (shows title and image horizontally, only supported on GTK+). The default is platform-specific.
`:size`	`size` is a keyword describing the size of the items. It can be one of `:small`, `:normal` or `:large`. Some of these sizes might be the same as others. The default is platform-specific.

You can set all of the keys simultaneously by setting the interface-toolbar-state accessor or providing the toolbar-states initarg.

Notes

The value :separator in items may or may not actually be visible, depending on the windowing system. On macOS Lion it is zero width.