## GnomeDbFindDialog

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

## Synopsis

                        GnomeDbFindDialog;
                        GnomeDbFindDialogClass;
                        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);
    const gchar*        gnome_db_find_dialog_get_text       (GnomeDbFindDialog *dialog);
    const 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.

## Properties

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

## Description

## Details

### GnomeDbFindDialog

    typedef struct _GnomeDbFindDialog GnomeDbFindDialog;

### GnomeDbFindDialogClass

    typedef struct {
    	GtkDialogClass parent_class;
    } GnomeDbFindDialogClass;

### GnomeDbFindDialogPrivate

    typedef struct _GnomeDbFindDialogPrivate 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 ()

    const 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 ()

    const 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

## Property Details

### The "`field`" property

      "field"                    gchararray            : Read

Default value: NULL

### The "`model`" property

      "model"                    GdaDataModel          : Write / Construct Only

### The "`text`" property

      "text"                     gchararray            : Read

Default value: NULL