KD Chart 2  [rev.2.7]
Signals | Public Member Functions | Protected Slots | Protected Member Functions | List of all members
KDChart::AbstractDiagram Class Referenceabstract

AbstractDiagram defines the interface for diagram classes. More...

#include <KDChartAbstractDiagram.h>

Inheritance diagram for KDChart::AbstractDiagram:
Inheritance graph
[legend]
Collaboration diagram for KDChart::AbstractDiagram:
Collaboration graph
[legend]

Signals

void aboutToBeDestroyed ()
 This signal is emitted when this diagram is being destroyed, but before all the data, i.e. More...
 
void attributesModelAboutToChange (AttributesModel *newModel, AttributesModel *oldModel)
 This signal is emitted just before the new attributes model is connected internally. More...
 
void boundariesChanged ()
 Emitted upon change of a data boundary. More...
 
void dataHidden ()
 This signal is emitted, when the hidden status of at least one data cell was (un)set. More...
 
void layoutChanged (AbstractDiagram *)
 Diagrams are supposed to emit this signal, when the layout of one of their element changes. More...
 
void modelDataChanged ()
 This signal is emitted, when the model data is changed. More...
 
void modelsChanged ()
 This signal is emitted when either the model or the AttributesModel is replaced. More...
 
void propertiesChanged ()
 Emitted upon change of a property of the Diagram. More...
 
void viewportCoordinateSystemChanged ()
 Emitted upon change of the view coordinate system. More...
 

Public Member Functions

bool allowOverlappingDataValueTexts () const
 
bool antiAliasing () const
 
virtual AttributesModelattributesModel () const
 Returns the AttributesModel, that is used by this diagram. More...
 
QBrush brush () const
 Retrieve the brush to be used for painting datapoints globally. More...
 
QBrush brush (int dataset) const
 Retrieve the brush to be used for the given dataset. More...
 
QBrush brush (const QModelIndex &index) const
 Retrieve the brush to be used, for painting the datapoint at the given index in the model. More...
 
bool compare (const AbstractDiagram *other) const
 Returns true if both diagrams have the same settings. More...
 
AbstractCoordinatePlanecoordinatePlane () const
 The coordinate plane associated with the diagram. More...
 
const QPair< QPointF, QPointF > dataBoundaries () const
 Return the bottom left and top right data point, that the diagram will display (unless the grid adjusts these values). More...
 
virtual void dataChanged (const QModelIndex &topLeft, const QModelIndex &bottomRight)
 [reimplemented] More...
 
QList< QBrush > datasetBrushes () const
 The set of dataset brushes currently used, for use in legends, etc. More...
 
int datasetDimension () const
 The dataset dimension of a diagram determines how many value dimensions it expects each datapoint to have. More...
 
QStringList datasetLabels () const
 The set of dataset labels currently displayed, for use in legends, etc. More...
 
QList< MarkerAttributesdatasetMarkers () const
 The set of dataset markers currently used, for use in legends, etc. More...
 
QList< QPen > datasetPens () const
 The set of dataset pens currently used, for use in legends, etc. More...
 
DataValueAttributes dataValueAttributes () const
 Retrieve the DataValueAttributes specified globally. More...
 
DataValueAttributes dataValueAttributes (int dataset) const
 Retrieve the DataValueAttributes for the given dataset. More...
 
DataValueAttributes dataValueAttributes (const QModelIndex &index) const
 Retrieve the DataValueAttributes for the given index. More...
 
void doItemsLayout () override
 [reimplemented] More...
 
int horizontalOffset () const override
 [reimplemented] More...
 
QModelIndex indexAt (const QPoint &point) const override
 [reimplemented] More...
 
QModelIndexList indexesAt (const QPoint &point) const
 This method is added alongside with indexAt from QAIM, since in kdchart multiple indexes can be displayed at the same spot. More...
 
QModelIndexList indexesIn (const QRect &rect) const
 
bool isHidden () const
 Retrieve the hidden status specified globally. More...
 
bool isHidden (int dataset) const
 Retrieve the hidden status for the given dataset. More...
 
bool isHidden (const QModelIndex &index) const
 Retrieve the hidden status for the given index. More...
 
bool isIndexHidden (const QModelIndex &index) const override
 [reimplemented] More...
 
QStringList itemRowLabels () const
 The set of item row labels currently displayed, for use in Abscissa axes, etc. More...
 
QModelIndex moveCursor (CursorAction cursorAction, Qt::KeyboardModifiers modifiers) override
 [reimplemented] More...
 
virtual void paint (PaintContext *paintContext)=0
 Draw the diagram contents to the rectangle and painter, that are passed in as part of the paint context. More...
 
void paintDataValueText (QPainter *painter, const QModelIndex &index, const QPointF &pos, qreal value)
 
virtual void paintMarker (QPainter *painter, const MarkerAttributes &markerAttributes, const QBrush &brush, const QPen &, const QPointF &point, const QSizeF &size)
 
void paintMarker (QPainter *painter, const DataValueAttributes &a, const QModelIndex &index, const QPointF &pos)
 
void paintMarker (QPainter *painter, const QModelIndex &index, const QPointF &pos)
 
QPen pen () const
 Retrieve the pen to be used for painting datapoints globally. More...
 
QPen pen (int dataset) const
 Retrieve the pen to be used for the given dataset. More...
 
QPen pen (const QModelIndex &index) const
 Retrieve the pen to be used, for painting the datapoint at the given index in the model. More...
 
bool percentMode () const
 Returns whether this diagram is drawn in percent mode. More...
 
virtual void resize (const QSizeF &area)=0
 Called by the widget's sizeEvent. More...
 
void scrollTo (const QModelIndex &index, ScrollHint hint=EnsureVisible) override
 [reimplemented] More...
 
