File indexing completed on 2024-04-14 15:51:02

 /**
  * SPDX-FileCopyrightText: (C) 2003 Sébastien Laoût <slaout@linux62.org>
  *
  * SPDX-License-Identifier: GPL-2.0-or-later
  */
 
 #ifndef NOTEDRAG_H
 #define NOTEDRAG_H
 
 #include <QDrag>
 #include <QGraphicsSceneDragDropEvent>
 #include <QList>
 
 class QDataStream;
 class QDragEnterEvent;
 class QPixmap;
 class QString;
 
 class BasketScene;
 class Note;
 class NoteSelection;
 
 /** Dragging/Copying/Cutting Scenario:
  * - User select some notes and cut them;
  * - NoteDrag::toMultipleDrag() is called with a tree of the selected notes (see BasketScene::toSelectionTree()):
  *   - This method create a new QDrag object, create a stream,
  *   - And then browse all notes and call the virtual Note::serialize() with the stream as parameter for them to serialize their content in the "native format".
  *   - This give the MIME type "application/x-basket-note" that will be used by the application to paste the notes exactly as they were.
  *   - Then the method try to set alternate formats for the dragged objects:
  *   - It call successively toText() for each notes and stack up the result so there is ONE big text flavour to add to the QDrag object
  *   - It do the same with toHtml(), toImage() and toLink() to have those flavors as well, if possible...
  *   - If there is only ONE copied note, addAlternateDragObjects() is called on it, so that Unknown objects can be dragged "as is".
  *   - It's OK for the flavors. The method finally set the drag feedback pixmap by asking every selected notes to draw the content to a small pixmap.
  *   - The pixmaps are joined to one big pixmap (but it should not exceed a defined size) and a border is drawn on this image.
  *
  * Pasting/Dropping Scenario:
  *
  * @author Sébastien Laoût
  */
 class NoteDrag
 {
 protected:
     static void serializeNotes(NoteSelection *noteList, QDataStream &stream, bool cutting);
     static void serializeText(NoteSelection *noteList, QMimeData* mimeData);
     static void serializeHtml(NoteSelection *noteList, QMimeData* mimeData);
     static void serializeImage(NoteSelection *noteList, QMimeData* mimeData);
     static void serializeLinks(NoteSelection *noteList, QMimeData* mimeData, bool cutting);
     static void setFeedbackPixmap(NoteSelection *noteList, QDrag *multipleDrag);
     static Note *decodeHierarchy(QDataStream &stream, BasketScene *parent, bool moveFiles, bool moveNotes, BasketScene *originalBasket);
 
 public:
     static QPixmap feedbackPixmap(NoteSelection *noteList);
     static QDrag *dragObject(NoteSelection *noteList, bool cutting, QWidget *source = nullptr);
     static bool canDecode(const QMimeData *source);
     static Note *decode(const QMimeData *source, BasketScene *parent, bool moveFiles, bool moveNotes);
     static BasketScene *basketOf(const QMimeData *source);
     static QList<Note *> notesOf(QGraphicsSceneDragDropEvent *source);
     static void saveNoteSelectionToList(NoteSelection *selection); ///< Traverse @p selection and save all note pointers to @p selectedNotes
     static void createAndEmptyCuttingTmpFolder();
 
     static const char *NOTE_MIME_STRING;
 
     static QList<Note *> selectedNotes; ///< The notes being selected and dragged
 };
 
 /** QTextDrag with capabilities to drop GNOME and Mozilla texts
  * as well as UTF-16 texts even if it was supposed to be encoded
  * with local encoding!
  * @author Sébastien Laoût
  */
 class ExtendedTextDrag : public QDrag
 {
     Q_OBJECT
 public:
     static bool decode(const QMimeData *e, QString &str);
     static bool decode(const QMimeData *e, QString &str, QString &subtype);
 };
 
 #endif // NOTEDRAG_H