Signals | Public Member Functions | Protected Slots | Protected Member Functions

KDChart::AbstractTernaryDiagram Class Reference

Base class for diagrams based on a ternary coordinate plane. More...

#include <KDChartAbstractTernaryDiagram.h>

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

List of all members.

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.
void viewportCoordinateSystemChanged ()
 Emitted upon change of the view coordinate system.

Public Member Functions

bool allowOverlappingDataValueTexts () const
bool antiAliasing () const
virtual AttributesModelattributesModel () const
 Returns the AttributesModel, that is used by this diagram.
QBrush brush () const
 Retrieve the brush to be used for painting datapoints globally.
QBrush brush (int dataset) const
 Retrieve the brush to be used for the given dataset.
QBrush brush (const QModelIndex &index) const
 Retrieve the brush to be used, for painting the datapoint at the given index in the model.
bool compare (const AbstractDiagram *other) const
 Returns true if both diagrams have the same settings.
AbstractCoordinatePlanecoordinatePlane () 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< MarkerAttributesdatasetMarkers () 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
 Retrieve the DataValueAttributes specified globally.
DataValueAttributes dataValueAttributes (int dataset) const
 Retrieve the DataValueAttributes for the given dataset.
DataValueAttributes dataValueAttributes (const QModelIndex &index) const
 Retrieve the DataValueAttributes for the given index.
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
 Retrieve the hidden status specified globally.
bool isHidden (int dataset) const
 Retrieve the hidden status for the given dataset.
bool isHidden (const QModelIndex &index) const
 Retrieve the hidden status for the given index.
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]
void paintDataValueText (QPainter *painter, const QModelIndex &index, const QPointF &pos, double 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.
QPen pen (int dataset) const
 Retrieve the pen to be used for the given dataset.
QPen pen (const QModelIndex &index) const
 Retrieve the pen to be used, for painting the datapoint at the given index in the model.
bool percentMode () const
 Returns whether this diagram is drawn in percent mode.
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 (const QModelIndex &index, const QBrush &brush)
 Set the brush to be used, for painting the datapoint at the given index.
void setBrush (int dataset, const QBrush &brush)
 Set the brush to be used, for painting the given dataset.
virtual void setCoordinatePlane (AbstractCoordinatePlane *plane)
 Set the coordinate plane associated with the diagram.
void setDatasetDimension (int dimension)
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 setDataValueAttributes (const DataValueAttributes &a)
 Set the DataValueAttributes for all datapoints in the model.
void setHidden (const QModelIndex &index, bool hidden)
 Hide (or unhide, resp.) a data cell.
void setHidden (int dataset, bool hidden)
 Hide (or unhide, resp.) a dataset.
void setHidden (bool hidden)
 Hide (or unhide, resp.) all datapoints in the model.
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, int column, Qt::Orientation orientation)
 Set the unit prefix to be used on axes for one specific column.
void setUnitPrefix (const QString &prefix, 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.
void setUnitSuffix (const QString &suffix, Qt::Orientation orientation)
 Set the unit prefix to be used on axes for all columns.
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 (int column, Qt::Orientation orientation, bool fallback=false) const
 Retrieves the axis unit suffix for a specific column.
QString unitSuffix (Qt::Orientation orientation) const
 Retrieves the axis unit suffix.
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]

Protected Slots

void setDataBoundariesDirty () const

Protected Member Functions

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.

Detailed Description

Base class for diagrams based on a ternary coordinate plane.

Definition at line 37 of file KDChartAbstractTernaryDiagram.h.


Member Function Documentation

void KDChart::AbstractDiagram::aboutToBeDestroyed (  ) [signal, inherited]

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

the attributes model, is invalidated.

Referenced by KDChart::AbstractDiagram::~AbstractDiagram().

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

Definition at line 491 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by KDChart::AbstractDiagram::compare().

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

Definition at line 502 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by KDChart::AbstractDiagram::compare().

AttributesModel * AbstractDiagram::attributesModel (  ) const [virtual, inherited]
QModelIndex AbstractDiagram::attributesModelRootIndex (  ) const [protected, inherited]
QBrush AbstractDiagram::brush (  ) const [inherited]

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.

Returns:
The brush to use for painting.

Definition at line 788 of file KDChartAbstractDiagram.cpp.

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

Referenced by KDChart::AbstractDiagram::brush(), KDChart::AbstractDiagram::datasetBrushes(), KDChart::TernaryPointDiagram::paint(), KDChart::TernaryLineDiagram::paint(), KDChart::PolarDiagram::paint(), and KDChart::AbstractDiagram::paintMarker().

QBrush AbstractDiagram::brush ( int  dataset ) const [inherited]

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 794 of file KDChartAbstractDiagram.cpp.

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

QBrush AbstractDiagram::brush ( const QModelIndex &  index ) const [inherited]

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 802 of file KDChartAbstractDiagram.cpp.

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

virtual const QPair< QPointF, QPointF > KDChart::AbstractTernaryDiagram::calculateDataBoundaries (  ) const [protected, pure virtual]
bool AbstractDiagram::checkInvariants ( bool  justReturnTheStatus = false ) const [protected, virtual, inherited]
bool AbstractDiagram::compare ( const AbstractDiagram other ) const [inherited]
AbstractCoordinatePlane * AbstractDiagram::coordinatePlane (  ) const [inherited]
const QPair< QPointF, QPointF > AbstractDiagram::dataBoundaries (  ) const [inherited]

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 KDChart::AbstractDiagram::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, inherited]
void KDChart::AbstractDiagram::dataHidden (  ) [signal, inherited]

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

Referenced by KDChart::AbstractDiagram::setHidden().

QList< QBrush > AbstractDiagram::datasetBrushes (  ) const [inherited]

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 990 of file KDChartAbstractDiagram.cpp.

References KDChart::AbstractDiagram::attributesModel(), KDChart::AbstractDiagram::attributesModelRootIndex(), KDChart::AbstractDiagram::brush(), KDChart::AttributesModel::columnCount(), and KDChart::AbstractDiagram::datasetDimension().

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

int AbstractDiagram::datasetDimension (  ) const [inherited]

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.

Returns:
The dataset dimension of the diagram.

Definition at line 1041 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by KDChart::AbstractDiagram::compare(), KDChart::AbstractDiagram::datasetBrushes(), KDChart::AbstractDiagram::datasetLabels(), KDChart::AbstractDiagram::datasetMarkers(), KDChart::AbstractDiagram::datasetPens(), KDChart::LineDiagram::getCellValues(), KDChart::CartesianCoordinatePlane::getDataDimensionsList(), KDChart::TernaryPointDiagram::paint(), KDChart::TernaryLineDiagram::paint(), KDChart::AbstractDiagram::paintDataValueTexts(), KDChart::AbstractDiagram::paintMarkers(), KDChart::Plotter::setType(), and KDChart::LineDiagram::setType().

QStringList AbstractDiagram::datasetLabels (  ) const [inherited]

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

Returns:
The set of dataset labels currently displayed.

Definition at line 977 of file KDChartAbstractDiagram.cpp.

References KDChart::AbstractDiagram::attributesModel(), KDChart::AbstractDiagram::attributesModelRootIndex(), KDChart::AttributesModel::columnCount(), KDChart::AbstractDiagram::datasetDimension(), and KDChart::AttributesModel::headerData().

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

QList< MarkerAttributes > AbstractDiagram::datasetMarkers (  ) const [inherited]

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 1016 of file KDChartAbstractDiagram.cpp.

References KDChart::AbstractDiagram::attributesModel(), KDChart::AbstractDiagram::attributesModelRootIndex(), KDChart::AttributesModel::columnCount(), KDChart::AbstractDiagram::datasetDimension(), KDChart::AbstractDiagram::dataValueAttributes(), and KDChart::DataValueAttributes::markerAttributes().

QList< QPen > AbstractDiagram::datasetPens (  ) const [inherited]

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 1003 of file KDChartAbstractDiagram.cpp.

References KDChart::AbstractDiagram::attributesModel(), KDChart::AbstractDiagram::attributesModelRootIndex(), KDChart::AttributesModel::columnCount(), KDChart::AbstractDiagram::datasetDimension(), and KDChart::AbstractDiagram::pen().

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

