Class: QgsCodeEditor¶

class qgis.gui.QgsCodeEditor(parent: QWidget = None, title: str = '', folding: bool = False, margin: bool = False)¶

Bases: PyQt5.Qsci.QsciScintilla

Construct a new code editor.

Parameters

parent (QWidget = None) – The parent QWidget
title (str = '') – The title to show in the code editor dialog
folding (bool = False) – False: Enable folding for code editor
margin (bool = False) – False: Enable margin for code editor (deprecated)

New in version 2.6.

A text editor based on QScintilla2.

Note

may not be available in Python bindings, depending on platform support

Methods

`actionEvent`
`addWarning`	Adds a `warning` message and indicator to the specified a `lineNumber`.
`canInsertFromMimeData`
`changeEvent`
`childEvent`
`clearWarnings`	Clears all warning messages from the editor.
`closeEvent`
`color`	Returns the color to use in the editor for the specified `role`.
`connectNotify`
`contextMenuEvent`
`create`
`customEvent`
`defaultColor`	Returns the default color for the specified `role`.
`destroy`
`disconnectNotify`
`dragEnterEvent`
`dragLeaveEvent`
`dragMoveEvent`
`drawFrame`
`dropEvent`
`enterEvent`
`event`
`eventFilter`
`focusInEvent`
`focusNextChild`
`focusNextPrevChild`
`focusOutEvent`	param event
`focusPreviousChild`
`foldingVisible`	Returns `True` if the folding controls are visible in the editor.
`fromMimeData`
`getMonospaceFont`	Returns the monospaced font to use for code editors.
`hideEvent`
`initPainter`
`initStyleOption`
`initializeLexer`	Called when the dialect specific code lexer needs to be initialized (or reinitialized).
`inputMethodEvent`
`inputMethodQuery`
`insertText`	Insert text at cursor position, or replace any selected text if user has made a selection.
`isFixedPitch`	param font
`isSignalConnected`
`keyPressEvent`	param event
`keyReleaseEvent`
`leaveEvent`
`lexerColor`	Returns the color to use in the lexer for the specified `role`.
`lexerFont`	Returns the font to use in the lexer.
`lineNumbersVisible`	Returns whether line numbers are visible in the editor.
`marginVisible`	Returns whether margins are in a visible state
`metric`
`mouseDoubleClickEvent`
`mouseMoveEvent`
`mousePressEvent`
`mouseReleaseEvent`
`moveEvent`
`nativeEvent`
`paintEvent`
`receivers`
`resizeEvent`
`runPostLexerConfigurationTasks`	Performs tasks which must be run after a lexer has been set for the widget.
`scrollContentsBy`
`sender`
`senderSignalIndex`
`setColor`	Sets the `color` to use in the editor for the specified `role`.
`setFoldingVisible`	Set whether the folding controls are visible in the editor.
`setLineNumbersVisible`	Sets whether line numbers should be visible in the editor.
`setMarginVisible`	Set margin visible state
`setTitle`	Set the widget title
`setViewportMargins`	setViewportMargins(self, QMargins)
`sharedPainter`
`showEvent`
`tabletEvent`
`timerEvent`
`toMimeData`
`updateMicroFocus`
`viewportEvent`
`viewportMargins`
`viewportSizeHint`
`wheelEvent`

Attributes

`ErrorIndicators`
`FoldingControls`
`LineNumbers`

ErrorIndicators = 1¶

FoldingControls = 2¶

LineNumbers = 0¶

class MarginRole¶: Bases: int

actionEvent(self, QActionEvent)¶

addWarning(self, lineNumber: int, warning: str)¶

Adds a warning message and indicator to the specified a lineNumber.

See also

clearWarnings()

New in version 3.16.

Parameters

lineNumber (int) –
warning (str) –

canInsertFromMimeData(self, QMimeData) → bool¶

changeEvent(self, QEvent)¶

childEvent(self, QChildEvent)¶

clearWarnings(self)¶: Clears all warning messages from the editor.

See also

addWarning()

New in version 3.16.

closeEvent(self, QCloseEvent)¶

color(role: QgsCodeEditorColorScheme.ColorRole) → QColor¶

Returns the color to use in the editor for the specified role.

This color will be the default theme color for the role, unless the user has manually selected a custom color scheme for the editor.

See also

setColor()

New in version 3.16.

Parameters: role (QgsCodeEditorColorScheme.ColorRole) –
Return type: QColor

connectNotify(self, QMetaMethod)¶

contextMenuEvent(self, QContextMenuEvent)¶

create(self, window: sip.voidptr = 0, initializeWindow: bool = True, destroyOldWindow: bool = True)¶

customEvent(self, QEvent)¶

defaultColor(role: QgsCodeEditorColorScheme.ColorRole, theme: str = '') → QColor¶

Returns the default color for the specified role.

The optional theme argument can be used to specify a color theme. A blank theme indicates the default color scheme.

Available themes are stored in QgsCodeEditorColorSchemeRegistry, and can be retrieved via QgsGui.codeEditorColorSchemeRegistry().

New in version 3.16.

Parameters

role (QgsCodeEditorColorScheme.ColorRole) –
theme (str = '') –

Return type

QColor

destroy(self, destroyWindow: bool = True, destroySubWindows: bool = True)¶

disconnectNotify(self, QMetaMethod)¶

