Spec-Zone.ru › Qt

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

Spec-Zone.ru

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