• Skip to content
  • Skip to link menu
Trinity API Reference
  • Trinity API Reference
  • kdeui
 

kdeui

Public Types | Public Member Functions | Static Public Member Functions | Protected Slots | Protected Member Functions
KPasswordDialog Class Reference

#include <kpassdlg.h>

Inheritance diagram for KPasswordDialog:
KDialogBase KDialog

List of all members.

Public Types

enum  Types { Password, NewPassword }

Public Member Functions

 KPasswordDialog (Types type, bool enableKeep, int extraBttn, TQWidget *parent=0, const char *name=0)
 KPasswordDialog (int type, TQString prompt, bool enableKeep=false, int extraBttn=0) KDE_DEPRECATED
 KPasswordDialog (Types type, bool enableKeep, int extraBttn, const TQString &iconName, TQWidget *parent=0, const char *name=0)
virtual ~KPasswordDialog ()
void setPrompt (TQString prompt)
TQString prompt () const
void setKeepWarning (TQString warn)
void addLine (TQString key, TQString value)
void setAllowEmptyPasswords (bool allowed)
bool allowEmptyPasswords () const
void setMinimumPasswordLength (int minLength)
int minimumPasswordLength () const
void setMaximumPasswordLength (int maxLength)
int maximumPasswordLength () const
void setReasonablePasswordLength (int reasonableLength)
int reasonablePasswordLength () const
void setPasswordStrengthWarningLevel (int warningLevel)
int passwordStrengthWarningLevel () const
const char * password () const
void clearPassword ()
bool keep () const

Static Public Member Functions

static int getPassword (TQCString &password, TQString prompt, int *keep=0L)
static int getNewPassword (TQCString &password, TQString prompt)
static void disableCoreDumps ()

Protected Slots

void slotOk ()
void slotCancel ()
void slotKeep (bool)
void slotLayout ()

Protected Member Functions

virtual bool checkPassword (const char *)
virtual void virtual_hook (int id, void *data)

Detailed Description

A password input dialog.

This dialog asks the user to enter a password. The functions you're probably interested in are the static methods, getPassword() and getNewPassword().

Usage example

 TQCString password;
 int result = KPasswordDialog::getPassword(password, i18n("Prompt message"));
 if (result == KPasswordDialog::Accepted)
     use(password);
kpassworddialog.png
KDE Password Dialog

Security notes:

Keeping passwords in memory can be a potential security hole. You should handle this situation with care.

  • You may want to use disableCoreDump() to disable core dumps. Core dumps are dangerous because they are an image of the process memory, and thus include any passwords that were in memory.
  • You should delete passwords as soon as they are not needed anymore. The functions getPassword() and getNewPassword() return the password as a TQCString. I believe this is safer than a TQString. A QString stores its characters internally as 16-bit wide values, so conversions are needed, both for creating the TQString and by using it. The temporary memory used for these conversion is probably not erased. This could lead to stray passwords in memory, even if you think you erased all of them.
Author:
Geert Jansen <jansen@kde.org>

Definition at line 166 of file kpassdlg.h.


Member Enumeration Documentation

enum KPasswordDialog::Types

This enum distinguishes the two operation modes of this dialog:

Enumerator:
Password 

The user is asked to enter a password.

NewPassword 

The user is asked to enter a password and to confirm it a second time.

This is usually used when the user changes his password.

Definition at line 175 of file kpassdlg.h.


Constructor & Destructor Documentation

KPasswordDialog::KPasswordDialog ( Types  type,
bool  enableKeep,
int  extraBttn,
TQWidget *  parent = 0,
const char *  name = 0 
)

Constructs a password dialog.

Parameters:
type,:if NewPassword is given here, the dialog contains two input fields, so that the user must confirm his password and possible typos are detected immediately.
enableKeep,:if true, a check box is shown in the dialog which allows the user to keep his password input for later.
extraBttn,:allows to show additional buttons, KDialogBase.
parentPassed to lower level constructor.
namePassed to lower level constructor
Since:
3.0

