Класс QAbstractBarSeries
Класс QAbstractBarSeries — это абстрактный базовый класс для всех классов рядов столбцов. Подробнее...
| Заголовок: | #include <QAbstractBarSeries> |
| Создаётся: | AbstractBarSeries |
| Наследуется от: | QAbstractSeries |
| Наследуется: | QBarSeries, QHorizontalBarSeries, QHorizontalPercentBarSeries, QHorizontalStackedBarSeries, QPercentBarSeries и QStackedBarSeries |
Типы
| перечисление | LabelsPosition { LabelsCenter, LabelsInsideEnd, LabelsInsideBase, LabelsOutsideEnd } |
Свойства
|
|
- 5 свойств унаследовано от QAbstractSeries
- 1 свойство унаследовано от QObject
Открытые функции
| 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) |
- 15 открытых функций унаследовано от QAbstractSeries
- 32 открытых функции унаследовано от QObject
Сигналы
| 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) |
- 4 сигнала унаследовано от QAbstractSeries
- 2 сигнала унаследовано от QObject
Дополнительные унаследованные члены
- 1 открытый слот унаследован от QObject
- 11 статических открытых членов унаследовано от QObject
- 9 защищённых функций унаследовано от QObject
Подробное описание
Класс QAbstractBarSeries — это абстрактный базовый класс для всех классов рядов столбцов.
В столбчатых диаграммах столбцы определяются как наборы столбцов, содержащие одно значение данных для каждой категории. Положение столбца определяется категорией, а его высота — значением данных. Ряды столбцов, содержащие несколько наборов столбцов, группируют вместе столбцы, относящиеся к одной категории. Способ отображения столбцов определяется подклассом этого класса, выбранным для создания столбчатой диаграммы.
Если для основной оси столбцов используется 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.
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.
labelsPosition : LabelsPosition
Это свойство содержит положение меток значений.
Функции доступа:
| QAbstractBarSeries::LabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QAbstractBarSeries::LabelsPosition position) |
Сигнал уведомления:
| void | labelsPositionChanged(QAbstractBarSeries::LabelsPosition position) |
См. также labelsVisible и labelsFormat.
labelsVisible : bool
Это свойство содержит видимость меток в ряду полос.
Функции доступа:
| bool | isLabelsVisible() const |
| void | setLabelsVisible(bool visible = true) |
Сигнал уведомления:
| void | labelsVisibleChanged() |
Документация функций-членов
[virtual] QAbstractBarSeries::~QAbstractBarSeries()
Удаляет абстрактный ряд полос и наборы полос, которыми он владеет.
bool QAbstractBarSeries::append(QBarSet *set)
Добавляет набор полос, указанный параметром set, к ряду полос и принимает владение им. Если набор равен null или уже принадлежит ряду, он не будет добавлен. Возвращает true в случае успешного добавления.
bool QAbstractBarSeries::append(QList<QBarSet *> sets)
Добавляет список наборов полос, указанный параметром sets, к ряду полос и принимает владение наборами. Возвращает true если все наборы были успешно добавлены. Если любой из наборов равен null или был ранее добавлен в ряд, ничего не добавляется, и эта функция возвращает false. Если любой из наборов появляется в списке более одного раза, ничего не добавляется, и эта функция возвращает false.
QList<QBarSet *> QAbstractBarSeries::barSets() const
Возвращает список наборов полос в ряду полос. Сохраняет владение наборами полос.
qreal QAbstractBarSeries::barWidth() const
Возвращает ширину полос ряда.
Примечание: Функция-получатель для свойства barWidth.
См. также setBarWidth().
[signal] void QAbstractBarSeries::barsetsAdded(QList<QBarSet *> sets)
Этот сигнал испускается, когда наборы полос, заданные параметром sets, добавляются в ряд.
См. также append() и insert().
[signal] void QAbstractBarSeries::barsetsRemoved(QList<QBarSet *> sets)
Этот сигнал испускается, когда наборы полос, заданные параметром sets, удаляются из ряда.
См. также remove().
void QAbstractBarSeries::clear()
Удаляет все наборы полос из ряда и постоянно удаляет их.
[signal] void QAbstractBarSeries::clicked(int index, QBarSet *barset)
Этот сигнал испускается, когда пользователь щелкает по полосе, заданной параметром index, в наборе полос, заданном параметром barset.
int QAbstractBarSeries::count() const
Возвращает количество наборов полос в ряду полос.
Примечание: Функция-получатель для свойства count.
[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.
bool QAbstractBarSeries::insert(int index, QBarSet *set)
Вставляет набор столбцов, указанный set, в серию в позиции, указанной index, и принимает владение набором. Если набор равен null или уже принадлежит серии, он не будет добавлен. Возвращает true если вставка выполнена успешно.
bool QAbstractBarSeries::isLabelsVisible() const
Возвращает видимость меток.
Примечание: Функция-геттер для свойства labelsVisible.
[signal] void QAbstractBarSeries::labelsAngleChanged(qreal angle)
Этот сигнал испускается, когда угол меток значений изменяется.
Примечание: Сигнал уведомления для свойства labelsAngle.
[signal] void QAbstractBarSeries::labelsFormatChanged(const QString &format)
Этот сигнал испускается, когда изменяется формат меток значений данных.
Примечание: Сигнал уведомления для свойства labelsFormat.
[signal] void QAbstractBarSeries::labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)
Этот сигнал испускается, когда меняется положение меток значений.
Примечание: Сигнал уведомления для свойства labelsPosition.
[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.
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-5.9/qabstractbarseries.html