KDE 4.9 PyKDE API Reference

- KDE's Python API

# KNewPasswordDialog Class Reference

`from PyKDE4.kdeui import *`

Inherits: KDialog → QDialog → QWidget → QObject

## Detailed Description

A password input dialog.

This dialog asks the user to enter a new password.

The password has to be entered twice to check if the passwords match. A hint about the strength of the entered password is also shown.

Usage Example

      KNewPasswordDialog *dlg = new KNewPasswordDialog( parent );
      dlg->setPrompt( i18n( "Enter a password" ) );
      connect( dlg, SIGNAL( newPassword(QString) )  , this, SLOT( setPassword(QString) ) );
      connect( dlg, SIGNAL( rejected() )  , this, SLOT( slotCancel() ) );
      dlg->show();

      KNewPasswordDialog dlg( parent );
      dlg.setPrompt( i18n( "Enter a password" ) );
      if( dlg.exec() )
          setPassword( dlg.password() );

"KDE New Password Dialog"

Author:
  Geert Jansen <jansen@kde.org>

Author:
  Olivier Goffart <ogoffart@kde.org>

## Signals
| newPassword (QString password)
## Methods
| __init__ (self, QWidget parent=0)
| accept (self)
bool | allowEmptyPasswords (self)
bool | checkAndGetPassword (self, QString pwd)
bool | checkPassword (self, QString a0)
int | maximumPasswordLength (self)
int | minimumPasswordLength (self)
QString | password (self)
int | passwordStrengthWarningLevel (self)
QPixmap | pixmap (self)
QString | prompt (self)
int | reasonablePasswordLength (self)
| setAllowEmptyPasswords (self, bool allowed)
| setMaximumPasswordLength (self, int maxLength)
| setMinimumPasswordLength (self, int minLength)
| setPasswordStrengthWarningLevel (self, int warningLevel)
| setPixmap (self, QPixmap a0)
| setPrompt (self, QString prompt)
| setReasonablePasswordLength (self, int reasonableLength)

## Signal Documentation

newPassword | ( | QString | password
| ) |  |  |

The dialog has been accepted, and the new password is password

Signal syntax:
  `QObject.connect(source, SIGNAL("newPassword(const QString&)"), target_slot)`

## Method Documentation

__init__ | ( | self, |
|  | QWidget | parent=0
| ) |  |  |

Constructs a password dialog.

Parameters:

  | parent | Passed to lower level constructor.

accept | ( |  | self ) |

Internal:

bool allowEmptyPasswords | ( |  | self ) |

Allow empty passwords?

Returns:
  true if minimumPasswordLength() == 0

bool checkAndGetPassword | ( | self, |
|  | QString | pwd
| ) |  |  |

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

bool checkPassword | ( | self, |
|  | QString | a0
| ) |  |  |

Virtual function that can be overridden to provide password checking in derived classes. It should return true if the password is valid, false otherwise.

int maximumPasswordLength | ( |  | self ) |

Maximum acceptable password length.

int minimumPasswordLength | ( |  | self ) |

Minimum acceptable password length.

QString password | ( |  | self ) |

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()

int passwordStrengthWarningLevel | ( |  | self ) |

Password strength level below which a warning is given

QPixmap pixmap | ( |  | self ) |

Returns the pixmap that appears next to the prompt in the dialog

QString prompt | ( |  | self ) |

Returns the password prompt.

int reasonablePasswordLength | ( |  | self ) |

Password length that is expected to be reasonably safe.

setAllowEmptyPasswords | ( | self, |
|  | bool | allowed
| ) |  |  |

Allow empty passwords? - Default: true

same as setMinimumPasswordLength( allowed ? 0 : 1 )

setMaximumPasswordLength | ( | self, |
|  | int | maxLength
| ) |  |  |

Maximum acceptable password length.

Parameters:

  | maxLength | The new maximum password length.

setMinimumPasswordLength | ( | self, |
|  | int | minLength
| ) |  |  |

Minimum acceptable password length.

Default: 0

Parameters:

  | minLength | The new minimum password length

setPasswordStrengthWarningLevel | ( | self, |
|  | 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.

setPixmap | ( | self, |
|  | QPixmap | a0
| ) |  |  |

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

setPrompt | ( | self, |
|  | QString | prompt
| ) |  |  |

Sets the password prompt.

setReasonablePasswordLength | ( | self, |
|  | 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.