![]() |
![]() |
![]() |
GNOME Data Access 3.0 manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties | Signals |
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
);
"current-row" gint : Read / Write "data-model" GdaDataModel* : Read / Write / Construct Only "forced-model" GdaDataModel* : Read / Write "update-model" gboolean : Read / Write
GdaDataModelIter * gda_data_model_iter_new (GdaDataModel *model
);
Creates a new GdaDataModelIter object which represents a value or a parameter.
|
Model used to create the GdaDataModelIter |
Returns : |
the new object |
const GValue * gda_data_model_iter_get_value_at (GdaDataModelIter *iter
,gint col
);
Get the value stored at the column col
in iter
|
a GdaDataModelIter object |
|
the requested column |
Returns : |
the GValue, or NULL
|
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
|
a GdaDataModelIter object |
|
the requested column name |
Returns : |
the GValue, or NULL
|
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)
|
a GdaDataModelIter object |
Returns : |
TRUE if iter is valid |
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.
|
a GdaDataModelIter object |
|
the row to set iter to |
Returns : |
TRUE if no error occurred |
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).
|
a GdaDataModelIter object |
Returns : |
TRUE if no error occurred |
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).
|
a GdaDataModelIter object |
Returns : |
TRUE if no error occurred |
gint gda_data_model_iter_get_row (GdaDataModelIter *iter
);
Get the row which iter
represents in the data model
|
a GdaDataModelIter object |
Returns : |
the row number, or -1 if not available |
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
|
a GdaDataModelIter object |
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
|
a GdaDataModelIter object |
|
a GdaParameter object, listed in iter
|
Returns : |
the column number, or param is not valid |
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
|
a GdaDataModelIter object |
|
the requested column |
Returns : |
the GdaParameter, or NULL if an error occurred |
"current-row"
property "current-row" gint : Read / Write
Allowed values: >= -1
Default value: -1
"end-of-data"
signalvoid user_function (GdaDataModelIter *gdadatamodeliter,
gpointer user_data) : Run First
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"row-changed"
signalvoid user_function (GdaDataModelIter *gdadatamodeliter,
gint arg1,
gpointer user_data) : Run First
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"row-to-change"
signalgboolean user_function (GdaDataModelIter *gdadatamodeliter,
gint arg1,
gpointer user_data) : Run Last
|
the object which received the signal. |
|
user data set when the signal handler was connected. |