src/dolphinnavigatorswidgetaction.h

   1 /*
   2     This file is part of the KDE project
   3     SPDX-FileCopyrightText: 2020 Felix Ernst <felixernst@kde.org>
   4
   5     SPDX-License-Identifier: LGPL-2.1-only OR LGPL-3.0-only OR LicenseRef-KDE-Accepted-LGPL
   6 */
   7
   8 #ifndef DOLPHINNAVIGATORSWIDGETACTION_H
   9 #define DOLPHINNAVIGATORSWIDGETACTION_H
  10
  11 #include "dolphinurlnavigator.h"
  12
  13 #include <QPointer>
  14 #include <QSplitter>
  15 #include <QTimer>
  16 #include <QWidgetAction>
  17
  18 #include <memory>
  19
  20 class KXmlGuiWindow;
  21 class QPushButton;
  22
  23 /**
  24  * @brief QWidgetAction that allows to use DolphinUrlNavigators in a toolbar.
  25  *
  26  * This class is mainly a container that manages up to two DolphinUrlNavigator objects so they
  27  * can be added to a toolbar. It also deals with alignment.
  28  *
  29  * The structure of the defaultWidget() of this QWidgetAction is as follows:
  30  * - A QSplitter manages up to two sides which each correspond to one DolphinViewContainer.
  31  *      The secondary side only exists for split view and is created by
  32  *      createSecondaryUrlNavigator() when necessary.
  33  * - Each side is a QWidget which I call NavigatorWidget with a QHBoxLayout.
  34  * - Each NavigatorWidget consists an UrlNavigator, an emptyTrashButton, a
  35  *   networkFolderButton, and spacing.
  36  * - Only the primary navigatorWidget has leading spacing. Both have trailing spacing.
  37  *      The spacing is there to align the UrlNavigator with its DolphinViewContainer.
  38  */
  39 class DolphinNavigatorsWidgetAction : public QWidgetAction
  40 {
  41     Q_OBJECT
  42
  43 public:
  44     DolphinNavigatorsWidgetAction(QWidget *parent = nullptr);
  45
  46     /**
  47      * Adjusts the width of the spacings used to align the UrlNavigators with ViewContainers.
  48      * This can only work nicely if up-to-date geometry of ViewContainers is cached so
  49      * followViewContainersGeometry() has to have been called at least once before.
  50      */
  51     void adjustSpacing();
  52
  53     /**
  54      * The secondary UrlNavigator is only created on-demand. Such an action is not necessary
  55      * for the primary UrlNavigator which is created preemptively.
  56      *
  57      * This method should preferably only be called when:
  58      * - Split view is activated in the active tab
  59      * OR
  60      * - A switch to a tab that is already in split view mode is occurring
  61      */
  62     void createSecondaryUrlNavigator();
  63
  64     /**
  65      * Notify this widget of changes in geometry of the ViewContainers it tries to be
  66      * aligned with.
  67      */
  68     void followViewContainersGeometry(QWidget *primaryViewContainer, QWidget *secondaryViewContainer = nullptr);
  69
  70     bool isInToolbar() const;
  71
  72     /**
  73      * @return the primary UrlNavigator.
  74      */
  75     DolphinUrlNavigator *primaryUrlNavigator() const;
  76     /**
  77      * @return the secondary UrlNavigator and nullptr if it doesn't exist.
  78      */
  79     DolphinUrlNavigator *secondaryUrlNavigator() const;
  80
  81     /**
  82      * Change the visibility of the secondary UrlNavigator including spacing.
  83      * @param visible Setting this to false will completely hide the secondary side of this
  84      *                WidgetAction's QSplitter making the QSplitter effectively disappear.
  85      */
  86     void setSecondaryNavigatorVisible(bool visible);
  87
  88 protected:
  89     /**
  90      * There should always ever be one navigatorsWidget for this action so
  91      * this method always returns the same widget and reparents it.
  92      * You normally don't have to use this method directly because
  93      * QWidgetAction::requestWidget() is used to obtain the navigatorsWidget
  94      * and to steal it from wherever it was prior.
  95      * @param parent the new parent of the navigatorsWidget.
  96      */
  97     QWidget *createWidget(QWidget *parent) override;
  98
  99     /** @see QWidgetAction::deleteWidget() */
 100     void deleteWidget(QWidget *widget) override;
 101
 102 private:
 103     /**
 104      * In Left-to-right languages the Primary side will be the left one.
 105      */
 106     enum Side { Primary, Secondary };
 107     /**
 108      * Used to create the navigatorWidgets for both sides of the QSplitter.
 109      */
 110     QWidget *createNavigatorWidget(Side side) const;
 111
 112     /**
 113      * Used to retrieve the emptyTrashButtons for the navigatorWidgets on both sides.
 114      */
 115     QPushButton *emptyTrashButton(Side side);
 116
 117     /**
 118      * Creates a new empty trash button.
 119      * @param urlNavigator Only when this UrlNavigator shows the trash directory
 120      *                     will the button be visible.
 121      * @param parent       Aside from the usual QObject deletion mechanisms,
 122      *                     this parameter influences the positioning of dialog windows
 123      *                     pertaining to this trash button.
 124      */
 125     QPushButton *newEmptyTrashButton(const DolphinUrlNavigator *urlNavigator, QWidget *parent) const;
 126
 127     /**
 128      * Used to retrieve the networkFolderButtons for the navigatorWidgets on
 129      * both sides.
 130      */
 131     QPushButton *networkFolderButton(Side side);
 132
 133     /**
 134      * Creates a new add "network folder" button.
 135      * @param urlNavigator Only when this UrlNavigator shows the remote directory
 136      *                     will the button be visible.
 137      * @param parent       The object that should be the button's parent.
 138      */
 139     QPushButton *newNetworkFolderButton(const DolphinUrlNavigator *urlNavigator, QWidget *parent) const;
 140
 141     enum Position { Leading, Trailing };
 142     /**
 143      * Used to retrieve both the leading and trailing spacing for the navigatorWidgets
 144      * on both sides. A secondary leading spacing does not exist.
 145      */
 146     QWidget *spacing(Side side, Position position) const;
 147
 148     /**
 149      * Sets this action's text depending on the amount of visible UrlNavigators.
 150      */
 151     void updateText();
 152
 153     /**
 154      * The defaultWidget() of this QWidgetAction.
 155      */
 156     std::unique_ptr<QSplitter> m_splitter;
 157
 158     /**
 159      * adjustSpacing() has to be called slightly later than when urlChanged is emitted.
 160      * This timer bridges that time.
 161      */
 162     std::unique_ptr<QTimer> m_adjustSpacingTimer;
 163
 164     /**
 165      * Extracts the geometry information needed by adjustSpacing() from
 166      * ViewContainers. They are also monitored for size changes which
 167      * will lead to adjustSpacing() calls.
 168      */
 169     class ViewGeometriesHelper : public QObject
 170     {
 171     public:
 172         /**
 173          * @param navigatorsWidget       The QWidget of the navigatorsWidgetAction.
 174          * @param navigatorsWidgetAction is only used to call adjustSpacing() whenever that is
 175          *                               deemed necessary.
 176          */
 177         ViewGeometriesHelper(QWidget *navigatorsWidget, DolphinNavigatorsWidgetAction *navigatorsWidgetAction);
 178
 179         /**
 180          * Calls m_navigatorsWidgetAction::adjustSpacing() when a watched object is resized.
 181          */
 182         bool eventFilter(QObject *watched, QEvent *event) override;
 183
 184         /**
 185          * Sets the ViewContainers whose geometry is obtained when viewGeometries() is called.
 186          */
 187         void setViewContainers(QWidget *primaryViewContainer, QWidget *secondaryViewContainer = nullptr);
 188
 189         struct Geometries {
 190             int globalXOfNavigatorsWidget;
 191             int globalXOfPrimary;
 192             int widthOfPrimary;
 193             int globalXOfSecondary;
 194             int widthOfSecondary;
 195         };
 196         /**
 197          * @return a Geometries struct that contains values adjustSpacing() requires.
 198          */
 199         Geometries viewGeometries();
 200
 201     private:
 202         QWidget *m_navigatorsWidget;
 203         /** Is only used to call adjustSpacing() whenever that is deemed necessary. */
 204         DolphinNavigatorsWidgetAction *m_navigatorsWidgetAction;
 205
 206         QPointer<QWidget> m_primaryViewContainer;
 207         QPointer<QWidget> m_secondaryViewContainer;
 208     };
 209
 210     ViewGeometriesHelper m_viewGeometriesHelper;
 211
 212     /**
 213      * Used to check if the window has been resized.
 214      * @see ViewGeometriesHelper::eventFilter() for why this is needed.
 215      */
 216     int m_previousWindowWidth = -1;
 217 };
 218
 219 #endif // DOLPHINNAVIGATORSWIDGETACTION_H