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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
/****************************************************************************
**
** Copyright (C) 2013 Digia Plc
** All rights reserved.
** For any questions to Digia, please use contact form at http://qt.digia.com
**
** This file is part of the QtDataVisualization module.
**
** Licensees holding valid Qt Enterprise licenses may use this file in
** accordance with the Qt Enterprise License Agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia.
**
** If you have questions regarding the use of this file, please use
** contact form at http://qt.digia.com
**
****************************************************************************/
/*!
* \qmltype Bars3D
* \inherits AbstractGraph3D
* \inqmlmodule QtDataVisualization
* \since QtDataVisualization 1.0
* \ingroup datavisualization_qml
* \brief 3D bar graph.
*
* This type enables developers to render bar graphs in 3D with Qt Quick 2.
*
* You will need to import data visualization module to use this type:
*
* \snippet doc_src_qmldatavisualization.cpp 0
*
* After that you can use Bars3D in your qml files:
*
* \snippet doc_src_qmldatavisualization.cpp 1
*
* See \l{Qt Quick 2 Bars Example} for more thorough usage example.
*
* \note Qt Data Visualization graphs are rendered behind any other QML elements on screen, including
* the parent elements of the graph. To make the whole graph show, ensure that no other element
* draws anything over the area the graph occupies. For example, having a non-transparent \c Rectangle
* item as the parent of a graph causes the graph to be hidden.
*
* \sa Bar3DSeries, ItemModelBarDataProxy, Scatter3D, Surface3D, {Qt Data Visualization C++ Classes}
*/
/*!
* \qmlproperty CategoryAxis3D Bars3D::rowAxis
* A user-defined row axis.
*
* If an axis is not given, a temporary default axis with no labels is created.
* This temporary axis is destroyed if another axis is explicitly set to same orientation.
*/
/*!
* \qmlproperty ValueAxis3D Bars3D::valueAxis
* A user-defined value axis.
*
* If an axis is not given, a temporary default axis with no labels and automatically adjusting
* range is created.
* This temporary axis is destroyed if another axis is explicitly set to same orientation.
*/
/*!
* \qmlproperty CategoryAxis3D Bars3D::columnAxis
* A user-defined column axis.
*
* If an axis is not given, a temporary default axis with no labels is created.
* This temporary axis is destroyed if another axis is explicitly set to same orientation.
*/
/*!
* \qmlproperty real Bars3D::barThickness
* Bar thickness ratio between X and Z dimensions. 1.0 means bars are as wide as they are deep, 0.5
* makes them twice as deep as they are wide.
*/
/*!
* \qmlproperty size Bars3D::barSpacing
* Bar spacing in X and Z dimensions.
*/
/*!
* \qmlproperty bool Bars3D::barSpacingRelative
* Relative or absolute bar spacing.
*/
/*!
* \qmlproperty list<QBar3DSeries> Bars3D::seriesList
* \default
* This property holds the series of the graph.
* By default, this property contains an empty list.
* To set the series, either use the addSeries() function or define them as children of the graph.
*/
/*!
* \qmlmethod void Bars3D::addSeries(QBar3DSeries *series)
* Adds the \a series to the graph. A graph can contain multiple series, but only one set of axes,
* so the rows and columns of all series must match for the visualized data to be meaningful.
* If the graph has multiple visible series, only the first one added will
* generate the row or column labels on the axes in cases where the labels are not explicitly set
* to the axes. If the newly added series has specified a selected bar, it will be highlighted and
* any existing selection will be cleared. Only one added series can have an active selection.
*/
/*!
* \qmlmethod void Bars3D::removeSeries(QBar3DSeries *series)
* Remove the \a series from the graph.
*/
|