Plotter defines a diagram type plotting two-dimensional data. More...

#include <KDChartPlotter.h>

Inheritance diagram for KDChart::Plotter:

Collaboration diagram for KDChart::Plotter:

Public Types
enum	CompressionMode { SLOPE, DISTANCE, BOTH, NONE }

enum	PlotType { Normal = 0, Percent }

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
virtual void	addAxis (CartesianAxis *axis)
	Add the axis to the diagram. More...

bool	allowOverlappingDataValueTexts () const

bool	antiAliasing () const

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

virtual KDChart::CartesianAxisList	axes () const

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...

virtual Plotter *	clone () const
	Creates an exact copy of this diagram. More...

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

bool	compare (const Plotter *other) const
	Returns true if both diagrams have the same settings. 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...

virtual void	layoutPlanes ()
	Triggers layouting of all coordinate planes on the current chart. More...

LineAttributes	lineAttributes () const

LineAttributes	lineAttributes (int column) const

LineAttributes	lineAttributes (const QModelIndex &index) const

qreal	maxSlopeChange () const

qreal	mergeRadiusPercentage () const

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

const int	numberOfAbscissaSegments () const

const int	numberOfOrdinateSegments () const

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...

	Plotter (QWidget parent=0, CartesianCoordinatePlane plane=0)

virtual AbstractCartesianDiagram *	referenceDiagram () const

virtual QPointF	referenceDiagramOffset () const

void	resetLineAttributes (int column)
	Resets the line attributes of data set column. More...

void	resetLineAttributes (const QModelIndex &index)
	Remove any explicit line attributes settings that might have been specified before. More...

void	resize (const QSizeF &area) override
	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...

void	setAttributesModel (AttributesModel *model) override
	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...

void	setCoordinatePlane (AbstractCoordinatePlane *plane) override
	[reimplemented] 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	setLineAttributes (const LineAttributes &a)
	Sets the global line attributes to la. More...

void	setLineAttributes (int column, const LineAttributes &a)
	Sets the line attributes of data set column to la. More...

void	setLineAttributes (const QModelIndex &index, const LineAttributes &a)
	Sets the line attributes for the model index index to la. More...

void	setMaxSlopeChange (qreal value)

void	setMergeRadiusPercentage (qreal value)

void	setModel (QAbstractItemModel *model) override

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...

virtual void	setReferenceDiagram (AbstractCartesianDiagram *diagram, const QPointF &offset=QPointF())
	Makes this diagram use another diagram diagram as reference diagram with relative offset offset. More...

void	setRootIndex (const QModelIndex &index) override

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	setThreeDLineAttributes (const ThreeDLineAttributes &a)
	Sets the global 3D line attributes to la. More...

void	setThreeDLineAttributes (int column, const ThreeDLineAttributes &a)
	Sets the 3D line attributes of data set column to la. More...

void	setThreeDLineAttributes (const QModelIndex &index, const ThreeDLineAttributes &a)
	Sets the 3D line attributes of model index index to la. More...

void	setType (const PlotType type)
	Sets the plotter's type to type. 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...

void	setUseDataCompression (CompressionMode value)

void	setValueTrackerAttributes (const QModelIndex &index, const ValueTrackerAttributes &a)
	Sets the value tracker attributes of the model index index to va. More...

virtual void	takeAxis (CartesianAxis *axis)
	Removes the axis from the diagram, without deleting it. More...

ThreeDLineAttributes	threeDLineAttributes () const

ThreeDLineAttributes	threeDLineAttributes (int column) const

ThreeDLineAttributes	threeDLineAttributes (const QModelIndex &index) const

PlotType	type () const

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

CompressionMode	useDataCompression () 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...

ValueTrackerAttributes	valueTrackerAttributes (const QModelIndex &index) const
	Returns the value tracker attributes of the model index index. 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...

	~Plotter () override

Protected Slots
void	calcMergeRadius ()

void	connectAttributesModel (AttributesModel *)

void	setDataBoundariesDirty ()

void	setDataBoundariesDirty () const

Protected Member Functions
QModelIndex	attributesModelRootIndex () const

const QPair< QPointF, QPointF >	calculateDataBoundaries () const override
	[reimplemented] More...

