Clutter.Actor.bind_model_with_properties

### Method

# Clutter Actorbind_model_with_properties

#### Declaration [src]

    void
    clutter_actor_bind_model_with_properties (
      ClutterActor* self,
      GListModel* model,
      GType child_type,
      const char* first_model_property,
      ...
    )

#### Description [src]

Binds a `GListModel` to a `ClutterActor`.

Unlike clutter_actor_bind_model(), this function automatically creates a child `ClutterActor` of type `child_type`, and binds properties on the items inside the `model` to the corresponding properties on the child, for instance:

      clutter_actor_bind_model_with_properties (actor, model,
                                                MY_TYPE_CHILD_VIEW,
                                                "label", "text", G_BINDING_DEFAULT | G_BINDING_SYNC_CREATE,
                                                "icon", "image", G_BINDING_DEFAULT | G_BINDING_SYNC_CREATE,
                                                "selected", "selected", G_BINDING_BIDIRECTIONAL,
                                                "active", "active", G_BINDING_BIDIRECTIONAL,
                                                NULL);

is the equivalent of calling `clutter_actor_bind_model()` with a `ClutterActorCreateChildFunc` of:

      ClutterActor *res = g_object_new (MY_TYPE_CHILD_VIEW, NULL);

      g_object_bind_property (item, "label", res, "text", G_BINDING_DEFAULT | G_BINDING_SYNC_CREATE);
      g_object_bind_property (item, "icon", res, "image", G_BINDING_DEFAULT | G_BINDING_SYNC_CREATE);
      g_object_bind_property (item, "selected", res, "selected", G_BINDING_BIDIRECTIONAL);
      g_object_bind_property (item, "active", res, "active", G_BINDING_BIDIRECTIONAL);

      return res;

If the `ClutterActor` was already bound to a `GListModel`, the previous binding is destroyed.

When a `ClutterActor` is bound to a model, adding and removing children directly is undefined behaviour.

See also: clutter_actor_bind_model()4.

This method is not directly available to language bindings.

#### Parameters

`model`

  Type: `GObject`

  A `GListModel`.

  The data is owned by the caller of the method.

`child_type`

  Type: `GType`

  The type of `ClutterActor` to use when creating children mapping to items inside the `model`.

`first_model_property`

  Type: `const char*`

  The first property of `model` to bind.

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

`...`

  Type: ``

  Tuples of property names on the `model`, on the child, and the `GBindingFlags` used to bind them, terminated by `NULL`.