Constructor

GtkButtonnew_from_icon_name

Declaration [src]

GtkWidget*
gtk_button_new_from_icon_name (
  const char* icon_name
)

Description [src]

Creates a new button containing an icon from the current icon theme.

If the icon name isn’t known, a “broken image” icon will be displayed instead. If the current icon theme is changed, the icon will be updated appropriately.

Parameters

icon_name const char*
 

An icon name.

 The argument can be NULL.
 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.

Return value

Returns: GtkWidget
 

A new GtkButton displaying the themed icon.

 The data is owned by the called function.