From e95e2bfd29b64d3144515c30fb9cf76adb75c6c3 Mon Sep 17 00:00:00 2001
From: Sine Striker <trueful@163.com>
Date: 周二, 07 5月 2024 21:44:21 +0800
Subject: [PATCH] minor tweaks

---
 src/core/style/styleagent.cpp |   32 ++++++++++++++++++++++++++++++++
 1 files changed, 32 insertions(+), 0 deletions(-)

diff --git a/src/core/style/styleagent.cpp b/src/core/style/styleagent.cpp
index 9e6206d..4b88447 100644
--- a/src/core/style/styleagent.cpp
+++ b/src/core/style/styleagent.cpp
@@ -1,9 +1,22 @@
+// Copyright (C) 2023-2024 Stdware Collections (https://www.github.com/stdware)
+// Copyright (C) 2021-2023 wangwenx190 (Yuhang Zhao)
+// SPDX-License-Identifier: Apache-2.0
+
 #include "styleagent.h"
 #include "styleagent_p.h"
 
 #include <QtCore/QVariant>
 
 namespace QWK {
+
+    /*!
+        \class StyleAgent
+        \brief StyleAgent provides some features related to system theme.
+
+        Qt6.6 started to support system theme detection, this class is intended as an auxiliary
+        support for lower versions of Qt. If your Qt already supports it, it is recommended that
+        you don't include this class in your build system.
+    */
 
     StyleAgentPrivate::StyleAgentPrivate() {
     }
@@ -25,21 +38,40 @@
         Q_EMIT q->systemThemeChanged();
     }
 
+    /*!
+        Constructor. Since it is not related to a concrete window instance, it is better to be used
+        as a singleton.
+    */
     StyleAgent::StyleAgent(QObject *parent) : StyleAgent(*new StyleAgentPrivate(), parent) {
     }
 
+    /*!
+        Destructor.
+    */
     StyleAgent::~StyleAgent() {
     }
 
+    /*!
+        Returns the system theme.
+    */
     StyleAgent::SystemTheme StyleAgent::systemTheme() const {
         Q_D(const StyleAgent);
         return d->systemTheme;
     }
 
+    /*!
+        \internal
+    */
     StyleAgent::StyleAgent(StyleAgentPrivate &d, QObject *parent) : QObject(parent), d_ptr(&d) {
         d.q_ptr = this;
 
         d.init();
     }
 
+    /*!
+        \fn void StyleAgent::systemThemeChanged()
+
+        This signal is emitted when the system theme changes.
+    */
+
 }

--
Gitblit v1.9.1