]> cloud.milkyroute.net Git - dolphin.git/blobdiff - src/dolphinmainwindow.h
allow to enable the categorization feature for sorting
[dolphin.git] / src / dolphinmainwindow.h
index 57d3708905cf584ec6d30bc1e32b6f7aaf853b17..bdb7ec59aeb6827a08386cda03ffae158bf90560 100644 (file)
  *   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA            *
  ***************************************************************************/
 
-#ifndef _DOLPHIN_MAINWINDOW_H_
-#define _DOLPHIN_MAINWINDOW_H_
+#ifndef DOLPHIN_MAINWINDOW_H
+#define DOLPHIN_MAINWINDOW_H
 
 #include "dolphinview.h"
+#include "sidebarpage.h"
 
 #include <kmainwindow.h>
 #include <ksortablelist.h>
 
 #include <QList>
 
+class DolphinApplication;
 class KNewMenu;
-class KPrinter;
 class KUrl;
-class QLineEdit;
-class KFileIconView;
-class KHBox;
-class Q3IconViewItem;
 class QSplitter;
-class KAction;
-class UrlNavigator;
-class DolphinApplication;
 
 /**
  * @short Main window for Dolphin.
@@ -57,20 +51,42 @@ class DolphinMainWindow: public KMainWindow
 public:
     virtual ~DolphinMainWindow();
 
-       /**
-     * Activates the given view, which means that
-     * all menu actions are applied to this view. When
-     * having a split view setup the nonactive view
-     * is usually shown in darker colors.
-     */
+    /**
+        * Activates the given view, which means that
+        * all menu actions are applied to this view. When
+        * having a split view setup the nonactive view
+        * is usually shown in darker colors.
+        */
     void setActiveView(DolphinView* view);
 
     /**
      * Returns the currently active view. See
      * DolphinMainWindow::setActiveView() for more details.
      */
-    DolphinView* activeView() const { return m_activeView; }
+    DolphinView* activeView() const
+    {
+        return m_activeView;
+    }
+
+    /** Renames the item represented by \a oldUrl to \a newUrl. */
+    void rename(const KUrl& oldUrl, const KUrl& newUrl);
+
+    /**
+     * Refreshs the views of the main window by recreating them dependent from
+     * the given Dolphin settings.
+     */
+    void refreshViews();
+
+    /**
+     * Returns the 'Create New...' sub menu which also can be shared
+     * with other menus (e. g. a context menu).
+     */
+    KNewMenu* newMenu() const
+    {
+        return m_newMenu;
+    }
 
+public slots:
     /**
      * Handles the dropping of URLs to the given
      * destination. A context menu with the options
@@ -85,31 +101,25 @@ public:
     void dropUrls(const KUrl::List& urls,
                   const KUrl& destination);
 
-    /** Renames the item represented by \a oldUrl to \a newUrl. */
-    void rename(const KUrl& oldUrl, const KUrl& newUrl);
-
     /**
-     * Refreshs the views of the main window by recreating them dependent from
-     * the given Dolphin settings.
-     */
-    void refreshViews();
-
-    /**
-     * Returns the 'Create New...' sub menu which also can be shared
-     * with other menus (e. g. a context menu).
+     * Returns the main window ID used through DBus.
      */
-    KNewMenu* newMenu() const { return m_newMenu; }
+    int getId() const
+    {
+        return m_id;
+    }
 
-public slots:
     /**
-     * Returns the main windows ID, mainly used throught DBus.
+     * Inform all affected dolphin components (sidebars, views) of an URL
+     * change.
      */
-    int getId() const { return m_id; }
+    void changeUrl(const KUrl& url);
 
     /**
-     * Changes the URL of the current active DolphinView to \a url.
+     * Inform all affected dolphin components that a selection change is
+     * requested.
      */
-    void changeUrl(const QString& url);
+    void changeSelection(const KFileItemList& selection);
 
     /** Stores all settings and quits Dolphin. */
     void quit();
@@ -122,10 +132,16 @@ signals:
     void activeViewChanged();
 
     /**
-     * Is send if the selection of the currently active view has
+     * Is sent if the selection of the currently active view has
      * been changed.
      */
-    void selectionChanged();
+    void selectionChanged(const KFileItemList& selection);
+
+    /**
+     * Is sent if the url of the currently active view has
+     * been changed.
+     */
+    void urlChanged(const KUrl& url);
 
 protected:
     /** @see QMainWindow::closeEvent */
@@ -225,6 +241,9 @@ private slots:
     /** The current active view is switched to the details mode. */
     void setDetailsView();
 
+    /** The current active view is switched to the column mode. */
+    void setColumnView();
+
     /** The sorting of the current view should be done by the name. */
     void sortByName();
 
@@ -246,6 +265,9 @@ private slots:
     /** Switches between an ascending and descending sorting order. */
     void toggleSortOrder();
 
+    /** Switches between sorting by categories or not. */
+    void toggleSortCategorization();
+
     /**
      * Clears any additional information for an item except for the
      * name and the icon.
@@ -345,6 +367,9 @@ private slots:
     /** Updates the state of the 'Show hidden files' menu action. */
     void slotShowHiddenFilesChanged();
 
+    /** Updates the state of the 'Categorized sorting' menu action. */
+    void slotCategorizedSortingChanged();
+
     /** Updates the state of the 'Sort by' actions. */
     void slotSortingChanged(DolphinView::Sorting sorting);
 
@@ -355,7 +380,7 @@ private slots:
     void slotAdditionalInfoChanged(KFileItemDelegate::AdditionalInformation info);
 
     /** Updates the state of the 'Edit' menu actions. */
-    void slotSelectionChanged();
+    void slotSelectionChanged(const KFileItemList& selection);
 
     /**
      * Updates the state of the 'Back' and 'Forward' menu
@@ -363,12 +388,6 @@ private slots:
      */
     void slotHistoryChanged();
 
-    /**
-     * Updates the caption of the main window and the state
-     * of all menu actions which depend from a changed URL.
-     */
-    void slotUrlChanged(const KUrl& url);
-
     /** Updates the state of the 'Show filter bar' menu action. */
     void updateFilterBarAction(bool show);
 
@@ -400,6 +419,11 @@ private:
      */
     void connectViewSignals(int viewIndex);
 
+    /**
+     * Helper function to connect all signal/slots of the given \sidebar.
+     */
+    void connectSidebarPage(SidebarPage* sidebar);
+
 private:
     /**
      * DolphinMainWindowsupports only one or two views, which
@@ -416,7 +440,7 @@ private:
      * assures that all errors are shown in the status bar of Dolphin
      * instead as modal error dialog with an OK button.
      */
-    class UndoUiInterface : public KonqUndoManager::UiInterface
+class UndoUiInterface : public KonqUndoManager::UiInterface
     {
     public:
         UndoUiInterface(DolphinMainWindow* mainWin);
@@ -438,5 +462,5 @@ private:
     QList<KonqUndoManager::CommandType> m_undoCommandTypes;
 };
 
-#endif // _DOLPHIN_H_
+#endif // DOLPHIN_MAINWINDOW_H