k3passworddialog.h

Go to the documentation of this file.

// vi: ts=8 sts=4 sw=4
/* This file is part of the KDE libraries
   Copyright (C) 1998 Pietro Iglio <iglio@fub.it>
   Copyright (C) 1999,2000 Geert Jansen <jansen@kde.org>
   Copyright (C) 2004,2005 Andrew Coles <andrew_coles@yahoo.co.uk>

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License version 2 as published by the Free Software Foundation.

   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public License
   along with this library; see the file COPYING.LIB.  If not, write to
   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301, USA.
*/
#ifndef K3PASSWORDDIALOG_H
#define K3PASSWORDDIALOG_H

#include <kde3support_export.h>
#include <kdialog.h>

#include <QtGui/QLineEdit>

class QLabel;
class QGridLayout;
class QWidget;

class KDE3SUPPORT_EXPORT K3PasswordEdit
    : public QLineEdit
{
    Q_OBJECT

public:
    enum EchoModes { OneStar, ThreeStars, NoEcho };

    explicit K3PasswordEdit(QWidget *parent=0);
    // KDE4: either of the two must go! add default values for parameters

    explicit K3PasswordEdit(EchoMode echoMode, QWidget *parent = 0);

    explicit K3PasswordEdit(EchoModes echoMode, QWidget *parent = 0);

    ~K3PasswordEdit();

    const char *password() const;

    void erase();

    static const int PassLen;

    void setMaxPasswordLength(int newLength);

    int maxPasswordLength() const;

public Q_SLOTS:
    virtual void insert( const QString &);

protected:
    virtual void keyPressEvent(QKeyEvent *);
    virtual void focusInEvent(QFocusEvent *e);
    virtual bool event(QEvent *e);

private:
    void init();
    void showPass();

    char *m_Password;
    int m_EchoMode, m_Length;
};


class KDE3SUPPORT_EXPORT K3PasswordDialog
    : public KDialog
{
    Q_OBJECT

public:
    enum Types {
        Password,

        NewPassword
    };

    K3PasswordDialog(Types type, bool enableKeep, ButtonCodes extraBttn, QWidget *parent=0);


    K3PasswordDialog(Types type, bool enableKeep, ButtonCodes extraBttn, const QString& iconName,
                    QWidget *parent = 0);

    virtual ~K3PasswordDialog();

    void setPrompt(const QString &prompt);

    QString prompt() const;

    void addLine(const QString &key, const QString &value);

    void setAllowEmptyPasswords(bool allowed);

    bool allowEmptyPasswords() const;

    void setMinimumPasswordLength(int minLength);

    int minimumPasswordLength() const;

    void setMaximumPasswordLength(int maxLength);

    int maximumPasswordLength() const;

    void setReasonablePasswordLength(int reasonableLength);

    int reasonablePasswordLength() const;

    void setPasswordStrengthWarningLevel(int warningLevel);

    int passwordStrengthWarningLevel() const;

    const char *password() const;

    void clearPassword();

    bool keep() const;

    static int getPassword(QWidget *parent, QByteArray &password, const QString &caption, const QString &prompt, bool *keep = 0L);

    static KDE_DEPRECATED int getPassword(QWidget *parent, QByteArray &password, const QString &prompt, int *keep = 0L);

    static int getNewPassword(QWidget *parent, QByteArray &password, const QString &caption, const QString &prompt);

    static KDE_DEPRECATED int getNewPassword(QWidget *parent, QByteArray &password, const QString &prompt);

    static void disableCoreDumps();
    
    virtual void accept();

protected Q_SLOTS:
    void slotKeep(bool);

protected:

    virtual bool checkPassword(const char *password);


private Q_SLOTS:
  void enableOkBtn();

private:
    void init();
    void erase();

    int m_Keep, m_Type, m_Row;
    QLabel *m_pHelpLbl;
    QGridLayout *m_pGrid;
    QWidget *m_pMain;
    K3PasswordEdit *m_pEdit, *m_pEdit2;

private:
    class K3PasswordDialogPrivate;
    K3PasswordDialogPrivate* const d;
};

#endif // K3PasswordDialog_H