X-Git-Url: https://cloud.milkyroute.net/gitweb/dolphin.git/blobdiff_plain/275d7b537de4bf6db971c9cb1d591ffe512272f9..a1c5c5cf81b5d1f6b7a0aa10b8a981cb70c5b26c:/src/dolphinviewcontainer.h diff --git a/src/dolphinviewcontainer.h b/src/dolphinviewcontainer.h index 52e63cbe0..f9c62296e 100644 --- a/src/dolphinviewcontainer.h +++ b/src/dolphinviewcontainer.h @@ -1,29 +1,17 @@ -/*************************************************************************** - * 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 * - * the Free Software Foundation; either version 2 of the License, or * - * (at your option) any later version. * - * * - * This program is distributed in the hope that it will be useful, * - * but WITHOUT ANY WARRANTY; without even the implied warranty of * - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * - * GNU General Public License for more details. * - * * - * You should have received a copy of the GNU General Public License * - * along with this program; if not, write to the * - * Free Software Foundation, Inc., * - * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA * - ***************************************************************************/ +/* + * SPDX-FileCopyrightText: 2007 Peter Penz + * + * SPDX-License-Identifier: GPL-2.0-or-later + */ #ifndef DOLPHINVIEWCONTAINER_H #define DOLPHINVIEWCONTAINER_H -#include "config-kactivities.h" +#include "config-dolphin.h" +#include "dolphinurlnavigator.h" +#include "selectionmode/bottombar.h" #include "views/dolphinview.h" -#include #include #include #include @@ -32,18 +20,24 @@ #include #include -#ifdef HAVE_KACTIVITIES -namespace KActivities { - class ResourceInstance; +#if HAVE_KACTIVITIES +namespace KActivities +{ +class ResourceInstance; } #endif class FilterBar; class KMessageWidget; +class QAction; +class QGridLayout; class QUrl; -class KUrlNavigator; class DolphinSearchBox; class DolphinStatusBar; +namespace SelectionMode +{ +class TopBar; +} /** * @short Represents a view for the directory content @@ -62,14 +56,9 @@ class DolphinViewContainer : public QWidget Q_OBJECT public: - enum MessageType - { - Information, - Warning, - Error - }; - - DolphinViewContainer(const QUrl& url, QWidget* parent); + enum MessageType { Information, Warning, Error }; + + DolphinViewContainer(const QUrl &url, QWidget *parent); ~DolphinViewContainer() override; /** @@ -77,6 +66,7 @@ public: * The URL navigator is synchronized with this URL. */ QUrl url() const; + KFileItem rootItem() const; /** * If \a active is true, the view container will marked as active. The active @@ -95,20 +85,79 @@ public: QString currentSearchText() const; - const DolphinStatusBar* statusBar() const; - DolphinStatusBar* statusBar(); + const DolphinStatusBar *statusBar() const; + DolphinStatusBar *statusBar(); + + /** + * @return An UrlNavigator that is controlling this view + * or nullptr if there is none. + * @see connectUrlNavigator() + * @see disconnectUrlNavigator() + * + * Use urlNavigatorInternalWithHistory() if you want to access the history. + * @see urlNavigatorInternalWithHistory() + */ + const DolphinUrlNavigator *urlNavigator() const; + /** + * @return An UrlNavigator that is controlling this view + * or nullptr if there is none. + * @see connectUrlNavigator() + * @see disconnectUrlNavigator() + * + * Use urlNavigatorInternalWithHistory() if you want to access the history. + * @see urlNavigatorInternalWithHistory() + */ + DolphinUrlNavigator *urlNavigator(); + + /** + * @return An UrlNavigator that contains this view's history. + * Use urlNavigator() instead when not accessing the history. + */ + const DolphinUrlNavigator *urlNavigatorInternalWithHistory() const; + /** + * @return An UrlNavigator that contains this view's history. + * Use urlNavigator() instead when not accessing the history. + */ + DolphinUrlNavigator *urlNavigatorInternalWithHistory(); + + const DolphinView *view() const; + DolphinView *view(); + + /** + * @param urlNavigator The UrlNavigator that is supposed to control + * this view. + */ + void connectUrlNavigator(DolphinUrlNavigator *urlNavigator); - const KUrlNavigator* urlNavigator() const; - KUrlNavigator* urlNavigator(); + /** + * Disconnects the navigator that is currently controlling the view. + * This method completely reverses connectUrlNavigator(). + */ + void disconnectUrlNavigator(); - const DolphinView* view() const; - DolphinView* view(); + /** + * Sets a selection mode that is useful for quick and easy selecting or deselecting of files. + * This method is the central authority about enabling or disabling selection mode: + * All other classes that want to enable or disable selection mode should trigger a call of this method. + * + * This method sets the selection mode for the view of this viewContainer and sets the visibility of the + * selection mode top and bottom bar which also belong to this viewContainer. + * + * @param enabled Whether to enable or disable selection mode. + * @param actionCollection The collection of actions from which the actions on the bottom bar are retrieved. + * @param bottomBarContents The contents the bar is supposed to show after this call. + */ + void setSelectionModeEnabled(bool enabled, + KActionCollection *actionCollection = nullptr, + SelectionMode::BottomBar::Contents bottomBarContents = SelectionMode::BottomBar::Contents::GeneralContents); + /** @see setSelectionModeEnabled() */ + bool isSelectionModeEnabled() const; /** * Shows the message \msg with the given type non-modal above * the view-content. */ - void showMessage(const QString& msg, MessageType type); + void showMessage(const QString &msg, MessageType type); /** * Refreshes the view container to get synchronized with the (updated) Dolphin settings. @@ -118,7 +167,6 @@ public: /** Returns true, if the filter bar is visible. */ bool isFilterBarVisible() const; - /** Returns true if the search mode is enabled. */ bool isSearchModeEnabled() const; @@ -147,7 +195,17 @@ public: */ QString caption() const; -public slots: + /** + * Disable/enable the behavior of "select child when moving to parent folder" + * offered by KUrlNavigator. + * + * See KUrlNavigator::urlSelectionRequested + */ + void disableUrlNavigatorSelectionRequests(); + void enableUrlNavigatorSelectionRequests(); + void clearFilterBar(); + +public Q_SLOTS: /** * Sets the current active URL, where all actions are applied. The * URL navigator is synchronized with this URL. The signals @@ -155,7 +213,7 @@ public slots: * are emitted. * @see DolphinViewContainer::urlNavigator() */ - void setUrl(const QUrl& url); + void setUrl(const QUrl &url); /** * Popups the filter bar above the status bar if \a visible is true. @@ -170,7 +228,10 @@ public slots: */ void setSearchModeEnabled(bool enabled); -signals: + /** Used to notify the m_selectionModeBottomBar that there is no other ViewContainer in the tab. */ + void slotSplitTabDisabled(); + +Q_SIGNALS: /** * Is emitted whenever the filter bar has changed its visibility state. */ @@ -180,6 +241,8 @@ signals: */ void searchModeEnabledChanged(bool enabled); + void selectionModeChanged(bool enabled); + /** * Is emitted when the write state of the folder has been changed. The application * should disable all actions like "Create New..." that depend on the write @@ -187,7 +250,23 @@ signals: */ void writeStateChanged(bool isFolderWritable); -private slots: + /** + * Is emitted when the Caption has been changed. + * @see DolphinViewContainer::caption() + */ + void captionChanged(); + + /** + * Is emitted if a new tab should be opened in the background for the URL \a url. + */ + void tabRequested(const QUrl &url); + + /** + * Is emitted if a new tab should be opened for the URL \a url and set as active. + */ + void activeTabRequested(const QUrl &url); + +private Q_SLOTS: /** * Updates the number of items (= number of files + number of * directories) in the statusbar. If files are selected, the number @@ -232,26 +311,26 @@ private slots: * 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 QUrl& url); + void slotUrlIsFileError(const QUrl &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 slotItemActivated(const KFileItem& item); + void slotItemActivated(const KFileItem &item); /** * Handles activation of multiple files. The files get started by * the corresponding applications. */ - void slotItemsActivated(const KFileItemList& items); + void slotItemsActivated(const KFileItemList &items); /** * Shows the information for the item \a item inside the statusbar. If the * item is null, the default statusbar information is shown. */ - void showItemInfo(const KFileItem& item); + void showItemInfo(const KFileItem &item); void closeFilterBar(); @@ -259,7 +338,7 @@ private slots: * Filters the currently shown items by \a nameFilter. All items * which contain the given filter string will be shown. */ - void setNameFilter(const QString& nameFilter); + void setNameFilter(const QString &nameFilter); /** * Marks the view container as active @@ -271,37 +350,29 @@ private slots: * Is invoked if the signal urlAboutToBeChanged() from the URL navigator * is emitted. Tries to save the view-state. */ - void slotUrlNavigatorLocationAboutToBeChanged(const QUrl& url); + void slotUrlNavigatorLocationAboutToBeChanged(const QUrl &url); /** * Restores the current view to show \a url and assures * that the root URL of the view is respected. */ - void slotUrlNavigatorLocationChanged(const QUrl& url); + void slotUrlNavigatorLocationChanged(const QUrl &url); /** * @see KUrlNavigator::urlSelectionRequested */ - void slotUrlSelectionRequested(const QUrl& url); + void slotUrlSelectionRequested(const QUrl &url); /** * Is invoked when a redirection is done and changes the * URL of the URL navigator to \a newUrl without triggering * a reloading of the directory. */ - void redirect(const QUrl& oldUrl, const QUrl& newUrl); + void redirect(const QUrl &oldUrl, const QUrl &newUrl); /** Requests the focus for the view \a m_view. */ void requestFocus(); - /** - * Saves the currently used URL completion mode of - * the URL navigator. - */ - void saveUrlCompletionMode(KCompletion::CompletionMode completion); - - void slotReturnPressed(); - /** * Gets the search URL from the searchbox and starts searching. */ @@ -319,13 +390,25 @@ private slots: /** * Slot that calls showMessage(msg, Error). */ - void showErrorMessage(const QString& msg); + void showErrorMessage(const QString &msg); + + /** + * Is invoked when a KFilePlacesModel has been changed + * @see DolphinPlacesModelSingleton::instance().placesModel() + */ + void slotPlacesModelChanged(); + + void slotHiddenFilesShownChanged(bool showHiddenFiles); + void slotSortHiddenLastChanged(bool hiddenLast); + void slotCurrentDirectoryRemoved(); + + void slotOpenUrlFinished(KJob *job); private: /** * @return True if the URL protocol is a search URL (e. g. baloosearch:// or filenamesearch://). */ - bool isSearchUrl(const QUrl& url) const; + bool isSearchUrl(const QUrl &url) const; /** * Saves the state of the current view: contents position, @@ -339,27 +422,56 @@ private: */ void tryRestoreViewState(); + /** + * @return Path of nearest existing ancestor directory. + */ + QString getNearestExistingAncestorOfPath(const QString &path) const; + private: - QVBoxLayout* m_topLayout; - QWidget* m_navigatorWidget; - KUrlNavigator* m_urlNavigator; - QPushButton* m_emptyTrashButton; - DolphinSearchBox* m_searchBox; + QGridLayout *m_topLayout; + + /** + * The internal UrlNavigator which is never visible to the user. + * m_urlNavigator is used even when another UrlNavigator is controlling + * the view to keep track of this object's history. + */ + std::unique_ptr m_urlNavigator; + + /** + * The UrlNavigator that is currently connected to the view. + * This is a nullptr if no UrlNavigator is connected. + * Otherwise it's one of the UrlNavigators visible in the toolbar. + */ + QPointer m_urlNavigatorConnected; + + DolphinSearchBox *m_searchBox; bool m_searchModeEnabled; - KMessageWidget* m_messageWidget; - DolphinView* m_view; + KMessageWidget *m_messageWidget; + + /// A bar shown at the top of the view to signify that selection mode is currently active. + SelectionMode::TopBar *m_selectionModeTopBar; + + DolphinView *m_view; - FilterBar* m_filterBar; + FilterBar *m_filterBar; - DolphinStatusBar* m_statusBar; - QTimer* m_statusBarTimer; // Triggers a delayed update - QElapsedTimer m_statusBarTimestamp; // Time in ms since last update + /// A bar shown at the bottom of the view whose contents depend on what the user is currently doing. + SelectionMode::BottomBar *m_selectionModeBottomBar; + + DolphinStatusBar *m_statusBar; + QTimer *m_statusBarTimer; // Triggers a delayed update + QElapsedTimer m_statusBarTimestamp; // Time in ms since last update bool m_autoGrabFocus; + /** + * The visual state to be applied to the next UrlNavigator that gets + * connected to this ViewContainer. + */ + std::unique_ptr m_urlNavigatorVisualState; -#ifdef HAVE_KACTIVITIES +#if HAVE_KACTIVITIES private: - KActivities::ResourceInstance * m_activityResourceInstance; + KActivities::ResourceInstance *m_activityResourceInstance; #endif };