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

#include <KDChartAbstractDiagram.h>

Inheritance diagram for KDChart::AbstractDiagram:

[legend]

Collaboration diagram for KDChart::AbstractDiagram:

Signals
void	aboutToBeDestroyed ()
	This signal is emitted when this diagram is being destroyed, but before all the data, i.e. More...

void	attributesModelAboutToChange (AttributesModel newModel, AttributesModel oldModel)
	This signal is emitted just before the new attributes model is connected internally. More...

void	boundariesChanged ()
	Emitted upon change of a data boundary. More...

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

void	layoutChanged (AbstractDiagram *)
	Diagrams are supposed to emit this signal, when the layout of one of their element changes. More...

void	modelDataChanged ()
	This signal is emitted, when the model data is changed. More...

void	modelsChanged ()
	This signal is emitted when either the model or the AttributesModel is replaced. More...

void	propertiesChanged ()
	Emitted upon change of a property of the Diagram. More...

void	viewportCoordinateSystemChanged ()
	Emitted upon change of the view coordinate system. More...

Public Member Functions
bool	allowOverlappingDataValueTexts () const

bool	antiAliasing () const

virtual AttributesModel *	attributesModel () const
	Returns the AttributesModel, that is used by this diagram. More...

QBrush	brush () const
	Retrieve the brush to be used for painting datapoints globally. More...

QBrush	brush (int dataset) const
	Retrieve the brush to be used for the given dataset. More...

QBrush	brush (const QModelIndex &index) const
	Retrieve the brush to be used, for painting the datapoint at the given index in the model. More...

bool	compare (const AbstractDiagram *other) const
	Returns true if both diagrams have the same settings. More...

AbstractCoordinatePlane *	coordinatePlane () const
	The coordinate plane associated with the diagram. More...

const QPair< QPointF, QPointF >	dataBoundaries () const
	Return the bottom left and top right data point, that the diagram will display (unless the grid adjusts these values). More...

virtual void	dataChanged (const QModelIndex &topLeft, const QModelIndex &bottomRight)
	[reimplemented] More...

QList< QBrush >	datasetBrushes () const
	The set of dataset brushes currently used, for use in legends, etc. More...

int	datasetDimension () const
	The dataset dimension of a diagram determines how many value dimensions it expects each datapoint to have. More...

QStringList	datasetLabels () const
	The set of dataset labels currently displayed, for use in legends, etc. More...

QList< MarkerAttributes >	datasetMarkers () const
	The set of dataset markers currently used, for use in legends, etc. More...

QList< QPen >	datasetPens () const
	The set of dataset pens currently used, for use in legends, etc. More...

DataValueAttributes	dataValueAttributes () const
	Retrieve the DataValueAttributes specified globally. More...

DataValueAttributes	dataValueAttributes (int dataset) const
	Retrieve the DataValueAttributes for the given dataset. More...

DataValueAttributes	dataValueAttributes (const QModelIndex &index) const
	Retrieve the DataValueAttributes for the given index. More...

void	doItemsLayout () override
	[reimplemented] More...

int	horizontalOffset () const override
	[reimplemented] More...

QModelIndex	indexAt (const QPoint &point) const override
	[reimplemented] More...

QModelIndexList	indexesAt (const QPoint &point) const
	This method is added alongside with indexAt from QAIM, since in kdchart multiple indexes can be displayed at the same spot. More...

QModelIndexList	indexesIn (const QRect &rect) const

bool	isHidden () const
	Retrieve the hidden status specified globally. More...

bool	isHidden (int dataset) const
	Retrieve the hidden status for the given dataset. More...

bool	isHidden (const QModelIndex &index) const
	Retrieve the hidden status for the given index. More...

bool	isIndexHidden (const QModelIndex &index) const override
	[reimplemented] More...

QStringList	itemRowLabels () const
	The set of item row labels currently displayed, for use in Abscissa axes, etc. More...

QModelIndex	moveCursor (CursorAction cursorAction, Qt::KeyboardModifiers modifiers) override
	[reimplemented] More...

virtual void	paint (PaintContext *paintContext)=0
	Draw the diagram contents to the rectangle and painter, that are passed in as part of the paint context. More...

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

virtual void	paintMarker (QPainter *painter, const MarkerAttributes &markerAttributes, const QBrush &brush, const QPen &, const QPointF &point, const QSizeF &size)

void	paintMarker (QPainter *painter, const DataValueAttributes &a, const QModelIndex &index, const QPointF &pos)

void	paintMarker (QPainter *painter, const QModelIndex &index, const QPointF &pos)

QPen	pen () const
	Retrieve the pen to be used for painting datapoints globally. More...

QPen	pen (int dataset) const
	Retrieve the pen to be used for the given dataset. More...

QPen	pen (const QModelIndex &index) const
	Retrieve the pen to be used, for painting the datapoint at the given index in the model. More...

bool	percentMode () const
	Returns whether this diagram is drawn in percent mode. More...

virtual void	resize (const QSizeF &area)=0
	Called by the widget's sizeEvent. More...

void	scrollTo (const QModelIndex &index, ScrollHint hint=EnsureVisible) override
	[reimplemented] More...

void	setAllowOverlappingDataValueTexts (bool allow)
	Set whether data value labels are allowed to overlap. More...

void	setAntiAliasing (bool enabled)
	Set whether anti-aliasing is to be used while rendering this diagram. More...

virtual void	setAttributesModel (AttributesModel *model)
	Associate an AttributesModel with this diagram. More...

void	setBrush (const QModelIndex &index, const QBrush &brush)
	Set the brush to be used, for painting the datapoint at the given index. More...

void	setBrush (int dataset, const QBrush &brush)
	Set the brush to be used, for painting the given dataset. More...

void	setBrush (const QBrush &brush)
	Set the brush to be used, for painting all datasets in the model. More...

virtual void	setCoordinatePlane (AbstractCoordinatePlane *plane)
	Set the coordinate plane associated with the diagram. More...

void	setDatasetDimension (int dimension)

void	setDataValueAttributes (const QModelIndex &index, const DataValueAttributes &a)
	Set the DataValueAttributes for the given index. More...

void	setDataValueAttributes (int dataset, const DataValueAttributes &a)
	Set the DataValueAttributes for the given dataset. More...

void	setDataValueAttributes (const DataValueAttributes &a)
	Set the DataValueAttributes for all datapoints in the model. More...

void	setHidden (const QModelIndex &index, bool hidden)
	Hide (or unhide, resp.) a data cell. More...

void	setHidden (int dataset, bool hidden)
	Hide (or unhide, resp.) a dataset. More...

void	setHidden (bool hidden)
	Hide (or unhide, resp.) all datapoints in the model. More...

void	setModel (QAbstractItemModel *model) override
	Associate a model with the diagram. More...

void	setPen (const QModelIndex &index, const QPen &pen)
	Set the pen to be used, for painting the datapoint at the given index. More...

void	setPen (int dataset, const QPen &pen)
	Set the pen to be used, for painting the given dataset. More...

void	setPen (const QPen &pen)
	Set the pen to be used, for painting all datasets in the model. More...

void	setPercentMode (bool percent)
	Deprecated method that turns the percent mode of this diagram on or off. More...

void	setRootIndex (const QModelIndex &idx) override
	Set the root index in the model, where the diagram starts referencing data for display. More...

void	setSelection (const QRect &rect, QItemSelectionModel::SelectionFlags command) override
	[reimplemented] More...

void	setSelectionModel (QItemSelectionModel *selectionModel) override
	Associate a seleection model with the diagrom. More...

void	setUnitPrefix (const QString &prefix, int column, Qt::Orientation orientation)
	Set the unit prefix to be used on axes for one specific column. More...

void	setUnitPrefix (const QString &prefix, Qt::Orientation orientation)
	Set the unit prefix to be used on axes for all columns. More...

