|
|
/****************************************************************************
|
|
|
**
|
|
|
** Copyright (C) 2012 Digia Plc
|
|
|
** All rights reserved.
|
|
|
** For any questions to Digia, please use contact form at http://qt.digia.com
|
|
|
**
|
|
|
** This file is part of the Qt Commercial Charts Add-on.
|
|
|
**
|
|
|
** $QT_BEGIN_LICENSE$
|
|
|
** Licensees holding valid Qt Commercial licenses may use this file in
|
|
|
** accordance with the Qt Commercial License Agreement provided with the
|
|
|
** Software or, alternatively, in accordance with the terms contained in
|
|
|
** a written agreement between you and Digia.
|
|
|
**
|
|
|
** If you have questions regarding the use of this file, please use
|
|
|
** contact form at http://qt.digia.com
|
|
|
** $QT_END_LICENSE$
|
|
|
**
|
|
|
****************************************************************************/
|
|
|
|
|
|
#include "qabstractaxis.h"
|
|
|
#include "qabstractaxis_p.h"
|
|
|
|
|
|
QTCOMMERCIALCHART_BEGIN_NAMESPACE
|
|
|
|
|
|
/*!
|
|
|
\class QAbstractAxis
|
|
|
\brief The QAbstractAxis class is used for manipulating chart's axis.
|
|
|
\mainclass
|
|
|
|
|
|
There is only one x Axis, however there can be multiple y axes.
|
|
|
Each chart series can be bound to exactly one Y axis and the shared common X axis.
|
|
|
Axis can be setup to show axis line with tick marks, grid lines and shades.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\qmlclass Axis QAbstractAxis
|
|
|
\brief The Axis element is used for manipulating chart's axes
|
|
|
|
|
|
There is only one x Axis, however there can be multiple y axes on a ChartView.
|
|
|
Each chart series can be bound to exactly one Y axis and the shared common X axis.
|
|
|
Axis can be setup to show axis line with tick marks, grid lines and shades.
|
|
|
|
|
|
To access Axes you can use ChartView API. For example:
|
|
|
\code
|
|
|
ChartView {
|
|
|
axisX.min: 0
|
|
|
axisX.max: 3
|
|
|
axisX.ticksCount: 4
|
|
|
axisY.min: 0
|
|
|
axisY.max: 4
|
|
|
// Add a few series...
|
|
|
}
|
|
|
\endcode
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\enum QAbstractAxis::AxisType
|
|
|
|
|
|
The type of the series object.
|
|
|
|
|
|
\value AxisTypeValues
|
|
|
\value AxisTypeCategories
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QAbstractAxis::type
|
|
|
The type of the axis.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QAbstractAxis::labelsVisible
|
|
|
Defines if axis labels are visible.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty bool Axis::labelsVisible
|
|
|
Defines if axis labels are visible.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QAbstractAxis::min
|
|
|
Defines the minimum value on the axis.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty real Axis::min
|
|
|
Defines the minimum value on the axis.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QAbstractAxis::max
|
|
|
Defines the maximum value on the axis.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty real Axis::max
|
|
|
Defines the maximum value on the axis.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QAbstractAxis::visible
|
|
|
The visibility of the axis.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty bool Axis::visible
|
|
|
The visibility of the axis.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QAbstractAxis::gridVisible
|
|
|
The visibility of the grid lines.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty bool Axis::gridVisible
|
|
|
The visibility of the grid lines.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QAbstractAxis::color
|
|
|
The color of the axis and ticks.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty color Axis::color
|
|
|
The color of the axis and ticks.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QAxis::labelsFont
|
|
|
The font of the axis labels.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty Font Axis::labelsFont
|
|
|
The font of the axis labels.
|
|
|
|
|
|
See the \l {Font} {QML Font Element} for detailed documentation.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QAbstractAxis::labelsColor
|
|
|
The color of the axis labels.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty color Axis::labelsColor
|
|
|
The color of the axis labels.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QAbstractAxis::labelsAngle
|
|
|
The angle of the axis labels in degrees.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty int Axis::labelsAngle
|
|
|
The angle of the axis labels in degrees.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QAbstractAxis::shadesVisible
|
|
|
The visibility of the axis shades.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty bool Axis::shadesVisible
|
|
|
The visibility of the axis shades.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QAbstractAxis::shadesColor
|
|
|
The fill (brush) color of the axis shades.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty color Axis::shadesColor
|
|
|
The fill (brush) color of the axis shades.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QAbstractAxis::shadesBorderColor
|
|
|
The border (pen) color of the axis shades.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty color Axis::shadesBorderColor
|
|
|
The border (pen) color of the axis shades.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QAbstractAxis::ticksCount
|
|
|
The number of tick marks for the axis.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty int Axis::ticksCount
|
|
|
The number of tick marks for the axis.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\property QAbstractAxis::niceNumbersEnabled
|
|
|
Whether the nice numbers algorithm is enabled or not for the axis.
|
|
|
*/
|
|
|
/*!
|
|
|
\qmlproperty bool Axis::niceNumbersEnabled
|
|
|
Whether the nice numbers algorithm is enabled or not for the axis.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QAbstractAxis::visibleChanged(bool)
|
|
|
Visiblity of the axis has changed to \a visible.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QAbstractAxis::labelsVisibleChanged(bool)
|
|
|
Visiblity of the labels of the axis has changed to \a visible.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QAbstractAxis::gridVisibleChanged(bool)
|
|
|
Visiblity of the grid lines of the axis has changed to \a visible.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QAbstractAxis::minChanged(qreal min)
|
|
|
Axis emits signal when \a min of axis has changed.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QAbstractAxis::maxChanged(qreal max)
|
|
|
Axis emits signal when \a max of axis has changed.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QAbstractAxis::rangeChanged(qreal min, qreal max)
|
|
|
Axis emits signal when \a min or \a max of axis has changed.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn QChartAxisCategories* QAbstractAxis::categories()
|
|
|
Returns pointer to the list of categories which correspond to the values on the axis.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QAbstractAxis::colorChanged(QColor)
|
|
|
Emitted if the \a color of the axis is changed.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QAbstractAxis::labelsColorChanged(QColor)
|
|
|
Emitted if the \a color of the axis labels is changed.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QAbstractAxis::shadesVisibleChanged(bool)
|
|
|
Emitted if the visibility of the axis shades is changed to \a visible.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QAbstractAxis::shadesColorChanged(QColor)
|
|
|
Emitted if the \a color of the axis shades is changed.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QAbstractAxis::shadesBorderColorChanged(QColor)
|
|
|
Emitted if the border \a color of the axis shades is changed.
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
Constructs new axis object which is a child of \a parent. Ownership is taken by
|
|
|
QChart when axis added.
|
|
|
*/
|
|
|
|
|
|
QAbstractAxis::QAbstractAxis(QAbstractAxisPrivate &d, QObject *parent) :
|
|
|
QObject(parent),
|
|
|
d_ptr(&d)
|
|
|
{
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Destructor of the axis object. When axis is added to chart, chart object takes ownership.
|
|
|
*/
|
|
|
|
|
|
QAbstractAxis::~QAbstractAxis()
|
|
|
{
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Sets \a pen used to draw axis line and ticks.
|
|
|
*/
|
|
|
void QAbstractAxis::setAxisPen(const QPen &pen)
|
|
|
{
|
|
|
if (d_ptr->m_axisPen!=pen) {
|
|
|
d_ptr->m_axisPen = pen;
|
|
|
emit d_ptr->updated();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns pen used to draw axis and ticks.
|
|
|
*/
|
|
|
QPen QAbstractAxis::axisPen() const
|
|
|
{
|
|
|
return d_ptr->m_axisPen;
|
|
|
}
|
|
|
|
|
|
void QAbstractAxis::setAxisPenColor(QColor color)
|
|
|
{
|
|
|
QPen p = d_ptr->m_axisPen;
|
|
|
if (p.color() != color) {
|
|
|
p.setColor(color);
|
|
|
setAxisPen(p);
|
|
|
emit colorChanged(color);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
QColor QAbstractAxis::axisPenColor() const
|
|
|
{
|
|
|
return d_ptr->m_axisPen.color();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Sets if axis and ticks are \a visible.
|
|
|
*/
|
|
|
void QAbstractAxis::setAxisVisible(bool visible)
|
|
|
{
|
|
|
if (d_ptr->m_axisVisible != visible) {
|
|
|
d_ptr->m_axisVisible = visible;
|
|
|
emit d_ptr->updated();
|
|
|
emit visibleChanged(visible);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
bool QAbstractAxis::isAxisVisible() const
|
|
|
{
|
|
|
return d_ptr->m_axisVisible;
|
|
|
}
|
|
|
|
|
|
void QAbstractAxis::setGridLineVisible(bool visible)
|
|
|
{
|
|
|
if (d_ptr->m_gridLineVisible != visible) {
|
|
|
d_ptr->m_gridLineVisible = visible;
|
|
|
emit d_ptr->updated();
|
|
|
emit gridVisibleChanged(visible);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
bool QAbstractAxis::isGridLineVisible() const
|
|
|
{
|
|
|
return d_ptr->m_gridLineVisible;
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Sets \a pen used to draw grid line.
|
|
|
*/
|
|
|
void QAbstractAxis::setGridLinePen(const QPen &pen)
|
|
|
{
|
|
|
if (d_ptr->m_gridLinePen != pen) {
|
|
|
d_ptr->m_gridLinePen = pen;
|
|
|
emit d_ptr->updated();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns pen used to draw grid.
|
|
|
*/
|
|
|
QPen QAbstractAxis::gridLinePen() const
|
|
|
{
|
|
|
return d_ptr->m_gridLinePen;
|
|
|
}
|
|
|
|
|
|
void QAbstractAxis::setLabelsVisible(bool visible)
|
|
|
{
|
|
|
if (d_ptr->m_labelsVisible != visible) {
|
|
|
d_ptr->m_labelsVisible = visible;
|
|
|
emit d_ptr->updated();
|
|
|
emit labelsVisibleChanged(visible);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
bool QAbstractAxis::labelsVisible() const
|
|
|
{
|
|
|
return d_ptr->m_labelsVisible;
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Sets \a pen used to draw labels.
|
|
|
*/
|
|
|
void QAbstractAxis::setLabelsPen(const QPen &pen)
|
|
|
{
|
|
|
if (d_ptr->m_labelsPen != pen) {
|
|
|
d_ptr->m_labelsPen = pen;
|
|
|
emit d_ptr->updated();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns the pen used to labels.
|
|
|
*/
|
|
|
QPen QAbstractAxis::labelsPen() const
|
|
|
{
|
|
|
return d_ptr->m_labelsPen;
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Sets \a brush used to draw labels.
|
|
|
*/
|
|
|
void QAbstractAxis::setLabelsBrush(const QBrush &brush)
|
|
|
{
|
|
|
if (d_ptr->m_labelsBrush != brush) {
|
|
|
d_ptr->m_labelsBrush = brush;
|
|
|
emit d_ptr->updated();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns brush used to draw labels.
|
|
|
*/
|
|
|
QBrush QAbstractAxis::labelsBrush() const
|
|
|
{
|
|
|
return d_ptr->m_labelsBrush;
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Sets \a font used to draw labels.
|
|
|
*/
|
|
|
void QAbstractAxis::setLabelsFont(const QFont &font)
|
|
|
{
|
|
|
if (d_ptr->m_labelsFont != font) {
|
|
|
d_ptr->m_labelsFont = font;
|
|
|
emit d_ptr->updated();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns font used to draw labels.
|
|
|
*/
|
|
|
QFont QAbstractAxis::labelsFont() const
|
|
|
{
|
|
|
return d_ptr->m_labelsFont;
|
|
|
}
|
|
|
|
|
|
void QAbstractAxis::setLabelsAngle(int angle)
|
|
|
{
|
|
|
if (d_ptr->m_labelsAngle != angle) {
|
|
|
d_ptr->m_labelsAngle = angle;
|
|
|
emit d_ptr->updated();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
int QAbstractAxis::labelsAngle() const
|
|
|
{
|
|
|
return d_ptr->m_labelsAngle;
|
|
|
}
|
|
|
|
|
|
void QAbstractAxis::setLabelsColor(QColor color)
|
|
|
{
|
|
|
QBrush b = d_ptr->m_labelsBrush;
|
|
|
if (b.color() != color) {
|
|
|
b.setColor(color);
|
|
|
setLabelsBrush(b);
|
|
|
emit labelsColorChanged(color);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
QColor QAbstractAxis::labelsColor() const
|
|
|
{
|
|
|
return d_ptr->m_labelsBrush.color();
|
|
|
}
|
|
|
|
|
|
void QAbstractAxis::setShadesVisible(bool visible)
|
|
|
{
|
|
|
if (d_ptr->m_shadesVisible != visible) {
|
|
|
d_ptr->m_shadesVisible = visible;
|
|
|
emit d_ptr->updated();
|
|
|
emit shadesVisibleChanged(visible);
|
|
|
}
|
|
|
}
|
|
|
|
|
|
bool QAbstractAxis::shadesVisible() const
|
|
|
{
|
|
|
return d_ptr->m_shadesVisible;
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Sets \a pen used to draw shades.
|
|
|
*/
|
|
|
void QAbstractAxis::setShadesPen(const QPen &pen)
|
|
|
{
|
|
|
if (d_ptr->m_shadesPen != pen) {
|
|
|
d_ptr->m_shadesPen = pen;
|
|
|
emit d_ptr->updated();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns pen used to draw shades.
|
|
|
*/
|
|
|
QPen QAbstractAxis::shadesPen() const
|
|
|
{
|
|
|
return d_ptr->m_shadesPen;
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Sets \a brush used to draw shades.
|
|
|
*/
|
|
|
void QAbstractAxis::setShadesBrush(const QBrush &brush)
|
|
|
{
|
|
|
if (d_ptr->m_shadesBrush != brush) {
|
|
|
d_ptr->m_shadesBrush = brush;
|
|
|
emit d_ptr->updated();
|
|
|
emit shadesColorChanged(brush.color());
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns brush used to draw shades.
|
|
|
*/
|
|
|
QBrush QAbstractAxis::shadesBrush() const
|
|
|
{
|
|
|
return d_ptr->m_shadesBrush;
|
|
|
}
|
|
|
|
|
|
void QAbstractAxis::setShadesColor(QColor color)
|
|
|
{
|
|
|
QBrush b = d_ptr->m_shadesBrush;
|
|
|
b.setColor(color);
|
|
|
setShadesBrush(b);
|
|
|
}
|
|
|
|
|
|
QColor QAbstractAxis::shadesColor() const
|
|
|
{
|
|
|
return d_ptr->m_shadesBrush.color();
|
|
|
}
|
|
|
|
|
|
void QAbstractAxis::setShadesBorderColor(QColor color)
|
|
|
{
|
|
|
QPen p = d_ptr->m_shadesPen;
|
|
|
p.setColor(color);
|
|
|
setShadesPen(p);
|
|
|
}
|
|
|
|
|
|
QColor QAbstractAxis::shadesBorderColor() const
|
|
|
{
|
|
|
return d_ptr->m_shadesPen.color();
|
|
|
}
|
|
|
|
|
|
|
|
|
/*!
|
|
|
Sets axis, shades, labels and grid lines to be visible.
|
|
|
*/
|
|
|
void QAbstractAxis::show()
|
|
|
{
|
|
|
d_ptr->m_axisVisible=true;
|
|
|
d_ptr->m_gridLineVisible=true;
|
|
|
d_ptr->m_labelsVisible=true;
|
|
|
d_ptr->m_shadesVisible=true;
|
|
|
emit d_ptr->updated();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Sets axis, shades, labels and grid lines to not be visible.
|
|
|
*/
|
|
|
void QAbstractAxis::hide()
|
|
|
{
|
|
|
d_ptr->m_axisVisible = false;
|
|
|
d_ptr->m_gridLineVisible = false;
|
|
|
d_ptr->m_labelsVisible = false;
|
|
|
d_ptr->m_shadesVisible = false;
|
|
|
emit d_ptr->updated();
|
|
|
}
|
|
|
|
|
|
|
|
|
void QAbstractAxis::setMin(const qreal min)
|
|
|
{
|
|
|
d_ptr->setMin(min);
|
|
|
}
|
|
|
void QAbstractAxis::setMax(const qreal max)
|
|
|
{
|
|
|
d_ptr->setMax(max);
|
|
|
}
|
|
|
void QAbstractAxis::setRange(const qreal min, const qreal max)
|
|
|
{
|
|
|
d_ptr->setRange(min,max);
|
|
|
}
|
|
|
|
|
|
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
QAbstractAxisPrivate::QAbstractAxisPrivate(QAbstractAxis* q):
|
|
|
q_ptr(q),
|
|
|
m_axisVisible(true),
|
|
|
m_gridLineVisible(true),
|
|
|
m_labelsVisible(true),
|
|
|
m_labelsAngle(0),
|
|
|
m_shadesVisible(false),
|
|
|
m_shadesBrush(Qt::SolidPattern),
|
|
|
m_shadesOpacity(1.0),
|
|
|
m_orientation(Qt::Orientation(0)),
|
|
|
m_min(0),
|
|
|
m_max(0),
|
|
|
m_ticksCount(5)
|
|
|
{
|
|
|
|
|
|
}
|
|
|
|
|
|
QAbstractAxisPrivate::~QAbstractAxisPrivate()
|
|
|
{
|
|
|
|
|
|
}
|
|
|
|
|
|
#include "moc_qabstractaxis.cpp"
|
|
|
#include "moc_qabstractaxis_p.cpp"
|
|
|
|
|
|
QTCOMMERCIALCHART_END_NAMESPACE
|
|
|
|
