KD Chart API Documentation  3.1
Public Types | Public Member Functions | Protected Member Functions | List of all members
KDChart::PieDiagram Class Reference

PieDiagram defines a common pie diagram. More...

#include <KDChartPieDiagram.h>

Inheritance diagram for KDChart::PieDiagram:
KDChart::AbstractPieDiagram KDChart::AbstractPolarDiagram KDChart::AbstractDiagram

Public Types

enum  LabelDecoration { NoDecoration = 0 , FrameDecoration = 1 , LineFromSliceDecoration = 2 }
 

Public Member Functions

 PieDiagram (QWidget *parent=nullptr, PolarCoordinatePlane *plane=nullptr)
 
 ~PieDiagram () override
 
virtual PieDiagramclone () const
 
bool isLabelCollisionAvoidanceEnabled () const
 Return whether overlapping labels will be moved to until they don't overlap anymore. More...
 
LabelDecorations labelDecorations () const
 Return the decorations to be painted around data labels. More...
 
qreal numberOfGridRings () const override
 
qreal numberOfValuesPerDataset () const override
 
void resize (const QSizeF &area) override
 
void setLabelCollisionAvoidanceEnabled (bool enabled)
 
void setLabelDecorations (LabelDecorations decorations)
 Set the decorations to be painted around data labels according to decorations. More...
 
qreal valueTotals () const override
 
- Public Member Functions inherited from KDChart::AbstractPieDiagram
 AbstractPieDiagram (QWidget *parent=nullptr, PolarCoordinatePlane *plane=nullptr)
 
 ~AbstractPieDiagram () override
 
bool autoRotateLabels () const
 
bool compare (const AbstractPieDiagram *other) const
 
qreal granularity () const
 
PieAttributes pieAttributes () const
 
PieAttributes pieAttributes (const QModelIndex &index) const
 
PieAttributes pieAttributes (int column) const
 
void setAutoRotateLabels (bool autoRotate)
 
void setGranularity (qreal value)
 
void setPieAttributes (const PieAttributes &a)
 
void setPieAttributes (const QModelIndex &index, const PieAttributes &a)
 
void setPieAttributes (int column, const PieAttributes &a)
 
Q_DECL_DEPRECATED void setStartPosition (int degrees)
 
void setThreeDPieAttributes (const QModelIndex &index, const ThreeDPieAttributes &a)
 
void setThreeDPieAttributes (const ThreeDPieAttributes &a)
 
void setThreeDPieAttributes (int column, const ThreeDPieAttributes &a)
 
Q_DECL_DEPRECATED int startPosition () const
 
ThreeDPieAttributes threeDPieAttributes () const
 
ThreeDPieAttributes threeDPieAttributes (const QModelIndex &index) const
 
ThreeDPieAttributes threeDPieAttributes (int column) const
 
- Public Member Functions inherited from KDChart::AbstractPolarDiagram
 AbstractPolarDiagram (QWidget *parent=nullptr, PolarCoordinatePlane *plane=nullptr)
 
 ~AbstractPolarDiagram () override
 
int columnCount () const
 
virtual qreal numberOfDatasets () const
 
const PolarCoordinatePlanepolarCoordinatePlane () const
 
int rowCount () const
 
- Public Member Functions inherited from KDChart::AbstractDiagram
 ~AbstractDiagram () override
 
bool allowOverlappingDataValueTexts () const
 
bool antiAliasing () const
 
virtual AttributesModelattributesModel () const
 
QBrush brush () const
 
QBrush brush (const QModelIndex &index) const
 
QBrush brush (int dataset) const
 
bool compare (const AbstractDiagram *other) const
 
AbstractCoordinatePlanecoordinatePlane () const
 
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...
 
void dataChanged (const QModelIndex &topLeft, const QModelIndex &bottomRight, const QVector< int > &roles=QVector< int >()) override
 
QList< QBrush > datasetBrushes () const
 
int datasetDimension () const
 
QStringList datasetLabels () const
 
QList< MarkerAttributesdatasetMarkers () const
 
QList< QPen > datasetPens () const
 
DataValueAttributes dataValueAttributes () const
 
DataValueAttributes dataValueAttributes (const QModelIndex &index) const
 
DataValueAttributes dataValueAttributes (int dataset) const
 
void doItemsLayout () override
 
int horizontalOffset () const override
 
QModelIndex indexAt (const QPoint &point) const override
 
QModelIndexList indexesAt (const QPoint &point) const
 
QModelIndexList indexesIn (const QRect &rect) const
 
bool isHidden () const
 
bool isHidden (const QModelIndex &index) const
 
bool isHidden (int dataset) const
 
bool isIndexHidden (const QModelIndex &index) const override
 
QStringList itemRowLabels () const
 
QModelIndex moveCursor (CursorAction cursorAction, Qt::KeyboardModifiers modifiers) override
 
