src/kitemviews/kitemlistgroupheader.h

   1 /***************************************************************************
   2  *   Copyright (C) 2011 by Peter Penz <peter.penz19@gmail.com>             *
   3  *                                                                         *
   4  *   This program is free software; you can redistribute it and/or modify  *
   5  *   it under the terms of the GNU General Public License as published by  *
   6  *   the Free Software Foundation; either version 2 of the License, or     *
   7  *   (at your option) any later version.                                   *
   8  *                                                                         *
   9  *   This program is distributed in the hope that it will be useful,       *
  10  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  11  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  12  *   GNU General Public License for more details.                          *
  13  *                                                                         *
  14  *   You should have received a copy of the GNU General Public License     *
  15  *   along with this program; if not, write to the                         *
  16  *   Free Software Foundation, Inc.,                                       *
  17  *   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA            *
  18  ***************************************************************************/
  19
  20 #ifndef KITEMLISTGROUPHEADER_H
  21 #define KITEMLISTGROUPHEADER_H
  22
  23 #include <libdolphin_export.h>
  24
  25 #include <kitemviews/kitemliststyleoption.h>
  26
  27 #include <QByteArray>
  28 #include <QGraphicsWidget>
  29 #include <QVariant>
  30
  31 class KItemListView;
  32
  33 class LIBDOLPHINPRIVATE_EXPORT KItemListGroupHeader : public QGraphicsWidget
  34 {
  35     Q_OBJECT
  36
  37 public:
  38     KItemListGroupHeader(QGraphicsWidget* parent = 0);
  39     virtual ~KItemListGroupHeader();
  40
  41     void setRole(const QByteArray& role);
  42     QByteArray role() const;
  43
  44     void setData(const QVariant& data);
  45     QVariant data() const;
  46
  47     void setStyleOption(const KItemListStyleOption& option);
  48     const KItemListStyleOption& styleOption() const;
  49
  50     /**
  51      * Sets the scroll orientation that is used by the KItemListView.
  52      * This allows the group header to use a modified look dependent
  53      * on the orientation.
  54      */
  55     void setScrollOrientation(Qt::Orientation orientation);
  56     Qt::Orientation scrollOrientation() const;
  57
  58     virtual void paint(QPainter* painter, const QStyleOptionGraphicsItem* option, QWidget* widget = 0);
  59
  60 protected:
  61     /**
  62      * Is called after the role has been changed and allows the derived class
  63      * to react on this change.
  64      */
  65     virtual void roleChanged(const QByteArray& current, const QByteArray& previous);
  66
  67     /**
  68      * Is called after the role has been changed and allows the derived class
  69      * to react on this change.
  70      */
  71     virtual void dataChanged(const QVariant& current, const QVariant& previous);
  72
  73     /**
  74      * Is called after the style option has been changed and allows the derived class
  75      * to react on this change.
  76      */
  77     virtual void styleOptionChanged(const KItemListStyleOption& current, const KItemListStyleOption& previous);
  78
  79     /**
  80      * Is called after the scroll orientation has been changed and allows the derived class
  81      * to react on this change.
  82      */
  83     virtual void scrollOrientationChanged(Qt::Orientation current, Qt::Orientation previous);
  84
  85     /** @reimp */
  86     virtual void resizeEvent(QGraphicsSceneResizeEvent* event);
  87
  88 private:
  89     void updateCache();
  90
  91 private:
  92     bool m_dirtyCache;
  93     QByteArray m_role;
  94     QVariant m_data;
  95     KItemListStyleOption m_styleOption;
  96     Qt::Orientation m_scrollOrientation;
  97
  98     QPixmap* m_leftBorderCache;
  99     QPixmap* m_rightBorderCache;
 100     QColor m_outlineColor;
 101 };
 102 #endif
 103
 104