1 files changed, 59 insertions, 1 deletions

diff --git a/lang/qt/src/encryptjob.h b/lang/qt/src/encryptjob.h
index ac3664fa..48b36598 100644
--- a/lang/qt/src/encryptjob.h
+++ b/lang/qt/src/encryptjob.h
@@ -72,6 +72,15 @@ namespace QGpgME
    EncryptJob instance will have scheduled it's own destruction with
    a call to QObject::deleteLater().
 
+   Alternatively, the job can be started with startIt() after setting
+   an input file and an output file and, optionally, recipients or flags.
+   If the job is started this way then the backend reads the input and
+   writes the output directly from/to the specified input file and output
+   file. In this case the cipherText value of the result signal will always
+   be empty. This direct IO mode is currently only supported for OpenPGP.
+   Note that startIt() does not schedule the job's destruction if starting
+   the job failed.
+
    After result() is emitted, the EncryptJob will schedule it's own
    destruction by calling QObject::deleteLater().
 */
@@ -81,15 +90,64 @@ class QGPGME_EXPORT EncryptJob : public Job
 protected:
     explicit EncryptJob(QObject *parent);
 public:
-    ~EncryptJob();
+    ~EncryptJob() override;
 
+    /**
+     * Sets the file name to embed in the encryption result.
+     *
+     * This is only used if one of the start() functions is used.
+     */
     void setFileName(const QString &fileName);
     QString fileName() const;
 
+    /**
+     * Sets the encoding of the plaintext.
+     *
+     * This is only used if one of the start() functions is used.
+     */
     void setInputEncoding(GpgME::Data::Encoding);
     GpgME::Data::Encoding inputEncoding() const;
 
     /**
+     * Sets the keys to use for encryption.
+     *
+     * Used if the job is started with startIt().
+     */
+    void setRecipients(const std::vector<GpgME::Key> &recipients);
+    std::vector<GpgME::Key> recipients() const;
+
+    /**
+     * Sets the path of the file to encrypt.
+     *
+     * Used if the job is started with startIt().
+     */
+    void setInputFile(const QString &path);
+    QString inputFile() const;
+
+    /**
+     * Sets the path of the file to write the encryption result to.
+     *
+     * Used if the job is started with startIt().
+     *
+     * \note If a file with this path exists, then the job will fail, i.e. you
+     * need to delete an existing file that shall be overwritten before you
+     * start the job.
+     */
+    void setOutputFile(const QString &path);
+    QString outputFile() const;
+
+    /**
+     * Sets the flags to use for encryption.
+     *
+     * Defaults to \c EncryptFile.
+     *
+     * Used if the job is started with startIt(). The \c EncryptFile flag is
+     * always assumed set.
+     */
+    void setEncryptionFlags(GpgME::Context::EncryptionFlags flags);
+    GpgME::Context::EncryptionFlags encryptionFlags() const;
+
+    /**
        Starts the encryption operation. \a recipients is the a list of
        keys to encrypt \a plainText to. Empty (null) keys are
        ignored. If \a recipients is empty, performs symmetric