Spec-Zone.ru › Qt 5.9

Класс QAbstractSeries

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

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

QAbstractBarSeries, QAreaSeries, QBoxPlotSeries, QCandlestickSeries, QPieSeries и QXYSeries

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

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

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

Свойства

  • name : QString
  • opacity : qreal
  • type : const SeriesType
  • useOpenGL : bool
  • visible : bool
  • 1 свойство унаследовано от QObject

Публичные функции

~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()
virtual SeriesType type() const = 0
bool useOpenGL() const
  • 32 публичных функции унаследованы от QObject

Сигналы

void nameChanged()
void opacityChanged()
void useOpenGLChanged()
void visibleChanged()
  • 2 сигнала унаследованы от QObject

Дополнительные унаследованные члены

  • 1 публичный слот унаследован от QObject
  • 11 статические публичные члены унаследованы от QObject
  • 9 защищенные функции унаследованы от QObject

Подробное описание

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

Обычно используются специфичные для типа серии унаследованные классы вместо базового класса.

См. также 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()

type : const SeriesType

Это свойство содержит тип ряда.

Функции доступа:

virtual 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()

Документация по членам-функциям

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().

[signal] void QAbstractSeries::nameChanged()

Этот сигнал излучается при изменении имени ряда.

Примечание: Сигнал уведомления для свойства name.

[signal] void QAbstractSeries::opacityChanged()

Этот сигнал излучается при изменении непрозрачности ряда.

Примечание: Сигнал уведомления для свойства opacity.

void QAbstractSeries::show()

Устанавливает видимость ряда в true.

См. также setVisible() и isVisible().

[signal] void QAbstractSeries::useOpenGLChanged()

Этот сигнал излучается при включении или отключении ускорения отрисовки ряда с помощью OpenGL.

Примечание: Сигнал уведомления для свойства useOpenGL.

[signal] void QAbstractSeries::visibleChanged()

Этот сигнал излучается при изменении видимости ряда.

Примечание: Сигнал уведомления для свойства visible.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qabstractseries.html

Spec-Zone.ru

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