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

<refnamediv>
<refname>GnomeDbDsnEditor</refname><refpurpose>A form to modify datasource information</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>

<synopsis>



struct      <link linkend="GnomeDbDsnEditor-struct">GnomeDbDsnEditor</link>;
struct      <link linkend="GnomeDbDsnEditorClass">GnomeDbDsnEditorClass</link>;
struct      <link linkend="GnomeDbDsnEditorPrivate">GnomeDbDsnEditorPrivate</link>;
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-db-dsn-editor-new">gnome_db_dsn_editor_new</link>         (void);
const <link linkend="GdaDsnInfo">GdaDsnInfo</link>* <link linkend="gnome-db-dsn-editor-get-dsn">gnome_db_dsn_editor_get_dsn</link>
                                            (<link linkend="GnomeDbDsnEditor">GnomeDbDsnEditor</link> *config);
<link linkend="void">void</link>        <link linkend="gnome-db-dsn-editor-set-dsn">gnome_db_dsn_editor_set_dsn</link>     (<link linkend="GnomeDbDsnEditor">GnomeDbDsnEditor</link> *config,
                                             const <link linkend="GdaDsnInfo">GdaDsnInfo</link> *dsn_info);

</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>
                                       +----GnomeDbDsnEditor
</synopsis>

</refsect1>



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

</refsect1>



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

&quot;<link linkend="GnomeDbDsnEditor-changed">changed</link>&quot;   <link linkend="void">void</link>        user_function      (<link linkend="GnomeDbDsnEditor">GnomeDbDsnEditor</link> *dbdsneditor,
                                            <link linkend="gpointer">gpointer</link> user_data);
</synopsis>
</refsect1>


<refsect1>
<title>Description</title>
<para>
The <link linkend="GnomeDbDsnEditor"><type>GnomeDbDsnEditor</type></link> widget contains a form to edit all the attributes of a DSN
(except for its name), including provider selection, username and password, and
provider specific information to open a connection.
</para>
</refsect1>

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

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

	GtkVBoxClass parent_class;

	/* signals */
	void (* changed) (GnomeDbDsnEditor *config);
};
</programlisting>
<para>

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

</para></refsect2>
<refsect2>
<title><anchor id="gnome-db-dsn-editor-new"/>gnome_db_dsn_editor_new ()</title>
<indexterm><primary>gnome_db_dsn_editor_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_db_dsn_editor_new         (void);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-dsn-editor-get-dsn"/>gnome_db_dsn_editor_get_dsn ()</title>
<indexterm><primary>gnome_db_dsn_editor_get_dsn</primary></indexterm><programlisting>const <link linkend="GdaDsnInfo">GdaDsnInfo</link>* gnome_db_dsn_editor_get_dsn
                                            (<link linkend="GnomeDbDsnEditor">GnomeDbDsnEditor</link> *config);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>config</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a pointer to the currently configured DSN (do not modify)
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-dsn-editor-set-dsn"/>gnome_db_dsn_editor_set_dsn ()</title>
<indexterm><primary>gnome_db_dsn_editor_set_dsn</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_dsn_editor_set_dsn     (<link linkend="GnomeDbDsnEditor">GnomeDbDsnEditor</link> *config,
                                             const <link linkend="GdaDsnInfo">GdaDsnInfo</link> *dsn_info);</programlisting>
<para>
Requests that <parameter>editor</parameter> update its contents with <parameter>dsn_info</parameter>'s contents</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>config</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>dsn_info</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GdaDsnInfo"><type>GdaDsnInfo</type></link> pointer or <literal>NULL</literal>
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>

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

</para><variablelist role="params">
<varlistentry><term><parameter>dbdsnconfig</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="GnomeDbDsnAssistant"><type>GnomeDbDsnAssistant</type></link> to create a new DSN using an assistant.
</para>
</refsect1>

</refentry>
