1/****************************************************************************
2**
3** Copyright (C) 2017 The Qt Company Ltd.
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the Qt Data Visualization module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:GPL$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see https://www.qt.io/terms-conditions. For further
15** information use the contact form at https://www.qt.io/contact-us.
16**
17** GNU General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU
19** General Public License version 3 or (at your option) any later version
20** approved by the KDE Free Qt Foundation. The licenses are as published by
21** the Free Software Foundation and appearing in the file LICENSE.GPL3
22** included in the packaging of this file. Please review the following
23** information to ensure the GNU General Public License requirements will
24** be met: https://www.gnu.org/licenses/gpl-3.0.html.
25**
26** $QT_END_LICENSE$
27**
28****************************************************************************/
29
30#include "qcategory3daxis_p.h"
31#include "bars3dcontroller_p.h"
32
33QT_BEGIN_NAMESPACE_DATAVISUALIZATION
34
35/*!
36 * \class QCategory3DAxis
37 * \inmodule QtDataVisualization
38 * \brief The QCategory3DAxis class manipulates an axis of a graph.
39 * \since QtDataVisualization 1.0
40 *
41 * QCategory3DAxis provides an axis that can be given labels. The axis is divided into equal-sized
42 * categories based on the data window size defined by setting the axis range.
43 *
44 * Grid lines are drawn between categories, if visible. Labels are drawn to positions of categories
45 * if provided.
46 */
47
48/*!
49 * \qmltype CategoryAxis3D
50 * \inqmlmodule QtDataVisualization
51 * \since QtDataVisualization 1.0
52 * \ingroup datavisualization_qml
53 * \instantiates QCategory3DAxis
54 * \inherits AbstractAxis3D
55 * \brief Manipulates an axis of a graph.
56 *
57 * This type provides an axis that can be given labels.
58 */
59
60/*!
61 * \qmlproperty list CategoryAxis3D::labels
62 *
63 * The labels for the axis applied to categories. If there are fewer labels than categories, the
64 * remaining ones do not have a label. If category labels are not defined explicitly, labels are
65 * generated from the data row (or column) labels of the primary series of the graph.
66 */
67
68/*!
69 * Constructs a category 3D axis with the parent \a parent.
70 */
71QCategory3DAxis::QCategory3DAxis(QObject *parent) :
72 QAbstract3DAxis(new QCategory3DAxisPrivate(this), parent)
73{
74 connect(sender: this, signal: &QCategory3DAxis::labelsChanged, receiver: this, slot: &QAbstract3DAxis::labelsChanged);
75}
76
77/*!
78 * Destroys the category 3D axis.
79 */
80QCategory3DAxis::~QCategory3DAxis()
81{
82}
83
84/*!
85 * \property QCategory3DAxis::labels
86 *
87 * \brief The labels for the axis applied to categories.
88 *
89 * If there are fewer labels than categories, the
90 * remaining ones do not have a label. If category labels are not defined explicitly, labels are
91 * generated from the data row (or column) labels of the primary series of the graph.
92 */
93QStringList QCategory3DAxis::labels() const
94{
95 return QAbstract3DAxis::labels();
96}
97
98void QCategory3DAxis::setLabels(const QStringList &labels)
99{
100 dptr()->m_labelsExplicitlySet = !labels.isEmpty();
101 bool labelsFromData = false;
102
103 // Get labels from data proxy if axis is attached to a bar controller and an active axis there
104 if (labels.isEmpty()) {
105 Bars3DController *controller = qobject_cast<Bars3DController *>(object: parent());
106 if (controller) {
107 if (controller->axisX() == this) {
108 controller->handleDataRowLabelsChanged();
109 labelsFromData = true;
110 } else if (controller->axisZ() == this) {
111 controller->handleDataColumnLabelsChanged();
112 labelsFromData = true;
113 }
114 }
115 }
116
117 if (!labelsFromData && d_ptr->m_labels != labels) {
118 d_ptr->m_labels = labels;
119 emit labelsChanged();
120 }
121}
122
123/*!
124 * \internal
125 */
126QCategory3DAxisPrivate *QCategory3DAxis::dptr()
127{
128 return static_cast<QCategory3DAxisPrivate *>(d_ptr.data());
129}
130
131QCategory3DAxisPrivate::QCategory3DAxisPrivate(QCategory3DAxis *q)
132 : QAbstract3DAxisPrivate(q, QAbstract3DAxis::AxisTypeCategory),
133 m_labelsExplicitlySet(false)
134{
135}
136
137QCategory3DAxisPrivate::~QCategory3DAxisPrivate()
138{
139}
140
141/*!
142 * \internal
143 * Controller uses this function to set labels from data proxy as category labels.
144 * If the labels have been set explicitly by the user, data proxy labels are not used.
145 */
146void QCategory3DAxisPrivate::setDataLabels(const QStringList &labels)
147{
148 if (!m_labelsExplicitlySet && m_labels != labels) {
149 m_labels = labels;
150 emit qptr()->labelsChanged();
151 }
152}
153
154bool QCategory3DAxisPrivate::allowZero()
155{
156 return true;
157}
158
159bool QCategory3DAxisPrivate::allowNegatives()
160{
161 return false;
162}
163
164bool QCategory3DAxisPrivate::allowMinMaxSame()
165{
166 return true;
167}
168
169QCategory3DAxis *QCategory3DAxisPrivate::qptr()
170{
171 return static_cast<QCategory3DAxis *>(q_ptr);
172}
173
174QT_END_NAMESPACE_DATAVISUALIZATION
175

source code of qtdatavis3d/src/datavisualization/axis/qcategory3daxis.cpp