<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html> <html lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <!-- toucheventsequence.qdoc --> <title>TouchEventSequence QML Type | Qt Quick 5.9</title> <link rel="stylesheet" type="text/css" href="style/offline-simple.css" /> <script type="text/javascript"> document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css"); // loading style sheet breaks anchors that were jumped to before // so force jumping to anchor again setTimeout(function() { var anchor = location.hash; // need to jump to different anchor first (e.g. none) location.hash = "#"; setTimeout(function() { location.hash = anchor; }, 0); }, 0); </script> </head> <body> <div class="header" id="qtdocheader"> <div class="main"> <div class="main-rounded"> <div class="navigationbar"> <table><tr> <td >Qt 5.9</td><td ><a href="qtquick-index.html">Qt Quick</a></td><td ><a href="qtquick-qmlmodule.html">QML Types</a></td><td >TouchEventSequence QML Type</td></tr></table><table class="buildversion"><tr> <td id="buildversion" width="100%" align="right">Qt 5.9.4 Reference Documentation</td> </tr></table> </div> </div> <div class="content"> <div class="line"> <div class="content mainContent"> <div class="sidebar"> <div class="toc"> <h3><a name="toc">Contents</a></h3> <ul> <li class="level1"><a href="#methods">Methods</a></li> <li class="level1"><a href="#details">Detailed Description</a></li> </ul> </div> <div class="sidebar-content" id="sidebar-content"></div></div> <h1 class="title">TouchEventSequence QML Type</h1> <span class="subtitle"></span> <!-- $$$TouchEventSequence-brief --> <p><a href="qml-qttest-toucheventsequence.html">TouchEventSequence</a> is used to build and dispatch touch events for testing. <a href="#details">More...</a></p> <!-- @@@TouchEventSequence --> <div class="table"><table class="alignedsummary"> <tr><td class="memItemLeft rightAlign topAlign"> Import Statement:</td><td class="memItemRight bottomAlign"> import QtTest 1.1</td></tr><tr><td class="memItemLeft rightAlign topAlign"> Since:</td><td class="memItemRight bottomAlign"> Qt 5.9</td></tr></table></div><ul> <li><a href="qml-qttest-toucheventsequence-members.html">List of all members, including inherited members</a></li> </ul> <a name="methods"></a> <h2 id="methods">Methods</h2> <ul> <li class="fn">TouchEventSequence <b><b><a href="qml-qttest-toucheventsequence.html#commit-method">commit</a></b></b>()</li> <li class="fn">TouchEventSequence <b><b><a href="qml-qttest-toucheventsequence.html#move-method">move</a></b></b>(int <i>touchId</i>, object <i>item</i>, real <i>x</i>, real <i>y</i>)</li> <li class="fn">TouchEventSequence <b><b><a href="qml-qttest-toucheventsequence.html#press-method">press</a></b></b>(int <i>touchId</i>, object <i>item</i>, real <i>x</i>, real <i>y</i>)</li> <li class="fn">TouchEventSequence <b><b><a href="qml-qttest-toucheventsequence.html#release-method">release</a></b></b>(int <i>touchId</i>, object <i>item</i>, real <i>x</i>, real <i>y</i>)</li> <li class="fn">TouchEventSequence <b><b><a href="qml-qttest-toucheventsequence.html#stationary-method">stationary</a></b></b>(int <i>touchId</i>)</li> </ul> <!-- $$$TouchEventSequence-description --> <a name="details"></a> <h2 id="details">Detailed Description</h2> <p>A <a href="qml-qttest-toucheventsequence.html">TouchEventSequence</a> is created by calling <a href="qml-qttest-testcase.html#touchEvent-method">TestCase.touchEvent()</a>. The type can not be directly instantiated. Each method provided by the type returns the same object, allowing chained calls.</p> <p>For example:</p> <pre class="cpp"> touchEvent(item)<span class="operator">.</span>press(<span class="number">0</span>)<span class="operator">.</span>commit(); </pre> <p>is equivalent to:</p> <pre class="cpp"> var sequence <span class="operator">=</span> touchEvent(item); sequence<span class="operator">.</span>press(<span class="number">0</span>); sequence<span class="operator">.</span>commit(); </pre> <p>Events are delivered to the window which contains the item specified in touchEvent.</p> <p><b>See also </b><a href="qml-qttest-testcase.html#touchEvent-method">TestCase::touchEvent()</a> and QTest::QTouchEventSequence.</p> <!-- @@@TouchEventSequence --> <h2>Method Documentation</h2> <!-- $$$commit --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="commit-method"> <td class="tblQmlFuncNode"><p> <a name="commit-method"></a><span class="type"><a href="qml-qttest-toucheventsequence.html">TouchEventSequence</a></span> <span class="name">commit</span>()</p></td></tr> </table></div> </div><div class="qmldoc"><p>Sends the touch event composed by prior use of <a href="qml-qttest-toucheventsequence.html#press-method">press()</a>, <a href="qml-qttest-toucheventsequence.html#move-method">move()</a>, <a href="qml-qttest-toucheventsequence.html#release-method">release()</a>, and <a href="qml-qttest-toucheventsequence.html#stationary-method">stationary()</a>. Following commit's return, the <a href="qml-qttest-toucheventsequence.html">TouchEventSequence</a> can be used to compose a new event.</p> <pre class="cpp"> var sequence <span class="operator">=</span> touchEvent(target); <span class="comment">// Touch the middle of target with 1 point</span> sequence<span class="operator">.</span>press(<span class="number">1</span>); sequence<span class="operator">.</span>commit(); <span class="comment">// Begin a new event</span> <span class="comment">// Move the point to target's upper left corner</span> sequence<span class="operator">.</span>move(<span class="number">1</span><span class="operator">,</span> target<span class="operator">,</span> <span class="number">0</span><span class="operator">,</span> <span class="number">0</span>); sequence<span class="operator">.</span>commit(); </pre> <p>Commit is automatically invoked when the <a href="qml-qttest-toucheventsequence.html">TouchEventSequence</a> object is destroyed.</p> </div></div><!-- @@@commit --> <br/> <!-- $$$move --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="move-method"> <td class="tblQmlFuncNode"><p> <a name="move-method"></a><span class="type"><a href="qml-qttest-toucheventsequence.html">TouchEventSequence</a></span> <span class="name">move</span>(<span class="type">int</span> <i>touchId</i>, <span class="type">object</span> <i>item</i>, <span class="type">real</span> <i>x</i> = item.width / 2, <span class="type">real</span> <i>y</i> = item.height / 2)</p></td></tr> </table></div> </div><div class="qmldoc"><p>Moves <i>touchId</i> to the point indicated by <i>x</i> and <i>y</i> relative to <i>item</i>.</p> <p>Item defaults to the value provided via touchEvent(). X and y default to the midpoint of the item.</p> </div></div><!-- @@@move --> <br/> <!-- $$$press --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="press-method"> <td class="tblQmlFuncNode"><p> <a name="press-method"></a><span class="type"><a href="qml-qttest-toucheventsequence.html">TouchEventSequence</a></span> <span class="name">press</span>(<span class="type">int</span> <i>touchId</i>, <span class="type">object</span> <i>item</i>, <span class="type">real</span> <i>x</i> = item.width / 2, <span class="type">real</span> <i>y</i> = item.height / 2)</p></td></tr> </table></div> </div><div class="qmldoc"><p>Creates a new point identified as <i>touchId</i>, at the point indicated by <i>x</i> and <i>y</i> relative to <i>item</i>. Further use of the same touch point should maintain the same touchId.</p> <p>Item defaults to the value provided via touchEvent(). X and y default to the midpoint of the item.</p> </div></div><!-- @@@press --> <br/> <!-- $$$release --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="release-method"> <td class="tblQmlFuncNode"><p> <a name="release-method"></a><span class="type"><a href="qml-qttest-toucheventsequence.html">TouchEventSequence</a></span> <span class="name">release</span>(<span class="type">int</span> <i>touchId</i>, <span class="type">object</span> <i>item</i>, <span class="type">real</span> <i>x</i> = item.width / 2, <span class="type">real</span> <i>y</i> = item.height / 2)</p></td></tr> </table></div> </div><div class="qmldoc"><p>Removes <i>touchId</i> at the point indicated by <i>x</i> and <i>y</i> relative to <i>item</i>.</p> <p>Item defaults to the value provided via touchEvent(). X and y default to the midpoint of the item.</p> </div></div><!-- @@@release --> <br/> <!-- $$$stationary --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="stationary-method"> <td class="tblQmlFuncNode"><p> <a name="stationary-method"></a><span class="type"><a href="qml-qttest-toucheventsequence.html">TouchEventSequence</a></span> <span class="name">stationary</span>(<span class="type">int</span> <i>touchId</i>)</p></td></tr> </table></div> </div><div class="qmldoc"><p>Indicates that <i>touchId</i> is present but otherwise unchanged from prior events.</p> </div></div><!-- @@@stationary --> <br/> </div> </div> </div> </div> </div> <div class="footer"> <p> <acronym title="Copyright">©</acronym> 2017 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners.<br> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br> Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners. </p> </div> </body> </html>