From 78f31c67d71ee743f022dd6f5930abae6f6d54f9 Mon Sep 17 00:00:00 2001 From: Yuhang Zhao <zhaoyuhang@rankyee.com> Date: 周二, 19 12月 2023 16:43:17 +0800 Subject: [PATCH] update readme --- README.md | 65 +++++++++++++++++++++++++++++--- 1 files changed, 58 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 88076e0..8aca4df 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,20 @@ This project inherited most of [wangwenx190 FramelessHelper](https://github.com/wangwenx190/framelesshelper) implementation, with a complete refactoring and upgrading of the architecture. +## Screenshots + +### Windows + + + +### Linux + + + +### macOS + + + ## TODO + Fix 5.15 window abnormal behavior @@ -15,13 +29,13 @@ ## Supported Platforms -+ Microsoft Windows (Vista ~ 11) -+ Apple Mac OSX (11+) -+ GNU/Linux (Tested on Ubuntu) ++ Microsoft Windows ++ Apple macOS (11+) ++ GNU/Linux ## Requirements -| Component | Requirement | Detailed | +| Component | Requirement | Details | |:---------:|:-----------:|:------------------------------------:| | Qt | \>=5.15 | Core, Gui, Widgets, Quick | | Compiler | \>=C++17 | MSVC 2019, GCC, Clang | @@ -31,8 +45,8 @@ + Windows + MSVC: 2019, 2022 - + MinGW: 13.2.0 -+ MacOSX + + MinGW (GCC): 13.2.0 ++ macOS + Clang 14.0.3 + Ubuntu + GCC: 9.4.0 @@ -135,7 +149,44 @@ ### Qt Quick Application -TODO +Make sure you have registered QWK into QtQuick: + +```cpp +// ... +#include <QWKQuick/qwkquickglobal.h> +// ... + +int main(int argc, char *argv[]) +{ + // ... + QQmlApplicationEngine engine; + // ... + QWK::registerTypes(&engine); + // ... +} +``` + +Then you can use QWK data types and classes by importing it's URI: + +```qml +import QtQuick 2.15 +import QtQuick.Window 2.15 +import QWindowKit 1.0 + +Window { + id: window + visible: false // We hide it first, so we can move the window to our desired position silently. + Component.onCompleted: { + windowAgent.setup(window) + window.visible = true + } + WindowAgent { + // ... + } +} +``` + +You can omit the version number or use "auto" instead of "1.0" for the module URI if you are using Qt6. ### Learn More -- Gitblit v1.9.1