kganttlegend.h

/*
 * SPDX-FileCopyrightText: 2001-2015 Klaralvdalens Datakonsult AB. All rights reserved.
 *
 * This file is part of the KGantt library.
 *
 * SPDX-License-Identifier: GPL-2.0-or-later
 */
 
#ifndef KGANTTLEGEND_H
#define KGANTTLEGEND_H
 
#include <QAbstractItemView>
 
#include "kganttglobal.h"
#include "kganttstyleoptionganttitem.h"
 
namespace KGantt 
{
 
    /*!\class KGantt::Legend kganttlegend.h KGanttLegend
     * \ingroup KGantt
     * \brief Legend showing an image and a description for Gantt items
     *
     * This is an item view class showing a small Gantt item and it's
     * text defined by LegendRole.
     */
    class KGANTT_EXPORT Legend : public QAbstractItemView
    {
        Q_OBJECT
        KGANTT_DECLARE_PRIVATE_BASE_POLYMORPHIC( Legend )
    public:
        /*! Constructor. Creates a Legend with parent \a parent.
         * The QObject parent is not used for anything internally. */
        explicit Legend( QWidget* parent = nullptr );
 
        /*! Destructor. Does nothing */
        ~Legend() override;
 
        /*reimp*/ QModelIndex indexAt( const QPoint& point ) const override;
        /*reimp*/ QRect visualRect( const QModelIndex& index ) const override;
 
        /*reimp*/ void scrollTo( const QModelIndex&, ScrollHint = EnsureVisible ) override {}
 
        /*reimp*/ QSize sizeHint() const override;
        /*reimp*/ QSize minimumSizeHint() const override;
 
        /*reimp*/ void setModel( QAbstractItemModel* model ) override;
 
    protected:
        /*! Draws the legend item at \a index and all of it's children recursively 
         *  at \a pos onto \a painter.
         *  Reimplement this if you want to draw items in an user defined way.
         *  \returns the rectangle drawn.
         */
        virtual QRect drawItem( QPainter* painter, const QModelIndex& index, const QPoint& pos = QPoint() ) const;
 
        /*! Calculates the needed space for the legend item at \a index and, if \a recursive is true,
         *  all child items.
         */
        virtual QSize measureItem( const QModelIndex& index, bool recursive = true ) const;
 
        /*! Creates a StyleOptionGanttItem with all style options filled in
         *  except the target rectangles.
         */
        virtual StyleOptionGanttItem getStyleOption( const QModelIndex& index ) const;
 
        /*reimp*/ void paintEvent( QPaintEvent* event ) override;
 
        /*reimp*/ int horizontalOffset() const override { return 0; }
        /*reimp*/ bool isIndexHidden( const QModelIndex& ) const override { return false; }
        /*reimp*/ QModelIndex moveCursor( CursorAction, Qt::KeyboardModifiers ) override { return QModelIndex(); }
        /*reimp*/ void setSelection( const QRect&, QItemSelectionModel::SelectionFlags ) override {}
        /*reimp*/ int verticalOffset() const override { return 0; }
        /*reimp*/ QRegion visualRegionForSelection( const QItemSelection& ) const override { return QRegion(); }
 
    protected Q_SLOTS:
        /*! Triggers repainting of the legend.
         */
        virtual void modelDataChanged();
    };
}
 
#endif