DataValueAttributes AbstractDiagram::dataValueAttributes (  ) const [inherited]
DataValueAttributes AbstractDiagram::dataValueAttributes ( int  dataset ) const [inherited]

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 451 of file KDChartAbstractDiagram.cpp.

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

DataValueAttributes AbstractDiagram::dataValueAttributes ( const QModelIndex &  index ) const [inherited]

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 471 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::doItemsLayout (  ) [virtual, inherited]

[reimplemented]

Definition at line 359 of file KDChartAbstractDiagram.cpp.

References d, and KDChart::AbstractDiagram::update().

int AbstractDiagram::horizontalOffset (  ) const [virtual, inherited]

[reimplemented]

Definition at line 910 of file KDChartAbstractDiagram.cpp.

QModelIndex AbstractDiagram::indexAt ( const QPoint &  point ) const [virtual, inherited]

[reimplemented]

Definition at line 1075 of file KDChartAbstractDiagram.cpp.

References d.

QModelIndexList AbstractDiagram::indexesAt ( const QPoint &  point ) const [inherited]

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

Definition at line 1080 of file KDChartAbstractDiagram.cpp.

References d.

bool AbstractDiagram::isHidden (  ) const [inherited]

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 405 of file KDChartAbstractDiagram.cpp.

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

Referenced by KDChart::AbstractDiagram::isHidden(), and KDChart::LineDiagram::valueForCellTesting().

bool AbstractDiagram::isHidden ( int  dataset ) const [inherited]

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 411 of file KDChartAbstractDiagram.cpp.

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

bool AbstractDiagram::isHidden ( const QModelIndex &  index ) const [inherited]

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 419 of file KDChartAbstractDiagram.cpp.

References KDChart::AbstractDiagram::attributesModel(), KDChart::AttributesModel::data(), and KDChart::DataHiddenRole.

bool AbstractDiagram::isIndexHidden ( const QModelIndex &  index ) const [virtual, inherited]

[reimplemented]

Definition at line 916 of file KDChartAbstractDiagram.cpp.

QStringList AbstractDiagram::itemRowLabels (  ) const [inherited]

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 961 of file KDChartAbstractDiagram.cpp.

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

void KDChart::AbstractDiagram::layoutChanged ( AbstractDiagram  ) [signal, inherited]

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::AbstractDiagram::setDatasetDimensionInternal(), KDChart::LeveyJenningsDiagram::setModel(), KDChart::AbstractDiagram::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, inherited]

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

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

void KDChart::AbstractDiagram::modelsChanged (  ) [signal, inherited]
QModelIndex AbstractDiagram::moveCursor ( CursorAction  cursorAction,
Qt::KeyboardModifiers  modifiers 
) [virtual, inherited]

[reimplemented]

Definition at line 907 of file KDChartAbstractDiagram.cpp.

void AbstractDiagram::paintDataValueText ( QPainter *  painter,
const QModelIndex &  index,
const QPointF &  pos,
double  value 
) [inherited]

Definition at line 519 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by KDChart::AbstractDiagram::paintDataValueTexts().

void AbstractDiagram::paintDataValueTexts ( QPainter *  painter ) [protected, virtual, inherited]
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 535 of file KDChartAbstractDiagram.cpp.

References KDChart::AbstractDiagram::checkInvariants(), KDChart::AbstractDiagram::coordinatePlane(), d, KDChart::AbstractDiagram::datasetDimension(), KDChart::AbstractDiagram::paintDataValueText(), and KDChart::AbstractCoordinatePlane::translate().

void AbstractDiagram::paintMarker ( QPainter *  painter,
const MarkerAttributes markerAttributes,
const QBrush &  brush,
const QPen &  pen,
const QPointF &  point,
const QSizeF &  size 
) [virtual, inherited]
void AbstractDiagram::paintMarker ( QPainter *  painter,
const DataValueAttributes a,
const QModelIndex &  index,
const QPointF &  pos 
) [inherited]
void AbstractDiagram::paintMarker ( QPainter *  painter,
const QModelIndex &  index,
const QPointF &  pos 
) [inherited]
void AbstractDiagram::paintMarkers ( QPainter *  painter ) [protected, virtual, inherited]
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 708 of file KDChartAbstractDiagram.cpp.

