GtkToolbar

typedef struct {
  gint             num_children;
  GList           *children;
  GtkOrientation   orientation;
  GtkToolbarStyle  style;
  GtkIconSize      icon_size;
  
  GtkTooltips     *tooltips;
} GtkToolbar;

The GtkToolbar struct only contains private data and should only be accessed through the function described below.

enum GtkToolbarChildType

typedef enum
{
  GTK_TOOLBAR_CHILD_SPACE,
  GTK_TOOLBAR_CHILD_BUTTON,
  GTK_TOOLBAR_CHILD_TOGGLEBUTTON,
  GTK_TOOLBAR_CHILD_RADIOBUTTON,
  GTK_TOOLBAR_CHILD_WIDGET
} GtkToolbarChildType;

GtkToolbarChildType is used to set the type of new elements that are added to a GtkToolbar.

enum GtkToolbarSpaceStyle

typedef enum
{
  GTK_TOOLBAR_SPACE_EMPTY,
  GTK_TOOLBAR_SPACE_LINE
} GtkToolbarSpaceStyle;

GtkToolbarChild

typedef struct {
  GtkToolbarChildType type;
  GtkWidget *widget;
  GtkWidget *icon;
  GtkWidget *label;
} GtkToolbarChild;

gtk_toolbar_new ()

GtkWidget*  gtk_toolbar_new                 (void);

Creates a new toolbar.

gtk_toolbar_insert ()

void        gtk_toolbar_insert              (GtkToolbar *toolbar,
                                             GtkToolItem *item,
                                             gint pos);

Insert a GtkToolItem into the toolbar at position pos. If pos is 0 the item is prepended to the start of the toolbar. If pos is negative, the item is appended to the end of the toolbar.

Since 2.4

gtk_toolbar_get_item_index ()

gint        gtk_toolbar_get_item_index      (GtkToolbar *toolbar,
                                             GtkToolItem *item);

Returns the position of item on the toolbar, starting from 0. It is an error if item is not a child of the toolbar.

Since 2.4

gtk_toolbar_get_n_items ()

gint        gtk_toolbar_get_n_items         (GtkToolbar *toolbar);

Returns the number of items on the toolbar.

Since 2.4

gtk_toolbar_get_nth_item ()

GtkToolItem* gtk_toolbar_get_nth_item       (GtkToolbar *toolbar,
                                             gint n);

Returns the n'th item on toolbar, or NULL if the toolbar does not contain an n'th item.

Since 2.4

gtk_toolbar_get_drop_index ()

gint        gtk_toolbar_get_drop_index      (GtkToolbar *toolbar,
                                             gint x,
                                             gint y);

Returns the position corresponding to the indicated point on toolbar. This is useful when dragging items to the toolbar: this function returns the position a new item should be inserted.

x and y are in toolbar coordinates.

Since 2.4

gtk_toolbar_set_drop_highlight_item ()

void        gtk_toolbar_set_drop_highlight_item
                                            (GtkToolbar *toolbar,
                                             GtkToolItem *tool_item,
                                             gint index_);

Highlights toolbar to give an idea of what it would look like if item was added to toolbar at the position indicated by index_. If item is NULL, highlighting is turned off. In that case index_ is ignored.

The tool_item passed to this function must not be part of any widget hierarchy. When an item is set as drop highlight item it can not added to any widget hierarchy or used as highlight item for another toolbar.

Since 2.4

gtk_toolbar_set_show_arrow ()

void        gtk_toolbar_set_show_arrow      (GtkToolbar *toolbar,
                                             gboolean show_arrow);

Sets whether to show an overflow menu when toolbar doesn't have room for all items on it. If TRUE, items that there are not room are available through an overflow menu.

Since 2.4

gtk_toolbar_set_orientation ()

void        gtk_toolbar_set_orientation     (GtkToolbar *toolbar,
                                             GtkOrientation orientation);

Sets whether a toolbar should appear horizontally or vertically.

