Класс QAreaSeries
Класс QAreaSeries отображает данные в диаграммах областей. Подробнее...
| Заголовок: | #include <QAreaSeries> |
| Инициализируется из: | AreaSeries |
| Наследуется от: | QAbstractSeries |
Свойства
|
|
Открытые функции
| QAreaSeries(QLineSeries *верхняяКривая, QLineSeries *нижняяКривая = nullptr) | |
| QAreaSeries(QObject *родитель = nullptr) | |
| virtual | ~QAreaSeries() |
| QColor | borderColor() const |
| QBrush | заливка() const |
| QColor | цвет() const |
| QLineSeries * | нижняяКривая() const |
| QPen | контур() const |
| bool | обрезкаПодписейТочек() const |
| QColor | цветПодписейТочек() const |
| QFont | шрифтПодписейТочек() const |
| QString | форматПодписейТочек() const |
| bool | видимостьПодписейТочек() const |
| bool | видимостьТочек() const |
| void | setBorderColor(const QColor &цвет) |
| void | setBrush(const QBrush &заливка) |
| void | setColor(const QColor &цвет) |
| void | setLowerSeries(QLineSeries *series) |
| void | setPen(const QPen &контур) |
| void | setPointLabelsClipping(bool enabled = true) |
| void | setPointLabelsColor(const QColor &цвет) |
| void | setPointLabelsFont(const QFont &шрифт) |
| void | setPointLabelsFormat(const QString &формат) |
| void | setPointLabelsVisible(bool visible = true) |
| void | setPointsVisible(bool visible = true) |
| void | setUpperSeries(QLineSeries *series) |
| QLineSeries * | верхняяКривая() const |
Переопределённые открытые функции
| virtual QAbstractSeries::SeriesType | тип() const override |
Сигналы
| void | изменениеЦветГраницы(QColor цвет) |
| void | нажатие(const QPointF &точка) |
| void | изменениеЦвет(QColor цвет) |
| void | двойноеНажатие(const QPointF &точка) |
| void | наведениеКурсора(const QPointF &точка, bool состояние) |
| void | изменениеОбрезкаПодписейТочек(bool обрезка) |
| void | изменениеЦветПодписейТочек(const QColor &цвет) |
| void | изменениеШрифтаПодписейТочек(const QFont &шрифт) |
| void | изменениеФорматПодписейТочек(const QString &формат) |
| void | изменениеВидимостьПодписейТочек(bool видимость) |
| void | нажатиеНажатия(const QPointF &точка) |
| void | отпущенный(const QPointF &точка) |
Подробное описание
Серия областей используется для отображения количественных данных. Она основана на линейной серии, при этом область между граничными линиями выделяется цветом. Поскольку серия областей основана на линейной серии, конструктор QAreaSeries требует экземпляр QLineSeries, который определяет верхнюю границу области. Диаграмма областей рисуется с использованием нижней части области графика в качестве нижней границы по умолчанию. Вместо нижней части области графика нижнюю границу можно указать другой линией. В этом случае QAreaSeries должен быть инициализирован с двумя экземплярами QLineSeries.
Примечание: Термины верхняя и нижняя граница могут быть вводящими в заблуждение в случаях, когда значение нижней границы больше, чем значение верхней границы. Главное, что область между этими двумя граничными линиями будет заполнена.
См. пример диаграммы областей, чтобы узнать, как создать простую диаграмму областей.
Документация свойств
borderColor : QColor
Это свойство хранит цвет линии (пера) ряда. Это удобное свойство для изменения цвета пера.
Функции доступа:
| QColor | borderColor() const |
| void | setBorderColor(const QColor &color) |
Сигнал уведомления:
| void | borderColorChanged(QColor color) |
См. также QAreaSeries::pen().
color : QColor
Это свойство хранит цвет заливки (кисти) ряда. Это удобное свойство для изменения цвета кисти.
Функции доступа:
| QColor | color() const |
| void | setColor(const QColor &color) |
Сигнал уведомления:
| void | colorChanged(QColor color) |
См. также QAreaSeries::brush().
[read-only] lowerSeries : QLineSeries* const
Это свойство хранит нижний из двух рядов линий, используемых для определения границ области ряда.
Примечание: Если QAreaSeries был создан без lowerSeries, это значение равно null.
Функции доступа:
| QLineSeries * | lowerSeries() const |
pointLabelsClipping : bool
Это свойство хранит значение обрезки для меток точек данных. По умолчанию значение равно true. Метки на краю области графика обрезаются при включенной обрезке.
Функции доступа:
| bool | pointLabelsClipping() const |
| void | setPointLabelsClipping(bool enabled = true) |
Сигнал уведомления:
| void | pointLabelsClippingChanged(bool clipping) |
См. также pointLabelsVisible.
pointLabelsColor : QColor
Это свойство хранит цвет, используемый для меток точек данных. По умолчанию цвет соответствует цвету кисти, определенной для меток в теме.
Функции доступа:
| QColor | pointLabelsColor() const |
| void | setPointLabelsColor(const QColor &color) |
Сигнал уведомления:
| void | pointLabelsColorChanged(const QColor &color) |
См. также QAreaSeries::pointLabelsFormat.
pointLabelsFont : QFont
Это свойство хранит шрифт, используемый для меток точек данных.
Функции доступа:
| QFont | pointLabelsFont() const |
| void | setPointLabelsFont(const QFont &font) |
Сигнал уведомления:
| void | pointLabelsFontChanged(const QFont &font) |
См. также QAreaSeries::pointLabelsFormat.
pointLabelsFormat : QString
Это свойство хранит формат, используемый для отображения меток с точками ряда.
QAreaSeries поддерживает следующие метки формата:
| @xPoint | Значение x точки данных |
| @yPoint | Значение y точки данных |
Например, следующее использование меток формата создаст метки, содержащие точку данных (x, y) в скобках, разделенных запятой:
series->setPointLabelsFormat("(@xPoint, @yPoint)"); По умолчанию формат метки установлен на @xPoint, @yPoint. Метки отображаются в области графика, при этом метки на краю области графика обрезаются. Если точки близко друг к другу, метки могут накладываться.
Функции доступа:
| QString | pointLabelsFormat() const |
| void | setPointLabelsFormat(const QString &format) |
Сигнал уведомления:
| void | pointLabelsFormatChanged(const QString &format) |
См. также QAreaSeries::pointLabelsVisible, QAreaSeries::pointLabelsFont и QAreaSeries::pointLabelsColor.
pointLabelsVisible : bool
Это свойство хранит видимость меток точек данных. По умолчанию значение равно false.
Функции доступа:
| bool | pointLabelsVisible() const |
| void | setPointLabelsVisible(bool visible = true) |
Сигнал уведомления:
| void | pointLabelsVisibilityChanged(bool visible) |
См. также QAreaSeries::pointLabelsFormat и QAreaSeries::pointLabelsClipping.
[read-only] upperSeries : QLineSeries* const
Это свойство хранит верхний из двух рядов линий, используемых для определения границ области ряда.
Функции доступа:
| QLineSeries * | upperSeries() const |
Документация функций-членов
QAreaSeries::QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr)
Создает объект ряда области, который будет охватываться линией upperSeries и линией lowerSeries. Если lowerSeries не передан в конструктор, ось x используется в качестве нижней границы вместо этого.
QAreaSeries не владеет верхним или нижним рядом, а право собственности сохраняется у вызывающей стороны. При добавлении объекта ряда в QChartView или QChart право собственности передается.
QAreaSeries::QAreaSeries(QObject *parent = nullptr)
Создает объект ряда области без верхнего или нижнего ряда с объектом parent.
[signal] void QAreaSeries::borderColorChanged(QColor color)
Этот сигнал испускается, когда цвет линии (пера) изменяется на color.
Примечание: Сигнал уведомления для свойства borderColor.
[signal] void QAreaSeries::clicked(const QPointF &point)
Этот сигнал испускается, когда пользователь вызывает нажатие на point, щелкнув по нему в диаграмме области.
См. также pressed, released и doubleClicked.
[signal] void QAreaSeries::colorChanged(QColor color)
Этот сигнал испускается, когда цвет заливки (кисти) изменяется на color.
Примечание: Сигнал-уведомитель для свойства color.
[signal] void QAreaSeries::doubleClicked(const QPointF &point)
Этот сигнал испускается, когда пользователь вызывает первое нажатие в диаграмме области, дважды щелкнув по point.
См. также pressed, released и clicked.
[signal] void QAreaSeries::hovered(const QPointF &point, bool state)
Этот сигнал испускается, когда пользователь наводит курсор мыши на область или убирает его с области. point показывает исходную точку (координаты) события наведения. state имеет значение true при наведении курсора на область и становится false, когда курсор убирается с области.
[signal] void QAreaSeries::pointLabelsClippingChanged(bool clipping)
Этот сигнал испускается, когда обрезка меток точек данных изменяется на clipping.
Примечание: Сигнал-уведомитель для свойства pointLabelsClipping.
[signal] void QAreaSeries::pointLabelsColorChanged(const QColor &color)
Этот сигнал испускается, когда цвет, используемый для меток точек данных, изменяется на color.
Примечание: Сигнал-уведомитель для свойства pointLabelsColor.
[signal] void QAreaSeries::pointLabelsFontChanged(const QFont &font)
Этот сигнал испускается, когда шрифт, используемый для меток точек данных, изменяется на font.
Примечание: Сигнал-уведомитель для свойства pointLabelsFont.
[signal] void QAreaSeries::pointLabelsFormatChanged(const QString &format)
Этот сигнал испускается, когда изменяется формат меток точек данных.
Примечание: Сигнал-уведомитель для свойства pointLabelsFormat.
[signal] void QAreaSeries::pointLabelsVisibilityChanged(bool visible)
Этот сигнал испускается, когда видимость меток точек данных изменяется на visible.
Примечание: Сигнал-уведомитель для свойства pointLabelsVisible.
[signal] void QAreaSeries::pressed(const QPointF &point)
Этот сигнал испускается, когда пользователь нажимает на точку, заданную point, в диаграмме области.
См. также clicked, released и doubleClicked.
[signal] void QAreaSeries::released(const QPointF &point)
Этот сигнал испускается, когда пользователь отпускает нажатие, которое было инициировано на point в диаграмме области.
См. также pressed, clicked и doubleClicked.
[virtual] QAreaSeries::~QAreaSeries()
Удаляет объект.
QBrush QAreaSeries::brush() const
Возвращает кисть, используемую для рисования линии для этой серии.
См. также setBrush().
QPen QAreaSeries::pen() const
Возвращает перо, используемое для рисования линии для этой серии.
См. также setPen().
bool QAreaSeries::pointsVisible() const
Возвращает, отображаются ли точки для этой серии.
См. также setPointsVisible().
void QAreaSeries::setBrush(const QBrush &brush)
Устанавливает brush, используемую для заполнения области.
См. также brush().
void QAreaSeries::setLowerSeries(QLineSeries *series)
Устанавливает series, который будет использоваться в качестве нижней серии диаграммы области.
См. также lowerSeries().
void QAreaSeries::setPen(const QPen &pen)
Устанавливает pen, используемое для рисования контура области.
См. также pen().
void QAreaSeries::setPointsVisible(bool visible = true)
Определяет, будут ли отображаться точки данных visible и должны ли они быть нарисованы на линии.
См. также pointsVisible().
void QAreaSeries::setUpperSeries(QLineSeries *series)
Устанавливает series, который будет использоваться в качестве верхней серии диаграммы области. Если верхняя серия равна null, диаграмма области не рисуется, даже если у нее есть нижняя серия.
См. также upperSeries().
[override virtual] QAbstractSeries::SeriesType QAreaSeries::type() const
Переопределяет функцию доступа к свойству: QAbstractSeries::type.
Возвращает QAbstractSeries::SeriesTypeArea.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qareaseries.html
