X-Git-Url: https://cloud.milkyroute.net/gitweb/dolphin.git/blobdiff_plain/f7bbe21b5b2d3bc85dcba1d03494879aac9e37c7..de3e2ae40f626c1368dfd40bace54ef3e7815833:/src/dolphinmainwindow.h diff --git a/src/dolphinmainwindow.h b/src/dolphinmainwindow.h index 9a57b5452..d5181711c 100644 --- a/src/dolphinmainwindow.h +++ b/src/dolphinmainwindow.h @@ -1,5 +1,5 @@ /*************************************************************************** - * Copyright (C) 2006 by Peter Penz * + * Copyright (C) 2006 by Peter Penz * * Copyright (C) 2006 by Stefan Monov * * Copyright (C) 2006 by Cvetoslav Ludmiloff * * * @@ -22,33 +22,36 @@ #ifndef DOLPHIN_MAINWINDOW_H #define DOLPHIN_MAINWINDOW_H -#include "panels/panel.h" +#include -#include - -#include +#include #include #include #include -#include - -#include "views/dolphinview.h" +#include +#include #include +#include typedef KIO::FileUndoManager::CommandType CommandType; -class KAction; class DolphinViewActionHandler; class DolphinApplication; class DolphinSettingsDialog; +class DolphinTabBar; class DolphinViewContainer; class DolphinRemoteEncoding; +class DolphinTabPage; +class KAction; +class KFileItem; +class KFileItemList; +class KJob; class KNewFileMenu; -class KTabBar; -class KUrl; class QSplitter; -class KJob; +class QToolButton; +class QVBoxLayout; +class QIcon; /** * @short Main window for Dolphin. @@ -63,6 +66,7 @@ class DolphinMainWindow: public KXmlGuiWindow friend class DolphinApplication; public: + DolphinMainWindow(); virtual ~DolphinMainWindow(); /** @@ -74,7 +78,7 @@ public: DolphinViewContainer* activeViewContainer() const; /** - * Opens each directory \p in a separate tab. If the "split view" + * Opens each directory in \p dirs in a separate tab. If the "split view" * option is enabled, 2 directories are collected within one tab. */ void openDirectories(const QList& dirs); @@ -86,42 +90,12 @@ public: */ void openFiles(const QList& files); - /** - * Returns true, if the main window contains two instances - * of a view container. The active view constainer can be - * accessed by DolphinMainWindow::activeViewContainer(). - */ - bool isSplit() const; - - /** - * 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 toggleViews(); - - /** Renames the item represented by \a oldUrl to \a newUrl. */ - void rename(const KUrl& oldUrl, const KUrl& newUrl); - - /** - * Refreshes 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). */ KNewFileMenu* newFileMenu() const; - /** - * Returns the 'Show Menubar' action which can be shared with - * other menus (e. g. a context menu). - */ - KAction* showMenuBarAction() const; - public slots: /** * Pastes the clipboard data into the currently selected folder @@ -142,6 +116,13 @@ public slots: */ void changeUrl(const KUrl& url); + /** + * The current directory of the Terminal Panel has changed, probably because + * the user entered a 'cd' command. This slot calls changeUrl(url) and makes + * sure that the panel keeps the keyboard focus. + */ + void slotTerminalDirectoryChanged(const KUrl& url); + /** Stores all settings and quits Dolphin. */ void quit(); @@ -164,6 +145,16 @@ signals: */ void requestItemInfo(const KFileItem& item); + /** + * Is emitted if the settings have been changed. + */ + void settingsChanged(); + + /** + * Is emitted when a tab has been closed. + */ + void rememberClosedTab(const KUrl& primaryUrl, const KUrl& secondaryUrl); + protected: /** @see QWidget::showEvent() */ virtual void showEvent(QShowEvent* event); @@ -178,6 +169,12 @@ protected: virtual void readProperties(const KConfigGroup& group); private slots: + /** + * Refreshes the views of the main window by recreating them according to + * the given Dolphin settings. + */ + void refreshViews(); + void clearStatusBar(); /** Updates the 'Create New...' sub menu. */ @@ -190,13 +187,10 @@ private slots: /** * Updates the state of the 'Undo' menu action dependent - * from the parameter \a available. + * on the parameter \a available. */ void slotUndoAvailable(bool available); - /** Invoked when an action in the recent tabs menu is clicked. */ - void restoreClosedTab(QAction* action); - /** Sets the text of the 'Undo' menu action to \a text. */ void slotUndoTextChanged(const QString& text); @@ -219,7 +213,7 @@ private slots: void find(); /** - * Updates the text of the paste action dependent from + * Updates the text of the paste action dependent on * the number of items which are in the clipboard. */ void updatePasteAction(); @@ -237,14 +231,14 @@ private slots: /** * Switches between one and two views: * If one view is visible, it will get split into two views. - * If already two views are visible, the nonactivated view gets closed. + * If already two views are visible, the active view gets closed. */ void toggleSplitView(); - /** Reloads the current active view. */ + /** Reloads the currently active view. */ void reloadView(); - /** Stops the loading process for the current active view. */ + /** Stops the loading process for the currently active view. */ void stopLoading(); void enableStopAction(); @@ -264,7 +258,19 @@ private slots: */ void replaceLocation(); - /** Goes back on step of the URL history. */ + /** + * Toggles the state of the panels between a locked and unlocked layout. + */ + void togglePanelLockState(); + + /** + * Is invoked if the Places panel got visible/invisible and takes care + * that the places-selector of all views is only shown if the Places panel + * is invisible. + */ + void slotPlacesPanelVisibilityChanged(bool visible); + + /** Goes back one step of the URL history. */ void goBack(); /** Goes forward one step of the URL history. */ @@ -273,6 +279,9 @@ private slots: /** Goes up one hierarchy of the current URL. */ void goUp(); + /** Changes the location to the home URL. */ + void goHome(); + /** * Open the previous URL in the URL history in a new tab * if the middle mouse button is clicked. @@ -291,8 +300,10 @@ private slots: */ void goUp(Qt::MouseButtons buttons); - /** Goes to the home URL. */ - void goHome(); + /** + * Open the home URL in a new tab + */ + void goHome(Qt::MouseButtons buttons); /** Opens Kompare for 2 selected files. */ void compareFiles(); @@ -337,9 +348,22 @@ private slots: void openNewTab(); /** - * Opens a new tab showing the URL \a url. + * Opens a new tab in the background showing the URL \a primaryUrl and the + * optional URL \a secondaryUrl. + */ + void openNewTab(const KUrl& primaryUrl, const KUrl& secondaryUrl = KUrl()); + + /** + * Opens a new tab showing the URL \a primaryUrl and the optional URL + * \a secondaryUrl and activates the tab. */ - void openNewTab(const KUrl& url); + void openNewActivatedTab(const KUrl& primaryUrl, const KUrl& secondaryUrl = KUrl()); + + /** + * Opens a new tab showing the url from tab at the given \a index and + * activates the tab. + */ + void openNewActivatedTab(int index); void activateNextTab(); @@ -355,9 +379,6 @@ private slots: */ void openInNewWindow(); - /** Toggles the active view if two views are shown within the main window. */ - void toggleActiveView(); - /** * Indicates in the statusbar that the execution of the command \a command * has been finished. @@ -374,15 +395,15 @@ private slots: void closeTab(); /** - * Closes the tab with the index \index and activates the tab with index - 1. + * Closes the tab with the index \a index and activates the tab with index - 1. */ void closeTab(int index); /** - * Opens a context menu for the tab with the index \a index - * on the position \a pos. + * Opens the tab with the index \a index in a new Dolphin instance and closes + * this tab. */ - void openTabContextMenu(int index, const QPoint& pos); + void detachTab(int index); /** * Is connected to the QTabBar signal tabMoved(int from, int to). @@ -392,20 +413,7 @@ private slots: void slotTabMoved(int from, int to); /** - * Handles a click on a places item: if the middle mouse button is - * clicked, a new tab is opened for \a url, otherwise the current - * view is replaced by \a url. - */ - void handlePlacesClick(const KUrl& url, Qt::MouseButtons buttons); - - /** - * Is connected to the KTabBar signal testCanDecode() and adjusts - * the output parameter \a accept. - */ - void slotTestCanDecode(const QDragMoveEvent* event, bool& accept); - - /** - * If the URL can be listed open it in the current view, otherwise + * If the URL can be listed, open it in the current view, otherwise * run it through KRun. */ void handleUrl(const KUrl& url); @@ -428,24 +436,42 @@ private slots: */ void slotWriteStateChanged(bool isFolderWritable); - void slotSearchModeChanged(bool enabled); - /** * Opens the context menu on the current mouse position. + * @pos Position in screen coordinates. * @item File item context. If item is null, the context menu * should be applied to \a url. * @url URL which contains \a item. * @customActions Actions that should be added to the context menu, * if the file item is null. */ - void openContextMenu(const KFileItem& item, + void openContextMenu(const QPoint& pos, + const KFileItem& item, const KUrl& url, const QList& customActions); -private: - DolphinMainWindow(int id); - void init(); + void updateControlMenu(); + void updateToolBar(); + void slotControlButtonDeleted(); + + /** + * Is called if a panel emits an error-message and shows + * the error-message in the active view-container. + */ + void slotPanelErrorMessage(const QString& error); + + /** + * Is called if the user clicked an item in the Places Panel. + * Reloads the view if \a url is the current URL already, and changes the + * current URL otherwise. + */ + void slotPlaceActivated(const KUrl& url); + + void activeViewChanged(); + void closedTabsCountChanged(unsigned int count); + +private: /** * Activates the given view, which means that * all menu actions are applied to this view. When @@ -460,10 +486,15 @@ private: void updateViewActions(); void updateGoActions(); + void createControlButton(); + void deleteControlButton(); + /** - * Adds the tab[\a index] to the closed tab menu's list of actions. + * Adds the action \p action to the menu \p menu in + * case if it has not added already to the toolbar. + * @return True if the action has been added to the menu. */ - void rememberClosedTab(int index); + bool addActionToMenu(QAction* action, KMenu* menu); /** * Connects the signals from the created DolphinView with @@ -484,16 +515,8 @@ private: /** Returns the name of the tab for the URL \a url. */ QString tabName(const KUrl& url) const; - bool isKompareInstalled() const; - - void createSecondaryView(int tabIndex); - /** - * Helper method for saveProperties() and readProperties(): Returns - * the property string for a tab with the index \a tabIndex and - * the property \a property. - */ - QString tabProperty(const QString& property, int tabIndex) const; + bool isKompareInstalled() const; /** * Sets the window caption to url.fileName() if this is non-empty, @@ -504,13 +527,15 @@ private: QString squeezedText(const QString& text) const; /** - * Adds a clone of the action \a action to the action-collection with - * the name \a actionName, so that the action \a action also can be - * added to the toolbar by the user. This is useful if the creation of - * \a action is e.g. done in Qt and hence cannot be added directly - * to the action-collection. + * Creates an action for showing/hiding a panel, that is accessible + * in "Configure toolbars..." and "Configure shortcuts...". This is necessary + * as the action for toggling the dock visibility is done by Qt which + * is no KAction instance. */ - void addActionCloneToCollection(QAction* action, const QString& actionName); + void createPanelAction(const QIcon &icon, + const QKeySequence& shortcut, + QAction* dockAction, + const QString& actionName); private: /** @@ -527,36 +552,23 @@ private: }; KNewFileMenu* m_newFileMenu; - KActionMenu* m_recentTabsMenu; - KAction* m_showMenuBar; - KTabBar* m_tabBar; + DolphinTabBar* m_tabBar; DolphinViewContainer* m_activeViewContainer; QVBoxLayout* m_centralWidgetLayout; int m_id; - struct ViewTab - { - ViewTab() : isPrimaryViewActive(true), primaryView(0), secondaryView(0), splitter(0) {} - bool isPrimaryViewActive; - DolphinViewContainer* primaryView; - DolphinViewContainer* secondaryView; - QSplitter* splitter; - }; - int m_tabIndex; - QList m_viewTab; + QList m_viewTab; DolphinViewActionHandler* m_actionHandler; DolphinRemoteEncoding* m_remoteEncoding; - QPointer m_settingsDialog; + QWeakPointer m_settingsDialog; - KJob* m_lastHandleUrlStatJob; + // Members for the toolbar menu that is shown when the menubar is hidden: + QToolButton* m_controlButton; + QTimer* m_updateToolBarTimer; - /** - * Set to true, if the filter dock visibility is only temporary set - * to true by enabling the search mode. - */ - bool m_filterDockIsTemporaryVisible; + KIO::Job* m_lastHandleUrlStatJob; }; inline DolphinViewContainer* DolphinMainWindow::activeViewContainer() const @@ -564,21 +576,11 @@ inline DolphinViewContainer* DolphinMainWindow::activeViewContainer() const return m_activeViewContainer; } -inline bool DolphinMainWindow::isSplit() const -{ - return m_viewTab[m_tabIndex].secondaryView != 0; -} - inline KNewFileMenu* DolphinMainWindow::newFileMenu() const { return m_newFileMenu; } -inline KAction* DolphinMainWindow::showMenuBarAction() const -{ - return m_showMenuBar; -} - inline int DolphinMainWindow::getId() const { return m_id;