KD Chart 2  [rev.2.5.1]
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Macros Pages
Public Slots | Signals | Public Member Functions | Static Public Member Functions | Protected Slots | Protected Member Functions | Protected Attributes | List of all members
KDChart::TernaryAxis Class Reference

The class for ternary axes. More...

#include <KDChartTernaryAxis.h>

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

Public Slots

void update ()
 

Signals

void coordinateSystemChanged ()
 
void positionChanged (AbstractArea *)
 

Public Member Functions

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...
 
bool compare (const AbstractAxis *other) const
 Returns true if both axes have the same settings. More...
 
virtual void connectSignals ()
 Wireing the signal/slot connections. More...
 
const AbstractCoordinatePlanecoordinatePlane () const
 Convenience function, returns the coordinate plane, in which this axis is used. More...
 
void createObserver (AbstractDiagram *diagram)
 
virtual const QString customizedLabel (const QString &label) const
 Implement this method if you want to adjust axis labels before they are printed. More...
 
void deleteObserver (AbstractDiagram *diagram)
 
const AbstractDiagramdiagram () const
 
virtual Qt::Orientations expandingDirections () const
 
FrameAttributes frameAttributes () const
 
virtual QRect geometry () const
 
void getFrameLeadings (int &left, int &top, int &right, int &bottom) const
 
bool hasDefaultTitleTextAttributes () const
 
virtual bool isEmpty () const
 
QStringList labels () const
 Returns a list of strings, that are used as axis labels, as set via setLabels. More...
 
virtual int leftOverlap (bool doNotRecalculate=false) const
 This is called at layout time by KDChart::AutoSpacerLayoutItem::sizeHint(). More...
 
virtual QSize maximumSize () const
 
virtual QSize minimumSize () const
 
bool observedBy (AbstractDiagram *diagram) const
 
virtual void paint (QPainter *)
 
virtual void paintAll (QPainter &)
 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 *)
 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...
 
QLayout * parentLayout ()
 
virtual const Position position () const
 
void removeFromParentLayout ()
 
QPair< QSizeF, QSizeF > requiredMargins () const
 
void resetTitleTextAttributes ()
 
virtual int rightOverlap (bool doNotRecalculate=false) const
 This is called at layout time by KDChart::AutoSpacerLayoutItem::sizeHint(). More...
 
RulerAttributes rulerAttributes () const
 Returns the attributes to be used for painting the rulers. More...
 
void setBackgroundAttributes (const BackgroundAttributes &a)
 
void setFrameAttributes (const FrameAttributes &a)
 
virtual void setGeometry (const QRect &rect)
 
void setLabels (const QStringList &list)
 Use this to specify your own set of strings, to be used as axis labels. 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...
 
virtual void setPosition (Position p)
 
void setRulerAttributes (const RulerAttributes &a)
 Use this to specify the attributes used to paint the axis ruler. More...
 
void setShortLabels (const QStringList &list)
 Use this to specify your own set of strings, to be used as axis labels, in case the normal labels are too long. More...
 
void setTextAttributes (const TextAttributes &a)
 Use this to specify the text attributes to be used for axis labels. More...
 
void setTitleText (const QString &text)
 
void setTitleTextAttributes (const TextAttributes &a)
 
QStringList shortLabels () const
 Returns a list of strings, that are used as axis labels, as set via setShortLabels. More...
 
virtual QSize sizeHint () const
 
virtual void sizeHintChanged () const
 Report changed size hint: ask the parent widget to recalculate the layout. More...
 
 TernaryAxis (AbstractTernaryDiagram *diagram=0)
 
TextAttributes textAttributes () const
 Returns the text attributes to be used for axis labels. More...
 
QString titleText () const
 
TextAttributes titleTextAttributes () const
 
virtual int topOverlap (bool doNotRecalculate=false) const
 This is called at layout time by KDChart::AutoSpacerLayoutItem::sizeHint(). More...
 
 ~TernaryAxis ()
 

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 Slots

