KD Chart 2  [rev.2.7]
Public Types | Public Slots | Signals | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
KDChart::TernaryCoordinatePlane Class Reference

Ternary coordinate plane. More...

#include <KDChartTernaryCoordinatePlane.h>

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

Public Types

enum  AxesCalcMode {
  Linear,
  Logarithmic
}
 

Public Slots

void layoutPlanes ()
 Calling layoutPlanes() on the plane triggers the global KDChart::Chart::slotLayoutPlanes() More...
 
void relayout ()
 Calling relayout() on the plane triggers the global KDChart::Chart::slotRelayout() More...
 
void setGridNeedsRecalculate ()
 Used by the chart to clear the cached grid data. More...
 
void update ()
 Calling update() on the plane triggers the global KDChart::Chart::update() More...
 

Signals

void boundariesChanged ()
 
void destroyedCoordinatePlane (AbstractCoordinatePlane *)
 Emitted when this coordinate plane is destroyed. More...
 
void geometryChanged (QRect, QRect)
 Emitted after the geometry of the Coordinate Plane has been changed. More...
 
void internal_geometryChanged (QRect, QRect)
 
void needLayoutPlanes ()
 Emitted when plane needs to trigger the Chart's layouting of the coord. More...
 
void needRelayout ()
 Emitted when plane needs to trigger the Chart's layouting. More...
 
void needUpdate ()
 Emitted when plane needs to update its drawings. More...
 
void positionChanged (AbstractArea *)
 
void propertiesChanged ()
 Emitted upon change of a property of the Coordinate Plane or any of its components. More...
 
void viewportCoordinateSystemChanged ()
 Emitted upon change of the view coordinate system. More...
 

Public Member Functions

void addDiagram (AbstractDiagram *diagram) override
 Adds a diagram to this coordinate plane. More...
 
void alignToReferencePoint (const RelativePosition &position)
 
BackgroundAttributes backgroundAttributes () const
 
virtual int bottomOverlap (bool doNotRecalculate=false) const
 This is called at layout time by KDChart:AutoSpacerLayoutItem::sizeHint(). More...
 
bool compare (const AbstractAreaBase *other) const
 Returns true if both areas have the same settings. More...
 
AbstractDiagram * diagram ()
 
AbstractDiagramList diagrams ()
 
ConstAbstractDiagramList diagrams () const
 
Qt::Orientations expandingDirections () const override
 pure virtual in QLayoutItem More...
 
FrameAttributes frameAttributes () const
 
QRect geometry () const override
 pure virtual in QLayoutItem More...
 
DataDimensionsList getDataDimensionsList () const override
 
void getFrameLeadings (int &left, int &top, int &right, int &bottom) const
 
GridAttributes globalGridAttributes () const
 
DataDimensionsList gridDimensionsList ()
 Returns the dimensions used for drawing the grid lines. More...
 
bool isCornerSpacersEnabled () const
 
bool isEmpty () const override
 pure virtual in QLayoutItem More...
 
bool isRubberBandZoomingEnabled () const
 
const bool isVisiblePoint (const QPointF &point) const
 Tests, if a point is visible on the coordinate plane. More...
 
void layoutDiagrams () override
 Distribute the available space among the diagrams and axes. More...
 
virtual int leftOverlap (bool doNotRecalculate=false) const
 This is called at layout time by KDChart::AutoSpacerLayoutItem::sizeHint(). More...
 
QSize maximumSize () const override
 pure virtual in QLayoutItem More...
 
QSize minimumSize () const override
 pure virtual in QLayoutItem More...
 
QSize minimumSizeHint () const
 [reimplemented] More...
 
virtual void mouseDoubleClickEvent (QMouseEvent *event)
 
virtual void mouseMoveEvent (QMouseEvent *event)
 
virtual void mousePressEvent (QMouseEvent *event)
 
virtual void mouseReleaseEvent (QMouseEvent *event)
 
void paint (QPainter *) override
 
void paintAll (QPainter &painter) override
 Call paintAll, if you want the background and the frame to be drawn before the normal paint() is invoked automatically. More...
 
virtual void paintBackground (QPainter &painter, const QRect &rectangle)
 
virtual void paintCtx (PaintContext *context)
 Default impl: Paint the complete item using its layouted position and size. More...
 
virtual void paintFrame (QPainter &painter, const QRect &rectangle)
 
virtual void paintIntoRect (QPainter &painter, const QRect &rect)
 Draws the background and frame, then calls paint(). More...
 
Chart * parent ()
 
const Chart * parent () const
 
QLayout * parentLayout ()
 
AbstractCoordinatePlane * referenceCoordinatePlane () const
 There are two ways, in which planes can be caused to interact, in where they are put layouting wise: The first is the reference plane. More...
 
void removeFromParentLayout ()
 
virtual void replaceDiagram (AbstractDiagram *diagram, AbstractDiagram *oldDiagram=0)
 Replaces the old diagram, or appends the diagram, it there is none yet. More...
 
virtual int rightOverlap (bool doNotRecalculate=false) const
 This is called at layout time by KDChart::AutoSpacerLayoutItem::sizeHint(). More...
 
void setBackgroundAttributes (const BackgroundAttributes &a)
 
void setCornerSpacersEnabled (bool enable)
 Enables or disables the use of spacers in the plane corners. More...
 
void setFrameAttributes (const FrameAttributes &a)
 
void setGeometry (const QRect &r) override
 pure virtual in QLayoutItem More...
 
void setGlobalGridAttributes (const GridAttributes &)
 Set the grid attributes to be used by this coordinate plane. More...
 
void setParent (Chart *parent)
 Called internally by KDChart::Chart. More...
 
void setParentLayout (QLayout *lay)
 
virtual void setParentWidget (QWidget *widget)
 Inform the item about its widget: This enables the item, to trigger that widget's update, whenever the size of the item's contents has changed. More...
 
void setReferenceCoordinatePlane (AbstractCoordinatePlane *plane)
 Set another coordinate plane to be used as the reference plane for this one. More...
 
void setRubberBandZoomingEnabled (bool enable)
 Enables or disables zooming with a rubber band using the mouse. More...
 
