Base class for 2-dimensional plot/chart/graphs with an X and Y axes. More...

#include <qgsplot.h>

Inheritance diagram for Qgs2DXyPlot:

[legend]

Public Member Functions
	Qgs2DXyPlot ()
	Constructor for Qgs2DXyPlot.
	Qgs2DXyPlot (const Qgs2DXyPlot &other)=delete
	~Qgs2DXyPlot () override
void	calculateOptimisedIntervals (QgsRenderContext &context, QgsPlotRenderContext &plotContext)
	Automatically sets the grid and label intervals to optimal values for display in the given render context.
QgsFillSymbol *	chartBackgroundSymbol ()
	Returns the fill symbol used to render the background of the chart.
QgsFillSymbol *	chartBorderSymbol ()
	Returns the symbol used to render the border of the chart.
QRectF	interiorPlotArea (QgsRenderContext &context, QgsPlotRenderContext &plotContext) const override
	Returns the area of the plot which corresponds to the actual plot content (excluding all titles and other components which sit outside the plot area).
Qgs2DXyPlot &	operator= (const Qgs2DXyPlot &other)=delete
bool	readXml (const QDomElement &element, const QgsReadWriteContext &context) override
	Reads the plot's properties from an XML element.
void	render (QgsRenderContext &context, QgsPlotRenderContext &plotContext, const QgsPlotData &plotData=QgsPlotData()) override
	Renders the plot.
void	setChartBackgroundSymbol (QgsFillSymbol *symbol)
	Sets the fill symbol used to render the background of the chart.
void	setChartBorderSymbol (QgsFillSymbol *symbol)
	Sets the symbol used to render the border of the chart.
void	setXMaximum (double maximum)
	Sets the maximum value of the x axis.
void	setXMinimum (double minimum)
	Sets the minimum value of the x axis.
void	setYMaximum (double maximum)
	Sets the maximum value of the y axis.
void	setYMinimum (double minimum)
	Sets the minimum value of the y axis.
bool	writeXml (QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context) const override
	Writes the plot's properties into an XML element.
QgsPlotAxis &	xAxis ()
	Returns a reference to the plot's x axis.
const QgsPlotAxis &	xAxis () const
	Returns a reference to the plot's x axis.
double	xMaximum () const
	Returns the maximum value of the x axis.
double	xMinimum () const
	Returns the minimum value of the x axis.
QgsPlotAxis &	yAxis ()
	Returns a reference to the plot's y axis.
const QgsPlotAxis &	yAxis () const
	Returns a reference to the plot's y axis.
double	yMaximum () const
	Returns the maximum value of the y axis.
double	yMinimum () const
	Returns the minimum value of the y axis.
Public Member Functions inherited from Qgs2DPlot
	Qgs2DPlot ()
	Constructor for Qgs2DPlot.
	Qgs2DPlot (const Qgs2DPlot &other)=delete
	~Qgs2DPlot () override
const QgsMargins &	margins () const
	Returns the margins of the plot area (in millimeters).
Qgs2DPlot &	operator= (const Qgs2DPlot &other)=delete
virtual void	renderContent (QgsRenderContext &context, QgsPlotRenderContext &plotContext, const QRectF &plotArea, const QgsPlotData &plotData=QgsPlotData())
	Renders the plot content.
void	setMargins (const QgsMargins &margins)
	Sets the margins of the plot area (in millimeters).
void	setSize (QSizeF size)
	Sets the overall size of the plot (including titles and over components which sit outside the plot area).
QSizeF	size () const
	Returns the overall size of the plot (in millimeters) (including titles and other components which sit outside the plot area).
Public Member Functions inherited from QgsPlot
	QgsPlot ()=default
virtual	~QgsPlot ()
QgsPropertyCollection &	dataDefinedProperties ()
	Returns a reference to the plot's property collection, used for data defined overrides.
const QgsPropertyCollection &	dataDefinedProperties () const
	Returns a reference to the plot's property collection, used for data defined overrides.
void	setDataDefinedProperties (const QgsPropertyCollection &collection)
	Sets the plot's property collection, used for data defined overrides.
void	setDataDefinedProperty (DataDefinedProperty key, const QgsProperty &property)
	Sets a data defined property for the plot.
virtual QString	type () const
	Returns the plot's type.

Protected Member Functions
void	applyDataDefinedProperties (QgsRenderContext &context, double &minX, double &maxX, double &minY, double &maxY, double &majorIntervalX, double &minorIntervalX, double &labelIntervalX, double &majorIntervalY, double &minorIntervalY, double &labelIntervalY) const
	Applies 2D XY plot data-defined properties.
