class PasswordDialog

Public Methods

•  PasswordDialog ( QWidget* parent=0, const char* name=0, WFlags wflags=0, bool modal=true, bool enableKeep=false )
•  PasswordDialog ( const QString& prompt, const QString& user, bool enableKeep = false, bool modal=true, QWidget* parent=0, const char* name=0, WFlags wflags=0 )
•  PasswordDialog ( QWidget* parent, const char* name, bool modal, WFlags wflags, const QString& head, const QString& user, const QString& pass )
•  ~PasswordDialog ()
• void  setPrompt ( const QString& prompt )
• void  addCommentLine ( const QString& label, const QString comment )
• QString  password () const
• QString  username () const
• QString  user ()
• QString  password ()
• bool  keepPassword () const
• void  setUserReadOnly ( bool readOnly )
• void  setEnableUserField ( bool enable, bool=false )
• void  init ( const QString&, const QString&, bool )

Public Static Methods

• static int  getNameAndPassword ( QString& user, QString& pass, bool* keep, const QString& prompt = QString::null, bool readOnly = false, const QString& caption = QString::null, const QString& comment = QString::null, const QString& label = QString::null )

Detailed Description

A dialog for requesting a login and a password from the end user.

KIO-Slave authors are encouraged to use SlaveBase::openPassDlg instead of directly instantiating this dialog.

Create a password dialog.

Parameters:

parent	the parent widget (default:NULL).
name	the dialog name (default:NULL).
wfags	window flags.
modal	if true, the dialog will be modal(default:true).
enableKeep	shows or hides the keep password check box.

Create a password dialog.

Parameters:

prompt	instructional text to be shown.
user	username, if known initially.
enableKeep	if true, makes password persistent until KDE is shutdown.
modal	if true, the dialog will be modal (default:true).
parent	the parent widget (default:NULL).
name	the dialog name (default:NULL).
wfags	window flags.

IMPORTANT: This function is added for binary compatability with the previous password dialog and as such should be avoided!

Parameters:

parent	the parent widget
name	the dialog name
modal	if true, the dialog will be modal
wflags	window flags, passed to QDialog
head	the text to show in the dialog, on top of the two fields
user	user name, if known initially
pass	password, if known initially

Destructor

Sets the prompt to show to the user.

Adds a comment line to the dialog.

This function allows you to add one additional comment line to this widget. Calling this fucntion after a comment has already been added will not have any effect.

Parameters:

label	label for comment (ex:"Command:")
comment	the actual comment text.

[const]

Returns the password entered by the user.

[const]

Returns the username entered by the user.

[const]

Determines whether supplied authorization should persist even after the application has been closed.

Sets the username field read-only and sets the focus to the password field.

Parameters:

readOnly

[static]

A convienence static method for obtaining authorization information from the end user.

Parameters:

user	username
pass	password
keep	pointer to flag that indicates
prompt	text to display to user.
readOnly	make the username field read-only.
caption	set the title bar to given text.
comment	extra comment to display to user.
label	optinal label for extra comment.

Returns: Accept/Reject based on the user choice.