Encapsulates the properties of a plot axis. More...

#include <qgsplot.h>

Public Member Functions
	QgsPlotAxis ()

	QgsPlotAxis (const QgsPlotAxis &other)=delete
	QgsPlotAxis cannot be copied. More...

	~QgsPlotAxis ()

double	gridIntervalMajor () const
	Returns the interval of major grid lines for the axis. More...

double	gridIntervalMinor () const
	Returns the interval of minor grid lines for the axis. More...

QgsLineSymbol *	gridMajorSymbol ()
	Returns the line symbol used to render the major lines in the axis grid. More...

QgsLineSymbol *	gridMinorSymbol ()
	Returns the line symbol used to render the minor lines in the axis grid. More...

double	labelInterval () const
	Returns the interval of labels for the axis. More...

QString	labelSuffix () const
	Returns the axis label suffix, or an empty string if no label suffix is to be used. More...

Qgis::PlotAxisSuffixPlacement	labelSuffixPlacement () const
	Returns the placement for the axis label suffixes. More...

QgsNumericFormat *	numericFormat () const
	Returns the numeric format used for the axis labels. More...

QgsPlotAxis &	operator= (const QgsPlotAxis &other)=delete
	QgsPlotAxis cannot be copied. More...

bool	readXml (const QDomElement &element, const QgsReadWriteContext &context)
	Reads the axis' properties from an XML element. More...

void	setGridIntervalMajor (double interval)
	Sets the interval of major grid lines for the axis. More...

void	setGridIntervalMinor (double interval)
	Sets the interval of minor grid lines for the axis. More...

void	setGridMajorSymbol (QgsLineSymbol *symbol)
	Sets the symbol used to render the major lines in the axis grid. More...

void	setGridMinorSymbol (QgsLineSymbol *symbol)
	Sets the symbol used to render the minor lines in the axis grid. More...

void	setLabelInterval (double interval)
	Sets the interval of labels for the axis. More...

void	setLabelSuffix (const QString &suffix)
	Sets the axis label suffix. More...

void	setLabelSuffixPlacement (Qgis::PlotAxisSuffixPlacement placement)
	Sets the placement for the axis label suffixes. More...

void	setNumericFormat (QgsNumericFormat *format)
	Sets the numeric format used for the axis labels. More...

void	setTextFormat (const QgsTextFormat &format)
	Sets the text format used for the axis labels. More...

QgsTextFormat	textFormat () const
	Returns the text format used for the axis labels. More...

bool	writeXml (QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context) const
	Writes the axis' properties into an XML element. More...

Detailed Description

Encapsulates the properties of a plot axis.

Warning: This class is not considered stable API, and may change in future!

Since: QGIS 3.26

Definition at line 77 of file qgsplot.h.

Constructor & Destructor Documentation

◆ QgsPlotAxis() [1/2]

QgsPlotAxis::QgsPlotAxis ( )

Definition at line 45 of file qgsplot.cpp.

◆ ~QgsPlotAxis()

QgsPlotAxis::~QgsPlotAxis ( )

default

◆ QgsPlotAxis() [2/2]

QgsPlotAxis::QgsPlotAxis ( const QgsPlotAxis & other )

delete

QgsPlotAxis cannot be copied.

Member Function Documentation

◆ gridIntervalMajor()

double QgsPlotAxis::gridIntervalMajor ( ) const

inline

Returns the interval of major grid lines for the axis.

See also: setGridIntervalMajor()

Definition at line 118 of file qgsplot.h.

◆ gridIntervalMinor()

double QgsPlotAxis::gridIntervalMinor ( ) const

inline

Returns the interval of minor grid lines for the axis.

See also: setGridIntervalMinor()

Definition at line 104 of file qgsplot.h.

◆ gridMajorSymbol()

QgsLineSymbol * QgsPlotAxis::gridMajorSymbol ( )

Returns the line symbol used to render the major lines in the axis grid.

See also: setGridMajorSymbol()

Definition at line 134 of file qgsplot.cpp.

◆ gridMinorSymbol()

QgsLineSymbol * QgsPlotAxis::gridMinorSymbol ( )

Returns the line symbol used to render the minor lines in the axis grid.

See also: setGridMinorSymbol()

Definition at line 144 of file qgsplot.cpp.

◆ labelInterval()

double QgsPlotAxis::labelInterval ( ) const

inline

Returns the interval of labels for the axis.

See also: setLabelInterval()

Definition at line 132 of file qgsplot.h.

◆ labelSuffix()

QString QgsPlotAxis::labelSuffix ( ) const

Returns the axis label suffix, or an empty string if no label suffix is to be used.

See also: setLabelSuffix(); labelSuffixPlacement()

Since: QGIS 3.32

Definition at line 114 of file qgsplot.cpp.

◆ labelSuffixPlacement()

Qgis::PlotAxisSuffixPlacement QgsPlotAxis::labelSuffixPlacement ( ) const

Returns the placement for the axis label suffixes.

See also: setLabelSuffixPlacement(); labelSuffix()

Since: QGIS 3.32

Definition at line 124 of file qgsplot.cpp.

◆ numericFormat()

QgsNumericFormat * QgsPlotAxis::numericFormat ( ) const

Returns the numeric format used for the axis labels.

See also: setNumericFormat()

Definition at line 104 of file qgsplot.cpp.

◆ operator=()

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

delete

QgsPlotAxis cannot be copied.

◆ readXml()

bool QgsPlotAxis::readXml	(	const QDomElement &	element,
		const QgsReadWriteContext &	context
	)

Reads the axis' properties from an XML element.

Definition at line 81 of file qgsplot.cpp.

◆ setGridIntervalMajor()

void QgsPlotAxis::setGridIntervalMajor ( double interval )

inline

Sets the interval of major grid lines for the axis.

See also: gridIntervalMajor()

Definition at line 125 of file qgsplot.h.

◆ setGridIntervalMinor()

void QgsPlotAxis::setGridIntervalMinor ( double interval )

inline

Sets the interval of minor grid lines for the axis.

See also: gridIntervalMinor()

Definition at line 111 of file qgsplot.h.

◆ setGridMajorSymbol()

void QgsPlotAxis::setGridMajorSymbol ( QgsLineSymbol * symbol )

Sets the symbol used to render the major lines in the axis grid.

Ownership of symbol is transferred to the plot.

See also: gridMajorSymbol()

Definition at line 139 of file qgsplot.cpp.

◆ setGridMinorSymbol()

void QgsPlotAxis::setGridMinorSymbol ( QgsLineSymbol * symbol )

Sets the symbol used to render the minor lines in the axis grid.

Ownership of symbol is transferred to the plot.

See also: gridMinorSymbol()

Definition at line 149 of file qgsplot.cpp.

◆ setLabelInterval()

void QgsPlotAxis::setLabelInterval ( double interval )

inline

Sets the interval of labels for the axis.

See also: labelInterval()

Definition at line 139 of file qgsplot.h.

◆ setLabelSuffix()

void QgsPlotAxis::setLabelSuffix ( const QString & suffix )

Sets the axis label suffix.

Set to an empty string if no label suffix is to be used.

See also: labelSuffix(); setLabelSuffixPlacement()

Since: QGIS 3.32

Definition at line 119 of file qgsplot.cpp.

◆ setLabelSuffixPlacement()

void QgsPlotAxis::setLabelSuffixPlacement ( Qgis::PlotAxisSuffixPlacement placement )

Sets the placement for the axis label suffixes.

See also: labelSuffixPlacement(); setLabelSuffix()

Since: QGIS 3.32

Definition at line 129 of file qgsplot.cpp.

◆ setNumericFormat()

void QgsPlotAxis::setNumericFormat ( QgsNumericFormat * format )

Sets the numeric format used for the axis labels.

Ownership of format is transferred to the plot.

See also: numericFormat()

Definition at line 109 of file qgsplot.cpp.

◆ setTextFormat()

void QgsPlotAxis::setTextFormat ( const QgsTextFormat & format )

Sets the text format used for the axis labels.

See also: textFormat()

Definition at line 159 of file qgsplot.cpp.

◆ textFormat()

QgsTextFormat QgsPlotAxis::textFormat ( ) const

Returns the text format used for the axis labels.

See also: setTextFormat()

Definition at line 154 of file qgsplot.cpp.

◆ writeXml()

bool QgsPlotAxis::writeXml	(	QDomElement &	element,
		QDomDocument &	document,
		const QgsReadWriteContext &	context
	)		const

Writes the axis' properties into an XML element.

Definition at line 55 of file qgsplot.cpp.

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

/build/qgis-3.37.0+git20240325+fdefdf9c27f+17bookworm/src/core/plot/qgsplot.h
/build/qgis-3.37.0+git20240325+fdefdf9c27f+17bookworm/src/core/plot/qgsplot.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ QgsPlotAxis() [1/2]

◆ ~QgsPlotAxis()

◆ QgsPlotAxis() [2/2]

Member Function Documentation

◆ gridIntervalMajor()

◆ gridIntervalMinor()

◆ gridMajorSymbol()

◆ gridMinorSymbol()

◆ labelInterval()

◆ labelSuffix()

◆ labelSuffixPlacement()

◆ numericFormat()

◆ operator=()

◆ readXml()

◆ setGridIntervalMajor()

◆ setGridIntervalMinor()

◆ setGridMajorSymbol()

◆ setGridMinorSymbol()

◆ setLabelInterval()

◆ setLabelSuffix()

◆ setLabelSuffixPlacement()

◆ setNumericFormat()

◆ setTextFormat()

◆ textFormat()

◆ writeXml()