tests/auto/macgui/guitest.h
changeset 0 1918ee327afb
child 4 3b1da2848fc7
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/tests/auto/macgui/guitest.h	Mon Jan 11 14:00:40 2010 +0000
@@ -0,0 +1,186 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the test suite of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, 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.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+#ifndef GUITEST_H
+#define GUITEST_H
+
+#include <QAccessibleInterface>
+#include <QSet>
+#include <QWidget>
+#include <QPainter>
+
+QT_USE_NAMESPACE
+
+/*
+    GuiTest provides tools for:
+     - navigating the Qt Widget hiearchy using the accessibilty APIs.
+     - Simulating platform mouse and keybord events.
+*/
+
+/*
+    InterfaceChildPair specifies an accessibilty interface item.
+*/
+class InterfaceChildPair {
+public:
+    InterfaceChildPair() : iface(0), possibleChild(0) {}
+    InterfaceChildPair(QAccessibleInterface *iface, int possibleChild)
+    :iface(iface), possibleChild(possibleChild)    
+    { }
+    
+    QAccessibleInterface *iface;
+    int possibleChild;
+};
+
+class TestBase {
+public:
+    virtual bool operator()(InterfaceChildPair candidate) = 0;
+    virtual ~TestBase() {}
+};
+
+/*
+    WidgetNavigator navigates a Qt GUI hierarchy using the QAccessibility APIs.
+*/
+class WidgetNavigator {
+public:
+    WidgetNavigator() {};
+    ~WidgetNavigator();
+
+    void printAll(QWidget *widget);
+    void printAll(InterfaceChildPair interface);
+    
+    InterfaceChildPair find(QAccessible::Text textType, const QString &text, QWidget *start);
+    InterfaceChildPair find(QAccessible::Text textType, const QString &text, QAccessibleInterface *start);
+
+    InterfaceChildPair recursiveSearch(TestBase *test, QAccessibleInterface *iface, int possibleChild);
+    
+    void deleteInDestructor(QAccessibleInterface * interface);
+    static QWidget *getWidget(InterfaceChildPair interface);
+private:
+    QSet<QAccessibleInterface *> interfaces;
+};
+
+/*
+    NativeEvents contains platform-specific code for simulating mouse and keybord events.
+    (Implemented so far: mouseClick on Mac)
+*/
+namespace NativeEvents {
+    enum MousePosition { UpdatePosition, DontUpdatePosition };
+    /*
+        Simulates a mouse click with button at globalPos.
+    */
+    void mouseClick(const QPoint &globalPos, Qt::MouseButtons buttons, MousePosition updateMouse = DontUpdatePosition);
+};
+
+class ColorWidget : public QWidget
+{
+public:
+    ColorWidget(QWidget *parent = 0, QColor color = QColor(Qt::red))
+       : QWidget(parent), color(color) {}
+    
+    QColor color;
+
+protected:
+    void paintEvent(QPaintEvent  *)
+    {
+        QPainter p(this);
+        p.fillRect(this->rect(), color);
+    }
+};
+
+class DelayedAction : public QObject
+{
+Q_OBJECT
+public:
+    DelayedAction() : delay(0), next(0) {}
+    virtual ~DelayedAction(){}
+public slots:
+    virtual void run();
+public:
+    int delay;
+    DelayedAction *next;
+};
+
+class ClickLaterAction : public DelayedAction
+{
+Q_OBJECT
+public:
+    ClickLaterAction(InterfaceChildPair interface, Qt::MouseButtons buttons = Qt::LeftButton);
+    ClickLaterAction(QWidget *widget, Qt::MouseButtons buttons = Qt::LeftButton);
+protected slots:
+    void run();
+private:
+    bool useInterface;
+    InterfaceChildPair interface;
+    QWidget *widget;
+    Qt::MouseButtons buttons;
+};
+
+/*
+    
+*/
+class GuiTester : public QObject
+{
+Q_OBJECT
+public:
+    GuiTester();
+    ~GuiTester();
+    enum Direction {Horizontal = 1, Vertical = 2, HorizontalAndVertical = 3};
+    Q_DECLARE_FLAGS(Directions, Direction)
+    bool isFilled(const QImage image, const QRect &rect, const QColor &color);
+    bool isContent(const QImage image, const QRect &rect, Directions directions = HorizontalAndVertical);
+protected slots:
+    void exitLoopSlot();
+protected:
+    void clickLater(InterfaceChildPair interface, Qt::MouseButtons buttons = Qt::LeftButton, int delay = 300);
+    void clickLater(QWidget *widget, Qt::MouseButtons buttons = Qt::LeftButton, int delay = 300);
+
+    void clearSequence();
+    void addToSequence(DelayedAction *action, int delay = 0);
+    void runSequence();
+    WidgetNavigator wn;
+private:
+    QSet<DelayedAction *> actions;
+    DelayedAction *startAction;
+    DelayedAction *lastAction;
+};
+
+Q_DECLARE_OPERATORS_FOR_FLAGS(GuiTester::Directions)
+
+#endif