virtual void setZoomCenter (const QPointF &center)
 Set the point (in value coordinates) to be used as the center point in zoom operations. More...
 
virtual void setZoomFactors (qreal factorX, qreal factorY)
 Sets both zoom factors in one go. More...
 
virtual void setZoomFactorX (qreal factor)
 Sets the zoom factor in horizontal direction, that is applied to all coordinate transformations. More...
 
virtual void setZoomFactorY (qreal factor)
 Sets the zoom factor in vertical direction, that is applied to all coordinate transformations. More...
 
virtual AbstractCoordinatePlane * sharedAxisMasterPlane (QPainter *p=0)
 
QSize sizeHint () const override
 pure virtual in QLayoutItem More...
 
virtual void sizeHintChanged () const
 Report changed size hint: ask the parent widget to recalculate the layout. More...
 
QSizePolicy sizePolicy () const
 [reimplemented] More...
 
virtual void takeDiagram (AbstractDiagram *diagram)
 Removes the diagram from the plane, without deleting it. More...
 
 TernaryCoordinatePlane (Chart *parent=0)
 
virtual int topOverlap (bool doNotRecalculate=false) const
 This is called at layout time by KDChart::AutoSpacerLayoutItem::sizeHint(). More...
 
const QPointF translate (const QPointF &diagramPoint) const override
 Translate the given point in value space coordinates to a position in pixel space. More...
 
virtual QPointF zoomCenter () const
 
virtual qreal zoomFactorX () const
 
virtual qreal zoomFactorY () const
 
 ~TernaryCoordinatePlane () override
 

Static Public Member Functions

static void paintBackgroundAttributes (QPainter &painter, const QRect &rectangle, const KDChart::BackgroundAttributes &attributes)
 
static void paintFrameAttributes (QPainter &painter, const QRect &rectangle, const KDChart::FrameAttributes &attributes)
 

Protected Member Functions

QRect areaGeometry () const override
 
QRect innerRect () const
 
void positionHasChanged () override
 

Protected Attributes

QWidget * mParent
 
QLayout * mParentLayout
 

Detailed Description

Ternary coordinate plane.

Definition at line 35 of file KDChartTernaryCoordinatePlane.h.

Member Enumeration Documentation

enum KDChart::AbstractCoordinatePlane::AxesCalcMode
inherited
Enumerator
Linear 
Logarithmic 

Definition at line 53 of file KDChartAbstractCoordinatePlane.h.

Constructor & Destructor Documentation

TernaryCoordinatePlane::TernaryCoordinatePlane ( Chart *  parent = 0)
explicit

Definition at line 45 of file KDChartTernaryCoordinatePlane.cpp.

TernaryCoordinatePlane::~TernaryCoordinatePlane ( )
override

Definition at line 50 of file KDChartTernaryCoordinatePlane.cpp.

Member Function Documentation

void TernaryCoordinatePlane::addDiagram ( AbstractDiagram *  diagram)
overridevirtual

Adds a diagram to this coordinate plane.

Parameters
diagramThe diagram to add.
See also
replaceDiagram, takeDiagram

Reimplemented from KDChart::AbstractCoordinatePlane.

Definition at line 58 of file KDChartTernaryCoordinatePlane.cpp.

References KDChart::AbstractCoordinatePlane::addDiagram().

void AbstractAreaBase::alignToReferencePoint ( const RelativePosition &  position)
inherited

Definition at line 81 of file KDChartAbstractAreaBase.cpp.

QRect AbstractArea::areaGeometry ( ) const
overrideprotectedvirtualinherited

Implements KDChart::AbstractAreaBase.

Definition at line 151 of file KDChartAbstractArea.cpp.

Referenced by KDChart::CartesianCoordinatePlane::drawingArea(), layoutDiagrams(), KDChart::PolarCoordinatePlane::layoutDiagrams(), paint(), KDChart::CartesianAxis::paint(), KDChart::AbstractArea::paintAll(), and KDChart::CartesianAxis::paintCtx().

BackgroundAttributes AbstractAreaBase::backgroundAttributes ( ) const
inherited

Definition at line 111 of file KDChartAbstractAreaBase.cpp.

References d.

Referenced by KDChart::AbstractAreaBase::compare(), and updateCommonBrush().

int AbstractArea::bottomOverlap ( bool  doNotRecalculate = false) const
virtualinherited

This is called at layout time by KDChart:AutoSpacerLayoutItem::sizeHint().

The method triggers AbstractArea::sizeHint() to find out the amount of overlap at the bottom edge of the area.

Note
The default implementation is not using any caching, it might make sense to implement a more sophisticated solution for derived classes that have complex work to do in sizeHint(). All we have here is a primitive flag to be set by the caller if it is sure that no sizeHint() needs to be called.

Definition at line 98 of file KDChartAbstractArea.cpp.

References d.

Referenced by KDChart::AutoSpacerLayoutItem::sizeHint().

void KDChart::AbstractCoordinatePlane::boundariesChanged ( )
signalinherited

Referenced by KDChart::AbstractCoordinatePlane::addDiagram(), KDChart::CartesianCoordinatePlane::setHorizontalRange(), and KDChart::CartesianCoordinatePlane::setVerticalRange().

bool AbstractAreaBase::compare ( const AbstractAreaBase *  other) const
inherited

Returns true if both areas have the same settings.

Definition at line 71 of file KDChartAbstractAreaBase.cpp.

References KDChart::AbstractAreaBase::backgroundAttributes(), and KDChart::AbstractAreaBase::frameAttributes().

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

void KDChart::AbstractCoordinatePlane::destroyedCoordinatePlane ( AbstractCoordinatePlane *  )
signalinherited

Emitted when this coordinate plane is destroyed.

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

AbstractDiagram * AbstractCoordinatePlane::diagram ( )
inherited
Returns
The first diagram associated with this coordinate plane.

Definition at line 130 of file KDChartAbstractCoordinatePlane.cpp.

References d.

Referenced by contains(), KDChart::Widget::diagram(), findSharingAxisDiagrams(), KDChart::CartesianCoordinatePlane::getRawDataBoundingRectFromDiagrams(), layoutDiagrams(), KDChart::PolarCoordinatePlane::layoutDiagrams(), numSignificantDecimalPlaces(), KDChart::CartesianCoordinatePlane::setGeometry(), KDChart::PolarCoordinatePlane::setStartPosition(), KDChart::Widget::setType(), and KDChart::CartesianCoordinatePlane::sharedAxisMasterPlane().

AbstractDiagramList AbstractCoordinatePlane::diagrams ( )
inherited
Returns
The list of diagrams associated with this coordinate plane.

Definition at line 140 of file KDChartAbstractCoordinatePlane.cpp.

References d.

Referenced by allAxisAnnotations(), KDChart::Chart::event(), findSharingAxisDiagrams(), KDChart::CartesianCoordinatePlane::getDataDimensionsList(), KDChart::CartesianCoordinatePlane::getRawDataBoundingRectFromDiagrams(), layoutDiagrams(), KDChart::PolarCoordinatePlane::layoutDiagrams(), KDChart::Chart::mouseDoubleClickEvent(), KDChart::Chart::mouseMoveEvent(), KDChart::Chart::mousePressEvent(), KDChart::Chart::mouseReleaseEvent(), paint(), KDChart::PolarCoordinatePlane::paint(), KDChart::CartesianCoordinatePlane::paint(), KDChart::CartesianCoordinatePlane::setAxesCalcModes(), and KDChart::CartesianCoordinatePlane::setGeometry().

ConstAbstractDiagramList AbstractCoordinatePlane::diagrams ( ) const
inherited
Returns
The list of diagrams associated with this coordinate plane.

Definition at line 145 of file KDChartAbstractCoordinatePlane.cpp.

References d.

Qt::Orientations KDChart::AbstractCoordinatePlane::expandingDirections ( ) const
overrideinherited

pure virtual in QLayoutItem

Definition at line 211 of file KDChartAbstractCoordinatePlane.cpp.

FrameAttributes AbstractAreaBase::frameAttributes ( ) const
inherited

Definition at line 97 of file KDChartAbstractAreaBase.cpp.

References d.

Referenced by KDChart::Legend::clone(), KDChart::AbstractAreaBase::compare(), and updateCommonBrush().

QRect KDChart::AbstractCoordinatePlane::geometry ( ) const
overrideinherited

pure virtual in QLayoutItem

Definition at line 248 of file KDChartAbstractCoordinatePlane.cpp.

References d.

Referenced by KDChart::Chart::mouseDoubleClickEvent(), KDChart::AbstractCoordinatePlane::mouseMoveEvent(), KDChart::Chart::mouseMoveEvent(), KDChart::Chart::mousePressEvent(), KDChart::AbstractCoordinatePlane::mouseReleaseEvent(), KDChart::Chart::mouseReleaseEvent(), KDChart::RadarDiagram::paint(), KDChart::PolarDiagram::paint(), KDChart::PolarCoordinatePlane::paint(), and KDChart::CartesianCoordinatePlane::setGeometry().

void KDChart::AbstractCoordinatePlane::geometryChanged ( QRect  ,
QRect   
)
signalinherited

Emitted after the geometry of the Coordinate Plane has been changed.

and control has returned to the event loop.

Parameters are the old geometry, the new geometry.

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

DataDimensionsList TernaryCoordinatePlane::getDataDimensionsList ( ) const
overridevirtual

Implements KDChart::AbstractCoordinatePlane.

Definition at line 181 of file KDChartTernaryCoordinatePlane.cpp.

References d.

void AbstractAreaBase::getFrameLeadings ( int &  left,
int &  top,
int &  right,
int &  bottom 
) const
inherited

Definition at line 213 of file KDChartAbstractAreaBase.cpp.

References d.

Referenced by KDChart::AbstractAreaBase::innerRect(), and KDChart::AbstractAreaWidget::paintAll().

GridAttributes KDChart::AbstractCoordinatePlane::globalGridAttributes ( ) const
inherited
Returns
The grid attributes used by this coordinate plane.
See also
setGlobalGridAttributes
CartesianCoordinatePlane::gridAttributes

Definition at line 163 of file KDChartAbstractCoordinatePlane.cpp.

References d.

Referenced by KDChart::PolarCoordinatePlane::gridAttributes(), and KDChart::CartesianCoordinatePlane::gridAttributes().

KDChart::DataDimensionsList KDChart::AbstractCoordinatePlane::gridDimensionsList ( )
inherited

Returns the dimensions used for drawing the grid lines.

Returned data is the result of (cached) grid calculations, so - if you need that information for your own tasks - make sure to call again this function after every data modification that has changed the data range, since grid calculation is based upon the data range, thus the grid start/end might have changed if the data was changed.

Note
Returned list will contain different numbers of DataDimension, depending on the kind of coordinate plane used. For CartesianCoordinatePlane two DataDimension are returned: the first representing grid lines in X direction (matching the Abscissa axes) and the second indicating vertical grid lines (or Ordinate axes, resp.).
Returns
The dimensions used for drawing the grid lines.
See also
DataDimension

Definition at line 168 of file KDChartAbstractCoordinatePlane.cpp.

References d.

Referenced by KDChart::CartesianCoordinatePlane::layoutDiagrams(), KDChart::CartesianAxis::maximumSize(), numSignificantDecimalPlaces(), and KDChart::PaintingHelpers::paintValueTracker().

QRect AbstractAreaBase::innerRect ( ) const
protectedinherited

Definition at line 225 of file KDChartAbstractAreaBase.cpp.

References KDChart::AbstractAreaBase::areaGeometry(), and KDChart::AbstractAreaBase::getFrameLeadings().

Referenced by KDChart::AbstractArea::paintAll(), and KDChart::TextArea::paintAll().

void KDChart::AbstractCoordinatePlane::internal_geometryChanged ( QRect  ,
QRect   
)
signalinherited

Referenced by KDChart::AbstractCoordinatePlane::setGeometry(), and KDChart::AbstractCoordinatePlane::~AbstractCoordinatePlane().

bool KDChart::AbstractCoordinatePlane::isCornerSpacersEnabled ( ) const
inherited
Returns
Whether this plane should have spacers in the corners formed by the presence of axes.