virtual bool	checkInvariants (bool justReturnTheStatus=false) const

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

virtual void	paintDataValueTexts (QPainter *painter)

void	paintEvent (QPaintEvent *) override

virtual void	paintMarkers (QPainter *painter)

void	resizeEvent (QResizeEvent *) override

void	setAttributesModelRootIndex (const QModelIndex &)

void	setDatasetDimensionInternal (int dimension)

qreal	threeDItemDepth (const QModelIndex &index) const override

qreal	threeDItemDepth (int column) const override

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

Properties
qreal	mergeRadiusPercentage

CompressionMode	useDataCompression

Detailed Description

Plotter defines a diagram type plotting two-dimensional data.

Definition at line 38 of file KDChartPlotter.h.

Member Enumeration Documentation

enum KDChart::Plotter::CompressionMode

Enumerator
SLOPE
DISTANCE
BOTH
NONE

Definition at line 52 of file KDChartPlotter.h.

enum KDChart::Plotter::PlotType

Enumerator
Normal
Percent

Definition at line 66 of file KDChartPlotter.h.

Constructor & Destructor Documentation

Plotter::Plotter	(	QWidget *	parent = `0`,
		CartesianCoordinatePlane *	plane = `0`
	)

explicit

Definition at line 53 of file KDChartPlotter.cpp.

References KDChart::AbstractDiagram::attributesModelAboutToChange(), KDChart::AbstractDiagram::boundariesChanged(), connectAttributesModel(), d, and KDChart::AbstractDiagram::setDatasetDimensionInternal().

Referenced by clone().

Plotter::~Plotter ( )

override

Definition at line 76 of file KDChartPlotter.cpp.

Member Function Documentation

void KDChart::AbstractDiagram::aboutToBeDestroyed ( )

signalinherited

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().

void AbstractCartesianDiagram::addAxis ( CartesianAxis * axis )

virtualinherited

Add the axis to the diagram.

The diagram takes ownership of the axis and will delete it.

To gain back ownership (e.g. for assigning the axis to another diagram) use the takeAxis method, before calling addAxis on the other diagram.

See also: takeAxis

Definition at line 84 of file KDChartAbstractCartesianDiagram.cpp.

References KDChart::AbstractAxis::createObserver(), d, and KDChart::AbstractCartesianDiagram::layoutPlanes().

bool AbstractDiagram::allowOverlappingDataValueTexts ( ) const

inherited

Returns: Whether data value labels are allowed to overlap.

Definition at line 372 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 383 of file KDChartAbstractDiagram.cpp.

References d.

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

AttributesModel * AbstractDiagram::attributesModel ( ) const

virtualinherited

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().

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

signalinherited

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 Plotter(), and KDChart::AbstractCartesianDiagram::~AbstractCartesianDiagram().

QModelIndex AbstractDiagram::attributesModelRootIndex ( ) const

protectedinherited

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 KDChart::AbstractDiagram::itemRowLabels(), KDChart::BarDiagram::numberOfAbscissaSegments(), numberOfAbscissaSegments(), KDChart::LineDiagram::numberOfAbscissaSegments(), KDChart::BarDiagram::numberOfOrdinateSegments(), numberOfOrdinateSegments(), KDChart::LineDiagram::numberOfOrdinateSegments(), and KDChart::AbstractDiagram::valueForCell().

KDChart::CartesianAxisList AbstractCartesianDiagram::axes ( ) const

virtualinherited

Returns: a list of all axes added to the diagram

Definition at line 103 of file KDChartAbstractCartesianDiagram.cpp.

References d.

Referenced by allAxisAnnotations(), checkExistingAxes(), findSharingAxisDiagrams(), KDChart::Widget::setType(), and KDChart::CartesianCoordinatePlane::sharedAxisMasterPlane().

void KDChart::AbstractDiagram::boundariesChanged ( )

signalinherited

Emitted upon change of a data boundary.

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

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

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

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

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

dataset The dataset to retrieve the brush for.

Returns: The brush to use for painting.

Definition at line 714 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

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 KDChart::AbstractDiagram::attributesModel(), KDChart::AttributesModel::data(), and KDChart::DatasetBrushRole.

void Plotter::calcMergeRadius ( )

protectedslot

Definition at line 457 of file KDChartPlotter.cpp.

