File indexing completed on 2024-05-12 04:20:37

 /*
  * SPDX-FileCopyrightText: 2001-2015 Klaralvdalens Datakonsult AB. All rights reserved.
  *
  * This file is part of the KD Chart library.
  *
  * SPDX-License-Identifier: GPL-2.0-or-later
  */
 
 #ifndef __KCHARTWIDGET_H__
 #define __KCHARTWIDGET_H__
 
 #include "KChartGlobal.h"
 
 #include <QWidget>
 
 #include "KChartEnums.h"
 #include "KChartHeaderFooter.h"
 
 QT_BEGIN_NAMESPACE
 template <typename T> class QList;
 QT_END_NAMESPACE
 
 namespace KChart {
 
     // 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 Widget KChartWidget.h
     * \brief The KChart widget for usage without Interwiev.
     *
     * If you want to use KChart with Interview, use KChart::Chart instead.
     */
    class KCHART_EXPORT Widget : public QWidget
     {
         Q_OBJECT
 
         Q_DISABLE_COPY( Widget )
         KCHART_DECLARE_PRIVATE_BASE_POLYMORPHIC_QWIDGET( Widget )
 
     public:
         /**
          * Standard Qt-style Constructor
          *
          * Creates a new widget with all data initialized empty.
          *
          * \param parent the widget parent; passed on to QWidget
          */
        explicit Widget( QWidget* parent = nullptr );
 
         /** Destructor. */
        ~Widget() override;
         /** Sets the data in the given column using a QVector of qreal for the Y values. */
         void setDataset( int column, const QVector< qreal > & data, const QString& title = QString() );
         /** Sets the data in the given column using a QVector of QPairs
          *  of qreal for the (X, Y) values. */
         void setDataset( int column, const QVector< QPair< qreal, qreal > > &  data, const QString& title = QString() );
         /** Sets the Y value data for a given cell. */
         void setDataCell( int row, int column, qreal data );
         /** Sets the data for a given column using an (X, Y) QPair of qreals. */
         void setDataCell( int row, int column, QPair< qreal, qreal > data );
         /** Resets all data. */
         void resetData();
 
     public Q_SLOTS:
         /** Sets all global leadings (borders). */
         void setGlobalLeading( int left, int top, int right, int bottom );
         /** Sets the left leading (border). */
        void setGlobalLeadingLeft( int leading );
         /** Sets the top leading (border). */
        void setGlobalLeadingTop( int leading );
         /** Sets the right leading (border). */
        void setGlobalLeadingRight( int leading );
         /** Sets the bottom leading (border). */
        void setGlobalLeadingBottom( int leading );
 
     public:
         /** Returns the left leading (border). */
         int globalLeadingLeft() const;
         /** Returns the top leading (border). */
         int globalLeadingTop() const;
         /** Returns the right leading (border). */
         int globalLeadingRight() const;
         /** Returns the bottom leading (border). */
         int globalLeadingBottom() const;
 
         /** Returns the first of all headers. */
         HeaderFooter* firstHeaderFooter();
         /** Returns a list with all headers. */
         QList<HeaderFooter*> allHeadersFooters();
 
         /** Adds a new header/footer with the given text to the position. */
         void addHeaderFooter( const QString& text,
                               HeaderFooter::HeaderFooterType type,
                               Position position );
 
         /**
           * Adds the existing header / footer object \a header.
           * \sa replaceHeaderFooter, takeHeaderFooter
         */
         void addHeaderFooter( HeaderFooter* header );
 
         /**
          * Replaces the old header (or footer, resp.), or appends the
          * new header or footer, it there is none yet.
          *
          * @param header The header or footer to be used instead of the old one.
          * This parameter must not be zero, or the method will do nothing.
          *
          * @param oldHeader 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.
          *
          * \sa addHeaderFooter, takeHeaderFooter
          */
         void replaceHeaderFooter( HeaderFooter* header,
                                   HeaderFooter* oldHeader = nullptr );
 
         /** Remove the header (or footer, resp.) from the widget,
          * 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.
          *
          * \sa addHeaderFooter, replaceHeaderFooter
          */
         void takeHeaderFooter( HeaderFooter* header );
 
         /** Returns the first of all legends. */
         Legend* legend();
         /** Returns a list with all legends. */
         QList<Legend*> allLegends();
 
         /** Adds an empty legend on the given position. */
         void addLegend( Position position );
         /** Adds a new, already existing, legend. */
         void addLegend (Legend* legend );
 
         void replaceLegend( Legend* legend, Legend* oldLegend = nullptr );
         void takeLegend( Legend* legend );
 
 
         /** Returns a pointer to the current diagram. */
         AbstractDiagram* diagram();
 
         /** If the current diagram is a BarDiagram, it is returned; otherwise 0 is returned.
           * This function provides type-safe casting.
           */
         BarDiagram* barDiagram();
         /** If the current diagram is a LineDiagram, it is returned; otherwise 0 is returned.
          * This function provides type-safe casting.
          */
         LineDiagram* lineDiagram();
         /** If the current diagram is a LineDiagram, it is returned; otherwise 0 is returned.
          * This function provides type-safe casting.
          *
          * \note Do not use lineDiagram for multi-dimensional diagrams, but use plotter instead
          *
          * \sa plotter
          */
         Plotter* plotter();
         /** If the current diagram is a Plotter, it is returned; otherwise 0 is returned.
           * This function provides type-safe casting.
           */
         PieDiagram* pieDiagram();
         /** If the current diagram is a RingDiagram, it is returned; otherwise 0 is returned.
           * This function provides type-safe casting.
           */
         RingDiagram* ringDiagram();
         /** If the current diagram is a PolarDiagram, it is returned; otherwise 0 is returned.
           * This function provides type-safe casting.
           */
         PolarDiagram* polarDiagram();
 
         /** Returns a pointer to the current coordinate plane. */
         AbstractCoordinatePlane* coordinatePlane();
 
 
         enum ChartType { NoType, Bar, Line, Plot, Pie, Ring, Polar };
 
         /** Returns the type of the chart. */
         ChartType type() const;
 
         /** Sub type values, matching the values defines for the respective Diagram classes. */
         enum SubType { Normal, Stacked, Percent, Rows };
 
         /** Returns the sub-type of the chart. */
         SubType subType() const;
 
     public Q_SLOTS:
         /** Sets the type of the chart. */
         void setType( KChart::Widget::ChartType chartType, KChart::Widget::SubType subType=Normal );
         /** \brief Sets the type of the chart without changing the main type.
           *
           * Make sure to use a sub-type that matches the main type,
           * so e.g. setting sub-type Rows makes sense for Bar charts only,
           * and it will be ignored for all other chart types.
           *
           * \sa KChart::BarDiagram::BarType, KChart::LineDiagram::LineType
           * \sa KChart::PieDiagram::PieType, KChart::RingDiagram::RingType
           * \sa KChart::PolarDiagram::PolarType
           */
         void setSubType( KChart::Widget::SubType subType );
 
     private:
         /** Justifies the model, so that the given rows and columns fit into it. */
         void justifyModelSize( int rows, int columns );
         /** Checks whether the given width matches with the one used until now. */
        bool checkDatasetWidth( int width );
     };
 }
 
 #endif // KChartWidget_H