diff options
Diffstat (limited to 'src/charts/areachart/qareaseries.cpp')
| -rw-r--r-- | src/charts/areachart/qareaseries.cpp | 121 |
1 files changed, 80 insertions, 41 deletions
diff --git a/src/charts/areachart/qareaseries.cpp b/src/charts/areachart/qareaseries.cpp index c1e5bac6..764579f2 100644 --- a/src/charts/areachart/qareaseries.cpp +++ b/src/charts/areachart/qareaseries.cpp @@ -70,18 +70,71 @@ QT_CHARTS_BEGIN_NAMESPACE \brief Presents data in area charts. + An area series is used to show quantitative data. It is based on a line + series, in the way that the area between the boundary lines is emphasized + with color. The LineSeries type defines the \e upper boundary of the + area. The area chart is drawn using the bottom of the plot area as the + \e lower boundary by default. Instead of the bottom of the plot area, the + lower boundary can be specified by another line. In that case, the + AreaSeries should use two LineSeries types. + + \note The terms \e upper and \e lower boundary can be misleading in cases + where the value of the lower boundary is greater than that of the upper + boundary. The main point is that the area between these two boundary lines + will be filled. + + \image examples_qmlchart4.png + The following QML shows how to create a simple area chart: \snippet qmlchart/qml/qmlchart/View4.qml 1 - \beginfloatleft - \image examples_qmlchart4.png - \endfloat - \clearfloat \note Adding the same line series to a chart and area series is not supported. The series used as boundary lines should be defined only for the area series. */ /*! + \qmlproperty AbstractAxis AreaSeries::axisX + The x-axis used for the series. If you leave both axisX and axisXTop + undefined, a value axis is created for the series. + \sa axisXTop, ValueAxis +*/ + +/*! + \qmlproperty AbstractAxis AreaSeries::axisY + The y-axis used for the series. If you leave both axisY and axisYRight + undefined, a value axis is created for the series. + \sa axisYRight, ValueAxis +*/ + +/*! + \qmlproperty AbstractAxis AreaSeries::axisXTop + The x-axis used for the series, drawn on top of the chart view. + + \note You can only provide either axisX or axisXTop, not both. + \sa axisX +*/ + +/*! + \qmlproperty AbstractAxis AreaSeries::axisYRight + The y-axis used for the series, drawn to the right on the chart view. + + \note You can only provide either axisY or axisYRight, not both. + \sa axisY +*/ + +/*! + \qmlproperty AbstractAxis AreaSeries::axisAngular + The angular axis used for the series, drawn around the polar chart view. + \sa axisX, PolarChartView +*/ + +/*! + \qmlproperty AbstractAxis AreaSeries::axisRadial + The radial axis used for the series, drawn inside the polar chart view. + \sa axisY, PolarChartView +*/ + +/*! \property QAreaSeries::upperSeries \brief The upper one of the two line series used to define area series boundaries. */ @@ -151,19 +204,11 @@ QT_CHARTS_BEGIN_NAMESPACE \fn void QAreaSeries::colorChanged(QColor color) \brief This signal is emitted when the fill (brush) color changes to \a color. */ -/*! - \qmlsignal AreaSeries::onColorChanged(color color) - This signal is emitted when the fill (brush) color changes to \a color. -*/ /*! \fn void QAreaSeries::borderColorChanged(QColor color) \brief This signal is emitted when the line (pen) color changes to \a color. */ -/*! - \qmlsignal AreaSeries::onBorderColorChanged(color color) - This signal is emitted when the line (pen) color changes to \a color. -*/ /*! \fn void QAreaSeries::clicked(const QPointF& point) @@ -172,10 +217,13 @@ QT_CHARTS_BEGIN_NAMESPACE \sa pressed, released, doubleClicked */ /*! - \qmlsignal AreaSeries::onClicked(QPointF point) + \qmlsignal AreaSeries::clicked(point point) This signal is emitted when the user triggers a press on \a point by clicking it in an area chart. - \sa onPressed, onReleased, onDoubleClicked + + The corresponding signal handler is \c {onClicked}. + + \sa pressed, released, doubleClicked */ /*! @@ -185,10 +233,12 @@ QT_CHARTS_BEGIN_NAMESPACE the cursor hovers over the series and turns \e false when it moves away from the series. */ /*! - \qmlsignal AreaSeries::onHovered(point point, bool state) + \qmlsignal AreaSeries::hovered(point point, bool state) This signal is emitted when the user hovers the mouse cursor over a series or moves it away from the series. \a point shows the origin (coordinate) of the hover event. \a state is \c true when the cursor hovers over the series and turns \e false when it moves away from the series. + + The corresponding signal handler is \c {onHovered}. */ /*! @@ -198,9 +248,12 @@ QT_CHARTS_BEGIN_NAMESPACE \sa clicked, released, doubleClicked */ /*! - \qmlsignal AreaSeries::onPressed(QPointF point) + \qmlsignal AreaSeries::pressed(point point) This signal is emitted when the user presses the point specified by \a point in an area chart. - \sa onClicked, onReleased, onDoubleClicked + + The corresponding signal handler is \c {onPressed}. + + \sa clicked, released, doubleClicked */ /*! @@ -210,10 +263,13 @@ QT_CHARTS_BEGIN_NAMESPACE \sa pressed, clicked, doubleClicked */ /*! - \qmlsignal AreaSeries::onReleased(QPointF point) + \qmlsignal AreaSeries::released(point point) This signal is emitted when the user releases a press that was triggered on \a point in an area chart. - \sa onPressed, onClicked, onDoubleClicked + + The corresponding signal handler is \c {onReleased}. + + \sa pressed, clicked, doubleClicked */ /*! @@ -223,10 +279,13 @@ QT_CHARTS_BEGIN_NAMESPACE \sa pressed, released, clicked */ /*! - \qmlsignal AreaSeries::onDoubleClicked(QPointF point) + \qmlsignal AreaSeries::doubleClicked(point point) This signal is emitted when the user triggers the first press in an area chart by doubleclicking \a point. - \sa onPressed, onReleased, onClicked + + The corresponding signal handler is \c {onDoubleClicked}. + + \sa pressed, released, clicked */ /*! @@ -273,10 +332,6 @@ QT_CHARTS_BEGIN_NAMESPACE \fn void QAreaSeries::pointLabelsFormatChanged(const QString &format) This signal is emitted when the \a format of data point labels is changed. */ -/*! - \qmlsignal AreaSeries::onPointLabelsFormatChanged(string format) - This signal is emitted when the \a format of data point labels is changed. -*/ /*! \property QAreaSeries::pointLabelsVisible @@ -294,10 +349,6 @@ QT_CHARTS_BEGIN_NAMESPACE \fn void QAreaSeries::pointLabelsVisibilityChanged(bool visible) This signal is emitted when the visibility of the data point labels changes to \a visible. */ -/*! - \qmlsignal AreaSeries::onPointLabelsVisibilityChanged(bool visible) - This signal is emitted when the visibility of the data point labels changes to \a visible. -*/ /*! \property QAreaSeries::pointLabelsFont @@ -315,10 +366,6 @@ QT_CHARTS_BEGIN_NAMESPACE \fn void QAreaSeries::pointLabelsFontChanged(const QFont &font); This signal is emitted when the font used for data point labels changes to \a font. */ -/*! - \qmlsignal AreaSeries::onPointLabelsFontChanged(Font font) - This signal is emitted when the font used for data point labels changes to \a font. -*/ /*! \property QAreaSeries::pointLabelsColor @@ -338,10 +385,6 @@ QT_CHARTS_BEGIN_NAMESPACE \fn void QAreaSeries::pointLabelsColorChanged(const QColor &color); This signal is emitted when the color used for data point labels changes to \a color. */ -/*! - \qmlsignal AreaSeries::onPointLabelsColorChanged(Color color) - This signal is emitted when the color used for data point labels changes to \a color. -*/ /*! \property QAreaSeries::pointLabelsClipping @@ -361,10 +404,6 @@ QT_CHARTS_BEGIN_NAMESPACE \fn void QAreaSeries::pointLabelsClippingChanged(bool clipping) This signal is emitted when the clipping of the data point labels changes to \a clipping. */ -/*! - \qmlsignal AreaSeries::onPointLabelsClippingChanged(bool clipping) - This signal is emitted when the clipping of the data point labels changes to \a clipping. -*/ /*! Constructs an area series object that will be spanned between an \a upperSeries line and a |