References KDChart::AbstractDiagram::checkInvariants(), KDChart::AbstractDiagram::coordinatePlane(), KDChart::AbstractDiagram::datasetDimension(), KDChart::AbstractDiagram::paintMarker(), and KDChart::AbstractCoordinatePlane::translate().

QPen AbstractDiagram::pen (  ) const [inherited]

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.

Returns:
The pen to use for painting.

Definition at line 745 of file KDChartAbstractDiagram.cpp.

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

Referenced by KDChart::AbstractDiagram::datasetPens(), KDChart::TernaryPointDiagram::paint(), KDChart::TernaryLineDiagram::paint(), KDChart::LeveyJenningsDiagram::paint(), KDChart::AbstractDiagram::pen(), and KDChart::LeveyJenningsDiagram::setScanLinePen().

QPen AbstractDiagram::pen ( int  dataset ) const [inherited]

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 751 of file KDChartAbstractDiagram.cpp.

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

QPen AbstractDiagram::pen ( const QModelIndex &  index ) const [inherited]

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 759 of file KDChartAbstractDiagram.cpp.

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

bool AbstractDiagram::percentMode (  ) const [inherited]

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 513 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by KDChart::AbstractDiagram::compare().

void KDChart::AbstractDiagram::propertiesChanged (  ) [signal, inherited]
void AbstractDiagram::scrollTo ( const QModelIndex &  index,
ScrollHint  hint = EnsureVisible 
) [virtual, inherited]

[reimplemented]

Definition at line 902 of file KDChartAbstractDiagram.cpp.

void AbstractDiagram::setAllowOverlappingDataValueTexts ( bool  allow ) [inherited]

Set whether data value labels are allowed to overlap.

Parameters:
allowTrue means that overlapping labels are allowed.

Definition at line 485 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setAntiAliasing ( bool  enabled ) [inherited]

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

Parameters:
enabledTrue means that AA is enabled.

Definition at line 496 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setAttributesModel ( AttributesModel amodel ) [virtual, inherited]

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.

Reimplemented in KDChart::AbstractCartesianDiagram.

Definition at line 292 of file KDChartAbstractDiagram.cpp.

References d, KDChart::AbstractDiagram::modelsChanged(), and KDChart::AbstractDiagram::setDataBoundariesDirty().

void AbstractDiagram::setAttributesModelRootIndex ( const QModelIndex &  idx ) [protected, inherited]
void AbstractDiagram::setBrush ( const QModelIndex &  index,
const QBrush &  brush 
) [inherited]

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 767 of file KDChartAbstractDiagram.cpp.

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

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

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 782 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setBrush ( const QBrush &  brush ) [inherited]

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

Parameters:
brushThe brush to use.

Definition at line 775 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setCoordinatePlane ( AbstractCoordinatePlane plane ) [virtual, inherited]

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 354 of file KDChartAbstractDiagram.cpp.

References d.

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

void AbstractDiagram::setDataBoundariesDirty (  ) const [protected, slot, inherited]
void AbstractDiagram::setDatasetDimension ( int  dimension ) [inherited]
Deprecated:

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

Definition at line 1046 of file KDChartAbstractDiagram.cpp.

void AbstractDiagram::setDatasetDimensionInternal ( int  dimension ) [protected, inherited]
void AbstractDiagram::setDataValueAttributes ( const DataValueAttributes a ) [inherited]

Set the DataValueAttributes for all datapoints in the model.

Parameters:
aThe attributes to set.

Definition at line 479 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setDataValueAttributes ( const QModelIndex &  index,
const DataValueAttributes a 
) [inherited]

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 428 of file KDChartAbstractDiagram.cpp.

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

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

Set the DataValueAttributes for the given dataset.

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

Definition at line 439 of file KDChartAbstractDiagram.cpp.

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

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

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 379 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setHidden ( int  dataset,
bool  hidden 
) [inherited]

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 388 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setHidden ( bool  hidden ) [inherited]

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 397 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setModel ( QAbstractItemModel *  model ) [virtual, inherited]
void AbstractDiagram::setPen ( const QModelIndex &  index,
const QPen &  pen 
) [inherited]

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 724 of file KDChartAbstractDiagram.cpp.

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

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

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 739 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setPen ( const QPen &  pen ) [inherited]

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

Parameters:
penThe pen to use.

