Package: gtk

Class gtk-toolbar

Superclasses

gtk-container, gtk-widget, gtk-buildable, gtk-tool-shell, gtk-orientable, g-object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

None

Direct Slots

icon-size
The icon-size property of type :int (Read / Write)
The size of the icons in a toolbar is normally determined by the gtk-toolbar-icon-size setting. When this property is set, it overrides the setting. This should only be used for special purpose toolbars, normal application toolbars should respect the user preferences for the size of icons.
Allowed values: >= 0
Default value: 3
icon-size-set
The icon-size-set property of type :boolean (Read / Write)
Is true if the icon-size property has been set.
Default value: false
show-arrow
The show-arrow property of type :boolean (Read / Write)
If an arrow should be shown if the toolbar does not fit.
Default value: true
toolbar-style
The toolbar-style property of type gtk-toolbar-style (Read / Write)
How to draw the toolbar.
Default value: :both

Details

A toolbar can contain instances of a subclass of gtk-tool-item widgets. A toolbar is created with a call to the gtk-toolbar-new function. To add a gtk-tool-item widget to the toolbar, use the gtk-toolbar-insert function. To remove an item from the toolbar use the gtk-container-remove function. To add a button to the toolbar, add an instance of the gtk-tool-button class.



Toolbar items can be visually grouped by adding instances of the gtk-separator-tool-item class to the toolbar. If the expand child property is true and the draw property is set to false, the effect is to force all following items to the end of the toolbar.

Creating a context menu for the toolbar can be done by connecting to the "popup-context-menu" signal.

CSS nodes

The gtk-toolbar implementation has a single CSS node with name toolbar.

Child Property Details

expand
The expand child property of type :boolean (Read / Write)
Whether the item should receive extra space when the toolbar grows.
Default value: false
homogeneous
The homogeneous child property of type :boolean (Read / Write)
Whether the item should be the same size as other homogeneous items.
Default value: false

Style Property Details

button-relief
The button-relief style property of type gtk-relief-style (Read)
Type of bevel around toolbar buttons.
Default value: :none
internal-padding
The internal-padding style property of type :int (Read)
Amount of border space between the toolbar shadow and the buttons.
Warning: The internal-padding style property has been deprecated since version 3.6 and should not be used in newly written code. Use the standard padding CSS property, through objects like gtk-style-context and gtk-css-provider. The value of this style property is ignored.
Allowed values: >= 0
Default value: 0
max-child-expand
The max-child-expand style property of type :int (Read)
Maximum amount of space an expandable item will be given.
Allowed values: >= 0
Default value: 2147483647
shadow-type
The shadow-type style property of type gtk-shadow-type (Read)
Style of bevel around the toolbar.
Warning: The shadow-type style property has been deprecated since version 3.6 and should not be used in newly written code. Use the standard border CSS property, through objects like gtk-style-context and gtk-css-provider. The value of this style property is ignored.
Default value: :out
space-size
The space-size style property of type :int (Read)
Size of spacers.
Warning: The space-size style property has been deprecated since version 3.20 and should not be used in newly written code. Use the standard margin/padding CSS properties on the separator elements. The value of this style property is ignored.
Allowed values: >= 0
Default value: 12
space-style
The space-style style property of type gtk-toolbar-space-style (Read)
Whether spacers are vertical lines or just blank.
Warning: The space-style style property has been deprecated since version 3.20 and should not be used in newly written code. Use CSS properties on the separator elements to style toolbar spacers. The value of this style property is ignored.
Default value: :line

Signal Details

The "focus-home-or-end" signal
 lambda (toolbar focus-home)    :action      
A keybinding signal used internally by GTK. The signal cannot be used in application code.
toolbar
The gtk-toolbar widget which emitted the signal.
focus-home
True if the first item should be focused.
Returns
True if the signal was handled, false if not.
The "orientation-changed" signal
 lambda (toolbar orientation)    :run-first      
Emitted when the orientation of the toolbar changes.
toolbar
The gtk-toolbar widget which emitted the signal.
orientation
The new value of the gtk-orientation enumeration of the toolbar.
The "popup-context-menu" signal
 lambda (toolbar x y button)    :run-last      
Emitted when the user right-clicks the toolbar or uses the keybinding to display a popup menu. Application developers should handle this signal if they want to display a context menu on the toolbar. The context menu should appear at the coordinates given by x and y. The mouse button number is given by the button parameter. If the menu was popped up using the keyboard, button is -1.
toolbar
The gtk-toolbar widget which emitted the signal.
x
An integer with the x coordinate of the point where the menu should appear.
y
An integer with the y coordinate of the point where the menu should appear.
button
An integer with the mouse button the user pressed, or -1.
Returns
Return true if the signal was handled, false if not.
The "style-changed" signal
 lambda (toolbar style)    :run-first      
Emitted when the style of the toolbar changes.
toolbar
The gtk-toolbar widget which emitted the signal.
style
The new value of the gtk-toolbar-style enumeration of the toolbar.
 

Slot Access Functions

Inherited Slot Access Functions

See also

*2021-10-30