void	setUnitSuffix (const QString &suffix, int column, Qt::Orientation orientation)
	Set the unit prefix to be used on axes for one specific column. More...

void	setUnitSuffix (const QString &suffix, Qt::Orientation orientation)
	Set the unit prefix to be used on axes for all columns. More...

QString	unitPrefix (int column, Qt::Orientation orientation, bool fallback=false) const
	Retrieves the axis unit prefix for a specific column. More...

QString	unitPrefix (Qt::Orientation orientation) const
	Retrieves the axis unit prefix. More...

QString	unitSuffix (int column, Qt::Orientation orientation, bool fallback=false) const
	Retrieves the axis unit suffix for a specific column. More...

QString	unitSuffix (Qt::Orientation orientation) const
	Retrieves the axis unit suffix. More...

void	update () const

void	useDefaultColors ()
	Set the palette to be used, for painting datasets to the default palette. More...

void	useRainbowColors ()
	Set the palette to be used, for painting datasets to the rainbow palette. More...

virtual bool	usesExternalAttributesModel () const
	Returns whether the diagram is using its own built-in attributes model or an attributes model that was set via setAttributesModel. More...

void	useSubduedColors ()
	Set the palette to be used, for painting datasets to the subdued palette. More...

int	verticalOffset () const override
	[reimplemented] More...

QRect	visualRect (const QModelIndex &index) const override
	[reimplemented] More...

virtual QRegion	visualRegion (const QModelIndex &index) const

QRegion	visualRegionForSelection (const QItemSelection &selection) const override
	[reimplemented] More...

	~AbstractDiagram () override

Protected Slots
void	setDataBoundariesDirty () const

Protected Member Functions
	AbstractDiagram (Private p, QWidget parent, AbstractCoordinatePlane *plane)

	AbstractDiagram (QWidget parent=0, AbstractCoordinatePlane plane=0)

QModelIndex	attributesModelRootIndex () const

virtual const QPair< QPointF, QPointF >	calculateDataBoundaries () const =0

virtual bool	checkInvariants (bool justReturnTheStatus=false) const

virtual void	paintDataValueTexts (QPainter *painter)

virtual void	paintMarkers (QPainter *painter)

void	setAttributesModelRootIndex (const QModelIndex &)

void	setDatasetDimensionInternal (int dimension)

qreal	valueForCell (int row, int column) const
	Helper method, retrieving the data value (DisplayRole) for a given row and column. More...

Detailed Description

AbstractDiagram defines the interface for diagram classes.

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

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

Definition at line 50 of file KDChartAbstractDiagram.h.

Constructor & Destructor Documentation

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

explicitprotected

AbstractDiagram::AbstractDiagram	(	QWidget *	parent = `0`,
		AbstractCoordinatePlane *	plane = `0`
	)

explicitprotected

Definition at line 49 of file KDChartAbstractDiagram.cpp.

AbstractDiagram::~AbstractDiagram ( )

override

Definition at line 56 of file KDChartAbstractDiagram.cpp.

References aboutToBeDestroyed(), and d.

Member Function Documentation

void KDChart::AbstractDiagram::aboutToBeDestroyed ( )

signal

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

the attributes model, is invalidated.

Referenced by ~AbstractDiagram().

bool AbstractDiagram::allowOverlappingDataValueTexts ( ) const

Returns: Whether data value labels are allowed to overlap.

Definition at line 372 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by compare().

bool AbstractDiagram::antiAliasing ( ) const

Returns: Whether anti-aliasing is to be used for rendering this diagram.

Definition at line 383 of file KDChartAbstractDiagram.cpp.

References d.

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

AttributesModel * AbstractDiagram::attributesModel ( ) const

virtual

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.

Returns: The AttributesModel associated with the diagram.

See also: setAttributesModel

Definition at line 198 of file KDChartAbstractDiagram.cpp.

References d, and KDChart::AbstractProxyModel::mapFromSource().

