Changeset 51813 in vbox

Timestamp:

Jul 2, 2014 2:17:56 PM (11 years ago)

Author:

vboxsync

Message:

FE/Qt: Widget Validation Framework: Extending framework with classes which able to validate QObject groups.

Location:

trunk/src/VBox/Frontends/VirtualBox/src/extensions

Files:

• QIWidgetValidator.cpp (modified) (1 diff)
• QIWidgetValidator.h (modified) (1 diff)

trunk/src/VBox/Frontends/VirtualBox/src/extensions/QIWidgetValidator.cpp

@@ -18 +18 @@
  */
 
+/* GUI includes: */
 #include "QIWidgetValidator.h"
+#include "UISettingsPage.h"
 
-/* GUI includes: */
-#include "UISettingsPage.h"
+
+QObjectValidator::QObjectValidator(QValidator *pValidator, QObject *pParent /* = 0 */)
+    : QObject(pParent)
+    , m_pValidator(pValidator)
+    , m_state(QValidator::Invalid)
+{
+    /* Prepare: */
+    prepare();
+}
+
+void QObjectValidator::sltValidate(QString strInput /* = QString() */)
+{
+    /* Make sure validator assigned: */
+    AssertPtrReturnVoid(m_pValidator);
+
+    /* Validate: */
+    int iPosition = 0;
+    const QValidator::State state = m_pValidator->validate(strInput, iPosition);
+
+    /* If validity state changed: */
+    if (m_state != state)
+    {
+        /* Update last validity state: */
+        m_state = state;
+
+        /* Notifies listener(s) about validity change: */
+        emit sigValidityChange(m_state);
+    }
+}
+
+void QObjectValidator::prepare()
+{
+    /* Make sure validator assigned: */
+    AssertPtrReturnVoid(m_pValidator);
+
+    /* Register validator as child: */
+    m_pValidator->setParent(this);
+
+    /* Validate: */
+    sltValidate();
+}
+
+
+QObjectValidatorGroup::QObjectValidatorGroup(QObject *pParent)
+    : QObject(pParent)
+    , m_fResult(false)
+{
+}
+
+void QObjectValidatorGroup::addObjectValidator(QObjectValidator *pObjectValidator)
+{
+    /* Make sure object-validator passed: */
+    AssertPtrReturnVoid(pObjectValidator);
+
+    /* Register object-validator as child: */
+    pObjectValidator->setParent(this);
+
+    /* Insert object-validator to internal map: */
+    m_group.insert(pObjectValidator, toResult(pObjectValidator->state()));
+
+    /* Attach object-validator to group: */
+    connect(pObjectValidator, SIGNAL(sigValidityChange(QValidator::State)),
+            this, SLOT(sltValidate(QValidator::State)));
+}
+
+void QObjectValidatorGroup::sltValidate(QValidator::State state)
+{
+    /* Determine sender object-validator: */
+    QObjectValidator *pObjectValidatorSender = qobject_cast<QObjectValidator*>(sender());
+    /* Make sure that is one of our senders: */
+    AssertReturnVoid(pObjectValidatorSender && m_group.contains(pObjectValidatorSender));
+
+    /* Update internal map: */
+    m_group[pObjectValidatorSender] = toResult(state);
+
+    /* Enumerate all the registered object-validators: */
+    bool fResult = true;
+    foreach (QObjectValidator *pObjectValidator, m_group.keys())
+        if (!toResult(pObjectValidator->state()))
+        {
+            fResult = false;
+            break;
+        }
+
+    /* If validity state changed: */
+    if (m_fResult != fResult)
+    {
+        /* Update last validity state: */
+        m_fResult = fResult;
+
+        /* Notifies listener(s) about validity change: */
+        emit sigValidityChange(m_fResult);
+    }
+}
+
+/* static */
+bool QObjectValidatorGroup::toResult(QValidator::State state)
+{
+    return state == QValidator::Acceptable;
+}
 
 

trunk/src/VBox/Frontends/VirtualBox/src/extensions/QIWidgetValidator.h

@@ -31 +31 @@
 /* Forward declarations: */
 class UISettingsPage;
+
+/** QObject reimplementation,
+  * providing passed QObject with validation routine. */
+class QObjectValidator : public QObject
+{
+    Q_OBJECT;
+
+signals:
+
+    /** Notifies listener(s) about validity change. */
+    void sigValidityChange(QValidator::State state);
+
+public:
+
+    /** Constructor.
+      * @param pParent    is passed on to the QObject constructor,
+      * @param pValidator is passed on to the OObject children
+      *                   and used to perform validation itself. */
+    QObjectValidator(QValidator *pValidator, QObject *pParent = 0);
+
+    /** Returns last validation state. */
+    QValidator::State state() const { return m_state; }
+
+private slots:
+
+    /** Performs validation: */
+    void sltValidate(QString strInput = QString());
+
+private:
+
+    /** Prepare routine. */
+    void prepare();
+
+    /** Holds validator. */
+    QValidator *m_pValidator;
+    /** Holds validation state. */
+    QValidator::State m_state;
+};
+
+/** QObject reimplementation,
+  * which can group various QObjectValidator instances to operate on. */
+class QObjectValidatorGroup : public QObject
+{
+    Q_OBJECT;
+
+signals:
+
+    /** Notifies listener(s) about validity change. */
+    void sigValidityChange(bool fValid);
+
+public:
+
+    /** Constructor.
+      * @param pParent is passed on to the QObject constructor. */
+    QObjectValidatorGroup(QObject *pParent);
+
+    /** Adds object-validator.
+      * @note The ownership of @a pObjectValidator is transferred to the group,
+      *       and it's the group's responsibility to delete it. */
+    void addObjectValidator(QObjectValidator *pObjectValidator);
+
+    /** Returns last validation result. */
+    bool result() const { return m_fResult; }
+
+private slots:
+
+    /** Performs validation: */
+    void sltValidate(QValidator::State state);
+
+private:
+
+    /** Converts QValidator::State to bool result. */
+    static bool toResult(QValidator::State state);
+
+    /** Holds object-validators and their states. */
+    QMap<QObjectValidator*, bool> m_group;
+    /** Holds validation result. */
+    bool m_fResult;
+};
 
 /* Page validator prototype: */