Settings for a color ramp legend node. More...

#include <qgscolorramplegendnodesettings.h>

Public Types
enum	Direction { MinimumToMaximum , MaximumToMinimum }
	Ramp directions. More...

Public Member Functions
	QgsColorRampLegendNodeSettings ()

	QgsColorRampLegendNodeSettings (const QgsColorRampLegendNodeSettings &other)

	~QgsColorRampLegendNodeSettings ()

QgsColorRampLegendNodeSettings::Direction	direction () const
	Returns the direction of the ramp.

QString	maximumLabel () const
	Returns the label for the maximum value on the ramp.

QString	minimumLabel () const
	Returns the label for the minimum value on the ramp.

const QgsNumericFormat *	numericFormat () const
	Returns the numeric format used for numbers in the scalebar.

QgsColorRampLegendNodeSettings &	operator= (const QgsColorRampLegendNodeSettings &other)

Qt::Orientation	orientation () const
	Returns the ramp orientation (i.e.

QString	prefix () const
	Returns the prefix to show before legend text.

void	readXml (const QDomElement &element, const QgsReadWriteContext &context)
	Reads settings from an XML element.

void	setDirection (QgsColorRampLegendNodeSettings::Direction direction)
	Sets the direction of the ramp.

void	setMaximumLabel (const QString &label)
	Sets the label for the maximum value on the ramp.

void	setMinimumLabel (const QString &label)
	Sets the label for the minimum value on the ramp.

void	setNumericFormat (QgsNumericFormat *format)
	Sets the numeric format used for numbers in the scalebar.

void	setOrientation (Qt::Orientation orientation)
	Sets the ramp orientation (i.e.

void	setPrefix (const QString &prefix)
	Sets the prefix to show before legend text.

void	setSuffix (const QString &suffix)
	Sets the suffix to show after legend text.

void	setTextFormat (const QgsTextFormat &format)
	Sets the text format used to render text in the legend item.

void	setUseContinuousLegend (bool useContinuousLegend)
	Sets the flag to use a continuous gradient legend to useContinuousLegend.

QString	suffix () const
	Returns the suffix to show after legend text.

QgsTextFormat	textFormat () const
	Returns the text format used to render text in the legend item.

bool	useContinuousLegend () const
	Returns `true` if a continuous gradient legend will be used.

void	writeXml (QDomDocument &doc, QDomElement &element, const QgsReadWriteContext &context) const
	Writes settings to an XML element.

Detailed Description

Settings for a color ramp legend node.

Since: QGIS 3.18

Definition at line 37 of file qgscolorramplegendnodesettings.h.

Member Enumeration Documentation

◆ Direction

enum QgsColorRampLegendNodeSettings::Direction

Ramp directions.

Enumerator
MinimumToMaximum	Minimum value on bottom, maximum value on top.
MaximumToMinimum	Maximum value on bottom, minimum value on top.

Definition at line 44 of file qgscolorramplegendnodesettings.h.

Constructor & Destructor Documentation

◆ QgsColorRampLegendNodeSettings() [1/2]

QgsColorRampLegendNodeSettings::QgsColorRampLegendNodeSettings ( )

Definition at line 23 of file qgscolorramplegendnodesettings.cpp.

◆ ~QgsColorRampLegendNodeSettings()

QgsColorRampLegendNodeSettings::~QgsColorRampLegendNodeSettings ( )

default

◆ QgsColorRampLegendNodeSettings() [2/2]

QgsColorRampLegendNodeSettings::QgsColorRampLegendNodeSettings ( const QgsColorRampLegendNodeSettings & other )

Definition at line 28 of file qgscolorramplegendnodesettings.cpp.

Member Function Documentation

◆ direction()

QgsColorRampLegendNodeSettings::Direction QgsColorRampLegendNodeSettings::direction ( ) const

Returns the direction of the ramp.

See also: setDirection(); orientation()

Definition at line 58 of file qgscolorramplegendnodesettings.cpp.

◆ maximumLabel()

QString QgsColorRampLegendNodeSettings::maximumLabel ( ) const

Returns the label for the maximum value on the ramp.

If the returned string is empty than a default value will be generated based on the associated maximum value.

See also: minimumLabel(); setMaximumLabel()

Definition at line 78 of file qgscolorramplegendnodesettings.cpp.

◆ minimumLabel()

QString QgsColorRampLegendNodeSettings::minimumLabel ( ) const

Returns the label for the minimum value on the ramp.

If the returned string is empty than a default value will be generated based on the associated minimum value.

See also: maximumLabel(); setMinimumLabel()

Definition at line 68 of file qgscolorramplegendnodesettings.cpp.

◆ numericFormat()

const QgsNumericFormat * QgsColorRampLegendNodeSettings::numericFormat ( ) const

Returns the numeric format used for numbers in the scalebar.

See also: setNumericFormat()

Since: QGIS 3.12

Definition at line 88 of file qgscolorramplegendnodesettings.cpp.

◆ operator=()

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

Definition at line 42 of file qgscolorramplegendnodesettings.cpp.

◆ orientation()

Qt::Orientation QgsColorRampLegendNodeSettings::orientation ( ) const

Returns the ramp orientation (i.e.

horizontal or vertical).

See also: setOrientation(); direction()

Definition at line 183 of file qgscolorramplegendnodesettings.cpp.

◆ prefix()

QString QgsColorRampLegendNodeSettings::prefix ( ) const

Returns the prefix to show before legend text.

See also: setPrefix(); suffix()

Definition at line 153 of file qgscolorramplegendnodesettings.cpp.

◆ readXml()

void QgsColorRampLegendNodeSettings::readXml	(	const QDomElement &	element,
		const QgsReadWriteContext &	context
	)

Reads settings from an XML element.

Definition at line 122 of file qgscolorramplegendnodesettings.cpp.

◆ setDirection()

void QgsColorRampLegendNodeSettings::setDirection ( QgsColorRampLegendNodeSettings::Direction direction )

Sets the direction of the ramp.

See also: direction(); setOrientation()

Definition at line 63 of file qgscolorramplegendnodesettings.cpp.

◆ setMaximumLabel()

void QgsColorRampLegendNodeSettings::setMaximumLabel ( const QString & label )

Sets the label for the maximum value on the ramp.

If the label is empty than a default value will be generated based on the associated maximum value.

See also: setMinimumLabel(); maximumLabel()

Definition at line 83 of file qgscolorramplegendnodesettings.cpp.

◆ setMinimumLabel()

void QgsColorRampLegendNodeSettings::setMinimumLabel ( const QString & label )

Sets the label for the minimum value on the ramp.

If the label is empty than a default value will be generated based on the associated minimum value.

See also: setMaximumLabel(); minimumLabel()

Definition at line 73 of file qgscolorramplegendnodesettings.cpp.

◆ setNumericFormat()

void QgsColorRampLegendNodeSettings::setNumericFormat ( QgsNumericFormat * format )

Sets the numeric format used for numbers in the scalebar.

Ownership of format is transferred to the scalebar.

See also: numericFormat()

Since: QGIS 3.12

Definition at line 93 of file qgscolorramplegendnodesettings.cpp.

◆ setOrientation()

void QgsColorRampLegendNodeSettings::setOrientation ( Qt::Orientation orientation )

Sets the ramp orientation (i.e.

horizontal or vertical).

See also: orientation(); setDirection()

Definition at line 188 of file qgscolorramplegendnodesettings.cpp.

◆ setPrefix()

void QgsColorRampLegendNodeSettings::setPrefix ( const QString & prefix )

Sets the prefix to show before legend text.

See also: prefix(); setSuffix()

Definition at line 158 of file qgscolorramplegendnodesettings.cpp.

◆ setSuffix()

void QgsColorRampLegendNodeSettings::setSuffix ( const QString & suffix )

Sets the suffix to show after legend text.

See also: suffix(); setPrefix()

Definition at line 168 of file qgscolorramplegendnodesettings.cpp.

◆ setTextFormat()

void QgsColorRampLegendNodeSettings::setTextFormat ( const QgsTextFormat & format )

Sets the text format used to render text in the legend item.

See also: textFormat()

Definition at line 178 of file qgscolorramplegendnodesettings.cpp.

◆ setUseContinuousLegend()

void QgsColorRampLegendNodeSettings::setUseContinuousLegend ( bool useContinuousLegend )

Sets the flag to use a continuous gradient legend to useContinuousLegend.

When this flag is set the legend will be rendered using a continuous color ramp with min and max values, when it is not set the legend will be rendered using separate items for each entry.