Referenced by KDChart::BarDiagram::BarDiagram(), brush(), compare(), KDChart::Plotter::connectAttributesModel(), dataValueAttributes(), KDChart::DiagramObserver::diagram(), isHidden(), itemRowLabels(), numSignificantDecimalPlaces(), pen(), KDChart::AbstractCartesianDiagram::setAttributesModel(), KDChart::BarDiagram::setBarAttributes(), setBrush(), KDChart::AbstractCartesianDiagram::setCoordinatePlane(), setPen(), KDChart::AbstractCartesianDiagram::setRootIndex(), KDChart::Plotter::setUseDataCompression(), KDChart::TernaryLineDiagram::TernaryLineDiagram(), and KDChart::AbstractCartesianDiagram::~AbstractCartesianDiagram().

void KDChart::AbstractDiagram::attributesModelAboutToChange	(	AttributesModel *	newModel,
		AttributesModel *	oldModel
	)

signal

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

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

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

QModelIndex AbstractDiagram::attributesModelRootIndex ( ) const

protected

returns a QModelIndex pointing into the AttributesModel that corresponds to the root index of the diagram.

Definition at line 226 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by itemRowLabels(), KDChart::BarDiagram::numberOfAbscissaSegments(), KDChart::Plotter::numberOfAbscissaSegments(), KDChart::LineDiagram::numberOfAbscissaSegments(), KDChart::BarDiagram::numberOfOrdinateSegments(), KDChart::Plotter::numberOfOrdinateSegments(), KDChart::LineDiagram::numberOfOrdinateSegments(), and valueForCell().

void KDChart::AbstractDiagram::boundariesChanged ( )

signal

Emitted upon change of a data boundary.

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

QBrush AbstractDiagram::brush ( ) const

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

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

Referenced by brush(), datasetBrushes(), doArcsOverlap(), labelAttachmentLine(), KDChart::TernaryPointDiagram::paint(), KDChart::TernaryLineDiagram::paint(), KDChart::RadarDiagram::paint(), KDChart::PolarDiagram::paint(), KDChart::PaintingHelpers::paintAreas(), KDChart::PaintingHelpers::paintElements(), paintMarker(), KDChart::PaintingHelpers::paintThreeDLines(), KDChart::RingDiagram::resize(), and KDChart::RadarDiagram::reverseData().

QBrush AbstractDiagram::brush ( int dataset ) const

Retrieve the brush to be used for the given dataset.

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

Parameters

dataset The dataset to retrieve the brush for.

Returns: The brush to use for painting.

Definition at line 714 of file KDChartAbstractDiagram.cpp.

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

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

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

Parameters

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.

Returns: The brush to use for painting.

Definition at line 722 of file KDChartAbstractDiagram.cpp.

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

virtual const QPair<QPointF, QPointF> KDChart::AbstractDiagram::calculateDataBoundaries ( ) const

protectedpure virtual

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

Referenced by dataBoundaries().

bool AbstractDiagram::checkInvariants ( bool justReturnTheStatus = false ) const

protectedvirtual

bool AbstractDiagram::compare ( const AbstractDiagram * other ) const

Returns true if both diagrams have the same settings.

Definition at line 69 of file KDChartAbstractDiagram.cpp.

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

AbstractCoordinatePlane * AbstractDiagram::coordinatePlane ( ) const

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.

Returns: The coordinate plane associated with the diagram.

Definition at line 113 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by KDChart::Plotter::calcMergeRadius(), KDChart::BarDiagram::calculateDataBoundaries(), KDChart::LineDiagram::calculateDataBoundaries(), checkInvariants(), KDChart::Plotter::connectAttributesModel(), KDChart::LeveyJenningsDiagram::iconRect(), KDChart::AbstractCartesianDiagram::layoutPlanes(), KDChart::CartesianAxis::maximumSize(), KDChart::RadarDiagram::paint(), KDChart::PolarDiagram::paint(), paintDataValueTexts(), paintMarkers(), KDChart::AbstractPolarDiagram::polarCoordinatePlane(), KDChart::BarDiagram::resize(), KDChart::Plotter::resize(), KDChart::LineDiagram::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 cached result of calculations done by calculateDataBoundaries. Classes derived from AbstractDiagram must implement the calculateDataBoundaries function, to specify their own way of calculating the data boundaries. If derived classes want to force recalculation of the data boundaries, they can call setDataBoundariesDirty()

