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

<refnamediv>
<refname>GnomeDbBasicForm</refname><refpurpose>A GUI form to present data in a <link linkend="GdaSet"><type>GdaSet</type></link></refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>

<synopsis>



struct      <link linkend="GnomeDbBasicForm-struct">GnomeDbBasicForm</link>;
struct      <link linkend="GnomeDbBasicFormClass">GnomeDbBasicFormClass</link>;
struct      <link linkend="GnomeDbBasicFormPriv">GnomeDbBasicFormPriv</link>;
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-db-basic-form-new">gnome_db_basic_form_new</link>         (<link linkend="GdaSet">GdaSet</link> *data_set);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-db-basic-form-new-custom">gnome_db_basic_form_new_custom</link>  (<link linkend="GdaSet">GdaSet</link> *data_set,
                                             const <link linkend="gchar">gchar</link> *glade_file,
                                             const <link linkend="gchar">gchar</link> *root_element,
                                             const <link linkend="gchar">gchar</link> *form_prefix);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-db-basic-form-new-in-dialog">gnome_db_basic_form_new_in_dialog</link>
                                            (<link linkend="GdaSet">GdaSet</link> *data_set,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent,
                                             const <link linkend="gchar">gchar</link> *title,
                                             const <link linkend="gchar">gchar</link> *header);
<link linkend="GdaSet">GdaSet</link>*     <link linkend="gnome-db-basic-form-get-data-set">gnome_db_basic_form_get_data_set</link>
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form);
<link linkend="gboolean">gboolean</link>    <link linkend="gnome-db-basic-form-is-valid">gnome_db_basic_form_is_valid</link>    (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form);
<link linkend="gboolean">gboolean</link>    <link linkend="gnome-db-basic-form-has-been-changed">gnome_db_basic_form_has_been_changed</link>
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form);
<link linkend="void">void</link>        <link linkend="gnome-db-basic-form-reset">gnome_db_basic_form_reset</link>       (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form);
<link linkend="void">void</link>        <link linkend="gnome-db-basic-form-set-current-as-orig">gnome_db_basic_form_set_current_as_orig</link>
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form);

<link linkend="void">void</link>        <link linkend="gnome-db-basic-form-entry-show">gnome_db_basic_form_entry_show</link>  (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                             <link linkend="GdaHolder">GdaHolder</link> *param,
                                             <link linkend="gboolean">gboolean</link> show);
<link linkend="void">void</link>        <link linkend="gnome-db-basic-form-entry-grab-focus">gnome_db_basic_form_entry_grab_focus</link>
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                             <link linkend="GdaHolder">GdaHolder</link> *param);
<link linkend="void">void</link>        <link linkend="gnome-db-basic-form-entry-set-editable">gnome_db_basic_form_entry_set_editable</link>
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                             <link linkend="GdaHolder">GdaHolder</link> *param,
                                             <link linkend="gboolean">gboolean</link> editable);
<link linkend="void">void</link>        <link linkend="gnome-db-basic-form-set-entries-auto-default">gnome_db_basic_form_set_entries_auto_default</link>
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                             <link linkend="gboolean">gboolean</link> auto_default);
<link linkend="void">void</link>        <link linkend="gnome-db-basic-form-set-entries-default">gnome_db_basic_form_set_entries_default</link>
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-db-basic-form-get-entry-widget">gnome_db_basic_form_get_entry_widget</link>
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                             <link linkend="GdaHolder">GdaHolder</link> *param);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-db-basic-form-get-label-widget">gnome_db_basic_form_get_label_widget</link>
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                             <link linkend="GdaHolder">GdaHolder</link> *param);
<link linkend="void">void</link>        <link linkend="gnome-db-basic-form-entry-set-editable">gnome_db_basic_form_entry_set_editable</link>
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                             <link linkend="GdaHolder">GdaHolder</link> *param,
                                             <link linkend="gboolean">gboolean</link> editable);

</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="GtkBox">GtkBox</link>
                                 +----<link linkend="GtkVBox">GtkVBox</link>
                                       +----GnomeDbBasicForm
                                             +----<link linkend="GnomeDbRawForm">GnomeDbRawForm</link>
</synopsis>

</refsect1>



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

