class KPasswordDialog

A password input dialog. More...

Definition#include <kpassdlg.h>
InheritsKDialogBase
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Types

Public Methods

Public Static Methods

Protected Methods

Protected Slots


Detailed Description

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

Usage example


 QCString password;
 int result = KPasswordDialog::getPassword(password, i18n("Password"));
 if (result == KPasswordDialog::Accepted)
     use(password);

Security notes

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

void  setPrompt (QString prompt)

Set the password prompt.

void  addLine (QString key, QString value)

Add a line of information to the dialog.

const char * password ()

[const]

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

bool  keep ()

[const]

Returns true if the user wants to keep the password.

int  getPassword (QCString &password, QString 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.

int  getNewPassword (QCString &password, QString 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.

void  disableCoreDumps ()

[static]

Static helper funtion that disables core dumps.

bool  checkPassword (const char *)

[protected virtual]

Virtual function that can be overridden to provide password checking in derived classes.