void setAllowOverlappingDataValueTexts (bool allow)
 Set whether data value labels are allowed to overlap. More...
 
void setAntiAliasing (bool enabled)
 Set whether anti-aliasing is to be used while rendering this diagram. More...
 
virtual void setAttributesModel (AttributesModel *model)
 Associate an AttributesModel with this diagram. More...
 
void setBrush (const QModelIndex &index, const QBrush &brush)
 Set the brush to be used, for painting the datapoint at the given index. More...
 
void setBrush (int dataset, const QBrush &brush)
 Set the brush to be used, for painting the given dataset. More...
 
void setBrush (const QBrush &brush)
 Set the brush to be used, for painting all datasets in the model. More...
 
virtual void setCoordinatePlane (AbstractCoordinatePlane *plane)
 Set the coordinate plane associated with the diagram. More...
 
void setDatasetDimension (int dimension)
 
void setDataValueAttributes (const QModelIndex &index, const DataValueAttributes &a)
 Set the DataValueAttributes for the given index. More...
 
void setDataValueAttributes (int dataset, const DataValueAttributes &a)
 Set the DataValueAttributes for the given dataset. More...
 
void setDataValueAttributes (const DataValueAttributes &a)
 Set the DataValueAttributes for all datapoints in the model. More...
 
void setHidden (const QModelIndex &index, bool hidden)
 Hide (or unhide, resp.) a data cell. More...
 
void setHidden (int dataset, bool hidden)
 Hide (or unhide, resp.) a dataset. More...
 
void setHidden (bool hidden)
 Hide (or unhide, resp.) all datapoints in the model. More...
 
void setModel (QAbstractItemModel *model) override
 Associate a model with the diagram. More...
 
void setPen (const QModelIndex &index, const QPen &pen)
 Set the pen to be used, for painting the datapoint at the given index. More...
 
void setPen (int dataset, const QPen &pen)
 Set the pen to be used, for painting the given dataset. More...
 
void setPen (const QPen &pen)
 Set the pen to be used, for painting all datasets in the model. More...
 
void setPercentMode (bool percent)
 Deprecated method that turns the percent mode of this diagram on or off. More...
 
void setRootIndex (const QModelIndex &idx) override
 Set the root index in the model, where the diagram starts referencing data for display. More...
 
void setSelection (const QRect &rect, QItemSelectionModel::SelectionFlags command) override
 [reimplemented] More...
 
void setSelectionModel (QItemSelectionModel *selectionModel) override
 Associate a seleection model with the diagrom. More...
 
void setUnitPrefix (const QString &prefix, int column, Qt::Orientation orientation)
 Set the unit prefix to be used on axes for one specific column. More...
 
void setUnitPrefix (const QString &prefix, Qt::Orientation orientation)
 Set the unit prefix to be used on axes for all columns. More...
 
void setUnitSuffix (const QString &suffix, int column, Qt::Orientation orientation)
 Set the unit prefix to be used on axes for one specific column. More...
 
void setUnitSuffix (const QString &suffix, Qt::Orientation orientation)
 Set the unit prefix to be used on axes for all columns. More...
 
QString unitPrefix (int column, Qt::Orientation orientation, bool fallback=false) const
 Retrieves the axis unit prefix for a specific column. More...
 
QString unitPrefix (Qt::Orientation orientation) const
 Retrieves the axis unit prefix. More...
 
QString unitSuffix (int column, Qt::Orientation orientation, bool fallback=false) const
 Retrieves the axis unit suffix for a specific column. More...
 
QString unitSuffix (Qt::Orientation orientation) const
 Retrieves the axis unit suffix. More...
 
void update () const
 
void useDefaultColors ()
 Set the palette to be used, for painting datasets to the default palette. More...
 
void useRainbowColors ()
 Set the palette to be used, for painting datasets to the rainbow palette. More...
 
virtual bool usesExternalAttributesModel () const
 Returns whether the diagram is using its own built-in attributes model or an attributes model that was set via setAttributesModel. More...
 
void useSubduedColors ()
 Set the palette to be used, for painting datasets to the subdued palette. More...
 
int verticalOffset () const override
 [reimplemented] More...
 
QRect visualRect (const QModelIndex &index) const override
 [reimplemented] More...
 
virtual QRegion visualRegion (const QModelIndex &index) const
 
QRegion visualRegionForSelection (const QItemSelection &selection) const override
 [reimplemented] More...
 
 ~AbstractDiagram () override
 

Protected Slots

void setDataBoundariesDirty () const
 

Protected Member Functions

 AbstractDiagram (Private *p, QWidget *parent, AbstractCoordinatePlane *plane)
 
 AbstractDiagram (QWidget *parent=0, AbstractCoordinatePlane *plane=0)
 
QModelIndex attributesModelRootIndex () const
 
virtual const QPair< QPointF, QPointF > calculateDataBoundaries () const =0
 
virtual bool checkInvariants (bool justReturnTheStatus=false) const
 
virtual void paintDataValueTexts (QPainter *painter)
 
virtual void paintMarkers (QPainter *painter)
 
void setAttributesModelRootIndex (const QModelIndex &)
 
void setDatasetDimensionInternal (int dimension)
 
qreal valueForCell (int row, int column) const
 Helper method, retrieving the data value (DisplayRole) for a given row and column. More...
 

Detailed Description

AbstractDiagram defines the interface for diagram classes.

AbstractDiagram is the base class for diagram classes ("chart types").

It defines the interface, that needs to be implemented for the diagram, to function within the KDChart framework. It extends Interview's QAbstractItemView.

Definition at line 50 of file KDChartAbstractDiagram.h.

Constructor & Destructor Documentation

KDChart::AbstractDiagram::AbstractDiagram ( Private *  p,
QWidget parent,
AbstractCoordinatePlane plane 
)
explicitprotected
AbstractDiagram::AbstractDiagram ( QWidget parent = 0,
AbstractCoordinatePlane plane = 0 
)
explicitprotected

Definition at line 49 of file KDChartAbstractDiagram.cpp.

AbstractDiagram::~AbstractDiagram ( )
override

Definition at line 56 of file KDChartAbstractDiagram.cpp.

References aboutToBeDestroyed(), and d.

Member Function Documentation

void KDChart::AbstractDiagram::aboutToBeDestroyed ( )
signal

This signal is emitted when this diagram is being destroyed, but before all the data, i.e.

the attributes model, is invalidated.

Referenced by ~AbstractDiagram().

bool AbstractDiagram::allowOverlappingDataValueTexts ( ) const
Returns
Whether data value labels are allowed to overlap.

Definition at line 372 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by compare().

bool AbstractDiagram::antiAliasing ( ) const
Returns
Whether anti-aliasing is to be used for rendering this diagram.

Definition at line 383 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by compare(), KDChart::PaintingHelpers::paintAreas(), KDChart::PaintingHelpers::paintElements(), and KDChart::PaintingHelpers::paintThreeDLines().

AttributesModel * AbstractDiagram::attributesModel ( ) const
virtual
void KDChart::AbstractDiagram::attributesModelAboutToChange ( AttributesModel newModel,
AttributesModel oldModel 
)
signal

This signal is emitted just before the new attributes model is connected internally.

It gives you a chance to connect to its signals first or perform other setup work.

Referenced by KDChart::Plotter::Plotter(), and KDChart::AbstractCartesianDiagram::~AbstractCartesianDiagram().

QModelIndex AbstractDiagram::attributesModelRootIndex ( ) const
protected
void KDChart::AbstractDiagram::boundariesChanged ( )
signal

Emitted upon change of a data boundary.

Referenced by KDChart::Plotter::connectAttributesModel(), KDChart::Plotter::Plotter(), and KDChart::Plotter::setType().

QBrush AbstractDiagram::brush ( ) const
QBrush AbstractDiagram::brush ( int  dataset) const

Retrieve the brush to be used for the given dataset.

This will fall back automatically to what was set at model level, if there are no dataset specific settings.

Parameters
datasetThe dataset to retrieve the brush for.
Returns
The brush to use for painting.

Definition at line 714 of file KDChartAbstractDiagram.cpp.

References brush(), d, and KDChart::DatasetBrushRole.

QBrush AbstractDiagram::brush ( const QModelIndex &  index) const

Retrieve the brush to be used, for painting the datapoint at the given index in the model.

Parameters
indexThe index of the datapoint in the model. With a dataset dimension of two, this is the index of the key of each key/value pair.
Returns
The brush to use for painting.

Definition at line 722 of file KDChartAbstractDiagram.cpp.

References attributesModel(), KDChart::AttributesModel::data(), and KDChart::DatasetBrushRole.

virtual const QPair<QPointF, QPointF> KDChart::AbstractDiagram::calculateDataBoundaries ( ) const
protectedpure virtual
bool AbstractDiagram::checkInvariants ( bool  justReturnTheStatus = false) const
protectedvirtual
bool AbstractDiagram::compare ( const AbstractDiagram other) const

Returns true if both diagrams have the same settings.

Definition at line 69 of file KDChartAbstractDiagram.cpp.

References allowOverlappingDataValueTexts(), antiAliasing(), attributesModel(), KDChart::AttributesModel::compare(), datasetDimension(), and percentMode().

AbstractCoordinatePlane * AbstractDiagram::coordinatePlane ( ) const
const QPair< QPointF, QPointF > AbstractDiagram::dataBoundaries ( ) const

Return the bottom left and top right data point, that the diagram will display (unless the grid adjusts these values).

This method returns a cached result of calculations done by calculateDataBoundaries. Classes derived from AbstractDiagram must implement the calculateDataBoundaries function, to specify their own way of calculating the data boundaries. If derived classes want to force recalculation of the data boundaries, they can call setDataBoundariesDirty()

Returned value is in diagram coordinates.

Definition at line 118 of file KDChartAbstractDiagram.cpp.

References calculateDataBoundaries(), and d.

Referenced by KDChart::CartesianCoordinatePlane::getRawDataBoundingRectFromDiagrams(), KDChart::PolarCoordinatePlane::layoutDiagrams(), KDChart::RadarDiagram::paint(), KDChart::BarDiagram::paint(), KDChart::LeveyJenningsDiagram::paint(), KDChart::Plotter::paint(), and KDChart::LineDiagram::paint().

void AbstractDiagram::dataChanged ( const QModelIndex &  topLeft,
const QModelIndex &  bottomRight 
)
virtual

[reimplemented]

Definition at line 248 of file KDChartAbstractDiagram.cpp.

References setDataBoundariesDirty().

Referenced by KDChart::LeveyJenningsDiagram::setModel().

void KDChart::AbstractDiagram::dataHidden ( )
signal

This signal is emitted, when the hidden status of at least one data cell was (un)set.

Referenced by setHidden().

QList< QBrush > AbstractDiagram::datasetBrushes ( ) const

The set of dataset brushes currently used, for use in legends, etc.

Note
Cell-level override brushes, if set, take precedence over the dataset values, so you might need to check these too, in order to find the brush, that is used for a single cell.
Returns
The current set of dataset brushes.

Definition at line 910 of file KDChartAbstractDiagram.cpp.

References brush(), and d.

Referenced by KDChart::Legend::datasetCount(), KDChart::Legend::removeDiagram(), KDChart::Legend::resizeEvent(), and KDChart::Legend::setBrushesFromDiagram().

int AbstractDiagram::datasetDimension ( ) const

The dataset dimension of a diagram determines how many value dimensions it expects each datapoint to have.

For each dimension and data series it will expect one column of values in the model. If the dimension is 1, automatic values will be used for X.

For example, a diagram with the default dimension of 1 will have one column per data series (the Y values) and will use automatic values for X (1, 2, 3, ... n). If the dimension is 2, the diagram will use the first, (and the third, fifth, etc) columns as X values, and the second, (and the fourth, sixth, etc) column as Y values.

Returns
The dataset dimension of the diagram.

Definition at line 961 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by compare(), contains(), KDChart::CartesianCoordinatePlane::getDataDimensionsList(), KDChart::TernaryPointDiagram::paint(), KDChart::TernaryLineDiagram::paint(), paintDataValueTexts(), paintMarkers(), KDChart::Plotter::setType(), and KDChart::LineDiagram::setType().

QStringList AbstractDiagram::datasetLabels ( ) const

The set of dataset labels currently displayed, for use in legends, etc.

Returns
The set of dataset labels currently displayed.

Definition at line 897 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by KDChart::Legend::datasetCount(), and KDChart::Legend::resizeEvent().

QList< MarkerAttributes > AbstractDiagram::datasetMarkers ( ) const

The set of dataset markers currently used, for use in legends, etc.

Note
Cell-level override markers, if set, take precedence over the dataset values, so you might need to check these too, in order to find the marker, that is shown for a single cell.
Returns
The current set of dataset brushes.

Definition at line 936 of file KDChartAbstractDiagram.cpp.

References d, dataValueAttributes(), and KDChart::DataValueAttributes::markerAttributes().

Referenced by KDChart::Legend::resizeEvent().

QList< QPen > AbstractDiagram::datasetPens ( ) const

The set of dataset pens currently used, for use in legends, etc.

Note
Cell-level override pens, if set, take precedence over the dataset values, so you might need to check these too, in order to find the pens, that is used for a single cell.
Returns
The current set of dataset pens.

Definition at line 923 of file KDChartAbstractDiagram.cpp.

References d, and pen().

Referenced by KDChart::Legend::removeDiagram(), and KDChart::Legend::resizeEvent().

DataValueAttributes AbstractDiagram::dataValueAttributes ( ) const
DataValueAttributes AbstractDiagram::dataValueAttributes ( int  dataset) const

Retrieve the DataValueAttributes for the given dataset.

This will fall back automatically to what was set at model level, if there are no dataset specific settings.

Parameters
datasetThe dataset to retrieve the attributes for.
Returns
The DataValueAttributes for the given dataset.

Definition at line 330 of file KDChartAbstractDiagram.cpp.

References d, dataValueAttributes(), and KDChart::DataValueLabelAttributesRole.

DataValueAttributes AbstractDiagram::dataValueAttributes ( const QModelIndex &  index) const

Retrieve the DataValueAttributes for the given index.

This will fall back automatically to what was set at dataset or model level, if there are no datapoint specific settings.

Parameters
indexThe datapoint to retrieve the attributes for. With a dataset dimension of two, this is the index of the key of each key/value pair.
Returns
The DataValueAttributes for the given index.

Definition at line 350 of file KDChartAbstractDiagram.cpp.

References attributesModel(), KDChart::AttributesModel::data(), and KDChart::DataValueLabelAttributesRole.

void AbstractDiagram::doItemsLayout ( )
override

[reimplemented]

Definition at line 238 of file KDChartAbstractDiagram.cpp.

References d, and update().

int AbstractDiagram::horizontalOffset ( ) const
override

[reimplemented]

Definition at line 830 of file KDChartAbstractDiagram.cpp.

QModelIndex AbstractDiagram::indexAt ( const QPoint &  point) const
override

[reimplemented]

Definition at line 1002 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by KDChart::Chart::event().

QModelIndexList AbstractDiagram::indexesAt ( const QPoint &  point) const

This method is added alongside with indexAt from QAIM, since in kdchart multiple indexes can be displayed at the same spot.

Definition at line 1007 of file KDChartAbstractDiagram.cpp.

References d.

QModelIndexList AbstractDiagram::indexesIn ( const QRect &  rect) const

Definition at line 1012 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by KDChart::Chart::event().

bool AbstractDiagram::isHidden ( ) const

Retrieve the hidden status specified globally.

This will fall back automatically to the default settings ( = not hidden), if there are no specific settings.

Returns
The global hidden status.

Definition at line 285 of file KDChartAbstractDiagram.cpp.

References attributesModel(), KDChart::DataHiddenRole, and KDChart::AttributesModel::modelData().

Referenced by isHidden(), and KDChart::Legend::resizeEvent().

bool AbstractDiagram::isHidden ( int  dataset) const

Retrieve the hidden status for the given dataset.

This will fall back automatically to what was set at diagram level, if there are no dataset specific settings.

Parameters
datasetThe dataset to retrieve the hidden status for.
Returns
The hidden status for the given dataset.

Definition at line 290 of file KDChartAbstractDiagram.cpp.

References d, KDChart::DataHiddenRole, and isHidden().

bool AbstractDiagram::isHidden ( const QModelIndex &  index) const

Retrieve the hidden status for the given index.

This will fall back automatically to what was set at dataset or diagram level, if there are no datapoint specific settings.

Parameters
indexThe datapoint to retrieve the hidden status for.
Returns
The hidden status for the given index.

Definition at line 298 of file KDChartAbstractDiagram.cpp.

References attributesModel(), d, KDChart::DataHiddenRole, and isHidden().

bool AbstractDiagram::isIndexHidden ( const QModelIndex &  index) const
override

[reimplemented]

Definition at line 836 of file KDChartAbstractDiagram.cpp.

QStringList AbstractDiagram::itemRowLabels ( ) const

The set of item row labels currently displayed, for use in Abscissa axes, etc.

Returns
The set of item row labels currently displayed.

