<refentry id="libgnomeui-GnomePassword">
<refmeta>
<refentrytitle role="top_of_page" id="libgnomeui-GnomePassword.top_of_page">GnomePassword</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>LIBGNOMEUI Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GnomePassword</refname>
<refpurpose></refpurpose>
</refnamediv>

<refsynopsisdiv id="libgnomeui-GnomePassword.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

#include &lt;libgnomeui/libgnomeui.h&gt;

                    <link linkend="GnomePasswordDialog">GnomePasswordDialog</link>;
                    <link linkend="GnomePasswordDialogDetails">GnomePasswordDialogDetails</link>;
enum                <link linkend="GnomePasswordDialogRemember">GnomePasswordDialogRemember</link>;
<link linkend="gboolean">gboolean</link>            <link linkend="gnome-password-dialog-anon-selected">gnome_password_dialog_anon_selected</link> (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog);
<link linkend="char">char</link> *              <link linkend="gnome-password-dialog-get-domain">gnome_password_dialog_get_domain</link>    (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog);
<link linkend="char">char</link> *              <link linkend="gnome-password-dialog-get-password">gnome_password_dialog_get_password</link>  (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog);
<link linkend="char">char</link> *              <link linkend="gnome-password-dialog-get-new-password">gnome_password_dialog_get_new_password</link>
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog);
<link linkend="GnomePasswordDialogRemember">GnomePasswordDialogRemember</link>  <link linkend="gnome-password-dialog-get-remember">gnome_password_dialog_get_remember</link>
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog);
<link linkend="char">char</link> *              <link linkend="gnome-password-dialog-get-username">gnome_password_dialog_get_username</link>  (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog);
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gnome-password-dialog-new">gnome_password_dialog_new</link>           (const <link linkend="char">char</link> *dialog_title,
                                                         const <link linkend="char">char</link> *message,
                                                         const <link linkend="char">char</link> *username,
                                                         const <link linkend="char">char</link> *password,
                                                         <link linkend="gboolean">gboolean</link> readonly_username);
<link linkend="gboolean">gboolean</link>            <link linkend="gnome-password-dialog-run-and-block">gnome_password_dialog_run_and_block</link> (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog);
<link linkend="void">void</link>                <link linkend="gnome-password-dialog-set-domain">gnome_password_dialog_set_domain</link>    (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         const <link linkend="char">char</link> *domain);
<link linkend="void">void</link>                <link linkend="gnome-password-dialog-set-password">gnome_password_dialog_set_password</link>  (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         const <link linkend="char">char</link> *password);
<link linkend="void">void</link>                <link linkend="gnome-password-dialog-set-readonly-domain">gnome_password_dialog_set_readonly_domain</link>
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> readonly);
<link linkend="void">void</link>                <link linkend="gnome-password-dialog-set-readonly-username">gnome_password_dialog_set_readonly_username</link>
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> readonly);
<link linkend="void">void</link>                <link linkend="gnome-password-dialog-set-remember">gnome_password_dialog_set_remember</link>  (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="GnomePasswordDialogRemember">GnomePasswordDialogRemember</link> remember);
<link linkend="void">void</link>                <link linkend="gnome-password-dialog-set-show-domain">gnome_password_dialog_set_show_domain</link>
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> show);
<link linkend="void">void</link>                <link linkend="gnome-password-dialog-set-show-password">gnome_password_dialog_set_show_password</link>
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> show);
<link linkend="void">void</link>                <link linkend="gnome-password-dialog-set-show-new-password">gnome_password_dialog_set_show_new_password</link>
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> show);
<link linkend="void">void</link>                <link linkend="gnome-password-dialog-set-show-new-password-quality">gnome_password_dialog_set_show_new_password_quality</link>
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> show);
<link linkend="void">void</link>                <link linkend="gnome-password-dialog-set-show-remember">gnome_password_dialog_set_show_remember</link>
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> show_remember);
<link linkend="void">void</link>                <link linkend="gnome-password-dialog-set-show-username">gnome_password_dialog_set_show_username</link>
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> show);
<link linkend="void">void</link>                <link linkend="gnome-password-dialog-set-show-userpass-buttons">gnome_password_dialog_set_show_userpass_buttons</link>
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> show_userpass_buttons);
<link linkend="void">void</link>                <link linkend="gnome-password-dialog-set-username">gnome_password_dialog_set_username</link>  (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         const <link linkend="char">char</link> *username);
<link linkend="void">void</link>                <link linkend="gnome-password-dialog-set-password-quality-func">gnome_password_dialog_set_password_quality_func</link>
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="GnomePasswordDialogQualityFunc">GnomePasswordDialogQualityFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> dnotify);
</synopsis>
</refsynopsisdiv>