void paintDataValueText (QPainter *painter, const QModelIndex &index, const QPointF &pos, qreal value)
 
void paintMarker (QPainter *painter, const DataValueAttributes &a, const QModelIndex &index, const QPointF &pos)
 
virtual void paintMarker (QPainter *painter, const MarkerAttributes &markerAttributes, const QBrush &brush, const QPen &, const QPointF &point, const QSizeF &size)
 
void paintMarker (QPainter *painter, const QModelIndex &index, const QPointF &pos)
 
QPen pen () const
 
QPen pen (const QModelIndex &index) const
 
QPen pen (int dataset) const
 
bool percentMode () const
 Returns whether this diagram is drawn in percent mode. More...
 
void scrollTo (const QModelIndex &index, ScrollHint hint=EnsureVisible) override
 
void setAllowOverlappingDataValueTexts (bool allow)
 
void setAntiAliasing (bool enabled)
 
virtual void setAttributesModel (AttributesModel *model)
 Sets an external AttributesModel on this diagram. More...
 
void setBrush (const QBrush &brush)
 
void setBrush (const QModelIndex &index, const QBrush &brush)
 
void setBrush (int dataset, const QBrush &brush)
 
virtual void setCoordinatePlane (AbstractCoordinatePlane *plane)
 
Q_DECL_DEPRECATED void setDatasetDimension (int dimension)
 
void setDataValueAttributes (const DataValueAttributes &a)
 
void setDataValueAttributes (const QModelIndex &index, const DataValueAttributes &a)
 
void setDataValueAttributes (int dataset, const DataValueAttributes &a)
 
void setHidden (bool hidden)
 
void setHidden (const QModelIndex &index, bool hidden)
 
void setHidden (int dataset, bool hidden)
 
void setModel (QAbstractItemModel *model) override
 
void setPen (const QModelIndex &index, const QPen &pen)
 
void setPen (const QPen &pen)
 
void setPen (int dataset, const QPen &pen)
 
Q_DECL_DEPRECATED void setPercentMode (bool percent)
 Deprecated method that turns the percent mode of this diagram on or off. More...
 
void setRootIndex (const QModelIndex &idx) override
 Reimplemented for internal purposes. More...
 
void setSelection (const QRect &rect, QItemSelectionModel::SelectionFlags command) override
 
void setSelectionModel (QItemSelectionModel *selectionModel) override
 
void setUnitPrefix (const QString &prefix, int column, Qt::Orientation orientation)
 
void setUnitPrefix (const QString &prefix, Qt::Orientation orientation)
 
void setUnitSuffix (const QString &suffix, int column, Qt::Orientation orientation)
 
void setUnitSuffix (const QString &suffix, Qt::Orientation orientation)
 
QString unitPrefix (int column, Qt::Orientation orientation, bool fallback=false) const
 
QString unitPrefix (Qt::Orientation orientation) const
 
QString unitSuffix (int column, Qt::Orientation orientation, bool fallback=false) const
 
QString unitSuffix (Qt::Orientation orientation) const
 
void update () const
 
void useDefaultColors ()
 
void useRainbowColors ()
 
virtual bool usesExternalAttributesModel () const
 
void useSubduedColors ()
 
int verticalOffset () const override
 
QRect visualRect (const QModelIndex &index) const override
 
virtual QRegion visualRegion (const QModelIndex &index) const
 
QRegion visualRegionForSelection (const QItemSelection &selection) const override
 

Protected Member Functions

const QPair< QPointF, QPointF > calculateDataBoundaries () const override
 
void paint (PaintContext *paintContext) override
 
void paintEvent (QPaintEvent *) override
 
void resizeEvent (QResizeEvent *) override
 
- Protected Member Functions inherited from KDChart::AbstractDiagram
 AbstractDiagram (Private *p, QWidget *parent, AbstractCoordinatePlane *plane)
 
 AbstractDiagram (QWidget *parent=nullptr, AbstractCoordinatePlane *plane=nullptr)
 
QModelIndex attributesModelRootIndex () const
 returns a QModelIndex pointing into the AttributesModel that corresponds to the root index of the diagram. More...
 
virtual bool checkInvariants (bool justReturnTheStatus=false) const
 
virtual Q_DECL_DEPRECATED void paintDataValueTexts (QPainter *painter)
 
virtual Q_DECL_DEPRECATED void paintMarkers (QPainter *painter)
 
void setAttributesModelRootIndex (const QModelIndex &)
 
void setDatasetDimensionInternal (int dimension)
 
Q_DECL_DEPRECATED qreal valueForCell (int row, int column) const
 

Additional Inherited Members

- Signals inherited from KDChart::AbstractDiagram
void aboutToBeDestroyed ()
 
void attributesModelAboutToChange (AttributesModel *newModel, AttributesModel *oldModel)
 
void boundariesChanged ()
 
void dataHidden ()
 
