KDChart::LeveyJenningsAxis Class Reference

#include <KDChartLeveyJenningsAxis.h>

Inheritance diagram for KDChart::LeveyJenningsAxis:

[legend]

Collaboration diagram for KDChart::LeveyJenningsAxis:

[legend]

List of all members.

---

Detailed Description

The class for levey jennings axes.

For being useful, axes need to be assigned to a diagram, see LeveyJenningsDiagram::addAxis and LeveyJenningsDiagram::takeAxis.

See also:

PolarAxis, AbstractCartesianDiagram

Definition at line 50 of file KDChartLeveyJenningsAxis.h.

Public Types
enum	Position {   Bottom,   Top,   Right,   Left }
Public Slots
void	setCachedSizeDirty () const
int	tickLength (bool subUnitTicks=false) const
void	update ()
Signals
void	positionChanged (AbstractArea *)
Public Member Functions
void	alignToReferencePoint (const RelativePosition &position)
QMap< double, QString >	annotations () const
	Returns the currently set axis annotations.
BackgroundAttributes	backgroundAttributes () const
virtual int	bottomOverlap (bool doNotRecalculate=false) const
	This is called at layout time by KDChart:AutoSpacerLayoutItem::sizeHint().
bool	compare (const AbstractAreaBase *other) const
	Returns true if both areas have the same settings.
bool	compare (const AbstractAxis *other) const
	Returns true if both axes have the same settings.
bool	compare (const CartesianAxis *other) const
	Returns true if both axes have the same settings.
bool	compare (const LeveyJenningsAxis *other) const
	Returns true if both axes have the same settings.
virtual void	connectSignals ()
	Wireing the signal/slot connections.
const AbstractCoordinatePlane *	coordinatePlane () const
	Convenience function, returns the coordinate plane, in which this axis is used.
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.
Qt::DateFormat	dateFormat () const
void	deleteObserver (AbstractDiagram *diagram)
const AbstractDiagram *	diagram () const
virtual Qt::Orientations	expandingDirections () const
	pure virtual in QLayoutItem
FrameAttributes	frameAttributes () const
virtual QRect	geometry () const
	pure virtual in QLayoutItem
void	getFrameLeadings (int &left, int &top, int &right, int &bottom) const
bool	hasDefaultTitleTextAttributes () const
virtual bool	isAbscissa () const
virtual bool	isEmpty () const
	pure virtual in QLayoutItem
virtual bool	isOrdinate () const
QStringList	labels () const
	Returns a list of strings, that are used as axis labels, as set via setLabels.
virtual void	layoutPlanes ()
virtual int	leftOverlap (bool doNotRecalculate=false) const
	This is called at layout time by KDChart::AutoSpacerLayoutItem::sizeHint().
	LeveyJenningsAxis (LeveyJenningsDiagram *diagram=0)
	C'tor of the class for levey jennings axes.
virtual QSize	maximumSize () const
	pure virtual in QLayoutItem
virtual QSize	minimumSize () const
	pure virtual in QLayoutItem
bool	observedBy (AbstractDiagram *diagram) const
virtual void	paint (QPainter *)
	reimpl
virtual void	paintAll (QPainter &painter)
	Call paintAll, if you want the background and the frame to be drawn before the normal paint() is invoked automatically.
virtual void	paintBackground (QPainter &painter, const QRect &rectangle)
void	paintCtx (PaintContext *)
	reimpl
virtual void	paintFrame (QPainter &painter, const QRect &rectangle)
virtual void	paintIntoRect (QPainter &painter, const QRect &rect)
	Draws the background and frame, then calls paint().
QLayout *	parentLayout ()
virtual const Position	position () const
void	removeFromParentLayout ()
void	resetTitleTextAttributes ()
	Reset the title text attributes to the built-in default:.
virtual int	rightOverlap (bool doNotRecalculate=false) const
	This is called at layout time by KDChart::AutoSpacerLayoutItem::sizeHint().
RulerAttributes	rulerAttributes () const
	Returns the attributes to be used for painting the rulers.
void	setAnnotations (const QMap< double, QString > &annotations)
	Sets the axis annotations to annotations.
void	setBackgroundAttributes (const BackgroundAttributes &a)
void	setDateFormat (Qt::DateFormat format)
void	setFrameAttributes (const FrameAttributes &a)
virtual void	setGeometry (const QRect &r)
	pure virtual in QLayoutItem
void	setLabels (const QStringList &list)
	Use this to specify your own set of strings, to be used as axis labels.
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.
virtual void	setPosition (Position p)
void	setRulerAttributes (const RulerAttributes &a)
	Use this to specify the attributes used to paint the axis ruler.
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.
void	setTextAttributes (const TextAttributes &a)
	Use this to specify the text attributes to be used for axis labels.
void	setTitleText (const QString &text)
void	setTitleTextAttributes (const TextAttributes &a)
void	setType (LeveyJenningsGridAttributes::GridType type)
	Sets the type of the axis to type.
QStringList	shortLabels () const
	Returns a list of strings, that are used as axis labels, as set via setShortLabels.
virtual QSize	sizeHint () const
	pure virtual in QLayoutItem
virtual void	sizeHintChanged () const
	Report changed size hint: ask the parent widget to recalculate the layout.
TextAttributes	textAttributes () const
	Returns the text attributes to be used for axis labels.
QString	titleText () const
TextAttributes	titleTextAttributes () const
	Returns the text attributes that will be used for displaying the title text.
virtual int	topOverlap (bool doNotRecalculate=false) const
	This is called at layout time by KDChart::AutoSpacerLayoutItem::sizeHint().
LeveyJenningsGridAttributes::GridType	type () const
	Returns: The axis' type.
	~LeveyJenningsAxis ()
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
Protected Member Functions
virtual QRect	areaGeometry () const
QRect	innerRect () const
virtual void	paintAsAbscissa (PaintContext *)
virtual void	paintAsOrdinate (PaintContext *)
virtual void	positionHasChanged ()
Protected Attributes
QWidget *	mParent
QLayout *	mParentLayout

---

Member Enumeration Documentation

enum KDChart::CartesianAxis::Position [inherited]

Enumerator:

Bottom
Top
Right
Left

