Changeset 63729 in vbox

Timestamp:

Sep 5, 2016 4:33:44 PM (8 years ago)

Author:

vboxsync

Message:

FE/Qt: bugref:6899: Accessibility support (step 12): Selector UI: Basic Details-view accessibility interface.

File:

• trunk/src/VBox/Frontends/VirtualBox/src/selector/graphics/details/UIGDetailsView.cpp (modified) (3 diffs)

trunk/src/VBox/Frontends/VirtualBox/src/selector/graphics/details/UIGDetailsView.cpp

@@ -21 +21 @@
 
 /* Qt includes: */
+# include <QAccessibleWidget>
 # include <QApplication>
 # include <QScrollBar>
@@ -26 +27 @@
 /* GUI includes: */
 # include "UIGDetails.h"
+# include "UIGDetailsModel.h"
 # include "UIGDetailsView.h"
+# include "UIGDetailsItem.h"
+
+/* Other VBox includes: */
+# include <iprt/assert.h>
 
 #endif /* !VBOX_WITH_PRECOMPILED_HEADERS */
+
+
+/** QAccessibleWidget extension used as an accessibility interface for Details-view. */
+class UIAccessibilityInterfaceForUIGDetailsView : public QAccessibleWidget
+{
+public:
+
+    /** Returns an accessibility interface for passed @a strClassname and @a pObject. */
+    static QAccessibleInterface *pFactory(const QString &strClassname, QObject *pObject)
+    {
+        /* Creating Details-view accessibility interface: */
+        if (pObject && strClassname == QLatin1String("UIGDetailsView"))
+            return new UIAccessibilityInterfaceForUIGDetailsView(qobject_cast<QWidget*>(pObject));
+
+        /* Null by default: */
+        return 0;
+    }
+
+    /** Constructs an accessibility interface passing @a pWidget to the base-class. */
+    UIAccessibilityInterfaceForUIGDetailsView(QWidget *pWidget)
+        : QAccessibleWidget(pWidget, QAccessible::List)
+    {}
+
+    /** Returns the number of children. */
+    virtual int childCount() const /* override */
+    {
+        /* Make sure view still alive: */
+        AssertPtrReturn(view(), 0);
+
+        /* What amount of children root has? */
+        const int cChildCount = view()->details()->model()->root()->items().size();
+
+        /* Return amount of children root has (if there are many of children): */
+        if (cChildCount > 1)
+            return cChildCount;
+
+        /* Return the number of children lone root child has (otherwise): */
+        return view()->details()->model()->root()->items().first()->items().size();
+    }
+
+    /** Returns the child with the passed @a iIndex. */
+    virtual QAccessibleInterface *child(int iIndex) const /* override */
+    {
+        /* Make sure view still alive: */
+        AssertPtrReturn(view(), 0);
+        /* Make sure index is valid: */
+        AssertReturn(iIndex >= 0 && iIndex < childCount(), 0);
+
+        /* What amount of children root has? */
+        const int cChildCount = view()->details()->model()->root()->items().size();
+
+        /* Return the root child with the passed iIndex (if there are many of children): */
+        if (cChildCount > 1)
+            return QAccessible::queryAccessibleInterface(view()->details()->model()->root()->items().at(iIndex));
+
+        /* Return the lone root child's child with the passed iIndex (otherwise): */
+        return QAccessible::queryAccessibleInterface(view()->details()->model()->root()->items().first()->items().at(iIndex));
+    }
+
+    /** Returns a text for the passed @a enmTextRole. */
+    virtual QString text(QAccessible::Text enmTextRole) const /* override */
+    {
+        /* Make sure view still alive: */
+        AssertPtrReturn(view(), QString());
+
+        /* Return view tool-tip: */
+        Q_UNUSED(enmTextRole);
+        return view()->toolTip();
+    }
+
+private:
+
+    /** Returns corresponding Details-view. */
+    UIGDetailsView *view() const { return qobject_cast<UIGDetailsView*>(widget()); }
+};
 
 
@@ -37 +118 @@
     , m_iMinimumHeightHint(0)
 {
+    /* Install Details-view accessibility interface factory: */
+    QAccessible::installFactory(UIAccessibilityInterfaceForUIGDetailsView::pFactory);
+
     /* Prepare palette: */
     preparePalette();