qabstractaxis.cpp
658 lines
| 14.1 KiB
| text/x-c
|
CppLexer
|
r1540 | /**************************************************************************** | ||
** | ||||
** 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 | ||||
|
r1639 | There is only one x Axis visible at the time, however there can be multiple y axes. | ||
|
r1540 | 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. | ||||
*/ | ||||
/*! | ||||
|
r1639 | \qmlclass AbstractAxis QAbstractAxis | ||
|
r1540 | \brief The Axis element is used for manipulating chart's axes | ||
|
r1639 | There is only one x Axis visible at the time, however there can be multiple y axes on a ChartView. | ||
|
r1540 | 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 | ||||
*/ | ||||
|
r1548 | /*! | ||
\enum QAbstractAxis::AxisType | ||||
The type of the series object. | ||||
|
r1618 | \value AxisTypeNoAxis | ||
|
r1818 | \value AxisTypeValue | ||
|
r1822 | \value AxisTypeBarCategory | ||
\value AxisTypeCategory | ||||
|
r1733 | \value AxisTypeDateTime | ||
|
r1548 | */ | ||
|
r1637 | /*! | ||
*\fn void QAbstractAxis::type() const | ||||
Returns the type of the axis | ||||
*/ | ||||
|
r1621 | /*! | ||
|
r1848 | \property QAbstractAxis::lineVisible | ||
The visibility of the axis line | ||||
|
r1621 | */ | ||
/*! | ||||
|
r1848 | \qmlproperty bool AbstractAxis::lineVisible | ||
The visibility of the axis line | ||||
|
r1548 | */ | ||
|
r1540 | /*! | ||
\property QAbstractAxis::labelsVisible | ||||
Defines if axis labels are visible. | ||||
*/ | ||||
/*! | ||||
|
r1639 | \qmlproperty bool AbstractAxis::labelsVisible | ||
|
r1540 | Defines if axis labels are visible. | ||
*/ | ||||
/*! | ||||
\property QAbstractAxis::visible | ||||
The visibility of the axis. | ||||
*/ | ||||
/*! | ||||
|
r1639 | \qmlproperty bool AbstractAxis::visible | ||
|
r1540 | The visibility of the axis. | ||
*/ | ||||
/*! | ||||
\property QAbstractAxis::gridVisible | ||||
The visibility of the grid lines. | ||||
*/ | ||||
/*! | ||||
|
r1639 | \qmlproperty bool AbstractAxis::gridVisible | ||
|
r1540 | The visibility of the grid lines. | ||
*/ | ||||
/*! | ||||
\property QAbstractAxis::color | ||||
The color of the axis and ticks. | ||||
*/ | ||||
/*! | ||||
|
r1639 | \qmlproperty color AbstractAxis::color | ||
|
r1540 | The color of the axis and ticks. | ||
*/ | ||||
/*! | ||||
|
r1575 | \property QAbstractAxis::labelsFont | ||
|
r1540 | The font of the axis labels. | ||
*/ | ||||
|
r1575 | |||
|
r1540 | /*! | ||
|
r1639 | \qmlproperty Font AbstractAxis::labelsFont | ||
|
r1540 | 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. | ||||
*/ | ||||
/*! | ||||
|
r1639 | \qmlproperty color AbstractAxis::labelsColor | ||
|
r1540 | The color of the axis labels. | ||
*/ | ||||
/*! | ||||
\property QAbstractAxis::labelsAngle | ||||
The angle of the axis labels in degrees. | ||||
*/ | ||||
/*! | ||||
|
r1639 | \qmlproperty int AbstractAxis::labelsAngle | ||
|
r1540 | The angle of the axis labels in degrees. | ||
*/ | ||||
/*! | ||||
\property QAbstractAxis::shadesVisible | ||||
The visibility of the axis shades. | ||||
*/ | ||||
/*! | ||||
|
r1639 | \qmlproperty bool AbstractAxis::shadesVisible | ||
|
r1540 | The visibility of the axis shades. | ||
*/ | ||||
/*! | ||||
\property QAbstractAxis::shadesColor | ||||
The fill (brush) color of the axis shades. | ||||
*/ | ||||
/*! | ||||
|
r1639 | \qmlproperty color AbstractAxis::shadesColor | ||
|
r1540 | The fill (brush) color of the axis shades. | ||
*/ | ||||
/*! | ||||
\property QAbstractAxis::shadesBorderColor | ||||
The border (pen) color of the axis shades. | ||||
*/ | ||||
/*! | ||||
|
r1639 | \qmlproperty color AbstractAxis::shadesBorderColor | ||
|
r1540 | The border (pen) color of the axis shades. | ||
*/ | ||||
/*! | ||||
|
r1654 | \fn void QAbstractAxis::visibleChanged(bool visible) | ||
|
r1932 | Visibility of the axis has changed to \a visible. | ||
|
r1540 | */ | ||
/*! | ||||
|
r1654 | \qmlsignal AbstractAxis::onVisibleChanged(bool visible) | ||
|
r1932 | Visibility of the axis has changed to \a visible. | ||
|
r1540 | */ | ||
/*! | ||||
|
r1848 | \fn void QAbstractAxis::lineVisibleChanged(bool visible) | ||
|
r1932 | Visibility of the axis line has changed to \a visible. | ||
|
r1540 | */ | ||
|
r1654 | /*! | ||
|
r1848 | \qmlsignal AbstractAxis::onLineVisibleChanged(bool visible) | ||
|
r1932 | Visibility of the axis line has changed to \a visible. | ||
|
r1540 | */ | ||
|
r1654 | /*! | ||
\fn void QAbstractAxis::labelsVisibleChanged(bool visible) | ||||
|
r1932 | Visibility of the labels of the axis has changed to \a visible. | ||
|
r1540 | */ | ||
|
r1654 | /*! | ||
\qmlsignal AbstractAxis::onLabelsVisibleChanged(bool visible) | ||||
|
r1932 | Visibility of the labels of the axis has changed to \a visible. | ||
|
r1540 | */ | ||
|
r1654 | /*! | ||
\fn void QAbstractAxis::gridVisibleChanged(bool visible) | ||||
|
r1932 | Visibility of the grid lines of the axis has changed to \a visible. | ||
|
r1654 | */ | ||
/*! | ||||
\qmlsignal AbstractAxis::onGridVisibleChanged(bool visible) | ||||
|
r1932 | Visibility of the grid lines of the axis has changed to \a visible. | ||
|
r1540 | */ | ||
/*! | ||||
|
r1654 | \fn void QAbstractAxis::colorChanged(QColor color) | ||
Emitted if the \a color of the axis is changed. | ||||
*/ | ||||
/*! | ||||
\qmlsignal AbstractAxis::onColorChanged(QColor color) | ||||
|
r1540 | Emitted if the \a color of the axis is changed. | ||
*/ | ||||
/*! | ||||
|
r1654 | \fn void QAbstractAxis::labelsColorChanged(QColor color) | ||
Emitted if the \a color of the axis labels is changed. | ||||
*/ | ||||
/*! | ||||
\qmlsignal AbstractAxis::onLabelsColorChanged(QColor color) | ||||
|
r1540 | 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. | ||||
*/ | ||||
|
r1654 | /*! | ||
\qmlsignal AbstractAxis::onShadesVisibleChanged(bool visible) | ||||
Emitted if the visibility of the axis shades is changed to \a visible. | ||||
*/ | ||||
|
r1540 | |||
/*! | ||||
|
r1654 | \fn void QAbstractAxis::shadesColorChanged(QColor color) | ||
Emitted if the \a color of the axis shades is changed. | ||||
*/ | ||||
/*! | ||||
\qmlsignal AbstractAxis::onShadesColorChanged(QColor color) | ||||
|
r1540 | 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. | ||||
*/ | ||||
|
r1654 | /*! | ||
\qmlsignal AbstractAxis::onBorderColorChanged(QColor color) | ||||
Emitted if the border \a color of the axis shades is changed. | ||||
*/ | ||||
|
r1540 | |||
/*! | ||||
|
r1657 | \internal | ||
|
r1540 | 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() | ||||
{ | ||||
|
r1725 | if(d_ptr->m_dataset) qFatal("Still binded axis detected !"); | ||
|
r1540 | } | ||
/*! | ||||
Sets \a pen used to draw axis line and ticks. | ||||
*/ | ||||
|
r1844 | void QAbstractAxis::setLinePen(const QPen &pen) | ||
|
r1540 | { | ||
if (d_ptr->m_axisPen!=pen) { | ||||
d_ptr->m_axisPen = pen; | ||||
|
r1698 | d_ptr->emitUpdated(); | ||
|
r1540 | } | ||
} | ||||
/*! | ||||
Returns pen used to draw axis and ticks. | ||||
*/ | ||||
|
r1844 | QPen QAbstractAxis::linePen() const | ||
|
r1540 | { | ||
return d_ptr->m_axisPen; | ||||
} | ||||
|
r1844 | void QAbstractAxis::setLinePenColor(QColor color) | ||
|
r1540 | { | ||
QPen p = d_ptr->m_axisPen; | ||||
if (p.color() != color) { | ||||
p.setColor(color); | ||||
|
r1844 | setLinePen(p); | ||
|
r1540 | emit colorChanged(color); | ||
} | ||||
} | ||||
|
r1844 | QColor QAbstractAxis::linePenColor() const | ||
|
r1540 | { | ||
return d_ptr->m_axisPen.color(); | ||||
} | ||||
/*! | ||||
Sets if axis and ticks are \a visible. | ||||
*/ | ||||
|
r1844 | void QAbstractAxis::setLineVisible(bool visible) | ||
|
r1540 | { | ||
|
r1654 | if (d_ptr->m_arrowVisible != visible) { | ||
d_ptr->m_arrowVisible = visible; | ||||
|
r1698 | d_ptr->emitUpdated(); | ||
|
r1844 | emit lineVisibleChanged(visible); | ||
|
r1540 | } | ||
} | ||||
|
r1844 | bool QAbstractAxis::isLineVisible() const | ||
|
r1540 | { | ||
|
r1654 | return d_ptr->m_arrowVisible; | ||
|
r1540 | } | ||
void QAbstractAxis::setGridLineVisible(bool visible) | ||||
{ | ||||
if (d_ptr->m_gridLineVisible != visible) { | ||||
d_ptr->m_gridLineVisible = visible; | ||||
|
r1698 | d_ptr->emitUpdated(); | ||
|
r1540 | 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; | ||||
|
r1698 | d_ptr->emitUpdated(); | ||
|
r1540 | } | ||
} | ||||
/*! | ||||
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; | ||||
|
r1698 | d_ptr->emitUpdated(); | ||
|
r1540 | 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; | ||||
|
r1698 | d_ptr->emitUpdated(); | ||
|
r1540 | } | ||
} | ||||
/*! | ||||
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; | ||||
|
r1698 | d_ptr->emitUpdated(); | ||
|
r1540 | } | ||
} | ||||
/*! | ||||
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; | ||||
|
r1698 | d_ptr->emitUpdated(); | ||
|
r1540 | } | ||
} | ||||
/*! | ||||
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; | ||||
|
r1698 | d_ptr->emitUpdated(); | ||
|
r1540 | } | ||
} | ||||
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; | ||||
|
r1698 | d_ptr->emitUpdated(); | ||
|
r1540 | 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; | ||||
|
r1698 | d_ptr->emitUpdated(); | ||
|
r1540 | } | ||
} | ||||
/*! | ||||
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; | ||||
|
r1698 | d_ptr->emitUpdated(); | ||
|
r1540 | 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(); | ||||
} | ||||
|
r1617 | bool QAbstractAxis::isVisible() const | ||
{ | ||||
return d_ptr->m_visible; | ||||
} | ||||
|
r1540 | /*! | ||
Sets axis, shades, labels and grid lines to be visible. | ||||
*/ | ||||
|
r1617 | void QAbstractAxis::setVisible(bool visible) | ||
|
r1540 | { | ||
|
r1626 | if(d_ptr->m_visible!=visible){ | ||
d_ptr->m_visible=visible; | ||||
|
r1698 | d_ptr->emitUpdated(); | ||
|
r1626 | emit visibleChanged(visible); | ||
} | ||||
|
r1540 | } | ||
|
r1617 | |||
/*! | ||||
Sets axis, shades, labels and grid lines to be visible. | ||||
*/ | ||||
void QAbstractAxis::show() | ||||
{ | ||||
setVisible(true); | ||||
} | ||||
|
r1540 | /*! | ||
Sets axis, shades, labels and grid lines to not be visible. | ||||
*/ | ||||
void QAbstractAxis::hide() | ||||
{ | ||||
|
r1617 | setVisible(false); | ||
|
r1540 | } | ||
|
r1635 | /*! | ||
Sets the minimum value shown on the axis. | ||||
|
r1935 | Depending on the actual axis type the \a min parameter is converted to appropriate type. | ||
|
r1635 | If the conversion is impossible then the function call does nothing | ||
*/ | ||||
|
r1578 | void QAbstractAxis::setMin(const QVariant &min) | ||
|
r1544 | { | ||
d_ptr->setMin(min); | ||||
} | ||||
|
r1635 | |||
/*! | ||||
Sets the maximum value shown on the axis. | ||||
|
r1935 | Depending on the actual axis type the \a max parameter is converted to appropriate type. | ||
|
r1635 | If the conversion is impossible then the function call does nothing | ||
*/ | ||||
|
r1578 | void QAbstractAxis::setMax(const QVariant &max) | ||
|
r1544 | { | ||
d_ptr->setMax(max); | ||||
} | ||||
|
r1635 | |||
/*! | ||||
Sets the range shown on the axis. | ||||
|
r1935 | Depending on the actual axis type the \a min and \a max parameters are converted to appropriate types. | ||
|
r1635 | If the conversion is impossible then the function call does nothing. | ||
*/ | ||||
|
r1578 | void QAbstractAxis::setRange(const QVariant &min, const QVariant &max) | ||
|
r1544 | { | ||
d_ptr->setRange(min,max); | ||||
} | ||||
|
r1695 | |||
|
r1743 | /*! | ||
Returns the orientation in which the axis is being used (Vertical or Horizontal) | ||||
*/ | ||||
|
r1695 | Qt::Orientation QAbstractAxis::orientation() | ||
{ | ||||
return d_ptr->m_orientation; | ||||
} | ||||
|
r1540 | ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||
QAbstractAxisPrivate::QAbstractAxisPrivate(QAbstractAxis* q): | ||||
q_ptr(q), | ||||
|
r1698 | m_orientation(Qt::Orientation(0)), | ||
|
r1725 | m_dataset(0), | ||
|
r1626 | m_visible(false), | ||
|
r1654 | m_arrowVisible(true), | ||
|
r1540 | m_gridLineVisible(true), | ||
m_labelsVisible(true), | ||||
m_labelsAngle(0), | ||||
m_shadesVisible(false), | ||||
m_shadesBrush(Qt::SolidPattern), | ||||
|
r1542 | m_shadesOpacity(1.0), | ||
|
r1698 | m_dirty(false) | ||
|
r1540 | { | ||
} | ||||
QAbstractAxisPrivate::~QAbstractAxisPrivate() | ||||
{ | ||||
} | ||||
|
r1698 | void QAbstractAxisPrivate::emitUpdated() | ||
{ | ||||
if(!m_dirty){ | ||||
m_dirty=true; | ||||
emit updated(); | ||||
} | ||||
} | ||||
void QAbstractAxisPrivate::setDirty(bool dirty) | ||||
{ | ||||
m_dirty=dirty; | ||||
} | ||||
void QAbstractAxisPrivate::setOrientation(Qt::Orientation orientation) | ||||
{ | ||||
m_orientation=orientation; | ||||
} | ||||
|
r1540 | #include "moc_qabstractaxis.cpp" | ||
#include "moc_qabstractaxis_p.cpp" | ||||
QTCOMMERCIALCHART_END_NAMESPACE | ||||