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