Protected Member Functions inherited from Qgs2DPlot
void	applyDataDefinedProperties (QgsRenderContext &context, QgsMargins &margins) const
	Applies 2D plot data-defined properties.

Additional Inherited Members
Public Types inherited from QgsPlot
enum class	DataDefinedProperty : int { MarginLeft , MarginTop , MarginRight , MarginBottom , XAxisMajorInterval , XAxisMinorInterval , XAxisLabelInterval , YAxisMajorInterval , YAxisMinorInterval , YAxisLabelInterval , XAxisMinimum , XAxisMaximum , YAxisMinimum , YAxisMaximum }
	Data defined properties for different plot types. More...
Static Public Member Functions inherited from QgsPlot
static const QgsPropertiesDefinition &	propertyDefinitions ()
	Returns the plot property definitions.
Protected Attributes inherited from QgsPlot
QgsPropertyCollection	mDataDefinedProperties

Detailed Description

Base class for 2-dimensional plot/chart/graphs with an X and Y axes.

The base class is responsible for rendering the axis, grid lines and chart area. Subclasses can implement the renderContent() method to render their actual plot content.

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

Since: QGIS 3.26

Definition at line 658 of file qgsplot.h.

Constructor & Destructor Documentation

◆ Qgs2DXyPlot() [1/2]

Qgs2DXyPlot::Qgs2DXyPlot ( )

Constructor for Qgs2DXyPlot.

Definition at line 356 of file qgsplot.cpp.

◆ ~Qgs2DXyPlot()

Qgs2DXyPlot::~Qgs2DXyPlot ( )

overridedefault

◆ Qgs2DXyPlot() [2/2]

Qgs2DXyPlot::Qgs2DXyPlot ( const Qgs2DXyPlot & other )

delete

Member Function Documentation

◆ applyDataDefinedProperties()

void Qgs2DXyPlot::applyDataDefinedProperties	(	QgsRenderContext &	context,
		double &	minX,
		double &	maxX,
		double &	minY,
		double &	maxY,
		double &	majorIntervalX,
		double &	minorIntervalX,
		double &	labelIntervalX,
		double &	majorIntervalY,
		double &	minorIntervalY,
		double &	labelIntervalY ) const

protected

Applies 2D XY plot data-defined properties.

Definition at line 1052 of file qgsplot.cpp.

◆ calculateOptimisedIntervals()

void Qgs2DXyPlot::calculateOptimisedIntervals	(	QgsRenderContext &	context,
		QgsPlotRenderContext &	plotContext )

Automatically sets the grid and label intervals to optimal values for display in the given render context.

Intervals will be calculated in order to avoid overlapping axis labels and to ensure round values are shown.

Definition at line 889 of file qgsplot.cpp.

◆ chartBackgroundSymbol()

QgsFillSymbol * Qgs2DXyPlot::chartBackgroundSymbol ( )

Returns the fill symbol used to render the background of the chart.

See also: setChartBackgroundSymbol()

Definition at line 1032 of file qgsplot.cpp.

◆ chartBorderSymbol()

QgsFillSymbol * Qgs2DXyPlot::chartBorderSymbol ( )

Returns the symbol used to render the border of the chart.

See also: setChartBorderSymbol()

Definition at line 1042 of file qgsplot.cpp.

◆ interiorPlotArea()

QRectF Qgs2DXyPlot::interiorPlotArea	(	QgsRenderContext &	context,
		QgsPlotRenderContext &	plotContext ) const

overridevirtual

Returns the area of the plot which corresponds to the actual plot content (excluding all titles and other components which sit outside the plot area).

Reimplemented from Qgs2DPlot.

Definition at line 760 of file qgsplot.cpp.

◆ operator=()

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

delete

◆ readXml()

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

overridevirtual

Reads the plot's properties from an XML element.

Reimplemented from Qgs2DPlot.

Reimplemented in QgsBarChartPlot, and QgsLineChartPlot.

Definition at line 390 of file qgsplot.cpp.

◆ render()

void Qgs2DXyPlot::render	(	QgsRenderContext &	context,
		QgsPlotRenderContext &	plotContext,
		const QgsPlotData &	plotData = QgsPlotData() )

overridevirtual

Renders the plot.

Reimplemented from Qgs2DPlot.

Definition at line 412 of file qgsplot.cpp.

◆ setChartBackgroundSymbol()

void Qgs2DXyPlot::setChartBackgroundSymbol ( QgsFillSymbol * symbol )