Definition at line 306 of file kpassdlg.cpp.

KPasswordDialog::KPasswordDialog ( int  type,
TQString  prompt,
bool  enableKeep = false,
int  extraBttn = 0 
)
Deprecated:
Variant of the previous constructor without the possibility to specify a parent.

Will be removed in KDE 4.0

Definition at line 327 of file kpassdlg.cpp.

KPasswordDialog::KPasswordDialog ( Types  type,
bool  enableKeep,
int  extraBttn,
const TQString &  iconName,
TQWidget *  parent = 0,
const char *  name = 0 
)

Construct a password dialog.

Essentially the same as above but allows the icon in the password dialog to be set via iconName.

Parameters:
typeif NewPassword is given here, the dialog contains two input fields, so that the user must confirm his password and possible typos are detected immediately
enableKeep,:if true, a check box is shown in the dialog which allows the user to keep his password input for later.
extraBttn,:allows to show additional buttons.
iconNamethe name of the icon to be shown in the dialog. If empty, a default icon is used
parentPassed to lower level constructor.
namePassed to lower level constructor
Since:
3.3

Definition at line 315 of file kpassdlg.cpp.

KPasswordDialog::~KPasswordDialog ( ) [virtual]

Destructs the password dialog.

Definition at line 469 of file kpassdlg.cpp.


Member Function Documentation

void KPasswordDialog::addLine ( TQString  key,
TQString  value 
)

Adds a line of information to the dialog.

Definition at line 503 of file kpassdlg.cpp.

bool KPasswordDialog::allowEmptyPasswords ( ) const

Allow empty passwords?

Since:
3.4

Definition at line 700 of file kpassdlg.cpp.

