Container for settings relating to a text background object. More...

#include <qgstextbackgroundsettings.h>

Public Types
enum	RotationType { RotationSync = 0 , RotationOffset , RotationFixed }
	Methods for determining the rotation of the background shape. More...

enum	ShapeType { ShapeRectangle = 0 , ShapeSquare , ShapeEllipse , ShapeCircle , ShapeSVG , ShapeMarkerSymbol }
	Background shape types. More...

enum	SizeType { SizeBuffer = 0 , SizeFixed , SizePercent }
	Methods for determining the background shape size. More...

Public Member Functions
	QgsTextBackgroundSettings ()

	QgsTextBackgroundSettings (const QgsTextBackgroundSettings &other)
	Copy constructor. More...

	~QgsTextBackgroundSettings ()

QPainter::CompositionMode	blendMode () const
	Returns the blending mode used for drawing the background shape. More...

bool	enabled () const
	Returns whether the background is enabled. More...

QColor	fillColor () const
	Returns the color used for filing the background shape. More...

QgsFillSymbol *	fillSymbol () const
	Returns the fill symbol to be rendered in the background. More...

Qt::PenJoinStyle	joinStyle () const
	Returns the join style used for drawing the background shape. More...

QgsMarkerSymbol *	markerSymbol () const
	Returns the marker symbol to be rendered in the background. More...

QPointF	offset () const
	Returns the offset used for drawing the background shape. More...

QgsMapUnitScale	offsetMapUnitScale () const
	Returns the map unit scale object for the shape offset. More...

QgsUnitTypes::RenderUnit	offsetUnit () const
	Returns the units used for the shape's offset. More...

double	opacity () const
	Returns the background shape's opacity. More...

bool	operator!= (const QgsTextBackgroundSettings &other) const

QgsTextBackgroundSettings &	operator= (const QgsTextBackgroundSettings &other)

bool	operator== (const QgsTextBackgroundSettings &other) const

const QgsPaintEffect *	paintEffect () const
	Returns the current paint effect for the background shape. More...

QSizeF	radii () const
	Returns the radii used for rounding the corners of shapes. More...

QgsMapUnitScale	radiiMapUnitScale () const
	Returns the map unit scale object for the shape radii. More...

QgsUnitTypes::RenderUnit	radiiUnit () const
	Returns the units used for the shape's radii. More...

void	readFromLayer (QgsVectorLayer *layer)
	Reads settings from a layer's custom properties (for QGIS 2.x projects). More...

void	readXml (const QDomElement &elem, const QgsReadWriteContext &context)
	Read settings from a DOM element. More...

QSet< QString >	referencedFields (const QgsRenderContext &context) const
	Returns all field names referenced by the configuration (e.g. More...

double	rotation () const
	Returns the rotation for the background shape, in degrees clockwise. More...

RotationType	rotationType () const
	Returns the method used for rotating the background shape. More...

void	setBlendMode (QPainter::CompositionMode mode)
	Sets the blending mode used for drawing the background shape. More...

void	setEnabled (bool enabled)
	Sets whether the text background will be drawn. More...

void	setFillColor (const QColor &color)
	Sets the color used for filing the background shape. More...

void	setFillSymbol (QgsFillSymbol *symbol)
	Sets the current fill symbol for the background shape. More...

void	setJoinStyle (Qt::PenJoinStyle style)
	Sets the join style used for drawing the background shape. More...

void	setMarkerSymbol (QgsMarkerSymbol *symbol)
	Sets the current marker symbol for the background shape. More...

void	setOffset (QPointF offset)
	Sets the offset used for drawing the background shape. More...

void	setOffsetMapUnitScale (const QgsMapUnitScale &scale)
	Sets the map unit scale object for the shape offset. More...

void	setOffsetUnit (QgsUnitTypes::RenderUnit units)
	Sets the units used for the shape's offset. More...

void	setOpacity (double opacity)
	Sets the background shape's opacity. More...

void	setPaintEffect (QgsPaintEffect *effect)
	Sets the current paint effect for the background shape. More...

void	setRadii (QSizeF radii)
	Sets the radii used for rounding the corners of shapes. More...

void	setRadiiMapUnitScale (const QgsMapUnitScale &scale)
	Sets the map unit scale object for the shape radii. More...

void	setRadiiUnit (QgsUnitTypes::RenderUnit units)
	Sets the units used for the shape's radii. More...

void	setRotation (double rotation)
	Sets the rotation for the background shape, in degrees clockwise. More...

void	setRotationType (RotationType type)
	Sets the method used for rotating the background shape. More...

void	setSize (QSizeF size)
	Sets the size of the background shape. More...

void	setSizeMapUnitScale (const QgsMapUnitScale &scale)
	Sets the map unit scale object for the shape size. More...

void	setSizeType (SizeType type)
	Sets the method used to determine the size of the background shape (e.g., fixed size or buffer around text). More...

void	setSizeUnit (QgsUnitTypes::RenderUnit unit)
	Sets the units used for the shape's size. More...

void	setStrokeColor (const QColor &color)
	Sets the color used for outlining the background shape. More...

void	setStrokeWidth (double width)
	Sets the width of the shape's stroke (stroke). More...

void	setStrokeWidthMapUnitScale (const QgsMapUnitScale &scale)
	Sets the map unit scale object for the shape stroke width. More...

void	setStrokeWidthUnit (QgsUnitTypes::RenderUnit units)
	Sets the units used for the shape's stroke width. More...

void	setSvgFile (const QString &file)
	Sets the path to the background SVG file. More...

void	setType (ShapeType type)
	Sets the type of background shape to draw (e.g., square, ellipse, SVG). More...

QSizeF	size () const
	Returns the size of the background shape. More...

QgsMapUnitScale	sizeMapUnitScale () const
	Returns the map unit scale object for the shape size. More...

SizeType	sizeType () const
	Returns the method used to determine the size of the background shape (e.g., fixed size or buffer around text). More...

QgsUnitTypes::RenderUnit	sizeUnit () const
	Returns the units used for the shape's size. More...

QColor	strokeColor () const
	Returns the color used for outlining the background shape. More...

double	strokeWidth () const
	Returns the width of the shape's stroke (stroke). More...

QgsMapUnitScale	strokeWidthMapUnitScale () const
	Returns the map unit scale object for the shape stroke width. More...

QgsUnitTypes::RenderUnit	strokeWidthUnit () const
	Returns the units used for the shape's stroke width. More...

QString	svgFile () const
	Returns the absolute path to the background SVG file, if set. More...

ShapeType	type () const
	Returns the type of background shape (e.g., square, ellipse, SVG). More...

void	updateDataDefinedProperties (QgsRenderContext &context, const QgsPropertyCollection &properties)
	Updates the format by evaluating current values of data defined properties. More...

void	upgradeDataDefinedProperties (QgsPropertyCollection &properties)
	Upgrade data defined properties when reading a project file saved in QGIS prior to version 3.20. More...

QDomElement	writeXml (QDomDocument &doc, const QgsReadWriteContext &context) const
	Write settings into a DOM element. More...

Detailed Description

Container for settings relating to a text background object.

Note: QgsTextBackgroundSettings objects are implicitly shared.

Since: QGIS 3.0

Definition at line 46 of file qgstextbackgroundsettings.h.

Member Enumeration Documentation

◆ RotationType

enum QgsTextBackgroundSettings::RotationType

Methods for determining the rotation of the background shape.

Enumerator
RotationSync	Shape rotation is synced with text rotation.
RotationOffset	Shape rotation is offset from text rotation.
RotationFixed	Shape rotation is a fixed angle.

Definition at line 76 of file qgstextbackgroundsettings.h.

◆ ShapeType

enum QgsTextBackgroundSettings::ShapeType

Background shape types.

Enumerator
ShapeRectangle	Rectangle.
ShapeSquare	Square - buffered sizes only.
ShapeEllipse	Ellipse.
ShapeCircle	Circle.
ShapeSVG	SVG file.
ShapeMarkerSymbol	Marker symbol.

Definition at line 53 of file qgstextbackgroundsettings.h.

◆ SizeType

enum QgsTextBackgroundSettings::SizeType

Methods for determining the background shape size.

Enumerator
SizeBuffer	Shape size is determined by adding a buffer margin around text.
SizeFixed	Fixed size.
SizePercent	Shape size is determined by percent of text size.

Definition at line 66 of file qgstextbackgroundsettings.h.

Constructor & Destructor Documentation

◆ QgsTextBackgroundSettings() [1/2]

QgsTextBackgroundSettings::QgsTextBackgroundSettings ( )

Definition at line 26 of file qgstextbackgroundsettings.cpp.

◆ QgsTextBackgroundSettings() [2/2]

QgsTextBackgroundSettings::QgsTextBackgroundSettings ( const QgsTextBackgroundSettings & other )

Copy constructor.

Parameters

other source QgsTextBackgroundSettings

Definition at line 43 of file qgstextbackgroundsettings.cpp.

◆ ~QgsTextBackgroundSettings()

QgsTextBackgroundSettings::~QgsTextBackgroundSettings ( )

Definition at line 55 of file qgstextbackgroundsettings.cpp.

Member Function Documentation

◆ blendMode()

QPainter::CompositionMode QgsTextBackgroundSettings::blendMode ( ) const

Returns the blending mode used for drawing the background shape.

See also: setBlendMode()

Definition at line 287 of file qgstextbackgroundsettings.cpp.

◆ enabled()

bool QgsTextBackgroundSettings::enabled ( ) const

Returns whether the background is enabled.

See also: setEnabled()

Definition at line 107 of file qgstextbackgroundsettings.cpp.

◆ fillColor()

QColor QgsTextBackgroundSettings::fillColor ( ) const

Returns the color used for filing the background shape.

See also: setFillColor(); strokeColor()

Note: As of QGIS 3.20, using this function is only recommended for SVG backgrounds, while other background types should be configured through their symbols.

Definition at line 297 of file qgstextbackgroundsettings.cpp.

◆ fillSymbol()

QgsFillSymbol * QgsTextBackgroundSettings::fillSymbol ( ) const

Returns the fill symbol to be rendered in the background.

Ownership remains with the background settings.

Note: This is only used when the type() is QgsTextBackgroundSettings::ShapeRectangle, QgsTextBackgroundSettings::ShapeSquare, QgsTextBackgroundSettings::ShapeCircle or QgsTextBackgroundSettings::ShapeEllipse

See also: setFillSymbol()

Since: QGIS 3.20

Definition at line 147 of file qgstextbackgroundsettings.cpp.

◆ joinStyle()

Qt::PenJoinStyle QgsTextBackgroundSettings::joinStyle ( ) const

Returns the join style used for drawing the background shape.

See also: setJoinStyle

Definition at line 369 of file qgstextbackgroundsettings.cpp.

◆ markerSymbol()

QgsMarkerSymbol * QgsTextBackgroundSettings::markerSymbol ( ) const

Returns the marker symbol to be rendered in the background.

Ownership remains with the background settings.

Note: This is only used when the type() is QgsTextBackgroundSettings::ShapeMarkerSymbol.

See also: setMarkerSymbol()

Since: QGIS 3.10

Definition at line 137 of file qgstextbackgroundsettings.cpp.

◆ offset()

QPointF QgsTextBackgroundSettings::offset ( ) const

Returns the offset used for drawing the background shape.

Units are determined via offsetUnit().

See also: setOffset(); offsetUnit()

Definition at line 217 of file qgstextbackgroundsettings.cpp.

◆ offsetMapUnitScale()

QgsMapUnitScale QgsTextBackgroundSettings::offsetMapUnitScale ( ) const

Returns the map unit scale object for the shape offset.

This is only used if the offsetUnit() is set to QgsUnitTypes::RenderMapUnit.

See also: setOffsetMapUnitScale(); offsetUnit()

Definition at line 237 of file qgstextbackgroundsettings.cpp.

◆ offsetUnit()

QgsUnitTypes::RenderUnit QgsTextBackgroundSettings::offsetUnit ( ) const

Returns the units used for the shape's offset.

See also: setOffsetUnit(); offset()

Definition at line 227 of file qgstextbackgroundsettings.cpp.

◆ opacity()

double QgsTextBackgroundSettings::opacity ( ) const

Returns the background shape's opacity.

The opacity is a double value between 0 (fully transparent) and 1 (totally opaque).

See also: setOpacity()

Definition at line 277 of file qgstextbackgroundsettings.cpp.

◆ operator!=()

bool QgsTextBackgroundSettings::operator!= ( const QgsTextBackgroundSettings & other ) const

Definition at line 102 of file qgstextbackgroundsettings.cpp.

◆ operator=()

QgsTextBackgroundSettings & QgsTextBackgroundSettings::operator= ( const QgsTextBackgroundSettings & other )

Definition at line 49 of file qgstextbackgroundsettings.cpp.

◆ operator==()

bool QgsTextBackgroundSettings::operator== ( const QgsTextBackgroundSettings & other ) const

Definition at line 60 of file qgstextbackgroundsettings.cpp.

◆ paintEffect()

const QgsPaintEffect * QgsTextBackgroundSettings::paintEffect ( ) const

Returns the current paint effect for the background shape.

Returns: paint effect

See also: setPaintEffect()

Definition at line 383 of file qgstextbackgroundsettings.cpp.

◆ radii()

QSizeF QgsTextBackgroundSettings::radii ( ) const

Returns the radii used for rounding the corners of shapes.

Units are retrieved through radiiUnit().

See also: setRadii(); radiiUnit()

Definition at line 247 of file qgstextbackgroundsettings.cpp.

◆ radiiMapUnitScale()

QgsMapUnitScale QgsTextBackgroundSettings::radiiMapUnitScale ( ) const

Returns the map unit scale object for the shape radii.

This is only used if the radiiUnit() is set to QgsUnitTypes::RenderMapUnit.

See also: setRadiiMapUnitScale(); radiiUnit()

Definition at line 267 of file qgstextbackgroundsettings.cpp.

◆ radiiUnit()

QgsUnitTypes::RenderUnit QgsTextBackgroundSettings::radiiUnit ( ) const

Returns the units used for the shape's radii.

See also: setRadiiUnit(); radii()

Definition at line 257 of file qgstextbackgroundsettings.cpp.

◆ readFromLayer()

void QgsTextBackgroundSettings::readFromLayer ( QgsVectorLayer * layer )

Reads settings from a layer's custom properties (for QGIS 2.x projects).

Parameters

layer source vector layer

Definition at line 393 of file qgstextbackgroundsettings.cpp.

◆ readXml()

void QgsTextBackgroundSettings::readXml	(	const QDomElement &	elem,
		const QgsReadWriteContext &	context
	)

Read settings from a DOM element.

See also: writeXml()

Definition at line 521 of file qgstextbackgroundsettings.cpp.

◆ referencedFields()

QSet< QString > QgsTextBackgroundSettings::referencedFields ( const QgsRenderContext & context ) const

Returns all field names referenced by the configuration (e.g.

from data defined properties).

Since: QGIS 3.14

Definition at line 942 of file qgstextbackgroundsettings.cpp.

◆ rotation()

double QgsTextBackgroundSettings::rotation ( ) const

Returns the rotation for the background shape, in degrees clockwise.

See also: rotationType(); setRotation()

Definition at line 207 of file qgstextbackgroundsettings.cpp.

◆ rotationType()

QgsTextBackgroundSettings::RotationType QgsTextBackgroundSettings::rotationType ( ) const

Returns the method used for rotating the background shape.

See also: setRotationType(); rotation()

Definition at line 197 of file qgstextbackgroundsettings.cpp.

◆ setBlendMode()

void QgsTextBackgroundSettings::setBlendMode ( QPainter::CompositionMode mode )

Sets the blending mode used for drawing the background shape.

Parameters

mode	blending mode

See also: blendMode()

Definition at line 292 of file qgstextbackgroundsettings.cpp.

◆ setEnabled()

void QgsTextBackgroundSettings::setEnabled ( bool enabled )

Sets whether the text background will be drawn.

Parameters

enabled set to true to draw background

See also: enabled()

Definition at line 112 of file qgstextbackgroundsettings.cpp.

◆ setFillColor()

void QgsTextBackgroundSettings::setFillColor ( const QColor & color )

Sets the color used for filing the background shape.

Parameters

color background color

See also: fillColor(); setStrokeColor()

Note: As of QGIS 3.20, using this function is only recommended for SVG backgrounds, while other background types should be configured through their symbols.

Definition at line 302 of file qgstextbackgroundsettings.cpp.

◆ setFillSymbol()

void QgsTextBackgroundSettings::setFillSymbol ( QgsFillSymbol * symbol )

Sets the current fill symbol for the background shape.

Ownership is transferred to the background settings.

Note: This is only used when the type() is QgsTextBackgroundSettings::ShapeRectangle, QgsTextBackgroundSettings::ShapeSquare, QgsTextBackgroundSettings::ShapeCircle or QgsTextBackgroundSettings::ShapeEllipse

See also: fillSymbol()

Since: QGIS 3.20

Definition at line 152 of file qgstextbackgroundsettings.cpp.

◆ setJoinStyle()

void QgsTextBackgroundSettings::setJoinStyle ( Qt::PenJoinStyle style )

Sets the join style used for drawing the background shape.

Parameters

style join style

See also: joinStyle()

Note: As of QGIS 3.20, using this function is only recommended for SVG backgrounds, while other background types should be configured through their symbols.

Definition at line 374 of file qgstextbackgroundsettings.cpp.

◆ setMarkerSymbol()

void QgsTextBackgroundSettings::setMarkerSymbol ( QgsMarkerSymbol * symbol )

Sets the current marker symbol for the background shape.

Ownership is transferred to the background settings.

Note: This is only used when the type() is QgsTextBackgroundSettings::ShapeMarkerSymbol.

See also: markerSymbol()

Since: QGIS 3.10

Definition at line 142 of file qgstextbackgroundsettings.cpp.

◆ setOffset()

void QgsTextBackgroundSettings::setOffset ( QPointF offset )

Sets the offset used for drawing the background shape.

Units are specified using setOffsetUnit().

Parameters

offset offset for shape

See also: offset(); setOffsetUnit()

Definition at line 222 of file qgstextbackgroundsettings.cpp.

◆ setOffsetMapUnitScale()

void QgsTextBackgroundSettings::setOffsetMapUnitScale ( const QgsMapUnitScale & scale )

Sets the map unit scale object for the shape offset.

This is only used if the offsetUnit() is set to QgsUnitTypes::RenderMapUnit.

Parameters

scale scale for shape offset

See also: offsetMapUnitScale(); setOffsetUnit()

Definition at line 242 of file qgstextbackgroundsettings.cpp.

◆ setOffsetUnit()

void QgsTextBackgroundSettings::setOffsetUnit ( QgsUnitTypes::RenderUnit units )

Sets the units used for the shape's offset.

Parameters

units offset units

See also: offsetUnit(); setOffset()

Definition at line 232 of file qgstextbackgroundsettings.cpp.

◆ setOpacity()

void QgsTextBackgroundSettings::setOpacity ( double opacity )

Sets the background shape's opacity.

Parameters

opacity opacity as a double value between 0 (fully transparent) and 1 (totally opaque)

See also: opacity()

Definition at line 282 of file qgstextbackgroundsettings.cpp.

◆ setPaintEffect()

void QgsTextBackgroundSettings::setPaintEffect ( QgsPaintEffect * effect )

Sets the current paint effect for the background shape.

Parameters

effect paint effect. Ownership is transferred to the background settings.

See also: paintEffect()

Definition at line 388 of file qgstextbackgroundsettings.cpp.

◆ setRadii()

void QgsTextBackgroundSettings::setRadii ( QSizeF radii )

Sets the radii used for rounding the corners of shapes.

This is only used if type() is set to QgsTextBackgroundSettings::ShapeRectangle or QgsTextBackgroundSettings::ShapeSquare.

Parameters

radii QSizeF representing horizontal and vertical radii for rounded corners. Units are specified through setRadiiUnit()

See also: radii(); setRadiiUnit()

Definition at line 252 of file qgstextbackgroundsettings.cpp.

◆ setRadiiMapUnitScale()

void QgsTextBackgroundSettings::setRadiiMapUnitScale ( const QgsMapUnitScale & scale )

Sets the map unit scale object for the shape radii.

This is only used if the radiiUnit() is set to QgsUnitTypes::RenderMapUnit.

Parameters

scale scale for shape radii

See also: radiiMapUnitScale(); setRadiiUnit()

Definition at line 272 of file qgstextbackgroundsettings.cpp.

◆ setRadiiUnit()

void QgsTextBackgroundSettings::setRadiiUnit ( QgsUnitTypes::RenderUnit units )

Sets the units used for the shape's radii.

Parameters

units radii units

See also: radiiUnit(); setRadii()

Definition at line 262 of file qgstextbackgroundsettings.cpp.

◆ setRotation()

void QgsTextBackgroundSettings::setRotation ( double rotation )

Sets the rotation for the background shape, in degrees clockwise.

See also: rotation(); setRotationType()

Definition at line 212 of file qgstextbackgroundsettings.cpp.

◆ setRotationType()

void QgsTextBackgroundSettings::setRotationType ( QgsTextBackgroundSettings::RotationType type )

Sets the method used for rotating the background shape.

Parameters

type	rotation method

See also: rotationType(); setRotation()

Definition at line 202 of file qgstextbackgroundsettings.cpp.

◆ setSize()

void QgsTextBackgroundSettings::setSize ( QSizeF size )

Sets the size of the background shape.

The meaning of the size depends on the current sizeType(), e.g., for size types of QgsTextBackgroundSettings::SizeFixed the size will represent the actual width and height of the shape, for QgsTextBackgroundSettings::SizeBuffer the size will represent the horizontal and vertical margins to add to the text when calculating the size of the shape.

Parameters

size	QSizeF representing horizontal and vertical size components for shape

See also: size(); setSizeType()

Definition at line 172 of file qgstextbackgroundsettings.cpp.

◆ setSizeMapUnitScale()

void QgsTextBackgroundSettings::setSizeMapUnitScale ( const QgsMapUnitScale & scale )

Sets the map unit scale object for the shape size.

This is only used if the sizeUnit() is set to QgsUnitTypes::RenderMapUnit.

Parameters

scale scale for shape size

See also: sizeMapUnitScale(); setSizeUnit()

Definition at line 192 of file qgstextbackgroundsettings.cpp.

◆ setSizeType()

void QgsTextBackgroundSettings::setSizeType ( QgsTextBackgroundSettings::SizeType type )

Sets the method used to determine the size of the background shape (e.g., fixed size or buffer around text).

Parameters

type	size method

See also: sizeType(); setSize()

Definition at line 162 of file qgstextbackgroundsettings.cpp.

◆ setSizeUnit()

void QgsTextBackgroundSettings::setSizeUnit ( QgsUnitTypes::RenderUnit unit )

Sets the units used for the shape's size.

This value has no meaning if the sizeType() is set to QgsTextBackgroundSettings::SizePercent.

Parameters

unit	size units

See also: sizeUnit(); setSizeType(); setSize()

Definition at line 182 of file qgstextbackgroundsettings.cpp.

◆ setStrokeColor()

void QgsTextBackgroundSettings::setStrokeColor ( const QColor & color )

Sets the color used for outlining the background shape.

Parameters

color stroke color

See also: strokeColor(); setFillColor()

Definition at line 316 of file qgstextbackgroundsettings.cpp.

◆ setStrokeWidth()

void QgsTextBackgroundSettings::setStrokeWidth ( double width )

Sets the width of the shape's stroke (stroke).

Units are specified through setStrokeWidthUnit().

See also: strokeWidth(); setStrokeWidthUnit()

Note: As of QGIS 3.20, using this function is only recommended for SVG backgrounds, while other background types should be configured through their symbols.

Definition at line 330 of file qgstextbackgroundsettings.cpp.

◆ setStrokeWidthMapUnitScale()

void QgsTextBackgroundSettings::setStrokeWidthMapUnitScale ( const QgsMapUnitScale & scale )

Sets the map unit scale object for the shape stroke width.

This is only used if the strokeWidthUnit() is set to QgsUnitTypes::RenderMapUnit.

Parameters

scale scale for shape stroke width

See also: strokeWidthMapUnitScale(); setStrokeWidthUnit()

Note: As of QGIS 3.20, using this function is only recommended for SVG backgrounds, while other background types should be configured through their symbols.

Definition at line 360 of file qgstextbackgroundsettings.cpp.

◆ setStrokeWidthUnit()

void QgsTextBackgroundSettings::setStrokeWidthUnit ( QgsUnitTypes::RenderUnit units )

Sets the units used for the shape's stroke width.

Parameters

units stroke width units

See also: strokeWidthUnit(); setStrokeWidth()

Note: As of QGIS 3.20, using this function is only recommended for SVG backgrounds, while other background types should be configured through their symbols.

Definition at line 346 of file qgstextbackgroundsettings.cpp.

◆ setSvgFile()

void QgsTextBackgroundSettings::setSvgFile ( const QString & file )

Sets the path to the background SVG file.

This is only used if type() is set to QgsTextBackgroundSettings::ShapeSVG. The path must be absolute.

Parameters

file	Absolute SVG file path

See also: svgFile()

Definition at line 132 of file qgstextbackgroundsettings.cpp.

◆ setType()

void QgsTextBackgroundSettings::setType ( QgsTextBackgroundSettings::ShapeType type )

Sets the type of background shape to draw (e.g., square, ellipse, SVG).

Parameters

type	shape type

See also: type()

Definition at line 122 of file qgstextbackgroundsettings.cpp.

◆ size()

QSizeF QgsTextBackgroundSettings::size ( ) const

Returns the size of the background shape.

The meaning of the size depends on the current sizeType(), e.g., for size types of QgsTextBackgroundSettings::SizeFixed the size will represent the actual width and height of the shape, for QgsTextBackgroundSettings::SizeBuffer the size will represent the horizontal and vertical margins to add to the text when calculating the size of the shape.

See also: setSize(); sizeType()

Definition at line 167 of file qgstextbackgroundsettings.cpp.

◆ sizeMapUnitScale()

QgsMapUnitScale QgsTextBackgroundSettings::sizeMapUnitScale ( ) const

Returns the map unit scale object for the shape size.

This is only used if the sizeUnit() is set to QgsUnitTypes::RenderMapUnit.

See also: setSizeMapUnitScale(); sizeUnit()

Definition at line 187 of file qgstextbackgroundsettings.cpp.

◆ sizeType()

QgsTextBackgroundSettings::SizeType QgsTextBackgroundSettings::sizeType ( ) const

Returns the method used to determine the size of the background shape (e.g., fixed size or buffer around text).

See also: setSizeType(); size()

Definition at line 157 of file qgstextbackgroundsettings.cpp.

◆ sizeUnit()

QgsUnitTypes::RenderUnit QgsTextBackgroundSettings::sizeUnit ( ) const

Returns the units used for the shape's size.

This value has no meaning if the sizeType() is set to QgsTextBackgroundSettings::SizePercent.

See also: setSizeUnit(); sizeType(); size()

Definition at line 177 of file qgstextbackgroundsettings.cpp.

◆ strokeColor()

QColor QgsTextBackgroundSettings::strokeColor ( ) const

Returns the color used for outlining the background shape.

See also: setStrokeColor(); fillColor()

Note: As of QGIS 3.20, using this function is only recommended for SVG backgrounds, while other background types should be configured through their symbols.

Definition at line 311 of file qgstextbackgroundsettings.cpp.

◆ strokeWidth()

double QgsTextBackgroundSettings::strokeWidth ( ) const

Returns the width of the shape's stroke (stroke).

Units are retrieved through strokeWidthUnit().

See also: setStrokeWidth(); strokeWidthUnit()

Definition at line 325 of file qgstextbackgroundsettings.cpp.

◆ strokeWidthMapUnitScale()

QgsMapUnitScale QgsTextBackgroundSettings::strokeWidthMapUnitScale ( ) const

Returns the map unit scale object for the shape stroke width.

This is only used if the strokeWidthUnit() is set to QgsUnitTypes::RenderMapUnit.

See also: setStrokeWidthMapUnitScale(); strokeWidthUnit()

Definition at line 355 of file qgstextbackgroundsettings.cpp.

◆ strokeWidthUnit()

QgsUnitTypes::RenderUnit QgsTextBackgroundSettings::strokeWidthUnit ( ) const

Returns the units used for the shape's stroke width.

See also: setStrokeWidthUnit(); strokeWidth()

Definition at line 341 of file qgstextbackgroundsettings.cpp.

◆ svgFile()

QString QgsTextBackgroundSettings::svgFile ( ) const

Returns the absolute path to the background SVG file, if set.

See also: setSvgFile()

Definition at line 127 of file qgstextbackgroundsettings.cpp.

◆ type()

QgsTextBackgroundSettings::ShapeType QgsTextBackgroundSettings::type ( ) const

Returns the type of background shape (e.g., square, ellipse, SVG).

See also: setType()

Definition at line 117 of file qgstextbackgroundsettings.cpp.

◆ updateDataDefinedProperties()

void QgsTextBackgroundSettings::updateDataDefinedProperties	(	QgsRenderContext &	context,
		const QgsPropertyCollection &	properties
	)

Updates the format by evaluating current values of data defined properties.

Note: Since QGIS 3.20, data defined fill color, stroke color, stroke width, and pen join style will only modify SVG backgrounds. For other background types, the data defined properties within symbols are to be used.

Since: QGIS 3.10

Definition at line 759 of file qgstextbackgroundsettings.cpp.

◆ upgradeDataDefinedProperties()

void QgsTextBackgroundSettings::upgradeDataDefinedProperties ( QgsPropertyCollection & properties )

Upgrade data defined properties when reading a project file saved in QGIS prior to version 3.20.

Since: QGIS 3.20

Definition at line 721 of file qgstextbackgroundsettings.cpp.

◆ writeXml()

QDomElement QgsTextBackgroundSettings::writeXml	(	QDomDocument &	doc,
		const QgsReadWriteContext &	context
	)		const

Write settings into a DOM element.

See also: readXml()

Definition at line 680 of file qgstextbackgroundsettings.cpp.

The documentation for this class was generated from the following files:

/build/qgis-3.24.2+99sid/src/core/textrenderer/qgstextbackgroundsettings.h
/build/qgis-3.24.2+99sid/src/core/textrenderer/qgstextbackgroundsettings.cpp

Public Types

Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ RotationType

◆ ShapeType

◆ SizeType

Constructor & Destructor Documentation

◆ QgsTextBackgroundSettings() [1/2]

◆ QgsTextBackgroundSettings() [2/2]

◆ ~QgsTextBackgroundSettings()

Member Function Documentation

◆ blendMode()

◆ enabled()

◆ fillColor()

◆ fillSymbol()

◆ joinStyle()

◆ markerSymbol()

◆ offset()

◆ offsetMapUnitScale()

◆ offsetUnit()

◆ opacity()

◆ operator!=()

◆ operator=()

◆ operator==()

◆ paintEffect()

◆ radii()

◆ radiiMapUnitScale()

◆ radiiUnit()

◆ readFromLayer()

◆ readXml()

◆ referencedFields()

◆ rotation()

◆ rotationType()

◆ setBlendMode()

◆ setEnabled()

◆ setFillColor()

◆ setFillSymbol()

◆ setJoinStyle()

◆ setMarkerSymbol()

◆ setOffset()

◆ setOffsetMapUnitScale()

◆ setOffsetUnit()

◆ setOpacity()

◆ setPaintEffect()

◆ setRadii()

◆ setRadiiMapUnitScale()

◆ setRadiiUnit()

◆ setRotation()

◆ setRotationType()

◆ setSize()

◆ setSizeMapUnitScale()

◆ setSizeType()

◆ setSizeUnit()

◆ setStrokeColor()

◆ setStrokeWidth()

◆ setStrokeWidthMapUnitScale()

◆ setStrokeWidthUnit()

◆ setSvgFile()

◆ setType()

◆ size()

◆ sizeMapUnitScale()

◆ sizeType()

◆ sizeUnit()

◆ strokeColor()

◆ strokeWidth()

◆ strokeWidthMapUnitScale()

◆ strokeWidthUnit()

◆ svgFile()

◆ type()

◆ updateDataDefinedProperties()

◆ upgradeDataDefinedProperties()

◆ writeXml()