Definition at line 295 of file KDChartAbstractCoordinatePlane.cpp.

References d.

bool KDChart::AbstractCoordinatePlane::isEmpty ( ) const
overrideinherited

pure virtual in QLayoutItem

Definition at line 204 of file KDChartAbstractCoordinatePlane.cpp.

bool KDChart::AbstractCoordinatePlane::isRubberBandZoomingEnabled ( ) const
inherited
Returns
Whether zooming with a rubber band using the mouse is enabled.

Definition at line 282 of file KDChartAbstractCoordinatePlane.cpp.

References d.

const bool KDChart::AbstractCoordinatePlane::isVisiblePoint ( const QPointF &  point) const
inherited

Tests, if a point is visible on the coordinate plane.

Note
Before calling this function the point must have been translated into coordinate plane space.

Definition at line 426 of file KDChartAbstractCoordinatePlane.cpp.

References d.

void TernaryCoordinatePlane::layoutDiagrams ( )
overridevirtual

Distribute the available space among the diagrams and axes.

Implements KDChart::AbstractCoordinatePlane.

Definition at line 66 of file KDChartTernaryCoordinatePlane.cpp.

References KDChart::AbstractArea::areaGeometry(), d, KDChart::AbstractCoordinatePlane::diagram(), KDChart::AbstractCoordinatePlane::diagrams(), KDChart::TernaryAxis::requiredMargins(), TriangleHeight, and TriangleWidth.

void KDChart::AbstractCoordinatePlane::layoutPlanes ( )
slotinherited

Calling layoutPlanes() on the plane triggers the global KDChart::Chart::slotLayoutPlanes()

Definition at line 265 of file KDChartAbstractCoordinatePlane.cpp.

References KDChart::AbstractCoordinatePlane::needLayoutPlanes().

Referenced by KDChart::AbstractCoordinatePlane::addDiagram(), findSharingAxisDiagrams(), invalidateLayoutTree(), KDChart::AbstractCartesianDiagram::layoutPlanes(), KDChart::CartesianAxis::layoutPlanes(), KDChart::AbstractCoordinatePlane::replaceDiagram(), and KDChart::AbstractCoordinatePlane::takeDiagram().

int AbstractArea::leftOverlap ( bool  doNotRecalculate = false) const
virtualinherited

This is called at layout time by KDChart::AutoSpacerLayoutItem::sizeHint().

The method triggers AbstractArea::sizeHint() to find out the amount of overlap at the left edge of the area.

Note
The default implementation is not using any caching, it might make sense to implement a more sophisticated solution for derived classes that have complex work to do in sizeHint(). All we have here is a primitive flag to be set by the caller if it is sure that no sizeHint() needs to be called.

Definition at line 74 of file KDChartAbstractArea.cpp.

References d.

Referenced by KDChart::AutoSpacerLayoutItem::sizeHint().

QSize KDChart::AbstractCoordinatePlane::maximumSize ( ) const
overrideinherited

pure virtual in QLayoutItem

Definition at line 216 of file KDChartAbstractCoordinatePlane.cpp.

Referenced by KDChart::AbstractCoordinatePlane::sizeHint().

QSize KDChart::AbstractCoordinatePlane::minimumSize ( ) const
overrideinherited

pure virtual in QLayoutItem

Definition at line 223 of file KDChartAbstractCoordinatePlane.cpp.

QSize TernaryCoordinatePlane::minimumSizeHint ( ) const

[reimplemented]

Definition at line 141 of file KDChartTernaryCoordinatePlane.cpp.

void KDChart::AbstractCoordinatePlane::mouseDoubleClickEvent ( QMouseEvent *  event)
virtualinherited

Definition at line 340 of file KDChartAbstractCoordinatePlane.cpp.

References d, and KDChart::AbstractCoordinatePlane::mousePressEvent().

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

void KDChart::AbstractCoordinatePlane::mouseMoveEvent ( QMouseEvent *  event)
virtualinherited

Definition at line 407 of file KDChartAbstractCoordinatePlane.cpp.

References d, and KDChart::AbstractCoordinatePlane::geometry().

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

void KDChart::AbstractCoordinatePlane::mousePressEvent ( QMouseEvent *  event)
virtualinherited

Definition at line 300 of file KDChartAbstractCoordinatePlane.cpp.

References KDChart::ZoomParameters::center(), d, KDChart::AbstractCoordinatePlane::parent(), KDChart::AbstractCoordinatePlane::setZoomCenter(), KDChart::AbstractCoordinatePlane::setZoomFactorX(), KDChart::AbstractCoordinatePlane::setZoomFactorY(), KDChart::ZoomParameters::xFactor, and KDChart::ZoomParameters::yFactor.

Referenced by KDChart::AbstractCoordinatePlane::mouseDoubleClickEvent(), and KDChart::Chart::mousePressEvent().

void KDChart::AbstractCoordinatePlane::mouseReleaseEvent ( QMouseEvent *  event)
virtualinherited

Definition at line 354 of file KDChartAbstractCoordinatePlane.cpp.

References d, KDChart::AbstractCoordinatePlane::geometry(), KDChart::AbstractCoordinatePlane::setZoomCenter(), KDChart::AbstractCoordinatePlane::setZoomFactorX(), KDChart::AbstractCoordinatePlane::setZoomFactorY(), KDChart::AbstractCoordinatePlane::zoomCenter(), KDChart::AbstractCoordinatePlane::zoomFactorX(), and KDChart::AbstractCoordinatePlane::zoomFactorY().

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

void KDChart::AbstractCoordinatePlane::needLayoutPlanes ( )
signalinherited

Emitted when plane needs to trigger the Chart's layouting of the coord.

planes.

Referenced by KDChart::AbstractCoordinatePlane::layoutPlanes().

void KDChart::AbstractCoordinatePlane::needRelayout ( )
signalinherited

Emitted when plane needs to trigger the Chart's layouting.

Referenced by KDChart::AbstractCoordinatePlane::relayout(), and KDChart::AbstractCoordinatePlane::setCornerSpacersEnabled().

void KDChart::AbstractCoordinatePlane::needUpdate ( )
signalinherited

Emitted when plane needs to update its drawings.

