Класс QAreaSeries
Класс QAreaSeries представляет данные в диаграммах областей. Подробнее...
| Заголовок: | #include <QAreaSeries> |
| Инициализируется из: | AreaSeries |
| Наследуется от: | QAbstractSeries |
Свойства
|
|
- 5 свойств унаследовано от QAbstractSeries
- 1 свойство унаследовано от QObject
Открытые функции
| QAreaSeries(QObject *parent = Q_NULLPTR) | |
| QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = Q_NULLPTR) | |
| ~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 |
- 15 открытых функций унаследовано от QAbstractSeries
- 32 открытых функций унаследовано от QObject
Сигналы
| 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) |
- 4 сигнала унаследовано от QAbstractSeries
- 2 сигнала унаследовано от QObject
Дополнительные унаследованные члены
- 1 открытый слот унаследован от QObject
- 11 статических открытых членов унаследовано от QObject
- 9 защищённых функций унаследовано от QObject
Подробное описание
Класс QAreaSeries представляет данные в диаграммах областей.
Серия областей используется для отображения количественных данных. Она основана на серии линий, при этом область между ограничивающими линиями выделяется цветом. Поскольку серия областей основана на серии линий, конструктор 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().
lowerSeries : QLineSeries * const
Это свойство хранит нижний из двух линейных рядов, используемых для определения границ ряда областей.
Примечание: Если QAreaSeries был создан без lowerSeries, это значение равно null.
Функции доступа:
| QLineSeries * | lowerSeries() const |
pointLabelsClipping : bool
Это свойство хранит обрезку для меток точек данных. По умолчанию истинно. Метки на краю области графика обрезаются, когда включена обрезка.
Функции доступа:
| 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
Это свойство хранит видимость меток точек данных. По умолчанию ложно.
Функции доступа:
| bool | pointLabelsVisible() const |
| void | setPointLabelsVisible(bool visible = true) |
Сигнал уведомления:
| void | pointLabelsVisibilityChanged(bool visible) |
См. также QAreaSeries::pointLabelsFormat и QAreaSeries::pointLabelsClipping.
upperSeries : QLineSeries * const
Это свойство хранит верхний из двух линейных рядов, используемых для определения границ ряда областей.
Функции доступа:
| QLineSeries * | upperSeries() const |
Описание функций-членов
QAreaSeries::QAreaSeries(QObject *parent = Q_NULLPTR)
Конструирует объект ряда областей без верхнего или нижнего ряда с объектом родительского объекта.
QAreaSeries::QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = Q_NULLPTR)
Конструирует объект ряда областей, который будет охватывать линию upperSeries и линию lowerSeries. Если в конструктор не передается lowerSeries, вместо нижней границы используется ось x.
Объект QAreaSeries не владеет верхним или нижним рядом, но владение остается у вызывающего. Когда объект ряда добавляется в QChartView или QChart, владение экземпляром передается.
QAreaSeries::~QAreaSeries()
Уничтожает объект.
[signal] void QAreaSeries::borderColorChanged(QColor color)
Этот сигнал испускается, когда цвет линии (пера) изменяется на color.
Примечание: Сигнал уведомления для свойства borderColor.
QBrush QAreaSeries::brush() const
Возвращает кисть, используемую для рисования линии для данного ряда.
См. также setBrush().
[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, когда он перемещается от ряда.
QPen QAreaSeries::pen() const
Возвращает перо, используемое для рисования линии для этого ряда.
См. также setPen().
[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.
bool QAreaSeries::pointsVisible() const
Возвращает, отображаются ли точки для данного ряда.
См. также setPointsVisible().
[signal] void QAreaSeries::pressed(const QPointF &point)
Этот сигнал испускается, когда пользователь нажимает на точку, указанную point, в диаграмме области.
См. также clicked, released и doubleClicked.
[signal] void QAreaSeries::released(const QPointF &point)
Этот сигнал испускается, когда пользователь отпускает нажатие, которое было вызвано на point в диаграмме области.
См. также pressed, clicked и doubleClicked.
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().
[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-5.9/qareaseries.html