update

Author: Decodetalkers

components/materiallib/qtmaterialoverlaywidget.cpp

@@ -2,8 +2,8 @@
 #include <QEvent>
 
 /*!
- *  \class QtMaterialOverlayWidget
- *  \internal
+ *  @class QtMaterialOverlayWidget
+ *  @internal
  */
 
 QtMaterialOverlayWidget::QtMaterialOverlayWidget(QWidget *parent)
@@ -17,7 +17,7 @@ QtMaterialOverlayWidget::QtMaterialOverlayWidget(QWidget *parent)
 QtMaterialOverlayWidget::~QtMaterialOverlayWidget() {}
 
 /*!
- *  \reimp
+ *  @reimp
  */
 bool QtMaterialOverlayWidget::event(QEvent *event)
 {
@@ -41,7 +41,7 @@ bool QtMaterialOverlayWidget::event(QEvent *event)
 }
 
 /*!
- *  \reimp
+ *  @reimp
  */
 bool QtMaterialOverlayWidget::eventFilter(QObject *obj, QEvent *event)
 {

components/qtmaterialcircularprogress.cpp

@@ -1,11 +1,11 @@
 #include "qtmaterialcircularprogress.h"
+#include "lib/qtmaterialstyle.h"
+#include "qtmaterialcircularprogress_internal.h"
 #include "qtmaterialcircularprogress_p.h"
-#include <QPropertyAnimation>
-#include <QParallelAnimationGroup>
 #include <QPainter>
 #include <QPainterPath>
-#include "qtmaterialcircularprogress_internal.h"
-#include "lib/qtmaterialstyle.h"
+#include <QParallelAnimationGroup>
+#include <QPropertyAnimation>
 
 /*!
  *  \class QtMaterialCircularProgressPrivate
@@ -17,22 +17,19 @@ QtMaterialCircularProgressPrivate::QtMaterialCircularProgressPrivate(QtMaterialC
 {
 }
 
-QtMaterialCircularProgressPrivate::~QtMaterialCircularProgressPrivate()
-{
-}
+QtMaterialCircularProgressPrivate::~QtMaterialCircularProgressPrivate() {}
 
 void QtMaterialCircularProgressPrivate::init()
 {
     Q_Q(QtMaterialCircularProgress);
 
-    delegate       = new QtMaterialCircularProgressDelegate(q);
-    progressType   = Material::IndeterminateProgress;
-    penWidth       = 6.25;
-    size           = 64;
+    delegate = new QtMaterialCircularProgressDelegate(q);
+    progressType = Material::IndeterminateProgress;
+    penWidth = 6.25;
+    size = 64;
     useThemeColors = true;
 
-    q->setSizePolicy(QSizePolicy(QSizePolicy::MinimumExpanding,
-                                 QSizePolicy::MinimumExpanding));
+    q->setSizePolicy(QSizePolicy(QSizePolicy::MinimumExpanding, QSizePolicy::MinimumExpanding));
 
     QParallelAnimationGroup *group = new QParallelAnimationGroup(q);
     group->setLoopCount(-1);
@@ -82,15 +79,13 @@ void QtMaterialCircularProgressPrivate::init()
  */
 
 QtMaterialCircularProgress::QtMaterialCircularProgress(QWidget *parent)
-    : QProgressBar(parent),
-      d_ptr(new QtMaterialCircularProgressPrivate(this))
+    : QProgressBar(parent)
+    , d_ptr(new QtMaterialCircularProgressPrivate(this))
 {
     d_func()->init();
 }
 
-QtMaterialCircularProgress::~QtMaterialCircularProgress()
-{
-}
+QtMaterialCircularProgress::~QtMaterialCircularProgress() {}
 
 void QtMaterialCircularProgress::setProgressType(Material::ProgressType type)
 {
@@ -186,7 +181,7 @@ QSize QtMaterialCircularProgress::sizeHint() const
 {
     Q_D(const QtMaterialCircularProgress);
 
-    const qreal s = d->size+d->penWidth+8;
+    const qreal s = d->size + d->penWidth + 8;
     return QSize(s, s);
 }
 
@@ -202,21 +197,19 @@ void QtMaterialCircularProgress::paintEvent(QPaintEvent *event)
     QPainter painter(this);
     painter.setRenderHint(QPainter::Antialiasing);
 
-    if (!isEnabled())
-    {
+    if (!isEnabled()) {
         QPen pen;
         pen.setCapStyle(Qt::RoundCap);
         pen.setWidthF(d->penWidth);
         pen.setColor(QtMaterialStyle::instance().themeColor("border"));
         painter.setPen(pen);
-        painter.drawLine(rect().center()-QPointF(20, 20), rect().center()+QPointF(20, 20));
-        painter.drawLine(rect().center()+QPointF(20, -20), rect().center()-QPointF(20, -20));
+        painter.drawLine(rect().center() - QPointF(20, 20), rect().center() + QPointF(20, 20));
+        painter.drawLine(rect().center() + QPointF(20, -20), rect().center() - QPointF(20, -20));
         return;
     }
 
-    if (Material::IndeterminateProgress == d->progressType)
-    {
-        painter.translate(width()/2.0, height()/2.0);
+    if (Material::IndeterminateProgress == d->progressType) {
+        painter.translate(width() / 2.0, height() / 2.0);
         painter.rotate(d->delegate->angle());
     }
 
@@ -225,26 +218,23 @@ void QtMaterialCircularProgress::paintEvent(QPaintEvent *event)
     pen.setWidthF(d->penWidth);
     pen.setColor(color());
 
-    if (Material::IndeterminateProgress == d->progressType)
-    {
+    if (Material::IndeterminateProgress == d->progressType) {
         QVector<qreal> pattern;
-        pattern << d->delegate->dashLength()*d->size/50 << 30.0*d->size/50;
+        pattern << d->delegate->dashLength() * d->size / 50 << 30.0 * d->size / 50;
 
-        pen.setDashOffset(d->delegate->dashOffset()*d->size/50);
+        pen.setDashOffset(d->delegate->dashOffset() * d->size / 50);
         pen.setDashPattern(pattern);
 
         painter.setPen(pen);
 
-        painter.drawEllipse(QPoint(0, 0), d->size/2, d->size/2);
-    }
-    else
-    {
+        painter.drawEllipse(QPoint(0, 0), d->size / 2, d->size / 2);
+    } else {
         painter.setPen(pen);
 
-        const qreal x = (width()-d->size)/2.0;
-        const qreal y = (height()-d->size)/2.0;
+        const qreal x = (width() - d->size) / 2.0;
+        const qreal y = (height() - d->size) / 2.0;
 
-        const qreal a = 360.0*(value()-minimum())/(maximum()-minimum());
+        const qreal a = 360.0 * (value() - minimum()) / (maximum() - minimum());
 
         QPainterPath path;
         path.arcMoveTo(x, y, d->size, d->size, 0);

components/qtmaterialdialog.cpp

@@ -11,8 +11,8 @@
 #include <QtWidgets/QStackedLayout>
 
 /*!
- *  \class QtMaterialDialogPrivate
- *  \internal
+ *  @class QtMaterialDialogPrivate
+ *  @internal
  */
 
 QtMaterialDialogPrivate::QtMaterialDialogPrivate(QtMaterialDialog *q)
@@ -22,22 +22,26 @@ QtMaterialDialogPrivate::QtMaterialDialogPrivate(QtMaterialDialog *q)
 
 QtMaterialDialogPrivate::~QtMaterialDialogPrivate() {}
 
+// main
 void QtMaterialDialogPrivate::init()
 {
+    // get public class
     Q_Q(QtMaterialDialog);
 
     dialogWindow = new QtMaterialDialogWindow(q);
     proxyStack = new QStackedLayout;
     stateMachine = new QStateMachine(q);
     proxy = new QtMaterialDialogProxy(dialogWindow, proxyStack, q);
 
+    // qvbox
     QVBoxLayout *layout = new QVBoxLayout;
     q->setLayout(layout);
 
     QWidget *widget = new QWidget;
     widget->setLayout(proxyStack);
     widget->setMinimumWidth(400);
 
+    // shadoweffect
     QGraphicsDropShadowEffect *effect = new QGraphicsDropShadowEffect;
     effect->setColor(QColor(0, 0, 0, 200));
     effect->setBlurRadius(64);
@@ -100,7 +104,7 @@ void QtMaterialDialogPrivate::init()
 }
 
 /*!
- *  \class QtMaterialDialog
+ *  @class QtMaterialDialog
  */
 
 QtMaterialDialog::QtMaterialDialog(QWidget *parent)
@@ -143,6 +147,7 @@ void QtMaterialDialog::hideDialog()
     d->proxyStack->setCurrentIndex(1);
 }
 
+// just paint shadow
 void QtMaterialDialog::paintEvent(QPaintEvent *event)
 {
     Q_UNUSED(event)

components/qtmaterialdialog_internal.cpp

@@ -6,8 +6,8 @@
 #include <QtWidgets/QStackedLayout>
 
 /*!
- *  \class QtMaterialDialogProxy
- *  \internal
+ *  @class QtMaterialDialogProxy
+ *  @internal
  */
 
 QtMaterialDialogProxy::QtMaterialDialogProxy(QtMaterialDialogWindow *source,
@@ -80,8 +80,8 @@ void QtMaterialDialogProxy::paintEvent(QPaintEvent *event)
 }
 
 /*!
- *  \class QtMaterialDialogWindow
- *  \internal
+ *  @class QtMaterialDialogWindow
+ *  @internal
  */
 
 QtMaterialDialogWindow::QtMaterialDialogWindow(QtMaterialDialog *dialog, QWidget *parent)

components/qtmaterialdrawer.cpp

@@ -11,25 +11,25 @@
 #include <QtWidgets/QVBoxLayout>
 
 /*!
- *  \class QtMaterialDrawerPrivate
- *  \internal
+ *  @class QtMaterialDrawerPrivate
+ *  @internal
  */
 
 /*!
- *  \internal
+ *  @internal
  */
 QtMaterialDrawerPrivate::QtMaterialDrawerPrivate(QtMaterialDrawer *q)
     : q_ptr(q)
 {
 }
 
 /*!
- *  \internal
+ *  @internal
  */
 QtMaterialDrawerPrivate::~QtMaterialDrawerPrivate() {}
 
 /*!
- *  \internal
+ *  @internal
  */
 void QtMaterialDrawerPrivate::init()
 {
@@ -57,7 +57,7 @@ void QtMaterialDrawerPrivate::init()
 }
 
 /*!
- *  \class QtMaterialDrawer
+ *  @class QtMaterialDrawer
  */
 
 QtMaterialDrawer::QtMaterialDrawer(QWidget *parent)
@@ -158,9 +158,10 @@ void QtMaterialDrawer::openDrawer()
 void QtMaterialDrawer::closeDrawer()
 {
     Q_D(QtMaterialDrawer);
-
+    // emit signal to close
     emit d->stateMachine->signalClose();
 
+    // reset the attribute
     if (d->overlay) {
         setAttribute(Qt::WA_TransparentForMouseEvents);
         setAttribute(Qt::WA_NoSystemBackground);
@@ -184,6 +185,7 @@ bool QtMaterialDrawer::event(QEvent *event)
     return QtMaterialOverlayWidget::event(event);
 }
 
+// size
 bool QtMaterialDrawer::eventFilter(QObject *obj, QEvent *event)
 {
     Q_D(QtMaterialDrawer);
@@ -192,7 +194,9 @@ bool QtMaterialDrawer::eventFilter(QObject *obj, QEvent *event)
         case QEvent::MouseButtonPress: {
             QMouseEvent *mouseEvent;
             if ((mouseEvent = static_cast<QMouseEvent *>(event))) {
+                // check canClose
                 const bool canClose = d->clickToClose || d->overlay;
+                // auto close location
                 if (!d->widget->geometry().contains(mouseEvent->pos()) && canClose) {
                     closeDrawer();
                 }
@@ -222,6 +226,7 @@ void QtMaterialDrawer::paintEvent(QPaintEvent *event)
     if (!d->overlay || d->stateMachine->isInClosedState()) {
         return;
     }
+    // shadow
     QPainter painter(this);
     painter.setOpacity(d->stateMachine->opacity());
     painter.fillRect(rect(), Qt::SolidPattern);

components/qtmaterialdrawer_internal.cpp

@@ -7,8 +7,8 @@
 #include <QtWidgets/QLayout>
 
 /*!
- *  \class QtMaterialDrawerStateMachine
- *  \internal
+ *  @class QtMaterialDrawerStateMachine
+ *  @internal
  */
 
 QtMaterialDrawerStateMachine::QtMaterialDrawerStateMachine(QtMaterialDrawerWidget *drawer, QtMaterialDrawer *parent)