KDChart::TernaryCoordinatePlane Class Reference

#include <KDChartTernaryCoordinatePlane.h>

Inheritance diagram for KDChart::TernaryCoordinatePlane:

[legend]

Collaboration diagram for KDChart::TernaryCoordinatePlane:

[legend]

List of all members.

---

Detailed Description

Ternary coordinate plane.

Definition at line 42 of file KDChartTernaryCoordinatePlane.h.

Public Types
enum	AxesCalcMode {   Linear,   Logarithmic }
Public Slots
void	layoutPlanes ()
	Calling layoutPlanes() on the plane triggers the global KDChart::Chart::slotLayoutPlanes().
void	relayout ()
	Calling relayout() on the plane triggers the global KDChart::Chart::slotRelayout().
void	setGridNeedsRecalculate ()
	Used by the chart to clear the cached grid data.
void	update ()
	Calling update() on the plane triggers the global KDChart::Chart::update().
Signals
void	destroyedCoordinatePlane (AbstractCoordinatePlane *)
	Emitted when this coordinate plane is destroyed.
void	geometryChanged (QRect, QRect)
	Emitted after the geometry of the Coordinate Plane has been changed.
void	internal_geometryChanged (QRect, QRect)
void	needLayoutPlanes ()
	Emitted when plane needs to trigger the Chart's layouting of the coord.
void	needRelayout ()
	Emitted when plane needs to trigger the Chart's layouting.
void	needUpdate ()
	Emitted when plane needs to update its drawings.
void	positionChanged (AbstractArea *)
void	propertiesChanged ()
	Emitted upon change of a property of the Coordinate Plane or any of its components.
Public Member Functions
void	addDiagram (AbstractDiagram *diagram)
	Adds a diagram to this coordinate plane.
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().
bool	compare (const AbstractAreaBase *other) const
	Returns true if both areas have the same settings.
AbstractDiagram *	diagram ()
	Returns: The first diagram associated with this coordinate plane.
ConstAbstractDiagramList	diagrams () const
	Returns: The list of diagrams associated with this coordinate plane.
AbstractDiagramList	diagrams ()
	Returns: The list of diagrams associated with this coordinate plane.
virtual Qt::Orientations	expandingDirections () const
	pure virtual in QLayoutItem
FrameAttributes	frameAttributes () const
virtual QRect	geometry () const
	pure virtual in QLayoutItem
DataDimensionsList	getDataDimensionsList () const
void	getFrameLeadings (int &left, int &top, int &right, int &bottom) const
GridAttributes	globalGridAttributes () const
	Returns: The grid attributes used by this coordinate plane.
DataDimensionsList	gridDimensionsList ()
	Returns the dimensions used for drawing the grid lines.
virtual bool	isEmpty () const
	pure virtual in QLayoutItem
bool	isRubberBandZoomingEnabled () const
	Returns: Whether zooming with a rubber band using the mouse is enabled.
const bool	isVisiblePoint (const QPointF &point) const
	Tests, if a point is visible on the coordinate plane.
void	layoutDiagrams ()
	Distribute the available space among the diagrams and axes.
virtual int	leftOverlap (bool doNotRecalculate=false) const
	This is called at layout time by KDChart::AutoSpacerLayoutItem::sizeHint().
virtual QSize	maximumSize () const
	pure virtual in QLayoutItem
virtual QSize	minimumSize () const
	pure virtual in QLayoutItem
QSize	minimumSizeHint () const
	[reimplemented]
void	mouseDoubleClickEvent (QMouseEvent *event)
void	mouseMoveEvent (QMouseEvent *event)
void	mousePressEvent (QMouseEvent *event)
void	mouseReleaseEvent (QMouseEvent *event)
void	paint (QPainter *)
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)
virtual void	paintCtx (PaintContext *context)
	Default impl: Paint the complete item using its layouted position and size.
virtual void	paintFrame (QPainter &painter, const QRect &rectangle)
virtual void	paintIntoRect (QPainter &painter, const QRect &rect)
	Draws the background and frame, then calls paint().
const Chart *	parent () const
Chart *	parent ()
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.
void	removeFromParentLayout ()
virtual void	replaceDiagram (AbstractDiagram *diagram, AbstractDiagram *oldDiagram=0)
	Replaces the old diagram, or appends the diagram, it there is none yet.
virtual int	rightOverlap (bool doNotRecalculate=false) const
	This is called at layout time by KDChart::AutoSpacerLayoutItem::sizeHint().
void	setBackgroundAttributes (const BackgroundAttributes &a)
void	setFrameAttributes (const FrameAttributes &a)
virtual void	setGeometry (const QRect &r)
	pure virtual in QLayoutItem
void	setGlobalGridAttributes (const GridAttributes &)
	Set the grid attributes to be used by this coordinate plane.
void	setParent (Chart *parent)
	Called internally by KDChart::Chart.
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.
void	setReferenceCoordinatePlane (AbstractCoordinatePlane *plane)
	Set another coordinate plane to be used as the reference plane for this one.
void	setRubberBandZoomingEnabled (bool enable)
	Enables or disables zooming with a rubber band using the mouse.
virtual void	setZoomCenter (const QPointF &center)
	Set the point (in value coordinates) to be used as the center point in zoom operations.
virtual void	setZoomFactors (double factorX, double factorY)
	Sets both zoom factors in one go.
virtual void	setZoomFactorX (double factor)
	Sets the zoom factor in horizontal direction, that is applied to all coordinate transformations.
virtual void	setZoomFactorY (double factor)
	Sets the zoom factor in vertical direction, that is applied to all coordinate transformations.
virtual AbstractCoordinatePlane *	sharedAxisMasterPlane (QPainter *p=0)
virtual QSize	sizeHint () const
	pure virtual in QLayoutItem
virtual void	sizeHintChanged () const
	Report changed size hint: ask the parent widget to recalculate the layout.
QSizePolicy	sizePolicy () const
	[reimplemented]
virtual void	takeDiagram (AbstractDiagram *diagram)
	Removes the diagram from the plane, without deleting it.
	TernaryCoordinatePlane (Chart *parent=0)
virtual int	topOverlap (bool doNotRecalculate=false) const
	This is called at layout time by KDChart::AutoSpacerLayoutItem::sizeHint().
const QPointF	translate (const QPointF &diagramPoint) const
	Translate the given point in value space coordinates to a position in pixel space.
virtual QPointF	zoomCenter () const
	Returns: The center point (in value coordinates) of the coordinate plane, that is used for zoom operations.
virtual double	zoomFactorX () const
	Returns: The zoom factor in horizontal direction, that is applied to all coordinate transformations.
virtual double	zoomFactorY () const
	Returns: The zoom factor in vertical direction, that is applied to all coordinate transformations.
	~TernaryCoordinatePlane ()
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
virtual QRect	areaGeometry () const
QRect	innerRect () const
virtual void	positionHasChanged ()
Protected Attributes
QWidget *	mParent
QLayout *	mParentLayout

---

Member Enumeration Documentation

enum KDChart::AbstractCoordinatePlane::AxesCalcMode [inherited]

Enumerator:

Linear
Logarithmic

Definition at line 57 of file KDChartAbstractCoordinatePlane.h.

{ Linear, Logarithmic };

---

Constructor & Destructor Documentation

TernaryCoordinatePlane::TernaryCoordinatePlane

(

Chart *

parent = 0

)

[explicit]

Definition at line 52 of file KDChartTernaryCoordinatePlane.cpp.

    : AbstractCoordinatePlane( new Private(), parent )
{
}

TernaryCoordinatePlane::~TernaryCoordinatePlane

(

)

Definition at line 57 of file KDChartTernaryCoordinatePlane.cpp.

{
}

---

Member Function Documentation

void TernaryCoordinatePlane::addDiagram

(

AbstractDiagram *

diagram

)

[virtual]

Adds a diagram to this coordinate plane.

Parameters:

diagram

The diagram to add.

See also:

replaceDiagram, takeDiagram

Reimplemented from KDChart::AbstractCoordinatePlane.

Definition at line 65 of file KDChartTernaryCoordinatePlane.cpp.

References KDChart::AbstractCoordinatePlane::addDiagram().

{
    Q_ASSERT_X ( dynamic_cast<AbstractTernaryDiagram*>( diagram ),
                 "TernaryCoordinatePlane::addDiagram", "Only ternary "
                 "diagrams can be added to a ternary coordinate plane!" );
    AbstractCoordinatePlane::addDiagram ( diagram );
//     connect ( diagram,  SIGNAL ( layoutChanged ( AbstractDiagram* ) ),
//               SLOT ( slotLayoutChanged ( AbstractDiagram* ) ) );
//     connect( diagram, SIGNAL( propertiesChanged() ),this, SIGNAL( propertiesChanged() ) );
}

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 )" );
}

QRect AbstractArea::areaGeometry

(

)

const [protected, virtual, inherited]

Implements KDChart::AbstractAreaBase.

Definition at line 150 of file KDChartAbstractArea.cpp.

Referenced by KDChart::CartesianCoordinatePlane::drawingArea(), layoutDiagrams(), KDChart::PolarCoordinatePlane::layoutDiagrams(), 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());
}

void KDChart::AbstractCoordinatePlane::destroyedCoordinatePlane

(

AbstractCoordinatePlane *

)

[signal, inherited]

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 125 of file KDChartAbstractCoordinatePlane.cpp.

References d.

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

{
    if ( d->diagrams.isEmpty() )
    {
        return 0;
    } else {
        return d->diagrams.first();
    }
}

ConstAbstractDiagramList AbstractCoordinatePlane::diagrams

(

)

const [inherited]

Returns:

The list of diagrams associated with this coordinate plane.

Definition at line 140 of file KDChartAbstractCoordinatePlane.cpp.

References d.

{
    ConstAbstractDiagramList list;
#ifndef QT_NO_STL
    qCopy( d->diagrams.begin(), d->diagrams.end(), std::back_inserter( list ) );
#else
    Q_FOREACH( AbstractDiagram * a, d->diagrams )
        list.push_back( a );
#endif
    return list;

AbstractDiagramList AbstractCoordinatePlane::diagrams

(

)

[inherited]

Returns:

The list of diagrams associated with this coordinate plane.

Definition at line 135 of file KDChartAbstractCoordinatePlane.cpp.

References d.

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

{
    return d->diagrams;
}

Qt::Orientations KDChart::AbstractCoordinatePlane::expandingDirections

(

)

const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 219 of file KDChartAbstractCoordinatePlane.cpp.

{
    return Qt::Vertical | Qt::Horizontal;

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 KDChart::AbstractCoordinatePlane::geometry

(

)

const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 259 of file KDChartAbstractCoordinatePlane.cpp.

References d.

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

{
    return d->geometry;

void KDChart::AbstractCoordinatePlane::geometryChanged	(	QRect	,
		QRect
	)			[signal, inherited]

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

and control has returned to the event loop.

Parameters are the the old geometry, the new geometry.

DataDimensionsList TernaryCoordinatePlane::getDataDimensionsList

(

)

const [virtual]

Implements KDChart::AbstractCoordinatePlane.

Definition at line 200 of file KDChartTernaryCoordinatePlane.cpp.

{   // not needed
    return DataDimensionsList();
}

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;
    }
}

GridAttributes KDChart::AbstractCoordinatePlane::globalGridAttributes

(

)

const [inherited]

Returns:

The grid attributes used by this coordinate plane.

See also:

setGlobalGridAttributes

CartesianCoordinatePlane::gridAttributes

Definition at line 168 of file KDChartAbstractCoordinatePlane.cpp.

References d.

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

{
    return d->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 173 of file KDChartAbstractCoordinatePlane.cpp.

References d.

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

{
    //KDChart::DataDimensionsList l( d->grid->updateData( this ) );
    //qDebug() << "AbstractCoordinatePlane::gridDimensionsList() Y-range:" << l.last().end - l.last().start << "   step width:" << l.last().stepWidth;
    //qDebug() << "AbstractCoordinatePlane::gridDimensionsList() X-range:" << l.first().end - l.first().start << "   step width:" << l.first().stepWidth;
    return d->grid->updateData( this );

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 );
}

void KDChart::AbstractCoordinatePlane::internal_geometryChanged	(	QRect	,
		QRect
	)			[signal, inherited]

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

bool KDChart::AbstractCoordinatePlane::isEmpty

(

)

const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 212 of file KDChartAbstractCoordinatePlane.cpp.

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

{
    return false; // never empty!
    // coordinate planes with no associated diagrams
    // are showing a default grid of ()1..10, 1..10) stepWidth 1

bool KDChart::AbstractCoordinatePlane::isRubberBandZoomingEnabled

(

)

const [inherited]

Returns:

Whether zooming with a rubber band using the mouse is enabled.

Definition at line 293 of file KDChartAbstractCoordinatePlane.cpp.

References d.

{
    return d->enableRubberBandZooming;

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 421 of file KDChartAbstractCoordinatePlane.cpp.

References d.

{
    return d->isVisiblePoint( this, point );

void TernaryCoordinatePlane::layoutDiagrams

(

)

[virtual]

Distribute the available space among the diagrams and axes.

Implements KDChart::AbstractCoordinatePlane.

Definition at line 76 of file KDChartTernaryCoordinatePlane.cpp.

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

{   // this is our "resize event":
    // all diagrams always take the same space, nothing to be done here
    // the "inner" margin (adjustments to diagram coordinates)
    QRectF diagramNativeRectangle ( QPointF( 0.0, 0.0 ),
                                    QSizeF( TriangleWidth, TriangleHeight ) );
    QPair<QSizeF, QSizeF> margins = grid()->requiredMargins();
    d->diagramRect = areaGeometry();
    diagramNativeRectangle.adjust
        (-margins.first.width(), -margins.first.height(),
         margins.second.width(), margins.second.height() );

    // the "outer" margin (distance between diagram contents and area,
    // determined by axis label overlap
    {
        QSizeF topleft( 0.0, 0.0 );
        QSizeF bottomRight( 0.0, 0.0 );
        Q_FOREACH( AbstractDiagram* abstractDiagram, diagrams() ) {
            AbstractTernaryDiagram* diagram =
                qobject_cast<AbstractTernaryDiagram*>( abstractDiagram );
            Q_ASSERT( diagram );
            Q_FOREACH( TernaryAxis* axis, diagram->axes() ) {
                QPair<QSizeF, QSizeF> margin = axis->requiredMargins();
                topleft = topleft.expandedTo( margin.first );
                bottomRight = bottomRight.expandedTo( margin.second );
            }
        }
        d->diagramRectContainer =
            d->diagramRect.adjusted( topleft.width(),
                                     topleft.height(),
                                     -bottomRight.width(),
                                     -bottomRight.height() );
    }

    // now calculate isometric projection, x and y widget coordinate
    // units, and location of (0.0, 0.0) in diagram coordinates
    QPointF zeroZeroPoint = d->diagramRectContainer.bottomLeft();
    double w = d->diagramRectContainer.width();
    double h = d->diagramRectContainer.height();
    double usableWidth;
    double usableHeight;

    if ( TriangleHeight * w > h ) {
        // shorten width:
        usableWidth = h / diagramNativeRectangle.height();
        usableHeight = h;
        zeroZeroPoint.setX( zeroZeroPoint.x() + ( w - usableWidth ) / 2 );
    } else {
        // reduce height:
        usableWidth = w;
        usableHeight = diagramNativeRectangle.height() * w;
        zeroZeroPoint.setY( zeroZeroPoint.y() - ( h - usableHeight ) / 2 );
    }
    // the rectangle has 1 as it's width, and TriangleHeight as it's
    // height - so this is how we translate that to widget coordinates:
    d->xUnit = usableWidth / diagramNativeRectangle.width(); // only because we normalize the values to [0..1]
    d->yUnit = -usableHeight / diagramNativeRectangle.height();

    // now move zeroZeroPoint so that it does not include the tick marks
    {
        double descent = diagramNativeRectangle.height() - TriangleHeight;
        double rightShift = -diagramNativeRectangle.x();
        zeroZeroPoint += QPointF( rightShift * d->xUnit, descent * d->yUnit );
    }

    d->diagramRect.setBottomLeft( zeroZeroPoint );
    d->diagramRect.setTopRight( QPointF( usableWidth, -usableHeight ) + zeroZeroPoint );
}

void KDChart::AbstractCoordinatePlane::layoutPlanes

(

)

[slot, inherited]

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

Definition at line 276 of file KDChartAbstractCoordinatePlane.cpp.

References KDChart::AbstractCoordinatePlane::needLayoutPlanes().

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

{
    //qDebug("KDChart::AbstractCoordinatePlane::relayout() called");
    emit needLayoutPlanes();

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 KDChart::AbstractCoordinatePlane::maximumSize

(

)

const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 224 of file KDChartAbstractCoordinatePlane.cpp.

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

{
    // No maximum size set. Especially not parent()->size(), we are not layouting
    // to the parent widget's size when using Chart::paint()!
    return QSize(QLAYOUTSIZE_MAX, QLAYOUTSIZE_MAX);

QSize KDChart::AbstractCoordinatePlane::minimumSize

(

)

const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 231 of file KDChartAbstractCoordinatePlane.cpp.

{
    return QSize(60, 60); // this default can be overwritten by derived classes

QSize TernaryCoordinatePlane::minimumSizeHint

(

)

const [virtual]

[reimplemented]

Reimplemented from KDChart::AbstractCoordinatePlane.

Definition at line 151 of file KDChartTernaryCoordinatePlane.cpp.

{
    // FIXME temp
    return QSize();
}

void KDChart::AbstractCoordinatePlane::mouseDoubleClickEvent

(

QMouseEvent *

event

)

[inherited]

Definition at line 338 of file KDChartAbstractCoordinatePlane.cpp.

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

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

{
    if( event->button() == Qt::RightButton )
    {
        // othewise the second click gets lost
        // which is pretty annoying when zooming out fast
        mousePressEvent( event );
    }
    KDAB_FOREACH( AbstractDiagram * a, d->diagrams )
    {
        a->mouseDoubleClickEvent( event );
    }

void KDChart::AbstractCoordinatePlane::mouseMoveEvent

(

QMouseEvent *

event

)

[inherited]

Definition at line 402 of file KDChartAbstractCoordinatePlane.cpp.

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

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

{
    if( d->rubberBand != 0 )
    {
        const QRect normalized = QRect( d->rubberBandOrigin, event->pos() ).normalized();
        d->rubberBand->setGeometry( normalized &  geometry() );

        event->accept();
    }

    KDAB_FOREACH( AbstractDiagram * a, d->diagrams )
    {
        a->mouseMoveEvent( event );
    }

void KDChart::AbstractCoordinatePlane::mousePressEvent

(

QMouseEvent *

event

)

[inherited]

Definition at line 298 of file KDChartAbstractCoordinatePlane.cpp.

References KDChart::ZoomParameters::center(), d, p, 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().

{
    if( event->button() == Qt::LeftButton )
    {
        if( d->enableRubberBandZooming && d->rubberBand == 0 )
            d->rubberBand = new QRubberBand( QRubberBand::Rectangle, qobject_cast< QWidget* >( parent() ) );

        if( d->rubberBand != 0 )
        {
            d->rubberBandOrigin = event->pos();
            d->rubberBand->setGeometry( QRect( event->pos(), QSize() ) );
            d->rubberBand->show();

            event->accept();
        }
    }
    else if( event->button() == Qt::RightButton )
    {
        if( d->enableRubberBandZooming && !d->rubberBandZoomConfigHistory.isEmpty() )
        {
            // restore the last config from the stack
            ZoomParameters config = d->rubberBandZoomConfigHistory.pop();
            setZoomFactorX( config.xFactor );
            setZoomFactorY( config.yFactor );
            setZoomCenter( config.center() );

            QWidget* const p = qobject_cast< QWidget* >( parent() );
            if( p != 0 )
                p->update();

            event->accept();
        }
    }

    KDAB_FOREACH( AbstractDiagram * a, d->diagrams )
    {
        a->mousePressEvent( event );
    }

void KDChart::AbstractCoordinatePlane::mouseReleaseEvent

(

QMouseEvent *

event

)

[inherited]

Definition at line 352 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().

{
    if( d->rubberBand != 0 )
    {
        // save the old config on the stack
        d->rubberBandZoomConfigHistory.push( ZoomParameters( zoomFactorX(), zoomFactorY(), zoomCenter() ) );

        // this is the height/width of the rubber band in pixel space
        const double rubberWidth = static_cast< double >( d->rubberBand->width() );
        const double rubberHeight = static_cast< double >( d->rubberBand->height() );

        if( rubberWidth > 0.0 && rubberHeight > 0.0 )
        {
            // this is the center of the rubber band in pixel space
            const double rubberCenterX = static_cast< double >( d->rubberBand->geometry().center().x() - geometry().x() );
            const double rubberCenterY = static_cast< double >( d->rubberBand->geometry().center().y() - geometry().y() );

            // this is the height/width of the plane in pixel space
            const double myWidth = static_cast< double >( geometry().width() );
            const double myHeight = static_cast< double >( geometry().height() );

            // this describes the new center of zooming, relative to the plane pixel space
            const double newCenterX = rubberCenterX / myWidth / zoomFactorX() + zoomCenter().x() - 0.5 / zoomFactorX();
            const double newCenterY = rubberCenterY / myHeight / zoomFactorY() + zoomCenter().y() - 0.5 / zoomFactorY();

            // this will be the new zoom factor
            const double newZoomFactorX = zoomFactorX() * myWidth / rubberWidth;
            const double newZoomFactorY = zoomFactorY() * myHeight / rubberHeight;

            // and this the new center
            const QPointF newZoomCenter( newCenterX, newCenterY );

            setZoomFactorX( newZoomFactorX );
            setZoomFactorY( newZoomFactorY );
            setZoomCenter( newZoomCenter );
        }

        d->rubberBand->parentWidget()->update();
        delete d->rubberBand;
        d->rubberBand = 0;

        event->accept();
    }

    KDAB_FOREACH( AbstractDiagram * a, d->diagrams )
    {
        a->mouseReleaseEvent( event );
    }

void KDChart::AbstractCoordinatePlane::needLayoutPlanes

(

)

[signal, inherited]

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

planes.

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

void KDChart::AbstractCoordinatePlane::needRelayout

(

)

[signal, inherited]

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

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

void KDChart::AbstractCoordinatePlane::needUpdate

(

)

[signal, inherited]

Emitted when plane needs to update its drawings.

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

void TernaryCoordinatePlane::paint

(

QPainter *

painter

)

[virtual]

Implements KDChart::AbstractLayoutItem.

Definition at line 163 of file KDChartTernaryCoordinatePlane.cpp.

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

{
    PainterSaver s( painter );
    // FIXME: this is not a good location for that:
    painter->setRenderHint(QPainter::Antialiasing, true );

//     painter->setPen( QColor( "gold" ) );
//     painter->setBrush( QColor( "gold" ) );
//     painter->drawRect( d->diagramRectContainer );

    AbstractDiagramList diags = diagrams();
    if ( !diags.isEmpty() )
    {
        PaintContext ctx;
        ctx.setPainter ( painter );
        ctx.setCoordinatePlane ( this );
        const QRectF drawArea( areaGeometry() );
        ctx.setRectangle ( drawArea );

        // enabling clipping so that we're not drawing outside
//         QRect clipRect = drawArea.toRect().adjusted( -1, -1, 1, 1 );
//         QRegion clipRegion( clipRect );
//         painter->setClipRegion( clipRegion );

        // paint the coordinate system rulers:
        Q_ASSERT( d->grid != 0 );
        d->grid->drawGrid( &ctx );

        // paint the diagrams:
        for ( int i = 0; i < diags.size(); i++ )
        {
            PainterSaver diagramPainterSaver( painter );
            diags[i]->paint ( &ctx );
        }
    }
}

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 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 KDChart::AbstractLayoutItem::paintCtx

(

PaintContext *

context

)

[virtual, inherited]

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

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

Definition at line 78 of file KDChartLayoutItems.cpp.

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

{
    if( context )
        paint( context->painter() );
}

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 );
}

const KDChart::Chart * KDChart::AbstractCoordinatePlane::parent

(

)

const [inherited]

Definition at line 201 of file KDChartAbstractCoordinatePlane.cpp.

References d.

{
    return d->parent;

KDChart::Chart * KDChart::AbstractCoordinatePlane::parent

(

)

[inherited]

Definition at line 206 of file KDChartAbstractCoordinatePlane.cpp.

References d.

Referenced by KDChart::AbstractCoordinatePlane::mousePressEvent(), KDChart::LeveyJenningsAxis::paintAsAbscissa(), and KDChart::LeveyJenningsAxis::paintAsOrdinate().

{
    return d->parent;

QLayout* KDChart::AbstractLayoutItem::parentLayout

(

)

[inherited]

Definition at line 79 of file KDChartLayoutItems.h.

        {
            return mParentLayout;
        }

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::AbstractCoordinatePlane::propertiesChanged

(

)

[signal, inherited]

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::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 191 of file KDChartAbstractCoordinatePlane.cpp.

References d.

{
    return d->referenceCoordinatePlane;

void KDChart::AbstractCoordinatePlane::relayout

(

)

[slot, inherited]

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

Definition at line 270 of file KDChartAbstractCoordinatePlane.cpp.

References KDChart::AbstractCoordinatePlane::needRelayout().

{
    //qDebug("KDChart::AbstractCoordinatePlane::relayout() called");
    emit needRelayout();

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 AbstractCoordinatePlane::replaceDiagram	(	AbstractDiagram *	diagram,
		AbstractDiagram *	oldDiagram = 0
	)			[virtual, inherited]

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

Parameters:

	diagram	The diagram to be used instead of the old diagram. This parameter must not be zero, or the method will do nothing.
	oldDiagram	The 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 90 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().

{
    if( diagram && oldDiagram_ != diagram ){
        AbstractDiagram* oldDiagram = oldDiagram_;
        if( d->diagrams.count() ){
            if( ! oldDiagram ){
                oldDiagram = d->diagrams.first();
                if( oldDiagram == diagram )
                    return;
            }
            takeDiagram( oldDiagram );
        }
        delete oldDiagram;
        addDiagram( diagram );
        layoutDiagrams();
        layoutPlanes(); // there might be new axes, etc
        update();
    }
}

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;
}

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 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 KDChart::AbstractCoordinatePlane::setGeometry

(

const QRect &

r

)

[virtual, inherited]

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.

Reimplemented in KDChart::CartesianCoordinatePlane.

Definition at line 243 of file KDChartAbstractCoordinatePlane.cpp.

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

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

{
//    qDebug() << "KDChart::AbstractCoordinatePlane::setGeometry(" << r << ") called";
    if( d->geometry != r ){
        //qDebug() << "entering KDChart::AbstractCoordinatePlane::setGeometry(" << r << ")";
        // inform the outside word by Signal geometryChanged()
        // via a queued connection to internal_geometryChanged()
        emit internal_geometryChanged( d->geometry, r );

        d->geometry = r;
        // Note: We do *not* call update() here
        //       because it would invoke KDChart::update() recursively.
        //qDebug() << "leaving  KDChart::AbstractCoordinatePlane::setGeometry(" << r << ")";
    }

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 162 of file KDChartAbstractCoordinatePlane.cpp.

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

{
    d->gridAttributes = a;
    update();

void KDChart::AbstractCoordinatePlane::setGridNeedsRecalculate

(

)

[slot, inherited]

Used by the chart to clear the cached grid data.

Definition at line 181 of file KDChartAbstractCoordinatePlane.cpp.

References d.

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

{
    d->grid->setNeedRecalculate();

void KDChart::AbstractCoordinatePlane::setParent

(

KDChart::Chart *

parent

)

[inherited]

Called internally by KDChart::Chart.

Definition at line 196 of file KDChartAbstractCoordinatePlane.cpp.

References d.

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

{
    d->parent = parent;

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 KDChart::AbstractCoordinatePlane::setReferenceCoordinatePlane

(

AbstractCoordinatePlane *

plane

)

[inherited]

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

Parameters:

plane

The coordinate plane to be used the reference plane for this one.

See also:

referenceCoordinatePlane

Definition at line 186 of file KDChartAbstractCoordinatePlane.cpp.

References d.

{
    d->referenceCoordinatePlane = plane;

void KDChart::AbstractCoordinatePlane::setRubberBandZoomingEnabled

(

bool

enable

)

[inherited]

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

Definition at line 282 of file KDChartAbstractCoordinatePlane.cpp.

References d.

{
    d->enableRubberBandZooming = enable;

    if( !enable && d->rubberBand != 0 )
    {
        delete d->rubberBand;
        d->rubberBand = 0;
    }

virtual void KDChart::AbstractCoordinatePlane::setZoomCenter

(

const QPointF &

center

)

[virtual, inherited]

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

Parameters:

center

The point to use.

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

Definition at line 188 of file KDChartAbstractCoordinatePlane.h.

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

{ Q_UNUSED( center ); }

virtual void KDChart::AbstractCoordinatePlane::setZoomFactors	(	double	factorX,
		double	factorY
	)			[virtual, inherited]

Sets both zoom factors in one go.

See also:

setZoomFactorX,setZoomFactorY

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

Definition at line 161 of file KDChartAbstractCoordinatePlane.h.

{ Q_UNUSED( factorX ); Q_UNUSED( factorY ); }

virtual void KDChart::AbstractCoordinatePlane::setZoomFactorX

(

double

factor

)

[virtual, inherited]

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

Parameters:

factor

The new zoom factor

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

Definition at line 168 of file KDChartAbstractCoordinatePlane.h.

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

{ Q_UNUSED( factor ); }

virtual void KDChart::AbstractCoordinatePlane::setZoomFactorY

(

double

factor

)

[virtual, inherited]

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

Parameters:

factor

The new zoom factor

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

Definition at line 175 of file KDChartAbstractCoordinatePlane.h.

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

{ Q_UNUSED( factor ); }

AbstractCoordinatePlane * KDChart::AbstractCoordinatePlane::sharedAxisMasterPlane

(

QPainter *

p = 0

)

[virtual, inherited]

Reimplemented in KDChart::CartesianCoordinatePlane.

Definition at line 426 of file KDChartAbstractCoordinatePlane.cpp.

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

{
    Q_UNUSED( p );
    return this;

QSize KDChart::AbstractCoordinatePlane::sizeHint

(

)

const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 236 of file KDChartAbstractCoordinatePlane.cpp.

References KDChart::AbstractCoordinatePlane::maximumSize().

{
    // we return our maxiumu (which is the full size of the Chart)
    // even if we know the plane will be smaller
    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 ) );
    }
}

QSizePolicy TernaryCoordinatePlane::sizePolicy

(

)

const [virtual]

[reimplemented]

Reimplemented from KDChart::AbstractCoordinatePlane.

Definition at line 157 of file KDChartTernaryCoordinatePlane.cpp.

{
    return QSizePolicy( QSizePolicy::MinimumExpanding,
                        QSizePolicy::MinimumExpanding );
}

void AbstractCoordinatePlane::takeDiagram

(

AbstractDiagram *

diagram

)

[virtual, inherited]

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

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

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

{
    const int idx = d->diagrams.indexOf( diagram );
    if( idx != -1 ){
        d->diagrams.removeAt( idx );
        diagram->setParent( 0 );
        diagram->setCoordinatePlane( 0 );
        disconnect( diagram, SIGNAL( modelsChanged() ), this, SLOT( layoutPlanes() ) );
        layoutDiagrams();
        update();
    }
}

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;
}

const QPointF TernaryCoordinatePlane::translate

(

const QPointF &

diagramPoint

)

const [virtual]

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

Parameters:

diagramPoint

The point in value coordinates.

Returns:

The translated point.

Implements KDChart::AbstractCoordinatePlane.

Definition at line 145 of file KDChartTernaryCoordinatePlane.cpp.

References d.

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

{
    return QPointF( d->diagramRect.bottomLeft().x() + point.x() * d->xUnit,
                    d->diagramRect.bottomLeft().y() + point.y() * d->yUnit );
}

void KDChart::AbstractCoordinatePlane::update

(

)

[slot, inherited]

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

Definition at line 264 of file KDChartAbstractCoordinatePlane.cpp.

References KDChart::AbstractCoordinatePlane::needUpdate().

Referenced by KDChart::AbstractCoordinatePlane::addDiagram(), KDChart::PolarCoordinatePlane::adjustZoomAndRepaint(), 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().

{
    //qDebug("KDChart::AbstractCoordinatePlane::update() called");
    emit needUpdate();

virtual QPointF KDChart::AbstractCoordinatePlane::zoomCenter

(

)

const [virtual, inherited]

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 181 of file KDChartAbstractCoordinatePlane.h.

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

{ return QPointF(0.0, 0.0); }

virtual double KDChart::AbstractCoordinatePlane::zoomFactorX

(

)

const [virtual, inherited]

Returns:

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

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

Definition at line 149 of file KDChartAbstractCoordinatePlane.h.

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

{ return 1.0; }

virtual double KDChart::AbstractCoordinatePlane::zoomFactorY

(

)

const [virtual, inherited]

Returns:

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

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

Definition at line 155 of file KDChartAbstractCoordinatePlane.h.

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

{ return 1.0; }

---

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:

• KDChartTernaryCoordinatePlane.h
• KDChartTernaryCoordinatePlane.cpp

---