/*
* SPDX-FileCopyrightText: 2014 Emmanuel Pescosta <emmanuelpescosta099@gmail.com>
- * SPDX-FileCopyrightText: 2020 Felix Ernst <fe.a.ernst@gmail.com>
+ * SPDX-FileCopyrightText: 2020 Felix Ernst <felixernst@kde.org>
*
* SPDX-License-Identifier: GPL-2.0-or-later
*/
#ifndef DOLPHIN_TAB_PAGE_H
#define DOLPHIN_TAB_PAGE_H
+#include "global.h"
+
#include <QPointer>
+#include <QSplitter>
#include <QUrl>
#include <QWidget>
class DolphinNavigatorsWidgetAction;
class DolphinViewContainer;
-class QSplitter;
class QVariantAnimation;
class KFileItemList;
-
-enum Animated {
- WithAnimation,
- WithoutAnimation
-};
+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.
*
* @param enabled If true, creates a secondary viewContainer in this tab.
* Otherwise deletes it.
- * @param animated Decides wether the effects of this method call should
+ * @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
/**
* @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
*/
void disconnectNavigators();
- /**
- * Calls resizeNavigators() when a watched object is resized.
- */
- bool eventFilter(QObject *watched, QEvent *event) override;
-
void insertNavigatorsWidget(DolphinNavigatorsWidgetAction *navigatorsWidget);
- /**
- * Notify the connected DolphinNavigatorsWidgetAction of geometry changes which it
- * needs for visual alignment.
- */
- void resizeNavigators() const;
-
/**
* Marks the items indicated by \p urls to get selected after the
* directory DolphinView::url() has been loaded. Note that nothing
* 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
* 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);
-signals:
- void activeViewChanged(DolphinViewContainer* viewContainer);
- void activeViewUrlChanged(const QUrl& url);
+ /**
+ * @see setCustomLabel.
+ */
+ QString customLabel() const;
+
+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.
*
* 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.
void startExpandViewAnimation(DolphinViewContainer *expandingContainer);
private:
- QSplitter* m_splitter;
+ DolphinTabPageSplitter *m_splitter;
QPointer<DolphinNavigatorsWidgetAction> m_navigatorsWidget;
QPointer<DolphinViewContainer> m_primaryViewContainer;
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
projects / dolphin.git / blobdiff