QXYSeries Class

The QXYSeries class is a base class for line, spline, and scatter series. More...

Header: #include <QXYSeries>
Instantiated By: XYSeries
Inherits: QAbstractSeries
Inherited By:

QLineSeries and QScatterSeries

Properties

Public Functions

virtual QColor color() const
bool pointLabelsClipping() const
QColor pointLabelsColor() const
QFont pointLabelsFont() const
QString pointLabelsFormat() const
bool pointLabelsVisible() const
bool pointsVisible() const
virtual void setColor(const QColor &color)
void setPointLabelsClipping(bool enabled = true)
void setPointLabelsColor(const QColor &color)
void setPointLabelsFont(const QFont &font)
void setPointLabelsFormat(const QString &format)
void setPointLabelsVisible(bool visible = true)
void setPointsVisible(bool visible = true)

Signals

void colorChanged(QColor color)
void pointLabelsClippingChanged(bool clipping)
void pointLabelsColorChanged(const QColor &color)
void pointLabelsFontChanged(const QFont &font)
void pointLabelsFormatChanged(const QString &format)
void pointLabelsVisibilityChanged(bool visible)

Detailed Description

Property Documentation

color : QColor

This property holds the color of the series.

This is the line (pen) color in case of QLineSeries or QSplineSeries and the fill (brush) color in case of QScatterSeries or QAreaSeries.

Access functions:

virtual QColor color() const
virtual void setColor(const QColor &color)

Notifier signal:

void colorChanged(QColor color)

See also pen() and brush().

pointLabelsClipping : bool

This property holds the clipping for data point labels.

This property is true by default. The labels on the edge of the plot area are cut when clipping is enabled.

Access functions:

bool pointLabelsClipping() const
void setPointLabelsClipping(bool enabled = true)

Notifier signal:

void pointLabelsClippingChanged(bool clipping)

See also pointLabelsVisible.

pointLabelsColor : QColor

This property holds the color used for data point labels. By default, the color is the color of the brush defined in theme for labels.

Access functions:

QColor pointLabelsColor() const
void setPointLabelsColor(const QColor &color)

Notifier signal:

void pointLabelsColorChanged(const QColor &color)

See also pointLabelsFormat.

pointLabelsFont : QFont

This property holds the font used for data point labels.

Access functions:

QFont pointLabelsFont() const
void setPointLabelsFont(const QFont &font)

Notifier signal:

void pointLabelsFontChanged(const QFont &font)

See also pointLabelsFormat.

pointLabelsFormat : QString

This property holds the format used for showing labels with data points.

QXYSeries supports the following format tags:

@xPointThe x-coordinate of the data point.
@yPointThe y-coordinate of the data point.

For example, the following usage of the format tags would produce labels that display the data point shown inside brackets separated by a comma (x, y):

 series->setPointLabelsFormat("(@xPoint, @yPoint)");

By default, the labels' format is set to @xPoint, @yPoint. The labels are shown on the plot area, and the labels on the edge of the plot area are cut. If the points are close to each other, the labels may overlap.

Access functions:

QString pointLabelsFormat() const
void setPointLabelsFormat(const QString &format)

Notifier signal:

void pointLabelsFormatChanged(const QString &format)

See also pointLabelsVisible, pointLabelsFont, and pointLabelsColor.

pointLabelsVisible : bool

This property holds the visibility of data point labels.

This property is false by default.

Access functions:

bool pointLabelsVisible() const
void setPointLabelsVisible(bool visible = true)

Notifier signal:

void pointLabelsVisibilityChanged(bool visible)

See also pointLabelsFormat and pointLabelsClipping.

pointsVisible : bool

This property holds whether the data points are visible and should be drawn.

Access functions:

bool pointsVisible() const
void setPointsVisible(bool visible = true)