qpolarchart.cpp
142 lines
| 5.2 KiB
| text/x-c
|
CppLexer
|
r2854 | /**************************************************************************** | ||
|
r2483 | ** | ||
|
r2854 | ** Copyright (C) 2016 The Qt Company Ltd. | ||
** Contact: https://www.qt.io/licensing/ | ||||
|
r2483 | ** | ||
|
r2854 | ** This file is part of the Qt Charts module of the Qt Toolkit. | ||
|
r2483 | ** | ||
|
r2854 | ** $QT_BEGIN_LICENSE:GPL$ | ||
|
r2845 | ** Commercial License Usage | ||
** Licensees holding valid commercial Qt licenses may use this file in | ||||
** accordance with the commercial license agreement provided with the | ||||
** Software or, alternatively, in accordance with the terms contained in | ||||
** a written agreement between you and The Qt Company. For licensing terms | ||||
|
r2854 | ** and conditions see https://www.qt.io/terms-conditions. For further | ||
** information use the contact form at https://www.qt.io/contact-us. | ||||
** | ||||
** GNU General Public License Usage | ||||
** Alternatively, this file may be used under the terms of the GNU | ||||
** General Public License version 3 or (at your option) any later version | ||||
** approved by the KDE Free Qt Foundation. The licenses are as published by | ||||
** the Free Software Foundation and appearing in the file LICENSE.GPL3 | ||||
** included in the packaging of this file. Please review the following | ||||
** information to ensure the GNU General Public License requirements will | ||||
** be met: https://www.gnu.org/licenses/gpl-3.0.html. | ||||
|
r2483 | ** | ||
|
r2845 | ** $QT_END_LICENSE$ | ||
** | ||||
|
r2854 | ****************************************************************************/ | ||
|
r2483 | |||
|
r2714 | #include <QtCharts/QPolarChart> | ||
#include <QtCharts/QAbstractAxis> | ||||
|
r2483 | |||
|
r2712 | QT_CHARTS_BEGIN_NAMESPACE | ||
|
r2483 | |||
/*! | ||||
\enum QPolarChart::PolarOrientation | ||||
|
r2494 | This type is used to specify the polar orientation of an axis. | ||
|
r2483 | |||
\value PolarOrientationRadial | ||||
\value PolarOrientationAngular | ||||
*/ | ||||
/*! | ||||
\class QPolarChart | ||||
|
r2639 | \inmodule Qt Charts | ||
|
r2591 | \brief Polar chart API for Qt Charts. | ||
|
r2483 | |||
QPolarChart is a specialization of QChart to show a polar chart. | ||||
Polar charts support line, spline, area, and scatter series, and all axis types | ||||
supported by those series. | ||||
\note When setting ticks to an angular QValueAxis, keep in mind that the first and last tick | ||||
are co-located at 0/360 degree angle. | ||||
\note If the angular distance between two consecutive points in a series is more than 180 degrees, | ||||
any line connecting the two points becomes meaningless, so choose the axis ranges accordingly | ||||
|
r2494 | when displaying line, spline, or area series. In such case series don't draw a direct line between | ||
the two points, but instead draw a line to and from the center of the chart. | ||||
|
r2483 | |||
|
r2547 | \note Polar charts draw all axes of same orientation in the same position, so using multiple | ||
axes of same orientation can be confusing, unless the extra axes are only used to customize the | ||||
grid (e.g. you can display a highlighted range with a secondary shaded QCategoryAxis or provide | ||||
unlabeled subticks with a secondary QValueAxis that has its labels hidden). | ||||
|
r2483 | |||
\sa QChart | ||||
*/ | ||||
/*! | ||||
|
r2494 | Constructs a polar chart as a child of the \a parent. | ||
|
r2483 | Parameter \a wFlags is passed to the QChart constructor. | ||
*/ | ||||
QPolarChart::QPolarChart(QGraphicsItem *parent, Qt::WindowFlags wFlags) | ||||
: QChart(QChart::ChartTypePolar, parent, wFlags) | ||||
{ | ||||
} | ||||
/*! | ||||
|
r2494 | Destroys the polar chart object and its children, like series and axis objects added to it. | ||
|
r2483 | */ | ||
QPolarChart::~QPolarChart() | ||||
{ | ||||
} | ||||
/*! | ||||
Returns the axes added for the \a series with \a polarOrientation. If no series is provided, then any axis with the | ||||
specified polar orientation is returned. | ||||
|
r2494 | |||
|
r2483 | \sa addAxis() | ||
*/ | ||||
QList<QAbstractAxis *> QPolarChart::axes(PolarOrientations polarOrientation, QAbstractSeries *series) const | ||||
{ | ||||
Qt::Orientations orientation(0); | ||||
if (polarOrientation.testFlag(PolarOrientationAngular)) | ||||
orientation |= Qt::Horizontal; | ||||
if (polarOrientation.testFlag(PolarOrientationRadial)) | ||||
orientation |= Qt::Vertical; | ||||
return QChart::axes(orientation, series); | ||||
} | ||||
/*! | ||||
This convenience method adds \a axis to the polar chart with \a polarOrientation. | ||||
The chart takes the ownership of the axis. | ||||
\note Axes can be added to a polar chart also with QChart::addAxis() instead of this method. | ||||
The specified alignment determines the polar orientation: horizontal alignments indicate angular | ||||
axis and vertical alignments indicate radial axis. | ||||
|
r2494 | |||
|
r2483 | \sa QChart::removeAxis(), QChart::createDefaultAxes(), QAbstractSeries::attachAxis(), QChart::addAxis() | ||
*/ | ||||
void QPolarChart::addAxis(QAbstractAxis *axis, PolarOrientation polarOrientation) | ||||
{ | ||||
if (!axis || axis->type() == QAbstractAxis::AxisTypeBarCategory) { | ||||
qWarning("QAbstractAxis::AxisTypeBarCategory is not a supported axis type for polar charts."); | ||||
} else { | ||||
Qt::Alignment alignment = Qt::AlignLeft; | ||||
if (polarOrientation == PolarOrientationAngular) | ||||
alignment = Qt::AlignBottom; | ||||
QChart::addAxis(axis, alignment); | ||||
} | ||||
} | ||||
/*! | ||||
Angular axes of a polar chart report horizontal orientation and radial axes report | ||||
vertical orientation. | ||||
This function is a convenience function for converting the orientation of an \a axis to | ||||
corresponding polar orientation. If the \a axis is NULL or not added to a polar chart, | ||||
the return value is meaningless. | ||||
*/ | ||||
QPolarChart::PolarOrientation QPolarChart::axisPolarOrientation(QAbstractAxis *axis) | ||||
{ | ||||
if (axis && axis->orientation() == Qt::Horizontal) | ||||
return PolarOrientationAngular; | ||||
else | ||||
return PolarOrientationRadial; | ||||
} | ||||
#include "moc_qpolarchart.cpp" | ||||
|
r2712 | QT_CHARTS_END_NAMESPACE | ||