kpassdlg.h

/* 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 __KPassDlg_h_included__
#define __KPassDlg_h_included__
 
#include <tqstring.h>
#include <tqlineedit.h>
#include <kdialogbase.h>
 
class TQLabel;
class TQGridLayout;
class TQWidget;

 
class TDEUI_EXPORT KPasswordEdit
    : public TQLineEdit
{
    TQ_OBJECT
 
public:
    enum EchoModes { OneStar, ThreeStars, NoEcho };

    KPasswordEdit(TQWidget *parent=0, const char *name=0);
    // KDE4: either of the two must go! add default values for parameters

    KPasswordEdit(EchoMode echoMode, TQWidget *parent, const char *name);

    KPasswordEdit(EchoModes echoMode, TQWidget *parent, const char *name);

    KPasswordEdit(TQWidget *parent, const char *name, int echoMode) TDE_DEPRECATED;

    ~KPasswordEdit();

    TQString password() const;

    void erase();
 
    static const int PassLen;

    void setMaxPasswordLength(int newLength);

    int maxPasswordLength() const;
 
public slots:
    virtual void insert( const TQString &);
 
protected:
    virtual void keyPressEvent(TQKeyEvent *);
    virtual void focusInEvent(TQFocusEvent *e);
    virtual bool event(TQEvent *e);
 
private:
    void init();
};
 

 
class TDEUI_EXPORT KPasswordDialog
    : public KDialogBase
{
    TQ_OBJECT
 
public:
    enum Types {
        Password,

        NewPassword
    };

    KPasswordDialog(Types type, bool enableKeep, int extraBttn,
                    TQWidget *parent=0, const char *name=0);

    KPasswordDialog(int type, TQString prompt, bool enableKeep=false,
                    int extraBttn=0) TDE_DEPRECATED;
    // note that this implicitly deprecates the 'prompt' variants of
    // getPassword() below. i guess the above constructor needs to be extended.

    KPasswordDialog(Types type, bool enableKeep, int extraBttn, const TQString& iconName,
                    TQWidget *parent = 0, const char *name = 0);

    virtual ~KPasswordDialog();

    void setPrompt(TQString prompt);

    TQString prompt() const;

    void setKeepWarning(TQString warn);

    void addLine(TQString key, TQString 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;

    TQString password() const { return m_pEdit->password(); }

    void clearPassword();

    bool keep() const { return m_Keep; }

    static int getPassword(TQString &password, TQString prompt, int *keep=0L);

    static int getNewPassword(TQString &password, TQString prompt);

    static void disableCoreDumps();
 
protected slots:
    void slotOk();
    void slotCancel();
    void slotKeep(bool);
    void slotLayout();
 
protected:

    virtual bool checkPassword(const TQString&) { return true; }
 
private slots:
  void enableOkBtn();
 
private:
    void init();
    void erase();
 
    int m_Keep;
    int m_Type;
    int m_Row;
    TQLabel *m_pHelpLbl;
    TQLabel *m_keepWarnLbl;
    TQGridLayout *m_pGrid;
    TQWidget *m_pMain;
    KPasswordEdit *m_pEdit;
    KPasswordEdit *m_pEdit2;
 
protected:
    virtual void virtual_hook( int id, void* data );
private:
    class KPasswordDialogPrivate;
    KPasswordDialogPrivate* const d;
};
 
 
#endif // __KPassDlg_h_included__