Definition at line 881 of file KDChartAbstractDiagram.cpp.

References attributesModel(), attributesModelRootIndex(), KDChart::AttributesModel::headerData(), KDChart::AttributesModel::rowCount(), unitPrefix(), and unitSuffix().

Referenced by numSignificantDecimalPlaces().

void KDChart::AbstractDiagram::layoutChanged ( AbstractDiagram )
signal

Diagrams are supposed to emit this signal, when the layout of one of their element changes.

Layouts can change, for example, when axes are added or removed, or when the configuration was changed in a way that the axes or the diagram itself are displayed in a different geometry. Changes in the diagrams coordinate system also result in the layoutChanged() signal being emitted.

Referenced by KDChart::LineDiagram::setCenterDataPoints(), setDatasetDimensionInternal(), KDChart::LeveyJenningsDiagram::setModel(), KDChart::AbstractPieDiagram::setPieAttributes(), KDChart::BarDiagram::setThreeDBarAttributes(), KDChart::AbstractPieDiagram::setThreeDPieAttributes(), KDChart::Plotter::setType(), KDChart::LineDiagram::setType(), and KDChart::AbstractCartesianDiagram::~AbstractCartesianDiagram().

void KDChart::AbstractDiagram::modelDataChanged ( )
signal

This signal is emitted, when the model data is changed.

void KDChart::AbstractDiagram::modelsChanged ( )
signal

This signal is emitted when either the model or the AttributesModel is replaced.

Referenced by setAttributesModel(), setModel(), and setSelectionModel().

QModelIndex AbstractDiagram::moveCursor ( CursorAction  cursorAction,
Qt::KeyboardModifiers  modifiers 
)
override

[reimplemented]

Definition at line 827 of file KDChartAbstractDiagram.cpp.

virtual void KDChart::AbstractDiagram::paint ( PaintContext paintContext)
pure virtual

Draw the diagram contents to the rectangle and painter, that are passed in as part of the paint context.

Parameters
paintContextAll information needed for painting.

Implemented in KDChart::LineDiagram, KDChart::Plotter, KDChart::LeveyJenningsDiagram, KDChart::BarDiagram, KDChart::StockDiagram, KDChart::RadarDiagram, KDChart::PolarDiagram, KDChart::PieDiagram, KDChart::RingDiagram, KDChart::TernaryLineDiagram, and KDChart::TernaryPointDiagram.

void AbstractDiagram::paintDataValueText ( QPainter *  painter,
const QModelIndex &  index,
const QPointF &  pos,
qreal  value 
)

Definition at line 400 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by paintDataValueTexts(), and KDChart::RingDiagram::resize().

void AbstractDiagram::paintDataValueTexts ( QPainter *  painter)
protectedvirtual
Deprecated:
This method is deprecated and provided for backward-compatibility only.

Your own diagram classes should call d->paintDataValueTextsAndMarkers() instead which also is taking care for showing your cell-specific comments, if any,

Definition at line 409 of file KDChartAbstractDiagram.cpp.

References checkInvariants(), coordinatePlane(), d, datasetDimension(), paintDataValueText(), and translate().

void AbstractDiagram::paintMarker ( QPainter *  painter,
const MarkerAttributes markerAttributes,
const QBrush &  brush,
const QPen &  pen,
const QPointF &  point,
const QSizeF &  size 
)
virtual
void AbstractDiagram::paintMarker ( QPainter *  painter,
const DataValueAttributes a,
const QModelIndex &  index,
const QPointF &  pos 
)
void AbstractDiagram::paintMarker ( QPainter *  painter,
const QModelIndex &  index,
const QPointF &  pos 
)
void AbstractDiagram::paintMarkers ( QPainter *  painter)
protectedvirtual
Deprecated:
This method is deprecated and provided for backward-compatibility only.

Your own diagram classes should call d->paintDataValueTextsAndMarkers() instead which also is taking care for showing your cell-specific comments, if any,

Definition at line 621 of file KDChartAbstractDiagram.cpp.

References checkInvariants(), coordinatePlane(), datasetDimension(), paintMarker(), and translate().

QPen AbstractDiagram::pen ( ) const
QPen AbstractDiagram::pen ( int  dataset) const

Retrieve the pen to be used for the given dataset.

This will fall back automatically to what was set at model level, if there are no dataset specific settings.

Parameters
datasetThe dataset to retrieve the pen for.
Returns
The pen to use for painting.

Definition at line 673 of file KDChartAbstractDiagram.cpp.

References d, KDChart::DatasetPenRole, and pen().

QPen AbstractDiagram::pen ( const QModelIndex &  index) const

Retrieve the pen to be used, for painting the datapoint at the given index in the model.

Parameters
indexThe index of the datapoint in the model. With a dataset dimension of two, this is the index of the key of each key/value pair.
Returns
The pen to use for painting.

Definition at line 681 of file KDChartAbstractDiagram.cpp.

References attributesModel(), KDChart::AttributesModel::data(), and KDChart::DatasetPenRole.

bool AbstractDiagram::percentMode ( ) const

Returns whether this diagram is drawn in percent mode.

If true, all data points in the same column of a diagram will be drawn at the same X coordinate and stacked up so that the distance from the last data point (or the zero line) to a data point P is always the ratio of (Y-Value of P)/ (sum of all Y-Values in same column as P) relative to the diagrams height (or width, if abscissa and ordinate are swapped).

Note that this property is not applicable to all diagram types.

Definition at line 394 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by compare().

void KDChart::AbstractDiagram::propertiesChanged ( )
signal
virtual void KDChart::AbstractDiagram::resize ( const QSizeF &  area)
pure virtual

Called by the widget's sizeEvent.

Adjust all internal structures, that are calculated, dependending on the size of the widget.

Parameters
area