</refsect1>


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

  &quot;<link linkend="GnomeDbBasicForm--entries-auto-default">entries-auto-default</link>&quot; <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GnomeDbBasicForm--headers-sensitive">headers-sensitive</link>&quot;    <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GnomeDbBasicForm--layout-spec">layout-spec</link>&quot;          <link linkend="gpointer">gpointer</link>             : Write
  &quot;<link linkend="GnomeDbBasicForm--paramlist">paramlist</link>&quot;            <link linkend="gpointer">gpointer</link>             : Read / Write
  &quot;<link linkend="GnomeDbBasicForm--show-actions">show-actions</link>&quot;         <link linkend="gboolean">gboolean</link>             : Read / Write
</synopsis>
</refsect1>

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

&quot;<link linkend="GnomeDbBasicForm-activated">activated</link>&quot; <link linkend="void">void</link>        user_function      (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *dbbasicform,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GnomeDbBasicForm-param-changed">param-changed</link>&quot;
            <link linkend="void">void</link>        user_function      (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                            <link linkend="GdaHolder">GdaHolder</link> *param,
                                            <link linkend="gboolean">gboolean</link> is_user_modif,
                                            <link linkend="gpointer">gpointer</link> user_data);
</synopsis>
</refsect1>


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

</para>
</refsect1>

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

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

	GtkVBoxClass          parent_class;

	/* signals */
        void       (*param_changed)         (GnomeDbBasicForm *form, GdaHolder *param, gboolean is_user_modif);
	void       (*activated)             (GnomeDbBasicForm *form);
};
</programlisting>
<para>

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

</para></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-new"/>gnome_db_basic_form_new ()</title>
<indexterm><primary>gnome_db_basic_form_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_db_basic_form_new         (<link linkend="GdaSet">GdaSet</link> *data_set);</programlisting>
<para>
Creates a new <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget using all the parameters provided in <parameter>paramlist</parameter>.
</para>
<para>
The global layout is rendered using a table (a <link linkend="GtkTable"><type>GtkTable</type></link>), and an entry is created for each
node of <parameter>paramlist</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>data_set</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the new widget
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-new-custom"/>gnome_db_basic_form_new_custom ()</title>
<indexterm><primary>gnome_db_basic_form_new_custom</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_db_basic_form_new_custom  (<link linkend="GdaSet">GdaSet</link> *data_set,
                                             const <link linkend="gchar">gchar</link> *glade_file,
                                             const <link linkend="gchar">gchar</link> *root_element,
                                             const <link linkend="gchar">gchar</link> *form_prefix);</programlisting>
<para>
Creates a new <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget using all the parameters provided in <parameter>paramlist</parameter>.
</para>
<para>
The layout is specified in the <parameter>glade_file</parameter> specification, and an entry is created for each
node of <parameter>paramlist</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>data_set</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>glade_file</parameter>&nbsp;:</term>
<listitem><simpara> a Glade XML file name
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>root_element</parameter>&nbsp;:</term>
<listitem><simpara> the name of the top-most widget in <parameter>glade_file</parameter> to use in the new form
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>form_prefix</parameter>&nbsp;:</term>
<listitem><simpara> the prefix used to look for widgets to add entries in
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the new widget
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-new-in-dialog"/>gnome_db_basic_form_new_in_dialog ()</title>
<indexterm><primary>gnome_db_basic_form_new_in_dialog</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_db_basic_form_new_in_dialog
                                            (<link linkend="GdaSet">GdaSet</link> *data_set,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent,
                                             const <link linkend="gchar">gchar</link> *title,
                                             const <link linkend="gchar">gchar</link> *header);</programlisting>
