An interface toolbar can be customized by the user. It can also be manipulated programmatically.
The user can change toolbar state , that is the set of visible toolbar items, their order and their appearance. The user does this via the context menu on the toolbar. This menu includes commands to display the button images or titles (or both), and a Customize command to alter the set of items, including separators and spaces, and the order in which the items appear.
To raise the customization dialog programmatically, call interface-customize-toolbar.
You can supply a default toolbar state in the initarg
. This is used when the user presses the
button in the
dialog. You can read this value with
Be aware that toolbar-states may not be the same each time you read it, because the user may have changed it as described in User-customization of toolbars.
For the details, see the accessor interface-toolbar-state.
CAPI User Guide and Reference Manual (Unix version) - 3 Aug 2017