Function

GimpUienum_icon_box_new

since: 2.10

Declaration [src]

GtkWidget*
gimp_enum_icon_box_new (
  GType enum_type,
  const gchar* icon_prefix,
  GtkIconSize icon_size,
  GCallback callback,
  gpointer callback_data,
  GDestroyNotify callback_data_destroy,
  GtkWidget** first_button
)

Description [src]

Creates a horizontal box of radio buttons with named icons. The icon name for each icon is created by appending the enum_value’s nick to the given icon_prefix.

Available since: 2.10

Parameters

enum_type

Type: GType

The GType of an enum.

icon_prefix

Type: const gchar*

The prefix of the group of icon names to use.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
icon_size

Type: GtkIconSize

The icon size for the icons.

callback

Type: GCallback

A callback to connect to the “toggled” signal of each GtkRadioButton that is created.

The argument can be NULL.
callback_data

Type: gpointer

Data to pass to the callback.

The argument can be NULL.
The data is owned by the caller of the function.
callback_data_destroy

Type: GDestroyNotify

Destroy function for callback_data.

first_button

Type: GtkWidget

           Returns the first button in the created group.

The argument will be set by the function.
The argument can be NULL.
The data is owned by the caller of the function.

Return value

Type: GtkWidget

A new horizontal GtkBox holding a group of GtkRadioButtons.

The caller of the function takes ownership of the data, and is responsible for freeing it.