SVN_SILENT made messages (.desktop file) - always resolve ours

[dolphin.git] / src / dolphintabpage.h

diff --git a/src/dolphintabpage.h b/src/dolphintabpage.h
index 74344acd1800b2b1919a2f7a4ee398880c9101f3..1e79fb5db071f48c68f95c06faedcb2a033064db 100644 (file)
--- a/src/dolphintabpage.h
+++ b/src/dolphintabpage.h
@@ -1,5 +1,6 @@
 /*
  * SPDX-FileCopyrightText: 2014 Emmanuel Pescosta <emmanuelpescosta099@gmail.com>
 /*
  * SPDX-FileCopyrightText: 2014 Emmanuel Pescosta <emmanuelpescosta099@gmail.com>

+ * SPDX-FileCopyrightText: 2020 Felix Ernst <felixernst@kde.org>

  *
  * SPDX-License-Identifier: GPL-2.0-or-later
  */
  *
  * SPDX-License-Identifier: GPL-2.0-or-later
  */


@@ -7,20 +8,25 @@
 #ifndef DOLPHIN_TAB_PAGE_H
 #define DOLPHIN_TAB_PAGE_H
 
 #ifndef DOLPHIN_TAB_PAGE_H
 #define DOLPHIN_TAB_PAGE_H
 

+#include "global.h"
+

 #include <QPointer>
 #include <QPointer>

+#include <QSplitter>

 #include <QUrl>
 #include <QWidget>
 
 #include <QUrl>
 #include <QWidget>
 

-class QSplitter;
+class DolphinNavigatorsWidgetAction;

 class DolphinViewContainer;
 class DolphinViewContainer;

+class QVariantAnimation;

 class KFileItemList;
 class KFileItemList;

+class DolphinTabPageSplitter;

 
 class DolphinTabPage : public QWidget
 {
     Q_OBJECT
 
 public:
 
 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.
 
     /**
      * @return True if primary view is the active view in this tab.


@@ -35,24 +41,36 @@ public:
     /**
      * Enables or disables the split view mode.
      *
     /**
      * 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.
      */
 
     /**
      * @return The primary view container.
      */

-    DolphinViewContainer* primaryViewContainer() const;
+    DolphinViewContainer *primaryViewContainer() const;

 
     /**
      * @return The secondary view container, can be 0 if split view is disabled.
      */
 
     /**
      * @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
      */
 
     /**
      * @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
 
     /**
      * Returns the selected items. The list is empty if no item has been


@@ -66,6 +84,21 @@ public:
      */
     int selectedItemsCount() const;
 
      */
     int selectedItemsCount() const;
 

+    /**
+     * Connects a navigatorsWidget to this. It will be connected to the DolphinViewContainers
+     * managed by this tab. For alignment purposes this will from now on notify the
+     * navigatorsWidget when this tab or its viewContainers are resized.
+     */
+    void connectNavigators(DolphinNavigatorsWidgetAction *navigatorsWidget);
+
+    /**
+     * Makes it so this tab and its DolphinViewContainers aren't controlled by any
+     * UrlNavigators anymore.
+     */
+    void disconnectNavigators();
+
+    void insertNavigatorsWidget(DolphinNavigatorsWidgetAction *navigatorsWidget);
+

     /**
      * Marks the items indicated by \p urls to get selected after the
      * directory DolphinView::url() has been loaded. Note that nothing
     /**
      * Marks the items indicated by \p urls to get selected after the
      * directory DolphinView::url() has been loaded. Note that nothing


@@ -78,15 +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.
      */
      * 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);
-
-    /**
-     * Sets the places selector visible, if \a visible is true.
-     * The places selector allows to select the places provided
-     * by the places model passed in the constructor. Per default
-     * the places selector is visible.
-     */
-    void setPlacesSelectorVisible(bool visible);
+    void markUrlAsCurrent(const QUrl &url);

 
     /**
      * Refreshes the views of the main window by recreating them according to
 
     /**
      * Refreshes the views of the main window by recreating them according to


@@ -105,28 +130,45 @@ public:
      * Restores all tab related properties (urls, splitter layout, ...) from
      * the given \a state.
      */
      * 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();

 
     /**
 
     /**

-     * Set whether the tab page is active
-     *
+     * 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 setActive(bool active);
+    void setCustomLabel(const QString &label);
+
+    /**
+     * @see setCustomLabel.
+     */
+    QString customLabel() const;
+
+Q_SIGNALS:
+    void activeViewChanged(DolphinViewContainer *viewContainer);
+    void activeViewUrlChanged(const QUrl &url);
+    void splitterMoved(int pos, int index);
+
+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();

 
 

-signals:
-    void activeViewChanged(DolphinViewContainer* viewContainer);
-    void activeViewUrlChanged(const QUrl& url);
+    /**
+     * This method is called for every frame of the m_expandViewAnimation.
+     */
+    void slotAnimationValueChanged(const QVariant &value);

 
 

-private slots:

     /**
      * Handles the view activated event.
      *
     /**
      * Handles the view activated event.
      *


@@ -140,25 +182,69 @@ private slots:
      *
      * It emits the activeViewUrlChanged signal with the url \a newUrl.
      */
      *
      * 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.
      */
 
 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:
 
 private:

-    QSplitter* m_splitter;
+    DolphinTabPageSplitter *m_splitter;

 
 

+    QPointer<DolphinNavigatorsWidgetAction> m_navigatorsWidget;

     QPointer<DolphinViewContainer> m_primaryViewContainer;
     QPointer<DolphinViewContainer> m_secondaryViewContainer;
 
     QPointer<DolphinViewContainer> m_primaryViewContainer;
     QPointer<DolphinViewContainer> m_secondaryViewContainer;
 

+    DolphinViewContainer *m_expandingContainer;
+    QPointer<QVariantAnimation> m_expandViewAnimation;
+

     bool m_primaryViewActive;
     bool m_splitViewEnabled;
     bool m_active;
     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
 };
 
 #endif // DOLPHIN_TAB_PAGE_H