![]() |
![]() |
![]() |
Libgnomedb Reference Manual | ![]() |
---|---|---|---|---|
GnomeDbFormGnomeDbForm — Form to display and modify data in a GnomeDbDataModel |
GnomeDbForm; GType gnome_db_form_get_type (void); GtkWidget* gnome_db_form_new (void); GtkWidget* gnome_db_form_new_with_gda_model (GnomeDbDict *dict, GdaDataModel *model); GtkWidget* gnome_db_form_new_with_select_query (GnomeDbQuery *query, GnomeDbTarget *modified); GtkWidget* gnome_db_form_new_in_layout (GnomeDbQuery *query, GnomeDbTarget *modified, GtkWidget *layout, GHashTable *box_widgets);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkVBox +----GnomeDbForm
"actions-visible" gboolean : Write "title-string" gchararray : Write "title-visible" gboolean : Write
This widget uses a SELECT query and displays the data, with buttons to move within the result rows.
GtkWidget* gnome_db_form_new (void);
Creates a new GnomeDbForm widget
Returns : | the new widget |
GtkWidget* gnome_db_form_new_with_gda_model (GnomeDbDict *dict, GdaDataModel *model);
Creates a new GnomeDbForm widget suitable to display the data in model
dict : |
a GnomeDbDict dictionary, or NULL
|
model : |
a GdaDataModel |
Returns : | the new widget |
GtkWidget* gnome_db_form_new_with_select_query (GnomeDbQuery *query, GnomeDbTarget *modified);
Creates a new GnomeDbForm widget.
query
must be a SELECT query (no union, etc selection query)
The modified
target must belong to query
and represent
modifiable entity (a GnomeDbTable for example). If modified
is NULL
then
no modification will be allowed.
query : |
a GnomeDbQuery object |
modified : |
a GnomeDbTarget object, or NULL
|
Returns : | the new widget |
GtkWidget* gnome_db_form_new_in_layout (GnomeDbQuery *query, GnomeDbTarget *modified, GtkWidget *layout, GHashTable *box_widgets);
Creates a new GnomeDbForm widget.
query
must be a SELECT query (no union, etc selection query)
The modified
target must belong to query
and represent
modifiable entity (a GnomeDbTable for example). If modified
is NULL
then
no modification will be allowed.
This function is similar to gnome_db_form_new()
but provides a GtkWidget to pack
entries in. The box_widgets
hash table has keys corresponding to the
query fields of query
, and corresponding values pointing to the GtkBox widgets
where the MGDataEntry widgets will be packed.
If any of layout
or box_widgets
is NULL
, then this function is equivalent to gnome_db_form_new()
.
query : |
a GnomeDbQuery object |
modified : |
a GnomeDbTarget object, or NULL
|
layout : |
a GtkWidget object |
box_widgets : |
a GHashTable of GtkBox widgets |
Returns : | the new widget |