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

<refnamediv>
<refname>GnomeDbDsnSelector</refname><refpurpose>Choose a data source</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>

<synopsis>



struct      <link linkend="GnomeDbDsnSelector-struct">GnomeDbDsnSelector</link>;
struct      <link linkend="GnomeDbDsnSelectorClass">GnomeDbDsnSelectorClass</link>;
struct      <link linkend="GnomeDbDsnSelectorPrivate">GnomeDbDsnSelectorPrivate</link>;
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-db-dsn-selector-new">gnome_db_dsn_selector_new</link>       (void);
<link linkend="gchar">gchar</link>*      <link linkend="gnome-db-dsn-selector-get-dsn">gnome_db_dsn_selector_get_dsn</link>   (<link linkend="GnomeDbDsnSelector">GnomeDbDsnSelector</link> *selector);
<link linkend="void">void</link>        <link linkend="gnome-db-dsn-selector-set-dsn">gnome_db_dsn_selector_set_dsn</link>   (<link linkend="GnomeDbDsnSelector">GnomeDbDsnSelector</link> *selector,
                                             const <link linkend="gchar">gchar</link> *dsn);

</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="GtkComboBox">GtkComboBox</link>
                                       +----<link linkend="GnomeDbCombo">GnomeDbCombo</link>
                                             +----GnomeDbDsnSelector
</synopsis>

</refsect1>



<refsect1>
<title>Implemented Interfaces</title>
<para>
GnomeDbDsnSelector implements
 <link linkend="GtkCellLayout">GtkCellLayout</link>,  <link linkend="GtkCellEditable">GtkCellEditable</link>,  <link linkend="AtkImplementorIface">AtkImplementorIface</link> and  <link linkend="GtkBuildable">GtkBuildable</link>.</para>

</refsect1>


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

  &quot;<link linkend="GnomeDbDsnSelector--source-name">source-name</link>&quot;          <link linkend="gchararray">gchararray</link>           : Read / Write
</synopsis>
</refsect1>



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

</para>
</refsect1>

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

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

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

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

</para></refsect2>
<refsect2>
<title><anchor id="gnome-db-dsn-selector-new"/>gnome_db_dsn_selector_new ()</title>
<indexterm><primary>gnome_db_dsn_selector_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_db_dsn_selector_new       (void);</programlisting>
<para>
Create a new <link linkend="GnomeDbDsnSelector"><type>GnomeDbDsnSelector</type></link>, which is just a <link linkend="GtkComboBox"><type>GtkComboBox</type></link>
which displays, as its items, all the data sources currently
configured in the system. It is useful for connection and configuration
screens, where the user has to choose a data source to work with.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the newly created widget.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-dsn-selector-get-dsn"/>gnome_db_dsn_selector_get_dsn ()</title>
<indexterm><primary>gnome_db_dsn_selector_get_dsn</primary></indexterm><programlisting><link linkend="gchar">gchar</link>*      gnome_db_dsn_selector_get_dsn   (<link linkend="GnomeDbDsnSelector">GnomeDbDsnSelector</link> *selector);</programlisting>
<para>
Get the Data Source Name (DSN) actualy selected in the <link linkend="GnomeDbDsnSelector"><type>GnomeDbDsnSelector</type></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>selector</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the DSN name actualy selected as a new string.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-dsn-selector-set-dsn"/>gnome_db_dsn_selector_set_dsn ()</title>
<indexterm><primary>gnome_db_dsn_selector_set_dsn</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_db_dsn_selector_set_dsn   (<link linkend="GnomeDbDsnSelector">GnomeDbDsnSelector</link> *selector,
                                             const <link linkend="gchar">gchar</link> *dsn);</programlisting>
<para>
Set the selected Data Source Name (DSN) in the <link linkend="GnomeDbDsnSelector"><type>GnomeDbDsnSelector</type></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>selector</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>dsn</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1>
<title>Properties</title>
<variablelist>
<varlistentry><term><anchor id="GnomeDbDsnSelector--source-name"/>&quot;<literal>source-name</literal>&quot; (<link linkend="gchararray">gchararray</link> : Read / Write)</term>
<listitem>
<para></para>
</listitem></varlistentry>

</variablelist>
</refsect1>




</refentry>
