KDEUI
KNewPasswordDialog Class Reference
A password input dialog. More...
#include <knewpassworddialog.h>

Signals | |
void | newPassword (const QString &password) |
Public Member Functions | |
virtual void | accept () |
bool | allowEmptyPasswords () const |
KNewPasswordDialog (QWidget *parent=0) | |
int | maximumPasswordLength () const |
int | minimumPasswordLength () const |
QString | password () const |
int | passwordStrengthWarningLevel () const |
QPixmap | pixmap () const |
QString | prompt () const |
int | reasonablePasswordLength () const |
void | setAllowEmptyPasswords (bool allowed) |
void | setMaximumPasswordLength (int maxLength) |
void | setMinimumPasswordLength (int minLength) |
void | setPasswordStrengthWarningLevel (int warningLevel) |
void | setPixmap (const QPixmap &) |
void | setPrompt (const QString &prompt) |
void | setReasonablePasswordLength (int reasonableLength) |
virtual | ~KNewPasswordDialog () |
Protected Member Functions | |
bool | checkAndGetPassword (QString *pwd) |
virtual bool | checkPassword (const QString &) |
Detailed Description
A password input dialog.
This dialog asks the user to enter a password.

KDE Password Dialog
Usage Exemple
Asynchronous
KNewPasswordDialog *dlg = new KNewPasswordDialog( parent ); dlg->setPrompt( i18n( "Enter a password" ); connect( dlg, SIGNAL( newPassword( const QString& ) ) , this, SLOT( setPassword( const QString &) ) ); connect( dlg, SIGNAL( rejected() ) , this, SLOT( slotCancel() ) ); dlg->show();
Synchronous
KNewPasswordDialog dlg( parent ); dlg.setPrompt( i18n( "Enter a password" ); if( dlg.exec() ) setPassword( dlg.password() );
Definition at line 64 of file knewpassworddialog.h.
Constructor & Destructor Documentation
KNewPasswordDialog::KNewPasswordDialog | ( | QWidget * | parent = 0 |
) | [explicit] |
Constructs a password dialog.
- Parameters:
-
parent Passed to lower level constructor.
Definition at line 195 of file knewpassworddialog.cpp.
KNewPasswordDialog::~KNewPasswordDialog | ( | ) | [virtual] |
Destructs the password dialog.
Definition at line 202 of file knewpassworddialog.cpp.
Member Function Documentation
void KNewPasswordDialog::accept | ( | ) | [virtual] |
bool KNewPasswordDialog::allowEmptyPasswords | ( | ) | const |
Allow empty passwords?
- Returns:
- true if minimumPasswordLength() == 0
Definition at line 284 of file knewpassworddialog.cpp.
Checks input password.
If the password is right, returns true and fills pwd with the password. Otherwise returns false and pwd will be null.
- Since:
- 4.2
Definition at line 232 of file knewpassworddialog.cpp.
Virtual function that can be overridden to provide password checking in derived classes.
It should return true
if the password is valid, false
otherwise.
Definition at line 354 of file knewpassworddialog.cpp.
int KNewPasswordDialog::maximumPasswordLength | ( | ) | const |
Maximum acceptable password length.
Definition at line 306 of file knewpassworddialog.cpp.
int KNewPasswordDialog::minimumPasswordLength | ( | ) | const |
Minimum acceptable password length.
Definition at line 295 of file knewpassworddialog.cpp.
void KNewPasswordDialog::newPassword | ( | const QString & | password | ) | [signal] |
The dialog has been accepted, and the new password is password
.
QString KNewPasswordDialog::password | ( | ) | const |
Returns the password entered.
- Note:
- Only has meaningful data after accept has been called if you want to access the password from a subclass use checkAndGetPassword()
Definition at line 349 of file knewpassworddialog.cpp.
int KNewPasswordDialog::passwordStrengthWarningLevel | ( | ) | const |
Password strength level below which a warning is given.
Definition at line 344 of file knewpassworddialog.cpp.
QPixmap KNewPasswordDialog::pixmap | ( | ) | const |
Returns the pixmap that appears next to the prompt in the dialog.
Definition at line 227 of file knewpassworddialog.cpp.
QString KNewPasswordDialog::prompt | ( | ) | const |
Returns the password prompt.
Definition at line 214 of file knewpassworddialog.cpp.
int KNewPasswordDialog::reasonablePasswordLength | ( | ) | const |
Password length that is expected to be reasonably safe.
Definition at line 327 of file knewpassworddialog.cpp.
void KNewPasswordDialog::setAllowEmptyPasswords | ( | bool | allowed | ) |
Allow empty passwords? - Default: true.
same as setMinimumPasswordLength( allowed ? 0 : 1 )
Definition at line 277 of file knewpassworddialog.cpp.
void KNewPasswordDialog::setMaximumPasswordLength | ( | int | maxLength | ) |
Maximum acceptable password length.
- Parameters:
-
maxLength,: The new maximum password length.
Definition at line 300 of file knewpassworddialog.cpp.
void KNewPasswordDialog::setMinimumPasswordLength | ( | int | minLength | ) |
Minimum acceptable password length.
Default: 0
- Parameters:
-
minLength,: The new minimum password length
Definition at line 289 of file knewpassworddialog.cpp.
void KNewPasswordDialog::setPasswordStrengthWarningLevel | ( | int | warningLevel | ) |
Set the password strength level below which a warning is given Value is in the range 0 to 99.
Empty passwords score 0; non-empty passwords score up to 100, depending on their length and whether they contain numbers, mixed case letters and punctuation.
Default: 1 - warn if the password has no discernable strength whatsoever
- Parameters:
-
warningLevel,: The level below which a warning should be given.
Definition at line 333 of file knewpassworddialog.cpp.
void KNewPasswordDialog::setPixmap | ( | const QPixmap & | pixmap | ) |
Sets the pixmap that appears next to the prompt in the dialog.
The default pixmap represent a simple key.
the recommended size is KIconLoader::SizeHuge
Definition at line 220 of file knewpassworddialog.cpp.
void KNewPasswordDialog::setPrompt | ( | const QString & | prompt | ) |
Sets the password prompt.
Definition at line 208 of file knewpassworddialog.cpp.
void KNewPasswordDialog::setReasonablePasswordLength | ( | int | reasonableLength | ) |
Password length that is expected to be reasonably safe.
Used to compute the strength level
Default: 8 - the standard UNIX password length
- Parameters:
-
reasonableLength,: The new reasonable password length.
Definition at line 313 of file knewpassworddialog.cpp.
The documentation for this class was generated from the following files: