summaryrefslogtreecommitdiffstats
path: root/src/charts/doc/src/examples-multiaxis.qdoc
blob: 1c55396c7931888d874633e2d628576e737c076b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
/****************************************************************************
**
** Copyright (C) 2016 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the Qt Charts module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:GPL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3 or (at your option) any later version
** approved by the KDE Free Qt Foundation. The licenses are as published by
** the Free Software Foundation and appearing in the file LICENSE.GPL3
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-3.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/

/*!
    \example multiaxis
    \title Multiple Axes Example
    \ingroup qtcharts_examples

    \brief The example shows how to create a simple chart with two vertical axes. One for each
    series.

    \image examples_multiaxis.png

    Create the QChart instance, hide the legend of the chart, and set its title.

    \snippet multiaxis/main.cpp 1

    Create a QValueAxis instance that will be used as a horizontal axis by both series and add it the bottom of the chart.
    The axis can be shared between many series, but each series can have only one vertical and horizontal axis.

    \snippet multiaxis/main.cpp 2

    Create the first series, and add the data to it. Finally, add the series to the chart. Instantiate its own Y-axis, add it to the chart. Then attach both the common X-axis and the series specific Y-axis.
    In this example the color of the axis line is set to be the same as the color of the series to make it possible to distinguish which axis is attached to which series.

    \snippet multiaxis/main.cpp 3

    Similarly prepare another series. This time a different axis type is used. Additionally grid lines color is also set to be the same as the color of the series.

    \snippet multiaxis/main.cpp 4

    Create a QChartView object with QChart as a parameter. Enable Antialiasing to have the rendered splines look nicer.

    \snippet multiaxis/main.cpp 5

    The chart is ready to be shown.

    \snippet multiaxis/main.cpp 6

*/