gtk_toolbar_set_tooltips ()

void        gtk_toolbar_set_tooltips        (GtkToolbar *toolbar,
                                             gboolean enable);

Sets if the tooltips of a toolbar should be active or not.

gtk_toolbar_unset_icon_size ()

void        gtk_toolbar_unset_icon_size     (GtkToolbar *toolbar);

Unsets toolbar icon size set with gtk_toolbar_set_icon_size(), so that user preferences will be used to determine the icon size.

gtk_toolbar_get_show_arrow ()

gboolean    gtk_toolbar_get_show_arrow      (GtkToolbar *toolbar);

Returns whether the toolbar has an overflow menu. See gtk_toolbar_set_show_arrow().

Since 2.4

gtk_toolbar_get_orientation ()

GtkOrientation gtk_toolbar_get_orientation  (GtkToolbar *toolbar);

Retrieves the current orientation of the toolbar. See gtk_toolbar_set_orientation().

gtk_toolbar_get_style ()

GtkToolbarStyle gtk_toolbar_get_style       (GtkToolbar *toolbar);

Retrieves whether the toolbar has text, icons, or both . See gtk_toolbar_set_style().

gtk_toolbar_get_icon_size ()

GtkIconSize gtk_toolbar_get_icon_size       (GtkToolbar *toolbar);

Retrieves the icon size for the toolbar. See gtk_toolbar_set_icon_size().

gtk_toolbar_get_tooltips ()

gboolean    gtk_toolbar_get_tooltips        (GtkToolbar *toolbar);

Retrieves whether tooltips are enabled. See gtk_toolbar_set_tooltips().

gtk_toolbar_get_relief_style ()

GtkReliefStyle gtk_toolbar_get_relief_style (GtkToolbar *toolbar);

Returns the relief style of buttons on toolbar. See gtk_button_set_relief().

Since 2.4

gtk_toolbar_append_item ()

GtkWidget*  gtk_toolbar_append_item         (GtkToolbar *toolbar,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             GtkWidget *icon,
                                             GtkSignalFunc callback,
                                             gpointer user_data);

Inserts a new item into the toolbar. You must specify the position in the toolbar where it will be inserted.

callback must be a pointer to a function taking a GtkWidget and a gpointer as arguments. Use the GTK_SIGNAL_FUNC() to cast the function to GtkSignalFunc.

gtk_toolbar_prepend_item ()

GtkWidget*  gtk_toolbar_prepend_item        (GtkToolbar *toolbar,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             GtkWidget *icon,
                                             GtkSignalFunc callback,
                                             gpointer user_data);

Adds a new button to the beginning (top or left edges) of the given toolbar.

callback must be a pointer to a function taking a GtkWidget and a gpointer as arguments. Use the GTK_SIGNAL_FUNC() to cast the function to GtkSignalFunc.

gtk_toolbar_insert_item ()

GtkWidget*  gtk_toolbar_insert_item         (GtkToolbar *toolbar,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             GtkWidget *icon,
                                             GtkSignalFunc callback,
                                             gpointer user_data,
                                             gint position);

Inserts a new item into the toolbar. You must specify the position in the toolbar where it will be inserted.

callback must be a pointer to a function taking a GtkWidget and a gpointer as arguments. Use the GTK_SIGNAL_FUNC() to cast the function to GtkSignalFunc.

gtk_toolbar_append_space ()

void        gtk_toolbar_append_space        (GtkToolbar *toolbar);

Adds a new space to the end of the toolbar.

gtk_toolbar_prepend_space ()

void        gtk_toolbar_prepend_space       (GtkToolbar *toolbar);

Adds a new space to the beginning of the toolbar.

gtk_toolbar_insert_space ()

void        gtk_toolbar_insert_space        (GtkToolbar *toolbar,
                                             gint position);

Inserts a new space in the toolbar at the specified position.

gtk_toolbar_append_element ()

