QWT API (English) 7.0.1
Qt Widget Library for Technical Applications - English API Documentation
Loading...
Searching...
No Matches
Classes | Public Types | Public Member Functions | Protected Member Functions | List of all members
QwtPlotBarChart Class Reference

QwtPlotBarChart displays a series of values as bars. More...

#include <qwt_plot_barchart.h>

Inheritance diagram for QwtPlotBarChart:
QwtPlotAbstractBarChart QwtSeriesStore< QPointF > QwtPlotSeriesItem QwtAbstractSeriesStore QwtPlotItem QwtAbstractSeriesStore

Classes

class  PrivateData
 

Public Types

enum  LegendMode { LegendChartTitle , LegendBarTitles }
 Legend modes. More...
 
- Public Types inherited from QwtPlotAbstractBarChart
enum  LayoutPolicy { AutoAdjustSamples , ScaleSamplesToAxes , ScaleSampleToCanvas , FixedSampleSize }
 Mode how to calculate the bar width. More...
 
- Public Types inherited from QwtPlotItem
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_PlotArrowMarker , Rtti_PlotBoxChart ,
  Rtti_PlotUserItem = 1000
}
 Runtime type information. More...
 
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...
 

Public Member Functions

 QwtPlotBarChart (const QString &title=QString())
 Constructor.
 
 QwtPlotBarChart (const QwtText &title)
 Constructor.
 
virtual ~QwtPlotBarChart ()
 Destructor .
 
virtual int rtti () const override
 Get the runtime type information.
 
void setSamples (const QVector< QPointF > &)
 Initialize data with an array of points.
 
void setSamples (const QVector< double > &)
 Initialize data with an array of doubles.
 
void setSamples (QwtSeriesData< QPointF > *)
 Assign a series of samples.
 
void setSymbol (QwtColumnSymbol *)
 Assign a symbol.
 
const QwtColumnSymbolsymbol () const
 Get the current symbol.
 
void setPen (const QPen &p)
 Set the bar symbol pen.
 
QPen pen () const
 Get the bar symbol pen.
 
void setBrush (const QBrush &b)
 Set the bar symbol brush.
 
QBrush brush () const
 Get the bar symbol brush.
 
void setFrameStyle (QwtColumnSymbol::FrameStyle f)
 Set the bar symbol frame style.
 
QwtColumnSymbol::FrameStyle frameStyle () const
 Get the bar symbol frame style.
 
void setLegendMode (LegendMode)
 Set the mode that decides what to display on the legend.
 
LegendMode legendMode () const
 Get the legend mode.
 
virtual void drawSeries (QPainter *, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, int from, int to) const override
 Draw an interval of the bar chart.
 
virtual QRectF boundingRect () const override
 Get the bounding rectangle of all samples.
 
virtual QwtColumnSymbolspecialSymbol (int sampleIndex, const QPointF &) const
 Get a special symbol for a specific sample.
 
virtual QwtText barTitle (int sampleIndex) const
 Return the title of a bar.
 
- Public Member Functions inherited from QwtPlotAbstractBarChart
 QwtPlotAbstractBarChart (const QwtText &title)
 Constructor.
 
virtual ~QwtPlotAbstractBarChart ()
 Destructor .
 
void setLayoutPolicy (LayoutPolicy)
 Set the layout policy.
 
LayoutPolicy layoutPolicy () const
 Get the layout policy.
 
void setLayoutHint (double)
 Set the layout hint.
 
double layoutHint () const
 Get the layout hint.
 
void setSpacing (int)
 Set the spacing between bars.
 
int spacing () const
 Get the spacing between bars.
 
void setMargin (int)
 Set the margin around the bars.
 
int margin () const
 Get the margin around the bars.
 
void setBaseline (double)
 Set the baseline value.
 
double baseline () const
 Get the baseline value.
 
virtual void getCanvasMarginHint (const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, double &left, double &top, double &right, double &bottom) const override
 Calculate a hint for the canvas margin.
 
- Public Member Functions inherited from QwtPlotSeriesItem
 QwtPlotSeriesItem (const QString &title=QString())
 Constructor.
 
 QwtPlotSeriesItem (const QwtText &title)
 Constructor.
 
virtual ~QwtPlotSeriesItem ()
 Destructor .
 
void setOrientation (Qt::Orientation)
 Set the orientation of the item.
 
Qt::Orientation orientation () const
 Get the orientation of the plot item.
 
virtual void draw (QPainter *, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect) const override
 Draw the complete series.
 
virtual void updateScaleDiv (const QwtScaleDiv &, const QwtScaleDiv &) override
 Update the scale divisions.
 
- Public Member Functions inherited from QwtPlotItem
 QwtPlotItem ()
 Default constructor.
 
 QwtPlotItem (const QString &title)
 Constructor with title as QString.
 
 QwtPlotItem (const QwtText &title)
 Constructor with title as QwtText.
 
virtual ~QwtPlotItem ()
 Destructor.
 
void attach (QwtPlot *plot)
 Attach the item to a plot.
 
void detach ()
 Detach the item from the plot.
 
