PHP Editor Review - Gtk Manual Gtk gtktoolbar

GtkToolbar

Container that creates bars of buttons and other widgets.

Object Hierarchy

GtkObject
`-- GtkWidget
`-- GtkContainer
`-- GtkToolbar

Direct subclasses

None.

Description

Horizontal or vertical container for bars of buttons and other widgets.

Toolbars are used to give the user access to often used functions like "New document", "Open", "Save" and such. The toolbar can show buttons of text and icons as well as only one of both, which can be set during runtime.

The methods insert_element() , append_element() , prepend_element() , insert_item() , append_item() and prepend_item() as well as all the properties are available since PHP-Gtk 1.0.1 only.

Constructor

GtkToolbar (GtkOrientation orientation, GtkToolbarStyle style);
-- Creates a new toolbar instance.

Methods

add()
Appends an existing widget to the toolbar.
append_space()
Adds a spacer element to the end.
prepend_space()
Adds a spacer element before the first item.
insert_space()
Inserts a spacer element at the given position.
append_element()
Adds a new toolbar element button to the end.
prepend_element()
Adds a new toolbar element before the first item.
insert_element()
Inserts a new toolbar element at the given position.
append_item()
Adds a new button to the end.
prepend_item()
Adds a new button before the first item.
insert_item()
Inserts a new button at the given position.
append_widget()
Adds a widget to the end.
prepend_widget()
Adds a widget before the first item.
insert_widget()
Inserts a widget at the given position.
set_orientation()
Sets the toolbar orientation to horizontal or vertical.
set_style()
Sets the text/icon style.
set_space_size()
Sets the width/height which a space takes.
set_space_style()
Sets the space style: line or invisible.
set_tooltips()
Enables or disables the display of tooltips
set_button_relief()
Sets the relief style for buttons on the toolbar
get_button_relief()
Returns the button relief style.

Signals

"style-changed"
Emitted when the style has changed.
"orientation-changed"
Emitted when the orientation has changed.

Properties

orientation:
Returns the orientation (horizontal or vertical) of the toolbar
space_size:
Returns the width/height which a space takes.
space_style:
Returns the current space style of the toolbar.
style:
Returns the current toolbar style.