GtkToolbar

GtkToolbar — Create bars of buttons and other widgets

Synopsis


#include <gtk/gtk.h>


                    GtkToolbar;
enum                GtkToolbarChildType;
enum                GtkToolbarSpaceStyle;
                    GtkToolbarChild;
GtkWidget*          gtk_toolbar_new                     (void);
void                gtk_toolbar_insert                  (GtkToolbar *toolbar,
                                                         GtkToolItem *item,
                                                         gint pos);
gint                gtk_toolbar_get_item_index          (GtkToolbar *toolbar,
                                                         GtkToolItem *item);
gint                gtk_toolbar_get_n_items             (GtkToolbar *toolbar);
GtkToolItem*        gtk_toolbar_get_nth_item            (GtkToolbar *toolbar,
                                                         gint n);
gint                gtk_toolbar_get_drop_index          (GtkToolbar *toolbar,
                                                         gint x,
                                                         gint y);
void                gtk_toolbar_set_drop_highlight_item (GtkToolbar *toolbar,
                                                         GtkToolItem *tool_item,
                                                         gint index_);
void                gtk_toolbar_set_show_arrow          (GtkToolbar *toolbar,
                                                         gboolean show_arrow);
void                gtk_toolbar_set_orientation         (GtkToolbar *toolbar,
                                                         GtkOrientation orientation);
void                gtk_toolbar_set_tooltips            (GtkToolbar *toolbar,
                                                         gboolean enable);
void                gtk_toolbar_unset_icon_size         (GtkToolbar *toolbar);
gboolean            gtk_toolbar_get_show_arrow          (GtkToolbar *toolbar);
GtkOrientation      gtk_toolbar_get_orientation         (GtkToolbar *toolbar);
GtkToolbarStyle     gtk_toolbar_get_style               (GtkToolbar *toolbar);
GtkIconSize         gtk_toolbar_get_icon_size           (GtkToolbar *toolbar);
gboolean            gtk_toolbar_get_tooltips            (GtkToolbar *toolbar);
GtkReliefStyle      gtk_toolbar_get_relief_style        (GtkToolbar *toolbar);
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);
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);
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);
void                gtk_toolbar_append_space            (GtkToolbar *toolbar);
void                gtk_toolbar_prepend_space           (GtkToolbar *toolbar);
void                gtk_toolbar_insert_space            (GtkToolbar *toolbar,
                                                         gint position);
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);
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);
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);
void                gtk_toolbar_append_widget           (GtkToolbar *toolbar,
                                                         GtkWidget *widget,
                                                         const char *tooltip_text,
                                                         const char *tooltip_private_text);
void                gtk_toolbar_prepend_widget          (GtkToolbar *toolbar,
                                                         GtkWidget *widget,
                                                         const char *tooltip_text,
                                                         const char *tooltip_private_text);
void                gtk_toolbar_insert_widget           (GtkToolbar *toolbar,
                                                         GtkWidget *widget,
                                                         const char *tooltip_text,
                                                         const char *tooltip_private_text,
                                                         gint position);
void                gtk_toolbar_set_style               (GtkToolbar *toolbar,
                                                         GtkToolbarStyle style);
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);
void                gtk_toolbar_set_icon_size           (GtkToolbar *toolbar,
                                                         GtkIconSize icon_size);
void                gtk_toolbar_remove_space            (GtkToolbar *toolbar,
                                                         gint position);
void                gtk_toolbar_unset_style             (GtkToolbar *toolbar);


Description

A toolbar is created with a call to gtk_toolbar_new().

A toolbar can contain instances of a subclass of GtkToolItem. To add a GtkToolItem to the a toolbar, use gtk_toolbar_insert(). To remove an item from the toolbar use gtk_container_remove(). To add a button to the toolbar, add an instance of GtkToolButton.

Toolbar items can be visually grouped by adding instances of GtkSeparatorToolItem to the toolbar. If a GtkSeparatorToolItem has the "expand" property set to TRUE and the "draw" property 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 GtkToolbar::popup-context-menu signal.

Details

GtkToolbar

typedef struct {
  GtkContainer container;

  gint             num_children;
  GList           *children;
  GtkOrientation   orientation;
  GtkToolbarStyle  style;
  GtkIconSize      icon_size;
  
#ifndef GTK_DISABLE_DEPRECATED
  GtkTooltips     *tooltips;
#else
  gpointer         _tooltips;
#endif
} 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;

Warning

GtkToolbarChildType is deprecated and should not be used in newly-written code.

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

GTK_TOOLBAR_CHILD_SPACE

a space in the style of the toolbar's GtkToolbarSpaceStyle.

