<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html> <html lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <!-- qtcharts.qdoc --> <title>Qt Charts C++ Classes | Qt Charts 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="qtcharts-index.html">Qt Charts</a></td><td >Qt Charts C++ Classes</td></tr></table><table class="buildversion"><tr> <td id="buildversion" width="100%" align="right"><a href="qtcharts-index.html">Qt Charts | 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="#classes">Classes</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">Qt Charts C++ Classes</h1> <span class="subtitle"></span> <!-- $$$QtCharts-brief --> <p>C++ classes for the Qt Charts API. <a href="#details">More...</a></p> <!-- @@@QtCharts --> <a name="classes"></a> <h2 id="classes">Classes</h2> <div class="table"><table class="annotated"> <tr class="odd topAlign"><td class="tblName"><p><a href="qabstractaxis.html">QAbstractAxis</a></p></td><td class="tblDescr"><p>Base class used for specialized axis classes</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qabstractbarseries.html">QAbstractBarSeries</a></p></td><td class="tblDescr"><p>Abstract parent class for all bar series classes</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qabstractseries.html">QAbstractSeries</a></p></td><td class="tblDescr"><p>Base class for all Qt Chart series</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qarealegendmarker.html">QAreaLegendMarker</a></p></td><td class="tblDescr"><p>Legend marker for an area series</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qareaseries.html">QAreaSeries</a></p></td><td class="tblDescr"><p>Presents data in area charts</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qbarcategoryaxis.html">QBarCategoryAxis</a></p></td><td class="tblDescr"><p>Adds categories to a chart's axes</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qbarlegendmarker.html">QBarLegendMarker</a></p></td><td class="tblDescr"><p>Legend marker for a bar series</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qbarseries.html">QBarSeries</a></p></td><td class="tblDescr"><p>Presents a series of data as vertical bars grouped by category</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qbarset.html">QBarSet</a></p></td><td class="tblDescr"><p>Represents one set of bars in a bar chart</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qboxplotlegendmarker.html">QBoxPlotLegendMarker</a></p></td><td class="tblDescr"><p>Legend marker for a box plot series</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qboxplotseries.html">QBoxPlotSeries</a></p></td><td class="tblDescr"><p>Presents data in box-and-whiskers charts</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qboxset.html">QBoxSet</a></p></td><td class="tblDescr"><p>Represents one item in a box-and-whiskers chart</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qcandlesticklegendmarker.html">QCandlestickLegendMarker</a></p></td><td class="tblDescr"><p>Legend marker for a candlestick series</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qcandlestickmodelmapper.html">QCandlestickModelMapper</a></p></td><td class="tblDescr"><p>Abstract model mapper class for candlestick series</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qcandlestickseries.html">QCandlestickSeries</a></p></td><td class="tblDescr"><p>Presents data as candlesticks</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qcandlestickset.html">QCandlestickSet</a></p></td><td class="tblDescr"><p>Represents a single candlestick item in a candlestick chart</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qcategoryaxis.html">QCategoryAxis</a></p></td><td class="tblDescr"><p>Places named ranges on the axis</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qchart.html">QChart</a></p></td><td class="tblDescr"><p>Manages the graphical representation of the chart's series, legends, and axes</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qchartview.html">QChartView</a></p></td><td class="tblDescr"><p>Standalone widget that can display charts</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qdatetimeaxis.html">QDateTimeAxis</a></p></td><td class="tblDescr"><p>Adds dates and times to a chart's axis</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qhbarmodelmapper.html">QHBarModelMapper</a></p></td><td class="tblDescr"><p>Horizontal model mapper for bar series</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qhboxplotmodelmapper.html">QHBoxPlotModelMapper</a></p></td><td class="tblDescr"><p>Horizontal model mapper for box plot series</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qhcandlestickmodelmapper.html">QHCandlestickModelMapper</a></p></td><td class="tblDescr"><p>Horizontal model mapper for a candlestick series</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qhpiemodelmapper.html">QHPieModelMapper</a></p></td><td class="tblDescr"><p>Horizontal model mapper for pie series</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qhxymodelmapper.html">QHXYModelMapper</a></p></td><td class="tblDescr"><p>Horizontal model mapper for line, spline, and scatter series</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qhorizontalbarseries.html">QHorizontalBarSeries</a></p></td><td class="tblDescr"><p>Presents a series of data as horizontal bars grouped by category</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qhorizontalpercentbarseries.html">QHorizontalPercentBarSeries</a></p></td><td class="tblDescr"><p>Presents a series of categorized data as a percentage of each category</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qhorizontalstackedbarseries.html">QHorizontalStackedBarSeries</a></p></td><td class="tblDescr"><p>Presents a series of data as horizontally stacked bars, with one bar per category</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qlegend.html">QLegend</a></p></td><td class="tblDescr"><p>Displays the legend of a chart</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qlegendmarker.html">QLegendMarker</a></p></td><td class="tblDescr"><p>Abstract object that can be used to access markers within a legend</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qlineseries.html">QLineSeries</a></p></td><td class="tblDescr"><p>Presents data in line charts</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qlogvalueaxis.html">QLogValueAxis</a></p></td><td class="tblDescr"><p>Adds a logarithmic scale to a chart's axis</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qpercentbarseries.html">QPercentBarSeries</a></p></td><td class="tblDescr"><p>Presents a series of categorized data as a percentage of each category</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qpielegendmarker.html">QPieLegendMarker</a></p></td><td class="tblDescr"><p>Legend marker for a pie series</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qpieseries.html">QPieSeries</a></p></td><td class="tblDescr"><p>Presents data in pie charts</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qpieslice.html">QPieSlice</a></p></td><td class="tblDescr"><p>Represents a single slice in a pie series</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qpolarchart.html">QPolarChart</a></p></td><td class="tblDescr"><p>Presents data in polar charts</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qscatterseries.html">QScatterSeries</a></p></td><td class="tblDescr"><p>Presents data in scatter charts</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qsplineseries.html">QSplineSeries</a></p></td><td class="tblDescr"><p>Presents data as spline charts</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qstackedbarseries.html">QStackedBarSeries</a></p></td><td class="tblDescr"><p>Presents a series of data as vertically stacked bars, with one bar per category</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qvbarmodelmapper.html">QVBarModelMapper</a></p></td><td class="tblDescr"><p>Vertical model mapper for bar series</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qvboxplotmodelmapper.html">QVBoxPlotModelMapper</a></p></td><td class="tblDescr"><p>Vertical model mapper for box plot series</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qvcandlestickmodelmapper.html">QVCandlestickModelMapper</a></p></td><td class="tblDescr"><p>Vertical model mapper for a candlestick series</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qvpiemodelmapper.html">QVPieModelMapper</a></p></td><td class="tblDescr"><p>Vertical model mapper for pie series</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qvxymodelmapper.html">QVXYModelMapper</a></p></td><td class="tblDescr"><p>Vertical model mapper for line, spline, and scatter series</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qvalueaxis.html">QValueAxis</a></p></td><td class="tblDescr"><p>Adds values to a chart's axes</p></td></tr> <tr class="odd topAlign"><td class="tblName"><p><a href="qxylegendmarker.html">QXYLegendMarker</a></p></td><td class="tblDescr"><p>Legend marker for a line, spline, or scatter series</p></td></tr> <tr class="even topAlign"><td class="tblName"><p><a href="qxyseries.html">QXYSeries</a></p></td><td class="tblDescr"><p>Base class for line, spline, and scatter series</p></td></tr> </table></div> <!-- $$$QtCharts-description --> <a name="details"></a> <div class="descr"> <h2 id="details">Detailed Description</h2> <p>Charts API is built on top of Qt Graphics View Framework. Charts can be displayed as QGraphicsWidget using the <a href="qchart.html">QChart</a> class. However there is also the convenience class <a href="qchartview.html">QChartView</a>, which is QWidget based. These enable us to quickly use Qt Charts as a normal Qt widget.</p> <p>If you intend to use Qt Charts C++ classes in your application, use the following include and using directives:</p> <pre class="cpp"> <span class="preprocessor">#include <QtCharts></span> <span class="keyword">using</span> <span class="keyword">namespace</span> <span class="type">QtCharts</span>; </pre> <p><b>Note: </b>Projects created with Qt Creator's Qt Quick Application wizard are based on the Qt Quick 2 template that uses QGuiApplication by default. All such QGuiApplication instances in the project must be replaced with QApplication as the module depends on Qt's Graphics View Framework for rendering.</p><p>To link against the Qt Charts module, add this line to your <code>qmake</code> project file:</p> <pre class="cpp"> QT += charts </pre> <p>Each chart type is represented by the <a href="qabstractseries.html">QAbstractSeries</a> derived class. To create charts, the users have to use an instance of the related series class and add it to a <a href="qchart.html">QChart</a> instance.</p> <pre class="cpp"> <span class="type"><a href="qlineseries.html">QLineSeries</a></span><span class="operator">*</span> series <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qlineseries.html">QLineSeries</a></span>(); series<span class="operator">-</span><span class="operator">></span>append(<span class="number">0</span><span class="operator">,</span> <span class="number">6</span>); series<span class="operator">-</span><span class="operator">></span>append(<span class="number">2</span><span class="operator">,</span> <span class="number">4</span>); <span class="operator">.</span><span class="operator">.</span><span class="operator">.</span> chartView<span class="operator">-</span><span class="operator">></span>chart()<span class="operator">-</span><span class="operator">></span>addSeries(series); chartView<span class="operator">-</span><span class="operator">></span>chart()<span class="operator">-</span><span class="operator">></span>createDefaultAxes(); </pre> </div> <!-- @@@QtCharts --> </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>