]> cloud.milkyroute.net Git - dolphin.git/blobdiff - src/dolphindetailsview.h
Fix temporary regression of sorting introduced by SVN commit 1126410
[dolphin.git] / src / dolphindetailsview.h
index 57fb98f2248149f3a5b394a01a781ecf6bbd1b66..1dff8fe59d3708f8b66f1529949f842e1a3cc9b5 100644 (file)
@@ -1,6 +1,6 @@
 /***************************************************************************
- *   Copyright (C) 2006 by Peter Penz                                      *
- *   peter.penz@gmx.at                                                     *
+ *   Copyright (C) 2006 by Peter Penz (peter.penz@gmx.at)                  *
+ *   Copyright (C) 2008 by Simon St. James (kdedevel@etotheipiplusone.com) *
  *                                                                         *
  *   This program is free software; you can redistribute it and/or modify  *
  *   it under the terms of the GNU General Public License as published by  *
 #define DOLPHINDETAILSVIEW_H
 
 #include <dolphinview.h>
-#include <QtGui/QStyleOption>
-#include <QtGui/QTreeView>
+#include <QTreeView>
 #include <libdolphin_export.h>
 
-class DolphinController;
+class DolphinViewController;
+class DolphinSortFilterProxyModel;
+class ViewExtensionsFactory;
 
 /**
  * @brief Represents the details view which shows the name, size,
@@ -41,9 +42,28 @@ class LIBDOLPHINPRIVATE_EXPORT DolphinDetailsView : public QTreeView
     Q_OBJECT
 
 public:
-    explicit DolphinDetailsView(QWidget* parent, DolphinController* controller);
+    /**
+     * @param parent                Parent widget.
+     * @param dolphinViewController Allows the DolphinDetailsView to control the
+     *                              DolphinView in a limited way.
+     * @param viewModeController    Controller that is used by the DolphinView
+     *                              to control the DolphinDetailsView. The DolphinDetailsView
+     *                              only has read access to the controller.
+     * @param model                 Directory that is shown.
+     */
+    explicit DolphinDetailsView(QWidget* parent,
+                                DolphinViewController* dolphinViewController,
+                                const ViewModeController* viewModeController,
+                                DolphinSortFilterProxyModel* model);
     virtual ~DolphinDetailsView();
 
+    /**
+     * Returns a set containing the URLs of all expanded items.
+     */
+    QSet<KUrl> expandedUrls() const;
+
+    virtual QRegion visualRegionForSelection(const QItemSelection& selection) const;
+
 protected:
     virtual bool event(QEvent* event);
     virtual QStyleOptionViewItem viewOptions() const;
@@ -51,13 +71,22 @@ protected:
     virtual void mousePressEvent(QMouseEvent* event);
     virtual void mouseMoveEvent(QMouseEvent* event);
     virtual void mouseReleaseEvent(QMouseEvent* event);
+    virtual void startDrag(Qt::DropActions supportedActions);
     virtual void dragEnterEvent(QDragEnterEvent* event);
     virtual void dragLeaveEvent(QDragLeaveEvent* event);
     virtual void dragMoveEvent(QDragMoveEvent* event);
     virtual void dropEvent(QDropEvent* event);
     virtual void paintEvent(QPaintEvent* event);
     virtual void keyPressEvent(QKeyEvent* event);
+    virtual void keyReleaseEvent(QKeyEvent* event);
     virtual void resizeEvent(QResizeEvent* event);
+    virtual void wheelEvent(QWheelEvent* event);
+    virtual void currentChanged(const QModelIndex& current, const QModelIndex& previous);
+    virtual bool eventFilter(QObject* watched, QEvent* event);
+    virtual QModelIndex indexAt (const QPoint& point) const;
+    virtual QRect visualRect(const QModelIndex& index) const;
+    virtual void setSelection(const QRect& rect, QItemSelectionModel::SelectionFlags command);
+    virtual void scrollTo(const QModelIndex& index, ScrollHint hint = EnsureVisible);
 
 private slots:
     /**
@@ -89,7 +118,7 @@ private slots:
     void slotEntered(const QModelIndex& index);
 
     /**
-     * Updates the destination \a m_elasticBandDestination from
+     * Updates the destination \a destination from
      * the elastic band to the current mouse position and triggers
      * an update.
      */
@@ -97,30 +126,83 @@ private slots:
 
     /**
      * Returns the rectangle for the elastic band dependent from the
-     * origin \a m_elasticBandOrigin, the current destination
-     * \a m_elasticBandDestination and the viewport position.
+     * origin \a origin, the current destination
+     * \a destination and the viewport position.
      */
     QRect elasticBandRect() const;
 
-    void zoomIn();
-    void zoomOut();
+    void setZoomLevel(int level);
 
-    /**
-     * Called by QTreeView when an item is activated (clicked or double-clicked)
-     */
-    void triggerItem(const QModelIndex& index);
+    void slotShowPreviewChanged();
 
     /**
      * Opens a context menu at the position \a pos and allows to
-     * configure the visibility of the header columns.
+     * configure the visibility of the header columns and whether
+     * expandable folders should be shown.
      */
-    void configureColumns(const QPoint& pos);
+    void configureSettings(const QPoint& pos);
 
+    /**
+     * Updates the visibilty state of columns and their order.
+     */
     void updateColumnVisibility();
 
