From 2150ebf45e638e45eefecc7264fa9423539686b9 Mon Sep 17 00:00:00 2001 From: githubuser0xFFFF Date: Tue, 17 Dec 2019 14:44:57 +0100 Subject: [PATCH] Update README.md Added animations for opaque and non opaque resizing --- README.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 9f4368f..01e6e47 100644 --- a/README.md +++ b/README.md @@ -69,7 +69,13 @@ main window layout. ![Perspective](doc/perspectives_dark.png) ### 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. +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. + +![Opaque resizing](doc/opaque_resizing.gif) + +If this flag is cleared, the widget resizing is deferred until the mouse button is released - this is some kind of lazy resizing separator. + +![Non-opaque resizing](doc/non_opaque_resizing.gif) ### 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.