Classes | Public Types | Public Member Functions | Protected Member Functions | Private Attributes | List of all members
QwtPlotItem Class Referenceabstract

Base class for items on the plot canvas. More...

#include <qwt_plot_item.h>

Inheritance diagram for QwtPlotItem:
Inheritance graph
[legend]

Classes

class  PrivateData
 

Public Types

enum  ItemAttribute { Legend = 0x01, AutoScale = 0x02, Margins = 0x04 }
 Plot Item Attributes. More...
 
typedef QFlags< ItemAttributeItemAttributes
 Plot Item Attributes. More...
 
enum  ItemInterest { ScaleInterest = 0x01, LegendInterest = 0x02 }
 Plot Item Interests. More...
 
typedef QFlags< ItemInterestItemInterests
 Plot Item Interests. More...
 
enum  RenderHint { RenderAntialiased = 0x1 }
 Render hints. More...
 
typedef QFlags< RenderHintRenderHints
 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_PlotSVG, Rtti_PlotTradingCurve,
  Rtti_PlotBarChart, Rtti_PlotMultiBarChart, Rtti_PlotShape, Rtti_PlotTextLabel,
  Rtti_PlotZone, Rtti_PlotUserItem = 1000
}
 Runtime type information. More...
 

Public Member Functions

void attach (QwtPlot *plot)
 Attach the item to a plot. More...
 
virtual QRectF boundingRect () const
 
void detach ()
 This method detaches a QwtPlotItem from any QwtPlot it has been associated with. More...
 
virtual void draw (QPainter *painter, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect) const =0
 Draw the item. More...
 
virtual void getCanvasMarginHint (const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasSize, double &left, double &top, double &right, double &bottom) const
 Calculate a hint for the canvas margin. More...
 
void hide ()
 Hide the item. More...
 
bool isVisible () const
 
virtual void itemChanged ()
 
virtual void legendChanged ()
 
virtual QList< QwtLegendDatalegendData () 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...
 
