QAbstractBarSeries Class

Series for creating a bar chart. More...

Public Types

enum LabelsPosition { LabelsCenter, LabelsInsideEnd, LabelsInsideBase, LabelsOutsideEnd }

Properties

Public Functions

virtual ~QAbstractBarSeries()
bool append(QBarSet *set)
bool append(QList<QBarSet *> sets)
QList<QBarSet *> barSets() const
qreal barWidth() const
void clear()
int count() const
bool insert(int index, QBarSet *set)
bool isLabelsVisible() const
qreal labelsAngle() const
QString labelsFormat() const
QAbstractBarSeries::LabelsPosition labelsPosition() const
bool remove(QBarSet *set)
void setBarWidth(qreal width)
void setLabelsAngle(qreal angle)
void setLabelsFormat(const QString &format)
void setLabelsPosition(QAbstractBarSeries::LabelsPosition position)
void setLabelsVisible(bool visible = true)
bool take(QBarSet *set)

Signals

void barsetsAdded(QList<QBarSet *> sets)
void barsetsRemoved(QList<QBarSet *> sets)
void clicked(int index, QBarSet *barset)
void countChanged()
void doubleClicked(int index, QBarSet *barset)
void hovered(bool status, int index, QBarSet *barset)
void labelsAngleChanged(qreal angle)
void labelsFormatChanged(const QString &format)
void labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)
void labelsVisibleChanged()
void pressed(int index, QBarSet *barset)
void released(int index, QBarSet *barset)

Additional Inherited Members

  • 1 public slot inherited from QObject
  • 11 static public members inherited from QObject
  • 9 protected functions inherited from QObject

Detailed Description

Series for creating a bar chart.

QAbstractBarSeries represents a series of data shown as bars. The purpose of this class is to draw bars to the position defined by data. Single bar is defined by QPointF, where x value is the x-coordinate of the bar and y-value is the height of the bar. The category names are ignored with this series and x-axis shows the x-values.

See the bar chart example to learn how to create a simple bar chart.

See also QBarSet, QStackedBarSeries, and QPercentBarSeries.

Member Type Documentation

enum QAbstractBarSeries::LabelsPosition

This enum describes the position of the data value labels.

ConstantValueDescription
QAbstractBarSeries::LabelsCenter0Label is in the center of the bar.
QAbstractBarSeries::LabelsInsideEnd1Label is inside the bar at the high end of it.
QAbstractBarSeries::LabelsInsideBase2Label is inside the bar at the low end of it.
QAbstractBarSeries::LabelsOutsideEnd3Label is outside the bar at the high end of it.

Property Documentation

barWidth : qreal

The width of the bars of the series. The unit of width is the unit of x-axis. The minimum width for bars is zero and negative values are treated as zero. Setting the width to zero means that width of the bar on screen is one pixel no matter what the scale of x-axis is. Bars wider than zero are scaled with x-axis. Note that with QBarSeries this value means the width of one group of bars instead of just one bar.

Access functions:

qreal barWidth() const
void setBarWidth(qreal width)

See also QBarSeries.

count : const int

Holds the number of sets in series.

Access functions:

int count() const

Notifier signal:

void countChanged()

labelsAngle : qreal

The angle of the value labels in degrees.

Access functions:

qreal labelsAngle() const
void setLabelsAngle(qreal angle)

Notifier signal:

void labelsAngleChanged(qreal angle)

labelsFormat : QString

The format used for showing labels in series.

QAbstractBarSeries supports the following format tag:

@valueThe value of the bar

For example, the following usage of the format tags would produce labels that show the value followed by unit ('u'):

series->setLabelsFormat("@value u");

By default, the labels shows the value of the bar. For percent bar series '%' is added after the value. The labels are shown on the plot area, labels on the edge of the plot area are cut. If the bars are close to each other the labels may overlap.

Access functions:

QString labelsFormat() const
void setLabelsFormat(const QString &format)

Notifier signal:

void labelsFormatChanged(const QString &format)

See also QAbstractBarSeries::labelsVisible and QAbstractBarSeries::labelsPosition.

labelsPosition : LabelsPosition

Defines the position of value labels.

Access functions:

QAbstractBarSeries::LabelsPosition labelsPosition() const
void setLabelsPosition(QAbstractBarSeries::LabelsPosition position)

Notifier signal:

void labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)

See also QAbstractBarSeries::labelsVisible and QAbstractBarSeries::labelsFormat.

labelsVisible : bool

Defines the visibility of the labels in series

Access functions:

bool isLabelsVisible() const
void setLabelsVisible(bool visible = true)

Notifier signal:

Member Function Documentation

[virtual] QAbstractBarSeries::~QAbstractBarSeries()

