GdaDataModelIter

GdaDataModelIter

Synopsis

                    GdaDataModelIter;
GdaDataModelIter *  gda_data_model_iter_new             (GdaDataModel *model);
const GValue *      gda_data_model_iter_get_value_at    (GdaDataModelIter *iter,
                                                         gint col);
const GValue *      gda_data_model_iter_get_value_for_field
                                                        (GdaDataModelIter *iter,
                                                         const gchar *field_name);
gboolean            gda_data_model_iter_is_valid        (GdaDataModelIter *iter);
gboolean            gda_data_model_iter_set_at_row      (GdaDataModelIter *iter,
                                                         gint row);
gboolean            gda_data_model_iter_move_next       (GdaDataModelIter *iter);
gboolean            gda_data_model_iter_move_prev       (GdaDataModelIter *iter);
gint                gda_data_model_iter_get_row         (GdaDataModelIter *iter);
void                gda_data_model_iter_invalidate_contents
                                                        (GdaDataModelIter *iter);
gint                gda_data_model_iter_get_column_for_param
                                                        (GdaDataModelIter *iter,
                                                         GdaParameter *param);
GdaParameter *      gda_data_model_iter_get_param_for_column
                                                        (GdaDataModelIter *iter,
                                                         gint col);

Object Hierarchy

  GObject
   +----GdaObject
         +----GdaParameterList
               +----GdaDataModelIter

Properties

  "current-row"              gint                  : Read / Write
  "data-model"               GdaDataModel*         : Read / Write / Construct Only
  "forced-model"             GdaDataModel*         : Read / Write
  "update-model"             gboolean              : Read / Write

Signals

  "end-of-data"                                    : Run First
  "row-changed"                                    : Run First
  "row-to-change"                                  : Run Last

Description

Details

GdaDataModelIter

typedef struct _GdaDataModelIter GdaDataModelIter;


gda_data_model_iter_new ()

GdaDataModelIter *  gda_data_model_iter_new             (GdaDataModel *model);

Creates a new GdaDataModelIter object which represents a value or a parameter.

model :

Model used to create the GdaDataModelIter

Returns :

the new object

gda_data_model_iter_get_value_at ()

const GValue *      gda_data_model_iter_get_value_at    (GdaDataModelIter *iter,
                                                         gint col);

Get the value stored at the column col in iter

iter :

a GdaDataModelIter object

col :

the requested column

Returns :

the GValue, or NULL

gda_data_model_iter_get_value_for_field ()

const GValue *      gda_data_model_iter_get_value_for_field
                                                        (GdaDataModelIter *iter,
                                                         const gchar *field_name);

Get the value stored at the column field_name in iter

iter :

a GdaDataModelIter object

field_name :

the requested column name

Returns :

the GValue, or NULL

gda_data_model_iter_is_valid ()

gboolean            gda_data_model_iter_is_valid        (GdaDataModelIter *iter);

Tells if iter is a valid iterator (if it actually corresponds to a valid row in the model)

iter :

a GdaDataModelIter object

Returns :

TRUE if iter is valid

gda_data_model_iter_set_at_row ()

gboolean            gda_data_model_iter_set_at_row      (GdaDataModelIter *iter,
                                                         gint row);

Synchronizes the values of the parameters in iter with the values at the row row

If row < 0 then iter is not bound to any row of the data model it iters through.

iter :

a GdaDataModelIter object

row :

the row to set iter to

Returns :

TRUE if no error occurred

gda_data_model_iter_move_next ()

gboolean            gda_data_model_iter_move_next       (GdaDataModelIter *iter);

Moves iter one row further than where it already is (synchronizes the values of the parameters in iter with the values at the new row).

iter :

a GdaDataModelIter object

Returns :

TRUE if no error occurred

gda_data_model_iter_move_prev ()

gboolean            gda_data_model_iter_move_prev       (GdaDataModelIter *iter);

Moves iter one row before where it already is (synchronizes the values of the parameters in iter with the values at the new row).

iter :

a GdaDataModelIter object

Returns :

TRUE if no error occurred

gda_data_model_iter_get_row ()

gint                gda_data_model_iter_get_row         (GdaDataModelIter *iter);

Get the row which iter represents in the data model

iter :

a GdaDataModelIter object

Returns :

the row number, or -1 if not available

gda_data_model_iter_invalidate_contents ()

void                gda_data_model_iter_invalidate_contents
                                                        (GdaDataModelIter *iter);

Declare all the parameters in iter invalid, without modifying the GdaDataModel iter is for or changing the row it represents

iter :

a GdaDataModelIter object

gda_data_model_iter_get_column_for_param ()

gint                gda_data_model_iter_get_column_for_param
                                                        (GdaDataModelIter *iter,
                                                         GdaParameter *param);

Get the column number in the GdaDataModel for which iter is an iterator as represented by the param parameter

iter :

a GdaDataModelIter object

param :

a GdaParameter object, listed in iter

Returns :

the column number, or param is not valid

gda_data_model_iter_get_param_for_column ()

GdaParameter *      gda_data_model_iter_get_param_for_column
                                                        (GdaDataModelIter *iter,
                                                         gint col);

Fetch a pointer to the GdaParameter object which is synchronized with data at column col

iter :

a GdaDataModelIter object

col :

the requested column

Returns :

the GdaParameter, or NULL if an error occurred

Property Details

The "current-row" property

  "current-row"              gint                  : Read / Write

Allowed values: >= -1

Default value: -1


The "data-model" property

  "data-model"               GdaDataModel*         : Read / Write / Construct Only


The "forced-model" property

  "forced-model"             GdaDataModel*         : Read / Write


The "update-model" property

  "update-model"             gboolean              : Read / Write

Default value: TRUE

Signal Details

The "end-of-data" signal

void                user_function                      (GdaDataModelIter *gdadatamodeliter,
                                                        gpointer          user_data)             : Run First

gdadatamodeliter :

the object which received the signal.

user_data :

user data set when the signal handler was connected.

The "row-changed" signal

void                user_function                      (GdaDataModelIter *gdadatamodeliter,
                                                        gint              arg1,
                                                        gpointer          user_data)             : Run First

gdadatamodeliter :

the object which received the signal.

user_data :

user data set when the signal handler was connected.

The "row-to-change" signal

gboolean            user_function                      (GdaDataModelIter *gdadatamodeliter,
                                                        gint              arg1,
                                                        gpointer          user_data)             : Run Last

gdadatamodeliter :

the object which received the signal.

user_data :

user data set when the signal handler was connected.