36#include <QFontDatabase>
43#include <Qsci/qscilexer.h>
44#include <Qsci/qscistyle.h>
46#include "moc_qgscodeeditor.cpp"
48using namespace Qt::StringLiterals;
55QMap<QgsCodeEditorColorScheme::ColorRole, QString> QgsCodeEditor::sColorRoleToSettingsKey {
95 : QsciScintilla( parent )
96 , mWidgetTitle( title )
101 if ( !parent && mWidgetTitle.isEmpty() )
103 setWindowTitle( u
"Text Editor"_s );
107 setWindowTitle( mWidgetTitle );
113 mSoftHistory.append( QString() );
116 setHorizontalScrollBarPolicy( Qt::ScrollBarAsNeeded );
118 SendScintilla( SCI_SETADDITIONALSELECTIONTYPING, 1 );
119 SendScintilla( SCI_SETMULTIPASTE, 1 );
120 SendScintilla( SCI_SETVIRTUALSPACEOPTIONS, SCVS_RECTANGULARSELECTION );
125 setAnnotationDisplay( QsciScintilla::AnnotationBoxed );
140 SendScintilla( QsciScintilla::SCI_SETHSCROLLBAR, 0 );
142 setWrapMode( QsciScintilla::WrapCharacter );
149 SendScintilla( QsciScintilla::SCI_SETHSCROLLBAR, 0 );
151 setWrapMode( QsciScintilla::WrapCharacter );
152 SendScintilla( QsciScintilla::SCI_EMPTYUNDOBUFFER );
157#if QSCINTILLA_VERSION < 0x020d03
158 installEventFilter(
this );
161 mLastEditTimer =
new QTimer(
this );
162 mLastEditTimer->setSingleShot(
true );
163 mLastEditTimer->setInterval( 1000 );
164 connect( mLastEditTimer, &QTimer::timeout,
this, &QgsCodeEditor::onLastEditTimeout );
165 connect(
this, &QgsCodeEditor::textChanged, mLastEditTimer, qOverload<>( &QTimer::start ) );
171#if QSCINTILLA_VERSION >= 0x020800 && QSCINTILLA_VERSION < 0x020900
172 if (
event->reason() != Qt::ActiveWindowFocusReason )
186 QFocusEvent newFocusEvent( QEvent::FocusOut, Qt::ActiveWindowFocusReason );
187 QsciScintilla::focusOutEvent( &newFocusEvent );
192 QsciScintilla::focusOutEvent(
event );
202 if ( isListActive() )
204 QsciScintilla::keyPressEvent(
event );
208 if (
event->key() == Qt::Key_Escape )
211 QWidget::keyPressEvent(
event );
215 if (
event->matches( QKeySequence::StandardKey::HelpContents ) )
218 QString text = selectedText();
223 text = wordAtPoint( mapFromGlobal( QCursor::pos() ) );
227 if ( text.isEmpty() )
230 getCursorPosition( &line, &index );
231 text = wordAtLineIndex( line, index );
240 switch (
event->key() )
265 if ( !isReadOnly() && canReformat )
268 if ( !reformatCodeSequence.isEmpty() && reformatCodeSequence.matches(
event->key() |
event->modifiers() ) )
278 if ( !isReadOnly() && canToggle )
281 if ( !toggleCommentCodeSequence.isEmpty() && toggleCommentCodeSequence.matches(
event->key() |
event->modifiers() ) )
289 QsciScintilla::keyPressEvent(
event );
292 if ( !
event->isAutoRepeat() )
304 QMenu *menu = createStandardContextMenu();
305 menu->setAttribute( Qt::WA_DeleteOnClose );
309 menu->addSeparator();
314 QAction *reformatAction =
new QAction( tr(
"Reformat Code" ), menu );
317 reformatAction->setEnabled( !isReadOnly() );
319 menu->addAction( reformatAction );
324 QAction *syntaxCheckAction =
new QAction( tr(
"Check Syntax" ), menu );
327 menu->addAction( syntaxCheckAction );
332 QAction *toggleCommentAction =
new QAction( tr(
"Toggle Comment" ), menu );
335 toggleCommentAction->setEnabled( !isReadOnly() );
337 menu->addAction( toggleCommentAction );
342 menu->exec( mapToGlobal(
event->pos() ) );
348 QMenu *menu =
new QMenu(
this );
349 QMenu *historySubMenu =
new QMenu( tr(
"Command History" ), menu );
355 menu->addMenu( historySubMenu );
356 menu->addSeparator();
358 QAction *copyAction = menu->addAction(
QgsApplication::getThemeIcon(
"mActionEditCopy.svg" ), tr(
"Copy" ),
this, &QgsCodeEditor::copy, QKeySequence::Copy );
359 QAction *pasteAction = menu->addAction(
QgsApplication::getThemeIcon(
"mActionEditPaste.svg" ), tr(
"Paste" ),
this, &QgsCodeEditor::paste, QKeySequence::Paste );
360 copyAction->setEnabled( hasSelectedText() );
361 pasteAction->setEnabled( !QApplication::clipboard()->text().isEmpty() );
365 menu->exec( mapToGlobal(
event->pos() ) );
370 QsciScintilla::contextMenuEvent(
event );
377 if (
event->type() == QEvent::ShortcutOverride )
379 if ( QKeyEvent *keyEvent =
dynamic_cast<QKeyEvent *
>(
event ) )
381 if ( keyEvent->matches( QKeySequence::StandardKey::HelpContents ) )
390 return QsciScintilla::event(
event );
395#if QSCINTILLA_VERSION < 0x020d03
396 if ( watched ==
this &&
event->type() == QEvent::InputMethod )
405 return QsciScintilla::eventFilter( watched,
event );
414 if ( mUseDefaultSettings )
415 return color( role );
417 if ( !mOverrideColors )
423 const QColor
color = mCustomColors.value( role );
430 if ( mUseDefaultSettings )
433 QFont font = QFontDatabase::systemFont( QFontDatabase::FixedFont );
436 if ( !mFontFamily.isEmpty() )
441 font.setPointSize( mFontSize );
445 font.setPointSize( QLabel().font().pointSize() );
449 font.setPointSize( mFontSize );
452 const int fontSize = settings.
value( u
"qgis/stylesheet/fontPointSize"_s, 10 ).toInt();
453 font.setPointSize( fontSize );
456 font.setBold(
false );
483 setCaretLineVisible(
false );
486 setMarginLineNumbers( 1,
true );
487 setMarginWidth( 1,
"00000" );
488 setMarginType( 1, QsciScintilla::MarginType::TextMarginRightJustified );
490 setEdgeMode( QsciScintilla::EdgeNone );
494void QgsCodeEditor::onLastEditTimeout()
496 mLastEditTimer->stop();
500void QgsCodeEditor::setSciWidget()
506 setCaretLineVisible(
true );
512 setBraceMatching( QsciScintilla::SloppyBraceMatch );
519 setFolding( QsciScintilla::NoFoldStyle );
531 setFoldMarginColors( foldColor, foldColor );
533 setAutoIndent(
true );
534 setIndentationWidth( 4 );
535 setTabIndents(
true );
536 setBackspaceUnindents(
true );
539 setAutoCompletionThreshold( 2 );
540 setAutoCompletionSource( QsciScintilla::AcsAPIs );
547 setWindowTitle( title );
567 return tr(
"Expression" );
571 return tr(
"JavaScript" );
575 return tr(
"Python" );
581 return tr(
"Batch" );
596 marginFont.setPointSize( 10 );
597 setMarginLineNumbers( 0,
true );
598 setMarginsFont( marginFont );
616 marginFont.setPointSize( 10 );
618 setMarginsFont( marginFont );
653void QgsCodeEditor::updateFolding()
660 setFolding( QsciScintilla::PlainFoldStyle );
664 setFolding( QsciScintilla::NoFoldStyle );
669bool QgsCodeEditor::readHistoryFile()
671 if ( mHistoryFilePath.isEmpty() || !QFile::exists( mHistoryFilePath ) )
674 QFile file( mHistoryFilePath );
675 if ( file.open( QIODevice::ReadOnly ) )
677 QTextStream stream( &file );
679 while ( !stream.atEnd() )
681 line = stream.readLine();
682 mHistory.append( line );
691void QgsCodeEditor::syncSoftHistory()
693 mSoftHistory = mHistory;
694 mSoftHistory.append( QString() );
695 mSoftHistoryIndex = mSoftHistory.length() - 1;
700 mSoftHistory[mSoftHistoryIndex] = text();
703void QgsCodeEditor::updateHistory(
const QStringList &commands,
bool skipSoftHistory )
705 if ( commands.size() > 1 )
707 mHistory.append( commands );
709 else if ( !commands.value( 0 ).isEmpty() )
711 const QString command = commands.value( 0 );
712 if ( mHistory.empty() || command != mHistory.constLast() )
713 mHistory.append( command );
716 if ( !skipSoftHistory )
736 QMessageBox::information(
this, title, message );
740 QMessageBox::warning(
this, title, message );
744 QMessageBox::critical(
this, title, message );
753 const QString prompt = mInterpreter->promptForState( mInterpreter->currentState() );
754 SendScintilla( QsciScintilla::SCI_MARGINSETTEXT,
static_cast<uintptr_t
>( 0 ), prompt.toUtf8().constData() );
765 mInterpreter = newInterpreter;
772 const int index = std::min( source.length(), target.length() );
778 int refDistanceMore = d0;
779 int refIndexMore = index;
780 if ( index < source.length() - 1 )
785 if ( newDistance <= refDistanceMore )
787 refDistanceMore = newDistance;
789 if ( refIndexMore == source.length() - 1 )
799 int refDistanceLess = d0;
800 int refIndexLess = index;
806 if ( newDistance <= refDistanceLess )
808 refDistanceLess = newDistance;
810 if ( refIndexLess == 0 )
820 if ( refDistanceMore < refDistanceLess )
832 const QString originalText = text();
835 if ( originalText == newText )
839 const int oldScrollValue = verticalScrollBar()->value();
844 removeSelectedText();
847 verticalScrollBar()->setValue( oldScrollValue );
868 int startLine, startPos, endLine, endPos;
869 if ( hasSelectedText() )
871 getSelection( &startLine, &startPos, &endLine, &endPos );
875 getCursorPosition( &startLine, &startPos );
881 bool allEmpty =
true;
882 bool allCommented =
true;
883 int minIndentation = -1;
884 for (
int line = startLine; line <= endLine; line++ )
886 const QString stripped = text( line ).trimmed();
887 if ( !stripped.isEmpty() )
890 if ( !stripped.startsWith( commentPrefix ) )
892 allCommented =
false;
894 if ( minIndentation == -1 || minIndentation > indentation( line ) )
896 minIndentation = indentation( line );
910 const int prefixLength =
static_cast<int>( commentPrefix.length() );
912 const bool startLineEmpty = ( text( startLine ).trimmed().isEmpty() );
913 const bool endLineEmpty = ( text( endLine ).trimmed().isEmpty() );
915 for (
int line = startLine; line <= endLine; line++ )
917 const QString stripped = text( line ).trimmed();
920 if ( stripped.isEmpty() )
927 insertAt( commentPrefix +
' ', line, minIndentation );
928 delta = -( prefixLength + 1 );
932 if ( !stripped.startsWith( commentPrefix ) )
936 if ( stripped.startsWith( commentPrefix +
' ' ) )
938 delta = prefixLength + 1;
942 delta = prefixLength;
944 setSelection( line, indentation( line ), line, indentation( line ) + delta );
945 removeSelectedText();
950 setSelection( startLine, startPos - ( startLineEmpty ? 0 : delta ), endLine, endPos - ( endLineEmpty ? 0 : delta ) );
959 int lineCount = lines();
962 for (
int line = 0; line < lineCount; line++ )
965 const long endLine = SendScintilla( SCI_GETLINEENDPOSITION, line );
967 const long x = SendScintilla( SCI_POINTXFROMPOSITION, 0, endLine );
968 maxWidth = std::max( maxWidth, x );
972 setScrollWidth(
static_cast<int>( maxWidth ) );
977 disconnect(
this, &QgsCodeEditor::textChanged, mLastEditTimer, qOverload<>( &QTimer::start ) );
978 QsciScintilla::setText( text );
979 connect(
this, &QgsCodeEditor::textChanged, mLastEditTimer, qOverload<>( &QTimer::start ) );
986 return mLastEditTimer->interval();
991 mLastEditTimer->setInterval( timeout );
1004 updateHistory( { command } );
1010 mInterpreter->exec( command );
1029 if ( !mHistoryFilePath.isEmpty() && QFile::exists( mHistoryFilePath ) )
1031 QFile file( mHistoryFilePath );
1032 if ( !file.open( QFile::WriteOnly | QFile::Truncate ) )
1034 QgsDebugError( u
"Could not truncate %1"_s.arg( mHistoryFilePath ) );
1043 if ( mHistoryFilePath.isEmpty() )
1046 QFile f( mHistoryFilePath );
1047 if ( !f.open( QFile::WriteOnly | QIODevice::Truncate ) )
1052 QTextStream ts( &f );
1053 for (
const QString &command : std::as_const( mHistory ) )
1055 ts << command +
'\n';
1062 if ( mSoftHistoryIndex < mSoftHistory.length() - 1 && !mSoftHistory.isEmpty() )
1064 mSoftHistoryIndex += 1;
1065 setText( mSoftHistory[mSoftHistoryIndex] );
1072 if ( mSoftHistoryIndex > 0 && !mSoftHistory.empty() )
1074 mSoftHistoryIndex -= 1;
1075 setText( mSoftHistory[mSoftHistoryIndex] );
1083 dialog->setAttribute( Qt::WA_DeleteOnClose );
1086 dialog->activateWindow();
1092 mHistory.removeAt( index );
1093 mSoftHistory.removeAt( index );
1094 if ( index < mSoftHistoryIndex )
1096 mSoftHistoryIndex -= 1;
1097 if ( mSoftHistoryIndex < 0 )
1098 mSoftHistoryIndex = mSoftHistory.length() - 1;
1105 if ( hasSelectedText() )
1107 replaceSelectedText( text );
1112 getCursorPosition( &line, &index );
1113 insertAt( text, line, index );
1114 setCursorPosition( line, index + text.length() );
1124 useDefault = !info.exists();
1127 if ( theme.isEmpty() && useDefault )
1130 const QPalette
pal = qApp->palette();
1135 return pal.color( QPalette::Highlight );
1137 return pal.color( QPalette::HighlightedText );
1142 else if ( theme.isEmpty() )
1147 static const QMap<QgsCodeEditorColorScheme::ColorRole, QString> sColorRoleToIniKey {
1191 return scheme.
color( role );
1199 const QString theme = settings.
value( u
"codeEditor/colorScheme"_s, QString(),
QgsSettings::Gui ).toString();
1204 const QString
color = settings.
value( u
"codeEditor/%1"_s.arg( sColorRoleToSettingsKey.value( role ) ), QString(),
QgsSettings::Gui ).toString();
1212 if (
color.isValid() )
1225 return font.fixedPitch();
1230 QFont font = QFontDatabase::systemFont( QFontDatabase::FixedFont );
1233 if ( !settings.
value( u
"codeEditor/fontfamily"_s, QString(),
QgsSettings::Gui ).toString().isEmpty() )
1240 font.setPointSize( fontSize );
1244 font.setPointSize( QLabel().font().pointSize() );
1248 font.setPointSize( fontSize );
1251 const int fontSize = settings.
value( u
"qgis/stylesheet/fontPointSize"_s, 10 ).toInt();
1252 font.setPointSize( fontSize );
1255 font.setBold(
false );
1262 mUseDefaultSettings =
false;
1263 mOverrideColors = !customColors.isEmpty();
1264 mColorScheme = scheme;
1265 mCustomColors = customColors;
1266 mFontFamily = fontFamily;
1267 mFontSize = fontSize;
1276 markerAdd( lineNumber, MARKER_NUMBER );
1278 font.setItalic(
true );
1280 annotate( lineNumber, warning, styleAnn );
1281 mWarningLines.push_back( lineNumber );
1286 for (
const int line : mWarningLines )
1288 markerDelete( line );
1289 clearAnnotations( line );
1292 mWarningLines.clear();
1299 getCursorPosition( &line, &index );
1300 return line == lines() - 1;
1305 mHistoryFilePath = path;
1311 setCursorPosition( 0, 0 );
1312 ensureCursorVisible();
1313 ensureLineVisible( 0 );
1321 const int endLine = lines() - 1;
1322 const int endLineLength = lineLength( endLine );
1323 setCursorPosition( endLine, endLineLength );
1324 ensureCursorVisible();
1325 ensureLineVisible( endLine );
1333 return static_cast<int>( SendScintilla( SCI_GETCURRENTPOS ) );
1339 lineIndexFromPosition( linearIndex, &line, &index );
1340 setCursorPosition( line, index );
1345 int startLine, startIndex, _;
1346 getSelection( &startLine, &startIndex, &_, &_ );
1347 if ( startLine == -1 )
1351 return positionFromLineIndex( startLine, startIndex );
1356 int endLine, endIndex, _;
1357 getSelection( &_, &_, &endLine, &endIndex );
1358 if ( endLine == -1 )
1362 return positionFromLineIndex( endLine, endIndex );
1367 int startLine, startIndex, endLine, endIndex;
1368 lineIndexFromPosition( start, &startLine, &startIndex );
1369 lineIndexFromPosition( end, &endLine, &endIndex );
1370 setSelection( startLine, startIndex, endLine, endIndex );
1385 if ( wrapMode() == WrapNone )
1397 if ( SendScintilla( SCI_WRAPCOUNT, line ) <= 1 )
1403 const long endLine = SendScintilla( SCI_GETLINEENDPOSITION, line );
1405 const long y = SendScintilla( SCI_POINTYFROMPOSITION, 0, endLine );
1407 return static_cast<int>( SendScintilla( SCI_POSITIONFROMPOINT, 0, y ) );
1414 if ( callTipsStyle() == CallTipsNone || lexer() ==
nullptr )
1419 QsciAbstractAPIs *apis = lexer()->apis();
1424 int pos, commas = 0;
1432 while ( ( ch = getCharacter( pos ) ) !=
'\0' )
1436 else if ( ch ==
')' )
1442 while ( ( ch = getCharacter( pos ) ) !=
'\0' )
1446 else if ( ch ==
'(' && --depth == 0 )
1450 else if ( ch ==
'(' )
1458 SendScintilla( SCI_CALLTIPCANCEL );
1464 int contextStart, lastWordStart;
1465 QStringList context = apiContext( pos, contextStart, lastWordStart );
1467 if ( context.isEmpty() )
1471 context << QString();
1473 QList<int> ctShifts;
1474 QStringList ctEntries = apis->callTips( context, commas, callTipsStyle(), ctShifts );
1476 int nbEntries = ctEntries.count();
1478 if ( nbEntries == 0 )
1481 const int maxNumberOfCallTips = callTipsVisible();
1484 if ( maxNumberOfCallTips > 0 && maxNumberOfCallTips < nbEntries )
1486 ctEntries = ctEntries.mid( 0, maxNumberOfCallTips );
1487 nbEntries = maxNumberOfCallTips;
1493 int nbShifts = ctShifts.count();
1495 if ( maxNumberOfCallTips < 0 && nbEntries > 1 )
1497 shift = ( nbShifts > 0 ? ctShifts.first() : 0 );
1499 ct.prepend(
'\002' );
1503 if ( nbShifts > nbEntries )
1504 nbShifts = nbEntries;
1509 for (
int i = 0; i < nbShifts; ++i )
1511 int sh = ctShifts[i];
1517 ct = ctEntries.join(
"\n" );
1520 QByteArray ctBa = ct.toLatin1();
1521 const char *cts = ctBa.data();
1525 if ( currentWrapPosition != -1 )
1527 SendScintilla( SCI_CALLTIPSHOW, currentWrapPosition, cts );
1535 int ctmin =
static_cast<int>( SendScintilla( SCI_POSITIONFROMLINE, SendScintilla( SCI_LINEFROMPOSITION, ct ) ) );
1536 if ( lastWordStart - shift < ctmin )
1537 lastWordStart = ctmin;
1541 lineIndexFromPosition( lastWordStart, &line, &index );
1542 SendScintilla( SCI_CALLTIPSHOW, positionFromLineIndex( line, index ), cts );
1546 if ( nbEntries > 1 )
1553 astart = strchr( cts,
'(' );
1555 for ( astart = strchr( cts,
',' ); astart && --commas > 0; astart = strchr( astart + 1,
',' ) )
1569 for ( aend = astart; *aend; ++aend )
1573 if ( ch ==
',' && depth == 0 )
1575 else if ( ch ==
'(' )
1577 else if ( ch ==
')' )
1586 if ( astart != aend )
1587 SendScintilla( SCI_CALLTIPSETHLT, astart - cts, aend - cts );
1594char QgsCodeEditor::getCharacter(
int &pos )
const
1599 char ch =
static_cast<char>( SendScintilla( SCI_GETCHARAT, --pos ) );
1602 if ( ch ==
'\n' || ch ==
'\r' )
MessageLevel
Level for messages This will be used both for message log and message bar in application.
@ Warning
Warning message.
@ Critical
Critical/error message.
@ Info
Information message.
@ Success
Used for reporting a successful operation.
@ CheckSyntax
Language supports syntax checking.
@ Reformat
Language supports automatic code reformatting.
@ ToggleComment
Language supports comment toggling.
ScriptLanguage
Scripting languages.
@ QgisExpression
QGIS expressions.
@ Batch
Windows batch files.
@ Unknown
Unknown/other language.
QFlags< ScriptLanguageCapability > ScriptLanguageCapabilities
Script language capabilities.
static QPixmap getThemePixmap(const QString &name, const QColor &foreColor=QColor(), const QColor &backColor=QColor(), int size=16)
Helper to get a theme icon as a pixmap.
static QgsApplication * instance()
Returns the singleton instance of the QgsApplication.
static QIcon getThemeIcon(const QString &name, const QColor &fillColor=QColor(), const QColor &strokeColor=QColor())
Helper to get a theme icon.
static QString themeName()
Set the active theme to the specified theme.
QgsCodeEditorColorScheme scheme(const QString &id) const
Returns the color scheme with matching id.
Defines a color scheme for use in QgsCodeEditor widgets.
@ TripleSingleQuote
Triple single quote color.
@ CommentBlock
Comment block color.
@ QuotedOperator
Quoted operator color.
@ Decoration
Decoration color.
@ Identifier
Identifier color.
@ DoubleQuote
Double quote color.
@ QuotedIdentifier
Quoted identifier color.
@ SelectionForeground
Selection foreground color.
@ CommentLine
Line comment color.
@ FoldIconForeground
Fold icon foreground color.
@ MarginForeground
Margin foreground color.
@ ErrorBackground
Error background color.
@ MatchedBraceBackground
Matched brace background color.
@ Default
Default text color.
@ SearchMatchBackground
Background color for search matches.
@ CaretLine
Caret line color.
@ IndentationGuide
Indentation guide line.
@ Background
Background color.
@ SingleQuote
Single quote color.
@ MarginBackground
Margin background color.
@ SelectionBackground
Selection background color.
@ MatchedBraceForeground
Matched brace foreground color.
@ Operator
Operator color.
@ TripleDoubleQuote
Triple double quote color.
@ FoldIconHalo
Fold icon halo color.
QColor color(ColorRole role) const
Returns the color to use in the editor for the specified role.
A dialog for displaying and managing command history for a QgsCodeEditor widget.
bool eventFilter(QObject *watched, QEvent *event) override
void sessionHistoryCleared()
Emitted when the history of commands run in the current session is cleared.
static const QgsSettingsEntryBool * settingContextHelpHover
void showHistory()
Shows the command history dialog.
int wrapPosition(int line=-1)
Returns the linear position of the start of the last wrapped part for the specified line,...
QgsCodeEditor::Mode mode() const
Returns the code editor mode.
void setCustomAppearance(const QString &scheme=QString(), const QMap< QgsCodeEditorColorScheme::ColorRole, QColor > &customColors=QMap< QgsCodeEditorColorScheme::ColorRole, QColor >(), const QString &fontFamily=QString(), int fontSize=0)
Sets a custom appearance for the widget, disconnecting it from using the standard appearance taken fr...
int editingTimeoutInterval() const
Returns the timeout (in milliseconds) threshold for the editingTimeout() signal to be emitted after a...
@ OutputDisplay
Read only mode for display of command outputs.
@ ScriptEditor
Standard mode, allows for display and edit of entire scripts.
@ CommandInput
Command input mode.
void reformatCode()
Applies code reformatting to the editor.
virtual void toggleComment()
Toggle comment for the selected text.
void contextMenuEvent(QContextMenuEvent *event) override
void clearPersistentHistory()
Clears the entire persistent history of commands run in the editor.
void removeHistoryCommand(int index)
Removes the command at the specified index from the history of the code editor.
static void setColor(QgsCodeEditorColorScheme::ColorRole role, const QColor &color)
Sets the color to use in the editor for the specified role.
void setHistoryFilePath(const QString &path)
Sets the file path to use for recording and retrieving previously executed commands.
void setLinearSelection(int start, int end)
Convenience function to set the selection using linear indexes.
QStringList history() const
Returns the list of commands previously executed in the editor.
static constexpr int SEARCH_RESULT_INDICATOR
Indicator index for search results.
void keyPressEvent(QKeyEvent *event) override
virtual void moveCursorToStart()
Moves the cursor to the start of the document and scrolls to ensure it is visible.
virtual void populateContextMenu(QMenu *menu)
Called when the context menu for the widget is about to be shown, after it has been fully populated w...
QFlags< Flag > Flags
Flags controlling behavior of code editor.
void persistentHistoryCleared()
Emitted when the persistent history of commands run in the editor is cleared.
void runCommand(const QString &command, bool skipHistory=false)
Runs a command in the editor.
void setText(const QString &text) override
void setFoldingVisible(bool folding)
Set whether the folding controls are visible in the editor.
virtual Qgis::ScriptLanguageCapabilities languageCapabilities() const
Returns the associated scripting language capabilities.
void setEditingTimeoutInterval(int timeout)
Sets the timeout (in milliseconds) threshold for the editingTimeout() signal to be emitted after an e...
void setInterpreter(QgsCodeInterpreter *newInterpreter)
Sets an attached code interpreter for executing commands when the editor is in the QgsCodeEditor::Mod...
@ FoldingControls
Folding controls.
@ ErrorIndicators
Error indicators.
@ LineNumbers
Line numbers.
void runPostLexerConfigurationTasks()
Performs tasks which must be run after a lexer has been set for the widget.
bool event(QEvent *event) override
virtual void showMessage(const QString &title, const QString &message, Qgis::MessageLevel level)
Shows a user facing message (eg a warning message).
int selectionEnd() const
Convenience function to return the end of the selection as a linear index Contrary to the getSelectio...
virtual void initializeLexer()
Called when the dialect specific code lexer needs to be initialized (or reinitialized).
int linearPosition() const
Convenience function to return the cursor position as a linear index.
void setTitle(const QString &title)
Set the widget title.
void setLinearPosition(int position)
Convenience function to set the cursor position as a linear index.
QgsCodeEditor(QWidget *parent=nullptr, const QString &title=QString(), bool folding=false, bool margin=false, QgsCodeEditor::Flags flags=QgsCodeEditor::Flags(), QgsCodeEditor::Mode mode=QgsCodeEditor::Mode::ScriptEditor)
Construct a new code editor.
void clearWarnings()
Clears all warning messages from the editor.
static QFont getMonospaceFont()
Returns the monospaced font to use for code editors.
void showNextCommand()
Shows the next command from the session in the editor.
void focusOutEvent(QFocusEvent *event) override
@ CodeFolding
Indicates that code folding should be enabled for the editor.
@ ImmediatelyUpdateHistory
Indicates that the history file should be immediately updated whenever a command is executed,...
void helpRequested(const QString &word)
Emitted when documentation was requested for the specified word.
bool isCursorOnLastLine() const
Returns true if the cursor is on the last line of the document.
static bool isFixedPitch(const QFont &font)
Returns true if a font is a fixed pitch font.
void updateSoftHistory()
Updates the soft history by storing the current editor text in the history.
void clearSessionHistory()
Clears the history of commands run in the current session.
void insertText(const QString &text)
Insert text at cursor position, or replace any selected text if user has made a selection.
bool writeHistoryFile()
Stores the commands executed in the editor to the persistent history file.
virtual void moveCursorToEnd()
Moves the cursor to the end of the document and scrolls to ensure it is visible.
static QString languageToString(Qgis::ScriptLanguage language)
Returns a user-friendly, translated name of the specified script language.
void setLineNumbersVisible(bool visible)
Sets whether line numbers should be visible in the editor.
void adjustScrollWidth()
Adjust the width of the scroll bar to fit the content.
virtual Qgis::ScriptLanguage language() const
Returns the associated scripting language.
QFont lexerFont() const
Returns the font to use in the lexer.
void toggleLineComments(const QString &commentPrefix)
Toggles comment for selected lines with the given comment prefix.
virtual QString reformatCodeString(const QString &string)
Applies code reformatting to a string and returns the result.
QgsCodeInterpreter * interpreter() const
Returns the attached code interpreter, or nullptr if not set.
bool lineNumbersVisible() const
Returns whether line numbers are visible in the editor.
QColor lexerColor(QgsCodeEditorColorScheme::ColorRole role) const
Returns the color to use in the lexer for the specified role.
bool foldingVisible()
Returns true if the folding controls are visible in the editor.
void showPreviousCommand()
Shows the previous command from the session in the editor.
Q_DECL_DEPRECATED void setMarginVisible(bool margin)
Set margin visible state.
void updatePrompt()
Triggers an update of the interactive prompt part of the editor.
void editingTimeout()
Emitted when either:
static QColor defaultColor(QgsCodeEditorColorScheme::ColorRole role, const QString &theme=QString())
Returns the default color for the specified role.
int selectionStart() const
Convenience function to return the start of the selection as a linear index Contrary to the getSelect...
void addWarning(int lineNumber, const QString &warning)
Adds a warning message and indicator to the specified a lineNumber.
virtual bool checkSyntax()
Applies syntax checking to the editor.
static QColor color(QgsCodeEditorColorScheme::ColorRole role)
Returns the color to use in the editor for the specified role.
An interface for code interpreters.
virtual int execCommandImpl(const QString &command)=0
Pure virtual method for executing commands in the interpreter.
int exec(const QString &command)
Executes a command in the interpreter.
virtual ~QgsCodeInterpreter()
static void setFontFamily(QFont &font, const QString &family)
Sets the family for a font object.
static QgsShortcutsManager * shortcutsManager()
Returns the global shortcuts manager, used for managing a QAction and QShortcut sequences.
void optionsChanged()
This signal is emitted whenever the application options have been changed.
static QgsGui * instance()
Returns a pointer to the singleton instance.
static QgsCodeEditorColorSchemeRegistry * codeEditorColorSchemeRegistry()
Returns the global code editor color scheme registry, used for registering the color schemes for QgsC...
A boolean settings entry.
Stores settings for use within QGIS.
QVariant value(const QString &key, const QVariant &defaultValue=QVariant(), Section section=NoSection) const
Returns the value for setting key.
void remove(const QString &key, QgsSettings::Section section=QgsSettings::NoSection)
Removes the setting key and any sub-settings of key in a section.
void setValue(const QString &key, const QVariant &value, QgsSettings::Section section=QgsSettings::NoSection)
Sets the value of setting key to value.
@ CodeReformat
Reformat code.
@ CodeToggleComment
Toggle code comments.
QKeySequence sequenceForCommonAction(CommonAction action) const
Returns the key sequence which is associated with a common action, or an empty sequence if no shortcu...
static int levenshteinDistance(const QString &string1, const QString &string2, bool caseSensitive=false)
Returns the Levenshtein edit distance between two strings.
static QColor decodeColor(const QString &str)
#define BUILTIN_UNREACHABLE
int findMinimalDistanceIndex(const QString &source, const QString &target)
#define QgsDebugError(str)