From 482ac0985ce485df742d2bf5b7d95beff490ff1b Mon Sep 17 00:00:00 2001
From: syn <1296770454@qq.com>
Date: Tue, 4 Jul 2023 16:59:48 +0800
Subject: [PATCH] doc: update docs for dbaseexpand
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

更新dbaseexpand的文档

Log: update docs

Issue: https://github.com/linuxdeepin/dtk/issues/94
---
 docs/widgets/dbaseexpand.zh_CN.dox | 65 ++++++++++++++++++++++++
 src/widgets/dbaseexpand.cpp        | 80 +++++++++++++++++-------------
 2 files changed, 111 insertions(+), 34 deletions(-)
 create mode 100644 docs/widgets/dbaseexpand.zh_CN.dox

diff --git a/docs/widgets/dbaseexpand.zh_CN.dox b/docs/widgets/dbaseexpand.zh_CN.dox
new file mode 100644
index 000000000..09790c374
--- /dev/null
+++ b/docs/widgets/dbaseexpand.zh_CN.dox
@@ -0,0 +1,65 @@
+/*!
+@~chinese
+@file dbaseexpand.h
+@ingroup dtkwidget
+
+@class Dtk::Widget::DBaseExpand
+@brief 一个美观的可展开的控件.
+@details 使用 DBaseExpand 类可以创建一个可展开的带有展开动画效果的控件，这个控件包含上下两部分，上面的控件为标题控件，这个控件会始终显示，下面的控件为内容控件，默认为不会显示，调用 DBaseExpand::setExpand 设置内容控件的可见性。
+使用 DBaseExpand::setHeader 和 DBaseExpand::setContent 设置分别设置标题控件和内容控件。
+@sa DHeaderLine
+@image html DBaseExpand.gif
+
+@fn void DBaseExpand::expandChange(bool e)
+@brief 内容控件可见性发生改变的信号
+@param[in] e 为 true 表示内容控件变为了可见，反之则反
+
+@fn DBaseExpand::DBaseExpand(QWidget *parent)
+@brief 获取 DBaseExpand::DBaseExpand 实例
+@param[in] parent 作为实例的父控件
+
+@fn void DBaseExpand::setHeader(QWidget *header)
+@brief 设置标题控件
+@note 标题控件会始终显示在布局里
+@param[in] header 标题控件
+
+@fn void DBaseExpand::setContent(QWidget *content, Qt::Alignment alignment)
+@brief 设置内容控件
+@note 内容控件默认是隐藏的，调用 DBaseExpand::setExpand 设置其可见性
+@param[in] content 内容控件
+@param[in] alignment 内容控件在布局中的对齐方式
+
+@fn QWidget *DBaseExpand::getContent() const
+@brief 获取内容控件对象
+@return 内容控件对象
+
+@fn void DBaseExpand::setHeaderHeight(int height)
+@brief 设置标题控件的高度
+@param[in] height 指定的高度
+
+@fn void DBaseExpand::setExpand(bool value)
+@brief 设置内容控件的可见性
+@param[in] value 为 true 则内容控件可见，反之则反
+
+@fn bool DBaseExpand::expand() const
+@brief 获取当前内容控件的可见性
+@return 当前内容控件的可见性
+
+@fn void DBaseExpand::setAnimationDuration(int duration)
+@brief 设置内容控件的可见性改变时动画的时间 
+@param[in] duration 指定动画时间
+
+@fn void DBaseExpand::setAnimationEasingCurve(QEasingCurve curve)
+@brief 设置内容控件的可见性改变时动画的样式
+@param[in] curve 指定动画样式
+
+@fn void DBaseExpand::setSeparatorVisible(bool arg)
+@brief 设置是否允许标题控件与内容控件之间的分割线 
+@param[in] arg 为 ture 则显示分割线，反之则反
+
+@fn void DBaseExpand::setExpandedSeparatorVisible(bool arg)
+@brief 设置是否允许内容控件下的分割线
+@param[in] arg 为 ture 则显示分割线，反之则反
+
+*/
+
diff --git a/src/widgets/dbaseexpand.cpp b/src/widgets/dbaseexpand.cpp
index 4aa424555..43671b947 100644
--- a/src/widgets/dbaseexpand.cpp
+++ b/src/widgets/dbaseexpand.cpp
@@ -98,26 +98,28 @@ DBaseExpandPrivate::~DBaseExpandPrivate()
 }
 
 /*!
-  \class Dtk::Widget::DBaseExpand
-  \inmodule dtkwidget
-  \brief 一个美观的可展开的控件.
+@~english
+  @class Dtk::Widget::DBaseExpand
+  @brief A beautiful expandable control.
   
-  使用 DBaseExpand 类可以创建一个可展开的带有展开动画效果的控件，这个控件包含上下两部分，上面的控件为标题控件，这个控件会始终显示，下面的控件为内容控件，默认为不会显示，调用 DBaseExpand::setExpand 设置内容控件的可见性。使用 DBaseExpand::setHeader 和 DBaseExpand::setContent 设置分别设置标题控件和内容控件。
+  Using the DBaseExpand class, you can create a controllable control with an animation effect. This control contains the upper and lower parts. The above control is the title control. This control will always display Call dbaseexpand :: setexpand to set the visibility of the content control. Use dbaseexpand :: setHeader and dbaseexpand :: SetContent to set the title control and content control respectively.
   
-  \sa DHeaderLine
+  @sa DHeaderLine
   
-  \image html DBaseExpand.gif
+  @image html DBaseExpand.gif
  */
 
 /*!
-  \fn void DBaseExpand::expandChange(bool e)
-  \brief 内容控件可见性发生改变的信号
-  \a e 为 true 表示内容控件变为了可见，反之则反
+@~english
+  @fn void DBaseExpand::expandChange(bool e)
+  @brief content control visibility signal
+  @param[in] e If "true", the content control becomes visible, but vice versa
  */
 
 /*!
-  \brief 获取 DBaseExpand::DBaseExpand 实例
-  \a parent 作为实例的父控件
+@~english
+  @brief get DBaseExpand::DBaseExpand instance
+  @param[in] parent as the parent control part of the example
  */
 DBaseExpand::DBaseExpand(QWidget *parent)
     : QWidget(parent)
