Класс QAbstractBarSeries
Класс QAbstractBarSeries — это абстрактный базовый класс для всех классов серий столбцов. Подробнее...
| Заголовок: | #include <QAbstractBarSeries> |
| Создается из: | AbstractBarSeries |
| Наследуется от: | QAbstractSeries |
| Наследуется для: | QBarSeries, QHorizontalBarSeries, QHorizontalPercentBarSeries, QHorizontalStackedBarSeries, QPercentBarSeries и QStackedBarSeries |
Общественные типы
| перечисление | LabelsPosition { LabelsCenter, LabelsInsideEnd, LabelsInsideBase, LabelsOutsideEnd } |
Свойства
|
|
Общественные функции
| виртуальный | ~QAbstractBarSeries() |
| bool | append(QBarSet *set) |
| bool | append(const 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 |
| int | labelsPrecision() const |
| bool | remove(QBarSet *set) |
| void | setBarWidth(qreal width) |
| void | setLabelsAngle(qreal angle) |
| void | setLabelsFormat(const QString &format) |
| void | setLabelsPosition(QAbstractBarSeries::LabelsPosition position) |
| void | setLabelsPrecision(int precision) |
| void | setLabelsVisible(bool visible = true) |
| bool | take(QBarSet *set) |
Сигналы
| void | barsetsAdded(const QList<QBarSet *> &sets) |
| void | barsetsRemoved(const 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 | labelsPrecisionChanged(int precision) |
| void | labelsVisibleChanged() |
| void | pressed(int index, QBarSet *barset) |
| void | released(int index, QBarSet *barset) |
Подробное описание
В столбчатых диаграммах столбцы определяются как наборы столбцов, содержащие одно значение данных для каждой категории. Положение столбца определяется категорией, а его высота — значением данных. Серии столбцов, содержащие несколько наборов столбцов, группируют вместе столбцы, относящиеся к одной и той же категории. Способ отображения столбцов определяется подклассом этого класса, выбранным для создания столбчатой диаграммы.
Если вместо QBarCategoryAxis используется QValueAxis для основной оси столбцов, столбцы группируются вокруг индексного значения категории.
См. пример столбчатой диаграммы, чтобы узнать, как использовать класс QBarSeries для создания простой столбчатой диаграммы.
См. также QBarSet, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries и QHorizontalPercentBarSeries.
Документация по типам членов
перечисление QAbstractBarSeries::LabelsPosition
Это значение перечисления описывает положение меток значений данных:
| Константа | Значение | Описание |
|---|---|---|
QAbstractBarSeries::LabelsCenter |
0 |
Метка расположена в центре полосы. |
QAbstractBarSeries::LabelsInsideEnd |
1 |
Метка расположена внутри полосы вверху. |
QAbstractBarSeries::LabelsInsideBase |
2 |
Метка расположена внутри полосы внизу. |
QAbstractBarSeries::LabelsOutsideEnd |
3 |
Метка расположена за пределами полосы вверху. |
Документация свойств
barWidth : qreal
Это свойство содержит ширину столбцов ряда.
Единица ширины — единица оси X. Минимальная ширина столбцов — ноль, отрицательные значения обрабатываются как ноль. Установка ширины в ноль означает, что ширина столбца на экране составляет один пиксель независимо от масштаба оси X. Столбцы шириной более нуля масштабируются с использованием масштаба оси X.
Примечание: При использовании с QBarSeries это значение задаёт ширину группы столбцов, а не отдельного столбца.
Функции доступа:
| qreal | barWidth() const |
| void | setBarWidth(qreal width) |
См. также QBarSeries.
count : const int
Это свойство содержит количество наборов столбцов в ряду столбцов.
Функции доступа:
| int | count() const |
Сигнал уведомления:
| void | countChanged() |
labelsAngle : qreal
Это свойство содержит угол меток значений в градусах.
Функции доступа:
| qreal | labelsAngle() const |
| void | setLabelsAngle(qreal angle) |
Сигнал уведомления:
| void | labelsAngleChanged(qreal angle) |
labelsFormat : QString
Это свойство содержит формат, используемый для отображения меток в ряду столбцов.
QAbstractBarSeries поддерживает следующий тег формата:
| @value | Значение столбца |
Например, следующее использование тегов формата создаст метки, отображающие значение, за которым следует единица (u):
series->setLabelsFormat("@value u"); По умолчанию метки отображают значение столбца. Для ряда столбцов в процентах после значения добавляется %. Метки отображаются на области графика; если столбцы расположены близко друг к другу, метки могут перекрываться.
Функции доступа:
| QString | labelsFormat() const |
| void | setLabelsFormat(const QString &format) |
Сигнал уведомления:
| void | labelsFormatChanged(const QString &format) |
См. также labelsVisible, labelsPosition и labelsPrecision.
labelsPosition : LabelsPosition
Это свойство содержит положение меток значений.
Функции доступа:
| QAbstractBarSeries::LabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QAbstractBarSeries::LabelsPosition position) |
Сигнал уведомления:
| void | labelsPositionChanged(QAbstractBarSeries::LabelsPosition position) |
См. также labelsVisible и labelsFormat.
labelsPrecision : int
Это свойство содержит максимальное количество значащих цифр, отображаемых в метках значений.
Значение по умолчанию — 6.
Функции доступа:
| int | labelsPrecision() const |
| void | setLabelsPrecision(int precision) |
Сигнал уведомления:
| void | labelsPrecisionChanged(int precision) |
labelsVisible : bool
Это свойство содержит видимость меток в ряду столбцов.
Функции доступа:
| bool | isLabelsVisible() const |
| void | setLabelsVisible(bool visible = true) |
Сигнал уведомления:
| void | labelsVisibleChanged() |
Документация по функциям-членам
void QAbstractBarSeries::barsetsAdded(const QList<QBarSet *> &sets)
Этот сигнал подаётся, когда наборы столбцов, указанные в sets, добавляются в ряд.
См. также append() и insert().
void QAbstractBarSeries::barsetsRemoved(const QList<QBarSet *> &sets)
Этот сигнал подаётся, когда наборы столбцов, указанные в sets, удаляются из ряда.
См. также remove().
void QAbstractBarSeries::clicked(int index, QBarSet *barset)
Этот сигнал подаётся, когда пользователь щелкает столбец, указанный в index, в наборе столбцов, указанном в barset.
void QAbstractBarSeries::countChanged()
Этот сигнал подаётся, когда количество наборов столбцов изменяется, например, с помощью append() или remove().
Примечание: Сигнал уведомления для свойства count.
void QAbstractBarSeries::doubleClicked(int index, QBarSet *barset)
Этот сигнал подаётся, когда пользователь дважды щелкает столбец, указанный в index, в наборе столбцов, указанном в barset.
void QAbstractBarSeries::hovered(bool status, int index, QBarSet *barset)
Этот сигнал подаётся, когда указатель мыши наведён на столбец, указанный в index, в наборе столбцов, указанном в barset. Когда указатель мыши наведён на столбец, status принимает значение true, а когда указатель мыши снова уведён, — false.
[signal] void QAbstractBarSeries::labelsAngleChanged(qreal angle)
Этот сигнал излучается, когда изменяется угол angle меток значений.
Примечание: Сигнал-уведомление для свойства labelsAngle.
[signal] void QAbstractBarSeries::labelsFormatChanged(const QString &format)
Этот сигнал излучается, когда изменяется формат меток значений данных.
Примечание: Сигнал-уведомление для свойства labelsFormat.
[signal] void QAbstractBarSeries::labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)
Этот сигнал излучается, когда изменяется положение меток значений.
Примечание: Сигнал-уведомление для свойства labelsPosition.
[signal] void QAbstractBarSeries::labelsPrecisionChanged(int precision)
Этот сигнал излучается, когда изменяется точность меток значений.
Примечание: Сигнал-уведомление для свойства labelsPrecision.
[signal] void QAbstractBarSeries::labelsVisibleChanged()
Этот сигнал излучается, когда изменяется видимость меток.
Примечание: Сигнал-уведомление для свойства labelsVisible.
См. также isLabelsVisible() и setLabelsVisible().
[signal] void QAbstractBarSeries::pressed(int index, QBarSet *barset)
Этот сигнал излучается, когда пользователь нажимает на столбец, указанный index в наборе столбцов, указанном barset, и удерживает нажатой кнопку мыши.
[signal] void QAbstractBarSeries::released(int index, QBarSet *barset)
Этот сигнал излучается, когда пользователь отпускает нажатие мыши на столбец, указанный index в наборе столбцов, указанном barset.
[virtual] QAbstractBarSeries::~QAbstractBarSeries()
Удаляет абстрактный график столбцов и наборы столбцов, которыми он владеет.
bool QAbstractBarSeries::append(QBarSet *set)
Добавляет набор столбцов, указанный set, к графику столбцов и берет на себя владение им. Если набор равен null или он уже принадлежит графику, он не будет добавлен. Возвращает true если добавление прошло успешно.
bool QAbstractBarSeries::append(const QList<QBarSet *> &sets)
Добавляет список наборов столбцов, указанный sets, к графику столбцов и берет на себя владение наборами. Возвращает true если все наборы были успешно добавлены. Если какой-либо из наборов равен null или был ранее добавлен в график, ничего не добавляется, и эта функция возвращает false. Если какой-либо из наборов появляется в списке более одного раза, ничего не добавляется, и эта функция возвращает false.
QList<QBarSet *> QAbstractBarSeries::barSets() const
Возвращает список наборов столбцов в графике столбцов. Сохраняет владение наборами столбцов.
qreal QAbstractBarSeries::barWidth() const
Возвращает ширину столбцов серии.
Примечание: Функция-получатель для свойства barWidth.
См. также setBarWidth().
void QAbstractBarSeries::clear()
Удаляет все наборы столбцов из серии и постоянно удаляет их.
int QAbstractBarSeries::count() const
Возвращает количество наборов столбцов в графике столбцов.
Примечание: Функция-получатель для свойства count.
bool QAbstractBarSeries::insert(int index, QBarSet *set)
Вставляет набор столбцов, указанный set, в серию в позиции, указанной index, и берет на себя владение набором. Если набор равен null или уже принадлежит серии, он не будет добавлен. Возвращает true если вставка прошла успешно.
bool QAbstractBarSeries::isLabelsVisible() const
Возвращает видимость меток.
Примечание: Функция-получатель для свойства labelsVisible.
bool QAbstractBarSeries::remove(QBarSet *set)
Удаляет набор столбцов, указанный set, из серии и постоянно удаляет его, если удаление прошло успешно. Возвращает true если набор был удален.
void QAbstractBarSeries::setBarWidth(qreal width)
Устанавливает ширину столбцов серии в width.
Примечание: Функция-установщик для свойства barWidth.
См. также barWidth().
void QAbstractBarSeries::setLabelsVisible(bool visible = true)
Устанавливает видимость меток на графике столбцов в visible.
Примечание: Функция-установщик для свойства labelsVisible.
См. также isLabelsVisible().
bool QAbstractBarSeries::take(QBarSet *set)
Извлекает один set из серии. Не удаляет объект набора столбцов.
Примечание: Серия остается родительским объектом набора столбцов. Необходимо установить родительский объект для полного владения.
Возвращает true если операция извлечения прошла успешно.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qabstractbarseries.html
