Класс 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.2/qabstractseries.html