]> cloud.milkyroute.net Git - dolphin.git/blobdiff - src/kitemviews/kitemlistview.h
Allow custom sorting of details-view columns
[dolphin.git] / src / kitemviews / kitemlistview.h
index 3f877d2360a668be7900a8a6a6a3f5f62c2d9dbe..b416888eb8aa37a28472d1c36a3bac8d19dc5c9a 100644 (file)
@@ -25,6 +25,7 @@
 
 #include <libdolphin_export.h>
 
+#include <kitemviews/kitemlistgroupheader.h>
 #include <kitemviews/kitemliststyleoption.h>
 #include <kitemviews/kitemlistviewanimation_p.h>
 #include <kitemviews/kitemlistwidget.h>
 #include <QSet>
 
 class KItemListController;
-class KItemListWidgetCreatorBase;
-class KItemListGroupHeader;
 class KItemListGroupHeaderCreatorBase;
+class KItemListHeader;
 class KItemListSizeHintResolver;
 class KItemListRubberBand;
 class KItemListViewAnimation;
 class KItemListViewLayouter;
 class KItemListWidget;
+class KItemListWidgetCreatorBase;
 class KItemListViewCreatorBase;
 class QTimer;
 
@@ -64,30 +65,62 @@ class LIBDOLPHINPRIVATE_EXPORT KItemListView : public QGraphicsWidget
 {
     Q_OBJECT
 
-    Q_PROPERTY(qreal offset READ offset WRITE setOffset)
+    Q_PROPERTY(qreal scrollOffset READ scrollOffset WRITE setScrollOffset)
+    Q_PROPERTY(qreal itemOffset READ itemOffset WRITE setItemOffset)
 
 public:
     KItemListView(QGraphicsWidget* parent = 0);
     virtual ~KItemListView();
 
+    /**
+     * If the scroll-orientation is vertical, the items are ordered
+     * from top to bottom (= default setting). If the scroll-orientation
+     * is horizontal, the items are ordered from left to right.
+     */
     void setScrollOrientation(Qt::Orientation orientation);
     Qt::Orientation scrollOrientation() const;
 
     void setItemSize(const QSizeF& size);
     QSizeF itemSize() const;
 
-    // TODO: add note that offset is not checked against maximumOffset, only against 0.
-    void setOffset(qreal offset);
-    qreal offset() const;
+    /**
+     * Offset of the scrollbar that represents the scroll-orientation
+     * (see setScrollOrientation()).
+     */
+    void setScrollOffset(qreal offset);
+    qreal scrollOffset() const;
 
-    qreal maximumOffset() const;
+    qreal maximumScrollOffset() const;
 
     /**
-     * Sets the visible roles to \p roles. The integer-value defines
-     * the order of the visible role: Smaller values are ordered first.
+     * Offset related to an item, that does not fit into the available
+     * size of the listview. If the scroll-orientation is vertical
+     * the item-offset describes the offset of the horizontal axe, if
+     * the scroll-orientation is horizontal the item-offset describes
+     * the offset of the vertical axe.
      */
-    void setVisibleRoles(const QHash<QByteArray, int>& roles);
-    QHash<QByteArray, int> visibleRoles() const;
+    void setItemOffset(qreal scrollOffset);
+    qreal itemOffset() const;
+
+    qreal maximumItemOffset() const;
+
+    void setVisibleRoles(const QList<QByteArray>& roles);
+    QList<QByteArray> visibleRoles() const;
+
+    /**
+     * If set to true an automatic scrolling is done as soon as the
+     * mouse is moved near the borders of the view. Per default
+     * the automatic scrolling is turned off.
+     */
+    void setAutoScroll(bool enabled);
+    bool autoScroll() const;
+
+    /**
+     * If set to true selection-toggles will be shown when hovering
+     * an item. Per default the selection-toggles are disabled.
+     */
+    void setEnabledSelectionToggles(bool enabled);
+    bool enabledSelectionToggles() const;
 
     /**
      * @return Controller of the item-list. The controller gets
@@ -98,7 +131,7 @@ public:
 
     /**
      * @return Model of the item-list. The model gets
-     *         initialized by KItemListController::setView() and will
+     *         initialized by KItemListController::setModel() and will
      *         result in calling KItemListController::onModelChanged().
      */
     KItemModelBase* model() const;
@@ -124,57 +157,175 @@ public:
     void setStyleOption(const KItemListStyleOption& option);
     const KItemListStyleOption& styleOption() const;
 
+    /** @reimp */
     virtual void setGeometry(const QRectF& rect);
 
+    /**
+     * @return Index of the item that is below the point \a pos.
+     *         The position is relative to the upper right of
+     *         the visible area. Only (at least partly) visible
+     *         items are considered. -1 is returned if no item is
+     *         below the position.
+     */
     int itemAt(const QPointF& pos) const;
     bool isAboveSelectionToggle(int index, const QPointF& pos) const;
     bool isAboveExpansionToggle(int index, const QPointF& pos) const;
 
+    /**
+     * @return Index of the first item that is at least partly visible.
+     *         -1 is returned if the model contains no items.
+     */
     int firstVisibleIndex() const;
+
+    /**
+     * @return Index of the last item that is at least partly visible.
+     *         -1 is returned if the model contains no items.
+     */
     int lastVisibleIndex() const;
 
+    /**
+     * @return Required size for the item with the index \p index.
+     *         Per default KItemListView::itemSize() is returned.
+     *         When reimplementing this method it is recommended to
+     *         also reimplement KItemListView::itemSizeHintUpdateRequired().
+     */
     virtual QSizeF itemSizeHint(int index) const;
-    virtual QHash<QByteArray, QSizeF> visibleRoleSizes() const;
 
     /**
-     * @return The bounding rectangle of the item relative to the top/left of
+     * @param itemRanges Items that must be checked for getting the visible roles sizes.
+     * @return           The size of each visible role in case if KItemListView::itemSize()
+     *                   is empty. This allows to have dynamic but equal role sizes between
+     *                   all items, like used in the classic "table-views". Per default an
+     *                   empty hash is returned.
+     */
+    virtual QHash<QByteArray, QSizeF> visibleRolesSizes(const KItemRangeList& itemRanges) const;
+
+    /**
+     * @return True if the view supports the expanding of items. Per default
+     *         false is returned. If expanding of items is supported
+     *         (see setSupportsItemExpanding()),the methods
+     *         KItemModelBase::setExpanded(), KItemModelBase::isExpanded(),
+     *         KItemModelBase::isExpandable() and KItemModelBase::expandedParentsCount()
+     *         must be reimplemented. The view-implementation
+     *         has to take care itself how to visually represent the expanded items provided
+     *         by the model.
+     */
+    bool supportsItemExpanding() const;
+
+    /**
+     * @return The rectangle of the item relative to the top/left of
      *         the currently visible area (see KItemListView::offset()).
      */
-    QRectF itemBoundingRect(int index) const;
+    QRectF itemRect(int index) const;
+
+    /**
+     * @return The context rectangle of the item relative to the top/left of
+     *         the currently visible area (see KItemListView::offset()). The
+     *         context rectangle is defined by by the united rectangle of
+     *         the icon rectangle and the text rectangle (see KItemListWidget::iconRect()
+     *         and KItemListWidget::textRect()) and is useful as reference for e.g. aligning
+     *         a tooltip or a context-menu for an item. Note that a context rectangle will
+     *         only be returned for (at least partly) visible items. An empty rectangle will
+     *         be returned for fully invisible items.
+     */
+    QRectF itemContextRect(int index) const;
 
     /**
-     * @return The number of items that can be shown in parallel for one offset.
-     *         Assuming the scrolldirection is vertical then a value of 4 means
-     *         that 4 columns for items are available. Assuming the scrolldirection
-     *         is horizontal then a value of 4 means that 4 lines for items are
-     *         available.
+     * Scrolls to the item with the index \a index so that the item
+     * will be fully visible.
      */
-    int itemsPerOffset() const;
+    void scrollToItem(int index);
 
+    /**
+     * If several properties of KItemListView are changed synchronously, it is
+     * recommended to encapsulate the calls between beginTransaction() and endTransaction().
+     * This prevents unnecessary and expensive layout-calculations.
+     */
     void beginTransaction();
+
+    /**
+     * Counterpart to beginTransaction(). The layout changes will only be animated if
+     * all property changes between beginTransaction() and endTransaction() support
+     * animations.
+     */
     void endTransaction();
+
     bool isTransactionActive() const;
 
+    /**
+     * Turns on the header if \p show is true. Per default the
+     * header is not shown. Usually the header is turned on when
+     * showing a classic "table-view" to describe the shown columns.
+     */
+    void setHeaderShown(bool show);
+    bool isHeaderShown() const;
+
+    /**
+     * @return Pixmap that is used for a drag operation based on the
+     *         items given by \a indexes. The default implementation returns
+     *         a null-pixmap.
+     */
+    virtual QPixmap createDragPixmap(const QSet<int>& indexes) const;
+
     /**
      * @reimp
      */
-   virtual void paint(QPainter* painter, const QStyleOptionGraphicsItem* option, QWidget* widget = 0);
+    virtual void paint(QPainter* painter, const QStyleOptionGraphicsItem* option, QWidget* widget = 0);
 
 signals:
-    void offsetChanged(qreal current, qreal previous);
-    void maximumOffsetChanged(qreal current, qreal previous);
+    void scrollOrientationChanged(Qt::Orientation current, Qt::Orientation previous);
+    void scrollOffsetChanged(qreal current, qreal previous);
+    void maximumScrollOffsetChanged(qreal current, qreal previous);
+    void itemOffsetChanged(qreal current, qreal previous);
+    void maximumItemOffsetChanged(qreal current, qreal previous);
     void scrollTo(qreal newOffset);
 
+    /**
+     * Is emitted if the user has changed the sort order by clicking on a
+     * header item (see KItemListView::setHeaderShown()). The sort order
+     * of the model has already been adjusted to
+     * the current sort order. Note that no signal will be emitted if the
+     * sort order of the model has been changed without user interaction.
+     */
+    void sortOrderChanged(Qt::SortOrder current, Qt::SortOrder previous);
+
+    /**
+     * Is emitted if the user has changed the sort role by clicking on a
+     * header item (see KItemListView::setHeaderShown()). The sort role
+     * of the model has already been adjusted to
+     * the current sort role. Note that no signal will be emitted if the
+     * sort role of the model has been changed without user interaction.
+     */
+    void sortRoleChanged(const QByteArray& current, const QByteArray& previous);
+
+    /**
+     * Is emitted if the user has changed the visible roles by moving a header
+     * item (see KItemListView::setHeaderShown()). Note that no signal will be
+     * emitted if the roles have been changed without user interaction by
+     * KItemListView::setVisibleRoles().
+     */
+    void visibleRolesChanged(const QList<QByteArray>& current, const QList<QByteArray>& previous);
+
 protected:
     virtual void initializeItemListWidget(KItemListWidget* item);
 
+    /**
+     * @return True if at least one of the changed roles \p changedRoles might result
+     *         in the need to update the item-size hint (see KItemListView::itemSizeHint()).
+     *         Per default true is returned which means on each role-change of existing items
+     *         the item-size hints are recalculated. For performance reasons it is recommended
+     *         to return false in case if a role-change will not result in a changed
+     *         item-size hint.
+     */
+    virtual bool itemSizeHintUpdateRequired(const QSet<QByteArray>& changedRoles) const;
+
     virtual void onControllerChanged(KItemListController* current, KItemListController* previous);
     virtual void onModelChanged(KItemModelBase* current, KItemModelBase* previous);
 
     virtual void onScrollOrientationChanged(Qt::Orientation current, Qt::Orientation previous);
     virtual void onItemSizeChanged(const QSizeF& current, const QSizeF& previous);
-    virtual void onOffsetChanged(qreal current, qreal previous);
-    virtual void onVisibleRolesChanged(const QHash<QByteArray, int>& current, const QHash<QByteArray, int>& previous);
+    virtual void onScrollOffsetChanged(qreal current, qreal previous);
+    virtual void onVisibleRolesChanged(const QList<QByteArray>& current, const QList<QByteArray>& previous);
     virtual void onStyleOptionChanged(const KItemListStyleOption& current, const KItemListStyleOption& previous);
 
     virtual void onTransactionBegin();
@@ -183,32 +334,74 @@ protected:
     virtual bool event(QEvent* event);
     virtual void mousePressEvent(QGraphicsSceneMouseEvent* event);
     virtual void mouseMoveEvent(QGraphicsSceneMouseEvent* event);
+    virtual void dragEnterEvent(QGraphicsSceneDragDropEvent* event);
+    virtual void dragMoveEvent(QGraphicsSceneDragDropEvent* event);
+    virtual void dragLeaveEvent(QGraphicsSceneDragDropEvent* event);
+    virtual void dropEvent(QGraphicsSceneDragDropEvent* event);
 
     QList<KItemListWidget*> visibleItemListWidgets() const;
 
+    /**
+     * Must be called by the derived class if it supports the expanding
+     * of items.
+     * @see supportsItemExpanding()
+     */
+    void setSupportsItemExpanding(bool supportsExpanding);
+
 protected slots:
     virtual void slotItemsInserted(const KItemRangeList& itemRanges);
     virtual void slotItemsRemoved(const KItemRangeList& itemRanges);
+    virtual void slotItemsMoved(const KItemRange& itemRange, const QList<int>& movedToIndexes);
     virtual void slotItemsChanged(const KItemRangeList& itemRanges,
                                   const QSet<QByteArray>& roles);
 
+    virtual void slotGroupedSortingChanged(bool current);
+    virtual void slotSortOrderChanged(Qt::SortOrder current, Qt::SortOrder previous);
+    virtual void slotSortRoleChanged(const QByteArray& current, const QByteArray& previous);
+    virtual void slotCurrentChanged(int current, int previous);
+    virtual void slotSelectionChanged(const QSet<int>& current, const QSet<int>& previous);
+
 private slots:
-    void slotCurrentChanged(int current, int previous);
-    void slotSelectionChanged(const QSet<int>& current, const QSet<int>& previous);
     void slotAnimationFinished(QGraphicsWidget* widget,
                                KItemListViewAnimation::AnimationType type);
     void slotLayoutTimerFinished();
 
-    void slotRubberBandStartPosChanged();
-    void slotRubberBandEndPosChanged();
+    void slotRubberBandPosChanged();
     void slotRubberBandActivationChanged(bool active);
 
     /**
-     * Emits the signal scrollTo() with the corresponding target offset if the current
-     * mouse position is above the autoscroll-margin.
+     * Is invoked if the visible role-width of one role in the header has
+     * been changed by the user. It is remembered that the user has modified
+     * the role-width, so that it won't be changed anymore automatically to
+     * calculate an optimized width.
+     */
+    void slotVisibleRoleWidthChanged(const QByteArray& role,
+                                     qreal currentWidth,
+                                     qreal previousWidth);
+
+    /**
+     * Is invoked if a visible role has been moved by the user. Applies
+     * the moved role to the view.
+     */
+    void slotVisibleRoleMoved(const QByteArray& role,
+                              int currentIndex,
+                              int previousIndex);
+
+    /**
+     * Triggers the autoscrolling if autoScroll() is enabled by checking the
+     * current mouse position. If the mouse position is within the autoscroll
+     * margins a timer will be started that periodically triggers the autoscrolling.
      */
     void triggerAutoScrolling();
 
+    /**
+     * Is invoked if the geometry of the parent-widget from a group-header has been
+     * changed. The x-position and width of the group-header gets adjusted to assure
+     * that it always spans the whole width even during temporary transitions of the
+     * parent widget.
+     */
+    void slotGeometryOfGroupHeaderParentChanged();
+
 private:
     enum LayoutAnimationHint
     {
@@ -227,25 +420,46 @@ private:
 
     KItemListRubberBand* rubberBand() const;
 
-    void updateLayout();
-    void doLayout(LayoutAnimationHint hint, int changedIndex, int changedCount);
-    void doGroupHeadersLayout(LayoutAnimationHint hint, int changedIndex, int changedCount);
+    void doLayout(LayoutAnimationHint hint, int changedIndex = 0, int changedCount = 0);
+
+    /**
+     * Helper method for doLayout: Returns a list of items that can be reused for the visible
+     * area. Invisible group headers get recycled. The reusable items are items that are
+     * invisible. If the animation hint is 'Animation' then items that are currently animated
+     * won't be reused. Reusing items is faster in comparison to deleting invisible
+     * items and creating a new instance for visible items.
+     */
+    QList<int> recycleInvisibleItems(int firstVisibleIndex,
+                                     int lastVisibleIndex,
+                                     LayoutAnimationHint hint);
+
+    /**
+     * Helper method for doLayout: Starts a moving-animation for the widget to the given
+     * new position. The moving-animation is only started if the new position is within
+     * the same row or column, otherwise the create-animation is used instead.
+     * @return True if the moving-animation has been applied.
+     */
+    bool moveWidget(KItemListWidget* widget, const QPointF& newPos);
+
     void emitOffsetChanges();
 
     KItemListWidget* createWidget(int index);
     void recycleWidget(KItemListWidget* widget);
+
+    /**
+     * Changes the index of the widget to \a index and assures a consistent
+     * update for m_visibleItems and m_visibleCells. The cell-information
+     * for the new index will not be updated and be initialized as empty cell.
+     */
     void setWidgetIndex(KItemListWidget* widget, int index);
 
     /**
-     * Helper method for setGeometry() and setItemSize(): Calling both methods might result
-     * in a changed number of visible items. To assure that currently invisible items can
-     * get animated from the old position to the new position prepareLayoutForIncreasedItemCount()
-     * takes care to create all item widgets that are visible with the old or the new size.
-     * @param size     Size of the layouter or the item dependent on \p sizeType.
-     * @param sizeType LayouterSize: KItemListLayouter::setSize() is used.
-     *                 ItemSize: KItemListLayouter::setItemSize() is used.
+     * Changes the index of the widget to \a index. In opposite to
+     * setWidgetIndex() the cell-information for the widget gets updated.
+     * This update gives doLayout() the chance to animate the moving
+     * of the item visually (see moveWidget()).
      */
-    void prepareLayoutForIncreasedItemCount(const QSizeF& size, SizeType sizeType);
+    void moveWidgetToIndex(KItemListWidget* widget, int index);
 
     /**
      * Helper method for prepareLayoutForIncreasedItemCount().
@@ -253,43 +467,175 @@ private:
     void setLayouterSize(const QSizeF& size, SizeType sizeType);
 
     /**
-     * Marks the visible roles as dirty so that they will get updated when doing the next
-     * layout. The visible roles will only get marked as dirty if an empty item-size is
-     * given.
-     * @return True if the visible roles have been marked as dirty.
+     * Helper method for createWidget() and setWidgetIndex() to update the properties
+     * of the itemlist widget.
      */
-    bool markVisibleRolesSizesAsDirty();
+    void updateWidgetProperties(KItemListWidget* widget, int index);
 
     /**
-     * Updates the m_visibleRoleSizes property and applies the dynamic
-     * size to the layouter.
+     * Helper method for updateWidgetPropertes() to create or update
+     * the itemlist group-header.
      */
-    void applyDynamicItemSize();
+    void updateGroupHeaderForWidget(KItemListWidget* widget);
 
     /**
-     * Helper method for createWidget() and setWidgetIndex() to update the properties
-     * of the itemlist widget.
+     * Updates the position and size of the group-header that belongs
+     * to the itemlist widget \a widget. The given widget must represent
+     * the first item of a group.
      */
-    void updateWidgetProperties(KItemListWidget* widget, int index);
+    void updateGroupHeaderLayout(KItemListWidget* widget);
+
+    /**
+     * Recycles the group-header from the widget.
+     */
+    void recycleGroupHeaderForWidget(KItemListWidget* widget);
+
+    /**
+     * Helper method for slotGroupedSortingChanged(), slotSortOrderChanged()
+     * and slotSortRoleChanged(): Iterates through all visible items and updates
+     * the group-header widgets.
+     */
+    void updateVisibleGroupHeaders();
+
+    /**
+     * @return Index for the item in the list returned by KItemModelBase::groups()
+     *         that represents the group where the item with the index \a index
+     *         belongs to. -1 is returned if no groups are available.
+     */
+    int groupIndexForItem(int index) const;
+
+    /**
+     * Updates the alternateBackground-property of the widget dependent
+     * on the state of useAlternateBackgrounds() and the grouping state.
+     */
+    void updateAlternateBackgroundForWidget(KItemListWidget* widget);
+
+    /**
+     * @return True if alternate backgrounds should be used for the items.
+     *         This is the case if an empty item-size is given and if there
+     *         is more than one visible role.
+     */
+    bool useAlternateBackgrounds() const;
+
+    /**
+     * @return The widths of each visible role that is shown in the KItemListHeader.
+     */
+    QHash<QByteArray, qreal> headerRolesWidths() const;
+
+    /**
+     * Updates m_visibleRolesSizes by calling KItemListView::visibleRolesSizes().
+     * Nothing will be done if m_itemRect is not empty or custom header-widths
+     * are used (see m_useHeaderWidths). Also m_strechedVisibleRolesSizes will be adjusted
+     * to respect the available view-size.
+     */
+    void updateVisibleRolesSizes(const KItemRangeList& itemRanges);
+
+    /**
+     * Convenience method for updateVisibleRoleSizes(KItemRangeList() << KItemRange(0, m_model->count()).
+     */
+    void updateVisibleRolesSizes();
+
+    /**
+     * Updates m_stretchedVisibleRolesSizes based on m_visibleRolesSizes and the available
+     * view-size. Nothing will be done if m_itemRect is not empty or custom header-widths
+     * are used (see m_useHeaderWidths).
+     */
+    void updateStretchedVisibleRolesSizes();
+
+    /**
+     * @return Sum of the widths of all visible roles.
+     */
+    qreal visibleRolesSizesWidthSum() const;
 
     /**
-     * Helper function for triggerAutoScrolling(). Returns the scroll increment
-     * that should be added to the offset() based on the available size \a size
-     * and the current mouse position \a pos. As soon as \a pos is inside
-     * the autoscroll-margin a value != 0 will be returned.
+     * @return Sum of the heights of all visible roles.
      */
-    static int calculateAutoScrollingIncrement(int pos, int size);
+    qreal visibleRolesSizesHeightSum() const;
+
+    /**
+     * @return Boundaries of the header. An empty rectangle is returned
+     *         if no header is shown.
+     */
+    QRectF headerBoundaries() const;
+
+    /**
+     * @return True if the number of columns or rows will be changed when applying
+     *         the new grid- and item-size. Used to determine whether an animation
+     *         should be done when applying the new layout.
+     */
+    bool changesItemGridLayout(const QSizeF& newGridSize,
+                               const QSizeF& newItemSize,
+                               const QSizeF& newItemMargin) const;
+
+    /**
+     * @param changedItemCount Number of inserted  or removed items.
+     * @return                 True if the inserting or removing of items should be animated.
+     *                         No animation should be done if the number of items is too large
+     *                         to provide a pleasant animation.
+     */
+    bool animateChangedItemCount(int changedItemCount) const;
+
+    /**
+     * @return True if a scrollbar for the given scroll-orientation is required
+     *         when using a size of \p size for the view. Calling the method is rather
+     *         expansive as a temporary relayout needs to be done.
+     */
+    bool scrollBarRequired(const QSizeF& size) const;
+
+    /**
+     * Applies the height of the group header to the layouter. The height
+     * depends on the used scroll orientation.
+     */
+    void updateGroupHeaderHeight();
+
+    /**
+     * Updates the siblings-information for all visible items that are inside
+     * the range of \p firstIndex and \p lastIndex. If firstIndex or lastIndex
+     * is smaller than 0, the siblings-information for all visible items gets
+     * updated.
+     * @see KItemListWidget::setSiblingsInformation()
+     */
+    void updateSiblingsInformation(int firstIndex = -1, int lastIndex = -1);
+
+    /**
+     * Helper method for updateExpansionIndicators().
+     * @return True if the item with the index \a index has a sibling successor
+     *         (= the item is not the last item of the current hierarchy).
+     */
+    bool hasSiblingSuccessor(int index) const;
+
+    /**
+     * Helper function for triggerAutoScrolling().
+     * @param pos    Logical position of the mouse relative to the range.
+     * @param range  Range of the visible area.
+     * @param oldInc Previous increment. Is used to assure that the increment
+     *               increases only gradually.
+     * @return Scroll increment that should be added to the offset().
+     *         As soon as \a pos is inside the autoscroll-margin a
+     *         value != 0 will be returned.
+     */
+    static int calculateAutoScrollingIncrement(int pos, int range, int oldInc);
+
+    /**
+     * Helper functions for changesItemCount().
+     * @return The number of items that fit into the available size by
+     *         respecting the size of the item and the margin between the items.
+     */
+    static int itemsPerSize(qreal size, qreal itemSize, qreal itemMargin);
 
 private:
-    bool m_autoScrollMarginEnabled;
+    bool m_enabledSelectionToggles;
     bool m_grouped;
+    bool m_supportsItemExpanding;
     int m_activeTransactions; // Counter for beginTransaction()/endTransaction()
+    LayoutAnimationHint m_endTransactionAnimationHint;
 
     QSizeF m_itemSize;
     KItemListController* m_controller;
     KItemModelBase* m_model;
-    QHash<QByteArray, int> m_visibleRoles;
+    QList<QByteArray> m_visibleRoles;
     QHash<QByteArray, QSizeF> m_visibleRolesSizes;
+    QHash<QByteArray, QSizeF> m_stretchedVisibleRolesSizes;
     KItemListWidgetCreatorBase* m_widgetCreator;
     KItemListGroupHeaderCreatorBase* m_groupHeaderCreator;
     KItemListStyleOption m_styleOption;
@@ -297,20 +643,39 @@ private:
     QHash<int, KItemListWidget*> m_visibleItems;
     QHash<KItemListWidget*, KItemListGroupHeader*> m_visibleGroups;
 
+    struct Cell
+    {
+        Cell() : column(-1), row(-1) {}
+        Cell(int c, int r) : column(c), row(r) {}
+        int column;
+        int row;
+    };
+    QHash<int, Cell> m_visibleCells;
+
     int m_scrollBarExtent;
     KItemListSizeHintResolver* m_sizeHintResolver;
     KItemListViewLayouter* m_layouter;
     KItemListViewAnimation* m_animation;
 
     QTimer* m_layoutTimer; // Triggers an asynchronous doLayout() call.
-    qreal m_oldOffset;
-    qreal m_oldMaximumOffset;
+    qreal m_oldScrollOffset;
+    qreal m_oldMaximumScrollOffset;
+    qreal m_oldItemOffset;
+    qreal m_oldMaximumItemOffset;
 
+    bool m_skipAutoScrollForRubberBand;
     KItemListRubberBand* m_rubberBand;
 
     QPointF m_mousePos;
+    int m_autoScrollIncrement;
+    QTimer* m_autoScrollTimer;
 
+    KItemListHeader* m_header;
+    bool m_useHeaderWidths;
+
+    friend class KItemListContainer; // Accesses scrollBarRequired()
     friend class KItemListController;
+    friend class KItemListControllerTest;
 };
 
 /**
@@ -351,7 +716,7 @@ public:
 };
 
 template <class T>
-class LIBDOLPHINPRIVATE_EXPORT KItemListWidgetCreator : public KItemListWidgetCreatorBase
+class KItemListWidgetCreator : public KItemListWidgetCreatorBase
 {
 public:
     virtual ~KItemListWidgetCreator();
@@ -386,16 +751,16 @@ class LIBDOLPHINPRIVATE_EXPORT KItemListGroupHeaderCreatorBase : public KItemLis
 {
 public:
     virtual ~KItemListGroupHeaderCreatorBase();
-    virtual KItemListGroupHeader* create(QGraphicsWidget* parent) = 0;
+    virtual KItemListGroupHeader* create(KItemListView* view) = 0;
     virtual void recycle(KItemListGroupHeader* header);
 };
 
 template <class T>
-class LIBDOLPHINPRIVATE_EXPORT KItemListGroupHeaderCreator : public KItemListGroupHeaderCreatorBase
+class KItemListGroupHeaderCreator : public KItemListGroupHeaderCreatorBase
 {
 public:
     virtual ~KItemListGroupHeaderCreator();
-    virtual KItemListGroupHeader* create(QGraphicsWidget* parent);
+    virtual KItemListGroupHeader* create(KItemListView* view);
 };
 
 template <class T>
@@ -404,11 +769,11 @@ KItemListGroupHeaderCreator<T>::~KItemListGroupHeaderCreator()
 }
 
 template <class T>
-KItemListGroupHeader* KItemListGroupHeaderCreator<T>::create(QGraphicsWidget* parent)
+KItemListGroupHeader* KItemListGroupHeaderCreator<T>::create(KItemListView* view)
 {
     KItemListGroupHeader* widget = static_cast<KItemListGroupHeader*>(popRecycleableWidget());
     if (!widget) {
-        widget = new T(parent);
+        widget = new T(view);
         addCreatedWidget(widget);
     }
     return widget;