<refentry id="GnomeDbFindDialog">
<refmeta>
<refentrytitle>GnomeDbFindDialog</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>LIBGNOMEDB-4.0 Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GnomeDbFindDialog</refname><refpurpose>A dialog to enter a string to search among a <link linkend="GdaDataModel"><type>GdaDataModel</type></link></refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>

<synopsis>



struct      <link linkend="GnomeDbFindDialog-struct">GnomeDbFindDialog</link>;
struct      <link linkend="GnomeDbFindDialogClass">GnomeDbFindDialogClass</link>;
struct      <link linkend="GnomeDbFindDialogPrivate">GnomeDbFindDialogPrivate</link>;
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-db-find-dialog-new">gnome_db_find_dialog_new</link>        (const <link linkend="gchar">gchar</link> *title);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-db-find-dialog-new-with-model">gnome_db_find_dialog_new_with_model</link>
                                            (const <link linkend="gchar">gchar</link> *title,
                                             <link linkend="GdaDataModel">GdaDataModel</link> *dm);
<link linkend="gboolean">gboolean</link>    <link linkend="gnome-db-find-dialog-run">gnome_db_find_dialog_run</link>        (<link linkend="GnomeDbFindDialog">GnomeDbFindDialog</link> *dialog);
<link linkend="void">void</link>        <link linkend="gnome-db-find-dialog-add-field">gnome_db_find_dialog_add_field</link>  (<link linkend="GnomeDbFindDialog">GnomeDbFindDialog</link> *dialog,
                                             const <link linkend="gchar">gchar</link> *field);
<link linkend="void">void</link>        <link linkend="gnome-db-find-dialog-add-fields-from-model">gnome_db_find_dialog_add_fields_from_model</link>
                                            (<link linkend="GnomeDbFindDialog">GnomeDbFindDialog</link> *dialog,
                                             <link linkend="GdaDataModel">GdaDataModel</link> *dm);
G_CONST_RETURN <link linkend="gchar">gchar</link>* <link linkend="gnome-db-find-dialog-get-text">gnome_db_find_dialog_get_text</link>
                                            (<link linkend="GnomeDbFindDialog">GnomeDbFindDialog</link> *dialog);
G_CONST_RETURN <link linkend="gchar">gchar</link>* <link linkend="gnome-db-find-dialog-get-field">gnome_db_find_dialog_get_field</link>
                                            (<link linkend="GnomeDbFindDialog">GnomeDbFindDialog</link> *dialog);

</synopsis>
</refsynopsisdiv>

<refsect1>
<title>Object Hierarchy</title>
<synopsis>

  <link linkend="GObject">GObject</link>
   +----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
         +----<link linkend="GtkObject">GtkObject</link>
               +----<link linkend="GtkWidget">GtkWidget</link>
                     +----<link linkend="GtkContainer">GtkContainer</link>
                           +----<link linkend="GtkBin">GtkBin</link>
                                 +----<link linkend="GtkWindow">GtkWindow</link>
                                       +----<link linkend="GtkDialog">GtkDialog</link>
                                             +----GnomeDbFindDialog
</synopsis>

</refsect1>



<refsect1>
<title>Implemented Interfaces</title>
<para>
GnomeDbFindDialog implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link> and  <link linkend="GtkBuildable">GtkBuildable</link>.</para>

</refsect1>


<refsect1>
<title>Properties</title>
<synopsis>

  &quot;<link linkend="GnomeDbFindDialog--field">field</link>&quot;                <link linkend="gchararray">gchararray</link>           : Read
  &quot;<link linkend="GnomeDbFindDialog--model">model</link>&quot;                <link linkend="GdaDataModel">GdaDataModel</link>         : Write / Construct Only
  &quot;<link linkend="GnomeDbFindDialog--text">text</link>&quot;                 <link linkend="gchararray">gchararray</link>           : Read
</synopsis>
</refsect1>



<refsect1>
<title>Description</title>
<para>

</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="GnomeDbFindDialog-struct"/>struct GnomeDbFindDialog</title>
<indexterm><primary>GnomeDbFindDialog</primary></indexterm><programlisting>struct GnomeDbFindDialog;</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="GnomeDbFindDialogClass"/>struct GnomeDbFindDialogClass</title>
<indexterm><primary>GnomeDbFindDialogClass</primary></indexterm><programlisting>struct GnomeDbFindDialogClass {

	GtkDialogClass parent_class;
};
</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="GnomeDbFindDialogPrivate"/>struct GnomeDbFindDialogPrivate</title>
<indexterm><primary>GnomeDbFindDialogPrivate</primary></indexterm><programlisting>struct GnomeDbFindDialogPrivate;</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="gnome-db-find-dialog-new"/>gnome_db_find_dialog_new ()</title>
<indexterm><primary>gnome_db_find_dialog_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_db_find_dialog_new        (const <link linkend="gchar">gchar</link> *title);</programlisting>
<para>
Creates a new <link linkend="GnomeDbFindDialog"><type>GnomeDbFindDialog</type></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>title</parameter>&nbsp;:</term>
<listitem><simpara> the title of the dialog
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a <link linkend="GnomeDbFindDialog"><type>GnomeDbFindDialog</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-find-dialog-new-with-model"/>gnome_db_find_dialog_new_with_model ()</title>
<indexterm><primary>gnome_db_find_dialog_new_with_model</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_db_find_dialog_new_with_model
                                            (const <link linkend="gchar">gchar</link> *title,
                                             <link linkend="GdaDataModel">GdaDataModel</link> *dm);</programlisting>
