diff options
Diffstat (limited to 'old/doc/html/qsystemtest.html')
| -rw-r--r-- | old/doc/html/qsystemtest.html | 701 |
1 files changed, 701 insertions, 0 deletions
diff --git a/old/doc/html/qsystemtest.html b/old/doc/html/qsystemtest.html new file mode 100644 index 0000000..48661e9 --- /dev/null +++ b/old/doc/html/qsystemtest.html @@ -0,0 +1,701 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!DOCTYPE html + PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<!-- ../../libqsystemtest/qsystemtest.cpp --> +<head> + <title>QSystemTest Namespace Reference</title> + <link href="classic.css" rel="stylesheet" type="text/css" /> +</head> +<body> +<table border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr> +<td align="left" valign="top" width="32"><a href="http://qt.nokia.com/"><img src="images/qt-logo.png" align="left" border="0" /></a></td> +<td width="1"> </td><td align="right" valign="top" width="230"></td></tr></table><h1 class="title">QSystemTest Namespace Reference<br /><span class="small-subtitle">[QtUiTestModule]</span> +</h1> +<p>The QSystemTest namespace provides script based system test functionality for Qt. <a href="#details">More...</a></p> +<pre> #include <QSystemTest></pre><p><b>This namespace is under development and is subject to change.</b></p> +<ul> +</ul> +<hr /> +<a name="types"></a> +<h2>Types</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">typedef </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#Array-typedef">Array</a></b></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">typedef </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#Boolean-typedef">Boolean</a></b></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#EnterMode-enum">EnterMode</a></b> { Commit, NoCommit }</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">typedef </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#Function-typedef">Function</a></b></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#LabelOrientation-enum">LabelOrientation</a></b> { LabelLeft, LabelRight, LabelAbove, LabelBelow }</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">typedef </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#Number-typedef">Number</a></b></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">typedef </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#QVariantArray-typedef">QVariantArray</a></b></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#Role-enum">Role</a></b> { NoRole, TitleBar, MenuBar, ScrollBar, ..., UserRole }</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#SkipMode-enum">SkipMode</a></b> { SkipSingle, SkipAll }</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#StartApplicationFlag-enum">StartApplicationFlag</a></b> { NoFlag, WaitForFocus, BackgroundCurrentApplication }</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">flags </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#StartApplicationFlag-enum">StartApplicationFlags</a></b></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">flags </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#StateFlag-enum">State</a></b></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#StateFlag-enum">StateFlag</a></b> { Normal, Unavailable, Selected, Focused, ..., Modal }</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">typedef </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#StringArray-typedef">StringArray</a></b></td></tr> +</table> +<hr /> +<a name="functions"></a> +<h2>Functions</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#Q_ENUMS">Q_ENUMS</a></b> ( SkipMode )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#activate">activate</a></b> ( const QString & <i>queryPath</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#addExpectedMessageBox">addExpectedMessageBox</a></b> ( const QString & <i>title</i>, const QString & <i>text</i>, const QString & <i>option</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#checkOS">checkOS</a></b> ( const QString & )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#checkState">checkState</a></b> ( const QString & <i>queryPath</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#clearExpectedMessageBox">clearExpectedMessageBox</a></b> ( const QString & <i>title</i>, const QString & <i>text</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#clearExpectedMessageBoxes">clearExpectedMessageBoxes</a></b> ()</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#compare">compare</a></b> ( Variant <i>actual</i>, Variant <i>expected</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#compareImage">compareImage</a></b> ( const QString & <i>expectedName</i>, const QString & <i>queryPath</i>, const QStringList & <i>maskedWidgets</i> = QStringList() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#currentApplication">currentApplication</a></b> ()</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#currentTitle">currentTitle</a></b> ( const QString & <i>queryPath</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#deletePath">deletePath</a></b> ( const QString & <i>path</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#enter">enter</a></b> ( const QVariant & <i>value</i>, const QString & <i>queryPath</i> = QString(), EnterMode <i>mode</i> = Commit )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#expectApplicationClose">expectApplicationClose</a></b> ( bool <i>value</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#expectFail">expectFail</a></b> ( const QString & <i>reason</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#expectMessageBox">expectMessageBox</a></b> ( String <i>title</i>, String <i>text</i>, String <i>option</i>, Number <i>timeout</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#fail">fail</a></b> ( String <i>message</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QStringList </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#findByProperty">findByProperty</a></b> ( const QString & <i>property</i>, const QVariant & <i>searchValue</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QStringList </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#findByProperty-2">findByProperty</a></b> ( const QVariantMap & <i>searchValues</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#focusWidget">focusWidget</a></b> ( const QString & <i>queryPath</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getClipboardText">getClipboardText</a></b> ()</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getData">getData</a></b> ( const QString & <i>srcFile</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QDateTime </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getDateTime">getDateTime</a></b> ()</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QStringList </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getDirectoryEntries">getDirectoryEntries</a></b> ( const QString & <i>dir</i>, QDir::Filters <i>filters</i> = QDir::NoFilter )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getFile">getFile</a></b> ( const QString & <i>srcFile</i>, const QString & <i>destFile</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QRect </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getGeometry">getGeometry</a></b> ( const QString & <i>queryPath</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QStringList </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getLabels">getLabels</a></b> ( const QString & <i>queryPath</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QStringList </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getList">getList</a></b> ( const QString & <i>queryPath</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QLocale </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getLocale">getLocale</a></b> ()</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QVariant </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getProperty">getProperty</a></b> ( const QString & <i>queryPath</i>, const QString & <i>name</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getSelectedText">getSelectedText</a></b> ( const QString & <i>queryPath</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QVariant </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getSelectedValue">getSelectedValue</a></b> ( const QString & <i>queryPath</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QVariant </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getSetting">getSetting</a></b> ( const QString & <i>file</i>, const QString & <i>group</i>, const QString & <i>key</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QVariant </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getSetting-2">getSetting</a></b> ( const QString & <i>organization</i>, const QString & <i>application</i>, const QString & <i>group</i>, const QString & <i>key</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getText">getText</a></b> ( const QString & <i>queryPath</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QVariant </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getValue">getValue</a></b> ( const QString & <i>queryPath</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#getenv">getenv</a></b> ( const QString & )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#ignoreMessageBoxes">ignoreMessageBoxes</a></b> ( bool <i>ignore</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#invokeMethod">invokeMethod</a></b> ( const QString & <i>queryPath</i>, const QString & <i>method</i>, Qt::ConnectionType <i>type</i>, const QVariant & <i>arg0</i> = QVariant(), const QVariant & <i>arg1</i> = QVariant(), const QVariant & <i>arg2</i> = QVariant(), const QVariant & <i>arg3</i> = QVariant(), const QVariant & <i>arg4</i> = QVariant(), const QVariant & <i>arg5</i> = QVariant(), const QVariant & <i>arg6</i> = QVariant(), const QVariant & <i>arg7</i> = QVariant(), const QVariant & <i>arg8</i> = QVariant(), const QVariant & <i>arg9</i> = QVariant() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#invokeMethod-2">invokeMethod</a></b> ( const QString & <i>queryPath</i>, const QString & <i>method</i>, const QVariant & <i>arg0</i> = QVariant(), const QVariant & <i>arg1</i> = QVariant(), const QVariant & <i>arg2</i> = QVariant(), const QVariant & <i>arg3</i> = QVariant(), const QVariant & <i>arg4</i> = QVariant(), const QVariant & <i>arg5</i> = QVariant(), const QVariant & <i>arg6</i> = QVariant(), const QVariant & <i>arg7</i> = QVariant(), const QVariant & <i>arg8</i> = QVariant(), const QVariant & <i>arg9</i> = QVariant() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#isChecked">isChecked</a></b> ( const QString & <i>queryPath</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#isChecked-2">isChecked</a></b> ( const QString & <i>item</i>, const QString & <i>queryPath</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#isEnabled">isEnabled</a></b> ( const QString & <i>queryPath</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#isVisible">isVisible</a></b> ( const QString & <i>queryPath</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#keyClick">keyClick</a></b> ( Qt::Key <i>key</i>, const QString & <i>queryPath</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#keyClickHold">keyClickHold</a></b> ( Qt::Key <i>key</i>, int <i>duration</i>, const QString & <i>queryPath</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#keyPress">keyPress</a></b> ( Qt::Key <i>key</i>, const QString & <i>queryPath</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#keyRelease">keyRelease</a></b> ( Qt::Key <i>key</i>, const QString & <i>queryPath</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">LabelOrientation </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#labelOrientation">labelOrientation</a></b> ()</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#mouseClick">mouseClick</a></b> ( int <i>x</i>, int <i>y</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#mouseClick-2">mouseClick</a></b> ( const QString & <i>queryPath</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#mouseClickHold">mouseClickHold</a></b> ( int <i>x</i>, int <i>y</i>, int <i>duration</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#mouseClickHold-2">mouseClickHold</a></b> ( const QString & <i>queryPath</i>, int <i>duration</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#mousePreferred">mousePreferred</a></b> ()</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#mousePress">mousePress</a></b> ( int <i>x</i>, int <i>y</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#mousePress-2">mousePress</a></b> ( const QString & <i>queryPath</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#mouseRelease">mouseRelease</a></b> ( int <i>x</i>, int <i>y</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#mouseRelease-2">mouseRelease</a></b> ( const QString & <i>queryPath</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#prompt">prompt</a></b> ( const QString & <i>promptText</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#putData">putData</a></b> ( const QByteArray & <i>data</i>, const QString & <i>destFile</i>, QFile::Permissions <i>permissions</i> = 0 )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#putFile">putFile</a></b> ( const QString & <i>srcFile</i>, const QString & <i>destFile</i>, QFile::Permissions <i>permissions</i> = 0 )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#readLocalFile">readLocalFile</a></b> ( const QString & <i>file</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#runProcess">runProcess</a></b> ( const QString & <i>application</i>, const QStringList & <i>args</i>, const QString & <i>input</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#runsOnDevice">runsOnDevice</a></b> ()</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#saveScreen">saveScreen</a></b> ( const QString & <i>name</i>, const QString & <i>queryPath</i> = "qpe:" )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#select">select</a></b> ( const QString & <i>item</i>, const QString & <i>queryPath</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#selectIndex">selectIndex</a></b> ( const QVariantList & <i>index</i>, const QString & <i>queryPath</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#setCheckState">setCheckState</a></b> ( int <i>state</i>, const QString & <i>queryPath</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#setChecked">setChecked</a></b> ( bool <i>doCheck</i>, const QString & <i>queryPath</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#setChecked-2">setChecked</a></b> ( bool <i>doCheck</i>, const QString & <i>item</i>, const QString & <i>queryPath</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#setClipboardText">setClipboardText</a></b> ( const QString & <i>text</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#setLabelOrientation">setLabelOrientation</a></b> ( LabelOrientation <i>orientation</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#setMousePreferred">setMousePreferred</a></b> ( bool <i>useMouse</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#setProperty">setProperty</a></b> ( const QString & <i>queryPath</i>, const QString & <i>name</i>, const QVariant & <i>value</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#setSetting">setSetting</a></b> ( const QString & <i>file</i>, const QString & <i>group</i>, const QString & <i>key</i>, const QVariant & <i>value</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#setSetting-2">setSetting</a></b> ( const QString & <i>organization</i>, const QString & <i>application</i>, const QString & <i>group</i>, const QString & <i>key</i>, const QVariant & <i>value</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#setVisibleResponseTime">setVisibleResponseTime</a></b> ( int <i>time</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#signature">signature</a></b> ( const QString & <i>labelText</i>, int <i>offset</i> = 0 )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#skip">skip</a></b> ( const QString & <i>message</i>, SkipMode <i>mode</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#startApplication">startApplication</a></b> ( const QString & <i>application</i>, const QStringList & <i>arguments</i> = QStringList(), int <i>timeout</i> = 5000, QSystemTest::StartApplicationFlags <i>flags</i> = QSystemTest::WaitForFocus )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#strict">strict</a></b> ( bool <i>on</i> = true )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#tabBar">tabBar</a></b> ( int <i>index</i> = 0 )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#translate">translate</a></b> ( const QString & <i>context</i>, const QString & <i>text</i>, const QString & <i>comment</i> = QString(), int <i>n</i> = 0 )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#userName">userName</a></b> ()</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#verify">verify</a></b> ( Boolean <i>condition</i>, String <i>message</i> = null )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#verifyImage">verifyImage</a></b> ( const QString & <i>expectedName</i>, const QString & <i>queryPath</i> = QString(), const QString & <i>comment</i> = QString(), const QStringList & <i>maskedWidgets</i> = QStringList() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#visibleResponseTime">visibleResponseTime</a></b> ()</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#wait">wait</a></b> ( int <i>msecs</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#waitExpectedMessageBox">waitExpectedMessageBox</a></b> ( uint <i>timeout</i>, bool <i>waitForAll</i> = true, const QString & <i>title</i> = QString(), const QString & <i>text</i> = QString() )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#waitFor">waitFor</a></b> ( Number <i>timeout</i> = 10000, Number <i>intervals</i> = 20, String <i>message</i> = null )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qsystemtest.html#waitForTitle">waitForTitle</a></b> ( const QString & <i>title</i>, int <i>timeout</i> = 0 )</td></tr> +</table> +<a name="details"></a> +<hr /> +<h2>Detailed Description</h2> +<p>The QSystemTest namespace provides script based system test functionality for Qt.</p> +<p>This documentation describes the API reference for the <a href="qtuitest.html">QtUiTest</a> scripting language. Please read the <a href="qtuitest-manual.html">QtUiTest Manual</a> for a full description of the system test tool.</p> +<hr /> +<h2>Type Documentation</h2> +<h3 class="fn"><a name="Array-typedef"></a>typedef Array</h3> +<p>The Array type as documented in ECMA-262, section 15.4.</p> +<p>The following extensions are provided in <a href="qtuitest.html">QtUiTest</a>.</p> +<p><table class="generic" align="center" cellpadding="2" cellspacing="1" border="0"> +<tr valign="top" class="odd"><td><tt><a href="qsystemtest.html#Boolean-typedef">Boolean</a> Array.prototype.contains(value)</tt></td><td>Returns true if the array contains the given value.</td></tr> +</table></p> +<h3 class="fn"><a name="Boolean-typedef"></a>typedef Boolean</h3> +<p>The Boolean type as documented in ECMA-262, section 15.6.</p> +<h3 class="fn"><a name="EnterMode-enum"></a>enum QSystemTest::EnterMode</h3> +<p>This enum specifies whether <a href="qsystemtest.html#enter">enter</a>() should commit the entered value (eg, by simulating a Select keypress) or not.</p> +<p><table class="valuelist" border="1" cellpadding="2" cellspacing="1" width="100%"> +<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr> +<tr><td valign="top"><tt>QSystemTest::Commit</tt></td><td align="center" valign="top"><tt>0x00</tt></td><td valign="top">Commit the value (default).</td></tr> +<tr><td valign="top"><tt>QSystemTest::NoCommit</tt></td><td align="center" valign="top"><tt>0x01</tt></td><td valign="top">Do not commit the value.</td></tr> +</table></p> +<h3 class="fn"><a name="Function-typedef"></a>typedef Function</h3> +<p>The Function type as documented in ECMA-262, section 15.3.</p> +<h3 class="fn"><a name="LabelOrientation-enum"></a>enum QSystemTest::LabelOrientation</h3> +<p>This enum is used to indicate the expected position of a label relative to the widget it is associated with. Use <a href="qsystemtest.html#setLabelOrientation">setLabelOrientation</a>() to change the expected layout.</p> +<p><table class="valuelist" border="1" cellpadding="2" cellspacing="1" width="100%"> +<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr> +<tr><td valign="top"><tt>QSystemTest::LabelLeft</tt></td><td align="center" valign="top"><tt>0x01</tt></td><td valign="top">Label is located to left of widget.</td></tr> +<tr><td valign="top"><tt>QSystemTest::LabelRight</tt></td><td align="center" valign="top"><tt>0x02</tt></td><td valign="top">Label is located to right of widget.</td></tr> +<tr><td valign="top"><tt>QSystemTest::LabelAbove</tt></td><td align="center" valign="top"><tt>0x03</tt></td><td valign="top">Label is located above widget.</td></tr> +<tr><td valign="top"><tt>QSystemTest::LabelBelow</tt></td><td align="center" valign="top"><tt>0x04</tt></td><td valign="top">Label is located below widget.</td></tr> +</table></p> +<p>See also <a href="qsystemtest.html#labelOrientation">labelOrientation</a>() and <a href="qsystemtest.html#setLabelOrientation">setLabelOrientation</a>().</p> +<h3 class="fn"><a name="Number-typedef"></a>typedef Number</h3> +<p>The Number type as documented in ECMA-262, section 15.7.</p> +<h3 class="fn"><a name="QVariantArray-typedef"></a>typedef QVariantArray</h3> +<p>An <a href="qsystemtest.html#Array-typedef">Array</a> object in which every element is a QVariant.</p> +<h3 class="fn"><a name="Role-enum"></a>enum QSystemTest::Role</h3> +<h3 class="fn"><a name="SkipMode-enum"></a>enum QSystemTest::SkipMode</h3> +<p>This enum describes the modes for skipping tests during execution of the test data.</p> +<p><table class="valuelist" border="1" cellpadding="2" cellspacing="1" width="100%"> +<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr> +<tr><td valign="top"><tt>QSystemTest::SkipSingle</tt></td><td align="center" valign="top"><tt>0x01</tt></td><td valign="top">Skip the rest of this test function for the current test data entry, but continue execution of the remaining test data.</td></tr> +<tr><td valign="top"><tt>QSystemTest::SkipAll</tt></td><td align="center" valign="top"><tt>0x02</tt></td><td valign="top">Skip the rest of this test function, and do not process any further test data for this test function.</td></tr> +</table></p> +<p>See also <a href="qsystemtest.html#skip">skip</a>() and QTest::SkipMode.</p> +<h3 class="flags"><a name="StartApplicationFlag-enum"></a>enum QSystemTest::StartApplicationFlag<br />flags QSystemTest::StartApplicationFlags</h3> +<p>This enum describes additional behaviour to use when starting applications by <a href="qsystemtest.html#startApplication">startApplication</a>().</p> +<p><table class="valuelist" border="1" cellpadding="2" cellspacing="1" width="100%"> +<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr> +<tr><td valign="top"><tt>QSystemTest::NoFlag</tt></td><td align="center" valign="top"><tt>0x00</tt></td><td valign="top">Don't apply any of the below flags.</td></tr> +<tr><td valign="top"><tt>QSystemTest::WaitForFocus</tt></td><td align="center" valign="top"><tt>0x01</tt></td><td valign="top">Wait for the application to gain keyboard focus before returning.</td></tr> +<tr><td valign="top"><tt>QSystemTest::BackgroundCurrentApplication</tt></td><td align="center" valign="top"><tt>0x02</tt></td><td valign="top">Use multitasking to background the current application. The default behaviour is to exit the current application.</td></tr> +</table></p> +<p>The StartApplicationFlags type is a typedef for <a href="qflags.html">QFlags</a><StartApplicationFlag>. It stores an OR combination of StartApplicationFlag values.</p> +<h3 class="flags"><a name="StateFlag-enum"></a>enum QSystemTest::StateFlag<br />flags QSystemTest::State</h3> +<p>The State type is a typedef for <a href="qflags.html">QFlags</a><StateFlag>. It stores an OR combination of StateFlag values.</p> +<h3 class="fn"><a name="StringArray-typedef"></a>typedef StringArray</h3> +<p>An <a href="qsystemtest.html#Array-typedef">Array</a> object in which every element is a String.</p> +<hr /> +<h2>Function Documentation</h2> +<h3 class="fn"><a name="Q_ENUMS"></a>QSystemTest::Q_ENUMS ( <a href="qsystemtest.html#SkipMode-enum">SkipMode</a> )</h3> +<h3 class="fn"><a name="activate"></a>void QSystemTest::activate ( const QString & <i>queryPath</i> ) <tt> [slot]</tt></h3> +<p>Activate the widget specified by <i>queryPath</i>. This is typically used to activate button widgets.</p> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a>.</p> +<h3 class="fn"><a name="addExpectedMessageBox"></a>void QSystemTest::addExpectedMessageBox ( const QString & <i>title</i>, const QString & <i>text</i>, const QString & <i>option</i> = QString() ) <tt> [slot]</tt></h3> +<p>Informs the test that a message box is expected to pop up (soon) with the given <i>title</i> and <i>text</i>. When <i>option</i> is specified <a href="qtuitest.html">QtUiTest</a> will try to activate a menu item from the softmenu that has the text specified by <i>option</i>. If a message box appears while executing a test which hasn't been marked as expected, the current test fails.</p> +<p>When the message box appears, the user-visible <i>option</i> will be selected.</p> +<p>Use this function when <a href="qsystemtest.html#expectMessageBox">expectMessageBox</a>() is unsuitable, e.g. when several different types of message boxes might occur.</p> +<p>Example:</p> +<pre> addExpectedMessageBox("Calendar", "Are you sure you want to delete:"); + addExpectedMessageBox("Delete Event", "This appointment is part of"); + select( "Delete event", optionsMenu() ); + waitExpectedMessageBox(4000,false); + if (currentTitle() == "Delete Event") select( "Back", softMenu() ) + else if (currentTitle() == "Calendar") select( "Yes", softMenu() ); + clearExpectedMessageBoxes();</pre> +<p>See also <a href="qsystemtest.html#expectMessageBox">expectMessageBox</a>(), <a href="qsystemtest.html#clearExpectedMessageBox">clearExpectedMessageBox</a>(), <a href="qsystemtest.html#clearExpectedMessageBoxes">clearExpectedMessageBoxes</a>(), and <a href="qsystemtest.html#waitExpectedMessageBox">waitExpectedMessageBox</a>().</p> +<h3 class="fn"><a name="checkOS"></a>bool QSystemTest::checkOS ( const QString & ) <tt> [slot]</tt></h3> +<h3 class="fn"><a name="checkState"></a>int QSystemTest::checkState ( const QString & <i>queryPath</i> ) <tt> [slot]</tt></h3> +<p>Returns the checked state of the checkbox-like widget specified by <i>queryPath</i>. Checkbox-like widgets include QCheckBox and anything inheriting QAbstractButton.</p> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a>, <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>, <a href="qsystemtest.html#isChecked">isChecked</a>(), and <a href="qsystemtest.html#setCheckState">setCheckState</a>().</p> +<h3 class="fn"><a name="clearExpectedMessageBox"></a>void QSystemTest::clearExpectedMessageBox ( const QString & <i>title</i>, const QString & <i>text</i> ) <tt> [slot]</tt></h3> +<p>Removes the message box with the given <i>title</i> and <i>text</i> from the list of expected message boxes.</p> +<p>See also <a href="qsystemtest.html#addExpectedMessageBox">addExpectedMessageBox</a>() and <a href="qsystemtest.html#waitExpectedMessageBox">waitExpectedMessageBox</a>().</p> +<h3 class="fn"><a name="clearExpectedMessageBoxes"></a>void QSystemTest::clearExpectedMessageBoxes () <tt> [slot]</tt></h3> +<p>Clears the list of expected message boxes.</p> +<p>See also <a href="qsystemtest.html#addExpectedMessageBox">addExpectedMessageBox</a>(), <a href="qsystemtest.html#waitExpectedMessageBox">waitExpectedMessageBox</a>(), and <a href="qsystemtest.html#clearExpectedMessageBox">clearExpectedMessageBox</a>().</p> +<h3 class="fn"><a name="compare"></a>void QSystemTest::compare ( Variant <i>actual</i>, Variant <i>expected</i> )</h3> +<p>Verifies that <i>actual</i> is equal to <i>expected</i>. If this is not the case, the current test fails.</p> +<p>Note that the order of <i>actual</i> and <i>expected</i> is significant, as it affects the test failure message.</p> +<h3 class="fn"><a name="compareImage"></a>bool QSystemTest::compareImage ( const QString & <i>expectedName</i>, const QString & <i>queryPath</i>, const QStringList & <i>maskedWidgets</i> = QStringList() ) <tt> [slot]</tt></h3> +<p>Compares the widget specified by <i>queryPath</i> against the reference snapshot <i>expectedName</i>.</p> +<p><i>maskedWidgets</i> is a list of query paths specifying widgets to be excluded from the snapshot. This allows constantly changing widgets to be hidden from view while the snapshot is taken.</p> +<p>Returns true if the images match, or false otherwise.</p> +<p>The reference snapshot can be one previously learned using <a href="qsystemtest.html#verifyImage">verifyImage</a>(), or an image saved using <a href="qsystemtest.html#saveScreen">saveScreen</a>(), in which case the .png filename extension must be specified.</p> +<p>See also <a href="qsystemtest.html#verifyImage">verifyImage</a>() and <a href="qsystemtest.html#saveScreen">saveScreen</a>().</p> +<h3 class="fn"><a name="currentApplication"></a>QString QSystemTest::currentApplication () <tt> [slot]</tt></h3> +<p>Returns the name of the application which currently has keyboard focus. The name will be the name returned by QCoreApplication::applicationName(), which is typically the name of the executable file.</p> +<p>Example:</p> +<pre> compare( currentApplication(), "addressbook" );</pre> +<h3 class="fn"><a name="currentTitle"></a>QString QSystemTest::currentTitle ( const QString & <i>queryPath</i> = QString() ) <tt> [slot]</tt></h3> +<p>Returns the current window title for the application specified by <i>queryPath</i>. If <i>queryPath</i> contains a widget component, it will be ignored.</p> +<p>Example:</p> +<pre> startApplication("Contacts") ); + + ... + +<span class="comment"> // Make sure we are still in contacts</span> + compare( currentTitle(), "Contacts" );</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a>.</p> +<h3 class="fn"><a name="deletePath"></a>void QSystemTest::deletePath ( const QString & <i>path</i> ) <tt> [slot]</tt></h3> +<p>Delete <i>path</i> from the test system. Can be a file, or can be a directory tree, in which case the entire tree is recursively deleted. If <i>path</i> contains environment variables, they will be expanded on the test system.</p> +<p>Example:</p> +<pre><span class="comment"> // Force test system to start with clean settings</span> + deletePath("$HOME/Settings");</pre> +<p>See also <a href="qtuitest-manual.html#file-management">File Management</a>.</p> +<h3 class="fn"><a name="enter"></a>void QSystemTest::enter ( const QVariant & <i>value</i>, const QString & <i>queryPath</i> = QString(), <a href="qsystemtest.html#EnterMode-enum">EnterMode</a> <i>mode</i> = Commit ) <tt> [slot]</tt></h3> +<p>Simulates <i>value</i> being entered into the widget specified by <i>queryPath</i>.</p> +<p>Some widgets go into an editing mode when entering text and need to be taken out of the editing mode by e.g. a Qt::Key_Select or by navigating to another field in the dialog. By default, enter() will automatically take whatever action is necessary to commit the text and leave edit mode. Set <i>mode</i> to <a href="qsystemtest.html#EnterMode-enum">NoCommit</a> to override this.</p> +<p>Example:</p> +<pre><span class="comment"> // Enter my job in "Occupation" field</span> + enter( "Dog Walker", "Occupation" ); + +<span class="comment"> // Enter date of birth in "Birthday" field</span> + enter( new Date(1985, 11, 10), "Birthday" ); + +<span class="comment"> // Enter start time in "Start" field</span> + enter( new QTime(11, 30), "Start" );</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and Keypad Simulation.</p> +<h3 class="fn"><a name="expectApplicationClose"></a>void QSystemTest::expectApplicationClose ( bool <i>value</i> ) <tt> [slot]</tt></h3> +<p>Indicate to the test framework if the application under test is expected to close.</p> +<p>If <i>value</i> is true, the test framework will not report a failure when it loses its connection to the application. If <i>value</i> is false, unexpected application terminations will result in a test failure.</p> +<p>Example:</p> +<pre> expectApplicationClose( true ); + select( "Close" ); <span class="comment">// Selecting this causes the current application to close</span> + expectApplicationClose( false ); <span class="comment">// Resume normal checking</span></pre> +<h3 class="fn"><a name="expectFail"></a>void QSystemTest::expectFail ( const QString & <i>reason</i> ) <tt> [virtual slot]</tt></h3> +<p>Uses the <i>reason</i> to mark the current testfunction as expected to fail.</p> +<h3 class="fn"><a name="expectMessageBox"></a>void QSystemTest::expectMessageBox ( String <i>title</i>, String <i>text</i>, String <i>option</i>, <a href="qsystemtest.html#Number-typedef">Number</a> <i>timeout</i> )</h3> +<p>Denotes the start of a block of code which, immediately after or during execution, should cause a message box to pop up with the given <i>title</i> and <i>text</i>. When the message box appears, the given menu <i>option</i> will be chosen from the message box softmenu bar (if one exists).</p> +<p>If the message box hasn't appeared by the end of the block of code, the test will wait until the <i>timeout</i> expires. If it still doesn't appear, the current test fails.</p> +<p>If a message box appears which hasn't been marked as expected, the current test fails.</p> +<p>Example:</p> +<pre><span class="comment"> // Delete a contact - select "Yes" on the popped-up message box</span> +<span class="comment"> // If the message box doesn't pop up, the test fails.</span> + expectMessageBox("Contacts", "Are you sure you want to delete: " + contact_name + "?", "Yes") { + select("Delete contact", optionsMenu()); + }</pre> +<h3 class="fn"><a name="fail"></a>void QSystemTest::fail ( String <i>message</i> )</h3> +<p>Immediately fail the current test with the specified <i>message</i>.</p> +<h3 class="fn"><a name="findByProperty"></a>QStringList QSystemTest::findByProperty ( const QString & <i>property</i>, const QVariant & <i>searchValue</i> ) <tt> [slot]</tt></h3> +<p>Returns the signatures of the widgets that have <i>property</i> matching <i>value</i>. This can be used to identify widgets that do not have an associated label text.</p> +<p>In addition to normal QObject properties, "inherits" and "className" may also be used, with the class specified as a string.</p> +<p>Example:</p> +<pre><span class="comment"> // Select the button with the tool tip "Quit"</span> +<span class="comment"> // assumes that only one widget will match</span> + var button = findByProperty("toolTip", "Quit"); + activate(button);</pre> +<p>If more than one widget matches, the list returned is sorted by widget position.</p> +<p>See also <a href="qsystemtest.html#signature">signature</a>(), <a href="qtuitest-manual.html#query-paths">Query Paths</a>, and <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>.</p> +<h3 class="fn"><a name="findByProperty-2"></a>QStringList QSystemTest::findByProperty ( const QVariantMap & <i>searchValues</i> ) <tt> [slot]</tt></h3> +<p>Returns the signatures of the widgets that match all of the property values specified in <i>searchValues</i>.</p> +<p>This can be used to identify widgets that do not have an associated label text.</p> +<p>Example:</p> +<pre><span class="comment"> // Select the button with the tool tip "Quit"</span> +<span class="comment"> // assumes that only one widget will match</span> + var button = findByProperty( {className: "QToolButton", + toolTip: "Quit"} ); + activate(button);</pre> +<p>If more than one widget matches, the list returned is sorted by widget position.</p> +<p>See also <a href="qsystemtest.html#signature">signature</a>(), <a href="qtuitest-manual.html#query-paths">Query Paths</a>, and <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>.</p> +<h3 class="fn"><a name="focusWidget"></a>QString QSystemTest::focusWidget ( const QString & <i>queryPath</i> = QString() ) <tt> [slot]</tt></h3> +<p>Returns the name of the specific widget with input focus specified by <i>queryPath</i>. If <i>queryPath</i> refers to a widget, then the name of the child widget with focus will be returned, otherwise all widgets in the specified application will be queried.</p> +<p>Example:</p> +<pre><span class="comment"> // Get the currently focused widget in the current app</span> + print( focusWidget() );</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a>.</p> +<h3 class="fn"><a name="getClipboardText"></a>QString QSystemTest::getClipboardText () <tt> [slot]</tt></h3> +<p>Returns text stored in the clipboard, or an empty string if the clipboard does not contain any text.</p> +<p>See also <a href="qsystemtest.html#setClipboardText">setClipboardText</a>().</p> +<h3 class="fn"><a name="getData"></a>QString QSystemTest::getData ( const QString & <i>srcFile</i> ) <tt> [slot]</tt></h3> +<p>Reads <i>srcFile</i> from the test system and returns its contents. if <i>srcFile</i> contains environment variables, they will be expanded on the test system.</p> +<p>See also <a href="qtuitest-manual.html#file-management">File Management</a>, <a href="qsystemtest.html#getFile">getFile</a>(), <a href="qsystemtest.html#putData">putData</a>(), and <a href="qsystemtest.html#putFile">putFile</a>().</p> +<h3 class="fn"><a name="getDateTime"></a>QDateTime QSystemTest::getDateTime () <tt> [slot]</tt></h3> +<p>Returns the current date and time of the test system.</p> +<h3 class="fn"><a name="getDirectoryEntries"></a>QStringList QSystemTest::getDirectoryEntries ( const QString & <i>dir</i>, QDir::Filters <i>filters</i> = QDir::NoFilter ) <tt> [slot]</tt></h3> +<p>List the contents of directory <i>dir</i> on the test system, applying <i>filters</i> to the listing. If <i>dir</i> contains environment variables, they will be expanded on the test system.</p> +<p>The returned listing will be relative to <i>dir</i>.</p> +<p>Example:</p> +<pre><span class="comment"> // Delete entire contents of Documents directory on the test system</span> + var list = getDirectoryEntries( documentsPath(), QDir.AllEntries); + for (var i = 0; i < list.length; ++i) { + deletePath( documentsPath() + list[i]); + }</pre> +<p>See also QDir::entryList() and <a href="qtuitest-manual.html#file-management">File Management</a>.</p> +<h3 class="fn"><a name="getFile"></a>void QSystemTest::getFile ( const QString & <i>srcFile</i>, const QString & <i>destFile</i> ) <tt> [slot]</tt></h3> +<p>Retrieves <i>srcFile</i> from the test system and copies it to <i>destFile</i> on the local machine. if <i>srcFile</i> contains environment variables, they will be expanded on the test system.</p> +<p>Example:</p> +<pre><span class="comment"> // Copy a settings file to the local machine</span> + getFile("$HOME/Settings/foo.conf", "/tmp/foo.conf" );</pre> +<p>See also <a href="qtuitest-manual.html#file-management">File Management</a>, <a href="qsystemtest.html#getData">getData</a>(), <a href="qsystemtest.html#putData">putData</a>(), and <a href="qsystemtest.html#putFile">putFile</a>().</p> +<h3 class="fn"><a name="getGeometry"></a>QRect QSystemTest::getGeometry ( const QString & <i>queryPath</i> = QString() ) <tt> [slot]</tt></h3> +<p>Returns geometry of the widget specified in <i>queryPath</i>, with position (x,y) co-ordinates being global. Note: QRect does not have toString() method, refer to QRect docs for methods returning common types.</p> +<p>Example:</p> +<pre><span class="comment"> // pass the test if widgets do not overlap</span> + var first_widget = getGeometry("Button1"); + var second_widget = getGeometry("Button2"); +<span class="comment"> // intersects returns true on overlap, false when not; verify causes test to fail on false</span> + verify( !first_widget.intersects(second_widget), "Specified widgets overlap.");</pre> +<p>Example two - a non-mainstream situation:</p> +<p><a href="qsystemtest.html#select">select</a>() may work in an undefined manner with custom widgets/items, implementing custom <a href="qsystemtest.html#select">select</a>() methods isn't ideal - each would require writing and testing. On a device with a primary input method of mouse/touchscreen there may not be key code mapping for keys which don't exist - therefore mouse events should be used. However devices may have different geometry, and widget geometry can change between invocations. The example below uses <a href="qsystemtest.html#mouseClick">mouseClick</a>() without prior geometry knowledge, though a way is needed to determine where to click, the example shows <a href="qsystemtest.html#mouseClick">mouseClick</a>() in the middle of an area defined by the 4th col and 4th row in a uniform grid of the area of the active widget.</p> +<pre><span class="comment"> // mouseClick() a widget or item with a fixed position inside its parent widget</span> + var geo = getGeometry(); + var select_x = geo.x() + (( geo.width() / 8) * 7); + var select_y = geo.y() + (( geo.height() / 8) * 7); + mouseClick(select_x, select_y);</pre> +<p>See also <a href="qsystemtest.html#select">select</a>(), <a href="qsystemtest.html#mouseClick">mouseClick</a>(), and QRect.</p> +<h3 class="fn"><a name="getLabels"></a>QStringList QSystemTest::getLabels ( const QString & <i>queryPath</i> = QString() ) <tt> [slot]</tt></h3> +<p>Returns a list of all the labels that are visible in the current active window or the widget specified by <i>queryPath</i>. A label is usually a non-editable widget (such as a QLabel) that is associated with an editable field. The label is used to give the user a visual clue of the meaning of the editable field. Labels are used by the user, and by QtUitest, to navigate to fields.</p> +<p>The items will be returned in the order they are stored in the widget, i.e. from top to bottom.</p> +<p>Example:</p> +<pre><span class="comment"> // Verify that the current dialogs contains Labels named 'Name' and 'Email'</span> + var g = getLabels(); + verify( g.length == 2 ); + verify( g.contains("Name") ); + verify( g.contains("Email") );</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>.</p> +<h3 class="fn"><a name="getList"></a>QStringList QSystemTest::getList ( const QString & <i>queryPath</i> = QString() ) <tt> [slot]</tt></h3> +<p>Returns a list of all items from the list-type widget specified by <i>queryPath</i>.</p> +<p>The items will be returned in the order they are stored in the widget (for example, for a simple list view the items will be returned from top to bottom).</p> +<p>Example:</p> +<pre><span class="comment"> // Verify that "gender" combobox contains male and female only</span> + var g = getList("Gender"); + compare( g.length == 2 ); + verify( g.contains("Male") ); + verify( g.contains("Female") );</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>.</p> +<h3 class="fn"><a name="getLocale"></a>QLocale QSystemTest::getLocale () <tt> [slot]</tt></h3> +<p>Returns the system locale.</p> +<p>See also QLocale::system() and <a href="qsystemtest.html#translate">translate</a>().</p> +<h3 class="fn"><a name="getProperty"></a>QVariant QSystemTest::getProperty ( const QString & <i>queryPath</i>, const QString & <i>name</i> ) <tt> [slot]</tt></h3> +<p>Get the value of the Qt property named <i>name</i> on object <i>queryPath</i> on the test system.</p> +<p>Example:</p> +<pre><span class="comment"> // Get the text of this field without using getText()</span> + var t = getProperty("Name", "text").toString();</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>.</p> +<h3 class="fn"><a name="getSelectedText"></a>QString QSystemTest::getSelectedText ( const QString & <i>queryPath</i> = QString() ) <tt> [slot]</tt></h3> +<p>Returns the currently selected text from the widget specified by <i>queryPath</i>. If no text is selected, returns all text. For list-type widgets, returns the text for the currently selected item.</p> +<p>Example:</p> +<pre><span class="comment"> // Enter text in two fields, then go back to the first</span> +<span class="comment"> // and make sure it still has the right text</span> + enter("Australia", "Home"); + enter("dog walker", "Occupation"); + compare( getSelectedText("Home"), "Australia" );</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>.</p> +<h3 class="fn"><a name="getSelectedValue"></a>QVariant QSystemTest::getSelectedValue ( const QString & <i>queryPath</i> = QString() ) <tt> [slot]</tt></h3> +<p>Returns the currently selected value from the widget specified by <i>queryPath</i>. If no value is selected, returns all data in a single value. For list-type widgets, returns the currently selected value.</p> +<p>See also <a href="qsystemtest.html#getSelectedText">getSelectedText</a>(), <a href="qtuitest-manual.html#query-paths">Query Paths</a>, and <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>.</p> +<h3 class="fn"><a name="getSetting"></a>QVariant QSystemTest::getSetting ( const QString & <i>file</i>, const QString & <i>group</i>, const QString & <i>key</i> ) <tt> [slot]</tt></h3> +<p>Retrieves a QSettings settings value from the test system located in <i>file</i>, settings group <i>group</i>, key <i>key</i>. If <i>file</i> contains environment variables, they will be expanded on the test system.</p> +<p>Example:</p> +<pre><span class="comment"> // What's our primary input mode?</span> + var primaryInput = getSetting("$QPEDIR/etc/defaultbuttons.conf", "Device", "PrimaryInput");</pre> +<p>See also <a href="qsystemtest.html#setSetting">setSetting</a>() and QSettings.</p> +<h3 class="fn"><a name="getSetting-2"></a>QVariant QSystemTest::getSetting ( const QString & <i>organization</i>, const QString & <i>application</i>, const QString & <i>group</i>, const QString & <i>key</i> ) <tt> [slot]</tt></h3> +<p>Retrieves a QSettings settings value from the test system located in the settings file for organization <i>organization</i> and application <i>application</i>, as passed to the QSettings constructor. The settings value retrieved will be group <i>group</i>, key <i>key</i>.</p> +<p>See also <a href="qsystemtest.html#setSetting">setSetting</a>() and QSettings.</p> +<h3 class="fn"><a name="getText"></a>QString QSystemTest::getText ( const QString & <i>queryPath</i> = QString() ) <tt> [slot]</tt></h3> +<p>Returns all text from the widget specified by <i>queryPath</i>, or the current focus widget if <i>queryPath</i> is not specified. For list-type widgets, returns the text for all items separated by newlines.</p> +<p>Example:</p> +<pre><span class="comment"> // Get current content of "address" field</span> + print( getText("Address") );</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>.</p> +<h3 class="fn"><a name="getValue"></a>QVariant QSystemTest::getValue ( const QString & <i>queryPath</i> = QString() ) <tt> [slot]</tt></h3> +<p>Returns the value from the widget specified by <i>queryPath</i>. For list-type widgets, returns a list containing all values.</p> +<p>See also <a href="qsystemtest.html#getText">getText</a>(), <a href="qtuitest-manual.html#query-paths">Query Paths</a>, and <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>.</p> +<h3 class="fn"><a name="getenv"></a>QString QSystemTest::getenv ( const QString & ) <tt> [slot]</tt></h3> +<h3 class="fn"><a name="ignoreMessageBoxes"></a>void QSystemTest::ignoreMessageBoxes ( bool <i>ignore</i> ) <tt> [slot]</tt></h3> +<p>If <i>ignore</i> is true, message boxes will be ignored by the test framework. Under normal circumstances during automated testing, message boxes need to be processed. However, short-lived, self dismissing message boxes may disappear before the test framework can handle them. Set <i>ignore</i> to false to resume normal processing of message boxes.</p> +<p>See also <a href="qsystemtest.html#addExpectedMessageBox">addExpectedMessageBox</a>(), <a href="qsystemtest.html#expectMessageBox">expectMessageBox</a>(), <a href="qsystemtest.html#clearExpectedMessageBox">clearExpectedMessageBox</a>(), <a href="qsystemtest.html#clearExpectedMessageBoxes">clearExpectedMessageBoxes</a>(), and <a href="qsystemtest.html#waitExpectedMessageBox">waitExpectedMessageBox</a>().</p> +<h3 class="fn"><a name="invokeMethod"></a>bool QSystemTest::invokeMethod ( const QString & <i>queryPath</i>, const QString & <i>method</i>, Qt::ConnectionType <i>type</i>, const QVariant & <i>arg0</i> = QVariant(), const QVariant & <i>arg1</i> = QVariant(), const QVariant & <i>arg2</i> = QVariant(), const QVariant & <i>arg3</i> = QVariant(), const QVariant & <i>arg4</i> = QVariant(), const QVariant & <i>arg5</i> = QVariant(), const QVariant & <i>arg6</i> = QVariant(), const QVariant & <i>arg7</i> = QVariant(), const QVariant & <i>arg8</i> = QVariant(), const QVariant & <i>arg9</i> = QVariant() ) <tt> [slot]</tt></h3> +<p>Invoke method <i>method</i> on object <i>queryPath</i> on the test system. Invokable methods include only Qt signals and slots.</p> +<p>The method will be invoked using the Qt connection type <i>type</i>. This can almost always be Qt::AutoConnection, but in a few cases Qt.QueuedConnection may be necessary (for example, if executing a method that will cause Qt Extended to shutdown, Qt.QueuedConnection should be used to ensure Qt Extended sends a response to the system test before shutting down).</p> +<p>The optional arguments <i>arg0</i>, <i>arg1</i>, <i>arg2</i>, <i>arg3</i>, <i>arg4</i>, <i>arg5</i>, <i>arg6</i>, <i>arg7</i>, <i>arg8</i> and <i>arg9</i> will be passed to the method if given.</p> +<p>Returns true if the method could be invoked, false otherwise.</p> +<p>Example:</p> +<pre><span class="comment"> // Hide this field because it keeps changing and we want a snapshot</span> + verify( invokeMethod("Time", "setVisible(bool)", Qt.AutoConnection, false) ); + verifyImage("good_snapshot"); +<span class="comment"> // Put the field back</span> + verify( invokeMethod("Time", "setVisible(bool)", Qt.AutoConnection, true) );</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>.</p> +<h3 class="fn"><a name="invokeMethod-2"></a>bool QSystemTest::invokeMethod ( const QString & <i>queryPath</i>, const QString & <i>method</i>, const QVariant & <i>arg0</i> = QVariant(), const QVariant & <i>arg1</i> = QVariant(), const QVariant & <i>arg2</i> = QVariant(), const QVariant & <i>arg3</i> = QVariant(), const QVariant & <i>arg4</i> = QVariant(), const QVariant & <i>arg5</i> = QVariant(), const QVariant & <i>arg6</i> = QVariant(), const QVariant & <i>arg7</i> = QVariant(), const QVariant & <i>arg8</i> = QVariant(), const QVariant & <i>arg9</i> = QVariant() ) <tt> [slot]</tt></h3> +<p>This is an overloaded function.</p> +<p>Invokes the given method using connection type Qt.AutoConnection.</p> +<h3 class="fn"><a name="isChecked"></a>bool QSystemTest::isChecked ( const QString & <i>queryPath</i> ) <tt> [slot]</tt></h3> +<p>Returns the checked state of the checkbox-like widget specified by <i>queryPath</i>. Checkbox-like widgets include QCheckBox and anything inheriting QAbstractButton.</p> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a>, <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>, <a href="qsystemtest.html#setChecked">setChecked</a>(), and <a href="qsystemtest.html#checkState">checkState</a>().</p> +<h3 class="fn"><a name="isChecked-2"></a>bool QSystemTest::isChecked ( const QString & <i>item</i>, const QString & <i>queryPath</i> ) <tt> [slot]</tt></h3> +<p>Returns the checked state of <i>item</i> in the widget specified by <i>queryPath</i>.</p> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a>, <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>, <a href="qsystemtest.html#setChecked">setChecked</a>(), and <a href="qsystemtest.html#checkState">checkState</a>().</p> +<h3 class="fn"><a name="isEnabled"></a>bool QSystemTest::isEnabled ( const QString & <i>queryPath</i> ) <tt> [slot]</tt></h3> +<p>The function returns whether the widget specified by <i>queryPath</i> is enabled.</p> +<p>Example:</p> +<pre><span class="comment"> // Verify the AM/PM field is disabled when using 24 hour format</span> + select("24 hour", "Time format"); + verify( !isEnabled("AM-PM"), "AM-PM field still enabled." );</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>.</p> +<h3 class="fn"><a name="isVisible"></a>bool QSystemTest::isVisible ( const QString & <i>queryPath</i> ) <tt> [slot]</tt></h3> +<p>Returns true if the widget specified by <i>queryPath</i> exists and is currently visible to the user.</p> +<p>The widget is considered to be visible to the user if QWidget::visibleRegion() returns a non-empty region. Thus, isVisible() will return true if even a single pixel of the widget is unobscured.</p> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>.</p> +<h3 class="fn"><a name="keyClick"></a>void QSystemTest::keyClick ( Qt::Key <i>key</i>, const QString & <i>queryPath</i> = QString() ) <tt> [slot]</tt></h3> +<p>Simulates a <i>key</i> click (press and release) for the application specified by <i>queryPath</i>. <i>key</i> is a string describing the key to be released.</p> +<p>Example:</p> +<pre><span class="comment"> // Go right 5 times, then select</span> + for (int i = 0; i < 5; ++i) keyClick( Qt.Key_Right ); + keyClick( Qt.Key_Select );</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and Keypad Simulation.</p> +<h3 class="fn"><a name="keyClickHold"></a>void QSystemTest::keyClickHold ( Qt::Key <i>key</i>, int <i>duration</i>, const QString & <i>queryPath</i> = QString() ) <tt> [slot]</tt></h3> +<p>Simulates a <i>key</i> click and hold (press + wait + release) for <i>queryPath</i>. The interval between press and release is set in milliseconds by <i>duration</i>.</p> +<p>Example:</p> +<pre><span class="comment"> // Hold hangup key to bring up shutdown app</span> + keyClickHold(Qt.Key_Hangup, 3000);</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and Keypad Simulation.</p> +<h3 class="fn"><a name="keyPress"></a>void QSystemTest::keyPress ( Qt::Key <i>key</i>, const QString & <i>queryPath</i> = QString() ) <tt> [slot]</tt></h3> +<p>Simulates a <i>key</i> press for the application specified by <i>queryPath</i>. <i>key</i> is a Qt::Key describing the key to be pressed.</p> +<p>Example:</p> +<pre><span class="comment"> // Press (do not release) F23 key in current app</span> + keyPress( Qt.Key_F23 );</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and Keypad Simulation.</p> +<h3 class="fn"><a name="keyRelease"></a>void QSystemTest::keyRelease ( Qt::Key <i>key</i>, const QString & <i>queryPath</i> = QString() ) <tt> [slot]</tt></h3> +<p>Simulates a <i>key</i> release for the application specified by <i>queryPath</i>. <i>key</i> is a Qt::Key describing the key to be released.</p> +<p>Example:</p> +<pre><span class="comment"> // Release Up key in current app</span> + keyRelease( Qt.Key_Up );</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and Keypad Simulation.</p> +<h3 class="fn"><a name="labelOrientation"></a><a href="qsystemtest.html#LabelOrientation-enum">LabelOrientation</a> QSystemTest::labelOrientation () <tt> [slot]</tt></h3> +<p>Returns the label orientation, used by <a href="qtuitest.html">QtUiTest</a> to assign labels to widgets.</p> +<p>See also <a href="qsystemtest.html#setLabelOrientation">setLabelOrientation</a>().</p> +<h3 class="fn"><a name="mouseClick"></a>void QSystemTest::mouseClick ( int <i>x</i>, int <i>y</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton ) <tt> [slot]</tt></h3> +<p>Simulates a mouse click / touchscreen tap at co-ordinates ( <i>x</i>, <i>y</i> ).</p> +<p>Example:</p> +<pre> mouseClick(200, 300);</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#mouse-touchscreen-simulation">Mouse / Touchscreen Simulation</a>.</p> +<h3 class="fn"><a name="mouseClick-2"></a>void QSystemTest::mouseClick ( const QString & <i>queryPath</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton ) <tt> [slot]</tt></h3> +<p>Simulates a mouse click / touchscreen tap at the center of the widget specified by <i>queryPath</i>.</p> +<p>Example:</p> +<pre><span class="comment"> // Click on Accept button</span> + mouseClick("Accept");</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#mouse-touchscreen-simulation">Mouse / Touchscreen Simulation</a>.</p> +<h3 class="fn"><a name="mouseClickHold"></a>void QSystemTest::mouseClickHold ( int <i>x</i>, int <i>y</i>, int <i>duration</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton ) <tt> [slot]</tt></h3> +<p>Simulates a mouse click / touchscreen tap at co-ordinates ( <i>x</i>, <i>y</i> ), with a custom <i>duration</i> in milliseconds between press and release.</p> +<p>Example:</p> +<pre><span class="comment"> // Hold at (200, 300) for three seconds</span> + mouseClickHold(200, 300, 3000);</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#mouse-touchscreen-simulation">Mouse / Touchscreen Simulation</a>.</p> +<h3 class="fn"><a name="mouseClickHold-2"></a>void QSystemTest::mouseClickHold ( const QString & <i>queryPath</i>, int <i>duration</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton ) <tt> [slot]</tt></h3> +<p>Simulates a mouse click / touchscreen tap at the center of the widget specified by <i>queryPath</i>, with a custom <i>duration</i> in milliseconds between press and release.</p> +<p>Example:</p> +<pre><span class="comment"> // Hold on the "Shutdown" button for three seconds</span> + mouseClickHold("Shutdown", 3000);</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#mouse-touchscreen-simulation">Mouse / Touchscreen Simulation</a>.</p> +<h3 class="fn"><a name="mousePreferred"></a>bool QSystemTest::mousePreferred () <tt> [slot]</tt></h3> +<p>Returns true if the primary input method is mouse/touchscreen.</p> +<p>See also <a href="qsystemtest.html#setMousePreferred">setMousePreferred</a>().</p> +<h3 class="fn"><a name="mousePress"></a>void QSystemTest::mousePress ( int <i>x</i>, int <i>y</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton ) <tt> [slot]</tt></h3> +<p>Simulates a mouse / touchscreen press at co-ordinates ( <i>x</i>, <i>y</i> ).</p> +<p>Example:</p> +<pre> mousePress(200, 300);</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#mouse-touchscreen-simulation">Mouse / Touchscreen Simulation</a>.</p> +<h3 class="fn"><a name="mousePress-2"></a>void QSystemTest::mousePress ( const QString & <i>queryPath</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton ) <tt> [slot]</tt></h3> +<p>Simulates a mouse / touchscreen press at the center of the widget specified by <i>queryPath</i>.</p> +<p>Example:</p> +<pre><span class="comment"> // Press "Edit" button</span> + mousePress("Edit");</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#mouse-touchscreen-simulation">Mouse / Touchscreen Simulation</a>.</p> +<h3 class="fn"><a name="mouseRelease"></a>void QSystemTest::mouseRelease ( int <i>x</i>, int <i>y</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton ) <tt> [slot]</tt></h3> +<p>Simulates a mouse / touchscreen release at co-ordinates ( <i>x</i>, <i>y</i> ).</p> +<p>Example:</p> +<pre> mouseRelease(200, 300);</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#mouse-touchscreen-simulation">Mouse / Touchscreen Simulation</a>.</p> +<h3 class="fn"><a name="mouseRelease-2"></a>void QSystemTest::mouseRelease ( const QString & <i>queryPath</i>, QFlags<Qt::MouseButton> <i>buttons</i> = Qt::LeftButton ) <tt> [slot]</tt></h3> +<p>Simulates a mouse / touchscreen release at the center of the widget specified by <i>queryPath</i>.</p> +<p>Example:</p> +<pre><span class="comment"> // Release mouse over "Edit" button</span> + mouseRelease("Edit");</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#mouse-touchscreen-simulation">Mouse / Touchscreen Simulation</a>.</p> +<h3 class="fn"><a name="prompt"></a>void QSystemTest::prompt ( const QString & <i>promptText</i> = QString() ) <tt> [slot]</tt></h3> +<p>Displays a dialog with the <i>promptText</i> and Pass/Fail/Record buttons, then waits for a response from the user. If Pass is clicked, the test will continue. If Fail is clicked, a failure will be generated and the current testcase will abort. If Record is clicked, event recording will start and recorded events can be appended to the testcase once recording is finished.</p> +<p>This function is intended to be used for verification of testcases that cannot be fully automated. Testcases containing this function will be skipped if the test is run with the <tt>-auto</tt> option.</p> +<p>Example:</p> +<pre> prompt( "Did something totally amazing just happen?" );</pre> +<h3 class="fn"><a name="putData"></a>void QSystemTest::putData ( const QByteArray & <i>data</i>, const QString & <i>destFile</i>, QFile::Permissions <i>permissions</i> = 0 ) <tt> [slot]</tt></h3> +<p>Transfers <i>data</i> from the local machine and copies it to <i>destFile</i> on the test system. if <i>destFile</i> contains environment variables, they will be expanded on the test system. The file permissions of the destination file can be specified using <i>permissions</i>.</p> +<p>See also <a href="qtuitest-manual.html#file-management">File Management</a> and <a href="qsystemtest.html#putFile">putFile</a>().</p> +<h3 class="fn"><a name="putFile"></a>void QSystemTest::putFile ( const QString & <i>srcFile</i>, const QString & <i>destFile</i>, QFile::Permissions <i>permissions</i> = 0 ) <tt> [slot]</tt></h3> +<p>Transfers <i>srcFile</i> from the local machine and copies it to <i>destFile</i> on the test system. if <i>destFile</i> contains environment variables, they will be expanded on the test system.</p> +<p>By default, the file permissions of the destination file will be set to those of the source file. This can be overridden by specifying <i>permissions</i>.</p> +<p>Example:</p> +<pre><span class="comment"> // Force test system to use certain settings</span> + putFile("testdata/my_settings.conf", "$HOME/Settings/foo.conf"); + +<span class="comment"> // Specify file permissions</span> + putFile("testdata/my_file", "$HOME/my_file", QFile.WriteOwner | QFile.ReadOwner | QFile.ReadOther);</pre> +<p>See also <a href="qtuitest-manual.html#file-management">File Management</a> and <a href="qsystemtest.html#putData">putData</a>().</p> +<h3 class="fn"><a name="readLocalFile"></a>QString QSystemTest::readLocalFile ( const QString & <i>file</i> ) <tt> [slot]</tt></h3> +<p>Reads text from the specified <i>file</i> and returns the contents as a QString.</p> +<p>This can be useful when prompting the user with larger amounts of text.</p> +<p>See also <a href="qtuitest-manual.html#file-management">File Management</a> and <a href="qsystemtest.html#prompt">prompt</a>().</p> +<h3 class="fn"><a name="runProcess"></a>QString QSystemTest::runProcess ( const QString & <i>application</i>, const QStringList & <i>args</i>, const QString & <i>input</i> ) <tt> [slot]</tt></h3> +<p>Runs <i>application</i> with arguments <i>args</i> on the local machine, with <i>input</i> given as standard input. The combined stderr and stdout text will be returned.</p> +<p>If the process fails to run or returns a non-zero exit code, the current test fails.</p> +<h3 class="fn"><a name="runsOnDevice"></a>bool QSystemTest::runsOnDevice () <tt> [slot]</tt></h3> +<p>Returns true if the test is running on an actual device, and false if it is running locally.</p> +<h3 class="fn"><a name="saveScreen"></a>void QSystemTest::saveScreen ( const QString & <i>name</i>, const QString & <i>queryPath</i> = "qpe:" ) <tt> [slot]</tt></h3> +<p>Take a full screenshot and save it as <i>name</i>. The screenshot will be placed in the test data directory in PNG format, and will automatically have .png appended to the name.</p> +<p>This function is intended to be used as a simple way to automate the gathering of screenshots, i.e. to be used in documentation and such.</p> +<p>If a <i>queryPath</i> is specified the snapshot will be limited to the Widget that is identified by the queryPath.</p> +<p>See also <a href="qsystemtest.html#verifyImage">verifyImage</a>().</p> +<h3 class="fn"><a name="select"></a>void QSystemTest::select ( const QString & <i>item</i>, const QString & <i>queryPath</i> = QString() ) <tt> [slot]</tt></h3> +<p>Selects the <i>item</i> from the application/widget specified by <i>queryPath</i>. This can be used to, e.g., select a certain item from a list widget or combo box. select() works with widgets which are conceptually a list, including list views, combo boxes and menus.</p> +<p>When used with a list widget, the specified item is navigated to and no further action is taken.</p> +<p>When used with a combo box, the drop-down list is opened, the item is selected, and the drop-down list is closed again.</p> +<p>Items in submenus are denoted using '/' delimiters (e.g., "View/All" means navigate to the "View" submenu, then the "All" item). Menu items which have a '/' in their name can be escaped using '' (e.g. "Add\/Remove Words").</p> +<p>Example:</p> +<pre><span class="comment"> // Select "Female" from "Gender" field</span> + select("Female", "Gender");</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and Keypad Simulation.</p> +<h3 class="fn"><a name="selectIndex"></a>void QSystemTest::selectIndex ( const QVariantList & <i>index</i>, const QString & <i>queryPath</i> = QString() ) <tt> [slot]</tt></h3> +<p>Selects the item with <i>index</i> from an indexed widget (such as a QAbstractItemView) specified by <i>queryPath</i>.</p> +<p>This function is lower level than using <a href="qsystemtest.html#select">select</a>(), but is more appropriate when there are large numbers of items in the view, or the view contains unnamed or ambiguously named items.</p> +<p>The <i>index</i> is specified as a list of row and column values.</p> +<p>Example:</p> +<pre><span class="comment"> // Select item (row 2, column 3) from table view</span> + select( [2, 3], table );</pre> +<p>The index may be hierarchical, in which case the row and column values should be specified as [row, column, parentRow, parentColumn, ...].</p> +<p>See also <a href="qsystemtest.html#select">select</a>().</p> +<h3 class="fn"><a name="setCheckState"></a>void QSystemTest::setCheckState ( int <i>state</i>, const QString & <i>queryPath</i> ) <tt> [slot]</tt></h3> +<p>Sets the check state of a checkbox-like widget specified by <i>queryPath</i> to <i>state</i>. Checkbox-like widgets include QCheckBox and anything inheriting QAbstractButton.</p> +<p>Example:</p> +<pre><span class="comment"> // Set tri-state button to partially checked state</span> + setCheckState(Qt.PartiallyChecked, "Tri-state button");</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a>, <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>, <a href="qsystemtest.html#checkState">checkState</a>(), and <a href="qsystemtest.html#setChecked">setChecked</a>().</p> +<h3 class="fn"><a name="setChecked"></a>void QSystemTest::setChecked ( bool <i>doCheck</i>, const QString & <i>queryPath</i> ) <tt> [slot]</tt></h3> +<p>Based on the value of <i>doCheck</i> checks or un-checks a checkbox-like widget specified by <i>queryPath</i>. Checkbox-like widgets include QCheckBox and anything inheriting QAbstractButton.</p> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a>, <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>, <a href="qsystemtest.html#isChecked">isChecked</a>(), and <a href="qsystemtest.html#setCheckState">setCheckState</a>().</p> +<h3 class="fn"><a name="setChecked-2"></a>void QSystemTest::setChecked ( bool <i>doCheck</i>, const QString & <i>item</i>, const QString & <i>queryPath</i> ) <tt> [slot]</tt></h3> +<p>Based on the value of <i>doCheck</i> checks or un-checks <i>item</i> in the widget specified by <i>queryPath</i>.</p> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a>, <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>, <a href="qsystemtest.html#isChecked">isChecked</a>(), and <a href="qsystemtest.html#setCheckState">setCheckState</a>().</p> +<h3 class="fn"><a name="setClipboardText"></a>void QSystemTest::setClipboardText ( const QString & <i>text</i> ) <tt> [slot]</tt></h3> +<p>Copies <i>text</i> into the clipboard.</p> +<p>See also <a href="qsystemtest.html#getClipboardText">getClipboardText</a>().</p> +<h3 class="fn"><a name="setLabelOrientation"></a>void QSystemTest::setLabelOrientation ( <a href="qsystemtest.html#LabelOrientation-enum">LabelOrientation</a> <i>orientation</i> ) <tt> [slot]</tt></h3> +<p>Set the expected label orientation to <i>orientation</i>. This value is used by <a href="qtuitest.html">QtUiTest</a> to work out which labels refer to which widgets. By default, this value is <a href="qsystemtest.html#LabelOrientation-enum">LabelLeft</a> (on left-to-right locales) or <a href="qsystemtest.html#LabelOrientation-enum">LabelRight</a> (on right-to-left locales).</p> +<p>The setting will remain active until the application under test closes, or until the value is changed by another call to setLabelOrientation().</p> +<p>See also <a href="qsystemtest.html#labelOrientation">labelOrientation</a>().</p> +<h3 class="fn"><a name="setMousePreferred"></a>void QSystemTest::setMousePreferred ( bool <i>useMouse</i> ) <tt> [slot]</tt></h3> +<p>If <i>useMouse</i> is true, indicates that <a href="qtuitest.html">QtUiTest</a> should use mouse/touchscreen events to select items on the screen. If false, the keyboard will be used.</p> +<p>The setting will remain active until the application under test closes, or until the value is changed by another call to setMousePreferred().</p> +<p>See also <a href="qsystemtest.html#mousePreferred">mousePreferred</a>().</p> +<h3 class="fn"><a name="setProperty"></a>void QSystemTest::setProperty ( const QString & <i>queryPath</i>, const QString & <i>name</i>, const QVariant & <i>value</i> ) <tt> [slot]</tt></h3> +<p>Set the Qt property named <i>name</i> on object <i>queryPath</i> to value <i>value</i> on the test system.</p> +<p>Errors can occur in this function.</p> +<p>Example:</p> +<pre><span class="comment"> // Set the text of this field without simulating key presses</span> + setProperty("Name", "text", "Billy Jones");</pre> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a> and <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>.</p> +<h3 class="fn"><a name="setSetting"></a>void QSystemTest::setSetting ( const QString & <i>file</i>, const QString & <i>group</i>, const QString & <i>key</i>, const QVariant & <i>value</i> ) <tt> [slot]</tt></h3> +<p>Set a QSettings settings <i>value</i> on the test system located in <i>file</i>, settings group <i>group</i>, key <i>key</i>.</p> +<p>Example:</p> +<pre><span class="comment"> // Turn on english and deutsch input languages</span> + setSetting("$HOME/Settings/Trolltech/locale.conf", "Language", "InputLanguages", "en_US de" );</pre> +<p>See also <a href="qsystemtest.html#getSetting">getSetting</a>() and QSettings.</p> +<h3 class="fn"><a name="setSetting-2"></a>void QSystemTest::setSetting ( const QString & <i>organization</i>, const QString & <i>application</i>, const QString & <i>group</i>, const QString & <i>key</i>, const QVariant & <i>value</i> ) <tt> [slot]</tt></h3> +<p>Set a QSettings settings <i>value</i> on the test system located in the settings file for the given <i>organization</i> and <i>application</i>, as passed to a QSettings constructor. The value set will be in settings group <i>group</i>, key <i>key</i>.</p> +<p>See also <a href="qsystemtest.html#getSetting">getSetting</a>() and QSettings.</p> +<h3 class="fn"><a name="setVisibleResponseTime"></a>void QSystemTest::setVisibleResponseTime ( int <i>time</i> ) <tt> [slot]</tt></h3> +<p>Sets the Visual Response Time to <i>time</i>.</p> +<p>See also <a href="qsystemtest.html#visibleResponseTime">visibleResponseTime</a>() and <a href="qsystemtest.html#waitForTitle">waitForTitle</a>().</p> +<h3 class="fn"><a name="signature"></a>QString QSystemTest::signature ( const QString & <i>labelText</i>, int <i>offset</i> = 0 ) <tt> [slot]</tt></h3> +<p>Returns the signature of the widget that is associated with <i>labelText</i>.</p> +<p>If <i>offset</i> is a number != 0 the query will return the n'th next or previous widget (excluding labels). The widgets are ordered from top to bottom, left to right. A positive offset indicates a widget to the right or below, a negative offset indicates a widget to the left or above the label.</p> +<p>This function can be used for situations where a field doesn't have a label associated with it.</p> +<p>See also <a href="qtuitest-manual.html#query-paths">Query Paths</a>, <a href="qtuitest-manual.html#querying-objects">Querying Objects</a>, and QObject::inherits().</p> +<h3 class="fn"><a name="skip"></a>void QSystemTest::skip ( const QString & <i>message</i>, <a href="qsystemtest.html#SkipMode-enum">SkipMode</a> <i>mode</i> ) <tt> [virtual slot]</tt></h3> +<p>Cause a test to skip with the given <i>message</i> and <i>mode</i>.</p> +<h3 class="fn"><a name="startApplication"></a>void QSystemTest::startApplication ( const QString & <i>application</i>, const QStringList & <i>arguments</i> = QStringList(), int <i>timeout</i> = 5000, <a href="qsystemtest.html#StartApplicationFlag-enum">QSystemTest::StartApplicationFlags</a> <i>flags</i> = QSystemTest::WaitForFocus ) <tt> [virtual slot]</tt></h3> +<p>Start the specified <i>application</i>.</p> +<p><i>application</i> is the combined path and arguments of a program to launch. The application must connect to the test framework within <i>timeout</i> ms or the test fails.</p> +<p><i>flags</i> specifies additional behaviour.</p> +<p>See also <a href="qtuitest-manual.html#application-management">Application Management</a>.</p> +<h3 class="fn"><a name="strict"></a>void QSystemTest::strict ( bool <i>on</i> = true ) <tt> [slot]</tt></h3> +<p>Switches the 'strict syntax' checking mode for the System test to <i>on</i>.</p> +<p>In strict mode the following commands are no longer allowed and will cause an immediate failure:</p> +<p><i>keyClick()</i> <i>keyPress()</i> <i>keyRelease()</i> <i>keyClickHold()</i></p> +<p>Strict mode also verifies that every 'Title' change is covered by a call to <a href="qsystemtest.html#waitForTitle">waitForTitle</a>(): any action that results in a Dialog to be shown (with a different title) will cause a test failure unless a <a href="qsystemtest.html#waitForTitle">waitForTitle</a>() is called on the next line of the test script.</p> +<h3 class="fn"><a name="tabBar"></a>void QSystemTest::tabBar ( int <i>index</i> = 0 )</h3> +<p>Returns the signature of the tabbar widget. If multiple tabbars exist, <i>index</i> can be used to distinguish between them (sorted in order of position from top left of screen).</p> +<p>Example:</p> +<pre> select( "Personal", tabBar() ); <span class="comment">// select the tab with text 'Personal' from the tab bar.</span> + print( tabBar() ); <span class="comment">// to print the signature of the tabbar widget.</span></pre> +<p>The test will fail if no visible tabbar is found.</p> +<h3 class="fn"><a name="translate"></a>QString QSystemTest::translate ( const QString & <i>context</i>, const QString & <i>text</i>, const QString & <i>comment</i> = QString(), int <i>n</i> = 0 ) <tt> [slot]</tt></h3> +<p>Returns the translation for <i>text</i>, from the application's installed translation files. <i>context</i> is typically a class name. If no translation is found, the <i>text</i> is returned unchanged.</p> +<p><i>comment</i> is a disambiguating comment, for when the same sourceText is used in different roles within the same context. By default, it is null. <i>n</i> is used in conjunction with <tt>%n</tt> to support plural forms. See QObject::tr() for details.</p> +<p>When developing test cases that use translations, it will be necessary to refer to the translator message files (<tt>.ts</tt> files), either directly or through Qt Linguist, to determine which translations are available, and the appropriate <i>context</i> to use.</p> +<p>In some cases, translated phrases will contain argument placeholders (<tt>%1</tt>, etc) which will need to be expanded with the correct values.</p> +<p>Example:</p> +<pre><span class="comment"> // Label translation</span> + print( translate("QFileDialog", "File &name:") ); + +<span class="comment"> // Replace argument placeholders</span> + compare( message, translate("QHttp", "Host %1 not found").replace("%1", hostname) );</pre> +<p>See also QCoreApplication::translate() and <a href="qsystemtest.html#getLocale">getLocale</a>().</p> +<h3 class="fn"><a name="userName"></a>QString QSystemTest::userName () <tt> [static slot]</tt></h3> +<p>Returns the username that is running the test on the desktop machine.</p> +<h3 class="fn"><a name="verify"></a>void QSystemTest::verify ( <a href="qsystemtest.html#Boolean-typedef">Boolean</a> <i>condition</i>, String <i>message</i> = null )</h3> +<p>Verifies that <i>condition</i> is true. If <i>condition</i> is not true, the current test fails. If <i>message</i> is given, it will be appended to the failure message.</p> +<p>Example:</p> +<pre> select("Frank", "Contacts"); + waitForTitle("Details: Frank"); + var details = getText(); +<span class="comment"> // Verify that Frank's phone number is shown somewhere</span> + verify( details.contains("12345") ); +<span class="comment"> // Same, but with more details in error message</span> + verify( details.contains("12345"), "Frank's phone number is missing!" );</pre> +<h3 class="fn"><a name="verifyImage"></a>void QSystemTest::verifyImage ( const QString & <i>expectedName</i>, const QString & <i>queryPath</i> = QString(), const QString & <i>comment</i> = QString(), const QStringList & <i>maskedWidgets</i> = QStringList() ) <tt> [slot]</tt></h3> +<p>Grabs a snapshot of the widget specified by <i>queryPath</i>, and compares it against the reference snapshot <i>expectedName</i>.</p> +<p>New snapshots are gathered by running the test in <a href="qtuitest-manual.html#learn-mode">learn mode</a>, and are stored in the <tt>testdata</tt> subdirectory of the directory containing the test script. When learn mode is used, a failed image comparison will result in a tester being presented with a manual verification dialog.</p> +<p>If there is a mismatch between the images, the current test fails.</p> +<p>When in learn mode, if <i>comment</i> is provided it will be shown to the user to help in determining whether or not the pixmap should be accepted.</p> +<p><i>maskedWidgets</i> is a list of query paths specifying widgets to be excluded from the snapshot. This allows constantly changing widgets to be hidden from view while the snapshot is taken.</p> +<p>Example:</p> +<pre> verifyImage( "task_completed", "", "Verify that the current task is shown with a green tick indicating completion" );</pre> +<p>See also <a href="qsystemtest.html#saveScreen">saveScreen</a>().</p> +<h3 class="fn"><a name="visibleResponseTime"></a>int QSystemTest::visibleResponseTime () <tt> [slot]</tt></h3> +<p>Returns the currently set Visual Response Time. This time is used in <a href="qtuitest.html">QtUiTest</a> to decide whether the User Interface is responsive to user events. For instance, after selecting "New Event" from the options menu a user expects a dialog in which a new event can be entered. If Qt Extended does not respond in some visible way within the visual response time, the test will fail.</p> +<p>By default the visual response time is set to 4 seconds, i.e. any UI that doesn't respond to events within this time is considered at fault.</p> +<p>The visibleResponseTime is also used as the default value for some queries such as <a href="qsystemtest.html#waitForTitle">waitForTitle</a>().</p> +<p>See also <a href="qsystemtest.html#setVisibleResponseTime">setVisibleResponseTime</a>() and <a href="qsystemtest.html#waitForTitle">waitForTitle</a>().</p> +<h3 class="fn"><a name="wait"></a>void QSystemTest::wait ( int <i>msecs</i> ) <tt> [slot]</tt></h3> +<p>Wait for <i>msecs</i> milliseconds, while still processing events from the event loop.</p> +<h3 class="fn"><a name="waitExpectedMessageBox"></a>bool QSystemTest::waitExpectedMessageBox ( uint <i>timeout</i>, bool <i>waitForAll</i> = true, const QString & <i>title</i> = QString(), const QString & <i>text</i> = QString() ) <tt> [slot]</tt></h3> +<p>Waits for expected message boxes to occur up until a maximum of <i>timeout</i> ms. Returns true if the expected message box occurs during or before this function.</p> +<p>It is an error to call this function for a message box which has not been passed to <a href="qsystemtest.html#expectMessageBox">expectMessageBox</a>() or <a href="qsystemtest.html#addExpectedMessageBox">addExpectedMessageBox</a>().</p> +<p>If <i>waitForAll</i> is true (the default) ALL messageBoxes will need to be shown before the wait terminates, or else it is sufficient if any of the expected message boxes has been shown.</p> +<p>When a <i>title</i> and <i>text</i> are specified the function will wait until that specific message box has been shown. Note that specifying a <i>title</i> and <i>text</i> only makes sense when <i>waitForAll</i> is set to false.</p> +<p>See also <a href="qsystemtest.html#addExpectedMessageBox">addExpectedMessageBox</a>(), <a href="qsystemtest.html#clearExpectedMessageBox">clearExpectedMessageBox</a>(), <a href="qsystemtest.html#clearExpectedMessageBoxes">clearExpectedMessageBoxes</a>(), and <a href="qsystemtest.html#expectMessageBox">expectMessageBox</a>().</p> +<h3 class="fn"><a name="waitFor"></a>void QSystemTest::waitFor ( <a href="qsystemtest.html#Number-typedef">Number</a> <i>timeout</i> = 10000, <a href="qsystemtest.html#Number-typedef">Number</a> <i>intervals</i> = 20, String <i>message</i> = null )</h3> +<p>Denotes the start of a block of code which should be repeatedly executed until it returns true. If the block of code doesn't return true within <i>timeout</i> milliseconds, the current test fails with the given <i>message</i>.</p> +<p><i>intervals</i> is the maximum amount of times the block of code should be executed; i.e., the code will be executed every <i>timeout</i> / <i>intervals</i> milliseconds.</p> +<p>Example:</p> +<pre> waitFor() { + return getList().length > 0; + }</pre> +<h3 class="fn"><a name="waitForTitle"></a>void QSystemTest::waitForTitle ( const QString & <i>title</i>, int <i>timeout</i> = 0 ) <tt> [slot]</tt></h3> +<p>Waits for the current title to change to <i>title</i> The test fails if the current title hasn't changed to <i>title</i> within <i>timeout</i> ms.</p> +<p /><address><hr /><div align="center"> +<table width="100%" cellspacing="0" border="0"><tr class="address"> +<td width="30%" align="left">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies)</td> +<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td> +<td width="30%" align="right"><div align="right">QtUiTest</div></td> +</tr></table></div></address></body> +</html> |