Definition at line 56 of file KDChartCartesianAxis.h.

                      {
            Bottom,
            Top,
            Right,
            Left
        };

---

Constructor & Destructor Documentation

LeveyJenningsAxis::LeveyJenningsAxis

(

LeveyJenningsDiagram *

diagram = 0

)

[explicit]

C'tor of the class for levey jennings axes.

Note:

If using a zero parent for the constructor, you need to call your diagram's addAxis function to add your axis to the diagram. Otherwise, there is no need to call addAxis, since the constructor does that automatically for you, if you pass a diagram as parameter.

See also:

AbstractCartesianDiagram::addAxis

Definition at line 48 of file KDChartLeveyJenningsAxis.cpp.

References StockDiagram::init().

    : CartesianAxis ( new Private( diagram, this ), diagram )
{
    init();
}

LeveyJenningsAxis::~LeveyJenningsAxis

(

)

Definition at line 54 of file KDChartLeveyJenningsAxis.cpp.

References d, KDChart::AbstractAxis::diagram(), and KDChart::AbstractCartesianDiagram::takeAxis().

{
    // when we remove the first axis it will unregister itself and
    // propagate the next one to the primary, thus the while loop
    while ( d->mDiagram ) {
        LeveyJenningsDiagram *cd = qobject_cast< LeveyJenningsDiagram* >( d->mDiagram );
        cd->takeAxis( this );
    }
    Q_FOREACH( AbstractDiagram *diagram, d->secondaryDiagrams ) {
        LeveyJenningsDiagram *cd = qobject_cast< LeveyJenningsDiagram* >( diagram );
        cd->takeAxis( this );
    }
}

---

Member Function Documentation

void AbstractAreaBase::alignToReferencePoint

(

const RelativePosition &

position

)

[inherited]

Definition at line 91 of file KDChartAbstractAreaBase.cpp.

{
    Q_UNUSED( position );
    // PENDING(kalle) FIXME
    qWarning( "Sorry, not implemented: void AbstractAreaBase::alignToReferencePoint( const RelativePosition& position )" );
}

QMap< double, QString > CartesianAxis::annotations

(

)

const [inherited]

Returns the currently set axis annotations.

Definition at line 1769 of file KDChartCartesianAxis.cpp.

References d.

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

{
    return d->annotations;
}

QRect AbstractArea::areaGeometry

(

)

const [protected, virtual, inherited]

Implements KDChart::AbstractAreaBase.

Definition at line 150 of file KDChartAbstractArea.cpp.

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

{
    return geometry();
}

BackgroundAttributes AbstractAreaBase::backgroundAttributes

(

)

const [inherited]

Definition at line 121 of file KDChartAbstractAreaBase.cpp.

References d.

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

{
    return d->backgroundAttributes;
}

int AbstractArea::bottomOverlap

(

bool

doNotRecalculate = false

)

const [virtual, inherited]

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 101 of file KDChartAbstractArea.cpp.

References d.

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

{
    // Re-calculate the sizes,
    // so we also get the amountOf..Overlap members set newly:
    if( ! doNotRecalculate )
        sizeHint();
    return d->amountOfBottomOverlap;
}

bool AbstractAreaBase::compare

(

const AbstractAreaBase *

other

)

const [inherited]

Returns true if both areas have the same settings.

Definition at line 76 of file KDChartAbstractAreaBase.cpp.

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

{
    if( other == this ) return true;
    if( ! other ){
        //qDebug() << "CartesianAxis::compare() cannot compare to Null pointer";
        return false;
    }
    /*
    qDebug() << "AbstractAreaBase:" << (frameAttributes() == other->frameAttributes())
        << (backgroundAttributes() == other->backgroundAttributes()) << "\n";
    */
    return  (frameAttributes()      == other->frameAttributes()) &&
            (backgroundAttributes() == other->backgroundAttributes());
}

bool AbstractAxis::compare

(

const AbstractAxis *

other

)

const [inherited]

Returns true if both axes have the same settings.

Definition at line 142 of file KDChartAbstractAxis.cpp.

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

{
    if( other == this ) return true;
    if( ! other ){
        //qDebug() << "CartesianAxis::compare() cannot compare to Null pointer";
        return false;
    }
    /*
    qDebug() << (textAttributes() == other->textAttributes());
    qDebug() << (labels()         == other->labels());
    qDebug() << (shortLabels()    == other->shortLabels());
    */
    return  ( static_cast<const AbstractAreaBase*>(this)->compare( other ) ) &&
            (textAttributes() == other->textAttributes()) &&
            (labels()         == other->labels()) &&
            (shortLabels()    == other->shortLabels());
}

bool CartesianAxis::compare

(

const CartesianAxis *

other

)

const [inherited]

Returns true if both axes have the same settings.

Definition at line 83 of file KDChartCartesianAxis.cpp.

References KDChart::CartesianAxis::position(), KDChart::CartesianAxis::titleText(), and KDChart::CartesianAxis::titleTextAttributes().

{
    if( other == this ) return true;
    if( ! other ){
        //qDebug() << "CartesianAxis::compare() cannot compare to Null pointer";
        return false;
    }
    /*
    qDebug() << (position()            == other->position());
    qDebug() << (titleText()           == other->titleText());
    qDebug() << (titleTextAttributes() == other->titleTextAttributes());
    */
    return  ( static_cast<const AbstractAxis*>(this)->compare( other ) ) &&
            ( position()            == other->position() ) &&
            ( titleText()           == other->titleText() ) &&
            ( titleTextAttributes() == other->titleTextAttributes() );
}

bool LeveyJenningsAxis::compare

(

const LeveyJenningsAxis *

other

)

const

Returns true if both axes have the same settings.

Definition at line 124 of file KDChartLeveyJenningsAxis.cpp.

References type().

{
    if( other == this ) return true;
    if( ! other ){
        //qDebug() << "CartesianAxis::compare() cannot compare to Null pointer";
        return false;
    }
    return  ( static_cast<const CartesianAxis*>(this)->compare( other ) ) &&
            ( type() == other->type() );
}

void AbstractAxis::connectSignals

(

)

[virtual, inherited]

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 211 of file KDChartAbstractAxis.cpp.

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

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

{
    if( d->observer ){
        connect( d->observer, SIGNAL( diagramDataChanged( AbstractDiagram *) ),
                this, SLOT( update() ) );
    }
}

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 349 of file KDChartAbstractAxis.cpp.

References d.

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

{
    if( d->diagram() )
        return d->diagram()->coordinatePlane();
    return 0;
}

void AbstractAxis::createObserver

(

AbstractDiagram *

diagram

)

[inherited]

Definition at line 177 of file KDChartAbstractAxis.cpp.

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

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

{
    if( d->setDiagram( diagram ) )
        connectSignals();
}

const QString AbstractAxis::customizedLabel

(

const QString &

label

)

const [virtual, inherited]

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:

label

The 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 161 of file KDChartAbstractAxis.cpp.

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

{
    return label;
}

Qt::DateFormat LeveyJenningsAxis::dateFormat

(

)

const

Definition at line 114 of file KDChartLeveyJenningsAxis.cpp.

References d.

Referenced by paintAsAbscissa().

{
    return d->format;
}

void AbstractAxis::delayedInit

(

)

[protected, virtual, slot, inherited]

called for initializing after the c'tor has completed

Definition at line 134 of file KDChartAbstractAxis.cpp.

References d.

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

{
    // We call setDiagram() here, because the c'tor of Private
    // only has stored the pointers, but it did not call setDiagram().
    if( d )
        d->setDiagram( 0, true /* delayedInit */ );
}

void AbstractAxis::deleteObserver

(

AbstractDiagram *

diagram

)

[inherited]

Definition at line 193 of file KDChartAbstractAxis.cpp.

References d.

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

{
    d->unsetDiagram( diagram );
}

const AbstractDiagram * KDChart::AbstractAxis::diagram

(

)

const [inherited]

Definition at line 356 of file KDChartAbstractAxis.cpp.

References d.

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

{
    return d->diagram();
}

Qt::Orientations CartesianAxis::expandingDirections

(

)

const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 1400 of file KDChartCartesianAxis.cpp.

References KDChart::CartesianAxis::Bottom, KDChart::CartesianAxis::Left, KDChart::CartesianAxis::position(), KDChart::CartesianAxis::Right, and KDChart::CartesianAxis::Top.

{
    Qt::Orientations ret;
    switch ( position() )
    {
    case Bottom:
    case Top:
        ret = Qt::Horizontal;
        break;
    case Left:
    case Right:
        ret = Qt::Vertical;
        break;
    default:
        Q_ASSERT( false ); // all positions need to be handeld
        break;
    };
    return ret;
}

FrameAttributes AbstractAreaBase::frameAttributes

(

)

const [inherited]

Definition at line 107 of file KDChartAbstractAreaBase.cpp.

References d.

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

{
    return d->frameAttributes;
}

QRect CartesianAxis::geometry

(

)

const [virtual, inherited]

pure virtual in QLayoutItem

Implements KDChart::AbstractAxis.

Definition at line 1748 of file KDChartCartesianAxis.cpp.

References d.

Referenced by paintAsAbscissa(), paintAsOrdinate(), and KDChart::CartesianAxis::paintCtx().

{
    return d->geometry;
}

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

{
    if( d && d->frameAttributes.isVisible() ){
        const int padding = qMax( d->frameAttributes.padding(), 0 );
        left   = padding;
        top    = padding;
        right  = padding;
        bottom = padding;
    }else{
        left   = 0;
        top    = 0;
        right  = 0;
        bottom = 0;
    }
}

bool CartesianAxis::hasDefaultTitleTextAttributes

(

)

const [inherited]

Definition at line 138 of file KDChartCartesianAxis.cpp.

References d.

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

{
    return d->useDefaultTextAttributes;
}

QRect AbstractAreaBase::innerRect

(

)

const [protected, inherited]

Definition at line 229 of file KDChartAbstractAreaBase.cpp.

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

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

{
    int left;
    int top;
    int right;
    int bottom;
    getFrameLeadings( left, top, right, bottom );
    return
        QRect( QPoint(0,0), areaGeometry().size() )
            .adjusted( left, top, -right, -bottom );
}

bool CartesianAxis::isAbscissa

(

)

const [virtual, inherited]

Definition at line 216 of file KDChartCartesianAxis.cpp.

References KDChart::CartesianAxis::Bottom, d, KDChart::CartesianAxis::Left, KDChart::CartesianAxis::position(), referenceDiagramIsBarDiagram(), KDChart::CartesianAxis::Right, and KDChart::CartesianAxis::Top.

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

{
        const Qt::Orientation diagramOrientation = referenceDiagramIsBarDiagram( d->diagram() ) ? ((BarDiagram*)(d->diagram()))->orientation()
                                                                                                                                                                                    : Qt::Vertical;
        return diagramOrientation == Qt::Vertical ? position() == Bottom || position() == Top
                                                                                  : position() == Left   || position() == Right;
}

bool CartesianAxis::isEmpty

(

)

const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 1395 of file KDChartCartesianAxis.cpp.

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

{
    return false; // if the axis exists, it has some (perhaps default) content
}

bool CartesianAxis::isOrdinate

(

)

const [virtual, inherited]

Definition at line 224 of file KDChartCartesianAxis.cpp.

References KDChart::CartesianAxis::Bottom, d, KDChart::CartesianAxis::Left, KDChart::CartesianAxis::position(), referenceDiagramIsBarDiagram(), KDChart::CartesianAxis::Right, and KDChart::CartesianAxis::Top.

Referenced by paintAsOrdinate(), paintCtx(), KDChart::CartesianAxis::paintCtx(), and KDChart::CartesianCoordinatePlane::sharedAxisMasterPlane().

{
        const Qt::Orientation diagramOrientation = referenceDiagramIsBarDiagram( d->diagram() ) ? ((BarDiagram*)(d->diagram()))->orientation()
                                                                                                                                                                                    : Qt::Vertical;
        return diagramOrientation == Qt::Vertical ? position() == Left   || position() == Right
                                                                                  : position() == Bottom || position() == Top;
}

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 306 of file KDChartAbstractAxis.cpp.

References d.

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

{
    return d->hardLabels;
}

void CartesianAxis::layoutPlanes

(

)

[virtual, inherited]

Definition at line 158 of file KDChartCartesianAxis.cpp.

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

Referenced by KDChart::CartesianAxis::resetTitleTextAttributes(), KDChart::CartesianAxis::setPosition(), KDChart::CartesianAxis::setTitleText(), and KDChart::CartesianAxis::setTitleTextAttributes().

{
    //qDebug() << "CartesianAxis::layoutPlanes()";
    if( ! d->diagram() || ! d->diagram()->coordinatePlane() ) {
        //qDebug() << "CartesianAxis::layoutPlanes(): Sorry, found no plane.";
        return;
    }
    AbstractCoordinatePlane* plane = d->diagram()->coordinatePlane();
    if( plane ){
        plane->layoutPlanes();
        //qDebug() << "CartesianAxis::layoutPlanes() OK";
    }
}

int AbstractArea::leftOverlap

(

bool

doNotRecalculate = false

)

const [virtual, inherited]

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 77 of file KDChartAbstractArea.cpp.

References d.

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

{
    // Re-calculate the sizes,
    // so we also get the amountOf..Overlap members set newly:
    if( ! doNotRecalculate )
        sizeHint();
    return d->amountOfLeftOverlap;
}

QSize CartesianAxis::maximumSize

(

)

const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 1452 of file KDChartCartesianAxis.cpp.

References d.

Referenced by KDChart::CartesianAxis::minimumSize(), and KDChart::CartesianAxis::sizeHint().

{
    if( ! d->cachedMaximumSize.isValid() )
        d->cachedMaximumSize = d->calculateMaximumSize();
    return d->cachedMaximumSize;
}

QSize CartesianAxis::minimumSize

(

)

const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 1730 of file KDChartCartesianAxis.cpp.

References KDChart::CartesianAxis::maximumSize().

{
    return maximumSize();
}

bool KDChart::AbstractAxis::observedBy

(

AbstractDiagram *

diagram

)

const [inherited]

Definition at line 361 of file KDChartAbstractAxis.cpp.

References d.

{
    return d->hasDiagram( diagram );
}

void CartesianAxis::paint

(

QPainter *

painter

)

[virtual, inherited]

reimpl

Implements KDChart::AbstractLayoutItem.

Definition at line 232 of file KDChartCartesianAxis.cpp.

References KDChart::AbstractArea::areaGeometry(), d, KDChart::CartesianAxis::paintCtx(), KDChart::PaintContext::setCoordinatePlane(), KDChart::PaintContext::setPainter(), and KDChart::PaintContext::setRectangle().

{
    if( ! d->diagram() || ! d->diagram()->coordinatePlane() ) return;
    PaintContext ctx;
    ctx.setPainter ( painter );
    ctx.setCoordinatePlane( d->diagram()->coordinatePlane() );
    const QRect rect( areaGeometry() );

    //qDebug() << "CartesianAxis::paint( QPainter* painter )  " << " areaGeometry()():" << rect << " sizeHint():" << sizeHint();

    ctx.setRectangle(
        QRectF (
            //QPointF(0, 0),
            QPointF(rect.left(), rect.top()),
            QSizeF(rect.width(), rect.height() ) ) );
    // enabling clipping so that we're not drawing outside
    QRegion clipRegion( rect.adjusted( -1, -1, 1, 1 ) );
    painter->save();
    painter->setClipRegion( clipRegion );
    paintCtx( &ctx );
    painter->restore();
    //qDebug() << "KDChart::CartesianAxis::paint() done.";
}

void AbstractArea::paintAll

(

QPainter &

painter

)

[virtual, inherited]

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

{
    // Paint the background and frame
    const QRect overlappingArea( geometry().adjusted(
            -d->amountOfLeftOverlap,
            -d->amountOfTopOverlap,
            d->amountOfRightOverlap,
            d->amountOfBottomOverlap ) );
    paintBackground( painter, overlappingArea );
    paintFrame(      painter, overlappingArea );

    // temporarily adjust the widget size, to be sure all content gets calculated
    // to fit into the inner rectangle
    const QRect oldGeometry( areaGeometry()  );
    QRect inner( innerRect() );
    inner.moveTo(
        oldGeometry.left() + inner.left(),
        oldGeometry.top()  + inner.top() );
    const bool needAdjustGeometry = oldGeometry != inner;
    if( needAdjustGeometry )
        setGeometry( inner );
    paint( &painter );
    if( needAdjustGeometry )
        setGeometry( oldGeometry );
    //qDebug() << "AbstractAreaWidget::paintAll() done.";
}

void LeveyJenningsAxis::paintAsAbscissa

(

PaintContext *

context

)

[protected, virtual]

Definition at line 217 of file KDChartLeveyJenningsAxis.cpp.

References KDChart::CartesianAxis::Bottom, KDChart::PaintContext::coordinatePlane(), d, dateFormat(), KDChart::CartesianAxis::geometry(), KDChart::CartesianAxis::isAbscissa(), KDChart::TextAttributes::isVisible(), KDChartEnums::MeasureOrientationMinimum, KDChart::CartesianAxis::paintCtx(), KDChart::PaintContext::painter(), KDChart::AbstractCoordinatePlane::parent(), KDChart::CartesianAxis::position(), KDChart::AbstractAxis::setLabels(), KDChart::AbstractAxis::textAttributes(), and KDChart::LeveyJenningsDiagram::timeRange().

Referenced by paintCtx().

{
    Q_ASSERT( isAbscissa() );

    // this triggers drawing of the ticks
    setLabels( QStringList() << QString::fromLatin1( " " ) );
    CartesianAxis::paintCtx( context );

    const LeveyJenningsDiagram* const diag = dynamic_cast< const LeveyJenningsDiagram* >( d->diagram() );
    LeveyJenningsCoordinatePlane* plane = dynamic_cast<LeveyJenningsCoordinatePlane*>(context->coordinatePlane());

    const QObject* referenceArea = plane->parent();
    const TextAttributes labelTA = textAttributes();
    
    const bool drawLabels = labelTA.isVisible();

    if( !drawLabels )
        return;


    const QPair< QDateTime, QDateTime > range = diag->timeRange();

    QPainter* const painter = context->painter();
    const PainterSaver ps( painter );
    painter->setRenderHint( QPainter::Antialiasing, true );
    painter->setClipping( false );
     

    TextLayoutItem labelItem( range.first.date().toString( dateFormat() ), 
                              labelTA,
                              referenceArea,
                              KDChartEnums::MeasureOrientationMinimum,
                              Qt::AlignLeft );
    QSize origSize = labelItem.sizeHint();
    if( range.first.secsTo( range.second ) < 86400 )
        labelItem = TextLayoutItem( range.first.toString( dateFormat() ), 
                                  labelTA,
                                  referenceArea,
                                  KDChartEnums::MeasureOrientationMinimum,
                                  Qt::AlignLeft );
    QSize size = labelItem.sizeHint();

    float yPos = position() == Bottom ? geometry().bottom() - size.height() : geometry().top();
    labelItem.setGeometry( QRectF( QPointF( geometry().left() - origSize.width() / 2.0, yPos ), size ).toRect() );
    labelItem.paint( painter );

    
    TextLayoutItem labelItem2( range.second.date().toString( dateFormat() ), 
                              labelTA,
                              referenceArea,
                              KDChartEnums::MeasureOrientationMinimum,
                              Qt::AlignLeft );
    origSize = labelItem2.sizeHint();
    if( range.first.secsTo( range.second ) < 86400 )
        labelItem2 = TextLayoutItem( range.second.toString( dateFormat() ), 
                                     labelTA,
                                     referenceArea,
                                     KDChartEnums::MeasureOrientationMinimum,
                                     Qt::AlignLeft );
    size = labelItem2.sizeHint();
    yPos = position() == Bottom ? geometry().bottom() - size.height() : geometry().top();
    labelItem2.setGeometry( QRectF( QPointF( geometry().right() - size.width() + origSize.width() / 2.0, yPos ), size ).toRect() );
    labelItem2.paint( painter );
}

void LeveyJenningsAxis::paintAsOrdinate

(

PaintContext *

context

)

[protected, virtual]

Definition at line 156 of file KDChartLeveyJenningsAxis.cpp.

References KDChart::LeveyJenningsDiagram::calculatedMeanValue(), KDChart::LeveyJenningsDiagram::calculatedStandardDeviation(), KDChart::PaintContext::coordinatePlane(), KDChart::AbstractAxis::customizedLabel(), d, KDChart::LeveyJenningsGridAttributes::Expected, KDChart::LeveyJenningsDiagram::expectedMeanValue(), KDChart::LeveyJenningsDiagram::expectedStandardDeviation(), KDChart::CartesianAxis::geometry(), KDChart::CartesianAxis::isOrdinate(), KDChart::TextAttributes::isVisible(), KDChart::AbstractAxis::labels(), KDChart::CartesianAxis::Left, KDChartEnums::MeasureOrientationMinimum, KDChart::PaintContext::painter(), KDChart::AbstractCoordinatePlane::parent(), KDChart::TextAttributes::pen(), KDChart::CartesianAxis::position(), KDChart::PrintingParameters::scalePen(), KDChart::AbstractAxis::textAttributes(), KDChart::CartesianCoordinatePlane::translate(), and type().

Referenced by paintCtx().

{
    const LeveyJenningsDiagram* const diag = dynamic_cast< const LeveyJenningsDiagram* >( d->diagram() );

    Q_ASSERT( isOrdinate() );
    LeveyJenningsCoordinatePlane* plane = dynamic_cast<LeveyJenningsCoordinatePlane*>(context->coordinatePlane());
    
    const qreal meanValue =         type() == LeveyJenningsGridAttributes::Expected ? diag->expectedMeanValue() 
                                                                                    : diag->calculatedMeanValue();
    const qreal standardDeviation = type() == LeveyJenningsGridAttributes::Expected ? diag->expectedStandardDeviation() 
                                                                                    : diag->calculatedStandardDeviation();
    const TextAttributes labelTA = textAttributes();
    const bool drawLabels = labelTA.isVisible();

    // nothing to draw, since we've no ticks
    if( !drawLabels )
        return;
    
    const QObject* referenceArea = plane->parent();

    const QVector< qreal > values = QVector< qreal >() << ( meanValue - 3 * standardDeviation )
                                                       << ( meanValue - 2 * standardDeviation )
                                                       << ( meanValue )
                                                       << ( meanValue + 2 * standardDeviation )
                                                       << ( meanValue + 3 * standardDeviation );

    Q_ASSERT_X( values.count() <= labels().count(), "LeveyJenningsAxis::paintAsOrdinate", "Need to have at least 5 labels" );

    TextLayoutItem labelItem( tr( "mean" ), 
                              labelTA,
                              referenceArea,
                              KDChartEnums::MeasureOrientationMinimum,
                              Qt::AlignLeft );

    QPainter* const painter = context->painter();
    const PainterSaver ps( painter );
    painter->setRenderHint( QPainter::Antialiasing, true );
    painter->setClipping( false );
    
    painter->setPen ( PrintingParameters::scalePen( labelTA.pen() ) ); // perhaps we want to add a setter method later?

    for( int i = 0; i < values.count(); ++i )
    {
        const QPointF labelPos = plane->translate( QPointF( 0.0, values.at( i ) ) );
        const QString label = customizedLabel( labels().at( i ) );
        labelItem.setText( label );
        const QSize size = labelItem.sizeHint();
        const float xPos = position() == Left ? geometry().right() - size.width() : geometry().left();
        labelItem.setGeometry( QRectF( QPointF( xPos, labelPos.y() - size.height() / 2.0 ), size ).toRect() );

        // don't draw labels which aren't in the valid range (might happen for calculated SDs)
        if( values.at( i ) > diag->expectedMeanValue() + 4 * diag->expectedStandardDeviation() )
            continue;

        if( values.at( i ) < diag->expectedMeanValue() - 4 * diag->expectedStandardDeviation() )
            continue;

        labelItem.paint( painter );
    }    
}

void AbstractAreaBase::paintBackground	(	QPainter &	painter,
		const QRect &	rectangle
	)			[virtual, inherited]

Definition at line 197 of file KDChartAbstractAreaBase.cpp.

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

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

{
    Q_ASSERT_X ( d != 0, "AbstractAreaBase::paintBackground()",
                "Private class was not initialized!" );
    paintBackgroundAttributes( painter, rect, d->backgroundAttributes );
}

void AbstractAreaBase::paintBackgroundAttributes	(	QPainter &	painter,
		const QRect &	rectangle,
		const KDChart::BackgroundAttributes &	attributes
	)			[static, inherited]

Definition at line 128 of file KDChartAbstractAreaBase.cpp.

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

Referenced by KDChart::AbstractAreaBase::paintBackground().

{
    if( !attributes.isVisible() ) return;

    /* first draw the brush (may contain a pixmap)*/
    if( Qt::NoBrush != attributes.brush().style() ) {
        KDChart::PainterSaver painterSaver( &painter );
        painter.setPen( Qt::NoPen );
        const QPointF newTopLeft( painter.deviceMatrix().map( rect.topLeft() ) );
        painter.setBrushOrigin( newTopLeft );
        painter.setBrush( attributes.brush() );
        painter.drawRect( rect.adjusted( 0, 0, -1, -1 ) );
    }
    /* next draw the backPixmap over the brush */
    if( !attributes.pixmap().isNull() &&
        attributes.pixmapMode() != BackgroundAttributes::BackgroundPixmapModeNone ) {
        QPointF ol = rect.topLeft();
        if( BackgroundAttributes::BackgroundPixmapModeCentered == attributes.pixmapMode() )
        {
            ol.setX( rect.center().x() - attributes.pixmap().width() / 2 );
            ol.setY( rect.center().y() - attributes.pixmap().height()/ 2 );
            painter.drawPixmap( ol, attributes.pixmap() );
        } else {
            QMatrix m;
            double zW = (double)rect.width()  / (double)attributes.pixmap().width();
            double zH = (double)rect.height() / (double)attributes.pixmap().height();
            switch( attributes.pixmapMode() ) {
            case BackgroundAttributes::BackgroundPixmapModeScaled:
            {
                double z;
                z = qMin( zW, zH );
                m.scale( z, z );
            }
            break;
            case BackgroundAttributes::BackgroundPixmapModeStretched:
                m.scale( zW, zH );
                break;
            default:
                ; // Cannot happen, previously checked
            }
            QPixmap pm = attributes.pixmap().transformed( m );
            ol.setX( rect.center().x() - pm.width() / 2 );
            ol.setY( rect.center().y() - pm.height()/ 2 );
            painter.drawPixmap( ol, pm );
        }
    }
}

void LeveyJenningsAxis::paintCtx

(

PaintContext *

context

)

[virtual]

reimpl

Reimplemented from KDChart::CartesianAxis.

Definition at line 135 of file KDChartLeveyJenningsAxis.cpp.

References KDChart::PaintContext::coordinatePlane(), d, KDChart::CartesianAxis::isOrdinate(), paintAsAbscissa(), and paintAsOrdinate().

{

    Q_ASSERT_X ( d->diagram(), "LeveyJenningsAxis::paint",
                 "Function call not allowed: The axis is not assigned to any diagram." );

    LeveyJenningsCoordinatePlane* plane = dynamic_cast<LeveyJenningsCoordinatePlane*>(context->coordinatePlane());
    Q_ASSERT_X ( plane, "LeveyJenningsAxis::paint",
                 "Bad function call: PaintContext::coodinatePlane() NOT a levey jennings plane." );

    // note: Not having any data model assigned is no bug
    //       but we can not draw an axis then either.
    if( ! d->diagram()->model() )
        return;

    if( isOrdinate() )
        paintAsOrdinate( context );
    else
        paintAsAbscissa( context );
}

void AbstractAreaBase::paintFrame	(	QPainter &	painter,
		const QRect &	rectangle
	)			[virtual, inherited]

Definition at line 205 of file KDChartAbstractAreaBase.cpp.

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

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

{
    Q_ASSERT_X ( d != 0, "AbstractAreaBase::paintFrame()",
                "Private class was not initialized!" );
    paintFrameAttributes( painter, rect, d->frameAttributes );
}

void AbstractAreaBase::paintFrameAttributes	(	QPainter &	painter,
		const QRect &	rectangle,
		const KDChart::FrameAttributes &	attributes
	)			[static, inherited]

Definition at line 178 of file KDChartAbstractAreaBase.cpp.

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

Referenced by KDChart::AbstractAreaBase::paintFrame().

{

    if( !attributes.isVisible() ) return;

    // Note: We set the brush to NoBrush explicitly here.
    //       Otherwise we might get a filled rectangle, so any
    //       previously drawn background would be overwritten by that area.

    const QPen   oldPen(   painter.pen() );
    const QBrush oldBrush( painter.brush() );
    painter.setPen(  PrintingParameters::scalePen( attributes.pen() ) );
    painter.setBrush( Qt::NoBrush );
    painter.drawRect( rect.adjusted( 0, 0, -1, -1 ) );
    painter.setBrush( oldBrush );
    painter.setPen( oldPen );
}

void AbstractArea::paintIntoRect	(	QPainter &	painter,
		const QRect &	rect
	)			[virtual, inherited]

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 111 of file KDChartAbstractArea.cpp.

References KDChart::AbstractArea::paintAll().

{
    const QRect oldGeometry( geometry() );
    if( oldGeometry != rect )
        setGeometry( rect );
    painter.translate( rect.left(), rect.top() );
    paintAll( painter );
    painter.translate( -rect.left(), -rect.top() );
    if( oldGeometry != rect )
        setGeometry( oldGeometry );
}

QLayout* KDChart::AbstractLayoutItem::parentLayout

(

)

[inherited]

Definition at line 79 of file KDChartLayoutItems.h.

        {
            return mParentLayout;
        }

const CartesianAxis::Position CartesianAxis::position

(

)

const [virtual, inherited]

Definition at line 153 of file KDChartCartesianAxis.cpp.

References d.

Referenced by KDChart::CartesianAxis::compare(), KDChart::CartesianAxis::expandingDirections(), KDChart::CartesianAxis::isAbscissa(), KDChart::CartesianAxis::isOrdinate(), paintAsAbscissa(), paintAsOrdinate(), KDChart::CartesianAxis::paintCtx(), and KDChart::CartesianAxis::tickLength().

{
    return d->position;
}

void KDChart::AbstractArea::positionChanged

(

AbstractArea *

)

[signal, inherited]

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

void AbstractArea::positionHasChanged

(

)

[protected, virtual, inherited]

Reimplemented from KDChart::AbstractAreaBase.

Definition at line 155 of file KDChartAbstractArea.cpp.

References KDChart::AbstractArea::positionChanged().

{
    emit positionChanged( this );
}

void KDChart::AbstractLayoutItem::removeFromParentLayout

(

)

[inherited]

Definition at line 83 of file KDChartLayoutItems.h.

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

        {
            if( mParentLayout ){
                if( widget() )
                    mParentLayout->removeWidget( widget() );
                else
                    mParentLayout->removeItem( this );
            }
        }

void CartesianAxis::resetTitleTextAttributes

(

)

[inherited]

Reset the title text attributes to the built-in default:.

Same font and pen as AbstractAxis::textAttributes() and 1.5 times their size.

Definition at line 132 of file KDChartCartesianAxis.cpp.

References d, and KDChart::CartesianAxis::layoutPlanes().

{
    d->useDefaultTextAttributes = true;
    layoutPlanes();
}

int AbstractArea::rightOverlap

(

bool

doNotRecalculate = false

)

const [virtual, inherited]

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 85 of file KDChartAbstractArea.cpp.

References d.

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

{
    // Re-calculate the sizes,
    // so we also get the amountOf..Overlap members set newly:
    if( ! doNotRecalculate )
        sizeHint();
    return d->amountOfRightOverlap;
}

RulerAttributes AbstractAxis::rulerAttributes

(

)

const [inherited]

Returns the attributes to be used for painting the rulers.

See also:

setRulerAttributes

Definition at line 270 of file KDChartAbstractAxis.cpp.

References d.

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

{
        return d->rulerAttributes;
}

void CartesianAxis::setAnnotations

(

const QMap< double, QString > &

annotations

)

[inherited]

Sets the axis annotations to annotations.

Annotations are a QMap of doubles and QStrings defining special markers and their position. If you use annotations, the normal ticks and values will be invisible. To unset the annotations, pass an empty QMap.

Definition at line 1774 of file KDChartCartesianAxis.cpp.

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

{
    if( d->annotations == annotations )
        return;

    d->annotations = annotations;
    update();
}

void AbstractAreaBase::setBackgroundAttributes

(

const BackgroundAttributes &

a

)

[inherited]

Definition at line 112 of file KDChartAbstractAreaBase.cpp.

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

{
    if( d->backgroundAttributes == a )
        return;

    d->backgroundAttributes = a;
    positionHasChanged();
}

void CartesianAxis::setCachedSizeDirty

(

)

const [slot, inherited]

Definition at line 1446 of file KDChartCartesianAxis.cpp.

References d.

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

{
    d->cachedMaximumSize = QSize();
}

void LeveyJenningsAxis::setDateFormat

(

Qt::DateFormat

format

)

Definition at line 119 of file KDChartLeveyJenningsAxis.cpp.

References d.

{
    d->format = format;
}

void AbstractAreaBase::setFrameAttributes

(

const FrameAttributes &

a

)

[inherited]

Definition at line 98 of file KDChartAbstractAreaBase.cpp.

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

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

{
    if( d->frameAttributes == a )
        return;

    d->frameAttributes = a;
    positionHasChanged();
}

void CartesianAxis::setGeometry

(

const QRect &

r

)

[virtual, inherited]

pure virtual in QLayoutItem

Implements KDChart::AbstractAxis.

Definition at line 1740 of file KDChartCartesianAxis.cpp.

References d, and KDChart::CartesianAxis::setCachedSizeDirty().

{
//    qDebug() << "KDChart::CartesianAxis::setGeometry(" << r << ") called"
//             << (isAbscissa() ? "for Abscissa":"for Ordinate") << "axis";
    d->geometry = r;
    setCachedSizeDirty();
}

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 a smaller number of strings than the number of labels drawn at this axis, KD Chart will iterate over the list, repeating 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 292 of file KDChartAbstractAxis.cpp.

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

Referenced by paintAsAbscissa().

{
    if( d->hardLabels == list )
        return;

    d->hardLabels = list;
    update();
}

void KDChart::AbstractLayoutItem::setParentLayout

(

QLayout *

lay

)

[inherited]

Definition at line 75 of file KDChartLayoutItems.h.

        {
            mParentLayout = lay;
        }

void KDChart::AbstractLayoutItem::setParentWidget

(

QWidget *

widget

)

[virtual, inherited]

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 65 of file KDChartLayoutItems.cpp.

References KDChart::AbstractLayoutItem::mParent.

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

{
    mParent = widget;
}

void CartesianAxis::setPosition

(

Position

p

)

[virtual, inherited]

Definition at line 144 of file KDChartCartesianAxis.cpp.

References d, and KDChart::CartesianAxis::layoutPlanes().

{
    d->position = p;
    layoutPlanes();
}

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 259 of file KDChartAbstractAxis.cpp.

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

{
        d->rulerAttributes = a;
        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 322 of file KDChartAbstractAxis.cpp.

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

{
    if( d->hardShortLabels == list )
        return;

    d->hardShortLabels = list;
    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 231 of file KDChartAbstractAxis.cpp.

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

Referenced by setType().

{
    if( d->textAttributes == a )
        return;

    d->textAttributes = a;
    update();
}

void CartesianAxis::setTitleText

(

const QString &

text

)

[inherited]

Definition at line 102 of file KDChartCartesianAxis.cpp.

References d, and KDChart::CartesianAxis::layoutPlanes().

{
    d->titleText = text;
    layoutPlanes();
}

void CartesianAxis::setTitleTextAttributes

(

const TextAttributes &

a

)

[inherited]

Definition at line 113 of file KDChartCartesianAxis.cpp.

References d, and KDChart::CartesianAxis::layoutPlanes().

{
    d->titleTextAttributes = a;
    d->useDefaultTextAttributes = false;
    layoutPlanes();
}

void LeveyJenningsAxis::setType

(

LeveyJenningsGridAttributes::GridType

type

)

Sets the type of the axis to type.

This method colors the label to the default color of the respective type. Please make sure to re-set the colors after calling this, if you want them different. Setting the type is only valid for axes located right or left from the diagram. An axis on the bottom always shows the timeline.

Definition at line 95 of file KDChartLeveyJenningsAxis.cpp.

References d, KDChart::LeveyJenningsGridAttributes::Expected, KDChart::TextAttributes::pen(), KDChart::TextAttributes::setPen(), KDChart::AbstractAxis::setTextAttributes(), and KDChart::AbstractAxis::textAttributes().

{
    if( type != d->type )
    {
        TextAttributes ta = textAttributes();
        QPen pen = ta.pen();
        QColor color = type == LeveyJenningsGridAttributes::Expected ? Qt::black : Qt::blue;
        if( qobject_cast< const LeveyJenningsDiagram* >( d->diagram() ) && 
            qobject_cast< const LeveyJenningsCoordinatePlane* >( d->diagram()->coordinatePlane() ) )
        {
            color = qobject_cast< const LeveyJenningsCoordinatePlane* >( d->diagram()->coordinatePlane() )->gridAttributes().gridPen( type ).color();
        }
        pen.setColor( color );
        ta.setPen( pen );
        setTextAttributes( ta );
    }
    d->type = type;
}

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 339 of file KDChartAbstractAxis.cpp.

References d.

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

{
    return d->hardShortLabels;
}

QSize CartesianAxis::sizeHint

(

)

const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 1735 of file KDChartCartesianAxis.cpp.

References KDChart::CartesianAxis::maximumSize().

{
    return maximumSize();
}

void KDChart::AbstractLayoutItem::sizeHintChanged

(

)

const [virtual, inherited]

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

Definition at line 87 of file KDChartLayoutItems.cpp.

References KDChart::AbstractLayoutItem::mParent.

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

{
    // This is exactly like what QWidget::updateGeometry does.
//  qDebug("KDChart::AbstractLayoutItem::sizeHintChanged() called");
    if( mParent ) {
        if ( mParent->layout() )
            mParent->layout()->invalidate();
        else
            QApplication::postEvent( mParent, new QEvent( QEvent::LayoutRequest ) );
    }
}

TextAttributes AbstractAxis::textAttributes

(

)

const [inherited]

Returns the text attributes to be used for axis labels.

See also:

setTextAttributes

Definition at line 245 of file KDChartAbstractAxis.cpp.

References d.

Referenced by KDChart::AbstractAxis::compare(), paintAsAbscissa(), paintAsOrdinate(), KDChart::CartesianAxis::paintCtx(), setType(), and KDChart::CartesianAxis::titleTextAttributes().

{
    return d->textAttributes;
}

int CartesianAxis::tickLength

(

bool

subUnitTicks = false

)

const [slot, inherited]

Definition at line 1753 of file KDChartCartesianAxis.cpp.

References KDChart::CartesianAxis::isAbscissa(), KDChart::CartesianAxis::Left, KDChart::CartesianAxis::position(), and KDChart::CartesianAxis::Top.

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

{
    int result = 0;

    if ( isAbscissa() ) {
        result = position() == Top ? -4 : 3;
    } else {
        result = position() == Left ? -4 : 3;
    }

    if ( subUnitTicks )
        result = result < 0 ? result + 1 : result - 1;

    return result;
}

QString CartesianAxis::titleText

(

)

const [inherited]

Definition at line 108 of file KDChartCartesianAxis.cpp.

References d.

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

{
    return d->titleText;
}

TextAttributes CartesianAxis::titleTextAttributes

(

)

const [inherited]

Returns the text attributes that will be used for displaying the title text.

This is either the text attributes as specified by setTitleTextAttributes, or (if setTitleTextAttributes() was not called) the default text attributes.

See also:

resetTitleTextAttributes, hasDefaultTitleTextAttributes

Definition at line 120 of file KDChartCartesianAxis.cpp.

References d, KDChart::TextAttributes::fontSize(), KDChart::CartesianAxis::hasDefaultTitleTextAttributes(), KDChart::TextAttributes::setFontSize(), and KDChart::AbstractAxis::textAttributes().

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

{
    if( hasDefaultTitleTextAttributes() ){
        TextAttributes ta( textAttributes() );
        Measure me( ta.fontSize() );
        me.setValue( me.value() * 1.5 );
        ta.setFontSize( me );
        return ta;
    }
    return d->titleTextAttributes;
}

int AbstractArea::topOverlap

(

bool

doNotRecalculate = false

)

const [virtual, inherited]

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 93 of file KDChartAbstractArea.cpp.

References d.

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

{
    // Re-calculate the sizes,
    // so we also get the amountOf..Overlap members set newly:
    if( ! doNotRecalculate )
        sizeHint();
    return d->amountOfTopOverlap;
}

LeveyJenningsGridAttributes::GridType LeveyJenningsAxis::type

(

)

const

Returns:

The axis' type.

Definition at line 81 of file KDChartLeveyJenningsAxis.cpp.

References d.

Referenced by compare(), and paintAsOrdinate().

{
    return d->type;
}

void KDChart::AbstractAxis::update

(

)

[slot, inherited]

Definition at line 366 of file KDChartAbstractAxis.cpp.

References d.

Referenced by KDChart::AbstractAxis::connectSignals(), KDChart::CartesianAxis::setAnnotations(), KDChart::AbstractAxis::setLabels(), KDChart::AbstractAxis::setRulerAttributes(), KDChart::AbstractAxis::setShortLabels(), and KDChart::AbstractAxis::setTextAttributes().

{
    if( d->diagram() )
        d->diagram()->update();
}

---

Member Data Documentation

QWidget* KDChart::AbstractLayoutItem::mParent [protected, inherited]

Definition at line 93 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 [protected, inherited]

Definition at line 94 of file KDChartLayoutItems.h.

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

---

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

• KDChartLeveyJenningsAxis.h
• KDChartLeveyJenningsAxis.cpp

---