summaryrefslogtreecommitdiffstats
path: root/tests/auto/macgui/guitest.h
diff options
context:
space:
mode:
Diffstat (limited to 'tests/auto/macgui/guitest.h')
-rw-r--r--tests/auto/macgui/guitest.h186
1 files changed, 186 insertions, 0 deletions
diff --git a/tests/auto/macgui/guitest.h b/tests/auto/macgui/guitest.h
new file mode 100644
index 0000000..1b65361
--- /dev/null
+++ b/tests/auto/macgui/guitest.h
@@ -0,0 +1,186 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** Contact: Qt Software Information (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 either Technology Preview License Agreement or the
+** Beta Release License Agreement.
+**
+** 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.0, 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.
+**
+** If you are unsure which license is appropriate for your use, please
+** contact the sales department at qt-sales@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