<para>
Creates a new <link linkend="GnomeDbFindDialog"><type>GnomeDbFindDialog</type></link> and adds the fields of <parameter>dm</parameter> to the Fields 
combo.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>title</parameter>&nbsp;:</term>
<listitem><simpara> the title of the dialog
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>dm</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GdaDataModel"><type>GdaDataModel</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a <link linkend="GnomeDbFindDialog"><type>GnomeDbFindDialog</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-find-dialog-run"/>gnome_db_find_dialog_run ()</title>
<indexterm><primary>gnome_db_find_dialog_run</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gnome_db_find_dialog_run        (<link linkend="GnomeDbFindDialog">GnomeDbFindDialog</link> *dialog);</programlisting>
<para>
Shows the <parameter>dialog</parameter> to the user and wait for his/her input.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbFindDialog"><type>GnomeDbFindDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> true if the user clicks "find", false otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-find-dialog-add-field"/>gnome_db_find_dialog_add_field ()</title>
<indexterm><primary>gnome_db_find_dialog_add_field</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_find_dialog_add_field  (<link linkend="GnomeDbFindDialog">GnomeDbFindDialog</link> *dialog,
                                             const <link linkend="gchar">gchar</link> *field);</programlisting>
<para>
Adds <parameter>field</parameter> to the Fields combo.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbFindDialog"><type>GnomeDbFindDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>field</parameter>&nbsp;:</term>
<listitem><simpara> the field's name
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-find-dialog-add-fields-from-model"/>gnome_db_find_dialog_add_fields_from_model ()</title>
<indexterm><primary>gnome_db_find_dialog_add_fields_from_model</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_find_dialog_add_fields_from_model
                                            (<link linkend="GnomeDbFindDialog">GnomeDbFindDialog</link> *dialog,
                                             <link linkend="GdaDataModel">GdaDataModel</link> *dm);</programlisting>
<para>
Adds all the fields of <parameter>dm</parameter> into the Fields combo.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbFindDialog"><type>GnomeDbFindDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>dm</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GdaDataModel"><type>GdaDataModel</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-find-dialog-get-text"/>gnome_db_find_dialog_get_text ()</title>
<indexterm><primary>gnome_db_find_dialog_get_text</primary></indexterm><programlisting>G_CONST_RETURN <link linkend="gchar">gchar</link>* gnome_db_find_dialog_get_text
                                            (<link linkend="GnomeDbFindDialog">GnomeDbFindDialog</link> *dialog);</programlisting>
<para>
Gets the current search text in <parameter>dialog</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbFindDialog"><type>GnomeDbFindDialog</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> text to find
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-find-dialog-get-field"/>gnome_db_find_dialog_get_field ()</title>
<indexterm><primary>gnome_db_find_dialog_get_field</primary></indexterm><programlisting>G_CONST_RETURN <link linkend="gchar">gchar</link>* gnome_db_find_dialog_get_field
                                            (<link linkend="GnomeDbFindDialog">GnomeDbFindDialog</link> *dialog);</programlisting>
<para>
Gets the currently selected field in <parameter>dialog</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbFindDialog"><type>GnomeDbFindDialog</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> name of the selected field
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1>
<title>Properties</title>
<variablelist>
<varlistentry><term><anchor id="GnomeDbFindDialog--field"/>&quot;<literal>field</literal>&quot; (<link linkend="gchararray">gchararray</link> : Read)</term>
<listitem>
<para></para>
</listitem></varlistentry>
<varlistentry><term><anchor id="GnomeDbFindDialog--model"/>&quot;<literal>model</literal>&quot; (<link linkend="GdaDataModel">GdaDataModel</link> : Write / Construct Only)</term>
<listitem>
<para></para>
</listitem></varlistentry>
<varlistentry><term><anchor id="GnomeDbFindDialog--text"/>&quot;<literal>text</literal>&quot; (<link linkend="gchararray">gchararray</link> : Read)</term>
<listitem>
<para></para>
</listitem></varlistentry>

</variablelist>
</refsect1>




</refentry>
