qchartaxis.cpp
402 lines
| 7.0 KiB
| text/x-c
|
CppLexer
/ src / qchartaxis.cpp
Michal Klocek
|
r72 | #include "qchartaxis.h" | ||
|
Michal Klocek
|
r85 | QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||
|
Michal Klocek
|
r331 | /*! | ||
| \class QChartAxis | ||||
| \brief The QChartAxis class is used for manipulating chart's axis | ||||
| and for adding optional axes to the chart. | ||||
| \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 share common X axis. | ||||
| Axis can be setup to show axis line with ticks, gird lines and shades. | ||||
| */ | ||||
|
Michal Klocek
|
r333 | /*! | ||
| \fn bool QChartAxis::isAxisVisible() const | ||||
| \brief Returns if axis is visible | ||||
| \sa setAxisVisible() | ||||
| */ | ||||
|
Michal Klocek
|
r331 | /*! | ||
| \fn QPen QChartAxis::axisPen() const | ||||
| \brief Returns pen used to draw axis and ticks. | ||||
| \sa setAxisPen() | ||||
| */ | ||||
|
Michal Klocek
|
r333 | |||
| /*! | ||||
| \fn bool QChartAxis::isGridVisible() const | ||||
| \brief Returns if grid is visible | ||||
| \sa setGridVisible() | ||||
| */ | ||||
|
Michal Klocek
|
r331 | /*! | ||
| \fn QPen QChartAxis::gridPen() const | ||||
| \brief Returns pen used to draw grid. | ||||
| \sa setGridPen() | ||||
| */ | ||||
|
Michal Klocek
|
r333 | /*! | ||
|
Michal Klocek
|
r365 | \fn bool QChartAxis::labelsVisible() const | ||
|
Michal Klocek
|
r333 | \brief Returns if grid is visible | ||
| \sa setLabelsVisible() | ||||
| */ | ||||
|
Michal Klocek
|
r331 | /*! | ||
| \fn QPen QChartAxis::labelsPen() const | ||||
|
Michal Klocek
|
r333 | \brief Returns the pen used to labels. | ||
|
Michal Klocek
|
r331 | \sa setLabelsPen() | ||
| */ | ||||
| /*! | ||||
| \fn QBrush QChartAxis::labelsBrush() const | ||||
|
Michal Klocek
|
r333 | \brief Returns brush used to draw labels. | ||
|
Michal Klocek
|
r331 | \sa setLabelsBrush() | ||
| */ | ||||
| /*! | ||||
| \fn QFont QChartAxis::labelsFont() const | ||||
|
Michal Klocek
|
r333 | \brief Returns font used to draw labels. | ||
|
Michal Klocek
|
r331 | \sa setLabelsFont() | ||
| */ | ||||
| /*! | ||||
| \fn QFont QChartAxis::labelsAngle() const | ||||
|
Michal Klocek
|
r333 | \brief Returns angle used to draw labels. | ||
|
Michal Klocek
|
r331 | \sa setLabelsAngle() | ||
| */ | ||||
|
Michal Klocek
|
r333 | /*! | ||
|
Michal Klocek
|
r365 | \fn bool QChartAxis::shadesVisible() const | ||
|
Michal Klocek
|
r333 | \brief Returns if shades are visible. | ||
| \sa setShadesVisible() | ||||
| */ | ||||
| /*! | ||||
| \fn qreal QChartAxis::shadesOpacity() const | ||||
| \brief Returns opacity of shades. | ||||
| */ | ||||
|
Michal Klocek
|
r331 | /*! | ||
| \fn QPen QChartAxis::shadesPen() const | ||||
|
Michal Klocek
|
r333 | \brief Returns pen used to draw shades. | ||
|
Michal Klocek
|
r331 | \sa setShadesPen() | ||
| */ | ||||
| /*! | ||||
| \fn QBrush QChartAxis::shadesBrush() const | ||||
|
Michal Klocek
|
r333 | \brief Returns brush used to draw shades. | ||
|
Michal Klocek
|
r331 | \sa setShadesBrush() | ||
| */ | ||||
|
Michal Klocek
|
r333 | /*! | ||
| \fn qreal QChartAxis::min() const | ||||
| \brief Returns minimum value on the axis. | ||||
| \sa setMin() | ||||
| */ | ||||
| /*! | ||||
| \fn qreal QChartAxis::max() const | ||||
| \brief Returns maximim value on the axis. | ||||
| \sa setMax() | ||||
| */ | ||||
| /*! | ||||
| \fn void QChartAxis::minChanged(qreal min) | ||||
| \brief Axis emits signal when \a min of axis has changed. | ||||
| */ | ||||
| /*! | ||||
| \fn void QChartAxis::maxChanged(qreal max) | ||||
| \brief Axis emits signal when \a max of axis has changed. | ||||
| */ | ||||
|
Michal Klocek
|
r331 | /*! | ||
|
Michal Klocek
|
r439 | \fn void QChartAxis::rangeChanged(qreal min, qreal max) | ||
| \brief Axis emits signal when \a min or \a max of axis has changed. | ||||
|
Michal Klocek
|
r331 | */ | ||
| /*! | ||||
|
Michal Klocek
|
r439 | \fn int QChartAxis::ticksCount() const | ||
| \brief Return number of ticks on the axis | ||||
| \sa setTicksCount() | ||||
|
Michal Klocek
|
r331 | */ | ||
|
Michal Klocek
|
r400 | /*! | ||
|
Michal Klocek
|
r441 | \fn void QChartAxis::updated() | ||
|
Michal Klocek
|
r400 | \brief \internal | ||
| */ | ||||
| /*! | ||||
|
Michal Klocek
|
r439 | \fn void QChartAxis::handleAxisRangeChanged(qreal min, qreal max) | ||
|
Michal Klocek
|
r400 | \brief \internal \a min \a max | ||
| */ | ||||
|
Michal Klocek
|
r331 | /*! | ||
| Constructs new axis object which is a child of \a parent. Ownership is taken by | ||||
| QChatView or QChart when axis added. | ||||
| */ | ||||
|
Michal Klocek
|
r223 | QChartAxis::QChartAxis(QObject* parent):QObject(parent), | ||
|
Michal Klocek
|
r85 | m_axisVisible(true), | ||
|
Michal Klocek
|
r176 | m_gridVisible(true), | ||
|
Michal Klocek
|
r85 | m_labelsVisible(true), | ||
|
Michal Klocek
|
r223 | m_labelsAngle(0), | ||
|
Michal Klocek
|
r188 | m_shadesVisible(true), | ||
|
Michal Klocek
|
r223 | m_shadesOpacity(1.0), | ||
| m_min(0), | ||||
| m_max(0), | ||||
|
Michal Klocek
|
r241 | m_ticksCount(5) | ||
|
Michal Klocek
|
r72 | { | ||
| } | ||||
|
Michal Klocek
|
r331 | /*! | ||
| Destructor of the axis object. When axis is added to chart, chart object takes ownership. | ||||
| */ | ||||
|
Michal Klocek
|
r72 | QChartAxis::~QChartAxis() | ||
| { | ||||
| } | ||||
|
Michal Klocek
|
r331 | /*! | ||
| Sets \a pen used to draw axis line and ticks. | ||||
| */ | ||||
|
Michal Klocek
|
r140 | void QChartAxis::setAxisPen(const QPen& pen) | ||
| { | ||||
|
Michal Klocek
|
r439 | if (pen != m_axisPen) { | ||
|
Michal Klocek
|
r176 | m_axisPen=pen; | ||
|
Michal Klocek
|
r439 | emit updated(); | ||
| } | ||||
|
Michal Klocek
|
r140 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| Sets if axis and ticks are \a visible. | ||||
| */ | ||||
|
Michal Klocek
|
r85 | void QChartAxis::setAxisVisible(bool visible) | ||
| { | ||||
|
Michal Klocek
|
r439 | if (m_axisVisible!=visible) { | ||
|
Michal Klocek
|
r85 | m_axisVisible=visible; | ||
|
Michal Klocek
|
r439 | emit updated(); | ||
| } | ||||
|
Michal Klocek
|
r85 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| Sets if grid is \a visible. | ||||
| */ | ||||
|
Michal Klocek
|
r85 | void QChartAxis::setGridVisible(bool visible) | ||
| { | ||||
|
Michal Klocek
|
r439 | if (m_gridVisible!=visible) { | ||
|
Michal Klocek
|
r176 | m_gridVisible=visible; | ||
|
Michal Klocek
|
r439 | emit updated(); | ||
| } | ||||
|
Michal Klocek
|
r176 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| Sets \a pen used to draw grid. | ||||
| */ | ||||
|
Michal Klocek
|
r176 | void QChartAxis::setGridPen(const QPen& pen) | ||
| { | ||||
|
Michal Klocek
|
r439 | if (m_gridPen!=pen) { | ||
|
Michal Klocek
|
r176 | m_gridPen=pen; | ||
|
Michal Klocek
|
r439 | emit updated(); | ||
| } | ||||
|
Michal Klocek
|
r85 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| Sets if axis' labels are \a visible. | ||||
| */ | ||||
|
Michal Klocek
|
r85 | void QChartAxis::setLabelsVisible(bool visible) | ||
| { | ||||
|
Michal Klocek
|
r439 | if(m_labelsVisible!=visible) { | ||
|
Michal Klocek
|
r85 | m_labelsVisible=visible; | ||
|
Michal Klocek
|
r439 | emit updated(); | ||
| } | ||||
|
Michal Klocek
|
r85 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| Sets \a pen used to draw labels. | ||||
| */ | ||||
|
Michal Klocek
|
r176 | void QChartAxis::setLabelsPen(const QPen& pen) | ||
| { | ||||
|
Michal Klocek
|
r439 | if(m_labelsPen!=pen) { | ||
|
Michal Klocek
|
r176 | m_labelsPen=pen; | ||
|
Michal Klocek
|
r439 | emit updated(); | ||
| } | ||||
|
Michal Klocek
|
r176 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| Sets \a brush used to draw labels. | ||||
| */ | ||||
|
Michal Klocek
|
r176 | void QChartAxis::setLabelsBrush(const QBrush& brush) | ||
| { | ||||
|
Michal Klocek
|
r439 | if(m_labelsBrush!=brush) { | ||
|
Michal Klocek
|
r176 | m_labelsBrush=brush; | ||
|
Michal Klocek
|
r439 | emit updated(); | ||
| } | ||||
|
Michal Klocek
|
r176 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| Sets \a font used to draw labels. | ||||
| */ | ||||
|
Michal Klocek
|
r176 | void QChartAxis::setLabelsFont(const QFont& font) | ||
| { | ||||
|
Michal Klocek
|
r439 | if(m_labelsFont!=font) { | ||
|
Michal Klocek
|
r176 | m_labelsFont=font; | ||
|
Michal Klocek
|
r439 | emit updated(); | ||
| } | ||||
|
Michal Klocek
|
r176 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| Sets \a angle for all the labels on given axis. | ||||
| */ | ||||
|
Michal Klocek
|
r223 | void QChartAxis::setLabelsAngle(int angle) | ||
|
Michal Klocek
|
r176 | { | ||
|
Michal Klocek
|
r439 | if(m_labelsAngle!=angle) { | ||
|
Michal Klocek
|
r223 | m_labelsAngle=angle; | ||
|
Michal Klocek
|
r439 | emit updated(); | ||
| } | ||||
|
Michal Klocek
|
r176 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| Sets if shades are \a visible. | ||||
| */ | ||||
|
Michal Klocek
|
r176 | void QChartAxis::setShadesVisible(bool visible) | ||
| { | ||||
|
Michal Klocek
|
r439 | if(m_shadesVisible!=visible) { | ||
|
Michal Klocek
|
r176 | m_shadesVisible=visible; | ||
|
Michal Klocek
|
r439 | emit updated(); | ||
| } | ||||
|
Michal Klocek
|
r176 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| Sets \a pen used to draw shades. | ||||
| */ | ||||
|
Michal Klocek
|
r176 | void QChartAxis::setShadesPen(const QPen& pen) | ||
| { | ||||
|
Michal Klocek
|
r439 | if(m_shadesPen!=pen) { | ||
| m_shadesPen=pen; | ||||
| emit updated(); | ||||
| } | ||||
|
Michal Klocek
|
r176 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| Sets \a brush used to draw shades. | ||||
| */ | ||||
|
Michal Klocek
|
r176 | void QChartAxis::setShadesBrush(const QBrush& brush) | ||
|
Michal Klocek
|
r85 | { | ||
|
Michal Klocek
|
r439 | if(m_shadesBrush!=brush) { | ||
|
Michal Klocek
|
r176 | m_shadesBrush=brush; | ||
|
Michal Klocek
|
r439 | emit updated(); | ||
| } | ||||
|
Michal Klocek
|
r85 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| Sets \a opacity of the shades. | ||||
| */ | ||||
|
Michal Klocek
|
r188 | void QChartAxis::setShadesOpacity(qreal opacity) | ||
| { | ||||
|
Michal Klocek
|
r439 | if(m_shadesOpacity!=opacity) { | ||
|
Michal Klocek
|
r188 | m_shadesOpacity=opacity; | ||
|
Michal Klocek
|
r439 | emit updated(); | ||
| } | ||||
|
Michal Klocek
|
r188 | } | ||
|
Michal Klocek
|
r85 | |||
|
Michal Klocek
|
r331 | /*! | ||
|
Michal Klocek
|
r400 | Sets \a min value on the axis. | ||
|
Michal Klocek
|
r331 | */ | ||
|
Michal Klocek
|
r223 | void QChartAxis::setMin(qreal min) | ||
| { | ||||
|
Michal Klocek
|
r439 | setRange(min,m_max); | ||
|
Michal Klocek
|
r223 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
|
Michal Klocek
|
r400 | Sets \a max value on the axis. | ||
|
Michal Klocek
|
r331 | */ | ||
|
Michal Klocek
|
r223 | void QChartAxis::setMax(qreal max) | ||
| { | ||||
|
Michal Klocek
|
r439 | setRange(m_min,max); | ||
|
Michal Klocek
|
r223 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| Sets range from \a min to \a max on the axis. | ||||
| */ | ||||
|
Michal Klocek
|
r223 | void QChartAxis::setRange(qreal min, qreal max) | ||
| { | ||||
|
Michal Klocek
|
r442 | |||
|
Michal Klocek
|
r439 | bool changed = false; | ||
| if(m_min!=min) { | ||||
| m_min=min; | ||||
|
Michal Klocek
|
r442 | changed=true; | ||
|
Michal Klocek
|
r439 | emit minChanged(min); | ||
| } | ||||
|
Michal Klocek
|
r400 | |||
|
Michal Klocek
|
r439 | if(m_max!=max) { | ||
| m_max=max; | ||||
|
Michal Klocek
|
r442 | changed=true; | ||
|
Michal Klocek
|
r400 | emit maxChanged(max); | ||
| } | ||||
|
Michal Klocek
|
r442 | if(changed) { | ||
| emit rangeChanged(m_min,m_max); | ||||
| } | ||||
|
Michal Klocek
|
r439 | } | ||
|
Michal Klocek
|
r400 | |||
|
Michal Klocek
|
r439 | void QChartAxis::handleAxisRangeChanged(qreal min, qreal max) | ||
| { | ||||
| setRange(min,max); | ||||
|
Michal Klocek
|
r223 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| Sets \a count for ticks on the axis. | ||||
| */ | ||||
|
Michal Klocek
|
r223 | void QChartAxis::setTicksCount(int count) | ||
| { | ||||
|
Michal Klocek
|
r439 | if(m_ticksCount!=count) { | ||
|
Michal Klocek
|
r223 | m_ticksCount=count; | ||
|
Michal Klocek
|
r439 | emit updated(); | ||
| } | ||||
|
Michal Klocek
|
r223 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| TODO: refactor me. Sets string \a label for \a value on the axis. | ||||
| */ | ||||
|
Michal Klocek
|
r223 | void QChartAxis::addAxisTickLabel(qreal value,const QString& label) | ||
| { | ||||
| m_ticks.insert(value,label); | ||||
|
Michal Klocek
|
r439 | emit updated(); | ||
|
Michal Klocek
|
r223 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| TODO: refactor me. Removes label for \a value on the axis. | ||||
| */ | ||||
|
Michal Klocek
|
r223 | void QChartAxis::removeAxisTickLabel(qreal value) | ||
| { | ||||
| m_ticks.remove(value); | ||||
|
Michal Klocek
|
r439 | emit updated(); | ||
|
Michal Klocek
|
r223 | } | ||
|
Michal Klocek
|
r331 | /*! | ||
| TODO: refactor me. Returns label for \a value on the axis. | ||||
| */ | ||||
|
Michal Klocek
|
r223 | QString QChartAxis::axisTickLabel(qreal value) const | ||
| { | ||||
| return m_ticks.value(value); | ||||
| } | ||||
|
Michal Klocek
|
r331 | /*! | ||
| TODO: refactor me. Removes all the string labels for on the axis. | ||||
| */ | ||||
|
Michal Klocek
|
r223 | void QChartAxis::clearAxisTickLabels() | ||
| { | ||||
| m_ticks.clear(); | ||||
|
Michal Klocek
|
r439 | emit updated(); | ||
|
Michal Klocek
|
r223 | } | ||
| #include "moc_qchartaxis.cpp" | ||||
|
Michal Klocek
|
r85 | QTCOMMERCIALCHART_END_NAMESPACE | ||