Implemented in KDChart::LineDiagram, KDChart::Plotter, KDChart::BarDiagram, KDChart::StockDiagram, KDChart::PieDiagram, KDChart::PolarDiagram, KDChart::RadarDiagram, KDChart::RingDiagram, KDChart::TernaryLineDiagram, and KDChart::TernaryPointDiagram.

Referenced by KDChart::CartesianCoordinatePlane::setGeometry().

void AbstractDiagram::scrollTo ( const QModelIndex &  index,
ScrollHint  hint = EnsureVisible 
)
override

[reimplemented]

Definition at line 822 of file KDChartAbstractDiagram.cpp.

void AbstractDiagram::setAllowOverlappingDataValueTexts ( bool  allow)

Set whether data value labels are allowed to overlap.

Parameters
allowTrue means that overlapping labels are allowed.

Definition at line 363 of file KDChartAbstractDiagram.cpp.

References d, dataValueAttributes(), propertiesChanged(), setDataValueAttributes(), and KDChart::DataValueAttributes::setShowOverlappingDataLabels().

void AbstractDiagram::setAntiAliasing ( bool  enabled)

Set whether anti-aliasing is to be used while rendering this diagram.

Parameters
enabledTrue means that AA is enabled.

Definition at line 377 of file KDChartAbstractDiagram.cpp.

References d, and propertiesChanged().

void AbstractDiagram::setAttributesModel ( AttributesModel amodel)
virtual

Associate an AttributesModel with this diagram.

Note that the diagram does not take ownership of the AttributesModel. This should thus only be used with AttributesModels that have been explicitly created by the user, and are owned by her. Setting an AttributesModel that is internal to another diagram is an error.

Correct:

AttributesModel *am = new AttributesModel( model, 0 );
diagram1->setAttributesModel( am );
diagram2->setAttributesModel( am );

Wrong:

diagram1->setAttributesModel( diagram2->attributesModel() );
Parameters
modelThe AttributesModel to use for this diagram.
See also
AttributesModel, usesExternalAttributesModel

Sets an external AttributesModel on this diagram. By default, a diagram has it's own internal set of attributes, but an external one can be set. This can be used to share attributes between several diagrams. The diagram does not take ownership of the attributesmodel.

Parameters
amodelThe AttributesModel to use for this diagram.

Reimplemented in KDChart::AbstractCartesianDiagram.

Definition at line 173 of file KDChartAbstractDiagram.cpp.

References d, modelsChanged(), and setDataBoundariesDirty().

Referenced by KDChart::AbstractCartesianDiagram::setAttributesModel().

void AbstractDiagram::setAttributesModelRootIndex ( const QModelIndex &  idx)
protected

Definition at line 217 of file KDChartAbstractDiagram.cpp.

References d, and setDataBoundariesDirty().

Referenced by setRootIndex().

void AbstractDiagram::setBrush ( const QModelIndex &  index,
const QBrush &  brush 
)

Set the brush to be used, for painting the datapoint at the given index.

Parameters
indexThe datapoint's index in the model. With a dataset dimension of two, this is the index of the key of each key/value pair.
brushThe brush to use.

Definition at line 688 of file KDChartAbstractDiagram.cpp.

References attributesModel(), KDChart::DatasetBrushRole, propertiesChanged(), and KDChart::AttributesModel::setData().

void AbstractDiagram::setBrush ( int  dataset,
const QBrush &  brush 
)

Set the brush to be used, for painting the given dataset.

Parameters
datasetThe dataset to set the brush for.
brushThe brush to use.

Definition at line 703 of file KDChartAbstractDiagram.cpp.

References d, KDChart::DatasetBrushRole, and propertiesChanged().

void AbstractDiagram::setBrush ( const QBrush &  brush)

Set the brush to be used, for painting all datasets in the model.

Parameters
brushThe brush to use.

Definition at line 696 of file KDChartAbstractDiagram.cpp.

References attributesModel(), KDChart::DatasetBrushRole, propertiesChanged(), and KDChart::AttributesModel::setModelData().

void AbstractDiagram::setCoordinatePlane ( AbstractCoordinatePlane plane)
virtual

Set the coordinate plane associated with the diagram.

This determines how coordinates in value space are mapped into pixel space. The chart takes ownership.

Returns
The coordinate plane associated with the diagram.

Reimplemented in KDChart::AbstractCartesianDiagram.

Definition at line 233 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by KDChart::AbstractCoordinatePlane::addDiagram(), KDChart::AbstractCartesianDiagram::setCoordinatePlane(), and KDChart::AbstractCoordinatePlane::takeDiagram().

void AbstractDiagram::setDataBoundariesDirty ( ) const
protectedslot
void AbstractDiagram::setDatasetDimension ( int  dimension)
Deprecated:

Sets the dataset dimension of the diagram. Using this method is deprecated. Use the specific diagram types instead.

Definition at line 966 of file KDChartAbstractDiagram.cpp.

void AbstractDiagram::setDatasetDimensionInternal ( int  dimension)
protected
void AbstractDiagram::setDataValueAttributes ( const QModelIndex &  index,
const DataValueAttributes a 
)

Set the DataValueAttributes for the given index.

Parameters
indexThe datapoint to set the attributes for. With a dataset dimension of two, this is the index of the key of each key/value pair.
aThe attributes to set.

Definition at line 310 of file KDChartAbstractDiagram.cpp.

References d, KDChart::DataValueLabelAttributesRole, and propertiesChanged().

Referenced by setAllowOverlappingDataValueTexts().

void AbstractDiagram::setDataValueAttributes ( int  dataset,
const DataValueAttributes a 
)

Set the DataValueAttributes for the given dataset.

Parameters
datasetThe dataset to set the attributes for.
aThe attributes to set.

Definition at line 319 of file KDChartAbstractDiagram.cpp.

References d, KDChart::DataValueLabelAttributesRole, and propertiesChanged().

