Sophie

Sophie

distrib > Mageia > 6 > x86_64 > media > core-updates > by-pkgid > 19952c5e751bf7e3108c3c59625b0f35 > files > 232

qtcharts5-doc-5.9.4-1.mga6.noarch.rpm

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qvpiemodelmapper.cpp -->
  <title>VPieModelMapper QML Type | Qt Charts 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="qtcharts-index.html">Qt Charts</a></td><td ><a href="qtcharts-qmlmodule.html">QML Types</a></td><td >VPieModelMapper 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">VPieModelMapper QML Type</h1>
<span class="subtitle"></span>
<!-- $$$VPieModelMapper-brief -->
<p>Vertical model mapper for pie series. <a href="#details">More...</a></p>
<!-- @@@VPieModelMapper -->
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> Import Statement:</td><td class="memItemRight bottomAlign"> import QtCharts 2.2</td></tr><tr><td class="memItemLeft rightAlign topAlign"> Instantiates:</td><td class="memItemRight bottomAlign"> <a href="qml-qtcharts-vpiemodelmapper.html"><a href="qvpiemodelmapper.html">QVPieModelMapper</a></td></tr></table></div><ul>
<li><a href="qml-qtcharts-vpiemodelmapper-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-qtcharts-vpiemodelmapper.html#firstRow-prop">firstRow</a></b></b> : int</li>
<li class="fn"><b><b><a href="qml-qtcharts-vpiemodelmapper.html#labelsColumn-prop">labelsColumn</a></b></b> : int</li>
<li class="fn"><b><b><a href="qml-qtcharts-vpiemodelmapper.html#model-prop">model</a></b></b> : SomeModel</li>
<li class="fn"><b><b><a href="qml-qtcharts-vpiemodelmapper.html#rowCount-prop">rowCount</a></b></b> : int</li>
<li class="fn"><b><b><a href="qml-qtcharts-vpiemodelmapper.html#series-prop">series</a></b></b> : PieSeries</li>
<li class="fn"><b><b><a href="qml-qtcharts-vpiemodelmapper.html#valuesColumn-prop">valuesColumn</a></b></b> : int</li>
</ul>
<!-- $$$VPieModelMapper-description -->
<a name="details"></a>
<h2 id="details">Detailed Description</h2>
<p>Model mappers enable using a data model derived from the QAbstractItemModel class as a data source for a chart. A vertical model mapper is used to create a connection between a data model and <a href="qml-qtcharts-pieseries.html">PieSeries</a>, so that each row in the data model defines a pie slice and each column maps to the label or the value of the pie slice.</p>
<p>Both model and pie series properties can be used to manipulate the data. The model mapper keeps the pie series and the data model in sync.</p>
<p>The following QML example creates a pie series with four slices (assuming the model has at least five rows). Each slice gets a label from column 1 and a value from column 2.</p>
<pre class="cpp">

  VPieModelMapper {
      series: pieSeries
      model: customModel
      labelsColumn: <span class="number">1</span>
      valuesColumn: <span class="number">2</span>
      firstRow: <span class="number">1</span>
      rowCount: <span class="number">4</span>
  }

</pre>
<!-- @@@VPieModelMapper -->
<h2>Property Documentation</h2>
<!-- $$$firstRow -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="firstRow-prop">
<td class="tblQmlPropNode"><p>
<a name="firstRow-prop"></a><span class="name">firstRow</span> : <span class="type">int</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>The row of the model that contains the first slice value. The default value is 0.</p>
</div></div><!-- @@@firstRow -->
<br/>
<!-- $$$labelsColumn -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="labelsColumn-prop">
<td class="tblQmlPropNode"><p>
<a name="labelsColumn-prop"></a><span class="name">labelsColumn</span> : <span class="type">int</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>The column of the model that is kept in sync with the labels of the pie's slices. The default value is -1 (invalid mapping).</p>
</div></div><!-- @@@labelsColumn -->
<br/>
<!-- $$$model -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="model-prop">
<td class="tblQmlPropNode"><p>
<a name="model-prop"></a><span class="name">model</span> : <span class="type">SomeModel</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>The QAbstractItemModel based model that is used by the mapper. You need to implement the model and expose it to QML.</p>
<p><b>Note: </b>The model has to support adding and removing rows or columns and modifying the data in the cells.</p></div></div><!-- @@@model -->
<br/>
<!-- $$$rowCount -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="rowCount-prop">
<td class="tblQmlPropNode"><p>
<a name="rowCount-prop"></a><span class="name">rowCount</span> : <span class="type">int</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>The number of rows of the model that are mapped as the data for a pie series. The default value is -1 (number limited by the number of rows in the model).</p>
</div></div><!-- @@@rowCount -->
<br/>
<!-- $$$series -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="series-prop">
<td class="tblQmlPropNode"><p>
<a name="series-prop"></a><span class="name">series</span> : <span class="type"><a href="qml-qtcharts-pieseries.html">PieSeries</a></span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>The pie series that is used by the mapper. If you define the mapper element as a child for a <a href="qml-qtcharts-pieseries.html">PieSeries</a>, leave this property undefined. All the data in the series is discarded when it is set to the mapper. When new series is specified the old series is disconnected (but it preserves its data).</p>
</div></div><!-- @@@series -->
<br/>
<!-- $$$valuesColumn -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="valuesColumn-prop">
<td class="tblQmlPropNode"><p>
<a name="valuesColumn-prop"></a><span class="name">valuesColumn</span> : <span class="type">int</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>The column of the model that is kept in sync with the values of the pie's slices. The default value is -1 (invalid mapping).</p>
</div></div><!-- @@@valuesColumn -->
<br/>
        </div>
       </div>
   </div>
   </div>
</div>
<div class="footer">
   <p>
   <acronym title="Copyright">&copy;</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>