X-Git-Url: https://cloud.milkyroute.net/gitweb/dolphin.git/blobdiff_plain/abf17941f7a052d25788d2f2f3c84e5aae935e29..ec00f379dc42b00a64ab1af25bb4bb1a06bd7449:/src/dolphinmainwindow.h diff --git a/src/dolphinmainwindow.h b/src/dolphinmainwindow.h index 7a71b685c..81b8f02c1 100644 --- a/src/dolphinmainwindow.h +++ b/src/dolphinmainwindow.h @@ -19,36 +19,32 @@ * 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 +#include + +#include #include -#include #include -#include +#include +class DolphinApplication; +class DolphinViewContainer; 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. * * Handles the menus, toolbars and Dolphin views. */ -class DolphinMainWindow: public KMainWindow +class DolphinMainWindow: public KXmlGuiWindow { Q_OBJECT Q_CLASSINFO("D-Bus Interface", "org.kde.dolphin.MainWindow") @@ -58,36 +54,34 @@ 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 + /** + * Returns the currently active view. + * 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); + inline DolphinViewContainer* activeViewContainer() const; /** - * Returns the currently active view. See - * DolphinMainWindow::setActiveView() for more details. + * Returns true, if the main window contains two instances + * of a view container. The active view constainer can be + * accessed by DolphinMainWindow::activeViewContainer(). */ - DolphinView* activeView() const { return m_activeView; } + inline bool isSplit() const; /** - * Handles the dropping of Urls to the given - * destination. A context menu with the options - * 'Move Here', 'Copy Here', 'Link Here' and - * 'Cancel' is offered to the user. - * @param urls List of Urls which have been - * dropped. - * @param destination Destination Url, where the - * list or Urls should be moved, - * copied or linked to. + * If the main window contains two instances of a view container + * (DolphinMainWindow::isSplit() returns true), then the + * two views get toggled (the right view is on the left, the left + * view on the right). */ - void dropUrls(const KUrl::List& urls, - const KUrl& destination); + void toggleViews(); + + /** 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 + * Refreshes the views of the main window by recreating them dependent from * the given Dolphin settings. */ void refreshViews(); @@ -96,18 +90,39 @@ public: * 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; } + inline KNewMenu* newMenu() const; public slots: /** - * Returns the main windows ID, mainly used throught DBus. + * Handles the dropping of URLs to the given + * destination. A context menu with the options + * 'Move Here', 'Copy Here', 'Link Here' and + * 'Cancel' is offered to the user. + * @param urls List of URLs which have been + * dropped. + * @param destination Destination URL, where the + * list or URLs should be moved, + * copied or linked to. + */ + void dropUrls(const KUrl::List& urls, + const KUrl& destination); + + /** + * Returns the main window ID used through DBus. + */ + inline int getId() const; + + /** + * 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 QList& selection); /** Stores all settings and quits Dolphin. */ void quit(); @@ -120,10 +135,22 @@ 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(const QList& selection); + + /** + * Is sent if the url of the currently active view has * been changed. */ - void selectionChanged(); + void urlChanged(const KUrl& url); + + /** + * Is emitted if information of an item is requested to be shown e. g. in the sidebar. + * If item is null, no item information request is pending. + */ + void requestItemInfo(const KFileItem& item); protected: /** @see QMainWindow::closeEvent */ @@ -146,7 +173,10 @@ private slots: /** Updates the 'Create New...' sub menu. */ void updateNewMenu(); - /** Renames the selected item of the active view. */ + /** + * Let the user input a name for the selected item(s) and trigger + * a renaming afterwards. + */ void rename(); /** Moves the selected items of the active view to the trash. */ @@ -157,11 +187,17 @@ private slots: /** * Opens the properties window for the selected items of the - * active view. The properties windows shows informations + * active view. The properties windows shows information * like name, size and permissions. */ void properties(); + /** + * Shows the error information from the places model + * in the status bar. + */ + void slotHandlePlacesError(const QString &message); + /** * Shows the error information of the job \a job * in the status bar. @@ -220,6 +256,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(); @@ -238,9 +277,36 @@ private slots: /** The sorting of the current view should be done by the group. */ void sortByGroup(); + /** The sorting of the current view should be done by the type. */ + void sortByType(); + + /** The sorting of the current view should be done by the rating. */ + void sortByRating(); + + /** The sorting of the current view should be done by tags. */ + void sortByTags(); + /** 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. + */ + void clearInfo(); + + /** Shows the MIME type as additional information for the item. */ + void showMimeInfo(); + + /** Shows the size as additional information for the item. */ + void showSizeInfo(); + + /** Shows the date as additional information for the item. */ + void showDateInfo(); + /** * Switches between one and two views: * If one view is visible, it will get split into two views. @@ -264,10 +330,10 @@ private slots: void toggleShowHiddenFiles(); /** - * Switches between showing and hiding of the filter bar dependent + * Toggles between showing and hiding of the filter bar dependent * from the current state of the 'Show Filter Bar' menu toggle action. */ - void showFilterBar(); + void toggleFilterBarVisibility(); /** Increases the size of the current set view mode. */ void zoomIn(); @@ -292,21 +358,18 @@ private slots: */ void adjustViewProperties(); - /** Goes back on step of the Url history. */ + /** Goes back on step of the URL history. */ void goBack(); - /** Goes forward one step of the Url history. */ + /** Goes forward one step of the URL history. */ void goForward(); - /** Goes up one hierarchy of the current Url. */ + /** Goes up one hierarchy of the current URL. */ void goUp(); - /** Goes to the home Url. */ + /** Goes to the home URL. */ void goHome(); - /** Opens a terminal for the current shown directory. */ - void openTerminal(); - /** Opens KFind for the current shown directory. */ void findFile(); @@ -319,29 +382,38 @@ private slots: /** Updates the state of all 'View' menu actions. */ void slotViewModeChanged(); + /** Updates the state of the 'Show preview' menu action. */ + void slotShowPreviewChanged(); + /** 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); /** Updates the state of the 'Sort Ascending/Descending' action. */ void slotSortOrderChanged(Qt::SortOrder order); - /** Updates the state of the 'Edit' menu actions. */ - void slotSelectionChanged(); + /** Updates the state of the 'Additional Information' actions. */ + void slotAdditionalInfoChanged(KFileItemDelegate::AdditionalInformation info); /** - * Updates the state of the 'Back' and 'Forward' menu - * actions corresponding the the current history. + * Updates the state of the 'Edit' menu actions and emits + * the signal selectionChanged(). */ - void slotHistoryChanged(); + void slotSelectionChanged(const QList& selection); + + /** Emits the signal requestItemInfo(). */ + void slotRequestItemInfo(const KFileItem&); /** - * Updates the caption of the main window and the state - * of all menu actions which depend from a changed Url. + * Updates the state of the 'Back' and 'Forward' menu + * actions corresponding the the current history. */ - void slotUrlChanged(const KUrl& url); + void slotHistoryChanged(); /** Updates the state of the 'Show filter bar' menu action. */ void updateFilterBarAction(bool show); @@ -349,12 +421,21 @@ private slots: /** Open a new main window. */ void openNewMainWindow(); + /** Toggles the active view if two views are shown within the main window. */ + void toggleActiveView(); + private: DolphinMainWindow(int id); void init(); - void loadSettings(); - void setupAccel(); + /** + * 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 setActiveViewContainer(DolphinViewContainer* view); + void setupActions(); void setupDockWidgets(); void updateHistory(); @@ -374,15 +455,22 @@ private: */ void connectViewSignals(int viewIndex); + /** + * Updates the text of the split action: + * If two views are shown, the text is set to "Split", + * otherwise the text is set to "Join". The icon + * is updated to match with the text and the currently active view. + */ + void updateSplitAction(); + private: /** - * DolphinMainWindowsupports only one or two views, which - * are handled internally as primary and secondary view. + * DolphinMainWindow supports up to two views beside each other. */ enum ViewIndex { - PrimaryIdx = 0, - SecondaryIdx = 1 + PrimaryView = 0, ///< View shown on the left side of the main window. + SecondaryView = 1 ///< View shown on the left side of the main window. }; /** @@ -403,14 +491,34 @@ private: KNewMenu* m_newMenu; QSplitter* m_splitter; - DolphinView* m_activeView; + DolphinViewContainer* m_activeViewContainer; int m_id; - DolphinView* m_view[SecondaryIdx + 1]; + DolphinViewContainer* m_viewContainer[SecondaryView + 1]; /// remember pending undo operations until they are finished - QList m_undoOperations; + QList m_undoCommandTypes; }; -#endif // _DOLPHIN_H_ +DolphinViewContainer* DolphinMainWindow::activeViewContainer() const +{ + return m_activeViewContainer; +} + +bool DolphinMainWindow::isSplit() const +{ + return m_viewContainer[SecondaryView] != 0; +} + +KNewMenu* DolphinMainWindow::newMenu() const +{ + return m_newMenu; +} + +int DolphinMainWindow::getId() const +{ + return m_id; +} + +#endif // DOLPHIN_MAINWINDOW_H