gtkToolbarInsertItem {RGtk2} | R Documentation

## gtkToolbarInsertItem

### Description

Inserts a new item into the toolbar. You must specify the position in the toolbar where it will be inserted. WARNING: `gtk_toolbar_insert_item` has been deprecated since version 2.4 and should not be used in newly-written code. Use `gtkToolbarInsert` instead.

### Usage

    gtkToolbarInsertItem(object, text, tooltip.text, tooltip.private.text,
        icon, callback, user.data, position)

### Arguments

``object`` | 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.

### Details

`callback` must be a pointer to a function taking a `GtkWidget` and a gpointer as arguments. Use `gCallback()` to cast the function to `GCallback`.

### Value

[`GtkWidget`] the new toolbar item as a `GtkWidget`.

### Author(s)

Derived by RGtkGen from GTK+ documentation

[Package RGtk2 version 2.20.36.3 Index]