## 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
       +----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.