RGtk2 (version 2.20.31)

gtkToolbarInsertItem: 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.

Value

GtkWidget] the new toolbar item as a GtkWidget.

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.