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

BarDiagram defines a common bar diagram. More...

#include <KDChartBarDiagram.h>

Inheritance diagram for KDChart::BarDiagram:
KDChart::AbstractCartesianDiagram KDChart::AbstractDiagram

Public Types

enum  BarType { Normal , Stacked , Percent , Q_DECL_ENUMERATOR_DEPRECATED }
 

Public Member Functions

 BarDiagram (QWidget *parent=nullptr, CartesianCoordinatePlane *plane=nullptr)
 
 ~BarDiagram () override
 
BarAttributes barAttributes () const
 
BarAttributes barAttributes (const QModelIndex &index) const
 
BarAttributes barAttributes (int column) const
 
virtual BarDiagramclone () const
 
bool compare (const BarDiagram *other) const
 
int numberOfAbscissaSegments () const override
 
int numberOfOrdinateSegments () const override
 
Qt::Orientation orientation () const
 
void resize (const QSizeF &area) override
 
void setBarAttributes (const BarAttributes &a)
 
void setBarAttributes (const QModelIndex &index, const BarAttributes &a)
 
void setBarAttributes (int column, const BarAttributes &a)
 
void setOrientation (Qt::Orientation orientation)
 
void setThreeDBarAttributes (const QModelIndex &index, const ThreeDBarAttributes &a)
 
void setThreeDBarAttributes (const ThreeDBarAttributes &a)
 
void setThreeDBarAttributes (int column, const ThreeDBarAttributes &a)
 
void setType (const BarType type)
 
ThreeDBarAttributes threeDBarAttributes () const
 
ThreeDBarAttributes threeDBarAttributes (const QModelIndex &index) const
 
ThreeDBarAttributes threeDBarAttributes (int column) const
 
BarType type () const
 
- Public Member Functions inherited from KDChart::AbstractCartesianDiagram
 AbstractCartesianDiagram (QWidget *parent=nullptr, CartesianCoordinatePlane *plane=nullptr)
 
 ~AbstractCartesianDiagram () override
 
virtual void addAxis (CartesianAxis *axis)
 
virtual KDChart::CartesianAxisList axes () const
 
bool compare (const AbstractCartesianDiagram *other) const
 
virtual void layoutPlanes ()
 
virtual AbstractCartesianDiagramreferenceDiagram () const
 
virtual QPointF referenceDiagramOffset () const
 
void setAttributesModel (AttributesModel *amodel) override
 Sets an external AttributesModel on this diagram. More...
 
void setCoordinatePlane (AbstractCoordinatePlane *plane) override
 
void setModel (QAbstractItemModel *model) override
 
virtual void setReferenceDiagram (AbstractCartesianDiagram *diagram, const QPointF &offset=QPointF())
 
void setRootIndex (const QModelIndex &index) override
 
virtual void takeAxis (CartesianAxis *axis)
 
- 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)
 
void setBrush (const QBrush &brush)
 
void setBrush (const QModelIndex &index, const QBrush &brush)
 
void setBrush (int dataset, const QBrush &brush)
 
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
 
qreal threeDItemDepth (const QModelIndex &index) const override
 
qreal threeDItemDepth (int column) const 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::AbstractCartesianDiagram
void connectAttributesModel (AttributesModel *)
 
- Protected Slots inherited from KDChart::AbstractDiagram
void setDataBoundariesDirty () const
 

Detailed Description

BarDiagram defines a common bar diagram.

It provides different subtypes which are set using setType.

Definition at line 30 of file KDChartBarDiagram.h.

Member Enumeration Documentation

◆ BarType

Enumerator
Normal 
Stacked 
Percent 
Q_DECL_ENUMERATOR_DEPRECATED 
Deprecated:
Use BarDiagram::setOrientation() instead

Definition at line 52 of file KDChartBarDiagram.h.

Constructor & Destructor Documentation

◆ BarDiagram()

BarDiagram::BarDiagram ( QWidget *  parent = nullptr,
CartesianCoordinatePlane plane = nullptr 
)
explicit

Definition at line 98 of file KDChartBarDiagram.cpp.

Referenced by clone().

◆ ~BarDiagram()

BarDiagram::~BarDiagram ( )
override

Definition at line 116 of file KDChartBarDiagram.cpp.

Member Function Documentation

◆ barAttributes() [1/3]

BarAttributes BarDiagram::barAttributes ( ) const
Returns
the global bar attribute set

Definition at line 210 of file KDChartBarDiagram.cpp.

References KDChart::BarAttributesRole, and d.

Referenced by barAttributes().

◆ barAttributes() [2/3]

BarAttributes BarDiagram::barAttributes ( const QModelIndex &  index) const
Returns
the bar attribute set of the model index index

Definition at line 229 of file KDChartBarDiagram.cpp.

References KDChart::BarAttributesRole, and d.

◆ barAttributes() [3/3]

BarAttributes BarDiagram::barAttributes ( int  column) const
Returns
the bar attribute set of data set column

Definition at line 218 of file KDChartBarDiagram.cpp.

References barAttributes(), KDChart::BarAttributesRole, and d.

◆ calculateDataBoundaries()

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

Reimplemented for internal purposes.

Implements KDChart::AbstractDiagram.

Definition at line 317 of file KDChartBarDiagram.cpp.

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

◆ clone()

BarDiagram * BarDiagram::clone ( ) const
virtual

Creates an exact copy of this diagram.

Definition at line 123 of file KDChartBarDiagram.cpp.

References BarDiagram(), d, and type().

◆ compare()

