1 /****************************************************************************

     2 **

     3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

     4 ** All rights reserved.

     5 ** Contact: Nokia Corporation (qt-info@nokia.com)

     6 **

     7 ** This file is part of the QtTest module of the Qt Toolkit.

     8 **

     9 ** $QT_BEGIN_LICENSE:LGPL$

    10 ** No Commercial Usage

    11 ** This file contains pre-release code and may not be distributed.

    12 ** You may use this file in accordance with the terms and conditions

    13 ** contained in the Technology Preview License Agreement accompanying

    14 ** this package.

    15 **

    16 ** GNU Lesser General Public License Usage

    17 ** Alternatively, this file may be used under the terms of the GNU Lesser

    18 ** General Public License version 2.1 as published by the Free Software

    19 ** Foundation and appearing in the file LICENSE.LGPL included in the

    20 ** packaging of this file.  Please review the following information to

    21 ** ensure the GNU Lesser General Public License version 2.1 requirements

    22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

    23 **

    24 ** In addition, as a special exception, Nokia gives you certain additional

    25 ** rights.  These rights are described in the Nokia Qt LGPL Exception

    26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

    27 **

    28 ** If you have questions regarding the use of this file, please contact

    29 ** Nokia at qt-info@nokia.com.

    30 **

    31 **

    32 **

    33 **

    34 **

    35 **

    36 **

    37 **

    38 ** $QT_END_LICENSE$

    39 **

    40 ****************************************************************************/

    41 

    42 #ifndef QTESTACCESSIBLE_H

    43 #define QTESTACCESSIBLE_H

    44 

    45 #if 0

    46 // inform syncqt

    47 #pragma qt_no_master_include

    48 #endif

    49 

    50 #ifndef QT_NO_ACCESSIBILITY

    51 

    52 #define QTEST_ACCESSIBILITY

    53 

    54 #define QVERIFY_EVENT(object, child, event) \

    55     QVERIFY(QTestAccessibility::verifyEvent(object, child, (int)event))

    56 

    57 #include <QtCore/qlist.h>

    58 #include <QtGui/qaccessible.h>

    59 #include <QtGui/qapplication.h>

    60 

    61 QT_BEGIN_HEADER

    62 

    63 QT_BEGIN_NAMESPACE

    64 

    65 QT_MODULE(Test)

    66 

    67 class QObject;

    68 

    69 struct QTestAccessibilityEvent

    70 {

    71     QTestAccessibilityEvent(QObject* o = 0, int c = 0, int e = 0)

    72         : object(o), child(c), event(e) {}

    73 

    74     bool operator==(const QTestAccessibilityEvent &o) const

    75     {

    76         return o.object == object && o.child == child && o.event == event;

    77     }

    78 

    79     QObject* object;

    80     int child;

    81     int event;

    82 };

    83 

    84 typedef QList<QTestAccessibilityEvent> EventList;

    85 

    86 class QTestAccessibility

    87 {

    88 public:

    89     static void initialize()

    90     {

    91         if (!instance()) {

    92             instance() = new QTestAccessibility;

    93             qAddPostRoutine(cleanup);

    94         }

    95     }

    96     static void cleanup()

    97     {

    98         delete instance();

    99         instance() = 0;

   100     }

   101     static void clearEvents() { eventList().clear(); }

   102     static EventList events() { return eventList(); }

   103     static bool verifyEvent(const QTestAccessibilityEvent& ev)

   104     {

   105         if (eventList().isEmpty())

   106             return FALSE;

   107         return eventList().takeFirst() == ev;

   108     }

   109 

   110     static bool verifyEvent(QObject *o, int c, int e)

   111     {

   112         return verifyEvent(QTestAccessibilityEvent(o, c, e));

   113     }

   114 

   115 private:

   116     QTestAccessibility()

   117     {

   118         QAccessible::installUpdateHandler(updateHandler);

   119         QAccessible::installRootObjectHandler(rootObjectHandler);

   120     }

   121 

   122     ~QTestAccessibility()

   123     {

   124         QAccessible::installUpdateHandler(0);

   125         QAccessible::installRootObjectHandler(0);

   126     }

   127 

   128     static void rootObjectHandler(QObject *object)

   129     {

   130         //    qDebug("rootObjectHandler called %p", object);

   131         if (object) {

   132             QApplication* app = qobject_cast<QApplication*>(object);

   133             if ( !app )

   134                 qWarning("QTEST_ACCESSIBILITY: root Object is not a QApplication!");

   135         } else {

   136             qWarning("QTEST_ACCESSIBILITY: root Object called with 0 pointer");

   137         }

   138     }

   139 

   140     static void updateHandler(QObject *o, int c, QAccessible::Event e)

   141     {

   142         //    qDebug("updateHandler called: %p %d %d", o, c, (int)e);

   143         eventList().append(QTestAccessibilityEvent(o, c, (int)e));

   144     }

   145 

   146     static EventList &eventList()

   147     {

   148         static EventList list;

   149         return list;

   150     }

   151 

   152     static QTestAccessibility *&instance()

   153     {

   154         static QTestAccessibility *ta = 0;

   155         return ta;

   156     }

   157 };

   158 

   159 #endif

   160 

   161 QT_END_NAMESPACE

   162 

   163 QT_END_HEADER

   164 

   165 #endif