KNewPasswordDialog Class Reference

#include <knewpassworddialog.h>

Inheritance diagram for KNewPasswordDialog:

Signals
void	newPassword (const QString &password)
Signals inherited from KDialog
void	aboutToShowDetails ()
void	applyClicked ()
void	buttonClicked (KDialog::ButtonCode button)
void	cancelClicked ()
void	closeClicked ()
void	defaultClicked ()
void	finished ()
void	helpClicked ()
void	hidden ()
void	layoutHintChanged ()
void	noClicked ()
void	okClicked ()
void	resetClicked ()
void	tryClicked ()
void	user1Clicked ()
void	user2Clicked ()
void	user3Clicked ()
void	yesClicked ()

Public Member Functions
	KNewPasswordDialog (QWidget *parent=0)
virtual	~KNewPasswordDialog ()
virtual void	accept ()
bool	allowEmptyPasswords () const
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)
Public Member Functions inherited from KDialog
	KDialog (QWidget *parent=0, Qt::WindowFlags flags=0)
	~KDialog ()
KPushButton *	button (ButtonCode id) const
KIcon	buttonIcon (ButtonCode id) const
QString	buttonText (ButtonCode id) const
QString	buttonToolTip (ButtonCode id) const
QString	buttonWhatsThis (ButtonCode id) const
ButtonCode	defaultButton () const
QString	helpLinkText () const
void	incrementInitialSize (const QSize &size)
bool	isButtonEnabled (ButtonCode id) const
QWidget *	mainWidget ()
virtual QSize	minimumSizeHint () const
void	restoreDialogSize (const KConfigGroup &config)
void	saveDialogSize (KConfigGroup &config, KConfigGroup::WriteConfigFlags options=KConfigGroup::Normal) const
void	setButtonFocus (ButtonCode id)
void	setButtonGuiItem (ButtonCode id, const KGuiItem &item)
void	setButtonIcon (ButtonCode id, const KIcon &icon)
void	setButtonMenu (ButtonCode id, QMenu *menu, ButtonPopupMode popupmode=InstantPopup)
void	setButtons (ButtonCodes buttonMask)
void	setButtonsOrientation (Qt::Orientation orientation)
void	setButtonText (ButtonCode id, const QString &text)
void	setButtonToolTip (ButtonCode id, const QString &text)
void	setButtonWhatsThis (ButtonCode id, const QString &text)
void	setDefaultButton (ButtonCode id)
void	setEscapeButton (ButtonCode id)
void	setInitialSize (const QSize &size)
void	setMainWidget (QWidget *widget)
void	showButton (ButtonCode id, bool state)
void	showButtonSeparator (bool state)
virtual QSize	sizeHint () const

Protected Member Functions
bool	checkAndGetPassword (QString *pwd)
virtual bool	checkPassword (const QString &)
Protected Member Functions inherited from KDialog
	KDialog (KDialogPrivate &dd, QWidget *parent, Qt::WindowFlags flags=0)
virtual void	closeEvent (QCloseEvent *e)
virtual void	hideEvent (QHideEvent *)
virtual void	keyPressEvent (QKeyEvent *)

Additional Inherited Members
Public Types inherited from KDialog
enum	ButtonCode {   None = 0x00000000, Help = 0x00000001, Default = 0x00000002, Ok = 0x00000004,   Apply = 0x00000008, Try = 0x00000010, Cancel = 0x00000020, Close = 0x00000040,   No = 0x00000080, Yes = 0x00000100, Reset = 0x00000200, Details = 0x00000400,   User1 = 0x00001000, User2 = 0x00002000, User3 = 0x00004000, NoDefault = 0x00008000 }
enum	ButtonPopupMode { InstantPopup = 0, DelayedPopup = 1 }
enum	CaptionFlag { NoCaptionFlags = 0, AppNameCaption = 1, ModifiedCaption = 2, HIGCompliantCaption = AppNameCaption }
Public Slots inherited from KDialog
void	delayedDestruct ()
void	enableButton (ButtonCode id, bool state)
void	enableButtonApply (bool state)
void	enableButtonCancel (bool state)
void	enableButtonOk (bool state)
void	enableLinkedHelp (bool state)
bool	isDetailsWidgetVisible () const
virtual void	setCaption (const QString &caption)
virtual void	setCaption (const QString &caption, bool modified)
void	setDetailsWidget (QWidget *detailsWidget)
void	setDetailsWidgetVisible (bool visible)
void	setHelp (const QString &anchor, const QString &appname=QString())
void	setHelpLinkText (const QString &text)
virtual void	setPlainCaption (const QString &caption)
Static Public Member Functions inherited from KDialog
static bool	avoidArea (QWidget *widget, const QRect &area, int screen=-1)
static void	centerOnScreen (QWidget *widget, int screen=-1)
static int	groupSpacingHint ()
static QString	makeStandardCaption (const QString &userCaption, QWidget *window=0, CaptionFlags flags=HIGCompliantCaption)
static int	marginHint ()
static void	resizeLayout (QWidget *widget, int margin, int spacing)
static void	resizeLayout (QLayout *lay, int margin, int spacing)
static void	setAllowEmbeddingInGraphicsView (bool allowEmbedding)
static int	spacingHint ()
Protected Slots inherited from KDialog
virtual void	slotButtonClicked (int button)
void	updateGeometry ()
Protected Attributes inherited from KDialog
KDialogPrivate *const	d_ptr