Definition at line 732 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setPercentMode ( bool  percent ) [inherited]

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 507 of file KDChartAbstractDiagram.cpp.

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

Referenced by KDChart::BarDiagram::setOrientation(), KDChart::LineDiagram::setType(), and KDChart::BarDiagram::setType().

void AbstractDiagram::setRootIndex ( const QModelIndex &  idx ) [virtual, inherited]

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

[reimplemented]

Reimplemented in KDChart::AbstractCartesianDiagram.

Definition at line 331 of file KDChartAbstractDiagram.cpp.

References d, and KDChart::AbstractDiagram::setAttributesModelRootIndex().

void AbstractDiagram::setSelection ( const QRect &  rect,
QItemSelectionModel::SelectionFlags  command 
) [virtual, inherited]

[reimplemented]

Definition at line 919 of file KDChartAbstractDiagram.cpp.

References d.

void AbstractDiagram::setSelectionModel ( QItemSelectionModel *  selectionModel ) [virtual, inherited]

Associate a seleection model with the diagrom.

Definition at line 271 of file KDChartAbstractDiagram.cpp.

References KDChart::AbstractDiagram::modelsChanged().

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

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 824 of file KDChartAbstractDiagram.cpp.

References d.

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

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 814 of file KDChartAbstractDiagram.cpp.

References d.

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

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 835 of file KDChartAbstractDiagram.cpp.

References d.

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

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 845 of file KDChartAbstractDiagram.cpp.

References d.

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

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 857 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by KDChart::AbstractDiagram::itemRowLabels(), and KDChart::CartesianAxis::paintCtx().

QString AbstractDiagram::unitPrefix ( Qt::Orientation  orientation ) const [inherited]

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 868 of file KDChartAbstractDiagram.cpp.

References d.

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

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 880 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by KDChart::AbstractDiagram::itemRowLabels(), and KDChart::CartesianAxis::paintCtx().

QString AbstractDiagram::unitSuffix ( Qt::Orientation  orientation ) const [inherited]

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 891 of file KDChartAbstractDiagram.cpp.

References d.

void AbstractDiagram::update (  ) const [inherited]
void KDChart::AbstractDiagram::useDefaultColors (  ) [inherited]

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 946 of file KDChartAbstractDiagram.cpp.

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

void KDChart::AbstractDiagram::useRainbowColors (  ) [inherited]

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

See also:
KDChart::Palette.

Definition at line 956 of file KDChartAbstractDiagram.cpp.

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

bool AbstractDiagram::usesExternalAttributesModel (  ) const [virtual, inherited]

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 311 of file KDChartAbstractDiagram.cpp.

References d.

void KDChart::AbstractDiagram::useSubduedColors (  ) [inherited]

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

See also:
KDChart::Palette.

Definition at line 951 of file KDChartAbstractDiagram.cpp.

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

double AbstractDiagram::valueForCell ( int  row,
int  column 
) const [protected, inherited]

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 double.
Deprecated:

Definition at line 1062 of file KDChartAbstractDiagram.cpp.

References KDChart::AbstractDiagram::attributesModelRootIndex(), and d.

int AbstractDiagram::verticalOffset (  ) const [virtual, inherited]

[reimplemented]

Definition at line 913 of file KDChartAbstractDiagram.cpp.

void KDChart::AbstractDiagram::viewportCoordinateSystemChanged (  ) [signal, inherited]

Emitted upon change of the view coordinate system.

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

QRect AbstractDiagram::visualRect ( const QModelIndex &  index ) const [virtual, inherited]

[reimplemented]

Definition at line 897 of file KDChartAbstractDiagram.cpp.

References d.

QRegion AbstractDiagram::visualRegion ( const QModelIndex &  index ) const [virtual, inherited]

Definition at line 940 of file KDChartAbstractDiagram.cpp.

References d.

QRegion AbstractDiagram::visualRegionForSelection ( const QItemSelection &  selection ) const [virtual, inherited]

[reimplemented]

Definition at line 930 of file KDChartAbstractDiagram.cpp.

References d.


The documentation for this class was generated from the following files:
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Defines

Klarälvdalens Datakonsult AB (KDAB)
Qt-related services and products
http://www.kdab.com/
http://www.kdab.com/products/kd-chart/