From 6677c2175d8118e54f3cc00e2a604ac61317e192 Mon Sep 17 00:00:00 2001 From: syn <1296770454@qq.com> Date: Wed, 5 Jul 2023 16:41:47 +0800 Subject: [PATCH] doc: update docs for dspinbox MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 更新dspinbox的文档,添加示例代码及运行图片 Log: update docs Issue: https://github.com/linuxdeepin/dtk/issues/94 --- docs/images/DSpinBox_example.png | Bin 0 -> 7641 bytes docs/widgets/dspinbox.zh_CN.dox | 101 +++++++++++++++++++++++++-- src/widgets/dspinbox.cpp | 116 ++++++++++++++----------------- 3 files changed, 150 insertions(+), 67 deletions(-) create mode 100644 docs/images/DSpinBox_example.png diff --git a/docs/images/DSpinBox_example.png b/docs/images/DSpinBox_example.png new file mode 100644 index 0000000000000000000000000000000000000000..dbbf80749561ee6b10ae740a05de6291fd03f28e GIT binary patch literal 7641 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 NxQvo?siaB3zW~PMlQ#eW literal 0 HcmV?d00001 diff --git a/docs/widgets/dspinbox.zh_CN.dox b/docs/widgets/dspinbox.zh_CN.dox index f0560daa7..832b3f913 100644 --- a/docs/widgets/dspinbox.zh_CN.dox +++ b/docs/widgets/dspinbox.zh_CN.dox @@ -2,11 +2,104 @@ @~chinese @file dspinbox.h @ingroup edit -@class -@brief -@details -TODO: 添加类简介、示例代码、示例截图和函数使用说明等 +@class Dtk::Widget::DSpinBox +@brief deepin风格的QSpinBox. +@details 类似 DLineEdit ，这个控件也提供了警告功能，用于提醒用户当前输入的数据不正确，另外，还可以设置一个默认的值，并在默认值发生改变时发出信号。 +### 示例代码 +#### main.cpp +```cpp +#include +#include +#include +#include +DWIDGET_USE_NAMESPACE + +int main(int argc, char *argv[]) +{ + DApplication app(argc, argv); + DMainWindow window; + window.setMinimumSize(QSize(300, 200)); + + QWidget *centralWidget = new QWidget(&window); + QVBoxLayout *layout = new QVBoxLayout(centralWidget); + + DSpinBox normalSpinBox; // 正常状态的控件 + normalSpinBox.setDefaultValue(50); // 设置默认值 + layout->addWidget(&normalSpinBox); + + DSpinBox warningSpinBox; // 警告状态的控件 + warningSpinBox.setAlert(true); // 设置警告状态 + layout->addWidget(&warningSpinBox); + warningSpinBox.showAlertMessage("这是一个警告消息！",5000);// 添加警告消息,5秒后消失 + + window.setCentralWidget(centralWidget); + window.show(); + + return app.exec(); +} +``` +### 示例图片 +如下图上面的是正常状态的控件, 下面的是处于警告状态的控件: +@image html DSpinBox_example.png + +@fn void DSpinBox::alertChanged(bool alert) +@brief 警告状态发生了变化 +@param[in] alert 当前的警告状态 + +@fn void DSpinBox::defaultValueChanged(int defaultValue) +@brief 默认值发生了变化 +@param[in] defaultValue 控件的默认值 + +@fn DSpinBox::DSpinBox(QWidget *parent) :QSpinBox(parent),DObject(*new DSpinBoxPrivate(this)) +@brief 构造一个 DSpinBox 实例 +@param[in] parent 作为该实例的父控件，传入 QSpinBox 构造函数 + +@fn QLineEdit *DSpinBox::lineEdit() const +@brief 获取输入框控件 +@return 返回正在使用的输入库控件对象 + +@property DSpinBox::alert +@brief 表示当前控件是否处于警告状态的属性 + +@fn bool DSpinBox::isAlert() const +@brief 表示当前控件是否处于警告状态的属性 +使用 DSpinBox::isAlert 获取属性当前状态，使用 DSpinBox::setAlert 设置属性的状态 +@return 当前状态处于警告状态，返回 true,否则返回 false + +@fn void DSpinBox::showAlertMessage(const QString &text, int duration) +@brief 显示指定的文本消息，超过指定时间后警告消息消失 +@param[in] text 警告的文本 +@param[in] duration 显示的时间长度，单位毫秒 + +@fn void DSpinBox::showAlertMessage(const QString &text, QWidget *follower, int duration) +@brief 显示指定的文本消息，超过指定时间后警告消息消失 +@param[in] text 警告的文本 +@param[in] follower 指定文本消息跟随的对象 +@param[in] duration 显示的时间长度，单位毫秒 + +@fn int DSpinBox::defaultValue() const +@brief 控件的默认值 +使用 DSpinBox::defaultValue 获取默认值 + +@fn void DSpinBox::setDefaultValue(int defaultValue) +@brief 设置控件的默认值 +使用 DSpinBox::setDefaultValue 设置默认值, 点击控件上的 reset 按钮会设置为此值 + +@class Dtk::Widget::DDoubleSpinBox +@brief 类似 DDoubleSpinBox + +@fn void DDoubleSpinBox::showAlertMessage(const QString &text, int duration) +@brief 显示指定的文本消息，超过指定时间后警告消息消失 +@param[in] text 警告的文本 +@param[in] duration 显示的时间长度，单位毫秒 + +@fn void DDoubleSpinBox::showAlertMessage(const QString &text, QWidget *follower, int duration) +@brief 显示指定的文本消息，超过指定时间后警告消息消失 +@param[in] text 警告的文本 +@param[in] follower 指定文本消息跟随的对象 +@param[in] duration 显示的时间长度，单位毫秒 */ + diff --git a/src/widgets/dspinbox.cpp b/src/widgets/dspinbox.cpp index a276934d3..08543636b 100644 --- a/src/widgets/dspinbox.cpp +++ b/src/widgets/dspinbox.cpp @@ -28,43 +28,35 @@ void DSpinBoxPrivate::init() } /*! - \class Dtk::Widget::DSpinBox - \inmodule dtkwidget - - \brief Deepin风格的QSpinBox. - \brief The DSpinBox class provides deepin style QSpinBox. - - 类似 DLineEdit ，这个控件也提供了警告功能，用于提醒用户当前输入的数据不正确，另外，还可以设置一个默认的值，并在默认值发生改变时发出信号。 - 如下图上面的是正常状态的控件, 下面的是处于警告状态的控件: - Like DLineEdit, this widget can be set on alert to warn the user that the - input is not correct. In addition, there's a DSpinBox::defaultValue property - can be used to set a default value on the widget. - - \image html DSpinBox.png +@~english + @class Dtk::Widget::DSpinBox + @inmodule dtkwidget + @brief The DSpinBox class provides deepin style QSpinBox. + Like DLineEdit, this widget can be set on alert to warn the user that the input is not correct. In addition, there's a DSpinBox::defaultValue property can be used to set a default value on the widget. + As shown in the figure below, the upper is normal state widget and the lower is a warning state widget: + @image html DSpinBox.png */ // ========================SIGNAL START======================== /*! - \fn void DSpinBox::alertChanged(bool alert) - \brief 警告状态发生了变化. - - \a alert 当前的警告状态。 +@~english + @fn void DSpinBox::alertChanged(bool alert) + @brief The warning state has changed. + @param[in] alert current warning state */ /*! - \fn void DSpinBox::defaultValueChanged(int defaultValue) - \brief 默认值发生了变化. - - \a defaultValue 控件的默认值。 +@~english + @fn void DSpinBox::defaultValueChanged(int defaultValue) + @brief The default value has changed. + @param[in] defaultValue default value of widget */ // ========================SIGNAL END======================== /*! - \brief 构造一个 DSpinBox 实例。 - \brief DSpinBox::DSpinBox constructs an instance of DSpinBox - - \a parent 作为该实例的父控件。 - \a parent is passed to QSpinBox constructor +@~english + @brief DSpinBox::DSpinBox construct an instance of DSpinBox + @param[in] parent passed to QSpinBox constructor */ DSpinBox::DSpinBox(QWidget *parent) : QSpinBox(parent), @@ -74,10 +66,9 @@ DSpinBox::DSpinBox(QWidget *parent) : } /*! - \brief 获取输入框控件。 - - \return 返回正在使用的输入库控件对象。 - \return the QLineEdit used by this spin box. +@~english + @brief get the input line widget + @return the QLineEdit used by this spin box */ QLineEdit *DSpinBox::lineEdit() const { @@ -85,17 +76,16 @@ QLineEdit *DSpinBox::lineEdit() const } /*! - \property DSpinBox::alert - - \brief This property holds whether the widget on alert mode. +@~english + @property DSpinBox::alert + @brief This property holds whether the widget on alert mode. */ /*! - \brief 表示当前控件是否处于警告状态的属性. - - 使用 DSpinBox::isAlert 获取属性当前状态，使用 DSpinBox::setAlert 设置属性的状态。 - - \return 当前状态处于警告状态，返回 true，否则返回 false. +@~english + @brief It means whether the current widget is on alert mode. + Use DSpinBox::isAlert to get the current state of the property, use DSpinBox::setAlert to set the state of the property. + @return If the current state is warning, return true, otherwise, return false. */ bool DSpinBox::isAlert() const { @@ -105,10 +95,10 @@ bool DSpinBox::isAlert() const } /*! - \brief 显示指定的文本消息，超过指定时间后警告消息消失. - - \a text text警告的文本 - \a duration 显示的时间长度，单位毫秒 +@~english + @brief Display the specified text message and the warning message will disappear if time out. + @param[in] text warning text + @param[in] duration show the length of time, unit in millisecond */ void DSpinBox::showAlertMessage(const QString &text, int duration) { @@ -118,11 +108,11 @@ void DSpinBox::showAlertMessage(const QString &text, int duration) } /*! - \brief 显示指定的文本消息，超过指定时间后警告消息消失. - - \a text text警告的文本 - \a follower 指定文本消息跟随的对象 - \a duration 显示的时间长度，单位毫秒 +@~english + @brief Display the specified text message and the warning message will disappear if time out. + @param[in] text warning text + @param[in] follower object of the text message + @param[in] duration show the length of time, unit in millisecond */ void DSpinBox::showAlertMessage(const QString &text, QWidget *follower, int duration) { @@ -132,9 +122,9 @@ void DSpinBox::showAlertMessage(const QString &text, QWidget *follower, int dura } /*! - \brief 这个属性的值是控件的默认值。 - - 使用 DSpinBox::defaultValue 获取默认值，使用 DSpinBox::setDefaultValue 设置默认值, 点击控件上的 reset 按钮会设置为此值。 +@~english + @brief default value of widget + Use DSpinBox::defaultValue to get the default value, use DSpinBox::setDefaultValue to set the default value, click the Reset button on the widget to set it to this value. */ #if DTK_VERSION < DTK_VERSION_CHECK(6, 0, 0, 0) int DSpinBox::defaultValue() const @@ -179,10 +169,10 @@ void DDoubleSpinBoxPrivate::init() } /*! - \class Dtk::Widget::DDoubleSpinBox - \inmodule dtkwidget - - \brief 类似 DDoubleSpinBox. +@~english + @class Dtk::Widget::DDoubleSpinBox + @inmodule dtkwidget + @brief like DDoubleSpinBox */ DDoubleSpinBox::DDoubleSpinBox(QWidget *parent) : @@ -200,10 +190,10 @@ bool DDoubleSpinBox::isAlert() const } /*! - \brief 显示指定的文本消息，超过指定时间后警告消息消失. - - \a text text警告的文本 - \a duration 显示的时间长度，单位毫秒 +@~english + @brief Display the specified text message and the warning message will disappear if time out. + @param[in] text warning text + @param[in] duration show the length of time, unit in millisecond */ void DDoubleSpinBox::showAlertMessage(const QString &text, int duration) { @@ -213,11 +203,11 @@ void DDoubleSpinBox::showAlertMessage(const QString &text, int duration) } /*! - \brief 显示指定的文本消息，超过指定时间后警告消息消失. - - \a text text警告的文本 - \a follower 指定文本消息跟随的对象 - \a duration 显示的时间长度，单位毫秒 +@~english + @brief Display the specified text message and the warning message will disappear if time out. + @param[in] text warning text + @param[in] follower object of the text message + @param[in] duration show the length of time, unit in millisecond */ void DDoubleSpinBox::showAlertMessage(const QString &text, QWidget *follower, int duration) {