<refsect1 id="libgnomeui-GnomePassword.description" role="desc">
<title role="desc.title">Description</title>
<para>
</para>
</refsect1>

<refsect1 id="libgnomeui-GnomePassword.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GnomePasswordDialog" role="struct">
<title>GnomePasswordDialog</title>
<indexterm zone="GnomePasswordDialog"><primary sortas="GnomePasswordDialog">GnomePasswordDialog</primary></indexterm><programlisting>typedef struct {
	GtkDialog gtk_dialog;

	GnomePasswordDialogDetails *details;
} GnomePasswordDialog;
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GnomePasswordDialogDetails" role="struct">
<title>GnomePasswordDialogDetails</title>
<indexterm zone="GnomePasswordDialogDetails"><primary sortas="GnomePasswordDialogDetails">GnomePasswordDialogDetails</primary></indexterm><programlisting>typedef struct _GnomePasswordDialogDetails GnomePasswordDialogDetails;</programlisting>
<para>
</para></refsect2>
<refsect2 id="GnomePasswordDialogRemember" role="enum">
<title>enum GnomePasswordDialogRemember</title>
<indexterm zone="GnomePasswordDialogRemember"><primary sortas="GnomePasswordDialogRemember">GnomePasswordDialogRemember</primary></indexterm><programlisting>typedef enum {
	GNOME_PASSWORD_DIALOG_REMEMBER_NOTHING,
	GNOME_PASSWORD_DIALOG_REMEMBER_SESSION,
	GNOME_PASSWORD_DIALOG_REMEMBER_FOREVER
} GnomePasswordDialogRemember;
</programlisting>
<para>
</para></refsect2>
<refsect2 id="gnome-password-dialog-anon-selected" role="function">
<title>gnome_password_dialog_anon_selected ()</title>
<indexterm zone="gnome-password-dialog-anon-selected"><primary sortas="gnome_password_dialog_anon_selected">gnome_password_dialog_anon_selected</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gnome_password_dialog_anon_selected (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog);</programlisting>
<para>
Checks whether anonymous support is set to <link linkend="TRUE--CAPS"><type>TRUE</type></link> and the radio button for connecting
as anonymous user is active.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><type>TRUE</type></link> if anonymous support is set and the radio button is active, <link linkend="FALSE--CAPS"><type>FALSE</type></link> otherwise.

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-password-dialog-get-domain" role="function" condition="since:2.4">
<title>gnome_password_dialog_get_domain ()</title>
<indexterm zone="gnome-password-dialog-get-domain" role="2.4"><primary sortas="gnome_password_dialog_get_domain">gnome_password_dialog_get_domain</primary></indexterm><programlisting><link linkend="char">char</link> *              gnome_password_dialog_get_domain    (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog);</programlisting>
<para>
Gets the domain name from the password dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The domain name, a char*.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gnome-password-dialog-get-password" role="function" condition="since:2.4">
<title>gnome_password_dialog_get_password ()</title>
<indexterm zone="gnome-password-dialog-get-password" role="2.4"><primary sortas="gnome_password_dialog_get_password">gnome_password_dialog_get_password</primary></indexterm><programlisting><link linkend="char">char</link> *              gnome_password_dialog_get_password  (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog);</programlisting>
<para>
Gets the password from the password dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The password, a char*.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gnome-password-dialog-get-new-password" role="function" condition="since:2.18">
<title>gnome_password_dialog_get_new_password ()</title>
<indexterm zone="gnome-password-dialog-get-new-password" role="2.18"><primary sortas="gnome_password_dialog_get_new_password">gnome_password_dialog_get_new_password</primary></indexterm><programlisting><link linkend="char">char</link> *              gnome_password_dialog_get_new_password
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog);</programlisting>
<para>
Gets the new password from the password dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The password, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if the entries in the new password
field and the confirmation field don't match.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gnome-password-dialog-get-remember" role="function" condition="since:2.6">
<title>gnome_password_dialog_get_remember ()</title>
<indexterm zone="gnome-password-dialog-get-remember" role="2.6"><primary sortas="gnome_password_dialog_get_remember">gnome_password_dialog_get_remember</primary></indexterm><programlisting><link linkend="GnomePasswordDialogRemember">GnomePasswordDialogRemember</link>  gnome_password_dialog_get_remember
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog);</programlisting>
<para>
Gets the state of the check buttons to remember password for the session and save
password to keyring.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="GnomePasswordDialogRemember"><type>GnomePasswordDialogRemember</type></link>, which indicates whether to remember the password for the session
or forever.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gnome-password-dialog-get-username" role="function" condition="since:2.4">
<title>gnome_password_dialog_get_username ()</title>
<indexterm zone="gnome-password-dialog-get-username" role="2.4"><primary sortas="gnome_password_dialog_get_username">gnome_password_dialog_get_username</primary></indexterm><programlisting><link linkend="char">char</link> *              gnome_password_dialog_get_username  (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog);</programlisting>
<para>
Gets the username from the password dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The username, a char*.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gnome-password-dialog-new" role="function" condition="since:2.4">
<title>gnome_password_dialog_new ()</title>
<indexterm zone="gnome-password-dialog-new" role="2.4"><primary sortas="gnome_password_dialog_new">gnome_password_dialog_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gnome_password_dialog_new           (const <link linkend="char">char</link> *dialog_title,
                                                         const <link linkend="char">char</link> *message,
                                                         const <link linkend="char">char</link> *username,
                                                         const <link linkend="char">char</link> *password,
                                                         <link linkend="gboolean">gboolean</link> readonly_username);</programlisting>
