Класс QAbstractSeries
Класс QAbstractSeries является базовым классом для всех серий Qt Chart. Подробнее...
| Заголовок: | #include <QAbstractSeries> |
| Инициализируется: | AbstractSeries |
| Наследует: | QObject |
| Наследуется: | QAbstractBarSeries, QAreaSeries, QBoxPlotSeries, QCandlestickSeries, QPieSeries и QXYSeries |
Типы публичного доступа
| Перечисление | SeriesType { SeriesTypeLine, SeriesTypeArea, SeriesTypeBar, SeriesTypeStackedBar, SeriesTypePercentBar, …, SeriesTypeCandlestick } |
Свойства
Открытые функции
| виртуальный | ~QAbstractSeries() |
| bool | attachAxis(QAbstractAxis *axis) |
| QList<QAbstractAxis *> | attachedAxes() |
| QChart * | chart() const |
| bool | detachAxis(QAbstractAxis *axis) |
| void | hide() |
| bool | isVisible() const |
| QString | name() const |
| qreal | opacity() const |
| void | setName(const QString &name) |
| void | setOpacity(qreal opacity) |
| void | setUseOpenGL(bool enable = true) |
| void | setVisible(bool visible = true) |
| void | show() |
| виртуальный QAbstractSeries::SeriesType | type() const = 0 |
| bool | useOpenGL() const |
Сигналы
| void | nameChanged() |
| void | opacityChanged() |
| void | useOpenGLChanged() |
| void | visibleChanged() |
Подробное описание
Обычно вместо базового класса используются специфичные для типа серии производные классы.
См. такжеQXYSeries, QLineSeries, QSplineSeries, QScatterSeries, QAreaSeries, QAbstractBarSeries, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries, QHorizontalPercentBarSeries и QPieSeries.
Документация по типу члена
перечисление QAbstractSeries::SeriesType
Это перечисление описывает тип серии.
| Константа | Значение | Описание |
|---|---|---|
QAbstractSeries::SeriesTypeLine |
0 |
График линии. |
QAbstractSeries::SeriesTypeArea |
1 |
График области. |
QAbstractSeries::SeriesTypeBar |
2 |
Вертикальная гистограмма. |
QAbstractSeries::SeriesTypeStackedBar |
3 |
Вертикальная стопка гистограмм. |
QAbstractSeries::SeriesTypePercentBar |
4 |
Вертикальная гистограмма в процентах. |
QAbstractSeries::SeriesTypePie |
5 |
Круговая диаграмма. |
QAbstractSeries::SeriesTypeScatter |
6 |
График точек. |
QAbstractSeries::SeriesTypeSpline |
7 |
График сплайнов. |
QAbstractSeries::SeriesTypeHorizontalBar |
8 |
Горизонтальная гистограмма. |
QAbstractSeries::SeriesTypeHorizontalStackedBar |
9 |
Горизонтальная стопка гистограмм. |
QAbstractSeries::SeriesTypeHorizontalPercentBar |
10 |
Горизонтальная гистограмма в процентах. |
QAbstractSeries::SeriesTypeBoxPlot |
11 |
График размаха. |
QAbstractSeries::SeriesTypeCandlestick |
12 |
График свечей. |
Документация свойств
name : QString
Это свойство содержит имя ряда.
Имя отображается в легенде ряда и поддерживает форматирование HTML.
Функции доступа:
| QString | name() const |
| void | setName(const QString &name) |
Сигнал уведомления:
| void | nameChanged() |
opacity : qreal
Это свойство содержит непрозрачность ряда.
По умолчанию непрозрачность равна 1.0. Допустимые значения находятся в диапазоне от 0.0 (прозрачный) до 1.0 (непрозрачный).
Функции доступа:
| qreal | opacity() const |
| void | setOpacity(qreal opacity) |
Сигнал уведомления:
| void | opacityChanged() |
[read-only] type : const SeriesType
Это свойство содержит тип ряда.
Функции доступа:
| virtual QAbstractSeries::SeriesType | type() const = 0 |
useOpenGL : bool
Указывает, ускоряется ли отрисовка ряда с помощью OpenGL.
Ускорение с помощью OpenGL поддерживается только для QLineSeries и QScatterSeries. Линейный ряд, используемый как ряд границ для QAreaSeries, не может использовать ускорение OpenGL. Когда диаграмма содержит ряды, которые отрисовываются с помощью OpenGL, создается прозрачный QOpenGLWidget поверх области графика диаграммы. Ускоренные ряды не отрисовываются на базовом QGraphicsView, а вместо этого отрисовываются на созданном QOpenGLWidget.
Прирост производительности при использовании OpenGL для ускорения отрисовки рядов зависит от базового оборудования, но в большинстве случаев он значительный. Например, на стандартном настольном компьютере включение ускорения OpenGL для ряда обычно позволяет отображать по крайней мере в сто раз больше точек без снижения частоты кадров. Размер диаграммы также оказывает меньшее влияние на частоту кадров.
Ускорение отрисовки рядов с помощью OpenGL предназначено для случаев, когда требуется быстрая отрисовка большого количества точек. Оно оптимизировано для эффективности, и поэтому ряды, использующие его, не поддерживают многие функции, доступные для рядов, не использующих ускорение:
- Анимации рядов не поддерживаются для ускоренных рядов.
- Метки точек не поддерживаются для ускоренных рядов.
- Стиль пера и форма маркера игнорируются для ускоренных рядов. Поддерживаются только сплошные линии и простые точки разброса. Точки разброса могут быть круговыми или прямоугольными, в зависимости от базового графического оборудования и драйверов.
- Полярные диаграммы не поддерживают ускоренные ряды.
- Включение тени от диаграммы или использование прозрачного фона диаграммы не рекомендуется при использовании ускоренных рядов, так как это может значительно снизить частоту кадров.
Эти дополнительные ограничения обусловлены тем, что ускоренный ряд отрисовывается на отдельном виджете поверх диаграммы:
- Если вы рисуете графические элементы поверх диаграммы, содержащей ускоренный ряд, ускоренный ряд нарисован поверх этих элементов.
- Чтобы сделать QOpenGLWidget частично прозрачным, его необходимо разместить поверх всех остальных виджетов. Это означает, что у вас не может быть других виджетов, частично накрывающих диаграмму при использовании ускоренных рядов.
- Ускоренные ряды не поддерживаются для случаев, когда графическая сцена имеет более одного подключенного к ней графического представления.
- Ускоренные ряды не поддерживаются для случаев, когда у диаграммы есть геометрия, отличная от стандартной. Например, добавление преобразований к графическому представлению приводит к тому, что ускоренный ряд отображается в неправильном положении относительно диаграммы.
Значение по умолчанию равно false.
Функции доступа:
| bool | useOpenGL() const |
| void | setUseOpenGL(bool enable = true) |
Сигнал уведомления:
| void | useOpenGLChanged() |
visible : bool
Это свойство указывает, отображается ли ряд или нет.
По умолчанию true.
Функции доступа:
| bool | isVisible() const |
| void | setVisible(bool visible = true) |
Сигнал уведомления:
| void | visibleChanged() |
Документация по функциям-членам
[signal] void QAbstractSeries::nameChanged()
Этот сигнал излучается при изменении имени ряда.
Примечание: Сигнал уведомления для свойства name.
[signal] void QAbstractSeries::opacityChanged()
Этот сигнал излучается при изменении непрозрачности ряда.
Примечание: Сигнал уведомления для свойства opacity.
[signal] void QAbstractSeries::useOpenGLChanged()
Этот сигнал излучается при включении или отключении ускорения отрисовки ряда с помощью OpenGL.
Примечание: Сигнал уведомления для свойства useOpenGL.
[signal] void QAbstractSeries::visibleChanged()
Этот сигнал излучается при изменении видимости ряда.
Примечание: Сигнал уведомления для свойства visible.
[virtual] QAbstractSeries::~QAbstractSeries()
Виртуальный деструктор для ряда диаграммы.
bool QAbstractSeries::attachAxis(QAbstractAxis *axis)
Присоединяет ось, указанную параметром axis, к ряду.
Возвращает true , если ось была успешно присоединена, false в противном случае.
Примечание: Если к одному ряду прикреплено несколько осей с одинаковой ориентацией, они будут иметь одинаковые минимальные и максимальные значения.
См. также QChart::addAxis() и QChart::createDefaultAxes().
QList<QAbstractAxis *> QAbstractSeries::attachedAxes()
Возвращает список осей, прикрепленных к ряду. Обычно к ряду прикрепляются ось X и ось Y, за исключением QPieSeries, у которого нет прикрепленных осей.
См. также attachAxis() и detachAxis().
QChart *QAbstractSeries::chart() const
Возвращает диаграмму, к которой принадлежит ряд.
Устанавливается автоматически, когда ряд добавляется в диаграмму, и сбрасывается, когда ряд удаляется из диаграммы.
bool QAbstractSeries::detachAxis(QAbstractAxis *axis)
Отсоединяет ось, указанную параметром axis, от ряда.
Возвращает true , если ось была успешно отсоединена, false в противном случае.
См. также QChart::removeAxis().
void QAbstractSeries::hide()
Устанавливает видимость ряда в false.
См. также setVisible() и isVisible().
void QAbstractSeries::show()
Устанавливает видимость ряда в true.
См. также setVisible() и isVisible().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qabstractseries.html