1/****************************************************************************
2**
3** Copyright (C) 2016 The Qt Company Ltd.
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the Qt Charts 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#ifndef QABSTRACTAXIS_H
31#define QABSTRACTAXIS_H
32
33#include <QtCharts/QChartGlobal>
34#include <QtGui/QPen>
35#include <QtGui/QFont>
36#include <QtCore/QVariant>
37
38QT_CHARTS_BEGIN_NAMESPACE
39
40class QAbstractAxisPrivate;
41
42class Q_CHARTS_EXPORT QAbstractAxis : public QObject
43{
44 Q_OBJECT
45 //visibility
46 Q_PROPERTY(bool visible READ isVisible WRITE setVisible NOTIFY visibleChanged)
47 //arrow
48 Q_PROPERTY(bool lineVisible READ isLineVisible WRITE setLineVisible NOTIFY lineVisibleChanged)
49 Q_PROPERTY(QPen linePen READ linePen WRITE setLinePen NOTIFY linePenChanged)
50 Q_PROPERTY(QColor color READ linePenColor WRITE setLinePenColor NOTIFY colorChanged)
51 //labels
52 Q_PROPERTY(bool labelsVisible READ labelsVisible WRITE setLabelsVisible NOTIFY labelsVisibleChanged)
53 Q_PROPERTY(QBrush labelsBrush READ labelsBrush WRITE setLabelsBrush NOTIFY labelsBrushChanged)
54 Q_PROPERTY(int labelsAngle READ labelsAngle WRITE setLabelsAngle NOTIFY labelsAngleChanged)
55 Q_PROPERTY(QFont labelsFont READ labelsFont WRITE setLabelsFont NOTIFY labelsFontChanged)
56 Q_PROPERTY(QColor labelsColor READ labelsColor WRITE setLabelsColor NOTIFY labelsColorChanged)
57 //grid
58 Q_PROPERTY(bool gridVisible READ isGridLineVisible WRITE setGridLineVisible NOTIFY gridVisibleChanged)
59 Q_PROPERTY(QPen gridLinePen READ gridLinePen WRITE setGridLinePen NOTIFY gridLinePenChanged)
60 Q_PROPERTY(bool minorGridVisible READ isMinorGridLineVisible WRITE setMinorGridLineVisible NOTIFY minorGridVisibleChanged)
61 Q_PROPERTY(QPen minorGridLinePen READ minorGridLinePen WRITE setMinorGridLinePen NOTIFY minorGridLinePenChanged)
62 Q_PROPERTY(QColor gridLineColor READ gridLineColor WRITE setGridLineColor NOTIFY gridLineColorChanged)
63 Q_PROPERTY(QColor minorGridLineColor READ minorGridLineColor WRITE setMinorGridLineColor NOTIFY minorGridLineColorChanged)
64 //shades
65 Q_PROPERTY(bool shadesVisible READ shadesVisible WRITE setShadesVisible NOTIFY shadesVisibleChanged)
66 Q_PROPERTY(QColor shadesColor READ shadesColor WRITE setShadesColor NOTIFY shadesColorChanged)
67 Q_PROPERTY(QColor shadesBorderColor READ shadesBorderColor WRITE setShadesBorderColor NOTIFY shadesBorderColorChanged)
68 Q_PROPERTY(QPen shadesPen READ shadesPen WRITE setShadesPen NOTIFY shadesPenChanged)
69 Q_PROPERTY(QBrush shadesBrush READ shadesBrush WRITE setShadesBrush NOTIFY shadesBrushChanged)
70 //title
71 Q_PROPERTY(QString titleText READ titleText WRITE setTitleText NOTIFY titleTextChanged)
72 Q_PROPERTY(QBrush titleBrush READ titleBrush WRITE setTitleBrush NOTIFY titleBrushChanged)
73 Q_PROPERTY(bool titleVisible READ isTitleVisible WRITE setTitleVisible NOTIFY titleVisibleChanged)
74 Q_PROPERTY(QFont titleFont READ titleFont WRITE setTitleFont NOTIFY titleFontChanged)
75 //orientation
76 Q_PROPERTY(Qt::Orientation orientation READ orientation)
77 //aligment
78 Q_PROPERTY(Qt::Alignment alignment READ alignment)
79 Q_PROPERTY(bool reverse READ isReverse WRITE setReverse NOTIFY reverseChanged)
80
81public:
82
83 enum AxisType {
84 AxisTypeNoAxis = 0x0,
85 AxisTypeValue = 0x1,
86 AxisTypeBarCategory = 0x2,
87 AxisTypeCategory = 0x4,
88 AxisTypeDateTime = 0x8,
89 AxisTypeLogValue = 0x10
90 };
91
92 Q_DECLARE_FLAGS(AxisTypes, AxisType)
93
94protected:
95 explicit QAbstractAxis(QAbstractAxisPrivate &d, QObject *parent = nullptr);
96
97public:
98 ~QAbstractAxis();
99
100 virtual AxisType type() const = 0;
101
102 //visibility handling
103 bool isVisible() const;
104 void setVisible(bool visible = true);
105 void show();
106 void hide();
107
108 //arrow handling
109 bool isLineVisible() const;
110 void setLineVisible(bool visible = true);
111 void setLinePen(const QPen &pen);
112 QPen linePen() const;
113 void setLinePenColor(QColor color);
114 QColor linePenColor() const;
115
116 //grid handling
117 bool isGridLineVisible() const;
118 void setGridLineVisible(bool visible = true);
119 void setGridLinePen(const QPen &pen);
120 QPen gridLinePen() const;
121 bool isMinorGridLineVisible() const;
122 void setMinorGridLineVisible(bool visible = true);
123 void setMinorGridLinePen(const QPen &pen);
124 QPen minorGridLinePen() const;
125 void setGridLineColor(const QColor &color);
126 QColor gridLineColor();
127 void setMinorGridLineColor(const QColor &color);
128 QColor minorGridLineColor();
129
130 //labels handling
131 bool labelsVisible() const;
132 void setLabelsVisible(bool visible = true);
133 void setLabelsBrush(const QBrush &brush);
134 QBrush labelsBrush() const;
135 void setLabelsFont(const QFont &font);
136 QFont labelsFont() const;
137 void setLabelsAngle(int angle);
138 int labelsAngle() const;
139 void setLabelsColor(QColor color);
140 QColor labelsColor() const;
141
142 //title handling
143 bool isTitleVisible() const;
144 void setTitleVisible(bool visible = true);
145 void setTitleBrush(const QBrush &brush);
146 QBrush titleBrush() const;
147 void setTitleFont(const QFont &font);
148 QFont titleFont() const;
149 void setTitleText(const QString &title);
150 QString titleText() const;
151
152 //shades handling
153 bool shadesVisible() const;
154 void setShadesVisible(bool visible = true);
155 void setShadesPen(const QPen &pen);
156 QPen shadesPen() const;
157 void setShadesBrush(const QBrush &brush);
158 QBrush shadesBrush() const;
159 void setShadesColor(QColor color);
160 QColor shadesColor() const;
161 void setShadesBorderColor(QColor color);
162 QColor shadesBorderColor() const;
163
164 Qt::Orientation orientation() const;
165 Qt::Alignment alignment() const;
166
167 //range handling
168 void setMin(const QVariant &min);
169 void setMax(const QVariant &max);
170 void setRange(const QVariant &min, const QVariant &max);
171
172 //reverse handling
173 void setReverse(bool reverse = true);
174 bool isReverse() const;
175
176 //label editable handling
177 void setLabelsEditable(bool editable = true);
178 bool labelsEditable() const;
179
180Q_SIGNALS:
181 void visibleChanged(bool visible);
182 void linePenChanged(const QPen &pen);
183 void lineVisibleChanged(bool visible);
184 void labelsVisibleChanged(bool visible);
185 void labelsBrushChanged(const QBrush &brush);
186 void labelsFontChanged(const QFont &pen);
187 void labelsAngleChanged(int angle);
188 void gridLinePenChanged(const QPen &pen);
189 void gridVisibleChanged(bool visible);
190 void minorGridVisibleChanged(bool visible);
191 void minorGridLinePenChanged(const QPen &pen);
192 void gridLineColorChanged(const QColor &color);
193 void minorGridLineColorChanged(const QColor &color);
194 void colorChanged(QColor color);
195 void labelsColorChanged(QColor color);
196 void titleTextChanged(const QString &title);
197 void titleBrushChanged(const QBrush &brush);
198 void titleVisibleChanged(bool visible);
199 void titleFontChanged(const QFont &font);
200 void shadesVisibleChanged(bool visible);
201 void shadesColorChanged(QColor color);
202 void shadesBorderColorChanged(QColor color);
203 void shadesPenChanged(const QPen &pen);
204 void shadesBrushChanged(const QBrush &brush);
205 void reverseChanged(bool reverse);
206 void labelsEditableChanged(bool editable);
207
208protected:
209 QScopedPointer<QAbstractAxisPrivate> d_ptr;
210 friend class ChartDataSet;
211 friend class ChartPresenter;
212 friend class ChartThemeManager;
213 friend class AbstractDomain;
214 friend class ChartAxisElement;
215 friend class XYChart;
216
217private:
218 Q_DISABLE_COPY(QAbstractAxis)
219};
220
221QT_CHARTS_END_NAMESPACE
222
223#endif // QABSTRACTAXIS_H
224

source code of qtcharts/src/charts/axis/qabstractaxis.h