References KDChart::AbstractDiagram::coordinatePlane(), d, and KDChart::CartesianCoordinatePlane::visibleDataRange().

Referenced by connectAttributesModel(), resize(), and setDataBoundariesDirty().

const QPair< QPointF, QPointF > Plotter::calculateDataBoundaries ( ) const

overrideprotectedvirtual

[reimplemented]

Implements KDChart::AbstractDiagram.

Definition at line 388 of file KDChartPlotter.cpp.

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

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

protectedvirtualinherited

Definition at line 949 of file KDChartAbstractDiagram.cpp.

References KDChart::AbstractDiagram::coordinatePlane().

Referenced by KDChart::RingDiagram::calculateDataBoundaries(), KDChart::PieDiagram::calculateDataBoundaries(), KDChart::RadarDiagram::calculateDataBoundaries(), KDChart::PolarDiagram::calculateDataBoundaries(), KDChart::BarDiagram::calculateDataBoundaries(), calculateDataBoundaries(), KDChart::LineDiagram::calculateDataBoundaries(), labelAttachmentLine(), KDChart::RingDiagram::paint(), KDChart::PieDiagram::paint(), KDChart::RadarDiagram::paint(), KDChart::PolarDiagram::paint(), KDChart::BarDiagram::paint(), KDChart::LeveyJenningsDiagram::paint(), paint(), KDChart::LineDiagram::paint(), KDChart::AbstractDiagram::paintDataValueTexts(), KDChart::AbstractDiagram::paintMarker(), and KDChart::AbstractDiagram::paintMarkers().

Plotter * Plotter::clone ( ) const

virtual

Creates an exact copy of this diagram.

Definition at line 83 of file KDChartPlotter.cpp.

References d, Plotter(), setType(), and type().

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

inherited

Returns true if both diagrams have the same settings.

Definition at line 40 of file KDChartAbstractCartesianDiagram.cpp.

References KDChart::AbstractAxis::compare(), KDChart::AbstractCartesianDiagram::referenceDiagram(), and KDChart::AbstractCartesianDiagram::referenceDiagramOffset().

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

Returns true if both diagrams have the same settings.

Definition at line 90 of file KDChartPlotter.cpp.

References type().

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

inherited

Returns true if both diagrams have the same settings.

Definition at line 69 of file KDChartAbstractDiagram.cpp.

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

void Plotter::connectAttributesModel ( AttributesModel * newModel )

protectedslot

Definition at line 102 of file KDChartPlotter.cpp.

References KDChart::AbstractDiagram::attributesModel(), KDChart::AbstractDiagram::boundariesChanged(), calcMergeRadius(), KDChart::AbstractCartesianDiagram::connectAttributesModel(), KDChart::AbstractDiagram::coordinatePlane(), d, NONE, setDataBoundariesDirty(), SLOPE, and useDataCompression().

Referenced by Plotter().

AbstractCoordinatePlane * AbstractDiagram::coordinatePlane ( ) const

inherited

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 calcMergeRadius(), KDChart::BarDiagram::calculateDataBoundaries(), KDChart::LineDiagram::calculateDataBoundaries(), KDChart::AbstractDiagram::checkInvariants(), connectAttributesModel(), KDChart::LeveyJenningsDiagram::iconRect(), KDChart::AbstractCartesianDiagram::layoutPlanes(), KDChart::CartesianAxis::maximumSize(), KDChart::RadarDiagram::paint(), KDChart::PolarDiagram::paint(), KDChart::AbstractDiagram::paintDataValueTexts(), KDChart::AbstractDiagram::paintMarkers(), KDChart::AbstractPolarDiagram::polarCoordinatePlane(), KDChart::BarDiagram::resize(), resize(), KDChart::LineDiagram::resize(), and KDChart::AbstractCartesianDiagram::setCoordinatePlane().

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 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 KDChart::AbstractDiagram::calculateDataBoundaries(), and d.

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

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

virtualinherited

[reimplemented]

Definition at line 248 of file KDChartAbstractDiagram.cpp.

References KDChart::AbstractDiagram::setDataBoundariesDirty().

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

void KDChart::AbstractDiagram::dataHidden ( )

signalinherited

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

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

