Qt-Advanced-Docking-System-master

# Advanced Docking System for Qt [](https://github.com/githubuser0xFFFF/Qt-Advanced-Docking-System/actions?query=workflow%3Alinux-builds) [](https://ci.appveyor.com/project/githubuser0xFFFF/qt-advanced-docking-system/branch/master) [](gnu-lgpl-v2.1.md) [What's new](https://github.com/githubuser0xFFFF/Qt-Advanced-Docking-System/releases/latest) • [Documentation](doc/user-guide.md) Qt Advanced Docking System lets you create customizable layouts using a full featured window docking system similar to what is found in many popular integrated development environments (IDEs) such as Visual Studio. [](https://www.youtube.com/watch?v=7pdNfafg3Qc) ## New and Noteworthy The [release 3.8](https://github.com/githubuser0xFFFF/Qt-Advanced-Docking-System/releases/tag/3.8.0) adds the following features: - option to close tabs with the middle mouse button - `DeleteContentOnClose` flag for dynamic deletion and creation of dock widget content The [release 3.7](https://github.com/githubuser0xFFFF/Qt-Advanced-Docking-System/releases/tag/3.7.0) adds the following features: - support for **Qt6.** - support for [empty dock area](doc/user-guide.md#empty-dock-area) The [release 3.6](https://github.com/githubuser0xFFFF/Qt-Advanced-Docking-System/releases/tag/3.6.0) adds some nice new features: - support for [central widget](doc/user-guide.md#central-widget) concept  - support for [native floating widgets](doc/user-guide.md#floatingcontainerforcenativetitlebar-linux-only) on Linux  Both features are contributions from ADS users. Read the [documentation](doc/user-guide.md) to learn more about both new features. The [release 3.5](https://github.com/githubuser0xFFFF/Qt-Advanced-Docking-System/releases/tag/3.5.0) adds the new [focus highlighting](doc/user-guide.md#focushighlighting) feature. This optional feature enables highlighting of the focused dock widget like you know it from Visual Studio.  [learn more...](doc/user-guide.md#focushighlighting) ## Features ### Overview - [New and Noteworthy](#new-and-noteworthy) - [Features](#features) - [Overview](#overview) - [Docking everywhere - no central widget](#docking-everywhere---no-central-widget) - [Docking inside floating windows](#docking-inside-floating-windows) - [Grouped dragging](#grouped-dragging) - [Perspectives for fast switching of the complete main window layout](#perspectives-for-fast-switching-of-the-complete-main-window-layout) - [Opaque and non-opaque splitter resizing](#opaque-and-non-opaque-splitter-resizing) - [Opaque and non-opaque undocking](#opaque-and-non-opaque-undocking) - [Tab-menu for easy handling of many tabbed dock widgets](#tab-menu-for-easy-handling-of-many-tabbed-dock-widgets) - [Many different ways to detach dock widgets](#many-different-ways-to-detach-dock-widgets) - [Supports deletion of dynamically created dock widgets](#supports-deletion-of-dynamically-created-dock-widgets) - [Python PyQt5 Bindings](#python-pyqt5-bindings) - [Tested Compatible Environments](#tested-compatible-environments) - [Supported Qt Versions](#supported-qt-versions) - [Windows](#windows) - [macOS](#macos) - [Linux](#linux) - [Build](#build) - [Getting started / Example](#getting-started--example) - [Developers](#developers) - [License information](#license-information) - [Alternative Docking System Implementations](#alternative-docking-system-implementations) - [KDDockWidgets](#kddockwidgets) - [QtitanDocking](#qtitandocking) - [Donation](#donation) - [Showcase](#showcase) - [Qt Creator IDE](#qt-creator-ide) - [Qt Design Studio](#qt-design-studio) - [QmixElements](#qmixelements) - [ezEditor](#ezeditor) - [D-Tect X](#d-tect-x) - [HiveWE](#hivewe) - [Ramses Composer](#ramses-composer) - [Plot Juggler](#plot-juggler) ### Docking everywhere - no central widget There is no central widget like in the Qt docking system. You can dock on every border of the main window or you can dock into each dock area - so you are free to dock almost everywhere.   ### Docking inside floating windows There is no difference between the main window and a floating window. Docking into floating windows is supported.   ### Grouped dragging When dragging the titlebar of a dock, all the tabs that are tabbed with it are going to be dragged. So you can move complete groups of tabbed widgets into a floating widget or from one dock area to another one.   ### Perspectives for fast switching of the complete main window layout A perspective defines the set and layout of dock windows in the main window. You can save the current layout of the dockmanager into a named perspective to make your own custom perspective. Later you can simply select a perspective from the perspective list to quickly switch the complete main window layout.   ### Opaque and non-opaque splitter resizing The advanced docking system uses standard QSplitters as resize separators and thus supports opaque and non-opaque resizing functionality of QSplitter. In some rare cases, for very complex widgets or on slow machines resizing via separator on the fly may cause flicking and glaring of rendered content inside a widget. The global dock manager flag `OpaqueSplitterResize` configures the resizing behaviour of the splitters. If this flag is set, then widgets are resized dynamically (opaquely) while interactively moving the splitters.  If this flag is cleared, the widget resizing is deferred until the mouse button is released - this is some kind of lazy resizing separator.  ### Opaque and non-opaque undocking By default, opaque undocking is active. That means, as soon as you drag a dock widget or a dock area with a number of dock widgets it will be undocked and moved into a floating widget and then the floating widget will be dragged around. That means undocking will take place immediatelly. You can compare this with opaque splitter resizing. If the flag `OpaqueUndocking` is cleared, then non-opaque undocking is active. In this mode, undocking is more like a standard drag and drop operation. That means, the dragged dock widget or dock area is not undocked immediatelly. Instead, a drag preview widget is created and dragged around to indicate the future position of the dock widget or dock area. The actual dock operation is only executed when the mouse button is released. That makes it possible, to cancel an active drag operation with the escape key. The drag preview widget can be configured by a number of global dock manager flags: - `DragPreviewIsDynamic`: if this flag is enabled, the preview will be adjusted dynamically to the drop area - `DragPreviewShowsContentPixmap`: the created drag preview window shows a static copy of the content of the dock widget / dock are that is dragged - `DragPreviewHasWindowFrame`: t