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

<refnamediv>
<refname>GnomeDbDataEntry</refname><refpurpose>Interface which provides the user with specific widgets to manipulate data</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>

<synopsis>



struct      <link linkend="GnomeDbDataEntry-struct">GnomeDbDataEntry</link>;
<link linkend="void">void</link>        <link linkend="gnome-db-data-entry-set-value-type">gnome_db_data_entry_set_value_type</link>
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de,
                                             <link linkend="GType">GType</link> type);
<link linkend="GType">GType</link>       <link linkend="gnome-db-data-entry-get-value-type">gnome_db_data_entry_get_value_type</link>
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);
<link linkend="void">void</link>        <link linkend="gnome-db-data-entry-set-value">gnome_db_data_entry_set_value</link>   (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de,
                                             const <link linkend="GValue">GValue</link> *value);
<link linkend="GValue">GValue</link>*     <link linkend="gnome-db-data-entry-get-value">gnome_db_data_entry_get_value</link>   (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);
<link linkend="gboolean">gboolean</link>    <link linkend="gnome-db-data-entry-is-contents-valid">gnome_db_data_entry_is_contents_valid</link>
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de,
                                             <link linkend="GError">GError</link> **error);
<link linkend="void">void</link>        <link linkend="gnome-db-data-entry-set-value-orig">gnome_db_data_entry_set_value_orig</link>
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de,
                                             const <link linkend="GValue">GValue</link> *value);
<link linkend="void">void</link>        <link linkend="gnome-db-data-entry-set-current-as-orig">gnome_db_data_entry_set_current_as_orig</link>
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);
const <link linkend="GValue">GValue</link>* <link linkend="gnome-db-data-entry-get-value-orig">gnome_db_data_entry_get_value_orig</link>
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);
<link linkend="void">void</link>        <link linkend="gnome-db-data-entry-set-value-default">gnome_db_data_entry_set_value_default</link>
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de,
                                             const <link linkend="GValue">GValue</link> *value);

<link linkend="void">void</link>        <link linkend="gnome-db-data-entry-set-attributes">gnome_db_data_entry_set_attributes</link>
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de,
                                             <link linkend="GdaValueAttribute">GdaValueAttribute</link> attrs,
                                             <link linkend="GdaValueAttribute">GdaValueAttribute</link> mask);
<link linkend="GdaValueAttribute">GdaValueAttribute</link> <link linkend="gnome-db-data-entry-get-attributes">gnome_db_data_entry_get_attributes</link>
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);
<link linkend="GdaDataHandler">GdaDataHandler</link>* <link linkend="gnome-db-data-entry-get-handler">gnome_db_data_entry_get_handler</link>
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);
<link linkend="gboolean">gboolean</link>    <link linkend="gnome-db-data-entry-expand-in-layout">gnome_db_data_entry_expand_in_layout</link>
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);
<link linkend="void">void</link>        <link linkend="gnome-db-data-entry-set-editable">gnome_db_data_entry_set_editable</link>
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de,
                                             <link linkend="gboolean">gboolean</link> editable);
<link linkend="void">void</link>        <link linkend="gnome-db-data-entry-grab-focus">gnome_db_data_entry_grab_focus</link>  (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);

</synopsis>
</refsynopsisdiv>

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

  <link linkend="GInterface">GInterface</link>
   +----GnomeDbDataEntry
</synopsis>

</refsect1>




<refsect1>
<title>Known Implementations</title>
<para>
GnomeDbDataEntry is implemented by
 <link linkend="GnomeDbEntryPassword">GnomeDbEntryPassword</link>,  <link linkend="GnomeDbEntryWrapper">GnomeDbEntryWrapper</link>,  <link linkend="GnomeDbEntryTime">GnomeDbEntryTime</link>,  <link linkend="GnomeDbEntryString">GnomeDbEntryString</link>,  <link linkend="GnomeDbEntryText">GnomeDbEntryText</link>,  <link linkend="GnomeDbEntryCidr">GnomeDbEntryCidr</link>,  <link linkend="GnomeDbEntryTimestamp">GnomeDbEntryTimestamp</link>,  <link linkend="GnomeDbEntryDate">GnomeDbEntryDate</link>,  <link linkend="GnomeDbEntryNone">GnomeDbEntryNone</link>,  <link linkend="GnomeDbEntryCommonTime">GnomeDbEntryCommonTime</link>,  <link linkend="GnomeDbEntryBoolean">GnomeDbEntryBoolean</link>,  <link linkend="GnomeDbEntryFilesel">GnomeDbEntryFilesel</link> and  <link linkend="GnomeDbEntryCombo">GnomeDbEntryCombo</link>.</para>

</refsect1>


<refsect1>
<title>Signal Prototypes</title>
<synopsis>