Referenced by KDChart::Legend::datasetCount(), KDChart::Legend::removeDiagram(), KDChart::Legend::resizeEvent(), 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 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 KDChart::AbstractDiagram::compare(), contains(), KDChart::CartesianCoordinatePlane::getDataDimensionsList(), KDChart::TernaryPointDiagram::paint(), KDChart::TernaryLineDiagram::paint(), KDChart::AbstractDiagram::paintDataValueTexts(), KDChart::AbstractDiagram::paintMarkers(), 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 897 of file KDChartAbstractDiagram.cpp.

References d.

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

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

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

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

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

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

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

DataValueAttributes AbstractDiagram::dataValueAttributes ( ) const

inherited

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 KDChart::AbstractDiagram::attributesModel(), KDChart::DataValueLabelAttributesRole, and KDChart::AttributesModel::modelData().

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

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

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, 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

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 KDChart::AbstractDiagram::attributesModel(), KDChart::AttributesModel::data(), and KDChart::DataValueLabelAttributesRole.

void AbstractDiagram::doItemsLayout ( )

overrideinherited

[reimplemented]

Definition at line 238 of file KDChartAbstractDiagram.cpp.

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

int AbstractDiagram::horizontalOffset ( ) const

overrideinherited

[reimplemented]

Definition at line 830 of file KDChartAbstractDiagram.cpp.

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

overrideinherited

[reimplemented]

Definition at line 1002 of file KDChartAbstractDiagram.cpp.

References d.

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

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

References d.

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

inherited

Definition at line 1012 of file KDChartAbstractDiagram.cpp.

References d.

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

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

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

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

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

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 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

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 KDChart::AbstractDiagram::attributesModel(), d, KDChart::DataHiddenRole, and KDChart::AbstractDiagram::isHidden().

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

overrideinherited

[reimplemented]

Definition at line 836 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 881 of file KDChartAbstractDiagram.cpp.

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

Referenced by numSignificantDecimalPlaces().

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

signalinherited

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(), KDChart::AbstractDiagram::setDatasetDimensionInternal(), KDChart::LeveyJenningsDiagram::setModel(), KDChart::AbstractPieDiagram::setPieAttributes(), KDChart::BarDiagram::setThreeDBarAttributes(), KDChart::AbstractPieDiagram::setThreeDPieAttributes(), setType(), KDChart::LineDiagram::setType(), and KDChart::AbstractCartesianDiagram::~AbstractCartesianDiagram().

void KDChart::AbstractCartesianDiagram::layoutPlanes ( )

virtualinherited

Triggers layouting of all coordinate planes on the current chart.

Normally you don't need to call this method. It's handled automatically for you.

Definition at line 108 of file KDChartAbstractCartesianDiagram.cpp.

References KDChart::AbstractDiagram::coordinatePlane(), and KDChart::AbstractCoordinatePlane::layoutPlanes().

Referenced by KDChart::AbstractCartesianDiagram::addAxis(), and KDChart::AbstractCartesianDiagram::takeAxis().

LineAttributes Plotter::lineAttributes ( ) const

Returns: the global line attribute set

Definition at line 270 of file KDChartPlotter.cpp.

References d, and KDChart::LineAttributesRole.

Referenced by lineAttributes().

LineAttributes Plotter::lineAttributes ( int column ) const

Returns: the line attribute set of data set column

Definition at line 278 of file KDChartPlotter.cpp.

References d, lineAttributes(), and KDChart::LineAttributesRole.

LineAttributes Plotter::lineAttributes ( const QModelIndex & index ) const

Returns: the line attribute set of the model index index

Definition at line 289 of file KDChartPlotter.cpp.

References d, and KDChart::LineAttributesRole.

qreal Plotter::maxSlopeChange ( ) const

Definition at line 151 of file KDChartPlotter.cpp.

References d.

qreal KDChart::Plotter::mergeRadiusPercentage ( ) const

Referenced by setMaxSlopeChange().

void KDChart::AbstractDiagram::modelDataChanged ( )

signalinherited

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

void KDChart::AbstractDiagram::modelsChanged ( )

signalinherited

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

Referenced by KDChart::AbstractDiagram::setAttributesModel(), KDChart::AbstractDiagram::setModel(), and KDChart::AbstractDiagram::setSelectionModel().

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