@@ -132,9 +134,10 @@ DBaseExpand::~DBaseExpand()
 }
 
 /*!
-  \brief 设置标题控件
-  标题控件会始终显示在布局里
-  \a header 标题控件
+@~english
+  @brief set the title control
+  The title control will always be displayed in the layout.
+  @param[in] header title control
  */
 void DBaseExpand::setHeader(QWidget *header)
 {
@@ -153,10 +156,11 @@ void DBaseExpand::setHeader(QWidget *header)
 }
 
 /*!
-  \brief 设置内容控件
-  内容控件默认是隐藏的，调用 DBaseExpand::setExpand 设置其可见性
-  \a content 内容控件
-  \a alignment 内容控件在布局中的对齐方式
+@~english
+  @brief set the content control
+  Content control is hidden by default, call dbaseexpand :: setexpand to set its visibility.
+  @param[in] content content control
+  @param[in] alignment content control's alignment method in layout
  */
 void DBaseExpand::setContent(QWidget *content, Qt::Alignment alignment)
 {
@@ -177,8 +181,9 @@ void DBaseExpand::setContent(QWidget *content, Qt::Alignment alignment)
 }
 
 /*!
-  \brief 获取内容控件对象
-  \return 内容控件对象
+@~english
+  @brief get the content control object
+  @return content control object
  */
 
 QWidget *DBaseExpand::getContent() const
@@ -189,9 +194,10 @@ QWidget *DBaseExpand::getContent() const
 }
 
 /*!
-  \brief 设置标题控件的高度
+@~english
+  @brief set the height of the title control
   
-  \a height 指定的高度
+  @param[in] height specified height
  */
 void DBaseExpand::setHeaderHeight(int height)
 {
@@ -203,9 +209,10 @@ void DBaseExpand::setHeaderHeight(int height)
 }
 
 /*!
-  \brief 设置内容控件的可见性
+@~english
+  @brief set the visibility of the content control
   
-  \a value 为 true 则内容控件可见，反之则反
+  @param[in] value If "true", the content control is visible, otherwise, the content control is not visible.
  */
 void DBaseExpand::setExpand(bool value)
 {
@@ -231,9 +238,10 @@ void DBaseExpand::setExpand(bool value)
 }
 
 /*!
-  \brief 获取当前内容控件的可见性
+@~english
+  @brief get the visiblity of the current content control
   
-  \return 当前内容控件的可见性
+  @return visiblity of the current content control
  */
 bool DBaseExpand::expand() const
 {
@@ -242,9 +250,10 @@ bool DBaseExpand::expand() const
 }
 
 /*!
-  \brief 设置内容控件的可见性改变时动画的时间
+@~english
+  @brief set the time for the visibility of the content control
   
-  \a duration 指定动画时间
+  @param[in] duration specified animation time
  */
 void DBaseExpand::setAnimationDuration(int duration)
 {
@@ -253,9 +262,10 @@ void DBaseExpand::setAnimationDuration(int duration)
 }
 
 /*!
-  \brief 设置内容控件的可见性改变时动画的样式
+@~english
+  @brief set the visibility of the content control when the animation style is changed
   
-  \a curve 指定动画样式
+  @param[in] curve specified animation style
  */
 void DBaseExpand::setAnimationEasingCurve(QEasingCurve curve)
 {
@@ -264,9 +274,10 @@ void DBaseExpand::setAnimationEasingCurve(QEasingCurve curve)
 }
 
 /*!
-  \brief 设置是否允许标题控件与内容控件之间的分割线
+@~english
+  @brief set whether to allow the segmentation line between the title control and the content control
   
-  \a arg 为 ture 则显示分割线，反之则反
+  @param[in] arg If "true", the segmentation line is visible, otherwise, the segmentation line is not visible.
  */
 void DBaseExpand::setSeparatorVisible(bool arg)
 {
@@ -275,9 +286,10 @@ void DBaseExpand::setSeparatorVisible(bool arg)
 }
 
 /*!
-  \brief 设置是否允许内容控件下的分割线
+@~english
+  @brief set whether to allow the segmentation line under the content control
   
-  \a arg 为 ture 则显示分割线，反之则反
+  @param[in] arg If "true", the segmentation line is visible, otherwise, the segmentation line is not visible.
  */
 void DBaseExpand::setExpandedSeparatorVisible(bool arg)
 {