clutter_model_iter_copy ()

ClutterModelIter *
clutter_model_iter_copy (ClutterModelIter *iter);

Copies the passed iterator.

Since 0.8

clutter_model_iter_get ()

void
clutter_model_iter_get (ClutterModelIter *iter,
                        ...);

Gets the value of one or more cells in the row referenced by iter . The variable argument list should contain integer column numbers, each column column number followed by a place to store the value being retrieved. The list is terminated by a -1.

For example, to get a value from column 0 with type G_TYPE_STRING use: <informalexample><programlisting> clutter_model_iter_get (iter, 0, &place_string_here, -1); </programlisting></informalexample>

where place_string_here is a gchar* to be filled with the string. If appropriate, the returned values have to be freed or unreferenced.

Since 0.6

clutter_model_iter_get_valist ()

void
clutter_model_iter_get_valist (ClutterModelIter *iter,
                               va_list args);

See clutter_model_iter_get(). This version takes a va_list for language bindings.

Since 0.6

clutter_model_iter_get_value ()

void
clutter_model_iter_get_value (ClutterModelIter *iter,
                              guint column,
                              GValue *value);

Sets an initializes value to that at column . When done with value , g_value_unset() needs to be called to free any allocated memory.

Since 0.6

clutter_model_iter_set ()

void
clutter_model_iter_set (ClutterModelIter *iter,
                        ...);

Sets the value of one or more cells in the row referenced by iter . The variable argument list should contain integer column numbers, each column column number followed by the value to be set. The list is terminated by a -1.

For example, to set column 0 with type G_TYPE_STRING, use: <informalexample><programlisting> clutter_model_iter_set (iter, 0, "foo", -1); </programlisting></informalexample>

Since 0.6

clutter_model_iter_set_valist ()

void
clutter_model_iter_set_valist (ClutterModelIter *iter,
                               va_list args);

See clutter_model_iter_set(); this version takes a va_list for language bindings.

Since 0.6

clutter_model_iter_set_value ()

void
clutter_model_iter_set_value (ClutterModelIter *iter,
                              guint column,
                              const GValue *value);

Sets the data in the cell specified by iter and column . The type of value must be convertable to the type of the column.

Since 0.6

clutter_model_iter_is_first ()

gboolean
clutter_model_iter_is_first (ClutterModelIter *iter);

Gets whether the current iterator is at the beginning of the model to which it belongs.

Since 0.6

clutter_model_iter_is_last ()

gboolean
clutter_model_iter_is_last (ClutterModelIter *iter);

Gets whether the iterator is at the end of the model to which it belongs.

Since 0.6

clutter_model_iter_next ()

ClutterModelIter *
clutter_model_iter_next (ClutterModelIter *iter);

Updates the iter to point at the next position in the model. The model implementation should take into account the presence of a filter function.

Since 0.6

clutter_model_iter_prev ()

ClutterModelIter *
clutter_model_iter_prev (ClutterModelIter *iter);

Sets the iter to point at the previous position in the model. The model implementation should take into account the presence of a filter function.

Since 0.6

clutter_model_iter_get_model ()

ClutterModel *
clutter_model_iter_get_model (ClutterModelIter *iter);

Retrieves a pointer to the ClutterModel that this iter is part of.

Since 0.6

clutter_model_iter_get_row ()

guint
clutter_model_iter_get_row (ClutterModelIter *iter);

Retrieves the position of the row that the iter points to.

Since 0.6

struct ClutterModelIter

struct ClutterModelIter;

Base class for list models iters. The ClutterModelIter structure contains only private data and should be manipulated using the provided API.

Since 0.6

struct ClutterModelIterClass

struct ClutterModelIterClass {
  /* vtable not signals */
  void              (* get_value) (ClutterModelIter *iter, 
                                   guint             column, 
                                   GValue           *value);
  void              (* set_value) (ClutterModelIter *iter, 
                                   guint             column, 
                                   const GValue     *value);

  gboolean          (* is_first)  (ClutterModelIter *iter);
  gboolean          (* is_last)   (ClutterModelIter *iter);

  ClutterModelIter *(* next)      (ClutterModelIter *iter);
  ClutterModelIter *(* prev)      (ClutterModelIter *iter);

  ClutterModel *    (* get_model) (ClutterModelIter *iter);
  guint             (* get_row)   (ClutterModelIter *iter);

  ClutterModelIter *(* copy)      (ClutterModelIter *iter);
};

Class for ClutterModelIter instances.

Since 0.6

The “model” property

  “model”                    ClutterModel *

A reference to the ClutterModel that this iter belongs to.

Flags: Read / Write

Since 0.6

The “row” property

  “row”                      guint

The row number to which this iter points to.

Flags: Read / Write

Default value: 0

Since 0.6