Returned value is in diagram coordinates.

Definition at line 118 of file KDChartAbstractDiagram.cpp.

References calculateDataBoundaries(), and d.

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

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

virtual

[reimplemented]

Definition at line 248 of file KDChartAbstractDiagram.cpp.

References setDataBoundariesDirty().

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

void KDChart::AbstractDiagram::dataHidden ( )

signal

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

Referenced by setHidden().

QList< QBrush > AbstractDiagram::datasetBrushes ( ) const

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

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

Returns: The current set of dataset brushes.

Definition at line 910 of file KDChartAbstractDiagram.cpp.

References brush(), and d.

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

int AbstractDiagram::datasetDimension ( ) const

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

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

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

Returns: The dataset dimension of the diagram.

Definition at line 961 of file KDChartAbstractDiagram.cpp.

References d.

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

QStringList AbstractDiagram::datasetLabels ( ) const

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

Returns: The set of dataset labels currently displayed.

Definition at line 897 of file KDChartAbstractDiagram.cpp.

References d.

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

QList< MarkerAttributes > AbstractDiagram::datasetMarkers ( ) const

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

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

Returns: The current set of dataset brushes.

Definition at line 936 of file KDChartAbstractDiagram.cpp.

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

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

QList< QPen > AbstractDiagram::datasetPens ( ) const

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

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

Returns: The current set of dataset pens.

Definition at line 923 of file KDChartAbstractDiagram.cpp.

References d, and pen().

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

DataValueAttributes AbstractDiagram::dataValueAttributes ( ) const

Retrieve the DataValueAttributes specified globally.

This will fall back automatically to the default settings, if there are no specific settings.

Returns: The global DataValueAttributes.

Definition at line 325 of file KDChartAbstractDiagram.cpp.

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

Referenced by contains(), datasetMarkers(), dataValueAttributes(), KDChart::TernaryPointDiagram::paint(), KDChart::TernaryLineDiagram::paint(), paintMarker(), KDChart::RingDiagram::resize(), setAllowOverlappingDataValueTexts(), and KDChart::TernaryLineDiagram::TernaryLineDiagram().

DataValueAttributes AbstractDiagram::dataValueAttributes ( int dataset ) const

Retrieve the DataValueAttributes for the given dataset.

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

Parameters

dataset The dataset to retrieve the attributes for.

Returns: The DataValueAttributes for the given dataset.

Definition at line 330 of file KDChartAbstractDiagram.cpp.

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

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

Retrieve the DataValueAttributes for the given index.

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

Parameters

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.

Returns: The DataValueAttributes for the given index.

Definition at line 350 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::doItemsLayout ( )

override

[reimplemented]

Definition at line 238 of file KDChartAbstractDiagram.cpp.

References d, and update().

int AbstractDiagram::horizontalOffset ( ) const

override

[reimplemented]

Definition at line 830 of file KDChartAbstractDiagram.cpp.

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

override

[reimplemented]

Definition at line 1002 of file KDChartAbstractDiagram.cpp.

References d.

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

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

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

Definition at line 1007 of file KDChartAbstractDiagram.cpp.

References d.

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

Definition at line 1012 of file KDChartAbstractDiagram.cpp.

References d.

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

bool AbstractDiagram::isHidden ( ) const

Retrieve the hidden status specified globally.

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

Returns: The global hidden status.

Definition at line 285 of file KDChartAbstractDiagram.cpp.

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

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

bool AbstractDiagram::isHidden ( int dataset ) const

Retrieve the hidden status for the given dataset.

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

Parameters

dataset The dataset to retrieve the hidden status for.

Returns: The hidden status for the given dataset.

Definition at line 290 of file KDChartAbstractDiagram.cpp.

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

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

