MxItemView

## MxItemView MxItemView — a flow layout driven by a model. |

## Synopsis

                        MxItemView;
    ClutterActor *      mx_item_view_new                    (void);
    void                mx_item_view_set_model              (MxItemView *item_view,
                                                             ClutterModel *model);
    ClutterModel *      mx_item_view_get_model              (MxItemView *item_view);
    void                mx_item_view_set_item_type          (MxItemView *item_view,
                                                             GType item_type);
    GType               mx_item_view_get_item_type          (MxItemView *item_view);
    void                mx_item_view_add_attribute          (MxItemView *item_view,
                                                             const gchar *attribute,
                                                             gint column);
    void                mx_item_view_freeze                 (MxItemView *item_view);
    void                mx_item_view_thaw                   (MxItemView *item_view);
    void                mx_item_view_set_factory            (MxItemView *item_view,
                                                             MxItemFactory *factory);
    MxItemFactory *     mx_item_view_get_factory            (MxItemView *item_view);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----ClutterActor
                   +----MxWidget
                         +----MxGrid
                               +----MxItemView

## Implemented Interfaces

MxItemView implements ClutterScriptable, MxStylable, ClutterContainer, MxScrollable and MxFocusable.

## Properties

      "factory"                  GObject*              : Read / Write
      "item-type"                GType*                : Read / Write
      "model"                    ClutterModel*         : Read / Write

## Description

MxItemView is a flow layout container driven by a ClutterModel. Children are created for each row in the model, either by creating actors from the supplied ClutterActor derived type, or from a MxItemFactory.

Data is set on the children by mapping columns in the model to object properties on the children.

## Details

### MxItemView

    typedef struct _MxItemView MxItemView;

The contents of the this structure are private and should only be accessed through the public API.

### mx_item_view_new ()

    ClutterActor *      mx_item_view_new                    (void);

Create a new MxItemView

Returns : | a newly allocated MxItemView

### mx_item_view_set_model ()

    void                mx_item_view_set_model              (MxItemView *item_view,
                                                             ClutterModel *model);

Set the model used by the MxItemView

`item_view` : | An MxItemView
`model` : | A ClutterModel

### mx_item_view_get_model ()

    ClutterModel *      mx_item_view_get_model              (MxItemView *item_view);

Get the model currently used by the MxItemView

`item_view` : | An MxItemView
Returns : | the current ClutterModel

### mx_item_view_set_item_type ()

    void                mx_item_view_set_item_type          (MxItemView *item_view,
                                                             GType item_type);

Set the item type used to create items representing each row in the model

`item_view` : | An MxItemView
`item_type` : | A GType

### mx_item_view_get_item_type ()

    GType               mx_item_view_get_item_type          (MxItemView *item_view);

Get the item type currently being used to create items

`item_view` : | An MxItemView
Returns : | a GType

### mx_item_view_add_attribute ()

    void                mx_item_view_add_attribute          (MxItemView *item_view,
                                                             const gchar *attribute,
                                                             gint column);

Adds an attribute mapping between the current model and the objects from the cell renderer.

`item_view` : | An MxItemView
`attribute` : | Name of the attribute
`column` : | Column number

### mx_item_view_freeze ()

    void                mx_item_view_freeze                 (MxItemView *item_view);

Freeze the view. This means that the view will not act on changes to the model until it is thawed. Call `mx_item_view_thaw()` to thaw the view

`item_view` : | An MxItemView

### mx_item_view_thaw ()

    void                mx_item_view_thaw                   (MxItemView *item_view);

Thaw the view. This means that the view will now act on changes to the model.

`item_view` : | An MxItemView

### mx_item_view_set_factory ()

    void                mx_item_view_set_factory            (MxItemView *item_view,
                                                             MxItemFactory *factory);

Sets `factory` to be the factory used for creating new items

`item_view` : | A MxItemView
`factory` : | A MxItemFactory. [allow-none]

### mx_item_view_get_factory ()

    MxItemFactory *     mx_item_view_get_factory            (MxItemView *item_view);

Gets the MxItemFactory used for creating new items.

`item_view` : | A MxItemView
Returns : | A MxItemFactory.

## Property Details

### The `"factory"` property

      "factory"                  GObject*              : Read / Write

The MxItemFactory used for creating new items.

### The `"item-type"` property

      "item-type"                GType*                : Read / Write

The GType to use as the items in the view. Must be a subclass of ClutterActor.

Allowed values: ClutterActor

### The `"model"` property

      "model"                    ClutterModel*         : Read / Write

The model for the item view.