https://github.com/kdab/kddockwidgets
KDAB's Dock Widget Framework for Qt
https://github.com/kdab/kddockwidgets
Last synced: 15 days ago
JSON representation
KDAB's Dock Widget Framework for Qt
- Host: GitHub
- URL: https://github.com/kdab/kddockwidgets
- Owner: KDAB
- License: other
- Created: 2019-04-08T13:08:44.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2025-04-12T11:26:31.000Z (18 days ago)
- Last Synced: 2025-04-14T22:10:03.024Z (15 days ago)
- Language: C++
- Homepage: https://www.kdab.com/development-resources/qt-tools/kddockwidgets
- Size: 30.7 MB
- Stars: 816
- Watchers: 51
- Forks: 172
- Open Issues: 19
-
Metadata Files:
- Readme: README-QtQuick.md
- Changelog: Changelog
- License: LICENSE.GPL.txt
Awesome Lists containing this project
README
# KDDockWidgets and QtQuick
## Supported Qt versions and toolchains
KDDockWidgets for QtQuick requires a C++17 capable compiler and Qt >= 6.2.1.
Qt 5.15.2 will probably also work, but it's not built and tested by KDAB CI, we
advise users to move to Qt6 as soon as possible.
## Build instructions
Doing a default build will build a KDDW library that's suitable for both QtWidgets and QtQuick development.
This is in contrast with 1.x version, where a separate build for QtQuick was required.
You can however be explicit and exclude the QtWidgets support:
`cd build && cmake -DKDDockWidgets_FRONTENDS=qtquick ..`
## Troubleshooting
- QtGraphicalEffects is not supported, as it's buggy when moving between different QWindows.
See for example QTBUG-94943, KDDockWidgets issue #213. Also search the Qt bug tracker
for "QQuickItem: Cannot use same item on different windows at the same time"
- Very rarely, in some Nvidia/X11 setups, floating/docking has noticeable lag (like 1 second)
This could be solved by going to Nvidia's settings and making sure all monitors have
the same refresh rate and disabling "Allow Flipping". It's not known why this solves it. Might also
be a bug in Qt.
- `"EGLFS: OpenGL windows cannot be mixed with others"` QtQuick on EGLFS does not support having more
than 1 window. This is a known QtQuick limitation. The QtWidgets stack worksaround this by compositing
all windows into a single native window.
- `module "QtQuick.Controls" is not installed`
Set the `QML_IMPORT_PATH` env var pointing to your Qt qml plugin dir or check the
Qt documentation on how to deploy QtQuick applications.
```bash
# Replace with your actual path
export QML_IMPORT_PATH=/home/user/Qt/5.15.2/gcc_64/qml
```