Класс QAbstractBarSeries
Класс QAbstractBarSeries является абстрактным базовым классом для всех классов серий столбцов. Подробнее...
| Заголовок: | #include <QAbstractBarSeries> |
| Создаётся с помощью: | AbstractBarSeries |
| Наследует: | QAbstractSeries |
| Наследуется: | QBarSeries, QHorizontalBarSeries, QHorizontalPercentBarSeries, QHorizontalStackedBarSeries, QPercentBarSeries, и QStackedBarSeries |
Типы публичного доступа
| Перечисление | LabelsPosition { LabelsCenter, LabelsInsideEnd, LabelsInsideBase, LabelsOutsideEnd } |
Свойства
|
|
Публичные функции
| virtual | ~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) |
Подробное описание
В столбчатых диаграммах столбцы определяются как наборы столбцов, содержащие одно значение данных для каждой категории. Положение столбца задаётся категорией, а его высота — значением данных. Серии столбцов, содержащие несколько наборов столбцов, объединяют столбцы, относящиеся к одной категории. Способ отображения столбцов определяется подклассом этого класса, выбранным для создания столбчатой диаграммы.
Если для основной оси столбцов используется QValueAxis вместо QBarCategoryAxis, столбцы группируются вокруг значения индекса категории.
См. пример столбчатой диаграммы, чтобы узнать, как использовать класс 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.
[read-only] 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() |
Документация по функциям-членам
[signal] void QAbstractBarSeries::barsetsAdded(const QList<QBarSet *> &sets)
Этот сигнал испускается, когда наборы полос, указанные параметром sets, добавляются в ряд.
См. также append() и insert().
[signal] void QAbstractBarSeries::barsetsRemoved(const QList<QBarSet *> &sets)
Этот сигнал испускается, когда наборы полос, указанные параметром sets, удаляются из ряда.
См. также remove().
[signal] void QAbstractBarSeries::clicked(int index, QBarSet *barset)
Этот сигнал испускается, когда пользователь щелкает полосу, указанную параметром index, в наборе полос, указанном параметром barset.
[signal] void QAbstractBarSeries::countChanged()
Этот сигнал испускается, когда меняется количество наборов полос, например, с помощью append() или remove().
Примечание: Сигнал оповещения для свойства count.
[signal] void QAbstractBarSeries::doubleClicked(int index, QBarSet *barset)
Этот сигнал испускается, когда пользователь дважды щелкает полосу, указанную параметром index, в наборе полос, указанном параметром barset.
[signal] 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.1/qabstractbarseries.html
