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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
// Copyright (C) 2023 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
#include <QtGraphs/qlineseries.h>
#include <private/qgraphsview_p.h>
#include <private/qlineseries_p.h>
#include <private/qxypoint_p.h>
QT_BEGIN_NAMESPACE
/*!
\class QLineSeries
\inmodule QtGraphs
\ingroup graphs_2D
\brief The QLineSeries class presents data in line graphs.
A line graph is used to show information as a series of data points
connected by straight lines.
*/
/*!
\qmltype LineSeries
\nativetype QLineSeries
\inqmlmodule QtGraphs
\ingroup graphs_qml_2D
\inherits XYSeries
\brief Presents data in line graphs.
A line graph is used to show information as a series of data points
connected by straight lines.
\image graphs2d-line.png
LineSeries uses mostly the same API as ScatterSeries so see ScatterSeries
documentation for further usage examples.
\sa ScatterSeries
*/
/*!
\qmlproperty real LineSeries::width
The width of the line. By default, the width is 2.0. Widths lower than 0
are invalid and are automatically set to 0.
*/
/*!
\qmlproperty Qt::PenCapStyle LineSeries::capStyle
Controls the cap style of the line. Set to one of \l{Qt::FlatCap}{Qt.FlatCap},
\l{Qt::SquareCap}{Qt.SquareCap} or \l{Qt::RoundCap}{Qt.RoundCap}. By
default the cap style is Qt.SquareCap. Invalid values are automatically set
to the default value.
\sa Qt::PenCapStyle
*/
/*!
\qmlproperty Component LineSeries::pointDelegate
Marks the point with the given QML component.
\code
pointDelegate: Image {
source: "images/happy_box.png"
}
\endcode
*/
/*!
\qmlsignal LineSeries::widthChanged()
This signal is emitted when the line series width changes.
*/
/*!
\qmlsignal LineSeries::capStyleChanged()
This signal is emitted when the line series cap style changes.
*/
QLineSeries::QLineSeries(QObject *parent)
: QXYSeries(*(new QLineSeriesPrivate()), parent)
{}
QLineSeries::~QLineSeries() {}
QLineSeries::QLineSeries(QLineSeriesPrivate &dd, QObject *parent)
: QXYSeries(dd, parent)
{}
void QLineSeries::componentComplete()
{
Q_D(QLineSeries);
for (auto *child : children()) {
if (auto point = qobject_cast<QXYPoint *>(child)) {
append(point->x(), point->y());
qCDebug(lcSeries2D, "append points x: %.1f, y: %.1f to lineSeries",
point->x(),
point->y());
}
}
if (d->m_graphTransition)
d->m_graphTransition->initialize();
qCDebug(lcEvents2D) << "QLineSeries::componentComplete.";
QAbstractSeries::componentComplete();
}
QAbstractSeries::SeriesType QLineSeries::type() const
{
return QAbstractSeries::SeriesType::Line;
}
QLineSeriesPrivate::QLineSeriesPrivate() {}
qreal QLineSeries::width() const
{
Q_D(const QLineSeries);
return d->m_width;
}
void QLineSeries::setWidth(qreal newWidth)
{
Q_D(QLineSeries);
if (newWidth < 0.0)
newWidth = 0.0;
if (qFuzzyCompare(d->m_width, newWidth)) {
qCDebug(lcProperties2D, "QLineSeries::setWidth. Set value width is already %f",
newWidth);
return;
}
d->m_width = newWidth;
emit widthChanged();
emit update();
}
Qt::PenCapStyle QLineSeries::capStyle() const
{
Q_D(const QLineSeries);
return d->m_capStyle;
}
void QLineSeries::setCapStyle(Qt::PenCapStyle newCapStyle)
{
Q_D(QLineSeries);
Qt::PenCapStyle validCapStyle = newCapStyle;
if (validCapStyle != Qt::PenCapStyle::FlatCap && validCapStyle != Qt::PenCapStyle::SquareCap
&& validCapStyle != Qt::PenCapStyle::RoundCap
&& validCapStyle != Qt::PenCapStyle::MPenCapStyle) {
validCapStyle = Qt::PenCapStyle::SquareCap;
}
if (d->m_capStyle == validCapStyle) {
qCDebug(lcProperties2D) << "QLineSeries::setCapStyle. CapStyle is already set to:"
<< newCapStyle;
return;
}
d->m_capStyle = validCapStyle;
emit capStyleChanged();
emit update();
}
/*!
\qmlmethod LineSeries::getDataPointCoordinates(real x, real y)
Returns \a x and \a y rendercoordinates converted into data point
coordinates.
*/
/*!
Returns \a x and \a y rendercoordinates converted into data point
coordinates.
*/
QPointF QLineSeries::getDataPointCoordinates(qreal x, qreal y)
{
Q_D(QLineSeries);
auto oPoint = d->m_graph->getDataPointCoordinates(this, x, y);
return oPoint;
}
QT_END_NAMESPACE
|