QwtPlotplot () const
 Get the plot the item is attached to.
 
void setTitle (const QString &title)
 Set the title using a QString.
 
void setTitle (const QwtText &title)
 Set the title using a QwtText.
 
const QwtTexttitle () const
 Get the title.
 
void setItemAttribute (ItemAttribute, bool on=true)
 Set an item attribute.
 
bool testItemAttribute (ItemAttribute) const
 Test an item attribute.
 
void setItemInterest (ItemInterest, bool on=true)
 Set an item interest.
 
bool testItemInterest (ItemInterest) const
 Test an item interest.
 
void setRenderHint (RenderHint, bool on=true)
 Set a render hint.
 
bool testRenderHint (RenderHint) const
 Test a render hint.
 
void setRenderThreadCount (uint numThreads)
 Set the number of render threads.
 
uint renderThreadCount () const
 Get the number of render threads.
 
void setLegendIconSize (const QSize &)
 Set the legend icon size.
 
QSize legendIconSize () const
 Get the legend icon size.
 
double z () const
 Get the z-value.
 
void setZ (double z)
 Set the z-value.
 
void show ()
 Show the item.
 
void hide ()
 Hide the item.
 
virtual void setVisible (bool)
 Set the visibility.
 
bool isVisible () const
 Check if the item is visible.
 
void setAxes (QwtAxisId xAxis, QwtAxisId yAxis)
 Set both axes.
 
void setXAxis (QwtAxisId)
 Set the x-axis.
 
QwtAxisId xAxis () const
 Get the x-axis.
 
void setYAxis (QwtAxisId)
 Set the y-axis.
 
QwtAxisId yAxis () const
 Get the y-axis.
 
virtual void itemChanged ()
 Notify the plot that the item has changed.
 
virtual void legendChanged ()
 Notify the item that the legend has changed.
 
virtual void updateLegend (const QwtPlotItem *, const QList< QwtLegendData > &)
 Update the item with changes of the legend.
 
QRectF scaleRect (const QwtScaleMap &, const QwtScaleMap &) const
 Calculate the scale rectangle.
 
QRectF paintRect (const QwtScaleMap &, const QwtScaleMap &) const
 Calculate the paint rectangle.
 
- Public Member Functions inherited from QwtSeriesStore< QPointF >
void setData (QwtSeriesData< QPointF > *series)
 
QwtSeriesData< QPointF > * data ()
 
const QwtSeriesData< QPointF > * data () const
 
QPointF sample (size_t index) const
 
virtual size_t dataSize () const override
 
virtual QRectF dataRect () const override
 
virtual void setRectOfInterest (const QRectF &rect) override
 Set a the "rectangle of interest" for the stored series.
 
QwtSeriesData< QPointF > * swapData (QwtSeriesData< QPointF > *series)
 

Protected Member Functions

virtual void drawSample (QPainter *painter, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, const QwtInterval &boundingInterval, int index, const QPointF &sample) const
 Draw a sample.
 
virtual void drawBar (QPainter *, int sampleIndex, const QPointF &sample, const QwtColumnRect &) const
 Draw a bar.
 
QwtColumnRect columnRect (const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, const QwtInterval &boundingInterval, const QPointF &sample) const
 Get column rectangle.
 
QList< QwtLegendDatalegendData () const override
 Get legend data.
 
QwtGraphic legendIcon (int index, const QSizeF &) const override
 Get legend icon.
 
- Protected Member Functions inherited from QwtPlotAbstractBarChart
double sampleWidth (const QwtScaleMap &map, double canvasSize, double boundingSize, double value) const
 Calculate the width for a sample in paint device coordinates.
 
- Protected Member Functions inherited from QwtPlotSeriesItem
virtual void dataChanged () override
 dataChanged() indicates, that the series has been changed.
 
- Protected Member Functions inherited from QwtPlotItem
QwtGraphic defaultIcon (const QBrush &, const QSizeF &) const
 Create a default icon.
 

Detailed Description

QwtPlotBarChart displays a series of values as bars.

Member Enumeration Documentation

◆ LegendMode

Legend modes.

Enumerator
LegendChartTitle 

One entry on the legend showing the default symbol and the title() of the chart

See also
QwtPlotItem::title()
LegendBarTitles 

One entry for each value showing the individual symbol of the corresponding bar and the bar title.

See also
specialSymbol(), barTitle()

Constructor & Destructor Documentation

◆ QwtPlotBarChart() [1/2]

QwtPlotBarChart::QwtPlotBarChart ( const QString &  title = QString())
explicit

Constructor.

◆ QwtPlotBarChart() [2/2]

QwtPlotBarChart::QwtPlotBarChart ( const QwtText title)
explicit

Constructor.

◆ ~QwtPlotBarChart()

QwtPlotBarChart::~QwtPlotBarChart ( )
virtual

Destructor .

Member Function Documentation

◆ barTitle()

QwtText QwtPlotBarChart::barTitle ( int  sampleIndex) const
virtual

Return the title of a bar.

◆ boundingRect()

QRectF QwtPlotBarChart::boundingRect ( ) const
overridevirtual

