<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html> <html lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <!-- qquickpincharea.cpp --> <title>PinchEvent 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 >PinchEvent 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="#properties">Properties</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">PinchEvent QML Type</h1> <span class="subtitle"></span> <!-- $$$PinchEvent-brief --> <p>For specifying information about a pinch event <a href="#details">More...</a></p> <!-- @@@PinchEvent --> <div class="table"><table class="alignedsummary"> <tr><td class="memItemLeft rightAlign topAlign"> Import Statement:</td><td class="memItemRight bottomAlign"> import QtQuick 2.7</td></tr></table></div><ul> <li><a href="qml-qtquick-pinchevent-members.html">List of all members, including inherited members</a></li> </ul> <a name="properties"></a> <h2 id="properties">Properties</h2> <ul> <li class="fn"><b><b><a href="qml-qtquick-pinchevent.html#accepted-prop">accepted</a></b></b> : bool</li> <li class="fn"><b><b><a href="qml-qtquick-pinchevent.html#angle-prop">angle</a></b></b> : real</li> <li class="fn"><b><b><a href="qml-qtquick-pinchevent.html#center-prop">center</a></b></b> : QPointF</li> <li class="fn"><b><b><a href="qml-qtquick-pinchevent.html#point1-prop">point1</a></b></b> : QPointF</li> <li class="fn"><b><b><a href="qml-qtquick-pinchevent.html#point2-prop">point2</a></b></b> : QPointF</li> <li class="fn"><b><b><a href="qml-qtquick-pinchevent.html#pointCount-prop">pointCount</a></b></b> : int</li> <li class="fn"><b><b><a href="qml-qtquick-pinchevent.html#previousAngle-prop">previousAngle</a></b></b> : real</li> <li class="fn"><b><b><a href="qml-qtquick-pinchevent.html#previousCenter-prop">previousCenter</a></b></b> : QPointF</li> <li class="fn"><b><b><a href="qml-qtquick-pinchevent.html#previousScale-prop">previousScale</a></b></b> : real</li> <li class="fn"><b><b><a href="qml-qtquick-pinchevent.html#rotation-prop">rotation</a></b></b> : real</li> <li class="fn"><b><b><a href="qml-qtquick-pinchevent.html#scale-prop">scale</a></b></b> : real</li> <li class="fn"><b><b><a href="qml-qtquick-pinchevent.html#startCenter-prop">startCenter</a></b></b> : QPointF</li> <li class="fn"><b><b><a href="qml-qtquick-pinchevent.html#startPoint1-prop">startPoint1</a></b></b> : QPointF</li> <li class="fn"><b><b><a href="qml-qtquick-pinchevent.html#startPoint2-prop">startPoint2</a></b></b> : QPointF</li> </ul> <!-- $$$PinchEvent-description --> <a name="details"></a> <h2 id="details">Detailed Description</h2> <p><b>The <a href="qml-qtquick-pinchevent.html">PinchEvent</a> type was added in <a href="qtquick-module.html">QtQuick</a> 1.1</b></p> <p>The <code>center</code>, <code>startCenter</code>, <code>previousCenter</code> properties provide the center position between the two touch points.</p> <p>The <code>scale</code> and <code>previousScale</code> properties provide the scale factor.</p> <p>The <code>angle</code>, <code>previousAngle</code> and <code>rotation</code> properties provide the angle between the two points and the amount of rotation.</p> <p>The <code>point1</code>, <code>point2</code>, <code>startPoint1</code>, <code>startPoint2</code> properties provide the positions of the touch points.</p> <p>The <code>accepted</code> property may be set to false in the <code>onPinchStarted</code> handler if the gesture should not be handled.</p> <p><b>See also </b><a href="qml-qtquick-pincharea.html">PinchArea</a>.</p> <!-- @@@PinchEvent --> <h2>Property Documentation</h2> <!-- $$$accepted --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="accepted-prop"> <td class="tblQmlPropNode"><p> <a name="accepted-prop"></a><span class="name">accepted</span> : <span class="type">bool</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>Setting this property to false in the <code>PinchArea::onPinchStarted</code> handler will result in no further pinch events being generated, and the gesture ignored.</p> </div></div><!-- @@@accepted --> <br/> <!-- $$$angle --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="angle-prop"> <td class="tblQmlPropNode"><p> <a name="angle-prop"></a><span class="name">angle</span> : <span class="type">real</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the angle between the two touch points.</p> <ul> <li><code>angle</code> is the current angle between the two points in the range -180 to 180.</li> <li><code>previousAngle</code> is the angle of the previous event.</li> <li><code>rotation</code> is the total rotation since the pinch gesture started.</li> </ul> <p>When a pinch gesture is started, the rotation is <code>0.0</code>.</p> </div></div><!-- @@@angle --> <br/> <!-- $$$center --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="center-prop"> <td class="tblQmlPropNode"><p> <a name="center-prop"></a><span class="name">center</span> : <span class="type">QPointF</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the position of the center point between the two touch points.</p> <ul> <li><code>center</code> is the current center point</li> <li><code>previousCenter</code> is the center point of the previous event.</li> <li><code>startCenter</code> is the center point when the gesture began</li> </ul> </div></div><!-- @@@center --> <br/> <!-- $$$point1 --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="point1-prop"> <td class="tblQmlPropNode"><p> <a name="point1-prop"></a><span class="name">point1</span> : <span class="type">QPointF</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties provide the actual touch points generating the pinch.</p> <ul> <li><code>point1</code> and <code>point2</code> hold the current positions of the points.</li> <li><code>startPoint1</code> and <code>startPoint2</code> hold the positions of the points when the second point was touched.</li> </ul> </div></div><!-- @@@point1 --> <br/> <!-- $$$point2 --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="point2-prop"> <td class="tblQmlPropNode"><p> <a name="point2-prop"></a><span class="name">point2</span> : <span class="type">QPointF</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties provide the actual touch points generating the pinch.</p> <ul> <li><code>point1</code> and <code>point2</code> hold the current positions of the points.</li> <li><code>startPoint1</code> and <code>startPoint2</code> hold the positions of the points when the second point was touched.</li> </ul> </div></div><!-- @@@point2 --> <br/> <!-- $$$pointCount --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="pointCount-prop"> <td class="tblQmlPropNode"><p> <a name="pointCount-prop"></a><span class="name">pointCount</span> : <span class="type">int</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>Holds the number of points currently touched. The <a href="qml-qtquick-pincharea.html">PinchArea</a> will not react until two touch points have initited a gesture, but will remain active until all touch points have been released.</p> </div></div><!-- @@@pointCount --> <br/> <!-- $$$previousAngle --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="previousAngle-prop"> <td class="tblQmlPropNode"><p> <a name="previousAngle-prop"></a><span class="name">previousAngle</span> : <span class="type">real</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the angle between the two touch points.</p> <ul> <li><code>angle</code> is the current angle between the two points in the range -180 to 180.</li> <li><code>previousAngle</code> is the angle of the previous event.</li> <li><code>rotation</code> is the total rotation since the pinch gesture started.</li> </ul> <p>When a pinch gesture is started, the rotation is <code>0.0</code>.</p> </div></div><!-- @@@previousAngle --> <br/> <!-- $$$previousCenter --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="previousCenter-prop"> <td class="tblQmlPropNode"><p> <a name="previousCenter-prop"></a><span class="name">previousCenter</span> : <span class="type">QPointF</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the position of the center point between the two touch points.</p> <ul> <li><code>center</code> is the current center point</li> <li><code>previousCenter</code> is the center point of the previous event.</li> <li><code>startCenter</code> is the center point when the gesture began</li> </ul> </div></div><!-- @@@previousCenter --> <br/> <!-- $$$previousScale --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="previousScale-prop"> <td class="tblQmlPropNode"><p> <a name="previousScale-prop"></a><span class="name">previousScale</span> : <span class="type">real</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the scale factor determined by the change in distance between the two touch points.</p> <ul> <li><code>scale</code> is the current scale factor.</li> <li><code>previousScale</code> is the scale factor of the previous event.</li> </ul> <p>When a pinch gesture is started, the scale is <code>1.0</code>.</p> </div></div><!-- @@@previousScale --> <br/> <!-- $$$rotation --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="rotation-prop"> <td class="tblQmlPropNode"><p> <a name="rotation-prop"></a><span class="name">rotation</span> : <span class="type">real</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the angle between the two touch points.</p> <ul> <li><code>angle</code> is the current angle between the two points in the range -180 to 180.</li> <li><code>previousAngle</code> is the angle of the previous event.</li> <li><code>rotation</code> is the total rotation since the pinch gesture started.</li> </ul> <p>When a pinch gesture is started, the rotation is <code>0.0</code>.</p> </div></div><!-- @@@rotation --> <br/> <!-- $$$scale --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="scale-prop"> <td class="tblQmlPropNode"><p> <a name="scale-prop"></a><span class="name">scale</span> : <span class="type">real</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the scale factor determined by the change in distance between the two touch points.</p> <ul> <li><code>scale</code> is the current scale factor.</li> <li><code>previousScale</code> is the scale factor of the previous event.</li> </ul> <p>When a pinch gesture is started, the scale is <code>1.0</code>.</p> </div></div><!-- @@@scale --> <br/> <!-- $$$startCenter --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="startCenter-prop"> <td class="tblQmlPropNode"><p> <a name="startCenter-prop"></a><span class="name">startCenter</span> : <span class="type">QPointF</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties hold the position of the center point between the two touch points.</p> <ul> <li><code>center</code> is the current center point</li> <li><code>previousCenter</code> is the center point of the previous event.</li> <li><code>startCenter</code> is the center point when the gesture began</li> </ul> </div></div><!-- @@@startCenter --> <br/> <!-- $$$startPoint1 --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="startPoint1-prop"> <td class="tblQmlPropNode"><p> <a name="startPoint1-prop"></a><span class="name">startPoint1</span> : <span class="type">QPointF</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties provide the actual touch points generating the pinch.</p> <ul> <li><code>point1</code> and <code>point2</code> hold the current positions of the points.</li> <li><code>startPoint1</code> and <code>startPoint2</code> hold the positions of the points when the second point was touched.</li> </ul> </div></div><!-- @@@startPoint1 --> <br/> <!-- $$$startPoint2 --> <div class="qmlitem"><div class="qmlproto"> <div class="table"><table class="qmlname"> <tr valign="top" class="odd" id="startPoint2-prop"> <td class="tblQmlPropNode"><p> <a name="startPoint2-prop"></a><span class="name">startPoint2</span> : <span class="type">QPointF</span></p></td></tr> </table></div> </div><div class="qmldoc"><p>These properties provide the actual touch points generating the pinch.</p> <ul> <li><code>point1</code> and <code>point2</code> hold the current positions of the points.</li> <li><code>startPoint1</code> and <code>startPoint2</code> hold the positions of the points when the second point was touched.</li> </ul> </div></div><!-- @@@startPoint2 --> <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>