KNewPasswordWidget Class

KNewPasswordWidget *m_passwordWidget = new KNewPasswordWidget(this);
// set a background warning color (taken from the current color scheme)
KColorScheme colorScheme(QPalette::Active, KColorScheme::View);
m_passwordWidget->setBackgroundWarningColor(colorScheme.background(KColorScheme::NegativeBackground).color());
// listen to password status updates
connect(m_passwordWidget, &KNewPasswordWidget::passwordStatusChanged, this, &MyCustomDialog::slotPasswordStatusChanged);
...

Member Function Documentation

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

Constructs a password widget.

parent Passed to lower level constructor.

bool KNewPasswordWidget::allowEmptyPasswords() const

Allow empty passwords?

Returns true if minimumPasswordLength() == 0

See also setAllowEmptyPasswords().

QColor KNewPasswordWidget::backgroundWarningColor() const

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

See also setBackgroundWarningColor().

bool KNewPasswordWidget::isPasswordStrengthMeterVisible() const

Whether the password strength meter is visible.

int KNewPasswordWidget::maximumPasswordLength() const

Maximum acceptable password length.

See also setMaximumPasswordLength().

int KNewPasswordWidget::minimumPasswordLength() const

Minimum acceptable password length.

See also setMinimumPasswordLength().

QString KNewPasswordWidget::password() const

Returns the password entered.

KNewPasswordWidget::PasswordStatus KNewPasswordWidget::passwordStatus() const

The current status of the password in the widget.

[signal] void KNewPasswordWidget::passwordStatusChanged()

Notify about the current status of the password being typed.

int KNewPasswordWidget::passwordStrengthWarningLevel() const

Password strength level below which a warning is given

See also setPasswordStrengthWarningLevel().

int KNewPasswordWidget::reasonablePasswordLength() const

Password length that is expected to be reasonably safe.

See also setReasonablePasswordLength().

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

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

This function was introduced in 6.0.

See also setRevealPasswordMode().

[slot] void KNewPasswordWidget::setAllowEmptyPasswords(bool allowed)

Allow empty passwords? - Default: true

same as setMinimumPasswordLength( allowed ? 0 : 1 )

See also allowEmptyPasswords().

[slot] void KNewPasswordWidget::setBackgroundWarningColor(const QColor &color)

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

See also backgroundWarningColor().

[slot] void KNewPasswordWidget::setMaximumPasswordLength(int maxLength)

Maximum acceptable password length.

maxLength The new maximum password length.

See also maximumPasswordLength().

[slot] void KNewPasswordWidget::setMinimumPasswordLength(int minLength)

Minimum acceptable password length.

Default: 0

minLength The new minimum password length

See also minimumPasswordLength().

[slot] void KNewPasswordWidget::setPasswordStrengthMeterVisible(bool visible)

Whether to show the password strength meter (label and progress bar). Default is true.

See also isPasswordStrengthMeterVisible().

[slot] void KNewPasswordWidget::setPasswordStrengthWarningLevel(int warningLevel)

Set the password strength level below which a warning is given The value is guaranteed to be in the range from 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().

[slot] void KNewPasswordWidget::setReasonablePasswordLength(int reasonableLength)

Password length that is expected to be reasonably safe. The value is guaranteed to be in the range from 1 to maximumPasswordLength().

Used to compute the strength level

Default: 8 - the standard UNIX password length

reasonableLength The new reasonable password length.

See also reasonablePasswordLength().

[slot, since 6.0] void KNewPasswordWidget::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"))) {
    newPasswordWidget.setRevealPasswordMode(KPassword::RevealMode::OnlyNew);
} else {
    newPasswordWidget.setRevealPasswordMode(KPassword::RevealMode::Never);
}

This function was introduced in 6.0.

See also revealPasswordMode().