Skip to content

Commit 50652b0

Browse files
Fixed svg icon
1 parent 66795f2 commit 50652b0

File tree

2 files changed

+25
-11
lines changed

2 files changed

+25
-11
lines changed

doc/ads_icon.svg

Lines changed: 7 additions & 7 deletions
Loading

doc/ads_qt_marketplace_description.md

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,8 @@
1-
# Advanced Docking System for Qt
2-
Qt Advanced Docking System lets you create customizable layouts using a full
3-
featured window docking system similar to what is found in many popular
4-
integrated development environments (IDEs) such as Visual Studio.
1+
# Advanced Docking System for Qt
2+
3+
Qt Advanced Docking System lets you create customizable layouts using a full
4+
featured window docking system similar to what is found in many popular
5+
integrated development environments (IDEs) such as Visual Studio.
56

67
[![Video Advanced Docking](https://raw.githubusercontent.com/githubuser0xFFFF/Qt-Advanced-Docking-System/master/doc/advanced-docking_video.png)](https://www.youtube.com/watch?v=7pdNfafg3Qc)
78

@@ -10,7 +11,9 @@ platform specific code. Basic usage of QWidgets and QLayouts and using basic
1011
styles as much as possible.
1112

1213
## Features
14+
1315
### Overview
16+
1417
- [Advanced Docking System for Qt](#advanced-docking-system-for-qt)
1518
- [Features](#features)
1619
- [Overview](#overview)
@@ -25,6 +28,7 @@ styles as much as possible.
2528
- [Supports deletion of dynamically created dock widgets](#supports-deletion-of-dynamically-created-dock-widgets)
2629

2730
### Docking everywhere - no central widget
31+
2832
There is no central widget like in the Qt docking system. You can dock on every
2933
border of the main window or you can dock into each dock area - so you are
3034
free to dock almost everywhere.
@@ -34,6 +38,7 @@ free to dock almost everywhere.
3438
![Dropping widgets](https://raw.githubusercontent.com/githubuser0xFFFF/Qt-Advanced-Docking-System/master/doc/preview-dragndrop_dark.png)
3539

3640
### Docking inside floating windows
41+
3742
There is no difference between the main window and a floating window. Docking
3843
into floating windows is supported.
3944

@@ -42,6 +47,7 @@ into floating windows is supported.
4247
![Docking inside floating windows](https://raw.githubusercontent.com/githubuser0xFFFF/Qt-Advanced-Docking-System/master/doc/floating-widget-dragndrop_dark.png)
4348

4449
### Grouped dragging
50+
4551
When dragging the titlebar of a dock, all the tabs that are tabbed with it are
4652
going to be dragged. So you can move complete groups of tabbed widgets into
4753
a floating widget or from one dock area to another one.
@@ -51,6 +57,7 @@ a floating widget or from one dock area to another one.
5157
![Grouped dragging](https://raw.githubusercontent.com/githubuser0xFFFF/Qt-Advanced-Docking-System/master/doc/grouped-dragging_dark.png)
5258

5359
### Perspectives for fast switching of the complete main window layout
60+
5461
A perspective defines the set and layout of dock windows in the main
5562
window. You can save the current layout of the dockmanager into a named
5663
perspective to make your own custom perspective. Later you can simply
@@ -62,6 +69,7 @@ main window layout.
6269
![Perspective](https://raw.githubusercontent.com/githubuser0xFFFF/Qt-Advanced-Docking-System/master/doc/perspectives_dark.png)
6370

6471
### Opaque and non-opaque splitter resizing
72+
6573
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.
6674

6775
![Opaque resizing](https://raw.githubusercontent.com/githubuser0xFFFF/Qt-Advanced-Docking-System/master/doc/opaque_resizing.gif)
@@ -71,25 +79,31 @@ If this flag is cleared, the widget resizing is deferred until the mouse button
7179
![Non-opaque resizing](https://raw.githubusercontent.com/githubuser0xFFFF/Qt-Advanced-Docking-System/master/doc/non_opaque_resizing.gif)
7280

7381
### Opaque and non-opaque undocking
82+
7483
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.
7584

7685
The drag preview widget can be configured by a number of global dock manager flags:
86+
7787
- `DragPreviewIsDynamic`: if this flag is enabled, the preview will be adjusted dynamically to the drop area
7888
- `DragPreviewShowsContentPixmap`: the created drag preview window shows a static copy of the content of the dock widget / dock are that is dragged
7989
- `DragPreviewHasWindowFrame`: this flag configures if the drag preview is frameless like a QRubberBand or looks like a real window
8090

8191
The best way to test non-opaque undocking is to set the standard flags: `CDockManager::setConfigFlags(CDockManager::DefaultNonOpaqueConfig)`.
8292

8393
### Tab-menu for easy handling of many tabbed dock widgets
94+
8495
Tabs are a good way to quickly switch between dockwidgets in a dockarea. However, if the number of dockwidgets in a dockarea is too large, this may affect the usability of the tab bar. To keep track in this situation, you can use the tab menu. The menu allows you to quickly select the dockwidget you want to activate from a drop down menu.
8596

8697
![Tab menu](https://raw.githubusercontent.com/githubuser0xFFFF/Qt-Advanced-Docking-System/master/doc/tab_menu.gif)
8798

8899
### Many different ways to detach dock widgets
100+
89101
You can detach dock widgets and also dock areas in the following ways:
102+
90103
- by dragging the dock widget tab or the dock area title bar
91104
- by double clicking the tab or title bar
92105
- by using the detach menu entry from the tab and title bar drop down menu
93106

94107
### Supports deletion of dynamically created dock widgets
108+
95109
Normally clicking the close button of a dock widget will just hide the widget and the user can show it again using the toggleView() action of the dock widget. This is meant for user interfaces with a static amount of widgets. But the advanced docking system also supports dynamic dock widgets that will get deleted on close. If you set the dock widget flag `DockWidgetDeleteOnClose` for a certain dock widget, then it will be deleted as soon as you close this dock widget. This enables the implementation of user interfaces with dynamically created editors, like in word processing applications or source code development tools.

0 commit comments

Comments
 (0)