Spec-Zone.ru › Qt 6.1

Класс QAbstractSeries

Класс QAbstractSeries является базовым классом для всех серий Qt Chart. Подробнее...

Заголовок: #include <QAbstractSeries>
Инициализируется: AbstractSeries
Наследует: QObject
Наследуется:

QAbstractBarSeries, QAreaSeries, QBoxPlotSeries, QCandlestickSeries, QPieSeries и QXYSeries

  • Список всех членов, включая унаследованные

Типы публичного доступа

Перечисление SeriesType { SeriesTypeLine, SeriesTypeArea, SeriesTypeBar, SeriesTypeStackedBar, SeriesTypePercentBar, …, SeriesTypeCandlestick }

Свойства

  • name : QString
  • opacity : qreal
  • type : const SeriesType
  • useOpenGL : bool
  • visible : bool

Открытые функции

виртуальный ~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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API