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

<refnamediv>
<refname>GnomeDbLoginDialog</refname><refpurpose>Login dialog widget</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>

<synopsis>



struct      <link linkend="GnomeDbLoginDialog-struct">GnomeDbLoginDialog</link>;
struct      <link linkend="GnomeDbLoginDialogClass">GnomeDbLoginDialogClass</link>;
struct      <link linkend="GnomeDbLoginDialogPrivate">GnomeDbLoginDialogPrivate</link>;
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-db-login-dialog-new">gnome_db_login_dialog_new</link>       (const <link linkend="gchar">gchar</link> *title,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);
<link linkend="gboolean">gboolean</link>    <link linkend="gnome-db-login-dialog-run">gnome_db_login_dialog_run</link>       (<link linkend="GnomeDbLoginDialog">GnomeDbLoginDialog</link> *dialog);
const <link linkend="gchar">gchar</link>* <link linkend="gnome-db-login-dialog-get-dsn">gnome_db_login_dialog_get_dsn</link>  (<link linkend="GnomeDbLoginDialog">GnomeDbLoginDialog</link> *dialog);
const <link linkend="gchar">gchar</link>* <link linkend="gnome-db-login-dialog-get-auth">gnome_db_login_dialog_get_auth</link> (<link linkend="GnomeDbLoginDialog">GnomeDbLoginDialog</link> *dialog);
const <link linkend="gchar">gchar</link>* <link linkend="gnome-db-login-dialog-get-username">gnome_db_login_dialog_get_username</link>
                                            (<link linkend="GnomeDbLoginDialog">GnomeDbLoginDialog</link> *dialog);
const <link linkend="gchar">gchar</link>* <link linkend="gnome-db-login-dialog-get-password">gnome_db_login_dialog_get_password</link>
                                            (<link linkend="GnomeDbLoginDialog">GnomeDbLoginDialog</link> *dialog);
<link linkend="GnomeDbLogin">GnomeDbLogin</link>* <link linkend="gnome-db-login-dialog-get-login-widget">gnome_db_login_dialog_get_login_widget</link>
                                            (<link linkend="GnomeDbLoginDialog">GnomeDbLoginDialog</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>
                                             +----GnomeDbLoginDialog
</synopsis>

</refsect1>



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

</refsect1>


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

  &quot;<link linkend="GnomeDbLoginDialog--dsn">dsn</link>&quot;                  <link linkend="gchararray">gchararray</link>           : Read
  &quot;<link linkend="GnomeDbLoginDialog--password">password</link>&quot;             <link linkend="gchararray">gchararray</link>           : Read
  &quot;<link linkend="GnomeDbLoginDialog--username">username</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="GnomeDbLoginDialog-struct"/>struct GnomeDbLoginDialog</title>
<indexterm><primary>GnomeDbLoginDialog</primary></indexterm><programlisting>struct GnomeDbLoginDialog;</programlisting>
<para>

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

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

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

</para></refsect2>
<refsect2>
<title><anchor id="gnome-db-login-dialog-new"/>gnome_db_login_dialog_new ()</title>
<indexterm><primary>gnome_db_login_dialog_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_db_login_dialog_new       (const <link linkend="gchar">gchar</link> *title,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);</programlisting>
<para>
Creates a new login dialog widget.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>title</parameter>&nbsp;:</term>
<listitem><simpara> title of the dialog, or <literal>NULL</literal>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>parent</parameter>&nbsp;:</term>
<listitem><simpara> transient parent of the dialog, or <literal>NULL</literal>
</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-login-dialog-run"/>gnome_db_login_dialog_run ()</title>
<indexterm><primary>gnome_db_login_dialog_run</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gnome_db_login_dialog_run       (<link linkend="GnomeDbLoginDialog">GnomeDbLoginDialog</link> *dialog);</programlisting>
<para>
Shows the login dialog and waits for the user to enter its username and
password and perform an action on the dialog.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> TRUE if the user wants to connect
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-login-dialog-get-dsn"/>gnome_db_login_dialog_get_dsn ()</title>
<indexterm><primary>gnome_db_login_dialog_get_dsn</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* gnome_db_login_dialog_get_dsn  (<link linkend="GnomeDbLoginDialog">GnomeDbLoginDialog</link> *dialog);</programlisting>
<para>
Get the currently defined data source parameters</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbLoginDialog"><type>GnomeDbLoginDialog</type></link> dialog
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a DSN string, which must not be modified
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-login-dialog-get-auth"/>gnome_db_login_dialog_get_auth ()</title>
<indexterm><primary>gnome_db_login_dialog_get_auth</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* gnome_db_login_dialog_get_auth (<link linkend="GnomeDbLoginDialog">GnomeDbLoginDialog</link> *dialog);</programlisting>
<para>
Get the currently defined authentication parameters</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeDbLoginDialog"><type>GnomeDbLoginDialog</type></link> dialog
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a string, which must not be modified
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-login-dialog-get-username"/>gnome_db_login_dialog_get_username ()</title>
<indexterm><primary>gnome_db_login_dialog_get_username</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* gnome_db_login_dialog_get_username
                                            (<link linkend="GnomeDbLoginDialog">GnomeDbLoginDialog</link> *dialog);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-login-dialog-get-password"/>gnome_db_login_dialog_get_password ()</title>
<indexterm><primary>gnome_db_login_dialog_get_password</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* gnome_db_login_dialog_get_password
                                            (<link linkend="GnomeDbLoginDialog">GnomeDbLoginDialog</link> *dialog);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-db-login-dialog-get-login-widget"/>gnome_db_login_dialog_get_login_widget ()</title>
<indexterm><primary>gnome_db_login_dialog_get_login_widget</primary></indexterm><programlisting><link linkend="GnomeDbLogin">GnomeDbLogin</link>* gnome_db_login_dialog_get_login_widget
                                            (<link linkend="GnomeDbLoginDialog">GnomeDbLoginDialog</link> *dialog);</programlisting>
<para>
Get the <link linkend="GnomeDbLogin"><type>GnomeDbLogin</type></link> widget contained in a <link linkend="GnomeDbLoginDialog"><type>GnomeDbLoginDialog</type></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GnomeDbLoginDialog"><type>GnomeDbLoginDialog</type></link> widget.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the login widget contained in the dialog.
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1>
<title>Properties</title>
<variablelist>
<varlistentry><term><anchor id="GnomeDbLoginDialog--dsn"/>&quot;<literal>dsn</literal>&quot; (<link linkend="gchararray">gchararray</link> : Read)</term>
<listitem>
<para></para>
</listitem></varlistentry>
<varlistentry><term><anchor id="GnomeDbLoginDialog--password"/>&quot;<literal>password</literal>&quot; (<link linkend="gchararray">gchararray</link> : Read)</term>
<listitem>
<para></para>
</listitem></varlistentry>
<varlistentry><term><anchor id="GnomeDbLoginDialog--username"/>&quot;<literal>username</literal>&quot; (<link linkend="gchararray">gchararray</link> : Read)</term>
<listitem>
<para></para>
</listitem></varlistentry>

</variablelist>
</refsect1>




</refentry>
