## GnomeDbFindDialog

GnomeDbFindDialog — A dialog to enter a string to search among a GdaDataModel

##

# Synopsis

    struct      GnomeDbFindDialog;
    struct      GnomeDbFindDialogClass;
    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_text
                                                (GnomeDbFindDialog *dialog);
    G_CONST_RETURN gchar* gnome_db_find_dialog_get_field
                                                (GnomeDbFindDialog *dialog);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBin
                                     +----GtkWindow
                                           +----GtkDialog
                                                 +----GnomeDbFindDialog

## Implemented Interfaces

GnomeDbFindDialog implements AtkImplementorIface and GtkBuildable.

## Properties

      "field"                gchararray           : Read
      "model"                GdaDataModel         : Write / Construct Only
      "text"                 gchararray           : Read

## Description

## Details

### struct GnomeDbFindDialog

    struct GnomeDbFindDialog;

### struct GnomeDbFindDialogClass

    struct GnomeDbFindDialogClass {

    	GtkDialogClass parent_class;
    };

### 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_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

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

## Properties

"`field`" (gchararray : Read) |
"`model`" (GdaDataModel : Write / Construct Only) |
"`text`" (gchararray : Read) |