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

KDEUI

KNewPasswordDialog Class Reference

#include <knewpassworddialog.h>

Inheritance diagram for KNewPasswordDialog:

Inheritance graph
[legend]

List of all members.


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 63 of file 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

virtual bool checkPassword (const QString &)

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]

Destructs the password dialog.

Definition at line 172 of file knewpassworddialog.cpp.


Member Function Documentation

void KNewPasswordDialog::accept (  )  [virtual]

For internal use only.

Reimplemented from QDialog.

Definition at line 203 of file knewpassworddialog.cpp.

bool KNewPasswordDialog::allowEmptyPasswords (  )  const

Allow empty passwords?

Returns:
true if minimumPasswordLength() == 0

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

int KNewPasswordDialog::maximumPasswordLength (  )  const

Maximum acceptable password length.

Definition at line 265 of file knewpassworddialog.cpp.

int KNewPasswordDialog::minimumPasswordLength (  )  const

Minimum acceptable password length.

Definition at line 254 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.

Definition at line 308 of file knewpassworddialog.cpp.

int KNewPasswordDialog::passwordStrengthWarningLevel (  )  const

Password strength level below which a warning is given.

Definition at line 303 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

Returns the password prompt.

Definition at line 184 of file knewpassworddialog.cpp.

int KNewPasswordDialog::reasonablePasswordLength (  )  const

Password length that is expected to be reasonably safe.

Definition at line 286 of file knewpassworddialog.cpp.

void KNewPasswordDialog::setAllowEmptyPasswords ( bool  allowed  ) 

Allow empty passwords? - Default: true.

same as setMinimumPasswordLength( allowed ? 0 : 1 )

Definition at line 236 of file knewpassworddialog.cpp.

void KNewPasswordDialog::setMaximumPasswordLength ( int  maxLength  ) 

Maximum acceptable password length.

Parameters:
maxLength,: The new maximum password length.

Definition at line 259 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 248 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 292 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  ) 

Sets the password prompt.

Definition at line 178 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 272 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
  • Kross
  • KUtils
  • Nepomuk
  • Solid
  • Sonnet
  • ThreadWeaver
Generated for kdelibs by doxygen 1.5.4
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