Abstract base class for bar chart items. More...

#include <qwt_plot_abstract_barchart.h>

Inheritance diagram for QwtPlotAbstractBarChart:

[legend]

Classes
class	PrivateData

Public Types
enum	LayoutPolicy { AutoAdjustSamples, ScaleSamplesToAxes, ScaleSampleToCanvas, FixedSampleSize }
	Mode how to calculate the bar width. More...

Public Types inherited from QwtPlotItem
enum	ItemAttribute { Legend = 0x01, AutoScale = 0x02, Margins = 0x04 }
	Plot Item Attributes. More...

enum	ItemInterest { ScaleInterest = 0x01, LegendInterest = 0x02 }
	Plot Item Interests. More...

enum	RenderHint { RenderAntialiased = 0x1 }
	Render hints. More...

enum	RttiValues { Rtti_PlotItem = 0, Rtti_PlotGrid, Rtti_PlotScale, Rtti_PlotLegend, Rtti_PlotMarker, Rtti_PlotCurve, Rtti_PlotSpectroCurve, Rtti_PlotIntervalCurve, Rtti_PlotHistogram, Rtti_PlotSpectrogram, Rtti_PlotGraphic, Rtti_PlotTradingCurve, Rtti_PlotBarChart, Rtti_PlotMultiBarChart, Rtti_PlotShape, Rtti_PlotTextLabel, Rtti_PlotZone, Rtti_PlotVectorField, Rtti_PlotUserItem = 1000 }
	Runtime type information. More...

Public Member Functions
double	baseline () const

virtual void	getCanvasMarginHint (const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, double &left, double &top, double &right, double &bottom) const QWT_OVERRIDE
	Calculate a hint for the canvas margin. More...

double	layoutHint () const

LayoutPolicy	layoutPolicy () const

int	margin () const

	QwtPlotAbstractBarChart (const QwtText &title)

void	setBaseline (double)
	Set the baseline. More...

void	setLayoutHint (double)

void	setLayoutPolicy (LayoutPolicy)

void	setMargin (int)
	Set the margin. More...

void	setSpacing (int)
	Set the spacing. More...

int	spacing () const

virtual	~QwtPlotAbstractBarChart ()
	Destructor. More...

Public Member Functions inherited from QwtPlotSeriesItem
virtual QRectF	boundingRect () const QWT_OVERRIDE

virtual void	draw (QPainter *, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect) const QWT_OVERRIDE
	Draw the complete series. More...

virtual void	drawSeries (QPainter *painter, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, int from, int to) const =0

Qt::Orientation	orientation () const

	QwtPlotSeriesItem (const QString &title=QString())

	QwtPlotSeriesItem (const QwtText &title)

void	setOrientation (Qt::Orientation)

virtual void	updateScaleDiv (const QwtScaleDiv &, const QwtScaleDiv &) QWT_OVERRIDE
	Update the item to changes of the axes scale division. More...

virtual	~QwtPlotSeriesItem ()
	Destructor. More...

Public Member Functions inherited from QwtPlotItem
void	attach (QwtPlot *plot)
	Attach the item to a plot. More...

void	detach ()
	This method detaches a QwtPlotItem from any QwtPlot it has been associated with. More...

void	hide ()
	Hide the item. More...

bool	isVisible () const

virtual void	itemChanged ()

virtual void	legendChanged ()

virtual QList< QwtLegendData >	legendData () const
	Return all information, that is needed to represent the item on the legend. More...

virtual QwtGraphic	legendIcon (int index, const QSizeF &) const

QSize	legendIconSize () const

QRectF	paintRect (const QwtScaleMap &, const QwtScaleMap &) const
	Calculate the bounding paint rectangle of 2 maps. More...

QwtPlot *	plot () const
	Return attached plot. More...

	QwtPlotItem ()

	QwtPlotItem (const QString &title)

	QwtPlotItem (const QwtText &title)

uint	renderThreadCount () const

virtual int	rtti () const

QRectF	scaleRect (const QwtScaleMap &, const QwtScaleMap &) const
	Calculate the bounding scale rectangle of 2 maps. More...

void	setAxes (QwtAxisId xAxis, QwtAxisId yAxis)

void	setItemAttribute (ItemAttribute, bool on=true)

void	setItemInterest (ItemInterest, bool on=true)

void	setLegendIconSize (const QSize &)

void	setRenderHint (RenderHint, bool on=true)

void	setRenderThreadCount (uint numThreads)

void	setTitle (const QString &title)

void	setTitle (const QwtText &title)

virtual void	setVisible (bool)

void	setXAxis (QwtAxisId)

void	setYAxis (QwtAxisId)

void	setZ (double z)
	Set the z value. More...

void	show ()
	Show the item. More...

bool	testItemAttribute (ItemAttribute) const

bool	testItemInterest (ItemInterest) const

bool	testRenderHint (RenderHint) const

const QwtText &	title () const

virtual void	updateLegend (const QwtPlotItem *, const QList< QwtLegendData > &)
	Update the item to changes of the legend info. More...

QwtAxisId	xAxis () const
	Return xAxis. More...

QwtAxisId	yAxis () const
	Return yAxis. More...

double	z () const

virtual	~QwtPlotItem ()
	Destroy the QwtPlotItem. More...

Public Member Functions inherited from QwtAbstractSeriesStore
virtual	~QwtAbstractSeriesStore ()
	Destructor. More...

Protected Member Functions
double	sampleWidth (const QwtScaleMap &map, double canvasSize, double boundingSize, double value) const

