## GnomeDbFindDialog

GnomeDbFindDialog —

##

# Synopsis

    struct      GnomeDbFindDialogPrivate;
    GtkWidget*  gnome_db_find_dialog_new        (const gchar *title);
    GtkWidget*  gnome_db_find_dialog_new_with_model
                                                (const gchar *title,
                                                 GdaDataModel *dm);
    gboolean    gnome_db_find_dialog_run        (GnomeDbFindDialog *dialog);
    void        gnome_db_find_dialog_add_field  (GnomeDbFindDialog *dialog,
                                                 const gchar *field);
    void        gnome_db_find_dialog_add_fields_from_model
                                                (GnomeDbFindDialog *dialog,
                                                 GdaDataModel *dm);
    G_CONST_RETURN gchar* gnome_db_find_dialog_get_field
                                                (GnomeDbFindDialog *dialog);
    G_CONST_RETURN gchar* gnome_db_find_dialog_get_text
                                                (GnomeDbFindDialog *dialog);

## Description

## Details

### struct GnomeDbFindDialogPrivate

    struct GnomeDbFindDialogPrivate;

### gnome_db_find_dialog_new ()

    GtkWidget*  gnome_db_find_dialog_new        (const gchar *title);

Creates a new GnomeDbFindDialog.

`title` : | the title of the dialog
Returns : | a GnomeDbFindDialog

### gnome_db_find_dialog_new_with_model ()

    GtkWidget*  gnome_db_find_dialog_new_with_model
                                                (const gchar *title,
                                                 GdaDataModel *dm);

Creates a new GnomeDbFindDialog and adds the fields of `dm` to the Fields combo.

`title` : | the title of the dialog
`dm` : | a GdaDataModel
Returns : | a GnomeDbFindDialog

### gnome_db_find_dialog_run ()

    gboolean    gnome_db_find_dialog_run        (GnomeDbFindDialog *dialog);

Shows the `dialog` to the user and wait for his/her input.

`dialog` : | a GnomeDbFindDialog
Returns : | true if the user clicks "find", false otherwise.

### gnome_db_find_dialog_add_field ()

    void        gnome_db_find_dialog_add_field  (GnomeDbFindDialog *dialog,
                                                 const gchar *field);

Adds `field` to the Fields combo.

`dialog` : | a GnomeDbFindDialog
`field` : | the field's name

### gnome_db_find_dialog_add_fields_from_model ()

    void        gnome_db_find_dialog_add_fields_from_model
                                                (GnomeDbFindDialog *dialog,
                                                 GdaDataModel *dm);

Adds all the fields of `dm` into the Fields combo.

`dialog` : | a GnomeDbFindDialog
`dm` : | a GdaDataModel

### gnome_db_find_dialog_get_field ()

    G_CONST_RETURN gchar* gnome_db_find_dialog_get_field
                                                (GnomeDbFindDialog *dialog);

Gets the currently selected field in `dialog`.

`dialog` : | a GnomeDbFindDialog widget
Returns : | name of the selected field

### gnome_db_find_dialog_get_text ()

    G_CONST_RETURN gchar* gnome_db_find_dialog_get_text
                                                (GnomeDbFindDialog *dialog);

Gets the current search text in `dialog`.

`dialog` : | a GnomeDbFindDialog widget
Returns : | text to find