<para>
Creates a new password dialog with an optional title, 
message, username, password etc. The user will be given the option to
save the password for this session only or store it permanently in her
keyring.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog_title</parameter>&#160;:</term>
<listitem><simpara> The title of the dialog
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>message</parameter>&#160;:</term>
<listitem><simpara> Message text for the dialog
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>username</parameter>&#160;:</term>
<listitem><simpara> The username to be used in the dialog
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>password</parameter>&#160;:</term>
<listitem><simpara> Password to be used
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>readonly_username</parameter>&#160;:</term>
<listitem><simpara> Boolean value that controls whether the user
can edit the username or not
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A new password dialog.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gnome-password-dialog-run-and-block" role="function" condition="since:2.4">
<title>gnome_password_dialog_run_and_block ()</title>
<indexterm zone="gnome-password-dialog-run-and-block" role="2.4"><primary sortas="gnome_password_dialog_run_and_block">gnome_password_dialog_run_and_block</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gnome_password_dialog_run_and_block (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog);</programlisting>
<para>
Gets the user input from PasswordDialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if "Connect" button is pressed. <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> if "Cancel"  button is pressed.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gnome-password-dialog-set-domain" role="function" condition="since:2.4">
<title>gnome_password_dialog_set_domain ()</title>
<indexterm zone="gnome-password-dialog-set-domain" role="2.4"><primary sortas="gnome_password_dialog_set_domain">gnome_password_dialog_set_domain</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_password_dialog_set_domain    (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         const <link linkend="char">char</link> *domain);</programlisting>
<para>
Sets the domain field in the password dialog to <parameter>domain</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>domain</parameter>&#160;:</term>
<listitem><simpara> The domain that should be set
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gnome-password-dialog-set-password" role="function" condition="since:2.4">
<title>gnome_password_dialog_set_password ()</title>
<indexterm zone="gnome-password-dialog-set-password" role="2.4"><primary sortas="gnome_password_dialog_set_password">gnome_password_dialog_set_password</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_password_dialog_set_password  (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         const <link linkend="char">char</link> *password);</programlisting>
<para>
Sets the password in the password dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>password</parameter>&#160;:</term>
<listitem><simpara> The password that should be set
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gnome-password-dialog-set-readonly-domain" role="function" condition="since:2.6">
<title>gnome_password_dialog_set_readonly_domain ()</title>
<indexterm zone="gnome-password-dialog-set-readonly-domain" role="2.6"><primary sortas="gnome_password_dialog_set_readonly_domain">gnome_password_dialog_set_readonly_domain</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_password_dialog_set_readonly_domain
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> readonly);</programlisting>
<para>
Sets the editable nature of the domain field in the password
dialog based on the boolean value <parameter>readonly</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>readonly</parameter>&#160;:</term>
<listitem><simpara> Boolean value that controls whether the user
can edit the domain or not
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gnome-password-dialog-set-readonly-username" role="function" condition="since:2.4">
<title>gnome_password_dialog_set_readonly_username ()</title>
<indexterm zone="gnome-password-dialog-set-readonly-username" role="2.4"><primary sortas="gnome_password_dialog_set_readonly_username">gnome_password_dialog_set_readonly_username</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_password_dialog_set_readonly_username
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> readonly);</programlisting>
<para>
Sets the editable nature of the username field in the password 
dialog based on the boolean value <parameter>readonly</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>readonly</parameter>&#160;:</term>
<listitem><simpara> Boolean value that controls whether the user
can edit the username or not
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gnome-password-dialog-set-remember" role="function" condition="since:2.6">
<title>gnome_password_dialog_set_remember ()</title>
<indexterm zone="gnome-password-dialog-set-remember" role="2.6"><primary sortas="gnome_password_dialog_set_remember">gnome_password_dialog_set_remember</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_password_dialog_set_remember  (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="GnomePasswordDialogRemember">GnomePasswordDialogRemember</link> remember);</programlisting>
<para>
Based on the value of <link linkend="GnomePasswordDialogRemember"><type>GnomePasswordDialogRemember</type></link>, sets the state of
the check buttons to remember password for the session and save password to keyring .</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>remember</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialogRemember"><type>GnomePasswordDialogRemember</type></link>.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gnome-password-dialog-set-show-domain" role="function" condition="since:2.6">
<title>gnome_password_dialog_set_show_domain ()</title>
<indexterm zone="gnome-password-dialog-set-show-domain" role="2.6"><primary sortas="gnome_password_dialog_set_show_domain">gnome_password_dialog_set_show_domain</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_password_dialog_set_show_domain
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> show);</programlisting>
<para>
Shows or hides the domain field in the password dialog based on the value of <parameter>show</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>show</parameter>&#160;:</term>
<listitem><simpara> Boolean value that controls whether the domain entry has to 
appear or not.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gnome-password-dialog-set-show-password" role="function" condition="since:2.6">
<title>gnome_password_dialog_set_show_password ()</title>
<indexterm zone="gnome-password-dialog-set-show-password" role="2.6"><primary sortas="gnome_password_dialog_set_show_password">gnome_password_dialog_set_show_password</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_password_dialog_set_show_password
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> show);</programlisting>
<para>
Shows or hides the password field in the password dialog based on the value of <parameter>show</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>show</parameter>&#160;:</term>
<listitem><simpara> Boolean value that controls whether the password entry has to
appear or not.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gnome-password-dialog-set-show-new-password" role="function" condition="since:2.18">
<title>gnome_password_dialog_set_show_new_password ()</title>
<indexterm zone="gnome-password-dialog-set-show-new-password" role="2.18"><primary sortas="gnome_password_dialog_set_show_new_password">gnome_password_dialog_set_show_new_password</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_password_dialog_set_show_new_password
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> show);</programlisting>
<para>
Shows or hides the new password and new password confirmation
fields based on the value of <parameter>show</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>show</parameter>&#160;:</term>
<listitem><simpara> Boolean value that controls whether the new password entry has to
appear or not.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gnome-password-dialog-set-show-new-password-quality" role="function" condition="since:2.18">
<title>gnome_password_dialog_set_show_new_password_quality ()</title>
<indexterm zone="gnome-password-dialog-set-show-new-password-quality" role="2.18"><primary sortas="gnome_password_dialog_set_show_new_password_quality">gnome_password_dialog_set_show_new_password_quality</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_password_dialog_set_show_new_password_quality
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> show);</programlisting>
<para>
Shows or hides the new password quality meter.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>show</parameter>&#160;:</term>
<listitem><simpara> Boolean value that controls whether the new password quality meter will
appear or not.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gnome-password-dialog-set-show-remember" role="function" condition="since:2.6">
<title>gnome_password_dialog_set_show_remember ()</title>
<indexterm zone="gnome-password-dialog-set-show-remember" role="2.6"><primary sortas="gnome_password_dialog_set_show_remember">gnome_password_dialog_set_show_remember</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_password_dialog_set_show_remember
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> show_remember);</programlisting>
<para>
Shows or hides the check buttons to save password in keyring and remember password for 
session based on the value of <parameter>show_remember</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>show_remember</parameter>&#160;:</term>
<listitem><simpara> Boolean value that controls whether the check buttons for password retention
should appear or not.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gnome-password-dialog-set-show-username" role="function" condition="since:2.6">
<title>gnome_password_dialog_set_show_username ()</title>
<indexterm zone="gnome-password-dialog-set-show-username" role="2.6"><primary sortas="gnome_password_dialog_set_show_username">gnome_password_dialog_set_show_username</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_password_dialog_set_show_username
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> show);</programlisting>
<para>
Shows or hides the username entry in the password dialog based on the value of <parameter>show</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>show</parameter>&#160;:</term>
<listitem><simpara> Boolean value that controls whether the username entry has to
appear or not.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gnome-password-dialog-set-show-userpass-buttons" role="function" condition="since:2.8">
<title>gnome_password_dialog_set_show_userpass_buttons ()</title>
<indexterm zone="gnome-password-dialog-set-show-userpass-buttons" role="2.8"><primary sortas="gnome_password_dialog_set_show_userpass_buttons">gnome_password_dialog_set_show_userpass_buttons</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_password_dialog_set_show_userpass_buttons
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="gboolean">gboolean</link> show_userpass_buttons);</programlisting>
<para>
Shows the radio buttons for connecting anonymously and connecting as user if 
<parameter>show_userpass_buttons</parameter> is <link linkend="TRUE--CAPS"><type>TRUE</type></link>. Also makes the 'Username' and 'Password' fields greyed out if the 
radio button for connecting anonymously is active. If <parameter>show_userpass_buttons</parameter> is <link linkend="FALSE--CAPS"><type>FALSE</type></link>, then these
radio buttons are hidden and the 'Username' and 'Password' fields will be made active.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>show_userpass_buttons</parameter>&#160;:</term>
<listitem><simpara> Boolean value that controls whether the radio buttons for connecting 
anonymously and connecting as user should be shown or not.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gnome-password-dialog-set-username" role="function" condition="since:2.4">
<title>gnome_password_dialog_set_username ()</title>
<indexterm zone="gnome-password-dialog-set-username" role="2.4"><primary sortas="gnome_password_dialog_set_username">gnome_password_dialog_set_username</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_password_dialog_set_username  (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         const <link linkend="char">char</link> *username);</programlisting>
<para>
Sets the username in the password dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>username</parameter>&#160;:</term>
<listitem><simpara> The username that should be set
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gnome-password-dialog-set-password-quality-func" role="function" condition="since:2.18">
<title>gnome_password_dialog_set_password_quality_func ()</title>
<indexterm zone="gnome-password-dialog-set-password-quality-func" role="2.18"><primary sortas="gnome_password_dialog_set_password_quality_func">gnome_password_dialog_set_password_quality_func</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_password_dialog_set_password_quality_func
                                                        (<link linkend="GnomePasswordDialog">GnomePasswordDialog</link> *password_dialog,
                                                         <link linkend="GnomePasswordDialogQualityFunc">GnomePasswordDialogQualityFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> dnotify);</programlisting>
<para>
Sets the function which measures the quality of the
new password as it's typed.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>password_dialog</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GnomePasswordDialog"><type>GnomePasswordDialog</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> the new <link linkend="GnomePasswordDialogQualityFunc"><type>GnomePasswordDialogQualityFunc</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara> user data to pass to the quality func
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>dnotify</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>

</refsect1>




</refentry>
