diff options
author | Jan-Arve Saether <jan-arve.saether@nokia.com> | 2011-09-16 06:56:48 +0200 |
---|---|---|
committer | Qt by Nokia <qt-info@nokia.com> | 2011-09-29 13:32:59 +0200 |
commit | 87ae97c11ab9b298c0ce6701873b45fc3992b385 (patch) | |
tree | 8f30a95f054b8bf2346a98e072ba864a7a974da5 /src/gui/accessible/qplatformaccessibility_qpa.cpp | |
parent | 8ebd7d84fcdaeba152bd9812b45d5c49b1e03a23 (diff) |
Refactor accessibility for Qt5
* Moved most stuff to gui\accessible
* Moved widget-specific stuff to widgets\accessible
* Moved platform-specific code to either the bridge plugin (this was already the case)
or to the platform plugin.
* Added several classes and functions. These have not yet gone through an API
review. The plan is to do that in a later commit.
Classes:
- QPlatformAccessibility
- QWindowsAccessibility
Functions:
- QWindow *QAccessibleInterface::window();
- QPlatformAccessibility *QPlatformIntegration::accessibility()
* The bridge code can now either be a plugin or integrated into the platform plugin
* Mac accessibility is left out for now. Unix "should still work" (tm). These platforms
should be fixed soon.
Change-Id: Ib49ffa73b647ee0af90864544c2769440157f562
Reviewed-on: http://codereview.qt-project.org/5330
Reviewed-by: Frederik Gladhorn <frederik.gladhorn@nokia.com>
Reviewed-by: Jan-Arve Sæther <jan-arve.saether@nokia.com>
Diffstat (limited to 'src/gui/accessible/qplatformaccessibility_qpa.cpp')
-rw-r--r-- | src/gui/accessible/qplatformaccessibility_qpa.cpp | 148 |
1 files changed, 148 insertions, 0 deletions
diff --git a/src/gui/accessible/qplatformaccessibility_qpa.cpp b/src/gui/accessible/qplatformaccessibility_qpa.cpp new file mode 100644 index 0000000000..f912907db3 --- /dev/null +++ b/src/gui/accessible/qplatformaccessibility_qpa.cpp @@ -0,0 +1,148 @@ +/**************************************************************************** +** +** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). +** All rights reserved. +** Contact: Nokia Corporation (qt-info@nokia.com) +** +** This file is part of the QtGui module of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:LGPL$ +** GNU Lesser General Public License Usage +** This file may be used under the terms of the GNU Lesser General Public +** License version 2.1 as published by the Free Software Foundation and +** appearing in the file LICENSE.LGPL included in the packaging of this +** file. Please review the following information to ensure the GNU Lesser +** General Public License version 2.1 requirements will be met: +** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. +** +** In addition, as a special exception, Nokia gives you certain additional +** rights. These rights are described in the Nokia Qt LGPL Exception +** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. +** +** GNU General Public License Usage +** Alternatively, this file may be used under the terms of the GNU General +** Public License version 3.0 as published by the Free Software Foundation +** and appearing in the file LICENSE.GPL included in the packaging of this +** file. Please review the following information to ensure the GNU General +** Public License version 3.0 requirements will be met: +** http://www.gnu.org/copyleft/gpl.html. +** +** Other Usage +** Alternatively, this file may be used in accordance with the terms and +** conditions contained in a signed written agreement between you and Nokia. +** +** +** +** +** +** $QT_END_LICENSE$ +** +****************************************************************************/ +#include "qplatformaccessibility_qpa.h" +#include <private/qfactoryloader_p.h> +#include "qaccessibleplugin.h" +#include "qaccessibleobject.h" +#include "qaccessiblebridge.h" +#include <QtGui/QGuiApplication> + +/* accessiblebridge plugin discovery stuff */ +#ifndef QT_NO_LIBRARY +Q_GLOBAL_STATIC_WITH_ARGS(QFactoryLoader, bridgeloader, + (QAccessibleBridgeFactoryInterface_iid, QLatin1String("/accessiblebridge"))) +#endif + +Q_GLOBAL_STATIC(QVector<QAccessibleBridge *>, bridges) + +/*! + \class QPlatformAccessibility + \brief The QPlatformAccessibility class is the base class for + integrating accessibility backends + + \preliminary + \ingroup accessibility + + \sa QAccessible +*/ +QPlatformAccessibility::QPlatformAccessibility() +{ +} + +QPlatformAccessibility::~QPlatformAccessibility() +{ +} + +void QPlatformAccessibility::notifyAccessibilityUpdate(QObject *o, + int who, + QAccessible::Event reason) +{ + initialize(); + + if (!bridges() || bridges()->isEmpty()) + return; + + QAccessibleInterface *iface = QAccessible::queryAccessibleInterface(o); + if (!iface) + return; + + // updates for List/Table/Tree should send child + if (who) { + QAccessibleInterface *child; + iface->navigate(QAccessible::Child, who, &child); + if (child) { + delete iface; + iface = child; + who = 0; + } + } + + for (int i = 0; i < bridges()->count(); ++i) + bridges()->at(i)->notifyAccessibilityUpdate(reason, iface, who); + delete iface; + +} + +void QPlatformAccessibility::setRootObject(QObject *o) +{ + initialize(); + if (bridges()->isEmpty()) + return; + + if (!o) + return; + + for (int i = 0; i < bridges()->count(); ++i) { + QAccessibleInterface *iface = QAccessible::queryAccessibleInterface(o); + bridges()->at(i)->setRootObject(iface); + } +} + +void QPlatformAccessibility::initialize() +{ + static bool isInit = false; + if (isInit) + return; + isInit = true; // ### not atomic +#ifdef Q_OS_UNIX + if (qgetenv("QT_ACCESSIBILITY") != "1") + return; +#endif +#ifndef QT_NO_LIBRARY + const QStringList l = bridgeloader()->keys(); + for (int i = 0; i < l.count(); ++i) { + if (QAccessibleBridgeFactoryInterface *factory = + qobject_cast<QAccessibleBridgeFactoryInterface*>(bridgeloader()->instance(l.at(i)))) { + QAccessibleBridge * bridge = factory->create(l.at(i)); + if (bridge) { + bridges()->append(bridge); +# + } + } + } +#endif +} + +void QPlatformAccessibility::cleanup() +{ + qDeleteAll(*bridges()); +} + |