X-Git-Url: https://cloud.milkyroute.net/gitweb/dolphin.git/blobdiff_plain/8eb9b508ca87fb1d634d8b8ba62c054ed04466d2..a46121dc510f987f2d164b43eaf5f84ea8c83cb8:/src/dolphinviewcontainer.h diff --git a/src/dolphinviewcontainer.h b/src/dolphinviewcontainer.h index 5f9102c83..a7a9969c3 100644 --- a/src/dolphinviewcontainer.h +++ b/src/dolphinviewcontainer.h @@ -1,5 +1,5 @@ /*************************************************************************** - * Copyright (C) 2007 by Peter Penz * + * Copyright (C) 2007 by Peter Penz * * * * This program is free software; you can redistribute it and/or modify * * it under the terms of the GNU General Public License as published by * @@ -22,7 +22,7 @@ #include #include -#include +#include #include #include @@ -31,8 +31,16 @@ #include #include +#include + +#ifdef KActivities_FOUND +namespace KActivities { + class ResourceInstance; +} +#endif class FilterBar; +class KMessageWidget; class KUrl; class KUrlNavigator; class DolphinSearchBox; @@ -42,7 +50,7 @@ class DolphinStatusBar; * @short Represents a view for the directory content * including the navigation bar, filter bar and status bar. * - * View modes for icons, details and columns are supported. Currently + * View modes for icons, compact and details are supported. Currently * Dolphin allows to have up to two views inside the main window. * * @see DolphinView @@ -55,6 +63,13 @@ class DolphinViewContainer : public QWidget Q_OBJECT public: + enum MessageType + { + Information, + Warning, + Error + }; + DolphinViewContainer(const KUrl& url, QWidget* parent); virtual ~DolphinViewContainer(); @@ -71,6 +86,14 @@ public: void setActive(bool active); bool isActive() const; + /** + * If \a grab is set to true, the container automatically grabs the focus + * as soon as the URL has been changed. Per default the grabbing + * of the focus is enabled. + */ + void setAutoGrabFocus(bool grab); + bool autoGrabFocus() const; + const DolphinStatusBar* statusBar() const; DolphinStatusBar* statusBar(); @@ -80,10 +103,16 @@ public: const DolphinView* view() const; DolphinView* view(); + /** + * Shows the message \msg with the given type non-modal above + * the view-content. + */ + void showMessage(const QString& msg, MessageType type); + /** * Refreshes the view container to get synchronized with the (updated) Dolphin settings. */ - void refresh(); + void readSettings(); /** Returns true, if the filter bar is visible. */ bool isFilterBarVisible() const; @@ -95,6 +124,12 @@ public: void setSearchModeEnabled(bool enabled); bool isSearchModeEnabled() const; + /** + * @return Text that should be used for the current URL when creating + * a new place. + */ + QString placesText() const; + public slots: /** * Sets the current active URL, where all actions are applied. The @@ -125,13 +160,6 @@ signals: */ void writeStateChanged(bool isFolderWritable); - /** - * Is emitted if the search mode has been enabled or disabled. - * (see DolphinViewContainer::setSearchModeEnabled() and - * DolphinViewContainer::isSearchModeEnabled()) - */ - void searchModeChanged(bool enabled); - private slots: /** * Updates the number of items (= number of files + number of @@ -139,6 +167,9 @@ private slots: * of selected files and the sum of the filesize is shown. The update * is done asynchronously, as getting the sum of the * filesizes can be an expensive operation. + * Unless a previous OperationCompletedMessage was set very shortly before + * calling this method, it will be overwritten (see DolphinStatusBar::setMessage). + * Previous ErrorMessages however are always preserved. */ void delayedStatusBarUpdate(); @@ -148,33 +179,46 @@ private slots: */ void updateStatusBar(); - void updateProgress(int percent); + void updateDirectoryLoadingProgress(int percent); + + void updateDirectorySortingProgress(int percent); /** * Updates the statusbar to show an undetermined progress with the correct * context information whether a searching or a directory loading is done. */ - void slotStartedPathLoading(); + void slotDirectoryLoadingStarted(); /** * Assures that the viewport position is restored and updates the * statusbar to reflect the current content. */ - void slotFinishedPathLoading(); + void slotDirectoryLoadingCompleted(); + + /** + * Updates the statusbar to show, that the directory loading has + * been canceled. + */ + void slotDirectoryLoadingCanceled(); + + /** + * Is called if the URL set by DolphinView::setUrl() represents + * a file and not a directory. Takes care to activate the file. + */ + void slotUrlIsFileError(const KUrl& url); /** * Handles clicking on an item. If the item is a directory, the * directory is opened in the view. If the item is a file, the file * gets started by the corresponding application. */ - void slotItemTriggered(const KFileItem& item); + void slotItemActivated(const KFileItem& item); /** - * Opens a the file \a url by opening the corresponding application. - * Is connected with the signal urlIsFile() from DolphinDirLister and will - * get invoked if the user manually has entered a file into the URL navigator. + * Handles activation of multiple files. The files get started by + * the corresponding applications. */ - void openFile(const KUrl& url); + void slotItemsActivated(const KFileItemList& items); /** * Shows the information for the item \a item inside the statusbar. If the @@ -182,15 +226,6 @@ private slots: */ void showItemInfo(const KFileItem& item); - /** Shows the information \a msg inside the statusbar. */ - void showInfoMessage(const QString& msg); - - /** Shows the error message \a msg inside the statusbar. */ - void showErrorMessage(const QString& msg); - - /** Shows the "operation completed" message \a msg inside the statusbar. */ - void showOperationCompletedMessage(const QString& msg); - void closeFilterBar(); /** @@ -206,10 +241,16 @@ private slots: void activate(); /** - * Saves the state of the current view: contents position, - * root URL, ... + * Is invoked if the signal urlAboutToBeChanged() from the DolphinView + * is emitted. Tries to save the view-state. */ - void saveViewState(); + void slotViewUrlAboutToBeChanged(const KUrl& url); + + /** + * Is invoked if the signal urlAboutToBeChanged() from the URL navigator + * is emitted. Tries to save the view-state. + */ + void slotUrlNavigatorLocationAboutToBeChanged(const KUrl& url); /** * Restores the current view to show \a url and assures @@ -220,9 +261,21 @@ private slots: /** * Is connected with the URL navigator and drops the URLs * above the destination \a destination. + * + * Creates a copy of \a event and invokes \a dropUrlsDelayed with a + * queued connection. */ void dropUrls(const KUrl& destination, QDropEvent* event); + /** + * Is invoked with a queued connection by \a dropUrls to prevent that the + * drop actions are executed in the URL navigator menu's nested event loop, + * which might cause a crash. Simply using a queued connection from the URL + * navigator to \a dropUrls would not work because the \a event pointer + * would be dangling then. + */ + void dropUrlsDelayed(); + /** * Is invoked when a redirection is done and changes the * URL of the URL navigator to \a newUrl without triggering @@ -237,33 +290,48 @@ private slots: * Saves the currently used URL completion mode of * the URL navigator. */ - void saveUrlCompletionMode(KGlobalSettings::Completion completion); + void saveUrlCompletionMode(KCompletion::CompletionMode completion); void slotHistoryChanged(); + void slotReturnPressed(); + /** * Gets the search URL from the searchbox and starts searching. - * @param text Text the user has entered into the searchbox. */ - void startSearching(const QString& text); + void startSearching(); void closeSearchBox(); /** * Stops the loading of a directory. Is connected with the "stopPressed" signal * from the statusbar. */ - void stopLoading(); + void stopDirectoryLoading(); + + void slotStatusBarZoomLevelChanged(int zoomLevel); + + /** + * Slot that calls showMessage(msg, Error). + */ + void showErrorMessage(const QString& msg); private: /** - * @return True if the URL protocol is a search URL (e. g. nepomuksearch:// or filenamesearch://). + * @return True if the URL protocol is a search URL (e. g. baloosearch:// or filenamesearch://). */ bool isSearchUrl(const KUrl& url) const; + /** + * Saves the state of the current view: contents position, + * root URL, ... + */ + void saveViewState(); + private: QVBoxLayout* m_topLayout; KUrlNavigator* m_urlNavigator; DolphinSearchBox* m_searchBox; + KMessageWidget* m_messageWidget; DolphinView* m_view; @@ -272,36 +340,15 @@ private: DolphinStatusBar* m_statusBar; QTimer* m_statusBarTimer; // Triggers a delayed update QElapsedTimer m_statusBarTimestamp; // Time in ms since last update -}; + bool m_autoGrabFocus; -inline const DolphinStatusBar* DolphinViewContainer::statusBar() const -{ - return m_statusBar; -} + KUrl m_dropDestination; + QScopedPointer m_dropEvent; -inline DolphinStatusBar* DolphinViewContainer::statusBar() -{ - return m_statusBar; -} - -inline const KUrlNavigator* DolphinViewContainer::urlNavigator() const -{ - return m_urlNavigator; -} - -inline KUrlNavigator* DolphinViewContainer::urlNavigator() -{ - return m_urlNavigator; -} - -inline const DolphinView* DolphinViewContainer::view() const -{ - return m_view; -} - -inline DolphinView* DolphinViewContainer::view() -{ - return m_view; -} +#ifdef KActivities_FOUND +private: + KActivities::ResourceInstance * m_activityResourceInstance; +#endif +}; #endif // DOLPHINVIEWCONTAINER_H