GtkWidget*  gtk_toolbar_append_element      (GtkToolbar *toolbar,
                                             GtkToolbarChildType type,
                                             GtkWidget *widget,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             GtkWidget *icon,
                                             GtkSignalFunc callback,
                                             gpointer user_data);

Adds a new element to the end of a toolbar.

If type == GTK_TOOLBAR_CHILD_WIDGET, widget is used as the new element. If type == GTK_TOOLBAR_CHILD_RADIOBUTTON, widget is used to determine the radio group for the new element. In all other cases, widget must be NULL.

callback must be a pointer to a function taking a GtkWidget and a gpointer as arguments. Use the GTK_SIGNAL_FUNC() to cast the function to GtkSignalFunc.

gtk_toolbar_prepend_element ()

GtkWidget*  gtk_toolbar_prepend_element     (GtkToolbar *toolbar,
                                             GtkToolbarChildType type,
                                             GtkWidget *widget,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             GtkWidget *icon,
                                             GtkSignalFunc callback,
                                             gpointer user_data);

Adds a new element to the beginning of a toolbar.

If type == GTK_TOOLBAR_CHILD_WIDGET, widget is used as the new element. If type == GTK_TOOLBAR_CHILD_RADIOBUTTON, widget is used to determine the radio group for the new element. In all other cases, widget must be NULL.

callback must be a pointer to a function taking a GtkWidget and a gpointer as arguments. Use the GTK_SIGNAL_FUNC() to cast the function to GtkSignalFunc.

gtk_toolbar_insert_element ()

GtkWidget*  gtk_toolbar_insert_element      (GtkToolbar *toolbar,
                                             GtkToolbarChildType type,
                                             GtkWidget *widget,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             GtkWidget *icon,
                                             GtkSignalFunc callback,
                                             gpointer user_data,
                                             gint position);

Inserts a new element in the toolbar at the given position.

If type == GTK_TOOLBAR_CHILD_WIDGET, widget is used as the new element. If type == GTK_TOOLBAR_CHILD_RADIOBUTTON, widget is used to determine the radio group for the new element. In all other cases, widget must be NULL.

callback must be a pointer to a function taking a GtkWidget and a gpointer as arguments. Use the GTK_SIGNAL_FUNC() to cast the function to GtkSignalFunc.

gtk_toolbar_append_widget ()

void        gtk_toolbar_append_widget       (GtkToolbar *toolbar,
                                             GtkWidget *widget,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text);

Adds a widget to the end of the given toolbar.

gtk_toolbar_prepend_widget ()

void        gtk_toolbar_prepend_widget      (GtkToolbar *toolbar,
                                             GtkWidget *widget,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text);

Adds a widget to the beginning of the given toolbar.

gtk_toolbar_insert_widget ()

void        gtk_toolbar_insert_widget       (GtkToolbar *toolbar,
                                             GtkWidget *widget,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gint position);

Inserts a widget in the toolbar at the given position.

gtk_toolbar_set_style ()

void        gtk_toolbar_set_style           (GtkToolbar *toolbar,
                                             GtkToolbarStyle style);

Alters the view of toolbar to display either icons only, text only, or both.

gtk_toolbar_insert_stock ()

GtkWidget*  gtk_toolbar_insert_stock        (GtkToolbar *toolbar,
                                             const gchar *stock_id,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             GtkSignalFunc callback,
                                             gpointer user_data,
                                             gint position);

Inserts a stock item at the specified position of the toolbar. If stock_id is not a known stock item ID, it's inserted verbatim, except that underscores used to mark mnemonics are removed.

callback must be a pointer to a function taking a GtkWidget and a gpointer as arguments. Use the GTK_SIGNAL_FUNC() to cast the function to GtkSignalFunc.

gtk_toolbar_set_icon_size ()

void        gtk_toolbar_set_icon_size       (GtkToolbar *toolbar,
                                             GtkIconSize icon_size);

This function sets the size of stock icons in the toolbar. You can call it both before you add the icons and after they've been added. The size you set will override user preferences for the default icon size.

This should only be used for special-purpose toolbars, normal application toolbars should respect the user preferences for the size of icons.

gtk_toolbar_remove_space ()

void        gtk_toolbar_remove_space        (GtkToolbar *toolbar,
                                             gint position);

Removes a space from the specified position.

gtk_toolbar_unset_style ()

void        gtk_toolbar_unset_style         (GtkToolbar *toolbar);

Unsets a toolbar style set with gtk_toolbar_set_style(), so that user preferences will be used to determine the toolbar style.

The "icon-size" property

  "icon-size"            GtkIconSize           : Read / Write

The size of the icons in a toolbar is normally determined by the 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.

Default value: GTK_ICON_SIZE_LARGE_TOOLBAR

Since 2.10

The "icon-size-set" property

  "icon-size-set"        gboolean              : Read / Write

Is TRUE if the icon-size property has been set.

Default value: FALSE

Since 2.10

The "orientation" property

  "orientation"          GtkOrientation        : Read / Write

The orientation of the toolbar.

Default value: GTK_ORIENTATION_HORIZONTAL

The "show-arrow" property

  "show-arrow"           gboolean              : Read / Write

If an arrow should be shown if the toolbar doesn't fit.

Default value: TRUE

The "toolbar-style" property

  "toolbar-style"        GtkToolbarStyle       : Read / Write

How to draw the toolbar.

Default value: GTK_TOOLBAR_ICONS

The "tooltips" property

  "tooltips"             gboolean              : Read / Write

If the tooltips of the toolbar should be active or not.

Default value: TRUE

Since 2.8

The "expand" child property

  "expand"               gboolean              : Read / Write

Whether the item should receive extra space when the toolbar grows.

Default value: TRUE

The "homogeneous" child property

  "homogeneous"          gboolean              : Read / Write

Whether the item should be the same size as other homogeneous items.

Default value: TRUE

The "button-relief" style property

  "button-relief"        GtkReliefStyle        : Read

Type of bevel around toolbar buttons.

Default value: GTK_RELIEF_NONE

The "internal-padding" style property

  "internal-padding"     gint                  : Read

Amount of border space between the toolbar shadow and the buttons.

Allowed values: >= 0

Default value: 0

The "max-child-expand" style property

  "max-child-expand"     gint                  : Read

Maximum amount of space an expandable item will be given.

Allowed values: >= 0

Default value: 2147483647

The "shadow-type" style property

  "shadow-type"          GtkShadowType         : Read

Style of bevel around the toolbar.

Default value: GTK_SHADOW_OUT

The "space-size" style property

  "space-size"           gint                  : Read

Size of spacers.

Allowed values: >= 0

Default value: 12

The "space-style" style property

  "space-style"          GtkToolbarSpaceStyle  : Read

Whether spacers are vertical lines or just blank.

Default value: GTK_TOOLBAR_SPACE_LINE

The "focus-home-or-end" signal

gboolean    user_function                  (GtkToolbar *toolbar,
                                            gboolean    focus_home,
                                            gpointer    user_data)       : Run last / Action

A keybinding signal used internally by GTK+. This signal can't be used in application code

The "orientation-changed" signal

void        user_function                  (GtkToolbar    *toolbar,
                                            GtkOrientation orientation,
                                            gpointer       user_data)        : Run first

Emitted when the orientation of the toolbar changes.

The "popup-context-menu" signal

gboolean    user_function                  (GtkToolbar *toolbar,
                                            gint        x,
                                            gint        y,
                                            gint        button,
                                            gpointer    user_data)      : 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 keybaord, button is -1.

The "style-changed" signal

void        user_function                  (GtkToolbar     *toolbar,
                                            GtkToolbarStyle style,
                                            gpointer        user_data)      : Run first

Emitted when the style of the toolbar changes.