Changeset 63897 in vbox

Timestamp:

Sep 19, 2016 4:29:42 PM (8 years ago)

Author:

vboxsync

Message:

FE/Qt: bugref:6899: Accessibility support (step 39): Selector UI: Basic Snapshot item accessibility interface.

File:

• trunk/src/VBox/Frontends/VirtualBox/src/selector/UISnapshotPane.cpp (modified) (3 diffs)

trunk/src/VBox/Frontends/VirtualBox/src/selector/UISnapshotPane.cpp

@@ -55 +55 @@
 
 
+/** QAccessibleObject extension used as an accessibility interface for Snapshot item. */
+class UIAccessibilityInterfaceForUISnapshotItem : public QAccessibleObject
+{
+public:
+
+    /** Returns an accessibility interface for passed @a strClassname and @a pObject. */
+    static QAccessibleInterface *pFactory(const QString &strClassname, QObject *pObject)
+    {
+        /* Creating Snapshot item accessibility interface: */
+        if (pObject && strClassname == QLatin1String("UISnapshotItem"))
+            return new UIAccessibilityInterfaceForUISnapshotItem(pObject);
+
+        /* Null by default: */
+        return 0;
+    }
+
+    /** Constructs an accessibility interface passing @a pObject to the base-class. */
+    UIAccessibilityInterfaceForUISnapshotItem(QObject *pObject)
+        : QAccessibleObject(pObject)
+    {}
+
+    /** Returns the parent. */
+    virtual QAccessibleInterface *parent() const /* override */;
+
+    /** 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 the rect. */
+    virtual QRect rect() const /* override */;
+    /** Returns a text for the passed @a enmTextRole. */
+    virtual QString text(QAccessible::Text enmTextRole) const /* override */;
+
+    /** Returns the role. */
+    virtual QAccessible::Role role() const /* override */;
+    /** Returns the state. */
+    virtual QAccessible::State state() const /* override */;
+
+private:
+
+    /** Returns corresponding Snapshot item. */
+    UISnapshotItem *item() const { return qobject_cast<UISnapshotItem*>(object()); }
+};
+
+
 /** QAccessibleWidget extension used as an accessibility interface for Snapshot tree. */
 class UIAccessibilityInterfaceForUISnapshotTree : public QAccessibleWidget
@@ -212 +260 @@
     UISnapshotItem *childSnapshotItem(int iIndex) const;
 };
+
+
+/*********************************************************************************************************************************
+*   Class UIAccessibilityInterfaceForUISnapshotItem implementation.                                                              *
+*********************************************************************************************************************************/
+
+QAccessibleInterface *UIAccessibilityInterfaceForUISnapshotItem::parent() const
+{
+    /* Make sure item still alive: */
+    AssertPtrReturn(item(), 0);
+
+    /* Return the parent: */
+    return item()->parentSnapshotItem() ?
+           QAccessible::queryAccessibleInterface(item()->parentSnapshotItem()) :
+           QAccessible::queryAccessibleInterface(item()->parentSnapshotTree());
+}
+
+int UIAccessibilityInterfaceForUISnapshotItem::childCount() const
+{
+    /* Make sure item still alive: */
+    AssertPtrReturn(item(), 0);
+
+    /* Return the number of children: */
+    return item()->childCount();
+}
+
+QAccessibleInterface *UIAccessibilityInterfaceForUISnapshotItem::child(int iIndex) const
+{
+    /* Make sure item still alive: */
+    AssertPtrReturn(item(), 0);
+    /* Make sure index is valid: */
+    AssertReturn(iIndex >= 0 && iIndex < childCount(), 0);
+
+    /* Return the child with the passed iIndex: */
+    return QAccessible::queryAccessibleInterface(item()->childSnapshotItem(iIndex));
+}
+
+int UIAccessibilityInterfaceForUISnapshotItem::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;
+}
+
+QRect UIAccessibilityInterfaceForUISnapshotItem::rect() const
+{
+    /* Make sure item still alive: */
+    AssertPtrReturn(item(), QRect());
+
+    /* Compose common region: */
+    QRegion region;
+
+    /* Append item rectangle: */
+    const QRect  itemRectInViewport = item()->parentSnapshotTree()->visualItemRect(item());
+    const QSize  itemSize           = itemRectInViewport.size();
+    const QPoint itemPosInViewport  = itemRectInViewport.topLeft();
+    const QPoint itemPosInScreen    = item()->parentSnapshotTree()->viewport()->mapToGlobal(itemPosInViewport);
+    const QRect  itemRectInScreen   = QRect(itemPosInScreen, itemSize);
+    region += itemRectInScreen;
+
+    /* Append children rectangles: */
+    for (int i = 0; i < childCount(); ++i)
+        region += child(i)->rect();
+
+    /* Return common region bounding rectangle: */
+    return region.boundingRect();
+}
+
+QString UIAccessibilityInterfaceForUISnapshotItem::text(QAccessible::Text enmTextRole) const
+{
+    /* Make sure item still alive: */
+    AssertPtrReturn(item(), QString());
+
+    /* Return a text for the passed enmTextRole: */
+    switch (enmTextRole)
+    {
+        case QAccessible::Name: return item()->text(0);
+        default: break;
+    }
+
+    /* Null-string by default: */
+    return QString();
+}
+
+QAccessible::Role UIAccessibilityInterfaceForUISnapshotItem::role() const
+{
+    /* Return the role of item with children: */
+    if (childCount() > 0)
+        return QAccessible::List;
+
+    /* TreeItem by default: */
+    return QAccessible::ListItem;
+}
+
+QAccessible::State UIAccessibilityInterfaceForUISnapshotItem::state() const
+{
+    /* Make sure item still alive: */
+    AssertPtrReturn(item(), QAccessible::State());
+
+    /* Compose the state: */
+    QAccessible::State state;
+    state.focusable = true;
+    state.selectable = true;
+
+    /* Compose the state of current item: */
+    if (   item()
+        && item() == UISnapshotPane::toSnapshotItem(item()->treeWidget()->currentItem()))
+    {
+        state.active = true;
+        state.focused = true;
+        state.selected = true;
+    }
+
+    /* Return the state: */
+    return state;
+}
 
 
@@ -585 +753 @@
     /* Install Snapshot tree accessibility interface factory: */
     QAccessible::installFactory(UIAccessibilityInterfaceForUISnapshotTree::pFactory);
+    /* Install Snapshot item accessibility interface factory: */
+    QAccessible::installFactory(UIAccessibilityInterfaceForUISnapshotItem::pFactory);
 
     /* No header: */