Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdepim@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 227 insertions, 0 deletions

diff --git a/certmanager/lib/ui/keyrequester.h b/certmanager/lib/ui/keyrequester.h
new file mode 100644
index 000000000..3de9c508b
--- /dev/null
+++ b/certmanager/lib/ui/keyrequester.h
@@ -0,0 +1,227 @@
+/*  -*- c++ -*-
+    keyrequester.h
+
+    This file is part of libkleopatra, the KDE keymanagement library
+    Copyright (c) 2004 Klar�lvdalens Datakonsult AB
+
+    Libkleopatra is free software; you can redistribute it and/or
+    modify it under the terms of the GNU General Public License as
+    published by the Free Software Foundation; either version 2 of the
+    License, or (at your option) any later version.
+
+    Libkleopatra 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
+    General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+    In addition, as a special exception, the copyright holders give
+    permission to link the code of this program with any edition of
+    the Qt library by Trolltech AS, Norway (or with modified versions
+    of Qt that use the same license as Qt), and distribute linked
+    combinations including the two.  You must obey the GNU General
+    Public License in all respects for all of the code used other than
+    Qt.  If you modify this file, you may extend this exception to
+    your version of the file, but you are not obligated to do so.  If
+    you do not wish to do so, delete this exception statement from
+    your version.
+
+
+    Based on kpgpui.h
+    Copyright (C) 2001,2002 the KPGP authors
+    See file libkdenetwork/AUTHORS.kpgp for details
+
+    This file is part of KPGP, the KDE PGP/GnuPG support library.
+
+    KPGP is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, write to the Free Software Foundation,
+    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
+ */
+
+#ifndef __KLEO_UI_KEYREQUESTER_H__
+#define __KLEO_UI_KEYREQUESTER_H__
+
+#include <qwidget.h>
+#include <kleo/cryptobackend.h>
+
+#include <vector>
+#include <kdepimmacros.h>
+
+namespace Kleo {
+  class KeyListView;
+  class KeyListViewItem;
+}
+
+namespace GpgME {
+  class Key;
+  class KeyListResult;
+}
+
+class QStringList;
+class QString;
+class QPushButton;
+class QLabel;
+
+namespace Kleo {
+
+  /// Base class for SigningKeyRequester and EncryptionKeyRequester
+  class KDE_EXPORT KeyRequester : public QWidget {
+    Q_OBJECT
+  public:
+    KeyRequester( unsigned int allowedKeys, bool multipleKeys=false,
+		  QWidget * parent=0, const char * name=0 );
+    // Constructor for Qt Designer
+    KeyRequester( QWidget * parent=0, const char * name=0 );
+    ~KeyRequester();
+
+    const GpgME::Key & key() const;
+    /** Preferred method to set a key for
+	non-multi-KeyRequesters. Doesn't start a backend
+	KeyListJob.
+    */
+    void setKey( const GpgME::Key & key );
+
+    const std::vector<GpgME::Key> & keys() const;
+    /** Preferred method to set a key for multi-KeyRequesters. Doesn't
+	start a backend KeyListJob.
+    */
+    void setKeys( const std::vector<GpgME::Key> & keys );
+
+    QString fingerprint() const;
+    /** Set the key by fingerprint. Starts a background KeyListJob to
+	retrive the complete GpgME::Key object
+    */
+    void setFingerprint( const QString & fingerprint );
+
+    QStringList fingerprints() const;
+    /** Set the keys by fingerprint. Starts a background KeyListJob to
+	retrive the complete GpgME::Key objects
+    */
+    void setFingerprints( const QStringList & fingerprints );
+
+
+    QPushButton * eraseButton();
+    QPushButton * dialogButton();
+
+    void setDialogCaption( const QString & caption );
+    void setDialogMessage( const QString & message );
+
+    bool isMultipleKeysEnabled() const;
+    void setMultipleKeysEnabled( bool enable );
+
+    unsigned int allowedKeys() const;
+    void setAllowedKeys( unsigned int allowed );
+
+    void setInitialQuery( const QString & s ) { mInitialQuery = s; }
+    const QString & initialQuery() const { return mInitialQuery; }
+
+  signals:
+    void changed();
+
+  private:
+    void init();
+    void startKeyListJob( const QStringList & fingerprints );
+    void updateKeys();
+
+  private slots:
+    void slotNextKey( const GpgME::Key & key );
+    void slotKeyListResult( const GpgME::KeyListResult & result );
+    void slotDialogButtonClicked();
+    void slotEraseButtonClicked();
+
+  private:
+    const CryptoBackend::Protocol * mOpenPGPBackend;
+    const CryptoBackend::Protocol * mSMIMEBackend;
+    QLabel * mLabel;
+    QPushButton * mEraseButton;
+    QPushButton * mDialogButton;
+    QString mDialogCaption, mDialogMessage, mInitialQuery;
+    bool mMulti;
+    unsigned int mKeyUsage;
+    int mJobs;
+    std::vector<GpgME::Key> mKeys;
+    std::vector<GpgME::Key> mTmpKeys;
+
+  private:
+    class Private;
+    Private * d;
+  protected:
+    virtual void virtual_hook( int, void* );
+  };
+
+
+  class KDE_EXPORT EncryptionKeyRequester : public KeyRequester {
+    Q_OBJECT
+  public:
+    enum { OpenPGP = 1, SMIME = 2, AllProtocols = OpenPGP|SMIME };
+
+    /**
+     * Preferred constructor
+     */
+    EncryptionKeyRequester( bool multipleKeys=false, unsigned int proto=AllProtocols,
+			    QWidget * parent=0, const char * name=0,
+			    bool onlyTrusted=true, bool onlyValid=true );
+    /**
+     * Constructor for Qt designer
+     */
+    EncryptionKeyRequester( QWidget * parent=0, const char * name=0 );
+    ~EncryptionKeyRequester();
+
+    void setAllowedKeys( unsigned int proto, bool onlyTrusted=true, bool onlyValid=true );
+
+  private:
+    class Private;
+    Private * d;
+  protected:
+    virtual void virtual_hook( int, void* );
+  };
+
+
+  class KDE_EXPORT SigningKeyRequester : public KeyRequester {
+    Q_OBJECT
+  public:
+    enum { OpenPGP = 1, SMIME = 2, AllProtocols = OpenPGP|SMIME };
+
+    /**
+     * Preferred constructor
+     * @param multipleKeys whether multiple keys can be selected
+     *
+     * @param proto the allowed protocols, OpenPGP and/or SMIME
+     * @param onlyTrusted only show trusted keys
+     * @param onlyValid only show valid keys
+     */
+    SigningKeyRequester( bool multipleKeys=false, unsigned int proto=AllProtocols,
+			 QWidget * parent=0, const char * name=0,
+			 bool onlyTrusted=true, bool onlyValid=true );
+    /**
+     * Constructor for Qt designer
+     */
+    SigningKeyRequester( QWidget * parent=0, const char * name=0 );
+    ~SigningKeyRequester();
+
+    /*
+     * Those parameters affect the parameters given to the key selection dialog.
+     * @param proto the allowed protocols, OpenPGP and/or SMIME
+     * @param onlyTrusted only show trusted keys
+     * @param onlyValid only show valid keys
+     */
+    void setAllowedKeys( unsigned int proto, bool onlyTrusted=true, bool onlyValid=true );
+
+  private:
+    class Private;
+    Private * d;
+  protected:
+    virtual void virtual_hook( int, void* );
+  };
+
+}
+
+#endif // __KLEO_UI_KEYREQUESTER_H__