Класс QAreaSeries
Класс QAreaSeries представляет данные в диаграммах областей. Подробнее...
| Заголовок: | #include <QAreaSeries> |
| Инициализируется из: | AreaSeries |
| Наследует от: | QAbstractSeries |
Свойства
|
|
Открытые функции
| QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr) | |
| QAreaSeries(QObject *parent = nullptr) | |
| virtual | ~QAreaSeries() |
| QColor | borderColor() const |
| QBrush | brush() const |
| QColor | color() const |
| QLineSeries * | lowerSeries() const |
| QPen | pen() const |
| bool | pointLabelsClipping() const |
| QColor | pointLabelsColor() const |
| QFont | pointLabelsFont() const |
| QString | pointLabelsFormat() const |
| bool | pointLabelsVisible() const |
| bool | pointsVisible() const |
| void | setBorderColor(const QColor &color) |
| void | setBrush(const QBrush &brush) |
| void | setColor(const QColor &color) |
| void | setLowerSeries(QLineSeries *series) |
| void | setPen(const QPen &pen) |
| void | setPointLabelsClipping(bool enabled = true) |
| void | setPointLabelsColor(const QColor &color) |
| void | setPointLabelsFont(const QFont &font) |
| void | setPointLabelsFormat(const QString &format) |
| void | setPointLabelsVisible(bool visible = true) |
| void | setPointsVisible(bool visible = true) |
| void | setUpperSeries(QLineSeries *series) |
| QLineSeries * | upperSeries() const |
Переопределённые открытые функции
| virtual QAbstractSeries::SeriesType | type() const override |
Сигналы
| void | borderColorChanged(QColor color) |
| void | clicked(const QPointF &point) |
| void | colorChanged(QColor color) |
| void | doubleClicked(const QPointF &point) |
| void | hovered(const QPointF &point, bool state) |
| void | pointLabelsClippingChanged(bool clipping) |
| void | pointLabelsColorChanged(const QColor &color) |
| void | pointLabelsFontChanged(const QFont &font) |
| void | pointLabelsFormatChanged(const QString &format) |
| void | pointLabelsVisibilityChanged(bool visible) |
| void | pressed(const QPointF &point) |
| void | released(const QPointF &point) |
Подробное описание
Серия областей используется для отображения количественных данных. Она основана на серии линий, при этом область между граничными линиями выделяется цветом. Поскольку серия областей основана на серии линий, конструктор 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.
[signal] void QAreaSeries::doubleClicked(const QPointF &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)
Этот сигнал излучается, когда формат меток точек данных изменяется на 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)
Этот сигнал излучается, когда пользователь отпускает нажатие, которое было вызвано по точке в диаграмме области.
См. также 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.1/qareaseries.html