+    /**
+     * Saves order of the columns as global setting.
+     */
+    void saveColumnPositions();
+
+    /**
+     * Disables the automatical resizing of columns, if the user has resized the columns
+     * with the mouse.
+     */
+    void slotHeaderSectionResized(int logicalIndex, int oldSize, int newSize);
+
+    /**
+     * Changes the alternating row colors setting depending from
+     * the activation state \a active.
+     */
+    void slotActivationChanged(bool active);
+
+    /**
+     * Disables the automatical resizing of the columns. Per default all columns
+     * are resized to use the maximum available width of the view as good as possible.
+     */
+    void disableAutoResizing();
+
+    void requestActivation();
+
+    void slotGlobalSettingsChanged(int category);
+
+    /**
+     * If the elastic band is currently shown, update the elastic band based on
+     * the current mouse position and ensure that the selection is the set of items
+     * intersecting it.
+     */
+    void updateElasticBandSelection();
+
+    /**
+     * If \a expandable is true, the details view acts as tree view.
+     * The current expandable state is remembered in the settings.
+     */
+    void setFoldersExpandable(bool expandable);
+
+    /**
+     * These slots update the list of expanded items.
+     */
+    void slotExpanded(const QModelIndex& index);
+    void slotCollapsed(const QModelIndex& index);
+
+protected slots:
+
+    virtual void rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end);
+
 private:
-    bool isZoomInPossible() const;
-    bool isZoomOutPossible() const;
+    /**
+     * Removes the URLs corresponding to the children of \a index in the rows
+     * between \a start and \a end inclusive from the set of expanded URLs.
+     */
+    void removeExpandedIndexes(const QModelIndex& parent, int start, int end);
 
     /**
      * Updates the size of the decoration dependent on the
@@ -128,23 +210,78 @@ private:
      * will get informed about possible zoom in/zoom out
      * operations.
      */
-    void updateDecorationSize();
+    void updateDecorationSize(bool showPreview);
+
+    KFileItemDelegate::Information infoForColumn(int columnIndex) const;
+
+    /**
+     * Resizes all columns in a way to use the whole available width of the view.
+     */
+    void resizeColumns();
 
-    /** Return the upper left position in pixels of the viewport content. */
-    QPoint contentsPos() const;
+    /**
+     * Returns true, if \a pos is within the expanding toggle of a tree.
+     */
+    bool isAboveExpandingToggle(const QPoint& pos) const;
 
-    KFileItem itemForIndex(const QModelIndex& index) const;
+    /**
+     * Sets the maximum size available for editing in the delegate.
+     */
+    void adjustMaximumSizeForEditing(const QModelIndex& index);
 
 private:
-    DolphinController* m_controller;
-    QStyleOptionViewItem m_viewOptions;
+    bool m_autoResize : 1;        // if true, the columns are resized automatically to the available width
+    bool m_expandingTogglePressed : 1;
+    bool m_keyPressed : 1;        // true if a key is pressed currently; info used by currentChanged()
+    bool m_useDefaultIndexAt : 1; // true, if QTreeView::indexAt() should be used
+    bool m_ignoreScrollTo : 1;    // true if calls to scrollTo(...) should do nothing.
+
+    DolphinViewController* m_dolphinViewController;
+    const ViewModeController* m_viewModeController;
+    ViewExtensionsFactory* m_extensionsFactory;
+    QAction* m_expandableFoldersAction;
+
+    // A set containing the URLs of all currently expanded folders.
+    // We cannot use a QSet<QModelIndex> because a QModelIndex is not guaranteed to remain valid over time.
+    // Also a QSet<QPersistentModelIndex> does not work as expected because it is not guaranteed that
+    // subsequent expand/collapse events of the same file item will yield the same QPersistentModelIndex.
+    QSet<KUrl> m_expandedUrls;
+
+    QFont m_font;
+    QSize m_decorationSize;
+
+    QRect m_dropRect;
+
+    struct ElasticBand
+    {
+        ElasticBand();
+
+        // Elastic band origin and destination coordinates are relative to t
+        // he origin of the view, not the viewport.
+        bool show;
+        QPoint origin;
+        QPoint destination;
+
+        // Optimization mechanisms for use with elastic band selection.
+        // Basically, allow "incremental" updates to the selection based
+        // on the last elastic band shape.
+        QPoint lastSelectionOrigin;
+        QPoint lastSelectionDestination;
 
-    bool m_dragging;   // TODO: remove this property when the issue #160611 is solved in Qt 4.4
-    QRect m_dropRect;  // TODO: remove this property when the issue #160611 is solved in Qt 4.4
+        // If true, compute the set of selected elements from scratch (slower)
+        bool ignoreOldInfo;
 
-    bool m_showElasticBand;
-    QPoint m_elasticBandOrigin;
-    QPoint m_elasticBandDestination;
+        // Edges of the filenames that are closest to the edges of oldSelectionRect.
+        // Used to decide whether horizontal changes in the elastic band are likely
+        // to require us to re-check which items are selected.
+        int outsideNearestLeftEdge;
+        int outsideNearestRightEdge;
+        int insideNearestLeftEdge;
+        int insideNearestRightEdge;
+        // The set of items that were selected at the time this band was shown.
+        // NOTE: Unless CTRL was pressed when the band was created, this is always empty.
+        QItemSelection originalSelection;
+    } m_band;
 };
 
 #endif