overrideinherited

[reimplemented]

Definition at line 827 of file KDChartAbstractDiagram.cpp.

const int Plotter::numberOfAbscissaSegments ( ) const

virtual

Implements KDChart::AbstractCartesianDiagram.

Definition at line 474 of file KDChartPlotter.cpp.

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

const int Plotter::numberOfOrdinateSegments ( ) const

virtual

Implements KDChart::AbstractCartesianDiagram.

Definition at line 482 of file KDChartPlotter.cpp.

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

void Plotter::paint ( PaintContext * paintContext )

overrideprotectedvirtual

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.

Implements KDChart::AbstractDiagram.

Definition at line 411 of file KDChartPlotter.cpp.

References KDChart::AbstractDiagram::checkInvariants(), KDChart::PaintContext::coordinatePlane(), d, KDChart::AbstractDiagram::dataBoundaries(), KDChart::PaintContext::painter(), KDChart::PaintContext::setCoordinatePlane(), and KDChart::AbstractCoordinatePlane::sharedAxisMasterPlane().

Referenced by paintEvent().

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

inherited

Definition at line 400 of file KDChartAbstractDiagram.cpp.

References d.

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

void AbstractDiagram::paintDataValueTexts ( QPainter * painter )

protectedvirtualinherited

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 KDChart::AbstractDiagram::checkInvariants(), KDChart::AbstractDiagram::coordinatePlane(), d, KDChart::AbstractDiagram::datasetDimension(), KDChart::AbstractDiagram::paintDataValueText(), and translate().

void Plotter::paintEvent ( QPaintEvent * )

overrideprotected

Definition at line 402 of file KDChartPlotter.cpp.

References paint(), KDChart::PaintContext::setPainter(), and KDChart::PaintContext::setRectangle().

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

virtualinherited

Definition at line 472 of file KDChartAbstractDiagram.cpp.

Referenced by KDChart::TernaryPointDiagram::paint(), KDChart::TernaryLineDiagram::paint(), KDChart::MarkerLayoutItem::paintIntoRect(), KDChart::AbstractDiagram::paintMarker(), and KDChart::AbstractDiagram::paintMarkers().

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

inherited

Definition at line 436 of file KDChartAbstractDiagram.cpp.

References KDChart::AbstractDiagram::brush(), KDChart::AbstractDiagram::checkInvariants(), d, KDChart::MarkerAttributes::isVisible(), KDChart::DataValueAttributes::isVisible(), KDChart::DataValueAttributes::markerAttributes(), KDChart::MarkerAttributes::markerColor(), KDChart::MarkerAttributes::markerSize(), KDChart::AbstractDiagram::paintMarker(), and KDChart::MarkerAttributes::pen().

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

inherited

Definition at line 464 of file KDChartAbstractDiagram.cpp.

References KDChart::AbstractDiagram::checkInvariants(), KDChart::AbstractDiagram::dataValueAttributes(), and KDChart::AbstractDiagram::paintMarker().

void AbstractDiagram::paintMarkers ( QPainter * painter )

protectedvirtualinherited

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 KDChart::AbstractDiagram::checkInvariants(), KDChart::AbstractDiagram::coordinatePlane(), KDChart::AbstractDiagram::datasetDimension(), KDChart::AbstractDiagram::paintMarker(), and 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 668 of file KDChartAbstractDiagram.cpp.

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

Referenced by KDChart::AbstractDiagram::datasetPens(), labelAttachmentLine(), KDChart::TernaryPointDiagram::paint(), KDChart::TernaryLineDiagram::paint(), KDChart::LeveyJenningsDiagram::paint(), KDChart::PaintingHelpers::paintAreas(), KDChart::PaintingHelpers::paintElements(), KDChart::PaintingHelpers::paintThreeDLines(), KDChart::AbstractDiagram::pen(), KDChart::RingDiagram::resize(), KDChart::RadarDiagram::reverseData(), 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

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 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

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 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 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 KDChart::AbstractDiagram::compare().

void KDChart::AbstractDiagram::propertiesChanged ( )

signalinherited

Emitted upon change of a property of the Diagram.

