Changeset 63699 in vbox

Timestamp:

Sep 2, 2016 1:15:58 PM (8 years ago)

Author:

vboxsync

Message:

FE/Qt: bugref:6899: Accessibility support (step 5): Selector UI: Basic Chooser-view item accessibility interface.

File:

• trunk/src/VBox/Frontends/VirtualBox/src/selector/graphics/chooser/UIGChooserItem.cpp (modified) (4 diffs)

trunk/src/VBox/Frontends/VirtualBox/src/selector/graphics/chooser/UIGChooserItem.cpp

@@ -21 +21 @@
 
 /* Qt includes: */
+# include <QAccessibleObject>
 # include <QApplication>
 # include <QStyle>
@@ -33 +34 @@
 
 /* GUI includes: */
+# include "UIGChooser.h"
 # include "UIGChooserItem.h"
+# include "UIGChooserView.h"
 # include "UIGChooserModel.h"
 # include "UIGChooserItemGroup.h"
@@ -39 +42 @@
 
 #endif /* !VBOX_WITH_PRECOMPILED_HEADERS */
+
+
+/** QAccessibleObject extension used as an accessibility interface for Chooser-view items. */
+class UIAccessibilityInterfaceForUIGChooserItem : public QAccessibleObject
+{
+public:
+
+    /** Returns an accessibility interface for passed @a strClassname and @a pObject. */
+    static QAccessibleInterface* pFactory(const QString &strClassname, QObject *pObject)
+    {
+        /* Creating Chooser-view accessibility interface: */
+        if (pObject && strClassname == QLatin1String("UIGChooserItem"))
+            return new UIAccessibilityInterfaceForUIGChooserItem(pObject);
+
+        /* Null by default: */
+        return 0;
+    }
+
+    /** Constructs an accessibility interface passing @a pObject to the base-class. */
+    UIAccessibilityInterfaceForUIGChooserItem(QObject *pObject)
+        : QAccessibleObject(pObject)
+    {}
+
+    /** Returns the parent. */
+    virtual QAccessibleInterface* parent() const /* override */
+    {
+        /* Make sure item still alive: */
+        AssertPtrReturn(item(), 0);
+
+        /* Return the parent: */
+        return QAccessible::queryAccessibleInterface(item()->model()->chooser()->view());
+    }
+
+    /** Returns the number of children. */
+    virtual int childCount() const /* override */
+    {
+        /* Make sure item still alive: */
+        AssertPtrReturn(item(), 0);
+
+        /* Return the number of group children: */
+        if (item()->type() == UIGChooserItemType_Group)
+            return item()->items().size();
+
+        /* Zero by default: */
+        return 0;
+    }
+
+    /** Returns the child with the passed @a iIndex. */
+    virtual QAccessibleInterface *child(int iIndex) const /* override */
+    {
+        /* Make sure item still alive: */
+        AssertPtrReturn(item(), 0);
+
+        /* Make sure index is valid: */
+        if (iIndex < childCount())
+            return QAccessible::queryAccessibleInterface(item()->items().at(iIndex));
+
+        /* Null by default: */
+        return 0;
+    }
+
+    /** Returns the index of the passed @a pChild. */
+    virtual int indexOfChild(const QAccessibleInterface *pChild) const /* override */
+    {
+        /* Search for corresponding child: */
+        for (int i = 0; i < childCount(); ++i)
+            if (child(i) == pChild)
+                return i;
+
+        /* -1 by default: */
+        return -1;
+    }
+
+    /** Returns the rect. */
+    virtual QRect rect() const /* override */
+    {
+        /* Now goes the mapping: */
+        const QSize   itemSize         = item()->size().toSize();
+        const QPointF itemPosInScene   = item()->mapToScene(QPointF(0, 0));
+        const QPoint  itemPosInView    = item()->model()->chooser()->view()->mapFromScene(itemPosInScene);
+        const QPoint  itemPosInScreen  = item()->model()->chooser()->view()->mapToGlobal(itemPosInView);
+        const QRect   itemRectInScreen = QRect(itemPosInScreen, itemSize);
+        return itemRectInScreen;
+    }
+
+    /** Returns a text for the passed @a enmTextRole. */
+    virtual QString text(QAccessible::Text enmTextRole) const /* override */
+    {
+        /* Make sure item still alive: */
+        AssertPtrReturn(item(), QString());
+
+        switch (enmTextRole)
+        {
+            case QAccessible::Name:        return item()->name();
+            case QAccessible::Description: return item()->description();
+            default: break;
+        }
+
+        /* Null-string by default: */
+        return QString();
+    }
+
+    /** Returns the role. */
+    virtual QAccessible::Role role() const /* override */
+    {
+        /* Make sure item still alive: */
+        AssertPtrReturn(item(), QAccessible::NoRole);
+
+        /* Return the number of group children: */
+        if (item()->type() == UIGChooserItemType_Group)
+            return QAccessible::List;
+
+        /* ListItem by default: */
+        return QAccessible::ListItem;
+    }
+
+    /** Returns the state. */
+    virtual QAccessible::State state() const /* override */
+    {
+        /* Make sure item still alive: */
+        AssertPtrReturn(item(), QAccessible::State());
+
+        /* Compose/return the state: */
+        QAccessible::State state;
+        state.focusable = true;
+        state.selectable = true;
+        if (item() && item() == item()->model()->currentItem())
+        {
+            state.active = true;
+            state.focused = true;
+            state.selected = true;
+        }
+        return state;
+    }
+
+private:
+
+    /** Returns corresponding Chooser-view item. */
+    UIGChooserItem* item() const { return qobject_cast<UIGChooserItem*>(object()); }
+};
 
 
@@ -58 +201 @@
     , m_iDragTokenDarkness(110)
 {
+    /* Install Chooser-view item accessibility interface factory: */
+    QAccessible::installFactory(UIAccessibilityInterfaceForUIGChooserItem::pFactory);
+
     /* Basic item setup: */
     setOwnedByLayout(false);