Get the bounding rectangle of all samples.

Reimplemented from QwtPlotSeriesItem.

◆ brush()

QBrush QwtPlotBarChart::brush ( ) const

Get the bar symbol brush.

◆ columnRect()

QwtColumnRect QwtPlotBarChart::columnRect ( const QwtScaleMap xMap,
const QwtScaleMap yMap,
const QRectF &  canvasRect,
const QwtInterval boundingInterval,
const QPointF &  sample 
) const
protected

Get column rectangle.

Calculate the geometry of a bar in widget coordinates.

Parameters
xMapx map
yMapy map
canvasRectContents rect of the canvas
boundingIntervalBounding interval of sample values
sampleValue of the sample
Returns
Geometry of the column

◆ drawBar()

void QwtPlotBarChart::drawBar ( QPainter *  painter,
int  sampleIndex,
const QPointF &  sample,
const QwtColumnRect rect 
) const
protectedvirtual

Draw a bar.

Parameters
painterPainter
sampleIndexIndex of the sample represented by the bar
sampleValue of the sample
rectBounding rectangle of the bar

◆ drawSample()

void QwtPlotBarChart::drawSample ( QPainter *  painter,
const QwtScaleMap xMap,
const QwtScaleMap yMap,
const QRectF &  canvasRect,
const QwtInterval boundingInterval,
int  index,
const QPointF &  sample 
) const
protectedvirtual

Draw a sample.

Parameters
painterPainter
xMapx map
yMapy map
canvasRectContents rect of the canvas
boundingIntervalBounding interval of sample values
indexIndex of the sample
sampleValue of the sample
See also
drawSeries()

◆ drawSeries()

void QwtPlotBarChart::drawSeries ( QPainter *  painter,
const QwtScaleMap xMap,
const QwtScaleMap yMap,
const QRectF &  canvasRect,
int  from,
int  to 
) const
overridevirtual

Draw an interval of the bar chart.

Implements QwtPlotSeriesItem.

◆ frameStyle()

QwtColumnSymbol::FrameStyle QwtPlotBarChart::frameStyle ( ) const

Get the bar symbol frame style.

◆ legendData()

QList< QwtLegendData > QwtPlotBarChart::legendData ( ) const
overrideprotectedvirtual

Get legend data.

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

In case of LegendBarTitles an entry for each bar is returned, otherwise the chart is represented like any other plot item from its title() and the legendIcon().

Returns
Information, that is needed to represent the item on the legend
See also
title(), setLegendMode(), barTitle(), QwtLegend, QwtPlotLegendItem

Reimplemented from QwtPlotItem.

◆ legendIcon()

QwtGraphic QwtPlotBarChart::legendIcon ( int  index,
const QSizeF &  size 
) const
overrideprotectedvirtual

Get legend icon.

Returns
Icon representing a bar or the chart on the legend

When the legendMode() is LegendBarTitles the icon shows the bar corresponding to index - otherwise the bar displays the default symbol.

Parameters
indexIndex of the legend entry
sizeIcon size
See also
setLegendMode(), drawBar(), QwtPlotItem::setLegendIconSize(), QwtPlotItem::legendData()

Reimplemented from QwtPlotItem.

◆ legendMode()

QwtPlotBarChart::LegendMode QwtPlotBarChart::legendMode ( ) const

Get the legend mode.

◆ pen()

QPen QwtPlotBarChart::pen ( ) const

Get the bar symbol pen.

◆ rtti()

int QwtPlotBarChart::rtti ( ) const
overridevirtual

Get the runtime type information.

Reimplemented from QwtPlotItem.

◆ setBrush()

void QwtPlotBarChart::setBrush ( const QBrush &  b)

Set the bar symbol brush.

◆ setFrameStyle()

void QwtPlotBarChart::setFrameStyle ( QwtColumnSymbol::FrameStyle  f)

Set the bar symbol frame style.

◆ setLegendMode()

void QwtPlotBarChart::setLegendMode ( LegendMode  mode)

Set the mode that decides what to display on the legend.

◆ setPen()

void QwtPlotBarChart::setPen ( const QPen &  p)

Set the bar symbol pen.

◆ setSamples() [1/3]

void QwtPlotBarChart::setSamples ( const QVector< double > &  samples)

Initialize data with an array of doubles.

◆ setSamples() [2/3]

void QwtPlotBarChart::setSamples ( const QVector< QPointF > &  samples)

Initialize data with an array of points.

◆ setSamples() [3/3]

void QwtPlotBarChart::setSamples ( QwtSeriesData< QPointF > *  data)

Assign a series of samples.

◆ setSymbol()

void QwtPlotBarChart::setSymbol ( QwtColumnSymbol symbol)

Assign a symbol.

◆ specialSymbol()

QwtColumnSymbol * QwtPlotBarChart::specialSymbol ( int  sampleIndex,
const QPointF &  sample 
) const
virtual

Get a special symbol for a specific sample.

◆ symbol()

const QwtColumnSymbol * QwtPlotBarChart::symbol ( ) const

Get the current symbol.


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