添加类、函数注释

newCardPage.cpp

@@ -2,10 +2,16 @@
 #include "ui_mainwindow.h"
 
 
-/*
- * 功能：切换到开卡页面
- * 触发：点击工具栏的“开卡”
-*/
+/**
+ * @brief   切换到开卡页面
+ *  点击工具栏的“开卡”触发：
+ *  - 如果读卡器或数据库未连接，显示警告信息并跳转到设置页面。
+ *  - 如果连接已准备好，则切换到开卡页面。
+ * @param   void
+ * @return  void
+ * @author  柯劲帆
+ * @date    2024-07-28
+ */
 void MainWindow::on_NewCardAction_triggered()
 {
     if (!ready())
@@ -22,13 +28,17 @@ void MainWindow::on_NewCardAction_triggered()
 }
 
 
-/*
- * 功能：读卡器扫描卡片
- * 触发：点击开卡页面的“查询”
-*/
+/**
+ * @brief   读卡器扫描卡片
+ *  点击开卡页面的“查询”触发。显示Inventory的查询结果，最多显示10张卡。
+ * @param   void
+ * @return  void
+ * @author  柯劲帆
+ * @date    2024-07-29
+ */
 void MainWindow::on_inventoryButton_clicked()
 {
-    QStringList cardIdList = reader.inventory(10); // 最多显示10张卡
+    QStringList cardIdList = reader.inventory(10);  // 最多显示10张卡
     ui->cardIdBox->clear();
     ui->cardIdBox->addItems(cardIdList);
 }