qgscodeeditor.h

Go to the documentation of this file.

/***************************************************************************
    qgscodeeditor.h - A base code editor for QGIS and plugins.  Provides
                      a base editor using QScintilla for editors
     --------------------------------------
    Date                 : 06-Oct-2013
    Copyright            : (C) 2013 by Salvatore Larosa
    Email                : lrssvtml (at) gmail (dot) com
 ***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
#ifndef QGSCODEEDITOR_H
#define QGSCODEEDITOR_H
 
#include <QString>
#include "qgscodeeditorcolorscheme.h"
// qscintilla includes
#include <Qsci/qsciapis.h>
#include "qgis_sip.h"
#include "qgis_gui.h"
 
#include <QMap>
 
 
SIP_IF_MODULE( HAVE_QSCI_SIP )
 
 
class QWidget;
 
class GUI_EXPORT QgsCodeEditor : public QsciScintilla
{
    Q_OBJECT
 
  public:
 
    enum MarginRole
    {
      LineNumbers = 0, 
      ErrorIndicators = 1, 
      FoldingControls = 2, 
    };
 
    QgsCodeEditor( QWidget *parent SIP_TRANSFERTHIS = nullptr, const QString &title = QString(), bool folding = false, bool margin = false );
 
    void setTitle( const QString &title );
 
    Q_DECL_DEPRECATED void setMarginVisible( bool margin ) SIP_DEPRECATED;
 
    Q_DECL_DEPRECATED bool marginVisible() SIP_DEPRECATED { return mMargin; }
 
    void setLineNumbersVisible( bool visible );
 
    bool lineNumbersVisible() const;
 
    void setFoldingVisible( bool folding );
 
    bool foldingVisible() { return mFolding; }
 
    void insertText( const QString &text );
 
    static QColor defaultColor( QgsCodeEditorColorScheme::ColorRole role, const QString &theme = QString() );
 
    static QColor color( QgsCodeEditorColorScheme::ColorRole role );
 
    static void setColor( QgsCodeEditorColorScheme::ColorRole role, const QColor &color );
 
    static QFont getMonospaceFont();
 
    void setCustomAppearance( const QString &scheme = QString(), const QMap< QgsCodeEditorColorScheme::ColorRole, QColor > &customColors = QMap< QgsCodeEditorColorScheme::ColorRole, QColor >(), const QString &fontFamily = QString(), int fontSize = 0 ) SIP_SKIP;
 
    void addWarning( int lineNumber, const QString &warning );
 
    void clearWarnings();
 
  protected:
 
    bool isFixedPitch( const QFont &font );
 
    void focusOutEvent( QFocusEvent *event ) override;
    void keyPressEvent( QKeyEvent *event ) override;
 
    virtual void initializeLexer();
 
    QColor lexerColor( QgsCodeEditorColorScheme::ColorRole role ) const;
 
    QFont lexerFont() const;
 
    void runPostLexerConfigurationTasks();
 
  private:
 
    void setSciWidget();
 
    QString mWidgetTitle;
    bool mFolding;
    bool mMargin;
 
    bool mUseDefaultSettings = true;
    // used if above is false, inplace of values taken from QSettings:
    bool mOverrideColors = false;
    QString mColorScheme;
    QMap< QgsCodeEditorColorScheme::ColorRole, QColor > mCustomColors;
    QString mFontFamily;
    int mFontSize = 0;
 
    QVector< int > mWarningLines;
 
    static QMap< QgsCodeEditorColorScheme::ColorRole, QString > sColorRoleToSettingsKey;
 
    static constexpr int MARKER_NUMBER = 6;
};
 
// clazy:excludeall=qstring-allocations
 
#endif