QwtPlotIntervalCurve represents a series of samples, where each value is associated with an interval ( $[y1,y2] = f(x)$ ). More...

#include <qwt_plot_intervalcurve.h>

Inheritance diagram for QwtPlotIntervalCurve:

[legend]

Public Types
enum	CurveStyle { NoCurve, Tube, UserCurve = 100 }
	Curve styles. The default setting is QwtPlotIntervalCurve::Tube. More...
enum	PaintAttribute { ClipPolygons = 0x01, ClipSymbol = 0x02 }
typedef QFlags< PaintAttribute >	PaintAttributes
	Paint attributes.
Public Member Functions
	QwtPlotIntervalCurve (const QString &title=QString::null)
	QwtPlotIntervalCurve (const QwtText &title)
virtual	~QwtPlotIntervalCurve ()
	Destructor.
virtual int	rtti () const
void	setPaintAttribute (PaintAttribute, bool on=true)
bool	testPaintAttribute (PaintAttribute) const
void	setSamples (const QVector< QwtIntervalSample > &)
void	setSamples (QwtSeriesData< QwtIntervalSample > *)
void	setPen (const QColor &, qreal width=0.0, Qt::PenStyle=Qt::SolidLine)
void	setPen (const QPen &)
	Assign a pen.
const QPen &	pen () const
void	setBrush (const QBrush &)
const QBrush &	brush () const
void	setStyle (CurveStyle style)
CurveStyle	style () const
void	setSymbol (const QwtIntervalSymbol *)
const QwtIntervalSymbol *	symbol () const
virtual void	drawSeries (QPainter *p, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, int from, int to) const
virtual QRectF	boundingRect () const
virtual QwtGraphic	legendIcon (int index, const QSizeF &) const
Protected Member Functions
void	init ()
	Initialize internal members.
virtual void	drawTube (QPainter *, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, int from, int to) const
virtual void	drawSymbols (QPainter *, const QwtIntervalSymbol &, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, int from, int to) const

Detailed Description

QwtPlotIntervalCurve represents a series of samples, where each value is associated with an interval ( $[y1,y2] = f(x)$ ).

The representation depends on the style() and an optional symbol() that is displayed for each interval. QwtPlotIntervalCurve might be used to display error bars or the area between 2 curves.

Member Enumeration Documentation

enum QwtPlotIntervalCurve::CurveStyle

Curve styles. The default setting is QwtPlotIntervalCurve::Tube.

See also:: setStyle(), style()

Enumerator:

NoCurve	Don't draw a curve. Note: This doesn't affect the symbols.
Tube	Build 2 curves from the upper and lower limits of the intervals and draw them with the pen(). The area between the curves is filled with the brush().
UserCurve	Styles >= QwtPlotIntervalCurve::UserCurve are reserved for derived classes that overload drawSeries() with additional application specific curve types.

enum QwtPlotIntervalCurve::PaintAttribute

Attributes to modify the drawing algorithm.

See also:: setPaintAttribute(), testPaintAttribute()

Enumerator:

ClipPolygons	Clip polygons before painting them. In situations, where points are far outside the visible area (f.e when zooming deep) this might be a substantial improvement for the painting performance.
ClipSymbol	Check if a symbol is on the plot canvas before painting it.

Constructor & Destructor Documentation

QwtPlotIntervalCurve::QwtPlotIntervalCurve ( const QString & title = QString::null ) [explicit]

Constructor

Parameters:

title Title of the curve

QwtPlotIntervalCurve::QwtPlotIntervalCurve ( const QwtText & title ) [explicit]

Constructor

Parameters:

title Title of the curve

Member Function Documentation

QRectF QwtPlotIntervalCurve::boundingRect ( ) const [virtual]

Returns:: Bounding rectangle of all samples. For an empty series the rectangle is invalid.

Reimplemented from QwtPlotSeriesItem.

const QBrush & QwtPlotIntervalCurve::brush ( ) const

Returns:: Brush used to fill the area in Tube style()

See also:: setBrush(), setStyle(), CurveStyle

void QwtPlotIntervalCurve::drawSeries	(	QPainter *	painter,
		const QwtScaleMap &	xMap,
		const QwtScaleMap &	yMap,
		const QRectF &	canvasRect,
		int	from,
		int	to
	)		const `[virtual]`

Draw a subset of the samples

Parameters:

painter	Painter
xMap	Maps x-values into pixel coordinates.
yMap	Maps y-values into pixel coordinates.
canvasRect	Contents rectangle of the canvas
from	Index of the first sample to be painted
to	Index of the last sample to be painted. If to < 0 the series will be painted to its last sample.

See also:: drawTube(), drawSymbols()

Implements QwtPlotSeriesItem.

