Source code
Revision control
Copy as Markdown
// Copyright (C) 2023 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
// Qt-Security score:significant reason:default
#include "graphs2d/qabstractseries_p.h"
#include <QtGraphs/qabstractseries.h>
#include <QtGraphs/qbarseries.h>
#include <QtGraphs/qbarset.h>
#include <private/qabstractseries_p.h>
#include <private/qbarseries_p.h>
#include <private/qbarset_p.h>
#include <private/qgraphsview_p.h>
QT_BEGIN_NAMESPACE
/*!
\class QBarSeries
\inmodule QtGraphs
\ingroup graphs_2D
\brief The QBarSeries class presents data in bar graphs.
This class draws data by default as a series of bars grouped by category,
with one bar per category from each bar set added to the series.
It also supports horizontal bars and grouping bars as stacked.
A bar series needs the GraphsView x-axis to be set to a BarCategoryAxis and
the y-axis set to ValueAxis.
\sa QBarSet, QAbstractSeries
*/
/*!
\qmltype BarSeries
\nativetype QBarSeries
\inqmlmodule QtGraphs
\ingroup graphs_qml_2D
\inherits AbstractSeries
\brief Presents data in bar graphs.
Draws data by default as a series of bars grouped by category,
with one bar per category from each bar set added to the series.
It also supports horizontal bars and grouping bars as stacked.
*/
/*!
\property QBarSeries::barWidth
\brief The width of the bars of the series.
The unit of width is the unit of the x-axis. The minimum width for bars is zero, and negative
values are treated as zero. Setting the width to zero means that the width of the bar on the
screen is one pixel regardless of the scale of the x-axis. Bars wider than zero are scaled
using the x-axis scale.
By default, the barWidth is 0.5 (bars will take 50% of the available width).
The valid values range from 0.0 (0%) to 1.0 (100%).
\note When used with QBarSeries, this value specifies the width of a group of bars instead of
that of a single bar.
\sa QBarSeries
*/
/*!
\enum QBarSeries::BarsType
This enum value describes the type of the bar series:
\value Groups Bar sets are grouped by category.
\value Stacked Bar sets are stacked after each other by category.
\value StackedPercent Bar sets are stacked after each other by category.
The segment size corresponds to the percentage of the segment value
compared with the total value of all segments in the stack.
*/
/*!
\property QBarSeries::barsType
\brief The type of the bar series.
*/
/*!
\qmlproperty enumeration BarSeries::barsType
The type of the bar series:
\value BarSeries.BarsType.Groups
Bar sets are grouped by category. This is the default value.
\value BarSeries.BarsType.Stacked
Bar sets are stacked after each other by category.
\value BarSeries.BarsType.StackedPercent
Bar sets are stacked after each other by category. The segment size corresponds
to the percentage of the segment value compared with the total value of all
segments in the stack.
*/
/*!
\qmlproperty real BarSeries::barWidth
The unit of width is the unit of the x-axis. The minimum width for bars is zero, and negative
values are treated as zero. Setting the width to zero means that the width of the bar on the
screen is one pixel regardless of the scale of the x-axis. Bars wider than zero are scaled
using the x-axis scale.
By default, the barWidth is 0.5 (bars will take 50% of the available width).
The valid values range from 0.0 (0%) to 1.0 (100%).
\note When used with the BarSeries type, this value specifies the width of a group of bars
instead of that of a single bar.
*/
/*!
\property QBarSeries::count
\brief The number of bar sets in a bar series.
*/
/*!
\qmlproperty int BarSeries::count
The number of bar sets in a bar series.
*/
/*!
\property QBarSeries::labelsVisible
\brief The visibility of the labels in a bar series.
The default label visibility is \c false.
\note The default label only displays the value for the set.
You can create custom labels with a \l barDelegate.
\sa barDelegate
*/
/*!
\qmlproperty bool BarSeries::labelsVisible
The visibility of the labels in a bar series.
The default label visibility is \c false.
\note The default label only displays the value for the set.
You can create custom labels with a \l barDelegate.
\sa barDelegate
*/
/*!
\property QBarSeries::labelsFormat
\brief The format used for showing labels in a bar series.
QBarSeries supports the following format tag:
\table
\row
\li @value \li The value of the bar
\endtable
For example, the following usage of the format tags would produce labels that show the value
followed by the unit (u):
\code
series->setLabelsFormat("@value u");
\endcode
By default, the labels show the value of the bar. For the percent bar series, \e % is added
after the value. The labels are shown on the plot area, if the bars are close to each other,
the labels may overlap.
\sa labelsVisible, labelsPosition, labelsPrecision
*/
/*!
\qmlproperty string BarSeries::labelsFormat
The format used for showing labels in a bar series.
\sa QBarSeries::labelsFormat, labelsVisible, labelsPosition
*/
/*!
\enum QBarSeries::LabelsPosition
This enum value describes the position of the data value labels:
\value Center Label is located in the center of the bar.
\value InsideEnd Label is located inside the bar at the top.
\value InsideBase Label is located inside the bar at the bottom.
\value OutsideEnd Label is located outside the bar at the top.
*/
/*!
\property QBarSeries::labelsPosition
\brief The position of value labels.
\sa labelsVisible, labelsFormat
*/
/*!
\qmlproperty enumeration BarSeries::labelsPosition
The position of the data value labels:
\value BarSeries.LabelsPosition.Center
Label is located in the center of the bar.
\value BarSeries.LabelsPosition.InsideEnd
Label is located inside the bar at the top.
\value BarSeries.LabelsPosition.InsideBase
Label is located inside the bar at the bottom.
\value BarSeries.LabelsPosition.OutsideEnd
Label is located outside the bar at the top.
\sa labelsVisible, labelsFormat
*/
/*!
\property QBarSeries::labelsMargin
\brief The margin of the value labels in pixels.
This margin from side is used when \l labelsPosition is set to something else
than \c LabelsPosition.Center. The default value is \c 0.
*/
/*!
\qmlproperty real BarSeries::labelsMargin
The margin of the value labels in pixels.
This margin from side is used when \l labelsPosition is set to something else
than \c LabelsPosition.Center. The default value is \c 0.
*/
/*!
\property QBarSeries::labelsAngle
\brief The angle of the value labels in degrees.
*/
/*!
\qmlproperty real BarSeries::labelsAngle
The angle of the value labels in degrees.
*/
/*!
\property QBarSeries::labelsPrecision
\brief The maximum amount of significant digits shown in value labels.
Default value is 6.
*/
/*!
\qmlproperty real BarSeries::labelsPrecision
The maximum amount of significant digits shown in value labels.
Default value is 6.
*/
/*!
\property QBarSeries::barDelegate
\brief A custom QML component used for visualizing each of the bars.
Instance of this component is created for each of the bar.
When this is not defined, a default rectangle visualization for bars is used.
The dynamic properties available for this component are:
\table
\header
\li Type
\li Name
\li Description
\row
\li QColor
\li barColor
\li The fill color of the bar. This value comes either from the \l QGraphsTheme
or from \l{QBarSet::color} if the \l QBarSet overrides the color.
\row
\li QColor
\li barBorderColor
\li The border color of the bar. This value comes either from the \l QGraphsTheme
or from \l{QBarSet::borderColor} if the \l QBarSet overrides the color.
\row
\li qreal
\li barBorderWidth
\li The width of the bar border. This value comes either from the \l QGraphsTheme
or from \l{QBarSet::borderWidth} if the \l QBarSet overrides the width.
\row
\li qreal
\li barValue
\li The value of the bar. This value comes from the \l{QBarSet::values}.
\row
\li QString
\li barLabel
\li The label of the bar. This value comes from the \l{QBarSet::label}.
\row
\li bool
\li barSelected
\li This value is true when the bar is selected, meaning that the bar index
is in \l{QBarSet::selectedBars}.
\row
\li int
\li barIndex
\li Index of the bar, from 0 to the amount of bars - 1. [since 6.9]
\endtable
To use any of these, add property with the defined name into your custom component.
For example \c{"property color barColor"} and \c{"property real barValue"}.
*/
/*!
\qmlproperty Component BarSeries::barDelegate
A custom QML component used for visualizing each of the bars.
Instance of this component is created for each of the bar.
When this is not defined, a default rectangle visualization for bars is used.
The dynamic properties available for this component are:
\table
\header
\li Type
\li Name
\li Description
\row
\li color
\li barColor
\li The fill color of the bar. This value comes either from the \l GraphsTheme
or from \l{BarSet::color} if the \l BarSet overrides the color.
\row
\li color
\li barBorderColor
\li The border color of the bar. This value comes either from the \l GraphsTheme
or from \l{BarSet::borderColor} if the \l BarSet overrides the color.
\row
\li real
\li barBorderWidth
\li The width of the bar border. This value comes either from the \l GraphsTheme
or from \l{BarSet::borderWidth} if the \l BarSet overrides the width.
\row
\li real
\li barValue
\li The value of the bar. This value comes from the \l{BarSet::values}.
\row
\li string
\li barLabel
\li The label of the bar. This value comes from the \l{BarSet::label}.
\row
\li bool
\li barSelected
\li This value is true when the bar is selected, meaning that the bar index
is in \l{BarSet::selectedBars}.
\row
\li int
\li barIndex
\li Index of the bar, from 0 to the amount of bars - 1. [since 6.9]
\endtable
To use any of these, add property with the defined name into your custom component.
For example \c{"property color barColor"} and \c{"property real barValue"}.
*/
/*!
\property QBarSeries::barSets
\brief A list of sets added to the series.
*/
/*!
\qmlproperty list<BarSet> BarSeries::barSets
A list of sets added to the series.
*/
/*!
\fn void QBarSeries::updatedBars()
This signal is emitted when bars are updated.
*/
/*!
\fn void QBarSeries::labelsVisibleChanged(bool visible)
This signal is emitted when the labels' visibility changes to \a visible.
\sa labelsVisible(), setLabelsVisible()
*/
/*!
\fn void QBarSeries::barsetsAdded(const QList<QBarSet *> &sets)
This signal is emitted when the bar sets specified by \a sets are added to the series.
\sa append(), insert()
*/
/*!
\qmlsignal BarSeries::barsetsAdded()
This signal is emitted when bar sets are added to the series.
*/
/*!
\fn void QBarSeries::barsetsRemoved(const QList<QBarSet *> &sets)
This signal is emitted when the bar sets specified by \a sets are removed from the series.
\sa remove()
*/
/*!
\qmlsignal BarSeries::barsetsRemoved()
This signal is emitted when bar sets are removed from the series.
*/
/*!
\fn void QBarSeries::setValueChanged(qsizetype index, QBarSet *barset)
This signal is emitted when a barset's value is changed. \a index is the index of
the barset in the series. The \a barset is a pointer to the changed set.
*/
/*!
\fn void QBarSeries::setValueAdded(qsizetype index, qsizetype count, QBarSet *barset)
This signal is emitted when a barset's value is changed. \a index is the index of
the barset in the series. The number of the added values is indicated \a count.
The \a barset is a pointer to the changed set.
*/
/*!
\fn void QBarSeries::setValueRemoved(qsizetype index, qsizetype count, QBarSet *barset)
This signal is emitted when a barset's value is changed. \a index is the index of
the barset in the series. The number of the removed values is indicated \a count.
The \a barset is a pointer to the changed set.
*/
/*!
\qmlmethod BarSet BarSeries::at(int index)
Returns the bar set at \a index. Returns null if the index is not valid.
*/
/*!
\qmlmethod BarSet BarSeries::insert(int index, BarSet barset)
Inserts a bar set specified by \a barset to a series at the position specified by \a index.
If the set is \c null or already belongs to the series, the set is not
appended. Returns \c true if inserting succeeds.
\sa append()
*/
/*!
\qmlmethod bool BarSeries::append(BarSet barset)
Adds a set of bars specified by \a barset to the bar series and takes
ownership of it. If the set is null or it already belongs to the series,
it will not be appended.
Returns \c true if appending succeeded.
\sa insert()
*/
/*!
\qmlmethod bool BarSeries::remove(BarSet barset)
Removes the bar set specified by \a barset from the series. Returns \c true if successful,
\c false otherwise.
*/
/*!
\qmlmethod void BarSeries::clear()
Removes all bar sets from the series.
*/
/*!
\qmlmethod bool BarSeries::replace(int index, BarSet barset)
Replaces the bar set at the position specified by \a index from the series and replaces it
with \a barset. Returns \c true if successful, \c false otherwise.
*/
/*!
\qmlmethod Barset BarSeries::at(int index)
Returns the bar set specified by \a index from the series. Returns \c null otherwise.
*/
/*!
\qmlmethod int BarSeries::find(BarSet barset)
Returns the index of the bar set specified by \a barset from the series. Returns \c -1 if
not found.
*/
/*!
\qmlmethod void BarSeries::removeMultiple(int index, int count)
Removes a range of bar sets as specified by the \a index and \a count. The call
traverses over all sets even if removal of one fails.
*/
/*!
\qmlmethod bool BarSeries::remove(int index)
Removes the bar set specified by \a index from the series. Returns \c true if the
removal was successful, \c false otherwise.
*/
/*!
\qmlmethod bool BarSeries::replace(BarSet oldSet, BarSet newSet)
Replaces the bar set specified by \a oldSet with newSet. Returns \c true if the
removal was successful, \c false otherwise. \a oldSet is destroyed if this
is successful.
*/
/*!
\qmlmethod bool BarSeries::replace(list<BarSet> sets)
Completely replaces all current bar set with \a sets. The size does not need
to match. Returns false if any of the bar set in \a sets are invalid.
*/
/*!
\qmlsignal BarSeries::clicked(int index, BarSet barset)
This signal is emitted when the user clicks or taps the bar specified by \a index
in the bar set specified by \a barset.
*/
/*!
\qmlsignal BarSeries::doubleClicked(int index, BarSet barset)
This signal is emitted when the user double-clicks or double-taps the bar specified
by \a index in the bar set specified by \a barset.
This signal always occurs after \l clicked.
*/
/*!
\qmlsignal BarSeries::pressed(int index, BarSet barset)
This signal is emitted when the user clicks or taps the bar specified by \a index
in the bar set specified by \a barset and holds down the mouse button or gesture.
*/
/*!
\qmlsignal BarSeries::released(int index, BarSet barset);
This signal is emitted when the user releases a previously pressed mouse button
or gesture on the bar specified by \a index in the bar set specified by \a barset.
*/
/*!
\qmlsignal BarSeries::hovered(bool state, int index, BarSet barset)
This signal is emitted when a mouse or touch hovers over the bar specified by \a index
in the bar set specified by \a barset. \a state is \c true when the cursor enters the
bar and \c false when it leaves it.
*/
/*!
\internal
*/
/*!
Constructs an empty bar series that is a QObject and a child of \a parent.
*/
QBarSeries::QBarSeries(QObject *parent)
: QAbstractSeries(*(new QBarSeriesPrivate()), parent)
{}
QBarSeries::~QBarSeries() {}
QBarSeries::QBarSeries(QBarSeriesPrivate &dd, QObject *parent)
: QAbstractSeries(dd, parent)
{}
/*!
Returns the bar series.
*/
QAbstractSeries::SeriesType QBarSeries::type() const
{
return QAbstractSeries::SeriesType::Bar;
}
/*!
\property QBarSeries::seriesColors
\brief The list of base colors to be used for all the objects in the series.
If there are more series than colors, the color list wraps and starts again
with the first color in the list. If this is not set (default), colors
from the \l{QGraphsTheme::seriesColors} will be used.
*/
/*!
\qmlproperty list<color> BarSeries::seriesColors
The list of base colors to be used for all the objects in the series.
If there are more series than colors, the color list wraps and starts again
with the first color in the list. If this is not set (default), colors
from the \l{GraphsTheme::seriesColors} will be used.
*/
QList<QColor> QBarSeries::seriesColors() const
{
Q_D(const QBarSeries);
return d->m_seriesColors;
}
void QBarSeries::setSeriesColors(const QList<QColor> &newSeriesColors)
{
Q_D(QBarSeries);
for (const QColor &color : newSeriesColors) {
if (!color.isValid()) {
qCWarning(lcProperties2D, "QBarSeries::setSeriesColors. Tried to use invalid color value.");
break;
}
}
if (d->m_seriesColors == newSeriesColors) {
qCDebug(lcProperties2D) << "QBarSeries::setSeriesColors. Set value of" << newSeriesColors << "is the same as it already was.";
return;
}
d->m_seriesColors = newSeriesColors;
emit seriesColorsChanged();
emit update();
}
/*!
\property QBarSeries::borderColors
\brief The list of border colors to be used for all the objects in the series.
If there are more series than colors, the color list wraps and starts again
with the first color in the list. If this is not set (default), colors
from the \l{QGraphsTheme::borderColors} will be used.
*/
/*!
\qmlproperty list<color> BarSeries::borderColors
The list of border colors to be used for all the objects in the series.
If there are more series than colors, the color list wraps and starts again
with the first color in the list. If this is not set (default), colors
from the \l{GraphsTheme::borderColors} will be used.
*/
QList<QColor> QBarSeries::borderColors() const
{
Q_D(const QBarSeries);
return d->m_borderColors;
}
void QBarSeries::setBorderColors(const QList<QColor> &newBorderColors)
{
Q_D(QBarSeries);
for (const QColor &color : newBorderColors) {
if (!color.isValid()) {
qCWarning(lcProperties2D, "QBarSeries::setBorderColors. Tried to use invalid color value.");
break;
}
}
if (d->m_borderColors == newBorderColors) {
qCDebug(lcProperties2D) << "QBarSeries::setBorderColors. Set value of:" << newBorderColors << "is the same than it already was.";
return;
}
d->m_borderColors = newBorderColors;
emit borderColorsChanged();
emit update();
}
void QBarSeries::setBarsType(QBarSeries::BarsType type)
{
Q_D(QBarSeries);
if (d->m_barsType != type) {
d->m_barsType = type;
emit barsTypeChanged(type);
emit update();
} else {
qCDebug(lcProperties2D) << "QBarSeries::setBarsType. Set value of:" << type << "is the same than it already was.";
}
}
QBarSeries::BarsType QBarSeries::barsType() const
{
Q_D(const QBarSeries);
return d->m_barsType;
}
/*!
Sets the width of the bars of the series to \a width.
*/
void QBarSeries::setBarWidth(qreal width)
{
Q_D(QBarSeries);
if (d->barWidth() != width) {
d->setBarWidth(width);
emit barWidthChanged();
} else {
qCDebug(lcProperties2D, "QBarSeries::setBarWidth. Set value of: %f is the same than it already was.",
width);
}
}
/*!
Returns the width of the bars of the series.
\sa setBarWidth()
*/
qreal QBarSeries::barWidth() const
{
Q_D(const QBarSeries);
return d->barWidth();
}
/*!
Adds a set of bars specified by \a set to the bar series and takes ownership of it. If the set
is null or it already belongs to the series, it will not be appended.
Returns \c true if appending succeeded.
*/
bool QBarSeries::append(QBarSet *set)
{
Q_D(QBarSeries);
bool success = d->append(set);
if (success) {
QList<QBarSet *> sets;
sets.append(set);
set->setParent(this);
QObject::connect(set, &QBarSet::update, this, &QBarSeries::update);
emit barsetsAdded(sets);
emit barSetsChanged();
emit countChanged();
emit update();
}
return success;
}
/*!
Removes the bar set specified by \a set from the series and permanently deletes it if
the removal succeeds. Returns \c true if the set was removed.
*/
bool QBarSeries::remove(QBarSet *set)
{
Q_D(QBarSeries);
bool success = d->remove(set);
if (success) {
QList<QBarSet *> sets;
sets.append(set);
set->setParent(0);
QObject::disconnect(set, &QBarSet::update, this, &QBarSeries::update);
emit barsetsRemoved(sets);
emit barSetsChanged();
emit countChanged();
emit update();
delete set;
set = 0;
}
return success;
}
/*!
Takes a single \a set from the series. Does not delete the bar set object.
\note The series remains the barset's parent object. You must set the
parent object to take full ownership.
Returns \c true if the take operation succeeds.
*/
bool QBarSeries::take(QBarSet *set)
{
Q_D(QBarSeries);
bool success = d->remove(set);
if (success) {
QList<QBarSet *> sets;
sets.append(set);
QObject::disconnect(set, &QBarSet::update, this, &QBarSeries::update);
emit barsetsRemoved(sets);
emit barSetsChanged();
emit countChanged();
emit update();
}
return success;
}
/*!
Adds a list of bar sets specified by \a sets to a bar series and takes ownership of the sets.
Returns \c true if all sets were appended successfully. If any of the sets is null or was
previously appended to the series, nothing is appended and this function returns \c false.
If any of the sets appears in the list more than once, nothing is appended and this function
returns \c false.
*/
bool QBarSeries::append(const QList<QBarSet *> &sets)
{
Q_D(QBarSeries);
if (!d->append(sets))
return false;
for (auto *set : sets) {
set->setParent(this);
QObject::connect(set, &QBarSet::update, this, &QBarSeries::update);
}
emit barsetsAdded(sets);
emit barSetsChanged();
emit countChanged();
emit update();
return true;
}
/*!
Inserts a bar set specified by \a set to a series at the position specified by \a index
and takes ownership of the set. If the set is null or already belongs to the series, it will
not be appended. Returns \c true if inserting succeeds.
*/
bool QBarSeries::insert(qsizetype index, QBarSet *set)
{
Q_D(QBarSeries);
bool success = d->insert(index, set);
if (success) {
QList<QBarSet *> sets;
sets.append(set);
QObject::connect(set, &QBarSet::update, this, &QBarSeries::update);
emit barsetsAdded(sets);
emit barSetsChanged();
emit countChanged();
emit update();
}
return success;
}
/*!
Removes all bar sets from the series and permanently deletes them.
*/
void QBarSeries::clear()
{
Q_D(QBarSeries);
const QList<QBarSet *> sets = barSets();
bool success = d->remove(sets);
if (success) {
emit barsetsRemoved(sets);
emit barSetsChanged();
emit countChanged();
for (QBarSet *set : sets) {
QObject::disconnect(set, &QBarSet::update, this, &QBarSeries::update);
// Detaching here prevents a crash in componentComplete if the QBarModelMapper has
// already destroyed "set".
set->setParent(nullptr);
set->deleteLater();
}
emit update();
}
}
/*!
Replaces the BarSet which is present at \a index with \a set.
The original BarSet will be permanently deleted.
*/
void QBarSeries::replace(qsizetype index, QBarSet *set)
{
Q_D(QBarSeries);
if (d->m_barSets.size() <= index)
return;
if (!set)
return;
if (index < 0)
index = 0;
remove(d->m_barSets[index]);
d->insert(index, set);
QList<QBarSet *> sets;
sets.append(set);
QObject::connect(set, &QBarSet::update, this, &QBarSeries::update);
emit barsetsReplaced(sets);
}
/*!
Retrieves the BarSet specified at the location \a index.
Returns null if no BarSet was found.
*/
QBarSet *QBarSeries::at(qsizetype index)
{
Q_D(QBarSeries);
if (d->m_barSets.size() <= index)
return nullptr;
if (index < 0)
return nullptr;
return d->m_barSets[index];
}
/*!
Returns the index of the first BarSet found as defined by \a set. Returns -1 if no BarSet was found.
*/
qsizetype QBarSeries::find(QBarSet *set) const
{
Q_D(const QBarSeries);
for (qsizetype i = 0; i < d->m_barSets.size(); ++i) {
if (set == d->m_barSets[i])
return i;
}
return -1;
}
/*!
Removes multiple BarSets from the series starting from \a index to a number of \a count.
The BarSets will be permanently deleted.
*/
void QBarSeries::removeMultiple(qsizetype index, qsizetype count)
{
Q_D(QBarSeries);
if (index < 0 || count < 1 || index + count > d->m_barSets.size())
return;
for (qsizetype i = index; i < index + count; ++i)
remove(d->m_barSets[index]);
}
/*!
Removes the BarSet at the location \a index. The BarSet will be permanently deleted.
*/
bool QBarSeries::remove(qsizetype index)
{
Q_D(QBarSeries);
if (index >= d->m_barSets.size())
return false;
if (index < 0)
return false;
return remove(d->m_barSets[index]);
}
/*!
Replaces the BarSet specified by \a oldValue with the one in \a newValue. The BarSet
in \a oldValue will be permanently deleted if found inside the series. Returns \c true if
the replace is successful.
*/
bool QBarSeries::replace(QBarSet *oldValue, QBarSet *newValue)
{
Q_D(QBarSeries);
if (!oldValue || !newValue)
return false;
if (oldValue == newValue)
return false;
for (qsizetype i = 0; i < d->m_barSets.size(); ++i) {
if (d->m_barSets[i] == oldValue) {
remove(d->m_barSets[i]);
d->insert(i, newValue);
QList<QBarSet *> sets;
sets.append(newValue);
QObject::connect(newValue, &QBarSet::update, this, &QBarSeries::update);
emit barsetsReplaced(sets);
return true;
}
}
return false;
}
/*!
Replaces the entire BarSet list inside of this BarSeries with the BarSets specified by \a sets.
All of the original BarSets will be permanently deleted. Returns \c true if all BarSets are replaced.
*/
bool QBarSeries::replace(const QList<QBarSet *> &sets)
{
Q_D(QBarSeries);
for (const auto set : sets) {
if (!set)
return false;
}
for (const auto set : std::as_const(d->m_barSets)) {
remove(set);
}
for (const auto set : sets) {
QObject::connect(set, &QBarSet::update, this, &QBarSeries::update);
}
d->append(sets);
emit barsetsReplaced(sets);
return true;
}
/*!
Returns the number of bar sets in a bar series.
*/
qsizetype QBarSeries::count() const
{
Q_D(const QBarSeries);
return d->m_barSets.size();
}
/*!
Returns a list of bar sets in a bar series. Keeps the ownership of the bar sets.
*/
QList<QBarSet *> QBarSeries::barSets() const
{
Q_D(const QBarSeries);
return d->m_barSets;
}
/*!
Sets the visibility of labels in a bar series to \a visible.
*/
void QBarSeries::setLabelsVisible(bool visible)
{
Q_D(QBarSeries);
if (d->m_labelsVisible != visible) {
d->setLabelsVisible(visible);
emit labelsVisibleChanged(visible);
emit update();
} else {
qCDebug(lcProperties2D) << "QBarSeries::setLabelsVisible. Label visibility is already set to:" << visible;
}
}
/*!
Returns the visibility of labels.
*/
bool QBarSeries::labelsVisible() const
{
Q_D(const QBarSeries);
return d->m_labelsVisible;
}
void QBarSeries::setLabelsFormat(const QString &format)
{
Q_D(QBarSeries);
if (d->m_labelsFormat != format) {
d->m_labelsFormat = format;
d->setLabelsDirty(true);
emit labelsFormatChanged(format);
emit update();
} else {
qCDebug(lcProperties2D) << "QBarSeries::setLabelsFormat. Format is already set to value:"
<< format;
}
}
QString QBarSeries::labelsFormat() const
{
Q_D(const QBarSeries);
return d->m_labelsFormat;
}
void QBarSeries::setLabelsMargin(qreal margin)
{
Q_D(QBarSeries);
if (d->m_labelsMargin != margin) {
d->m_labelsMargin = margin;
d->setLabelsDirty(true);
emit labelsMarginChanged(margin);
emit update();
} else {
qCDebug(lcProperties2D, "QBarSeries::setLabelsMargin. Margin is already set to value: %f",
margin);
}
}
qreal QBarSeries::labelsMargin() const
{
Q_D(const QBarSeries);
return d->m_labelsMargin;
}
void QBarSeries::setLabelsAngle(qreal angle)
{
Q_D(QBarSeries);
if (d->m_labelsAngle != angle) {
d->m_labelsAngle = angle;
d->setLabelsDirty(true);
emit labelsAngleChanged(angle);
emit update();
} else {
qCDebug(lcProperties2D, "QBarSeries::setLabelsAngle. Label angle is already set to value: %f",
angle);
}
}
qreal QBarSeries::labelsAngle() const
{
Q_D(const QBarSeries);
return d->m_labelsAngle;
}
void QBarSeries::setLabelsPosition(QBarSeries::LabelsPosition position)
{
Q_D(QBarSeries);
if (d->m_labelsPosition != position) {
d->m_labelsPosition = position;
emit labelsPositionChanged(position);
emit update();
} else {
qCDebug(lcProperties2D) << "QBarSeries::setLabelsPosition. Position is already set to:"
<< position;
}
}
QBarSeries::LabelsPosition QBarSeries::labelsPosition() const
{
Q_D(const QBarSeries);
return d->m_labelsPosition;
}
void QBarSeries::setLabelsPrecision(int precision)
{
Q_D(QBarSeries);
if (d->m_labelsPrecision != precision) {
d->m_labelsPrecision = precision;
d->setLabelsDirty(true);
emit labelsPrecisionChanged(precision);
emit update();
} else {
qCDebug(lcProperties2D, "QBarSeries::setLabelsPrecision. Precision is already set to: %d",
precision);
}
}
int QBarSeries::labelsPrecision() const
{
Q_D(const QBarSeries);
return d->m_labelsPrecision;
}
QQmlComponent *QBarSeries::barDelegate() const
{
Q_D(const QBarSeries);
return d->m_barDelegate;
}
void QBarSeries::setBarDelegate(QQmlComponent *newBarDelegate)
{
Q_D(QBarSeries);
if (d->m_barDelegate == newBarDelegate) {
qCDebug(lcProperties2D) << "QBarSeries::setBarDelegate. BarDelegate is already set to:"
<< newBarDelegate;
return;
}
d->m_barDelegate = newBarDelegate;
d->m_barDelegateDirty = true;
emit barDelegateChanged();
emit update();
}
// Select all the elements in the series
void QBarSeries::selectAll()
{
Q_D(QBarSeries);
for (auto s : std::as_const(d->m_barSets)) {
s->selectAllBars();
}
}
// Deselect all the elements in the series
void QBarSeries::deselectAll()
{
Q_D(QBarSeries);
for (auto s : std::as_const(d->m_barSets)) {
s->deselectAllBars();
}
}
void QBarSeries::componentComplete()
{
const auto kids = children();
for (auto *child : kids) {
if (auto bs = qobject_cast<QBarSet *>(child)) {
append(bs);
qCDebug(lcSeries2D) << "append barset" << bs << "to barseries. barset values:" << bs->values();
}
}
qCDebug(lcEvents2D) << "QBarSeries::componentComplete.";
QAbstractSeries::componentComplete();
}
void QBarSeries::handleSetValueChange(qsizetype index)
{
QBarSet *set = qobject_cast<QBarSet *>(sender());
if (set)
emit setValueChanged(index, set);
emit update();
}
void QBarSeries::handleSetValueAdd(qsizetype index, qsizetype count)
{
QBarSet *set = qobject_cast<QBarSet *>(sender());
if (set)
emit setValueAdded(index, count, set);
emit update();
}
void QBarSeries::handleSetValueRemove(qsizetype index, qsizetype count)
{
QBarSet *set = qobject_cast<QBarSet *>(sender());
if (set)
emit setValueRemoved(index, count, set);
emit update();
}
bool QBarSeries::barDelegateDirty() const
{
Q_D(const QBarSeries);
return d->m_barDelegateDirty;
}
void QBarSeries::setBarDelegateDirty(bool dirty)
{
Q_D(QBarSeries);
d->m_barDelegateDirty = dirty;
}
QBarSeriesPrivate::QBarSeriesPrivate()
: QAbstractSeriesPrivate(QAbstractSeries::SeriesType::Bar)
, m_barWidth(0.5) // Default value is 50% of category width
, m_labelsVisible(false)
, m_visible(true)
, m_blockBarUpdate(false)
, m_labelsFormat()
, m_labelsMargin(0)
, m_labelsAngle(0)
, m_labelsPrecision(6)
, m_labelsDirty(true)
, m_barDelegateDirty(false)
{
}
qsizetype QBarSeriesPrivate::categoryCount() const
{
// No categories defined. return count of longest set.
qsizetype count = 0;
for (qsizetype i = 0; i < m_barSets.size(); i++) {
if (m_barSets.at(i)->count() > count)
count = m_barSets.at(i)->count();
}
return count;
}
void QBarSeriesPrivate::setBarWidth(qreal width)
{
Q_Q(QBarSeries);
width = std::clamp<qreal>(width, 0.0, 1.0);
if (!qFuzzyCompare(width + 1, m_barWidth + 1)) {
m_barWidth = width;
emit q->update();
}
}
qreal QBarSeriesPrivate::barWidth() const
{
return m_barWidth;
}
QBarSet *QBarSeriesPrivate::barsetAt(qsizetype index)
{
return m_barSets.at(index);
}
void QBarSeriesPrivate::setVisible(bool visible)
{
Q_Q(QBarSeries);
m_visible = visible;
emit q->visibleChanged();
}
void QBarSeriesPrivate::setLabelsVisible(bool visible)
{
m_labelsVisible = visible;
}
qreal QBarSeriesPrivate::min()
{
if (m_barSets.size() <= 0)
return 0;
qreal min = INT_MAX;
for (int i = 0; i < m_barSets.size(); i++) {
qsizetype categoryCount = m_barSets.at(i)->count();
for (qsizetype j = 0; j < categoryCount; j++) {
qreal temp = m_barSets.at(i)->at(j);
if (temp < min)
min = temp;
}
}
return min;
}
qreal QBarSeriesPrivate::max()
{
if (m_barSets.size() <= 0)
return 0;
qreal max = INT_MIN;
for (int i = 0; i < m_barSets.size(); i++) {
qsizetype categoryCount = m_barSets.at(i)->count();
for (qsizetype j = 0; j < categoryCount; j++) {
qreal temp = m_barSets.at(i)->at(j);
if (temp > max)
max = temp;
}
}
return max;
}
qreal QBarSeriesPrivate::valueAt(int set, int category)
{
if ((set < 0) || (set >= m_barSets.size()))
return 0; // No set, no value.
else if ((category < 0) || (category >= m_barSets.at(set)->count()))
return 0; // No category, no value.
return m_barSets.at(set)->at(category);
}
qreal QBarSeriesPrivate::percentageAt(int set, int category)
{
if ((set < 0) || (set >= m_barSets.size()))
return 0; // No set, no value.
else if ((category < 0) || (category >= m_barSets.at(set)->count()))
return 0; // No category, no value.
qreal value = m_barSets.at(set)->at(category);
qreal sum = categorySum(category);
if (qFuzzyIsNull(sum))
return 0;
return value / sum;
}
qreal QBarSeriesPrivate::categorySum(qsizetype category)
{
qreal sum(0);
qsizetype count = m_barSets.size(); // Count sets
for (qsizetype set = 0; set < count; set++) {
if (category < m_barSets.at(set)->count())
sum += m_barSets.at(set)->at(category);
}
return sum;
}
qreal QBarSeriesPrivate::absoluteCategorySum(int category)
{
qreal sum(0);
qsizetype count = m_barSets.size(); // Count sets
for (qsizetype set = 0; set < count; set++) {
if (category < m_barSets.at(set)->count())
sum += qAbs(m_barSets.at(set)->at(category));
}
return sum;
}
qreal QBarSeriesPrivate::maxCategorySum()
{
qreal max = INT_MIN;
qsizetype count = categoryCount();
for (qsizetype i = 0; i < count; i++) {
qreal sum = categorySum(i);
if (sum > max)
max = sum;
}
return max;
}
qreal QBarSeriesPrivate::minX()
{
if (m_barSets.size() <= 0)
return 0;
qreal min = INT_MAX;
for (int i = 0; i < m_barSets.size(); i++) {
qsizetype categoryCount = m_barSets.at(i)->count();
for (qsizetype j = 0; j < categoryCount; j++) {
qreal temp = m_barSets.at(i)->d_func()->m_values.at(j).x();
if (temp < min)
min = temp;
}
}
return min;
}
qreal QBarSeriesPrivate::maxX()
{
if (m_barSets.size() <= 0)
return 0;
qreal max = INT_MIN;
for (int i = 0; i < m_barSets.size(); i++) {
qsizetype categoryCount = m_barSets.at(i)->count();
for (qsizetype j = 0; j < categoryCount; j++) {
qreal temp = m_barSets.at(i)->d_func()->m_values.at(j).x();
if (temp > max)
max = temp;
}
}
return max;
}
qreal QBarSeriesPrivate::categoryTop(qsizetype category)
{
// Returns top (sum of all positive values) of category.
// Returns 0, if all values are negative
qreal top(0);
qsizetype count = m_barSets.size();
for (qsizetype set = 0; set < count; set++) {
if (category < m_barSets.at(set)->count()) {
qreal temp = m_barSets.at(set)->at(category);
if (temp > 0) {
top += temp;
}
}
}
return top;
}
qreal QBarSeriesPrivate::categoryBottom(qsizetype category)
{
// Returns bottom (sum of all negative values) of category
// Returns 0, if all values are positive
qreal bottom(0);
qsizetype count = m_barSets.size();
for (qsizetype set = 0; set < count; set++) {
if (category < m_barSets.at(set)->count()) {
qreal temp = m_barSets.at(set)->at(category);
if (temp < 0) {
bottom += temp;
}
}
}
return bottom;
}
qreal QBarSeriesPrivate::top()
{
// Returns top of all categories
qreal top(0);
qsizetype count = categoryCount();
for (qsizetype i = 0; i < count; i++) {
qreal temp = categoryTop(i);
if (temp > top)
top = temp;
}
return top;
}
qreal QBarSeriesPrivate::bottom()
{
// Returns bottom of all categories
qreal bottom(0);
qsizetype count = categoryCount();
for (qsizetype i = 0; i < count; i++) {
qreal temp = categoryBottom(i);
if (temp < bottom)
bottom = temp;
}
return bottom;
}
bool QBarSeriesPrivate::blockBarUpdate()
{
return m_blockBarUpdate;
}
bool QBarSeriesPrivate::append(QBarSet *set)
{
if ((m_barSets.contains(set)) || (set == 0))
return false; // Fail if set is already in list or set is null.
m_barSets.append(set);
Q_Q(QBarSeries);
QObject::connect(set, &QBarSet::updatedBars, q, &QBarSeries::updatedBars);
QObject::connect(set, &QBarSet::valueChanged, q, &QBarSeries::handleSetValueChange);
QObject::connect(set, &QBarSet::valueAdded, q, &QBarSeries::handleSetValueAdd);
QObject::connect(set, &QBarSet::valueRemoved, q, &QBarSeries::handleSetValueRemove);
QObject::connect(set, &QBarSet::selectedBarsChanged, q, &QBarSeries::updatedBars);
return true;
}
bool QBarSeriesPrivate::remove(QBarSet *set)
{
if (!m_barSets.contains(set))
return false; // Fail if set is not in list
m_barSets.removeOne(set);
Q_Q(QBarSeries);
QObject::disconnect(set, &QBarSet::updatedBars, q, &QBarSeries::updatedBars);
QObject::disconnect(set, &QBarSet::valueChanged, q, &QBarSeries::handleSetValueChange);
QObject::disconnect(set, &QBarSet::valueAdded, q, &QBarSeries::handleSetValueAdd);
QObject::disconnect(set, &QBarSet::valueRemoved, q, &QBarSeries::handleSetValueRemove);
QObject::disconnect(set, &QBarSet::selectedBarsChanged, q, &QBarSeries::updatedBars);
return true;
}
bool QBarSeriesPrivate::append(const QList<QBarSet *> &sets)
{
for (auto *set : sets) {
if ((set == 0) || (m_barSets.contains(set)))
return false; // Fail if any of the sets is null or is already appended.
if (sets.count(set) != 1)
return false; // Also fail if same set is more than once in given list.
}
Q_Q(QBarSeries);
for (auto *set : sets) {
m_barSets.append(set);
QObject::connect(set, &QBarSet::updatedBars, q, &QBarSeries::updatedBars);
QObject::connect(set, &QBarSet::valueChanged, q, &QBarSeries::handleSetValueChange);
QObject::connect(set, &QBarSet::valueAdded, q, &QBarSeries::handleSetValueAdd);
QObject::connect(set, &QBarSet::valueRemoved, q, &QBarSeries::handleSetValueRemove);
QObject::connect(set, &QBarSet::selectedBarsChanged, q, &QBarSeries::updatedBars);
}
return true;
}
bool QBarSeriesPrivate::remove(const QList<QBarSet *> &sets)
{
if (sets.size() == 0)
return false;
for (QBarSet *set : sets) {
if ((set == 0) || (!m_barSets.contains(set)))
return false; // Fail if any of the sets is null or is not in series
if (sets.count(set) != 1)
return false; // Also fail if same set is more than once in given list.
}
Q_Q(QBarSeries);
for (QBarSet *set : sets) {
m_barSets.removeOne(set);
QObject::disconnect(set, &QBarSet::updatedBars, q, &QBarSeries::updatedBars);
QObject::disconnect(set,
&QBarSet::valueChanged,
q,
&QBarSeries::handleSetValueChange);
QObject::disconnect(set, &QBarSet::valueAdded, q, &QBarSeries::handleSetValueAdd);
QObject::disconnect(set,
&QBarSet::valueRemoved,
q,
&QBarSeries::handleSetValueRemove);
QObject::disconnect(set, &QBarSet::selectedBarsChanged, q, &QBarSeries::updatedBars);
}
return true;
}
bool QBarSeriesPrivate::insert(qsizetype index, QBarSet *set)
{
if ((m_barSets.contains(set)) || (set == 0))
return false; // Fail if set is already in list or set is null.
m_barSets.insert(index, set);
Q_Q(QBarSeries);
QObject::connect(set, &QBarSet::updatedBars, q, &QBarSeries::updatedBars);
QObject::connect(set, &QBarSet::valueChanged, q, &QBarSeries::handleSetValueChange);
QObject::connect(set, &QBarSet::valueAdded, q, &QBarSeries::handleSetValueAdd);
QObject::connect(set, &QBarSet::valueRemoved, q, &QBarSeries::handleSetValueRemove);
QObject::disconnect(set, &QBarSet::selectedBarsChanged, q, &QBarSeries::updatedBars);
return true;
}
QT_END_NAMESPACE
#include "moc_qbarseries.cpp"