Detailed Description

A password input dialog.

This dialog asks the user to enter a new password.

The password has to be entered twice to check if the passwords match. A hint about the strength of the entered password is also shown.

Usage Example

Asynchronous

KNewPasswordDialog *dlg = new KNewPasswordDialog( parent );
dlg->setPrompt( i18n( "Enter a password" ) );
connect( dlg, SIGNAL( newPassword(QString) )  , this, SLOT( setPassword(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() );

KDE New Password Dialog

Author

Geert Jansen janse.nosp@m.n@kd.nosp@m.e.org

Olivier Goffart ogoff.nosp@m.art@.nosp@m.kde.o.nosp@m.rg

Definition at line 68 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 194 of file knewpassworddialog.cpp.

KNewPasswordDialog::~KNewPasswordDialog ( )

virtual

Destructs the password dialog.

Definition at line 201 of file knewpassworddialog.cpp.

Member Function Documentation

void KNewPasswordDialog::accept ( )

virtual

Definition at line 264 of file knewpassworddialog.cpp.

bool KNewPasswordDialog::allowEmptyPasswords

(

)

const

Allow empty passwords?

Returns

true if minimumPasswordLength() == 0

Definition at line 283 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 231 of file knewpassworddialog.cpp.

bool KNewPasswordDialog::checkPassword ( const QString &  )

protectedvirtual

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 353 of file knewpassworddialog.cpp.

int KNewPasswordDialog::maximumPasswordLength

(

)

const

Maximum acceptable password length.

Definition at line 305 of file knewpassworddialog.cpp.

int KNewPasswordDialog::minimumPasswordLength

(

)

const

Minimum acceptable password length.

Definition at line 294 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 348 of file knewpassworddialog.cpp.

int KNewPasswordDialog::passwordStrengthWarningLevel

(

)

const

Password strength level below which a warning is given.

Definition at line 343 of file knewpassworddialog.cpp.

QPixmap KNewPasswordDialog::pixmap

(

)

const

Returns the pixmap that appears next to the prompt in the dialog.

Definition at line 226 of file knewpassworddialog.cpp.

QString KNewPasswordDialog::prompt

(

)

const

Returns the password prompt.

Definition at line 213 of file knewpassworddialog.cpp.

int KNewPasswordDialog::reasonablePasswordLength

(

)

const

Password length that is expected to be reasonably safe.

Definition at line 326 of file knewpassworddialog.cpp.

void KNewPasswordDialog::setAllowEmptyPasswords

(

bool

allowed

)

Allow empty passwords? - Default: true.

same as setMinimumPasswordLength( allowed ? 0 : 1 )

Definition at line 276 of file knewpassworddialog.cpp.

void KNewPasswordDialog::setMaximumPasswordLength

(

int

maxLength

)

Maximum acceptable password length.

Parameters

maxLength

The new maximum password length.

Definition at line 299 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 288 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 332 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 219 of file knewpassworddialog.cpp.

void KNewPasswordDialog::setPrompt

(

const QString &

prompt

)

Sets the password prompt.

Definition at line 207 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 312 of file knewpassworddialog.cpp.

---

The documentation for this class was generated from the following files:

• knewpassworddialog.h
• knewpassworddialog.cpp