GTK_TOOLBAR_CHILD_BUTTON

a GtkButton.

GTK_TOOLBAR_CHILD_TOGGLEBUTTON

a GtkToggleButton.

GTK_TOOLBAR_CHILD_RADIOBUTTON

a GtkRadioButton.

GTK_TOOLBAR_CHILD_WIDGET

a standard GtkWidget.

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;

Warning

GtkToolbarChild is deprecated and should not be used in newly-written code.


gtk_toolbar_new ()

GtkWidget*          gtk_toolbar_new                     (void);

Creates a new toolbar.

Returns :

the newly-created 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.

toolbar :

a GtkToolbar

item :

a GtkToolItem

pos :

the position of the new item

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.

toolbar :

a GtkToolbar

item :

a GtkToolItem that is a child of toolbar

Returns :

the position of item on 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.

toolbar :

a GtkToolbar

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.

toolbar :

a GtkToolbar

n :

A position on the toolbar

Returns :

The n'th GtkToolItem on toolbar, or NULL if there isn't 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.

toolbar :

a GtkToolbar

x :

x coordinate of a point on the toolbar

y :

y coordinate of a point on the toolbar

Returns :

The position corresponding to the point (x, y) on the toolbar.

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.

toolbar :

a GtkToolbar

tool_item :

a GtkToolItem, or NULL to turn of highlighting

index_ :

a position on 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.

toolbar :

a GtkToolbar

show_arrow :

Whether to show 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.

toolbar :

a GtkToolbar.

orientation :

a new GtkOrientation.

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.

toolbar :

a GtkToolbar.

enable :

set to FALSE to disable the tooltips, or TRUE to enable them.

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.

toolbar :

a GtkToolbar

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().

toolbar :

a GtkToolbar

Returns :

TRUE if the toolbar has an overflow menu.

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().

toolbar :

a GtkToolbar

Returns :

the 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().

toolbar :

a GtkToolbar

Returns :

the current style of toolbar

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().

toolbar :

a GtkToolbar

Returns :

the current icon size for the icons on the toolbar.

gtk_toolbar_get_tooltips ()

gboolean            gtk_toolbar_get_tooltips            (GtkToolbar *toolbar);

Retrieves whether tooltips are enabled. See gtk_toolbar_set_tooltips().

toolbar :

a GtkToolbar

Returns :

TRUE if tooltips are enabled

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().

toolbar :

a GtkToolbar

Returns :

The relief style of buttons on toolbar.

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);

Warning

gtk_toolbar_append_item is deprecated and should not be used in newly-written code.

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.

toolbar :

a GtkToolbar.

text :

give your toolbar button a label.

tooltip_text :

a string that appears when the user holds the mouse over this item.

tooltip_private_text :

use with GtkTipsQuery.

icon :

a GtkWidget that should be used as the button's icon.

callback :

the function to be executed when the button is pressed.

user_data :

a pointer to any data you wish to be passed to the callback.

Returns :

the new toolbar item as a GtkWidget.

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);

Warning

gtk_toolbar_prepend_item is deprecated and should not be used in newly-written code.

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.

toolbar :

a GtkToolbar.

text :

give your toolbar button a label.

tooltip_text :

a string that appears when the user holds the mouse over this item.

tooltip_private_text :

use with GtkTipsQuery.

icon :

a GtkWidget that should be used as the button's icon.

callback :

the function to be executed when the button is pressed.

user_data :

a pointer to any data you wish to be passed to the callback.

Returns :

the new toolbar item as a GtkWidget.

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);

Warning

gtk_toolbar_insert_item is deprecated and should not be used in newly-written code.

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.

toolbar :

a GtkToolbar.

text :

give your toolbar button a label.

tooltip_text :

a string that appears when the user holds the mouse over this item.

tooltip_private_text :

use with GtkTipsQuery.

icon :

a GtkWidget that should be used as the button's icon.

callback :

the function to be executed when the button is pressed.

user_data :

a pointer to any data you wish to be passed to the callback.

position :

the number of widgets to insert this item after.

Returns :

the new toolbar item as a GtkWidget.

gtk_toolbar_append_space ()

void                gtk_toolbar_append_space            (GtkToolbar *toolbar);

Warning

gtk_toolbar_append_space is deprecated and should not be used in newly-written code.

Adds a new space to the end of the toolbar.

toolbar :

a GtkToolbar.

gtk_toolbar_prepend_space ()

void                gtk_toolbar_prepend_space           (GtkToolbar *toolbar);

Warning

gtk_toolbar_prepend_space is deprecated and should not be used in newly-written code.

Adds a new space to the beginning of the toolbar.

toolbar :

a GtkToolbar.

gtk_toolbar_insert_space ()

void                gtk_toolbar_insert_space            (GtkToolbar *toolbar,
                                                         gint position);

Warning

gtk_toolbar_insert_space is deprecated and should not be used in newly-written code.

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

toolbar :

a GtkToolbar

position :

the number of widgets after which a space should be inserted.

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);

Warning

gtk_toolbar_append_element is deprecated and should not be used in newly-written code.

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.

toolbar :

a GtkToolbar.

type :

a value of type GtkToolbarChildType that determines what widget will be.

widget :

a GtkWidget, or NULL.

text :

the element's label.

tooltip_text :

the element's tooltip.

tooltip_private_text :

used for context-sensitive help about this toolbar element.

icon :

a GtkWidget that provides pictorial representation of the element's function.

callback :

the function to be executed when the button is pressed.

user_data :

any data you wish to pass to the callback.

Returns :

the new toolbar element as a GtkWidget.

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);

Warning

gtk_toolbar_prepend_element is deprecated and should not be used in newly-written code.

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.

toolbar :

a GtkToolbar.

type :

a value of type GtkToolbarChildType that determines what widget will be.

widget :

a GtkWidget, or NULL

text :

the element's label.

tooltip_text :

the element's tooltip.

tooltip_private_text :

used for context-sensitive help about this toolbar element.

icon :

a GtkWidget that provides pictorial representation of the element's function.

callback :

the function to be executed when the button is pressed.

user_data :

any data you wish to pass to the callback.

Returns :

the new toolbar element as a GtkWidget.

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);

Warning

gtk_toolbar_insert_element is deprecated and should not be used in newly-written code.

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.

toolbar :

a GtkToolbar.

type :

a value of type GtkToolbarChildType that determines what widget will be.

widget :

a GtkWidget, or NULL.

text :

the element's label.

tooltip_text :

the element's tooltip.

tooltip_private_text :

used for context-sensitive help about this toolbar element.

icon :

a GtkWidget that provides pictorial representation of the element's function.

callback :

the function to be executed when the button is pressed.

user_data :

any data you wish to pass to the callback.

position :

the number of widgets to insert this element after.

Returns :

the new toolbar element as a GtkWidget.

gtk_toolbar_append_widget ()

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

Warning

gtk_toolbar_append_widget is deprecated and should not be used in newly-written code.

Adds a widget to the end of the given toolbar.

toolbar :

a GtkToolbar.

widget :

a GtkWidget to add to the toolbar.

tooltip_text :

the element's tooltip.

tooltip_private_text :

used for context-sensitive help about this toolbar element.

gtk_toolbar_prepend_widget ()

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

Warning

gtk_toolbar_prepend_widget is deprecated and should not be used in newly-written code.

Adds a widget to the beginning of the given toolbar.

toolbar :

a GtkToolbar.

widget :

a GtkWidget to add to the toolbar.

tooltip_text :

the element's tooltip.

tooltip_private_text :

used for context-sensitive help about this toolbar element.

gtk_toolbar_insert_widget ()

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

Warning

gtk_toolbar_insert_widget is deprecated and should not be used in newly-written code.

Inserts a widget in the toolbar at the given position.

toolbar :

a GtkToolbar.

widget :

a GtkWidget to add to the toolbar.

tooltip_text :

the element's tooltip.

tooltip_private_text :

used for context-sensitive help about this toolbar element.

position :

the number of widgets to insert this widget after.

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.

toolbar :

a GtkToolbar.

style :

the new style for toolbar.

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);

Warning

gtk_toolbar_insert_stock is deprecated and should not be used in newly-written code.

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.

toolbar :

A GtkToolbar

stock_id :

The id of the stock item you want to insert

tooltip_text :

The text in the tooltip of the toolbar button

tooltip_private_text :

The private text of the tooltip

callback :

The callback called when the toolbar button is clicked.

user_data :

user data passed to callback

position :

The position the button shall be inserted at. -1 means at the end.

Returns :

the inserted widget

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.

toolbar :

A GtkToolbar

icon_size :

The GtkIconSize that stock icons in the toolbar shall have.

gtk_toolbar_remove_space ()

void                gtk_toolbar_remove_space            (GtkToolbar *toolbar,
                                                         gint position);

Warning

gtk_toolbar_remove_space is deprecated and should not be used in newly-written code.

Removes a space from the specified position.

toolbar :

a GtkToolbar.

position :

the index of the space to remove.

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.

toolbar :

a GtkToolbar

See Also

GtkToolItem

Base class of widgets that can be added to a toolbar.