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 class MarginRole SIP_MONKEYPATCH_SCOPEENUM_UNNEST( QgsCodeEditor, MarginRole ) : int
      {
      LineNumbers = 0, 
      ErrorIndicators = 1, 
      FoldingControls = 2, 
    };
    Q_ENUM( MarginRole )
 
    
    enum class Flag : int
    {
      CodeFolding = 1 << 0, 
    };
    Q_ENUM( Flag )
 
    
    Q_DECLARE_FLAGS( Flags, Flag )
    Q_FLAG( Flags )
 
    
    QgsCodeEditor( QWidget * parent SIP_TRANSFERTHIS = nullptr, const QString & title = QString(), bool folding = false, bool margin = false, QgsCodeEditor::Flags flags = QgsCodeEditor::Flags() );
 
    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();
 
    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();
 
    bool isCursorOnLastLine() const;
 
  public slots:
 
    virtual void moveCursorToStart();
 
    virtual void moveCursorToEnd();
 
  protected:
 
    bool isFixedPitch( const QFont & font );
 
    void focusOutEvent( QFocusEvent * event ) override;
    void keyPressEvent( QKeyEvent * event ) override;
    bool eventFilter( QObject * watched, QEvent * event ) override;
 
    virtual void initializeLexer();
 
    QColor lexerColor( QgsCodeEditorColorScheme::ColorRole role ) const;
 
    QFont lexerFont() const;
 
    void runPostLexerConfigurationTasks();
 
  private:
 
    void setSciWidget();
    void updateFolding();
 
    QString mWidgetTitle;
    bool mMargin = false;
    QgsCodeEditor::Flags mFlags;
 
    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;
};
 
Q_DECLARE_OPERATORS_FOR_FLAGS( QgsCodeEditor::Flags )
 
// clazy:excludeall=qstring-allocations
 
#endif