Changeset 64477 in vbox for trunk/src/VBox/Frontends

Timestamp:

Oct 28, 2016 3:57:24 PM (8 years ago)

Author:

vboxsync

Message:

FE/Qt: bugref:6899: Accessibility support (step 106): Basic QITreeView accessibility interface.

File:

• trunk/src/VBox/Frontends/VirtualBox/src/extensions/QITreeView.cpp (modified) (3 diffs)

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

@@ -21 +21 @@
 
 /* Qt includes: */
+# include <QAccessibleWidget>
 # include <QMouseEvent>
 # include <QPainter>
@@ -27 +28 @@
 # include "QITreeView.h"
 
+/* Other VBox includes: */
+# include "iprt/assert.h"
+
 #endif /* !VBOX_WITH_PRECOMPILED_HEADERS */
+
+
+/** QAccessibleWidget extension used as an accessibility interface for QITreeView. */
+class QIAccessibilityInterfaceForQITreeView : public QAccessibleWidget
+{
+public:
+
+    /** Returns an accessibility interface for passed @a strClassname and @a pObject. */
+    static QAccessibleInterface *pFactory(const QString &strClassname, QObject *pObject)
+    {
+        /* Creating QITreeView accessibility interface: */
+        if (pObject && strClassname == QLatin1String("QITreeView"))
+            return new QIAccessibilityInterfaceForQITreeView(qobject_cast<QWidget*>(pObject));
+
+        /* Null by default: */
+        return 0;
+    }
+
+    /** Constructs an accessibility interface passing @a pWidget to the base-class. */
+    QIAccessibilityInterfaceForQITreeView(QWidget *pWidget)
+        : QAccessibleWidget(pWidget, QAccessible::List)
+    {}
+
+    /** Returns the number of children. */
+    virtual int childCount() const /* override */;
+    /** Returns the child with the passed @a iIndex. */
+    virtual QAccessibleInterface *child(int iIndex) const /* override */;
+    /** Returns the index of the passed @a pChild. */
+    virtual int indexOfChild(const QAccessibleInterface *pChild) const /* override */;
+
+    /** Returns a text for the passed @a enmTextRole. */
+    virtual QString text(QAccessible::Text enmTextRole) const /* override */;
+
+private:
+
+    /** Returns corresponding QITreeView. */
+    QITreeView *tree() const { return qobject_cast<QITreeView*>(widget()); }
+};
+
+
+/*********************************************************************************************************************************
+*   Class QIAccessibilityInterfaceForQITreeView implementation.                                                                  *
+*********************************************************************************************************************************/
+
+int QIAccessibilityInterfaceForQITreeView::childCount() const
+{
+    /* Make sure tree still alive: */
+    AssertPtrReturn(tree(), 0);
+
+    /* Return the number of children: */
+    return tree()->childCount();
+}
+
+QAccessibleInterface *QIAccessibilityInterfaceForQITreeView::child(int iIndex) const
+{
+    /* Make sure tree still alive: */
+    AssertPtrReturn(tree(), 0);
+    /* Make sure index is valid: */
+    AssertReturn(iIndex >= 0 && iIndex < childCount(), 0);
+
+    /* Return the child with the passed iIndex: */
+    return QAccessible::queryAccessibleInterface(tree()->childItem(iIndex));
+}
+
+int QIAccessibilityInterfaceForQITreeView::indexOfChild(const QAccessibleInterface *pChild) const
+{
+    /* Search for corresponding child: */
+    for (int i = 0; i < childCount(); ++i)
+        if (child(i) == pChild)
+            return i;
+
+    /* -1 by default: */
+    return -1;
+}
+
+QString QIAccessibilityInterfaceForQITreeView::text(QAccessible::Text /* enmTextRole */) const
+{
+    /* Make sure tree still alive: */
+    AssertPtrReturn(tree(), QString());
+
+    /* Return tree whats-this: */
+    return tree()->whatsThis();
+}
 
 
@@ -140 +227 @@
 void QITreeView::prepare()
 {
+    /* Install QITreeView accessibility interface factory: */
+    QAccessible::installFactory(QIAccessibilityInterfaceForQITreeView::pFactory);
+
     /* Mark header hidden: */
     setHeaderHidden(true);