AbstractDiagram defines the interface for diagram classes. More...
#include <KDChartAbstractDiagram.h>
Signals | |
void | aboutToBeDestroyed () |
This signal is emitted when this diagram is being destroyed, but before all the data, i.e. | |
void | dataHidden () |
This signal is emitted, when the hidden status of at least one data cell was (un)set. | |
void | layoutChanged (AbstractDiagram *) |
Diagrams are supposed to emit this signal, when the layout of one of their element changes. | |
void | modelDataChanged () |
This signal is emitted, when the model data is changed. | |
void | modelsChanged () |
This signal is emitted, when either the model or the AttributesModel is replaced. | |
void | propertiesChanged () |
Emitted upon change of a property of the Diagram. | |
Public Member Functions | |
bool | allowOverlappingDataValueTexts () const |
bool | antiAliasing () const |
virtual AttributesModel * | attributesModel () const |
Returns the AttributesModel, that is used by this diagram. | |
QBrush | brush (const QModelIndex &index) const |
Retrieve the brush to be used, for painting the datapoint at the given index in the model. | |
QBrush | brush (int dataset) const |
Retrieve the brush to be used for the given dataset. | |
QBrush | brush () const |
Retrieve the brush to be used for painting datapoints globally. | |
bool | compare (const AbstractDiagram *other) const |
Returns true if both diagrams have the same settings. | |
AbstractCoordinatePlane * | coordinatePlane () const |
The coordinate plane associated with the diagram. | |
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). | |
virtual void | dataChanged (const QModelIndex &topLeft, const QModelIndex &bottomRight) |
[reimplemented] | |
QList< QBrush > | datasetBrushes () const |
The set of dataset brushes currently used, for use in legends, etc. | |
int | datasetDimension () const |
The dataset dimension of a diagram determines, how many value dimensions it expects each datapoint to have. | |
QStringList | datasetLabels () const |
The set of dataset labels currently displayed, for use in legends, etc. | |
QList< MarkerAttributes > | datasetMarkers () const |
The set of dataset markers currently used, for use in legends, etc. | |
QList< QPen > | datasetPens () const |
The set of dataset pens currently used, for use in legends, etc. | |
DataValueAttributes | dataValueAttributes (const QModelIndex &index) const |
Retrieve the DataValueAttributes for the given index. | |
DataValueAttributes | dataValueAttributes (int dataset) const |
Retrieve the DataValueAttributes for the given dataset. | |
DataValueAttributes | dataValueAttributes () const |
Retrieve the DataValueAttributes specified globally. | |
virtual void | doItemsLayout () |
[reimplemented] | |
virtual int | horizontalOffset () const |
[reimplemented] | |
virtual QModelIndex | indexAt (const QPoint &point) const |
[reimplemented] | |
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. | |
bool | isHidden (const QModelIndex &index) const |
Retrieve the hidden status for the given index. | |
bool | isHidden (int dataset) const |
Retrieve the hidden status for the given dataset. | |
bool | isHidden () const |
Retrieve the hidden status specified globally. | |
virtual bool | isIndexHidden (const QModelIndex &index) const |
[reimplemented] | |
QStringList | itemRowLabels () const |
The set of item row labels currently displayed, for use in Abscissa axes, etc. | |
virtual QModelIndex | moveCursor (CursorAction cursorAction, Qt::KeyboardModifiers modifiers) |
[reimplemented] | |
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. | |
void | paintDataValueText (QPainter *painter, const QModelIndex &index, const QPointF &pos, double value) |
void | paintMarker (QPainter *painter, const QModelIndex &index, const QPointF &pos) |
void | paintMarker (QPainter *painter, const DataValueAttributes &a, const QModelIndex &index, const QPointF &pos) |
virtual void | paintMarker (QPainter *painter, const MarkerAttributes &markerAttributes, const QBrush &brush, const QPen &, const QPointF &point, const QSizeF &size) |
QPen | pen (const QModelIndex &index) const |
Retrieve the pen to be used, for painting the datapoint at the given index in the model. | |
QPen | pen (int dataset) const |
Retrieve the pen to be used for the given dataset. | |
QPen | pen () const |
Retrieve the pen to be used for painting datapoints globally. | |
bool | percentMode () const |
Returns whether this diagram is drawn in percent mode. | |
virtual void | resize (const QSizeF &area)=0 |
Called by the widget's sizeEvent. | |
virtual void | scrollTo (const QModelIndex &index, ScrollHint hint=EnsureVisible) |
[reimplemented] | |
void | setAllowOverlappingDataValueTexts (bool allow) |
Set whether data value labels are allowed to overlap. | |
void | setAntiAliasing (bool enabled) |
Set whether anti-aliasing is to be used while rendering this diagram. | |
virtual void | setAttributesModel (AttributesModel *model) |
Associate an AttributesModel with this diagram. | |
void | setBrush (const QBrush &brush) |
Set the brush to be used, for painting all datasets in the model. | |
void | setBrush (int dataset, const QBrush &brush) |
Set the brush to be used, for painting the given dataset. | |
void | setBrush (const QModelIndex &index, const QBrush &brush) |
Set the brush to be used, for painting the datapoint at the given index. | |
virtual void | setCoordinatePlane (AbstractCoordinatePlane *plane) |
Set the coordinate plane associated with the diagram. | |
void | setDatasetDimension (int dimension) |
void | setDataValueAttributes (const DataValueAttributes &a) |
Set the DataValueAttributes for all datapoints in the model. | |
void | setDataValueAttributes (int dataset, const DataValueAttributes &a) |
Set the DataValueAttributes for the given dataset. | |
void | setDataValueAttributes (const QModelIndex &index, const DataValueAttributes &a) |
Set the DataValueAttributes for the given index. | |
void | setHidden (bool hidden) |
Hide (or unhide, resp. | |
void | setHidden (int dataset, bool hidden) |
Hide (or unhide, resp. | |
void | setHidden (const QModelIndex &index, bool hidden) |
Hide (or unhide, resp. | |
virtual void | setModel (QAbstractItemModel *model) |
Associate a model with the diagram. | |
void | setPen (const QPen &pen) |
Set the pen to be used, for painting all datasets in the model. | |
void | setPen (int dataset, const QPen &pen) |
Set the pen to be used, for painting the given dataset. | |
void | setPen (const QModelIndex &index, const QPen &pen) |
Set the pen to be used, for painting the datapoint at the given index. | |
void | setPercentMode (bool percent) |
Deprecated method that turns the percent mode of this diagram on or off. | |
virtual void | setRootIndex (const QModelIndex &idx) |
Set the root index in the model, where the diagram starts referencing data for display. | |
virtual void | setSelection (const QRect &rect, QItemSelectionModel::SelectionFlags command) |
[reimplemented] | |
virtual void | setSelectionModel (QItemSelectionModel *selectionModel) |
Associate a seleection model with the diagrom. | |
void | setUnitPrefix (const QString &prefix, Qt::Orientation orientation) |
Set the unit prefix to be used on axes for all columns. | |
void | setUnitPrefix (const QString &prefix, int column, Qt::Orientation orientation) |
Set the unit prefix to be used on axes for one specific column. | |
void | setUnitSuffix (const QString &suffix, Qt::Orientation orientation) |
Set the unit prefix to be used on axes for all columns. | |
void | setUnitSuffix (const QString &suffix, int column, Qt::Orientation orientation) |
Set the unit prefix to be used on axes for one specific column. | |
QString | unitPrefix (Qt::Orientation orientation) const |
Retrieves the axis unit prefix. | |
QString | unitPrefix (int column, Qt::Orientation orientation, bool fallback=false) const |
Retrieves the axis unit prefix for a specific column. | |
QString | unitSuffix (Qt::Orientation orientation) const |
Retrieves the axis unit suffix. | |
QString | unitSuffix (int column, Qt::Orientation orientation, bool fallback=false) const |
Retrieves the axis unit suffix for a specific column. | |
void | update () const |
void | useDefaultColors () |
Set the palette to be used, for painting datasets to the default palette. | |
void | useRainbowColors () |
Set the palette to be used, for painting datasets to the rainbow palette. | |
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. | |
void | useSubduedColors () |
Set the palette to be used, for painting datasets to the subdued palette. | |
virtual int | verticalOffset () const |
[reimplemented] | |
virtual QRect | visualRect (const QModelIndex &index) const |
[reimplemented] | |
virtual QRegion | visualRegion (const QModelIndex &index) const |
virtual QRegion | visualRegionForSelection (const QItemSelection &selection) const |
[reimplemented] | |
virtual | ~AbstractDiagram () |
Protected Slots | |
void | setDataBoundariesDirty () const |
Protected Member Functions | |
AbstractDiagram (QWidget *parent=0, AbstractCoordinatePlane *plane=0) | |
AbstractDiagram (Private *p, QWidget *parent, AbstractCoordinatePlane *plane) | |
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) |
double | valueForCell (int row, int column) const |
Helper method, retrieving the data value (DisplayRole) for a given row and column. |
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.
KDChart::AbstractDiagram::AbstractDiagram | ( | Private * | p, | |
QWidget * | parent, | |||
AbstractCoordinatePlane * | plane | |||
) | [explicit, protected] |
AbstractDiagram::AbstractDiagram | ( | QWidget * | parent = 0 , |
|
AbstractCoordinatePlane * | plane = 0 | |||
) | [explicit, protected] |
Definition at line 110 of file KDChartAbstractDiagram.cpp.
AbstractDiagram::~AbstractDiagram | ( | ) | [virtual] |
Definition at line 117 of file KDChartAbstractDiagram.cpp.
References aboutToBeDestroyed().
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 |
Definition at line 490 of file KDChartAbstractDiagram.cpp.
References d.
Referenced by compare().
bool AbstractDiagram::antiAliasing | ( | ) | const |
Definition at line 501 of file KDChartAbstractDiagram.cpp.
References d.
Referenced by compare().
AttributesModel * AbstractDiagram::attributesModel | ( | ) | const [virtual] |
Returns the AttributesModel, that is used by this diagram.
By default each diagram owns its own AttributesModel, which should never be deleted. Only if a user-supplied AttributesModel has been set does the pointer returned here not belong to the diagram.
Definition at line 316 of file KDChartAbstractDiagram.cpp.
References d.
Referenced by brush(), compare(), datasetBrushes(), datasetLabels(), datasetMarkers(), datasetPens(), dataValueAttributes(), isHidden(), itemRowLabels(), pen(), KDChart::AbstractCartesianDiagram::setAttributesModel(), KDChart::BarDiagram::setBarAttributes(), setBrush(), KDChart::AbstractCartesianDiagram::setCoordinatePlane(), KDChart::AbstractCartesianDiagram::setModel(), setPen(), KDChart::AbstractCartesianDiagram::setRootIndex(), and KDChart::TernaryLineDiagram::TernaryLineDiagram().
QModelIndex AbstractDiagram::attributesModelRootIndex | ( | ) | const [protected] |
returns a QModelIndex pointing into the AttributesModel that corresponds to the root index of the diagram.
Definition at line 346 of file KDChartAbstractDiagram.cpp.
References d.
Referenced by datasetBrushes(), datasetLabels(), datasetMarkers(), datasetPens(), itemRowLabels(), KDChart::Plotter::numberOfAbscissaSegments(), KDChart::LineDiagram::numberOfAbscissaSegments(), KDChart::BarDiagram::numberOfAbscissaSegments(), KDChart::Plotter::numberOfOrdinateSegments(), KDChart::LineDiagram::numberOfOrdinateSegments(), KDChart::BarDiagram::numberOfOrdinateSegments(), valueForCell(), and KDChart::LineDiagram::valueForCellTesting().
QBrush AbstractDiagram::brush | ( | const QModelIndex & | index | ) | const |
Retrieve the brush to be used, for painting the datapoint at the given index in the model.
index | The 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.
|
Definition at line 801 of file KDChartAbstractDiagram.cpp.
References attributesModel(), KDChart::AttributesModel::data(), and KDChart::DatasetBrushRole.
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.
dataset | The dataset to retrieve the brush for.
|
Definition at line 793 of file KDChartAbstractDiagram.cpp.
References brush(), d, and KDChart::DatasetBrushRole.
QBrush AbstractDiagram::brush | ( | ) | const |
Retrieve the brush to be used for painting datapoints globally.
This will fall back automatically to the default settings, if there are no specific settings.
Definition at line 787 of file KDChartAbstractDiagram.cpp.
References attributesModel(), KDChart::AttributesModel::data(), and KDChart::DatasetBrushRole.
Referenced by brush(), datasetBrushes(), KDChart::TernaryPointDiagram::paint(), KDChart::TernaryLineDiagram::paint(), KDChart::PolarDiagram::paint(), and paintMarker().
virtual const QPair<QPointF, QPointF> KDChart::AbstractDiagram::calculateDataBoundaries | ( | ) | const [protected, pure virtual] |
Implemented in KDChart::BarDiagram, KDChart::LineDiagram, KDChart::PieDiagram, KDChart::Plotter, KDChart::PolarDiagram, KDChart::RingDiagram, KDChart::StockDiagram, KDChart::LeveyJenningsDiagram, KDChart::AbstractTernaryDiagram, KDChart::TernaryLineDiagram, and KDChart::TernaryPointDiagram.
Referenced by dataBoundaries().
bool AbstractDiagram::checkInvariants | ( | bool | justReturnTheStatus = false |
) | const [protected, virtual] |
Definition at line 1028 of file KDChartAbstractDiagram.cpp.
References coordinatePlane().
Referenced by KDChart::RingDiagram::calculateDataBoundaries(), KDChart::PolarDiagram::calculateDataBoundaries(), KDChart::Plotter::calculateDataBoundaries(), KDChart::PieDiagram::calculateDataBoundaries(), KDChart::LineDiagram::calculateDataBoundaries(), KDChart::BarDiagram::calculateDataBoundaries(), KDChart::RingDiagram::paint(), KDChart::PolarDiagram::paint(), KDChart::Plotter::paint(), KDChart::LineDiagram::paint(), KDChart::LeveyJenningsDiagram::paint(), KDChart::BarDiagram::paint(), paintDataValueTexts(), KDChart::PieDiagram::paintInternal(), paintMarker(), and paintMarkers().
bool AbstractDiagram::compare | ( | const AbstractDiagram * | other | ) | const |
Returns true if both diagrams have the same settings.
Definition at line 129 of file KDChartAbstractDiagram.cpp.
References allowOverlappingDataValueTexts(), antiAliasing(), attributesModel(), KDChart::AttributesModel::compare(), datasetDimension(), and percentMode().
AbstractCoordinatePlane * AbstractDiagram::coordinatePlane | ( | ) | const |
The coordinate plane associated with the diagram.
This determines how coordinates in value space are mapped into pixel space. By default this is a CartesianCoordinatePlane.
Definition at line 220 of file KDChartAbstractDiagram.cpp.
References d.
Referenced by KDChart::LineDiagram::calculateDataBoundaries(), KDChart::BarDiagram::calculateDataBoundaries(), checkInvariants(), KDChart::LeveyJenningsDiagram::iconRect(), KDChart::AbstractCartesianDiagram::layoutPlanes(), KDChart::PolarDiagram::paint(), paintDataValueTexts(), paintMarkers(), KDChart::AbstractPolarDiagram::polarCoordinatePlane(), KDChart::Plotter::resize(), KDChart::LineDiagram::resize(), KDChart::BarDiagram::resize(), and KDChart::AbstractCartesianDiagram::setCoordinatePlane().
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 chached 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 225 of file KDChartAbstractDiagram.cpp.
References calculateDataBoundaries(), and d.
Referenced by KDChart::CartesianCoordinatePlane::getRawDataBoundingRectFromDiagrams(), KDChart::PolarCoordinatePlane::layoutDiagrams(), KDChart::Plotter::paint(), KDChart::LineDiagram::paint(), KDChart::LeveyJenningsDiagram::paint(), and KDChart::BarDiagram::paint().
void AbstractDiagram::dataChanged | ( | const QModelIndex & | topLeft, | |
const QModelIndex & | bottomRight | |||
) | [virtual] |
[reimplemented]
Definition at line 367 of file KDChartAbstractDiagram.cpp.
References setDataBoundariesDirty().
Referenced by KDChart::LeveyJenningsDiagram::setModel(), and 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.
Definition at line 989 of file KDChartAbstractDiagram.cpp.
References attributesModel(), attributesModelRootIndex(), brush(), KDChart::AttributesModel::columnCount(), and datasetDimension().
Referenced by KDChart::Legend::datasetCount(), KDChart::Legend::removeDiagram(), 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 it will expect one column of values in the model. If the dimensionality is 1, automatic values will be used for the abscissa.
For example a diagram with the default dimension of 1, will have one column per datapoint (the y values) and will use automatic values for the x axis (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.
Definition at line 1040 of file KDChartAbstractDiagram.cpp.
References d.
Referenced by compare(), datasetBrushes(), datasetLabels(), datasetMarkers(), datasetPens(), KDChart::LineDiagram::getCellValues(), 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.
Definition at line 976 of file KDChartAbstractDiagram.cpp.
References attributesModel(), attributesModelRootIndex(), KDChart::AttributesModel::columnCount(), datasetDimension(), and KDChart::AttributesModel::headerData().
Referenced by KDChart::Legend::datasetCount().
QList< MarkerAttributes > AbstractDiagram::datasetMarkers | ( | ) | const |
The set of dataset markers currently used, for use in legends, etc.
Definition at line 1015 of file KDChartAbstractDiagram.cpp.
References attributesModel(), attributesModelRootIndex(), KDChart::AttributesModel::columnCount(), datasetDimension(), dataValueAttributes(), and KDChart::DataValueAttributes::markerAttributes().
QList< QPen > AbstractDiagram::datasetPens | ( | ) | const |
The set of dataset pens currently used, for use in legends, etc.
Definition at line 1002 of file KDChartAbstractDiagram.cpp.
References attributesModel(), attributesModelRootIndex(), KDChart::AttributesModel::columnCount(), datasetDimension(), and pen().
Referenced by KDChart::Legend::removeDiagram().
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.
index | The datapoint to retrieve the attributes for. With a dataset dimension of two, this is the index of the key of each key/value pair.
|
Definition at line 470 of file KDChartAbstractDiagram.cpp.
References attributesModel(), KDChart::AttributesModel::data(), and KDChart::DataValueLabelAttributesRole.
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.
dataset | The dataset to retrieve the attributes for.
|
Definition at line 450 of file KDChartAbstractDiagram.cpp.
References d, dataValueAttributes(), and KDChart::DataValueLabelAttributesRole.
DataValueAttributes AbstractDiagram::dataValueAttributes | ( | ) | const |
Retrieve the DataValueAttributes specified globally.
This will fall back automatically to the default settings, if there are no specific settings.
Definition at line 444 of file KDChartAbstractDiagram.cpp.
References attributesModel(), KDChart::DataValueLabelAttributesRole, and KDChart::AttributesModel::modelData().
Referenced by datasetMarkers(), dataValueAttributes(), KDChart::TernaryPointDiagram::paint(), KDChart::TernaryLineDiagram::paint(), paintMarker(), and KDChart::TernaryLineDiagram::TernaryLineDiagram().
void AbstractDiagram::doItemsLayout | ( | ) | [virtual] |
[reimplemented]
Definition at line 358 of file KDChartAbstractDiagram.cpp.
int AbstractDiagram::horizontalOffset | ( | ) | const [virtual] |
[reimplemented]
Definition at line 909 of file KDChartAbstractDiagram.cpp.
QModelIndex AbstractDiagram::indexAt | ( | const QPoint & | point | ) | const [virtual] |
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 1079 of file KDChartAbstractDiagram.cpp.
References d.
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.
index | The datapoint to retrieve the hidden status for.
|
Definition at line 418 of file KDChartAbstractDiagram.cpp.
References attributesModel(), KDChart::AttributesModel::data(), and KDChart::DataHiddenRole.
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.
dataset | The dataset to retrieve the hidden status for.
|
Definition at line 410 of file KDChartAbstractDiagram.cpp.
References d, KDChart::DataHiddenRole, and isHidden().
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.
Definition at line 404 of file KDChartAbstractDiagram.cpp.
References attributesModel(), KDChart::DataHiddenRole, and KDChart::AttributesModel::modelData().
Referenced by isHidden(), and KDChart::LineDiagram::valueForCellTesting().
bool AbstractDiagram::isIndexHidden | ( | const QModelIndex & | index | ) | const [virtual] |
[reimplemented]
Definition at line 915 of file KDChartAbstractDiagram.cpp.
QStringList AbstractDiagram::itemRowLabels | ( | ) | const |
The set of item row labels currently displayed, for use in Abscissa axes, etc.
Definition at line 960 of file KDChartAbstractDiagram.cpp.
References attributesModel(), attributesModelRootIndex(), KDChart::AttributesModel::headerData(), KDChart::AttributesModel::rowCount(), unitPrefix(), and unitSuffix().
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 setDatasetDimensionInternal(), KDChart::LeveyJenningsDiagram::setModel(), setModel(), KDChart::BarDiagram::setOrientation(), KDChart::AbstractPieDiagram::setPieAttributes(), KDChart::BarDiagram::setThreeDBarAttributes(), KDChart::AbstractPieDiagram::setThreeDPieAttributes(), KDChart::Plotter::setType(), KDChart::LineDiagram::setType(), and KDChart::BarDiagram::setType().
void KDChart::AbstractDiagram::modelDataChanged | ( | ) | [signal] |
This signal is emitted, when the model data is changed.
Referenced by setModel().
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 | |||
) | [virtual] |
[reimplemented]
Definition at line 906 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.
paintContext | All information needed for painting. |
Implemented in KDChart::BarDiagram, KDChart::LineDiagram, KDChart::PieDiagram, KDChart::Plotter, KDChart::PolarDiagram, KDChart::RingDiagram, KDChart::StockDiagram, KDChart::LeveyJenningsDiagram, KDChart::TernaryLineDiagram, and KDChart::TernaryPointDiagram.
void AbstractDiagram::paintDataValueText | ( | QPainter * | painter, | |
const QModelIndex & | index, | |||
const QPointF & | pos, | |||
double | value | |||
) |
Definition at line 518 of file KDChartAbstractDiagram.cpp.
References d.
Referenced by paintDataValueTexts().
void AbstractDiagram::paintDataValueTexts | ( | QPainter * | painter | ) | [protected, virtual] |
Definition at line 534 of file KDChartAbstractDiagram.cpp.
References checkInvariants(), coordinatePlane(), d, datasetDimension(), paintDataValueText(), and KDChart::AbstractCoordinatePlane::translate().
void AbstractDiagram::paintMarker | ( | QPainter * | painter, | |
const QModelIndex & | index, | |||
const QPointF & | pos | |||
) |
Definition at line 579 of file KDChartAbstractDiagram.cpp.
References checkInvariants(), dataValueAttributes(), and paintMarker().
void AbstractDiagram::paintMarker | ( | QPainter * | painter, | |
const DataValueAttributes & | a, | |||
const QModelIndex & | index, | |||
const QPointF & | pos | |||
) |
Definition at line 551 of file KDChartAbstractDiagram.cpp.
References brush(), checkInvariants(), d, KDChart::MarkerAttributes::isVisible(), KDChart::DataValueAttributes::isVisible(), KDChart::DataValueAttributes::markerAttributes(), KDChart::MarkerAttributes::markerColor(), KDChart::MarkerAttributes::markerSize(), paintMarker(), and KDChart::MarkerAttributes::pen().
void AbstractDiagram::paintMarker | ( | QPainter * | painter, | |
const MarkerAttributes & | markerAttributes, | |||
const QBrush & | brush, | |||
const QPen & | pen, | |||
const QPointF & | point, | |||
const QSizeF & | size | |||
) | [virtual] |
Definition at line 587 of file KDChartAbstractDiagram.cpp.
References KDChart::MarkerAttributes::Marker1Pixel, KDChart::MarkerAttributes::Marker4Pixels, KDChart::MarkerAttributes::MarkerCircle, KDChart::MarkerAttributes::MarkerCross, KDChart::MarkerAttributes::MarkerDiamond, KDChart::MarkerAttributes::MarkerFastCross, KDChart::MarkerAttributes::MarkerRing, KDChart::MarkerAttributes::MarkerSquare, KDChart::MarkerAttributes::markerStyle(), KDChart::MarkerAttributes::NoMarker, and KDChart::PrintingParameters::scalePen().
Referenced by KDChart::TernaryPointDiagram::paint(), KDChart::TernaryLineDiagram::paint(), KDChart::MarkerLayoutItem::paintIntoRect(), paintMarker(), and paintMarkers().
void AbstractDiagram::paintMarkers | ( | QPainter * | painter | ) | [protected, virtual] |
Definition at line 707 of file KDChartAbstractDiagram.cpp.
References checkInvariants(), coordinatePlane(), datasetDimension(), paintMarker(), and KDChart::AbstractCoordinatePlane::translate().
QPen AbstractDiagram::pen | ( | const QModelIndex & | index | ) | const |
Retrieve the pen to be used, for painting the datapoint at the given index in the model.
index | The 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.
|
Definition at line 758 of file KDChartAbstractDiagram.cpp.
References attributesModel(), KDChart::AttributesModel::data(), and KDChart::DatasetPenRole.
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.
dataset | The dataset to retrieve the pen for.
|
Definition at line 750 of file KDChartAbstractDiagram.cpp.
References d, KDChart::DatasetPenRole, and pen().
QPen AbstractDiagram::pen | ( | ) | const |
Retrieve the pen to be used for painting datapoints globally.
This will fall back automatically to the default settings, if there are no specific settings.
Definition at line 744 of file KDChartAbstractDiagram.cpp.
References attributesModel(), KDChart::AttributesModel::data(), and KDChart::DatasetPenRole.
Referenced by datasetPens(), KDChart::TernaryPointDiagram::paint(), KDChart::TernaryLineDiagram::paint(), KDChart::LeveyJenningsDiagram::paint(), and pen().
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 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 512 of file KDChartAbstractDiagram.cpp.
References d.
Referenced by compare().
void KDChart::AbstractDiagram::propertiesChanged | ( | ) | [signal] |
Emitted upon change of a property of the Diagram.
Referenced by KDChart::Plotter::resetLineAttributes(), KDChart::LineDiagram::resetLineAttributes(), setAllowOverlappingDataValueTexts(), setAntiAliasing(), KDChart::BarDiagram::setBarAttributes(), setBrush(), KDChart::LineDiagram::setCenterDataPoints(), setDataValueAttributes(), KDChart::Plotter::setLineAttributes(), KDChart::LineDiagram::setLineAttributes(), KDChart::BarDiagram::setOrientation(), setPen(), setPercentMode(), KDChart::BarDiagram::setThreeDBarAttributes(), KDChart::Plotter::setThreeDLineAttributes(), KDChart::LineDiagram::setThreeDLineAttributes(), KDChart::Plotter::setType(), KDChart::LineDiagram::setType(), KDChart::BarDiagram::setType(), KDChart::Plotter::setValueTrackerAttributes(), and KDChart::LineDiagram::setValueTrackerAttributes().
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.
area |
Implemented in KDChart::BarDiagram, KDChart::LineDiagram, KDChart::PieDiagram, KDChart::Plotter, KDChart::PolarDiagram, KDChart::RingDiagram, KDChart::StockDiagram, KDChart::TernaryLineDiagram, and KDChart::TernaryPointDiagram.
Referenced by KDChart::CartesianCoordinatePlane::setGeometry().
void AbstractDiagram::scrollTo | ( | const QModelIndex & | index, | |
ScrollHint | hint = EnsureVisible | |||
) | [virtual] |
[reimplemented]
Definition at line 901 of file KDChartAbstractDiagram.cpp.
void AbstractDiagram::setAllowOverlappingDataValueTexts | ( | bool | allow | ) |
Set whether data value labels are allowed to overlap.
allow | True means that overlapping labels are allowed. |
Definition at line 484 of file KDChartAbstractDiagram.cpp.
References d, and propertiesChanged().
void AbstractDiagram::setAntiAliasing | ( | bool | enabled | ) |
Set whether anti-aliasing is to be used while rendering this diagram.
enabled | True means that AA is enabled. |
Definition at line 495 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() );
model | The AttributesModel to use for this diagram.
|
Reimplemented in KDChart::AbstractCartesianDiagram.
Definition at line 291 of file KDChartAbstractDiagram.cpp.
References d, modelsChanged(), and setDataBoundariesDirty().
void AbstractDiagram::setAttributesModelRootIndex | ( | const QModelIndex & | idx | ) | [protected] |
Definition at line 337 of file KDChartAbstractDiagram.cpp.
References d, and setDataBoundariesDirty().
Referenced by setRootIndex().
void AbstractDiagram::setBrush | ( | const QBrush & | brush | ) |
Set the brush to be used, for painting all datasets in the model.
brush | The brush to use. |
Definition at line 774 of file KDChartAbstractDiagram.cpp.
References attributesModel(), KDChart::DatasetBrushRole, propertiesChanged(), and KDChart::AttributesModel::setModelData().
void AbstractDiagram::setBrush | ( | int | dataset, | |
const QBrush & | brush | |||
) |
Set the brush to be used, for painting the given dataset.
dataset | The dataset to set the brush for.
|
Definition at line 781 of file KDChartAbstractDiagram.cpp.
References d, KDChart::DatasetBrushRole, and propertiesChanged().
void AbstractDiagram::setBrush | ( | const QModelIndex & | index, | |
const QBrush & | brush | |||
) |
Set the brush to be used, for painting the datapoint at the given index.
index | The datapoint's index in the model. With a dataset dimension of two, this is the index of the key of each key/value pair.
|
Definition at line 766 of file KDChartAbstractDiagram.cpp.
References attributesModel(), KDChart::DatasetBrushRole, propertiesChanged(), and KDChart::AttributesModel::setData().
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.
Reimplemented in KDChart::AbstractCartesianDiagram.
Definition at line 353 of file KDChartAbstractDiagram.cpp.
References d.
Referenced by KDChart::AbstractCoordinatePlane::addDiagram(), and KDChart::AbstractCoordinatePlane::takeDiagram().
void AbstractDiagram::setDataBoundariesDirty | ( | ) | const [protected, slot] |
Definition at line 234 of file KDChartAbstractDiagram.cpp.
References d.
Referenced by dataChanged(), KDChart::Plotter::resize(), KDChart::LineDiagram::resize(), KDChart::BarDiagram::resize(), setAttributesModel(), setAttributesModelRootIndex(), setDatasetDimensionInternal(), setModel(), KDChart::BarDiagram::setOrientation(), KDChart::BarDiagram::setThreeDBarAttributes(), KDChart::Plotter::setThreeDLineAttributes(), KDChart::LineDiagram::setThreeDLineAttributes(), KDChart::Plotter::setType(), KDChart::LineDiagram::setType(), and KDChart::BarDiagram::setType().
void AbstractDiagram::setDatasetDimension | ( | int | dimension | ) |
Definition at line 1045 of file KDChartAbstractDiagram.cpp.
void AbstractDiagram::setDatasetDimensionInternal | ( | int | dimension | ) | [protected] |
Definition at line 1051 of file KDChartAbstractDiagram.cpp.
References d, layoutChanged(), and setDataBoundariesDirty().
Referenced by KDChart::TernaryLineDiagram::TernaryLineDiagram(), and KDChart::TernaryPointDiagram::TernaryPointDiagram().
void AbstractDiagram::setDataValueAttributes | ( | const DataValueAttributes & | a | ) |
Set the DataValueAttributes for all datapoints in the model.
a | The attributes to set. |
Definition at line 478 of file KDChartAbstractDiagram.cpp.
References d, KDChart::DataValueLabelAttributesRole, and propertiesChanged().
void AbstractDiagram::setDataValueAttributes | ( | int | dataset, | |
const DataValueAttributes & | a | |||
) |
Set the DataValueAttributes for the given dataset.
dataset | The dataset to set the attributes for.
|
Definition at line 438 of file KDChartAbstractDiagram.cpp.
References d, KDChart::DataValueLabelAttributesRole, and propertiesChanged().
void AbstractDiagram::setDataValueAttributes | ( | const QModelIndex & | index, | |
const DataValueAttributes & | a | |||
) |
Set the DataValueAttributes for the given index.
index | The datapoint to set the attributes for. With a dataset dimension of two, this is the index of the key of each key/value pair.
|
Definition at line 427 of file KDChartAbstractDiagram.cpp.
References d, KDChart::DataValueLabelAttributesRole, and propertiesChanged().
void AbstractDiagram::setHidden | ( | bool | hidden | ) |
Hide (or unhide, resp.
) all datapoints in the model.
hidden | The hidden status to set. |
Definition at line 396 of file KDChartAbstractDiagram.cpp.
References d, dataHidden(), and KDChart::DataHiddenRole.
void AbstractDiagram::setHidden | ( | int | dataset, | |
bool | hidden | |||
) |
Hide (or unhide, resp.
) a dataset.
dataset | The dataset to set the hidden status for.
|
Definition at line 387 of file KDChartAbstractDiagram.cpp.
References d, dataHidden(), and KDChart::DataHiddenRole.
void AbstractDiagram::setHidden | ( | const QModelIndex & | index, | |
bool | hidden | |||
) |
Hide (or unhide, resp.
) a data cell.
index | The 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.
|
Definition at line 378 of file KDChartAbstractDiagram.cpp.
References d, dataHidden(), and KDChart::DataHiddenRole.
void AbstractDiagram::setModel | ( | QAbstractItemModel * | model | ) | [virtual] |
Associate a model with the diagram.
Reimplemented in KDChart::AbstractCartesianDiagram, and KDChart::LeveyJenningsDiagram.
Definition at line 239 of file KDChartAbstractDiagram.cpp.
References d, dataChanged(), KDChart::AttributesModel::initFrom(), layoutChanged(), modelDataChanged(), modelsChanged(), and setDataBoundariesDirty().
Referenced by KDChart::Widget::setType().
void AbstractDiagram::setPen | ( | const QPen & | pen | ) |
Set the pen to be used, for painting all datasets in the model.
pen | The pen to use. |
Definition at line 731 of file KDChartAbstractDiagram.cpp.
References attributesModel(), KDChart::DatasetPenRole, propertiesChanged(), and KDChart::AttributesModel::setModelData().
void AbstractDiagram::setPen | ( | int | dataset, | |
const QPen & | pen | |||
) |
Set the pen to be used, for painting the given dataset.
dataset | The dataset to set the pen for.
|
Definition at line 738 of file KDChartAbstractDiagram.cpp.
References d, KDChart::DatasetPenRole, and propertiesChanged().
void AbstractDiagram::setPen | ( | const QModelIndex & | index, | |
const QPen & | pen | |||
) |
Set the pen to be used, for painting the datapoint at the given index.
index | The datapoint's index in the model. With a dataset dimension of two, this is the index of the key of each key/value pair.
|
Definition at line 723 of file KDChartAbstractDiagram.cpp.
References attributesModel(), KDChart::DatasetPenRole, propertiesChanged(), and KDChart::AttributesModel::setData().
void AbstractDiagram::setPercentMode | ( | bool | percent | ) |
Deprecated method that turns the percent mode of this diagram on or off.
This method is deprecated. Use the setType() method of a supporting diagram implementation instead, e.g. BarDiagram::setType().Definition at line 506 of file KDChartAbstractDiagram.cpp.
References d, and propertiesChanged().
Referenced by KDChart::BarDiagram::setOrientation(), KDChart::LineDiagram::setType(), and KDChart::BarDiagram::setType().
void AbstractDiagram::setRootIndex | ( | const QModelIndex & | idx | ) | [virtual] |
Set the root index in the model, where the diagram starts referencing data for display.
[reimplemented]
Reimplemented in KDChart::AbstractCartesianDiagram.
Definition at line 330 of file KDChartAbstractDiagram.cpp.
References d, and setAttributesModelRootIndex().
void AbstractDiagram::setSelection | ( | const QRect & | rect, | |
QItemSelectionModel::SelectionFlags | command | |||
) | [virtual] |
void AbstractDiagram::setSelectionModel | ( | QItemSelectionModel * | selectionModel | ) | [virtual] |
Associate a seleection model with the diagrom.
Definition at line 270 of file KDChartAbstractDiagram.cpp.
References modelsChanged().
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.
prefix | The prefix to be used.
|
Definition at line 823 of file KDChartAbstractDiagram.cpp.
References d.
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.
prefix | The prefix to be used.
|
Definition at line 813 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.
suffix | The suffix to be used.
|
Definition at line 844 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.
suffix | The suffix to be used.
|
Definition at line 834 of file KDChartAbstractDiagram.cpp.
References d.
QString AbstractDiagram::unitPrefix | ( | Qt::Orientation | orientation | ) | const |
Retrieves the axis unit prefix.
Returns the global unit prefix.
orientation | The orientation of the axis.
|
Definition at line 867 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.
column | The column whose prefix should be retrieved.
|
Definition at line 856 of file KDChartAbstractDiagram.cpp.
References d.
Referenced by itemRowLabels(), and KDChart::CartesianAxis::paintCtx().
QString AbstractDiagram::unitSuffix | ( | Qt::Orientation | orientation | ) | const |
Retrieves the axis unit suffix.
Returns the global unit suffix.
orientation | The orientation of the axis.
|
Definition at line 890 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.
column | The column whose prefix should be retrieved.
|
Definition at line 879 of file KDChartAbstractDiagram.cpp.
References d.
Referenced by itemRowLabels(), and KDChart::CartesianAxis::paintCtx().
void AbstractDiagram::update | ( | ) | const |
Definition at line 1067 of file KDChartAbstractDiagram.cpp.
References d.
Referenced by doItemsLayout(), KDChart::LeveyJenningsDiagram::setExpectedMeanValue(), KDChart::LeveyJenningsDiagram::setExpectedStandardDeviation(), KDChart::LeveyJenningsDiagram::setFluidicsPackChangedSymbolPosition(), KDChart::LeveyJenningsDiagram::setFluidicsPackChanges(), KDChart::LeveyJenningsDiagram::setLotChangedSymbolPosition(), KDChart::LeveyJenningsDiagram::setScanLinePen(), KDChart::LeveyJenningsDiagram::setSensorChangedSymbolPosition(), KDChart::LeveyJenningsDiagram::setSensorChanges(), KDChart::LeveyJenningsDiagram::setSymbol(), and KDChart::LeveyJenningsDiagram::setTimeRange().
void KDChart::AbstractDiagram::useDefaultColors | ( | ) |
Set the palette to be used, for painting datasets to the default palette.
Definition at line 945 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.
Definition at line 955 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.
Definition at line 310 of file KDChartAbstractDiagram.cpp.
References d.
void KDChart::AbstractDiagram::useSubduedColors | ( | ) |
Set the palette to be used, for painting datasets to the subdued palette.
Definition at line 950 of file KDChartAbstractDiagram.cpp.
References d, and KDChart::AttributesModel::PaletteTypeSubdued.
double AbstractDiagram::valueForCell | ( | int | row, | |
int | column | |||
) | const [protected] |
Helper method, retrieving the data value (DisplayRole) for a given row and column.
row | The row to query.
|
Definition at line 1061 of file KDChartAbstractDiagram.cpp.
References attributesModelRootIndex(), and d.
int AbstractDiagram::verticalOffset | ( | ) | const [virtual] |
[reimplemented]
Definition at line 912 of file KDChartAbstractDiagram.cpp.
QRect AbstractDiagram::visualRect | ( | const QModelIndex & | index | ) | const [virtual] |
QRegion AbstractDiagram::visualRegion | ( | const QModelIndex & | index | ) | const [virtual] |
Definition at line 939 of file KDChartAbstractDiagram.cpp.
References d.
QRegion AbstractDiagram::visualRegionForSelection | ( | const QItemSelection & | selection | ) | const [virtual] |