From 96833537013e55ee42ef86ea75afca373bdced29 Mon Sep 17 00:00:00 2001
From: Zhao Yuhang <2546789017@qq.com>
Date: 摹曛, 28 12月 2023 20:23:50 +0800
Subject: [PATCH] add quick mac button API

---
 src/core/windowagentbase.cpp |   31 +++++++++++++++++++------------
 1 files changed, 19 insertions(+), 12 deletions(-)

diff --git a/src/core/windowagentbase.cpp b/src/core/windowagentbase.cpp
index 60ade6a..ef8b0fb 100644
--- a/src/core/windowagentbase.cpp
+++ b/src/core/windowagentbase.cpp
@@ -27,8 +27,8 @@
         \brief WindowAgentBase is the base class of the specifiy window agent for QtWidgets and
         QtQuick.
 
-        It processes some system events and the implements of frameless logic, and provides some
-        common methods for derived classes to call.
+        It processes some system events to remove the window's default title bar, and provides some
+        shared methods for derived classes to call.
     */
 
     WindowAgentBasePrivate::WindowContextFactoryMethod
@@ -83,20 +83,27 @@
         Available attributes:
 
         On Windows,
-            \li \c acrylic-material: Specify a boolean value to enable or disable acrylic material,
-                    this attribute is only available on Windows 11.
-            \li \c mica: Specify a boolean value to enable or disable mica material,
-                    this attribute is only available on Windows 11.
-            \li \c mica-alt: Specify a boolean value to enable or disable mica-alt material,
-                    this attribute is only available on Windows 11.
+            \li \c dwm-blur: Specify a boolean value to enable or disable dwm blur effect, this
+                   attribute is available on Windows 10 or later.
             \li \c dark-mode: Specify a boolean value to enable or disable the dark mode, it is
-                    enabled by default on Windows 10 if the system borders config is enabled.
+                   enabled by default on Windows 10 if the system borders config is enabled. This
+                   attribute is available on Windows 10 or later.
+            \li \c acrylic-material: Specify a boolean value to enable or disable acrylic material,
+                   this attribute is only available on Windows 11.
+            \li \c mica: Specify a boolean value to enable or disable mica material,
+                   this attribute is only available on Windows 11.
+            \li \c mica-alt: Specify a boolean value to enable or disable mica-alt material,
+                   this attribute is only available on Windows 11.
             \li \c extra-margins: Specify a margin value to change the \c dwm extended area
-                    geometry, you shouldn't change this attribute because it may break the
-                    internal state.
+                   geometry, you shouldn't change this attribute because it may break the
+                   internal state.
 
         On macOS,
-            \li \c no-system-buttons: Specify a boolean value to set the system buttons' visibility.
+            \li \c no-system-buttons: Specify a boolean value to set the system buttons'
+                   visibility.
+            \li \c blur-effect: You can specify a string value, "dark" to set dark mode, "light"
+                   to set light mode, "none" to disable. You can also specify a boolean value,
+                   \c true to enable and set the current theme, \c false to disable.
     */
     bool WindowAgentBase::setWindowAttribute(const QString &key, const QVariant &attribute) {
         Q_D(WindowAgentBase);

--
Gitblit v1.9.1