void AbstractDiagram::setDataValueAttributes ( const DataValueAttributes a)

Set the DataValueAttributes for all datapoints in the model.

Parameters
aThe attributes to set.

Definition at line 357 of file KDChartAbstractDiagram.cpp.

References d, KDChart::DataValueLabelAttributesRole, and propertiesChanged().

void AbstractDiagram::setHidden ( const QModelIndex &  index,
bool  hidden 
)

Hide (or unhide, resp.) a data cell.

Note
Hidden data are still taken into account by the coordinate plane, so neither the grid nor your axes' ranges will change, when you hide data. For totally removing data from KD Chart's view you can use another approach: e.g. you could define a proxy model on top of your data model, and register the proxy model calling setModel() instead of registering your real data model.
Parameters
indexThe datapoint to set the hidden status for. With a dataset dimension of two, this is the index of the key of each key/value pair.
hiddenThe hidden status to set.

Definition at line 264 of file KDChartAbstractDiagram.cpp.

References d, dataHidden(), and KDChart::DataHiddenRole.

void AbstractDiagram::setHidden ( int  dataset,
bool  hidden 
)

Hide (or unhide, resp.) a dataset.

Note
Hidden data are still taken into account by the coordinate plane, so neither the grid nor your axes' ranges will change, when you hide data. For totally removing data from KD Chart's view you can use another approach: e.g. you could define a proxy model on top of your data model, and register the proxy model calling setModel() instead of registering your real data model.
Parameters
datasetThe dataset to set the hidden status for.
hiddenThe hidden status to set.

Definition at line 273 of file KDChartAbstractDiagram.cpp.

References d, dataHidden(), and KDChart::DataHiddenRole.

void AbstractDiagram::setHidden ( bool  hidden)

Hide (or unhide, resp.) all datapoints in the model.

Note
Hidden data are still taken into account by the coordinate plane, so neither the grid nor your axes' ranges will change, when you hide data. For totally removing data from KD Chart's view you can use another approach: e.g. you could define a proxy model on top of your data model, and register the proxy model calling setModel() instead of registering your real data model.
Parameters
hiddenThe hidden status to set.

Definition at line 279 of file KDChartAbstractDiagram.cpp.

References d, dataHidden(), and KDChart::DataHiddenRole.

void AbstractDiagram::setModel ( QAbstractItemModel *  model)
override
void AbstractDiagram::setPen ( const QModelIndex &  index,
const QPen &  pen 
)

Set the pen to be used, for painting the datapoint at the given index.

Parameters
indexThe datapoint's index in the model. With a dataset dimension of two, this is the index of the key of each key/value pair.
penThe pen to use.

Definition at line 647 of file KDChartAbstractDiagram.cpp.

References attributesModel(), KDChart::DatasetPenRole, propertiesChanged(), and KDChart::AttributesModel::setData().

Referenced by KDChart::LeveyJenningsDiagram::LeveyJenningsDiagram().

void AbstractDiagram::setPen ( int  dataset,
const QPen &  pen 
)

Set the pen to be used, for painting the given dataset.

Parameters
datasetThe dataset to set the pen for.
penThe pen to use.

Definition at line 662 of file KDChartAbstractDiagram.cpp.

References d, KDChart::DatasetPenRole, and propertiesChanged().

void AbstractDiagram::setPen ( const QPen &  pen)

Set the pen to be used, for painting all datasets in the model.

Parameters
penThe pen to use.

Definition at line 655 of file KDChartAbstractDiagram.cpp.

References attributesModel(), KDChart::DatasetPenRole, propertiesChanged(), and KDChart::AttributesModel::setModelData().

void AbstractDiagram::setPercentMode ( bool  percent)

Deprecated method that turns the percent mode of this diagram on or off.

Deprecated:

This method is deprecated. Use the setType() method of a supporting diagram implementation instead, e.g. BarDiagram::setType().

See also
percentMode

Definition at line 388 of file KDChartAbstractDiagram.cpp.

References d, and propertiesChanged().

Referenced by KDChart::LineDiagram::setType().

void AbstractDiagram::setRootIndex ( const QModelIndex &  idx)
override

Set the root index in the model, where the diagram starts referencing data for display.

[reimplemented]

Definition at line 210 of file KDChartAbstractDiagram.cpp.

References d, and setAttributesModelRootIndex().

Referenced by KDChart::AbstractCartesianDiagram::setRootIndex().

void AbstractDiagram::setSelection ( const QRect &  rect,
QItemSelectionModel::SelectionFlags  command 
)
override

[reimplemented]

Definition at line 839 of file KDChartAbstractDiagram.cpp.

References d.

void AbstractDiagram::setSelectionModel ( QItemSelectionModel *  selectionModel)
override

Associate a seleection model with the diagrom.

Definition at line 150 of file KDChartAbstractDiagram.cpp.

References modelsChanged().

void AbstractDiagram::setUnitPrefix ( const QString &  prefix,
int  column,
Qt::Orientation  orientation 
)

Set the unit prefix to be used on axes for one specific column.

Sets the unit prefix for one value.

Parameters
prefixThe prefix to be used.
columnThe column which should be set.
orientationThe orientation of the axis to use.
prefixthe prefix to be set
columnthe value using that prefix
orientationthe orientantion of the axis to set

Definition at line 734 of file KDChartAbstractDiagram.cpp.

References d.

void AbstractDiagram::setUnitPrefix ( const QString &  prefix,
Qt::Orientation  orientation 
)

Set the unit prefix to be used on axes for all columns.

Sets the unit prefix for all values.

Parameters
prefixThe prefix to be used.
orientationThe orientation of the axis to use.
prefixthe prefix to be set
orientationthe orientantion of the axis to set

Definition at line 744 of file KDChartAbstractDiagram.cpp.