Destructs abstractbarseries and owned barsets.

bool QAbstractBarSeries::append(QBarSet *set)

Adds a set of bars to series. Takes ownership of set. If the set is null or is already in series, it won't be appended. Returns true, if appending succeeded.

bool QAbstractBarSeries::append(QList<QBarSet *> sets)

Adds a list of barsets to series. Takes ownership of sets. Returns true, if all sets were appended successfully. If any of the sets is null or is already appended to series, nothing is appended and function returns false. If any of the sets is in list more than once, nothing is appended and function returns false.

QList<QBarSet *> QAbstractBarSeries::barSets() const

Returns a list of sets in series. Keeps ownership of sets.

qreal QAbstractBarSeries::barWidth() const

Returns the width of the bars of the series.

Note: Getter function for property barWidth.

See also setBarWidth().

[signal] void QAbstractBarSeries::barsetsAdded(QList<QBarSet *> sets)

This signal is emitted when sets have been added to the series.

See also append() and insert().

[signal] void QAbstractBarSeries::barsetsRemoved(QList<QBarSet *> sets)

This signal is emitted when sets have been removed from the series.

See also remove().

void QAbstractBarSeries::clear()

Removes all barsets from the series. Deletes removed sets.

[signal] void QAbstractBarSeries::clicked(int index, QBarSet *barset)

The signal is emitted if the user clicks with a mouse on top of QBarSet barset. Clicked bar inside set is indexed by index

int QAbstractBarSeries::count() const

Returns number of sets in series.

Note: Getter function for property count.

[signal] void QAbstractBarSeries::countChanged()

This signal is emitted when barset count has been changed, for example by append or remove.

Note: Notifier signal for property count.

[signal] void QAbstractBarSeries::doubleClicked(int index, QBarSet *barset)

The signal is emitted if the user doubleclicks with a mouse on top of QBarSet barset. DoubleClicked bar inside set is indexed by index

[signal] void QAbstractBarSeries::hovered(bool status, int index, QBarSet *barset)

The signal is emitted if mouse is hovered on top of series. Parameter barset is the pointer of barset, where hover happened. Parameter status is true, if mouse entered on top of series, false if mouse left from top of series. Hovered bar inside the set is indexed by index.

bool QAbstractBarSeries::insert(int index, QBarSet *set)

Insert a set of bars to series at index postion. Takes ownership of set. If the set is null or is already in series, it won't be appended. Returns true, if inserting succeeded.

bool QAbstractBarSeries::isLabelsVisible() const

Returns the visibility of labels

Note: Getter function for property labelsVisible.

[signal] void QAbstractBarSeries::labelsAngleChanged(qreal angle)

Signal is emitted when the angle of the value labels is changed.

Note: Notifier signal for property labelsAngle.

[signal] void QAbstractBarSeries::labelsFormatChanged(const QString &format)

Signal is emitted when the format of data value labels is changed.

Note: Notifier signal for property labelsFormat.

[signal] void QAbstractBarSeries::labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)

Signal is emitted when the position of value labels is changed.

Note: Notifier signal for property labelsPosition.

[signal] void QAbstractBarSeries::labelsVisibleChanged()

This signal is emitted when labels visibility have changed.

Note: Notifier signal for property labelsVisible.

See also isLabelsVisible() and setLabelsVisible().

[signal] void QAbstractBarSeries::pressed(int index, QBarSet *barset)

The signal is emitted if the user presses with a mouse on top of QBarSet barset. Pressed bar inside set is indexed by index

[signal] void QAbstractBarSeries::released(int index, QBarSet *barset)

The signal is emitted if the user releases with a mouse on top of QBarSet barset. Released bar inside set is indexed by index

bool QAbstractBarSeries::remove(QBarSet *set)

Removes barset from series. Releases ownership of set. Deletes the set, if remove was successful. Returns true, if set was removed.

void QAbstractBarSeries::setBarWidth(qreal width)

Sets the width of the bars of the series. The unit of width is the unit of x-axis. The minimum width for bars is zero and negative values are treated as zero. Setting the width to zero means that width of the bar on screen is one pixel no matter what the scale of x-axis is. Bars wider than zero are scaled with x-axis. Note that with this value means the width of one group of bars instead of just one bar.

Note: Setter function for property barWidth.

See also barWidth().

void QAbstractBarSeries::setLabelsVisible(bool visible = true)

Sets the visibility of labels in series to visible

Note: Setter function for property labelsVisible.

See also isLabelsVisible().

bool QAbstractBarSeries::take(QBarSet *set)

Takes a single set from the series. Does not delete the barset object.

NOTE: The series remains as the barset's parent object. You must set the parent object to take full ownership.

Returns true if take was successful.

© 2016 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.