certmanager/lib

keyselectiondialog.h

00001 /*  -*- c++ -*-
00002     keyselectiondialog.h
00003 
00004     This file is part of libkleopatra, the KDE keymanagement library
00005     Copyright (c) 2004 Klarävdalens Datakonsult AB
00006 
00007     Based on kpgpui.h
00008     Copyright (C) 2001,2002 the KPGP authors
00009     See file libkdenetwork/AUTHORS.kpgp for details
00010 
00011     Libkleopatra is free software; you can redistribute it and/or
00012     modify it under the terms of the GNU General Public License as
00013     published by the Free Software Foundation; either version 2 of the
00014     License, or (at your option) any later version.
00015 
00016     Libkleopatra is distributed in the hope that it will be useful,
00017     but WITHOUT ANY WARRANTY; without even the implied warranty of
00018     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00019     General Public License for more details.
00020 
00021     You should have received a copy of the GNU General Public License
00022     along with this program; if not, write to the Free Software
00023     Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
00024 
00025     In addition, as a special exception, the copyright holders give
00026     permission to link the code of this program with any edition of
00027     the Qt library by Trolltech AS, Norway (or with modified versions
00028     of Qt that use the same license as Qt), and distribute linked
00029     combinations including the two.  You must obey the GNU General
00030     Public License in all respects for all of the code used other than
00031     Qt.  If you modify this file, you may extend this exception to
00032     your version of the file, but you are not obligated to do so.  If
00033     you do not wish to do so, delete this exception statement from
00034     your version.
00035 */
00036 
00037 #ifndef __KLEO_UI_KEYSELECTIONDIALOG_H__
00038 #define __KLEO_UI_KEYSELECTIONDIALOG_H__
00039 
00040 #include <kdialogbase.h>
00041 
00042 #include <kleo/cryptobackend.h>
00043 #include <gpgmepp/key.h>
00044 #include <kdepimmacros.h>
00045 #include <vector>
00046 
00047 class QVBoxLayout;
00048 class QCheckBox;
00049 class QPixmap;
00050 class QTimer;
00051 class QListViewItem;
00052 class QRegExp;
00053 class QPoint;
00054 
00055 namespace Kleo {
00056   class KeyListView;
00057   class KeyListViewItem;
00058 }
00059 
00060 namespace GpgME {
00061   class KeyListResult;
00062 }
00063 
00064 namespace Kleo {
00065 
00066   class KDE_EXPORT KeySelectionDialog : public KDialogBase {
00067     Q_OBJECT
00068   public:
00069 
00070     enum KeyUsage {
00071       PublicKeys = 1,
00072       SecretKeys = 2,
00073       EncryptionKeys = 4,
00074       SigningKeys = 8,
00075       ValidKeys = 16,
00076       TrustedKeys = 32,
00077       CertificationKeys = 64,
00078       AuthenticationKeys = 128,
00079       OpenPGPKeys = 256,
00080       SMIMEKeys = 512,
00081       AllKeys = PublicKeys | SecretKeys | OpenPGPKeys | SMIMEKeys,
00082       ValidEncryptionKeys = AllKeys | EncryptionKeys | ValidKeys,
00083       ValidTrustedEncryptionKeys = AllKeys | EncryptionKeys | ValidKeys | TrustedKeys
00084     };
00085 
00086     KeySelectionDialog( const QString & title,
00087                         const QString & text,
00088             const std::vector<GpgME::Key> & selectedKeys=std::vector<GpgME::Key>(),
00089                         unsigned int keyUsage=AllKeys,
00090                         bool extendedSelection=false,
00091             bool rememberChoice=false,
00092                         QWidget * parent=0, const char * name=0,
00093                         bool modal=true );
00094     KeySelectionDialog( const QString & title,
00095                         const QString & text,
00096                         const QString & initialPattern,
00097             const std::vector<GpgME::Key> & selectedKeys,
00098                         unsigned int keyUsage=AllKeys,
00099                         bool extendedSelection=false,
00100             bool rememberChoice=false,
00101                         QWidget * parent=0, const char * name=0,
00102                         bool modal=true );
00103     KeySelectionDialog( const QString & title,
00104                         const QString & text,
00105             const QString & initialPattern,
00106                         unsigned int keyUsage=AllKeys,
00107                         bool extendedSelection=false,
00108             bool rememberChoice=false,
00109                         QWidget * parent=0, const char * name=0,
00110                         bool modal=true );
00111     ~KeySelectionDialog();
00112 
00115     const GpgME::Key & selectedKey() const;
00116 
00117     QString fingerprint() const;
00118 
00120     const std::vector<GpgME::Key> & selectedKeys() const { return mSelectedKeys; }
00121 
00123     QStringList fingerprints() const;
00124 
00126     QStringList pgpKeyFingerprints() const;
00128     QStringList smimeFingerprints() const;
00129 
00130     bool rememberSelection() const;
00131   protected slots:
00132     // reimplemented to avoid popping up the help, since we
00133     // override the button
00134     void slotHelp();
00135 
00136     // Could be used by derived classes to insert their own widget
00137     QVBoxLayout* topLayout() const { return mTopLayout; }
00138 
00139   private slots:
00140     void slotRereadKeys();
00141     void slotStartCertificateManager( const QString &query = QString() );
00142     void slotStartSearchForExternalCertificates() {
00143       slotStartCertificateManager( mInitialQuery );
00144     }
00145     void slotKeyListResult( const GpgME::KeyListResult & );
00146     void slotSelectionChanged();
00147     void slotCheckSelection() { slotCheckSelection( 0 ); }
00148     void slotCheckSelection( Kleo::KeyListViewItem * );
00149     void slotRMB( Kleo::KeyListViewItem *, const QPoint & );
00150     void slotRecheckKey();
00151     void slotTryOk();
00152     void slotOk();
00153     void slotCancel();
00154     void slotSearch( const QString & text );
00155     void slotSearch();
00156     void slotFilter();
00157 
00158   private:
00159     void filterByKeyID( const QString & keyID );
00160     void filterByKeyIDOrUID( const QString & keyID );
00161     void filterByUID( const QString & uid );
00162     void showAllItems();
00163     bool anyChildMatches( const Kleo::KeyListViewItem * item, QRegExp & rx ) const;
00164 
00165     void connectSignals();
00166     void disconnectSignals();
00167 
00168     void startKeyListJobForBackend( const Kleo::CryptoBackend::Protocol *, const std::vector<GpgME::Key> &, bool );
00169     void startValidatingKeyListing();
00170 
00171     void init( bool, bool, const QString &, const QString & );
00172 
00173   private:
00174     QVBoxLayout* mTopLayout;
00175     Kleo::KeyListView * mKeyListView;
00176     const Kleo::CryptoBackend::Protocol * mOpenPGPBackend;
00177     const Kleo::CryptoBackend::Protocol * mSMIMEBackend;
00178     QCheckBox * mRememberCB;
00179     std::vector<GpgME::Key> mSelectedKeys, mKeysToCheck;
00180     unsigned int mKeyUsage;
00181     QTimer * mCheckSelectionTimer;
00182     QTimer * mStartSearchTimer;
00183     // cross-eventloop temporaries:
00184     QString mSearchText;
00185     const QString mInitialQuery;
00186     Kleo::KeyListViewItem * mCurrentContextMenuItem;
00187     int mTruncated, mListJobCount, mSavedOffsetY;
00188   };
00189 
00190 }
00191 
00192 #endif // __KLEO_UI_KEYSELECTIONDIALOG_H__
KDE Home | KDE Accessibility Home | Description of Access Keys