Function
GimpUiprop_chooser_factory
unstable since: 3.0
Declaration [src]
GtkWidget*
gimp_prop_chooser_factory (
GimpResourceWidgetCreator widget_creator_func,
GObject* config,
const gchar* property_name,
const gchar* chooser_title
)
Description [src]
Creates a GimpResourceSelectButton
that displays
and sets the named property of the config.
The factory makes many kinds of widgets. Parameterized by passing a creator function for a kind of widget. E.G. creator function is gimp_brush_select_button_new. The created widget must have a property named “resource”.
The factory wraps the widget so that it is a prop widget.
A prop widget gets the initial choice from the config
and binds the property named property_name
of the config
to the widget’s “resource” property.
config
is usually a GimpProcedureConfig
(but it could be otherwise.)
The config
must have a property with name property_name
.
The property must be of type that matches that of the widget_creator_func
,
e.g. GimpBrush
.
The property_name
need not be “brush”,
since the config
may have more than one property of the same type e.g. GimpBrush
.
Available since: 3.0
This function is not directly available to language bindings.
Parameters
widget_creator_func
-
Type:
GimpResourceWidgetCreator
Function that creates a chooser widget.
config
-
Type:
GObject
Object to which property is attached.
The data is owned by the caller of the function. property_name
-
Type:
const gchar*
Name of property set by the widget.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. chooser_title
-
Type:
const gchar*
Title for the popup chooser dialog.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string.
Return value
Type: GtkWidget
The newly created GimpResourceSelectButton
widget.
The caller of the function takes ownership of the data, and is responsible for freeing it. |