// Copyright (C) 2020 Uwe Kindler // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-2.1-or-later OR GPL-3.0-or-later #pragma once #include "ads_globals.h" #include #include #if defined(Q_OS_UNIX) && !defined(Q_OS_MACOS) using FloatingWidgetBaseType = QDockWidget; #else using FloatingWidgetBaseType = QWidget; #endif namespace ADS { class FloatingDockContainerPrivate; class DockManager; class DockManagerPrivate; class DockAreaWidget; class DockContainerWidget; class DockWidget; class DockManager; class DockAreaTabBar; class DockWidgetTab; class DockWidgetTabPrivate; class DockAreaTitleBar; class DockAreaTitleBarPrivate; class FloatingWidgetTitleBar; class DockingStateReader; /** * Pure virtual interface for floating widgets. * This interface is used for opaque and non-opaque undocking. If opaque undocking is used, * the a real FloatingDockContainer widget will be created. */ class AbstractFloatingWidget { public: virtual ~AbstractFloatingWidget() = 0; /** * Starts floating. * This function should get called typically from a mouse press event handler. */ virtual void startFloating(const QPoint &dragStartMousePos, const QSize &size, eDragState dragState, QWidget *mouseEventHandler) = 0; /** * Moves the widget to a new position relative to the position given when startFloating() * was called. This function should be called from a mouse mouve event handler to move the * floating widget on mouse move events. */ virtual void moveFloating() = 0; /** * Tells the widget that to finish dragging if the mouse is released. This function should be * called from a mouse release event handler to finish the dragging. */ virtual void finishDragging() = 0; }; /** * This implements a floating widget that is a dock container that accepts docking of dock widgets * like the main window and that can be docked into another dock container. Every floating window * of the docking system is a FloatingDockContainer. */ class ADS_EXPORT FloatingDockContainer : public FloatingWidgetBaseType, public AbstractFloatingWidget { Q_OBJECT private: FloatingDockContainerPrivate *d; ///< private data (pimpl) friend class FloatingDockContainerPrivate; friend class DockManager; friend class DockManagerPrivate; friend class DockAreaTabBar; friend class DockWidgetTabPrivate; friend class DockWidgetTab; friend class DockAreaTitleBar; friend class DockAreaTitleBarPrivate; friend class DockWidget; friend class DockAreaWidget; friend class FloatingWidgetTitleBar; void onDockAreasAddedOrRemoved(); void onDockAreaCurrentChanged(int Index); protected: /** * Starts floating at the given global position. Use moveToGlobalPos() to move the widget * to a new position depending on the start position given in Pos parameter. */ void startFloating(const QPoint &dragStartMousePos, const QSize &size, eDragState dragState, QWidget *mouseEventHandler) override; /** * Call this function to start dragging the floating widget. */ void startDragging(const QPoint &dragStartMousePos, const QSize &size, QWidget *mouseEventHandler) { startFloating(dragStartMousePos, size, DraggingFloatingWidget, mouseEventHandler); } /** * Call this function if you explicitly want to signal that dragging has finished. */ void finishDragging() override; /** * Call this function if you just want to initialize the position and size of the * floating widget. */ void initFloatingGeometry(const QPoint &dragStartMousePos, const QSize &size) { startFloating(dragStartMousePos, size, DraggingInactive, nullptr); } /** * Moves the widget to a new position relative to the position given when startFloating() * was called. */ void moveFloating() override; /** * Restores the state from given stream. If Testing is true, the function only parses the * data from the given stream but does not restore anything. You can use this check for * faulty files before you start restoring the state. */ bool restoreState(DockingStateReader &stream, bool testing); /** * Call this function to update the window title. */ void updateWindowTitle(); protected: // reimplements QWidget void changeEvent(QEvent *event) override; void closeEvent(QCloseEvent *event) override; void hideEvent(QHideEvent *event) override; void showEvent(QShowEvent *event) override; #ifdef Q_OS_MACOS virtual bool event(QEvent *event) override; virtual void moveEvent(QMoveEvent *event) override; #elif defined(Q_OS_UNIX) virtual bool event(QEvent *e) override; virtual void moveEvent(QMoveEvent *event) override; virtual void resizeEvent(QResizeEvent *event) override; #endif #ifdef Q_OS_WIN /** * Native event filter for handling WM_MOVING messages on Windows */ bool nativeEvent(const QByteArray &eventType, void *message, qintptr *result) override; #endif public: using Super = QWidget; /** * Create empty floating widget - required for restore state */ FloatingDockContainer(DockManager *dockManager); /** * Create floating widget with the given dock area */ FloatingDockContainer(DockAreaWidget *dockArea); /** * Create floating widget with the given dock widget */ FloatingDockContainer(DockWidget *dockWidget); /** * Virtual Destructor */ ~FloatingDockContainer() override; virtual QSize minimumSizeHint() const override; /** * Access function for the internal dock container */ DockContainerWidget *dockContainer() const; /** * This function returns true, if it can be closed. * It can be closed, if all dock widgets in all dock areas can be closed */ bool isClosable() const; /** * This function returns true, if this floating widget has only one single visible dock widget * in a single visible dock area. The single dock widget is a real top level floating widget * because no other widgets are docked. */ bool hasTopLevelDockWidget() const; /** * This function returns the first dock widget in the first dock area. If the function * hasSingleDockWidget() returns true, then this function returns this single dock widget. */ DockWidget *topLevelDockWidget() const; /** * This function returns a list of all dock widget in this floating widget. This is a simple * convenience function that simply calls the dockWidgets() function of the internal * container widget. */ QList dockWidgets() const; /** * This function hides the floating bar instantely and delete it later. */ void hideAndDeleteLater(); #if defined(Q_OS_UNIX) && !defined(Q_OS_MACOS) /** * This is a function that responds to FloatingWidgetTitleBar::maximizeRequest() * Maximize or normalize the container size. */ void onMaximizeRequest(); /** * Normalize (Unmaximize) the window. * fixGeometry parameter fixes a "bug" in QT where immediately after calling showNormal * geometry is not set properly. * Set this true when moving the window immediately after normalizing. */ void showNormal(bool fixGeometry = false); /** * Maximizes the window. */ void showMaximized(); /** * Returns if the window is currently maximized or not. */ bool isMaximized() const; /** * Returns true if the floating widget has a native titlebar or false if * the floating widget has a QWidget based title bar */ bool hasNativeTitleBar(); #endif }; // class FloatingDockContainer } // namespace ADS