dragEnterEvent(self, QDragEnterEvent)¶

dragLeaveEvent(self, QDragLeaveEvent)¶

dragMoveEvent(self, QDragMoveEvent)¶

drawFrame(self, QPainter)¶

dropEvent(self, QDropEvent)¶

enterEvent(self, QEvent)¶

event(self, QEvent) → bool¶

eventFilter(self, QObject, QEvent) → bool¶

focusInEvent(self, QFocusEvent)¶

focusNextChild(self) → bool¶

focusNextPrevChild(self, bool) → bool¶

focusOutEvent(self, event: QFocusEvent)¶

Parameters: event (QFocusEvent) –

focusPreviousChild(self) → bool¶

foldingVisible(self) → bool¶

Returns True if the folding controls are visible in the editor.

See also

setFoldingVisible()

Return type: bool

fromMimeData(self, QMimeData) → Tuple[QByteArray, bool]¶

getMonospaceFont() → QFont¶

Returns the monospaced font to use for code editors.

New in version 3.16.

Return type: QFont

hideEvent(self, QHideEvent)¶

initPainter(self, QPainter)¶

initStyleOption(self, QStyleOptionFrame)¶

initializeLexer(self)¶

Called when the dialect specific code lexer needs to be initialized (or reinitialized).

The default implementation does nothing.

New in version 3.16.

inputMethodEvent(self, QInputMethodEvent)¶

inputMethodQuery(self, Qt.InputMethodQuery) → Any¶

insertText(self, text: str)¶

Insert text at cursor position, or replace any selected text if user has made a selection.

Parameters: text (str) – The text to be inserted

isFixedPitch(self, font: QFont) → bool¶

Parameters: font (QFont) –
Return type: bool

isSignalConnected(self, QMetaMethod) → bool¶

keyPressEvent(self, event: QKeyEvent)¶

Parameters: event (QKeyEvent) –

keyReleaseEvent(self, QKeyEvent)¶

leaveEvent(self, QEvent)¶

lexerColor(self, role: QgsCodeEditorColorScheme.ColorRole) → QColor¶

Returns the color to use in the lexer for the specified role.

New in version 3.16.

Parameters: role (QgsCodeEditorColorScheme.ColorRole) –
Return type: QColor

lexerFont(self) → QFont¶

Returns the font to use in the lexer.

New in version 3.16.

Return type: QFont

lineNumbersVisible(self) → bool¶

Returns whether line numbers are visible in the editor.

See also

setLineNumbersVisible()

New in version 3.16.

Return type: bool

marginVisible(self) → bool¶

Returns whether margins are in a visible state

Deprecated since version Use: base class methods for individual margins instead, or lineNumbersVisible()

Return type: bool

metric(self, QPaintDevice.PaintDeviceMetric) → int¶

mouseDoubleClickEvent(self, QMouseEvent)¶

mouseMoveEvent(self, QMouseEvent)¶

mousePressEvent(self, QMouseEvent)¶

mouseReleaseEvent(self, QMouseEvent)¶

moveEvent(self, QMoveEvent)¶

nativeEvent(self, Union[QByteArray, bytes, bytearray], sip.voidptr) → Tuple[bool, int]¶

paintEvent(self, QPaintEvent)¶

receivers(self, PYQT_SIGNAL) → int¶

resizeEvent(self, QResizeEvent)¶

runPostLexerConfigurationTasks(self)¶: Performs tasks which must be run after a lexer has been set for the widget.

New in version 3.16.

QgsCodeEditor.scrollContentsBy(self, int, int)

sender(self) → QObject¶

senderSignalIndex(self) → int¶

setColor(role: QgsCodeEditorColorScheme.ColorRole, color: Union[QColor, Qt.GlobalColor, QGradient])¶

Sets the color to use in the editor for the specified role.

This color will be stored as the new default color for the role, to be used for all code editors.

Set color to an invalid QColor in order to clear the stored color value and reset it to the default color.

See also

color()

New in version 3.16.

Parameters

role (QgsCodeEditorColorScheme.ColorRole) –
color (Union[QColor) –

setFoldingVisible(self, folding: bool)¶

Set whether the folding controls are visible in the editor.

See also

foldingVisible()

Parameters: folding (bool) –

setLineNumbersVisible(self, visible: bool)¶

Sets whether line numbers should be visible in the editor.

Defaults to False.

See also

lineNumbersVisible()

New in version 3.16.

Parameters: visible (bool) –

setMarginVisible(self, margin: bool)¶

Set margin visible state

Parameters: margin (bool) – Set margin in the editor

Deprecated since version Use: base class methods for individual margins instead, or setLineNumbersVisible()

setTitle(self, title: str)¶

Set the widget title

Parameters: title (str) – widget title

QgsCodeEditor.setViewportMargins(self, int, int, int, int): setViewportMargins(self, QMargins)

sharedPainter(self) → QPainter¶

showEvent(self, QShowEvent)¶

tabletEvent(self, QTabletEvent)¶

timerEvent(self, QTimerEvent)¶

toMimeData(self, Union[QByteArray, bytes, bytearray], bool) → QMimeData¶

updateMicroFocus(self)¶

viewportEvent(self, QEvent) → bool¶

viewportMargins(self) → QMargins¶

viewportSizeHint(self) → QSize¶

wheelEvent(self, QWheelEvent)¶