Changeset 63797 in vbox

Timestamp:

Sep 12, 2016 12:59:44 PM (8 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

110622

Message:

FE/Qt: bugref:6899: Accessibility support (step 22): Mac OS X: Selector UI: Basic segmented-button accessibility interface.

File:

• trunk/src/VBox/Frontends/VirtualBox/src/platform/darwin/UICocoaSpecialControls.mm (modified) (3 diffs)

trunk/src/VBox/Frontends/VirtualBox/src/platform/darwin/UICocoaSpecialControls.mm

@@ -38 +38 @@
 
 /* Qt includes */
+#include <QAccessibleWidget>
 #include <QApplication>
 #include <QIcon>
 #include <QKeyEvent>
 #include <QMacCocoaViewContainer>
+
+/* Other VBox includes: */
+#include <iprt/assert.h>
 
 #if 0 /* This is a built-in according to clang. Not sure how it relates to QT_VERSION... */
@@ -50 +54 @@
 #endif /* QT_VERSION >= 0x050000 */
 #endif
+
+/* Forward declarations: */
+class UIAccessibilityInterfaceForUICocoaSegmentedButton;
+
 
 /*
@@ -349 +357 @@
 }
 
+
+/** QAccessibleInterface extension used as an accessibility interface for segmented-button segment. */
+class UIAccessibilityInterfaceForUICocoaSegmentedButtonSegment : public QAccessibleInterface
+{
+public:
+
+    /** Constructs an accessibility interface.
+      * @param  pParent  Brings the parent interface we are linked to.
+      * @param  iIndex   Brings the index of segment we are referring to. */
+    UIAccessibilityInterfaceForUICocoaSegmentedButtonSegment(UIAccessibilityInterfaceForUICocoaSegmentedButton *pParent, int iIndex)
+        : m_pParent(pParent)
+        , m_iIndex(iIndex)
+    {}
+
+    /** Returns whether the interface is valid. */
+    virtual bool isValid() const /* override */ { return true; }
+
+    /** Returns the wrapped object. */
+    virtual QObject *object() const /* override */ { return 0; }
+    /** Returns the parent. */
+    virtual QAccessibleInterface *parent() const /* override */;
+
+    /** Returns the number of children. */
+    virtual int childCount() const /* override */ { return 0; }
+    /** Returns the child with the passed @a iIndex. */
+    virtual QAccessibleInterface *child(int /* iIndex */) const /* override */ { return 0; }
+    /** Returns the child at position QPoint(@a x, @a y). */
+    virtual QAccessibleInterface *childAt(int /* x */, int /* y */) const /* override */ { return 0; }
+    /** Returns the index of the passed @a pChild. */
+    virtual int indexOfChild(const QAccessibleInterface * /* pChild */) const /* override */ { return -1; }
+
+    /** Returns the rect. */
+    virtual QRect rect() const /* override */;
+
+    /** Defines a @a strText for the passed @a enmTextRole. */
+    virtual void setText(QAccessible::Text /* enmTextRole */, const QString & /* strText */) /* 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 */ { return QAccessible::RadioButton; }
+    /** Returns the state. */
+    virtual QAccessible::State state() const /* override */;
+
+private:
+
+    /** Holds the parent interface we are linked to. */
+    UIAccessibilityInterfaceForUICocoaSegmentedButton *m_pParent;
+    /** Holds the index of segment we are referring to. */
+    const int m_iIndex;
+};
+
+
+/** QAccessibleWidget extension used as an accessibility interface for segmented-button. */
+class UIAccessibilityInterfaceForUICocoaSegmentedButton : public QAccessibleWidget
+{
+public:
+
+    /** Returns an accessibility interface for passed @a strClassname and @a pObject. */
+    static QAccessibleInterface *pFactory(const QString &strClassname, QObject *pObject)
+    {
+        /* Creating segmented-button accessibility interface: */
+        if (pObject && strClassname == QLatin1String("UICocoaSegmentedButton"))
+            return new UIAccessibilityInterfaceForUICocoaSegmentedButton(qobject_cast<QWidget*>(pObject));
+
+        /* Null by default: */
+        return 0;
+    }
+
+    /** Constructs an accessibility interface passing @a pWidget to the base-class. */
+    UIAccessibilityInterfaceForUICocoaSegmentedButton(QWidget *pWidget)
+        : QAccessibleWidget(pWidget, QAccessible::ToolBar)
+    {
+        /* Prepare: */
+        prepare();
+    }
+
+    /** Destructs an accessibility interface. */
+    ~UIAccessibilityInterfaceForUICocoaSegmentedButton()
+    {
+        /* Cleanup: */
+        cleanup();
+    }
+
+    /** Returns the number of children. */
+    virtual int childCount() const /* override */ { return m_children.size(); }
+    /** Returns the child with the passed @a iIndex. */
+    virtual QAccessibleInterface *child(int iIndex) const /* override */ { return m_children.at(iIndex); }
+
+    /** Returns corresponding segmented-button. */
+    UICocoaSegmentedButton *button() const { return qobject_cast<UICocoaSegmentedButton*>(widget()); }
+
+private:
+
+    /** Prepares all. */
+    void prepare()
+    {
+        /* Prepare the list of children interfaces: */
+        for (int i = 0; i < button()->count(); ++i)
+            m_children << new UIAccessibilityInterfaceForUICocoaSegmentedButtonSegment(this, i);
+    }
+
+    /** Cleanups all. */
+    void cleanup()
+    {
+        /* Cleanup the list of children interfaces: */
+        qDeleteAll(m_children);
+        m_children.clear();
+    }
+
+    /** Holds the list of children interfaces. */
+    QList<UIAccessibilityInterfaceForUICocoaSegmentedButtonSegment*> m_children;
+};
+
+
+QAccessibleInterface *UIAccessibilityInterfaceForUICocoaSegmentedButtonSegment::parent() const
+{
+    return m_pParent;
+}
+
+QRect UIAccessibilityInterfaceForUICocoaSegmentedButtonSegment::rect() const
+{
+    // TODO: Return the -=real=- segment rectangle.
+    const QRect myRect = m_pParent->rect();
+    return QRect(myRect.x() + myRect.width() / 2 * m_iIndex,
+                 myRect.y(), myRect.width() / 2, myRect.height());
+}
+
+QString UIAccessibilityInterfaceForUICocoaSegmentedButtonSegment::text(QAccessible::Text /* enmTextRole */) const
+{
+    /* Return the segment description: */
+    return m_pParent->button()->description(m_iIndex);
+}
+
+QAccessible::State UIAccessibilityInterfaceForUICocoaSegmentedButtonSegment::state() const
+{
+    /* Compose the segment state: */
+    QAccessible::State state;
+    state.checkable = true;
+    state.checked = m_pParent->button()->isSelected(m_iIndex);
+
+    /* Return the segment state: */
+    return state;
+}
+
+
 UICocoaSegmentedButton::UICocoaSegmentedButton(QWidget *pParent, int count, CocoaSegmentType type /* = RoundRectSegment */)
     : QMacCocoaViewContainer(0, pParent)
 {
+    /* Install segmented-button accessibility interface factory: */
+    QAccessible::installFactory(UIAccessibilityInterfaceForUICocoaSegmentedButton::pFactory);
+
     /* Prepare auto-release pool: */
     NSAutoreleasePool *pool = [[NSAutoreleasePool alloc] init];