NoteEditor.h

/*
 * Copyright 2016-2020 Dmitry Ivanov
 *
 * This file is part of libquentier
 *
 * libquentier is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, version 3 of the License.
 *
 * libquentier is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with libquentier. If not, see <http://www.gnu.org/licenses/>.
 */
 
#ifndef LIB_QUENTIER_NOTE_EDITOR_NOTE_EDITOR_H
#define LIB_QUENTIER_NOTE_EDITOR_NOTE_EDITOR_H
 
#include <quentier/types/ErrorString.h>
#include <quentier/types/Note.h>
#include <quentier/types/Notebook.h>
#include <quentier/utility/Linkage.h>
 
#include <QPrinter>
#include <QStringList>
#include <QThread>
#include <QWidget>
 
QT_FORWARD_DECLARE_CLASS(QUndoStack)
 
namespace quentier {
 
QT_FORWARD_DECLARE_CLASS(Account)
QT_FORWARD_DECLARE_CLASS(INoteEditorBackend)
QT_FORWARD_DECLARE_CLASS(LocalStorageManagerAsync)
QT_FORWARD_DECLARE_CLASS(SpellChecker)
 
 
class QUENTIER_EXPORT NoteEditor : public QWidget
{
    Q_OBJECT
public:
    explicit NoteEditor(
        QWidget * parent = nullptr,
#if QT_VERSION >= QT_VERSION_CHECK(5, 15, 0)
        Qt::WindowFlags flags = {});
#else
        Qt::WindowFlags flags = 0);
#endif
 
    virtual ~NoteEditor() override;
 
    void initialize(
        LocalStorageManagerAsync & localStorageManager,
        SpellChecker & spellChecker, const Account & account,
        QThread * pBackgroundJobsThread = nullptr);
 
    INoteEditorBackend * backend();
 
    void setBackend(INoteEditorBackend * backend);
 
    void setAccount(const Account & account);
 
    const QUndoStack * undoStack() const;
 
    void setUndoStack(QUndoStack * pUndoStack);
 
    void setInitialPageHtml(const QString & html);
 
    void setNoteNotFoundPageHtml(const QString & html);
 
    void setNoteDeletedPageHtml(const QString & html);
 
    void setNoteLoadingPageHtml(const QString & html);
 
    QString currentNoteLocalUid() const;
 
    void setCurrentNoteLocalUid(const QString & noteLocalUid);
 
    void clear();
 
    bool isModified() const;
 
    bool isEditorPageModified() const;
 
    bool isNoteLoaded() const;
 
    qint64 idleTime() const;
 
    void setFocus();
 
    QString selectedText() const;
    bool hasSelection() const;
 
    bool spellCheckEnabled() const;
 
    bool print(QPrinter & printer, ErrorString & errorDescription);
 
    bool exportToPdf(
        const QString & absoluteFilePath, ErrorString & errorDescription);
 
    bool exportToEnex(
        const QStringList & tagNames, QString & enex,
        ErrorString & errorDescription);
 
    QPalette defaultPalette() const;
 
    const QFont * defaultFont() const;
 
Q_SIGNALS:
    void contentChanged();
 
    void noteAndNotebookFoundInLocalStorage(Note note, Notebook notebook);
 
    void noteNotFound(QString noteLocalUid);
 
    void noteDeleted(QString noteLocalUid);
 
    void noteModified();
 
    void notifyError(ErrorString error);
 
    void inAppNoteLinkClicked(
        QString userId, QString shardId, QString noteGuid);
 
    void inAppNoteLinkPasteRequested(
        QString url, QString userId, QString shardId, QString noteGuid);
 
    void convertedToNote(Note note);
    void cantConvertToNote(ErrorString error);
 
    void noteEditorHtmlUpdated(QString html);
 
    void currentNoteChanged(Note note);
 
    void spellCheckerNotReady();
    void spellCheckerReady();
 
    void noteLoaded();
 
    void noteSavedToLocalStorage(QString noteLocalUid);
 
    void failedToSaveNoteToLocalStorage(
        ErrorString errorDescription, QString noteLocalUid);
 
    // Signals to notify anyone interested of the formatting at the current
    // cursor position
    void textBoldState(bool state);
    void textItalicState(bool state);
    void textUnderlineState(bool state);
    void textStrikethroughState(bool state);
    void textAlignLeftState(bool state);
    void textAlignCenterState(bool state);
    void textAlignRightState(bool state);
    void textAlignFullState(bool state);
    void textInsideOrderedListState(bool state);
    void textInsideUnorderedListState(bool state);
    void textInsideTableState(bool state);
 
    void textFontFamilyChanged(QString fontFamily);
    void textFontSizeChanged(int fontSize);
 
    void insertTableDialogRequested();
 
public Q_SLOTS:
    void convertToNote();
 
    void saveNoteToLocalStorage();
 
    void setNoteTitle(const QString & noteTitle);
 
    void setTagIds(
        const QStringList & tagLocalUids, const QStringList & tagGuids);
 
    void undo();
    void redo();
    void cut();
    void copy();
    void paste();
    void pasteUnformatted();
    void selectAll();
 
    void formatSelectionAsSourceCode();
 
    void fontMenu();
    void textBold();
    void textItalic();
    void textUnderline();
    void textStrikethrough();
    void textHighlight();
 
    void alignLeft();
    void alignCenter();
    void alignRight();
    void alignFull();
 
    void findNext(const QString & text, const bool matchCase) const;
    void findPrevious(const QString & text, const bool matchCase) const;
 
    void replace(
        const QString & textToReplace, const QString & replacementText,
        const bool matchCase);
 
    void replaceAll(
        const QString & textToReplace, const QString & replacementText,
        const bool matchCase);
 
    void insertToDoCheckbox();
 
    void insertInAppNoteLink(
        const QString & userId, const QString & shardId,
        const QString & noteGuid, const QString & linkText);
 
    void setSpellcheck(const bool enabled);
 
    void setFont(const QFont & font);
    void setFontHeight(const int height);
    void setFontColor(const QColor & color);
    void setBackgroundColor(const QColor & color);
 
    void setDefaultPalette(const QPalette & pal);
 
    void setDefaultFont(const QFont & font);
 
    void insertHorizontalLine();
 
    void increaseFontSize();
    void decreaseFontSize();
 
    void increaseIndentation();
    void decreaseIndentation();
 
    void insertBulletedList();
    void insertNumberedList();
 
    void insertTableDialog();
 
    void insertFixedWidthTable(
        const int rows, const int columns, const int widthInPixels);
 
    void insertRelativeWidthTable(
        const int rows, const int columns, const double relativeWidth);
 
    void insertTableRow();
    void insertTableColumn();
    void removeTableRow();
    void removeTableColumn();
 
    void addAttachmentDialog();
    void saveAttachmentDialog(const QByteArray & resourceHash);
    void saveAttachmentUnderCursor();
    void openAttachment(const QByteArray & resourceHash);
    void openAttachmentUnderCursor();
    void copyAttachment(const QByteArray & resourceHash);
    void copyAttachmentUnderCursor();
 
    void encryptSelectedText();
    void decryptEncryptedTextUnderCursor();
 
    void editHyperlinkDialog();
    void copyHyperlink();
    void removeHyperlink();
 
    void onNoteLoadCancelled();
 
protected:
    virtual void dragMoveEvent(QDragMoveEvent * pEvent) override;
    virtual void dropEvent(QDropEvent * pEvent) override;
 
private:
    INoteEditorBackend * m_backend;
};
 
} // namespace quentier
 
#endif // LIB_QUENTIER_NOTE_EDITOR_NOTE_EDITOR_H