References d.

void AbstractDiagram::setUnitSuffix ( const QString &  suffix,
int  column,
Qt::Orientation  orientation 
)

Set the unit prefix to be used on axes for one specific column.

Sets the unit suffix for one value.

Parameters
suffixThe suffix to be used.
columnThe column which should be set.
orientationThe orientation of the axis to use.
suffixthe suffix to be set
columnthe value using that suffix
orientationthe orientantion of the axis to set

Definition at line 755 of file KDChartAbstractDiagram.cpp.

References d.

void AbstractDiagram::setUnitSuffix ( const QString &  suffix,
Qt::Orientation  orientation 
)

Set the unit prefix to be used on axes for all columns.

Sets the unit suffix for all values.

Parameters
suffixThe suffix to be used.
orientationThe orientation of the axis to use.
suffixthe suffix to be set
orientationthe orientantion of the axis to set

Definition at line 765 of file KDChartAbstractDiagram.cpp.

References d.

QString AbstractDiagram::unitPrefix ( int  column,
Qt::Orientation  orientation,
bool  fallback = false 
) const

Retrieves the axis unit prefix for a specific column.

Returns the unit prefix for a special value.

Parameters
columnThe column whose prefix should be retrieved.
orientationThe orientation of the axis.
fallbackIf true, the prefix for all columns is returned, when none is set for the selected column.
Returns
The axis unit prefix.
Parameters
columnthe value which's prefix is requested
orientationthe orientation of the axis
fallbackif true, the global prefix is return when no specific one is set for that value
Returns
the unit prefix

Definition at line 777 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by itemRowLabels(), and KDChart::CartesianAxis::paint().

QString AbstractDiagram::unitPrefix ( Qt::Orientation  orientation) const

Retrieves the axis unit prefix.

Returns the global unit prefix.

Parameters
orientationThe orientation of the axis.
Returns
The axis unit prefix.
Parameters
orientationthe orientation of the axis
Returns
the unit prefix

Definition at line 788 of file KDChartAbstractDiagram.cpp.

References d.

QString AbstractDiagram::unitSuffix ( int  column,
Qt::Orientation  orientation,
bool  fallback = false 
) const

Retrieves the axis unit suffix for a specific column.

Returns the unit suffix for a special value.

Parameters
columnThe column whose prefix should be retrieved.
orientationThe orientation of the axis.
fallbackIf true, the suffix for all columns is returned, when none is set for the selected column.
Returns
The axis unit suffix.
Parameters
columnthe value which's suffix is requested
orientationthe orientation of the axis
fallbackif true, the global suffix is return when no specific one is set for that value
Returns
the unit suffix

Definition at line 800 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by itemRowLabels(), and KDChart::CartesianAxis::paint().

QString AbstractDiagram::unitSuffix ( Qt::Orientation  orientation) const

Retrieves the axis unit suffix.

Returns the global unit suffix.

Parameters
orientationThe orientation of the axis.
Returns
The axis unit suffix.
Parameters
orientationthe orientation of the axis
Returns
the unit siffix

Definition at line 811 of file KDChartAbstractDiagram.cpp.

References d.

void AbstractDiagram::update ( ) const
void KDChart::AbstractDiagram::useDefaultColors ( )

Set the palette to be used, for painting datasets to the default palette.

See also
KDChart::Palette. FIXME: fold into one usePalette (KDChart::Palette&) method

Definition at line 866 of file KDChartAbstractDiagram.cpp.

References d, and KDChart::AttributesModel::PaletteTypeDefault.

void KDChart::AbstractDiagram::useRainbowColors ( )

Set the palette to be used, for painting datasets to the rainbow palette.

See also
KDChart::Palette.

Definition at line 876 of file KDChartAbstractDiagram.cpp.

References d, and KDChart::AttributesModel::PaletteTypeRainbow.

bool AbstractDiagram::usesExternalAttributesModel ( ) const
virtual

Returns whether the diagram is using its own built-in attributes model or an attributes model that was set via setAttributesModel.

See also
setAttributesModel

Definition at line 193 of file KDChartAbstractDiagram.cpp.

References d.

void KDChart::AbstractDiagram::useSubduedColors ( )

Set the palette to be used, for painting datasets to the subdued palette.

See also
KDChart::Palette.

Definition at line 871 of file KDChartAbstractDiagram.cpp.

References d, and KDChart::AttributesModel::PaletteTypeSubdued.

qreal AbstractDiagram::valueForCell ( int  row,
int  column 
) const
protected

Helper method, retrieving the data value (DisplayRole) for a given row and column.

Parameters
rowThe row to query.
columnThe column to query.
Returns
The value of the display role at the given row and column as a qreal.
Deprecated:

Definition at line 985 of file KDChartAbstractDiagram.cpp.

References attributesModelRootIndex(), and d.

int AbstractDiagram::verticalOffset ( ) const
override

[reimplemented]

Definition at line 833 of file KDChartAbstractDiagram.cpp.

void KDChart::AbstractDiagram::viewportCoordinateSystemChanged ( )
signal
QRect AbstractDiagram::visualRect ( const QModelIndex &  index) const
override

[reimplemented]

Definition at line 817 of file KDChartAbstractDiagram.cpp.

References d.

QRegion AbstractDiagram::visualRegion ( const QModelIndex &  index) const
virtual

Definition at line 860 of file KDChartAbstractDiagram.cpp.

References d.

QRegion AbstractDiagram::visualRegionForSelection ( const QItemSelection &  selection) const
override

[reimplemented]

Definition at line 850 of file KDChartAbstractDiagram.cpp.

References d.


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

Klarälvdalens Datakonsult AB (KDAB)
"The Qt, C++ and OpenGL Experts"
https://www.kdab.com/

https://www.kdab.com/development-resources/qt-tools/kd-chart/