• Skip to content
  • Skip to link menu
KDE 4.3 API Reference
  • KDE API Reference
  • kdelibs
  • Sitemap
  • Contact Us
 

KDEUI

KNewPasswordDialog Class Reference

A password input dialog. More...

#include <knewpassworddialog.h>

Inheritance diagram for KNewPasswordDialog:
KDialog QDialog

List of all members.

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.

kpassworddialog.png

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() );
Author:
Geert Jansen <jansen@kde.org>
Olivier Goffart <ogoffart@kde.org>

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]

For internal use only.

Definition at line 265 of file knewpassworddialog.cpp.

bool KNewPasswordDialog::allowEmptyPasswords (  )  const

Allow empty passwords?

Returns:
true if minimumPasswordLength() == 0

Definition at line 284 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 232 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 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:
  • knewpassworddialog.h
  • knewpassworddialog.cpp

KDEUI

Skip menu "KDEUI"
  • Main Page
  • Modules
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

kdelibs

Skip menu "kdelibs"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • Kate
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • kio
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • KPty
  • Kross
  • KUtils
  • Nepomuk
  • Plasma
  • Solid
  • Sonnet
  • ThreadWeaver
Generated for kdelibs by doxygen 1.6.1
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal