<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qitemmodelscatterdataproxy.cpp -->
<title>ItemModelScatterDataProxy QML Type | Qt Data Visualization 5.12.6</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.12</td><td ><a href="qtdatavisualization-index.html">Qt Data Visualization</a></td><td ><a href="qtdatavisualization-qmlmodule.html">QML Types</a></td><td >ItemModelScatterDataProxy QML Type</td></tr></table><table class="buildversion"><tr>
<td id="buildversion" width="100%" align="right"><a href="qtdatavisualization-index.html">Qt Data Visualization | Commercial or GPLv3</a></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">ItemModelScatterDataProxy QML Type</h1>
<span class="subtitle"></span>
<!-- $$$ItemModelScatterDataProxy-brief -->
<p>Proxy class for presenting data in item models with <a href="qml-qtdatavisualization-scatter3d.html">Scatter3D</a>. <a href="#details">More...</a></p>
<!-- @@@ItemModelScatterDataProxy -->
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> Import Statement:</td><td class="memItemRight bottomAlign"> import QtDataVisualization 1.2</td></tr><tr><td class="memItemLeft rightAlign topAlign"> Since:</td><td class="memItemRight bottomAlign"> QtDataVisualization 1.0</td></tr><tr><td class="memItemLeft rightAlign topAlign"> Instantiates:</td><td class="memItemRight bottomAlign"> <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html"><a href="qitemmodelscatterdataproxy.html">QItemModelScatterDataProxy</a></td></tr><tr><td class="memItemLeft rightAlign topAlign"> Inherits:</td><td class="memItemRight bottomAlign"> <p><a href="qml-qtdatavisualization-scatterdataproxy.html">ScatterDataProxy</a></p>
</td></tr></table></div><ul>
<li><a href="qml-qtdatavisualization-itemmodelscatterdataproxy-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-qtdatavisualization-itemmodelscatterdataproxy.html#itemModel-prop">itemModel</a></b></b> : model</li>
<li class="fn"><b><b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#rotationRole-prop">rotationRole</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#rotationRolePattern-prop">rotationRolePattern</a></b></b> : regExp</li>
<li class="fn"><b><b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#rotationRoleReplace-prop">rotationRoleReplace</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#xPosRole-prop">xPosRole</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#xPosRolePattern-prop">xPosRolePattern</a></b></b> : regExp</li>
<li class="fn"><b><b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#xPosRoleReplace-prop">xPosRoleReplace</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#yPosRole-prop">yPosRole</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#yPosRolePattern-prop">yPosRolePattern</a></b></b> : regExp</li>
<li class="fn"><b><b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#yPosRoleReplace-prop">yPosRoleReplace</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#zPosRole-prop">zPosRole</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#zPosRolePattern-prop">zPosRolePattern</a></b></b> : regExp</li>
<li class="fn"><b><b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#zPosRoleReplace-prop">zPosRoleReplace</a></b></b> : string</li>
</ul>
<!-- $$$ItemModelScatterDataProxy-description -->
<a name="details"></a>
<h2 id="details">Detailed Description</h2>
<p>This type allows you to use AbstractItemModel derived models as a data source for <a href="qml-qtdatavisualization-scatter3d.html">Scatter3D</a>.</p>
<p>The data is resolved asynchronously whenever the mapping or the model changes. <a href="qscatterdataproxy.html#arrayReset">QScatterDataProxy::arrayReset()</a> is emitted when the data has been resolved.</p>
<p>For more details, see <a href="qitemmodelscatterdataproxy.html">QItemModelScatterDataProxy</a> documentation.</p>
<p>Usage example:</p>
<pre class="cpp">
ItemModelScatterDataProxy {
itemModel: model <span class="comment">// E.g. a list model defined elsewhere containing point coordinates.</span>
<span class="comment">// Mapping model roles to scatter series item coordinates.</span>
xPosRole: <span class="string">"xPos"</span>
yPosRole: <span class="string">"yPos"</span>
zPosRole: <span class="string">"zPos"</span>
}
</pre>
<p><b>See also </b><a href="qml-qtdatavisualization-scatterdataproxy.html">ScatterDataProxy</a> and <a href="qtdatavisualization-data-handling.html">Qt Data Visualization Data Handling</a>.</p>
<!-- @@@ItemModelScatterDataProxy -->
<h2>Property Documentation</h2>
<!-- $$$itemModel -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="itemModel-prop">
<td class="tblQmlPropNode"><p>
<a name="itemModel-prop"></a><span class="name">itemModel</span> : <span class="type">model</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>The item model to use as a data source for <a href="qml-qtdatavisualization-scatter3d.html">Scatter3D</a>.</p>
</div></div><!-- @@@itemModel -->
<br/>
<!-- $$$rotationRole -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="rotationRole-prop">
<td class="tblQmlPropNode"><p>
<a name="rotationRole-prop"></a><span class="name">rotationRole</span> : <span class="type">string</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>The item model role to map into item rotation. The model may supply the value for rotation as either variant that is directly convertible to quaternion, or as one of the string representations: <code>"scalar,x,y,z"</code> or <code>"@angle,x,y,z"</code>. The first format will construct the quaternion directly with given values, and the second one will construct the quaternion using QQuaternion::fromAxisAndAngle() method.</p>
</div></div><!-- @@@rotationRole -->
<br/>
<!-- $$$rotationRolePattern -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="rotationRolePattern-prop">
<td class="tblQmlPropNode"><p>
<a name="rotationRolePattern-prop"></a><span class="name">rotationRolePattern</span> : <span class="type">regExp</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>When set, a search and replace is done on the value mapped by the rotation role before it is used as item rotation. This property specifies the regular expression to find the portion of the mapped value to replace and <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#rotationRoleReplace-prop">rotationRoleReplace</a> property contains the replacement string.</p>
<p><b>See also </b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#rotationRole-prop">rotationRole</a> and <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#rotationRoleReplace-prop">rotationRoleReplace</a>.</p>
</div></div><!-- @@@rotationRolePattern -->
<br/>
<!-- $$$rotationRoleReplace -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="rotationRoleReplace-prop">
<td class="tblQmlPropNode"><p>
<a name="rotationRoleReplace-prop"></a><span class="name">rotationRoleReplace</span> : <span class="type">string</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>This property defines the replace content to be used in conjunction with <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#rotationRolePattern-prop">rotationRolePattern</a>. Defaults to an empty string. For more information on how the search and replace using regular expressions works, see QString::replace(const QRegExp &rx, const QString &after) function documentation.</p>
<p><b>See also </b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#rotationRole-prop">rotationRole</a> and <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#rotationRolePattern-prop">rotationRolePattern</a>.</p>
</div></div><!-- @@@rotationRoleReplace -->
<br/>
<!-- $$$xPosRole -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="xPosRole-prop">
<td class="tblQmlPropNode"><p>
<a name="xPosRole-prop"></a><span class="name">xPosRole</span> : <span class="type">string</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>The item model role to map into the X position.</p>
</div></div><!-- @@@xPosRole -->
<br/>
<!-- $$$xPosRolePattern -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="xPosRolePattern-prop">
<td class="tblQmlPropNode"><p>
<a name="xPosRolePattern-prop"></a><span class="name">xPosRolePattern</span> : <span class="type">regExp</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>When set, a search and replace is done on the value mapped by the x position role before it is used as an item position value. This property specifies the regular expression to find the portion of the mapped value to replace and <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#xPosRoleReplace-prop">xPosRoleReplace</a> property contains the replacement string.</p>
<p><b>See also </b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#xPosRole-prop">xPosRole</a> and <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#xPosRoleReplace-prop">xPosRoleReplace</a>.</p>
</div></div><!-- @@@xPosRolePattern -->
<br/>
<!-- $$$xPosRoleReplace -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="xPosRoleReplace-prop">
<td class="tblQmlPropNode"><p>
<a name="xPosRoleReplace-prop"></a><span class="name">xPosRoleReplace</span> : <span class="type">string</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>This property defines the replace content to be used in conjunction with <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#xPosRolePattern-prop">xPosRolePattern</a>. Defaults to an empty string. For more information on how the search and replace using regular expressions works, see QString::replace(const QRegExp &rx, const QString &after) function documentation.</p>
<p><b>See also </b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#xPosRole-prop">xPosRole</a> and <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#xPosRolePattern-prop">xPosRolePattern</a>.</p>
</div></div><!-- @@@xPosRoleReplace -->
<br/>
<!-- $$$yPosRole -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="yPosRole-prop">
<td class="tblQmlPropNode"><p>
<a name="yPosRole-prop"></a><span class="name">yPosRole</span> : <span class="type">string</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>The item model role to map into the Y position.</p>
</div></div><!-- @@@yPosRole -->
<br/>
<!-- $$$yPosRolePattern -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="yPosRolePattern-prop">
<td class="tblQmlPropNode"><p>
<a name="yPosRolePattern-prop"></a><span class="name">yPosRolePattern</span> : <span class="type">regExp</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>When set, a search and replace is done on the value mapped by the y position role before it is used as an item position value. This property specifies the regular expression to find the portion of the mapped value to replace and <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#yPosRoleReplace-prop">yPosRoleReplace</a> property contains the replacement string.</p>
<p><b>See also </b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#yPosRole-prop">yPosRole</a> and <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#yPosRoleReplace-prop">yPosRoleReplace</a>.</p>
</div></div><!-- @@@yPosRolePattern -->
<br/>
<!-- $$$yPosRoleReplace -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="yPosRoleReplace-prop">
<td class="tblQmlPropNode"><p>
<a name="yPosRoleReplace-prop"></a><span class="name">yPosRoleReplace</span> : <span class="type">string</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>This property defines the replace content to be used in conjunction with <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#yPosRolePattern-prop">yPosRolePattern</a>. Defaults to an empty string. For more information on how the search and replace using regular expressions works, see QString::replace(const QRegExp &rx, const QString &after) function documentation.</p>
<p><b>See also </b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#yPosRole-prop">yPosRole</a> and <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#yPosRolePattern-prop">yPosRolePattern</a>.</p>
</div></div><!-- @@@yPosRoleReplace -->
<br/>
<!-- $$$zPosRole -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="zPosRole-prop">
<td class="tblQmlPropNode"><p>
<a name="zPosRole-prop"></a><span class="name">zPosRole</span> : <span class="type">string</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>The item model role to map into the Z position.</p>
</div></div><!-- @@@zPosRole -->
<br/>
<!-- $$$zPosRolePattern -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="zPosRolePattern-prop">
<td class="tblQmlPropNode"><p>
<a name="zPosRolePattern-prop"></a><span class="name">zPosRolePattern</span> : <span class="type">regExp</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>When set, a search and replace is done on the value mapped by the z position role before it is used as an item position value. This property specifies the regular expression to find the portion of the mapped value to replace and <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#zPosRoleReplace-prop">zPosRoleReplace</a> property contains the replacement string.</p>
<p><b>See also </b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#zPosRole-prop">zPosRole</a> and <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#zPosRoleReplace-prop">zPosRoleReplace</a>.</p>
</div></div><!-- @@@zPosRolePattern -->
<br/>
<!-- $$$zPosRoleReplace -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="zPosRoleReplace-prop">
<td class="tblQmlPropNode"><p>
<a name="zPosRoleReplace-prop"></a><span class="name">zPosRoleReplace</span> : <span class="type">string</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>This property defines the replace content to be used in conjunction with <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#zPosRolePattern-prop">zPosRolePattern</a>. Defaults to an empty string. For more information on how the search and replace using regular expressions works, see QString::replace(const QRegExp &rx, const QString &after) function documentation.</p>
<p><b>See also </b><a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#zPosRole-prop">zPosRole</a> and <a href="qml-qtdatavisualization-itemmodelscatterdataproxy.html#zPosRolePattern-prop">zPosRolePattern</a>.</p>
</div></div><!-- @@@zPosRoleReplace -->
<br/>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2019 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>