QwtPlotplot () const
 Return attached plot. More...
 
 QwtPlotItem (const QwtText &title=QwtText())
 
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 (int xAxis, int 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 (int axis)
 
void setYAxis (int axis)
 
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 QwtTexttitle () const
 
virtual void updateLegend (const QwtPlotItem *, const QList< QwtLegendData > &)
 Update the item to changes of the legend info. More...
 
virtual void updateScaleDiv (const QwtScaleDiv &, const QwtScaleDiv &)
 Update the item to changes of the axes scale division. More...
 
int xAxis () const
 Return xAxis. More...
 
int yAxis () const
 Return yAxis. More...
 
double z () const
 
virtual ~QwtPlotItem ()
 Destroy the QwtPlotItem. More...
 

Protected Member Functions

QwtGraphic defaultIcon (const QBrush &, const QSizeF &) const
 Return a default icon from a brush. More...
 

Private Attributes

PrivateDatad_data
 

Detailed Description

Base class for items on the plot canvas.

A plot item is "something", that can be painted on the plot canvas, or only affects the scales of the plot widget. They can be categorized as:

Depending on the QwtPlotItem::ItemAttribute flags, an item is included into autoscaling or has an entry on the legend.

Before misusing the existing item classes it might be better to implement a new type of plot item ( don't implement a watermark as spectrogram ). Deriving a new type of QwtPlotItem primarily means to implement the YourPlotItem::draw() method.

See also
The cpuplot example shows the implementation of additional plot items.

Definition at line 64 of file qwt_plot_item.h.

Member Typedef Documentation

Plot Item Attributes.

Definition at line 163 of file qwt_plot_item.h.

Plot Item Interests.

Definition at line 197 of file qwt_plot_item.h.

Render hints.

Definition at line 207 of file qwt_plot_item.h.

Member Enumeration Documentation

Plot Item Attributes.

Various aspects of a plot widget depend on the attributes of the attached plot items. If and how a single plot item participates in these updates depends on its attributes.

See also
setItemAttribute(), testItemAttribute(), ItemInterest
Enumerator
Legend 

The item is represented on the legend.

AutoScale 

The boundingRect() of the item is included in the autoscaling calculation as long as its width or height is >= 0.0.

Margins 

The item needs extra space to display something outside its bounding rectangle.

See also
getCanvasMarginHint()

Definition at line 142 of file qwt_plot_item.h.

Plot Item Interests.

Plot items might depend on the situation of the corresponding plot widget. By enabling an interest the plot item will be notified, when the corresponding attribute of the plot widgets has changed.

See also
setItemAttribute(), testItemAttribute(), ItemInterest
Enumerator
ScaleInterest 

The item is interested in updates of the scales

See also
updateScaleDiv()
LegendInterest 

The item is interested in updates of the legend ( of other items ) This flag is intended for items, that want to implement a legend for displaying entries of other plot item.

Note
If the plot item wants to be represented on a legend enable QwtPlotItem::Legend instead.
See also
updateLegend()

Definition at line 175 of file qwt_plot_item.h.

Render hints.

Enumerator
RenderAntialiased 

Enable antialiasing.

Definition at line 200 of file qwt_plot_item.h.

Runtime type information.

RttiValues is used to cast plot items, without having to enable runtime type information of the compiler.

Enumerator
Rtti_PlotItem 

Unspecific value, that can be used, when it doesn't matter.

Rtti_PlotGrid 

For QwtPlotGrid.

Rtti_PlotScale 

For QwtPlotScaleItem.

Rtti_PlotLegend 

For QwtPlotLegendItem.

Rtti_PlotMarker 

For QwtPlotMarker.

Rtti_PlotCurve 

For QwtPlotCurve.

Rtti_PlotSpectroCurve 

For QwtPlotSpectroCurve.

Rtti_PlotIntervalCurve 

For QwtPlotIntervalCurve.

Rtti_PlotHistogram 

For QwtPlotHistogram.

Rtti_PlotSpectrogram 

For QwtPlotSpectrogram.

Rtti_PlotSVG 

For QwtPlotSvgItem.

Rtti_PlotTradingCurve 

For QwtPlotTradingCurve.

Rtti_PlotBarChart 

For QwtPlotBarChart.

Rtti_PlotMultiBarChart 

For QwtPlotMultiBarChart.

Rtti_PlotShape 

For QwtPlotShapeItem.

Rtti_PlotTextLabel 

For QwtPlotTextLabel.

Rtti_PlotZone 

For QwtPlotZoneItem.

Rtti_PlotUserItem 

Values >= Rtti_PlotUserItem are reserved for plot items not implemented in the Qwt library.

Definition at line 73 of file qwt_plot_item.h.

Constructor & Destructor Documentation

QwtPlotItem::QwtPlotItem ( const QwtText title = QwtText())
explicit

Constructor

Parameters
titleTitle of the item

Definition at line 58 of file qwt_plot_item.cpp.

QwtPlotItem::~QwtPlotItem ( )
virtual

Destroy the QwtPlotItem.

Definition at line 65 of file qwt_plot_item.cpp.

Member Function Documentation

void QwtPlotItem::attach ( QwtPlot plot)

Attach the item to a plot.

This method will attach a QwtPlotItem to the QwtPlot argument. It will first detach the QwtPlotItem from any plot from a previous call to attach (if necessary). If a NULL argument is passed, it will detach from any QwtPlot it was attached to.

Parameters
plotPlot widget
See also
detach()

Definition at line 82 of file qwt_plot_item.cpp.

QRectF QwtPlotItem::boundingRect ( ) const
virtual
Returns
An invalid bounding rect: QRectF(1.0, 1.0, -2.0, -2.0)
Note
A width or height < 0.0 is ignored by the autoscaler

Reimplemented in QwtPlotTradingCurve, QwtPlotMarker, QwtPlotIntervalCurve, QwtPlotHistogram, QwtPlotRasterItem, QwtPlotShapeItem, QwtPlotBarChart, QwtPlotMultiBarChart, QwtPlotZoneItem, QwtPlotSeriesItem, and QwtPlotSvgItem.

Definition at line 537 of file qwt_plot_item.cpp.

QwtGraphic QwtPlotItem::defaultIcon ( const QBrush &  brush,
const QSizeF &  size 
) const
protected

Return a default icon from a brush.

The default icon is a filled rectangle used in several derived classes as legendIcon().

Parameters
brushFill brush
sizeIcon size
Returns
A filled rectangle

Definition at line 391 of file qwt_plot_item.cpp.

void QwtPlotItem::detach ( )

This method detaches a QwtPlotItem from any QwtPlot it has been associated with.

detach() is equivalent to calling attach( NULL )

See also
attach()

Definition at line 103 of file qwt_plot_item.cpp.

virtual void QwtPlotItem::draw ( QPainter *  painter,
const QwtScaleMap xMap,
const QwtScaleMap yMap,
const QRectF &  canvasRect 
) const
pure virtual

Draw the item.

Parameters
painterPainter
xMapMaps x-values into pixel coordinates.
yMapMaps y-values into pixel coordinates.
canvasRectContents rect of the canvas in painter coordinates

Implemented in QwtPlotMarker, QwtPlotLegendItem, QwtPlotRasterItem, QwtPlotShapeItem, QwtPlotSpectrogram, QwtPlotScaleItem, QwtPlotGrid, QwtPlotTextLabel, QwtPlotZoneItem, QwtPlotSvgItem, QwtPlotSeriesItem, and PlotLegend.

void QwtPlotItem::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.

When the QwtPlotItem::Margins flag is enabled the plot item indicates, that it needs some margins at the borders of the canvas. This is f.e. used by bar charts to reserve space for displaying the bars.

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

Parameters
xMapMaps x-values into pixel coordinates.
yMapMaps y-values into pixel coordinates.
canvasRectContents rectangle of the canvas in painter coordinates
leftReturns the left margin
topReturns the top margin
rightReturns the right margin
bottomReturns the bottom margin
Returns
The default implementation returns 0 for all margins
See also
QwtPlot::getCanvasMarginsHint(), QwtPlot::updateCanvasMargins()

Reimplemented in QwtPlotAbstractBarChart.

Definition at line 564 of file qwt_plot_item.cpp.

void QwtPlotItem::hide ( )

Hide the item.

Definition at line 415 of file qwt_plot_item.cpp.

bool QwtPlotItem::isVisible ( ) const
Returns
true if visible
See also
setVisible(), show(), hide()

Definition at line 439 of file qwt_plot_item.cpp.

void QwtPlotItem::itemChanged ( )
virtual

Update the legend and call QwtPlot::autoRefresh() for the parent plot.

See also
QwtPlot::legendChanged(), QwtPlot::autoRefresh()

Definition at line 450 of file qwt_plot_item.cpp.

void QwtPlotItem::legendChanged ( )
virtual

Update the legend of the parent plot.

See also
QwtPlot::updateLegend(), itemChanged()

Definition at line 460 of file qwt_plot_item.cpp.

QList< QwtLegendData > QwtPlotItem::legendData ( ) const
virtual

Return all information, that is needed to represent the item on the legend.

Most items are represented by one entry on the legend showing an icon and a text, but f.e. QwtPlotMultiBarChart displays one entry for each bar.

QwtLegendData is basically a list of QVariants that makes it possible to overload and reimplement legendData() to return almost any type of information, that is understood by the receiver that acts as the legend.

The default implementation returns one entry with the title() of the item and the legendIcon().

Returns
Data, that is needed to represent the item on the legend
See also
title(), legendIcon(), QwtLegend, QwtPlotLegendItem

Reimplemented in QwtPlotBarChart, and QwtPlotMultiBarChart.

Definition at line 595 of file qwt_plot_item.cpp.

QwtGraphic QwtPlotItem::legendIcon ( int  index,
const QSizeF &  size 
) const
virtual
Returns
Icon representing the item on the legend

The default implementation returns an invalid icon

Parameters
indexIndex of the legend entry ( usually there is only one )
sizeIcon size
See also
setLegendIconSize(), legendData()

Reimplemented in QwtPlotCurve, QwtPlotTradingCurve, QwtPlotMarker, QwtPlotBarChart, QwtPlotIntervalCurve, QwtPlotHistogram, QwtPlotShapeItem, and QwtPlotMultiBarChart.

Definition at line 371 of file qwt_plot_item.cpp.

QSize QwtPlotItem::legendIconSize ( ) const
Returns
Legend icon size
See also
setLegendIconSize(), legendIcon()

Definition at line 355 of file qwt_plot_item.cpp.

QRectF QwtPlotItem::paintRect ( const QwtScaleMap xMap,
const QwtScaleMap yMap 
) const

Calculate the bounding paint rectangle of 2 maps.

Parameters
xMapMaps x-values into pixel coordinates.
yMapMaps y-values into pixel coordinates.
Returns
Bounding paint rectangle of the scale maps, not normalized

Definition at line 691 of file qwt_plot_item.cpp.

QwtPlot * QwtPlotItem::plot ( ) const

Return attached plot.

Definition at line 126 of file qwt_plot_item.cpp.

uint QwtPlotItem::renderThreadCount ( ) const
Returns
Number of threads to be used for rendering. If numThreads() is set to 0, the system specific ideal thread count is used.

Definition at line 329 of file qwt_plot_item.cpp.

int QwtPlotItem::rtti ( ) const
virtual

Return rtti for the specific class represented. QwtPlotItem is simply a virtual interface class, and base classes will implement this method with specific rtti values so a user can differentiate them.

The rtti value is useful for environments, where the runtime type information is disabled and it is not possible to do a dynamic_cast<...>.

Returns
rtti value
See also
RttiValues

Reimplemented in QwtPlotCurve, QwtPlotTradingCurve, QwtPlotShapeItem, QwtPlotSpectrogram, QwtPlotIntervalCurve, QwtPlotHistogram, QwtPlotMarker, QwtPlotBarChart, QwtPlotMultiBarChart, QwtPlotLegendItem, QwtPlotScaleItem, QwtPlotTextLabel, QwtPlotSpectroCurve, QwtPlotSvgItem, QwtPlotGrid, and QwtPlotZoneItem.

Definition at line 120 of file qwt_plot_item.cpp.

QRectF QwtPlotItem::scaleRect ( const QwtScaleMap xMap,
const QwtScaleMap yMap 
) const

Calculate the bounding scale rectangle of 2 maps.

Parameters
xMapMaps x-values into pixel coordinates.
yMapMaps y-values into pixel coordinates.
Returns
Bounding scale rect of the scale maps, not normalized

Definition at line 676 of file qwt_plot_item.cpp.

void QwtPlotItem::setAxes ( int  xAxis,
int  yAxis 
)

Set X and Y axis

The item will painted according to the coordinates of its Axes.

Parameters
xAxisX Axis ( QwtPlot::xBottom or QwtPlot::xTop )
yAxisY Axis ( QwtPlot::yLeft or QwtPlot::yRight )
See also
setXAxis(), setYAxis(), xAxis(), yAxis(), QwtPlot::Axis

Definition at line 476 of file qwt_plot_item.cpp.

void QwtPlotItem::setItemAttribute ( ItemAttribute  attribute,
bool  on = true 
)

Toggle an item attribute

Parameters
attributeAttribute type
ontrue/false
See also
testItemAttribute(), ItemInterest

Definition at line 212 of file qwt_plot_item.cpp.

void QwtPlotItem::setItemInterest ( ItemInterest  interest,
bool  on = true 
)

Toggle an item interest

Parameters
interestInterest type
ontrue/false
See also
testItemInterest(), ItemAttribute

Definition at line 248 of file qwt_plot_item.cpp.

void QwtPlotItem::setLegendIconSize ( const QSize &  size)

Set the size of the legend icon

The default setting is 8x8 pixels

Parameters
sizeSize
See also
legendIconSize(), legendIcon()

Definition at line 342 of file qwt_plot_item.cpp.

void QwtPlotItem::setRenderHint ( RenderHint  hint,
bool  on = true 
)

Toggle an render hint

Parameters
hintRender hint
ontrue/false
See also
testRenderHint(), RenderHint

Definition at line 281 of file qwt_plot_item.cpp.

void QwtPlotItem::setRenderThreadCount ( uint  numThreads)

On multi core systems rendering of certain plot item ( f.e QwtPlotRasterItem ) can be done in parallel in several threads.

The default setting is set to 1.

Parameters
numThreadsNumber of threads to be used for rendering. If numThreads is set to 0, the system specific ideal thread count is used.

The default thread count is 1 ( = no additional threads )

Definition at line 319 of file qwt_plot_item.cpp.

void QwtPlotItem::setTitle ( const QString &  title)

Set a new title

Parameters
titleTitle
See also
title()

Definition at line 171 of file qwt_plot_item.cpp.

void QwtPlotItem::setTitle ( const QwtText title)

Set a new title

Parameters
titleTitle
See also
title()

Definition at line 182 of file qwt_plot_item.cpp.

void QwtPlotItem::setVisible ( bool  on)
virtual

Show/Hide the item

Parameters
onShow if true, otherwise hide
See also
isVisible(), show(), hide()

Definition at line 426 of file qwt_plot_item.cpp.

void QwtPlotItem::setXAxis ( int  axis)

Set the X axis

The item will painted according to the coordinates its Axes.

Parameters
axisX Axis ( QwtPlot::xBottom or QwtPlot::xTop )
See also
setAxes(), setYAxis(), xAxis(), QwtPlot::Axis

Definition at line 495 of file qwt_plot_item.cpp.

void QwtPlotItem::setYAxis ( int  axis)

Set the Y axis

The item will painted according to the coordinates its Axes.

Parameters
axisY Axis ( QwtPlot::yLeft or QwtPlot::yRight )
See also
setAxes(), setXAxis(), yAxis(), QwtPlot::Axis

Definition at line 512 of file qwt_plot_item.cpp.

void QwtPlotItem::setZ ( double  z)

Set the z value.

Plot items are painted in increasing z-order.

Parameters
zZ-value
See also
z(), QwtPlotDict::itemList()

Definition at line 149 of file qwt_plot_item.cpp.

void QwtPlotItem::show ( )

Show the item.

Definition at line 409 of file qwt_plot_item.cpp.

bool QwtPlotItem::testItemAttribute ( ItemAttribute  attribute) const

Test an item attribute

Parameters
attributeAttribute type
Returns
true/false
See also
setItemAttribute(), ItemInterest

Definition at line 235 of file qwt_plot_item.cpp.

bool QwtPlotItem::testItemInterest ( ItemInterest  interest) const

Test an item interest

Parameters
interestInterest type
Returns
true/false
See also
setItemInterest(), ItemAttribute

Definition at line 268 of file qwt_plot_item.cpp.

bool QwtPlotItem::testRenderHint ( RenderHint  hint) const

Test a render hint

Parameters
hintRender hint
Returns
true/false
See also
setRenderHint(), RenderHint

Definition at line 301 of file qwt_plot_item.cpp.

const QwtText & QwtPlotItem::title ( ) const
Returns
Title of the item
See also
setTitle()

Definition at line 199 of file qwt_plot_item.cpp.

void QwtPlotItem::updateLegend ( const QwtPlotItem item,
const QList< QwtLegendData > &  data 
)
virtual

Update the item to changes of the legend info.

Plot items that want to display a legend ( not those, that want to be displayed on a legend ! ) will have to implement updateLegend().

updateLegend() is only called when the LegendInterest interest is enabled. The default implementation does nothing.

Parameters
itemPlot item to be displayed on a legend
dataAttributes how to display item on the legend
See also
QwtPlotLegendItem
Note
Plot items, that want to be displayed on a legend need to enable the QwtPlotItem::Legend flag and to implement legendData() and legendIcon()

Reimplemented in QwtPlotLegendItem.

Definition at line 661 of file qwt_plot_item.cpp.

void QwtPlotItem::updateScaleDiv ( const QwtScaleDiv xScaleDiv,
const QwtScaleDiv yScaleDiv 
)
virtual

Update the item to changes of the axes scale division.

Update the item, when the axes of plot have changed. The default implementation does nothing, but items that depend on the scale division (like QwtPlotGrid()) have to reimplement updateScaleDiv()

updateScaleDiv() is only called when the ScaleInterest interest is enabled. The default implementation does nothing.

Parameters
xScaleDivScale division of the x-axis
yScaleDivScale division of the y-axis
See also
QwtPlot::updateAxes(), ScaleInterest

Reimplemented in QwtPlotScaleItem, QwtPlotGrid, and QwtPlotSeriesItem.

Definition at line 636 of file qwt_plot_item.cpp.

int QwtPlotItem::xAxis ( ) const

Return xAxis.

Definition at line 522 of file qwt_plot_item.cpp.

int QwtPlotItem::yAxis ( ) const

Return yAxis.

Definition at line 528 of file qwt_plot_item.cpp.

double QwtPlotItem::z ( ) const

Plot items are painted in increasing z-order.

Returns
setZ(), QwtPlotDict::itemList()

Definition at line 136 of file qwt_plot_item.cpp.

Member Data Documentation

PrivateData* QwtPlotItem::d_data
private

Definition at line 295 of file qwt_plot_item.h.


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


plotjuggler
Author(s): Davide Faconti
autogenerated on Sat Jul 6 2019 03:44:18