Conditional styling for a rule. More...

#include <qgsconditionalstyle.h>

Public Member Functions
	QgsConditionalStyle ()

	QgsConditionalStyle (const QgsConditionalStyle &other)

	QgsConditionalStyle (const QString &rule)

QColor	backgroundColor () const
	The background color for style. More...

QString	displayText () const
	The name of the style. More...

QFont	font () const
	The font for the style. More...

QPixmap	icon () const
	The icon set for style generated from the set symbol. More...

bool	isValid () const
	isValid Check if this rule is valid. More...

bool	matches (const QVariant &value, QgsExpressionContext &context) const
	Check if the rule matches using the given value and feature. More...

QString	name () const
	The name of the style. More...

QgsConditionalStyle &	operator= (const QgsConditionalStyle &other)

bool	readXml (const QDomNode &node, const QgsReadWriteContext &context)
	Reads vector conditional style specific state from layer Dom node. More...

QPixmap	renderPreview () const
	Render a preview icon of the rule. More...

QString	rule () const
	The condition rule set for the style. More...

void	setBackgroundColor (const QColor &value)
	Set the background color for the style. More...

void	setFont (const QFont &value)
	Set the font for the style. More...

void	setName (const QString &value)
	Set the name of the style. More...

void	setRule (const QString &value)
	Set the rule for the style. More...

void	setSymbol (QgsSymbol *value)
	Set the icon for the style. More...

void	setTextColor (const QColor &value)
	Set the text color for the style. More...

QgsSymbol *	symbol () const
	The symbol used to generate the icon for the style. More...

QColor	textColor () const
	The text color set for style. More...

bool	validBackgroundColor () const
	Check if the background color is valid for render. More...

bool	validTextColor () const
	Check if the text color is valid for render. More...

bool	writeXml (QDomNode &node, QDomDocument &doc, const QgsReadWriteContext &context) const
	Write vector conditional style specific state from layer Dom node. More...

Static Public Member Functions
static QgsConditionalStyle	compressStyles (const QList< QgsConditionalStyle > &styles)
	Compress a list of styles into a single style. More...

static QgsConditionalStyle	matchingConditionalStyle (const QList< QgsConditionalStyle > &styles, const QVariant &value, QgsExpressionContext &context)
	Find and return the matching style for the value and feature. More...

static QList< QgsConditionalStyle >	matchingConditionalStyles (const QList< QgsConditionalStyle > &styles, const QVariant &value, QgsExpressionContext &context)
	Find and return the matching styles for the value and feature. More...

Detailed Description

Conditional styling for a rule.

Definition at line 86 of file qgsconditionalstyle.h.

Constructor & Destructor Documentation

◆ QgsConditionalStyle() [1/3]

QgsConditionalStyle::QgsConditionalStyle ( )

Definition at line 122 of file qgsconditionalstyle.cpp.

◆ QgsConditionalStyle() [2/3]

QgsConditionalStyle::QgsConditionalStyle ( const QgsConditionalStyle & other )

Definition at line 134 of file qgsconditionalstyle.cpp.

◆ QgsConditionalStyle() [3/3]

QgsConditionalStyle::QgsConditionalStyle ( const QString & rule )

Definition at line 127 of file qgsconditionalstyle.cpp.

Member Function Documentation

◆ backgroundColor()

QColor QgsConditionalStyle::backgroundColor ( ) const

inline

The background color for style.

Returns: QColor for background color

Definition at line 187 of file qgsconditionalstyle.h.

◆ compressStyles()

QgsConditionalStyle QgsConditionalStyle::compressStyles ( const QList< QgsConditionalStyle > & styles )

static

Compress a list of styles into a single style.

This can be used to stack the elements of the styles. The font of the last style is used in the output.

Parameters

styles The list of styles to compress down

Returns: A single style generated from joining each style property.

Definition at line 258 of file qgsconditionalstyle.cpp.

◆ displayText()

QString QgsConditionalStyle::displayText ( ) const

The name of the style.

Returns: The name of the style. Names are optional so might be empty.

Definition at line 167 of file qgsconditionalstyle.cpp.

◆ font()

QFont QgsConditionalStyle::font ( ) const

inline

The font for the style.

Returns: QFont for the style

Definition at line 200 of file qgsconditionalstyle.h.

◆ icon()

QPixmap QgsConditionalStyle::icon ( ) const

inline

The icon set for style generated from the set symbol.

Returns: A QPixmap that was set for the icon using the symbol

Definition at line 162 of file qgsconditionalstyle.h.

◆ isValid()

bool QgsConditionalStyle::isValid ( ) const

inline

isValid Check if this rule is valid.

A valid rule has one or more properties set.

Returns: true if the rule is valid.

Definition at line 214 of file qgsconditionalstyle.h.

◆ matches()

bool QgsConditionalStyle::matches	(	const QVariant &	value,
		QgsExpressionContext &	context
	)		const

Check if the rule matches using the given value and feature.

Parameters

value	The current value being checked. The "value" variable from the context is replaced with this value.
context	Expression context for evaluating rule expression

Returns: true of the rule matches against the given feature

Definition at line 189 of file qgsconditionalstyle.cpp.

◆ matchingConditionalStyle()

QgsConditionalStyle QgsConditionalStyle::matchingConditionalStyle	(	const QList< QgsConditionalStyle > &	styles,
		const QVariant &	value,
		QgsExpressionContext &	context
	)

static

Find and return the matching style for the value and feature.

If no match is found a invalid QgsConditionalStyle is return.

Returns: A conditional style that matches the value and feature. Check with QgsConditionalStyle::isValid()

Definition at line 247 of file qgsconditionalstyle.cpp.

◆ matchingConditionalStyles()

QList< QgsConditionalStyle > QgsConditionalStyle::matchingConditionalStyles	(	const QList< QgsConditionalStyle > &	styles,
		const QVariant &	value,
		QgsExpressionContext &	context
	)

static

Find and return the matching styles for the value and feature.

If no match is found a invalid QgsConditionalStyle is return.

Returns: A conditional style that matches the value and feature. Check with QgsConditionalStyle::isValid()

Definition at line 235 of file qgsconditionalstyle.cpp.

◆ name()

QString QgsConditionalStyle::name ( ) const

inline

The name of the style.

Returns: The name of the style. Names are optional so might be empty.

Definition at line 156 of file qgsconditionalstyle.h.

◆ operator=()

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

Definition at line 147 of file qgsconditionalstyle.cpp.

◆ readXml()

bool QgsConditionalStyle::readXml	(	const QDomNode &	node,
		const QgsReadWriteContext &	context
	)

Reads vector conditional style specific state from layer Dom node.

Definition at line 295 of file qgsconditionalstyle.cpp.

◆ renderPreview()

QPixmap QgsConditionalStyle::renderPreview ( ) const

Render a preview icon of the rule.

Returns: QPixmap preview of the style

Definition at line 196 of file qgsconditionalstyle.cpp.

◆ rule()

QString QgsConditionalStyle::rule ( ) const

inline

The condition rule set for the style.

Rule may contain variable @value to represent the current value

Returns: QString of the current set rule

Definition at line 207 of file qgsconditionalstyle.h.

◆ setBackgroundColor()

void QgsConditionalStyle::setBackgroundColor ( const QColor & value )

inline

Set the background color for the style.

Parameters

value QColor for background color

Definition at line 126 of file qgsconditionalstyle.h.

◆ setFont()

void QgsConditionalStyle::setFont ( const QFont & value )

inline

Set the font for the style.

Parameters

value QFont to be used for text

Definition at line 138 of file qgsconditionalstyle.h.

◆ setName()

void QgsConditionalStyle::setName ( const QString & value )

inline

Set the name of the style.

Names are optional but handy for display

Parameters

value The name given to the style

Definition at line 113 of file qgsconditionalstyle.h.

◆ setRule()

void QgsConditionalStyle::setRule ( const QString & value )

inline

Set the rule for the style.

Rules should be of QgsExpression syntax. Special value of @value is replaced at run time with the check value

Parameters

value The QgsExpression style rule to use for this style

Definition at line 120 of file qgsconditionalstyle.h.

◆ setSymbol()

void QgsConditionalStyle::setSymbol ( QgsSymbol * value )

Set the icon for the style.

Icons are generated from symbols

Parameters

value QgsSymbol to be used when generating the icon

Definition at line 175 of file qgsconditionalstyle.cpp.

◆ setTextColor()

void QgsConditionalStyle::setTextColor ( const QColor & value )

inline

Set the text color for the style.

Parameters

value QColor for text color

Definition at line 132 of file qgsconditionalstyle.h.

◆ symbol()

QgsSymbol* QgsConditionalStyle::symbol ( ) const

inline

The symbol used to generate the icon for the style.

Returns: The QgsSymbol used for the icon

Definition at line 168 of file qgsconditionalstyle.h.

◆ textColor()

QColor QgsConditionalStyle::textColor ( ) const

inline

The text color set for style.

Returns: QColor for text color

Definition at line 174 of file qgsconditionalstyle.h.

◆ validBackgroundColor()

bool QgsConditionalStyle::validBackgroundColor ( ) const

Check if the background color is valid for render.

Valid colors are non invalid QColors and a color with a > 0 alpha

Returns: true of the color set for background is valid.

Definition at line 225 of file qgsconditionalstyle.cpp.

◆ validTextColor()

bool QgsConditionalStyle::validTextColor ( ) const

Check if the text color is valid for render.

Valid colors are non invalid QColors and a color with a > 0 alpha

Returns: true of the color set for text is valid.

Definition at line 230 of file qgsconditionalstyle.cpp.

◆ writeXml()

bool QgsConditionalStyle::writeXml	(	QDomNode &	node,
		QDomDocument &	doc,
		const QgsReadWriteContext &	context
	)		const

Write vector conditional style specific state from layer Dom node.

Definition at line 275 of file qgsconditionalstyle.cpp.

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

/tmp/buildd/qgis-3.8.0+99unstable/src/core/qgsconditionalstyle.h
/tmp/buildd/qgis-3.8.0+99unstable/src/core/qgsconditionalstyle.cpp

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ QgsConditionalStyle() [1/3]

◆ QgsConditionalStyle() [2/3]

◆ QgsConditionalStyle() [3/3]

Member Function Documentation

◆ backgroundColor()

◆ compressStyles()

◆ displayText()

◆ font()

◆ icon()

◆ isValid()

◆ matches()

◆ matchingConditionalStyle()

◆ matchingConditionalStyles()

◆ name()

◆ operator=()

◆ readXml()

◆ renderPreview()

◆ rule()

◆ setBackgroundColor()

◆ setFont()

◆ setName()

◆ setRule()

◆ setSymbol()

◆ setTextColor()

◆ symbol()

◆ textColor()

◆ validBackgroundColor()

◆ validTextColor()

◆ writeXml()