]> cloud.milkyroute.net Git - dolphin.git/blobdiff - src/dolphindetailsview.h
Stupid me: The inconsistent behavior between QListView::scrollTo() and QTreeView...
[dolphin.git] / src / dolphindetailsview.h
index b438b3a33527eb0a6d93d3bf368bd0f9f3e14105..38aea12deef7463f0b9ac286d3a9651bdaea3b0e 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  *
 #ifndef DOLPHINDETAILSVIEW_H
 #define DOLPHINDETAILSVIEW_H
 
+#include <dolphinview.h>
 #include <QTreeView>
+#include <libdolphin_export.h>
 
-class DolphinView;
+class DolphinController;
+class SelectionManager;
+class DolphinViewAutoScroller;
 
 /**
  * @brief Represents the details view which shows the name, size,
@@ -33,24 +37,193 @@ class DolphinView;
  * that full available width of the view is used by stretching the width
  * of the name column.
  */
-class DolphinDetailsView : public QTreeView
+class LIBDOLPHINPRIVATE_EXPORT DolphinDetailsView : public QTreeView
 {
     Q_OBJECT
 
 public:
-    explicit DolphinDetailsView(DolphinView* parent);
+    explicit DolphinDetailsView(QWidget* parent, DolphinController* controller);
     virtual ~DolphinDetailsView();
 
 protected:
     virtual bool event(QEvent* event);
     virtual QStyleOptionViewItem viewOptions() const;
     virtual void contextMenuEvent(QContextMenuEvent* event);
+    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 void setSelection(const QRect& rect, QItemSelectionModel::SelectionFlags command);
+    virtual void scrollTo(const QModelIndex& index, ScrollHint hint = EnsureVisible);
+
+private slots:
+    /**
+     * Sets the sort indicator section of the header view
+     * corresponding to \a sorting.
+     */
+    void setSortIndicatorSection(DolphinView::Sorting sorting);
+
+    /**
+     * Sets the sort indicator order of the header view
+     * corresponding to \a sortOrder.
+     */
+    void setSortIndicatorOrder(Qt::SortOrder sortOrder);
+
+    /**
+     * Synchronizes the sorting state of the Dolphin menu 'View -> Sort'
+     * with the current state of the details view.
+     * @param column Index of the current sorting column.
+     */
+    void synchronizeSortingState(int column);
+
+    /**
+     * Is invoked when the mouse cursor has entered an item. The controller
+     * gets informed to emit the itemEntered() signal if the mouse cursor
+     * is above the name column. Otherwise the controller gets informed
+     * to emit the itemViewportEntered() signal (all other columns should
+     * behave as viewport area).
+     */
+    void slotEntered(const QModelIndex& index);
+
+    /**
+     * Updates the destination \a destination from
+     * the elastic band to the current mouse position and triggers
+     * an update.
+     */
+    void updateElasticBand();
+
+    /**
+     * Returns the rectangle for the elastic band dependent from the
+     * origin \a origin, the current destination
+     * \a destination and the viewport position.
+     */
+    QRect elasticBandRect() const;
+
+    void setZoomLevel(int level);
+
+    void slotShowPreviewChanged();
+
+    /**
+     * Opens a context menu at the position \a pos and allows to
+     * configure the visibility of the header columns and whether
+     * expandable folders should be shown.
+     */
+    void configureSettings(const QPoint& pos);
+
+    void updateColumnVisibility();
+
+    /**
+     * 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);
+
+private:
+    /**
+     * Updates the size of the decoration dependent on the
+     * icon size of the DetailsModeSettings. The controller
+     * will get informed about possible zoom in/zoom out
+     * operations.
+     */
+    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();
+
+    QRect nameColumnRect(const QModelIndex& index) const;
 
 private:
-    DolphinView* m_parentView;
+    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.
+
+    DolphinController* m_controller;
+    SelectionManager* m_selectionManager;
+    DolphinViewAutoScroller* m_autoScroller;
+    QAction* m_expandableFoldersAction;
+
+    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;
+
+        // If true, compute the set of selected elements from scratch (slower)
+        bool ignoreOldInfo;
+
+        // 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