apps/dolphin/src/dolphinviewactionhandler.h

   1 /***************************************************************************
   2  *   Copyright (C) 2008 by David Faure <faure@kde.org>                     *
   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
  21 #ifndef DOLPHINVIEWACTIONHANDLER_H
  22 #define DOLPHINVIEWACTIONHANDLER_H
  23
  24 #include "dolphinview.h"
  25 #include "libdolphin_export.h"
  26 #include <QtCore/QObject>
  27 class KToggleAction;
  28 class QAction;
  29 class QActionGroup;
  30 class DolphinView;
  31 class KActionCollection;
  32
  33 /**
  34  * @short Handles all actions for DolphinView
  35  *
  36  * The action handler owns all the actions and slots related to DolphinView,
  37  * but can the view that is acts upon can be switched to another one
  38  * (this is used in the case of split views).
  39  *
  40  * The purpose of this class is also to share this code between DolphinMainWindow
  41  * and DolphinPart.
  42  *
  43  * @see DolphinView
  44  * @see DolphinMainWindow
  45  * @see DolphinPart
  46  */
  47 class LIBDOLPHINPRIVATE_EXPORT DolphinViewActionHandler : public QObject
  48 {
  49     Q_OBJECT
  50
  51 public:
  52     explicit DolphinViewActionHandler(KActionCollection* collection, QObject* parent);
  53
  54     /**
  55      * Sets the view that this action handler should work on.
  56      */
  57     void setCurrentView(DolphinView* view);
  58
  59     /**
  60      * Returns the name of the action for the current viewmode
  61      */
  62     QString currentViewModeActionName() const;
  63
  64 public Q_SLOTS:
  65     /**
  66      * Update all actions in the 'View' menu, i.e. those that depend on the
  67      * settings in the current view.
  68      */
  69     void updateViewActions();
  70
  71 Q_SIGNALS:
  72     /**
  73      * Emitted by DolphinViewActionHandler when the user triggered an action.
  74      * This is only used for clearining the statusbar in DolphinMainWindow.
  75      */
  76     void actionBeingHandled();
  77
  78 private Q_SLOTS:
  79     /**
  80      * Opens the dialog for creating a directory. Is connected
  81      * with the key shortcut for "new directory" (F10).
  82      */
  83     void slotCreateDir();
  84
  85     /**
  86      * Emitted when the user requested a change of view mode
  87      */
  88     void slotViewModeActionTriggered(QAction*);
  89
  90     /**
  91      * Let the user input a name for the selected item(s) and trigger
  92      * a renaming afterwards.
  93      */
  94     void slotRename();
  95
  96     /**
  97      * Moves the selected items of the active view to the trash.
  98      * This methods adds "shift means del" handling.
  99      */
 100     void slotTrashActivated(Qt::MouseButtons, Qt::KeyboardModifiers);
 101
 102     /**
 103      * Deletes the selected items of the active view.
 104      */
 105     void slotDeleteItems();
 106
 107     /**
 108      * Switches between showing a preview of the file content and showing the icon.
 109      */
 110     void togglePreview(bool);
 111
 112     /** Updates the state of the 'Show preview' menu action. */
 113     void slotShowPreviewChanged();
 114
 115     /** Increases the size of the current set view mode. */
 116     void zoomIn();
 117
 118     /** Decreases the size of the current set view mode. */
 119     void zoomOut();
 120
 121     /** Switches between an ascending and descending sorting order. */
 122     void toggleSortOrder();
 123
 124     /**
 125      * Updates the state of the 'Sort Ascending/Descending' action.
 126      */
 127     void slotSortOrderChanged(Qt::SortOrder order);
 128
 129     /**
 130      * Updates the state of the 'Sort by' actions.
 131      */
 132     void slotSortingChanged(DolphinView::Sorting sorting);
 133
 134     /**
 135      * Updates the state of the 'Zoom In' and 'Zoom Out' actions.
 136      */
 137     void slotZoomLevelChanged(int level);
 138
 139     /**
 140      * Switches on or off the displaying of additional information
 141      * as specified by \a action.
 142      */
 143     void toggleAdditionalInfo(QAction* action);
 144
 145     /**
 146      * Changes the sorting of the current view.
 147      */
 148     void slotSortTriggered(QAction*);
 149
 150     /**
 151      * Updates the state of the 'Additional Information' actions.
 152      */
 153     void slotAdditionalInfoChanged();
 154
 155     /**
 156      * Switches between sorting by categories or not.
 157      */
 158     void toggleSortCategorization(bool);
 159
 160     /**
 161      * Updates the state of the 'Categorized sorting' menu action.
 162      */
 163     void slotCategorizedSortingChanged();
 164
 165     /**
 166      * Switches between showing and hiding of hidden marked files
 167      */
 168     void toggleShowHiddenFiles(bool);
 169
 170     /**
 171      * Updates the state of the 'Show hidden files' menu action.
 172      */
 173     void slotShowHiddenFilesChanged();
 174
 175     /**
 176      * Opens the view properties dialog, which allows to modify the properties
 177      * of the currently active view.
 178      */
 179     void slotAdjustViewProperties();
 180
 181     /**
 182      * Opens the Find File dialog for the currently shown directory.
 183      */
 184     void slotFindFile();
 185
 186     /**
 187      * Connected to the "properties" action.
 188      * Opens the properties dialog for the selected items of the
 189      * active view. The properties dialog shows information
 190      * like name, size and permissions.
 191      */
 192     void slotProperties();
 193
 194 private:
 195     /**
 196      * Create all the actions.
 197      * This is called only once (by the constructor)
 198      */
 199     void createActions();
 200     /**
 201      * Creates an action group with all the "show additional information" actions in it.
 202      * Helper method for createActions();
 203      */
 204     QActionGroup* createAdditionalInformationActionGroup();
 205
 206     /**
 207      * Creates an action group with all the "sort by" actions in it.
 208      * Helper method for createActions();
 209      */
 210     QActionGroup* createSortByActionGroup();
 211
 212     /**
 213      * Returns the "switch to icons mode" action.
 214      * Helper method for createActions();
 215      */
 216     KToggleAction* iconsModeAction();
 217
 218     /**
 219      * Returns the "switch to details mode" action.
 220      * Helper method for createActions();
 221      */
 222     KToggleAction* detailsModeAction();
 223
 224     /**
 225      * Returns the "switch to columns mode" action.
 226      * Helper method for createActions();
 227      */
 228     KToggleAction* columnsModeAction();
 229
 230
 231     KActionCollection* m_actionCollection;
 232     DolphinView* m_currentView;
 233 };
 234
 235 #endif /* DOLPHINVIEWACTIONHANDLER_H */