&quot;<link linkend="GnomeDbDataEntry-contents-activated">contents-activated</link>&quot;
            <link linkend="void">void</link>        user_function      (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *dbdataentry,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GnomeDbDataEntry-contents-modified">contents-modified</link>&quot;
            <link linkend="void">void</link>        user_function      (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *dbdataentry,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GnomeDbDataEntry-contents-valid">contents-valid</link>&quot;
            <link linkend="gboolean">gboolean</link>    user_function      (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *dbdataentry,
                                            <link linkend="gpointer">gpointer</link> arg1,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GnomeDbDataEntry-status-changed">status-changed</link>&quot;
            <link linkend="void">void</link>        user_function      (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *dbdataentry,
                                            <link linkend="gpointer">gpointer</link> user_data);
</synopsis>
</refsect1>


<refsect1>
<title>Description</title>
<para>
This interface is implemented by widgets to enable users to manipulate data of different types.
Such widgets are created by objects implementing the <link linkend="GdaDataHandler"><type>GdaDataHandler</type></link> interface.
</para>
</refsect1>

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

</para></refsect2>
<refsect2>
<title><anchor id="gnome-db-data-entry-set-value-type"/>gnome_db_data_entry_set_value_type ()</title>
<indexterm><primary>gnome_db_data_entry_set_value_type</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_data_entry_set_value_type
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de,
                                             <link linkend="GType">GType</link> type);</programlisting>
<para>
Sets the type of value the GnomeDbDataEntry will handle. The type must be compatible with what
the widget can handle.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>de</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> object which implements the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> interface
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>type</parameter>&nbsp;:</term>
<listitem><simpara> 
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-data-entry-get-value-type"/>gnome_db_data_entry_get_value_type ()</title>
<indexterm><primary>gnome_db_data_entry_get_value_type</primary></indexterm><programlisting><link linkend="GType">GType</link>       gnome_db_data_entry_get_value_type
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);</programlisting>
<para>
Fetch the type of data the GnomeDbDataEntry handles</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>de</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> object which implements the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> interface
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the GType type
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-data-entry-set-value"/>gnome_db_data_entry_set_value ()</title>
<indexterm><primary>gnome_db_data_entry_set_value</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_data_entry_set_value   (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de,
                                             const <link linkend="GValue">GValue</link> *value);</programlisting>
<para>
Push a value into the GnomeDbDataEntry. The value parameter must either be:
- NULL or of type GDA_TYPE_NULL, or
- of type specified using gnome_db_data_entry_set_value_type.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>de</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> object which implements the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> interface
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&nbsp;:</term>
<listitem><simpara> 
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-data-entry-get-value"/>gnome_db_data_entry_get_value ()</title>
<indexterm><primary>gnome_db_data_entry_get_value</primary></indexterm><programlisting><link linkend="GValue">GValue</link>*     gnome_db_data_entry_get_value   (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);</programlisting>
<para>
Fetch the value held in the GnomeDbDataEntry widget. If the value is set to NULL,
the returned value is of type GDA_TYPE_NULL. If the value is set to default,
then the returned value is of type GDA_TYPE_NULL or is the default value if it
has been provided to the widget (and is of the same type as the one provided by <parameter>de</parameter>).</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>de</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> object which implements the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> interface
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a new GValue
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-data-entry-is-contents-valid"/>gnome_db_data_entry_is_contents_valid ()</title>
<indexterm><primary>gnome_db_data_entry_is_contents_valid</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gnome_db_data_entry_is_contents_valid
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de,
                                             <link linkend="GError">GError</link> **error);</programlisting>
<para>
Tests the validity of <parameter>de</parameter>'s contents. The validity is a determined from:
<itemizedlist>
<listitem><para>the <parameter>de</parameter> widget itself if it is capable of doing it (depending on the implementation)</para></listitem>
<listitem><para>the results of the "contents_valid" signal which can be connected from </para></listitem>
</itemizedlist></para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>de</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> object which implements the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> interface
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
<listitem><simpara> a place to store an error, or <literal>NULL</literal>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> TRUE if <parameter>de</parameter>'s contents is valid
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-data-entry-set-value-orig"/>gnome_db_data_entry_set_value_orig ()</title>
<indexterm><primary>gnome_db_data_entry_set_value_orig</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_data_entry_set_value_orig
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de,
                                             const <link linkend="GValue">GValue</link> *value);</programlisting>
<para>
Push a value into the GnomeDbDataEntry in the same way as <link linkend="gnome-db-data-entry-set-value"><function>gnome_db_data_entry_set_value()</function></link> but
also sets this value as the original value.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>de</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> object which implements the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> interface
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&nbsp;:</term>
<listitem><simpara> 
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-data-entry-set-current-as-orig"/>gnome_db_data_entry_set_current_as_orig ()</title>
<indexterm><primary>gnome_db_data_entry_set_current_as_orig</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_data_entry_set_current_as_orig
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);</programlisting>
<para>
Tells that the current value in <parameter>de</parameter> is to be considered as the original value</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>de</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> object which implements the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> interface
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-data-entry-get-value-orig"/>gnome_db_data_entry_get_value_orig ()</title>
<indexterm><primary>gnome_db_data_entry_get_value_orig</primary></indexterm><programlisting>const <link linkend="GValue">GValue</link>* gnome_db_data_entry_get_value_orig
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);</programlisting>
<para>
Fetch the original value held in the GnomeDbDataEntry widget</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>de</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> object which implements the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> interface
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the GValue
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-data-entry-set-value-default"/>gnome_db_data_entry_set_value_default ()</title>
<indexterm><primary>gnome_db_data_entry_set_value_default</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_data_entry_set_value_default
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de,
                                             const <link linkend="GValue">GValue</link> *value);</programlisting>
