Cross-platform window customization framework for Qt Widgets and Qt Quick. Support Windows, macOS, Linux.
This project inherited most of wangwenx190 FramelessHelper implementation, with a complete refactoring and upgrading of the architecture.
| Component | Requirement | Detailed |
|---|---|---|
| Qt | >=5.15 | Core, Gui, Widgets, Quick |
| Compiler | >=C++17 | MSVC 2019, GCC, Clang |
| CMake | >=3.17 | >=3.20 is recommended |
cmake -B build \
-Dqmsetup_DIR=<dir> \ # Optional
-DCMAKE_INSTALL_PREFIX=/path/install \
-G "Ninja Multi-Config"
cmake --build build --target install --config Debug
cmake --build build --target install --config Release
You can also include this directory as a sub-project if you choose CMake as your build system.
For other build systems, you need to install with CMake first and include the corresponding configuration files in your project.
cmake -B build -DQWindowKit_DIR=/path/install/cmake/QWindowKit
find_package(QWindowKit REQUIRED)
taraget_link_libraries(widgets_app PUBLIC QWindowKit::Widgets)
taraget_link_libraries(quick_app PUBLIC QWindowKit::Quick)
# WidgetsApp.pro
include("/path/install/share/QWindowKit/qmake/QWKWidgets.pri")
# QuickApp.pro
include("/path/install/share/QWindowKit/qmake/QWKQuick.pri")
TODO
First of all, you're supposed to add the following code in your main function in a very early stage (MUST before the construction of any Q(Gui|Core)Application objects).
int main(int argc, char *argv[]) {
#ifdef Q_OS_WINDOWS
QCoreApplication::setAttribute(Qt::AA_DontCreateNativeWidgetSiblings);
#elif defined(Q_OS_MAC)
# if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
qputenv("QT_MAC_WANTS_LAYER", "1");
# endif
#endif
}
TODO
TODO
See examples for more demo use cases. The examples has no High DPI support.
QWindowKit is licensed under the Apache 2.0 License.