Retrieve the hidden status for the given index.

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

Parameters

index The datapoint to retrieve the hidden status for.

Returns: The hidden status for the given index.

Definition at line 298 of file KDChartAbstractDiagram.cpp.

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

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

override

[reimplemented]

Definition at line 836 of file KDChartAbstractDiagram.cpp.

QStringList AbstractDiagram::itemRowLabels ( ) const

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

Returns: The set of item row labels currently displayed.

Definition at line 881 of file KDChartAbstractDiagram.cpp.

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

Referenced by numSignificantDecimalPlaces().

void KDChart::AbstractDiagram::layoutChanged ( AbstractDiagram * )

signal

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

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

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

void KDChart::AbstractDiagram::modelDataChanged ( )

signal

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

void KDChart::AbstractDiagram::modelsChanged ( )

signal

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

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

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

override

[reimplemented]

Definition at line 827 of file KDChartAbstractDiagram.cpp.

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

pure virtual

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

Parameters

paintContext All information needed for painting.

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

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

Definition at line 400 of file KDChartAbstractDiagram.cpp.

References d.

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

void AbstractDiagram::paintDataValueTexts ( QPainter * painter )

protectedvirtual

Deprecated:: This method is deprecated and provided for backward-compatibility only.

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

Definition at line 409 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::paintMarker	(	QPainter *	painter,
		const MarkerAttributes &	markerAttributes,
		const QBrush &	brush,
		const QPen &	pen,
		const QPointF &	point,
		const QSizeF &	size
	)

virtual

void AbstractDiagram::paintMarker	(	QPainter *	painter,
		const DataValueAttributes &	a,
		const QModelIndex &	index,
		const QPointF &	pos
	)

Definition at line 436 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 QModelIndex &	index,
		const QPointF &	pos
	)

Definition at line 464 of file KDChartAbstractDiagram.cpp.

References checkInvariants(), dataValueAttributes(), and paintMarker().

void AbstractDiagram::paintMarkers ( QPainter * painter )

protectedvirtual

Deprecated:: This method is deprecated and provided for backward-compatibility only.

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

Definition at line 621 of file KDChartAbstractDiagram.cpp.

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

QPen AbstractDiagram::pen ( ) const

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

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

Referenced by datasetPens(), labelAttachmentLine(), KDChart::TernaryPointDiagram::paint(), KDChart::TernaryLineDiagram::paint(), KDChart::LeveyJenningsDiagram::paint(), KDChart::PaintingHelpers::paintAreas(), KDChart::PaintingHelpers::paintElements(), KDChart::PaintingHelpers::paintThreeDLines(), pen(), KDChart::RingDiagram::resize(), KDChart::RadarDiagram::reverseData(), and KDChart::LeveyJenningsDiagram::setScanLinePen().

QPen AbstractDiagram::pen ( int dataset ) const

Retrieve the pen to be used for the given dataset.

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

Parameters

dataset The dataset to retrieve the pen for.

Returns: The pen to use for painting.

Definition at line 673 of file KDChartAbstractDiagram.cpp.

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

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

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

Parameters

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.

Returns: The pen to use for painting.

Definition at line 681 of file KDChartAbstractDiagram.cpp.

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

bool AbstractDiagram::percentMode ( ) const

Returns whether this diagram is drawn in percent mode.

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

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

Definition at line 394 of file KDChartAbstractDiagram.cpp.

References d.

Referenced by compare().

void KDChart::AbstractDiagram::propertiesChanged ( )

signal

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

pure virtual

Called by the widget's sizeEvent.

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

Parameters

area

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

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

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

override

[reimplemented]

Definition at line 822 of file KDChartAbstractDiagram.cpp.

void AbstractDiagram::setAllowOverlappingDataValueTexts ( bool allow )

Set whether data value labels are allowed to overlap.

Parameters

allow True means that overlapping labels are allowed.

Definition at line 363 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setAntiAliasing ( bool enabled )

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

Parameters

enabled True means that AA is enabled.

