btqmlinterface.h

Go to the documentation of this file.

/*********
*
* In the name of the Father, and of the Son, and of the Holy Spirit.
*
* This file is part of BibleTime's source code, https://bibletime.info/
*
* Copyright 1999-2025 by the BibleTime developers.
* The BibleTime source code is licensed under the GNU General Public License
* version 2.0.
*
**********/
 
#pragma once
 
#include <memory>
#include <optional>
#include <QFont>
#include <QList>
#include <QObject>
#include <QQmlEngine>
#include <QString>
#include "../../../backend/models/btmoduletextmodel.h"
 
 
class CSwordKey;
class CSwordModuleInfo;
class CSwordVerseKey;
class RoleItemModel;
 
/**
 * /brief This class provides communications between QML and c++.
 *
 * It is instantiated by usage within the QML files. It provides
 * properties and functions written in c++ and usable by QML.
 */
 
class BtQmlInterface : public QObject {
 
    Q_OBJECT
    QML_ELEMENT
    QML_SINGLETON
    Q_PROPERTY(QColor       backgroundColor         READ getBackgroundColor NOTIFY backgroundColorChanged)
    Q_PROPERTY(QColor       backgroundHighlightColor READ getBackgroundHighlightColor NOTIFY backgroundHighlightColorChanged)
    Q_PROPERTY(int          backgroundHighlightColorIndex READ getBackgroundHighlightColorIndex NOTIFY backgroundHighlightColorIndexChanged)
    Q_PROPERTY(int          contextMenuIndex        READ getContextMenuIndex NOTIFY contextMenuIndexChanged WRITE setContextMenuIndex)
    Q_PROPERTY(int          contextMenuColumn       READ getContextMenuColumn NOTIFY contextMenuColumnChanged WRITE setContextMenuColumn)
    Q_PROPERTY(int          currentModelIndex       READ getCurrentModelIndex NOTIFY currentModelIndexChanged)
    Q_PROPERTY(QFont        font0                   READ getFont0   NOTIFY fontChanged)
    Q_PROPERTY(QFont        font1                   READ getFont1   NOTIFY fontChanged)
    Q_PROPERTY(QFont        font2                   READ getFont2   NOTIFY fontChanged)
    Q_PROPERTY(QFont        font3                   READ getFont3   NOTIFY fontChanged)
    Q_PROPERTY(QFont        font4                   READ getFont4   NOTIFY fontChanged)
    Q_PROPERTY(QFont        font5                   READ getFont5   NOTIFY fontChanged)
    Q_PROPERTY(QFont        font6                   READ getFont6   NOTIFY fontChanged)
    Q_PROPERTY(QFont        font7                   READ getFont7   NOTIFY fontChanged)
    Q_PROPERTY(QFont        font8                   READ getFont8   NOTIFY fontChanged)
    Q_PROPERTY(QFont        font9                   READ getFont9   NOTIFY fontChanged)
    Q_PROPERTY(QColor       foregroundColor         READ getForegroundColor NOTIFY foregroundColorChanged)
    Q_PROPERTY(int          numModules              READ getNumModules NOTIFY numModulesChanged)
    Q_PROPERTY(double       pixelsPerMM             READ getPixelsPerMM NOTIFY pixelsPerMMChanged)
    Q_PROPERTY(QVariant     textModel               READ getTextModel NOTIFY textModelChanged)
 
public: /* Types: */
 
    struct Selection {
        int column;
        int startIndex;
        int endIndex;
        QString selectedText;
 
        friend bool operator==(Selection const & lhs, Selection const & rhs) {
            return lhs.column == rhs.column
                    && lhs.startIndex == rhs.startIndex
                    && lhs.endIndex == rhs.endIndex
                    && lhs.selectedText == rhs.selectedText;
        }
        friend bool operator==(Selection const & lhs, Selection const & rhs) {…};
 