Sets the fill symbol used to render the background of the chart.

Ownership of symbol is transferred to the plot.

See also: chartBackgroundSymbol()

Definition at line 1037 of file qgsplot.cpp.

◆ setChartBorderSymbol()

void Qgs2DXyPlot::setChartBorderSymbol ( QgsFillSymbol * symbol )

Sets the symbol used to render the border of the chart.

Ownership of symbol is transferred to the plot.

See also: chartBorderSymbol()

Definition at line 1047 of file qgsplot.cpp.

◆ setXMaximum()

void Qgs2DXyPlot::setXMaximum ( double maximum )

inline

Sets the maximum value of the x axis.

See also: xMaximum()

Definition at line 735 of file qgsplot.h.

◆ setXMinimum()

void Qgs2DXyPlot::setXMinimum ( double minimum )

inline

Sets the minimum value of the x axis.

See also: xMinimum()

Definition at line 707 of file qgsplot.h.

◆ setYMaximum()

void Qgs2DXyPlot::setYMaximum ( double maximum )

inline

Sets the maximum value of the y axis.

See also: yMaximum()

Definition at line 749 of file qgsplot.h.

◆ setYMinimum()

void Qgs2DXyPlot::setYMinimum ( double minimum )

inline

Sets the minimum value of the y axis.

See also: yMinimum()

Definition at line 721 of file qgsplot.h.

◆ writeXml()

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

overridevirtual

Writes the plot's properties into an XML element.

Reimplemented from Qgs2DPlot.

Reimplemented in QgsBarChartPlot, and QgsLineChartPlot.

Definition at line 364 of file qgsplot.cpp.

◆ xAxis() [1/2]

QgsPlotAxis & Qgs2DXyPlot::xAxis ( )

inline

Returns a reference to the plot's x axis.

See also: yAxis()

Definition at line 756 of file qgsplot.h.

◆ xAxis() [2/2]

const QgsPlotAxis & Qgs2DXyPlot::xAxis ( ) const

inline

Returns a reference to the plot's x axis.

See also: yAxis()

Definition at line 763 of file qgsplot.h.

◆ xMaximum()

double Qgs2DXyPlot::xMaximum ( ) const

inline

Returns the maximum value of the x axis.

See also: setXMaximum()

Definition at line 728 of file qgsplot.h.

◆ xMinimum()

double Qgs2DXyPlot::xMinimum ( ) const

inline

Returns the minimum value of the x axis.

See also: setXMinimum()

Definition at line 700 of file qgsplot.h.

◆ yAxis() [1/2]

QgsPlotAxis & Qgs2DXyPlot::yAxis ( )

inline

Returns a reference to the plot's y axis.

See also: xAxis()

Definition at line 770 of file qgsplot.h.

◆ yAxis() [2/2]

const QgsPlotAxis & Qgs2DXyPlot::yAxis ( ) const

inline

Returns a reference to the plot's y axis.

See also: xAxis()

Definition at line 777 of file qgsplot.h.

◆ yMaximum()

double Qgs2DXyPlot::yMaximum ( ) const

inline

Returns the maximum value of the y axis.

See also: setYMaximum()

Definition at line 742 of file qgsplot.h.

◆ yMinimum()

double Qgs2DXyPlot::yMinimum ( ) const

inline

Returns the minimum value of the y axis.

See also: setYMinimum()

Definition at line 714 of file qgsplot.h.

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

/build/qgis-3.99.0+git20251205+26c88405ac0+99sid/src/core/plot/qgsplot.h
/build/qgis-3.99.0+git20251205+26c88405ac0+99sid/src/core/plot/qgsplot.cpp

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Qgs2DXyPlot() [1/2]

◆ ~Qgs2DXyPlot()

◆ Qgs2DXyPlot() [2/2]

Member Function Documentation

◆ applyDataDefinedProperties()

◆ calculateOptimisedIntervals()

◆ chartBackgroundSymbol()

◆ chartBorderSymbol()

◆ interiorPlotArea()

◆ operator=()

◆ readXml()

◆ render()

◆ setChartBackgroundSymbol()

◆ setChartBorderSymbol()

◆ setXMaximum()

◆ setXMinimum()

◆ setYMaximum()

◆ setYMinimum()

◆ writeXml()

◆ xAxis() [1/2]

◆ xAxis() [2/2]

◆ xMaximum()

◆ xMinimum()

◆ yAxis() [1/2]

◆ yAxis() [2/2]

◆ yMaximum()

◆ yMinimum()