virtual bool KPasswordDialog::checkPassword ( const char *  ) [inline, 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 397 of file kpassdlg.h.

void KPasswordDialog::clearPassword ( )

Clears the password input field.

You might want to use this after the user failed to enter the correct password.

Since:
3.3

Definition at line 475 of file kpassdlg.cpp.

void KPasswordDialog::disableCoreDumps ( ) [static]

Static helper function that disables core dumps.

Definition at line 618 of file kpassdlg.cpp.

int KPasswordDialog::getNewPassword ( TQCString &  password,
TQString  prompt 
) [static]

Pops up the dialog, asks the user for a password and returns it.

The user has to enter the password twice to make sure it was entered correctly.

Parameters:
passwordThe password is returned in this reference parameter.
promptA prompt for the password. This can be a few lines of information. The text is word broken to fit nicely in the dialog.
Returns:
Result code: Accepted or Rejected.

Definition at line 606 of file kpassdlg.cpp.

int KPasswordDialog::getPassword ( TQCString &  password,
TQString  prompt,
int *  keep = 0L 
) [static]

Pops up the dialog, asks the user for a password, and returns it.

Parameters:
passwordThe password is returned in this reference parameter.
promptA prompt for the password. This can be a few lines of information. The text is word broken to fit nicely in the dialog.
keepEnable/disable a checkbox controlling password keeping. If you pass a null pointer, or a pointer to the value 0, the checkbox is not shown. If you pass a pointer to a nonzero value, the checkbox is shown and the result is stored in *keep.
Returns:
Result code: Accepted or Rejected.

Definition at line 589 of file kpassdlg.cpp.

bool KPasswordDialog::keep ( ) const [inline]

Returns true if the user wants to keep the password.

Definition at line 351 of file kpassdlg.h.

int KPasswordDialog::maximumPasswordLength ( ) const

Maximum acceptable password length.

Since:
3.4

Definition at line 725 of file kpassdlg.cpp.

int KPasswordDialog::minimumPasswordLength ( ) const

Minimum acceptable password length.

Since:
3.4

Definition at line 709 of file kpassdlg.cpp.

const char* KPasswordDialog::password ( ) const [inline]

Returns the password entered.

The memory is freed in the destructor, so you should make a copy.

Definition at line 339 of file kpassdlg.h.

int KPasswordDialog::passwordStrengthWarningLevel ( ) const

Password strength level below which a warning is given.

Since:
3.4

Definition at line 751 of file kpassdlg.cpp.

TQString KPasswordDialog::prompt ( ) const

Returns the password prompt.

Definition at line 495 of file kpassdlg.cpp.

int KPasswordDialog::reasonablePasswordLength ( ) const

Password length that is expected to be reasonably safe.

Since:
3.4

Definition at line 740 of file kpassdlg.cpp.

void KPasswordDialog::setAllowEmptyPasswords ( bool  allowed)

Allow empty passwords? - Default: false.

Since:
3.4

Definition at line 694 of file kpassdlg.cpp.

void KPasswordDialog::setKeepWarning ( TQString  warn)

Sets the text to be dynamically displayed when the keep checkbox is checked.

Definition at line 487 of file kpassdlg.cpp.

void KPasswordDialog::setMaximumPasswordLength ( int  maxLength)

Maximum acceptable password length.

Limited to 199. Default: No limit, i.e. -1

Parameters:
maxLength,:The new maximum password length.
Since:
3.4

Definition at line 713 of file kpassdlg.cpp.

void KPasswordDialog::setMinimumPasswordLength ( int  minLength)

Minimum acceptable password length.

Default: If empty passwords are forbidden, 1; Otherwise, 0.

Parameters:
minLength,:The new minimum password length
Since:
3.4

Definition at line 704 of file kpassdlg.cpp.

void KPasswordDialog::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.
Since:
3.4

Definition at line 745 of file kpassdlg.cpp.

void KPasswordDialog::setPrompt ( TQString  prompt)

Sets the password prompt.

Definition at line 481 of file kpassdlg.cpp.

void KPasswordDialog::setReasonablePasswordLength ( int  reasonableLength)

Password length that is expected to be reasonably safe.

Default: 8 - the standard UNIX password length

Parameters:
reasonableLength,:The new reasonable password length.
Since:
3.4

Definition at line 731 of file kpassdlg.cpp.

void KPasswordDialog::slotCancel ( void  ) [protected, virtual, slot]

Activated when the Cancel button has been clicked.

The TQDialog::reject() is activated in regular mode and TQDialog::done( Cancel ) when in message box mode.

Reimplemented from KDialogBase.

Definition at line 561 of file kpassdlg.cpp.

void KPasswordDialog::slotOk ( void  ) [protected, virtual, slot]

Activated when the Ok button has been clicked.

The TQDialog::accept() is activated.

Reimplemented from KDialogBase.

Definition at line 530 of file kpassdlg.cpp.


The documentation for this class was generated from the following files:
  • kpassdlg.h
  • kpassdlg.cpp

kdeui

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

kdeui

Skip menu "kdeui"
  • arts
  • dcop
  • dnssd
  • interfaces
  •     interface
  •     library
  •   kspeech
  •   ktexteditor
  • kabc
  • kate
  • kcmshell
  • kdecore
  • kded
  • kdefx
  • kdeprint
  • kdesu
  • kdeui
  • kdoctools
  • khtml
  • kimgio
  • kinit
  • kio
  •   bookmarks
  •   httpfilter
  •   kfile
  •   kio
  •   kioexec
  •   kpasswdserver
  •   kssl
  • kioslave
  •   http
  • kjs
  • kmdi
  •   kmdi
  • knewstuff
  • kparts
  • krandr
  • kresources
  • kspell2
  • kunittest
  • kutils
  • kwallet
  • libkmid
  • libkscreensaver
Generated for kdeui by doxygen 1.7.6.1
This website is maintained by Timothy Pearson.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. |