void layoutChanged (AbstractDiagram *)
 
void modelDataChanged ()
 
void modelsChanged ()
 
void propertiesChanged ()
 
void viewportCoordinateSystemChanged ()
 
- Protected Slots inherited from KDChart::AbstractDiagram
void setDataBoundariesDirty () const
 

Detailed Description

PieDiagram defines a common pie diagram.

Definition at line 23 of file KDChartPieDiagram.h.

Member Enumeration Documentation

◆ LabelDecoration

Describes which decorations are painted around data labels.

Enumerator
NoDecoration 

No decoration.

FrameDecoration 

A rectangular frame is painted around the label text.

LineFromSliceDecoration 

A line is drawn from the pie slice to its label.

Definition at line 44 of file KDChartPieDiagram.h.

Constructor & Destructor Documentation

◆ PieDiagram()

PieDiagram::PieDiagram ( QWidget *  parent = nullptr,
PolarCoordinatePlane plane = nullptr 
)
explicit

Definition at line 39 of file KDChartPieDiagram.cpp.

Referenced by clone().

◆ ~PieDiagram()

PieDiagram::~PieDiagram ( )
override

Definition at line 45 of file KDChartPieDiagram.cpp.

Member Function Documentation

◆ calculateDataBoundaries()

const QPair< QPointF, QPointF > PieDiagram::calculateDataBoundaries ( ) const
overrideprotectedvirtual

◆ clone()

PieDiagram * PieDiagram::clone ( ) const
virtual

Creates an exact copy of this diagram.

Definition at line 56 of file KDChartPieDiagram.cpp.

References PieDiagram(), and d.

◆ isLabelCollisionAvoidanceEnabled()

bool PieDiagram::isLabelCollisionAvoidanceEnabled ( ) const

Return whether overlapping labels will be moved to until they don't overlap anymore.

Definition at line 76 of file KDChartPieDiagram.cpp.

References d.

◆ labelDecorations()

PieDiagram::LabelDecorations PieDiagram::labelDecorations ( ) const

Return the decorations to be painted around data labels.

Definition at line 66 of file KDChartPieDiagram.cpp.

References d.

◆ numberOfGridRings()

qreal PieDiagram::numberOfGridRings ( ) const
overridevirtual

Reimplemented for internal purposes.

Implements KDChart::AbstractPolarDiagram.

Definition at line 947 of file KDChartPieDiagram.cpp.

◆ numberOfValuesPerDataset()

qreal PieDiagram::numberOfValuesPerDataset ( ) const
overridevirtual

Reimplemented for internal purposes.

Implements KDChart::AbstractPolarDiagram.

Definition at line 941 of file KDChartPieDiagram.cpp.

◆ paint()

void PieDiagram::paint ( PaintContext paintContext)
overrideprotectedvirtual

Reimplemented for internal purposes.

Implements KDChart::AbstractDiagram.

Definition at line 122 of file KDChartPieDiagram.cpp.

Referenced by paintEvent().

◆ paintEvent()

void PieDiagram::paintEvent ( QPaintEvent *  )
overrideprotected

◆ resize()

void PieDiagram::resize ( const QSizeF &  area)
overridevirtual

Reimplemented for internal purposes.

Implements KDChart::AbstractDiagram.

Definition at line 118 of file KDChartPieDiagram.cpp.

◆ resizeEvent()

void PieDiagram::resizeEvent ( QResizeEvent *  )
overrideprotected

Definition at line 114 of file KDChartPieDiagram.cpp.

◆ setLabelCollisionAvoidanceEnabled()

void PieDiagram::setLabelCollisionAvoidanceEnabled ( bool  enabled)

If enabled is set to true, labels that would overlap will be shuffled to avoid overlap.

Note
Collision avoidance may allow labels to be closer than AbstractDiagram with allowOverlappingDataValueTexts() == false, so you should usually also call setAllowOverlappingDataValueTexts( true ) if you enable this feature.

Definition at line 71 of file KDChartPieDiagram.cpp.

References d.

◆ setLabelDecorations()

void PieDiagram::setLabelDecorations ( LabelDecorations  decorations)

Set the decorations to be painted around data labels according to decorations.

Definition at line 61 of file KDChartPieDiagram.cpp.

References d.

◆ valueTotals()

qreal PieDiagram::valueTotals ( ) const
overridevirtual

Reimplemented for internal purposes.

Implements KDChart::AbstractPolarDiagram.

Definition at line 927 of file KDChartPieDiagram.cpp.

References KDChart::AbstractPolarDiagram::columnCount(), and KDChart::AbstractPolarDiagram::rowCount().


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

© 2001 Klarälvdalens Datakonsult AB (KDAB)
"The Qt, C++ and OpenGL Experts"
https://www.kdab.com/
https://www.kdab.com/development-resources/qt-tools/kd-chart/
Generated by doxygen 1.9.1