<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html> <html lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <!-- examples-customchart.qdoc --> <title>Custom Chart Example | 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 ><a href="qtcharts-examples.html">Qt Charts Examples</a></td><td >Custom Chart Example</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="#running-the-example">Running the Example</a></li> <li class="level1"><a href="#customizing-charts">Customizing Charts</a></li> </ul> </div> <div class="sidebar-content" id="sidebar-content"></div></div> <h1 class="title">Custom Chart Example</h1> <span class="subtitle"></span> <!-- $$$customchart-brief --> <p>This example shows how to customize the appearance of the different elements on a chart.</p> <!-- @@@customchart --> <!-- $$$customchart-description --> <div class="descr"> <a name="details"></a> <p class="centerAlign"><img src="images/examples_customchart.png" alt="" /></p><a name="running-the-example"></a> <h2 id="running-the-example">Running the Example</h2> <p>To run the example from Qt Creator, open the <b>Welcome</b> mode and select the example from <b>Examples</b>. For more information, visit Building and Running an Example.</p> <a name="customizing-charts"></a> <h2 id="customizing-charts">Customizing Charts</h2> <p>We begin by creating a simple line series and a chart object.</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>(); <span class="operator">*</span>series <span class="operator"><</span><span class="operator"><</span> <span class="type">QPointF</span>(<span class="number">0</span><span class="operator">,</span> <span class="number">6</span>) <span class="operator"><</span><span class="operator"><</span> <span class="type">QPointF</span>(<span class="number">9</span><span class="operator">,</span> <span class="number">4</span>) <span class="operator"><</span><span class="operator"><</span> <span class="type">QPointF</span>(<span class="number">15</span><span class="operator">,</span> <span class="number">20</span>) <span class="operator"><</span><span class="operator"><</span> <span class="type">QPointF</span>(<span class="number">25</span><span class="operator">,</span> <span class="number">12</span>) <span class="operator"><</span><span class="operator"><</span> <span class="type">QPointF</span>(<span class="number">29</span><span class="operator">,</span> <span class="number">26</span>); <span class="type"><a href="qchart.html">QChart</a></span> <span class="operator">*</span>chart <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qchart.html">QChart</a></span>(); chart<span class="operator">-</span><span class="operator">></span>legend()<span class="operator">-</span><span class="operator">></span>hide(); chart<span class="operator">-</span><span class="operator">></span>addSeries(series); </pre> <p>First we customize the series and the chart's title and background.</p> <pre class="cpp"> <span class="comment">// Customize series</span> <span class="type">QPen</span> pen(<span class="type">QRgb</span>(<span class="number">0xfdb157</span>)); pen<span class="operator">.</span>setWidth(<span class="number">5</span>); series<span class="operator">-</span><span class="operator">></span>setPen(pen); <span class="comment">// Customize chart title</span> <span class="type">QFont</span> font; font<span class="operator">.</span>setPixelSize(<span class="number">18</span>); chart<span class="operator">-</span><span class="operator">></span>setTitleFont(font); chart<span class="operator">-</span><span class="operator">></span>setTitleBrush(<span class="type">QBrush</span>(<span class="type">Qt</span><span class="operator">::</span>white)); chart<span class="operator">-</span><span class="operator">></span>setTitle(<span class="string">"Customchart example"</span>); <span class="comment">// Customize chart background</span> <span class="type">QLinearGradient</span> backgroundGradient; backgroundGradient<span class="operator">.</span>setStart(<span class="type">QPointF</span>(<span class="number">0</span><span class="operator">,</span> <span class="number">0</span>)); backgroundGradient<span class="operator">.</span>setFinalStop(<span class="type">QPointF</span>(<span class="number">0</span><span class="operator">,</span> <span class="number">1</span>)); backgroundGradient<span class="operator">.</span>setColorAt(<span class="number">0.0</span><span class="operator">,</span> <span class="type">QRgb</span>(<span class="number">0xd2d0d1</span>)); backgroundGradient<span class="operator">.</span>setColorAt(<span class="number">1.0</span><span class="operator">,</span> <span class="type">QRgb</span>(<span class="number">0x4c4547</span>)); backgroundGradient<span class="operator">.</span>setCoordinateMode(<span class="type">QGradient</span><span class="operator">::</span>ObjectBoundingMode); chart<span class="operator">-</span><span class="operator">></span>setBackgroundBrush(backgroundGradient); <span class="comment">// Customize plot area background</span> <span class="type">QLinearGradient</span> plotAreaGradient; plotAreaGradient<span class="operator">.</span>setStart(<span class="type">QPointF</span>(<span class="number">0</span><span class="operator">,</span> <span class="number">1</span>)); plotAreaGradient<span class="operator">.</span>setFinalStop(<span class="type">QPointF</span>(<span class="number">1</span><span class="operator">,</span> <span class="number">0</span>)); plotAreaGradient<span class="operator">.</span>setColorAt(<span class="number">0.0</span><span class="operator">,</span> <span class="type">QRgb</span>(<span class="number">0x555555</span>)); plotAreaGradient<span class="operator">.</span>setColorAt(<span class="number">1.0</span><span class="operator">,</span> <span class="type">QRgb</span>(<span class="number">0x55aa55</span>)); plotAreaGradient<span class="operator">.</span>setCoordinateMode(<span class="type">QGradient</span><span class="operator">::</span>ObjectBoundingMode); chart<span class="operator">-</span><span class="operator">></span>setPlotAreaBackgroundBrush(plotAreaGradient); chart<span class="operator">-</span><span class="operator">></span>setPlotAreaBackgroundVisible(<span class="keyword">true</span>); </pre> <p>Then we customize the axes.</p> <pre class="cpp"> <span class="type"><a href="qcategoryaxis.html">QCategoryAxis</a></span> <span class="operator">*</span>axisX <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qcategoryaxis.html">QCategoryAxis</a></span>(); <span class="type"><a href="qcategoryaxis.html">QCategoryAxis</a></span> <span class="operator">*</span>axisY <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qcategoryaxis.html">QCategoryAxis</a></span>(); <span class="comment">// Customize axis label font</span> <span class="type">QFont</span> labelsFont; labelsFont<span class="operator">.</span>setPixelSize(<span class="number">12</span>); axisX<span class="operator">-</span><span class="operator">></span>setLabelsFont(labelsFont); axisY<span class="operator">-</span><span class="operator">></span>setLabelsFont(labelsFont); <span class="comment">// Customize axis colors</span> <span class="type">QPen</span> axisPen(<span class="type">QRgb</span>(<span class="number">0xd18952</span>)); axisPen<span class="operator">.</span>setWidth(<span class="number">2</span>); axisX<span class="operator">-</span><span class="operator">></span>setLinePen(axisPen); axisY<span class="operator">-</span><span class="operator">></span>setLinePen(axisPen); <span class="comment">// Customize axis label colors</span> <span class="type">QBrush</span> axisBrush(<span class="type">Qt</span><span class="operator">::</span>white); axisX<span class="operator">-</span><span class="operator">></span>setLabelsBrush(axisBrush); axisY<span class="operator">-</span><span class="operator">></span>setLabelsBrush(axisBrush); <span class="comment">// Customize grid lines and shades</span> axisX<span class="operator">-</span><span class="operator">></span>setGridLineVisible(<span class="keyword">false</span>); axisY<span class="operator">-</span><span class="operator">></span>setGridLineVisible(<span class="keyword">false</span>); axisY<span class="operator">-</span><span class="operator">></span>setShadesPen(<span class="type">Qt</span><span class="operator">::</span>NoPen); axisY<span class="operator">-</span><span class="operator">></span>setShadesBrush(<span class="type">QBrush</span>(<span class="type">QColor</span>(<span class="number">0x99</span><span class="operator">,</span> <span class="number">0xcc</span><span class="operator">,</span> <span class="number">0xcc</span><span class="operator">,</span> <span class="number">0x55</span>))); axisY<span class="operator">-</span><span class="operator">></span>setShadesVisible(<span class="keyword">true</span>); </pre> <p>Then the axis label values and ranges. Once the axes are ready, we set them to be used by the chart.</p> <pre class="cpp"> axisX<span class="operator">-</span><span class="operator">></span>append(<span class="string">"low"</span><span class="operator">,</span> <span class="number">10</span>); axisX<span class="operator">-</span><span class="operator">></span>append(<span class="string">"optimal"</span><span class="operator">,</span> <span class="number">20</span>); axisX<span class="operator">-</span><span class="operator">></span>append(<span class="string">"high"</span><span class="operator">,</span> <span class="number">30</span>); axisX<span class="operator">-</span><span class="operator">></span>setRange(<span class="number">0</span><span class="operator">,</span> <span class="number">30</span>); axisY<span class="operator">-</span><span class="operator">></span>append(<span class="string">"slow"</span><span class="operator">,</span> <span class="number">10</span>); axisY<span class="operator">-</span><span class="operator">></span>append(<span class="string">"med"</span><span class="operator">,</span> <span class="number">20</span>); axisY<span class="operator">-</span><span class="operator">></span>append(<span class="string">"fast"</span><span class="operator">,</span> <span class="number">30</span>); axisY<span class="operator">-</span><span class="operator">></span>setRange(<span class="number">0</span><span class="operator">,</span> <span class="number">30</span>); chart<span class="operator">-</span><span class="operator">></span>addAxis(axisX<span class="operator">,</span> <span class="type">Qt</span><span class="operator">::</span>AlignBottom); chart<span class="operator">-</span><span class="operator">></span>addAxis(axisY<span class="operator">,</span> <span class="type">Qt</span><span class="operator">::</span>AlignLeft); series<span class="operator">-</span><span class="operator">></span>attachAxis(axisX); series<span class="operator">-</span><span class="operator">></span>attachAxis(axisY); </pre> <p>Finally, we create a view containing the chart.</p> <pre class="cpp"> <span class="type"><a href="qchartview.html">QChartView</a></span> <span class="operator">*</span>chartView <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qchartview.html">QChartView</a></span>(chart); chartView<span class="operator">-</span><span class="operator">></span>setRenderHint(<span class="type">QPainter</span><span class="operator">::</span>Antialiasing); </pre> <p>Now we are ready to show the chart on a main window.</p> <pre class="cpp"> <span class="type">QMainWindow</span> window; window<span class="operator">.</span>setCentralWidget(chartView); window<span class="operator">.</span>resize(<span class="number">400</span><span class="operator">,</span> <span class="number">300</span>); window<span class="operator">.</span>show(); </pre> <p>Files:</p> <ul> <li><a href="qtcharts-customchart-customchart-pro.html">customchart/customchart.pro</a></li> <li><a href="qtcharts-customchart-main-cpp.html">customchart/main.cpp</a></li> </ul> </div> <!-- @@@customchart --> </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>