        friend bool operator!=(Selection const & lhs, Selection const & rhs) {
            return lhs.column != rhs.column
                    || lhs.startIndex != rhs.startIndex
                    || lhs.endIndex != rhs.endIndex
                    || lhs.selectedText != rhs.selectedText;
        }
        friend bool operator!=(Selection const & lhs, Selection const & rhs) {…};
    };
    struct Selection {…};
 
public:
    void cancelMagTimer();
    Q_INVOKABLE void changeReference(int i);
    Q_INVOKABLE void dragHandler(int index);
    Q_INVOKABLE bool moduleIsWritable(int column);
    Q_INVOKABLE void openEditor(int row, int column);
    void setMagReferenceByUrl(const QString& url);
    Q_INVOKABLE QString rawText(int row, int column);
    Q_INVOKABLE void setRawText(int row, int column, const QString& text);
    Q_INVOKABLE void setBibleKey(const QString& link);
    Q_INVOKABLE int indexToVerse(int index);
    Q_INVOKABLE void setHoveredLink(QString const & link);
 
    BtQmlInterface(QObject * parent = nullptr);
    ~BtQmlInterface() override;
 
    void findText(bool backward);
 
    QString const & activeLink() const noexcept { return m_activeLink; }
    QColor getBackgroundColor() const;
    QColor getBackgroundHighlightColor() const;
    QColor getForegroundColor() const;
    int getBackgroundHighlightColorIndex() const;
    void changeColorTheme();
    void copyRange(int index1, int index2) const;
    static void copyVerseRange(CSwordVerseKey const & key1,
                               CSwordVerseKey const & key2);
    QString getBibleUrlFromLink(const QString& url);
    int getContextMenuIndex() const;
    int getContextMenuColumn() const;
    int getCurrentModelIndex() const;
    QFont getFont0() const;
    QFont getFont1() const;
    QFont getFont2() const;
    QFont getFont3() const;
    QFont getFont4() const;
    QFont getFont5() const;
    QFont getFont6() const;
    QFont getFont7() const;
    QFont getFont8() const;
    QFont getFont9() const;
    CSwordKey* getMouseClickedKey() const;
    QString getLemmaFromLink(const QString& url);
    int getNumModules() const;
    double getPixelsPerMM() const;
 
    Q_INVOKABLE void setSelection(int column,
                                  int startIndex,
                                  int endIndex,
                                  QString const & selectedText);
    Q_INVOKABLE void clearSelection() noexcept;
    QString getSelectedText() const;
 
    std::optional<Selection> const & selection() const noexcept
    { return m_selection; }
    std::optional<Selection> const & selection() const noexcept {…}
 
    QVariant getTextModel();
    bool isBibleOrCommentary();
    BtModuleTextModel * textModel();
    BtModuleTextModel const * textModel() const;
    void scrollToSwordKey(CSwordKey * key);
    void setContextMenuIndex(int index);
    void setContextMenuColumn(int index);
    void setHighlightWords(const QString& words, bool caseSensitivy);
    void setModules(const QStringList &modules);
    void settingsChanged();
 
Q_SIGNALS:
    void backgroundColorChanged();
    void backgroundHighlightColorChanged();
    void backgroundHighlightColorIndexChanged();
    void contextMenuIndexChanged();
    void contextMenuColumnChanged();
    void currentModelIndexChanged();
    void fontChanged();
    void foregroundColorChanged();
    void numModulesChanged();
    void pixelsPerMMChanged();
    void positionItemOnScreen(int index);
    void setBibleReference(const QString& reference);
    void textChanged();
    void textModelChanged();
    void updateReference(const QString& reference);
    void dragOccuring(const QString& moduleName, const QString& keyName);
    void activeLinkChanged(QString newActiveLink);
    void selectionChanged(std::optional<Selection> newSelection);
 
protected: // Methods:
 
    void timerEvent(QTimerEvent * event) final override;
 
private:
    QFont font(int column) const;
    void getFontsFromSettings();
    QString getReferenceFromUrl(const QString& url);
 
public: // Fields:
 
    static int typeId;
 
private: // Fields:
 
    bool m_firstHref = false;
    int m_linkTimerId = 0;
    BtModuleTextModel * const m_moduleTextModel;
    CSwordKey * m_swordKey = nullptr;
 
    QList<QFont> m_fonts;
    int m_backgroundHighlightColorIndex = -1;
    QStringList m_moduleNames;
    QString m_timeoutUrl;
    int m_contextMenuIndex;
    int m_contextMenuColumn;
    QString m_activeLink;
    std::optional<FindState> m_findState;
    std::optional<Selection> m_selection;
};
class BtQmlInterface : public QObject {…};