| Top |
| GBindingGroup * | g_binding_group_new () |
| gpointer | g_binding_group_dup_source () |
| void | g_binding_group_set_source () |
| void | g_binding_group_bind () |
| void | g_binding_group_bind_full () |
| void | g_binding_group_bind_with_closures () |
The GBindingGroup can be used to bind multiple properties from an object collectively.
Use the various methods to bind properties from a single source
object to multiple destination objects. Properties can be bound
bidirectionally and are connected when the source object is set
with g_binding_group_set_source().
GBindingGroup *
g_binding_group_new (void);
Creates a new GBindingGroup.
Since: 2.72
gpointer
g_binding_group_dup_source (GBindingGroup *self);
Gets the source object used for binding properties.
Since: 2.72
void g_binding_group_set_source (GBindingGroup *self,gpointer source);
Sets source
as the source object used for creating property
bindings. If there is already a source object all bindings from it
will be removed.
Note that all properties that have been bound must exist on source
.
Since: 2.72
void g_binding_group_bind (GBindingGroup *self,const gchar *source_property,gpointer target,const gchar *target_property,GBindingFlags flags);
Creates a binding between source_property
on the source object
and target_property
on target
. Whenever the source_property
is changed the target_property
is updated using the same value.
The binding flag G_BINDING_SYNC_CREATE is automatically specified.
See g_object_bind_property() for more information.
self |
the GBindingGroup |
|
source_property |
the property on the source to bind |
|
target |
the target GObject. |
[type GObject][transfer none][not nullable] |
target_property |
the property on |
|
flags |
the flags used to create the GBinding |
Since: 2.72
void g_binding_group_bind_full (GBindingGroup *self,const gchar *source_property,gpointer target,const gchar *target_property,GBindingFlags flags,GBindingTransformFunc transform_to,GBindingTransformFunc transform_from,gpointer user_data,GDestroyNotify user_data_destroy);
Creates a binding between source_property
on the source object and
target_property
on target
, allowing you to set the transformation
functions to be used by the binding. The binding flag
G_BINDING_SYNC_CREATE is automatically specified.
See g_object_bind_property_full() for more information.
self |
the GBindingGroup |
|
source_property |
the property on the source to bind |
|
target |
the target GObject. |
[type GObject][transfer none][not nullable] |
target_property |
the property on |
|
flags |
the flags used to create the GBinding |
|
transform_to |
the transformation function
from the source object to the |
[scope notified][nullable] |
transform_from |
the transformation function
from the |
[scope notified][nullable] |
user_data |
custom data to be passed to the transformation
functions, or |
|
user_data_destroy |
function to be called when disposing the binding, to free the resources used by the transformation functions |
Since: 2.72
void g_binding_group_bind_with_closures (GBindingGroup *self,const gchar *source_property,gpointer target,const gchar *target_property,GBindingFlags flags,GClosure *transform_to,GClosure *transform_from);
Creates a binding between source_property
on the source object and
target_property
on target
, allowing you to set the transformation
functions to be used by the binding. The binding flag
G_BINDING_SYNC_CREATE is automatically specified.
This function is the language bindings friendly version of
g_binding_group_bind_property_full(), using GClosures
instead of function pointers.
See g_object_bind_property_with_closures() for more information.
[rename-to g_binding_group_bind_full]
self |
the GBindingGroup |
|
source_property |
the property on the source to bind |
|
target |
the target GObject. |
[type GObject][transfer none][not nullable] |
target_property |
the property on |
|
flags |
the flags used to create the GBinding |
|
transform_to |
a GClosure wrapping the
transformation function from the source object to the |
[nullable][transfer none] |
transform_from |
a GClosure wrapping the
transformation function from the |
[nullable][transfer none] |
Since: 2.72
typedef struct _GBindingGroup GBindingGroup;
GBindingGroup is an opaque structure whose members cannot be accessed directly.
Since: 2.72