Revision control
Copy as Markdown
// Copyright (C) 2018 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
// Qt-Security score:significant reason:default
#include "qtestsupport_widgets.h"
#include "qwidget.h"
#include <QtGui/qwindow.h>
#include <QtCore/qtestsupport_core.h>
#include <QtCore/qthread.h>
#include <QtGui/qtestsupport_gui.h>
#include <QtGui/private/qevent_p.h>
#include <QtGui/private/qeventpoint_p.h>
#include <private/qguiapplication_p.h>
#include <qpa/qplatformintegration.h>
QT_BEGIN_NAMESPACE
template <typename Predicate>
static bool qWaitForWidgetWindow(QWidget *w, Predicate predicate, QDeadlineTimer timeout)
{
if (!w->window()->windowHandle())
return false;
return QTest::qWaitFor([&, wp = QPointer(w)]() {
using QTest::Internal::WaitForResult;
if (QWidget *widget = wp.data(); !widget)
return WaitForResult::Failed;
else if (QWindow *window = widget->window()->windowHandle(); window && predicate(window))
return WaitForResult::Done;
return WaitForResult::NotYet;
}, timeout);
}
/*!
\since 5.0
\overload
The \a timeout is in milliseconds.
*/
bool QTest::qWaitForWindowActive(QWidget *widget, int timeout)
{
return qWaitForWindowActive(widget, QDeadlineTimer{timeout, Qt::TimerType::PreciseTimer});
}
/*!
\since 6.10
Returns \c true if \a widget is active within \a timeout milliseconds. Otherwise returns \c false.
The method is useful in tests that call QWidget::show() and rely on the widget actually being
active (i.e. being visible and having focus) before proceeding.
\note The method will time out and return \c false if another window prevents \a widget from
becoming active.
\note Since focus is an exclusive property, \a widget may loose its focus to another window at
any time - even after the method has returned \c true.
\sa qWaitForWindowExposed(), QWidget::isActiveWindow()
*/
bool QTest::qWaitForWindowActive(QWidget *widget, QDeadlineTimer timeout)
{
if (Q_UNLIKELY(!QGuiApplicationPrivate::platformIntegration()->hasCapability(QPlatformIntegration::WindowActivation))) {
qWarning() << "qWaitForWindowActive was called on a platform that doesn't support window"
<< "activation. This means there is an error in the test and it should either"
<< "check for the WindowActivation platform capability before calling"
<< "qWaitForWindowActivate, use qWaitForWindowExposed instead, or skip the test."
<< "Falling back to qWaitForWindowExposed.";
return qWaitForWindowExposed(widget, timeout);
}
return qWaitForWidgetWindow(widget,
[&](QWindow *window) { return window->isActive(); },
timeout);
}
/*!
\since 6.10
\overload
This function uses the default timeout of 5 seconds.
*/
bool QTest::qWaitForWindowActive(QWidget *widget)
{
return qWaitForWindowActive(widget, defaultTryTimeout.load(std::memory_order_relaxed));
}
/*!
\since 6.7
Returns \c true, if \a widget is the focus window within \a timeout. Otherwise returns \c false.
The method is useful in tests that call QWidget::show() and rely on the widget
having focus (for receiving keyboard events e.g.) before proceeding.
\note The method will time out and return \c false if another window prevents \a widget from
becoming focused.
\note Since focus is an exclusive property, \a widget may loose its focus to another window at
any time - even after the method has returned \c true.
\sa qWaitForWindowExposed(), qWaitForWindowActive(), QGuiApplication::focusWindow()
*/
Q_WIDGETS_EXPORT bool QTest::qWaitForWindowFocused(QWidget *widget, QDeadlineTimer timeout)
{
return qWaitForWidgetWindow(widget,
[&](QWindow *window) {
return qGuiApp->focusWindow() == window;
}, timeout);
}
/*!
\since 6.10
\overload
This function uses the default timeout of 5 seconds.
*/
bool QTest::qWaitForWindowFocused(QWidget *widget)
{
return qWaitForWindowFocused(widget, defaultTryTimeout.load(std::memory_order_relaxed));
}
/*!
\since 5.0
\overload
The \a timeout is in milliseconds.
*/
bool QTest::qWaitForWindowExposed(QWidget *widget, int timeout)
{
return qWaitForWindowExposed(widget, std::chrono::milliseconds(timeout));
}
/*!
\since 6.10
Returns \c true if \a widget is exposed within \a timeout milliseconds. Otherwise returns \c false.
The method is useful in tests that call QWidget::show() and rely on the widget actually being
being visible before proceeding.
\note A window mapped to screen may still not be considered exposed, if the window client area is
not visible, e.g. because it is completely covered by other windows.
In such cases, the method will time out and return \c false.
\sa qWaitForWindowActive(), QWidget::isVisible(), QWindow::isExposed()
*/
bool QTest::qWaitForWindowExposed(QWidget *widget, QDeadlineTimer timeout)
{
return qWaitForWidgetWindow(widget,
[&](QWindow *window) { return window->isExposed(); },
timeout);
}
/*!
\since 6.10
\overload
This function uses the default timeout of 5 seconds.
*/
bool QTest::qWaitForWindowExposed(QWidget *widget)
{
return qWaitForWindowExposed(widget, defaultTryTimeout.load(std::memory_order_relaxed));
}
namespace QTest {
QTouchEventWidgetSequence::~QTouchEventWidgetSequence()
{
if (commitWhenDestroyed)
QTouchEventWidgetSequence::commit();
}
QTouchEventWidgetSequence& QTouchEventWidgetSequence::press(int touchId, const QPoint &pt, QWidget *widget)
{
auto &p = point(touchId);
QMutableEventPoint::setGlobalPosition(p, mapToScreen(widget, pt));
QMutableEventPoint::setState(p, QEventPoint::State::Pressed);
return *this;
}
QTouchEventWidgetSequence& QTouchEventWidgetSequence::move(int touchId, const QPoint &pt, QWidget *widget)
{
auto &p = point(touchId);
QMutableEventPoint::setGlobalPosition(p, mapToScreen(widget, pt));
QMutableEventPoint::setState(p, QEventPoint::State::Updated);
return *this;
}
QTouchEventWidgetSequence& QTouchEventWidgetSequence::release(int touchId, const QPoint &pt, QWidget *widget)
{
auto &p = point(touchId);
QMutableEventPoint::setGlobalPosition(p, mapToScreen(widget, pt));
QMutableEventPoint::setState(p, QEventPoint::State::Released);
return *this;
}
QTouchEventWidgetSequence& QTouchEventWidgetSequence::stationary(int touchId)
{
auto &p = pointOrPreviousPoint(touchId);
QMutableEventPoint::setState(p, QEventPoint::State::Stationary);
return *this;
}
bool QTouchEventWidgetSequence::commit(bool processEvents)
{
bool ret = false;
if (points.isEmpty())
return ret;
QThread::sleep(std::chrono::milliseconds{1});
if (targetWindow) {
ret = qt_handleTouchEventv2(targetWindow, device, points.values());
} else if (targetWidget) {
ret = qt_handleTouchEventv2(targetWidget->windowHandle(), device, points.values());
}
if (processEvents)
QCoreApplication::processEvents();
previousPoints = points;
points.clear();
return ret;
}
QTest::QTouchEventWidgetSequence::QTouchEventWidgetSequence(QWidget *widget, QPointingDevice *aDevice, bool autoCommit)
: QTouchEventSequence(nullptr, aDevice, autoCommit), targetWidget(widget)
{
}
QPointF QTouchEventWidgetSequence::mapToScreen(QWidget *widget, const QPoint &pt)
{
if (widget)
return widget->mapToGlobal(QPointF(pt));
return targetWidget ? targetWidget->mapToGlobal(QPointF(pt)) : QPointF(pt);
}
} // namespace QTest
QT_END_NAMESPACE