Referenced by KDChart::AbstractCoordinatePlane::update().

void TernaryCoordinatePlane::paint ( QPainter *  painter)
overridevirtual

Implements KDChart::AbstractLayoutItem.

Definition at line 153 of file KDChartTernaryCoordinatePlane.cpp.

References KDChart::AbstractArea::areaGeometry(), d, KDChart::AbstractCoordinatePlane::diagrams(), KDChart::PaintContext::setCoordinatePlane(), KDChart::PaintContext::setPainter(), and KDChart::PaintContext::setRectangle().

void AbstractArea::paintAll ( QPainter &  painter)
overridevirtualinherited

Call paintAll, if you want the background and the frame to be drawn before the normal paint() is invoked automatically.

Reimplemented from KDChart::AbstractLayoutItem.

Reimplemented in KDChart::TernaryAxis.

Definition at line 120 of file KDChartAbstractArea.cpp.

References KDChart::AbstractArea::areaGeometry(), d, KDChart::AbstractAreaBase::innerRect(), KDChart::AbstractLayoutItem::paint(), KDChart::AbstractAreaBase::paintBackground(), and KDChart::AbstractAreaBase::paintFrame().

Referenced by KDChart::AbstractArea::paintIntoRect().

void AbstractAreaBase::paintBackground ( QPainter &  painter,
const QRect &  rectangle 
)
virtualinherited

Definition at line 189 of file KDChartAbstractAreaBase.cpp.

References d, and KDChart::AbstractAreaBase::paintBackgroundAttributes().

Referenced by KDChart::AbstractArea::paintAll(), KDChart::TextArea::paintAll(), and KDChart::AbstractAreaWidget::paintAll().

void AbstractAreaBase::paintBackgroundAttributes ( QPainter &  painter,
const QRect &  rectangle,
const KDChart::BackgroundAttributes &  attributes 
)
staticinherited

Definition at line 118 of file KDChartAbstractAreaBase.cpp.

References KDChart::BackgroundAttributes::BackgroundPixmapModeCentered, KDChart::BackgroundAttributes::BackgroundPixmapModeNone, KDChart::BackgroundAttributes::BackgroundPixmapModeScaled, KDChart::BackgroundAttributes::BackgroundPixmapModeStretched, KDChart::BackgroundAttributes::brush(), KDChart::BackgroundAttributes::isVisible(), KDChart::BackgroundAttributes::pixmap(), and KDChart::BackgroundAttributes::pixmapMode().

Referenced by findSharingAxisDiagrams(), and KDChart::AbstractAreaBase::paintBackground().

void KDChart::AbstractLayoutItem::paintCtx ( PaintContext *  context)
virtualinherited

Default impl: Paint the complete item using its layouted position and size.

Reimplemented in KDChart::CartesianAxis, KDChart::LeveyJenningsAxis, and KDChart::TernaryAxis.

Definition at line 72 of file KDChartLayoutItems.cpp.

References KDChart::AbstractLayoutItem::paint(), and KDChart::PaintContext::painter().

void AbstractAreaBase::paintFrame ( QPainter &  painter,
const QRect &  rectangle 
)
virtualinherited

Definition at line 205 of file KDChartAbstractAreaBase.cpp.

References d, and KDChart::AbstractAreaBase::paintFrameAttributes().

Referenced by KDChart::AbstractArea::paintAll(), KDChart::TextArea::paintAll(), and KDChart::AbstractAreaWidget::paintAll().

void AbstractAreaBase::paintFrameAttributes ( QPainter &  painter,
const QRect &  rectangle,
const KDChart::FrameAttributes &  attributes 
)
staticinherited

Definition at line 168 of file KDChartAbstractAreaBase.cpp.

References KDChart::FrameAttributes::cornerRadius(), KDChart::FrameAttributes::isVisible(), KDChart::FrameAttributes::pen(), and KDChart::PrintingParameters::scalePen().

Referenced by findSharingAxisDiagrams(), and KDChart::AbstractAreaBase::paintFrame().

void AbstractArea::paintIntoRect ( QPainter &  painter,
const QRect &  rect 
)
virtualinherited

Draws the background and frame, then calls paint().

In most cases there is no need to overwrite this method in a derived class, but you would overwrite AbstractLayoutItem::paint() instead.

Definition at line 108 of file KDChartAbstractArea.cpp.

References KDChart::AbstractArea::paintAll().

KDChart::Chart * KDChart::AbstractCoordinatePlane::parent ( )
inherited

Definition at line 198 of file KDChartAbstractCoordinatePlane.cpp.

References d.

Referenced by KDChart::AbstractCoordinatePlane::AbstractCoordinatePlane(), KDChart::CartesianAxis::maximumSize(), KDChart::AbstractCoordinatePlane::mousePressEvent(), KDChart::LeveyJenningsAxis::paintAsAbscissa(), KDChart::LeveyJenningsAxis::paintAsOrdinate(), KDChart::AbstractCoordinatePlane::setParent(), and KDChart::CartesianAxis::titleSize().

const KDChart::Chart * KDChart::AbstractCoordinatePlane::parent ( ) const
inherited

Definition at line 193 of file KDChartAbstractCoordinatePlane.cpp.

References d.

QLayout* KDChart::AbstractLayoutItem::parentLayout ( )
inherited

Definition at line 77 of file KDChartLayoutItems.h.

void KDChart::AbstractArea::positionChanged ( AbstractArea *  )
signalinherited

Referenced by KDChart::AbstractArea::positionHasChanged().

void AbstractArea::positionHasChanged ( )
overrideprotectedvirtualinherited

Reimplemented from KDChart::AbstractAreaBase.

Definition at line 156 of file KDChartAbstractArea.cpp.

References KDChart::AbstractArea::positionChanged().

void KDChart::AbstractCoordinatePlane::propertiesChanged ( )
signalinherited

Emitted upon change of a property of the Coordinate Plane or any of its components.

Referenced by KDChart::CartesianCoordinatePlane::addDiagram(), KDChart::CartesianCoordinatePlane::adjustHorizontalRangeToData(), KDChart::CartesianCoordinatePlane::adjustRangesToData(), KDChart::CartesianCoordinatePlane::adjustVerticalRangeToData(), KDChart::PolarCoordinatePlane::gridAttributes(), KDChart::CartesianCoordinatePlane::gridAttributes(), KDChart::CartesianCoordinatePlane::handleFixedDataCoordinateSpaceRelation(), KDChart::CartesianCoordinatePlane::setAutoAdjustGridToZoom(), KDChart::CartesianCoordinatePlane::setAutoAdjustHorizontalRangeToData(), KDChart::CartesianCoordinatePlane::setAutoAdjustVerticalRangeToData(), KDChart::CartesianCoordinatePlane::setAxesCalcModes(), KDChart::CartesianCoordinatePlane::setAxesCalcModeX(), KDChart::CartesianCoordinatePlane::setAxesCalcModeY(), KDChart::PolarCoordinatePlane::setGridAttributes(), KDChart::CartesianCoordinatePlane::setGridAttributes(), KDChart::CartesianCoordinatePlane::setHorizontalRange(), KDChart::CartesianCoordinatePlane::setHorizontalRangeReversed(), KDChart::CartesianCoordinatePlane::setIsometricScaling(), KDChart::CartesianCoordinatePlane::setVerticalRange(), KDChart::CartesianCoordinatePlane::setVerticalRangeReversed(), KDChart::CartesianCoordinatePlane::setZoomCenter(), KDChart::CartesianCoordinatePlane::setZoomFactors(), KDChart::CartesianCoordinatePlane::setZoomFactorX(), and KDChart::CartesianCoordinatePlane::setZoomFactorY().

AbstractCoordinatePlane * KDChart::AbstractCoordinatePlane::referenceCoordinatePlane ( ) const
inherited

There are two ways, in which planes can be caused to interact, in where they are put layouting wise: The first is the reference plane.

If such a reference plane is set, on a plane, it will use the same cell in the layout as that one. In addition to this, planes can share an axis. In that case they will be laid out in relation to each other as suggested by the position of the axis. If, for example Plane1 and Plane2 share an axis at position Left, that will result in the layout: Axis Plane1 Plane 2, vertically. If Plane1 also happens to be Plane2's reference plane, both planes are drawn over each other. The reference plane concept allows two planes to share the same space even if neither has any axis, and in case there are shared axis, it is used to decided, whether the planes should be painted on top of each other or laid out vertically or horizontally next to each other.

Returns
The reference coordinate plane associated with this one.

Definition at line 183 of file KDChartAbstractCoordinatePlane.cpp.

References d.

Referenced by findSharingAxisDiagrams(), and invalidateLayoutTree().

void KDChart::AbstractCoordinatePlane::relayout ( )
slotinherited

Calling relayout() on the plane triggers the global KDChart::Chart::slotRelayout()

Definition at line 259 of file KDChartAbstractCoordinatePlane.cpp.

References KDChart::AbstractCoordinatePlane::needRelayout().

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

void KDChart::AbstractLayoutItem::removeFromParentLayout ( )
inherited

Definition at line 81 of file KDChartLayoutItems.h.

Referenced by findSharingAxisDiagrams(), KDChart::Chart::takeCoordinatePlane(), and KDChart::Chart::takeHeaderFooter().

void AbstractCoordinatePlane::replaceDiagram ( AbstractDiagram *  diagram,
AbstractDiagram *  oldDiagram = 0 
)
virtualinherited

Replaces the old diagram, or appends the diagram, it there is none yet.

Parameters
diagramThe diagram to be used instead of the old diagram. This parameter must not be zero, or the method will do nothing.
oldDiagramThe diagram to be removed by the new diagram. This diagram will be deleted automatically. If the parameter is omitted, the very first diagram will be replaced. In case, there was no diagram yet, the new diagram will just be added.
Note
If you want to re-use the old diagram, call takeDiagram and addDiagram, instead of using replaceDiagram.
See also
addDiagram, takeDiagram

Definition at line 93 of file KDChartAbstractCoordinatePlane.cpp.

References KDChart::AbstractCoordinatePlane::addDiagram(), d, KDChart::AbstractCoordinatePlane::layoutDiagrams(), KDChart::AbstractCoordinatePlane::layoutPlanes(), KDChart::AbstractCoordinatePlane::takeDiagram(), and KDChart::AbstractCoordinatePlane::update().

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

int AbstractArea::rightOverlap ( bool  doNotRecalculate = false) const
virtualinherited

This is called at layout time by KDChart::AutoSpacerLayoutItem::sizeHint().

The method triggers AbstractArea::sizeHint() to find out the amount of overlap at the right edge of the area.

Note
The default implementation is not using any caching, it might make sense to implement a more sophisticated solution for derived classes that have complex work to do in sizeHint(). All we have here is a primitive flag to be set by the caller if it is sure that no sizeHint() needs to be called.

Definition at line 82 of file KDChartAbstractArea.cpp.

References d.

Referenced by KDChart::AutoSpacerLayoutItem::sizeHint().

void AbstractAreaBase::setBackgroundAttributes ( const BackgroundAttributes &  a)
inherited

Definition at line 102 of file KDChartAbstractAreaBase.cpp.

References d, and KDChart::AbstractAreaBase::positionHasChanged().

void KDChart::AbstractCoordinatePlane::setCornerSpacersEnabled ( bool  enable)
inherited

Enables or disables the use of spacers in the plane corners.

Definition at line 287 of file KDChartAbstractCoordinatePlane.cpp.

References d, and KDChart::AbstractCoordinatePlane::needRelayout().

void AbstractAreaBase::setFrameAttributes ( const FrameAttributes &  a)
inherited

Definition at line 88 of file KDChartAbstractAreaBase.cpp.

References d, and KDChart::AbstractAreaBase::positionHasChanged().

Referenced by KDChart::Legend::clone(), and KDChart::Legend::~Legend().

void KDChart::AbstractCoordinatePlane::setGeometry ( const QRect &  r)
overrideinherited

pure virtual in QLayoutItem

Note
Do not call this function directly, unless you know exactly what you are doing. Geometry management is done by KD Chart's internal layouting measures.

Definition at line 235 of file KDChartAbstractCoordinatePlane.cpp.

References d, and KDChart::AbstractCoordinatePlane::internal_geometryChanged().

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

void KDChart::AbstractCoordinatePlane::setGlobalGridAttributes ( const GridAttributes &  a)
inherited

Set the grid attributes to be used by this coordinate plane.

To disable grid painting, for example, your code should like this:

GridAttributes ga = plane->globalGridAttributes();
ga.setGlobalGridVisible( false );
plane->setGlobalGridAttributes( ga );
See also
globalGridAttributes
CartesianCoordinatePlane::setGridAttributes

Definition at line 157 of file KDChartAbstractCoordinatePlane.cpp.

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

void KDChart::AbstractCoordinatePlane::setGridNeedsRecalculate ( )
slotinherited

Used by the chart to clear the cached grid data.

Definition at line 173 of file KDChartAbstractCoordinatePlane.cpp.

References d.

Referenced by findSharingAxisDiagrams(), and KDChart::CartesianCoordinatePlane::setAxesCalcModeY().

void KDChart::AbstractCoordinatePlane::setParent ( KDChart::Chart *  parent)
inherited

Called internally by KDChart::Chart.

Definition at line 188 of file KDChartAbstractCoordinatePlane.cpp.

References d, and KDChart::AbstractCoordinatePlane::parent().

Referenced by KDChart::Chart::insertCoordinatePlane(), and KDChart::Chart::takeCoordinatePlane().

void KDChart::AbstractLayoutItem::setParentLayout ( QLayout *  lay)
inherited

Definition at line 73 of file KDChartLayoutItems.h.

Referenced by KDChart::Chart::addHeaderFooter(), findSharingAxisDiagrams(), and KDChart::Chart::takeHeaderFooter().

void KDChart::AbstractLayoutItem::setParentWidget ( QWidget *  widget)
virtualinherited

Inform the item about its widget: This enables the item, to trigger that widget's update, whenever the size of the item's contents has changed.

Thus, you need to call setParentWidget on every item, that has a non-fixed size.

Definition at line 59 of file KDChartLayoutItems.cpp.

References KDChart::AbstractLayoutItem::mParent.

Referenced by KDChart::HeaderFooter::setParent(), KDChart::AbstractCartesianDiagram::takeAxis(), and updateToplevelLayout().

void KDChart::AbstractCoordinatePlane::setReferenceCoordinatePlane ( AbstractCoordinatePlane *  plane)
inherited

Set another coordinate plane to be used as the reference plane for this one.

Parameters
planeThe coordinate plane to be used the reference plane for this one.
See also
referenceCoordinatePlane

Definition at line 178 of file KDChartAbstractCoordinatePlane.cpp.

References d.

Referenced by invalidateLayoutTree().

void KDChart::AbstractCoordinatePlane::setRubberBandZoomingEnabled ( bool  enable)
inherited

Enables or disables zooming with a rubber band using the mouse.

Definition at line 271 of file KDChartAbstractCoordinatePlane.cpp.

References d.

virtual void KDChart::AbstractCoordinatePlane::setZoomCenter ( const QPointF &  center)
virtualinherited

Set the point (in value coordinates) to be used as the center point in zoom operations.

Parameters
centerThe point to use.

Reimplemented in KDChart::CartesianCoordinatePlane, and KDChart::PolarCoordinatePlane.

Definition at line 179 of file KDChartAbstractCoordinatePlane.h.

Referenced by KDChart::AbstractCoordinatePlane::mousePressEvent(), and KDChart::AbstractCoordinatePlane::mouseReleaseEvent().

virtual void KDChart::AbstractCoordinatePlane::setZoomFactors ( qreal  factorX,
qreal  factorY 
)
virtualinherited

Sets both zoom factors in one go.

See also
setZoomFactorX,setZoomFactorY

Reimplemented in KDChart::CartesianCoordinatePlane, and KDChart::PolarCoordinatePlane.

Definition at line 152 of file KDChartAbstractCoordinatePlane.h.

virtual void KDChart::AbstractCoordinatePlane::setZoomFactorX ( qreal  factor)
virtualinherited

Sets the zoom factor in horizontal direction, that is applied to all coordinate transformations.

Parameters
factorThe new zoom factor

Reimplemented in KDChart::CartesianCoordinatePlane, and KDChart::PolarCoordinatePlane.

Definition at line 159 of file KDChartAbstractCoordinatePlane.h.

Referenced by KDChart::AbstractCoordinatePlane::mousePressEvent(), and KDChart::AbstractCoordinatePlane::mouseReleaseEvent().

virtual void KDChart::AbstractCoordinatePlane::setZoomFactorY ( qreal  factor)
virtualinherited

Sets the zoom factor in vertical direction, that is applied to all coordinate transformations.

Parameters
factorThe new zoom factor

Reimplemented in KDChart::CartesianCoordinatePlane, and KDChart::PolarCoordinatePlane.

Definition at line 166 of file KDChartAbstractCoordinatePlane.h.

Referenced by KDChart::AbstractCoordinatePlane::mousePressEvent(), and KDChart::AbstractCoordinatePlane::mouseReleaseEvent().

AbstractCoordinatePlane * KDChart::AbstractCoordinatePlane::sharedAxisMasterPlane ( QPainter *  p = 0)
virtualinherited

Reimplemented in KDChart::CartesianCoordinatePlane.

Definition at line 431 of file KDChartAbstractCoordinatePlane.cpp.

Referenced by KDChart::BarDiagram::paint(), KDChart::LeveyJenningsDiagram::paint(), KDChart::Plotter::paint(), and KDChart::LineDiagram::paint().

QSize KDChart::AbstractCoordinatePlane::sizeHint ( ) const
overrideinherited

pure virtual in QLayoutItem

Definition at line 228 of file KDChartAbstractCoordinatePlane.cpp.

References KDChart::AbstractCoordinatePlane::maximumSize().

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

void KDChart::AbstractLayoutItem::sizeHintChanged ( ) const
virtualinherited

Report changed size hint: ask the parent widget to recalculate the layout.

Definition at line 81 of file KDChartLayoutItems.cpp.

References KDChart::AbstractLayoutItem::mParent.

