aboutsummaryrefslogtreecommitdiffstats
path: root/src/qmltest/doc/src/qtquicktest.qdoc
blob: 31c097ed76e41b83d7270eb16e85711c36e53c7c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
/****************************************************************************
**
** Copyright (C) 2018 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file. Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
** $QT_END_LICENSE$
**
****************************************************************************/

/*!
   \namespace QQuickTest
   \inmodule QtQuickTest

   \brief The QQuickTest namespace contains all the functions and
   macros related to Qt Quick Test.

   See the \l{Introduction to Qt Quick Test} for information about how to write
   Qt Quick unit tests.

   To link to the Qt Quick Test C++ library, see \l {Qt Quick Test C++ API}.

   \sa {Executing C++ Before QML Tests}
*/

/*!
    \macro QUICK_TEST_MAIN(name)
    \relates QQuickTest

    \brief Sets up the entry point for a Qt Quick Test application.
    The \a name argument uniquely identifies this set of tests.

    \snippet src_qmltest_qquicktest.cpp 1

    \note The macro assumes that your test sources are in the current
    directory, unless the \c QUICK_TEST_SOURCE_DIR environment variable is set.

    \sa QUICK_TEST_MAIN_WITH_SETUP(), {Running Qt Quick Tests}

*/

/*!
    \macro QUICK_TEST_MAIN_WITH_SETUP(name, QuickTestSetupClass)
    \relates QQuickTest

    \brief Sets up the entry point for a Qt Quick Test application.
    The \a name argument uniquely identifies this set of tests.

    This macro is identical to QUICK_TEST_MAIN(), except that it takes an
    additional argument \a QuickTestSetupClass, a pointer to a QObject-derived
    class. With this class it is possible to define additional setup code to
    execute before running the QML test.

    \note The macro assumes that your test sources are in the current
    directory, unless the \c QUICK_TEST_SOURCE_DIR environment variable is set.

    The following snippet demonstrates the use of this macro:

    \snippet src_qmltest_qquicktest.cpp 2

    \sa QUICK_TEST_MAIN(), {Running Qt Quick Tests}
*/