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 – The parent QWidget

  • title – The title to show in the code editor dialog

  • foldingFalse: Enable folding for code editor

  • marginFalse: 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

New in version 2.6:

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

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
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.

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.

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
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.

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) None
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)