<para>
Creates a new <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget in the same way as <link linkend="gnome-db-basic-form-new"><function>gnome_db_basic_form_new()</function></link>
and puts it into a <link linkend="GtkDialog"><type>GtkDialog</type></link> widget. The returned dialog has the "Ok" and "Cancel" buttons
which respectively return GTK_RESPONSE_ACCEPT and GTK_RESPONSE_REJECT.
</para>
<para>
The <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget is attached to the dialog using the user property
"form".</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>data_set</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>parent</parameter>&nbsp;:</term>
<listitem><simpara> the parent window for the new dialog, or <literal>NULL</literal>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>title</parameter>&nbsp;:</term>
<listitem><simpara> the title of the dialog window, or <literal>NULL</literal>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>header</parameter>&nbsp;:</term>
<listitem><simpara> a helper text displayed at the top of the dialog, or <literal>NULL</literal>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the new <link linkend="GtkDialog"><type>GtkDialog</type></link> widget
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-get-data-set"/>gnome_db_basic_form_get_data_set ()</title>
<indexterm><primary>gnome_db_basic_form_get_data_set</primary></indexterm><programlisting><link linkend="GdaSet">GdaSet</link>*     gnome_db_basic_form_get_data_set
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form);</programlisting>
<para>
Get a pointer to the <link linkend="GdaSet"><type>GdaSet</type></link> object which
is modified by <parameter>form</parameter></para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>form</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-is-valid"/>gnome_db_basic_form_is_valid ()</title>
<indexterm><primary>gnome_db_basic_form_is_valid</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gnome_db_basic_form_is_valid    (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form);</programlisting>
<para>
Tells if the form can be used as-is (if all the parameters do have some valid values)</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>form</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> TRUE if the form is valid
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-has-been-changed"/>gnome_db_basic_form_has_been_changed ()</title>
<indexterm><primary>gnome_db_basic_form_has_been_changed</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gnome_db_basic_form_has_been_changed
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form);</programlisting>
<para>
Tells if the form has had at least on entry changed, or not</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>form</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-reset"/>gnome_db_basic_form_reset ()</title>
<indexterm><primary>gnome_db_basic_form_reset</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_basic_form_reset       (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form);</programlisting>
<para>
Resets all the entries in the form to their
original values</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>form</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-set-current-as-orig"/>gnome_db_basic_form_set_current_as_orig ()</title>
<indexterm><primary>gnome_db_basic_form_set_current_as_orig</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_basic_form_set_current_as_orig
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form);</programlisting>
<para>
Tells <parameter>form</parameter> that the current values in the different entries are
to be considered as the original values for all the entries; the immediate
consequence is that any sub-sequent call to <link linkend="gnome-db-basic-form-has-been-changed"><function>gnome_db_basic_form_has_been_changed()</function></link>
will return FALSE (of course until any entry is changed).</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>form</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-entry-show"/>gnome_db_basic_form_entry_show ()</title>
<indexterm><primary>gnome_db_basic_form_entry_show</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_basic_form_entry_show  (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                             <link linkend="GdaHolder">GdaHolder</link> *param,
                                             <link linkend="gboolean">gboolean</link> show);</programlisting>
<para>
Shows or hides the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> in <parameter>form</parameter> which corresponds to the
<parameter>param</parameter> parameter</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>form</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>param</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GdaHolder"><type>GdaHolder</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>show</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-entry-grab-focus"/>gnome_db_basic_form_entry_grab_focus ()</title>
<indexterm><primary>gnome_db_basic_form_entry_grab_focus</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_basic_form_entry_grab_focus
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                             <link linkend="GdaHolder">GdaHolder</link> *param);</programlisting>
<para>
Makes the data entry corresponding to <parameter>param</parameter> grab the focus for the window it's in</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>form</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>param</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GdaHolder"><type>GdaHolder</type></link> object
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-entry-set-editable"/>gnome_db_basic_form_entry_set_editable ()</title>
<indexterm><primary>gnome_db_basic_form_entry_set_editable</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_basic_form_entry_set_editable
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                             <link linkend="GdaHolder">GdaHolder</link> *param,
                                             <link linkend="gboolean">gboolean</link> editable);</programlisting>
