Spec-Zone.ru › Qt 6.1

Класс QAreaSeries

Класс QAreaSeries представляет данные в диаграммах областей. Подробнее...

Заголовок: #include <QAreaSeries>
Инициализируется из: AreaSeries
Наследует от: QAbstractSeries
  • Список всех членов, включая унаследованные

Свойства

  • borderColor : QColor
  • color : QColor
  • lowerSeries : QLineSeries* const
  • pointLabelsClipping : bool
  • pointLabelsColor : QColor
  • pointLabelsFont : QFont
  • pointLabelsFormat : QString
  • pointLabelsVisible : bool
  • upperSeries : QLineSeries* const

Открытые функции

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.

Примечание: Термины верхняя и нижняя границы могут быть вводящими в заблуждение в тех случаях, когда значение нижней границы больше, чем значение верхней границы. Главное, что область между этими двумя граничными линиями будет заполнена.

См. пример диаграммы областей, чтобы узнать, как создать простую диаграмму областей.

END_OF_DOCUMENT_MARKER

Документация свойств

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

Spec-Zone.ru

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