Definition at line 377 of file KDChartAbstractDiagram.cpp.

References d, and propertiesChanged().

void AbstractDiagram::setAttributesModel ( AttributesModel * amodel )

virtual

Associate an AttributesModel with this diagram.

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

Correct:

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

Wrong:

diagram1->setAttributesModel( diagram2->attributesModel() );

Parameters

model The AttributesModel to use for this diagram.

See also: AttributesModel, usesExternalAttributesModel

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

Parameters

amodel The AttributesModel to use for this diagram.

Reimplemented in KDChart::AbstractCartesianDiagram.

Definition at line 173 of file KDChartAbstractDiagram.cpp.

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

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

void AbstractDiagram::setAttributesModelRootIndex ( const QModelIndex & idx )

protected

Definition at line 217 of file KDChartAbstractDiagram.cpp.

References d, and setDataBoundariesDirty().

Referenced by setRootIndex().

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

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

Parameters

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.
brush	The brush to use.

Definition at line 688 of file KDChartAbstractDiagram.cpp.

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

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

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

Parameters

dataset	The dataset to set the brush for.
brush	The brush to use.

Definition at line 703 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setBrush ( const QBrush & brush )

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

Parameters

brush The brush to use.

Definition at line 696 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setCoordinatePlane ( AbstractCoordinatePlane * plane )

virtual

Set the coordinate plane associated with the diagram.

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

Returns: The coordinate plane associated with the diagram.

Reimplemented in KDChart::AbstractCartesianDiagram.

Definition at line 233 of file KDChartAbstractDiagram.cpp.

References d.

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

void AbstractDiagram::setDataBoundariesDirty ( ) const

protectedslot

Definition at line 127 of file KDChartAbstractDiagram.cpp.

References d, and update().

Referenced by dataChanged(), KDChart::BarDiagram::resize(), KDChart::LineDiagram::resize(), setAttributesModel(), setAttributesModelRootIndex(), KDChart::LineDiagram::setCenterDataPoints(), KDChart::Plotter::setDataBoundariesDirty(), setDatasetDimensionInternal(), setModel(), KDChart::BarDiagram::setThreeDBarAttributes(), KDChart::LineDiagram::setThreeDLineAttributes(), and KDChart::LineDiagram::setType().

void AbstractDiagram::setDatasetDimension ( int dimension )

Deprecated:

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

Definition at line 966 of file KDChartAbstractDiagram.cpp.

void AbstractDiagram::setDatasetDimensionInternal ( int dimension )

protected

Definition at line 973 of file KDChartAbstractDiagram.cpp.

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

Referenced by KDChart::Plotter::Plotter(), KDChart::TernaryLineDiagram::TernaryLineDiagram(), and KDChart::TernaryPointDiagram::TernaryPointDiagram().

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

Set the DataValueAttributes for the given index.

Parameters

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.
a	The attributes to set.

Definition at line 310 of file KDChartAbstractDiagram.cpp.

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

Referenced by setAllowOverlappingDataValueTexts().

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

Set the DataValueAttributes for the given dataset.

Parameters

dataset	The dataset to set the attributes for.
a	The attributes to set.

Definition at line 319 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setDataValueAttributes ( const DataValueAttributes & a )

Set the DataValueAttributes for all datapoints in the model.

Parameters

a	The attributes to set.

Definition at line 357 of file KDChartAbstractDiagram.cpp.

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

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

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

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

Parameters

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.
hidden	The hidden status to set.

Definition at line 264 of file KDChartAbstractDiagram.cpp.

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

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

Hide (or unhide, resp.) a dataset.

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

Parameters

dataset	The dataset to set the hidden status for.
hidden	The hidden status to set.

Definition at line 273 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setHidden ( bool hidden )

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

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

Parameters

hidden The hidden status to set.

Definition at line 279 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setModel ( QAbstractItemModel * model )

override

Associate a model with the diagram.

Definition at line 133 of file KDChartAbstractDiagram.cpp.

