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 165 of file knewpassworddialog.cpp.
KNewPasswordDialog::~KNewPasswordDialog | ( | ) | [virtual] |
Member Function Documentation
void KNewPasswordDialog::accept | ( | ) | [virtual] |
For internal use only.
Reimplemented from QDialog.
Definition at line 235 of file knewpassworddialog.cpp.
bool KNewPasswordDialog::allowEmptyPasswords | ( | ) | const |
Allow empty passwords?
- Returns:
- true if minimumPasswordLength() == 0
Definition at line 254 of file knewpassworddialog.cpp.
bool KNewPasswordDialog::checkAndGetPassword | ( | QString * | pwd | ) | [protected] |
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 202 of file knewpassworddialog.cpp.
bool KNewPasswordDialog::checkPassword | ( | const QString & | ) | [protected, virtual] |
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 324 of file knewpassworddialog.cpp.
int KNewPasswordDialog::maximumPasswordLength | ( | ) | const |
int KNewPasswordDialog::minimumPasswordLength | ( | ) | const |
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 319 of file knewpassworddialog.cpp.
int KNewPasswordDialog::passwordStrengthWarningLevel | ( | ) | const |
Password strength level below which a warning is given.
Definition at line 314 of file knewpassworddialog.cpp.
QPixmap KNewPasswordDialog::pixmap | ( | ) | const |
Returns the pixmap that appears next to the prompt in the dialog.
Definition at line 197 of file knewpassworddialog.cpp.
QString KNewPasswordDialog::prompt | ( | ) | const |
int KNewPasswordDialog::reasonablePasswordLength | ( | ) | const |
Password length that is expected to be reasonably safe.
Definition at line 297 of file knewpassworddialog.cpp.
void KNewPasswordDialog::setAllowEmptyPasswords | ( | bool | allowed | ) |
Allow empty passwords? - Default: true.
same as setMinimumPasswordLength( allowed ? 0 : 1 )
Definition at line 247 of file knewpassworddialog.cpp.
void KNewPasswordDialog::setMaximumPasswordLength | ( | int | maxLength | ) |
Maximum acceptable password length.
- Parameters:
-
maxLength,: The new maximum password length.
Definition at line 270 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 259 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 303 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 190 of file knewpassworddialog.cpp.
void KNewPasswordDialog::setPrompt | ( | const QString & | prompt | ) |
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 283 of file knewpassworddialog.cpp.
The documentation for this class was generated from the following files: