KNewPasswordDialog Class

KNewPasswordDialog *dlg = new KNewPasswordDialog( parent );
dlg->setPrompt(i18n("Enter a password"));
connect(dlg, &KNewPasswordDialog::newPassword, this, [this](const QString &pass) { setPassword(pass); });
connect(dlg, &QDialog::rejected, this, [this]() { slotCancel(); });
dlg->show();

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

Member Function Documentation

[explicit] KNewPasswordDialog::KNewPasswordDialog(QWidget *parent = nullptr)

Constructs a password dialog.

parent Passed to lower level constructor.

bool KNewPasswordDialog::allowEmptyPasswords() const

Allow empty passwords?

Returns true if minimumPasswordLength() == 0

See also setAllowEmptyPasswords().

[since 5.17] QColor KNewPasswordDialog::backgroundWarningColor() const

The color used as warning for the verification password field's background.

This function was introduced in 5.17.

See also setBackgroundWarningColor().

[protected, since 4.2] bool KNewPasswordDialog::checkAndGetPassword(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.

This function was introduced in 4.2.

[virtual protected] bool KNewPasswordDialog::checkPassword(const QString &)

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

[since 5.63] QIcon KNewPasswordDialog::icon() const

Returns the icon that appears next to the prompt in the dialog. The default icon represents a simple key.

This function was introduced in 5.63.

See also setIcon().

int KNewPasswordDialog::maximumPasswordLength() const

Maximum acceptable password length.

See also setMaximumPasswordLength().

int KNewPasswordDialog::minimumPasswordLength() const

Minimum acceptable password length.

See also setMinimumPasswordLength().

[signal] void KNewPasswordDialog::newPassword(const QString &password)

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

QString KNewPasswordDialog::password() const

Returns the password entered.

int KNewPasswordDialog::passwordStrengthWarningLevel() const

Password strength level below which a warning is given

See also setPasswordStrengthWarningLevel().

QString KNewPasswordDialog::prompt() const

Returns the password prompt.

See also setPrompt().

int KNewPasswordDialog::reasonablePasswordLength() const

Password length that is expected to be reasonably safe.

See also setReasonablePasswordLength().

[since 6.0] int KNewPasswordDialog::revealPasswordMode() const

Whether the visibility trailing action in the line edit is visible.

This function was introduced in 6.0.

See also setRevealPasswordMode().

void KNewPasswordDialog::setAllowEmptyPasswords(bool allowed)

Allow empty passwords? - Default: true

same as setMinimumPasswordLength( allowed ? 0 : 1 )

See also allowEmptyPasswords().

[since 5.17] void KNewPasswordDialog::setBackgroundWarningColor(const QColor &color)

When the verification password does not match, the background color of the verification field is set to color. As soon as the passwords match, the original color of the verification field is restored.

Default: the background color from the current theme.

This function was introduced in 5.17.

See also backgroundWarningColor().

[since 5.63] void KNewPasswordDialog::setIcon(const QIcon &icon)

Sets the icon that appears next to the prompt in the dialog. The default icon represents a simple key.

This function was introduced in 5.63.

See also icon().

void KNewPasswordDialog::setMaximumPasswordLength(int maxLength)

Maximum acceptable password length.

maxLength The new maximum password length.

See also maximumPasswordLength().

void KNewPasswordDialog::setMinimumPasswordLength(int minLength)

Minimum acceptable password length.

Default: 0

minLength The new minimum password length

See also minimumPasswordLength().

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 discernible strength whatsoever

warningLevel The level below which a warning should be given.

See also passwordStrengthWarningLevel().

void KNewPasswordDialog::setPrompt(const QString &prompt)

Sets the password prompt.

See also prompt().

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

reasonableLength The new reasonable password length.

See also reasonablePasswordLength().

[since 6.0] void KNewPasswordDialog::setRevealPasswordMode(int revealPasswordMode)

Set when the reveal password button will be visible.

The default is RevealPasswordMode::OnlyNew and the reveal password button will only be visible when entering a new password.

This can be used to honor the lineedit_reveal_password kiosk key, for example:

if (KAuthorized::authorize(QStringLiteral("lineedit_reveal_password"))) {
    newPasswordDialog.setRevealPasswordMode(KPassword::RevealMode::OnlyNew);
} else {
    newPasswordDialog.setRevealPasswordMode(KPassword::RevealMode::Never);
}

This function was introduced in 6.0.

See also revealPasswordMode().