Referenced by resetLineAttributes(), KDChart::LineDiagram::resetLineAttributes(), KDChart::AbstractDiagram::setAllowOverlappingDataValueTexts(), KDChart::AbstractDiagram::setAntiAliasing(), KDChart::BarDiagram::setBarAttributes(), KDChart::AbstractDiagram::setBrush(), KDChart::LineDiagram::setCenterDataPoints(), KDChart::AbstractDiagram::setDataValueAttributes(), setLineAttributes(), KDChart::LineDiagram::setLineAttributes(), KDChart::LineDiagram::setLineTension(), KDChart::AbstractDiagram::setPen(), KDChart::AbstractDiagram::setPercentMode(), KDChart::BarDiagram::setThreeDBarAttributes(), setThreeDLineAttributes(), KDChart::LineDiagram::setThreeDLineAttributes(), setType(), KDChart::LineDiagram::setType(), setValueTrackerAttributes(), and KDChart::LineDiagram::setValueTrackerAttributes().

AbstractCartesianDiagram * AbstractCartesianDiagram::referenceDiagram ( ) const

virtualinherited

Returns: this diagram's reference diagram

See also: setReferenceDiagram

Definition at line 153 of file KDChartAbstractCartesianDiagram.cpp.

References d.

Referenced by KDChart::AbstractCartesianDiagram::compare(), KDChart::CartesianCoordinatePlane::getDataDimensionsList(), referenceDiagramIsBarDiagram(), and referenceDiagramNeedsCenteredAbscissaTicks().

QPointF AbstractCartesianDiagram::referenceDiagramOffset ( ) const

virtualinherited

Returns: the relative offset of this diagram's reference diagram

See also: setReferenceDiagram

Definition at line 158 of file KDChartAbstractCartesianDiagram.cpp.

References d.

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

void Plotter::resetLineAttributes ( int column )

Resets the line attributes of data set column.

Definition at line 241 of file KDChartPlotter.cpp.

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

void Plotter::resetLineAttributes ( const QModelIndex & index )

Remove any explicit line attributes settings that might have been specified before.

Definition at line 260 of file KDChartPlotter.cpp.

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

void Plotter::resize ( const QSizeF & area )

overridevirtual

Called by the widget's sizeEvent.

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

Parameters

area

Implements KDChart::AbstractDiagram.

Definition at line 435 of file KDChartPlotter.cpp.

References BOTH, calcMergeRadius(), KDChart::AbstractDiagram::coordinatePlane(), d, DISTANCE, setDataBoundariesDirty(), and useDataCompression().

void Plotter::resizeEvent ( QResizeEvent * )

overrideprotected

Definition at line 384 of file KDChartPlotter.cpp.

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

overrideinherited

[reimplemented]

Definition at line 822 of file KDChartAbstractDiagram.cpp.

void AbstractDiagram::setAllowOverlappingDataValueTexts ( bool allow )

inherited

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, KDChart::AbstractDiagram::dataValueAttributes(), KDChart::AbstractDiagram::propertiesChanged(), KDChart::AbstractDiagram::setDataValueAttributes(), and KDChart::DataValueAttributes::setShowOverlappingDataLabels().

void AbstractDiagram::setAntiAliasing ( bool enabled )

inherited

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 KDChart::AbstractDiagram::propertiesChanged().

void AbstractCartesianDiagram::setAttributesModel ( AttributesModel * amodel )

overridevirtualinherited

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 from KDChart::AbstractDiagram.

Definition at line 177 of file KDChartAbstractCartesianDiagram.cpp.

References KDChart::AbstractDiagram::attributesModel(), and KDChart::AbstractDiagram::setAttributesModel().

void AbstractDiagram::setAttributesModelRootIndex ( const QModelIndex & idx )

protectedinherited

Definition at line 217 of file KDChartAbstractDiagram.cpp.

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

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

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

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 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

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 KDChart::AbstractDiagram::propertiesChanged().

void AbstractDiagram::setBrush ( const QBrush & brush )

inherited

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 KDChart::AbstractDiagram::attributesModel(), KDChart::DatasetBrushRole, KDChart::AbstractDiagram::propertiesChanged(), and KDChart::AttributesModel::setModelData().

void KDChart::AbstractCartesianDiagram::setCoordinatePlane ( AbstractCoordinatePlane * plane )

overridevirtualinherited

[reimplemented]

