Sine Striker
2023-12-17 ddfcd1e70643cc08161e9a032eb33f62e86d1cd3
README.md
@@ -1,8 +1,8 @@
# QWindowKit
Cross-platform window customization framework for Qt Widgets and Qt Quick.
Cross-platform window customization framework for Qt Widgets and Qt Quick. Support Windows, macOS, Linux.
This project inherited most of [FramelessHelper](https://github.com/wangwenx190/framelesshelper)'s implementation, with a complete refactoring and upgrading of the architecture.
This project inherited most of [wangwenx190 FramelessHelper](https://github.com/wangwenx190/framelesshelper) implementation, with a complete refactoring and upgrading of the architecture.
## Supported Platforms
@@ -30,7 +30,52 @@
## Dependencies
+ Qt 5.15 or higher
+ [qmsetup](https://github.com/stdware/qmsetup)
## Integrate
### Build & Install
```sh
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.
### Import
#### CMake Project
```cmake
cmake -B build -DQWindowKit_DIR=/path/install/cmake/QWindowKit
```
```cmake
find_package(QWindowKit REQUIRED)
taraget_link_libraries(widgets_app PUBLIC QWindowKit::Widgets)
taraget_link_libraries(quick_app PUBLIC QWindowKit::Quick)
```
#### QMake Project
```cmake
# WidgetsApp.pro
include("/path/install/share/QWindowKit/qmake/QWKWidgets.pri")
# QuickApp.pro
include("/path/install/share/QWindowKit/qmake/QWKQuick.pri")
```
#### Visual Studio Project
TODO
## Quick Start
@@ -41,7 +86,7 @@
```c++
int main(int argc, char *argv[]) {
#ifdef Q_OS_WINDOWS
    qApp->setAttribute(Qt::AA_DontCreateNativeWidgetSiblings);
    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");
@@ -60,7 +105,7 @@
### Learn More
See [examples](examples) for more demo use cases.
See [examples](examples) for more demo use cases. The examples has no High DPI support.
## Documentatons
@@ -69,4 +114,4 @@
## License
QWindowKit is licensed under the [Apache 2.0 License](LICENSE).
QWindowKit is licensed under the Apache 2.0 License.