From 1571d7b43228a0ed4347f681a16b2b23defccda9 Mon Sep 17 00:00:00 2001
From: Sine Striker <trueful@163.com>
Date: 周三, 27 12月 2023 03:52:03 +0800
Subject: [PATCH] Add doxygen documentations

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

diff --git a/src/core/style/styleagent.cpp b/src/core/style/styleagent.cpp
index 9e6206d..11d1adc 100644
--- a/src/core/style/styleagent.cpp
+++ b/src/core/style/styleagent.cpp
@@ -5,6 +5,11 @@
 
 namespace QWK {
 
+    /*!
+        \class StyleAgent
+        \brief StyleAgent provides some features related to system theme.
+    */
+
     StyleAgentPrivate::StyleAgentPrivate() {
     }
 
@@ -25,21 +30,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