diff options
| author | David Clark <david.a.clark@nokia.com> | 2010-11-18 16:20:48 +1000 |
|---|---|---|
| committer | David Clark <david.a.clark@nokia.com> | 2010-11-18 16:20:48 +1000 |
| commit | c223232bc15106750da632598047a35ad3762723 (patch) | |
| tree | 403f7aa2c3a5a912edce6feae869046c89d29178 /old/doc/html | |
| parent | b984b0b62076067f1f75db5a7eda5aaa2cdaad2a (diff) | |
Diffstat (limited to 'old/doc/html')
44 files changed, 4771 insertions, 0 deletions
diff --git a/old/doc/html/assistant.dcf b/old/doc/html/assistant.dcf new file mode 100644 index 0000000..ca2fdea --- /dev/null +++ b/old/doc/html/assistant.dcf @@ -0,0 +1,3 @@ +<!DOCTYPE DCF> +<DCF ref="assistant-manual.html" icon="assistant.png" imagedir="../../gif" title="Qt Assistant Manual"> +</DCF> diff --git a/old/doc/html/classic.css b/old/doc/html/classic.css new file mode 100644 index 0000000..320da66 --- /dev/null +++ b/old/doc/html/classic.css @@ -0,0 +1,279 @@ +BODY,H1,H2,H3,H4,H5,H6,P,CENTER,TD,TH,UL,DL,DIV { + font-family: Arial, Geneva, Helvetica, sans-serif; +} +H1 { + text-align: center; + font-size: 160%; +} +H2 { + font-size: 120%; +} +H3 { + font-size: 100%; +} + +h3.fn,span.fn +{ + background-color: #eee; + border-width: 1px; + border-style: solid; + border-color: #ddd; + font-weight: bold; + padding: 6px 0px 6px 10px; + margin: 42px 0px 0px 0px; +} + +hr { + border: 0; + color: #a0a0a0; + background-color: #ccc; + height: 1px; + width: 100%; + text-align: left; + margin: 34px 0px 34px 0px; +} + +table.valuelist { + border-width: 1px 1px 1px 1px; + border-style: solid; + border-color: #dddddd; + border-collapse: collapse; + background-color: #f0f0f0; +} + +table.indextable { + border-width: 1px 1px 1px 1px; + border-style: solid; + border-collapse: collapse; + background-color: #f0f0f0; + border-color:#555; + font-size: 100%; +} + +table td.largeindex { + border-width: 1px 1px 1px 1px; + border-collapse: collapse; + background-color: #f0f0f0; + border-color:#555; + font-size: 120%; +} + +table.valuelist th { + border-width: 1px 1px 1px 2px; + padding: 4px; + border-style: solid; + border-color: #666; + color:white; + background-color:#666; +} + +th.titleheader { + border-width: 1px 0px 1px 0px; + padding: 2px; + border-style: solid; + border-color: #666; + color:white; + background-color:#555; + background-image:url('images/gradient.png')}; + background-repeat: repeat-x; + font-size: 100%; +} + + +th.largeheader { + border-width: 1px 0px 1px 0px; + padding: 4px; + border-style: solid; + border-color: #444; + color:white; + background-color:#555555; + font-size: 120%; +} + +p { + + margin-left: 4px; + margin-top: 8px; + margin-bottom: 8px; +} + +a:link +{ + color: #0046ad; + text-decoration: none +} + +a:visited +{ + color: #672967; + text-decoration: none +} + +a.obsolete +{ + color: #661100; + text-decoration: none +} + +a.compat +{ + color: #661100; + text-decoration: none +} + +a.obsolete:visited +{ + color: #995500; + text-decoration: none +} + +a.compat:visited +{ + color: #995500; + text-decoration: none +} + +body +{ + background: #ffffff; + color: black +} + +table.generic, table.annotated +{ + border-width: 1px; + border-color:#bbb; + border-style:solid; + border-collapse:collapse; +} + +table td.memItemLeft { + width: 180px; + padding: 2px 0px 0px 8px; + margin: 4px; + border-width: 1px; + border-color: #E0E0E0; + border-style: none; + font-size: 100%; + white-space: nowrap +} + +table td.memItemRight { + padding: 2px 8px 0px 8px; + margin: 4px; + border-width: 1px; + border-color: #E0E0E0; + border-style: none; + font-size: 100%; +} + +table tr.odd { + background: #f0f0f0; + color: black; +} + +table tr.even { + background: #e4e4e4; + color: black; +} + +table.annotated th { + padding: 3px; + text-align: left +} + +table.annotated td { + padding: 3px; +} + +table tr pre +{ + padding-top: 0px; + padding-bottom: 0px; + padding-left: 0px; + padding-right: 0px; + border: none; + background: none +} + +tr.qt-style +{ + background: #96E066; + color: black +} + +body pre +{ + padding: 0.2em; + border: #e7e7e7 1px solid; + background: #f1f1f1; + color: black +} + +table tr.qt-code pre +{ + padding: 0.2em; + border: #e7e7e7 1px solid; + background: #f1f1f1; + color: black +} + +span.preprocessor, span.preprocessor a +{ + color: darkblue; +} + +span.comment +{ + color: darkred; + font-style: italic +} + +span.string,span.char +{ + color: darkgreen; +} + +.title +{ + text-align: center +} + +.subtitle +{ + font-size: 0.8em +} + +.small-subtitle +{ + font-size: 0.65em +} + +.qmlitem { + padding: 0; +} + +.qmlname { + white-space: nowrap; +} + +.qmltype { + text-align: center; + font-size: 160%; +} + +.qmlproto { + background-color: #eee; + border-width: 1px; + border-style: solid; + border-color: #ddd; + font-weight: bold; + padding: 6px 0px 6px 10px; + margin: 42px 0px 0px 0px; +} + +.qmldoc { +} + +*.qmlitem p { +} diff --git a/old/doc/html/designer.dcf b/old/doc/html/designer.dcf new file mode 100644 index 0000000..d307129 --- /dev/null +++ b/old/doc/html/designer.dcf @@ -0,0 +1,3 @@ +<!DOCTYPE DCF> +<DCF ref="designer-manual.html" icon="designer.png" imagedir="../../gif" title="Qt Designer Manual"> +</DCF> diff --git a/old/doc/html/images/qt-logo.png b/old/doc/html/images/qt-logo.png Binary files differnew file mode 100644 index 0000000..2dc6716 --- /dev/null +++ b/old/doc/html/images/qt-logo.png diff --git a/old/doc/html/index.html b/old/doc/html/index.html new file mode 100644 index 0000000..1f9ab89 --- /dev/null +++ b/old/doc/html/index.html @@ -0,0 +1,124 @@ +<?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"> +<!-- ../../doc/src/index.qdoc --> +<head> + <title>Qt Reference Documentation</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">Qt Reference Documentation<br /><span class="subtitle"></span> +</h1> +<a name="qt-reference-documentation"></a> <table cellpadding="2" cellspacing="1" border="0" width="95%" class="indextable" align="center"> + <tr> + <th class="titleheader" width="33%"> + Getting Started</th> + <th class="titleheader" width="33%"> + API Reference</th> + <th class="titleheader" width="33%"> + Working with Qt</th> + </tr> + <tr> + <td valign="top"> + <ul> + <li><a href="installation.html">Installation</a> and <a href="how-to-learn-qt.html">First Steps with Qt</a></li> + <li><a href="tutorials.html">Tutorials</a> and <a href="examples.html">Examples</a></li> + <li><a href="demos.html">Demonstrations</a> and <a href="qt4-6-intro.html"><b>New in Qt 4.6</b></a></li> + </ul> + </td> + <td valign="top"> + <ul> + <li><a href="classlists.html">Class and Function Documentation</a></li> + <li><a href="frameworks-technologies.html">Frameworks and Technologies</a></li> + <li><a href="best-practices.html">How-To's and Best Practices</a></li> + </ul> + </td> + <td valign="top"> + <ul> + <li><a href="developing-with-qt.html">Cross-Platform Development with Qt</a></li> + <li><a href="qtestlib-manual.html">Unit Testing</a> and <a href="debug.html">Debugging</a></li> + <li><a href="deployment.html">Deploying Qt Applications</a></li> + </ul> + </td> + </tr> + <tr> + <th class="titleheader"> + Fundamentals</th> + <th class="titleheader"> + User Interface Design</th> + <th class="titleheader"> + Technologies</th> + </tr> + <tr> + <td valign="top"> + <ul> + <li><a href="object.html">The Qt Object Model</a></li> + <li><a href="eventsandfilters.html">Event System</a></li> + <li><a href="threads.html">Threading</a></li> + <li><a href="internationalization.html">Internationalization</a></li> + <li><a href="platform-specific.html">Platform Specifics</a></li> + </ul> + </td> + <td valign="top"> + <ul> + <li><a href="widgets-and-layouts.html">Widgets and Layouts</a></li> + <li><a href="application-windows.html">Application Windows</a></li> + <li><a href="paintsystem.html">Painting and Printing</a></li> + <li><a href="graphicsview.html">Canvas UI with Graphics View</a></li> + <li><a href="webintegration.html">Integrating Web Content</a></li> + <li><a href="qtdeclarative.html">Declarative UI</a></li> + </ul> + </td> + <td valign="top"> + <ul> + <li><a href="io.html">Input/Output</a> and <a href="resources.html">Resources</a></li> + <li><a href="network-programming.html">Network Programming</a></li> + <li><a href="sql-programming.html">SQL Development</a></li> + <li><a href="xml-processing.html">XML Processing</a></li> + <li><a href="scripting.html">Scripting</a></li> + </ul> + </td> + </tr> + <tr> + <th class="titleheader"> + Community and Resources</th> + <th class="titleheader"> + Contributing</th> + <th class="titleheader"> + Licenses</th> + </tr> + <tr> + <td valign="top"> + <ul> + <li><a href="http://qt.nokia.com/developer">Online Resources</a></li> + <li><a href="http://labs.qt.nokia.com/blogs">Developer Blogs</a></li> + <li><a href="http://qt.nokia.com/support-services">Support</a>, <a href="http://qt.nokia.com/services-partners">Training and Services</a></li> + </ul> + </td> + <td valign="top"> + <ul> + <li><a href="bughowto.html">Report Bugs and Make Suggestions</a></li> + <li><a href="http://qt.gitorious.org">Open Repository</a></li> + <li><a href="credits.html">Credits</a></li> + </ul> + </td> + <td valign="top"> + <ul> + <li><a href="gpl.html">GNU GPL</a>, <a href="lgpl.html">GNU LGPL</a></li> + <li><a href="commercialeditions.html">Commercial Editions</a></li> + <li><a href="licensing.html">Licenses Used in Qt</a></li> + </ul> + </td> + </tr> + </table> + <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> diff --git a/old/doc/html/linguist.dcf b/old/doc/html/linguist.dcf new file mode 100644 index 0000000..9e27d2b --- /dev/null +++ b/old/doc/html/linguist.dcf @@ -0,0 +1,3 @@ +<!DOCTYPE DCF> +<DCF ref="linguist-manual.html" icon="linguist.png" imagedir="../../gif" title="Qt Linguist Manual"> +</DCF> diff --git a/old/doc/html/qmake.dcf b/old/doc/html/qmake.dcf new file mode 100644 index 0000000..d7b2821 --- /dev/null +++ b/old/doc/html/qmake.dcf @@ -0,0 +1,3 @@ +<!DOCTYPE DCF> +<DCF ref="qmake-manual.html" imagedir="../../gif" title="qmake Manual"> +</DCF> 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> diff --git a/old/doc/html/qtuitest-activatewidget-members.html b/old/doc/html/qtuitest-activatewidget-members.html new file mode 100644 index 0000000..69e9556 --- /dev/null +++ b/old/doc/html/qtuitest-activatewidget-members.html @@ -0,0 +1,26 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>List of All Members for ActivateWidget</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">List of All Members for ActivateWidget</h1> +<p>This is the complete list of members for <a href="qtuitest-activatewidget.html">QtUiTest::ActivateWidget</a>, including inherited members.</p> +<ul> +<li><div class="fn"><b><a href="qtuitest-activatewidget.html#activate">activate</a></b> () : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-activatewidget.html#activated">activated</a></b> ()</div></li> +</ul> +<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> diff --git a/old/doc/html/qtuitest-activatewidget.html b/old/doc/html/qtuitest-activatewidget.html new file mode 100644 index 0000000..4d6f658 --- /dev/null +++ b/old/doc/html/qtuitest-activatewidget.html @@ -0,0 +1,53 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>ActivateWidget Class 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">ActivateWidget Class Reference<br /><span class="small-subtitle">(QtUiTest::ActivateWidget)<br />[QtUiTestModule]</span> +</h1> +<p>The ActivateWidget class provides an abstract base class for all test widgets which can conceptually be "activated" by a user. <a href="#details">More...</a></p> +<pre> #include <<a href="qtuitest.html">QtUiTest</a>></pre><p><b>This class is under development and is subject to change.</b></p> +<ul> +<li><a href="qtuitest-activatewidget-members.html">List of all members, including inherited members</a></li> +</ul> +<hr /> +<a name="public-functions"></a> +<h2>Public Functions</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-activatewidget.html#activate">activate</a></b> () = 0</td></tr> +</table> +<hr /> +<a name="signals"></a> +<h2>Signals</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-activatewidget.html#activated">activated</a></b> ()</td></tr> +</table> +<a name="details"></a> +<hr /> +<h2>Detailed Description</h2> +<p>The ActivateWidget class provides an abstract base class for all test widgets which can conceptually be "activated" by a user.</p> +<p>"Activation" occurs when user input causes an action, possibly non-reversible, on a widget which exists solely for the purpose of causing that action.</p> +<p>Examples of widgets suitable for this interface include QAbstractButton.</p> +<hr /> +<h2>Member Function Documentation</h2> +<h3 class="fn"><a name="activate"></a>bool ActivateWidget::activate () <tt> [pure virtual]</tt></h3> +<p>Simulate the user input necessary to activate this widget.</p> +<p>Returns true if this widget was successfully activated.</p> +<p>For example, a button would reimplement this function to simulate a click on itself, or to navigate to itself and hit the "Select" key.</p> +<h3 class="fn"><a name="activated"></a>void ActivateWidget::activated () <tt> [signal]</tt></h3> +<p>This signal is emitted when this widget is activated.</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> diff --git a/old/doc/html/qtuitest-checkitemwidget-members.html b/old/doc/html/qtuitest-checkitemwidget-members.html new file mode 100644 index 0000000..3d80600 --- /dev/null +++ b/old/doc/html/qtuitest-checkitemwidget-members.html @@ -0,0 +1,27 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>List of All Members for CheckItemWidget</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">List of All Members for CheckItemWidget</h1> +<p>This is the complete list of members for <a href="qtuitest-checkitemwidget.html">QtUiTest::CheckItemWidget</a>, including inherited members.</p> +<ul> +<li><div class="fn"><b><a href="qtuitest-checkitemwidget.html#isCheckable">isCheckable</a></b> ( const QString & ) : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-checkitemwidget.html#isChecked">isChecked</a></b> ( const QString & ) const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-checkitemwidget.html#setChecked">setChecked</a></b> ( const QString &, bool ) : bool</div></li> +</ul> +<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> diff --git a/old/doc/html/qtuitest-checkitemwidget.html b/old/doc/html/qtuitest-checkitemwidget.html new file mode 100644 index 0000000..9f98b2d --- /dev/null +++ b/old/doc/html/qtuitest-checkitemwidget.html @@ -0,0 +1,48 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>CheckItemWidget Class 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">CheckItemWidget Class Reference<br /><span class="small-subtitle">(QtUiTest::CheckItemWidget)<br />[QtUiTestModule]</span> +</h1> +<p>The CheckItemWidget class provides an abstract base class for all test widgets which include items that support 'checked' and 'unchecked' states. <a href="#details">More...</a></p> +<pre> #include <<a href="qtuitest.html">QtUiTest</a>></pre><p><b>This class is under development and is subject to change.</b></p> +<ul> +<li><a href="qtuitest-checkitemwidget-members.html">List of all members, including inherited members</a></li> +</ul> +<hr /> +<a name="public-functions"></a> +<h2>Public Functions</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-checkitemwidget.html#isCheckable">isCheckable</a></b> ( const QString & <i>item</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-checkitemwidget.html#isChecked">isChecked</a></b> ( const QString & ) const = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-checkitemwidget.html#setChecked">setChecked</a></b> ( const QString & <i>item</i>, bool <i>state</i> ) = 0</td></tr> +</table> +<a name="details"></a> +<hr /> +<h2>Detailed Description</h2> +<p>The CheckItemWidget class provides an abstract base class for all test widgets which include items that support 'checked' and 'unchecked' states.</p> +<p>Examples of widgets suitable for this interface include QMenu.</p> +<hr /> +<h2>Member Function Documentation</h2> +<h3 class="fn"><a name="isCheckable"></a>bool CheckItemWidget::isCheckable ( const QString & <i>item</i> ) <tt> [virtual]</tt></h3> +<p>Returns true if <i>item</i> can be checked (has a selectable on/off state).</p> +<h3 class="fn"><a name="isChecked"></a>bool CheckItemWidget::isChecked ( const QString & ) const <tt> [pure virtual]</tt></h3> +<h3 class="fn"><a name="setChecked"></a>bool CheckItemWidget::setChecked ( const QString & <i>item</i>, bool <i>state</i> ) <tt> [pure virtual]</tt></h3> +<p>Set the check state of the <i>item</i>. Returns false if the check state cannot be set.</p> +<p>See also <a href="qtuitest-checkitemwidget.html#isChecked">isChecked</a>().</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> diff --git a/old/doc/html/qtuitest-checkwidget-members.html b/old/doc/html/qtuitest-checkwidget-members.html new file mode 100644 index 0000000..740fd06 --- /dev/null +++ b/old/doc/html/qtuitest-checkwidget-members.html @@ -0,0 +1,28 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>List of All Members for CheckWidget</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">List of All Members for CheckWidget</h1> +<p>This is the complete list of members for <a href="qtuitest-checkwidget.html">QtUiTest::CheckWidget</a>, including inherited members.</p> +<ul> +<li><div class="fn"><b><a href="qtuitest-checkwidget.html#checkState">checkState</a></b> () const : Qt::CheckState</div></li> +<li><div class="fn"><b><a href="qtuitest-checkwidget.html#isTristate">isTristate</a></b> () const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-checkwidget.html#setCheckState">setCheckState</a></b> ( Qt::CheckState ) : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-checkwidget.html#stateChanged">stateChanged</a></b> ( int )</div></li> +</ul> +<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> diff --git a/old/doc/html/qtuitest-checkwidget.html b/old/doc/html/qtuitest-checkwidget.html new file mode 100644 index 0000000..410b4c7 --- /dev/null +++ b/old/doc/html/qtuitest-checkwidget.html @@ -0,0 +1,62 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>CheckWidget Class 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">CheckWidget Class Reference<br /><span class="small-subtitle">(QtUiTest::CheckWidget)<br />[QtUiTestModule]</span> +</h1> +<p>The CheckWidget class provides an abstract base class for all test widgets which support 'checked' and 'unchecked' states. <a href="#details">More...</a></p> +<pre> #include <<a href="qtuitest.html">QtUiTest</a>></pre><p><b>This class is under development and is subject to change.</b></p> +<ul> +<li><a href="qtuitest-checkwidget-members.html">List of all members, including inherited members</a></li> +</ul> +<hr /> +<a name="public-functions"></a> +<h2>Public Functions</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">virtual Qt::CheckState </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-checkwidget.html#checkState">checkState</a></b> () const = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-checkwidget.html#isTristate">isTristate</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-checkwidget.html#setCheckState">setCheckState</a></b> ( Qt::CheckState <i>state</i> )</td></tr> +</table> +<hr /> +<a name="signals"></a> +<h2>Signals</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-checkwidget.html#stateChanged">stateChanged</a></b> ( int <i>state</i> )</td></tr> +</table> +<a name="details"></a> +<hr /> +<h2>Detailed Description</h2> +<p>The CheckWidget class provides an abstract base class for all test widgets which support 'checked' and 'unchecked' states.</p> +<p>QtUiTest::CheckWidget exposes the current check state of widgets which can be checked or unchecked.</p> +<p>Examples of widgets suitable for this interface include QCheckBox and QAbstractButton.</p> +<hr /> +<h2>Member Function Documentation</h2> +<h3 class="fn"><a name="checkState"></a>Qt::CheckState CheckWidget::checkState () const <tt> [pure virtual]</tt></h3> +<p>Returns the current check state of this widget.</p> +<p>See also QCheckBox::checkState() and <a href="qtuitest-checkwidget.html#setCheckState">setCheckState</a>().</p> +<h3 class="fn"><a name="isTristate"></a>bool CheckWidget::isTristate () const <tt> [virtual]</tt></h3> +<p>Returns true if this widget has three possible states, i.e. the widget can be in state Qt::PartiallyChecked.</p> +<p>The base implementation returns false.</p> +<p>See also QCheckBox::isTristate().</p> +<h3 class="fn"><a name="setCheckState"></a>bool CheckWidget::setCheckState ( Qt::CheckState <i>state</i> ) <tt> [virtual]</tt></h3> +<p>Simulates the user input necessary to set the current check state to <i>state</i>, returning true on success.</p> +<p>The default implementation does nothing and returns false.</p> +<p>See also QCheckBox::setCheckState() and <a href="qtuitest-checkwidget.html#checkState">checkState</a>().</p> +<h3 class="fn"><a name="stateChanged"></a>void CheckWidget::stateChanged ( int <i>state</i> ) <tt> [signal]</tt></h3> +<p>This signal is emitted when the check state of this widget changes to <i>state</i>. <i>state</i> is compatible with Qt::CheckState.</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> diff --git a/old/doc/html/qtuitest-indexedwidget-members.html b/old/doc/html/qtuitest-indexedwidget-members.html new file mode 100644 index 0000000..5cf2e32 --- /dev/null +++ b/old/doc/html/qtuitest-indexedwidget-members.html @@ -0,0 +1,25 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>List of All Members for IndexedWidget</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">List of All Members for IndexedWidget</h1> +<p>This is the complete list of members for <a href="qtuitest-indexedwidget.html">QtUiTest::IndexedWidget</a>, including inherited members.</p> +<ul> +<li><div class="fn"><b><a href="qtuitest-indexedwidget.html#selectIndex">selectIndex</a></b> ( const QVariantList & ) : bool</div></li> +</ul> +<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> diff --git a/old/doc/html/qtuitest-indexedwidget.html b/old/doc/html/qtuitest-indexedwidget.html new file mode 100644 index 0000000..5b0d716 --- /dev/null +++ b/old/doc/html/qtuitest-indexedwidget.html @@ -0,0 +1,50 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>IndexedWidget Class 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">IndexedWidget Class Reference<br /><span class="small-subtitle">(QtUiTest::IndexedWidget)<br />[QtUiTestModule]</span> +</h1> +<p>The IndexedWidget class provides an abstract base class for all test widgets which allow the user to select items based on index. <a href="#details">More...</a></p> +<pre> #include <<a href="qtuitest.html">QtUiTest</a>></pre><p><b>This class is under development and is subject to change.</b></p> +<ul> +<li><a href="qtuitest-indexedwidget-members.html">List of all members, including inherited members</a></li> +</ul> +<hr /> +<a name="public-functions"></a> +<h2>Public Functions</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-indexedwidget.html#selectIndex">selectIndex</a></b> ( const QVariantList & <i>index</i> )</td></tr> +</table> +<a name="details"></a> +<hr /> +<h2>Detailed Description</h2> +<p>The IndexedWidget class provides an abstract base class for all test widgets which allow the user to select items based on index.</p> +<p>Examples of widgets suitable for this interface include QAbstractItemView.</p> +<p>See also <a href="qtuitest-listwidget.html">QtUiTest::ListWidget</a> and <a href="qtuitest-selectwidget.html">QtUiTest::SelectWidget</a>.</p> +<hr /> +<h2>Member Function Documentation</h2> +<h3 class="fn"><a name="selectIndex"></a>bool IndexedWidget::selectIndex ( const QVariantList & <i>index</i> ) <tt> [virtual]</tt></h3> +<p>Selects the item with the specified <i>index</i> from an item view. The index should be specified in QtScript as an array, in the form [parentRow, parentColumn, ..., row, column].</p> +<p>This function can be used in situations where <a href="qsystemtest.html#select">select()</a> would be inappropriate, typically in larger, more complex item views or those containing items with duplicate names.</p> +<pre><span class="comment"> // Select row 3, column 5 from tableView</span> + selectIndex([3, 5], tableView); + +<span class="comment"> // Select row 2, column 4 beneath parent item at row 1, column 0 from treeView</span> + selectIndex([1, 0, 2, 4], treeView);</pre> +<p>See also select().</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> diff --git a/old/doc/html/qtuitest-inputwidget-members.html b/old/doc/html/qtuitest-inputwidget-members.html new file mode 100644 index 0000000..636a8d4 --- /dev/null +++ b/old/doc/html/qtuitest-inputwidget-members.html @@ -0,0 +1,27 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>List of All Members for InputWidget</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">List of All Members for InputWidget</h1> +<p>This is the complete list of members for <a href="qtuitest-inputwidget.html">QtUiTest::InputWidget</a>, including inherited members.</p> +<ul> +<li><div class="fn"><b><a href="qtuitest-inputwidget.html#canEnter">canEnter</a></b> ( const QVariant & ) const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-inputwidget.html#enter">enter</a></b> ( const QVariant &, bool ) : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-inputwidget.html#entered">entered</a></b> ( const QVariant & )</div></li> +</ul> +<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> diff --git a/old/doc/html/qtuitest-inputwidget.html b/old/doc/html/qtuitest-inputwidget.html new file mode 100644 index 0000000..e4aab40 --- /dev/null +++ b/old/doc/html/qtuitest-inputwidget.html @@ -0,0 +1,60 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>InputWidget Class 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">InputWidget Class Reference<br /><span class="small-subtitle">(QtUiTest::InputWidget)<br />[QtUiTestModule]</span> +</h1> +<p>The InputWidget class provides an abstract base class for all test widgets which allow the user to input text. <a href="#details">More...</a></p> +<pre> #include <<a href="qtuitest.html">QtUiTest</a>></pre><p><b>This class is under development and is subject to change.</b></p> +<p>Inherited by </p> +<ul> +<li><a href="qtuitest-inputwidget-members.html">List of all members, including inherited members</a></li> +</ul> +<hr /> +<a name="public-functions"></a> +<h2>Public Functions</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-inputwidget.html#canEnter">canEnter</a></b> ( const QVariant & <i>item</i> ) const = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-inputwidget.html#enter">enter</a></b> ( const QVariant & <i>item</i>, bool <i>noCommit</i> ) = 0</td></tr> +</table> +<hr /> +<a name="signals"></a> +<h2>Signals</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-inputwidget.html#entered">entered</a></b> ( const QVariant & <i>item</i> )</td></tr> +</table> +<a name="details"></a> +<hr /> +<h2>Detailed Description</h2> +<p>The InputWidget class provides an abstract base class for all test widgets which allow the user to input text.</p> +<p>QtUiTest::InputWidget encapsulates a widget in which a user may enter and remove text. This is closely related to <a href="qtuitest-textwidget.html">QtUiTest::TextWidget</a>, which provides an interface for retrieving text from a widget. Any widgets which contain user-editable text will typically implement both QtUiTest::InputWidget and <a href="qtuitest-textwidget.html">QtUiTest::TextWidget</a>.</p> +<p>Examples of widgets suitable for this interface include QLineEdit and QTextEdit.</p> +<p>See also <a href="qtuitest-textwidget.html">QtUiTest::TextWidget</a>.</p> +<hr /> +<h2>Member Function Documentation</h2> +<h3 class="fn"><a name="canEnter"></a>bool InputWidget::canEnter ( const QVariant & <i>item</i> ) const <tt> [pure virtual]</tt></h3> +<p>Returns true if <i>item</i> can possibly be entered into this widget.</p> +<p>For example, for a QLineEdit, QLineEdit::validator() would be used to ensure that item.toString() constitutes valid input for this line edit.</p> +<h3 class="fn"><a name="enter"></a>bool InputWidget::enter ( const QVariant & <i>item</i>, bool <i>noCommit</i> ) <tt> [pure virtual]</tt></h3> +<p>Simulates the user input necessary to enter <i>item</i> into this widget. Returns true on success.</p> +<p><i>item</i> can potentially be any type representable in a QVariant. Most widgets will only be interested in text, in which case item.toString() can be called to retrieve a string. Examples of widgets which may handle types other than text are QDateEdit and QTimeEdit, which may handle dates and times.</p> +<p>If <i>noCommit</i> is true, no attempt is made to commit the input (for example, by clicking the Select key). Normally this value will be false, which will result in the input being committed. This value is not applicable to all widget types.</p> +<p>If <a href="qtuitest-inputwidget.html#canEnter">canEnter</a>() returns true and this function returns false, an error has occurred and this widget is left in an undefined state.</p> +<h3 class="fn"><a name="entered"></a>void InputWidget::entered ( const QVariant & <i>item</i> ) <tt> [signal]</tt></h3> +<p>This signal is emitted when <i>item</i> is entered into the widget by the user.</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> diff --git a/old/doc/html/qtuitest-labelwidget-members.html b/old/doc/html/qtuitest-labelwidget-members.html new file mode 100644 index 0000000..2bb92c1 --- /dev/null +++ b/old/doc/html/qtuitest-labelwidget-members.html @@ -0,0 +1,26 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>List of All Members for LabelWidget</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">List of All Members for LabelWidget</h1> +<p>This is the complete list of members for <a href="qtuitest-labelwidget.html">QtUiTest::LabelWidget</a>, including inherited members.</p> +<ul> +<li><div class="fn"><b><a href="qtuitest-labelwidget.html#buddy">buddy</a></b> () const : QObject *</div></li> +<li><div class="fn"><b><a href="qtuitest-labelwidget.html#labelText">labelText</a></b> () const : QString</div></li> +</ul> +<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> diff --git a/old/doc/html/qtuitest-labelwidget.html b/old/doc/html/qtuitest-labelwidget.html new file mode 100644 index 0000000..e5956c8 --- /dev/null +++ b/old/doc/html/qtuitest-labelwidget.html @@ -0,0 +1,49 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>LabelWidget Class 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">LabelWidget Class Reference<br /><span class="small-subtitle">(QtUiTest::LabelWidget)<br />[QtUiTestModule]</span> +</h1> +<p>The LabelWidget class provides an abstract base class for all test widgets which are conceptually labels. <a href="#details">More...</a></p> +<pre> #include <<a href="qtuitest.html">QtUiTest</a>></pre><p><b>This class is under development and is subject to change.</b></p> +<ul> +<li><a href="qtuitest-labelwidget-members.html">List of all members, including inherited members</a></li> +</ul> +<hr /> +<a name="public-functions"></a> +<h2>Public Functions</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">virtual QObject * </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-labelwidget.html#buddy">buddy</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QString </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-labelwidget.html#labelText">labelText</a></b> () const = 0</td></tr> +</table> +<a name="details"></a> +<hr /> +<h2>Detailed Description</h2> +<p>The LabelWidget class provides an abstract base class for all test widgets which are conceptually labels.</p> +<p>Some widgets may act as labels for themselves while also providing other functionality. For example, a button widget labels itself and is also an <a href="qtuitest-activatewidget.html">ActivateWidget</a>.</p> +<p>Examples of widgets suitable for this interface include QLabel.</p> +<hr /> +<h2>Member Function Documentation</h2> +<h3 class="fn"><a name="buddy"></a>QObject * LabelWidget::buddy () const <tt> [virtual]</tt></h3> +<p>Returns the label's buddy widget, or 0 if this widget has no buddy. The buddy-label relationship is used by <a href="qtuitest.html">QtUiTest</a> as part of query path resolution.</p> +<p>The returned object may be an actual QWidget, or may be a wrapping test widget. Therefore, the only safe way to use the returned value of this function is to cast it to the desired <a href="qtuitest.html">QtUiTest</a> interface using <a href="qtuitest.html">qtuitest_cast</a>.</p> +<p>See also QLabel::buddy(), <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="labelText"></a>QString LabelWidget::labelText () const <tt> [pure virtual]</tt></h3> +<p>Returns the text displayed on this label.</p> +<p>Most label widgets will also implement <a href="qtuitest-textwidget.html">QtUiTest::TextWidget</a>. Most commonly, labelText() returns the same value as <a href="qtuitest-textwidget.html#text">QtUiTest::TextWidget::text</a>().</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> diff --git a/old/doc/html/qtuitest-listwidget-members.html b/old/doc/html/qtuitest-listwidget-members.html new file mode 100644 index 0000000..1097cd8 --- /dev/null +++ b/old/doc/html/qtuitest-listwidget-members.html @@ -0,0 +1,27 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>List of All Members for ListWidget</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">List of All Members for ListWidget</h1> +<p>This is the complete list of members for <a href="qtuitest-listwidget.html">QtUiTest::ListWidget</a>, including inherited members.</p> +<ul> +<li><div class="fn"><b><a href="qtuitest-listwidget.html#ensureVisible">ensureVisible</a></b> ( const QString & ) : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-listwidget.html#list">list</a></b> () const : QStringList</div></li> +<li><div class="fn"><b><a href="qtuitest-listwidget.html#visualRect">visualRect</a></b> ( const QString & ) const : QRect</div></li> +</ul> +<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> diff --git a/old/doc/html/qtuitest-listwidget.html b/old/doc/html/qtuitest-listwidget.html new file mode 100644 index 0000000..576e3bb --- /dev/null +++ b/old/doc/html/qtuitest-listwidget.html @@ -0,0 +1,53 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>ListWidget Class 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">ListWidget Class Reference<br /><span class="small-subtitle">(QtUiTest::ListWidget)<br />[QtUiTestModule]</span> +</h1> +<p>The ListWidget class provides an abstract base class for all test widgets which display a list of items to the user. <a href="#details">More...</a></p> +<pre> #include <<a href="qtuitest.html">QtUiTest</a>></pre><p><b>This class is under development and is subject to change.</b></p> +<ul> +<li><a href="qtuitest-listwidget-members.html">List of all members, including inherited members</a></li> +</ul> +<hr /> +<a name="public-functions"></a> +<h2>Public Functions</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-listwidget.html#ensureVisible">ensureVisible</a></b> ( const QString & <i>item</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QStringList </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-listwidget.html#list">list</a></b> () const = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QRect </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-listwidget.html#visualRect">visualRect</a></b> ( const QString & <i>item</i> ) const = 0</td></tr> +</table> +<a name="details"></a> +<hr /> +<h2>Detailed Description</h2> +<p>The ListWidget class provides an abstract base class for all test widgets which display a list of items to the user.</p> +<p>QtUiTest::ListWidget allows a widget which is conceptually a list to be enumerated. This is closely related to <a href="qtuitest-selectwidget.html">QtUiTest::SelectWidget</a>, which may be implemented to allow a user to select an item from a list.</p> +<p>Examples of widgets suitable for this interface include QAbstractItemView, QComboBox and QMenu.</p> +<p>See also <a href="qtuitest-selectwidget.html">QtUiTest::SelectWidget</a>.</p> +<hr /> +<h2>Member Function Documentation</h2> +<h3 class="fn"><a name="ensureVisible"></a>bool ListWidget::ensureVisible ( const QString & <i>item</i> ) <tt> [virtual]</tt></h3> +<p>Simulates the user input necessary to navigate this widget until <i>item</i> is currently visible and return true on success.</p> +<p>For example, in a QAbstractItemView with vertical scrollbars, if <i>item</i> exists further down the list than currently shown, this function might simulate 'Down' key clicks until it becomes visible.</p> +<p>The base implementation does nothing and returns true.</p> +<h3 class="fn"><a name="list"></a>QStringList ListWidget::list () const <tt> [pure virtual]</tt></h3> +<p>Returns a list containing a text representation of each item in this list widget.</p> +<h3 class="fn"><a name="visualRect"></a>QRect ListWidget::visualRect ( const QString & <i>item</i> ) const <tt> [pure virtual]</tt></h3> +<p>Returns the bounding rect of <i>item</i>, in widget coordinates. If <i>item</i> isn't currently shown in this widget, returns a null rect.</p> +<p>See also QAbstractItemView::visualRect().</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> diff --git a/old/doc/html/qtuitest-manual.html b/old/doc/html/qtuitest-manual.html new file mode 100644 index 0000000..946f903 --- /dev/null +++ b/old/doc/html/qtuitest-manual.html @@ -0,0 +1,290 @@ +<?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"> +<!-- ../../doc/src/qtuitest_manual.qdoc --> +<head> + <title>QtUiTest Manual</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">QtUiTest Manual<br /><span class="subtitle"></span> +</h1> +<p>The <a href="qtuitest.html">QtUiTest</a> framework is a tool for automatic and semi-automatic User Interface/System level testing of Qt based applications and libraries. <a href="qtuitest.html">QtUiTest</a> provides functionality commonly found in system test frameworks but with a focus on maintainable cross-platform tests.</p> +<p>Contents: <ul><li><a href="#introduction">Introduction</a></li> +<li><a href="#the-scripting-language">The Scripting Language</a></li> +<ul><li><a href="#language-design-philosophy">Language design philosophy</a></li> +</ul> +<li><a href="#using-qtuitest">Using QtUiTest</a></li> +<ul><li><a href="#creating-a-test">Creating a Test</a></li> +<ul><li><a href="#writing-a-manual-system-test">Writing a Manual System Test</a></li> +</ul> +<li><a href="#running-a-test">Running a Test</a></li> +<ul><li><a href="#running-tests-in-a-continuous-integration-system">Running tests in a Continuous Integration System</a></li> +</ul> +<li><a href="#qtuitest-tutorial">QtUiTest Tutorial</a></li> +</ul> +<li><a href="#qtuitest-api-overview">QtUiTest API Overview</a></li> +<ul><li><a href="#system-architecture">System Architecture</a></li> +<li><a href="#query-paths">Query Paths</a></li> +<ul><li><a href="#labels">Labels</a></li> +<li><a href="#signatures">Signatures</a></li> +<li><a href="#querying-widgets-by-property">Querying Widgets By Property</a></li> +</ul> +<li><a href="#learn-mode">Learn Mode</a></li> +<li><a href="#application-management">Application Management</a></li> +<li><a href="#file-management">File Management</a></li> +<li><a href="#querying-objects">Querying Objects</a></li> +<li><a href="#text-entry-and-navigation">Text Entry and Navigation</a></li> +<li><a href="#key-simulation">Key Simulation</a></li> +<li><a href="#mouse-touchscreen-simulation">Mouse / Touchscreen Simulation</a></li> +<li><a href="#other">Other</a></li> +</ul> +<li><a href="#extending-qtuitest-for-custom-widgets">Extending QtUiTest for Custom Widgets</a></li> +<li><a href="#qtuitest-api-reference">QtUiTest API Reference</a></li> +</ul> +</p> +<a name="introduction"></a> +<h2>Introduction</h2> +<p><a href="qtuitest.html">QtUiTest</a> is, by design, quite similar to the QTestLib API that is used for Unit level testing. In contrast to QTestLib however, <a href="qtuitest.html">QtUiTest</a> based tests are written in QtScript. Please refer to the QTestLib Manual if you are looking for a Unit test framework.</p> +<p><a href="qtuitest.html">QtUiTest</a> is a scripting test language plus some basic test execution tools and as such does not provide a complete Integrated Development Environment (IDE) to write and execute tests. Tests can be written with any standard editor or development IDE. Tests can be executed from the command line or in continuous integration test systems.</p> +<a name="the-scripting-language"></a> +<h2>The Scripting Language</h2> +<a name="language-design-philosophy"></a> +<h3>Language design philosophy</h3> +<p><a href="qtuitest.html">QtUiTest</a> aims to provide a test scripting language that is:</p> +<ul> +<li>simple, reliable and easy to learn,</li> +<li>resilient to UI changes,</li> +<li>transparent to device changes (i.e. a touchscreen and keyboard based device should run the same test),</li> +<li>suitable for performance testing.</li> +</ul> +<p><a href="qtuitest.html">QtUiTest</a> scripts are written from a User perspective. When a User uses a GUI application all he/she does is apply a few concepts that form the basis of using a GUI application. For instance, a button can be clicked on and then 'the text on the button' will happen.</p> +<p>It is irrelevant to the user that the actual UI implementation uses a button. The UI could just as well have been an html page with a hyperlink in it with a similar text as on the button. In both cases, the user will 'select' the text to initiate a certain action from the application. So, today the implementation can be a button, tomorrow it can be a hyperlink, the day after tomorrow it can be something that hasn't been invented yet: the principle remains the same.</p> +<p>So conceptually a user does not 'click' keys, but rather uses the concept of a button to 'select' an action or hits keys on a real or virtual keyboard to 'enter' text. The user wants something to happen and has an understanding of what needs to be done to "get there".</p> +<p>On a new system a user first needs to learn the User Manual. The more the system behaves in a way the user already knows, and the more the system provides functionality in a way the user can predict, the more "Intuitive" and "Usable" the system is experienced by the user.</p> +<p>System testing is, in our view, very much related to these fundamental issues and just like a real user, <a href="qtuitest.html">QtUiTest</a> understands the UI concepts that form the foundation of a UI application and uses a simple syntax to enable the tester to describe it's Use Cases.</p> +<p>Next to being able to write tests in a language that is as close as possible to the user experience it is also important to write maintainable code. Automating tests is well known to be major investment, and tests being broken for every small UI change, or tests that need to be modified for each slightly different device (or Operating System) are a major problem. <a href="qtuitest.html">QtUiTest</a> is designed in such a way that the script will result in good readable and understandable code which reduces the need for additional documentation, as well as tests that are platform agnostic.</p> +<ul> +<li>The four most important commands are <a href="qsystemtest.html#select">select()</a>, <a href="qsystemtest.html#enter">enter()</a>, <a href="qsystemtest.html#compare">compare()</a> and <a href="qsystemtest.html#verify">verify()</a>.</li> +<li>Every command is making verification steps along the way. For instance, <a href="qsystemtest.html#enter">enter()</a> will perform a verification at the end to ensure that the text has been entered correctly.</li> +<li>There is no need to explicitly code key clicks or mouse clicks. The usage of key/mouse clicks typically results in low level code that is difficult to understand and should only be used in exceptional cases.</li> +<li>The test can be executed equally well with a keyboard based and/or a mouse/touchscreen based system.</li> +<li>There is usually no need for explicit synchronisation steps such as a <a href="qsystemtest.html#wait">wait()</a>: <a href="qtuitest.html">QtUiTest</a> understands that certain actions may result in a background task and will wait automatically.</li> +<li><a href="qtuitest.html">QtUiTest</a> uses the Labels that are visible on the screen to find the editable 'buddy fields'.</li> +<li><a href="qtuitest.html">QtUiTest</a> is forgiving to UI changes. For instance, the user "Name" field may start as a simple line edit, then may become a full text edit, and finally become a combobox but all this time the test will pass without as much as a single complaint: as long as a field labeled "Name" exists and a text can be successfully entered into a buddy field the test is a success from user perspective.</li> +<li>Test Data and Test Logic are separated.</li> +</ul> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="using-qtuitest"></a> +<h2>Using QtUiTest</h2> +<a name="creating-a-test"></a> +<h3>Creating a Test</h3> +<p>Each System Test is stored in its own file ending with the <tt>.js</tt> extension.</p> +<p>Within the test script, a <tt>testcase</tt> object is created containing several test functions. Within each test function, the <a href="#qtuitest-api-reference">QtUiTest API</a> scripting commands may be used, as well as standard commands provided by QtScript.</p> +<p>Helper functions and global variables can be written outside of the testcase object.</p> +<p>For example:</p> +<pre> testcase = { + testFunction1: function() { + startApplication("Dog Walker"); + select("Walk the dog...", optionsMenu()); + compare( getText(), "Dog was walked." ); + }, + + testFunction2: function() { + var i = 1; + helper(i); + } + } + + function helper(num) { + verify( num > 0 ); + ... + }</pre> +<p>The project files for System tests are usually very simple, for example:</p> +<pre> CONFIG+=systemtest + SOURCES+=sys_mytest.js</pre> +<p>Adding "systemtest" to CONFIG enables the use of the "make test" command.</p> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="writing-a-manual-system-test"></a> +<h4>Writing a Manual System Test</h4> +<p>Writing a Manual System test is typically the first step in many test automation efforts. It is far better to document and run through the steps manually to check that an idea is executable (and repeatable) before time is invested in automating all steps.</p> +<p>The downside about Manual tests is that the test is usually 'somewhere else', i.e. in a text document or spreadsheet that isn't necessarily saved in the same version control system as the source code it tests, or in a format that can be easily merged by the version control system.</p> +<p><a href="qtuitest.html">QtUiTest</a> integrates the Manual test process into the Automation process and makes it possible to seamlessly transition from a full Manual to a Semi-Automatic to a Full-Automatic test. All work is done in the same text file, so the intermediate steps are all recorded in the version control system for easy retrieval, merging and tracking.</p> +<p>A Manual test is written by using the prompt() command:</p> +<pre> my_manual_test: function() + { + prompt( "* Do something\n"+ + "* Do something else\n"+ + "* Verify that the result is as expected"); + }</pre> +<p>When a System test is executed it can be a combination of fully automated and semi-automated test functions. The automated tests simply execute without user intervention and result in a PASS/FAIL/etc. A Manual test will be executed until a prompt is detected at which time a Dialog is shown on the Desktop (host) machine containing the specified prompt text. In the dialog, the stars (*) will be replaced with "1:", "2:", etc to indicate the steps that need to be taken in sequence. The advantage of using stars (*) in the code is that lines can be inserted/removed without having to renumber the remaining steps until the end of the prompt.</p> +<p>The Dialog will also contain "Pass" and "Fail" buttons as well as a "Record" button that puts the test system into recording mode. The Pass and Fail buttons obviously must be used to indicate the result of the manual step.</p> +<p>It is perfectly fine, and to be expected, that prompts() will be combined with automated steps. For instance, one could launch an application and then select a few menu options before arriving at the section of the test that requires manual intervention.</p> +<p>For instance:</p> +<pre> startApplication("Dog Walker"); + select("Walk the dog..."); + prompt( "* Verify that the dog is having a good time");</pre> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="running-a-test"></a> +<h3>Running a Test</h3> +<p>System tests can usually be run using the command "make test". Alternatively, the <a href="qtuitest.html">QtUiTest</a> Script Execution engine (qtuitestrunner) can be called directly:</p> +<pre> qtuitestrunner <scriptname> <options></pre> +<p>These commands should be run on the desktop machine (host environment).</p> +<a name="running-tests-in-a-continuous-integration-system"></a> +<h4>Running tests in a Continuous Integration System</h4> +<p><a href="qtuitest.html">QtUiTest</a> tests can be executed from the command line of a desktop (Host) machine and as such are perfectly suited to be executed in Continuous Integration Test Systems. The output format of the test, the testresults, can be printed to the screen or saved into a file in a number of formats (such as XML) to allow easy post processing by test-reporting and defect-tracking systems.</p> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="qtuitest-tutorial"></a> +<h3>QtUiTest Tutorial</h3> +<p>Please refer to the <a href="qtuitest-tutorial.html">QtUiTest Tutorial</a> for a detailed example about writing <a href="qtuitest.html">QtUiTest</a> test cases.</p> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="qtuitest-api-overview"></a> +<h2>QtUiTest API Overview</h2> +<p>To write a System Test, create a new file containing a test script, which defines a "testcase" object with one or more test functions.</p> +<p>For example:</p> +<pre> testcase = { + testFunction1: function() { + ... + }, + testFunction2: function() { + ... + } + }</pre> +<p>The testfunctions can be written with a combination of standard QtScript and special <a href="qtuitest.html">QtUiTest</a> commands, which are grouped below.</p> +<ul> +<li><a href="#system-architecture">System Architecture</a> - briefly describes the architecture of <a href="qtuitest.html">QtUiTest</a>.</li> +<li><a href="#query-paths">Query Paths</a> - specifying widgets and objects to access.</li> +<li><a href="#querying-objects">Querying Objects</a> - getting information from widgets or objects.</li> +<li><a href="#learn-mode">Learn Mode</a> - dynamically generating test data.</li> +<li><a href="#application-management">Application Management</a> - starting and stopping applications.</li> +<li><a href="#file-management">File Management</a> - accessing files on the test system.</li> +<li>Time Management - functionality to manage the system time on the device.</li> +<li><a href="#key-simulation">Key Simulation</a> - simulating entering text, selection of items from the menus or lists, and generation of arbitrary key events.</li> +<li><a href="#mouse-touchscreen-simulation">Mouse / Touchscreen Simulation</a> - simulating user interaction via a mouse or touchscreen.</li> +<li><a href="#other">Other</a> - some miscellaneous functionality.</li> +</ul> +<a name="system-architecture"></a> +<h3>System Architecture</h3> +<p>The <a href="qtuitest.html">QtUiTest</a> framework is designed around a script execution engine (qtuitestrunner) that is executed on the desktop (host machine) and a set of <a href="qtuitest.html">QtUiTest</a> plugins that are loaded by the System Under Test (SUT). The plugins are running in the SUT process space, i.e. may be running on a device, and communicate with the System Test script execution engine via a socket based communication protocol.</p> +<p>Each test command is sent as a query to the SUT, and the script runner will be blocked until a reply is received from the SUT.</p> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="query-paths"></a> +<h3>Query Paths</h3> +<p>Most <a href="qtuitest.html">QtUiTest</a> functions use 'query paths' to identify the object on which the query needs to be performed. A query path is a string value, and is one of the following:</p> +<ul> +<li>a Label</li> +<li>a Signature</li> +</ul> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="labels"></a> +<h4>Labels</h4> +<p>A <b>Label</b> is a (usually static) text description that is associated with an editable field. In some cases, a widget is self-labelling (for example, the text property of a QPushButton), but often the label is seperate widget (usually a QLabel). The Label and Edit widgets form a "buddy pair". This relationship can be hardcoded in the application, but this is not mandatory.</p> +<p>For labels that have no buddy widget set, <a href="qtuitest.html">QtUiTest</a> resolves the buddy relationships based on relative positions of the label and edit widgets on screen. By default, for Left-to-Right languages, labels are expected to be to the left of their corresponding edit widgets (and to the right for Right-to-Left languages). However, this can be changed by using the setLabelOrientation() function.</p> +<p>For example, the code below will enter the text "dog walker" in a text field next to a Label with text "Occupation".</p> +<pre> enter( "dog walker", "Occupation" );</pre> +<p>In words the example says: "enter the text 'dog walker' into a field labeled 'Occupation'.</p> +<p>A special case of a Label is an empty string. This will resolve to the widget that currently has focus, or (for touchscreen devices) the first field in the dialog. Note that for tests that should run both on keyboard and touchscreen devices it may be risky to rely on this feature. Always explicitly specifying a Label is the most safe and portable thing to do.</p> +<p>Using a Label to identify a field is the preferred mechanism for identifying fields. It is reliable, easy to write, easy to understand and easy to debug.</p> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="signatures"></a> +<h4>Signatures</h4> +<p>In some cases it is not possible to use a label to uniquely identify a widget. In these cases it is necessary to use a <b>Signature</b> to identify the widget.</p> +<p>A Signature is a string that uniquely identifies an object. Signatures are generated by the system at run-time; the signature of a widget will be different each time a test is run, so it is not possible to hard-code a signature value in a test case.</p> +<p>The signature() function can be used to return the signature of an object based on its position relative to another widget.</p> +<pre> enter( "dog walker", signature("Label",1));</pre> +<p>In this case, the signature() function returns the first editable field to the right of or below the field associated with label "Label".</p> +<a name="querying-widgets-by-property"></a> +<h4>Querying Widgets By Property</h4> +<p>Widgets can also be specified using the findByProperty() function. This finds all widgets that match the specified property values, sorted by position (top left to bottom right). The values returned are returned as a QStringList of signatures. In addition to the properties supported by the widget, "className" and "inherits" are also supported. The "className" matches if the specified value matches the class name of the object; "inherits" matches if the class of the object inherits the specified class name.</p> +<p>For example:</p> +<pre> var toolButtons = findByProperty( { className: "QToolButton" } ); + ... + select (toolButtons[3]); + var addNewPage = findByProperty( { tooltip: "Add new page" } );</pre> +<p>Multiple property value may be specified, for example:</p> +<pre> var password = findByProperty( { className: "QLineEdit", echoMode: 2 } );</pre> +<p>Using findByProperty requires some knowledge of the inner workings of the application under test, and as such breaks some of the principles of black-box testing. It is recommended that, where possible, logic using findByProperty should be wrapped in a utility function, which can be called by the test case.</p> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="learn-mode"></a> +<h3>Learn Mode</h3> +<p>Some testcases require the existence of non-volatile test data, such as screen snapshots. To simplify the process of data gathering, the test system supports the concept of a learn mode. When a test is run in learn mode, certain actions will result in the generation of test data, which will be presented to the user to manually verify once, then stored for use in subsequent test runs. A system test is run in learn mode by supplying the <tt>-learn</tt> or <tt>-learn-all</tt> command line options.</p> +<p>The system test framework will store generated test data in the <tt>testdata</tt> subdirectory of the directory containing the test script.</p> +<p>NOTE: It is up to the tester to ensure that new learned elements are added to a version control system.</p> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="application-management"></a> +<h3>Application Management</h3> +<ul> +<li><a href="qsystemtest.html#startApplication">startApplication()</a> - start an application.</li> +</ul> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="file-management"></a> +<h3>File Management</h3> +<p>It is possible to access files on the System Under Test (even if this is another device) from within a system test.</p> +<ul> +<li><a href="qsystemtest.html#putFile">putFile()</a>, <a href="qsystemtest.html#putData">putData()</a> - copy data to the test system.</li> +<li><a href="qsystemtest.html#deletePath">deletePath()</a> - delete files from the test system.</li> +<li><a href="qsystemtest.html#getDirectoryEntries">getDirectoryEntries()</a> - read the contents of a directory on the test system.</li> +</ul> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="querying-objects"></a> +<h3>Querying Objects</h3> +<p>The system test framework provides powerful methods of obtaining information on particular objects and widgets in the system.</p> +<ul> +<li><a href="qsystemtest.html#isVisible">isVisible()</a>, <a href="qsystemtest.html#isChecked">isChecked()</a>, <a href="qsystemtest.html#isEnabled">isEnabled()</a> - retrieve simple information from widgets.</li> +<li><a href="qsystemtest.html#getText">getText()</a>, <a href="qsystemtest.html#getSelectedText">getSelectedText()</a> - retrieve a textual representation of widgets.</li> +<li><a href="qsystemtest.html#getProperty">getProperty()</a>, <a href="qsystemtest.html#setProperty">setProperty()</a>, <a href="qsystemtest.html#invokeMethod">invokeMethod()</a> - access Qt properties, signals and slots on any QObject.</li> +</ul> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="text-entry-and-navigation"></a> +<h3>Text Entry and Navigation</h3> +<p>The system test framework provides several ways of entering text into widgets and for navigating through applications.</p> +<ul> +<li><a href="qsystemtest.html#enter">enter()</a> - navigate to a widget and enter any text.</li> +<li><a href="qsystemtest.html#select">select()</a> - choose a particular item from a list, combo box, menu or navigate to a particular widget or tab.</li> +</ul> +<p>These functions are input method independant and will have the same syntax for both Keyboard and Mouse/Touchscreen based devices and are therefore the preferred commands to use in tests.</p> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="key-simulation"></a> +<h3>Key Simulation</h3> +<p>The system test framework provides several ways of generating arbitrary key events.</p> +<ul> +<li><a href="qsystemtest.html#keyPress">keyPress()</a>, <a href="qsystemtest.html#keyRelease">keyRelease()</a>, <a href="qsystemtest.html#keyRelease">keyRelease()</a>, <a href="qsystemtest.html#keyClickHold">keyClickHold()</a> - press/release/click/hold any key.</li> +</ul> +<p>Note that Key simulation should be used in exceptional cases only since it makes the test specific for keyboard based devices. Other functions such as select() are the preferred mechanism to write tests because these will work both for Keyboard and Mouse/Touchscreen based devices.</p> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="mouse-touchscreen-simulation"></a> +<h3>Mouse / Touchscreen Simulation</h3> +<p>The system test framework provides methods to simulate input from a mouse or touchscreen.</p> +<ul> +<li><a href="qsystemtest.html#mousePress">mousePress()</a>, <a href="qsystemtest.html#mouseRelease">mouseRelease()</a>, <a href="qsystemtest.html#mouseClick">mouseClick()</a>, <a href="qsystemtest.html#mouseClickHold">mouseClickHold()</a> - press/release/click with mouse or touchscreen.</li> +</ul> +<p>Note that Mouse simulation should be used in exceptional cases only since it makes the test specific for mouse/touchscreen based devices. Other functions such as select() are the preferred mechanism to write tests because these will work both for Keyboard and Mouse/Touchscreen based devices.</p> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="other"></a> +<h3>Other</h3> +<p>Some functionality does not fall into the aforementioned categories:</p> +<ul> +<li><a href="qsystemtest.html#setSetting">setSetting()</a>, <a href="qsystemtest.html#getSetting">getSetting()</a> - access any settings stored within QSettings objects.</li> +</ul> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="extending-qtuitest-for-custom-widgets"></a> +<h2>Extending QtUiTest for Custom Widgets</h2> +<p><a href="qtuitest.html">QtUiTest</a>'s high-level commands require knowledge of the widgets they interact with. For example, <a href="qsystemtest.html#select">select()</a> must know how to select items from both a combobox and a list view.</p> +<p>When testing an application which uses custom widgets, some additional steps may be required in order to use high-level <a href="qtuitest.html">QtUiTest</a> commands. The logic for interacting with custom widgets must be implemented either in the application under test or in a plugin.</p> +<p>See <a href="qtuitest-plugins.html">Creating a QtUiTest Test Widget</a> for more details.</p> +<p><a href="#introduction">Back to QtUiTest Manual</a></p> +<a name="qtuitest-api-reference"></a> +<h2>QtUiTest API Reference</h2> +<p>For a complete description of the <a href="qtuitest.html">QtUiTest</a> API please refer to <a href="qsystemtest.html">QSystemTest API</a>.</p> +<p><a href="#introduction">Back to QtUiTest Manual</a></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> diff --git a/old/doc/html/qtuitest-plugins.html b/old/doc/html/qtuitest-plugins.html new file mode 100644 index 0000000..0626397 --- /dev/null +++ b/old/doc/html/qtuitest-plugins.html @@ -0,0 +1,219 @@ +<?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"> +<!-- ../../doc/src/qtuitest_plugins.qdoc --> +<head> + <title>Creating a QtUiTest Test Widget</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">Creating a QtUiTest Test Widget<br /><span class="subtitle"></span> +</h1> +<ul><li><a href="#introduction">Introduction</a></li> +<li><a href="#when-a-test-widget-is-required">When a Test Widget is Required</a></li> +<li><a href="#choosing-the-right-interfaces">Choosing the Right Interfaces</a></li> +<li><a href="#implementing-the-test-widget">Implementing the Test Widget</a></li> +<ul><li><a href="#plugin-method">Plugin method</a></li> +<ul><li><a href="#test-widget-class">Test widget class</a></li> +<li><a href="#test-widget-factory">Test widget factory</a></li> +</ul> +<li><a href="#multiple-inheritance-method">Multiple inheritance method</a></li> +</ul> +</ul> +<a name="introduction"></a> +<h2>Introduction</h2> +<p><a href="qtuitest.html">QtUiTest</a> provides support for simulating high-level user interface interactions. Conceptually these take the form of, for example, <i>Select 'Dog' from the widget labelled 'Animal'</i>, or <i>Enter 'Bob' into the widget labelled 'Name'</i>.</p> +<p>Crucially, testcases do not need to specify the exact type of each widget or how to interact with it. Instead the logic for interacting with different types of widgets resides on the system under test, either alongside the implementation of each widget or in a plugin. Each class of widget which <a href="qtuitest.html">QtUiTest</a> can interact with has a corresponding wrapper class, referred to as a test widget.</p> +<p>This document explains when a test widget must be created and how it is implemented.</p> +<a name="when-a-test-widget-is-required"></a> +<h2>When a Test Widget is Required</h2> +<p><a href="qtuitest.html">QtUiTest</a> includes support for most Qt widgets. When a new type of widget is introduced, a test widget may be required.</p> +<p>In these cases, a test widget will almost certainly have to be implemented:</p> +<ul> +<li>A custom widget implements painting and interaction by overriding functions such as paintEvent() and keyPressEvent().</li> +<li>The behavior of a major user interface element has been customized (for example, a device profile is used which has a device-specific way of accepting incoming phone calls).</li> +</ul> +<p>In these cases, a test widget will usually not be required:</p> +<ul> +<li>A custom widget acts primarily as a container for standard widgets. In this case, <a href="qtuitest.html">QtUiTest</a> can interact with the contained widgets as normal.</li> +<li>A custom widget subclasses a standard widget and correctly reimplements virtual functions. For example, a subclass of QAbstractItemView which performs custom painting with a custom model will work with no additional effort if visualRect() is implemented correctly (for mouse interaction), standard item view key event handling is used and the item model accurately reports its data.</li> +</ul> +<p>As an example, consider a testcase for creating a contact in the addressbook application. At one point in the testcase, we wish to set the contact's title to Doctor:</p> +<p><tt>select("Dr", "Title");</tt></p> +<p>This requires that the widget referred to by "Title" implements the <a href="qtuitest-selectwidget.html">SelectWidget</a> interface. If this is not the case, the testcase fails with a failure message like the following:</p> +<p><tt>FAIL! : sys_addressbook::creating_a_contact() ERROR: Title (QComboBox(0x80b2768)) is not a SelectWidget.</tt></p> +<p>This error message indicates that the "Title" widget, which is a QComboBox, does not have any corresponding test widget which implements the <a href="qtuitest-selectwidget.html">SelectWidget</a> interface, and therefore can't have items selected from it.</p> +<p>Note that not all errors arising from missing test widgets will be of this form.</p> +<a name="choosing-the-right-interfaces"></a> +<h2>Choosing the Right Interfaces</h2> +<p>Test widgets must implement one or more of a standard set of interfaces belonging to the <a href="qtuitest.html">QtUiTest</a> namespace.</p> +<p>Test widget interfaces map to the conceptual purpose of a widget from a user's perspective. The available interfaces are listed below:</p> +<p><table class="generic" align="center" cellpadding="2" cellspacing="1" border="0"> +<thead><tr valign="top" class="qt-style"><th>Interface</th><th>Applies to</th><th>Examples</th></tr></thead> +<tr valign="top" class="odd"><td><a href="qtuitest-widget.html">Widget</a></td><td>All 2D user interface elements.</td><td>QWidget</td></tr> +<tr valign="top" class="even"><td><a href="qtuitest-activatewidget.html">ActivateWidget</a></td><td>Widgets which are activated to trigger some action.</td><td>QAbstractButton</td></tr> +<tr valign="top" class="odd"><td><a href="qtuitest-checkwidget.html">CheckWidget</a></td><td>Widgets which can be checked and unchecked.</td><td>QCheckBox, QRadioButton</td></tr> +<tr valign="top" class="even"><td><a href="qtuitest-textwidget.html">TextWidget</a></td><td>Widgets which display text.</td><td>QLineEdit, QTextEdit, QMenu, QAbstractItemView, QLabel, many others</td></tr> +<tr valign="top" class="odd"><td><a href="qtuitest-inputwidget.html">InputWidget</a></td><td>Widgets which can accept text input.</td><td>QLineEdit, QTextEdit</td></tr> +<tr valign="top" class="even"><td><a href="qtuitest-listwidget.html">ListWidget</a></td><td>Widgets which display a list of items.</td><td>QAbstractItemView, QMenu</td></tr> +<tr valign="top" class="odd"><td><a href="qtuitest-selectwidget.html">SelectWidget</a></td><td>Widgets which allow an item to be selected from a list.</td><td>QAbstractItemView, QMenu</td></tr> +</table></p> +<p>Each test widget should implement all interfaces applicable to the wrapped widget. Test widgets can subclass other test widgets and reuse already-implemented interfaces. For example, the test widget for QCheckBox could inherit from the test widget for QAbstractButton to avoid having to reimplementing the <a href="qtuitest-widget.html">Widget</a>, <a href="qtuitest-textwidget.html">TextWidget</a> and <a href="qtuitest-activatewidget.html">ActivateWidget</a> interfaces again.</p> +<p>Some test widget interfaces are strongly related and are likely to be implemented in pairs. Almost all widgets which accept text input also display the entered text, so any test widget which implements <a href="qtuitest-inputwidget.html">InputWidget</a> will usually implement <a href="qtuitest-textwidget.html">TextWidget</a>. Almost all widgets which can be selected from also display the selectable items, so any test widget which implements <a href="qtuitest-selectwidget.html">SelectWidget</a> will usually implement <a href="qtuitest-listwidget.html">ListWidget</a>.</p> +<a name="implementing-the-test-widget"></a> +<h2>Implementing the Test Widget</h2> +<p>To make a new test widget visible to <a href="qtuitest.html">QtUiTest</a>, there are two separate approaches which can be taken, each with their own advantages.</p> +<a name="plugin-method"></a> +<h3>Plugin method</h3> +<p>The plugin method involves adding the test widget code into a plugin which is then loaded by <a href="qtuitest.html">QtUiTest</a> at runtime. This is the most suitable method to use in most cases and the only method used for the test widgets shipped with <a href="qtuitest.html">QtUiTest</a>.</p> +<p>Advantages to the plugin method compared to the multiple inheritance method include:</p> +<ul> +<li>The code for the test widget is cleanly separated from the wrapped widget and hence easy to omit from a release build without the need for <tt>#ifdef</tt>s or similar measures.</li> +<li>It is easier to reuse test widget code because test widgets aren't directly tied to wrapped widgets.</li> +<li>It is possible to customize the process of <a href="qtuitest-widgetfactory.html#find">finding</a> and <a href="qtuitest-widgetfactory.html#create">creating</a> test widgets.</li> +<li>Typical multiple inheritance difficulties are avoided, such as the test widget interface API shadowing the API of the wrapped widget.</li> +</ul> +<a name="test-widget-class"></a> +<h4>Test widget class</h4> +<p>Each test widget class needs to inherit from QObject and the relevant test widget interfaces.</p> +<p>In practice, it is common for a test widget class hierarchy to be written which closely mirrors the wrapped widget class hierarchy. This makes it possible to avoid rewriting the code for common interfaces such as <a href="qtuitest-widget.html">QtUiTest::Widget</a> many times.</p> +<p>It is possible to subclass the test widgets shipped with <a href="qtuitest.html">QtUiTest</a>, although they are not guaranteed to remain source or binary compatible across releases. The convention used in the reference plugins to generate a test widget class name is to take the wrapped widget class name, drop any leading Q, and prefix Test. For example, the test widget wrappers for QWidget and QAbstractItemView are named TestWidget and TestAbstractItemView respectively.</p> +<p>Using the plugin approach, while subclassing from TestWidget to avoid reimplementing the <a href="qtuitest-widget.html">QtUiTest::Widget</a> interface, would result in a class declaration like the following:</p> +<pre> #include <testwidget.h> + class TestCustomComboBox : public TestWidget, public QtUiTest::ListWidget, + public QtUiTest::SelectWidget, public QtUiTest::TextWidget + { + Q_OBJECT + Q_INTERFACES( + QtUiTest::ListWidget + QtUiTest::SelectWidget + QtUiTest::TextWidget) + + public: + TestCustomComboBox(CustomComboBox* wrapped); + virtual ~TestCustomComboBox(); + + <span class="comment">// QtUiTest::ListWidget members</span> + virtual QStringList list() const; + virtual QRect visualRect(const QString&) const; + + <span class="comment">// QtUiTest::SelectWidget members</span> + virtual bool canSelect(QString const&) const; + virtual bool select(QString const&); + + <span class="comment">// QtUiTest::TextWidget members</span> + virtual QString text() const; + virtual QString selectedText() const; + + private: + CustomComboBox* m_wrapped; + };</pre> +<p>Implementing the test widget is as simple as retrieving the necessary information from the wrapped widget. Test widgets can create and use other test widgets at runtime when necessary, as shown in the <tt>list()</tt> function below.</p> +<pre> TestCustomComboBox::TestCustomComboBox(CustomComboBox* wrapped) + : m_wrapped(wrapped) + {} + + QStringList TestCustomComboBox::list() const + { return qtuitest_cast<QtUiTest::ListWidget*>(m_wrapped->view())->list(); } + + QString TestCustomComboBox::text() const + { return list().join("\n"); } + + QString TestCustomComboBox::selectedText() const + { return m_wrapped->currentText(); }</pre> +<p>Memory management is handled automatically; there will be a maximum of one TestCustomComboBox instance created for any CustomComboBox and it will be destroyed when the underlying CustomComboBox is destroyed.</p> +<a name="test-widget-factory"></a> +<h4>Test widget factory</h4> +<p>When using the plugin approach it is also necessary to implement a factory class. This serves as the entry point to the plugin and handles the logic for creating test widgets.</p> +<p>The test widget factory must subclass <a href="qtuitest-widgetfactory.html">QtUiTest::WidgetFactory</a> and implement the <a href="qtuitest-widgetfactory.html#create">create()</a> function to create test widgets and the <a href="qtuitest-widgetfactory.html#keys">keys()</a> function to report which widget classes can be wrapped.</p> +<pre> class TestWidgetsFactory : public QObject, public QtUiTest::WidgetFactory + { + Q_OBJECT + Q_INTERFACES(QtUiTest::WidgetFactory) + + public: + TestWidgetsFactory(); + + virtual QObject* create(QObject*); + virtual QStringList keys() const; + };</pre> +<p>The <a href="qtuitest-widgetfactory.html#create">create()</a> function is called when a new test widget is to be created. Our example widget factory handles CustomComboBox widgets and nothing else.</p> +<pre> QObject* TestWidgetsFactory::create(QObject* wrapped) + { + if ((CustomComboBox* ccb = qobject_cast<CustomComboBox*>(wrapped))) { + return new TestCustomComboBox(ccb); + } + return 0; + }</pre> +<p>The <a href="qtuitest-widgetfactory.html#keys">keys()</a> function must report which classes can be handled by this factory. Any object passed into the <a href="qtuitest-widgetfactory.html#create">create()</a> function is guaranteed to be one of the classes returned by <a href="qtuitest-widgetfactory.html#keys">keys()</a>. Classes are handled from most to least specific; when creating a test widget for CustomComboBox, a factory which handles CustomComboBox has higher priority over a factory which handles QWidget. If two or more factories handle the same class, it is undefined which factory will be asked to create the test widget.</p> +<p>Our example factory can only handle CustomComboBox widgets so it returns that class name only.</p> +<pre> QStringList TestWidgetsFactory::keys() const + { + return QStringList() << "CustomComboBox"; + }</pre> +<p>Finally, the plugin needs to be exported using the standard Qt plugin mechanism:</p> +<pre> #include <qplugin.h> + Q_EXPORT_PLUGIN2(customtestwidgets, TestWidgetsFactory)</pre> +<p>In the project's <tt>qbuild.pro</tt>, the <tt>PLUGIN_TYPE</tt> must be set to <tt>qtuitest_widgets</tt>.</p> +<a name="multiple-inheritance-method"></a> +<h3>Multiple inheritance method</h3> +<p>The multiple inheritance approach requires the widget being wrapped to implement the test widget interfaces itself.</p> +<p>Advantages to the multiple inheritance method compared to the plugin method include:</p> +<ul> +<li>The code for the test widget is in the same file as the wrapped widget and hence is more likely to be maintained if the widget is modified.</li> +<li>The test widget has access to the internal structures of the wrapped widget.</li> +<li>There is no need to write a <a href="qtuitest-widgetfactory.html">WidgetFactory</a> class to handle creation of test widgets.</li> +</ul> +<p>For example, implementing a custom combobox class along with all of the associated test widget interfaces would result in a class declaration like:</p> +<pre> class CustomComboBox : public QComboBox, public QtUiTest::Widget, + public QtUiTest::ListWidget, public QtUiTest::SelectWidget, + public QtUiTest::TextWidget + { + Q_OBJECT + Q_INTERFACES( + QtUiTest::Widget + QtUiTest::ListWidget + QtUiTest::SelectWidget + QtUiTest::TextWidget) + + public: + CustomComboBox(QWidget* parent = 0); + ... + + <span class="comment">// CustomComboBox members</span> + void addCustomItem(const QVariant& item); + void addCustomItems(const QVariantList& items); + ... + + <span class="comment">// QtUiTest::Widget members</span> + virtual const QRect& geometry() const; + virtual QRect rect() const; + ... + + <span class="comment">// QtUiTest::ListWidget members</span> + virtual QStringList list() const; + virtual QRect visualRect(const QString&) const; + ... + + <span class="comment">// etc...</span> + };</pre> +<p>Implementing the test widget is as simple as returning the necessary information. Test widgets can create and use other test widgets at runtime when necessary, as shown in the <tt>list()</tt> function below.</p> +<pre> QStringList CustomComboBox::list() const + { return qtuitest_cast<QtUiTest::ListWidget*>(view())->list(); } + + QString CustomComboBox::text() const + { return list().join("\n"); } + + QString CustomComboBox::selectedText() const + { return currentText(); }</pre> +<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> diff --git a/old/doc/html/qtuitest-selectwidget-members.html b/old/doc/html/qtuitest-selectwidget-members.html new file mode 100644 index 0000000..31f1458 --- /dev/null +++ b/old/doc/html/qtuitest-selectwidget-members.html @@ -0,0 +1,30 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>List of All Members for SelectWidget</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">List of All Members for SelectWidget</h1> +<p>This is the complete list of members for <a href="qtuitest-selectwidget.html">QtUiTest::SelectWidget</a>, including inherited members.</p> +<ul> +<li><div class="fn"><b><a href="qtuitest-selectwidget.html#canSelect">canSelect</a></b> ( const QString & ) const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-selectwidget.html#canSelectMulti">canSelectMulti</a></b> ( const QStringList & ) const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-selectwidget.html#isMultiSelection">isMultiSelection</a></b> () const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-selectwidget.html#select">select</a></b> ( const QString & ) : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-selectwidget.html#selectMulti">selectMulti</a></b> ( const QStringList & ) : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-selectwidget.html#selected">selected</a></b> ( const QString & )</div></li> +</ul> +<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> diff --git a/old/doc/html/qtuitest-selectwidget.html b/old/doc/html/qtuitest-selectwidget.html new file mode 100644 index 0000000..ed8fecd --- /dev/null +++ b/old/doc/html/qtuitest-selectwidget.html @@ -0,0 +1,71 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>SelectWidget Class 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">SelectWidget Class Reference<br /><span class="small-subtitle">(QtUiTest::SelectWidget)<br />[QtUiTestModule]</span> +</h1> +<p>The SelectWidget class provides an abstract base class for all test widgets which allow the user to select from a range of items. <a href="#details">More...</a></p> +<pre> #include <<a href="qtuitest.html">QtUiTest</a>></pre><p><b>This class is under development and is subject to change.</b></p> +<ul> +<li><a href="qtuitest-selectwidget-members.html">List of all members, including inherited members</a></li> +</ul> +<hr /> +<a name="public-functions"></a> +<h2>Public Functions</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-selectwidget.html#canSelect">canSelect</a></b> ( const QString & <i>item</i> ) const = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-selectwidget.html#canSelectMulti">canSelectMulti</a></b> ( const QStringList & <i>items</i> ) const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-selectwidget.html#isMultiSelection">isMultiSelection</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-selectwidget.html#select">select</a></b> ( const QString & <i>item</i> ) = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-selectwidget.html#selectMulti">selectMulti</a></b> ( const QStringList & <i>items</i> )</td></tr> +</table> +<hr /> +<a name="signals"></a> +<h2>Signals</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-selectwidget.html#selected">selected</a></b> ( const QString & <i>item</i> )</td></tr> +</table> +<a name="details"></a> +<hr /> +<h2>Detailed Description</h2> +<p>The SelectWidget class provides an abstract base class for all test widgets which allow the user to select from a range of items.</p> +<p>QtUiTest::SelectWidget encapsulates a widget which provides the user with a choice from a (possibly unlimited) range. This is closely related to <a href="qtuitest-listwidget.html">QtUiTest::ListWidget</a>, which may be implemented to allow a user to enumerate all items from a list.</p> +<p>Examples of widgets suitable for this interface include QAbstractItemView, QComboBox and QMenu.</p> +<p>See also <a href="qtuitest-listwidget.html">QtUiTest::ListWidget</a>.</p> +<hr /> +<h2>Member Function Documentation</h2> +<h3 class="fn"><a name="canSelect"></a>bool SelectWidget::canSelect ( const QString & <i>item</i> ) const <tt> [pure virtual]</tt></h3> +<p>Returns true if <i>item</i> can possibly be selected from this widget.</p> +<h3 class="fn"><a name="canSelectMulti"></a>bool SelectWidget::canSelectMulti ( const QStringList & <i>items</i> ) const <tt> [virtual]</tt></h3> +<p>Returns true if all of the given <i>items</i> can be selected from this widget at the same time.</p> +<p>The base implementation returns true if <a href="qtuitest-selectwidget.html#isMultiSelection">isMultiSelection</a>() returns true and <a href="qtuitest-selectwidget.html#canSelect">canSelect</a>() returns true for every item in <i>items</i>.</p> +<h3 class="fn"><a name="isMultiSelection"></a>bool SelectWidget::isMultiSelection () const <tt> [virtual]</tt></h3> +<p>Returns true if this widget supports the selection of multiple items at the same time.</p> +<p>The base implementation returns false.</p> +<h3 class="fn"><a name="select"></a>bool SelectWidget::select ( const QString & <i>item</i> ) <tt> [pure virtual]</tt></h3> +<p>Simulates the user input necessary to select <i>item</i> from this widget.</p> +<p>Returns true if <i>item</i> was successfully selected.</p> +<p>If <a href="qtuitest-selectwidget.html#canSelect">canSelect</a>() returns true and this function returns false, an error has occurred and this widget's state is undefined.</p> +<h3 class="fn"><a name="selectMulti"></a>bool SelectWidget::selectMulti ( const QStringList & <i>items</i> ) <tt> [virtual]</tt></h3> +<p>Simulates the user input necessary to select all <i>items</i> from this widget at the same time.</p> +<p>Returns true if <i>items</i> were all successfully selected.</p> +<p>If <a href="qtuitest-selectwidget.html#canSelectMulti">canSelectMulti</a>() returns true and this function returns false, an error has occurred and this widget's state is undefined.</p> +<p>The base implementation calls <a href="qtuitest-selectwidget.html#canSelectMulti">canSelectMulti</a>() to check if <i>items</i> can be selected, then calls <a href="qtuitest-selectwidget.html#select">select</a>() on each item in <i>items</i>.</p> +<h3 class="fn"><a name="selected"></a>void SelectWidget::selected ( const QString & <i>item</i> ) <tt> [signal]</tt></h3> +<p>This signal is emitted when <i>item</i> is selected from this widget.</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> diff --git a/old/doc/html/qtuitest-testwidget-members.html b/old/doc/html/qtuitest-testwidget-members.html new file mode 100644 index 0000000..a9db194 --- /dev/null +++ b/old/doc/html/qtuitest-testwidget-members.html @@ -0,0 +1,65 @@ +<?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"> +<head> + <title>List of All Members for TestWidget</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">List of All Members for TestWidget</h1> +<p>This is the complete list of members for <a href="qtuitest-testwidget.html">QtUiTest::TestWidget</a>, including inherited members.</p> +<p><table class="propsummary" width="100%" border="0" cellpadding="0" cellspacing="0"> +<tr><td width="45%" valign="top"><ul> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#TestWidget">TestWidget</a></b> ( QObject * )</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#canEnter">canEnter</a></b> ( QVariant const & ) const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#canWrap">canWrap</a></b> ( QObject * ) : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#center">center</a></b> () const : QPoint</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#children">children</a></b> () const : const QObjectList &</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#childrenVisibleRegion">childrenVisibleRegion</a></b> () const : QRegion</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#ensureVisiblePoint">ensureVisiblePoint</a></b> ( const QPoint & ) : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#ensureVisibleRegion">ensureVisibleRegion</a></b> ( QRegion const & ) : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#enter">enter</a></b> ( QVariant const &, bool ) : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-inputwidget.html#entered">entered</a></b> ( const QVariant & )</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#eventFilter">eventFilter</a></b> ( QObject *, QEvent * ) : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#focusOutEvent">focusOutEvent</a></b> ()</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#focusPolicy">focusPolicy</a></b> () const : Qt::FocusPolicy</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#focusProxy">focusProxy</a></b> () const : QObject *</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#geometry">geometry</a></b> () const : const QRect &</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#gotFocus">gotFocus</a></b> ()</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#grabPixmap">grabPixmap</a></b> ( QPixmap & ) const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#hasEditFocus">hasEditFocus</a></b> () const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#hasFocus">hasFocus</a></b> () const : bool</div></li> +</ul></td><td valign="top"><ul> +<li><div class="fn"><b><a href="qtuitest-widget.html#height">height</a></b> () const : int</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#ignoreBuddy">ignoreBuddy</a></b> () const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#ignoreScan">ignoreScan</a></b> () const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#inherits">inherits</a></b> ( QtUiTest::WidgetType ) const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#isVisible">isVisible</a></b> () const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#labelText">labelText</a></b> ( QString const & ) : QString</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#mapFromGlobal">mapFromGlobal</a></b> ( QPoint const & ) const : QPoint</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#mapToGlobal">mapToGlobal</a></b> ( QPoint const & ) const : QPoint</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#parent">parent</a></b> () const : QObject *</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#printable">printable</a></b> ( QString const & ) : QString</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#rect">rect</a></b> () const : QRect</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#setEditFocus">setEditFocus</a></b> ( bool ) : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#setFocus">setFocus</a></b> () : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#visibleRegion">visibleRegion</a></b> () const : QRegion</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#width">width</a></b> () const : int</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#windowFlags">windowFlags</a></b> () const : Qt::WindowFlags</div></li> +<li><div class="fn"><b><a href="qtuitest-testwidget.html#windowTitle">windowTitle</a></b> () const : QString</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#x">x</a></b> () const : int</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#y">y</a></b> () const : int</div></li> +</ul> +</td></tr> +</table></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> diff --git a/old/doc/html/qtuitest-testwidget.html b/old/doc/html/qtuitest-testwidget.html new file mode 100644 index 0000000..3af776a --- /dev/null +++ b/old/doc/html/qtuitest-testwidget.html @@ -0,0 +1,111 @@ +<?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"> +<head> + <title>TestWidget Class 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">TestWidget Class Reference<br /><span class="small-subtitle">(QtUiTest::TestWidget)<br /></span> +</h1> +<p>Inherits <a href="qtuitest-widget.html">QtUiTest::Widget</a> and <a href="qtuitest-inputwidget.html">QtUiTest::InputWidget</a>.</p> +<ul> +<li><a href="qtuitest-testwidget-members.html">List of all members, including inherited members</a></li> +</ul> +<hr /> +<a name="public-functions"></a> +<h2>Public 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="qtuitest-testwidget.html#TestWidget">TestWidget</a></b> ( QObject * )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#canEnter">canEnter</a></b> ( QVariant const & ) const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#ensureVisibleRegion">ensureVisibleRegion</a></b> ( QRegion const & )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#enter">enter</a></b> ( QVariant const &, bool )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QPoint </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#mapFromGlobal">mapFromGlobal</a></b> ( QPoint const & ) const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QPoint </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#mapToGlobal">mapToGlobal</a></b> ( QPoint const & ) const</td></tr> +</table> +<hr /> +<a name="reimplemented-public-functions"></a> +<h2>Reimplemented Public Functions</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">virtual const QObjectList & </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#children">children</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#focusOutEvent">focusOutEvent</a></b> ()</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual Qt::FocusPolicy </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#focusPolicy">focusPolicy</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QObject * </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#focusProxy">focusProxy</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual const QRect & </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#geometry">geometry</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#grabPixmap">grabPixmap</a></b> ( QPixmap & <i>pixmap</i> ) const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#hasFocus">hasFocus</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#isVisible">isVisible</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QObject * </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#parent">parent</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QRect </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#rect">rect</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#setEditFocus">setEditFocus</a></b> ( bool )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QRegion </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#visibleRegion">visibleRegion</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual Qt::WindowFlags </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#windowFlags">windowFlags</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QString </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#windowTitle">windowTitle</a></b> () const</td></tr> +</table> +<ul> +<li><div bar="2" class="fn"></div>29 public functions inherited from <a href="qtuitest-widget.html#public-functions">QtUiTest::Widget</a></li> +<li><div bar="2" class="fn"></div>2 public functions inherited from <a href="qtuitest-inputwidget.html#public-functions">QtUiTest::InputWidget</a></li> +</ul> +<hr /> +<a name="signals"></a> +<h2>Signals</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#gotFocus">gotFocus</a></b> ()</td></tr> +</table> +<ul> +<li><div bar="2" class="fn"></div>1 signal inherited from <a href="qtuitest-widget.html#signals">QtUiTest::Widget</a></li> +<li><div bar="2" class="fn"></div>1 signal inherited from <a href="qtuitest-inputwidget.html#signals">QtUiTest::InputWidget</a></li> +</ul> +<hr /> +<a name="static-public-members"></a> +<h2>Static Public Members</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#canWrap">canWrap</a></b> ( QObject * )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#labelText">labelText</a></b> ( QString const & )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#printable">printable</a></b> ( QString const & )</td></tr> +</table> +<hr /> +<a name="protected-functions"></a> +<h2>Protected Functions</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html#eventFilter">eventFilter</a></b> ( QObject *, QEvent * )</td></tr> +</table> +<a name="details"></a> +<hr /> +<h2>Member Function Documentation</h2> +<h3 class="fn"><a name="TestWidget"></a>TestWidget::TestWidget ( QObject * )</h3> +<h3 class="fn"><a name="canEnter"></a>bool TestWidget::canEnter ( QVariant const & ) const <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="canWrap"></a>bool TestWidget::canWrap ( QObject * ) <tt> [static]</tt></h3> +<h3 class="fn"><a name="children"></a>const QObjectList & TestWidget::children () const <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="ensureVisibleRegion"></a>bool TestWidget::ensureVisibleRegion ( QRegion const & ) <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="enter"></a>bool TestWidget::enter ( QVariant const &, bool ) <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="eventFilter"></a>bool TestWidget::eventFilter ( QObject *, QEvent * ) <tt> [protected]</tt></h3> +<h3 class="fn"><a name="focusOutEvent"></a>void TestWidget::focusOutEvent () <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="focusPolicy"></a>Qt::FocusPolicy TestWidget::focusPolicy () const <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="focusProxy"></a>QObject * TestWidget::focusProxy () const <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="geometry"></a>const QRect & TestWidget::geometry () const <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="gotFocus"></a>void TestWidget::gotFocus () <tt> [signal]</tt></h3> +<h3 class="fn"><a name="grabPixmap"></a>bool TestWidget::grabPixmap ( QPixmap & <i>pixmap</i> ) const <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="hasFocus"></a>bool TestWidget::hasFocus () const <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="isVisible"></a>bool TestWidget::isVisible () const <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="labelText"></a>QString TestWidget::labelText ( QString const & ) <tt> [static]</tt></h3> +<h3 class="fn"><a name="mapFromGlobal"></a>QPoint TestWidget::mapFromGlobal ( QPoint const & ) const <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="mapToGlobal"></a>QPoint TestWidget::mapToGlobal ( QPoint const & ) const <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="parent"></a>QObject * TestWidget::parent () const <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="printable"></a>QString TestWidget::printable ( QString const & ) <tt> [static]</tt></h3> +<h3 class="fn"><a name="rect"></a>QRect TestWidget::rect () const <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="setEditFocus"></a>bool TestWidget::setEditFocus ( bool ) <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="visibleRegion"></a>QRegion TestWidget::visibleRegion () const <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="windowFlags"></a>Qt::WindowFlags TestWidget::windowFlags () const <tt> [virtual]</tt></h3> +<h3 class="fn"><a name="windowTitle"></a>QString TestWidget::windowTitle () const <tt> [virtual]</tt></h3> +<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> diff --git a/old/doc/html/qtuitest-textwidget-members.html b/old/doc/html/qtuitest-textwidget-members.html new file mode 100644 index 0000000..71811c3 --- /dev/null +++ b/old/doc/html/qtuitest-textwidget-members.html @@ -0,0 +1,28 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>List of All Members for TextWidget</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">List of All Members for TextWidget</h1> +<p>This is the complete list of members for <a href="qtuitest-textwidget.html">QtUiTest::TextWidget</a>, including inherited members.</p> +<ul> +<li><div class="fn"><b><a href="qtuitest-textwidget.html#selectedText">selectedText</a></b> () const : QString</div></li> +<li><div class="fn"><b><a href="qtuitest-textwidget.html#selectedValue">selectedValue</a></b> () const : QVariant</div></li> +<li><div class="fn"><b><a href="qtuitest-textwidget.html#text">text</a></b> () const : QString</div></li> +<li><div class="fn"><b><a href="qtuitest-textwidget.html#value">value</a></b> () const : QVariant</div></li> +</ul> +<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> diff --git a/old/doc/html/qtuitest-textwidget.html b/old/doc/html/qtuitest-textwidget.html new file mode 100644 index 0000000..745cf90 --- /dev/null +++ b/old/doc/html/qtuitest-textwidget.html @@ -0,0 +1,58 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>TextWidget Class 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">TextWidget Class Reference<br /><span class="small-subtitle">(QtUiTest::TextWidget)<br />[QtUiTestModule]</span> +</h1> +<p>The TextWidget class provides an abstract base class for all test widgets which display text to the user. <a href="#details">More...</a></p> +<pre> #include <<a href="qtuitest.html">QtUiTest</a>></pre><p><b>This class is under development and is subject to change.</b></p> +<ul> +<li><a href="qtuitest-textwidget-members.html">List of all members, including inherited members</a></li> +</ul> +<hr /> +<a name="public-functions"></a> +<h2>Public Functions</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">virtual QString </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-textwidget.html#selectedText">selectedText</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QVariant </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-textwidget.html#selectedValue">selectedValue</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QString </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-textwidget.html#text">text</a></b> () const = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QVariant </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-textwidget.html#value">value</a></b> () const</td></tr> +</table> +<a name="details"></a> +<hr /> +<h2>Detailed Description</h2> +<p>The TextWidget class provides an abstract base class for all test widgets which display text to the user.</p> +<p>The QtUiTest::TextWidget interface should be implemented on any widget which shows any text at all. This is the primary interface <a href="qtuitest.html">QtUiTest</a> uses to determine text->widget mappings, and it is used to implement <a href="qsystemtest.html#getText">getText()</a>, a heavily used verification mechanism.</p> +<p>This interface is closely related to <a href="qtuitest-inputwidget.html">QtUiTest::InputWidget</a>, which provides an interface for entering text into a widget. Any widgets which contain user-editable text will typically implement both <a href="qtuitest-inputwidget.html">QtUiTest::InputWidget</a> and QtUiTest::TextWidget.</p> +<p>Examples of widgets suitable for this interface include QLabel, QAbstractButton, QLineEdit, QTextEdit and many more.</p> +<p>See also <a href="qtuitest-inputwidget.html">QtUiTest::InputWidget</a>.</p> +<hr /> +<h2>Member Function Documentation</h2> +<h3 class="fn"><a name="selectedText"></a>QString TextWidget::selectedText () const <tt> [virtual]</tt></h3> +<p>Returns the text in this widget which is currently selected / highlighted. If the widget does not support the concept of selected text, this function should return the same as <a href="qtuitest-textwidget.html#text">text</a>().</p> +<p>The base implementation calls <a href="qtuitest-textwidget.html#text">text</a>().</p> +<p>See also QLineEdit::selectedText().</p> +<h3 class="fn"><a name="selectedValue"></a>QVariant TextWidget::selectedValue () const <tt> [virtual]</tt></h3> +<p>Returns the value in this widget which is currently selected / highlighted. If the widget does not support the concept of a selected value, this function should return the same as <a href="qtuitest-textwidget.html#value">value</a>().</p> +<p>The base implementation calls <a href="qtuitest-textwidget.html#selectedText">selectedText</a>().</p> +<h3 class="fn"><a name="text"></a>QString TextWidget::text () const <tt> [pure virtual]</tt></h3> +<p>Returns all of the text this widget is currently presenting to the user.</p> +<h3 class="fn"><a name="value"></a>QVariant TextWidget::value () const <tt> [virtual]</tt></h3> +<p>Returns the value this widget is currently presenting to the user.</p> +<p>The returned value will be of whatever type is most appropriate for this widget. For example, a QLineEdit would return a literal copy of its text (giving the same result as the <a href="qtuitest-textwidget.html#text">text</a>() function), while a QTimeEdit may return a QTime.</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> diff --git a/old/doc/html/qtuitest-tutorial.html b/old/doc/html/qtuitest-tutorial.html new file mode 100644 index 0000000..ddee10a --- /dev/null +++ b/old/doc/html/qtuitest-tutorial.html @@ -0,0 +1,39 @@ +<?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"> +<!-- ../../doc/src/qtuitest_tutorial.qdoc --> +<head> + <title>QtUiTest Tutorial</title> + <link rel="contents" href="qtuitest-manual.html" /> + <link rel="next" href="qtuitest-tutorial1.html" /> + <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><p> +[<a href="qtuitest-manual.html">QtUiTest Manual</a>] +[Next: <a href="qtuitest-tutorial1.html">Chapter 1</a>] +</p> +<h1 class="title">QtUiTest Tutorial<br /><span class="subtitle"></span> +</h1> +<p>This tutorial gives a short introduction on the creation of System Tests using the <a href="qtuitest.html">QtUiTest</a> framework. It is divided into the following chapters:</p> +<ol type="1"> +<li><a href="qtuitest-tutorial1.html">Writing a System Test</a></li> +<li><a href="qtuitest-tutorial2.html">Input, Output and Widget Navigation</a></li> +<li><a href="qtuitest-tutorial3.html">Data Driven Testing</a></li> +<li><a href="qtuitest-tutorial4.html">Putting It All Together</a></li> +</ol> +<p> +[<a href="qtuitest-manual.html">QtUiTest Manual</a>] +[Next: <a href="qtuitest-tutorial1.html">Chapter 1</a>] +</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> diff --git a/old/doc/html/qtuitest-tutorial1.html b/old/doc/html/qtuitest-tutorial1.html new file mode 100644 index 0000000..f81a822 --- /dev/null +++ b/old/doc/html/qtuitest-tutorial1.html @@ -0,0 +1,177 @@ +<?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"> +<!-- ../../doc/src/qtuitest_tutorial.qdoc --> +<head> + <title>Chapter 1: Writing a System Test</title> + <link rel="contents" href="qtuitest-tutorial.html" /> + <link rel="next" href="qtuitest-tutorial2.html" /> + <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><p> +[<a href="qtuitest-tutorial.html">Contents</a>] +[Next: <a href="qtuitest-tutorial2.html">Chapter 2</a>] +</p> +<h1 class="title">Chapter 1: Writing a System Test<br /><span class="subtitle"></span> +</h1> +<p>In this first chapter we will demonstrate how to write a simple system test, and how to execute it.</p> +<a name="setting-up-the-environment"></a> +<h2>Setting up the environment</h2> +<p>Tests are saved in directories, one directory per test. As a convention we keep the name of the directory the same as the test name although this isn't a requirement. Tests are further stored in a 'tests' directory immediately under the application or library that is being tested. So let's create our first test directory, and we'll be writing a test for the addressbook application.</p> +<pre> cd src/applications/addressbook + mkdir -p tests/sys_demo</pre> +<p>Note that we write and save tests in the <tt>source</tt> tree, and we can execute them from the source as well as the build tree.</p> +<p>The <tt>tests</tt> subdirectories have a special meaning when used in combination with QBuild, the Qt Extended build system. Anything below <tt>tests</tt> is ignored from a normal build. In other words, all code is compiled when 'configure && qbuild && qbuild image' is executed except for the testcases beneath <tt>tests</tt>.</p> +<p>To run a testcase we do a <tt>qbuild test</tt> but more about that a little later.</p> +<a name="writing-the-test"></a> +<h2>Writing the Test</h2> +<p>New system tests are defined by creating a new QtScript file (named ending with .js by convention), containing a <tt>testcase</tt> object with one or more test functions: So cd into <tt>tests/my_demo</tt> and create a file named <tt>sys_demo.js</tt> with the following content:</p> +<pre> testcase = { + testFunction1: function() { + print( "Hello World" ); + }, + testFunction2: function() { + print( "Testfunction 2" ); + } + }</pre> +<p>The example above shows the creation of a testcase object containing two test functions, <tt>testFunction1</tt> and <tt>testFunction2</tt>. Obviously not much exciting is going to happen when we run this test. But we'll get to that a little later.</p> +<p>The second bit that needs to be done is tell the build system about our new project. For this we need to create a project file named <tt>qbuild.pro</tt>. The contents of the file is as follows:</p> +<pre> CONFIG+=systemtest + TARGET=sys_demo + SOURCES+=sys_demo.js</pre> +<a name="running-the-test-for-the-first-time"></a> +<h3>Running the test for the first time</h3> +<p>Now that we have created a little test it's about time to run it for which we use QBuild again. <tt>qbuild</tt> is a binary that is created when <tt>configure</tt> is ran on the Qt Extended source tree and will end up in the bin directory of the build tree. Whenever we want to run tests, or re-compile parts of Qt Extended for that matter, it is important to call the qbuild binary from the build tree. The simplest mechanism to make that happen is to add the bin directory to our PATH variable:</p> +<pre> export PATH=~/build/qtopia/demo/bin:$PATH</pre> +<p>(assuming that <tt>~/build/qtopia/demo</tt> is where the code has been build.</p> +<p>Once the PATH is set correctly we can simply run the test as follows:</p> +<pre> cd <your_src_location>/src/applications/addressbook/tests/sys_demo + qbuild test</pre> +<p>The test will be built and executed and results in something like this:</p> +<pre> 1 echo '#!/bin/sh' > <your_build_dir>/src/applications/addressbook/tests/sys_demo/sys_demo + 2 echo 'exec <your_build_dir>/bin/qtuitestrunner <your_src_location>/src/applications/addressbook/tests/sys_demo/sys_demo.js "$@"' >> <your_build_dir>/src/applications/addressbook/tests/sys_demo/sys_demo + 3 chmod 755 <your_build_dir>/src/applications/addressbook/tests/sys_demo/sys_demo + 4 export QPEHOME=$(mktemp -d /tmp/qtopia_maketest_XXXXXX); <your_build_dir>/src/applications/addressbook/tests/sys_demo/sys_demo $ARGS; rm -rf $QPEHOME + 5 ********* Start testing of sys_demo ********* + 6 Config: Using QTest library 4.4.2, Qt 4.4.2 + 7 PASS : sys_demo::initTestCase() + 8 QDEBUG : sys_demo::testFunction1() Hello World + 9 PASS : sys_demo::testFunction1() + 10 QDEBUG : sys_demo::testFunction2() Testfunction 2 + 11 PASS : sys_demo::testFunction2() + 12 PASS : sys_demo::cleanupTestCase() + 13 Totals: 4 passed, 0 failed, 0 skipped + 14 ********* Finished testing of sys_demo *********</pre> +<p>In the above snippet line numbers have been added for clarity. Lines 1-4 are a bit of magic to create a subdirectory for the test in the build tree, and to create an 'executable' for the test. Once the executable is created, it is executed and the results are printed to stdout (or to a file if we use extra command line parameters).</p> +<p>Line 5-14 are the result of the test being execute. Line 5 simply marks the start of the test. Line 6 shows the version numbers of Qt and Qtest that are used. Line 7 is the result of a special function named <tt>initTestCase</tt>. Note that we haven't written an initTestCase yet, so this function is empty (and shouldn't fail). Once the test is initialized (with initTestCase) the testrunner will start executing all testfunctions, in principle in the order in which they are discovered in the file. Line 8 is the result of the print statement we did in testFunction1. Note also that the output clearly marks this information as being a part of <tt>sys_demo::testFunction1</tt>. Line 9 is the final test result for testFunction1. Since we did nothing else but a print statement it PASSes the test. Line 10 and 11 show the results for testFunction2. Line 12 shows the result for the counterpart to initTestCase: after all testfunctions have been executed the system takes a moment to clean up any garbage that has been created during test execution. Just like it's init counterpart is cleanupTestCase <tt>always</tt> called, and called only once, at the end of a test. Since we haven't actually defined anything yet the cleanup is empty and we'd expect it to PASS. Line 13 shows the accumulated totals for the test and Line 14 finally marks the end of the test.</p> +<p>In this example we have called <tt>qbuild test</tt> from the source tree, but we could have done the same, and with the same result from the build tree. This is because we're calling qbuild which knows everything about the actual configuration we're testing, as well as where to find it.</p> +<a name="special-functions"></a> +<h3>Special functions</h3> +<p>As with QTestLib unit tests, special reserved functions include the four init/cleanup functions. These behave identically to their unit test counterparts but will be explained here for completeness.</p> +<p><table class="generic" width="80%" align="center" cellpadding="2" cellspacing="1" border="0"> +<thead><tr valign="top" class="qt-style"><th>function</th><th>description</th></tr></thead> +<tr valign="top" class="odd"><td>initTestCase</td><td>called once immediately after the test is started. If initTestCase fails, which could happen if you add verification steps in the function, no test will be executed. In normal circumstances, each test will be executed after initTestCase is finished.</td></tr> +<tr valign="top" class="even"><td>init</td><td>called immediately <tt>before</tt> a test function is executed. If a test function has multiple test data sets (to be discussed later) then <tt>init()</tt> will also be called multiple times. When init() fails, the test function will be skipped.</td></tr> +<tr valign="top" class="odd"><td>cleanup</td><td>called immediately after a test function has finished executing. cleanup() is guaranteed to be called, even if the test function has failed, i.e. you still get a chance to cleanup the environment after a failure.</td></tr> +<tr valign="top" class="even"><td>cleanupTestCase</td><td>called once after the last test function has been executed.</td></tr> +</table></p> +<p>Let's re-write our testcase a bit, but this time we use the special functions.</p> +<pre> testcase = { + initTestCase: function() { + print( "Init complete test" ); + }, + cleanupTestCase: function() { + print( "Cleanup complete test" ); + }, + init: function() { + print( "Init test function" ); + }, + cleanup: function() { + print( "Cleanup test function" ); + }, + testFunction1: function() { + print( "Hello World" ); + }, + testFunction2: function() { + print( "Testfunction 2" ); + } + }</pre> +<p>When we run <tt>qbuild test</tt> again we get the following output:</p> +<pre> ********* Start testing of sys_demo ********* + Config: Using QTest library 4.4.2, Qt 4.4.2 + QDEBUG : sys_demo::initTestCase() Init complete test + PASS : sys_demo::initTestCase() + QDEBUG : sys_demo::testFunction1() Init test function + QDEBUG : sys_demo::testFunction1() Hello World + QDEBUG : sys_demo::testFunction1() Cleanup test function + PASS : sys_demo::testFunction1() + QDEBUG : sys_demo::testFunction2() Init test function + QDEBUG : sys_demo::testFunction2() Testfunction 2 + QDEBUG : sys_demo::testFunction2() Cleanup test function + PASS : sys_demo::testFunction2() + QDEBUG : sys_demo::cleanupTestCase() Cleanup complete test + PASS : sys_demo::cleanupTestCase() + Totals: 4 passed, 0 failed, 0 skipped + ********* Finished testing of sys_demo *********</pre> +<a name="interacting-with-the-system-under-test"></a> +<h3>Interacting with the System Under Test</h3> +<p>System tests do not have direct access to the code under test. Instead, the system testrunner connects to Qt Extended, and sends and receives information via a communication protocol. This effectively controls access to the tested system, reducing the impact of tests on results and emulating standard user behaviour.</p> +<p>Suppose we wish to create a simple test which launches an application; we first need to ensure that Qt Extended has finished loading successfully, since we can't be sure of the state of the system we have connected to. This is accomplished by using the waitForQtopiaStart() function in initTestCase():</p> +<pre> initTestCase: function() + { + waitForQtopiaStart(); + }</pre> +<p>Since <tt>initTestCase()</tt> is called before any test functions are executed, this will pause test execution until it receives confirmation that Qt Extended has started. Now we're ready to start the application:</p> +<pre> testFunction1: function() + { + startApplication( "Contacts" ); + }</pre> +<p>The <a href="qsystemtest.html#startApplication">startApplication()</a> method will attempt to start the specified application (in this case, Contacts). If the specified application cannot be started, <tt>testFunction</tt> will generate a test failure and abort the test.</p> +<p>Once the application has started, we can begin testing. While it is possible to execute as many actions in a test function as desired, the recommendation is to dedicate each test function to a single use case. The test function should then attempt to realistically simulate each step of the use case, and verify that the expected result occurs. For example, assume we need to test creating a new contact; a simple test function could look like this:</p> +<pre> creating_a_contact: function() + { + <span class="comment">// Start the application</span> + startApplication( "Contacts" ); + + <span class="comment">// Open the options menu and choose "New contact"</span> + select( "New contact", optionsMenu() ); + + <span class="comment">// Enter some details in the "Name" and "Emails" fields</span> + enter( "Frank Grimes", "Name" ); + enter( "frank@example.com", "Emails" ); + + <span class="comment">// Select 'Back' from the softkey menu to commit changes</span> + select( "Back", softMenu() ); + + <span class="comment">// We should now be at the contacts list.</span> + <span class="comment">// Verify that we can select the contact we just created.</span> + select( "Frank Grimes" ); + + <span class="comment">// We should now be viewing the contact.</span> + <span class="comment">// Move to "Details" tab.</span> + select( "Details", tabBar() ); + + <span class="comment">// Now verify that the details screen contains</span> + <span class="comment">// the expected details.</span> + var text = getText(); + verify( text.contains("Frank Grimes") ); + verify( text.contains("frank@example.com") ); + }</pre> +<p>This test function will start Contacts, navigate through several screens, input data, and verify that the data was successfully saved as a new contact. It is important to note that this test has not explicitly simulated any key or mouse events (although this can be done). This means that the same test can be used as-is on both a keyboard and touchscreen device. This is possible because the implementation of select() and enter() know how to select items and enter data on both keyboard and touchscreen devices.</p> +<p>The next chapter gives more detail on how navigation works.</p> +<p> +[<a href="qtuitest-tutorial.html">Contents</a>] +[Next: <a href="qtuitest-tutorial2.html">Chapter 2</a>] +</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> diff --git a/old/doc/html/qtuitest-tutorial2.html b/old/doc/html/qtuitest-tutorial2.html new file mode 100644 index 0000000..1b0ea5e --- /dev/null +++ b/old/doc/html/qtuitest-tutorial2.html @@ -0,0 +1,93 @@ +<?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"> +<!-- ../../doc/src/qtuitest_tutorial.qdoc --> +<head> + <title>Chapter 2: Input, Output and Widget Navigation</title> + <link rel="prev" href="qtuitest-tutorial1.html" /> + <link rel="contents" href="qtuitest-tutorial.html" /> + <link rel="next" href="qtuitest-tutorial3.html" /> + <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><p> +[Previous: <a href="qtuitest-tutorial1.html">Chapter 1</a>] +[<a href="qtuitest-tutorial.html">Contents</a>] +[Next: <a href="qtuitest-tutorial3.html">Chapter 3</a>] +</p> +<h1 class="title">Chapter 2: Input, Output and Widget Navigation<br /><span class="subtitle"></span> +</h1> +<p>System tests generally consist of a series of actions and verification that the expected behaviour took place. When testing a Qt Extended application, this usually takes the form of simulating the input of specific text and verifying that the application subsequently displays the correct text. Testing necessarily includes navigating through forms and menus, activating buttons and comboboxes, and similar tasks. <a href="qtuitest.html">QtUiTest</a> makes this very easy by supplying simple yet powerful navigation and input/output methods.</p> +<a name="basic-input"></a> +<h2>Basic Input</h2> +<p>Using QtUitest, it is possible to simulate individual keyclicks, perhaps the most simple form of user interaction that can be simulated.</p> +<pre> mytestcase = { + mytestfunction: function() { + keyClick(Qt.Key_A); + keyClick(Qt.Key_B); + keyClick(Qt.Key_C); + } + }</pre> +<p>In the above example, the calls to <a href="qsystemtest.html#keyClick">keyClick()</a> simulate a few individual key clicks, exactly as if the user had physically pressed keys on the device.</p> +<p>However, there are several disadvantages to this approach. Firstly, it is extremely verbose. Secondly, it means that the test will only work on a keypad device. To avoid these problems, the <a href="qsystemtest.html#enter">enter()</a> function is provided:</p> +<pre> mytestcase = { + mytestfunction: function() { + enter("abc"); + } + }</pre> +<p>On a keypad device, the above example has the same affect as the previous example, but is more concise. However, this test now has the additional advantage that it can work on a touchscreen device, as <a href="qsystemtest.html#enter">enter()</a> knows how to simulate the necessary touchscreen events to input the given text.</p> +<a name="input-into-specific-widgets"></a> +<h2>Input Into Specific Widgets</h2> +<p>In both of the examples above, input would be delivered to whichever widget is currently focused. In practice, what we often wish to do is enter text into a series of widgets displayed to the user.</p> +<p>For example, consider the following screen for entering the details of a new contact.</p> +<p align="center"><font color="red">[Missing image fields_example.png]</font></p><p>It would be possible to enter text in each field on this screen by using <tt>enter()</tt> and <tt>keyClick(Qt.Key_Down)</tt>. However, the test would easily break if the order of fields were changed, or if fields were added or removed, and the test would not work on a touchscreen device.</p> +<p>To solve this problem, <tt>enter()</tt> (and many other functions in <a href="qtuitest.html">QtUiTest</a>) take an optional <i>Query Path</i> parameter, which specifies which widget to operate on. The most common usage of query paths takes the form "LabelText", which refers to any widget which can receive input and is named or labeled "LabelText".</p> +<p>Entering text into a few fields on the screen featured above is achieved by the following example:</p> +<pre> mytestfunction: function() { + enter("Yoyo Corporation", "Company"); + enter("Yoyo Engineer", "Title"); + enter("x51 YOYO", "Phone"); + }</pre> +<p>In the above example, if any of the specified fields are moved, the test will continue to work as expected. If any of the specified fields are removed, renamed, or no longer visible, the test will fail with a message indicating it cannot find the specified field.</p> +<a name="selecting-items-from-lists-and-menus-and-activating-buttons"></a> +<h2>Selecting Items from Lists and Menus, and Activating Buttons</h2> +<p>Often, a user will be presented with a list of items or a context menu. <a href="qtuitest.html">QtUiTest</a> provides a simple way to navigate to and select items in any list- or menu-like widget. The <a href="qsystemtest.html#select">select()</a> function will select an item from a list, combo box, menu or tab widget by looking at the display text for each item. It can also be used to activate a button with the given text.</p> +<pre> mytestfunction: function() { + <span class="comment">// Select "Show contacts" from the options (context) menu.</span> + select("Show contacts", optionsMenu()); + + <span class="comment">// Select "Bob" in the currently shown list.</span> + select("Bob"); + + <span class="comment">// Activate the "Edit" button to edit Bob's details.</span> + select("Edit"); + + <span class="comment">// Fill in the "Gender" field (a combo box) for Bob.</span> + select("Male", "Gender"); + }</pre> +<p>select() allows a test to be reused by keypad and touchscreen devices. For instance, consider select("Edit") from the above example. On a touchscreen device, this will simply result in a click being simulated at the co-ordinates of the Edit button. On a keypad device, keyclicks will be simulated to navigate to and activate the Edit button.</p> +<a name="output"></a> +<h2>Output</h2> +<p>Built-in Qt and Qt Extended widgets can be queried for their currently displayed text. The <a href="qsystemtest.html#getText">getText()</a> function is the most common way of doing this.</p> +<pre> mytestfunction: function() { + enter("Yoyo Corporation", "Company"); + compare( getText("Company"), "Yoyo Corporation" ); + }</pre> +<p>The above example simply enters "Yoyo Corporation" into the "Company" field, then verifies that the field actually contains the text "Yoyo Corporation". Note that it is not necessary to explicitly call compare immediately after the enter command: it would have failed if the enter text had failed.</p> +<p>The next chapter explains how to make use of data driven testing.</p> +<p> +[Previous: <a href="qtuitest-tutorial1.html">Chapter 1</a>] +[<a href="qtuitest-tutorial.html">Contents</a>] +[Next: <a href="qtuitest-tutorial3.html">Chapter 3</a>] +</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> diff --git a/old/doc/html/qtuitest-tutorial3.html b/old/doc/html/qtuitest-tutorial3.html new file mode 100644 index 0000000..880ee61 --- /dev/null +++ b/old/doc/html/qtuitest-tutorial3.html @@ -0,0 +1,105 @@ +<?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"> +<!-- ../../doc/src/qtuitest_tutorial.qdoc --> +<head> + <title>Chapter 3: Data driven testing</title> + <link rel="prev" href="qtuitest-tutorial2.html" /> + <link rel="contents" href="qtuitest-tutorial.html" /> + <link rel="next" href="qtuitest-tutorial4.html" /> + <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><p> +[Previous: <a href="qtuitest-tutorial2.html">Chapter 2</a>] +[<a href="qtuitest-tutorial.html">Contents</a>] +[Next: <a href="qtuitest-tutorial4.html">Chapter 4</a>] +</p> +<h1 class="title">Chapter 3: Data driven testing<br /><span class="subtitle"></span> +</h1> +<p>The first page of this tutorial gave an example of testing creation of a contact:</p> +<pre> creating_a_contact: function() + { + <span class="comment">// Start the application</span> + startApplication( "Contacts" ); + + <span class="comment">// Open the options menu and choose "New contact"</span> + select( "New contact", optionsMenu() ); + + <span class="comment">// Enter some details in the "Name" and "Emails" fields</span> + enter( "Frank Grimes", "Name" ); + enter( "frank@example.com", "Emails" ); + + <span class="comment">// Select 'Back' from the softkey menu to commit changes</span> + select( "Back", softMenu() ); + + <span class="comment">// We should now be at the contacts list.</span> + <span class="comment">// Verify that we can select the contact we just created.</span> + select( "Frank Grimes" ); + + <span class="comment">// We should now be viewing the contact.</span> + <span class="comment">// Move to "Details" tab.</span> + select( "Details", tabBar() ); + + <span class="comment">// Now verify that the details screen contains</span> + <span class="comment">// the expected details.</span> + var text = getText(); + verify( text.contains("Frank Grimes") ); + verify( text.contains("frank@example.com") ); + }</pre> +<p>One problem with this test function is that only one set of values is tested. If we want to test additional values, the best way to do it is with <a href="qtuitest.html">QtUiTest</a>'s built-in support for data driven testing.</p> +<p>We create a new object, named the same as our testfunction with '_data' appended, and we make the object consist of a series of arrays:</p> +<pre> creating_a_contact_data: { + simple: [ "Frank Grimes", "frank@example.com", "+61 0321 FRANK" ], + no_email: [ "Bob Jones", undefined, "+61 0321 BOB" ], + with_middlename: [ "Jane Middlename Doe", "jmd@example.com", undefined ] + }</pre> +<p><tt>testcase.creating_a_contact_data</tt> is a table of test data with rows <tt>simple</tt>, <tt>no_email</tt> and <tt>with_middlename</tt>. Each row has 3 columns, and these are passed to the <tt>creating_a_contact</tt> test function as the arguments <tt>name</tt>, <tt>email</tt>, <tt>homephone</tt> in the example below:</p> +<pre> creating_a_contact: function(name, email, homephone) + { + <span class="comment">// Start the application</span> + startApplication( "Contacts" ); + + <span class="comment">// Open the options menu and choose "New contact"</span> + select( "New contact", optionsMenu() ); + + <span class="comment">// Enter details</span> + enter( name, "Name" ); + enter( email, "Emails" ); + enter( homephone, "Home Phone" ); + + <span class="comment">// Select 'Back' from the softkey menu to commit changes</span> + select( "Back", softMenu() ); + + <span class="comment">// We should now be at the contacts list.</span> + <span class="comment">// Verify that we can select the contact we just created.</span> + select( name ); + + <span class="comment">// We should now be viewing the contact.</span> + <span class="comment">// Move to "Details" tab.</span> + select( "Details", tabBar() ); + + <span class="comment">// Now verify that the details screen contains</span> + <span class="comment">// the expected details.</span> + var text = getText(); + if (name != undefined) verify( text.contains(name) ); + if (email != undefined) verify( text.contains(email) ); + if (homephone != undefined) verify( text.contains(homephone) ); + }</pre> +<p>This test is now much more extensible. New test cases can simply be added as new rows to the testdata table and will automatically be tested without needing to add further logic to the test function.</p> +<p> +[Previous: <a href="qtuitest-tutorial2.html">Chapter 2</a>] +[<a href="qtuitest-tutorial.html">Contents</a>] +[Next: <a href="qtuitest-tutorial4.html">Chapter 4</a>] +</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> diff --git a/old/doc/html/qtuitest-tutorial4.html b/old/doc/html/qtuitest-tutorial4.html new file mode 100644 index 0000000..f85c69e --- /dev/null +++ b/old/doc/html/qtuitest-tutorial4.html @@ -0,0 +1,106 @@ +<?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"> +<!-- ../../doc/src/qtuitest_tutorial.qdoc --> +<head> + <title>Chapter 4: Putting It All Together</title> + <link rel="prev" href="qtuitest-tutorial3.html" /> + <link rel="contents" href="qtuitest-tutorial.html" /> + <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><p> +[Previous: <a href="qtuitest-tutorial3.html">Chapter 3</a>] +[<a href="qtuitest-tutorial.html">Contents</a>] +</p> +<h1 class="title">Chapter 4: Putting It All Together<br /><span class="subtitle"></span> +</h1> +<p>Using the simple building blocks of textual input and output and navigation functions, with the data driven testing approach, a full testcase can be written for creating a new contact. Note that the functions for creating and verifying a contact have been moved out into helper functions; this allows them to be reused for subsequent tests. This is very useful for cases where, for instance, one test's precondition might be that a contact has been successfully created.</p> +<pre> testcase = { + initTestCase: function() { + <span class="comment">// Start "Contacts" when the testcase starts.</span> + startApplication( "Contacts" ); + }, + + creating_a_contact: function(name, emails, company, jobTitle, businessPhone) { + create_contact(name, emails, company, jobTitle, businessPhone); + verify_contact(name, emails, company, jobTitle, businessPhone); + }, + + creating_a_contact_data: { + simple: [ "Billy Jones", "billy@example.com", "Hotdog Inc.", "Hotdog Engineer", "12345" ], + letters_in_phone: [ "Joan Example", "joan@example.com", "Example Inc.", "Exemplary Engineer", "555 EXA" ], + three_names: [ "Jon John Johnson", "jjj@example.com", "Sillynames Inc.", "Dog Walker", "12345" ], + no_job: [ "William Doe", "bill@example.net", undefined, undefined, undefined ] + } + } + +<span class="comment"> // Create a contact with the given details.</span> + function create_contact(name, emails, company, jobTitle, businessPhone) { + <span class="comment">// Verify that we're on the home screen of the "Contacts" app.</span> + waitForTitle( "Contacts" ); + + <span class="comment">// Select "New contact" from context menu.</span> + select( "New contact", optionsMenu() ); + + <span class="comment">// Navigate to the "Contact" tab.</span> + <span class="comment">// This is the default tab, but with this code we ensure the</span> + <span class="comment">// test will work if it becomes no longer the default.</span> + select( "Contact", tabBar() ); + + <span class="comment">// Fill in fields on the "Contact" tab.</span> + <span class="comment">// enter() returns immediately if we try to enter an undefined</span> + <span class="comment">// value.</span> + enter( name, "Name" ); + enter( emails, "Emails" ); + + <span class="comment">// Navigate to the "Business" tab.</span> + select( "Business", tabBar() ); + + <span class="comment">// Fill in fields on the "Business" tab.</span> + enter( company, "Company" ); + enter( jobTitle, "Title" ); + enter( businessPhone, "Phone" ); + + <span class="comment">// Press the Back key to commit the new contact</span> + select( "Back", softMenu() ); + } + +<span class="comment"> // Verify that a contact with the given details exists.</span> + function verify_contact(name, emails, company, jobTitle, businessPhone) { + <span class="comment">// Verify that we're on the contacts list.</span> + waitForTitle( "Contacts" ); + + <span class="comment">// Select the contact with the given name.</span> + select( name ); + + <span class="comment">// Navigate to the "Details" tab and get the displayed text.</span> + select( "Details", tabBar() ); + var details = getText(); + + <span class="comment">// Now verify that the details contains all of the non-null information</span> + <span class="comment">// for the contact.</span> + if (name != undefined) verify( details.contains(name) ); + if (emails != undefined) verify( details.contains(emails) ); + if (company != undefined) verify( details.contains(company) ); + if (jobTitle != undefined) verify( details.contains(jobTitle) ); + if (businessPhone != undefined) verify( details.contains(businessPhone) ); + }</pre> +<p>The above test has been written to be reasonably permissive; it will succeed as long as the text shown by the contacts application contains all of the information for the created contact, and it does not test things such as the formatting of the given text, and does not test every single field. However, this test is well insulated against minor changes to the tested application GUI.</p> +<p><a href="qtuitest.html">QtUiTest</a> allows the tester to decide how strict a test should be. If pixel-perfect accuracy is required for output, a test can be written to test every screen with <a href="qsystemtest.html#verifyImage">verifyImage()</a>. In contrast, a high-level text-based approach as shown above can result in effective tests which remain correct even when significant UI changes occur.</p> +<p>There are many other methods available for use; for further information, refer to the <a href="qsystemtest.html">QSystemTest</a> documentation.</p> +<p> +[Previous: <a href="qtuitest-tutorial3.html">Chapter 3</a>] +[<a href="qtuitest-tutorial.html">Contents</a>] +</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> diff --git a/old/doc/html/qtuitest-widget-members.html b/old/doc/html/qtuitest-widget-members.html new file mode 100644 index 0000000..56b1fab --- /dev/null +++ b/old/doc/html/qtuitest-widget-members.html @@ -0,0 +1,58 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>List of All Members for Widget</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">List of All Members for Widget</h1> +<p>This is the complete list of members for <a href="qtuitest-widget.html">QtUiTest::Widget</a>, including inherited members.</p> +<p><table class="propsummary" width="100%" border="0" cellpadding="0" cellspacing="0"> +<tr><td width="45%" valign="top"><ul> +<li><div class="fn"><b><a href="qtuitest-widget.html#center">center</a></b> () const : QPoint</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#children">children</a></b> () const : const QObjectList &</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#childrenVisibleRegion">childrenVisibleRegion</a></b> () const : QRegion</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#ensureVisiblePoint">ensureVisiblePoint</a></b> ( const QPoint & ) : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#ensureVisibleRegion">ensureVisibleRegion</a></b> ( const QRegion & ) : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#focusOutEvent">focusOutEvent</a></b> ()</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#focusPolicy">focusPolicy</a></b> () const : Qt::FocusPolicy</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#focusProxy">focusProxy</a></b> () const : QObject *</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#geometry">geometry</a></b> () const : const QRect &</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#gotFocus">gotFocus</a></b> ()</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#grabPixmap">grabPixmap</a></b> ( QPixmap & ) const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#hasEditFocus">hasEditFocus</a></b> () const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#hasFocus">hasFocus</a></b> () const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#height">height</a></b> () const : int</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#ignoreBuddy">ignoreBuddy</a></b> () const : bool</div></li> +</ul></td><td valign="top"><ul> +<li><div class="fn"><b><a href="qtuitest-widget.html#ignoreScan">ignoreScan</a></b> () const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#inherits">inherits</a></b> ( QtUiTest::WidgetType ) const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#isVisible">isVisible</a></b> () const : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#mapFromGlobal">mapFromGlobal</a></b> ( const QPoint & ) const : QPoint</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#mapToGlobal">mapToGlobal</a></b> ( const QPoint & ) const : QPoint</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#parent">parent</a></b> () const : QObject *</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#rect">rect</a></b> () const : QRect</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#setEditFocus">setEditFocus</a></b> ( bool ) : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#setFocus">setFocus</a></b> () : bool</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#visibleRegion">visibleRegion</a></b> () const : QRegion</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#width">width</a></b> () const : int</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#windowFlags">windowFlags</a></b> () const : Qt::WindowFlags</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#windowTitle">windowTitle</a></b> () const : QString</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#x">x</a></b> () const : int</div></li> +<li><div class="fn"><b><a href="qtuitest-widget.html#y">y</a></b> () const : int</div></li> +</ul> +</td></tr> +</table></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> diff --git a/old/doc/html/qtuitest-widget.html b/old/doc/html/qtuitest-widget.html new file mode 100644 index 0000000..7775380 --- /dev/null +++ b/old/doc/html/qtuitest-widget.html @@ -0,0 +1,200 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>Widget Class 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">Widget Class Reference<br /><span class="small-subtitle">(QtUiTest::Widget)<br />[QtUiTestModule]</span> +</h1> +<p>The Widget class provides an abstract base class for all test widgets. <a href="#details">More...</a></p> +<pre> #include <<a href="qtuitest.html">QtUiTest</a>></pre><p><b>This class is under development and is subject to change.</b></p> +<p>Inherited by </p> +<ul> +<li><a href="qtuitest-widget-members.html">List of all members, including inherited members</a></li> +</ul> +<hr /> +<a name="public-functions"></a> +<h2>Public Functions</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">virtual QPoint </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#center">center</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual const QObjectList & </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#children">children</a></b> () const = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QRegion </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#childrenVisibleRegion">childrenVisibleRegion</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#ensureVisiblePoint">ensureVisiblePoint</a></b> ( const QPoint & <i>point</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#ensureVisibleRegion">ensureVisibleRegion</a></b> ( const QRegion & <i>region</i> ) = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#focusOutEvent">focusOutEvent</a></b> ()</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual Qt::FocusPolicy </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#focusPolicy">focusPolicy</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QObject * </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#focusProxy">focusProxy</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual const QRect & </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#geometry">geometry</a></b> () const = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#grabPixmap">grabPixmap</a></b> ( QPixmap & <i>pixmap</i> ) const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#hasEditFocus">hasEditFocus</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#hasFocus">hasFocus</a></b> () const = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual int </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#height">height</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#ignoreBuddy">ignoreBuddy</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#ignoreScan">ignoreScan</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#inherits">inherits</a></b> ( QtUiTest::WidgetType <i>type</i> ) const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#isVisible">isVisible</a></b> () const = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QPoint </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#mapFromGlobal">mapFromGlobal</a></b> ( const QPoint & <i>pos</i> ) const = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QPoint </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#mapToGlobal">mapToGlobal</a></b> ( const QPoint & <i>pos</i> ) const = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QObject * </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#parent">parent</a></b> () const = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QRect </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#rect">rect</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#setEditFocus">setEditFocus</a></b> ( bool <i>enable</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#setFocus">setFocus</a></b> ()</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QRegion </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#visibleRegion">visibleRegion</a></b> () const = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual int </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#width">width</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual Qt::WindowFlags </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#windowFlags">windowFlags</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QString </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#windowTitle">windowTitle</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual int </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#x">x</a></b> () const</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual int </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#y">y</a></b> () const</td></tr> +</table> +<hr /> +<a name="signals"></a> +<h2>Signals</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html#gotFocus">gotFocus</a></b> ()</td></tr> +</table> +<a name="details"></a> +<hr /> +<h2>Detailed Description</h2> +<p>The Widget class provides an abstract base class for all test widgets.</p> +<p>QtUiTest::Widget contains functionality which maps closely to QWidget. It encapsulates important information and functionality related to two-dimensional GUI elements.</p> +<p>All Qt Extended test widgets should implement the QtUiTest::Widget interface, using multiple inheritance to implement other <a href="qtuitest.html">QtUiTest</a> interfaces where suitable.</p> +<hr /> +<h2>Member Function Documentation</h2> +<h3 class="fn"><a name="center"></a>QPoint Widget::center () const <tt> [virtual]</tt></h3> +<p>Returns the center point of the widget. The base implementation returns <a href="qtuitest-widget.html#geometry">geometry</a>().center().</p> +<p>See also <a href="qtuitest-widget.html#geometry">QtUiTest::Widget::geometry</a>().</p> +<h3 class="fn"><a name="children"></a>const QObjectList & Widget::children () const <tt> [pure virtual]</tt></h3> +<p>Returns all children of this widget.</p> +<p>The returned objects may be actual QWidget instances, or may be wrapping test widgets. Therefore, the only safe way to use the returned objects are to cast them to the desired <a href="qtuitest.html">QtUiTest</a> interface using <a href="qtuitest.html">qtuitest_cast</a>.</p> +<p>Reimplementing this function allows widgets which are conceptually widgets but are not QObject subclasses to be wrapped. This can be achieved by returning a list of test widgets which do not necessarily have underlying QWidget instances.</p> +<p>See also QObject::children() and <a href="qtuitest-widget.html#parent">parent</a>().</p> +<h3 class="fn"><a name="childrenVisibleRegion"></a>QRegion Widget::childrenVisibleRegion () const <tt> [virtual]</tt></h3> +<p>Returns the currently on-screen, unobscured region of all child widgets of this widget, in widget coordinates. This does not include the visible region of this widget.</p> +<p>The base implementation calculates the visible region by calling <a href="qtuitest-widget.html#visibleRegion">visibleRegion</a>() and childrenVisibleRegion() on all <a href="qtuitest-widget.html#children">children</a>().</p> +<p>See also QWidget::visibleRegion(), <a href="qtuitest-widget.html#children">children</a>(), and <a href="qtuitest-widget.html#visibleRegion">visibleRegion</a>().</p> +<h3 class="fn"><a name="ensureVisiblePoint"></a>bool Widget::ensureVisiblePoint ( const QPoint & <i>point</i> )</h3> +<p>Simulate whatever user input is necessary to ensure that <i>point</i> (in local coordinates) is on-screen and unobscured.</p> +<p>This convenience function calls <a href="qtuitest-widget.html#ensureVisibleRegion">ensureVisibleRegion</a>() with a region containing only <i>point</i>.</p> +<p>Returns true if <i>point</i> was successfully made visible.</p> +<p>See also <a href="qtuitest-widget.html#visibleRegion">visibleRegion</a>() and <a href="qtuitest-widget.html#ensureVisibleRegion">ensureVisibleRegion</a>().</p> +<h3 class="fn"><a name="ensureVisibleRegion"></a>bool Widget::ensureVisibleRegion ( const QRegion & <i>region</i> ) <tt> [pure virtual]</tt></h3> +<p>Simulate whatever user input is necessary to ensure that <i>region</i> (in local coordinates) is on-screen and unobscured.</p> +<p>Returns true if <i>region</i> was successfully made visible.</p> +<p>See also <a href="qtuitest-widget.html#visibleRegion">visibleRegion</a>().</p> +<h3 class="fn"><a name="focusOutEvent"></a>void Widget::focusOutEvent () <tt> [virtual]</tt></h3> +<p>This function is called when this widget is about to lose keyboard focus. The base implementation does nothing.</p> +<p>This function should be reimplemented to put this widget in a state where subsequent up/down key clicks will result in non-destructive navigation between widgets.</p> +<p>For example, if this function is called on a combo box which currently has a list popped up, it should dismiss the list so that subsequent key clicks will navigate between widgets rather than navigating within the list.</p> +<pre> void MyComboBox::focusOutEvent() { + <span class="comment">// Assuming q is a QComboBox...</span> + <span class="comment">// If the list is currently popped up...</span> + if (q->view()->isVisible()) { + <span class="comment">// Press the Select key to commit the currently highlighted</span> + <span class="comment">// item and ensure we are ready to navigate by keys.</span> + QtUiTest::keyClick(Qt::Key_Select); + } + }</pre> +<p>See also QWidget::focusOutEvent(), <a href="qtuitest-widget.html#setFocus">setFocus</a>(), and <a href="qtuitest-widget.html#hasFocus">hasFocus</a>().</p> +<h3 class="fn"><a name="focusPolicy"></a>Qt::FocusPolicy Widget::focusPolicy () const <tt> [virtual]</tt></h3> +<p>Returns the focus policy of this widget.</p> +<p>The default implementation returns Qt::NoFocus, indicating that the widget does not accept focus.</p> +<p>See also QWidget::focusPolicy().</p> +<h3 class="fn"><a name="focusProxy"></a>QObject * Widget::focusProxy () const <tt> [virtual]</tt></h3> +<p>Returns the focus proxy of this widget, or 0 if this widget has no focus proxy. A widget may "have focus", but have a child widget that actually handles the focus.</p> +<p>The returned object may be an actual QWidget, or may be a wrapping test widget. Therefore, the only safe way to use the returned value of this function is to cast it to the desired <a href="qtuitest.html">QtUiTest</a> interface using <a href="qtuitest.html">qtuitest_cast</a>.</p> +<p>See also QWidget::focusProxy().</p> +<h3 class="fn"><a name="geometry"></a>const QRect & Widget::geometry () const <tt> [pure virtual]</tt></h3> +<p>Returns the geometry of this widget in parent coordinates.</p> +<p>See also QWidget::geometry().</p> +<h3 class="fn"><a name="gotFocus"></a>void Widget::gotFocus () <tt> [signal]</tt></h3> +<p>This signal is emitted when this widget gains focus by any means.</p> +<p>See also QApplication::focusChanged().</p> +<h3 class="fn"><a name="grabPixmap"></a>bool Widget::grabPixmap ( QPixmap & <i>pixmap</i> ) const <tt> [virtual]</tt></h3> +<p>Sets <i>pixmap</i> to image of the widget. Returns true on success.</p> +<p>The base implementation always returns false.</p> +<h3 class="fn"><a name="hasEditFocus"></a>bool Widget::hasEditFocus () const <tt> [virtual]</tt></h3> +<p>Returns true if this widget currently has edit focus.</p> +<p>The concept of edit focus only exists in Qt Embedded. This function must be implemented on Qt Embedded. On other platforms, the base implementation will return the same as <a href="qtuitest-widget.html#hasFocus">hasFocus</a>().</p> +<p>See also QWidget::hasEditFocus() and <a href="qtuitest-widget.html#setEditFocus">setEditFocus</a>().</p> +<h3 class="fn"><a name="hasFocus"></a>bool Widget::hasFocus () const <tt> [pure virtual]</tt></h3> +<p>Returns true if this widget currently has keyboard focus.</p> +<p>See also QWidget::hasFocus().</p> +<h3 class="fn"><a name="height"></a>int Widget::height () const <tt> [virtual]</tt></h3> +<p>Returns the height of the widget.</p> +<p>See also <a href="qtuitest-widget.html#geometry">geometry</a>().</p> +<h3 class="fn"><a name="ignoreBuddy"></a>bool Widget::ignoreBuddy () const <tt> [virtual]</tt></h3> +<p>Returns true if this widget should not considered a possible buddy for a label when resolving query paths.</p> +<p>Note that if the widget is returned as a buddy by QtUiTest::Label::buddy() then this value will be ignored.</p> +<p>The base implementation always returns false.</p> +<p>See also QtUiTest::Label::buddy(), <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="ignoreScan"></a>bool Widget::ignoreScan () const <tt> [virtual]</tt></h3> +<p>Returns true if this widget should be ignored by <a href="qtuitest.html">QtUiTest</a>. If a widget is ignored, any child widgets will still be processed.</p> +<p>The base implementation always returns false.</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="inherits"></a>bool Widget::inherits ( <a href="qtuitest.html#WidgetType-enum">QtUiTest::WidgetType</a> <i>type</i> ) const <tt> [virtual]</tt></h3> +<p>Returns true if this widget is of the given <i>type</i>.</p> +<p>The base implementation always returns false.</p> +<h3 class="fn"><a name="isVisible"></a>bool Widget::isVisible () const <tt> [pure virtual]</tt></h3> +<p>Returns true if this widget is currently visible.</p> +<p>In this context, "visible" has the same meaning as in QWidget::isVisible(). Therefore, this function returning <tt>true</tt> is not a guarantee that this widget is currently on screen and unobscured. To test this, <a href="qtuitest-widget.html#visibleRegion">visibleRegion</a>() can be used.</p> +<p>See also QWidget::isVisible() and <a href="qtuitest-widget.html#visibleRegion">visibleRegion</a>().</p> +<h3 class="fn"><a name="mapFromGlobal"></a>QPoint Widget::mapFromGlobal ( const QPoint & <i>pos</i> ) const <tt> [pure virtual]</tt></h3> +<p>Maps <i>pos</i> from global screen coordinates to widget coordinates and returns the result.</p> +<p>See also QWidget::mapFromGlobal().</p> +<h3 class="fn"><a name="mapToGlobal"></a>QPoint Widget::mapToGlobal ( const QPoint & <i>pos</i> ) const <tt> [pure virtual]</tt></h3> +<p>Maps <i>pos</i> from widget coordinates to global screen coordinates and returns the result.</p> +<p>See also QWidget::mapToGlobal().</p> +<h3 class="fn"><a name="parent"></a>QObject * Widget::parent () const <tt> [pure virtual]</tt></h3> +<p>Returns the parent of this widget, or 0 if this widget has no parent.</p> +<p>The returned object may be an actual QWidget, or may be a wrapping test widget. Therefore, the only safe way to use the returned value of this function is to cast it to the desired <a href="qtuitest.html">QtUiTest</a> interface using <a href="qtuitest.html">qtuitest_cast</a>.</p> +<p>See also QObject::parent(), QWidget::parentWidget(), and <a href="qtuitest-widget.html#children">children</a>().</p> +<h3 class="fn"><a name="rect"></a>QRect Widget::rect () const <tt> [virtual]</tt></h3> +<p>Returns the bounding rect of this widget in widget coordinates.</p> +<p>The base implementation returns <a href="qtuitest-widget.html#geometry">geometry</a>(), transformed to widget coordinates.</p> +<p>See also QWidget::rect().</p> +<h3 class="fn"><a name="setEditFocus"></a>bool Widget::setEditFocus ( bool <i>enable</i> ) <tt> [virtual]</tt></h3> +<p>Simulate the user input necessary to <i>enable</i> or disable edit focus for this widget. Enabling edit focus will implicitly call <a href="qtuitest-widget.html#setFocus">setFocus</a>() when necessary.</p> +<p>The concept of edit focus only exists in Qt Embedded. This function must be implemented when using Qt Embedded. On other platforms, this function will behave the same as <a href="qtuitest-widget.html#setFocus">setFocus</a>() when enable is true, and will have no effect when enable is false.</p> +<p>Returns true if edit focus was successfully enabled or disabled for this widget, false otherwise.</p> +<p>See also QWidget::setEditFocus() and <a href="qtuitest-widget.html#hasEditFocus">hasEditFocus</a>().</p> +<h3 class="fn"><a name="setFocus"></a>bool Widget::setFocus () <tt> [virtual]</tt></h3> +<p>Simulate the user input necessary to move keyboard focus to this widget.</p> +<p>The base implementation uses the result of <a href="qtuitest-widget.html#hasFocus">hasFocus</a>() to determine if the widget currently has focus. If in keypad mode, a sequence of Up or Down key presses will be used to move focus until this widget has focus. If in mouse mode, the center of this widget will be clicked once.</p> +<p>Due to the way this function works in keypad mode, it is very important that <a href="qtuitest-widget.html#focusOutEvent">focusOutEvent</a>() is correctly implemented for all widgets to dismiss any "grab" effects on keyboard focus.</p> +<p>When reimplementing this function, it is necessary to call <a href="qtuitest-widget.html#focusOutEvent">focusOutEvent</a>() on any widget before taking any action which could cause that widget to lose focus.</p> +<p>Returns true if focus was successfully given to this widget, false otherwise.</p> +<p>See also <a href="qtuitest-widget.html#hasFocus">hasFocus</a>(), QWidget::setFocus(), and <a href="qtuitest-widget.html#focusOutEvent">focusOutEvent</a>().</p> +<h3 class="fn"><a name="visibleRegion"></a>QRegion Widget::visibleRegion () const <tt> [pure virtual]</tt></h3> +<p>Returns the currently on-screen, unobscured region of this widget, in widget coordinates.</p> +<p>See also QWidget::visibleRegion().</p> +<h3 class="fn"><a name="width"></a>int Widget::width () const <tt> [virtual]</tt></h3> +<p>Returns the width of the widget.</p> +<p>See also <a href="qtuitest-widget.html#geometry">geometry</a>().</p> +<h3 class="fn"><a name="windowFlags"></a>Qt::WindowFlags Widget::windowFlags () const <tt> [virtual]</tt></h3> +<p>Returns the flags set on this widget.</p> +<p>The default implementation returns 0, which is equivalent to a plain Qt::Widget with no special flags set.</p> +<h3 class="fn"><a name="windowTitle"></a>QString Widget::windowTitle () const <tt> [virtual]</tt></h3> +<p>Returns the window title (caption).</p> +<p>The returned string will typically be empty for all widgets other than top-level widgets.</p> +<p>The default implementation returns an empty string.</p> +<p>See also QWidget::windowTitle().</p> +<h3 class="fn"><a name="x"></a>int Widget::x () const <tt> [virtual]</tt></h3> +<p>Returns the left of the widget, in global coordinates.</p> +<p>See also <a href="qtuitest-widget.html#mapToGlobal">mapToGlobal</a>().</p> +<h3 class="fn"><a name="y"></a>int Widget::y () const <tt> [virtual]</tt></h3> +<p>Returns the top of the widget, in global coordinates.</p> +<p>See also <a href="qtuitest-widget.html#mapToGlobal">mapToGlobal</a>().</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> diff --git a/old/doc/html/qtuitest-widgetfactory-members.html b/old/doc/html/qtuitest-widgetfactory-members.html new file mode 100644 index 0000000..b9ccd72 --- /dev/null +++ b/old/doc/html/qtuitest-widgetfactory-members.html @@ -0,0 +1,27 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>List of All Members for WidgetFactory</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">List of All Members for WidgetFactory</h1> +<p>This is the complete list of members for <a href="qtuitest-widgetfactory.html">QtUiTest::WidgetFactory</a>, including inherited members.</p> +<ul> +<li><div class="fn"><b><a href="qtuitest-widgetfactory.html#create">create</a></b> ( QObject * ) : QObject *</div></li> +<li><div class="fn"><b><a href="qtuitest-widgetfactory.html#find">find</a></b> ( QtUiTest::WidgetType ) : QObject *</div></li> +<li><div class="fn"><b><a href="qtuitest-widgetfactory.html#keys">keys</a></b> () const : QStringList</div></li> +</ul> +<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> diff --git a/old/doc/html/qtuitest-widgetfactory.html b/old/doc/html/qtuitest-widgetfactory.html new file mode 100644 index 0000000..dc74cad --- /dev/null +++ b/old/doc/html/qtuitest-widgetfactory.html @@ -0,0 +1,54 @@ +<?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"> +<!-- ../../lib/qtuitestwidgetinterface.cpp --> +<head> + <title>WidgetFactory Class 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">WidgetFactory Class Reference<br /><span class="small-subtitle">(QtUiTest::WidgetFactory)<br />[QtUiTestModule]</span> +</h1> +<p>The WidgetFactory class provides a factory interface for <a href="qtuitest.html">QtUiTest</a> widget wrapper classes. <a href="#details">More...</a></p> +<pre> #include <<a href="qtuitest.html">QtUiTest</a>></pre><p><b>This class is under development and is subject to change.</b></p> +<ul> +<li><a href="qtuitest-widgetfactory-members.html">List of all members, including inherited members</a></li> +</ul> +<hr /> +<a name="public-functions"></a> +<h2>Public Functions</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">virtual QObject * </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widgetfactory.html#create">create</a></b> ( QObject * <i>object</i> ) = 0</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QObject * </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widgetfactory.html#find">find</a></b> ( QtUiTest::WidgetType <i>type</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">virtual QStringList </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widgetfactory.html#keys">keys</a></b> () const = 0</td></tr> +</table> +<a name="details"></a> +<hr /> +<h2>Detailed Description</h2> +<p>The WidgetFactory class provides a factory interface for <a href="qtuitest.html">QtUiTest</a> widget wrapper classes.</p> +<p>QtUiTest::WidgetFactory is an abstract base class which enables the creation of <a href="qtuitest.html">QtUiTest</a> wrapper objects around Qt/Qt Extended widgets.</p> +<p>Customizing <a href="qtuitest.html">QtUiTest</a> behaviour for particular widgets is achieved by implementing one or more test widget classes which inherit from one or more <a href="qtuitest.html">QtUiTest</a> widget interfaces, subclassing QtUiTest::WidgetFactory, reimplementing the pure virtual <a href="qtuitest-widgetfactory.html#keys">keys</a>() and <a href="qtuitest-widgetfactory.html#create">create</a>() functions to create instances of the custom test widget classes, and exporting the factory class using the Q_EXPORT_PLUGIN2() macro.</p> +<hr /> +<h2>Member Function Documentation</h2> +<h3 class="fn"><a name="create"></a>QObject * WidgetFactory::create ( QObject * <i>object</i> ) <tt> [pure virtual]</tt></h3> +<p>Attempts to create a test widget to wrap <i>object</i>. Returns the created test widget. Returns 0 if this factory does not support wrapping <i>object</i>.</p> +<p>The returned object is suitable for use with <a href="qtuitest.html">qtuitest_cast</a>.</p> +<p>This function will only be called for objects which inherit one of the classes returned by <a href="qtuitest-widgetfactory.html#keys">keys</a>().</p> +<h3 class="fn"><a name="find"></a>QObject * WidgetFactory::find ( <a href="qtuitest.html#WidgetType-enum">QtUiTest::WidgetType</a> <i>type</i> ) <tt> [virtual]</tt></h3> +<p>Returns a widget or test widget of <i>type</i>, or 0 if none can be found.</p> +<p>Reimplement this function to provide custom behaviour for QtUiTest::findWidget(). For example, if a custom soft menu widget is being used rather than the shipped ContextLabel class, this function must be reimplemented to return a pointer to the custom widget.</p> +<p>The base implementation always returns 0.</p> +<h3 class="fn"><a name="keys"></a>QStringList WidgetFactory::keys () const <tt> [pure virtual]</tt></h3> +<p>Returns the list of C++ class names this factory can generate test widgets for.</p> +<p>Note that returning a class from this function does not guarantee that the factory will always be able to generate a test widget for that class.</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> diff --git a/old/doc/html/qtuitest.dcf b/old/doc/html/qtuitest.dcf new file mode 100644 index 0000000..b7bfa4f --- /dev/null +++ b/old/doc/html/qtuitest.dcf @@ -0,0 +1,318 @@ +<!DOCTYPE DCF> +<DCF ref="index.html" icon="qtuitest.png" imagedir="../../gif" title="QtUiTest Reference Documentation"> +<section ref="classes.html" title="Classes"> + <section ref="qtuitest-activatewidget.html" title="ActivateWidget Class Reference"> + <keyword ref="qtuitest-activatewidget.html">ActivateWidget</keyword> + <keyword ref="qtuitest-activatewidget.html#activate">activate</keyword> + <keyword ref="qtuitest-activatewidget.html#activated">activated</keyword> + <section ref="qtuitest-activatewidget-members.html" title="List of all members"/> + </section> + <section ref="qtuitest-checkitemwidget.html" title="CheckItemWidget Class Reference"> + <keyword ref="qtuitest-checkitemwidget.html">CheckItemWidget</keyword> + <keyword ref="qtuitest-checkitemwidget.html#isCheckable">isCheckable</keyword> + <keyword ref="qtuitest-checkitemwidget.html#isChecked">isChecked</keyword> + <keyword ref="qtuitest-checkitemwidget.html#setChecked">setChecked</keyword> + <section ref="qtuitest-checkitemwidget-members.html" title="List of all members"/> + </section> + <section ref="qtuitest-checkwidget.html" title="CheckWidget Class Reference"> + <keyword ref="qtuitest-checkwidget.html">CheckWidget</keyword> + <keyword ref="qtuitest-checkwidget.html#checkState">checkState</keyword> + <keyword ref="qtuitest-checkwidget.html#isTristate">isTristate</keyword> + <keyword ref="qtuitest-checkwidget.html#setCheckState">setCheckState</keyword> + <keyword ref="qtuitest-checkwidget.html#stateChanged">stateChanged</keyword> + <section ref="qtuitest-checkwidget-members.html" title="List of all members"/> + </section> + <section ref="qtuitest-indexedwidget.html" title="IndexedWidget Class Reference"> + <keyword ref="qtuitest-indexedwidget.html">IndexedWidget</keyword> + <keyword ref="qtuitest-indexedwidget.html#selectIndex">selectIndex</keyword> + <section ref="qtuitest-indexedwidget-members.html" title="List of all members"/> + </section> + <section ref="qtuitest-inputwidget.html" title="InputWidget Class Reference"> + <keyword ref="qtuitest-inputwidget.html">InputWidget</keyword> + <keyword ref="qtuitest-inputwidget.html#canEnter">canEnter</keyword> + <keyword ref="qtuitest-inputwidget.html#enter">enter</keyword> + <keyword ref="qtuitest-inputwidget.html#entered">entered</keyword> + <section ref="qtuitest-inputwidget-members.html" title="List of all members"/> + </section> + <section ref="qtuitest-labelwidget.html" title="LabelWidget Class Reference"> + <keyword ref="qtuitest-labelwidget.html">LabelWidget</keyword> + <keyword ref="qtuitest-labelwidget.html#buddy">buddy</keyword> + <keyword ref="qtuitest-labelwidget.html#labelText">labelText</keyword> + <section ref="qtuitest-labelwidget-members.html" title="List of all members"/> + </section> + <section ref="qtuitest-listwidget.html" title="ListWidget Class Reference"> + <keyword ref="qtuitest-listwidget.html">ListWidget</keyword> + <keyword ref="qtuitest-listwidget.html#ensureVisible">ensureVisible</keyword> + <keyword ref="qtuitest-listwidget.html#list">list</keyword> + <keyword ref="qtuitest-listwidget.html#visualRect">visualRect</keyword> + <section ref="qtuitest-listwidget-members.html" title="List of all members"/> + </section> + <section ref="qsystemtest.html" title="QSystemTest Namespace Reference"> + <keyword ref="qsystemtest.html">QSystemTest</keyword> + <keyword ref="qsystemtest.html#Array-typedef">Array</keyword> + <keyword ref="qsystemtest.html#Boolean-typedef">Boolean</keyword> + <keyword ref="qsystemtest.html#EnterMode-enum">EnterMode</keyword> + <keyword ref="qsystemtest.html#EnterMode-enum">QSystemTest::Commit</keyword> + <keyword ref="qsystemtest.html#EnterMode-enum">QSystemTest::NoCommit</keyword> + <keyword ref="qsystemtest.html#Function-typedef">Function</keyword> + <keyword ref="qsystemtest.html#LabelOrientation-enum">LabelOrientation</keyword> + <keyword ref="qsystemtest.html#LabelOrientation-enum">QSystemTest::LabelLeft</keyword> + <keyword ref="qsystemtest.html#LabelOrientation-enum">QSystemTest::LabelRight</keyword> + <keyword ref="qsystemtest.html#LabelOrientation-enum">QSystemTest::LabelBelow</keyword> + <keyword ref="qsystemtest.html#LabelOrientation-enum">QSystemTest::LabelAbove</keyword> + <keyword ref="qsystemtest.html#Number-typedef">Number</keyword> + <keyword ref="qsystemtest.html#QVariantArray-typedef">QVariantArray</keyword> + <keyword ref="qsystemtest.html#Role-enum">Role</keyword> + <keyword ref="qsystemtest.html#SkipMode-enum">SkipMode</keyword> + <keyword ref="qsystemtest.html#SkipMode-enum">QSystemTest::SkipSingle</keyword> + <keyword ref="qsystemtest.html#SkipMode-enum">QSystemTest::SkipAll</keyword> + <keyword ref="qsystemtest.html#StartApplicationFlag-enum">StartApplicationFlag</keyword> + <keyword ref="qsystemtest.html#StartApplicationFlag-enum">StartApplicationFlags</keyword> + <keyword ref="qsystemtest.html#StartApplicationFlag-enum">QSystemTest::WaitForFocus</keyword> + <keyword ref="qsystemtest.html#StartApplicationFlag-enum">QSystemTest::BackgroundCurrentApplication</keyword> + <keyword ref="qsystemtest.html#StartApplicationFlag-enum">QSystemTest::NoFlag</keyword> + <keyword ref="qsystemtest.html#StateFlag-enum">StateFlag</keyword> + <keyword ref="qsystemtest.html#StateFlag-enum">State</keyword> + <keyword ref="qsystemtest.html#StringArray-typedef">StringArray</keyword> + <keyword ref="qsystemtest.html#Q_ENUMS">Q_ENUMS</keyword> + <keyword ref="qsystemtest.html#activate">activate</keyword> + <keyword ref="qsystemtest.html#addExpectedMessageBox">addExpectedMessageBox</keyword> + <keyword ref="qsystemtest.html#checkOS">checkOS</keyword> + <keyword ref="qsystemtest.html#checkState">checkState</keyword> + <keyword ref="qsystemtest.html#clearExpectedMessageBox">clearExpectedMessageBox</keyword> + <keyword ref="qsystemtest.html#clearExpectedMessageBoxes">clearExpectedMessageBoxes</keyword> + <keyword ref="qsystemtest.html#compare">compare</keyword> + <keyword ref="qsystemtest.html#compareImage">compareImage</keyword> + <keyword ref="qsystemtest.html#currentApplication">currentApplication</keyword> + <keyword ref="qsystemtest.html#currentTitle">currentTitle</keyword> + <keyword ref="qsystemtest.html#deletePath">deletePath</keyword> + <keyword ref="qsystemtest.html#enter">enter</keyword> + <keyword ref="qsystemtest.html#expectApplicationClose">expectApplicationClose</keyword> + <keyword ref="qsystemtest.html#expectFail">expectFail</keyword> + <keyword ref="qsystemtest.html#expectMessageBox">expectMessageBox</keyword> + <keyword ref="qsystemtest.html#fail">fail</keyword> + <keyword ref="qsystemtest.html#findByProperty">findByProperty</keyword> + <keyword ref="qsystemtest.html#focusWidget">focusWidget</keyword> + <keyword ref="qsystemtest.html#getClipboardText">getClipboardText</keyword> + <keyword ref="qsystemtest.html#getData">getData</keyword> + <keyword ref="qsystemtest.html#getDateTime">getDateTime</keyword> + <keyword ref="qsystemtest.html#getDirectoryEntries">getDirectoryEntries</keyword> + <keyword ref="qsystemtest.html#getFile">getFile</keyword> + <keyword ref="qsystemtest.html#getGeometry">getGeometry</keyword> + <keyword ref="qsystemtest.html#getLabels">getLabels</keyword> + <keyword ref="qsystemtest.html#getList">getList</keyword> + <keyword ref="qsystemtest.html#getLocale">getLocale</keyword> + <keyword ref="qsystemtest.html#getProperty">getProperty</keyword> + <keyword ref="qsystemtest.html#getSelectedText">getSelectedText</keyword> + <keyword ref="qsystemtest.html#getSelectedValue">getSelectedValue</keyword> + <keyword ref="qsystemtest.html#getSetting">getSetting</keyword> + <keyword ref="qsystemtest.html#getText">getText</keyword> + <keyword ref="qsystemtest.html#getValue">getValue</keyword> + <keyword ref="qsystemtest.html#getenv">getenv</keyword> + <keyword ref="qsystemtest.html#ignoreMessageBoxes">ignoreMessageBoxes</keyword> + <keyword ref="qsystemtest.html#invokeMethod">invokeMethod</keyword> + <keyword ref="qsystemtest.html#isChecked">isChecked</keyword> + <keyword ref="qsystemtest.html#isEnabled">isEnabled</keyword> + <keyword ref="qsystemtest.html#isVisible">isVisible</keyword> + <keyword ref="qsystemtest.html#keyClick">keyClick</keyword> + <keyword ref="qsystemtest.html#keyClickHold">keyClickHold</keyword> + <keyword ref="qsystemtest.html#keyPress">keyPress</keyword> + <keyword ref="qsystemtest.html#keyRelease">keyRelease</keyword> + <keyword ref="qsystemtest.html#labelOrientation">labelOrientation</keyword> + <keyword ref="qsystemtest.html#mouseClick">mouseClick</keyword> + <keyword ref="qsystemtest.html#mouseClickHold">mouseClickHold</keyword> + <keyword ref="qsystemtest.html#mousePreferred">mousePreferred</keyword> + <keyword ref="qsystemtest.html#mousePress">mousePress</keyword> + <keyword ref="qsystemtest.html#mouseRelease">mouseRelease</keyword> + <keyword ref="qsystemtest.html#prompt">prompt</keyword> + <keyword ref="qsystemtest.html#putData">putData</keyword> + <keyword ref="qsystemtest.html#putFile">putFile</keyword> + <keyword ref="qsystemtest.html#readLocalFile">readLocalFile</keyword> + <keyword ref="qsystemtest.html#runProcess">runProcess</keyword> + <keyword ref="qsystemtest.html#runsOnDevice">runsOnDevice</keyword> + <keyword ref="qsystemtest.html#saveScreen">saveScreen</keyword> + <keyword ref="qsystemtest.html#select">select</keyword> + <keyword ref="qsystemtest.html#selectIndex">selectIndex</keyword> + <keyword ref="qsystemtest.html#setCheckState">setCheckState</keyword> + <keyword ref="qsystemtest.html#setChecked">setChecked</keyword> + <keyword ref="qsystemtest.html#setClipboardText">setClipboardText</keyword> + <keyword ref="qsystemtest.html#setLabelOrientation">setLabelOrientation</keyword> + <keyword ref="qsystemtest.html#setMousePreferred">setMousePreferred</keyword> + <keyword ref="qsystemtest.html#setProperty">setProperty</keyword> + <keyword ref="qsystemtest.html#setSetting">setSetting</keyword> + <keyword ref="qsystemtest.html#setVisibleResponseTime">setVisibleResponseTime</keyword> + <keyword ref="qsystemtest.html#signature">signature</keyword> + <keyword ref="qsystemtest.html#skip">skip</keyword> + <keyword ref="qsystemtest.html#startApplication">startApplication</keyword> + <keyword ref="qsystemtest.html#strict">strict</keyword> + <keyword ref="qsystemtest.html#tabBar">tabBar</keyword> + <keyword ref="qsystemtest.html#translate">translate</keyword> + <keyword ref="qsystemtest.html#userName">userName</keyword> + <keyword ref="qsystemtest.html#verify">verify</keyword> + <keyword ref="qsystemtest.html#verifyImage">verifyImage</keyword> + <keyword ref="qsystemtest.html#visibleResponseTime">visibleResponseTime</keyword> + <keyword ref="qsystemtest.html#wait">wait</keyword> + <keyword ref="qsystemtest.html#waitExpectedMessageBox">waitExpectedMessageBox</keyword> + <keyword ref="qsystemtest.html#waitFor">waitFor</keyword> + <keyword ref="qsystemtest.html#waitForTitle">waitForTitle</keyword> + </section> + <section ref="qtuitest.html" title="QtUiTest Namespace Reference"> + <keyword ref="qtuitest.html">QtUiTest</keyword> + <keyword ref="qtuitest-activatewidget.html">ActivateWidget</keyword> + <keyword ref="qtuitest-checkitemwidget.html">CheckItemWidget</keyword> + <keyword ref="qtuitest-checkwidget.html">CheckWidget</keyword> + <keyword ref="qtuitest-indexedwidget.html">IndexedWidget</keyword> + <keyword ref="qtuitest-inputwidget.html">InputWidget</keyword> + <keyword ref="qtuitest-labelwidget.html">LabelWidget</keyword> + <keyword ref="qtuitest-listwidget.html">ListWidget</keyword> + <keyword ref="qtuitest-selectwidget.html">SelectWidget</keyword> + <keyword ref="qtuitest-testwidget.html">TestWidget</keyword> + <keyword ref="qtuitest-textwidget.html">TextWidget</keyword> + <keyword ref="qtuitest-widget.html">Widget</keyword> + <keyword ref="qtuitest-widgetfactory.html">WidgetFactory</keyword> + <keyword ref="qtuitest.html#InputOption-enum">InputOption</keyword> + <keyword ref="qtuitest.html#InputOption-enum">QtUiTest::KeyRepeat</keyword> + <keyword ref="qtuitest.html#InputOption-enum">QtUiTest::NoOptions</keyword> + <keyword ref="qtuitest.html#InputOption-enum">QtUiTest::DemoMode</keyword> + <keyword ref="qtuitest.html#Key-enum">Key</keyword> + <keyword ref="qtuitest.html#Key-enum">QtUiTest::Key_ActivateButton</keyword> + <keyword ref="qtuitest.html#Key-enum">QtUiTest::Key_Activate</keyword> + <keyword ref="qtuitest.html#Key-enum">QtUiTest::Key_Select</keyword> + <keyword ref="qtuitest.html#LabelOrientation-enum">LabelOrientation</keyword> + <keyword ref="qtuitest.html#WidgetType-enum">WidgetType</keyword> + <keyword ref="qtuitest.html#WidgetType-enum">QtUiTest::InputMethod</keyword> + <keyword ref="qtuitest.html#WidgetType-enum">QtUiTest::Focus</keyword> + <keyword ref="qtuitest.html#WidgetType-enum">QtUiTest::SoftMenu</keyword> + <keyword ref="qtuitest.html#WidgetType-enum">QtUiTest::OptionsMenu</keyword> + <keyword ref="qtuitest.html#WidgetType-enum">QtUiTest::HomeScreen</keyword> + <keyword ref="qtuitest.html#WidgetType-enum">QtUiTest::Launcher</keyword> + <keyword ref="qtuitest.html#WidgetType-enum">QtUiTest::TabBar</keyword> + <keyword ref="qtuitest.html#qtuitest_cast">qtuitest_cast</keyword> + </section> + <section ref="qtuitestrecorder.html" title="QtUiTestRecorder Class Reference"> + <keyword ref="qtuitestrecorder.html">QtUiTestRecorder</keyword> + <keyword ref="qtuitestrecorder.html#activated">activated</keyword> + <keyword ref="qtuitestrecorder.html#entered">entered</keyword> + <keyword ref="qtuitestrecorder.html#gotFocus">gotFocus</keyword> + <keyword ref="qtuitestrecorder.html#keyEvent">keyEvent</keyword> + <keyword ref="qtuitestrecorder.html#mouseEvent">mouseEvent</keyword> + <keyword ref="qtuitestrecorder.html#selected">selected</keyword> + <keyword ref="qtuitestrecorder.html#stateChanged">stateChanged</keyword> + <section ref="qtuitestrecorder-members.html" title="List of all members"/> + </section> + <section ref="qtuitest-selectwidget.html" title="SelectWidget Class Reference"> + <keyword ref="qtuitest-selectwidget.html">SelectWidget</keyword> + <keyword ref="qtuitest-selectwidget.html#canSelect">canSelect</keyword> + <keyword ref="qtuitest-selectwidget.html#canSelectMulti">canSelectMulti</keyword> + <keyword ref="qtuitest-selectwidget.html#isMultiSelection">isMultiSelection</keyword> + <keyword ref="qtuitest-selectwidget.html#select">select</keyword> + <keyword ref="qtuitest-selectwidget.html#selectMulti">selectMulti</keyword> + <keyword ref="qtuitest-selectwidget.html#selected">selected</keyword> + <section ref="qtuitest-selectwidget-members.html" title="List of all members"/> + </section> + <section ref="qtuitest-testwidget.html" title="TestWidget Class Reference"> + <keyword ref="qtuitest-testwidget.html">TestWidget</keyword> + <keyword ref="qtuitest-testwidget.html#canEnter">canEnter</keyword> + <keyword ref="qtuitest-testwidget.html#canWrap">canWrap</keyword> + <keyword ref="qtuitest-testwidget.html#children">children</keyword> + <keyword ref="qtuitest-testwidget.html#ensureVisibleRegion">ensureVisibleRegion</keyword> + <keyword ref="qtuitest-testwidget.html#enter">enter</keyword> + <keyword ref="qtuitest-testwidget.html#eventFilter">eventFilter</keyword> + <keyword ref="qtuitest-testwidget.html#focusOutEvent">focusOutEvent</keyword> + <keyword ref="qtuitest-testwidget.html#focusPolicy">focusPolicy</keyword> + <keyword ref="qtuitest-testwidget.html#focusProxy">focusProxy</keyword> + <keyword ref="qtuitest-testwidget.html#geometry">geometry</keyword> + <keyword ref="qtuitest-testwidget.html#gotFocus">gotFocus</keyword> + <keyword ref="qtuitest-testwidget.html#grabPixmap">grabPixmap</keyword> + <keyword ref="qtuitest-testwidget.html#hasFocus">hasFocus</keyword> + <keyword ref="qtuitest-testwidget.html#isVisible">isVisible</keyword> + <keyword ref="qtuitest-testwidget.html#labelText">labelText</keyword> + <keyword ref="qtuitest-testwidget.html#mapFromGlobal">mapFromGlobal</keyword> + <keyword ref="qtuitest-testwidget.html#mapToGlobal">mapToGlobal</keyword> + <keyword ref="qtuitest-testwidget.html#parent">parent</keyword> + <keyword ref="qtuitest-testwidget.html#printable">printable</keyword> + <keyword ref="qtuitest-testwidget.html#rect">rect</keyword> + <keyword ref="qtuitest-testwidget.html#setEditFocus">setEditFocus</keyword> + <keyword ref="qtuitest-testwidget.html#visibleRegion">visibleRegion</keyword> + <keyword ref="qtuitest-testwidget.html#windowFlags">windowFlags</keyword> + <keyword ref="qtuitest-testwidget.html#windowTitle">windowTitle</keyword> + <section ref="qtuitest-testwidget-members.html" title="List of all members"/> + </section> + <section ref="qtuitest-textwidget.html" title="TextWidget Class Reference"> + <keyword ref="qtuitest-textwidget.html">TextWidget</keyword> + <keyword ref="qtuitest-textwidget.html#selectedText">selectedText</keyword> + <keyword ref="qtuitest-textwidget.html#selectedValue">selectedValue</keyword> + <keyword ref="qtuitest-textwidget.html#text">text</keyword> + <keyword ref="qtuitest-textwidget.html#value">value</keyword> + <section ref="qtuitest-textwidget-members.html" title="List of all members"/> + </section> + <section ref="qtuitest-widget.html" title="Widget Class Reference"> + <keyword ref="qtuitest-widget.html">Widget</keyword> + <keyword ref="qtuitest-widget.html#center">center</keyword> + <keyword ref="qtuitest-widget.html#children">children</keyword> + <keyword ref="qtuitest-widget.html#childrenVisibleRegion">childrenVisibleRegion</keyword> + <keyword ref="qtuitest-widget.html#ensureVisiblePoint">ensureVisiblePoint</keyword> + <keyword ref="qtuitest-widget.html#ensureVisibleRegion">ensureVisibleRegion</keyword> + <keyword ref="qtuitest-widget.html#focusOutEvent">focusOutEvent</keyword> + <keyword ref="qtuitest-widget.html#focusPolicy">focusPolicy</keyword> + <keyword ref="qtuitest-widget.html#focusProxy">focusProxy</keyword> + <keyword ref="qtuitest-widget.html#geometry">geometry</keyword> + <keyword ref="qtuitest-widget.html#gotFocus">gotFocus</keyword> + <keyword ref="qtuitest-widget.html#grabPixmap">grabPixmap</keyword> + <keyword ref="qtuitest-widget.html#hasEditFocus">hasEditFocus</keyword> + <keyword ref="qtuitest-widget.html#hasFocus">hasFocus</keyword> + <keyword ref="qtuitest-widget.html#height">height</keyword> + <keyword ref="qtuitest-widget.html#ignoreBuddy">ignoreBuddy</keyword> + <keyword ref="qtuitest-widget.html#ignoreScan">ignoreScan</keyword> + <keyword ref="qtuitest-widget.html#inherits">inherits</keyword> + <keyword ref="qtuitest-widget.html#isVisible">isVisible</keyword> + <keyword ref="qtuitest-widget.html#mapFromGlobal">mapFromGlobal</keyword> + <keyword ref="qtuitest-widget.html#mapToGlobal">mapToGlobal</keyword> + <keyword ref="qtuitest-widget.html#parent">parent</keyword> + <keyword ref="qtuitest-widget.html#rect">rect</keyword> + <keyword ref="qtuitest-widget.html#setEditFocus">setEditFocus</keyword> + <keyword ref="qtuitest-widget.html#setFocus">setFocus</keyword> + <keyword ref="qtuitest-widget.html#visibleRegion">visibleRegion</keyword> + <keyword ref="qtuitest-widget.html#width">width</keyword> + <keyword ref="qtuitest-widget.html#windowFlags">windowFlags</keyword> + <keyword ref="qtuitest-widget.html#windowTitle">windowTitle</keyword> + <keyword ref="qtuitest-widget.html#x">x</keyword> + <keyword ref="qtuitest-widget.html#y">y</keyword> + <section ref="qtuitest-widget-members.html" title="List of all members"/> + </section> + <section ref="qtuitest-widgetfactory.html" title="WidgetFactory Class Reference"> + <keyword ref="qtuitest-widgetfactory.html">WidgetFactory</keyword> + <keyword ref="qtuitest-widgetfactory.html#create">create</keyword> + <keyword ref="qtuitest-widgetfactory.html#find">find</keyword> + <keyword ref="qtuitest-widgetfactory.html#keys">keys</keyword> + <section ref="qtuitest-widgetfactory-members.html" title="List of all members"/> + </section> +</section> +<section ref="overviews.html" title="Overviews"> + <section ref="qtuitest-tutorial1.html" title="Chapter 1: Writing a System Test"> + <keyword ref="qtuitest-tutorial1.html">Chapter 1: Writing a System Test</keyword> + </section> + <section ref="qtuitest-tutorial2.html" title="Chapter 2: Input, Output and Widget Navigation"> + <keyword ref="qtuitest-tutorial2.html">Chapter 2: Input, Output and Widget Navigation</keyword> + </section> + <section ref="qtuitest-tutorial3.html" title="Chapter 3: Data driven testing"> + <keyword ref="qtuitest-tutorial3.html">Chapter 3: Data driven testing</keyword> + </section> + <section ref="qtuitest-tutorial4.html" title="Chapter 4: Putting It All Together"> + <keyword ref="qtuitest-tutorial4.html">Chapter 4: Putting It All Together</keyword> + </section> + <section ref="qtuitest-plugins.html" title="Creating a QtUiTest Test Widget"> + <keyword ref="qtuitest-plugins.html">Creating a QtUiTest Test Widget</keyword> + </section> + <section ref="index.html" title="Qt Reference Documentation"> + <keyword ref="index.html">Qt Reference Documentation</keyword> + </section> + <section ref="qtuitest-manual.html" title="QtUiTest Manual"> + <keyword ref="qtuitest-manual.html">QtUiTest Manual</keyword> + </section> + <section ref="qtuitest-tutorial.html" title="QtUiTest Tutorial"> + <keyword ref="qtuitest-tutorial.html">QtUiTest Tutorial</keyword> + </section> +</section> +<section ref="examples.html" title="Tutorial & Examples"/> +</DCF> diff --git a/old/doc/html/qtuitest.html b/old/doc/html/qtuitest.html new file mode 100644 index 0000000..39acc1e --- /dev/null +++ b/old/doc/html/qtuitest.html @@ -0,0 +1,128 @@ +<?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"> +<!-- ../../lib/qtuitestnamespace.cpp --> +<head> + <title>QtUiTest 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">QtUiTest Namespace Reference<br /><span class="small-subtitle">[QtUiTestModule]</span> +</h1> +<p>The QtUiTest namespace provides the plugin interfaces used for customizing the behaviour of QtUiTest. <a href="#details">More...</a></p> +<pre> #include <QtUiTest></pre><p><b>This namespace is under development and is subject to change.</b></p> +<ul> +</ul> +<hr /> +<a name="classes"></a> +<h2>Classes</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-activatewidget.html">ActivateWidget</a></b> <tt> (preliminary)</tt></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-checkitemwidget.html">CheckItemWidget</a></b> <tt> (preliminary)</tt></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-checkwidget.html">CheckWidget</a></b> <tt> (preliminary)</tt></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-indexedwidget.html">IndexedWidget</a></b> <tt> (preliminary)</tt></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-inputwidget.html">InputWidget</a></b> <tt> (preliminary)</tt></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-labelwidget.html">LabelWidget</a></b> <tt> (preliminary)</tt></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-listwidget.html">ListWidget</a></b> <tt> (preliminary)</tt></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-selectwidget.html">SelectWidget</a></b> <tt> (preliminary)</tt></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-testwidget.html">TestWidget</a></b></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-textwidget.html">TextWidget</a></b> <tt> (preliminary)</tt></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widget.html">Widget</a></b> <tt> (preliminary)</tt></td></tr> +<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widgetfactory.html">WidgetFactory</a></b> <tt> (preliminary)</tt></td></tr> +</table> +<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">enum </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest.html#InputOption-enum">InputOption</a></b> { NoOptions, DemoMode, KeyRepeat }</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest.html#Key-enum">Key</a></b> { Key_Activate, Key_ActivateButton, Key_Select }</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest.html#LabelOrientation-enum">LabelOrientation</a></b> { LabelLeft, LabelRight, LabelAbove, LabelBelow }</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest.html#WidgetType-enum">WidgetType</a></b> { Focus, InputMethod, SoftMenu, OptionsMenu, ..., Launcher }</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">T </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest.html#qtuitest_cast">qtuitest_cast</a></b> ( const QObject * <i>object</i> )</td></tr> +</table> +<a name="details"></a> +<hr /> +<h2>Detailed Description</h2> +<p>The QtUiTest namespace provides the plugin interfaces used for customizing the behaviour of QtUiTest.</p> +<p>When running a <a href="qsystemtest.html">Qt Extended system test</a>, functions such as <a href="qsystemtest.html#select">select()</a> and <a href="qsystemtest.html#getText">getText()</a> are used to perform actions and retrieve information from widgets. This is implemented by wrapping each conceptual widget (which is not necessarily a QWidget) with a test widget class.</p> +<p>These test widgets each implement one or more of the widget interfaces in the QtUiTest namespace. The interfaces are used to determine what actions can be taken on a particular widget, and how to perform them.</p> +<p>For example, when the following system test code executes:</p> +<pre> select("Dog", "Favorite Animal");</pre> +<p>QtUiTest will first look up the QWidget which is labelled by the text "Favorite Animal". It will then use qtuitest_cast to cast this widget to a <a href="qtuitest-selectwidget.html">QtUiTest::SelectWidget</a>. If this is successful, it will then call <a href="qtuitest-selectwidget.html#select">select</a>("Dog") on the list widget.</p> +<p>It is possible to customize the behavior of QtUiTest for particular widgets by creating custom test widget classes and a <a href="qtuitest-widgetfactory.html">QtUiTest::WidgetFactory</a> factory class to wrap QObject instances in test widgets.</p> +<hr /> +<h2>Classes</h2> +<h3> class <a href="qtuitest-activatewidget.html">ActivateWidget</a></h3><p>The ActivateWidget class provides an abstract base class for all test widgets which can conceptually be "activated" by a user. <a href="qtuitest-activatewidget.html#details">More...</a></p> +<h3> class <a href="qtuitest-checkitemwidget.html">CheckItemWidget</a></h3><p>The CheckItemWidget class provides an abstract base class for all test widgets which include items that support 'checked' and 'unchecked' states. <a href="qtuitest-checkitemwidget.html#details">More...</a></p> +<h3> class <a href="qtuitest-checkwidget.html">CheckWidget</a></h3><p>The CheckWidget class provides an abstract base class for all test widgets which support 'checked' and 'unchecked' states. <a href="qtuitest-checkwidget.html#details">More...</a></p> +<h3> class <a href="qtuitest-indexedwidget.html">IndexedWidget</a></h3><p>The IndexedWidget class provides an abstract base class for all test widgets which allow the user to select items based on index. <a href="qtuitest-indexedwidget.html#details">More...</a></p> +<h3> class <a href="qtuitest-inputwidget.html">InputWidget</a></h3><p>The InputWidget class provides an abstract base class for all test widgets which allow the user to input text. <a href="qtuitest-inputwidget.html#details">More...</a></p> +<h3> class <a href="qtuitest-labelwidget.html">LabelWidget</a></h3><p>The LabelWidget class provides an abstract base class for all test widgets which are conceptually labels. <a href="qtuitest-labelwidget.html#details">More...</a></p> +<h3> class <a href="qtuitest-listwidget.html">ListWidget</a></h3><p>The ListWidget class provides an abstract base class for all test widgets which display a list of items to the user. <a href="qtuitest-listwidget.html#details">More...</a></p> +<h3> class <a href="qtuitest-selectwidget.html">SelectWidget</a></h3><p>The SelectWidget class provides an abstract base class for all test widgets which allow the user to select from a range of items. <a href="qtuitest-selectwidget.html#details">More...</a></p> +<h3> class <a href="qtuitest-testwidget.html">TestWidget</a></h3><h3> class <a href="qtuitest-textwidget.html">TextWidget</a></h3><p>The TextWidget class provides an abstract base class for all test widgets which display text to the user. <a href="qtuitest-textwidget.html#details">More...</a></p> +<h3> class <a href="qtuitest-widget.html">Widget</a></h3><p>The Widget class provides an abstract base class for all test widgets. <a href="qtuitest-widget.html#details">More...</a></p> +<h3> class <a href="qtuitest-widgetfactory.html">WidgetFactory</a></h3><p>The WidgetFactory class provides a factory interface for <a href="qtuitest.html">QtUiTest</a> widget wrapper classes. <a href="qtuitest-widgetfactory.html#details">More...</a></p> +<hr /> +<h2>Type Documentation</h2> +<h3 class="fn"><a name="InputOption-enum"></a>enum QtUiTest::InputOption</h3> +<p>This enum type specifies the options to be used when simulating key and mouse events.</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>QtUiTest::NoOptions</tt></td><td align="center" valign="top"><tt>0x0</tt></td><td valign="top">no options.</td></tr> +<tr><td valign="top"><tt>QtUiTest::DemoMode</tt></td><td align="center" valign="top"><tt>0x1</tt></td><td valign="top">when simulating, force artificial delays between key and mouse events, and animate some events.</td></tr> +<tr><td valign="top"><tt>QtUiTest::KeyRepeat</tt></td><td align="center" valign="top"><tt>0x2</tt></td><td valign="top">when simulating key press events, simulate auto-repeat key press events. The default is to simulate regular key press events.</td></tr> +</table></p> +<h3 class="fn"><a name="Key-enum"></a>enum QtUiTest::Key</h3> +<p>This enum provides mappings for high-level conceptual keys to platform-specific values of Qt::Key.</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>QtUiTest::Key_Activate</tt></td><td align="center" valign="top"><tt>Qt::Key_Enter</tt></td><td valign="top">Key used to activate generic UI elements.</td></tr> +<tr><td valign="top"><tt>QtUiTest::Key_ActivateButton</tt></td><td align="center" valign="top"><tt>Qt::Key_Space</tt></td><td valign="top">Key used to activate buttons.</td></tr> +<tr><td valign="top"><tt>QtUiTest::Key_Select</tt></td><td align="center" valign="top"><tt>Qt::Key_Space</tt></td><td valign="top">Key used to select an item from lists.</td></tr> +</table></p> +<h3 class="fn"><a name="LabelOrientation-enum"></a>enum QtUiTest::LabelOrientation</h3> +<h3 class="fn"><a name="WidgetType-enum"></a>enum QtUiTest::WidgetType</h3> +<p>This enum type specifies different types of widgets which can be retrieved via QtUiTest::findWidget().</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>QtUiTest::Focus</tt></td><td align="center" valign="top"><tt>6</tt></td><td valign="top">The widget which currently has keyboard focus. Note that this need not be located in the current application.</td></tr> +<tr><td valign="top"><tt>QtUiTest::InputMethod</tt></td><td align="center" valign="top"><tt>0</tt></td><td valign="top">A currently active input method widget.</td></tr> +<tr><td valign="top"><tt>QtUiTest::SoftMenu</tt></td><td align="center" valign="top"><tt>1</tt></td><td valign="top">A currently displayed soft menu bar.</td></tr> +<tr><td valign="top"><tt>QtUiTest::OptionsMenu</tt></td><td align="center" valign="top"><tt>2</tt></td><td valign="top">The context/options menu which is currently shown, or would be shown if the user attempted to raise a context menu (typically by pressing Qt::Key_Context1).</td></tr> +<tr><td valign="top"><tt>QtUiTest::TabBar</tt></td><td align="center" valign="top"><tt>3</tt></td><td valign="top">The tab bar for the currently active tab widget, if one exists. <a href="qtuitest.html">QtUiTest</a> is not designed to handle multiple nested tab widgets.</td></tr> +<tr><td valign="top"><tt>QtUiTest::HomeScreen</tt></td><td align="center" valign="top"><tt>5</tt></td><td valign="top">The home screen widget.</td></tr> +<tr><td valign="top"><tt>QtUiTest::Launcher</tt></td><td align="center" valign="top"><tt>4</tt></td><td valign="top">The widget (typically a grid-like menu) in the server process used for launching applications.</td></tr> +</table></p> +<hr /> +<h2>Function Documentation</h2> +<h3 class="fn"><a name="qtuitest_cast"></a>T qtuitest_cast ( const QObject * <i>object</i> )</h3> +<p>Casts <i>object</i> to the specified Qt Extended test widget interface <tt>T</tt>.</p> +<p>If <i>object</i> already implements <tt>T</tt>, it is simply casted and returned. Otherwise, <a href="qtuitest.html">QtUiTest</a> will attempt to find or create a test widget to wrap <i>object</i>, using all loaded <a href="qtuitest-widgetfactory.html">QtUiTest::WidgetFactory</a> plugins. If a test widget cannot be created to wrap <i>object</i>, 0 is returned.</p> +<p>In either case, the returned value must not be deleted by the caller.</p> +<p>Example:</p> +<pre><span class="comment"> // Attempt to select the item "Foo" from the given widget</span> + bool selectFoo(QWidget *widget) { + QtUiTest::SelectWidget* sw + = qtuitest_cast<QtUiTest::SelectWidget*>(widget); + if (!sw || !sw->canSelect("Foo")) { + return false; + } + return sw->select("Foo"); + }</pre> +<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> diff --git a/old/doc/html/qtuitest.index b/old/doc/html/qtuitest.index new file mode 100644 index 0000000..fbbfb69 --- /dev/null +++ b/old/doc/html/qtuitest.index @@ -0,0 +1,801 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE QDOCINDEX> +<INDEX url="http://doc.trolltech.com/" title="QtUiTest Reference Documentation" version=""> + <namespace access="public" threadsafety="unspecified" status="commendable" name="" href="" location="" module=""> + <typedef access="public" threadsafety="unspecified" status="commendable" name="QAlternateStackEntryPoint" href="qalternatestack.html#QAlternateStackEntryPoint-typedef" location="qalternatestack_p.h"/> + <namespace access="public" threadsafety="unspecified" status="preliminary" name="QtUiTest" href="qtuitest.html" location="qtuitestwidgetinterface.h" module=""> + <class access="public" threadsafety="unspecified" status="preliminary" name="WidgetFactory" fullname="QtUiTest::WidgetFactory" href="qtuitest-widgetfactory.html" location="qtuitestwidgetinterface.h" bases="" module=""> + <function access="public" threadsafety="unspecified" status="commendable" name="create" fullname="QtUiTest::WidgetFactory::create" href="qtuitest-widgetfactory.html#create" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="false" static="false" overload="false" type="QObject *" signature="create(QObject * object)"> + <parameter left="QObject *" right="" name="object" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="find" fullname="QtUiTest::WidgetFactory::find" href="qtuitest-widgetfactory.html#find" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="false" static="false" overload="false" type="QObject *" signature="find(QtUiTest::WidgetType type)"> + <parameter left="QtUiTest::WidgetType" right="" name="type" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="keys" fullname="QtUiTest::WidgetFactory::keys" href="qtuitest-widgetfactory.html#keys" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="QStringList" signature="keys() const"/> + </class> + <class access="public" threadsafety="unspecified" status="preliminary" name="Widget" fullname="QtUiTest::Widget" href="qtuitest-widget.html" location="qtuitestwidgetinterface.h" bases="" module=""> + <function access="public" threadsafety="unspecified" status="commendable" name="geometry" fullname="QtUiTest::Widget::geometry" href="qtuitest-widget.html#geometry" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="const QRect &" signature="geometry() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="rect" fullname="QtUiTest::Widget::rect" href="qtuitest-widget.html#rect" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QRect" signature="rect() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="x" fullname="QtUiTest::Widget::x" href="qtuitest-widget.html#x" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="int" signature="x() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="y" fullname="QtUiTest::Widget::y" href="qtuitest-widget.html#y" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="int" signature="y() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="width" fullname="QtUiTest::Widget::width" href="qtuitest-widget.html#width" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="int" signature="width() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="height" fullname="QtUiTest::Widget::height" href="qtuitest-widget.html#height" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="int" signature="height() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="isVisible" fullname="QtUiTest::Widget::isVisible" href="qtuitest-widget.html#isVisible" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="bool" signature="isVisible() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="visibleRegion" fullname="QtUiTest::Widget::visibleRegion" href="qtuitest-widget.html#visibleRegion" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="QRegion" signature="visibleRegion() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="parent" fullname="QtUiTest::Widget::parent" href="qtuitest-widget.html#parent" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="QObject *" signature="parent() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="windowTitle" fullname="QtUiTest::Widget::windowTitle" href="qtuitest-widget.html#windowTitle" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QString" signature="windowTitle() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="children" fullname="QtUiTest::Widget::children" href="qtuitest-widget.html#children" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="const QObjectList &" signature="children() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="childrenVisibleRegion" fullname="QtUiTest::Widget::childrenVisibleRegion" href="qtuitest-widget.html#childrenVisibleRegion" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QRegion" signature="childrenVisibleRegion() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="mapToGlobal" fullname="QtUiTest::Widget::mapToGlobal" href="qtuitest-widget.html#mapToGlobal" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="QPoint" signature="mapToGlobal(const QPoint & pos) const"> + <parameter left="const QPoint &" right="" name="pos" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="mapFromGlobal" fullname="QtUiTest::Widget::mapFromGlobal" href="qtuitest-widget.html#mapFromGlobal" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="QPoint" signature="mapFromGlobal(const QPoint & pos) const"> + <parameter left="const QPoint &" right="" name="pos" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="center" fullname="QtUiTest::Widget::center" href="qtuitest-widget.html#center" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QPoint" signature="center() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="ensureVisibleRegion" fullname="QtUiTest::Widget::ensureVisibleRegion" href="qtuitest-widget.html#ensureVisibleRegion" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="false" static="false" overload="false" type="bool" signature="ensureVisibleRegion(const QRegion & region)"> + <parameter left="const QRegion &" right="" name="region" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="ensureVisiblePoint" fullname="QtUiTest::Widget::ensureVisiblePoint" href="qtuitest-widget.html#ensureVisiblePoint" location="qtuitestwidgetinterface.h" virtual="non" meta="plain" const="false" static="false" overload="false" type="bool" signature="ensureVisiblePoint(const QPoint & point)"> + <parameter left="const QPoint &" right="" name="point" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="setFocus" fullname="QtUiTest::Widget::setFocus" href="qtuitest-widget.html#setFocus" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="false" static="false" overload="false" type="bool" signature="setFocus()"/> + <function access="public" threadsafety="unspecified" status="commendable" name="focusOutEvent" fullname="QtUiTest::Widget::focusOutEvent" href="qtuitest-widget.html#focusOutEvent" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="false" static="false" overload="false" type="void" signature="focusOutEvent()"/> + <function access="public" threadsafety="unspecified" status="commendable" name="hasFocus" fullname="QtUiTest::Widget::hasFocus" href="qtuitest-widget.html#hasFocus" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="bool" signature="hasFocus() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="focusProxy" fullname="QtUiTest::Widget::focusProxy" href="qtuitest-widget.html#focusProxy" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QObject *" signature="focusProxy() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="focusPolicy" fullname="QtUiTest::Widget::focusPolicy" href="qtuitest-widget.html#focusPolicy" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="Qt::FocusPolicy" signature="focusPolicy() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="windowFlags" fullname="QtUiTest::Widget::windowFlags" href="qtuitest-widget.html#windowFlags" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="Qt::WindowFlags" signature="windowFlags() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="hasEditFocus" fullname="QtUiTest::Widget::hasEditFocus" href="qtuitest-widget.html#hasEditFocus" location="qtuitestwidgetinterface.cpp" virtual="impure" meta="plain" const="true" static="false" overload="false" type="bool" signature="hasEditFocus() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="setEditFocus" fullname="QtUiTest::Widget::setEditFocus" href="qtuitest-widget.html#setEditFocus" location="qtuitestwidgetinterface.cpp" virtual="impure" meta="plain" const="false" static="false" overload="false" type="bool" signature="setEditFocus(bool enable)"> + <parameter left="bool" right="" name="enable" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="inherits" fullname="QtUiTest::Widget::inherits" href="qtuitest-widget.html#inherits" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="bool" signature="inherits(QtUiTest::WidgetType type) const"> + <parameter left="QtUiTest::WidgetType" right="" name="type" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="grabPixmap" fullname="QtUiTest::Widget::grabPixmap" href="qtuitest-widget.html#grabPixmap" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="bool" signature="grabPixmap(QPixmap & pixmap) const"> + <parameter left="QPixmap &" right="" name="pixmap" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="ignoreScan" fullname="QtUiTest::Widget::ignoreScan" href="qtuitest-widget.html#ignoreScan" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="bool" signature="ignoreScan() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="ignoreBuddy" fullname="QtUiTest::Widget::ignoreBuddy" href="qtuitest-widget.html#ignoreBuddy" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="bool" signature="ignoreBuddy() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="gotFocus" fullname="QtUiTest::Widget::gotFocus" href="qtuitest-widget.html#gotFocus" location="qtuitestwidgetinterface.h" virtual="non" meta="signal" const="false" static="false" overload="false" type="void" signature="gotFocus()"/> + </class> + <class access="public" threadsafety="unspecified" status="preliminary" name="ActivateWidget" fullname="QtUiTest::ActivateWidget" href="qtuitest-activatewidget.html" location="qtuitestwidgetinterface.h" bases="" module=""> + <function access="public" threadsafety="unspecified" status="commendable" name="activate" fullname="QtUiTest::ActivateWidget::activate" href="qtuitest-activatewidget.html#activate" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="false" static="false" overload="false" type="bool" signature="activate()"/> + <function access="public" threadsafety="unspecified" status="commendable" name="activated" fullname="QtUiTest::ActivateWidget::activated" href="qtuitest-activatewidget.html#activated" location="qtuitestwidgetinterface.h" virtual="non" meta="signal" const="false" static="false" overload="false" type="void" signature="activated()"/> + </class> + <class access="public" threadsafety="unspecified" status="preliminary" name="LabelWidget" fullname="QtUiTest::LabelWidget" href="qtuitest-labelwidget.html" location="qtuitestwidgetinterface.h" bases="" module=""> + <function access="public" threadsafety="unspecified" status="commendable" name="labelText" fullname="QtUiTest::LabelWidget::labelText" href="qtuitest-labelwidget.html#labelText" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="QString" signature="labelText() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="buddy" fullname="QtUiTest::LabelWidget::buddy" href="qtuitest-labelwidget.html#buddy" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QObject *" signature="buddy() const"/> + </class> + <class access="public" threadsafety="unspecified" status="preliminary" name="CheckWidget" fullname="QtUiTest::CheckWidget" href="qtuitest-checkwidget.html" location="qtuitestwidgetinterface.h" bases="" module=""> + <function access="public" threadsafety="unspecified" status="commendable" name="isTristate" fullname="QtUiTest::CheckWidget::isTristate" href="qtuitest-checkwidget.html#isTristate" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="bool" signature="isTristate() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="checkState" fullname="QtUiTest::CheckWidget::checkState" href="qtuitest-checkwidget.html#checkState" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="Qt::CheckState" signature="checkState() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="setCheckState" fullname="QtUiTest::CheckWidget::setCheckState" href="qtuitest-checkwidget.html#setCheckState" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="false" static="false" overload="false" type="bool" signature="setCheckState(Qt::CheckState state)"> + <parameter left="Qt::CheckState" right="" name="state" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="stateChanged" fullname="QtUiTest::CheckWidget::stateChanged" href="qtuitest-checkwidget.html#stateChanged" location="qtuitestwidgetinterface.h" virtual="non" meta="signal" const="false" static="false" overload="false" type="void" signature="stateChanged(int state)"> + <parameter left="int" right="" name="state" default=""/> + </function> + </class> + <class access="public" threadsafety="unspecified" status="preliminary" name="TextWidget" fullname="QtUiTest::TextWidget" href="qtuitest-textwidget.html" location="qtuitestwidgetinterface.h" bases="" module=""> + <function access="public" threadsafety="unspecified" status="commendable" name="selectedText" fullname="QtUiTest::TextWidget::selectedText" href="qtuitest-textwidget.html#selectedText" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QString" signature="selectedText() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="selectedValue" fullname="QtUiTest::TextWidget::selectedValue" href="qtuitest-textwidget.html#selectedValue" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QVariant" signature="selectedValue() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="text" fullname="QtUiTest::TextWidget::text" href="qtuitest-textwidget.html#text" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="QString" signature="text() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="value" fullname="QtUiTest::TextWidget::value" href="qtuitest-textwidget.html#value" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QVariant" signature="value() const"/> + </class> + <class access="public" threadsafety="unspecified" status="preliminary" name="ListWidget" fullname="QtUiTest::ListWidget" href="qtuitest-listwidget.html" location="qtuitestwidgetinterface.h" bases="" module=""> + <function access="public" threadsafety="unspecified" status="commendable" name="list" fullname="QtUiTest::ListWidget::list" href="qtuitest-listwidget.html#list" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="QStringList" signature="list() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="visualRect" fullname="QtUiTest::ListWidget::visualRect" href="qtuitest-listwidget.html#visualRect" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="QRect" signature="visualRect(const QString & item) const"> + <parameter left="const QString &" right="" name="item" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="ensureVisible" fullname="QtUiTest::ListWidget::ensureVisible" href="qtuitest-listwidget.html#ensureVisible" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="false" static="false" overload="false" type="bool" signature="ensureVisible(const QString & item)"> + <parameter left="const QString &" right="" name="item" default=""/> + </function> + </class> + <class access="public" threadsafety="unspecified" status="preliminary" name="InputWidget" fullname="QtUiTest::InputWidget" href="qtuitest-inputwidget.html" location="qtuitestwidgetinterface.h" bases="" module=""> + <function access="public" threadsafety="unspecified" status="commendable" name="canEnter" fullname="QtUiTest::InputWidget::canEnter" href="qtuitest-inputwidget.html#canEnter" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="bool" signature="canEnter(const QVariant & item) const"> + <parameter left="const QVariant &" right="" name="item" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="enter" fullname="QtUiTest::InputWidget::enter" href="qtuitest-inputwidget.html#enter" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="false" static="false" overload="false" type="bool" signature="enter(const QVariant & item, bool noCommit)"> + <parameter left="const QVariant &" right="" name="item" default=""/> + <parameter left="bool" right="" name="noCommit" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="entered" fullname="QtUiTest::InputWidget::entered" href="qtuitest-inputwidget.html#entered" location="qtuitestwidgetinterface.h" virtual="non" meta="signal" const="false" static="false" overload="false" type="void" signature="entered(const QVariant & item)"> + <parameter left="const QVariant &" right="" name="item" default=""/> + </function> + </class> + <class access="public" threadsafety="unspecified" status="preliminary" name="SelectWidget" fullname="QtUiTest::SelectWidget" href="qtuitest-selectwidget.html" location="qtuitestwidgetinterface.h" bases="" module=""> + <function access="public" threadsafety="unspecified" status="commendable" name="isMultiSelection" fullname="QtUiTest::SelectWidget::isMultiSelection" href="qtuitest-selectwidget.html#isMultiSelection" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="bool" signature="isMultiSelection() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="canSelect" fullname="QtUiTest::SelectWidget::canSelect" href="qtuitest-selectwidget.html#canSelect" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="bool" signature="canSelect(const QString & item) const"> + <parameter left="const QString &" right="" name="item" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="canSelectMulti" fullname="QtUiTest::SelectWidget::canSelectMulti" href="qtuitest-selectwidget.html#canSelectMulti" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="bool" signature="canSelectMulti(const QStringList & items) const"> + <parameter left="const QStringList &" right="" name="items" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="select" fullname="QtUiTest::SelectWidget::select" href="qtuitest-selectwidget.html#select" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="false" static="false" overload="false" type="bool" signature="select(const QString & item)"> + <parameter left="const QString &" right="" name="item" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="selectMulti" fullname="QtUiTest::SelectWidget::selectMulti" href="qtuitest-selectwidget.html#selectMulti" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="false" static="false" overload="false" type="bool" signature="selectMulti(const QStringList & items)"> + <parameter left="const QStringList &" right="" name="items" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="selected" fullname="QtUiTest::SelectWidget::selected" href="qtuitest-selectwidget.html#selected" location="qtuitestwidgetinterface.h" virtual="non" meta="signal" const="false" static="false" overload="false" type="void" signature="selected(const QString & item)"> + <parameter left="const QString &" right="" name="item" default=""/> + </function> + </class> + <class access="public" threadsafety="unspecified" status="preliminary" name="CheckItemWidget" fullname="QtUiTest::CheckItemWidget" href="qtuitest-checkitemwidget.html" location="qtuitestwidgetinterface.h" bases="" module=""> + <function access="public" threadsafety="unspecified" status="commendable" name="isCheckable" fullname="QtUiTest::CheckItemWidget::isCheckable" href="qtuitest-checkitemwidget.html#isCheckable" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="false" static="false" overload="false" type="bool" signature="isCheckable(const QString & item)"> + <parameter left="const QString &" right="" name="item" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="isChecked" fullname="QtUiTest::CheckItemWidget::isChecked" href="qtuitest-checkitemwidget.html#isChecked" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="true" static="false" overload="false" type="bool" signature="isChecked(const QString & ) const"> + <parameter left="const QString &" right="" name="" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="setChecked" fullname="QtUiTest::CheckItemWidget::setChecked" href="qtuitest-checkitemwidget.html#setChecked" location="qtuitestwidgetinterface.h" virtual="pure" meta="plain" const="false" static="false" overload="false" type="bool" signature="setChecked(const QString & item, bool state)"> + <parameter left="const QString &" right="" name="item" default=""/> + <parameter left="bool" right="" name="state" default=""/> + </function> + </class> + <class access="public" threadsafety="unspecified" status="preliminary" name="IndexedWidget" fullname="QtUiTest::IndexedWidget" href="qtuitest-indexedwidget.html" location="qtuitestwidgetinterface.h" bases="" module=""> + <function access="public" threadsafety="unspecified" status="commendable" name="selectIndex" fullname="QtUiTest::IndexedWidget::selectIndex" href="qtuitest-indexedwidget.html#selectIndex" location="qtuitestwidgetinterface.h" virtual="impure" meta="plain" const="false" static="false" overload="false" type="bool" signature="selectIndex(const QVariantList & index)"> + <parameter left="const QVariantList &" right="" name="index" default=""/> + </function> + </class> + <class access="public" threadsafety="unspecified" status="commendable" name="TestWidget" fullname="QtUiTest::TestWidget" href="qtuitest-testwidget.html" location="testwidget.h" bases="Widget,InputWidget" module=""> + <function access="public" threadsafety="unspecified" status="commendable" name="TestWidget" fullname="QtUiTest::TestWidget::TestWidget" href="qtuitest-testwidget.html#TestWidget" location="testwidget.h" virtual="non" meta="constructor" const="false" static="false" overload="false" type="" signature="TestWidget(QObject * )"> + <parameter left="QObject *" right="" name="" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="geometry" fullname="QtUiTest::TestWidget::geometry" href="qtuitest-testwidget.html#geometry" location="testwidget.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="const QRect &" signature="geometry() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="rect" fullname="QtUiTest::TestWidget::rect" href="qtuitest-testwidget.html#rect" location="testwidget.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QRect" signature="rect() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="isVisible" fullname="QtUiTest::TestWidget::isVisible" href="qtuitest-testwidget.html#isVisible" location="testwidget.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="bool" signature="isVisible() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="visibleRegion" fullname="QtUiTest::TestWidget::visibleRegion" href="qtuitest-testwidget.html#visibleRegion" location="testwidget.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QRegion" signature="visibleRegion() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="children" fullname="QtUiTest::TestWidget::children" href="qtuitest-testwidget.html#children" location="testwidget.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="const QObjectList &" signature="children() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="parent" fullname="QtUiTest::TestWidget::parent" href="qtuitest-testwidget.html#parent" location="testwidget.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QObject *" signature="parent() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="windowTitle" fullname="QtUiTest::TestWidget::windowTitle" href="qtuitest-testwidget.html#windowTitle" location="testwidget.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QString" signature="windowTitle() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="mapToGlobal" fullname="QtUiTest::TestWidget::mapToGlobal" href="qtuitest-testwidget.html#mapToGlobal" location="testwidget.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QPoint" signature="mapToGlobal(QPoint const & ) const"> + <parameter left="QPoint const &" right="" name="" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="mapFromGlobal" fullname="QtUiTest::TestWidget::mapFromGlobal" href="qtuitest-testwidget.html#mapFromGlobal" location="testwidget.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QPoint" signature="mapFromGlobal(QPoint const & ) const"> + <parameter left="QPoint const &" right="" name="" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="hasFocus" fullname="QtUiTest::TestWidget::hasFocus" href="qtuitest-testwidget.html#hasFocus" location="testwidget.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="bool" signature="hasFocus() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="windowFlags" fullname="QtUiTest::TestWidget::windowFlags" href="qtuitest-testwidget.html#windowFlags" location="testwidget.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="Qt::WindowFlags" signature="windowFlags() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="ensureVisibleRegion" fullname="QtUiTest::TestWidget::ensureVisibleRegion" href="qtuitest-testwidget.html#ensureVisibleRegion" location="testwidget.h" virtual="impure" meta="plain" const="false" static="false" overload="false" type="bool" signature="ensureVisibleRegion(QRegion const & )"> + <parameter left="QRegion const &" right="" name="" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="canEnter" fullname="QtUiTest::TestWidget::canEnter" href="qtuitest-testwidget.html#canEnter" location="testwidget.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="bool" signature="canEnter(QVariant const & ) const"> + <parameter left="QVariant const &" right="" name="" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="enter" fullname="QtUiTest::TestWidget::enter" href="qtuitest-testwidget.html#enter" location="testwidget.h" virtual="impure" meta="plain" const="false" static="false" overload="false" type="bool" signature="enter(QVariant const & , bool )"> + <parameter left="QVariant const &" right="" name="" default=""/> + <parameter left="bool" right="" name="" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="focusOutEvent" fullname="QtUiTest::TestWidget::focusOutEvent" href="qtuitest-testwidget.html#focusOutEvent" location="testwidget.h" virtual="impure" meta="plain" const="false" static="false" overload="false" type="void" signature="focusOutEvent()"/> + <function access="public" threadsafety="unspecified" status="commendable" name="setEditFocus" fullname="QtUiTest::TestWidget::setEditFocus" href="qtuitest-testwidget.html#setEditFocus" location="testwidget.h" virtual="impure" meta="plain" const="false" static="false" overload="false" type="bool" signature="setEditFocus(bool )"> + <parameter left="bool" right="" name="" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="focusProxy" fullname="QtUiTest::TestWidget::focusProxy" href="qtuitest-testwidget.html#focusProxy" location="testwidget.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="QObject *" signature="focusProxy() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="focusPolicy" fullname="QtUiTest::TestWidget::focusPolicy" href="qtuitest-testwidget.html#focusPolicy" location="testwidget.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="Qt::FocusPolicy" signature="focusPolicy() const"/> + <function access="public" threadsafety="unspecified" status="commendable" name="grabPixmap" fullname="QtUiTest::TestWidget::grabPixmap" href="qtuitest-testwidget.html#grabPixmap" location="testwidget.h" virtual="impure" meta="plain" const="true" static="false" overload="false" type="bool" signature="grabPixmap(QPixmap & pixmap) const"> + <parameter left="QPixmap &" right="" name="pixmap" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="canWrap" fullname="QtUiTest::TestWidget::canWrap" href="qtuitest-testwidget.html#canWrap" location="testwidget.h" virtual="non" meta="plain" const="false" static="true" overload="false" type="bool" signature="canWrap(QObject * )"> + <parameter left="QObject *" right="" name="" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="printable" fullname="QtUiTest::TestWidget::printable" href="qtuitest-testwidget.html#printable" location="testwidget.h" virtual="non" meta="plain" const="false" static="true" overload="false" type="QString" signature="printable(QString const & )"> + <parameter left="QString const &" right="" name="" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="labelText" fullname="QtUiTest::TestWidget::labelText" href="qtuitest-testwidget.html#labelText" location="testwidget.h" virtual="non" meta="plain" const="false" static="true" overload="false" type="QString" signature="labelText(QString const & )"> + <parameter left="QString const &" right="" name="" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="gotFocus" fullname="QtUiTest::TestWidget::gotFocus" href="qtuitest-testwidget.html#gotFocus" location="testwidget.h" virtual="non" meta="signal" const="false" static="false" overload="false" type="void" signature="gotFocus()"/> + <function access="protected" threadsafety="unspecified" status="commendable" name="eventFilter" fullname="QtUiTest::TestWidget::eventFilter" href="qtuitest-testwidget.html#eventFilter" location="testwidget.h" virtual="non" meta="plain" const="false" static="false" overload="false" type="bool" signature="eventFilter(QObject * , QEvent * )"> + <parameter left="QObject *" right="" name="" default=""/> + <parameter left="QEvent *" right="" name="" default=""/> + </function> + </class> + <enum access="public" threadsafety="unspecified" status="commendable" name="InputOption" fullname="QtUiTest::InputOption" href="qtuitest.html#InputOption-enum" location="qtuitestnamespace.h"> + <value name="NoOptions" value="0x0"/> + <value name="DemoMode" value="0x1"/> + <value name="KeyRepeat" value="0x2"/> + </enum> + <enum access="public" threadsafety="unspecified" status="commendable" name="WidgetType" fullname="QtUiTest::WidgetType" href="qtuitest.html#WidgetType-enum" location="qtuitestnamespace.h"> + <value name="InputMethod" value="0"/> + <value name="SoftMenu" value="1"/> + <value name="OptionsMenu" value="2"/> + <value name="TabBar" value="3"/> + <value name="Launcher" value="4"/> + <value name="HomeScreen" value="5"/> + <value name="Focus" value="6"/> + <value name="CallManager" value="7"/> + <value name="MenuBar" value="8"/> + </enum> + <enum access="public" threadsafety="unspecified" status="commendable" name="Key" fullname="QtUiTest::Key" href="qtuitest.html#Key-enum" location="qtuitestnamespace.h"> + <value name="Key_Activate" value="Qt::Key_Enter"/> + <value name="Key_Select" value="Qt::Key_Space"/> + <value name="Key_ActivateButton" value="Qt::Key_Space"/> + </enum> + <enum access="public" threadsafety="unspecified" status="commendable" name="LabelOrientation" fullname="QtUiTest::LabelOrientation" href="qtuitest.html#LabelOrientation-enum" location="qtuitestnamespace.h"> + <value name="LabelLeft" value="0x01"/> + <value name="LabelRight" value="0x02"/> + <value name="LabelAbove" value="0x03"/> + <value name="LabelBelow" value="0x04"/> + </enum> + </namespace> + <namespace access="public" threadsafety="unspecified" status="preliminary" name="QSystemTest" href="qsystemtest.html" location="qsystemtest.h" module=""> + <function access="public" threadsafety="unspecified" status="commendable" name="Q_ENUMS" fullname="QSystemTest::Q_ENUMS" href="qsystemtest.html#Q_ENUMS" location="qsystemtest.h" virtual="non" meta="plain" const="false" static="false" overload="false" type="" signature="Q_ENUMS(SkipMode )"> + <parameter left="SkipMode" right="" name="" default=""/> + </function> + <enum access="public" threadsafety="unspecified" status="commendable" name="SkipMode" fullname="QSystemTest::SkipMode" href="qsystemtest.html#SkipMode-enum" location="qsystemtest.h"> + <value name="SkipSingle" value="0x01"/> + <value name="SkipAll" value="0x02"/> + </enum> + <enum access="public" threadsafety="unspecified" status="commendable" name="EnterMode" fullname="QSystemTest::EnterMode" href="qsystemtest.html#EnterMode-enum" location="qsystemtest.h"> + <value name="Commit" value="0x00"/> + <value name="NoCommit" value="0x01"/> + </enum> + <enum access="public" threadsafety="unspecified" status="commendable" name="LabelOrientation" fullname="QSystemTest::LabelOrientation" href="qsystemtest.html#LabelOrientation-enum" location="qsystemtest.h"> + <value name="LabelLeft" value="0x01"/> + <value name="LabelRight" value="0x02"/> + <value name="LabelAbove" value="0x03"/> + <value name="LabelBelow" value="0x04"/> + </enum> + <enum access="public" threadsafety="unspecified" status="commendable" name="StartApplicationFlag" fullname="QSystemTest::StartApplicationFlag" href="qsystemtest.html#StartApplicationFlag-enum" location="qsystemtest.h" typedef="QSystemTest::StartApplicationFlags"> + <value name="NoFlag" value="0x00"/> + <value name="WaitForFocus" value="0x01"/> + <value name="BackgroundCurrentApplication" value="0x02"/> + </enum> + <typedef access="public" threadsafety="unspecified" status="commendable" name="StartApplicationFlags" fullname="QSystemTest::StartApplicationFlags" href="qsystemtest.html#StartApplicationFlags-typedef" location="qsystemtest.h" enum="QSystemTest::StartApplicationFlag"/> + <enum access="public" threadsafety="unspecified" status="commendable" name="Role" fullname="QSystemTest::Role" href="qsystemtest.html#Role-enum" location="qsystemtest.h"> + <value name="NoRole" value="0x00000000"/> + <value name="TitleBar" value="0x00000001"/> + <value name="MenuBar" value="0x00000002"/> + <value name="ScrollBar" value="0x00000003"/> + <value name="Grip" value="0x00000004"/> + <value name="Sound" value="0x00000005"/> + <value name="Cursor" value="0x00000006"/> + <value name="Caret" value="0x00000007"/> + <value name="AlertMessage" value="0x00000008"/> + <value name="Window" value="0x00000009"/> + <value name="Client" value="0x0000000A"/> + <value name="PopupMenu" value="0x0000000B"/> + <value name="MenuItem" value="0x0000000C"/> + <value name="ToolTip" value="0x0000000D"/> + <value name="Application" value="0x0000000E"/> + <value name="Document" value="0x0000000F"/> + <value name="Pane" value="0x00000010"/> + <value name="Chart" value="0x00000011"/> + <value name="Dialog" value="0x00000012"/> + <value name="Border" value="0x00000013"/> + <value name="Grouping" value="0x00000014"/> + <value name="Separator" value="0x00000015"/> + <value name="ToolBar" value="0x00000016"/> + <value name="StatusBar" value="0x00000017"/> + <value name="Table" value="0x00000018"/> + <value name="ColumnHeader" value="0x00000019"/> + <value name="RowHeader" value="0x0000001A"/> + <value name="Column" value="0x0000001B"/> + <value name="Row" value="0x0000001C"/> + <value name="Cell" value="0x0000001D"/> + <value name="Link" value="0x0000001E"/> + <value name="HelpBalloon" value="0x0000001F"/> + <value name="Assistant" value="0x00000020"/> + <value name="List" value="0x00000021"/> + <value name="ListItem" value="0x00000022"/> + <value name="Tree" value="0x00000023"/> + <value name="TreeItem" value="0x00000024"/> + <value name="PageTab" value="0x00000025"/> + <value name="PropertyPage" value="0x00000026"/> + <value name="Indicator" value="0x00000027"/> + <value name="Graphic" value="0x00000028"/> + <value name="StaticText" value="0x00000029"/> + <value name="EditableText" value="0x0000002A"/> + <value name="PushButton" value="0x0000002B"/> + <value name="CheckBox" value="0x0000002C"/> + <value name="RadioButton" value="0x0000002D"/> + <value name="ComboBox" value="0x0000002E"/> + <value name="ProgressBar" value="0x00000030"/> + <value name="Dial" value="0x00000031"/> + <value name="HotkeyField" value="0x00000032"/> + <value name="Slider" value="0x00000033"/> + <value name="SpinBox" value="0x00000034"/> + <value name="Canvas" value="0x00000035"/> + <value name="Animation" value="0x00000036"/> + <value name="Equation" value="0x00000037"/> + <value name="ButtonDropDown" value="0x00000038"/> + <value name="ButtonMenu" value="0x00000039"/> + <value name="ButtonDropGrid" value="0x0000003A"/> + <value name="Whitespace" value="0x0000003B"/> + <value name="PageTabList" value="0x0000003C"/> + <value name="Clock" value="0x0000003D"/> + <value name="Splitter" value="0x0000003E"/> + <value name="LayeredPane" value="0x0000003F"/> + <value name="UserRole" value="0x0000ffff"/> + </enum> + <enum access="public" threadsafety="unspecified" status="commendable" name="StateFlag" fullname="QSystemTest::StateFlag" href="qsystemtest.html#StateFlag-enum" location="qsystemtest.h" typedef="QSystemTest::State"> + <value name="Normal" value="0x00000000"/> + <value name="Unavailable" value="0x00000001"/> + <value name="Selected" value="0x00000002"/> + <value name="Focused" value="0x00000004"/> + <value name="Pressed" value="0x00000008"/> + <value name="Checked" value="0x00000010"/> + <value name="Mixed" value="0x00000020"/> + <value name="ReadOnly" value="0x00000040"/> + <value name="HotTracked" value="0x00000080"/> + <value name="DefaultButton" value="0x00000100"/> + <value name="Expanded" value="0x00000200"/> + <value name="Collapsed" value="0x00000400"/> + <value name="Busy" value="0x00000800"/> + <value name="Marqueed" value="0x00002000"/> + <value name="Animated" value="0x00004000"/> + <value name="Invisible" value="0x00008000"/> + <value name="Offscreen" value="0x00010000"/> + <value name="Sizeable" value="0x00020000"/> + <value name="Movable" value="0x00040000"/> + <value name="SelfVoicing" value="0x00080000"/> + <value name="Focusable" value="0x00100000"/> + <value name="Selectable" value="0x00200000"/> + <value name="Linked" value="0x00400000"/> + <value name="Traversed" value="0x00800000"/> + <value name="MultiSelectable" value="0x01000000"/> + <value name="ExtSelectable" value="0x02000000"/> + <value name="Protected" value="0x20000000"/> + <value name="HasPopup" value="0x40000000"/> + <value name="Modal" value="0x80000000"/> + </enum> + <typedef access="public" threadsafety="unspecified" status="commendable" name="State" fullname="QSystemTest::State" href="qsystemtest.html#State-typedef" location="qsystemtest.h" enum="QSystemTest::StateFlag"/> + <function access="public" threadsafety="unspecified" status="commendable" name="strict" fullname="QSystemTest::strict" href="qsystemtest.html#strict" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="strict(bool on)"> + <parameter left="bool" right="" name="on" default="true"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="userName" fullname="QSystemTest::userName" href="qsystemtest.html#userName" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="true" overload="false" type="QString" signature="userName()"/> + <function access="public" threadsafety="unspecified" status="commendable" name="runsOnDevice" fullname="QSystemTest::runsOnDevice" href="qsystemtest.html#runsOnDevice" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="bool" signature="runsOnDevice()"/> + <function access="public" threadsafety="unspecified" status="commendable" name="skip" fullname="QSystemTest::skip" href="qsystemtest.html#skip" location="qsystemtest.h" virtual="impure" meta="slot" const="false" static="false" overload="false" type="void" signature="skip(const QString & message, SkipMode mode)"> + <parameter left="const QString &" right="" name="message" default=""/> + <parameter left="SkipMode" right="" name="mode" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="expectFail" fullname="QSystemTest::expectFail" href="qsystemtest.html#expectFail" location="qsystemtest.h" virtual="impure" meta="slot" const="false" static="false" overload="false" type="void" signature="expectFail(const QString & reason)"> + <parameter left="const QString &" right="" name="reason" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="addExpectedMessageBox" fullname="QSystemTest::addExpectedMessageBox" href="qsystemtest.html#addExpectedMessageBox" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="addExpectedMessageBox(const QString & title, const QString & text, const QString & option)"> + <parameter left="const QString &" right="" name="title" default=""/> + <parameter left="const QString &" right="" name="text" default=""/> + <parameter left="const QString &" right="" name="option" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="clearExpectedMessageBoxes" fullname="QSystemTest::clearExpectedMessageBoxes" href="qsystemtest.html#clearExpectedMessageBoxes" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="clearExpectedMessageBoxes()"/> + <function access="public" threadsafety="unspecified" status="commendable" name="clearExpectedMessageBox" fullname="QSystemTest::clearExpectedMessageBox" href="qsystemtest.html#clearExpectedMessageBox" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="clearExpectedMessageBox(const QString & title, const QString & text)"> + <parameter left="const QString &" right="" name="title" default=""/> + <parameter left="const QString &" right="" name="text" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="waitExpectedMessageBox" fullname="QSystemTest::waitExpectedMessageBox" href="qsystemtest.html#waitExpectedMessageBox" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="bool" signature="waitExpectedMessageBox(uint timeout, bool waitForAll, const QString & title, const QString & text)"> + <parameter left="uint" right="" name="timeout" default=""/> + <parameter left="bool" right="" name="waitForAll" default="true"/> + <parameter left="const QString &" right="" name="title" default="QString()"/> + <parameter left="const QString &" right="" name="text" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="ignoreMessageBoxes" fullname="QSystemTest::ignoreMessageBoxes" href="qsystemtest.html#ignoreMessageBoxes" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="ignoreMessageBoxes(bool ignore)"> + <parameter left="bool" right="" name="ignore" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="signature" fullname="QSystemTest::signature" href="qsystemtest.html#signature" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QString" signature="signature(const QString & labelText, int offset)"> + <parameter left="const QString &" right="" name="labelText" default=""/> + <parameter left="int" right="" name="offset" default="0"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="isVisible" fullname="QSystemTest::isVisible" href="qsystemtest.html#isVisible" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="bool" signature="isVisible(const QString & queryPath)"> + <parameter left="const QString &" right="" name="queryPath" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="isEnabled" fullname="QSystemTest::isEnabled" href="qsystemtest.html#isEnabled" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="bool" signature="isEnabled(const QString & queryPath)"> + <parameter left="const QString &" right="" name="queryPath" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="isChecked" fullname="QSystemTest::isChecked" href="qsystemtest.html#isChecked" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="bool" signature="isChecked(const QString & queryPath)"> + <parameter left="const QString &" right="" name="queryPath" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="isChecked" fullname="QSystemTest::isChecked" href="qsystemtest.html#isChecked-2" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="true" overload-number="2" type="bool" signature="isChecked(const QString & item, const QString & queryPath)"> + <parameter left="const QString &" right="" name="item" default=""/> + <parameter left="const QString &" right="" name="queryPath" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="setChecked" fullname="QSystemTest::setChecked" href="qsystemtest.html#setChecked" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="setChecked(bool doCheck, const QString & queryPath)"> + <parameter left="bool" right="" name="doCheck" default=""/> + <parameter left="const QString &" right="" name="queryPath" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="setChecked" fullname="QSystemTest::setChecked" href="qsystemtest.html#setChecked-2" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="true" overload-number="2" type="void" signature="setChecked(bool doCheck, const QString & item, const QString & queryPath)"> + <parameter left="bool" right="" name="doCheck" default=""/> + <parameter left="const QString &" right="" name="item" default=""/> + <parameter left="const QString &" right="" name="queryPath" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="checkState" fullname="QSystemTest::checkState" href="qsystemtest.html#checkState" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="int" signature="checkState(const QString & queryPath)"> + <parameter left="const QString &" right="" name="queryPath" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="setCheckState" fullname="QSystemTest::setCheckState" href="qsystemtest.html#setCheckState" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="setCheckState(int state, const QString & queryPath)"> + <parameter left="int" right="" name="state" default=""/> + <parameter left="const QString &" right="" name="queryPath" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="currentApplication" fullname="QSystemTest::currentApplication" href="qsystemtest.html#currentApplication" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QString" signature="currentApplication()"/> + <function access="public" threadsafety="unspecified" status="commendable" name="currentTitle" fullname="QSystemTest::currentTitle" href="qsystemtest.html#currentTitle" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QString" signature="currentTitle(const QString & queryPath)"> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="focusWidget" fullname="QSystemTest::focusWidget" href="qsystemtest.html#focusWidget" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QString" signature="focusWidget(const QString & queryPath)"> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getSelectedText" fullname="QSystemTest::getSelectedText" href="qsystemtest.html#getSelectedText" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QString" signature="getSelectedText(const QString & queryPath)"> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getText" fullname="QSystemTest::getText" href="qsystemtest.html#getText" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QString" signature="getText(const QString & queryPath)"> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getSelectedValue" fullname="QSystemTest::getSelectedValue" href="qsystemtest.html#getSelectedValue" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QVariant" signature="getSelectedValue(const QString & queryPath)"> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getValue" fullname="QSystemTest::getValue" href="qsystemtest.html#getValue" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QVariant" signature="getValue(const QString & queryPath)"> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getList" fullname="QSystemTest::getList" href="qsystemtest.html#getList" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QStringList" signature="getList(const QString & queryPath)"> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getLabels" fullname="QSystemTest::getLabels" href="qsystemtest.html#getLabels" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QStringList" signature="getLabels(const QString & queryPath)"> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getClipboardText" fullname="QSystemTest::getClipboardText" href="qsystemtest.html#getClipboardText" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QString" signature="getClipboardText()"/> + <function access="public" threadsafety="unspecified" status="commendable" name="setClipboardText" fullname="QSystemTest::setClipboardText" href="qsystemtest.html#setClipboardText" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="setClipboardText(const QString & text)"> + <parameter left="const QString &" right="" name="text" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getDateTime" fullname="QSystemTest::getDateTime" href="qsystemtest.html#getDateTime" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QDateTime" signature="getDateTime()"/> + <function access="public" threadsafety="unspecified" status="commendable" name="visibleResponseTime" fullname="QSystemTest::visibleResponseTime" href="qsystemtest.html#visibleResponseTime" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="int" signature="visibleResponseTime()"/> + <function access="public" threadsafety="unspecified" status="commendable" name="setVisibleResponseTime" fullname="QSystemTest::setVisibleResponseTime" href="qsystemtest.html#setVisibleResponseTime" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="setVisibleResponseTime(int time)"> + <parameter left="int" right="" name="time" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="startApplication" fullname="QSystemTest::startApplication" href="qsystemtest.html#startApplication" location="qsystemtest.h" virtual="impure" meta="slot" const="false" static="false" overload="false" type="void" signature="startApplication(const QString & application, const QStringList & arguments, int timeout, QFlags<QSystemTest::StartApplicationFlag> flags)"> + <parameter left="const QString &" right="" name="application" default=""/> + <parameter left="const QStringList &" right="" name="arguments" default="QStringList()"/> + <parameter left="int" right="" name="timeout" default="5000"/> + <parameter left="QFlags<QSystemTest::StartApplicationFlag>" right="" name="flags" default="QSystemTest::WaitForFocus"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="expectApplicationClose" fullname="QSystemTest::expectApplicationClose" href="qsystemtest.html#expectApplicationClose" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="expectApplicationClose(bool value)"> + <parameter left="bool" right="" name="value" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="keyClick" fullname="QSystemTest::keyClick" href="qsystemtest.html#keyClick" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="keyClick(Qt::Key key, const QString & queryPath)"> + <parameter left="Qt::Key" right="" name="key" default=""/> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="keyClickHold" fullname="QSystemTest::keyClickHold" href="qsystemtest.html#keyClickHold" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="keyClickHold(Qt::Key key, int duration, const QString & queryPath)"> + <parameter left="Qt::Key" right="" name="key" default=""/> + <parameter left="int" right="" name="duration" default=""/> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="keyPress" fullname="QSystemTest::keyPress" href="qsystemtest.html#keyPress" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="keyPress(Qt::Key key, const QString & queryPath)"> + <parameter left="Qt::Key" right="" name="key" default=""/> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="keyRelease" fullname="QSystemTest::keyRelease" href="qsystemtest.html#keyRelease" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="keyRelease(Qt::Key key, const QString & queryPath)"> + <parameter left="Qt::Key" right="" name="key" default=""/> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="mouseClick" fullname="QSystemTest::mouseClick" href="qsystemtest.html#mouseClick" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="mouseClick(int x, int y, QFlags<Qt::MouseButton> buttons)"> + <parameter left="int" right="" name="x" default=""/> + <parameter left="int" right="" name="y" default=""/> + <parameter left="QFlags<Qt::MouseButton>" right="" name="buttons" default="Qt::LeftButton"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="mouseClick" fullname="QSystemTest::mouseClick" href="qsystemtest.html#mouseClick-2" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="true" overload-number="2" type="void" signature="mouseClick(const QString & queryPath, QFlags<Qt::MouseButton> buttons)"> + <parameter left="const QString &" right="" name="queryPath" default=""/> + <parameter left="QFlags<Qt::MouseButton>" right="" name="buttons" default="Qt::LeftButton"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="mouseClickHold" fullname="QSystemTest::mouseClickHold" href="qsystemtest.html#mouseClickHold" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="mouseClickHold(int x, int y, int duration, QFlags<Qt::MouseButton> buttons)"> + <parameter left="int" right="" name="x" default=""/> + <parameter left="int" right="" name="y" default=""/> + <parameter left="int" right="" name="duration" default=""/> + <parameter left="QFlags<Qt::MouseButton>" right="" name="buttons" default="Qt::LeftButton"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="mouseClickHold" fullname="QSystemTest::mouseClickHold" href="qsystemtest.html#mouseClickHold-2" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="true" overload-number="2" type="void" signature="mouseClickHold(const QString & queryPath, int duration, QFlags<Qt::MouseButton> buttons)"> + <parameter left="const QString &" right="" name="queryPath" default=""/> + <parameter left="int" right="" name="duration" default=""/> + <parameter left="QFlags<Qt::MouseButton>" right="" name="buttons" default="Qt::LeftButton"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="mousePress" fullname="QSystemTest::mousePress" href="qsystemtest.html#mousePress" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="mousePress(int x, int y, QFlags<Qt::MouseButton> buttons)"> + <parameter left="int" right="" name="x" default=""/> + <parameter left="int" right="" name="y" default=""/> + <parameter left="QFlags<Qt::MouseButton>" right="" name="buttons" default="Qt::LeftButton"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="mousePress" fullname="QSystemTest::mousePress" href="qsystemtest.html#mousePress-2" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="true" overload-number="2" type="void" signature="mousePress(const QString & queryPath, QFlags<Qt::MouseButton> buttons)"> + <parameter left="const QString &" right="" name="queryPath" default=""/> + <parameter left="QFlags<Qt::MouseButton>" right="" name="buttons" default="Qt::LeftButton"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="mouseRelease" fullname="QSystemTest::mouseRelease" href="qsystemtest.html#mouseRelease" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="mouseRelease(int x, int y, QFlags<Qt::MouseButton> buttons)"> + <parameter left="int" right="" name="x" default=""/> + <parameter left="int" right="" name="y" default=""/> + <parameter left="QFlags<Qt::MouseButton>" right="" name="buttons" default="Qt::LeftButton"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="mouseRelease" fullname="QSystemTest::mouseRelease" href="qsystemtest.html#mouseRelease-2" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="true" overload-number="2" type="void" signature="mouseRelease(const QString & queryPath, QFlags<Qt::MouseButton> buttons)"> + <parameter left="const QString &" right="" name="queryPath" default=""/> + <parameter left="QFlags<Qt::MouseButton>" right="" name="buttons" default="Qt::LeftButton"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="mousePreferred" fullname="QSystemTest::mousePreferred" href="qsystemtest.html#mousePreferred" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="bool" signature="mousePreferred()"/> + <function access="public" threadsafety="unspecified" status="commendable" name="setMousePreferred" fullname="QSystemTest::setMousePreferred" href="qsystemtest.html#setMousePreferred" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="setMousePreferred(bool useMouse)"> + <parameter left="bool" right="" name="useMouse" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="labelOrientation" fullname="QSystemTest::labelOrientation" href="qsystemtest.html#labelOrientation" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="LabelOrientation" signature="labelOrientation()"/> + <function access="public" threadsafety="unspecified" status="commendable" name="setLabelOrientation" fullname="QSystemTest::setLabelOrientation" href="qsystemtest.html#setLabelOrientation" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="setLabelOrientation(LabelOrientation orientation)"> + <parameter left="LabelOrientation" right="" name="orientation" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="enter" fullname="QSystemTest::enter" href="qsystemtest.html#enter" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="enter(const QVariant & value, const QString & queryPath, EnterMode mode)"> + <parameter left="const QVariant &" right="" name="value" default=""/> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + <parameter left="EnterMode" right="" name="mode" default="Commit"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="select" fullname="QSystemTest::select" href="qsystemtest.html#select" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="select(const QString & item, const QString & queryPath)"> + <parameter left="const QString &" right="" name="item" default=""/> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="selectIndex" fullname="QSystemTest::selectIndex" href="qsystemtest.html#selectIndex" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="selectIndex(const QVariantList & index, const QString & queryPath)"> + <parameter left="const QVariantList &" right="" name="index" default=""/> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="activate" fullname="QSystemTest::activate" href="qsystemtest.html#activate" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="activate(const QString & queryPath)"> + <parameter left="const QString &" right="" name="queryPath" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="waitForTitle" fullname="QSystemTest::waitForTitle" href="qsystemtest.html#waitForTitle" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="waitForTitle(const QString & title, int timeout)"> + <parameter left="const QString &" right="" name="title" default=""/> + <parameter left="int" right="" name="timeout" default="0"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="verifyImage" fullname="QSystemTest::verifyImage" href="qsystemtest.html#verifyImage" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="verifyImage(const QString & expectedName, const QString & queryPath, const QString & comment, const QStringList & maskedWidgets)"> + <parameter left="const QString &" right="" name="expectedName" default=""/> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + <parameter left="const QString &" right="" name="comment" default="QString()"/> + <parameter left="const QStringList &" right="" name="maskedWidgets" default="QStringList()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="compareImage" fullname="QSystemTest::compareImage" href="qsystemtest.html#compareImage" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="bool" signature="compareImage(const QString & expectedName, const QString & queryPath, const QStringList & maskedWidgets)"> + <parameter left="const QString &" right="" name="expectedName" default=""/> + <parameter left="const QString &" right="" name="queryPath" default=""/> + <parameter left="const QStringList &" right="" name="maskedWidgets" default="QStringList()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="prompt" fullname="QSystemTest::prompt" href="qsystemtest.html#prompt" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="prompt(const QString & promptText)"> + <parameter left="const QString &" right="" name="promptText" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="wait" fullname="QSystemTest::wait" href="qsystemtest.html#wait" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="wait(int msecs)"> + <parameter left="int" right="" name="msecs" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="saveScreen" fullname="QSystemTest::saveScreen" href="qsystemtest.html#saveScreen" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="saveScreen(const QString & name, const QString & queryPath)"> + <parameter left="const QString &" right="" name="name" default=""/> + <parameter left="const QString &" right="" name="queryPath" default=""qpe:""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="runProcess" fullname="QSystemTest::runProcess" href="qsystemtest.html#runProcess" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QString" signature="runProcess(const QString & application, const QStringList & args, const QString & input)"> + <parameter left="const QString &" right="" name="application" default=""/> + <parameter left="const QStringList &" right="" name="args" default=""/> + <parameter left="const QString &" right="" name="input" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getenv" fullname="QSystemTest::getenv" href="qsystemtest.html#getenv" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QString" signature="getenv(const QString & )"> + <parameter left="const QString &" right="" name="" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="checkOS" fullname="QSystemTest::checkOS" href="qsystemtest.html#checkOS" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="bool" signature="checkOS(const QString & )"> + <parameter left="const QString &" right="" name="" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="putFile" fullname="QSystemTest::putFile" href="qsystemtest.html#putFile" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="putFile(const QString & srcFile, const QString & destFile, QFile::Permissions permissions)"> + <parameter left="const QString &" right="" name="srcFile" default=""/> + <parameter left="const QString &" right="" name="destFile" default=""/> + <parameter left="QFile::Permissions" right="" name="permissions" default="0"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="putData" fullname="QSystemTest::putData" href="qsystemtest.html#putData" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="putData(const QByteArray & data, const QString & destFile, QFile::Permissions permissions)"> + <parameter left="const QByteArray &" right="" name="data" default=""/> + <parameter left="const QString &" right="" name="destFile" default=""/> + <parameter left="QFile::Permissions" right="" name="permissions" default="0"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getFile" fullname="QSystemTest::getFile" href="qsystemtest.html#getFile" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="getFile(const QString & srcFile, const QString & destFile)"> + <parameter left="const QString &" right="" name="srcFile" default=""/> + <parameter left="const QString &" right="" name="destFile" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="readLocalFile" fullname="QSystemTest::readLocalFile" href="qsystemtest.html#readLocalFile" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QString" signature="readLocalFile(const QString & file)"> + <parameter left="const QString &" right="" name="file" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getData" fullname="QSystemTest::getData" href="qsystemtest.html#getData" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QString" signature="getData(const QString & srcFile)"> + <parameter left="const QString &" right="" name="srcFile" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="deletePath" fullname="QSystemTest::deletePath" href="qsystemtest.html#deletePath" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="deletePath(const QString & path)"> + <parameter left="const QString &" right="" name="path" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getDirectoryEntries" fullname="QSystemTest::getDirectoryEntries" href="qsystemtest.html#getDirectoryEntries" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QStringList" signature="getDirectoryEntries(const QString & dir, QDir::Filters filters)"> + <parameter left="const QString &" right="" name="dir" default=""/> + <parameter left="QDir::Filters" right="" name="filters" default="QDir::NoFilter"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getGeometry" fullname="QSystemTest::getGeometry" href="qsystemtest.html#getGeometry" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QRect" signature="getGeometry(const QString & queryPath)"> + <parameter left="const QString &" right="" name="queryPath" default="QString()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="setProperty" fullname="QSystemTest::setProperty" href="qsystemtest.html#setProperty" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="setProperty(const QString & queryPath, const QString & name, const QVariant & value)"> + <parameter left="const QString &" right="" name="queryPath" default=""/> + <parameter left="const QString &" right="" name="name" default=""/> + <parameter left="const QVariant &" right="" name="value" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getProperty" fullname="QSystemTest::getProperty" href="qsystemtest.html#getProperty" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QVariant" signature="getProperty(const QString & queryPath, const QString & name)"> + <parameter left="const QString &" right="" name="queryPath" default=""/> + <parameter left="const QString &" right="" name="name" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="findByProperty" fullname="QSystemTest::findByProperty" href="qsystemtest.html#findByProperty" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QStringList" signature="findByProperty(const QString & property, const QVariant & searchValue)"> + <parameter left="const QString &" right="" name="property" default=""/> + <parameter left="const QVariant &" right="" name="searchValue" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="findByProperty" fullname="QSystemTest::findByProperty" href="qsystemtest.html#findByProperty-2" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="true" overload-number="2" type="QStringList" signature="findByProperty(const QVariantMap & searchValues)"> + <parameter left="const QVariantMap &" right="" name="searchValues" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="invokeMethod" fullname="QSystemTest::invokeMethod" href="qsystemtest.html#invokeMethod-2" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="true" overload-number="2" type="bool" signature="invokeMethod(const QString & queryPath, const QString & method, const QVariant & arg0, const QVariant & arg1, const QVariant & arg2, const QVariant & arg3, const QVariant & arg4, const QVariant & arg5, const QVariant & arg6, const QVariant & arg7, const QVariant & arg8, const QVariant & arg9)"> + <parameter left="const QString &" right="" name="queryPath" default=""/> + <parameter left="const QString &" right="" name="method" default=""/> + <parameter left="const QVariant &" right="" name="arg0" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg1" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg2" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg3" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg4" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg5" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg6" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg7" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg8" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg9" default="QVariant()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="invokeMethod" fullname="QSystemTest::invokeMethod" href="qsystemtest.html#invokeMethod" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="bool" signature="invokeMethod(const QString & queryPath, const QString & method, Qt::ConnectionType type, const QVariant & arg0, const QVariant & arg1, const QVariant & arg2, const QVariant & arg3, const QVariant & arg4, const QVariant & arg5, const QVariant & arg6, const QVariant & arg7, const QVariant & arg8, const QVariant & arg9)"> + <parameter left="const QString &" right="" name="queryPath" default=""/> + <parameter left="const QString &" right="" name="method" default=""/> + <parameter left="Qt::ConnectionType" right="" name="type" default=""/> + <parameter left="const QVariant &" right="" name="arg0" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg1" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg2" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg3" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg4" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg5" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg6" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg7" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg8" default="QVariant()"/> + <parameter left="const QVariant &" right="" name="arg9" default="QVariant()"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getSetting" fullname="QSystemTest::getSetting" href="qsystemtest.html#getSetting" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QVariant" signature="getSetting(const QString & file, const QString & group, const QString & key)"> + <parameter left="const QString &" right="" name="file" default=""/> + <parameter left="const QString &" right="" name="group" default=""/> + <parameter left="const QString &" right="" name="key" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getSetting" fullname="QSystemTest::getSetting" href="qsystemtest.html#getSetting-2" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="true" overload-number="2" type="QVariant" signature="getSetting(const QString & organization, const QString & application, const QString & group, const QString & key)"> + <parameter left="const QString &" right="" name="organization" default=""/> + <parameter left="const QString &" right="" name="application" default=""/> + <parameter left="const QString &" right="" name="group" default=""/> + <parameter left="const QString &" right="" name="key" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="setSetting" fullname="QSystemTest::setSetting" href="qsystemtest.html#setSetting" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="setSetting(const QString & file, const QString & group, const QString & key, const QVariant & value)"> + <parameter left="const QString &" right="" name="file" default=""/> + <parameter left="const QString &" right="" name="group" default=""/> + <parameter left="const QString &" right="" name="key" default=""/> + <parameter left="const QVariant &" right="" name="value" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="setSetting" fullname="QSystemTest::setSetting" href="qsystemtest.html#setSetting-2" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="true" overload-number="2" type="void" signature="setSetting(const QString & organization, const QString & application, const QString & group, const QString & key, const QVariant & value)"> + <parameter left="const QString &" right="" name="organization" default=""/> + <parameter left="const QString &" right="" name="application" default=""/> + <parameter left="const QString &" right="" name="group" default=""/> + <parameter left="const QString &" right="" name="key" default=""/> + <parameter left="const QVariant &" right="" name="value" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="translate" fullname="QSystemTest::translate" href="qsystemtest.html#translate" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QString" signature="translate(const QString & context, const QString & text, const QString & comment, int n)"> + <parameter left="const QString &" right="" name="context" default=""/> + <parameter left="const QString &" right="" name="text" default=""/> + <parameter left="const QString &" right="" name="comment" default="QString()"/> + <parameter left="int" right="" name="n" default="0"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="getLocale" fullname="QSystemTest::getLocale" href="qsystemtest.html#getLocale" location="qsystemtest.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="QLocale" signature="getLocale()"/> + <variable access="protected" threadsafety="unspecified" status="commendable" name="abort_prompt" fullname="QSystemTest::abort_prompt" href="qsystemtest.html#abort_prompt-var" location="qsystemtest.h" type="bool" static="false"/> + <function access="public" threadsafety="unspecified" status="commendable" name="waitFor" fullname="QSystemTest::waitFor" href="qsystemtest.html#waitFor" location="qsystemtest.h" virtual="non" meta="plain" const="false" static="false" overload="false" type="void" signature="waitFor(Number timeout, Number intervals, String message)"> + <parameter left="Number" right="" name="timeout" default="10000"/> + <parameter left="Number" right="" name="intervals" default="20"/> + <parameter left="String" right="" name="message" default="null"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="expectMessageBox" fullname="QSystemTest::expectMessageBox" href="qsystemtest.html#expectMessageBox" location="qsystemtest.h" virtual="non" meta="plain" const="false" static="false" overload="false" type="void" signature="expectMessageBox(String title, String text, String option, Number timeout)"> + <parameter left="String" right="" name="title" default=""/> + <parameter left="String" right="" name="text" default=""/> + <parameter left="String" right="" name="option" default=""/> + <parameter left="Number" right="" name="timeout" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="compare" fullname="QSystemTest::compare" href="qsystemtest.html#compare" location="qsystemtest.h" virtual="non" meta="plain" const="false" static="false" overload="false" type="void" signature="compare(Variant actual, Variant expected)"> + <parameter left="Variant" right="" name="actual" default=""/> + <parameter left="Variant" right="" name="expected" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="verify" fullname="QSystemTest::verify" href="qsystemtest.html#verify" location="qsystemtest.h" virtual="non" meta="plain" const="false" static="false" overload="false" type="void" signature="verify(Boolean condition, String message)"> + <parameter left="Boolean" right="" name="condition" default=""/> + <parameter left="String" right="" name="message" default="null"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="fail" fullname="QSystemTest::fail" href="qsystemtest.html#fail" location="qsystemtest.h" virtual="non" meta="plain" const="false" static="false" overload="false" type="void" signature="fail(String message)"> + <parameter left="String" right="" name="message" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="tabBar" fullname="QSystemTest::tabBar" href="qsystemtest.html#tabBar" location="qsystemtest.h" virtual="non" meta="plain" const="false" static="false" overload="false" type="void" signature="tabBar(int index)"> + <parameter left="int" right="" name="index" default="0"/> + </function> + </namespace> + <typedef access="public" threadsafety="unspecified" status="commendable" name="StringArray" href="qsystemtest.html#StringArray-typedef" location="qsystemtest.h"/> + <typedef access="public" threadsafety="unspecified" status="commendable" name="QVariantArray" href="qsystemtest.html#QVariantArray-typedef" location="qsystemtest.h"/> + <typedef access="public" threadsafety="unspecified" status="commendable" name="Boolean" href="qsystemtest.html#Boolean-typedef" location="qsystemtest.h"/> + <typedef access="public" threadsafety="unspecified" status="commendable" name="Number" href="qsystemtest.html#Number-typedef" location="qsystemtest.h"/> + <typedef access="public" threadsafety="unspecified" status="commendable" name="Array" href="qsystemtest.html#Array-typedef" location="qsystemtest.h"/> + <typedef access="public" threadsafety="unspecified" status="commendable" name="Function" href="qsystemtest.html#Function-typedef" location="qsystemtest.h"/> + <class access="public" threadsafety="unspecified" status="preliminary" name="QtUiTestRecorder" href="qtuitestrecorder.html" location="qtuitestrecorder.h" bases="" module=""> + <function access="public" threadsafety="unspecified" status="commendable" name="QtUiTestRecorder" fullname="QtUiTestRecorder::QtUiTestRecorder" href="qtuitestrecorder.html#QtUiTestRecorder" location="qtuitestrecorder.h" virtual="non" meta="constructor" const="false" static="false" overload="false" type="" signature="QtUiTestRecorder(QObject * parent)"> + <parameter left="QObject *" right="" name="parent" default="0"/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="~QtUiTestRecorder" fullname="QtUiTestRecorder::~QtUiTestRecorder" href="qtuitestrecorder.html#dtor.QtUiTestRecorder" location="qtuitestrecorder.h" virtual="non" meta="destructor" const="false" static="false" overload="false" type="" signature="~QtUiTestRecorder()"/> + <function access="public" threadsafety="unspecified" status="commendable" name="gotFocus" fullname="QtUiTestRecorder::gotFocus" href="qtuitestrecorder.html#gotFocus" location="qtuitestrecorder.h" virtual="non" meta="signal" const="false" static="false" overload="false" type="void" signature="gotFocus(QObject * widget)"> + <parameter left="QObject *" right="" name="widget" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="activated" fullname="QtUiTestRecorder::activated" href="qtuitestrecorder.html#activated" location="qtuitestrecorder.h" virtual="non" meta="signal" const="false" static="false" overload="false" type="void" signature="activated(QObject * widget)"> + <parameter left="QObject *" right="" name="widget" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="stateChanged" fullname="QtUiTestRecorder::stateChanged" href="qtuitestrecorder.html#stateChanged" location="qtuitestrecorder.h" virtual="non" meta="signal" const="false" static="false" overload="false" type="void" signature="stateChanged(QObject * widget, int state)"> + <parameter left="QObject *" right="" name="widget" default=""/> + <parameter left="int" right="" name="state" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="entered" fullname="QtUiTestRecorder::entered" href="qtuitestrecorder.html#entered" location="qtuitestrecorder.h" virtual="non" meta="signal" const="false" static="false" overload="false" type="void" signature="entered(QObject * widget, QVariant const & item)"> + <parameter left="QObject *" right="" name="widget" default=""/> + <parameter left="QVariant const &" right="" name="item" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="selected" fullname="QtUiTestRecorder::selected" href="qtuitestrecorder.html#selected" location="qtuitestrecorder.h" virtual="non" meta="signal" const="false" static="false" overload="false" type="void" signature="selected(QObject * widget, QString const & item)"> + <parameter left="QObject *" right="" name="widget" default=""/> + <parameter left="QString const &" right="" name="item" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="keyEvent" fullname="QtUiTestRecorder::keyEvent" href="qtuitestrecorder.html#keyEvent" location="qtuitestrecorder.h" virtual="non" meta="signal" const="false" static="false" overload="false" type="void" signature="keyEvent(int key, int modifiers, bool isPress, bool isAutoRepeat)"> + <parameter left="int" right="" name="key" default=""/> + <parameter left="int" right="" name="modifiers" default=""/> + <parameter left="bool" right="" name="isPress" default=""/> + <parameter left="bool" right="" name="isAutoRepeat" default=""/> + </function> + <function access="public" threadsafety="unspecified" status="commendable" name="mouseEvent" fullname="QtUiTestRecorder::mouseEvent" href="qtuitestrecorder.html#mouseEvent" location="qtuitestrecorder.h" virtual="non" meta="signal" const="false" static="false" overload="false" type="void" signature="mouseEvent(int x, int y, int state)"> + <parameter left="int" right="" name="x" default=""/> + <parameter left="int" right="" name="y" default=""/> + <parameter left="int" right="" name="state" default=""/> + </function> + </class> + <function access="public" threadsafety="unspecified" status="commendable" name="qtuitest_cast" href="qtuitest.html#qtuitest_cast" location="qtuitestnamespace.h" virtual="non" meta="plain" const="false" static="false" overload="false" relates="QtUiTest" type="T" signature="qtuitest_cast(const QObject * object)"> + <parameter left="const QObject *" right="" name="object" default=""/> + </function> + <page access="public" status="commendable" name="qtuitest_manual.html" href="qtuitest-manual.html" subtype="page" title="QtUiTest Manual" fulltitle="QtUiTest Manual" subtitle="" location="qtuitest_manual.qdoc"> + <contents name="introduction" title="Introduction" level="1"/> + <contents name="the-scripting-language" title="The Scripting Language" level="1"/> + <contents name="language-design-philosophy" title="Language design philosophy" level="2"/> + <contents name="using-qtuitest" title="Using QtUiTest" level="1"/> + <contents name="creating-a-test" title="Creating a Test" level="2"/> + <contents name="writing-a-manual-system-test" title="Writing a Manual System Test" level="3"/> + <contents name="running-a-test" title="Running a Test" level="2"/> + <contents name="running-tests-in-a-continuous-integration-system" title="Running tests in a Continuous Integration System" level="3"/> + <contents name="qtuitest-tutorial" title="QtUiTest Tutorial" level="2"/> + <contents name="qtuitest-api-overview" title="QtUiTest API Overview" level="1"/> + <contents name="system-architecture" title="System Architecture" level="2"/> + <contents name="query-paths" title="Query Paths" level="2"/> + <contents name="labels" title="Labels" level="3"/> + <contents name="signatures" title="Signatures" level="3"/> + <contents name="querying-widgets-by-property" title="Querying Widgets By Property" level="3"/> + <contents name="learn-mode" title="Learn Mode" level="2"/> + <contents name="application-management" title="Application Management" level="2"/> + <contents name="file-management" title="File Management" level="2"/> + <contents name="querying-objects" title="Querying Objects" level="2"/> + <contents name="text-entry-and-navigation" title="Text Entry and Navigation" level="2"/> + <contents name="key-simulation" title="Key Simulation" level="2"/> + <contents name="mouse-touchscreen-simulation" title="Mouse / Touchscreen Simulation" level="2"/> + <contents name="other" title="Other" level="2"/> + <contents name="extending-qtuitest-for-custom-widgets" title="Extending QtUiTest for Custom Widgets" level="1"/> + <contents name="qtuitest-api-reference" title="QtUiTest API Reference" level="1"/> + </page> + <page access="public" status="commendable" name="qtuitest-tutorial.html" href="qtuitest-tutorial.html" subtype="page" title="QtUiTest Tutorial" fulltitle="QtUiTest Tutorial" subtitle="" location="qtuitest_tutorial.qdoc"/> + <page access="public" status="commendable" name="qtuitest-tutorial1.html" href="qtuitest-tutorial1.html" subtype="page" title="Chapter 1: Writing a System Test" fulltitle="Chapter 1: Writing a System Test" subtitle="" location="qtuitest_tutorial.qdoc"> + <contents name="setting-up-the-environment" title="Setting up the environment" level="1"/> + <contents name="writing-the-test" title="Writing the Test" level="1"/> + <contents name="running-the-test-for-the-first-time" title="Running the test for the first time" level="2"/> + <contents name="special-functions" title="Special functions" level="2"/> + <contents name="interacting-with-the-system-under-test" title="Interacting with the System Under Test" level="2"/> + </page> + <page access="public" status="commendable" name="qtuitest-tutorial2.html" href="qtuitest-tutorial2.html" subtype="page" title="Chapter 2: Input, Output and Widget Navigation" fulltitle="Chapter 2: Input, Output and Widget Navigation" subtitle="" location="qtuitest_tutorial.qdoc"> + <contents name="basic-input" title="Basic Input" level="1"/> + <contents name="input-into-specific-widgets" title="Input Into Specific Widgets" level="1"/> + <contents name="selecting-items-from-lists-and-menus-and-activating-buttons" title="Selecting Items from Lists and Menus, and Activating Buttons" level="1"/> + <contents name="output" title="Output" level="1"/> + </page> + <page access="public" status="commendable" name="qtuitest-tutorial3.html" href="qtuitest-tutorial3.html" subtype="page" title="Chapter 3: Data driven testing" fulltitle="Chapter 3: Data driven testing" subtitle="" location="qtuitest_tutorial.qdoc"/> + <page access="public" status="commendable" name="qtuitest-tutorial4.html" href="qtuitest-tutorial4.html" subtype="page" title="Chapter 4: Putting It All Together" fulltitle="Chapter 4: Putting It All Together" subtitle="" location="qtuitest_tutorial.qdoc"/> + <page access="public" status="commendable" name="index.html" href="index.html" subtype="page" title="Qt Reference Documentation" fulltitle="Qt Reference Documentation" subtitle="" location="index.qdoc"> + <keyword name="qt-reference-documentation"/> + </page> + <page access="public" status="commendable" name="qtuitest_plugins.html" href="qtuitest-plugins.html" subtype="page" title="Creating a QtUiTest Test Widget" fulltitle="Creating a QtUiTest Test Widget" subtitle="" location="qtuitest_plugins.qdoc"> + <contents name="introduction" title="Introduction" level="1"/> + <contents name="when-a-test-widget-is-required" title="When a Test Widget is Required" level="1"/> + <contents name="choosing-the-right-interfaces" title="Choosing the Right Interfaces" level="1"/> + <contents name="implementing-the-test-widget" title="Implementing the Test Widget" level="1"/> + <contents name="plugin-method" title="Plugin method" level="2"/> + <contents name="test-widget-class" title="Test widget class" level="3"/> + <contents name="test-widget-factory" title="Test widget factory" level="3"/> + <contents name="multiple-inheritance-method" title="Multiple inheritance method" level="2"/> + </page> + </namespace> +</INDEX> diff --git a/old/doc/html/qtuitestrecorder-members.html b/old/doc/html/qtuitestrecorder-members.html new file mode 100644 index 0000000..51d6f62 --- /dev/null +++ b/old/doc/html/qtuitestrecorder-members.html @@ -0,0 +1,33 @@ +<?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"> +<!-- ../../lib/qtuitestrecorder.cpp --> +<head> + <title>List of All Members for QtUiTestRecorder</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">List of All Members for QtUiTestRecorder</h1> +<p>This is the complete list of members for <a href="qtuitestrecorder.html">QtUiTestRecorder</a>, including inherited members.</p> +<ul> +<li><div class="fn"><b><a href="qtuitestrecorder.html#QtUiTestRecorder">QtUiTestRecorder</a></b> ( QObject * )</div></li> +<li><div class="fn"><b><a href="qtuitestrecorder.html#dtor.QtUiTestRecorder">~QtUiTestRecorder</a></b> ()</div></li> +<li><div class="fn"><b><a href="qtuitestrecorder.html#activated">activated</a></b> ( QObject * )</div></li> +<li><div class="fn"><b><a href="qtuitestrecorder.html#entered">entered</a></b> ( QObject *, QVariant const & )</div></li> +<li><div class="fn"><b><a href="qtuitestrecorder.html#gotFocus">gotFocus</a></b> ( QObject * )</div></li> +<li><div class="fn"><b><a href="qtuitestrecorder.html#keyEvent">keyEvent</a></b> ( int, int, bool, bool )</div></li> +<li><div class="fn"><b><a href="qtuitestrecorder.html#mouseEvent">mouseEvent</a></b> ( int, int, int )</div></li> +<li><div class="fn"><b><a href="qtuitestrecorder.html#selected">selected</a></b> ( QObject *, QString const & )</div></li> +<li><div class="fn"><b><a href="qtuitestrecorder.html#stateChanged">stateChanged</a></b> ( QObject *, int )</div></li> +</ul> +<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> diff --git a/old/doc/html/qtuitestrecorder.html b/old/doc/html/qtuitestrecorder.html new file mode 100644 index 0000000..17b1e13 --- /dev/null +++ b/old/doc/html/qtuitestrecorder.html @@ -0,0 +1,83 @@ +<?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"> +<!-- ../../lib/qtuitestrecorder.cpp --> +<head> + <title>QtUiTestRecorder Class 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">QtUiTestRecorder Class Reference<br /><span class="small-subtitle">[QtUiTestModule]</span> +</h1> +<p>The QtUiTestRecorder class provides an interface for observing application-wide high level user actions. <a href="#details">More...</a></p> +<pre> #include <QtUiTestRecorder></pre><p><b>This class is under development and is subject to change.</b></p> +<ul> +<li><a href="qtuitestrecorder-members.html">List of all members, including inherited members</a></li> +</ul> +<hr /> +<a name="public-functions"></a> +<h2>Public 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="qtuitestrecorder.html#QtUiTestRecorder">QtUiTestRecorder</a></b> ( QObject * <i>parent</i> = 0 )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qtuitestrecorder.html#dtor.QtUiTestRecorder">~QtUiTestRecorder</a></b> ()</td></tr> +</table> +<hr /> +<a name="signals"></a> +<h2>Signals</h2> +<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtuitestrecorder.html#activated">activated</a></b> ( QObject * <i>widget</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtuitestrecorder.html#entered">entered</a></b> ( QObject * <i>widget</i>, QVariant const & <i>item</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtuitestrecorder.html#gotFocus">gotFocus</a></b> ( QObject * <i>widget</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtuitestrecorder.html#keyEvent">keyEvent</a></b> ( int <i>key</i>, int <i>modifiers</i>, bool <i>isPress</i>, bool <i>isAutoRepeat</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtuitestrecorder.html#mouseEvent">mouseEvent</a></b> ( int <i>x</i>, int <i>y</i>, int <i>state</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtuitestrecorder.html#selected">selected</a></b> ( QObject * <i>widget</i>, QString const & <i>item</i> )</td></tr> +<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtuitestrecorder.html#stateChanged">stateChanged</a></b> ( QObject * <i>widget</i>, int <i>state</i> )</td></tr> +</table> +<a name="details"></a> +<hr /> +<h2>Detailed Description</h2> +<p>The QtUiTestRecorder class provides an interface for observing application-wide high level user actions.</p> +<p>QtUiTestRecorder aggregates the signals declared in the <a href="qtuitest.html">QtUiTest widget interfaces</a> to provide a single object capable of watching for user input.</p> +<p>Note that using this class is expensive because it involves watching for signals on a large number of objects. When you create a QtUiTestRecorder and connect to its signals, this will result in every existing widget being wrapped in a <a href="qtuitest.html">test widget</a>. To avoid this, do not connect to the signals of a QtUiTestRecorder unless you will definitely use the result.</p> +<hr /> +<h2>Member Function Documentation</h2> +<h3 class="fn"><a name="QtUiTestRecorder"></a>QtUiTestRecorder::QtUiTestRecorder ( QObject * <i>parent</i> = 0 )</h3> +<p>Constructs a <a href="qtuitestrecorder.html">QtUiTestRecorder</a> with the given <i>parent</i>.</p> +<h3 class="fn"><a name="dtor.QtUiTestRecorder"></a>QtUiTestRecorder::~QtUiTestRecorder ()</h3> +<p>Destroys the <a href="qtuitestrecorder.html">QtUiTestRecorder</a>.</p> +<h3 class="fn"><a name="activated"></a>void QtUiTestRecorder::activated ( QObject * <i>widget</i> ) <tt> [signal]</tt></h3> +<p>Emitted when <i>widget</i> is activated by any means.</p> +<p>In this context, "activated" means, for example, clicking a button.</p> +<p>See also <a href="qtuitest-activatewidget.html#activated">QtUiTest::ActivateWidget::activated</a>().</p> +<h3 class="fn"><a name="entered"></a>void QtUiTestRecorder::entered ( QObject * <i>widget</i>, QVariant const & <i>item</i> ) <tt> [signal]</tt></h3> +<p>Emitted when <i>item</i> is entered into <i>widget</i>.</p> +<p>See also <a href="qtuitest-inputwidget.html#entered">QtUiTest::InputWidget::entered</a>().</p> +<h3 class="fn"><a name="gotFocus"></a>void QtUiTestRecorder::gotFocus ( QObject * <i>widget</i> ) <tt> [signal]</tt></h3> +<p>Emitted when <i>widget</i> obtains focus by any means.</p> +<p>See also <a href="qtuitest-widget.html#gotFocus">QtUiTest::Widget::gotFocus</a>().</p> +<h3 class="fn"><a name="keyEvent"></a>void QtUiTestRecorder::keyEvent ( int <i>key</i>, int <i>modifiers</i>, bool <i>isPress</i>, bool <i>isAutoRepeat</i> ) <tt> [signal]</tt></h3> +<p>Emitted when <i>key</i> (with <i>modifiers</i>) is pressed or released.</p> +<p><i>key</i> is compatible with Qt::Key and <i>modifiers</i> is compatible with Qt::KeyboardModifiers.</p> +<p>If the event is a press <i>isPress</i> is true, otherwise it is a release. <i>isAutoRepeat</i> is true if the event is generated due to autorepeat.</p> +<p>This signal is only emitted within the server process, because individual applications cannot monitor system-wide key events.</p> +<h3 class="fn"><a name="mouseEvent"></a>void QtUiTestRecorder::mouseEvent ( int <i>x</i>, int <i>y</i>, int <i>state</i> ) <tt> [signal]</tt></h3> +<p>Emitted when the mouse changes state.</p> +<p><i>x</i> and <i>y</i> are the global co-ordinates of the event. <i>state</i> is the current state of the mouse buttons, compatible with Qt::MouseButtons.</p> +<p>This signal is only emitted within the server process, because individual applications cannot monitor system-wide mouse events.</p> +<h3 class="fn"><a name="selected"></a>void QtUiTestRecorder::selected ( QObject * <i>widget</i>, QString const & <i>item</i> ) <tt> [signal]</tt></h3> +<p>Emitted when <i>item</i> is selected from <i>widget</i>.</p> +<p>See also <a href="qtuitest-selectwidget.html#selected">QtUiTest::SelectWidget::selected</a>().</p> +<h3 class="fn"><a name="stateChanged"></a>void QtUiTestRecorder::stateChanged ( QObject * <i>widget</i>, int <i>state</i> ) <tt> [signal]</tt></h3> +<p>Emitted when the check state changes to <i>state</i> in <i>widget</i>.</p> +<p>See also <a href="qtuitest-checkwidget.html#stateChanged">QtUiTest::CheckWidget::stateChanged</a>().</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> |
