Class: QgsTextFormatWidget

class qgis.gui.QgsTextFormatWidget

Bases: PyQt5.QtWidgets.QWidget, QgsExpressionContextGenerator

A widget for customizing text formatting settings.

QgsTextFormatWidget provides a widget for controlling the appearance of text rendered using QgsTextRenderer. The widget includes all settings contained within a QgsTextFormat, including shadow, background and buffer.

Additionally, the widget can handle labeling settings due to the large overlap between the text renderer settings and the labeling settings. This mode is possible by subclassing QgsTextFormatWidget and calling the protected constructor with a mode of Labeling.

New in version 3.0.

QgsTextFormatWidget(format: QgsTextFormat = QgsTextFormat(), mapCanvas: QgsMapCanvas = None, parent: QWidget = None, layer: QgsVectorLayer = None) Constructor for QgsTextFormatWidget.

Parameters:
  • format – initial formatting settings to show in widget

  • mapCanvas – associated map canvas

  • parent – parent widget

  • layer – associated vector layer

QgsTextFormatWidget(mapCanvas: QgsMapCanvas, parent: QWidget, mode: QgsTextFormatWidget.Mode, layer: QgsVectorLayer = None) Constructor for QgsTextFormatWidget.

Parameters:
Labeling = 1
class Mode

Bases: int

Text = 0
actionEvent(self, QActionEvent)
auxiliaryFieldCreated

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

Parameters:
  • name (str = ...) –

  • revision (int = ...) –

  • arguments (Sequence = ...) –

Return type:

PYQT_SIGNAL

changeEvent(self, QEvent)
childEvent(self, QChildEvent)
closeEvent(self, QCloseEvent)
connectNotify(self, QMetaMethod)
context(self) QgsSymbolWidgetContext

Returns the context in which the widget is shown, e.g., the associated map canvas and expression contexts.

See also

setContext()

New in version 3.10.

Return type:

QgsSymbolWidgetContext

contextMenuEvent(self, QContextMenuEvent)
create(self, window: PyQt5.sip.voidptr = 0, initializeWindow: bool = True, destroyOldWindow: bool = True)
createExpressionContext(self) QgsExpressionContext
Return type:

QgsExpressionContext

customEvent(self, QEvent)
deactivateField(self, key: QgsPalLayerSettings.Property)

Deactivate a field from data defined properties and update the corresponding button.

Parameters:

key (QgsPalLayerSettings.Property) – The property key to deactivate

New in version 3.0.

destroy(self, destroyWindow: bool = True, destroySubWindows: bool = True)
disconnectNotify(self, QMetaMethod)
dragEnterEvent(self, QDragEnterEvent)
dragLeaveEvent(self, QDragLeaveEvent)
dragMoveEvent(self, QDragMoveEvent)
dropEvent(self, QDropEvent)
enableDataDefinedAlignment(self, enable: bool)

Controls whether data defined alignment buttons are enabled.

Parameters:

enable (bool) – set to True to enable alignment controls

enterEvent(self, QEvent)
event(self, QEvent) bool
focusInEvent(self, QFocusEvent)
focusNextChild(self) bool
focusNextPrevChild(self, bool) bool
focusOutEvent(self, QFocusEvent)
focusPreviousChild(self) bool
format(self, includeDataDefinedProperties: bool = True) QgsTextFormat

Returns the current formatting settings defined by the widget.

If includateDataDefinedProperties is True, then data defined properties specified in the widget will be included in the format definition.

Parameters:

includeDataDefinedProperties (bool = True) –

Return type:

QgsTextFormat

hideEvent(self, QHideEvent)
initPainter(self, QPainter)
inputMethodEvent(self, QInputMethodEvent)
isSignalConnected(self, QMetaMethod) bool
keyPressEvent(self, QKeyEvent)
keyReleaseEvent(self, QKeyEvent)
labelGeometryType(self) QgsWkbTypes.GeometryType

Returns the geometry type which will be used by the labeling engine when registering labels for the labeling settings currently defined by the widget.

New in version 3.16.

Return type:

QgsWkbTypes.GeometryType

leaveEvent(self, QEvent)
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], PyQt5.sip.voidptr) Tuple[bool, int]
paintEvent(self, QPaintEvent)
receivers(self, PYQT_SIGNAL) int
resizeEvent(self, QResizeEvent)
saveFormat(self)

Saves the current text settings to a style entry.

sender(self) QObject
senderSignalIndex(self) int
setContext(self, context: QgsSymbolWidgetContext)

Sets the context in which the widget is shown, e.g., the associated map canvas and expression contexts.

See also

context()

New in version 3.10.

Parameters:

context (QgsSymbolWidgetContext) –

setDockMode(self, enabled: bool)

Sets whether the widget should be shown in a compact dock mode.

Parameters:

enabled (bool) – set to True to show in dock mode.

setFormat(self, format: QgsTextFormat)

Sets the current formatting settings

New in version 3.2.

Parameters:

format (QgsTextFormat) –

setFormatFromStyle(self, name: str, type: QgsStyle.StyleEntity)

Sets the current text settings from a style entry.

New in version 3.10.

Parameters:
setPreviewBackground(self, color: QColor | Qt.GlobalColor | QGradient)

Sets the background color for the text preview widget.

Parameters:

color (Union[QColor) – background color

sharedPainter(self) QPainter
showEvent(self, QShowEvent)
tabletEvent(self, QTabletEvent)
timerEvent(self, QTimerEvent)
updateLinePlacementOptions(self)

Updates line placement options to reflect current state of widget

updateMicroFocus(self)
updatePlacementWidgets(self)

Updates label placement options to reflect current state of widget

updatePreview(self)

Updates the text preview.

New in version 3.10.

updateWidgetForFormat(self, format: QgsTextFormat)

Updates the widget’s state to reflect the settings in a QgsTextFormat.

Parameters:

format (QgsTextFormat) – source format

wheelEvent(self, QWheelEvent)
widgetChanged

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

Parameters:
  • name (str = ...) –

  • revision (int = ...) –

  • arguments (Sequence = ...) –

Return type:

PYQT_SIGNAL