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