Protected Member Functions inherited from QwtPlotSeriesItem
virtual void	dataChanged () QWT_OVERRIDE
	dataChanged() indicates, that the series has been changed. More...

Protected Member Functions inherited from QwtPlotItem
QwtGraphic	defaultIcon (const QBrush &, const QSizeF &) const
	Return a default icon from a brush. More...

Protected Member Functions inherited from QwtAbstractSeriesStore
virtual QRectF	dataRect () const =0

virtual size_t	dataSize () const =0

virtual void	setRectOfInterest (const QRectF &)=0

Private Attributes
PrivateData *	m_data

Detailed Description

Abstract base class for bar chart items.

In opposite to almost all other plot items bar charts can't be displayed inside of their bounding rectangle and need a special API how to calculate the width of the bars and how they affect the layout of the attached plot.

Definition at line 24 of file qwt_plot_abstract_barchart.h.

Member Enumeration Documentation

◆ LayoutPolicy

enum QwtPlotAbstractBarChart::LayoutPolicy

Mode how to calculate the bar width.

setLayoutPolicy(), setLayoutHint(), barWidthHint()

Enumerator
AutoAdjustSamples	The sample width is calculated by dividing the bounding rectangle by the number of samples. The layoutHint() is used as a minimum width in paint device coordinates. See also boundingRectangle()
ScaleSamplesToAxes	layoutHint() defines an interval in axis coordinates
ScaleSampleToCanvas	The bar width is calculated by multiplying layoutHint() with the height or width of the canvas. See also boundingRectangle()
FixedSampleSize	layoutHint() defines a fixed width in paint device coordinates.

Definition at line 39 of file qwt_plot_abstract_barchart.h.

Constructor & Destructor Documentation

◆ QwtPlotAbstractBarChart()

QwtPlotAbstractBarChart::QwtPlotAbstractBarChart ( const QwtText & title )

explicit

Constructor

Parameters

title Title of the chart

Definition at line 48 of file qwt_plot_abstract_barchart.cpp.

◆ ~QwtPlotAbstractBarChart()

QwtPlotAbstractBarChart::~QwtPlotAbstractBarChart ( )

virtual

Destructor.

Definition at line 60 of file qwt_plot_abstract_barchart.cpp.

Member Function Documentation

◆ baseline()

double QwtPlotAbstractBarChart::baseline ( ) const

Returns: Value for the origin of the bar chart

See also: setBaseline(), QwtPlotSeriesItem::orientation()

Definition at line 208 of file qwt_plot_abstract_barchart.cpp.

◆ getCanvasMarginHint()

void QwtPlotAbstractBarChart::getCanvasMarginHint	(	const QwtScaleMap &	xMap,
		const QwtScaleMap &	yMap,
		const QRectF &	canvasRect,
		double &	left,
		double &	top,
		double &	right,
		double &	bottom
	)		const

virtual

Calculate a hint for the canvas margin.

Bar charts need to reserve some space for displaying the bars for the first and the last sample. The hint is calculated from the layoutHint() depending on the layoutPolicy().

The margins are in target device coordinates ( pixels on screen )

Parameters

xMap	Maps x-values into pixel coordinates.
yMap	Maps y-values into pixel coordinates.
canvasRect	Contents rectangle of the canvas in painter coordinates
left	Returns the left margin
top	Returns the top margin
right	Returns the right margin
bottom	Returns the bottom margin

Returns: Margin

See also: layoutPolicy(), layoutHint(), QwtPlotItem::Margins QwtPlot::getCanvasMarginsHint(), QwtPlot::updateCanvasMargins()

Reimplemented from QwtPlotItem.

Definition at line 289 of file qwt_plot_abstract_barchart.cpp.

◆ layoutHint()

double QwtPlotAbstractBarChart::layoutHint ( ) const

The combination of layoutPolicy() and layoutHint() define how the width of the bars is calculated

Returns: Layout policy of the chart item

See also: LayoutPolicy, setLayoutHint(), layoutPolicy()

Definition at line 119 of file qwt_plot_abstract_barchart.cpp.

◆ layoutPolicy()

QwtPlotAbstractBarChart::LayoutPolicy QwtPlotAbstractBarChart::layoutPolicy ( ) const

The combination of layoutPolicy() and layoutHint() define how the width of the bars is calculated

Returns: Layout policy of the chart item

See also: setLayoutPolicy(), layoutHint()

Definition at line 89 of file qwt_plot_abstract_barchart.cpp.

◆ margin()

int QwtPlotAbstractBarChart::margin ( ) const

Returns: Margin between the outmost bars and the contentsRect() of the canvas.

See also: setMargin(), spacing()

Definition at line 176 of file qwt_plot_abstract_barchart.cpp.

◆ sampleWidth()

double QwtPlotAbstractBarChart::sampleWidth	(	const QwtScaleMap &	map,
		double	canvasSize,
		double	boundingSize,
		double	value
	)		const

protected

Calculate the width for a sample in paint device coordinates

Parameters

map	Scale map for the corresponding scale
canvasSize	Size of the canvas in paint device coordinates
boundingSize	Bounding size of the chart in plot coordinates ( used in AutoAdjustSamples mode )
value	Value of the sample

Returns: Sample width

See also: layoutPolicy(), layoutHint()

Definition at line 225 of file qwt_plot_abstract_barchart.cpp.

◆ setBaseline()

void QwtPlotAbstractBarChart::setBaseline ( double value )

Set the baseline.

The baseline is the origin for the chart. Each bar is painted from the baseline in the direction of the sample value. In case of a horizontal orientation() the baseline is interpreted as x - otherwise as y - value.

The default value for the baseline is 0.

Parameters

value Value for the baseline