Referenced by KDChart::TextLayoutItem::sizeHint().

QSizePolicy TernaryCoordinatePlane::sizePolicy ( ) const

[reimplemented]

Definition at line 147 of file KDChartTernaryCoordinatePlane.cpp.

void AbstractCoordinatePlane::takeDiagram ( AbstractDiagram *  diagram)
virtualinherited

Removes the diagram from the plane, without deleting it.

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

See also
addDiagram, replaceDiagram

Definition at line 114 of file KDChartAbstractCoordinatePlane.cpp.

References d, KDChart::AbstractCoordinatePlane::layoutDiagrams(), KDChart::AbstractCoordinatePlane::layoutPlanes(), KDChart::AbstractCoordinatePlane::relayout(), KDChart::AbstractDiagram::setCoordinatePlane(), and KDChart::AbstractCoordinatePlane::update().

Referenced by KDChart::AbstractCoordinatePlane::replaceDiagram().

int AbstractArea::topOverlap ( bool  doNotRecalculate = false) const
virtualinherited

This is called at layout time by KDChart::AutoSpacerLayoutItem::sizeHint().

The method triggers AbstractArea::sizeHint() to find out the amount of overlap at the top edge of the area.

Note
The default implementation is not using any caching, it might make sense to implement a more sophisticated solution for derived classes that have complex work to do in sizeHint(). All we have here is a primitive flag to be set by the caller if it is sure that no sizeHint() needs to be called.

Definition at line 90 of file KDChartAbstractArea.cpp.

References d.

Referenced by KDChart::AutoSpacerLayoutItem::sizeHint().

const QPointF TernaryCoordinatePlane::translate ( const QPointF &  diagramPoint) const
overridevirtual

Translate the given point in value space coordinates to a position in pixel space.

Parameters
diagramPointThe point in value coordinates.
Returns
The translated point.

Implements KDChart::AbstractCoordinatePlane.

Definition at line 135 of file KDChartTernaryCoordinatePlane.cpp.

References d.

Referenced by KDChart::TernaryPointDiagram::paint(), KDChart::TernaryLineDiagram::paint(), and KDChart::TernaryAxis::paintCtx().

void KDChart::AbstractCoordinatePlane::update ( )
slotinherited

Calling update() on the plane triggers the global KDChart::Chart::update()

Definition at line 253 of file KDChartAbstractCoordinatePlane.cpp.

References KDChart::AbstractCoordinatePlane::needUpdate().

Referenced by KDChart::AbstractCoordinatePlane::addDiagram(), KDChart::PolarCoordinatePlane::adjustZoomAndRepaint(), KDChart::PolarCoordinatePlane::layoutDiagrams(), KDChart::CartesianCoordinatePlane::layoutDiagrams(), KDChart::AbstractCoordinatePlane::replaceDiagram(), KDChart::PolarCoordinatePlane::resetGridAttributes(), KDChart::CartesianCoordinatePlane::resetGridAttributes(), KDChart::AbstractCoordinatePlane::setGlobalGridAttributes(), KDChart::PolarCoordinatePlane::setGridAttributes(), KDChart::CartesianCoordinatePlane::setGridAttributes(), and KDChart::AbstractCoordinatePlane::takeDiagram().

void KDChart::AbstractCoordinatePlane::viewportCoordinateSystemChanged ( )
signalinherited

Emitted upon change of the view coordinate system.

Referenced by KDChart::CartesianCoordinatePlane::setAxesCalcModes(), KDChart::CartesianCoordinatePlane::setAxesCalcModeX(), and KDChart::CartesianCoordinatePlane::setAxesCalcModeY().

virtual QPointF KDChart::AbstractCoordinatePlane::zoomCenter ( ) const
virtualinherited
Returns
The center point (in value coordinates) of the coordinate plane, that is used for zoom operations.

Reimplemented in KDChart::CartesianCoordinatePlane, and KDChart::PolarCoordinatePlane.

Definition at line 172 of file KDChartAbstractCoordinatePlane.h.

Referenced by KDChart::AbstractCoordinatePlane::mouseReleaseEvent().

virtual qreal KDChart::AbstractCoordinatePlane::zoomFactorX ( ) const
virtualinherited
Returns
The zoom factor in horizontal direction, that is applied to all coordinate transformations.

Reimplemented in KDChart::PolarCoordinatePlane, and KDChart::CartesianCoordinatePlane.

Definition at line 140 of file KDChartAbstractCoordinatePlane.h.

Referenced by KDChart::AbstractCoordinatePlane::mouseReleaseEvent(), KDChart::RadarDiagram::paint(), KDChart::CartesianAxis::paint(), KDChart::PolarDiagram::paint(), KDChart::BarDiagram::resize(), and KDChart::LineDiagram::resize().

virtual qreal KDChart::AbstractCoordinatePlane::zoomFactorY ( ) const
virtualinherited
Returns
The zoom factor in vertical direction, that is applied to all coordinate transformations.

Reimplemented in KDChart::CartesianCoordinatePlane, and KDChart::PolarCoordinatePlane.

Definition at line 146 of file KDChartAbstractCoordinatePlane.h.

Referenced by KDChart::AbstractCoordinatePlane::mouseReleaseEvent(), KDChart::RadarDiagram::paint(), KDChart::CartesianAxis::paint(), KDChart::PolarDiagram::paint(), KDChart::BarDiagram::resize(), and KDChart::LineDiagram::resize().

Member Data Documentation

QWidget* KDChart::AbstractLayoutItem::mParent
protectedinherited

Definition at line 91 of file KDChartLayoutItems.h.

Referenced by KDChart::AbstractLayoutItem::setParentWidget(), KDChart::TextLayoutItem::setText(), KDChart::TextLayoutItem::setTextAlignment(), KDChart::TextLayoutItem::setTextAttributes(), and KDChart::AbstractLayoutItem::sizeHintChanged().

QLayout* KDChart::AbstractLayoutItem::mParentLayout
protectedinherited

Definition at line 92 of file KDChartLayoutItems.h.

Referenced by KDChart::AutoSpacerLayoutItem::paint().

The documentation for this class was generated from the following files:
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/