##// END OF EJS Templates
fixed documentation errors
fixed documentation errors

File last commit:

r1575:5c9e4e8ea61d
r1575:5c9e4e8ea61d
Show More
qvaluesaxis.cpp
277 lines | 5.8 KiB | text/x-c | CppLexer
/****************************************************************************
**
** 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 "qvaluesaxis.h"
#include "qvaluesaxis_p.h"
#include "chartvaluesaxisx_p.h"
#include "chartvaluesaxisy_p.h"
#include <QDebug>
QTCOMMERCIALCHART_BEGIN_NAMESPACE
/*!
\class QValuesAxis
\brief The QValuesAxis class is used for manipulating chart's axis.
\mainclass
Axis can be setup to show axis line with tick marks, grid lines and shades.
*/
/*!
\qmlclass Axis QValuesAxis
\brief The Axis element is used for manipulating chart's axes
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
*/
/*!
\property QValuesAxis::min
Defines the minimum value on the axis.
*/
/*!
\qmlproperty real Axis::min
Defines the minimum value on the axis.
*/
/*!
\property QValuesAxis::max
Defines the maximum value on the axis.
*/
/*!
\qmlproperty real Axis::max
Defines the maximum value on the axis.
*/
/*!
\fn void QValuesAxis::minChanged(qreal min)
Axis emits signal when \a min of axis has changed.
*/
/*!
\fn void QValuesAxis::maxChanged(qreal max)
Axis emits signal when \a max of axis has changed.
*/
/*!
\fn void QValuesAxis::rangeChanged(qreal min, qreal max)
Axis emits signal when \a min or \a max of axis has changed.
*/
/*!
\property QValuesAxis::ticksCount
The number of tick marks for the axis.
*/
/*!
\qmlproperty int Axis::ticksCount
The number of tick marks for the axis.
*/
/*!
\property QValuesAxis::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.
*/
QValuesAxis::QValuesAxis(QObject *parent) :
QAbstractAxis(*new QValuesAxisPrivate(this),parent)
{
}
QValuesAxis::QValuesAxis(QValuesAxisPrivate &d,QObject *parent) : QAbstractAxis(d,parent)
{
}
QValuesAxis::~QValuesAxis()
{
}
void QValuesAxis::setMin(qreal min)
{
Q_D(QValuesAxis);
setRange(min,d->m_max);
}
qreal QValuesAxis::min() const
{
Q_D(const QValuesAxis);
return d->m_min;
}
void QValuesAxis::setMax(qreal max)
{
Q_D(QValuesAxis);
setRange(d->m_min,max);
}
qreal QValuesAxis::max() const
{
Q_D(const QValuesAxis);
return d->m_max;
}
/*!
Sets range from \a min to \a max on the axis.
*/
void QValuesAxis::setRange(qreal min, qreal max)
{
Q_D(QValuesAxis);
d->setRange(min,max);
}
/*!
Sets \a count for ticks on the axis.
*/
void QValuesAxis::setTicksCount(int count)
{
Q_D(QValuesAxis);
if (d->m_ticksCount != count) {
d->m_ticksCount = count;
emit d->changed(d->m_min, d->m_max, d->m_ticksCount, d->m_niceNumbers);
}
}
/*!
\fn int QValuesAxis::ticksCount() const
Return number of ticks on the axis
*/
int QValuesAxis::ticksCount() const
{
Q_D(const QValuesAxis);
return d->m_ticksCount;
}
void QValuesAxis::setNiceNumbersEnabled(bool enable)
{
Q_D(QValuesAxis);
if (d->m_niceNumbers != enable){
d->m_niceNumbers = enable;
emit d->changed(d->m_min, d->m_max, d->m_ticksCount, d->m_niceNumbers);
}
}
bool QValuesAxis::niceNumbersEnabled() const
{
Q_D(const QValuesAxis);
return d->m_niceNumbers;
}
QAbstractAxis::AxisType QValuesAxis::type() const
{
return AxisTypeValues;
}
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
QValuesAxisPrivate::QValuesAxisPrivate(QValuesAxis* q):
QAbstractAxisPrivate(q),
m_niceNumbers(false)
{
}
QValuesAxisPrivate::~QValuesAxisPrivate()
{
}
void QValuesAxisPrivate::handleAxisRangeChanged(qreal min, qreal max,int count)
{
Q_Q(QValuesAxis);
q->setRange(min,max);
q->setTicksCount(count);
}
void QValuesAxisPrivate::setMin(const qreal min)
{
setRange(min,m_max);
}
void QValuesAxisPrivate::setMax(const qreal max)
{
setRange(m_min,max);
}
void QValuesAxisPrivate::setRange(const qreal min, const qreal max, bool force)
{
Q_Q(QValuesAxis);
bool changed = false;
if (!qFuzzyIsNull(m_min - min)) {
m_min = min;
changed = true;
emit q->minChanged(min);
}
if (!qFuzzyIsNull(m_max - max)) {
m_max = max;
changed = true;
emit q->maxChanged(max);
}
if ((changed) ||(force)) {
emit q->rangeChanged(m_min,m_max);
emit this->changed(m_min, m_max, m_ticksCount, m_niceNumbers);
}
}
int QValuesAxisPrivate::ticksCount() const
{
return m_ticksCount;
}
ChartAxis* QValuesAxisPrivate::createGraphics(ChartPresenter* presenter)
{
Q_Q(QValuesAxis);
if(m_orientation == Qt::Vertical){
return new ChartValuesAxisY(q,presenter);
}else{
return new ChartValuesAxisX(q,presenter);
}
}
void QValuesAxisPrivate::updateRange()
{
setRange(m_min,m_max,true);
}
#include "moc_qvaluesaxis.cpp"
#include "moc_qvaluesaxis_p.cpp"
QTCOMMERCIALCHART_END_NAMESPACE