<para>
Sets the default value for the GnomeDbDataEntry which gets displayed when the
user forces the default value. If it is not set then it is set to type GDA_TYPE_NULL.
The value parameter must either be:
- NULL or of type GDA_TYPE_NULL, or
- of type specified using gnome_db_data_entry_set_value_type.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>de</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> object which implements the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> interface
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&nbsp;:</term>
<listitem><simpara> 
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-data-entry-set-attributes"/>gnome_db_data_entry_set_attributes ()</title>
<indexterm><primary>gnome_db_data_entry_set_attributes</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_data_entry_set_attributes
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de,
                                             <link linkend="GdaValueAttribute">GdaValueAttribute</link> attrs,
                                             <link linkend="GdaValueAttribute">GdaValueAttribute</link> mask);</programlisting>
<para>
Sets the parameters of the GnomeDbDataEntry. Only the attributes corresponding to the
mask are set, the other ones are ignored.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>de</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> object which implements the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> interface
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attrs</parameter>&nbsp;:</term>
<listitem><simpara> the attributes to set (OR'ed between them)
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>mask</parameter>&nbsp;:</term>
<listitem><simpara> the mask corresponding to the considered attributes
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-data-entry-get-attributes"/>gnome_db_data_entry_get_attributes ()</title>
<indexterm><primary>gnome_db_data_entry_get_attributes</primary></indexterm><programlisting><link linkend="GdaValueAttribute">GdaValueAttribute</link> gnome_db_data_entry_get_attributes
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);</programlisting>
<para>
Retreives the parameters of the GnomeDbDataEntry widget.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>de</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> object which implements the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> interface
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the OR'ed bits corresponding to the attributes.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-data-entry-get-handler"/>gnome_db_data_entry_get_handler ()</title>
<indexterm><primary>gnome_db_data_entry_get_handler</primary></indexterm><programlisting><link linkend="GdaDataHandler">GdaDataHandler</link>* gnome_db_data_entry_get_handler
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);</programlisting>
<para>
Fetch the GdaDataHandler the GnomeDbDataEntry is using</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>de</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> object which implements the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> interface
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the GdaDataHandler object
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-data-entry-expand-in-layout"/>gnome_db_data_entry_expand_in_layout ()</title>
<indexterm><primary>gnome_db_data_entry_expand_in_layout</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gnome_db_data_entry_expand_in_layout
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);</programlisting>
<para>
Used for the layout of the widget in containers.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>de</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> object which implements the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> interface
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> TRUE if the widget should expand
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-data-entry-set-editable"/>gnome_db_data_entry_set_editable ()</title>
<indexterm><primary>gnome_db_data_entry_set_editable</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_data_entry_set_editable
                                            (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de,
                                             <link linkend="gboolean">gboolean</link> editable);</programlisting>
<para>
Set if <parameter>de</parameter> can be modified or not by the user</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>de</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> object which implements the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> interface
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>editable</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-data-entry-grab-focus"/>gnome_db_data_entry_grab_focus ()</title>
<indexterm><primary>gnome_db_data_entry_grab_focus</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_data_entry_grab_focus  (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *de);</programlisting>
<para>
Makes <parameter>de</parameter> grab the focus for the window it's in</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>de</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> object which implements the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> interface
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>

<refsect1>
<title>Signals</title>
<refsect2><title><anchor id="GnomeDbDataEntry-contents-activated"/>The &quot;contents-activated&quot; signal</title>
<programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *dbdataentry,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>dbdataentry</parameter>&nbsp;:</term>
<listitem><simpara>the object which received the signal.

</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2><title><anchor id="GnomeDbDataEntry-contents-modified"/>The &quot;contents-modified&quot; signal</title>
<programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *dbdataentry,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>dbdataentry</parameter>&nbsp;:</term>
<listitem><simpara>the object which received the signal.

</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2><title><anchor id="GnomeDbDataEntry-contents-valid"/>The &quot;contents-valid&quot; signal</title>
<programlisting><link linkend="gboolean">gboolean</link>    user_function                  (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *dbdataentry,
                                            <link linkend="gpointer">gpointer</link> arg1,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>dbdataentry</parameter>&nbsp;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>

</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2><title><anchor id="GnomeDbDataEntry-status-changed"/>The &quot;status-changed&quot; signal</title>
<programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GnomeDbDataEntry">GnomeDbDataEntry</link> *dbdataentry,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>dbdataentry</parameter>&nbsp;:</term>
<listitem><simpara>the object which received the signal.

</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>


<refsect1>
<title>See Also</title>
<para>
The <link linkend="GdaDictType"><type>GdaDictType</type></link> class and <link linkend="GdaDataHandler"><type>GdaDataHandler</type></link> interface.
</para>
</refsect1>

</refentry>
