File indexing completed on 2024-04-28 04:18:50

0001 // vim: set tabstop=4 shiftwidth=4 expandtab:
0002 /*
0003 Gwenview: an image viewer
0004 Copyright 2007 Aurélien Gâteau <agateau@kde.org>
0005 
0006 This program is free software; you can redistribute it and/or
0007 modify it under the terms of the GNU General Public License
0008 as published by the Free Software Foundation; either version 2
0009 of the License, or (at your option) any later version.
0010 
0011 This program is distributed in the hope that it will be useful,
0012 but WITHOUT ANY WARRANTY; without even the implied warranty of
0013 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
0014 GNU General Public License for more details.
0015 
0016 You should have received a copy of the GNU General Public License
0017 along with this program; if not, write to the Free Software
0018 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
0019 
0020 */
0021 #ifndef ABSTRACTIMAGEOPERATION_H
0022 #define ABSTRACTIMAGEOPERATION_H
0023 
0024 #include <lib/gwenviewlib_export.h>
0025 
0026 // Qt
0027 #include <QUndoCommand>
0028 
0029 // KF
0030 
0031 // Local
0032 #include <lib/document/document.h>
0033 
0034 class KJob;
0035 
0036 namespace Gwenview
0037 {
0038 struct AbstractImageOperationPrivate;
0039 
0040 /**
0041  * An operation to apply on a document. This class pushes internal instances of
0042  * QUndoCommand to the document undo stack, but it only does so if the
0043  * operation succeeded.
0044  *
0045  * Class inheriting from this class should:
0046  * - Implement redo() and call finish() or finishFromKJob() when done
0047  * - Implement undo()
0048  * - Define the operation/command text with setText()
0049  */
0050 class GWENVIEWLIB_EXPORT AbstractImageOperation : public QObject
0051 {
0052     Q_OBJECT
0053 public:
0054     AbstractImageOperation();
0055     ~AbstractImageOperation() override;
0056 
0057     void applyToDocument(Document::Ptr);
0058     Document::Ptr document() const;
0059 
0060 protected:
0061     virtual void redo() = 0;
0062     virtual void undo()
0063     {
0064     }
0065     void setText(const QString &);
0066 
0067     /**
0068      * Convenience method which can be called from redo() if the operation is
0069      * implemented as a job
0070      */
0071     void redoAsDocumentJob(DocumentJob *job);
0072 
0073 protected Q_SLOTS:
0074     void finish(bool ok);
0075 
0076     /**
0077      * Convenience slot which call finish() correctly if job succeeded
0078      */
0079     void finishFromKJob(KJob *job);
0080 
0081 private:
0082     AbstractImageOperationPrivate *const d;
0083 
0084     friend class ImageOperationCommand;
0085 };
0086 
0087 } // namespace
0088 
0089 #endif /* ABSTRACTIMAGEOPERATION_H */