GnomeDbForm

GnomeDbForm — Form to display and modify data in a GnomeDbDataModel

Synopsis




            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);

Object Hierarchy


  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBox
                                 +----GtkVBox
                                       +----GnomeDbForm

Implemented Interfaces

GnomeDbForm implements AtkImplementorIface and GnomeDbDataWidget.

Properties


  "actions-visible"      gboolean              : Write
  "title-string"         gchararray            : Write
  "title-visible"        gboolean              : Write

Description

This widget uses a SELECT query and displays the data, with buttons to move within the result rows.

Details

GnomeDbForm

typedef struct _GnomeDbForm GnomeDbForm;


gnome_db_form_get_type ()

GType       gnome_db_form_get_type          (void);

Returns :

gnome_db_form_new ()

GtkWidget*  gnome_db_form_new               (void);

Creates a new GnomeDbForm widget

Returns : the new widget

gnome_db_form_new_with_gda_model ()

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

gnome_db_form_new_with_select_query ()

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

gnome_db_form_new_in_layout ()

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

Property Details

The "actions-visible" property

  "actions-visible"      gboolean              : Write

Default value: FALSE


The "title-string" property

  "title-string"         gchararray            : Write

Default value: NULL


The "title-visible" property

  "title-visible"        gboolean              : Write

Default value: FALSE

See Also

The GnomeDbForm widget which is being used in this widget.