References d, KDChart::AttributesModel::initFrom(), modelsChanged(), and setDataBoundariesDirty().

Referenced by KDChart::AbstractCartesianDiagram::setModel(), and KDChart::Widget::setType().

void AbstractDiagram::setPen	(	const QModelIndex &	index,
		const QPen &	pen
	)

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

Parameters

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.
pen	The pen to use.

Definition at line 647 of file KDChartAbstractDiagram.cpp.

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

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

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

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

Parameters

dataset	The dataset to set the pen for.
pen	The pen to use.

Definition at line 662 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setPen ( const QPen & pen )

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

Parameters

pen	The pen to use.

Definition at line 655 of file KDChartAbstractDiagram.cpp.

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

void AbstractDiagram::setPercentMode ( bool percent )

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

Deprecated:

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

See also: percentMode

Definition at line 388 of file KDChartAbstractDiagram.cpp.

References d, and propertiesChanged().

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

void AbstractDiagram::setRootIndex ( const QModelIndex & idx )

override

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

[reimplemented]

Definition at line 210 of file KDChartAbstractDiagram.cpp.

References d, and setAttributesModelRootIndex().

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

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

override

[reimplemented]

Definition at line 839 of file KDChartAbstractDiagram.cpp.

References d.

void AbstractDiagram::setSelectionModel ( QItemSelectionModel * selectionModel )

override

Associate a seleection model with the diagrom.

Definition at line 150 of file KDChartAbstractDiagram.cpp.

References modelsChanged().

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

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

Sets the unit prefix for one value.

Parameters

prefix	The prefix to be used.
column	The column which should be set.
orientation	The orientation of the axis to use.
prefix	the prefix to be set
column	the value using that prefix
orientation	the orientantion of the axis to set

Definition at line 734 of file KDChartAbstractDiagram.cpp.

References d.

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

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

Sets the unit prefix for all values.

Parameters

prefix	The prefix to be used.
orientation	The orientation of the axis to use.
prefix	the prefix to be set
orientation	the orientantion of the axis to set

Definition at line 744 of file KDChartAbstractDiagram.cpp.

References d.

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

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

Sets the unit suffix for one value.

Parameters

suffix	The suffix to be used.
column	The column which should be set.
orientation	The orientation of the axis to use.
suffix	the suffix to be set
column	the value using that suffix
orientation	the orientantion of the axis to set

Definition at line 755 of file KDChartAbstractDiagram.cpp.

References d.

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

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

Sets the unit suffix for all values.

Parameters

suffix	The suffix to be used.
orientation	The orientation of the axis to use.
suffix	the suffix to be set
orientation	the orientantion of the axis to set

Definition at line 765 of file KDChartAbstractDiagram.cpp.

References d.

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

Retrieves the axis unit prefix for a specific column.

Returns the unit prefix for a special value.

Parameters

column	The column whose prefix should be retrieved.
orientation	The orientation of the axis.
fallback	If true, the prefix for all columns is returned, when none is set for the selected column.

Returns: The axis unit prefix.

Parameters

column	the value which's prefix is requested
orientation	the orientation of the axis
fallback	if true, the global prefix is return when no specific one is set for that value

Returns: the unit prefix

Definition at line 777 of file KDChartAbstractDiagram.cpp.

References d.

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

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

Retrieves the axis unit prefix.

Returns the global unit prefix.

Parameters

orientation The orientation of the axis.

Returns: The axis unit prefix.

Parameters

orientation the orientation of the axis

Returns: the unit prefix

Definition at line 788 of file KDChartAbstractDiagram.cpp.

References d.

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

Retrieves the axis unit suffix for a specific column.

Returns the unit suffix for a special value.

Parameters

column	The column whose prefix should be retrieved.
orientation	The orientation of the axis.
fallback	If true, the suffix for all columns is returned, when none is set for the selected column.

Returns: The axis unit suffix.

Parameters

column	the value which's suffix is requested
orientation	the orientation of the axis
fallback	if true, the global suffix is return when no specific one is set for that value