void QwtPlotIntervalCurve::drawSymbols	(	QPainter *	painter,
		const QwtIntervalSymbol &	symbol,
		const QwtScaleMap &	xMap,
		const QwtScaleMap &	yMap,
		const QRectF &	canvasRect,
		int	from,
		int	to
	)		const `[protected, virtual]`

Draw symbols for a subset of the samples

Parameters:

painter	Painter
symbol	Interval symbol
xMap	x map
yMap	y map
canvasRect	Contents rectangle of the canvas
from	Index of the first sample to be painted
to	Index of the last sample to be painted

See also:: setSymbol(), drawSeries(), drawTube()

void QwtPlotIntervalCurve::drawTube	(	QPainter *	painter,
		const QwtScaleMap &	xMap,
		const QwtScaleMap &	yMap,
		const QRectF &	canvasRect,
		int	from,
		int	to
	)		const `[protected, virtual]`

Draw a tube

Builds 2 curves from the upper and lower limits of the intervals and draws them with the pen(). The area between the curves is filled with the brush().

Parameters:

painter	Painter
xMap	Maps x-values into pixel coordinates.
yMap	Maps y-values into pixel coordinates.
canvasRect	Contents rectangle of the canvas
from	Index of the first sample to be painted
to	Index of the last sample to be painted. If to < 0 the series will be painted to its last sample.

See also:: drawSeries(), drawSymbols()

QwtGraphic QwtPlotIntervalCurve::legendIcon	(	int	index,
		const QSizeF &	size
	)		const `[virtual]`

Returns:: Icon for the legend

In case of Tube style() the icon is a plain rectangle filled with the brush(). If a symbol is assigned it is scaled to size.

Parameters:

index	Index of the legend entry ( ignored as there is only one )
size	Icon size

See also:: QwtPlotItem::setLegendIconSize(), QwtPlotItem::legendData()

Reimplemented from QwtPlotItem.

const QPen & QwtPlotIntervalCurve::pen ( ) const

Returns:: Pen used to draw the lines

See also:: setPen(), brush()

int QwtPlotIntervalCurve::rtti ( ) const [virtual]

Returns:: QwtPlotItem::Rtti_PlotIntervalCurve

Reimplemented from QwtPlotItem.

void QwtPlotIntervalCurve::setBrush ( const QBrush & brush )

Assign a brush.

The brush is used to fill the area in Tube style().

Parameters:

brush Brush

See also:: brush(), pen(), setStyle(), CurveStyle

void QwtPlotIntervalCurve::setPaintAttribute	(	PaintAttribute	attribute,
		bool	on = `true`
	)

Specify an attribute how to draw the curve

Parameters:

attribute	Paint attribute
on	On/Off

See also:: testPaintAttribute()

void QwtPlotIntervalCurve::setPen	(	const QColor &	color,
		qreal	width = `0.0`,
		Qt::PenStyle	style = `Qt::SolidLine`
	)

Build and assign a pen

In Qt5 the default pen width is 1.0 ( 0.0 in Qt4 ) what makes it non cosmetic ( see QPen::isCosmetic() ). This method has been introduced to hide this incompatibility.

Parameters:

color	Pen color
width	Pen width
style	Pen style

See also:: pen(), brush()

void QwtPlotIntervalCurve::setPen ( const QPen & pen )

Assign a pen.

Parameters:

pen New pen

See also:: pen(), brush()

void QwtPlotIntervalCurve::setSamples ( const QVector< QwtIntervalSample > & samples )

Initialize data with an array of samples.

Parameters:

samples Vector of samples

void QwtPlotIntervalCurve::setSamples ( QwtSeriesData< QwtIntervalSample > * data )

Assign a series of samples

setSamples() is just a wrapper for setData() without any additional value - beside that it is easier to find for the developer.

Parameters:

data Data

Warning:: The item takes ownership of the data object, deleting it when its not used anymore.

void QwtPlotIntervalCurve::setStyle ( CurveStyle style )

Set the curve's drawing style

Parameters:

style Curve style

See also:: CurveStyle, style()

void QwtPlotIntervalCurve::setSymbol ( const QwtIntervalSymbol * symbol )

Assign a symbol.

Parameters:

symbol Symbol

See also:: symbol()

QwtPlotIntervalCurve::CurveStyle QwtPlotIntervalCurve::style ( ) const

Returns:: Style of the curve

See also:: setStyle()

const QwtIntervalSymbol * QwtPlotIntervalCurve::symbol ( ) const

Returns:: Current symbol or NULL, when no symbol has been assigned

See also:: setSymbol()

bool QwtPlotIntervalCurve::testPaintAttribute ( PaintAttribute attribute ) const

Returns:: True, when attribute is enabled

See also:: PaintAttribute, setPaintAttribute()

List of all members.

Public Types

Public Member Functions

Protected Member Functions

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation