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.

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, QString command=QString::null, 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.
commandExtra feedback to the user, telling him the command the password is intended for.
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.