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 */