RGtk2 (version 2.20.31)

gtkToolbarInsertElement: gtkToolbarInsertElement

Description

Inserts a new element in the toolbar at the given position. WARNING: gtk_toolbar_insert_element has been deprecated since version 2.4 and should not be used in newly-written code. Use gtkToolbarInsert instead.

Usage

gtkToolbarInsertElement(object, type, widget, text, tooltip.text,  tooltip.private.text, icon, callback, user.data = NULL, position)

Arguments

object

a GtkToolbar.

type

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

widget

a GtkWidget, or NULL. [ allow-none ]

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.

Value

GtkWidget] the new toolbar element as a GtkWidget.

Details

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 gCallback() to cast the function to GCallback.