mirror of
https://bitbucket.org/smil3y/kde-playground.git
synced 2025-02-24 02:42:51 +00:00
136 lines
5.1 KiB
C++
136 lines
5.1 KiB
C++
/****************************************************************************
|
|
** Copyright (C) 2001-2013 Klaralvdalens Datakonsult AB. All rights reserved.
|
|
**
|
|
** This file is part of the KD Chart library.
|
|
**
|
|
** 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 may be distributed and/or modified under the terms of the
|
|
** GNU General Public License version 2 and version 3 as published by the
|
|
** Free Software Foundation and appearing in the file LICENSE.GPL.txt included.
|
|
**
|
|
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
|
|
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
|
**
|
|
** Contact info@kdab.com if any conditions of this licensing are not
|
|
** clear to you.
|
|
**
|
|
**********************************************************************/
|
|
|
|
#ifndef KDCHARTABSTRACTAREA_H
|
|
#define KDCHARTABSTRACTAREA_H
|
|
|
|
#include <QObject>
|
|
|
|
#include "KDChartGlobal.h"
|
|
#include "KDChartAbstractAreaBase.h"
|
|
#include "KDChartLayoutItems.h"
|
|
|
|
namespace KDChart {
|
|
|
|
|
|
/**
|
|
* @class AbstractArea KDChartAbstractArea.h
|
|
* @brief An area in the chart with a background, a frame, etc.
|
|
*
|
|
* AbstractArea is the base class for all non-widget chart elements that have
|
|
* a set of background attributes and frame attributes, such as
|
|
* coordinate planes or axes.
|
|
*
|
|
* @note This class inherits from AbstractAreaBase, AbstractLayoutItem, QObject.
|
|
* The reason for this triple inheritance is that neither AbstractAreaBase nor
|
|
* AbstractLayoutItem are QObject.
|
|
*/
|
|
class KDCHART_EXPORT AbstractArea : public QObject,
|
|
public AbstractAreaBase,
|
|
public AbstractLayoutItem
|
|
{
|
|
Q_OBJECT
|
|
|
|
Q_DISABLE_COPY( AbstractArea )
|
|
KDCHART_DECLARE_PRIVATE_DERIVED( AbstractArea )
|
|
|
|
public:
|
|
virtual ~AbstractArea() ;
|
|
|
|
/**
|
|
* @brief 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.
|
|
*/
|
|
virtual void paintIntoRect( QPainter& painter, const QRect& rect );
|
|
|
|
/**
|
|
* Call paintAll, if you want the background and the frame to be drawn
|
|
* before the normal paint() is invoked automatically.
|
|
*/
|
|
virtual void paintAll( QPainter& painter );
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
virtual int leftOverlap( bool doNotRecalculate=false ) const;
|
|
/**
|
|
* 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.
|
|
*/
|
|
virtual int rightOverlap( bool doNotRecalculate=false ) const;
|
|
/**
|
|
* 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.
|
|
*/
|
|
virtual int topOverlap( bool doNotRecalculate=false ) const;
|
|
/**
|
|
* 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.
|
|
*/
|
|
virtual int bottomOverlap( bool doNotRecalculate=false ) const;
|
|
|
|
protected:
|
|
AbstractArea();
|
|
virtual QRect areaGeometry() const;
|
|
virtual void positionHasChanged();
|
|
|
|
Q_SIGNALS:
|
|
void positionChanged( AbstractArea * );
|
|
}; // End of class AbstractArea
|
|
|
|
}
|
|
#endif // KDCHARTABSTRACTAREA_H
|