Constructor

GtkImagenew_from_icon_name

Declaration [src]

GtkWidget*
gtk_image_new_from_icon_name (
  const gchar* icon_name,
  GtkIconSize size
)

Description [src]

Creates a GtkImage displaying 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.

Available since:2.6

Parameters

icon_name const gchar*
 

An icon name or NULL.

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

A stock icon size (GtkIconSize)

Return value

Returns: GtkWidget
 

A new GtkImage displaying the themed icon.

 The data is owned by the called function.