KDChartWidget.h

Go to the documentation of this file.

/* -*- Mode: C++ -*-
   KDChart - a multi-platform charting engine
   */

/****************************************************************************
 ** Copyright (C) 2001-2007 Klarälvdalens Datakonsult AB.  All rights reserved.
 **
 ** This file is part of the KD Chart library.
 **
 ** This file may be distributed and/or modified under the terms of the
 ** GNU General Public License version 2 as published by the Free Software
 ** Foundation and appearing in the file LICENSE.GPL included in the
 ** packaging of this file.
 **
 ** Licensees holding valid commercial KD Chart licenses may use this file in
 ** accordance with the KD Chart Commercial License Agreement provided with
 ** the Software.
 **
 ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
 ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 **
 ** See http://www.kdab.net/kdchart for
 **   information about KD Chart Commercial License Agreements.
 **
 ** Contact info@kdab.net if any conditions of this
 ** licensing are not clear to you.
 **
 **********************************************************************/
#ifndef __KDCHARTWIDGET_H__
#define __KDCHARTWIDGET_H__

#include "KDChartGlobal.h"

#include <QWidget>

#include "KDChartEnums.h"
#include "KDChartHeaderFooter.h"

template <typename T> class QVector;
template <typename T1, typename T2> struct QPair;

namespace KDChart {

    // some forward declarations
    class AbstractDiagram;
    class Chart;
    class AbstractCoordinatePlane;
    class TableModel;
    class BarDiagram;
    class LineDiagram;
    class Plotter;
    class PieDiagram;
    class RingDiagram;
    class PolarDiagram;
    class Legend;
    class Position;

    class KDCHART_EXPORT Widget : public QWidget
    {
        Q_OBJECT

        Q_DISABLE_COPY( Widget )
        KDCHART_DECLARE_PRIVATE_BASE_POLYMORPHIC_QWIDGET( Widget )

    public:
        explicit Widget( QWidget* parent = 0 );

        ~Widget();
        void setDataset( int column, const QVector< double > & data, const QString& title = QString()  );
        void setDataset( int column, const QVector< QPair< double, double > > &  data, const QString& title = QString() );
        void setDataCell( int row, int column, double data );
        void setDataCell( int row, int column, QPair< double, double > data );
        void resetData();

    public Q_SLOTS:
        void setGlobalLeading( int left, int top, int right, int bottom );
        void setGlobalLeadingLeft( int leading );
        void setGlobalLeadingTop( int leading );
        void setGlobalLeadingRight( int leading );
        void setGlobalLeadingBottom( int leading );

    public:
        int globalLeadingLeft() const;
        int globalLeadingTop() const;
        int globalLeadingRight() const;
        int globalLeadingBottom() const;

        HeaderFooter* firstHeaderFooter();
        QList<HeaderFooter*> allHeadersFooters();

        void addHeaderFooter( const QString& text,
                              HeaderFooter::HeaderFooterType type,
                              Position position );

        void addHeaderFooter( HeaderFooter* header );

        void replaceHeaderFooter( HeaderFooter* header,
                                  HeaderFooter* oldHeader = 0 );

        void takeHeaderFooter( HeaderFooter* header );

        Legend* legend();
        QList<Legend*> allLegends();

        void addLegend( Position position );
        void addLegend (Legend* legend );

        void replaceLegend( Legend* legend, Legend* oldLegend = 0 );
        void takeLegend( Legend* legend );


        AbstractDiagram* diagram();

        BarDiagram* barDiagram();
        LineDiagram* lineDiagram();
        Plotter* plotter();
        PieDiagram* pieDiagram();
        RingDiagram* ringDiagram();
        PolarDiagram* polarDiagram();

        AbstractCoordinatePlane* coordinatePlane();


        enum ChartType { NoType, Bar, Line, Plot, Pie, Ring, Polar };

        ChartType type() const;

        enum SubType { Normal, Stacked, Percent, Rows };

        SubType subType() const;

    public Q_SLOTS:
        void setType( ChartType chartType, SubType subType=Normal );
        void setSubType( SubType subType );

    private:
        void justifyModelSize( int rows, int columns );
        bool checkDatasetWidth( int width );
    };
}

#endif // KDChartWidget_H

---