src/dolphindetailsview.h

   1 /***************************************************************************
   2  *   Copyright (C) 2006 by Peter Penz                                      *
   3  *   peter.penz@gmx.at                                                     *
   4  *                                                                         *
   5  *   This program is free software; you can redistribute it and/or modify  *
   6  *   it under the terms of the GNU General Public License as published by  *
   7  *   the Free Software Foundation; either version 2 of the License, or     *
   8  *   (at your option) any later version.                                   *
   9  *                                                                         *
  10  *   This program is distributed in the hope that it will be useful,       *
  11  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  12  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  13  *   GNU General Public License for more details.                          *
  14  *                                                                         *
  15  *   You should have received a copy of the GNU General Public License     *
  16  *   along with this program; if not, write to the                         *
  17  *   Free Software Foundation, Inc.,                                       *
  18  *   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA            *
  19  ***************************************************************************/
  20
  21 #ifndef DOLPHINDETAILSVIEW_H
  22 #define DOLPHINDETAILSVIEW_H
  23
  24 #include <dolphinview.h>
  25 #include <QTreeView>
  26 #include <libdolphin_export.h>
  27
  28 class DolphinController;
  29 class SelectionManager;
  30
  31 /**
  32  * @brief Represents the details view which shows the name, size,
  33  *        date, permissions, owner and group of an item.
  34  *
  35  * The width of the columns is automatically adjusted in a way
  36  * that full available width of the view is used by stretching the width
  37  * of the name column.
  38  */
  39 class LIBDOLPHINPRIVATE_EXPORT DolphinDetailsView : public QTreeView
  40 {
  41     Q_OBJECT
  42
  43 public:
  44     explicit DolphinDetailsView(QWidget* parent, DolphinController* controller);
  45     virtual ~DolphinDetailsView();
  46
  47 protected:
  48     virtual bool event(QEvent* event);
  49     virtual QStyleOptionViewItem viewOptions() const;
  50     virtual void contextMenuEvent(QContextMenuEvent* event);
  51     virtual void mousePressEvent(QMouseEvent* event);
  52     virtual void mouseMoveEvent(QMouseEvent* event);
  53     virtual void mouseReleaseEvent(QMouseEvent* event);
  54     virtual void startDrag(Qt::DropActions supportedActions);
  55     virtual void dragEnterEvent(QDragEnterEvent* event);
  56     virtual void dragLeaveEvent(QDragLeaveEvent* event);
  57     virtual void dragMoveEvent(QDragMoveEvent* event);
  58     virtual void dropEvent(QDropEvent* event);
  59     virtual void paintEvent(QPaintEvent* event);
  60     virtual void keyPressEvent(QKeyEvent* event);
  61     virtual void keyReleaseEvent(QKeyEvent* event);
  62     virtual void resizeEvent(QResizeEvent* event);
  63     virtual void wheelEvent(QWheelEvent* event);
  64     virtual void currentChanged(const QModelIndex& current, const QModelIndex& previous);
  65     virtual bool eventFilter(QObject* watched, QEvent* event);
  66     virtual QModelIndex indexAt (const QPoint& point) const;
  67     virtual void setSelection(const QRect& rect, QItemSelectionModel::SelectionFlags command);
  68
  69 private slots:
  70     /**
  71      * Sets the sort indicator section of the header view
  72      * corresponding to \a sorting.
  73      */
  74     void setSortIndicatorSection(DolphinView::Sorting sorting);
  75
  76     /**
  77      * Sets the sort indicator order of the header view
  78      * corresponding to \a sortOrder.
  79      */
  80     void setSortIndicatorOrder(Qt::SortOrder sortOrder);
  81
  82     /**
  83      * Synchronizes the sorting state of the Dolphin menu 'View -> Sort'
  84      * with the current state of the details view.
  85      * @param column Index of the current sorting column.
  86      */
  87     void synchronizeSortingState(int column);
  88
  89     /**
  90      * Is invoked when the mouse cursor has entered an item. The controller
  91      * gets informed to emit the itemEntered() signal if the mouse cursor
  92      * is above the name column. Otherwise the controller gets informed
  93      * to emit the itemViewportEntered() signal (all other columns should
  94      * behave as viewport area).
  95      */
  96     void slotEntered(const QModelIndex& index);
  97
  98     /**
  99      * Updates the destination \a m_elasticBandDestination from
 100      * the elastic band to the current mouse position and triggers
 101      * an update.
 102      */
 103     void updateElasticBand();
 104
 105     /**
 106      * Returns the rectangle for the elastic band dependent from the
 107      * origin \a m_elasticBandOrigin, the current destination
 108      * \a m_elasticBandDestination and the viewport position.
 109      */
 110     QRect elasticBandRect() const;
 111
 112     void setZoomLevel(int level);
 113
 114     void slotShowPreviewChanged();
 115
 116     /**
 117      * Opens a context menu at the position \a pos and allows to
 118      * configure the visibility of the header columns.
 119      */
 120     void configureColumns(const QPoint& pos);
 121
 122     void updateColumnVisibility();
 123
 124     /**
 125      * Disables the automatical resizing of columns, if the user has resized the columns
 126      * with the mouse.
 127      */
 128     void slotHeaderSectionResized(int logicalIndex, int oldSize, int newSize);
 129
 130     /**
 131      * Changes the alternating row colors setting depending from
 132      * the activation state \a active.
 133      */
 134     void slotActivationChanged(bool active);
 135
 136     /**
 137      * Disables the automatical resizing of the columns. Per default all columns
 138      * are resized to use the maximum available width of the view as good as possible.
 139      */
 140     void disableAutoResizing();
 141
 142     void requestActivation();
 143
 144     void updateFont();
 145
 146 private:
 147     /**
 148      * Updates the size of the decoration dependent on the
 149      * icon size of the DetailsModeSettings. The controller
 150      * will get informed about possible zoom in/zoom out
 151      * operations.
 152      */
 153     void updateDecorationSize(bool showPreview);
 154
 155     /** Return the upper left position in pixels of the viewport content. */
 156     QPoint contentsPos() const;
 157
 158     KFileItemDelegate::Information infoForColumn(int columnIndex) const;
 159
 160     /**
 161      * Resizes all columns in a way to use the whole available width of the view.
 162      */
 163     void resizeColumns();
 164
 165     QRect nameColumnRect(const QModelIndex& index) const;
 166
 167     void setSelectionRecursive(const QModelIndex& startIndex,
 168                                const QRect& rect,
 169                                QItemSelectionModel::SelectionFlags command);
 170
 171 private:
 172         bool m_autoResize : 1;        // if true, the columns are resized automatically to the available width
 173     bool m_expandingTogglePressed : 1;
 174     bool m_keyPressed : 1;        // true if a key is pressed currently; info used by currentChanged()
 175     bool m_useDefaultIndexAt : 1; // true, if QTreeView::indexAt() should be used
 176
 177     DolphinController* m_controller;
 178     SelectionManager* m_selectionManager;
 179
 180     QFont m_font;
 181     QSize m_decorationSize;
 182
 183     QRect m_dropRect;
 184
 185     // Elastic band coordinates are relative to the origin of the
 186     // view, not the viewport.
 187     bool m_showElasticBand;
 188     QPoint m_elasticBandOrigin;
 189     QPoint m_elasticBandDestination;
 190
 191 };
 192
 193 #endif