@@ -1,660 +1,693 | |||
|
1 | 1 | /**************************************************************************** |
|
2 | 2 | ** |
|
3 | 3 | ** Copyright (C) 2012 Digia Plc |
|
4 | 4 | ** All rights reserved. |
|
5 | 5 | ** For any questions to Digia, please use contact form at http://qt.digia.com |
|
6 | 6 | ** |
|
7 | 7 | ** This file is part of the Qt Commercial Charts Add-on. |
|
8 | 8 | ** |
|
9 | 9 | ** $QT_BEGIN_LICENSE$ |
|
10 | 10 | ** Licensees holding valid Qt Commercial licenses may use this file in |
|
11 | 11 | ** accordance with the Qt Commercial License Agreement provided with the |
|
12 | 12 | ** Software or, alternatively, in accordance with the terms contained in |
|
13 | 13 | ** a written agreement between you and Digia. |
|
14 | 14 | ** |
|
15 | 15 | ** If you have questions regarding the use of this file, please use |
|
16 | 16 | ** contact form at http://qt.digia.com |
|
17 | 17 | ** $QT_END_LICENSE$ |
|
18 | 18 | ** |
|
19 | 19 | ****************************************************************************/ |
|
20 | 20 | |
|
21 | 21 | #include "qpieseries.h" |
|
22 | 22 | #include "qpiesliceprivate_p.h" |
|
23 | 23 | #include "qpieseriesprivate_p.h" |
|
24 | 24 | #include <QDebug> |
|
25 | 25 | |
|
26 | 26 | QTCOMMERCIALCHART_BEGIN_NAMESPACE |
|
27 | 27 | |
|
28 | 28 | QPieSeriesPrivate::QPieSeriesPrivate(QPieSeries *parent) |
|
29 | 29 | :QObject(parent), |
|
30 | 30 | q_ptr(parent), |
|
31 | 31 | m_pieRelativeHorPos(0.5), |
|
32 | 32 | m_pieRelativeVerPos(0.5), |
|
33 | 33 | m_pieRelativeSize(0.7), |
|
34 | 34 | m_pieStartAngle(0), |
|
35 | 35 | m_pieEndAngle(360), |
|
36 | 36 | m_total(0), |
|
37 | 37 | m_mapValues(0), |
|
38 | 38 | m_mapLabels(0), |
|
39 | 39 | m_mapOrientation(Qt::Horizontal) |
|
40 | 40 | { |
|
41 | 41 | |
|
42 | 42 | } |
|
43 | 43 | |
|
44 | 44 | QPieSeriesPrivate::~QPieSeriesPrivate() |
|
45 | 45 | { |
|
46 | 46 | |
|
47 | 47 | } |
|
48 | 48 | |
|
49 | 49 | void QPieSeriesPrivate::updateDerivativeData() |
|
50 | 50 | { |
|
51 | 51 | m_total = 0; |
|
52 | 52 | |
|
53 | 53 | // nothing to do? |
|
54 | 54 | if (m_slices.count() == 0) |
|
55 | 55 | return; |
|
56 | 56 | |
|
57 | 57 | // calculate total |
|
58 | 58 | foreach (QPieSlice* s, m_slices) |
|
59 | 59 | m_total += s->value(); |
|
60 | 60 | |
|
61 | 61 | // nothing to show.. |
|
62 | 62 | if (qFuzzyIsNull(m_total)) |
|
63 | 63 | return; |
|
64 | 64 | |
|
65 | 65 | // update slice attributes |
|
66 | 66 | qreal sliceAngle = m_pieStartAngle; |
|
67 | 67 | qreal pieSpan = m_pieEndAngle - m_pieStartAngle; |
|
68 | 68 | QVector<QPieSlice*> changed; |
|
69 | 69 | foreach (QPieSlice* s, m_slices) { |
|
70 | 70 | |
|
71 | 71 | PieSliceData data = s->data_ptr()->m_data; |
|
72 | 72 | data.m_percentage = s->value() / m_total; |
|
73 | 73 | data.m_angleSpan = pieSpan * data.m_percentage; |
|
74 | 74 | data.m_startAngle = sliceAngle; |
|
75 | 75 | sliceAngle += data.m_angleSpan; |
|
76 | 76 | |
|
77 | 77 | if (s->data_ptr()->m_data != data) { |
|
78 | 78 | s->data_ptr()->m_data = data; |
|
79 | 79 | changed << s; |
|
80 | 80 | } |
|
81 | 81 | } |
|
82 | 82 | |
|
83 | 83 | // emit signals |
|
84 | 84 | foreach (QPieSlice* s, changed) |
|
85 | 85 | emit s->data_ptr()->changed(); |
|
86 | 86 | } |
|
87 | 87 | |
|
88 | 88 | void QPieSeriesPrivate::sliceChanged() |
|
89 | 89 | { |
|
90 | 90 | Q_ASSERT(m_slices.contains(qobject_cast<QPieSlice *>(sender()))); |
|
91 | 91 | updateDerivativeData(); |
|
92 | 92 | } |
|
93 | 93 | |
|
94 | 94 | void QPieSeriesPrivate::sliceClicked(Qt::MouseButtons buttons) |
|
95 | 95 | { |
|
96 | 96 | QPieSlice* slice = qobject_cast<QPieSlice *>(sender()); |
|
97 | 97 | Q_ASSERT(m_slices.contains(slice)); |
|
98 | 98 | Q_Q(QPieSeries); |
|
99 | 99 | emit q->clicked(slice, buttons); |
|
100 | 100 | } |
|
101 | 101 | |
|
102 | 102 | void QPieSeriesPrivate::sliceHoverEnter() |
|
103 | 103 | { |
|
104 | 104 | QPieSlice* slice = qobject_cast<QPieSlice *>(sender()); |
|
105 | 105 | Q_ASSERT(m_slices.contains(slice)); |
|
106 | 106 | Q_Q(QPieSeries); |
|
107 | 107 | emit q->hoverEnter(slice); |
|
108 | 108 | } |
|
109 | 109 | |
|
110 | 110 | void QPieSeriesPrivate::sliceHoverLeave() |
|
111 | 111 | { |
|
112 | 112 | QPieSlice* slice = qobject_cast<QPieSlice *>(sender()); |
|
113 | 113 | Q_ASSERT(m_slices.contains(slice)); |
|
114 | 114 | Q_Q(QPieSeries); |
|
115 | 115 | emit q->hoverLeave(slice); |
|
116 | 116 | } |
|
117 | 117 | |
|
118 | 118 | void QPieSeriesPrivate::modelUpdated(QModelIndex topLeft, QModelIndex bottomRight) |
|
119 | 119 | { |
|
120 | 120 | Q_UNUSED(bottomRight) |
|
121 | 121 | Q_Q(QPieSeries); |
|
122 | 122 | |
|
123 | 123 | if (m_mapOrientation == Qt::Vertical) |
|
124 | 124 | { |
|
125 | 125 | // slices().at(topLeft.row())->setValue(m_model->data(m_model->index(topLeft.row(), topLeft.column()), Qt::DisplayRole).toDouble()); |
|
126 | 126 | if (topLeft.column() == m_mapValues) |
|
127 | 127 | if (m_mapValues == m_mapLabels) |
|
128 | 128 | { |
|
129 | 129 | m_slices.at(topLeft.row())->setValue(q->m_model->data(topLeft, Qt::DisplayRole).toDouble()); |
|
130 | 130 | m_slices.at(topLeft.row())->setLabel(q->m_model->data(topLeft, Qt::DisplayRole).toString()); |
|
131 | 131 | } |
|
132 | 132 | else |
|
133 | 133 | { |
|
134 | 134 | m_slices.at(topLeft.row())->setValue(q->m_model->data(topLeft, Qt::DisplayRole).toDouble()); |
|
135 | 135 | } |
|
136 | 136 | else if (topLeft.column() == m_mapLabels) |
|
137 | 137 | m_slices.at(topLeft.row())->setLabel(q->m_model->data(topLeft, Qt::DisplayRole).toString()); |
|
138 | 138 | } |
|
139 | 139 | else |
|
140 | 140 | { |
|
141 | 141 | // slices().at(topLeft.column())->setValue(m_model->data(m_model->index(topLeft.row(), topLeft.column()), Qt::DisplayRole).toDouble()); |
|
142 | 142 | if (topLeft.row() == m_mapValues) |
|
143 | 143 | if (m_mapValues == m_mapLabels) |
|
144 | 144 | { |
|
145 | 145 | m_slices.at(topLeft.column())->setValue(q->m_model->data(topLeft, Qt::DisplayRole).toDouble()); |
|
146 | 146 | m_slices.at(topLeft.column())->setLabel(q->m_model->data(topLeft, Qt::DisplayRole).toString()); |
|
147 | 147 | } |
|
148 | 148 | else |
|
149 | 149 | { |
|
150 | 150 | m_slices.at(topLeft.column())->setValue(q->m_model->data(topLeft, Qt::DisplayRole).toDouble()); |
|
151 | 151 | } |
|
152 | 152 | else if (topLeft.row() == m_mapLabels) |
|
153 | 153 | m_slices.at(topLeft.column())->setLabel(q->m_model->data(topLeft, Qt::DisplayRole).toString()); |
|
154 | 154 | } |
|
155 | 155 | } |
|
156 | 156 | |
|
157 | 157 | void QPieSeriesPrivate::modelDataAdded(QModelIndex parent, int start, int end) |
|
158 | 158 | { |
|
159 | 159 | Q_UNUSED(parent) |
|
160 | 160 | Q_UNUSED(end) |
|
161 | 161 | Q_Q(QPieSeries); |
|
162 | 162 | |
|
163 | 163 | QPieSlice* newSlice = new QPieSlice; |
|
164 | 164 | newSlice->setLabelVisible(true); |
|
165 | 165 | if (m_mapOrientation == Qt::Vertical) |
|
166 | 166 | { |
|
167 | 167 | newSlice->setValue(q->m_model->data(q->m_model->index(start, m_mapValues), Qt::DisplayRole).toDouble()); |
|
168 | 168 | newSlice->setLabel(q->m_model->data(q->m_model->index(start, m_mapLabels), Qt::DisplayRole).toString()); |
|
169 | 169 | } |
|
170 | 170 | else |
|
171 | 171 | { |
|
172 | 172 | newSlice->setValue(q->m_model->data(q->m_model->index(m_mapValues, start), Qt::DisplayRole).toDouble()); |
|
173 | 173 | newSlice->setLabel(q->m_model->data(q->m_model->index(m_mapLabels, start), Qt::DisplayRole).toString()); |
|
174 | 174 | } |
|
175 | 175 | |
|
176 | 176 | q->insert(start, newSlice); |
|
177 | 177 | } |
|
178 | 178 | |
|
179 | 179 | void QPieSeriesPrivate::modelDataRemoved(QModelIndex parent, int start, int end) |
|
180 | 180 | { |
|
181 | 181 | Q_UNUSED(parent) |
|
182 | 182 | Q_UNUSED(end) |
|
183 | 183 | Q_Q(QPieSeries); |
|
184 | 184 | q->remove(m_slices.at(start)); |
|
185 | 185 | } |
|
186 | 186 | |
|
187 | 187 | |
|
188 | 188 | |
|
189 | 189 | /*! |
|
190 | 190 | \class QPieSeries |
|
191 | 191 | \brief Pie series API for QtCommercial Charts |
|
192 | 192 | |
|
193 | 193 | The pie series defines a pie chart which consists of pie slices which are QPieSlice objects. |
|
194 | 194 | The slices can have any values as the QPieSeries will calculate its relative value to the sum of all slices. |
|
195 | 195 | The actual slice size is determined by that relative value. |
|
196 | 196 | |
|
197 | 197 | By default the pie is defined as a full pie but it can be a partial pie. |
|
198 | 198 | This can be done by setting a starting angle and angle span to the series. |
|
199 | 199 | */ |
|
200 | 200 | |
|
201 | 201 | /*! |
|
202 | 202 | Constructs a series object which is a child of \a parent. |
|
203 | 203 | */ |
|
204 | 204 | QPieSeries::QPieSeries(QObject *parent) : |
|
205 | 205 | QSeries(parent), |
|
206 | 206 | d_ptr(new QPieSeriesPrivate(this)) |
|
207 | 207 | { |
|
208 | 208 | |
|
209 | 209 | } |
|
210 | 210 | |
|
211 | 211 | /*! |
|
212 | 212 | Destroys the object. Note that adding series to QChart transfers the ownership to the chart. |
|
213 | 213 | */ |
|
214 | 214 | QPieSeries::~QPieSeries() |
|
215 | 215 | { |
|
216 | 216 | // NOTE: d_prt destroyed by QObject |
|
217 | 217 | } |
|
218 | 218 | |
|
219 | 219 | /*! |
|
220 | 220 | Returns QChartSeries::SeriesTypePie. |
|
221 | 221 | */ |
|
222 | 222 | QSeries::QSeriesType QPieSeries::type() const |
|
223 | 223 | { |
|
224 | 224 | return QSeries::SeriesTypePie; |
|
225 | 225 | } |
|
226 | 226 | |
|
227 | 227 | /*! |
|
228 | 228 | Sets an array of \a slices to the series replacing the existing slices. |
|
229 | 229 | Slice ownership is passed to the series. |
|
230 | 230 | */ |
|
231 | 231 | void QPieSeries::replace(QList<QPieSlice*> slices) |
|
232 | 232 | { |
|
233 | 233 | clear(); |
|
234 | 234 | append(slices); |
|
235 | 235 | } |
|
236 | 236 | |
|
237 | 237 | /*! |
|
238 | 238 | Adds an array of \a slices to the series. |
|
239 | 239 | Slice ownership is passed to the series. |
|
240 | 240 | */ |
|
241 | 241 | void QPieSeries::append(QList<QPieSlice*> slices) |
|
242 | 242 | { |
|
243 | 243 | Q_D(QPieSeries); |
|
244 | 244 | |
|
245 | 245 | foreach (QPieSlice* s, slices) { |
|
246 | 246 | s->setParent(this); |
|
247 | 247 | d->m_slices << s; |
|
248 | 248 | } |
|
249 | 249 | |
|
250 | 250 | d->updateDerivativeData(); |
|
251 | 251 | |
|
252 | 252 | foreach (QPieSlice* s, slices) { |
|
253 | 253 | connect(s, SIGNAL(changed()), d, SLOT(sliceChanged())); |
|
254 | 254 | connect(s, SIGNAL(clicked(Qt::MouseButtons)), d, SLOT(sliceClicked(Qt::MouseButtons))); |
|
255 | 255 | connect(s, SIGNAL(hoverEnter()), d, SLOT(sliceHoverEnter())); |
|
256 | 256 | connect(s, SIGNAL(hoverLeave()), d, SLOT(sliceHoverLeave())); |
|
257 | 257 | } |
|
258 | 258 | |
|
259 | 259 | emit added(slices); |
|
260 | 260 | } |
|
261 | 261 | |
|
262 | 262 | /*! |
|
263 | 263 | Adds a single \a slice to the series. |
|
264 | 264 | Slice ownership is passed to the series. |
|
265 | 265 | */ |
|
266 | 266 | void QPieSeries::append(QPieSlice* slice) |
|
267 | 267 | { |
|
268 | 268 | append(QList<QPieSlice*>() << slice); |
|
269 | 269 | } |
|
270 | 270 | |
|
271 | 271 | /*! |
|
272 | 272 | Adds a single \a slice to the series and returns a reference to the series. |
|
273 | 273 | Slice ownership is passed to the series. |
|
274 | 274 | */ |
|
275 | 275 | QPieSeries& QPieSeries::operator << (QPieSlice* slice) |
|
276 | 276 | { |
|
277 | 277 | append(slice); |
|
278 | 278 | return *this; |
|
279 | 279 | } |
|
280 | 280 | |
|
281 | 281 | |
|
282 | 282 | /*! |
|
283 |
A |
|
|
283 | Appends a single slice to the series with give \a value and \a name. | |
|
284 | 284 | Slice ownership is passed to the series. |
|
285 | 285 | */ |
|
286 | 286 | QPieSlice* QPieSeries::append(qreal value, QString name) |
|
287 | 287 | { |
|
288 | 288 | QPieSlice* slice = new QPieSlice(value, name); |
|
289 | 289 | append(slice); |
|
290 | 290 | return slice; |
|
291 | 291 | } |
|
292 | 292 | |
|
293 | void QPieSeries::insert(int i, QPieSlice* slice) | |
|
293 | /*! | |
|
294 | Inserts a single \a slice to the series before the slice at \a index position. | |
|
295 | Slice ownership is passed to the series. | |
|
296 | */ | |
|
297 | void QPieSeries::insert(int index, QPieSlice* slice) | |
|
294 | 298 | { |
|
295 | 299 | Q_D(QPieSeries); |
|
296 | Q_ASSERT(i <= d->m_slices.count()); | |
|
300 | Q_ASSERT(index <= d->m_slices.count()); | |
|
297 | 301 | slice->setParent(this); |
|
298 | d->m_slices.insert(i, slice); | |
|
302 | d->m_slices.insert(index, slice); | |
|
299 | 303 | |
|
300 | 304 | d->updateDerivativeData(); |
|
301 | 305 | |
|
302 | 306 | connect(slice, SIGNAL(changed()), d, SLOT(sliceChanged())); |
|
303 | 307 | connect(slice, SIGNAL(clicked()), d, SLOT(sliceClicked())); |
|
304 | 308 | connect(slice, SIGNAL(hoverEnter()), d, SLOT(sliceHoverEnter())); |
|
305 | 309 | connect(slice, SIGNAL(hoverLeave()), d, SLOT(sliceHoverLeave())); |
|
306 | 310 | |
|
307 | 311 | emit added(QList<QPieSlice*>() << slice); |
|
308 | 312 | } |
|
309 | 313 | |
|
310 | 314 | /*! |
|
311 | 315 | Removes a single \a slice from the series and deletes the slice. |
|
312 | 316 | |
|
313 | 317 | Do not reference this pointer after this call. |
|
314 | 318 | */ |
|
315 | 319 | void QPieSeries::remove(QPieSlice* slice) |
|
316 | 320 | { |
|
317 | 321 | Q_D(QPieSeries); |
|
318 | 322 | if (!d->m_slices.removeOne(slice)) { |
|
319 | 323 | Q_ASSERT(0); // TODO: how should this be reported? |
|
320 | 324 | return; |
|
321 | 325 | } |
|
322 | 326 | |
|
323 | 327 | d->updateDerivativeData(); |
|
324 | 328 | |
|
325 | 329 | emit removed(QList<QPieSlice*>() << slice); |
|
326 | 330 | |
|
327 | 331 | delete slice; |
|
328 | 332 | slice = NULL; |
|
329 | 333 | } |
|
330 | 334 | |
|
331 | 335 | /*! |
|
332 | 336 | Clears all slices from the series. |
|
333 | 337 | */ |
|
334 | 338 | void QPieSeries::clear() |
|
335 | 339 | { |
|
336 | 340 | Q_D(QPieSeries); |
|
337 | 341 | if (d->m_slices.count() == 0) |
|
338 | 342 | return; |
|
339 | 343 | |
|
340 | 344 | QList<QPieSlice*> slices = d->m_slices; |
|
341 | 345 | foreach (QPieSlice* s, d->m_slices) { |
|
342 | 346 | d->m_slices.removeOne(s); |
|
343 | 347 | delete s; |
|
344 | 348 | } |
|
345 | 349 | |
|
346 | 350 | d->updateDerivativeData(); |
|
347 | 351 | |
|
348 | 352 | emit removed(slices); |
|
349 | 353 | } |
|
350 | 354 | |
|
351 | 355 | /*! |
|
352 | 356 | Counts the number of the slices in this series. |
|
353 | 357 | */ |
|
354 | 358 | int QPieSeries::count() const |
|
355 | 359 | { |
|
356 | 360 | Q_D(const QPieSeries); |
|
357 | 361 | return d->m_slices.count(); |
|
358 | 362 | } |
|
359 | 363 | |
|
360 | 364 | /*! |
|
361 | 365 | Returns true is the series is empty. |
|
362 | 366 | */ |
|
363 | 367 | bool QPieSeries::isEmpty() const |
|
364 | 368 | { |
|
365 | 369 | Q_D(const QPieSeries); |
|
366 | 370 | return d->m_slices.isEmpty(); |
|
367 | 371 | } |
|
368 | 372 | |
|
369 | 373 | /*! |
|
370 | 374 | Returns a list of slices that belong to this series. |
|
371 | 375 | */ |
|
372 | 376 | QList<QPieSlice*> QPieSeries::slices() const |
|
373 | 377 | { |
|
374 | 378 | Q_D(const QPieSeries); |
|
375 | 379 | return d->m_slices; |
|
376 | 380 | } |
|
377 | 381 | |
|
378 | 382 | /*! |
|
379 | 383 | Sets the center position of the pie by \a relativeHorizontalPosition and \a relativeVerticalPosition. |
|
380 | 384 | |
|
381 | 385 | The factors are relative to the chart rectangle where: |
|
382 | 386 | |
|
383 | 387 | \a relativeHorizontalPosition 0.0 means the absolute left. |
|
384 | 388 | \a relativeHorizontalPosition 1.0 means the absolute right. |
|
385 | 389 | \a relativeVerticalPosition 0.0 means the absolute top. |
|
386 | 390 | \a relativeVerticalPosition 1.0 means the absolute bottom. |
|
387 | 391 | |
|
388 | 392 | By default both values are 0.5 which puts the pie in the middle of the chart rectangle. |
|
389 | 393 | |
|
390 | 394 | \sa pieHorizontalPosition(), pieVerticalPosition(), setPieSize() |
|
391 | 395 | */ |
|
392 | 396 | void QPieSeries::setPiePosition(qreal relativeHorizontalPosition, qreal relativeVerticalPosition) |
|
393 | 397 | { |
|
394 | 398 | Q_D(QPieSeries); |
|
395 | 399 | if (relativeHorizontalPosition < 0.0 || relativeHorizontalPosition > 1.0 || |
|
396 | 400 | relativeVerticalPosition < 0.0 || relativeVerticalPosition > 1.0) |
|
397 | 401 | return; |
|
398 | 402 | |
|
399 | 403 | if (!qFuzzyIsNull(d->m_pieRelativeHorPos - relativeHorizontalPosition) || |
|
400 | 404 | !qFuzzyIsNull(d->m_pieRelativeVerPos - relativeVerticalPosition)) { |
|
401 | 405 | d->m_pieRelativeHorPos = relativeHorizontalPosition; |
|
402 | 406 | d->m_pieRelativeVerPos = relativeVerticalPosition; |
|
403 | 407 | emit piePositionChanged(); |
|
404 | 408 | } |
|
405 | 409 | } |
|
406 | 410 | |
|
407 | 411 | /*! |
|
408 | 412 | Gets the horizontal position of the pie. |
|
409 | 413 | |
|
410 | 414 | The returned value is relative to the chart rectangle where: |
|
411 | 415 | |
|
412 | 416 | 0.0 means the absolute left. |
|
413 | 417 | 1.0 means the absolute right. |
|
414 | 418 | |
|
415 | 419 | By default it is 0.5 which puts the pie in the horizontal middle of the chart rectangle. |
|
416 | 420 | |
|
417 | 421 | \sa setPiePosition(), pieVerticalPosition(), setPieSize() |
|
418 | 422 | */ |
|
419 | 423 | qreal QPieSeries::pieHorizontalPosition() const |
|
420 | 424 | { |
|
421 | 425 | Q_D(const QPieSeries); |
|
422 | 426 | return d->m_pieRelativeHorPos; |
|
423 | 427 | } |
|
424 | 428 | |
|
425 | 429 | /*! |
|
426 | 430 | Gets the vertical position position of the pie. |
|
427 | 431 | |
|
428 | 432 | The returned value is relative to the chart rectangle where: |
|
429 | 433 | |
|
430 | 434 | 0.0 means the absolute top. |
|
431 | 435 | 1.0 means the absolute bottom. |
|
432 | 436 | |
|
433 | 437 | By default it is 0.5 which puts the pie in the vertical middle of the chart rectangle. |
|
434 | 438 | |
|
435 | 439 | \sa setPiePosition(), pieHorizontalPosition(), setPieSize() |
|
436 | 440 | */ |
|
437 | 441 | qreal QPieSeries::pieVerticalPosition() const |
|
438 | 442 | { |
|
439 | 443 | Q_D(const QPieSeries); |
|
440 | 444 | return d->m_pieRelativeVerPos; |
|
441 | 445 | } |
|
442 | 446 | |
|
443 | 447 | /*! |
|
444 | 448 | Sets the relative size of the pie. |
|
445 | 449 | |
|
446 | 450 | The \a relativeSize is defined so that the 1.0 is the maximum that can fit the given chart rectangle. |
|
447 | 451 | |
|
448 | 452 | Default value is 0.7. |
|
449 | 453 | |
|
450 | 454 | \sa pieSize(), setPiePosition(), pieVerticalPosition(), pieHorizontalPosition() |
|
451 | 455 | */ |
|
452 | 456 | void QPieSeries::setPieSize(qreal relativeSize) |
|
453 | 457 | { |
|
454 | 458 | Q_D(QPieSeries); |
|
455 | 459 | if (relativeSize < 0.0 || relativeSize > 1.0) |
|
456 | 460 | return; |
|
457 | 461 | |
|
458 | 462 | if (!qFuzzyIsNull(d->m_pieRelativeSize- relativeSize)) { |
|
459 | 463 | d->m_pieRelativeSize = relativeSize; |
|
460 | 464 | emit pieSizeChanged(); |
|
461 | 465 | } |
|
462 | 466 | } |
|
463 | 467 | |
|
464 | 468 | /*! |
|
465 | 469 | Gets the relative size of the pie. |
|
466 | 470 | |
|
467 | 471 | The size is defined so that the 1.0 is the maximum that can fit the given chart rectangle. |
|
468 | 472 | |
|
469 | 473 | Default value is 0.7. |
|
470 | 474 | |
|
471 | 475 | \sa setPieSize(), setPiePosition(), pieVerticalPosition(), pieHorizontalPosition() |
|
472 | 476 | */ |
|
473 | 477 | qreal QPieSeries::pieSize() const |
|
474 | 478 | { |
|
475 | 479 | Q_D(const QPieSeries); |
|
476 | 480 | return d->m_pieRelativeSize; |
|
477 | 481 | } |
|
478 | 482 | |
|
479 | 483 | |
|
480 | 484 | /*! |
|
481 | 485 | Sets the end angle of the pie. |
|
482 | 486 | |
|
483 | 487 | Full pie is 360 degrees where 0 degrees is at 12 a'clock. |
|
484 | 488 | |
|
485 | 489 | \a angle must be less than pie end angle. Default value is 0. |
|
486 | 490 | |
|
487 | 491 | \sa pieStartAngle(), pieEndAngle(), setPieEndAngle() |
|
488 | 492 | */ |
|
489 | 493 | void QPieSeries::setPieStartAngle(qreal angle) |
|
490 | 494 | { |
|
491 | 495 | Q_D(QPieSeries); |
|
492 | 496 | |
|
493 | 497 | if (angle < 0 || angle > 360 || angle > d->m_pieEndAngle) |
|
494 | 498 | return; |
|
495 | 499 | |
|
496 | 500 | if (!qFuzzyIsNull(angle - d->m_pieStartAngle)) { |
|
497 | 501 | d->m_pieStartAngle = angle; |
|
498 | 502 | d->updateDerivativeData(); |
|
499 | 503 | } |
|
500 | 504 | } |
|
501 | 505 | |
|
502 | 506 | /*! |
|
503 | 507 | Gets the start angle of the pie. |
|
504 | 508 | |
|
505 | 509 | Full pie is 360 degrees where 0 degrees is at 12 a'clock. Default value is 360. |
|
506 | 510 | |
|
507 | 511 | \sa setPieStartAngle(), pieEndAngle(), setPieEndAngle() |
|
508 | 512 | */ |
|
509 | 513 | qreal QPieSeries::pieStartAngle() const |
|
510 | 514 | { |
|
511 | 515 | Q_D(const QPieSeries); |
|
512 | 516 | return d->m_pieStartAngle; |
|
513 | 517 | } |
|
514 | 518 | |
|
515 | 519 | /*! |
|
516 | 520 | Sets the end angle of the pie. |
|
517 | 521 | |
|
518 | 522 | Full pie is 360 degrees where 0 degrees is at 12 a'clock. |
|
519 | 523 | |
|
520 | 524 | \a angle must be greater than start angle. |
|
521 | 525 | |
|
522 | 526 | \sa pieEndAngle(), pieStartAngle(), setPieStartAngle() |
|
523 | 527 | */ |
|
524 | 528 | void QPieSeries::setPieEndAngle(qreal angle) |
|
525 | 529 | { |
|
526 | 530 | Q_D(QPieSeries); |
|
527 | 531 | |
|
528 | 532 | if (angle < 0 || angle > 360 || angle < d->m_pieStartAngle) |
|
529 | 533 | return; |
|
530 | 534 | |
|
531 | 535 | if (!qFuzzyIsNull(angle - d->m_pieEndAngle)) { |
|
532 | 536 | d->m_pieEndAngle = angle; |
|
533 | 537 | d->updateDerivativeData(); |
|
534 | 538 | } |
|
535 | 539 | } |
|
536 | 540 | |
|
537 | 541 | /*! |
|
538 | 542 | Returns the end angle of the pie. |
|
539 | 543 | |
|
540 | 544 | Full pie is 360 degrees where 0 degrees is at 12 a'clock. |
|
541 | 545 | |
|
542 | 546 | \sa setPieEndAngle(), pieStartAngle(), setPieStartAngle() |
|
543 | 547 | */ |
|
544 | 548 | qreal QPieSeries::pieEndAngle() const |
|
545 | 549 | { |
|
546 | 550 | Q_D(const QPieSeries); |
|
547 | 551 | return d->m_pieEndAngle; |
|
548 | 552 | } |
|
549 | 553 | |
|
550 | 554 | /*! |
|
551 | 555 | Sets the all the slice labels \a visible or invisible. |
|
552 | 556 | |
|
553 | 557 | \sa QPieSlice::isLabelVisible(), QPieSlice::setLabelVisible() |
|
554 | 558 | */ |
|
555 | 559 | void QPieSeries::setLabelsVisible(bool visible) |
|
556 | 560 | { |
|
557 | 561 | Q_D(QPieSeries); |
|
558 | 562 | foreach (QPieSlice* s, d->m_slices) |
|
559 | 563 | s->setLabelVisible(visible); |
|
560 | 564 | } |
|
561 | 565 | |
|
562 | 566 | /*! |
|
563 | 567 | Returns the sum of all slice values in this series. |
|
564 | 568 | |
|
565 | 569 | \sa QPieSlice::value(), QPieSlice::setValue() |
|
566 | 570 | */ |
|
567 | 571 | qreal QPieSeries::total() const |
|
568 | 572 | { |
|
569 | 573 | Q_D(const QPieSeries); |
|
570 | 574 | return d->m_total; |
|
571 | 575 | } |
|
572 | 576 | |
|
573 | 577 | /*! |
|
574 | \fn void QPieSeries::clicked(QPieSlice* slice) | |
|
578 | \fn void QPieSeries::clicked(QPieSlice* slice, Qt::MouseButtons buttons) | |
|
575 | 579 | |
|
576 | This signal is emitted when a \a slice has been clicked. | |
|
580 | This signal is emitted when a \a slice has been clicked with mouse \a buttons. | |
|
577 | 581 | |
|
578 | 582 | \sa QPieSlice::clicked() |
|
579 | 583 | */ |
|
580 | 584 | |
|
581 | 585 | /*! |
|
582 | 586 | \fn void QPieSeries::hoverEnter(QPieSlice* slice) |
|
583 | 587 | |
|
584 | 588 | This signal is emitted when user has hovered over a \a slice. |
|
585 | 589 | |
|
586 | 590 | \sa QPieSlice::hoverEnter() |
|
587 | 591 | */ |
|
588 | 592 | |
|
589 | 593 | /*! |
|
590 | 594 | \fn void QPieSeries::hoverLeave(QPieSlice* slice) |
|
591 | 595 | |
|
592 | 596 | This signal is emitted when user has hovered away from a \a slice. |
|
593 | 597 | |
|
594 | 598 | \sa QPieSlice::hoverLeave() |
|
595 | 599 | */ |
|
596 | 600 | |
|
601 | /*! | |
|
602 | \fn void QPieSeries::added(QList<QPieSlice*> slices) | |
|
603 | ||
|
604 | This signal is emitted when \a slices has been added to the series. | |
|
605 | ||
|
606 | \sa append(), insert() | |
|
607 | */ | |
|
608 | ||
|
609 | /*! | |
|
610 | \fn void QPieSeries::removed(QList<QPieSlice*> slices) | |
|
611 | ||
|
612 | This signal is emitted when \a slices has been removed from the series. | |
|
613 | ||
|
614 | \sa remove(), clear() | |
|
615 | */ | |
|
616 | ||
|
617 | /*! | |
|
618 | \fn void QPieSeries::piePositionChanged() | |
|
619 | ||
|
620 | This signal is emitted when pie position has changed. | |
|
621 | ||
|
622 | \sa setPiePosition(), pieVerticalPosition(), pieHorizontalPosition() | |
|
623 | */ | |
|
624 | ||
|
625 | /*! | |
|
626 | \fn void QPieSeries::pieSizeChanged() | |
|
597 | 627 |
|
|
628 | This signal is emitted when pie size has changed. | |
|
598 | 629 |
|
|
630 | \sa pieSize(), setPieSize() | |
|
631 | */ | |
|
599 | 632 | |
|
600 | 633 | bool QPieSeries::setModel(QAbstractItemModel* model) |
|
601 | 634 | { |
|
602 | 635 | Q_D(QPieSeries); |
|
603 | 636 | // disconnect signals from old model |
|
604 | 637 | if(m_model) |
|
605 | 638 | { |
|
606 | 639 | disconnect(m_model, 0, this, 0); |
|
607 | 640 | d->m_mapValues = -1; |
|
608 | 641 | d->m_mapLabels = -1; |
|
609 | 642 | d->m_mapOrientation = Qt::Vertical; |
|
610 | 643 | } |
|
611 | 644 | |
|
612 | 645 | // set new model |
|
613 | 646 | if(model) |
|
614 | 647 | { |
|
615 | 648 | m_model = model; |
|
616 | 649 | return true; |
|
617 | 650 | } |
|
618 | 651 | else |
|
619 | 652 | { |
|
620 | 653 | m_model = NULL; |
|
621 | 654 | return false; |
|
622 | 655 | } |
|
623 | 656 | } |
|
624 | 657 | |
|
625 | 658 | void QPieSeries::setModelMapping(int modelValuesLine, int modelLabelsLine, Qt::Orientation orientation) |
|
626 | 659 | { |
|
627 | 660 | Q_D(QPieSeries); |
|
628 | 661 | |
|
629 | 662 | if (m_model == NULL) |
|
630 | 663 | return; |
|
631 | 664 | |
|
632 | 665 | d->m_mapValues = modelValuesLine; |
|
633 | 666 | d->m_mapLabels = modelLabelsLine; |
|
634 | 667 | d->m_mapOrientation = orientation; |
|
635 | 668 | |
|
636 | 669 | // connect the signals |
|
637 | 670 | if (d->m_mapOrientation == Qt::Vertical) { |
|
638 | 671 | connect(m_model, SIGNAL(dataChanged(QModelIndex,QModelIndex)), d, SLOT(modelUpdated(QModelIndex, QModelIndex))); |
|
639 | 672 | connect(m_model, SIGNAL(rowsInserted(QModelIndex, int, int)), d, SLOT(modelDataAdded(QModelIndex,int,int))); |
|
640 | 673 | connect(m_model, SIGNAL(rowsRemoved(QModelIndex, int, int)), d, SLOT(modelDataRemoved(QModelIndex,int,int))); |
|
641 | 674 | } else { |
|
642 | 675 | connect(m_model, SIGNAL(dataChanged(QModelIndex,QModelIndex)), d, SLOT(modelUpdated(QModelIndex, QModelIndex))); |
|
643 | 676 | connect(m_model, SIGNAL(columnsInserted(QModelIndex, int, int)), d, SLOT(modelDataAdded(QModelIndex,int,int))); |
|
644 | 677 | connect(m_model, SIGNAL(columnsRemoved(QModelIndex, int, int)), d, SLOT(modelDataRemoved(QModelIndex,int,int))); |
|
645 | 678 | } |
|
646 | 679 | |
|
647 | 680 | // create the initial slices set |
|
648 | 681 | if (d->m_mapOrientation == Qt::Vertical) { |
|
649 | 682 | for (int i = 0; i < m_model->rowCount(); i++) |
|
650 | 683 | append(m_model->data(m_model->index(i, d->m_mapValues), Qt::DisplayRole).toDouble(), m_model->data(m_model->index(i, d->m_mapLabels), Qt::DisplayRole).toString()); |
|
651 | 684 | } else { |
|
652 | 685 | for (int i = 0; i < m_model->columnCount(); i++) |
|
653 | 686 | append(m_model->data(m_model->index(d->m_mapValues, i), Qt::DisplayRole).toDouble(), m_model->data(m_model->index(d->m_mapLabels, i), Qt::DisplayRole).toString()); |
|
654 | 687 | } |
|
655 | 688 | } |
|
656 | 689 | |
|
657 | 690 | #include "moc_qpieseries.cpp" |
|
658 | 691 | #include "moc_qpieseriesprivate_p.cpp" |
|
659 | 692 | |
|
660 | 693 | QTCOMMERCIALCHART_END_NAMESPACE |
@@ -1,100 +1,100 | |||
|
1 | 1 | /**************************************************************************** |
|
2 | 2 | ** |
|
3 | 3 | ** Copyright (C) 2012 Digia Plc |
|
4 | 4 | ** All rights reserved. |
|
5 | 5 | ** For any questions to Digia, please use contact form at http://qt.digia.com |
|
6 | 6 | ** |
|
7 | 7 | ** This file is part of the Qt Commercial Charts Add-on. |
|
8 | 8 | ** |
|
9 | 9 | ** $QT_BEGIN_LICENSE$ |
|
10 | 10 | ** Licensees holding valid Qt Commercial licenses may use this file in |
|
11 | 11 | ** accordance with the Qt Commercial License Agreement provided with the |
|
12 | 12 | ** Software or, alternatively, in accordance with the terms contained in |
|
13 | 13 | ** a written agreement between you and Digia. |
|
14 | 14 | ** |
|
15 | 15 | ** If you have questions regarding the use of this file, please use |
|
16 | 16 | ** contact form at http://qt.digia.com |
|
17 | 17 | ** $QT_END_LICENSE$ |
|
18 | 18 | ** |
|
19 | 19 | ****************************************************************************/ |
|
20 | 20 | |
|
21 | 21 | #ifndef PIESERIES_H |
|
22 | 22 | #define PIESERIES_H |
|
23 | 23 | |
|
24 | 24 | #include <qseries.h> |
|
25 | 25 | |
|
26 | 26 | QTCOMMERCIALCHART_BEGIN_NAMESPACE |
|
27 | 27 | class QPieSeriesPrivate; |
|
28 | 28 | class QPieSlice; |
|
29 | 29 | |
|
30 | 30 | class QTCOMMERCIALCHART_EXPORT QPieSeries : public QSeries |
|
31 | 31 | { |
|
32 | 32 | Q_OBJECT |
|
33 | 33 | |
|
34 | 34 | public: |
|
35 | 35 | QPieSeries(QObject *parent = 0); |
|
36 | 36 | virtual ~QPieSeries(); |
|
37 | 37 | |
|
38 | 38 | public: // from QChartSeries |
|
39 | 39 | QSeriesType type() const; |
|
40 | 40 | |
|
41 | 41 | public: |
|
42 | 42 | |
|
43 | 43 | // slice setters |
|
44 | 44 | void append(QPieSlice* slice); |
|
45 | 45 | void append(QList<QPieSlice*> slices); |
|
46 | void insert(int i, QPieSlice* slice); | |
|
46 | void insert(int index, QPieSlice* slice); | |
|
47 | 47 | void replace(QList<QPieSlice*> slices); |
|
48 | 48 | void remove(QPieSlice* slice); |
|
49 | 49 | void clear(); |
|
50 | 50 | |
|
51 | 51 | // slice getters |
|
52 | 52 | QList<QPieSlice*> slices() const; |
|
53 | 53 | |
|
54 | 54 | // calculated data |
|
55 | 55 | int count() const; |
|
56 | 56 | bool isEmpty() const; |
|
57 | 57 | qreal total() const; |
|
58 | 58 | |
|
59 | 59 | // pie customization |
|
60 | 60 | void setPiePosition(qreal relativeHorizontalPosition, qreal relativeVerticalPosition); |
|
61 | 61 | qreal pieHorizontalPosition() const; |
|
62 | 62 | qreal pieVerticalPosition() const; |
|
63 | 63 | void setPieSize(qreal relativeSize); |
|
64 | 64 | qreal pieSize() const; |
|
65 | 65 | void setPieStartAngle(qreal startAngle); |
|
66 | 66 | qreal pieStartAngle() const; |
|
67 | 67 | void setPieEndAngle(qreal endAngle); |
|
68 | 68 | qreal pieEndAngle() const; |
|
69 | 69 | |
|
70 | 70 | // convenience function |
|
71 | 71 | QPieSeries& operator << (QPieSlice* slice); |
|
72 | 72 | QPieSlice* append(qreal value, QString name); |
|
73 | 73 | void setLabelsVisible(bool visible = true); |
|
74 | 74 | |
|
75 | 75 | // data from model |
|
76 | 76 | bool setModel(QAbstractItemModel* model); |
|
77 | 77 | void setModelMapping(int modelValuesLine, int modelLabelsLine, Qt::Orientation orientation = Qt::Vertical); |
|
78 | 78 | |
|
79 | 79 | Q_SIGNALS: |
|
80 | 80 | void clicked(QPieSlice* slice, Qt::MouseButtons buttons); |
|
81 | 81 | void hoverEnter(QPieSlice* slice); |
|
82 | 82 | void hoverLeave(QPieSlice* slice); |
|
83 | 83 | void added(QList<QPieSlice*> slices); |
|
84 | 84 | void removed(QList<QPieSlice*> slices); |
|
85 | 85 | void piePositionChanged(); |
|
86 | 86 | void pieSizeChanged(); |
|
87 | 87 | |
|
88 | 88 | private: |
|
89 | 89 | QPieSeriesPrivate * const d_ptr; |
|
90 | 90 | Q_DECLARE_PRIVATE(QPieSeries) |
|
91 | 91 | Q_DISABLE_COPY(QPieSeries) |
|
92 | 92 | |
|
93 | 93 | public: |
|
94 | 94 | typedef QPieSeriesPrivate * const DataPtr; |
|
95 | 95 | inline DataPtr &data_ptr() { return d_ptr; } |
|
96 | 96 | }; |
|
97 | 97 | |
|
98 | 98 | QTCOMMERCIALCHART_END_NAMESPACE |
|
99 | 99 | |
|
100 | 100 | #endif // PIESERIES_H |
@@ -1,433 +1,433 | |||
|
1 | 1 | /**************************************************************************** |
|
2 | 2 | ** |
|
3 | 3 | ** Copyright (C) 2012 Digia Plc |
|
4 | 4 | ** All rights reserved. |
|
5 | 5 | ** For any questions to Digia, please use contact form at http://qt.digia.com |
|
6 | 6 | ** |
|
7 | 7 | ** This file is part of the Qt Commercial Charts Add-on. |
|
8 | 8 | ** |
|
9 | 9 | ** $QT_BEGIN_LICENSE$ |
|
10 | 10 | ** Licensees holding valid Qt Commercial licenses may use this file in |
|
11 | 11 | ** accordance with the Qt Commercial License Agreement provided with the |
|
12 | 12 | ** Software or, alternatively, in accordance with the terms contained in |
|
13 | 13 | ** a written agreement between you and Digia. |
|
14 | 14 | ** |
|
15 | 15 | ** If you have questions regarding the use of this file, please use |
|
16 | 16 | ** contact form at http://qt.digia.com |
|
17 | 17 | ** $QT_END_LICENSE$ |
|
18 | 18 | ** |
|
19 | 19 | ****************************************************************************/ |
|
20 | 20 | |
|
21 | 21 | #include "qpieslice.h" |
|
22 | 22 | #include "qpiesliceprivate_p.h" |
|
23 | 23 | #include "qpieseries.h" |
|
24 | 24 | #include "qpieseriesprivate_p.h" |
|
25 | 25 | |
|
26 | 26 | QTCOMMERCIALCHART_BEGIN_NAMESPACE |
|
27 | 27 | |
|
28 | 28 | /*! |
|
29 | 29 | \class QPieSlice |
|
30 | 30 | \brief Defines a slice in pie series. |
|
31 | 31 | |
|
32 | 32 | Holds all the data of a single slice in a QPieSeries and provides the means |
|
33 | 33 | to modify slice data and customize the visual appearance of the slice. |
|
34 | 34 | |
|
35 | 35 | It also provides the means to customize user interaction with the slice by |
|
36 | 36 | providing signals for clicking and hover events. |
|
37 | 37 | */ |
|
38 | 38 | |
|
39 | 39 | /*! |
|
40 | 40 | \property QPieSlice::label |
|
41 | 41 | |
|
42 | 42 | Label of the slice. |
|
43 | 43 | */ |
|
44 | 44 | |
|
45 | 45 | /*! |
|
46 | 46 | \property QPieSlice::value |
|
47 | 47 | |
|
48 | 48 | Value of the slice. |
|
49 | 49 | */ |
|
50 | 50 | |
|
51 | 51 | /*! |
|
52 | 52 | Constructs an empty slice with a \a parent. |
|
53 | 53 | |
|
54 | 54 | Note that QPieSeries takes ownership of the slice when it is set/added. |
|
55 | 55 | |
|
56 | 56 | \sa QPieSeries::replace(), QPieSeries::append() |
|
57 | 57 | */ |
|
58 | 58 | QPieSlice::QPieSlice(QObject *parent) |
|
59 | 59 | :QObject(parent), |
|
60 | 60 | d_ptr(new QPieSlicePrivate(this)) |
|
61 | 61 | { |
|
62 | 62 | |
|
63 | 63 | } |
|
64 | 64 | |
|
65 | 65 | /*! |
|
66 | 66 | Constructs an empty slice with given \a value, \a label and a \a parent. |
|
67 | 67 | Note that QPieSeries takes ownership of the slice when it is set/added. |
|
68 | 68 | \sa QPieSeries::replace(), QPieSeries::append() |
|
69 | 69 | */ |
|
70 | 70 | QPieSlice::QPieSlice(qreal value, QString label, QObject *parent) |
|
71 | 71 | :QObject(parent), |
|
72 | 72 | d_ptr(new QPieSlicePrivate(this)) |
|
73 | 73 | { |
|
74 | 74 | Q_D(QPieSlice); |
|
75 | 75 | d->m_data.m_value = value; |
|
76 | 76 | d->m_data.m_labelText = label; |
|
77 | 77 | } |
|
78 | 78 | |
|
79 | 79 | /*! |
|
80 | 80 | Destroys the slice. |
|
81 | 81 | User should not delete the slice if it has been added to the series. |
|
82 | 82 | */ |
|
83 | 83 | QPieSlice::~QPieSlice() |
|
84 | 84 | { |
|
85 | 85 | delete d_ptr; |
|
86 | 86 | } |
|
87 | 87 | |
|
88 | 88 | /*! |
|
89 | 89 | Gets the value of the slice. |
|
90 | 90 | Note that all values in the series |
|
91 | 91 | \sa setValue() |
|
92 | 92 | */ |
|
93 | 93 | qreal QPieSlice::value() const |
|
94 | 94 | { |
|
95 | 95 | Q_D(const QPieSlice); |
|
96 | 96 | return d->m_data.m_value; |
|
97 | 97 | } |
|
98 | 98 | |
|
99 | 99 | /*! |
|
100 | 100 | Gets the label of the slice. |
|
101 | 101 | \sa setLabel() |
|
102 | 102 | */ |
|
103 | 103 | QString QPieSlice::label() const |
|
104 | 104 | { |
|
105 | 105 | Q_D(const QPieSlice); |
|
106 | 106 | return d->m_data.m_labelText; |
|
107 | 107 | } |
|
108 | 108 | |
|
109 | 109 | /*! |
|
110 | 110 | Returns true if label is set as visible. |
|
111 | 111 | \sa setLabelVisible() |
|
112 | 112 | */ |
|
113 | 113 | bool QPieSlice::isLabelVisible() const |
|
114 | 114 | { |
|
115 | 115 | Q_D(const QPieSlice); |
|
116 | 116 | return d->m_data.m_isLabelVisible; |
|
117 | 117 | } |
|
118 | 118 | |
|
119 | 119 | /*! |
|
120 | 120 | Returns true if slice is exloded from the pie. |
|
121 | 121 | \sa setExploded(), setExplodeDistanceFactor() |
|
122 | 122 | */ |
|
123 | 123 | bool QPieSlice::isExploded() const |
|
124 | 124 | { |
|
125 | 125 | Q_D(const QPieSlice); |
|
126 | 126 | return d->m_data.m_isExploded; |
|
127 | 127 | } |
|
128 | 128 | |
|
129 | 129 | /*! |
|
130 | 130 | Returns the explode distance factor. |
|
131 | 131 | |
|
132 | 132 | The factor is relative to pie radius. For example: |
|
133 | 133 | 1.0 means the distance is the same as the radius. |
|
134 | 134 | 0.5 means the distance is half of the radius. |
|
135 | 135 | |
|
136 | 136 | Default value is 0.15. |
|
137 | 137 | |
|
138 | 138 | \sa setExplodeDistanceFactor() |
|
139 | 139 | */ |
|
140 | 140 | qreal QPieSlice::explodeDistanceFactor() const |
|
141 | 141 | { |
|
142 | 142 | Q_D(const QPieSlice); |
|
143 | 143 | return d->m_data.m_explodeDistanceFactor; |
|
144 | 144 | } |
|
145 | 145 | |
|
146 | 146 | /*! |
|
147 | 147 | Returns the percentage of this slice compared to all slices in the same series. |
|
148 | 148 | The returned value ranges from 0 to 1.0. |
|
149 | 149 | |
|
150 | 150 | Updated internally after the slice is added to the series. |
|
151 | 151 | */ |
|
152 | 152 | qreal QPieSlice::percentage() const |
|
153 | 153 | { |
|
154 | 154 | Q_D(const QPieSlice); |
|
155 | 155 | return d->m_data.m_percentage; |
|
156 | 156 | } |
|
157 | 157 | |
|
158 | 158 | /*! |
|
159 | 159 | Returns the starting angle of this slice in the series it belongs to. |
|
160 | 160 | |
|
161 | 161 | Full pie is 360 degrees where 0 degrees is at 12 a'clock. |
|
162 | 162 | |
|
163 | 163 | Updated internally after the slice is added to the series. |
|
164 | 164 | */ |
|
165 | 165 | qreal QPieSlice::startAngle() const |
|
166 | 166 | { |
|
167 | 167 | Q_D(const QPieSlice); |
|
168 | 168 | return d->m_data.m_startAngle; |
|
169 | 169 | } |
|
170 | 170 | |
|
171 | 171 | /*! |
|
172 | 172 | Returns the end angle of this slice in the series it belongs to. |
|
173 | 173 | |
|
174 | 174 | Full pie is 360 degrees where 0 degrees is at 12 a'clock. |
|
175 | 175 | |
|
176 | 176 | Updated internally after the slice is added to the series. |
|
177 | 177 | */ |
|
178 | 178 | qreal QPieSlice::endAngle() const |
|
179 | 179 | { |
|
180 | 180 | Q_D(const QPieSlice); |
|
181 | 181 | return d->m_data.m_startAngle + d->m_data.m_angleSpan; |
|
182 | 182 | } |
|
183 | 183 | |
|
184 | 184 | /*! |
|
185 | 185 | Returns the pen used to draw this slice. |
|
186 |
\sa set |
|
|
186 | \sa setPen() | |
|
187 | 187 | */ |
|
188 | 188 | QPen QPieSlice::pen() const |
|
189 | 189 | { |
|
190 | 190 | Q_D(const QPieSlice); |
|
191 | 191 | return d->m_data.m_slicePen; |
|
192 | 192 | } |
|
193 | 193 | |
|
194 | 194 | /*! |
|
195 | 195 | Returns the brush used to draw this slice. |
|
196 |
\sa set |
|
|
196 | \sa setBrush() | |
|
197 | 197 | */ |
|
198 | 198 | QBrush QPieSlice::brush() const |
|
199 | 199 | { |
|
200 | 200 | Q_D(const QPieSlice); |
|
201 | 201 | return d->m_data.m_sliceBrush; |
|
202 | 202 | } |
|
203 | 203 | |
|
204 | 204 | /*! |
|
205 | 205 | Returns the pen used to draw the label in this slice. |
|
206 |
\sa setLabel |
|
|
206 | \sa setLabelPen() | |
|
207 | 207 | */ |
|
208 | 208 | QPen QPieSlice::labelPen() const |
|
209 | 209 | { |
|
210 | 210 | Q_D(const QPieSlice); |
|
211 | 211 | return d->m_data.m_labelPen; |
|
212 | 212 | } |
|
213 | 213 | |
|
214 | 214 | /*! |
|
215 | 215 | Returns the font used to draw label in this slice. |
|
216 | 216 | \sa setLabelFont() |
|
217 | 217 | */ |
|
218 | 218 | QFont QPieSlice::labelFont() const |
|
219 | 219 | { |
|
220 | 220 | Q_D(const QPieSlice); |
|
221 | 221 | return d->m_data.m_labelFont; |
|
222 | 222 | } |
|
223 | 223 | |
|
224 | 224 | /*! |
|
225 | 225 | Gets the label arm length factor. |
|
226 | 226 | |
|
227 | 227 | The factor is relative to pie radius. For example: |
|
228 | 228 | 1.0 means the length is the same as the radius. |
|
229 | 229 | 0.5 means the length is half of the radius. |
|
230 | 230 | |
|
231 | 231 | Default value is 0.15 |
|
232 | 232 | |
|
233 | 233 | \sa setLabelArmLengthFactor() |
|
234 | 234 | */ |
|
235 | 235 | qreal QPieSlice::labelArmLengthFactor() const |
|
236 | 236 | { |
|
237 | 237 | Q_D(const QPieSlice); |
|
238 | 238 | return d->m_data.m_labelArmLengthFactor; |
|
239 | 239 | } |
|
240 | 240 | |
|
241 | 241 | /*! |
|
242 | \fn void QPieSlice::clicked() | |
|
242 | \fn void QPieSlice::clicked(Qt::MouseButtons buttons) | |
|
243 | 243 | |
|
244 | 244 | This signal is emitted when user has clicked the slice. |
|
245 | 245 | |
|
246 | 246 | \sa QPieSeries::clicked() |
|
247 | 247 | */ |
|
248 | 248 | |
|
249 | 249 | /*! |
|
250 | 250 | \fn void QPieSlice::hoverEnter() |
|
251 | 251 | |
|
252 | 252 | This signal is emitted when user has hovered over the slice. |
|
253 | 253 | |
|
254 | 254 | \sa QPieSeries::hoverEnter() |
|
255 | 255 | */ |
|
256 | 256 | |
|
257 | 257 | /*! |
|
258 | 258 | \fn void QPieSlice::hoverLeave() |
|
259 | 259 | |
|
260 | 260 | This signal is emitted when user has hovered away from the slice. |
|
261 | 261 | |
|
262 | 262 | \sa QPieSeries::hoverLeave() |
|
263 | 263 | */ |
|
264 | 264 | |
|
265 | 265 | /*! |
|
266 | 266 | \fn void QPieSlice::changed() |
|
267 | 267 | |
|
268 | 268 | This signal emitted when something has changed in the slice. |
|
269 | 269 | |
|
270 | 270 | \sa QPieSeries::changed() |
|
271 | 271 | */ |
|
272 | 272 | |
|
273 | 273 | /*! |
|
274 | 274 | Sets the \a value of this slice. |
|
275 | 275 | \sa value() |
|
276 | 276 | */ |
|
277 | 277 | void QPieSlice::setValue(qreal value) |
|
278 | 278 | { |
|
279 | 279 | Q_D(QPieSlice); |
|
280 | 280 | if (!qFuzzyIsNull(d->m_data.m_value - value)) { |
|
281 | 281 | d->m_data.m_value = value; |
|
282 | 282 | |
|
283 | 283 | QPieSeries *series = qobject_cast<QPieSeries*>(parent()); |
|
284 | 284 | if (series) |
|
285 | 285 | series->data_ptr()->updateDerivativeData(); // will emit changed() |
|
286 | 286 | else |
|
287 | 287 | emit changed(); |
|
288 | 288 | } |
|
289 | 289 | } |
|
290 | 290 | |
|
291 | 291 | /*! |
|
292 | 292 | Sets the \a label of the slice. |
|
293 | 293 | \sa label() |
|
294 | 294 | */ |
|
295 | 295 | void QPieSlice::setLabel(QString label) |
|
296 | 296 | { |
|
297 | 297 | Q_D(QPieSlice); |
|
298 | 298 | if (d->m_data.m_labelText != label) { |
|
299 | 299 | d->m_data.m_labelText = label; |
|
300 | 300 | emit changed(); |
|
301 | 301 | } |
|
302 | 302 | } |
|
303 | 303 | |
|
304 | 304 | /*! |
|
305 | 305 | Sets the label \a visible in this slice. |
|
306 | 306 | \sa isLabelVisible(), QPieSeries::setLabelsVisible() |
|
307 | 307 | */ |
|
308 | 308 | void QPieSlice::setLabelVisible(bool visible) |
|
309 | 309 | { |
|
310 | 310 | Q_D(QPieSlice); |
|
311 | 311 | if (d->m_data.m_isLabelVisible != visible) { |
|
312 | 312 | d->m_data.m_isLabelVisible = visible; |
|
313 | 313 | emit changed(); |
|
314 | 314 | } |
|
315 | 315 | } |
|
316 | 316 | |
|
317 | 317 | /*! |
|
318 | 318 | Sets this slice \a exploded. |
|
319 | 319 | \sa isExploded(), explodeDistanceFactor() |
|
320 | 320 | */ |
|
321 | 321 | void QPieSlice::setExploded(bool exploded) |
|
322 | 322 | { |
|
323 | 323 | Q_D(QPieSlice); |
|
324 | 324 | if (d->m_data.m_isExploded != exploded) { |
|
325 | 325 | d->m_data.m_isExploded = exploded; |
|
326 | 326 | emit changed(); |
|
327 | 327 | } |
|
328 | 328 | } |
|
329 | 329 | |
|
330 | 330 | /*! |
|
331 | 331 | Sets the explode distance \a factor. |
|
332 | 332 | |
|
333 | 333 | The factor is relative to pie radius. For example: |
|
334 | 334 | 1.0 means the distance is the same as the radius. |
|
335 | 335 | 0.5 means the distance is half of the radius. |
|
336 | 336 | |
|
337 | 337 | Default value is 0.15 |
|
338 | 338 | |
|
339 | 339 | \sa explodeDistanceFactor() |
|
340 | 340 | */ |
|
341 | 341 | void QPieSlice::setExplodeDistanceFactor(qreal factor) |
|
342 | 342 | { |
|
343 | 343 | Q_D(QPieSlice); |
|
344 | 344 | if (!qFuzzyIsNull(d->m_data.m_explodeDistanceFactor - factor)) { |
|
345 | 345 | d->m_data.m_explodeDistanceFactor = factor; |
|
346 | 346 | emit changed(); |
|
347 | 347 | } |
|
348 | 348 | } |
|
349 | 349 | |
|
350 | 350 | /*! |
|
351 | 351 | Sets the \a pen used to draw this slice. |
|
352 | 352 | Note that applying a theme will override this. |
|
353 |
\sa |
|
|
353 | \sa pen() | |
|
354 | 354 | */ |
|
355 | 355 | void QPieSlice::setPen(const QPen &pen) |
|
356 | 356 | { |
|
357 | 357 | Q_D(QPieSlice); |
|
358 | 358 | if (d->m_data.m_slicePen != pen) { |
|
359 | 359 | d->m_data.m_slicePen = pen; |
|
360 | 360 | d->m_data.m_slicePen.setThemed(false); |
|
361 | 361 | emit changed(); |
|
362 | 362 | } |
|
363 | 363 | } |
|
364 | 364 | |
|
365 | 365 | /*! |
|
366 | 366 | Sets the \a brush used to draw this slice. |
|
367 | 367 | Note that applying a theme will override this. |
|
368 |
\sa |
|
|
368 | \sa brush() | |
|
369 | 369 | */ |
|
370 | 370 | void QPieSlice::setBrush(const QBrush &brush) |
|
371 | 371 | { |
|
372 | 372 | Q_D(QPieSlice); |
|
373 | 373 | if (d->m_data.m_sliceBrush != brush) { |
|
374 | 374 | d->m_data.m_sliceBrush = brush; |
|
375 | 375 | d->m_data.m_sliceBrush.setThemed(false); |
|
376 | 376 | emit changed(); |
|
377 | 377 | } |
|
378 | 378 | } |
|
379 | 379 | |
|
380 | 380 | /*! |
|
381 | 381 | Sets the \a pen used to draw the label in this slice. |
|
382 | 382 | Note that applying a theme will override this. |
|
383 |
\sa label |
|
|
383 | \sa labelPen() | |
|
384 | 384 | */ |
|
385 | 385 | void QPieSlice::setLabelPen(const QPen &pen) |
|
386 | 386 | { |
|
387 | 387 | Q_D(QPieSlice); |
|
388 | 388 | if (d->m_data.m_labelPen != pen) { |
|
389 | 389 | d->m_data.m_labelPen = pen; |
|
390 | 390 | d->m_data.m_labelPen.setThemed(false); |
|
391 | 391 | emit changed(); |
|
392 | 392 | } |
|
393 | 393 | } |
|
394 | 394 | |
|
395 | 395 | /*! |
|
396 | 396 | Sets the \a font used to draw the label in this slice. |
|
397 | 397 | Note that applying a theme will override this. |
|
398 | 398 | \sa labelFont() |
|
399 | 399 | */ |
|
400 | 400 | void QPieSlice::setLabelFont(const QFont &font) |
|
401 | 401 | { |
|
402 | 402 | Q_D(QPieSlice); |
|
403 | 403 | if (d->m_data.m_labelFont != font) { |
|
404 | 404 | d->m_data.m_labelFont = font; |
|
405 | 405 | d->m_data.m_labelFont.setThemed(false); |
|
406 | 406 | emit changed(); |
|
407 | 407 | } |
|
408 | 408 | } |
|
409 | 409 | |
|
410 | 410 | /*! |
|
411 | 411 | Sets the label arm length \a factor. |
|
412 | 412 | |
|
413 | 413 | The factor is relative to pie radius. For example: |
|
414 | 414 | 1.0 means the length is the same as the radius. |
|
415 | 415 | 0.5 means the length is half of the radius. |
|
416 | 416 | |
|
417 | 417 | Default value is 0.15 |
|
418 | 418 | |
|
419 | 419 | \sa labelArmLengthFactor() |
|
420 | 420 | */ |
|
421 | 421 | void QPieSlice::setLabelArmLengthFactor(qreal factor) |
|
422 | 422 | { |
|
423 | 423 | Q_D(QPieSlice); |
|
424 | 424 | if (!qFuzzyIsNull(d->m_data.m_labelArmLengthFactor - factor)) { |
|
425 | 425 | d->m_data.m_labelArmLengthFactor = factor; |
|
426 | 426 | emit changed(); |
|
427 | 427 | } |
|
428 | 428 | } |
|
429 | 429 | |
|
430 | 430 | #include "moc_qpieslice.cpp" |
|
431 | 431 | #include "moc_qpiesliceprivate_p.cpp" |
|
432 | 432 | |
|
433 | 433 | QTCOMMERCIALCHART_END_NAMESPACE |
@@ -1,87 +1,87 | |||
|
1 | 1 | /**************************************************************************** |
|
2 | 2 | ** |
|
3 | 3 | ** Copyright (C) 2012 Digia Plc |
|
4 | 4 | ** All rights reserved. |
|
5 | 5 | ** For any questions to Digia, please use contact form at http://qt.digia.com |
|
6 | 6 | ** |
|
7 | 7 | ** This file is part of the Qt Commercial Charts Add-on. |
|
8 | 8 | ** |
|
9 | 9 | ** $QT_BEGIN_LICENSE$ |
|
10 | 10 | ** Licensees holding valid Qt Commercial licenses may use this file in |
|
11 | 11 | ** accordance with the Qt Commercial License Agreement provided with the |
|
12 | 12 | ** Software or, alternatively, in accordance with the terms contained in |
|
13 | 13 | ** a written agreement between you and Digia. |
|
14 | 14 | ** |
|
15 | 15 | ** If you have questions regarding the use of this file, please use |
|
16 | 16 | ** contact form at http://qt.digia.com |
|
17 | 17 | ** $QT_END_LICENSE$ |
|
18 | 18 | ** |
|
19 | 19 | ****************************************************************************/ |
|
20 | 20 | |
|
21 | 21 | #include "qseries.h" |
|
22 | 22 | |
|
23 | 23 | /*! |
|
24 | 24 | \class QSeries |
|
25 | 25 | \brief Base class for all QtCommercial Chart series. |
|
26 | 26 | \mainclass |
|
27 | 27 | |
|
28 | 28 | Usually you use the series type specific inherited classes instead of the base class. |
|
29 | 29 | \sa QScatterSeries |
|
30 | 30 | */ |
|
31 | 31 | |
|
32 | 32 | /*! |
|
33 | 33 | \enum QSeries::QSeriesType |
|
34 | 34 | |
|
35 | 35 | The type of the series object. |
|
36 | 36 | |
|
37 | 37 | \value SeriesTypeLine |
|
38 | 38 | \value SeriesTypeArea |
|
39 | 39 | \value SeriesTypeBar |
|
40 | 40 | \value SeriesTypeStackedBar |
|
41 | 41 | \value SeriesTypePercentBar |
|
42 | 42 | \value SeriesTypePie |
|
43 | 43 | \value SeriesTypeScatter |
|
44 | 44 | \value SeriesTypeSpline |
|
45 | 45 | */ |
|
46 | 46 | |
|
47 | 47 | /*! |
|
48 | 48 | \fn QSeries::QSeries(QObject *parent) |
|
49 | 49 | \brief Constructs ChartSeries object with \a parent. |
|
50 | 50 | */ |
|
51 | 51 | |
|
52 | 52 | /*! |
|
53 | 53 | \fn QSeries::~QSeries() |
|
54 | 54 | \brief Virtual destructor for the chart series. |
|
55 | 55 | */ |
|
56 | 56 | |
|
57 | 57 | /*! |
|
58 | 58 | \fn QSeriesType QSeries::type() const |
|
59 | 59 | \brief The type of the series. |
|
60 | 60 | */ |
|
61 | 61 | |
|
62 | 62 | /*! |
|
63 | 63 | \fn bool QSeries::setModel(QAbstractItemModel *model) |
|
64 | 64 | \brief Use the \a model to provide data for the series. The model overrides possible user data |
|
65 | 65 | set with QChartSeries type specific data setters. For example if you call both |
|
66 | 66 | QScatterSeries::addData() and QScatterSeries::setModel, only the data provided by the model is |
|
67 | 67 | used by the series. Returns true if the model is valid for the series. |
|
68 | 68 | */ |
|
69 | 69 | |
|
70 | 70 | /*! |
|
71 | 71 | \fn void QSeries::setName(QString name) |
|
72 | 72 | \brief Sets a \a name for the series. |
|
73 | 73 | |
|
74 | 74 | The name of a series is shown in the legend for QXYSeries. |
|
75 | 75 | \sa QChart::setTitle() |
|
76 |
\sa QPieSlice::set |
|
|
76 | \sa QPieSlice::setLabel() | |
|
77 | 77 | \sa QBarSet::setName() |
|
78 | 78 | */ |
|
79 | 79 | |
|
80 | 80 | /*! |
|
81 | 81 | \fn QString QSeries::name() |
|
82 | 82 | \brief Returns the name of the series. |
|
83 | 83 | */ |
|
84 | 84 | |
|
85 | 85 | QTCOMMERCIALCHART_BEGIN_NAMESPACE |
|
86 | 86 | #include "moc_qseries.cpp" |
|
87 | 87 | QTCOMMERCIALCHART_END_NAMESPACE |
General Comments 0
You need to be logged in to leave comments.
Login now