<para>
Sets the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> in <parameter>form</parameter> which corresponds to the
<parameter>param</parameter> parameter editable or not</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>form</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>param</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GdaHolder"><type>GdaHolder</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>editable</parameter>&nbsp;:</term>
<listitem><simpara> <literal>TRUE</literal> if corresponding data entry must be editable
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-set-entries-auto-default"/>gnome_db_basic_form_set_entries_auto_default ()</title>
<indexterm><primary>gnome_db_basic_form_set_entries_auto_default</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_basic_form_set_entries_auto_default
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                             <link linkend="gboolean">gboolean</link> auto_default);</programlisting>
<para>
Sets weather all the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> entries in the form must default
to a default value if they are assigned a non valid value.
Depending on the real type of entry, it will provide a default value
which the user does not need to modify if it is OK.
</para>
<para>
For example a date entry can by default display the current date.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>form</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>auto_default</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-set-entries-default"/>gnome_db_basic_form_set_entries_default ()</title>
<indexterm><primary>gnome_db_basic_form_set_entries_default</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_basic_form_set_entries_default
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form);</programlisting>
<para>
For each entry in the form, sets it to a default value if it is possible to do so.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>form</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-get-entry-widget"/>gnome_db_basic_form_get_entry_widget ()</title>
<indexterm><primary>gnome_db_basic_form_get_entry_widget</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_db_basic_form_get_entry_widget
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                             <link linkend="GdaHolder">GdaHolder</link> *param);</programlisting>
<para>
Get the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> in <parameter>form</parameter> which corresponds to the param parameter.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>form</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>param</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GdaHolder"><type>GdaHolder</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the requested widget, or <literal>NULL</literal> if not found
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-get-label-widget"/>gnome_db_basic_form_get_label_widget ()</title>
<indexterm><primary>gnome_db_basic_form_get_label_widget</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_db_basic_form_get_label_widget
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                             <link linkend="GdaHolder">GdaHolder</link> *param);</programlisting>
<para>
Get the label in <parameter>form</parameter> which corresponds to the param parameter.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>form</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>param</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GdaHolder"><type>GdaHolder</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the requested widget, or <literal>NULL</literal> if not found
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-basic-form-entry-set-editable"/>gnome_db_basic_form_entry_set_editable ()</title>
<indexterm><primary>gnome_db_basic_form_entry_set_editable</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_basic_form_entry_set_editable
                                            (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                             <link linkend="GdaHolder">GdaHolder</link> *param,
                                             <link linkend="gboolean">gboolean</link> editable);</programlisting>
<para>
Sets the <link linkend="GnomeDbDataEntry"><type>GnomeDbDataEntry</type></link> in <parameter>form</parameter> which corresponds to the
<parameter>param</parameter> parameter editable or not</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>form</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbBasicForm"><type>GnomeDbBasicForm</type></link> widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>param</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GdaHolder"><type>GdaHolder</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>editable</parameter>&nbsp;:</term>
<listitem><simpara> <literal>TRUE</literal> if corresponding data entry must be editable
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1>
<title>Properties</title>
<variablelist>
<varlistentry><term><anchor id="GnomeDbBasicForm--entries-auto-default"/>&quot;<literal>entries-auto-default</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para></para>
</listitem></varlistentry>
<varlistentry><term><anchor id="GnomeDbBasicForm--headers-sensitive"/>&quot;<literal>headers-sensitive</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para></para>
</listitem></varlistentry>
<varlistentry><term><anchor id="GnomeDbBasicForm--layout-spec"/>&quot;<literal>layout-spec</literal>&quot; (<link linkend="gpointer">gpointer</link> : Write)</term>
<listitem>
<para></para>
</listitem></varlistentry>
<varlistentry><term><anchor id="GnomeDbBasicForm--paramlist"/>&quot;<literal>paramlist</literal>&quot; (<link linkend="gpointer">gpointer</link> : Read / Write)</term>
<listitem>
<para></para>
</listitem></varlistentry>
<varlistentry><term><anchor id="GnomeDbBasicForm--show-actions"/>&quot;<literal>show-actions</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para></para>
</listitem></varlistentry>

</variablelist>
</refsect1>

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

</para><variablelist role="params">
<varlistentry><term><parameter>dbbasicform</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="GnomeDbBasicForm-param-changed"/>The &quot;param-changed&quot; signal</title>
<programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GnomeDbBasicForm">GnomeDbBasicForm</link> *form,
                                            <link linkend="GdaHolder">GdaHolder</link> *param,
                                            <link linkend="gboolean">gboolean</link> is_user_modif,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Emitted when a GdaHolder changes</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>form</parameter>&nbsp;:</term>
<listitem><simpara> GnomeDbBasicForm
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>param</parameter>&nbsp;:</term>
<listitem><simpara> that changed
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>is_user_modif</parameter>&nbsp;:</term>
<listitem><simpara> TRUE if the modification has been initiated by a user modification
</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>



</refentry>