Reimplemented from KDChart::AbstractDiagram.

Definition at line 116 of file KDChartAbstractCartesianDiagram.cpp.

References KDChart::AbstractDiagram::attributesModel(), KDChart::AbstractDiagram::coordinatePlane(), KDChart::AbstractDiagram::setCoordinatePlane(), KDChart::AbstractDiagram::update(), and KDChart::AbstractDiagram::viewportCoordinateSystemChanged().

void Plotter::setDataBoundariesDirty ( )

protectedslot

Definition at line 447 of file KDChartPlotter.cpp.

References BOTH, calcMergeRadius(), DISTANCE, KDChart::AbstractDiagram::setDataBoundariesDirty(), and useDataCompression().

Referenced by connectAttributesModel(), resize(), setThreeDLineAttributes(), and setType().

void AbstractDiagram::setDataBoundariesDirty ( ) const

protectedslotinherited

Definition at line 127 of file KDChartAbstractDiagram.cpp.

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

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

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

void AbstractDiagram::setDatasetDimensionInternal ( int dimension )

protectedinherited

Definition at line 973 of file KDChartAbstractDiagram.cpp.

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

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

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

inherited

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 KDChart::AbstractDiagram::propertiesChanged().

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

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

inherited

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 KDChart::AbstractDiagram::propertiesChanged().

void AbstractDiagram::setDataValueAttributes ( const DataValueAttributes & a )

inherited

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 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

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, 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

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, 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

hidden The hidden status to set.

Definition at line 279 of file KDChartAbstractDiagram.cpp.

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

void Plotter::setLineAttributes ( const LineAttributes & a )

Sets the global line attributes to la.

Definition at line 223 of file KDChartPlotter.cpp.

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

void Plotter::setLineAttributes	(	int	column,
		const LineAttributes &	a
	)

Sets the line attributes of data set column to la.

Definition at line 232 of file KDChartPlotter.cpp.

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

void Plotter::setLineAttributes	(	const QModelIndex &	index,
		const LineAttributes &	a
	)

Sets the line attributes for the model index index to la.

Definition at line 250 of file KDChartPlotter.cpp.

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

void Plotter::setMaxSlopeChange ( qreal value )

Definition at line 156 of file KDChartPlotter.cpp.

References d, and mergeRadiusPercentage().

void Plotter::setMergeRadiusPercentage ( qreal value )

Definition at line 166 of file KDChartPlotter.cpp.

References d.

void AbstractCartesianDiagram::setModel ( QAbstractItemModel * model )

overrideinherited

Definition at line 169 of file KDChartAbstractCartesianDiagram.cpp.

References KDChart::AbstractDiagram::setModel().

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

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

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 KDChart::AbstractDiagram::attributesModel(), KDChart::DatasetPenRole, KDChart::AbstractDiagram::propertiesChanged(), and KDChart::AttributesModel::setData().

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

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

inherited

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 KDChart::AbstractDiagram::propertiesChanged().

void AbstractDiagram::setPen ( const QPen & pen )

inherited

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

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

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

void AbstractCartesianDiagram::setReferenceDiagram	(	AbstractCartesianDiagram *	diagram,
		const QPointF &	offset = `QPointF()`
	)

virtualinherited

Makes this diagram use another diagram diagram as reference diagram with relative offset offset.

To share cartesian axes between different diagrams there might be cases when you need that. Normally you don't.

See also: examples/SharedAbscissa

Definition at line 147 of file KDChartAbstractCartesianDiagram.cpp.

References d.

void AbstractCartesianDiagram::setRootIndex ( const QModelIndex & index )

overrideinherited

Definition at line 163 of file KDChartAbstractCartesianDiagram.cpp.

References KDChart::AbstractDiagram::attributesModel(), d, and KDChart::AbstractDiagram::setRootIndex().

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

overrideinherited

[reimplemented]

Definition at line 839 of file KDChartAbstractDiagram.cpp.

References d.

void AbstractDiagram::setSelectionModel ( QItemSelectionModel * selectionModel )

overrideinherited

Associate a seleection model with the diagrom.

Definition at line 150 of file KDChartAbstractDiagram.cpp.

References KDChart::AbstractDiagram::modelsChanged().

