X-Git-Url: https://cloud.milkyroute.net/gitweb/dolphin.git/blobdiff_plain/a418d6229e31dac254660da2a417b4306f066ae3..c9b7c5b77ec092f8354c5fd9701384aa14de76f4:/src/dolphintabpage.h diff --git a/src/dolphintabpage.h b/src/dolphintabpage.h index 650594214..1e79fb5db 100644 --- a/src/dolphintabpage.h +++ b/src/dolphintabpage.h @@ -1,5 +1,6 @@ /* * SPDX-FileCopyrightText: 2014 Emmanuel Pescosta + * SPDX-FileCopyrightText: 2020 Felix Ernst * * SPDX-License-Identifier: GPL-2.0-or-later */ @@ -7,21 +8,25 @@ #ifndef DOLPHIN_TAB_PAGE_H #define DOLPHIN_TAB_PAGE_H +#include "global.h" + #include +#include #include #include class DolphinNavigatorsWidgetAction; class DolphinViewContainer; -class QSplitter; +class QVariantAnimation; class KFileItemList; +class DolphinTabPageSplitter; class DolphinTabPage : public QWidget { Q_OBJECT public: - explicit DolphinTabPage(const QUrl& primaryUrl, const QUrl& secondaryUrl = QUrl(), QWidget* parent = nullptr); + explicit DolphinTabPage(const QUrl &primaryUrl, const QUrl &secondaryUrl = QUrl(), QWidget *parent = nullptr); /** * @return True if primary view is the active view in this tab. @@ -36,24 +41,36 @@ public: /** * Enables or disables the split view mode. * - * If \a enabled is true, it creates a secondary view with the url of the primary view. + * @param enabled If true, creates a secondary viewContainer in this tab. + * Otherwise deletes it. + * @param animated Decides whether the effects of this method call should + * happen instantly or be transitioned to smoothly. + * @param secondaryUrl If \p enabled is true, the new viewContainer will be opened at this + * parameter. The default value will set the Url of the new viewContainer + * to be the same as the existing one. */ - void setSplitViewEnabled(bool enabled, const QUrl &secondaryUrl = QUrl()); + void setSplitViewEnabled(bool enabled, Animated animated, const QUrl &secondaryUrl = QUrl()); /** * @return The primary view container. */ - DolphinViewContainer* primaryViewContainer() const; + DolphinViewContainer *primaryViewContainer() const; /** * @return The secondary view container, can be 0 if split view is disabled. */ - DolphinViewContainer* secondaryViewContainer() const; + DolphinViewContainer *secondaryViewContainer() const; /** * @return DolphinViewContainer of the active view */ - DolphinViewContainer* activeViewContainer() const; + DolphinViewContainer *activeViewContainer() const; + + /** + * @return DolphinViewContainer of the inactive view + * if split view is enabled, or nullptr otherwise. + */ + DolphinViewContainer *inactiveViewContainer() const; /** * Returns the selected items. The list is empty if no item has been @@ -80,16 +97,7 @@ public: */ void disconnectNavigators(); - /** - * Calls resizeNavigators() when a watched object is resized. - */ - bool eventFilter(QObject */* watched */, QEvent *event) override; - - /** - * Notify the connected DolphinNavigatorsWidgetAction of geometry changes which it - * needs for visual alignment. - */ - void resizeNavigators() const; + void insertNavigatorsWidget(DolphinNavigatorsWidgetAction *navigatorsWidget); /** * Marks the items indicated by \p urls to get selected after the @@ -103,7 +111,7 @@ public: * Marks the item indicated by \p url to be scrolled to and as the * current item after directory DolphinView::url() has been loaded. */ - void markUrlAsCurrent(const QUrl& url); + void markUrlAsCurrent(const QUrl &url); /** * Refreshes the views of the main window by recreating them according to @@ -122,29 +130,45 @@ public: * Restores all tab related properties (urls, splitter layout, ...) from * the given \a state. */ - void restoreState(const QByteArray& state); + void restoreState(const QByteArray &state); /** - * Restores all tab related properties (urls, splitter layout, ...) from - * the given \a state. + * Set whether the tab page is active * - * @deprecated The first tab state version has no version number, we keep - * this method to restore old states (<= Dolphin 4.14.x). */ - Q_DECL_DEPRECATED void restoreStateV1(const QByteArray& state); + void setActive(bool active); + + void switchActiveView(); + + /** + * Overwrites the automatically generated label of this tab with @p label. + * This @p label will be kept until it is overwritten by calling this method again. + * Calling this with an empty string will restore the automatic labelling. + */ + void setCustomLabel(const QString &label); /** - * Set whether the tab page is active - * + * @see setCustomLabel. */ - void setActive(bool active); + QString customLabel() const; -signals: - void activeViewChanged(DolphinViewContainer* viewContainer); - void activeViewUrlChanged(const QUrl& url); +Q_SIGNALS: + void activeViewChanged(DolphinViewContainer *viewContainer); + void activeViewUrlChanged(const QUrl &url); void splitterMoved(int pos, int index); -private slots: +private Q_SLOTS: + /** + * Deletes all zombie viewContainers that were used for the animation + * and resets the minimum size of the others to a sane value. + */ + void slotAnimationFinished(); + + /** + * This method is called for every frame of the m_expandViewAnimation. + */ + void slotAnimationValueChanged(const QVariant &value); + /** * Handles the view activated event. * @@ -158,26 +182,69 @@ private slots: * * It emits the activeViewUrlChanged signal with the url \a newUrl. */ - void slotViewUrlRedirection(const QUrl& oldUrl, const QUrl& newUrl); - - void switchActiveView(); + void slotViewUrlRedirection(const QUrl &oldUrl, const QUrl &newUrl); private: /** * Creates a new view container and does the default initialization. */ - DolphinViewContainer* createViewContainer(const QUrl& url) const; + DolphinViewContainer *createViewContainer(const QUrl &url) const; + + /** + * Starts an animation that transitions between split view mode states. + * + * One of the viewContainers is always being expanded when toggling so + * this method can animate both opening and closing of viewContainers. + * @param expandingContainer The container that will increase in size + * over the course of the animation. + */ + void startExpandViewAnimation(DolphinViewContainer *expandingContainer); private: - QSplitter* m_splitter; + DolphinTabPageSplitter *m_splitter; QPointer m_navigatorsWidget; QPointer m_primaryViewContainer; QPointer m_secondaryViewContainer; + DolphinViewContainer *m_expandingContainer; + QPointer m_expandViewAnimation; + bool m_primaryViewActive; bool m_splitViewEnabled; bool m_active; + /** @see setCustomLabel(). */ + QString m_customLabel; +}; + +class DolphinTabPageSplitterHandle : public QSplitterHandle +{ + Q_OBJECT + +public: + explicit DolphinTabPageSplitterHandle(Qt::Orientation orientation, QSplitter *parent); + +protected: + bool event(QEvent *event) override; + +private: + void resetSplitterSizes(); + + // Sometimes QSplitterHandle doesn't receive MouseButtonDblClick event. + // We can detect that MouseButtonDblClick event should have been + // received if we receive two MouseButtonRelease events in a row. + bool m_mouseReleaseWasReceived; +}; + +class DolphinTabPageSplitter : public QSplitter +{ + Q_OBJECT + +public: + explicit DolphinTabPageSplitter(Qt::Orientation orientation, QWidget *parent); + +protected: + QSplitterHandle *createHandle() override; }; #endif // DOLPHIN_TAB_PAGE_H