QGpgME  10.3.4.0000000
Qt API for GpgME
Signals | Public Member Functions | Protected Member Functions | List of all members
QGpgME::SignEncryptJob Class Referenceabstract

An abstract base class for asynchronous combined signing and encrypting. More...

#include <signencryptjob.h>

Inheritance diagram for QGpgME::SignEncryptJob:
Inheritance graph
[legend]
Collaboration diagram for QGpgME::SignEncryptJob:
Collaboration graph
[legend]

Signals

void result (const GpgME::SigningResult &signingresult, const GpgME::EncryptionResult &encryptionresult, const QByteArray &cipherText, const QString &auditLogAsHtml=QString(), const GpgME::Error &auditLogError=GpgME::Error())
 
- Signals inherited from QGpgME::Job
void progress (const QString &what, int current, int total)
 
void done ()
 

Public Member Functions

virtual GpgME::Error start (const std::vector< GpgME::Key > &signers, const std::vector< GpgME::Key > &recipients, const QByteArray &plainText, bool alwaysTrust=false)=0
 
virtual void start (const std::vector< GpgME::Key > &signers, const std::vector< GpgME::Key > &recipients, const std::shared_ptr< QIODevice > &plainText, const std::shared_ptr< QIODevice > &cipherText=std::shared_ptr< QIODevice >(), bool alwaysTrust=false)=0
 
virtual std::pair< GpgME::SigningResult, GpgME::EncryptionResult > exec (const std::vector< GpgME::Key > &signers, const std::vector< GpgME::Key > &recipients, const QByteArray &plainText, bool alwaysTrust, QByteArray &cipherText)=0
 
virtual void setOutputIsBase64Encoded (bool)=0
 
virtual void start (const std::vector< GpgME::Key > &signers, const std::vector< GpgME::Key > &recipients, const std::shared_ptr< QIODevice > &plainText, const std::shared_ptr< QIODevice > &cipherText=std::shared_ptr< QIODevice >(), const GpgME::Context::EncryptionFlags flags=GpgME::Context::None)=0
 
virtual std::pair< GpgME::SigningResult, GpgME::EncryptionResult > exec (const std::vector< GpgME::Key > &signers, const std::vector< GpgME::Key > &recipients, const QByteArray &plainText, const GpgME::Context::EncryptionFlags flags, QByteArray &cipherText)=0
 
- Public Member Functions inherited from QGpgME::Job
virtual QString auditLogAsHtml () const
 
virtual GpgME::Error auditLogError () const
 
bool isAuditLogSupported () const
 

Protected Member Functions

 SignEncryptJob (QObject *parent)
 
- Protected Member Functions inherited from QGpgME::Job
 Job (QObject *parent)
 

Additional Inherited Members

- Public Slots inherited from QGpgME::Job
virtual void slotCancel ()=0
 
- Static Public Member Functions inherited from QGpgME::Job
static GpgME::Context * context (Job *job)
 

Detailed Description

An abstract base class for asynchronous combined signing and encrypting.

To use a SignEncryptJob, first obtain an instance from the CryptoBackend implementation, connect the progress() and result() signals to suitable slots and then start the operation with a call to start(). This call might fail, in which case the SignEncryptJob instance will have scheduled it's own destruction with a call to QObject::deleteLater().

After result() is emitted, the SignEncryptJob will schedule it's own destruction by calling QObject::deleteLater().

Member Function Documentation

◆ exec()

virtual std::pair<GpgME::SigningResult, GpgME::EncryptionResult> QGpgME::SignEncryptJob::exec ( const std::vector< GpgME::Key > &  signers,
const std::vector< GpgME::Key > &  recipients,
const QByteArray &  plainText,
const GpgME::Context::EncryptionFlags  flags,
QByteArray &  cipherText 
)
pure virtual

Like exec but with an additional argument for EncryptionFlags for more flexibility.

Implemented in QGpgME::QGpgMESignEncryptJob.

◆ setOutputIsBase64Encoded()

virtual void QGpgME::SignEncryptJob::setOutputIsBase64Encoded ( bool  )
pure virtual

This is a hack to request BASE64 output (instead of whatever comes out normally).

Implemented in QGpgME::QGpgMESignEncryptJob.

◆ start() [1/3]

virtual GpgME::Error QGpgME::SignEncryptJob::start ( const std::vector< GpgME::Key > &  signers,
const std::vector< GpgME::Key > &  recipients,
const QByteArray &  plainText,
bool  alwaysTrust = false 
)
pure virtual

Starts the combined signing and encrypting operation. signers is the list of keys to sign plainText with. recipients is a list of keys to encrypt the signed plainText to. In both lists, empty (null) keys are ignored.

If alwaysTrust is true, validity checking for the recipient keys will not be performed, but full validity assumed for all recipient keys without further checks.

Implemented in QGpgME::QGpgMESignEncryptJob.

◆ start() [2/3]

virtual void QGpgME::SignEncryptJob::start ( const std::vector< GpgME::Key > &  signers,
const std::vector< GpgME::Key > &  recipients,
const std::shared_ptr< QIODevice > &  plainText,
const std::shared_ptr< QIODevice > &  cipherText = std::shared_ptr< QIODevice >(),
bool  alwaysTrust = false 
)
pure virtual

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

If cipherText is non-null, the ciphertext is written there. Otherwise, it will be delivered in the third argument of result().

Exceptions
GpgME::Exceptionif starting fails

Implemented in QGpgME::QGpgMESignEncryptJob.

◆ start() [3/3]

virtual void QGpgME::SignEncryptJob::start ( const std::vector< GpgME::Key > &  signers,
const std::vector< GpgME::Key > &  recipients,
const std::shared_ptr< QIODevice > &  plainText,
const std::shared_ptr< QIODevice > &  cipherText = std::shared_ptr< QIODevice >(),
const GpgME::Context::EncryptionFlags  flags = GpgME::Context::None 
)
pure virtual

Like start but with an additional argument for EncryptionFlags for more flexibility.

Implemented in QGpgME::QGpgMESignEncryptJob.


The documentation for this class was generated from the following file: