KDChart::Chart Class Reference

#include <KDChartChart>

Inheritance diagram for KDChart::Chart:

[legend]

Collaboration diagram for KDChart::Chart:

[legend]

List of all members.

---

Detailed Description

A chart with one or more diagrams.

The Chart class represents a drawing consisting of one or more diagrams and various optional elements such as legends, axes, text boxes, headers or footers. It takes ownership of all these elements when they are assigned to it. Each diagram is associated with a coordinate plane, of which the chart can have more than one. The coordinate planes (and thus the associated diagrams) can be laid out in various ways.

The Chart class makes heavy use of the Qt Interview framework for model/view programming, and thus requires data to be presented to it in a QAbstractItemModel compatible way. For many simple charts, especially if the visualized data is static, KDChart::Widget provides an abstracted interface, that hides the complexity of Interview to a large extent.

Definition at line 72 of file KDChartChart.h.

Signals
void	propertiesChanged ()
	Emitted upon change of a property of the Chart or any of its components.
Public Member Functions
void	addCoordinatePlane (AbstractCoordinatePlane *plane)
	Adds a coordinate plane to the chart.
void	addHeaderFooter (HeaderFooter *headerFooter)
	Adds a header or a footer to the chart.
void	addLegend (Legend *legend)
	Add the given legend to the chart.
BackgroundAttributes	backgroundAttributes () const
	Chart (QWidget *parent=0)
AbstractCoordinatePlane *	coordinatePlane ()
	Each chart must have at least one coordinate plane.
QLayout *	coordinatePlaneLayout ()
CoordinatePlaneList	coordinatePlanes ()
	The list of coordinate planes.
FrameAttributes	frameAttributes () const
int	globalLeadingBottom () const
	The padding between the start of the widget and the start of the area that is used for drawing at the bottom.
int	globalLeadingLeft () const
	The padding between the start of the widget and the start of the area that is used for drawing on the left.
int	globalLeadingRight () const
	The padding between the start of the widget and the start of the area that is used for drawing on the right.
int	globalLeadingTop () const
	The padding between the start of the widget and the start of the area that is used for drawing at the top.
HeaderFooter *	headerFooter ()
	The first header or footer of the chart.
HeaderFooterList	headerFooters ()
	The list of headers and footers associated with the chart.
Legend *	legend ()
	The first legend of the chart or 0 if there was none added to the chart.
LegendList	legends ()
	The list of all legends associated with the chart.
void	paint (QPainter *painter, const QRect &target)
	Paints all the contents of the chart.
void	reLayoutFloatingLegends ()
void	replaceCoordinatePlane (AbstractCoordinatePlane *plane, AbstractCoordinatePlane *oldPlane=0)
	Replaces the old coordinate plane, or appends the plane, it there is none yet.
void	replaceHeaderFooter (HeaderFooter *headerFooter, HeaderFooter *oldHeaderFooter=0)
	Replaces the old header (or footer, resp.
void	replaceLegend (Legend *legend, Legend *oldLegend=0)
	Replaces the old legend, or appends the new legend, it there is none yet.
void	setBackgroundAttributes (const BackgroundAttributes &a)
	Specify the background attributes to be used, by default there is no background.
void	setCoordinatePlaneLayout (QLayout *layout)
	Set the coordinate plane layout that should be used as model for the internal used layout.
void	setFrameAttributes (const FrameAttributes &a)
	Specify the frame attributes to be used, by default is it a thin black line.
void	setGlobalLeading (int left, int top, int right, int bottom)
	Set the padding between the margin of the widget and the area that the contents are drawn into.
void	setGlobalLeadingBottom (int leading)
	Set the padding between the start of the widget and the start of the area that is used for drawing on the bottom.
void	setGlobalLeadingLeft (int leading)
	Set the padding between the start of the widget and the start of the area that is used for drawing on the left.
void	setGlobalLeadingRight (int leading)
	Set the padding between the start of the widget and the start of the area that is used for drawing on the right.
void	setGlobalLeadingTop (int leading)
	Set the padding between the start of the widget and the start of the area that is used for drawing at the top.
void	takeCoordinatePlane (AbstractCoordinatePlane *plane)
	Removes the coordinate plane from the chart, without deleting it.
void	takeHeaderFooter (HeaderFooter *headerFooter)
	Removes the header (or footer, resp.
void	takeLegend (Legend *legend)
	Removes the legend from the chart, without deleting it.
	~Chart ()
Protected Member Functions
bool	event (QEvent *event)
	reimp
void	mouseDoubleClickEvent (QMouseEvent *event)
	reimp
void	mouseMoveEvent (QMouseEvent *event)
	reimp
void	mousePressEvent (QMouseEvent *event)
	reimp
void	mouseReleaseEvent (QMouseEvent *event)
	reimp
void	paintEvent (QPaintEvent *event)
	Draws the background and frame, then calls paint().
void	resizeEvent (QResizeEvent *event)
	Adjusts the internal layout when the chart is resized.
Properties
int	globalLeadingBottom
int	globalLeadingLeft
int	globalLeadingRight
int	globalLeadingTop

---

Constructor & Destructor Documentation

Chart::Chart

(

QWidget *

parent = 0

)

[explicit]

Definition at line 861 of file KDChartChart.cpp.

References addCoordinatePlane(), setFrameAttributes(), KDChart::FrameAttributes::setPadding(), and KDChart::FrameAttributes::setPen().

    : QWidget ( parent )
    , _d( new Private( this ) )
{
    FrameAttributes frameAttrs;
// no frame per default...
//    frameAttrs.setVisible( true );
    frameAttrs.setPen( QPen( Qt::black ) );
    frameAttrs.setPadding( 1 );
    setFrameAttributes( frameAttrs );

    addCoordinatePlane( new CartesianCoordinatePlane ( this ) );
}

Chart::~Chart

(

)

Definition at line 875 of file KDChartChart.cpp.

{
    delete _d;
}

---

Member Function Documentation

void Chart::addCoordinatePlane

(

AbstractCoordinatePlane *

plane

)

Adds a coordinate plane to the chart.

The chart takes ownership.

Parameters:

plane

The coordinate plane to add.

See also:

replaceCoordinatePlane, takeCoordinatePlane

Definition at line 931 of file KDChartChart.cpp.

References d, propertiesChanged(), and KDChart::AbstractCoordinatePlane::setParent().

Referenced by Chart(), and replaceCoordinatePlane().

{
    connect( plane, SIGNAL( destroyedCoordinatePlane( AbstractCoordinatePlane* ) ),
             d,   SLOT( slotUnregisterDestroyedPlane( AbstractCoordinatePlane* ) ) );
    connect( plane, SIGNAL( needUpdate() ),       this,   SLOT( update() ) );
    connect( plane, SIGNAL( needRelayout() ),     d,      SLOT( slotRelayout() ) ) ;
    connect( plane, SIGNAL( needLayoutPlanes() ), d,      SLOT( slotLayoutPlanes() ) ) ;
    connect( plane, SIGNAL( propertiesChanged() ),this, SIGNAL( propertiesChanged() ) );
    d->coordinatePlanes.append( plane );
    plane->setParent( this );
    d->slotLayoutPlanes();
}

void Chart::addHeaderFooter

(

HeaderFooter *

headerFooter

)

Adds a header or a footer to the chart.

The chart takes ownership.

Parameters:

headerFooter

The header (or footer, resp.) to add.

See also:

replaceHeaderFooter, takeHeaderFooter

Definition at line 1151 of file KDChartChart.cpp.

References d, and KDChart::HeaderFooter::setParent().

Referenced by replaceHeaderFooter().

{
    d->headerFooters.append( headerFooter );
    headerFooter->setParent( this );
    connect( headerFooter, SIGNAL( destroyedHeaderFooter( HeaderFooter* ) ),
             d, SLOT( slotUnregisterDestroyedHeaderFooter( HeaderFooter* ) ) );
    connect( headerFooter, SIGNAL( positionChanged( HeaderFooter* ) ),
             d, SLOT( slotRelayout() ) );
    d->slotRelayout();
}

void Chart::addLegend

(

Legend *

legend

)

Add the given legend to the chart.

The chart takes ownership.

Parameters:

legend

The legend to add.

See also:

replaceLegend, takeLegend

Definition at line 1209 of file KDChartChart.cpp.

References d, KDChartEnums::MeasureOrientationMinimum, propertiesChanged(), KDChart::TextAttributes::setFontSize(), KDChart::Legend::setReferenceArea(), KDChart::Legend::setTextAttributes(), KDChart::Legend::setTitleTextAttributes(), KDChart::Legend::setVisible(), KDChart::Legend::textAttributes(), and KDChart::Legend::titleTextAttributes().

Referenced by replaceLegend().

{
    if( ! legend ) return;

    //qDebug() << "adding the legend";
    d->legends.append( legend );
    legend->setParent( this );

    TextAttributes textAttrs( legend->textAttributes() );

    KDChart::Measure measure( textAttrs.fontSize() );
    measure.setRelativeMode( this, KDChartEnums::MeasureOrientationMinimum );
    measure.setValue( 20 );
    textAttrs.setFontSize( measure );
    legend->setTextAttributes( textAttrs );

    textAttrs = legend->titleTextAttributes();
    measure.setRelativeMode( this, KDChartEnums::MeasureOrientationMinimum );
    measure.setValue( 24 );
    textAttrs.setFontSize( measure );

    legend->setTitleTextAttributes( textAttrs );

    legend->setReferenceArea( this );

/*
    future: Use relative sizes for the markers too!

    const uint nMA = Legend::datasetCount();
    for( uint iMA = 0; iMA < nMA; ++iMA ){
        MarkerAttributes ma( legend->markerAttributes( iMA ) );
        ma.setMarkerSize( ... )
        legend->setMarkerAttributes( iMA, ma )
    }
*/

    connect( legend, SIGNAL( destroyedLegend( Legend* ) ),
             d, SLOT( slotUnregisterDestroyedLegend( Legend* ) ) );
    connect( legend, SIGNAL( positionChanged( AbstractAreaWidget* ) ),
             d, SLOT( slotLayoutPlanes() ) ); //slotRelayout() ) );
    connect( legend, SIGNAL( propertiesChanged() ),
             this,   SIGNAL( propertiesChanged() ) );
    legend->setVisible( true );
    d->slotRelayout();
}

BackgroundAttributes Chart::backgroundAttributes

(

)

const

Definition at line 897 of file KDChartChart.cpp.

References d.

{
    return d->backgroundAttributes;
}

AbstractCoordinatePlane * Chart::coordinatePlane

(

)

Each chart must have at least one coordinate plane.

Initially a default CartesianCoordinatePlane is created. Use replaceCoordinatePlane() to replace it with a different one, such as a PolarCoordinatePlane.

Returns:

The first coordinate plane of the chart.

Definition at line 915 of file KDChartChart.cpp.

References d.

{
    if ( d->coordinatePlanes.isEmpty() )
    {
        qWarning() << "Chart::coordinatePlane: warning: no coordinate plane defined.";
        return 0;
    } else {
        return d->coordinatePlanes.first();
    }
}

QLayout * Chart::coordinatePlaneLayout

(

)

Definition at line 910 of file KDChartChart.cpp.

References d.

{
    return d->planesLayout;
}

CoordinatePlaneList Chart::coordinatePlanes

(

)

The list of coordinate planes.

Returns:

The list of coordinate planes.

Definition at line 926 of file KDChartChart.cpp.

References d.

{
    return d->coordinatePlanes;
}

bool Chart::event

(

QEvent *

event

)

[protected]

reimp

Definition at line 1576 of file KDChartChart.cpp.

References d, KDChart::AbstractCoordinatePlane::diagrams(), and KDChart::AbstractDiagram::indexAt().

{
    switch( event->type() )
    {
    case QEvent::ToolTip:
    {
        const QHelpEvent* const helpEvent = static_cast< QHelpEvent* >( event );
        KDAB_FOREACH( const AbstractCoordinatePlane* const plane, d->coordinatePlanes )
        {
            KDAB_FOREACH( const AbstractDiagram* const diag, plane->diagrams() )
            {
                const QModelIndex index = diag->indexAt( helpEvent->pos() );
                const QVariant toolTip = index.data( Qt::ToolTipRole );
                if( toolTip.isValid() )
                {
                    QToolTip::showText( helpEvent->globalPos(), toolTip.toString() );
                    return true;
                }
            }
        }
        // fall-through intended
    }
    default:
        return QWidget::event( event );
    }
}

FrameAttributes Chart::frameAttributes

(

)

const

Definition at line 887 of file KDChartChart.cpp.

References d.

{
    return d->frameAttributes;
}

int KDChart::Chart::globalLeadingBottom

(

)

const

The padding between the start of the widget and the start of the area that is used for drawing at the bottom.

Returns:

The padding between the start of the widget and the start of the area that is used for drawing at the bottom.

See also:

setGlobalLeading

int KDChart::Chart::globalLeadingLeft

(

)

const

The padding between the start of the widget and the start of the area that is used for drawing on the left.

Returns:

The padding between the start of the widget and the start of the area that is used for drawing on the left.

See also:

setGlobalLeading

int KDChart::Chart::globalLeadingRight

(

)

const

The padding between the start of the widget and the start of the area that is used for drawing on the right.

Returns:

The padding between the start of the widget and the start of the area that is used for drawing on the right.

See also:

setGlobalLeading

int KDChart::Chart::globalLeadingTop

(

)

const

The padding between the start of the widget and the start of the area that is used for drawing at the top.

Returns:

The padding between the start of the widget and the start of the area that is used for drawing at the top.

See also:

setGlobalLeading

HeaderFooter * Chart::headerFooter

(

)

The first header or footer of the chart.

By default there is none.

Returns:

The first header or footer of the chart or 0 if there was none added to the chart.

Definition at line 1195 of file KDChartChart.cpp.

References d.

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

HeaderFooterList Chart::headerFooters

(

)

The list of headers and footers associated with the chart.

Returns:

The list of headers and footers associated with the chart.

Definition at line 1204 of file KDChartChart.cpp.

References d.

{
    return d->headerFooters;
}

Legend * Chart::legend

(

)

The first legend of the chart or 0 if there was none added to the chart.

Returns:

The first legend of the chart or 0 if none exists.

Definition at line 1296 of file KDChartChart.cpp.

References d.

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

LegendList Chart::legends

(

)

The list of all legends associated with the chart.

Returns:

The list of all legends associated with the chart.

Definition at line 1306 of file KDChartChart.cpp.

References d.

{
    return d->legends;
}

void Chart::mouseDoubleClickEvent

(

QMouseEvent *

event

)

[protected]

reimp

Definition at line 1503 of file KDChartChart.cpp.

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

{
    const QPoint pos = mapFromGlobal( event->globalPos() );

    KDAB_FOREACH( AbstractCoordinatePlane* plane, d->coordinatePlanes )
    {
        if ( plane->geometry().contains( event->pos() ) )
        {
            if ( plane->diagrams().size() > 0 )
            {
                QMouseEvent ev( QEvent::MouseButtonPress, pos, event->globalPos(),
                                event->button(), event->buttons(),
                                event->modifiers() );
                plane->mouseDoubleClickEvent( &ev );
            }
        }
    }
}

void Chart::mouseMoveEvent

(

QMouseEvent *

event

)

[protected]

reimp

Definition at line 1522 of file KDChartChart.cpp.

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

{
    QSet< AbstractCoordinatePlane* > eventReceivers = QSet< AbstractCoordinatePlane* >::fromList( d->mouseClickedPlanes );

    KDAB_FOREACH( AbstractCoordinatePlane* plane, d->coordinatePlanes )
    {
        if( plane->geometry().contains( event->pos() ) )
        {
            if( plane->diagrams().size() > 0 )
            {
                eventReceivers.insert( plane );
            }
        }
    }

    const QPoint pos = mapFromGlobal( event->globalPos() );

    KDAB_FOREACH( AbstractCoordinatePlane* plane, eventReceivers )
    {
        QMouseEvent ev( QEvent::MouseMove, pos, event->globalPos(),
                         event->button(), event->buttons(),
                         event->modifiers() );
        plane->mouseMoveEvent( &ev );
    }
}

void Chart::mousePressEvent

(

QMouseEvent *

event

)

[protected]

reimp

Definition at line 1312 of file KDChartChart.cpp.

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

{
    const QPoint pos = mapFromGlobal( event->globalPos() );

    KDAB_FOREACH( AbstractCoordinatePlane* plane, d->coordinatePlanes )
    {
        if ( plane->geometry().contains( event->pos() ) )
        {
            if ( plane->diagrams().size() > 0 )
            {
                QMouseEvent ev( QEvent::MouseButtonPress, pos, event->globalPos(),
                                event->button(), event->buttons(),
                                event->modifiers() );

                plane->mousePressEvent( &ev );
                d->mouseClickedPlanes.append( plane );
           }
       }
    }
}

void Chart::mouseReleaseEvent

(

QMouseEvent *

event

)

[protected]

reimp

Definition at line 1548 of file KDChartChart.cpp.

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

{
    QSet< AbstractCoordinatePlane* > eventReceivers = QSet< AbstractCoordinatePlane* >::fromList( d->mouseClickedPlanes );

    KDAB_FOREACH( AbstractCoordinatePlane* plane, d->coordinatePlanes )
    {
        if ( plane->geometry().contains( event->pos() ) )
        {
            if( plane->diagrams().size() > 0 )
            {
                eventReceivers.insert( plane );
            }
        }
    }

    const QPoint pos = mapFromGlobal( event->globalPos() );

    KDAB_FOREACH( AbstractCoordinatePlane* plane, eventReceivers )
    {
        QMouseEvent ev( QEvent::MouseButtonRelease, pos, event->globalPos(),
                         event->button(), event->buttons(),
                         event->modifiers() );
        plane->mouseReleaseEvent( &ev );
    }

    d->mouseClickedPlanes.clear();
}

void Chart::paint	(	QPainter *	painter,
		const QRect &	target
	)

Paints all the contents of the chart.

Use this method, to make KDChart draw into your QPainter.

Note:

Any global leading settings will be used by the paint method too, so make sure to set them to zero, if you want the drawing to have the exact size of the target rectangle.

Parameters:

	painter	The painter to be drawn into.
	target	The rectangle to be filled by the Chart's drawing.

See also:

setGlobalLeading

Definition at line 1031 of file KDChartChart.cpp.

References d, KDChart::GlobalMeasureScaling::instance(), KDChart::GlobalMeasureScaling::paintDevice(), KDChart::AbstractAreaWidget::paintIntoRect(), KDChart::GlobalMeasureScaling::resetFactors(), KDChart::PrintingParameters::resetScaleFactor(), KDChart::GlobalMeasureScaling::setFactors(), KDChart::GlobalMeasureScaling::setPaintDevice(), and KDChart::PrintingParameters::setScaleFactor().

{
    if( target.isEmpty() || !painter ) return;
    //qDebug() << "Chart::paint( ..," << target << ")";

    QPaintDevice* prevDevice = GlobalMeasureScaling::paintDevice();
    GlobalMeasureScaling::setPaintDevice( painter->device() );

    // Output on a widget
    if( dynamic_cast< QWidget* >( painter->device() ) != 0 )
    {
        GlobalMeasureScaling::setFactors(
                static_cast< qreal >( target.width() ) /
                static_cast< qreal >( geometry().size().width() ),
                static_cast< qreal >( target.height() ) /
                static_cast< qreal >( geometry().size().height() ) );
    }
    // Output onto a QPixmap 
    else
    {
        PrintingParameters::setScaleFactor( static_cast< qreal >( painter->device()->logicalDpiX() ) / static_cast< qreal >( logicalDpiX() ) );

        const qreal resX = static_cast< qreal >( logicalDpiX() ) / static_cast< qreal >( painter->device()->logicalDpiX() );
        const qreal resY = static_cast< qreal >( logicalDpiY() ) / static_cast< qreal >( painter->device()->logicalDpiY() );

        GlobalMeasureScaling::setFactors(
                static_cast< qreal >( target.width() ) /
                static_cast< qreal >( geometry().size().width() ) * resX,
                static_cast< qreal >( target.height() ) /
                static_cast< qreal >( geometry().size().height() ) * resY );
    }


    if( target.size() != d->currentLayoutSize ){
        d->resizeLayout( target.size() );
    }
    const QPoint translation = target.topLeft();
    painter->translate( translation );

    d->paintAll( painter );

    // for debugging:
    //painter->setPen(QPen(Qt::blue, 8));
    //painter->drawRect(target.adjusted(12,12,-12,-12));

    KDAB_FOREACH( Legend *legend, d->legends ) {
        const bool hidden = legend->isHidden() && legend->testAttribute(Qt::WA_WState_ExplicitShowHide);
        if ( !hidden ) {
            //qDebug() << "painting legend at " << legend->geometry();
            legend->paintIntoRect( *painter, legend->geometry() );
            //testing:
            //legend->paintIntoRect( *painter, legend->geometry().adjusted(-100,0,-100,0) );
        }
    }

    painter->translate( -translation.x(), -translation.y() );

    GlobalMeasureScaling::instance()->resetFactors();
    PrintingParameters::resetScaleFactor();
    GlobalMeasureScaling::setPaintDevice( prevDevice );

    //qDebug() << "KDChart::Chart::paint() done.\n";
}

void Chart::paintEvent

(

QPaintEvent *

event

)

[protected]

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

In most cases there is no need to override this method in a derived class, but if you do, do not forget to call paint().

See also:

paint

Definition at line 1137 of file KDChartChart.cpp.

References d, and reLayoutFloatingLegends().

{
    QPainter painter( this );

    if( size() != d->currentLayoutSize ){
        d->resizeLayout( size() );
        reLayoutFloatingLegends();
    }

    //FIXME(khz): Paint the background/frame too!
    //            (can we derive Chart from AreaWidget ??)
    d->paintAll( &painter );
}

void KDChart::Chart::propertiesChanged

(

)

[signal]

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

Referenced by addCoordinatePlane(), addLegend(), takeCoordinatePlane(), takeHeaderFooter(), and takeLegend().

void Chart::reLayoutFloatingLegends

(

)

Definition at line 1105 of file KDChartChart.cpp.

References d, KDChart::Legend::floatingPosition(), KDChart::Position::isFloating(), KDChart::Legend::position(), and KDChart::Legend::sizeHint().

Referenced by paintEvent(), and resizeEvent().

{
    KDAB_FOREACH( Legend *legend, d->legends ) {
        const bool hidden = legend->isHidden() && legend->testAttribute(Qt::WA_WState_ExplicitShowHide);
        if ( legend->position().isFloating() && !hidden ){
            // resize the legend
            const QSize legendSize( legend->sizeHint() );
            legend->setGeometry( QRect( legend->geometry().topLeft(), legendSize ) );
            // find the legends corner point (reference point plus any paddings)
            const RelativePosition relPos( legend->floatingPosition() );
            QPointF pt( relPos.calculatedPoint( size() ) );
            //qDebug() << pt;
            // calculate the legend's top left point
            const Qt::Alignment alignTopLeft = Qt::AlignBottom | Qt::AlignLeft;
            if( (relPos.alignment() & alignTopLeft) != alignTopLeft ){
                if( relPos.alignment() & Qt::AlignRight )
                    pt.rx() -= legendSize.width();
                else if( relPos.alignment() & Qt::AlignHCenter )
                    pt.rx() -= 0.5 * legendSize.width();

                if( relPos.alignment() & Qt::AlignBottom )
                    pt.ry() -= legendSize.height();
                else if( relPos.alignment() & Qt::AlignVCenter )
                    pt.ry() -= 0.5 * legendSize.height();
            }
            //qDebug() << pt << endl;
            legend->move( static_cast<int>(pt.x()), static_cast<int>(pt.y()) );
        }
    }
}

void Chart::replaceCoordinatePlane	(	AbstractCoordinatePlane *	plane,
		AbstractCoordinatePlane *	oldPlane = 0
	)

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

Parameters:

	plane	The coordinate plane to be used instead of the old plane. This parameter must not be zero, or the method will do nothing.
	oldPlane	The coordinate plane to be removed by the new plane. This plane will be deleted automatically. If the parameter is omitted, the very first coordinate plane will be replaced. In case, there was no plane yet, the new plane will just be added.

Note:

If you want to re-use the old coordinate plane, call takeCoordinatePlane and addCoordinatePlane, instead of using replaceCoordinatePlane.

See also:

addCoordinatePlane, takeCoordinatePlane

Definition at line 944 of file KDChartChart.cpp.

References addCoordinatePlane(), d, and takeCoordinatePlane().

{
    if( plane && oldPlane_ != plane ){
        AbstractCoordinatePlane* oldPlane = oldPlane_;
        if( d->coordinatePlanes.count() ){
            if( ! oldPlane ){
                oldPlane = d->coordinatePlanes.first();
                if( oldPlane == plane )
                    return;
            }
            takeCoordinatePlane( oldPlane );
        }
        delete oldPlane;
        addCoordinatePlane( plane );
    }
}

void Chart::replaceHeaderFooter	(	HeaderFooter *	headerFooter,
		HeaderFooter *	oldHeaderFooter = 0
	)

Replaces the old header (or footer, resp.

), or appends the new header or footer, it there is none yet.

Parameters:

	headerFooter	The header or footer to be used instead of the old one. This parameter must not be zero, or the method will do nothing.
	oldHeaderFooter	The header or footer to be removed by the new one. This header or footer will be deleted automatically. If the parameter is omitted, the very first header or footer will be replaced. In case, there was no header and no footer yet, the new header or footer will just be added.

Note:

If you want to re-use the old header or footer, call takeHeaderFooter and addHeaderFooter, instead of using replaceHeaderFooter.

See also:

addHeaderFooter, takeHeaderFooter

Definition at line 1162 of file KDChartChart.cpp.

References addHeaderFooter(), d, and takeHeaderFooter().

{
    if( headerFooter && oldHeaderFooter_ != headerFooter ){
        HeaderFooter* oldHeaderFooter = oldHeaderFooter_;
        if( d->headerFooters.count() ){
            if( ! oldHeaderFooter ){
                oldHeaderFooter =  d->headerFooters.first();
                if( oldHeaderFooter == headerFooter )
                    return;
            }
            takeHeaderFooter( oldHeaderFooter );
        }
        delete oldHeaderFooter;
        addHeaderFooter( headerFooter );
    }
}

void Chart::replaceLegend	(	Legend *	legend,
		Legend *	oldLegend = 0
	)

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

Parameters:

	legend	The legend to be used instead of the old one. This parameter must not be zero, or the method will do nothing.
	oldLegend	The legend to be removed by the new one. This legend will be deleted automatically. If the parameter is omitted, the very first legend will be replaced. In case, there was no legend yet, the new legend will just be added.

If you want to re-use the old legend, call takeLegend and addLegend, instead of using replaceLegend.

Note:

Whenever addLegend is called the font sizes used by the Legend are set to relative and they get coupled to the Chart's size, with their relative values being 20 for the item texts and 24 to the title text. So if you want to use custom font sizes for the Legend make sure to set them after calling addLegend.

See also:

addLegend, takeLegend

Definition at line 1256 of file KDChartChart.cpp.

References addLegend(), d, and takeLegend().

{
    if( legend && oldLegend_ != legend ){
        Legend* oldLegend = oldLegend_;
        if( d->legends.count() ){
            if( ! oldLegend ){
                oldLegend = d->legends.first();
                if( oldLegend == legend )
                    return;
            }
            takeLegend( oldLegend );
        }
        delete oldLegend;
        addLegend( legend );
    }
}

void Chart::resizeEvent

(

QResizeEvent *

event

)

[protected]

Adjusts the internal layout when the chart is resized.

Definition at line 1095 of file KDChartChart.cpp.

References d, reLayoutFloatingLegends(), and KDChart::AbstractCoordinatePlane::setGridNeedsRecalculate().

{
    d->resizeLayout( size() );
    KDAB_FOREACH( AbstractCoordinatePlane* plane, d->coordinatePlanes ){
        plane->setGridNeedsRecalculate();
    }
    reLayoutFloatingLegends();
}

void Chart::setBackgroundAttributes

(

const BackgroundAttributes &

a

)

Specify the background attributes to be used, by default there is no background.

To set a light blue background, you could do something like this:

          KDChart::BackgroundAttributes backgroundAttrs( my_chart->backgroundAttributes() );
          backgroundAttrs.setVisible( true );
          backgroundAttrs.setBrush( QColor(0xd0,0xd0,0xff) );
          my_chart->setBackgroundAttributes( backgroundAttrs );
          

See also:

setFrameAttributes

Definition at line 892 of file KDChartChart.cpp.

References d.

{
    d->backgroundAttributes = a;
}

void Chart::setCoordinatePlaneLayout

(

QLayout *

layout

)

Set the coordinate plane layout that should be used as model for the internal used layout.

The layout needs to be an instance of QHBoxLayout or QVBoxLayout.

Definition at line 903 of file KDChartChart.cpp.

References d.

{
    delete d->planesLayout;
    d->planesLayout = dynamic_cast<QBoxLayout*>( layout );
    d->slotLayoutPlanes();
}

void Chart::setFrameAttributes

(

const FrameAttributes &

a

)

Specify the frame attributes to be used, by default is it a thin black line.

To hide the frame line, you could do something like this:

          KDChart::FrameAttributes frameAttrs( my_chart->frameAttributes() );
          frameAttrs.setVisible( false );
          my_chart->setFrameAttributes( frameAttrs );
          

See also:

setBackgroundAttributes

Definition at line 882 of file KDChartChart.cpp.

References d.

Referenced by Chart().

{
    d->frameAttributes = a;
}

void Chart::setGlobalLeading	(	int	left,
		int	top,
		int	right,
		int	bottom
	)

Set the padding between the margin of the widget and the area that the contents are drawn into.

Parameters:

	left	The padding on the left side.
	top	The padding at the top.
	right	The padding on the left hand side.
	bottom	The padding on the bottom.

Note:

Using previous versions of KD Chart you might have called setGlobalLeading() to make room for long Abscissa labels (or for an overlapping top label of an Ordinate axis, resp.) that would not fit into the normal axis area. This is no longer needed because KD Chart now is using hidden auto-spacer items reserving as much free space as is needed for axes with overlaping content at the respective sides.

See also:

setGlobalLeadingTop, setGlobalLeadingBottom, setGlobalLeadingLeft, setGlobalLeadingRight

globalLeadingTop, globalLeadingBottom, globalLeadingLeft, globalLeadingRight

Definition at line 978 of file KDChartChart.cpp.

References d, setGlobalLeadingBottom(), setGlobalLeadingLeft(), setGlobalLeadingRight(), and setGlobalLeadingTop().

{
    setGlobalLeadingLeft( left );
    setGlobalLeadingTop( top );
    setGlobalLeadingRight( right );
    setGlobalLeadingBottom( bottom );
    d->slotRelayout();
}

void Chart::setGlobalLeadingBottom

(

int

leading

)

Set the padding between the start of the widget and the start of the area that is used for drawing on the bottom.

Parameters:

leading

The padding value.

See also:

setGlobalLeading

Definition at line 1020 of file KDChartChart.cpp.

References d.

Referenced by setGlobalLeading().

{
    d->globalLeadingBottom = leading;
    d->slotRelayout();
}

void Chart::setGlobalLeadingLeft

(

int

leading

)

Set the padding between the start of the widget and the start of the area that is used for drawing on the left.

Parameters:

leading

The padding value.

See also:

setGlobalLeading

Definition at line 987 of file KDChartChart.cpp.

References d.

Referenced by setGlobalLeading().

{
    d->globalLeadingLeft = leading;
    d->slotRelayout();
}

void Chart::setGlobalLeadingRight

(

int

leading

)

Set the padding between the start of the widget and the start of the area that is used for drawing on the right.

Parameters:

leading

The padding value.

See also:

setGlobalLeading

Definition at line 1009 of file KDChartChart.cpp.

References d.

Referenced by setGlobalLeading().

{
    d->globalLeadingRight = leading;
    d->slotRelayout();
}

void Chart::setGlobalLeadingTop

(

int

leading

)

Set the padding between the start of the widget and the start of the area that is used for drawing at the top.

Parameters:

leading

The padding value.

See also:

setGlobalLeading

Definition at line 998 of file KDChartChart.cpp.

References d.

Referenced by setGlobalLeading().

{
    d->globalLeadingTop = leading;
    d->slotRelayout();
}

void Chart::takeCoordinatePlane

(

AbstractCoordinatePlane *

plane

)

Removes the coordinate plane from the chart, without deleting it.

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

See also:

addCoordinatePlane, takeCoordinatePlane

Definition at line 962 of file KDChartChart.cpp.

References d, propertiesChanged(), KDChart::AbstractLayoutItem::removeFromParentLayout(), and KDChart::AbstractCoordinatePlane::setParent().

Referenced by replaceCoordinatePlane().

{
    const int idx = d->coordinatePlanes.indexOf( plane );
    if( idx != -1 ){
        d->coordinatePlanes.takeAt( idx );
        disconnect( plane, SIGNAL( destroyedCoordinatePlane( AbstractCoordinatePlane* ) ),
                    d, SLOT( slotUnregisterDestroyedPlane( AbstractCoordinatePlane* ) ) );
        plane->removeFromParentLayout();
        plane->setParent( 0 );
    }
    d->slotLayoutPlanes();
    // Need to emit the signal: In case somebody has connected the signal
    // to her own slot for e.g. calling update() on a widget containing the chart.
    emit propertiesChanged();
}

void Chart::takeHeaderFooter

(

HeaderFooter *

headerFooter

)

Removes the header (or footer, resp.

) from the chart, without deleting it.

The chart no longer owns the header or footer, so it is the caller's responsibility to delete the header or footer.

See also:

addHeaderFooter, replaceHeaderFooter

Definition at line 1180 of file KDChartChart.cpp.

References d, propertiesChanged(), and KDChart::HeaderFooter::setParent().

Referenced by replaceHeaderFooter().

{
    const int idx = d->headerFooters.indexOf( headerFooter );
    if( idx != -1 ){
        d->headerFooters.takeAt( idx );
        disconnect( headerFooter, SIGNAL( destroyedHeaderFooter( HeaderFooter* ) ),
                    d, SLOT( slotUnregisterDestroyedHeaderFooter( HeaderFooter* ) ) );
        headerFooter->setParent( 0 );
    }
    d->slotRelayout();
    // Need to emit the signal: In case somebody has connected the signal
    // to her own slot for e.g. calling update() on a widget containing the chart.
    emit propertiesChanged();
}

void Chart::takeLegend

(

Legend *

legend

)

Removes the legend from the chart, without deleting it.

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

See also:

addLegend, takeLegend

Definition at line 1273 of file KDChartChart.cpp.

References d, propertiesChanged(), and KDChart::Legend::setVisible().

Referenced by replaceLegend().

{
    const int idx = d->legends.indexOf( legend );
    if( idx != -1 ){
        d->legends.takeAt( idx );
        disconnect( legend, SIGNAL( destroyedLegend( Legend* ) ),
                    d, SLOT( slotUnregisterDestroyedLegend( Legend* ) ) );
        disconnect( legend, SIGNAL( positionChanged( AbstractAreaWidget* ) ),
                    d, SLOT( slotLayoutPlanes() ) ); //slotRelayout() ) );
        disconnect( legend, SIGNAL( propertiesChanged() ),
                    this,   SIGNAL( propertiesChanged() ) );
        legend->setParent( 0 );
        legend->setVisible( false );
    }
    d->slotRelayout();

    // Need to emit the signal: In case somebody has connected the signal
    // to her own slot for e.g. calling update() on a widget containing the chart.
    // Note:
    // We do this ourselves in examples/DrawIntoPainter/mainwindow.cpp
    emit propertiesChanged();
}

---

Property Documentation

int Chart::globalLeadingBottom [read, write]

Definition at line 76 of file KDChartChart.h.

int Chart::globalLeadingLeft [read, write]

Definition at line 77 of file KDChartChart.h.

int Chart::globalLeadingRight [read, write]

Definition at line 78 of file KDChartChart.h.

int Chart::globalLeadingTop [read, write]

Definition at line 75 of file KDChartChart.h.

---

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

• KDChartChart.h
• KDChartChart.cpp

---