virtual void delayedInit ()
 called for initializing after the c'tor has completed More...
 

Protected Member Functions

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

Protected Attributes

QWidgetmParent
 
QLayout * mParentLayout
 

Detailed Description

The class for ternary axes.

Definition at line 40 of file KDChartTernaryAxis.h.

Constructor & Destructor Documentation

TernaryAxis::TernaryAxis ( AbstractTernaryDiagram diagram = 0)
explicit
TernaryAxis::~TernaryAxis ( )

Definition at line 56 of file KDChartTernaryAxis.cpp.

Member Function Documentation

void AbstractAreaBase::alignToReferencePoint ( const RelativePosition position)
inherited

Definition at line 81 of file KDChartAbstractAreaBase.cpp.

QRect AbstractArea::areaGeometry ( ) const
protectedvirtualinherited
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().

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

bool AbstractAxis::compare ( const AbstractAxis other) const
inherited

Returns true if both axes have the same settings.

Definition at line 139 of file KDChartAbstractAxis.cpp.

References KDChart::AbstractAxis::labels(), KDChart::AbstractAxis::shortLabels(), and KDChart::AbstractAxis::textAttributes().

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

void AbstractAxis::connectSignals ( )
virtualinherited

Wireing the signal/slot connections.

This method gets called automatically, each time, when you assign the axis to a diagram, either by passing a diagram* to the c'tor, or by calling the diagram's setAxis method, resp.

If overwriting this method in derived classes, make sure to call this base method AbstractAxis::connectSignals(), so your axis gets connected to the diagram's built-in signals.

See Also
AbstractCartesianDiagram::addAxis()

Definition at line 171 of file KDChartAbstractAxis.cpp.

References KDChart::AbstractAxis::coordinateSystemChanged(), and d.

const AbstractCoordinatePlane * AbstractAxis::coordinatePlane ( ) const
inherited

Convenience function, returns the coordinate plane, in which this axis is used.

If the axis is not used in a coordinate plane, the return value is Zero.

Definition at line 235 of file KDChartAbstractAxis.cpp.

References d.

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

void KDChart::AbstractAxis::coordinateSystemChanged ( )
signalinherited
void AbstractAxis::createObserver ( AbstractDiagram diagram)
inherited

Definition at line 161 of file KDChartAbstractAxis.cpp.

References d.

const QString AbstractAxis::customizedLabel ( const QString &  label) const
virtualinherited

Implement this method if you want to adjust axis labels before they are printed.

KD Chart is calling this method immediately before drawing the text, this means: What you return here will be drawn without further modifications.

Parameters
labelThe text of the label as KD Chart has calculated it automatically (or as it was taken from a QStringList provided by you, resp.)
Returns
The text to be drawn. By default this is the same as label.

Definition at line 155 of file KDChartAbstractAxis.cpp.

Referenced by KDChart::LeveyJenningsAxis::paintAsOrdinate().

void AbstractAxis::delayedInit ( )
protectedvirtualslotinherited

called for initializing after the c'tor has completed

Definition at line 131 of file KDChartAbstractAxis.cpp.

References d.

Referenced by KDChart::AbstractAxis::AbstractAxis().

void AbstractAxis::deleteObserver ( AbstractDiagram diagram)
inherited
const AbstractDiagram * KDChart::AbstractAxis::diagram ( ) const
inherited
Qt::Orientations TernaryAxis::expandingDirections ( ) const
virtual

Definition at line 123 of file KDChartTernaryAxis.cpp.

FrameAttributes AbstractAreaBase::frameAttributes ( ) const
inherited
QRect TernaryAxis::geometry ( ) const
virtual

Implements KDChart::AbstractAxis.

Definition at line 97 of file KDChartTernaryAxis.cpp.

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

Definition at line 194 of file KDChartTernaryAxis.cpp.

QRect AbstractAreaBase::innerRect ( ) const
protectedinherited
bool TernaryAxis::isEmpty ( ) const
virtual

Definition at line 91 of file KDChartTernaryAxis.cpp.

QStringList AbstractAxis::labels ( ) const
inherited

Returns a list of strings, that are used as axis labels, as set via setLabels.

See Also
setLabels

Definition at line 216 of file KDChartAbstractAxis.cpp.

References d.

Referenced by KDChart::AbstractAxis::compare(), KDChart::LeveyJenningsAxis::paintAsOrdinate(), and paintCtx().

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 TernaryAxis::maximumSize ( ) const
virtual

Definition at line 113 of file KDChartTernaryAxis.cpp.

QSize TernaryAxis::minimumSize ( ) const
virtual

Definition at line 107 of file KDChartTernaryAxis.cpp.

bool KDChart::AbstractAxis::observedBy ( AbstractDiagram diagram) const
inherited

Definition at line 247 of file KDChartAbstractAxis.cpp.

References d.

void TernaryAxis::paint ( QPainter *  )
virtual

Implements KDChart::AbstractLayoutItem.

Definition at line 67 of file KDChartTernaryAxis.cpp.

void TernaryAxis::paintAll ( QPainter &  painter)
virtual

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

Reimplemented from KDChart::AbstractArea.

Definition at line 62 of file KDChartTernaryAxis.cpp.

void AbstractAreaBase::paintBackground ( QPainter &  painter,
const QRect &  rectangle 
)
virtualinherited
void AbstractAreaBase::paintBackgroundAttributes ( QPainter &  painter,
const QRect &  rectangle,
const KDChart::BackgroundAttributes attributes 
)
staticinherited
void TernaryAxis::paintCtx ( PaintContext context)
virtual
void AbstractAreaBase::paintFrame ( QPainter &  painter,
const QRect &  rectangle 
)
virtualinherited
void AbstractAreaBase::paintFrameAttributes ( QPainter &  painter,
const QRect &  rectangle,
const KDChart::FrameAttributes attributes 
)
staticinherited
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().

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

Definition at line 78 of file KDChartLayoutItems.h.

const Position TernaryAxis::position ( ) const
virtual

Definition at line 128 of file KDChartTernaryAxis.cpp.

Referenced by requiredMargins(), and setPosition().

void KDChart::AbstractArea::positionChanged ( AbstractArea )
signalinherited
void AbstractArea::positionHasChanged ( )
protectedvirtualinherited

Reimplemented from KDChart::AbstractAreaBase.

Definition at line 156 of file KDChartAbstractArea.cpp.

References KDChart::AbstractArea::positionChanged().

void KDChart::AbstractLayoutItem::removeFromParentLayout ( )
inherited
QPair< QSizeF, QSizeF > TernaryAxis::requiredMargins ( ) const
void TernaryAxis::resetTitleTextAttributes ( )

Definition at line 187 of file KDChartTernaryAxis.cpp.

Referenced by TernaryAxis().

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

RulerAttributes AbstractAxis::rulerAttributes ( ) const
inherited

Returns the attributes to be used for painting the rulers.

See Also
setRulerAttributes

Definition at line 202 of file KDChartAbstractAxis.cpp.

References d.

Referenced by KDChart::CartesianAxis::paintCtx(), and KDChart::CartesianAxis::tickLength().

void AbstractAreaBase::setBackgroundAttributes ( const BackgroundAttributes a)
inherited
void AbstractAreaBase::setFrameAttributes ( const FrameAttributes a)
inherited
void TernaryAxis::setGeometry ( const QRect &  rect)
virtual

Implements KDChart::AbstractAxis.

Definition at line 102 of file KDChartTernaryAxis.cpp.

void AbstractAxis::setLabels ( const QStringList &  list)
inherited

Use this to specify your own set of strings, to be used as axis labels.

Labels specified via setLabels take precedence: If a non-empty list is passed, KD Chart will use these strings as axis labels, instead of calculating them.

If you pass a smaller number of strings than the number of labels drawn at this axis, KD Chart will repeat the strings until all labels are drawn. As an example you could specify the seven days of the week as abscissa labels, which would be repeatedly used then.

By passing an empty QStringList you can reset the default behaviour.

See Also
labels, setShortLabels

Definition at line 207 of file KDChartAbstractAxis.cpp.

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

Referenced by KDChart::LeveyJenningsAxis::paintAsAbscissa().

void KDChart::AbstractLayoutItem::setParentLayout ( QLayout *  lay)
inherited
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(), and KDChart::AbstractCartesianDiagram::takeAxis().

void TernaryAxis::setPosition ( Position  p)
virtual
void AbstractAxis::setRulerAttributes ( const RulerAttributes a)
inherited

Use this to specify the attributes used to paint the axis ruler.

Every axis has a default set of ruler attributes that is exactly the same among them. Use this method to specify your own attributes.

See Also
rulerAttributes

Definition at line 196 of file KDChartAbstractAxis.cpp.

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

void AbstractAxis::setShortLabels ( const QStringList &  list)
inherited

Use this to specify your own set of strings, to be used as axis labels, in case the normal labels are too long.

Note
Setting done via setShortLabels will be ignored, if you did not pass a non-empty string list via setLabels too!

By passing an empty QStringList you can reset the default behaviour.

See Also
shortLabels, setLabels

Definition at line 221 of file KDChartAbstractAxis.cpp.

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

void AbstractAxis::setTextAttributes ( const TextAttributes a)
inherited

Use this to specify the text attributes to be used for axis labels.

By default, the reference area will be set at painting time. It will be the then-valid coordinate plane's parent widget, so normally, it will be the KDChart::Chart. Thus the labels of all of your axes in all of your diagrams within that Chart will be drawn in same font size, by default.

See Also
textAttributes, setLabels

Definition at line 181 of file KDChartAbstractAxis.cpp.

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

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

void TernaryAxis::setTitleText ( const QString &  text)

Definition at line 165 of file KDChartTernaryAxis.cpp.

References PrerenderedLabel::setText().

void TernaryAxis::setTitleTextAttributes ( const TextAttributes a)

Definition at line 176 of file KDChartTernaryAxis.cpp.

QStringList AbstractAxis::shortLabels ( ) const
inherited

Returns a list of strings, that are used as axis labels, as set via setShortLabels.

Note
Setting done via setShortLabels will be ignored, if you did not pass a non-empty string list via setLabels too!
See Also
setShortLabels

Definition at line 230 of file KDChartAbstractAxis.cpp.

References d.

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

QSize TernaryAxis::sizeHint ( ) const
virtual

Definition at line 118 of file KDChartTernaryAxis.cpp.

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.

TextAttributes AbstractAxis::textAttributes ( ) const
inherited
QString TernaryAxis::titleText ( ) const

Definition at line 171 of file KDChartTernaryAxis.cpp.

References PrerenderedLabel::text().

TextAttributes TernaryAxis::titleTextAttributes ( ) const

Definition at line 182 of file KDChartTernaryAxis.cpp.

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

void KDChart::AbstractAxis::update ( )
slotinherited

Member Data Documentation

QWidget* KDChart::AbstractLayoutItem::mParent
protectedinherited

Definition at line 92 of file KDChartLayoutItems.h.

Referenced by KDChart::AbstractLayoutItem::setParentWidget().

QLayout* KDChart::AbstractLayoutItem::mParentLayout
protectedinherited

Definition at line 93 of file KDChartLayoutItems.h.


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

Klarälvdalens Datakonsult AB (KDAB)
Qt-related services and products
http://www.kdab.com/
http://www.kdab.com/products/kd-chart/