Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

QPasswordDialog Class Reference
[QtBaseModule]

The QPasswordDialog class provides a dialog widget for entering a PIN code. More...

    #include <QPasswordDialog>

Inherits QDialog.

• List of all members, including inherited members
• Obsolete members

Public Types

• enum InputMode { Crypted, Plain, Pin }

Public Functions

• QPasswordDialog ( QWidget * parent = 0, Qt::WFlags flags = 0 )
• ~QPasswordDialog ()
• QPasswordDialog::InputMode inputMode () const
• QString password () const
• QString prompt () const
• void reset ()
• void setInputMode ( QPasswordDialog::InputMode mode )
• void setPrompt ( const QString & prompt )

• 5 public functions inherited from QDialog
• 206 public functions inherited from QWidget
• 29 public functions inherited from QObject
• 14 public functions inherited from QPaintDevice

Static Public Members

• QString getPassword ( QWidget * parent, const QString & prompt, InputMode mode = QPasswordDialog::Crypted, bool last = true )

• 4 static public members inherited from QWidget
• 4 static public members inherited from QObject

Additional Inherited Members

• 2 properties inherited from QDialog
• 57 properties inherited from QWidget
• 1 property inherited from QObject
• 4 public slots inherited from QDialog
• 19 public slots inherited from QWidget
• 1 public slot inherited from QObject
• 3 signals inherited from QDialog
• 1 signal inherited from QWidget
• 1 signal inherited from QObject
• 1 public type inherited from QObject
• 38 protected functions inherited from QWidget
• 7 protected functions inherited from QObject
• 1 protected function inherited from QPaintDevice
• 1 protected slot inherited from QWidget
• 2 protected variables inherited from QObject
• 1 protected type inherited from QPaintDevice

Detailed Description

The QPasswordDialog class provides a dialog widget for entering a PIN code.

Member Type Documentation

enum QPasswordDialog::InputMode

This enum describes the various input modes. The input mode for a dialog is used to specify how the password is returned (encrypted or plain text), as well as other UI differences if the dialog is shown using getPassword().

Member Function Documentation

QPasswordDialog::QPasswordDialog ( QWidget * parent = 0, Qt::WFlags flags = 0 )

Constructs a new QPasswordDialog with the given parent and widget flags.

The input mode for the dialog is set by default to Crypted.

QPasswordDialog::~QPasswordDialog ()

Destroys the QPasswordDialog.

QString QPasswordDialog::getPassword ( QWidget * parent, const QString & prompt, InputMode mode = QPasswordDialog::Crypted, bool last = true )   [static]

Creates and displays a password dialog with the given parent and prompt; returns the entered password.

mode specifies whether the returned password is one-way encrypted (using MD5) or plain text. It also determines whether or not the dialog will be maximized. If the operation is required to accept more than one password -- for example, if accepting an old password and a new password -- set last to false to set the context label to 'Next'.

The returned value is a null string if the user cancels the operation, or an empty string if the user enters no password (but confirms the dialog).

QPasswordDialog::InputMode QPasswordDialog::inputMode () const

Returns the input mode used by the dialog.

See also setInputMode().

QString QPasswordDialog::password () const

Returns the password entered in the dialog.

If the input mode is Crypted, the password will be returned one-way encrypted (using MD5); otherwise it will be returned as plain text.

QString QPasswordDialog::prompt () const

Returns the prompt used by the dialog.

See also setPrompt().

void QPasswordDialog::reset ()

Resets any password previously entered in the dialog.

void QPasswordDialog::setInputMode ( QPasswordDialog::InputMode mode )

Sets the input mode for the dialog to mode.

See also inputMode().

void QPasswordDialog::setPrompt ( const QString & prompt )

Sets the prompt to be displayed by the dialog.

See also prompt().