void Plotter::setThreeDLineAttributes ( const ThreeDLineAttributes & a )

Sets the global 3D line attributes to la.

Definition at line 298 of file KDChartPlotter.cpp.

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

void Plotter::setThreeDLineAttributes	(	int	column,
		const ThreeDLineAttributes &	a
	)

Sets the 3D line attributes of data set column to la.

Definition at line 308 of file KDChartPlotter.cpp.

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

void Plotter::setThreeDLineAttributes	(	const QModelIndex &	index,
		const ThreeDLineAttributes &	a
	)

Sets the 3D line attributes of model index index to la.

Definition at line 318 of file KDChartPlotter.cpp.

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

void Plotter::setType ( const PlotType type )

Sets the plotter's type to type.

Definition at line 179 of file KDChartPlotter.cpp.

References KDChart::AbstractDiagram::boundariesChanged(), d, KDChart::AbstractDiagram::datasetDimension(), KDChart::AbstractDiagram::layoutChanged(), Normal, Percent, KDChart::AbstractDiagram::propertiesChanged(), setDataBoundariesDirty(), and type().

Referenced by clone().

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

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
	)

inherited

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
	)

inherited

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
	)

inherited

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.

void Plotter::setUseDataCompression ( Plotter::CompressionMode value )

Definition at line 137 of file KDChartPlotter.cpp.

References KDChart::AbstractDiagram::attributesModel(), d, NONE, and useDataCompression().

void Plotter::setValueTrackerAttributes	(	const QModelIndex &	index,
		const ValueTrackerAttributes &	a
	)

Sets the value tracker attributes of the model index index to va.

Definition at line 368 of file KDChartPlotter.cpp.

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

void AbstractCartesianDiagram::takeAxis ( CartesianAxis * axis )

virtualinherited

Removes the axis from the diagram, without deleting it.

The diagram no longer owns the axis, so it is the caller's responsibility to delete the axis.

See also: addAxis

Definition at line 93 of file KDChartAbstractCartesianDiagram.cpp.

References d, KDChart::AbstractAxis::deleteObserver(), KDChart::AbstractCartesianDiagram::layoutPlanes(), and KDChart::AbstractLayoutItem::setParentWidget().

Referenced by KDChart::Widget::setType(), KDChart::CartesianAxis::~CartesianAxis(), and KDChart::LeveyJenningsAxis::~LeveyJenningsAxis().

qreal Plotter::threeDItemDepth ( const QModelIndex & index ) const

overrideprotectedvirtual

Returns: the 3D item depth of the model index index

Implements KDChart::AbstractCartesianDiagram.

Definition at line 355 of file KDChartPlotter.cpp.

References threeDLineAttributes(), and KDChart::AbstractThreeDAttributes::validDepth().

qreal Plotter::threeDItemDepth ( int column ) const

overrideprotectedvirtual

Returns: the 3D item depth of the data set column

Implements KDChart::AbstractCartesianDiagram.

Definition at line 360 of file KDChartPlotter.cpp.

References threeDLineAttributes(), and KDChart::AbstractThreeDAttributes::validDepth().

ThreeDLineAttributes Plotter::threeDLineAttributes ( ) const

Returns: the global 3D line attributes

Definition at line 329 of file KDChartPlotter.cpp.

References d, and KDChart::ThreeDLineAttributesRole.

Referenced by threeDItemDepth(), and threeDLineAttributes().

ThreeDLineAttributes Plotter::threeDLineAttributes ( int column ) const

Returns: the 3D line attributes of data set column

Definition at line 337 of file KDChartPlotter.cpp.

References d, threeDLineAttributes(), and KDChart::ThreeDLineAttributesRole.

ThreeDLineAttributes Plotter::threeDLineAttributes ( const QModelIndex & index ) const

Returns: the 3D line attributes of the model index index

Definition at line 349 of file KDChartPlotter.cpp.

References d, and KDChart::ThreeDLineAttributesRole.

Plotter::PlotType Plotter::type ( ) const

Returns: the type of the plotter

Definition at line 215 of file KDChartPlotter.cpp.

References d.

Referenced by clone(), compare(), and setType().

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

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 KDChart::AbstractDiagram::itemRowLabels(), and KDChart::CartesianAxis::paint().

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

inherited

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

inherited

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