bool BarDiagram::compare ( const BarDiagram other) const

Returns true if both diagrams have the same settings.

Definition at line 130 of file KDChartBarDiagram.cpp.

References type().

◆ numberOfAbscissaSegments()

int BarDiagram::numberOfAbscissaSegments ( ) const
overridevirtual

Reimplemented for internal purposes.

Implements KDChart::AbstractCartesianDiagram.

Definition at line 384 of file KDChartBarDiagram.cpp.

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

◆ numberOfOrdinateSegments()

int BarDiagram::numberOfOrdinateSegments ( ) const
overridevirtual

Reimplemented for internal purposes.

Implements KDChart::AbstractCartesianDiagram.

Definition at line 393 of file KDChartBarDiagram.cpp.

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

◆ orientation()

Qt::Orientation BarDiagram::orientation ( ) const
Returns
the orientation of the bar diagram

Definition at line 172 of file KDChartBarDiagram.cpp.

References d.

Referenced by setOrientation().

◆ paint()

void BarDiagram::paint ( PaintContext paintContext)
overrideprotectedvirtual

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

Parameters
paintContextAll information needed for painting.

Implements KDChart::AbstractDiagram.

Definition at line 342 of file KDChartBarDiagram.cpp.

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

Referenced by paintEvent().

◆ paintEvent()

void BarDiagram::paintEvent ( QPaintEvent *  )
overrideprotected

◆ resize()

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

Called by the widget's sizeEvent. Adjust all internal structures, that are calculated, depending on the size of the widget.

Parameters
areaSize of the widget

Implements KDChart::AbstractDiagram.

Definition at line 372 of file KDChartBarDiagram.cpp.

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

◆ resizeEvent()

void BarDiagram::resizeEvent ( QResizeEvent *  )
overrideprotected

Definition at line 313 of file KDChartBarDiagram.cpp.

◆ setBarAttributes() [1/3]

void BarDiagram::setBarAttributes ( const BarAttributes ba)

Sets the global bar attributes to ba

Definition at line 180 of file KDChartBarDiagram.cpp.

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

◆ setBarAttributes() [2/3]

void BarDiagram::setBarAttributes ( const QModelIndex &  index,
const BarAttributes ba 
)

◆ setBarAttributes() [3/3]

void BarDiagram::setBarAttributes ( int  column,
const BarAttributes ba 
)

Sets the bar attributes of data set column to ba

Definition at line 189 of file KDChartBarDiagram.cpp.

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

◆ setOrientation()

void BarDiagram::setOrientation ( Qt::Orientation  orientation)

Sets the orientation of the bar diagram

Definition at line 164 of file KDChartBarDiagram.cpp.

References d, and orientation().

◆ setThreeDBarAttributes() [1/3]

void BarDiagram::setThreeDBarAttributes ( const QModelIndex &  index,
const ThreeDBarAttributes threeDAttrs 
)

Sets the 3D line attributes of model index index to threeDAttrs

Definition at line 262 of file KDChartBarDiagram.cpp.

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

◆ setThreeDBarAttributes() [2/3]

void BarDiagram::setThreeDBarAttributes ( const ThreeDBarAttributes threeDAttrs)

◆ setThreeDBarAttributes() [3/3]

void BarDiagram::setThreeDBarAttributes ( int  column,
const ThreeDBarAttributes threeDAttrs 
)

Sets the 3D bar attributes of dataset column to threeDAttrs

Definition at line 251 of file KDChartBarDiagram.cpp.

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

◆ setType()

void BarDiagram::setType ( const BarType  type)

Sets the bar diagram's type to type

See also
BarDiagram::BarType

Definition at line 148 of file KDChartBarDiagram.cpp.

References d, and type().

◆ threeDBarAttributes() [1/3]

ThreeDBarAttributes BarDiagram::threeDBarAttributes ( ) const
Returns
the global 3D bar attributes

Definition at line 276 of file KDChartBarDiagram.cpp.

References d, and KDChart::ThreeDBarAttributesRole.

Referenced by threeDBarAttributes(), and threeDItemDepth().

◆ threeDBarAttributes() [2/3]

ThreeDBarAttributes BarDiagram::threeDBarAttributes ( const QModelIndex &  index) const
Returns
the 3D bar attributes of the model index index

Definition at line 295 of file KDChartBarDiagram.cpp.

References d, and KDChart::ThreeDBarAttributesRole.

◆ threeDBarAttributes() [3/3]

ThreeDBarAttributes BarDiagram::threeDBarAttributes ( int  column) const
Returns
the 3D bar attributes of data set column

Definition at line 284 of file KDChartBarDiagram.cpp.

References d, threeDBarAttributes(), and KDChart::ThreeDBarAttributesRole.

◆ threeDItemDepth() [1/2]

qreal BarDiagram::threeDItemDepth ( const QModelIndex &  index) const
overrideprotectedvirtual
Returns
the 3D item depth of the model index index

Implements KDChart::AbstractCartesianDiagram.

Definition at line 303 of file KDChartBarDiagram.cpp.

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

◆ threeDItemDepth() [2/2]

qreal BarDiagram::threeDItemDepth ( int  column) const
overrideprotectedvirtual
Returns
the 3D item depth of the data set column

Implements KDChart::AbstractCartesianDiagram.

Definition at line 308 of file KDChartBarDiagram.cpp.

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

◆ type()

BarDiagram::BarType BarDiagram::type ( ) const
Returns
the type of the bar diagram

Definition at line 156 of file KDChartBarDiagram.cpp.

References d.

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


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