Класс QXYSeries

Класс QXYSeries — базовый класс для линий, сплайнов и точечных рядов. Подробнее...

• Список всех членов, включая наследуемые
• Устаревшие члены

Общедоступные типы

Свойства

Общедоступные функции

Сигналы

Подробное описание

QXYSeries поддерживает отображение линии наилучшей аппроксимации на графике. Линия наилучшей аппроксимации — это линия на графике, которая выражает взаимосвязь между точками.

Документация по типам элементов

Перечисление QXYSeries::PointConfiguration

Это значение перечисления описывает конкретную конфигурацию точки.

См. такжеsetPointConfiguration().

series->setPointLabelsFormat("(@xPoint, @yPoint)");

Документация по функциям-членам

[signal] void QXYSeries::bestFitLineColorChanged(const QColor &color)

Этот сигнал излучается, когда цвет, используемый для линии наилучшего приближения, изменяется на color.

Примечание: Сигнал-уведомление для свойства bestFitLineColor.

[signal] void QXYSeries::bestFitLineVisibilityChanged(bool visible)

Этот сигнал излучается, когда видимость линии наилучшего приближения изменяется на visible.

Примечание: Сигнал-уведомление для свойства bestFitLineVisible.

[signal] void QXYSeries::clicked(const QPointF &point)

Этот сигнал излучается, когда пользователь вызывает событие мыши, щелкнув по точке point на графике.

См. также pressed(), released() и doubleClicked().

[signal] void QXYSeries::colorChanged(QColor color)

Этот сигнал излучается, когда цвет линии (пера) изменяется на color.

Примечание: Сигнал-уведомление для свойства цвет.

[signal] void QXYSeries::doubleClicked(const QPointF &point)

Этот сигнал излучается, когда пользователь дважды щелкает по точке данных point на графике. point — точка, по которой произошло первое нажатие.

См. также pressed(), released() и clicked().

[signal] void QXYSeries::hovered(const QPointF &point, bool state)

Этот сигнал излучается, когда курсор мыши наведён на точку point на графике. При наведении на точку state устанавливается в true, а при перемещении курсора мыши с точки — в false.

[signal, since 6.2] void QXYSeries::lightMarkerChanged(const QImage &lightMarker)

Этот сигнал излучается, когда изображение метки подсветки изменяется на lightMarker.

Эта функция была добавлена в Qt 6.2.

См. также QXYSeries::setLightMarker() и ;.

[signal] void QXYSeries::markerSizeChanged(qreal size)

Этот сигнал излучается, когда размер маркера изменяется на size.

[signal] void QXYSeries::penChanged(const QPen &pen)

Этот сигнал излучается, когда перо изменяется на pen.

[signal] void QXYSeries::pointAdded(int index)

Этот сигнал излучается, когда точка добавляется в позицию, указанную index.

См. также append() и insert().

[signal] void QXYSeries::pointLabelsClippingChanged(bool clipping)

Этот сигнал излучается, когда обрезка меток точек данных изменяется на clipping.

Примечание: Сигнал-уведомление для свойства pointLabelsClipping.

[signal] void QXYSeries::pointLabelsColorChanged(const QColor &color)

Этот сигнал излучается, когда цвет, используемый для меток точек данных, изменяется на color.

Примечание: Сигнал-уведомление для свойства pointLabelsColor.

[signal] void QXYSeries::pointLabelsFontChanged(const QFont &font)

Этот сигнал излучается, когда шрифт, используемый для меток точек данных, изменяется на font.

Примечание: Сигнал-уведомление для свойства pointLabelsFont.

[signal] void QXYSeries::pointLabelsFormatChanged(const QString &format)

Этот сигнал излучается, когда формат меток точек данных изменяется на format.

Примечание: Сигнал-уведомление для свойства pointLabelsFormat.

[signal] void QXYSeries::pointLabelsVisibilityChanged(bool visible)

Этот сигнал излучается, когда видимость меток точек данных изменяется на visible.

Примечание: Сигнал-уведомление для свойства pointLabelsVisible.

[signal] void QXYSeries::pointRemoved(int index)

Этот сигнал излучается, когда точка удаляется из позиции, указанной index.

См. также remove().

[signal] void QXYSeries::pointReplaced(int index)

Этот сигнал излучается, когда точка заменяется в позиции, указанной index.

См. также replace().

[signal] void QXYSeries::pointsRemoved(int index, int count)

Этот сигнал излучается, когда количество точек, указанное count, удаляется, начиная с позиции, указанной index.

См. также removePoints() и clear().

[signal] void QXYSeries::pointsReplaced()

Этот сигнал излучается, когда все точки заменены другими точками.

См. также replace().

[signal] void QXYSeries::pressed(const QPointF &point)

Этот сигнал излучается, когда пользователь нажимает на точку данных point на графике и удерживает кнопку мыши.

См. также clicked(), released() и doubleClicked().

[signal] void QXYSeries::released(const QPointF &point)

Этот сигнал излучается, когда пользователь отпускает нажатие мыши на точке данных, указанной point.

См. также pressed(), clicked() и doubleClicked().

[virtual] QXYSeries::~QXYSeries()

Удаляет ряд. Ряды, добавленные в экземпляры QChart, принадлежат им и удаляются при удалении экземпляров QChart.

void QXYSeries::append(qreal x, qreal y)

Добавляет точку данных с координатами x и y в ряд.

void QXYSeries::append(const QPointF &point)

Это перегруженная функция.

Добавляет точку данных point в ряд.

void QXYSeries::append(const QList<QPointF> &points)

Это перегруженная функция.

Добавляет список точек данных, указанный points, в ряд.

const QPointF &QXYSeries::at(int index) const

Возвращает точку данных в позиции, указанной index, в внутреннем ряду точек.

[since 6.2] QPair<qreal, qreal> QXYSeries::bestFitLineEquation(bool &ok) const

Возвращает пару чисел, где первое число — коэффициент наклона, а второе — отрезок прямой наилучшего приближения.

Эти коэффициенты вычисляются с помощью метода наименьших квадратов на основе точек, переданных в ряд.

Параметр ok используется для сообщения об ошибке, установив его значение в false, и для сообщения об успехе, установив его значение в true.

Эта функция была добавлена в Qt 6.2.

См. также QXYSeries::bestFitLineVisible().

QBrush QXYSeries::brush() const

Возвращает кисть, используемую для заполнения точек данных ряда.

См. также setBrush().

void QXYSeries::clear()

Удаляет все точки из графика.

См. также pointsRemoved().

[since 6.2] void QXYSeries::clearPointConfiguration(const int index)

Удаляет конфигурацию точки по индексу index и восстанавливает стандартный вид, заданный настройками графика.

Функция была добавлена в Qt 6.2.

См. также clearPointsConfiguration() и setPointConfiguration().

[since 6.2] void QXYSeries::clearPointConfiguration(const int index, const QXYSeries::PointConfiguration key)

Удаляет свойство конфигурации, идентифицируемое по key, из точки с индексом index, и восстанавливает стандартный вид, заданный настройками графика.

Удаляет тип конфигурации, такой как цвет или размер, указанный key, из точки с индексом index с настройками конфигурации, позволяя отобразить это свойство конфигурации по умолчанию, заданному в свойствах графика.

Функция была добавлена в Qt 6.2.

См. также clearPointsConfiguration() и setPointConfiguration().

[since 6.2] void QXYSeries::clearPointsConfiguration()

Удаляет конфигурацию всех точек в графике и восстанавливает стандартный вид, заданный настройками графика.

Функция была добавлена в Qt 6.2.

См. также setPointConfiguration().

[since 6.2] void QXYSeries::clearPointsConfiguration(const QXYSeries::PointConfiguration key)

Удаляет свойство конфигурации, идентифицируемое по key, из всех точек и восстанавливает стандартный вид, заданный настройками графика.

Удаляет тип конфигурации, такой как цвет или размер, указанный key, из всех точек с настройками конфигурации, позволяя отобразить это свойство конфигурации по умолчанию, заданному в свойствах графика.

Функция была добавлена в Qt 6.2.

См. также clearPointsConfiguration() и setPointConfiguration().

[since 6.2] void QXYSeries::colorBy(const QList<qreal> &sourceData, const QLinearGradient &gradient = QLinearGradient())

Устанавливает цвет точек в соответствии с переданным списком значений. Значения из sourceData сортируются и отображаются на gradient.

Если к графику прикреплен QColorAxis, будет использоваться градиент с этого объекта.

Функция была добавлена в Qt 6.2.

См. также setPointConfiguration(), pointConfiguration() и QColorAxis.

int QXYSeries::count() const

Возвращает количество точек данных в графике.

[since 6.2] void QXYSeries::deselectAllPoints()

Отменяет выделение всех точек в графике.

Функция была добавлена в Qt 6.2.

См. также setPointSelected().

[since 6.2] void QXYSeries::deselectPoint(int index)

Отменяет выделение точки с данным index.

Функция была добавлена в Qt 6.2.

См. также setPointSelected().

[since 6.2] void QXYSeries::deselectPoints(const QList<int> &indexes)

Отмечает несколько точек, перечисленных в списке indexes, как невыделенные.

Функция была добавлена в Qt 6.2.

См. также setPointSelected().

void QXYSeries::insert(int index, const QPointF &point)

Вставляет точку данных point в график на позицию, указанную index.

См. также pointAdded().

[since 6.2] bool QXYSeries::isPointSelected(int index)

Возвращает true, если точка с данным index среди выделенных, и false в противном случае.

Функция была добавлена в Qt 6.2.

См. также selectedPoints(), setPointSelected() и setSelectedColor().

[since 6.2] const QImage &QXYSeries::lightMarker() const

Получает изображение, используемое для рисования маркеров на каждой точке графика.

Значение по умолчанию — QImage(), что означает, что маркер не будет нарисован.

Маркеры визуализируют точки данных этого графика и являются альтернативой setPointsVisible(true). Обе функции могут быть включены независимо друг от друга.

В отличие от элементов QScatterSeries, светящиеся маркеры не представлены QGraphicsItem, а просто отрисовываются (никаких объектов не создается). Однако сигналы событий мыши QXYSeries ведут себя аналогично, что означает, что вы получите точное значение домена точки, если щелкните/нажмете/наведете курсор на светящийся маркер. Вы по-прежнему получите значение домена между точками, если щелкнете по линии. Светящиеся маркеры расположены над линией как в плане отрисовки, так и событий.

Функция была добавлена в Qt 6.2.

См. также QXYSeries::setLightMarker().

[since 6.2] qreal QXYSeries::markerSize() const

Получает размер маркера, используемого для отрисовки точек на графике.

Размер по умолчанию зависит от конкретного типа QXYSeries. QScatterSeries имеет значение по умолчанию 15.0, QLineSeries имеет значение по умолчанию — размер линии * 1.5.

Функция была добавлена в Qt 6.2.

См. также setMarkerSize() и QScatterSeries::markerSize.

QPen QXYSeries::pen() const

Возвращает кисть, используемую для отрисовки контура точек данных графика.

См. также setPen().

[since 6.2] QHash<QXYSeries::PointConfiguration, QVariant> QXYSeries::pointConfiguration(const int index) const

Возвращает карту, представляющую конфигурацию точки по индексу index.

С помощью конфигурации точек вы можете изменить различные аспекты внешнего вида каждой точки.

Функция была добавлена в Qt 6.2.

См. также setPointConfiguration().

QList<QPointF> QXYSeries::points() const

Возвращает точки на графике.

[since 6.2] QHash<int, QHash<QXYSeries::PointConfiguration, QVariant> > QXYSeries::pointsConfiguration() const

Возвращает карту с индексами точек в качестве ключей и конфигурацией точек в качестве значений.

Функция была добавлена в Qt 6.2.

См. также setPointsConfiguration(), setPointConfiguration() и pointConfiguration().

void QXYSeries::remove(qreal x, qreal y)

Удаляет точку с координатами x и y из графика.

См. также pointRemoved().

void QXYSeries::remove(const QPointF &point)

Удаляет точку данных point из графика.

См. также pointRemoved().

void QXYSeries::remove(int index)

Удаляет точку по индексу index из графика.

См. также pointRemoved().

void QXYSeries::removePoints(int index, int count)

Удаляет указанное количество точек из графика, начиная с позиции index.

См. также pointsRemoved().

void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY)

Заменяет точку с координатами oldX и oldY точкой с координатами newX и newY. Ничего не делает, если старой точки не существует.

См. также pointReplaced().

void QXYSeries::replace(const QPointF &oldPoint, const QPointF &newPoint)

Заменяет точку, заданную oldPoint, точкой, заданной newPoint.

См. также pointReplaced().

void QXYSeries::replace(int index, qreal newX, qreal newY)

Заменяет точку по индексу index точкой с координатами newX и newY.

См. также pointReplaced().

void QXYSeries::replace(int index, const QPointF &newPoint)

Заменяет точку по индексу index точкой, заданной newPoint.

См. также pointReplaced().

void QXYSeries::replace(const QList<QPointF> &points)

Заменяет текущие точки на точки, заданные points.

См. также pointsReplaced().

[since 6.2] void QXYSeries::selectAllPoints()

Помечает все точки в ряду как выбранные.

Эта функция была добавлена в Qt 6.2.

См. также setPointSelected().

[since 6.2] void QXYSeries::selectPoint(int index)

Помечает точку по индексу index как выбранную.

Эта функция была добавлена в Qt 6.2.

См. также setPointSelected().

[since 6.2] void QXYSeries::selectPoints(const QList<int> &indexes)

Помечает несколько точек, переданных в списке indexes, как выбранные.

Эта функция была добавлена в Qt 6.2.

См. также setPointSelected().

[since 6.2] const QImage &QXYSeries::selectedLightMarker() const

Возвращает изображение, используемое для рисования маркеров на выбранных точках графика.

Значение по умолчанию — QImage(), что означает, что будет нарисован обычный маркер lightMarker().

Эквивалентно selectedColor, если вы предпочитаете светлые маркеры вместо обычных точек, но всё равно хотите различать выбранные точки.

Эта функция была добавлена в Qt 6.2.

См. также setSelectedLightMarker(), lightMarker(), selectedColor и setPointSelected().

[since 6.2] QList<int> QXYSeries::selectedPoints() const

Возвращает список индексов точек, отмеченных как выбранные. Выбранные точки видны независимо от видимости точек.

Эта функция была добавлена в Qt 6.2.

См. также setPointSelected() и pointsVisible().

[virtual] void QXYSeries::setBrush(const QBrush &brush)

Устанавливает кисть, используемую для рисования точек на графике, в brush. Если кисть не определена, используется кисть из настроек темы графика.

См. также brush() и QChart::setTheme().

[since 6.2] void QXYSeries::setLightMarker(const QImage &lightMarker)

Устанавливает изображение, используемое для рисования маркеров на каждой точке ряда, как значение lightMarker.

Значение по умолчанию — QImage() (QImage::isNull() == true), что означает, что светлый маркер не будет нарисован. Можно восстановить значение по умолчанию (отключить), вызвав эту функцию с пустым изображением (QImage()).

Светлые маркеры визуализируют данные точки данного ряда и, как таковые, являются альтернативой setPointsVisible(true). Если светлый маркер задан с помощью этого метода, видимые точки, заданные с помощью setPointsVisible(true), не отображаются.

В отличие от элементов QScatterSeries, светлые маркеры не представлены QGraphicsItem, а просто отрисовываются (без создания объектов). Однако сигналы событий мыши QXYSeries ведут себя так же, что означает, что вы получите точное значение области точки, если щелкнёте/нажмёте/наведёте указатель на светлый маркер. Вы по-прежнему получите значение области между точками, если щелкнёте по линии. Светлые маркеры находятся поверх линии как в плане отрисовки, так и в плане событий.

Эта функция была добавлена в Qt 6.2.

См. также QXYSeries::lightMarker().

[since 6.2] void QXYSeries::setMarkerSize(qreal size)

Устанавливает size маркера, используемого для отрисовки точек в ряду.

Значение по умолчанию — 15.0.

Эта функция была добавлена в Qt 6.2.

См. также QScatterSeries::markerSize.

[virtual] void QXYSeries::setPen(const QPen &pen)

Устанавливает перо, используемое для рисования точек на графике, в pen. Если перо не определено, используется перо из темы графика.

См. также pen() и QChart::setTheme().

[since 6.2] void QXYSeries::setPointConfiguration(const int index, const QHash<QXYSeries::PointConfiguration, QVariant> &configuration)

Позволяет настроить внешний вид точки по индексу index с помощью желаемой configuration.

С помощью настройки точек можно изменить различные аспекты внешнего вида каждой точки.

Настройка точки представлена в виде хэш-карты с ключами QXYSeries::pointConfiguration и значениями QVariant. Например:

QLineSeries *series = new QLineSeries();
series->setName("Customized serie");
series->setPointsVisible(true);

*series << QPointF(0, 6) << QPointF(2, 4) << QPointF(3, 6) << QPointF(7, 4) << QPointF(10, 5)
        << QPointF(11, 1) << QPointF(13, 3) << QPointF(17, 6) << QPointF(18, 3)
        << QPointF(20, 2);

QChart *chart = new QChart();
chart->addSeries(series);
chart->createDefaultAxes();

QHash<QXYSeries::PointConfiguration, QVariant> conf;
conf[QXYSeries::PointConfiguration::Color] = QColor(Qt::red);
conf[QXYSeries::PointConfiguration::Size] = 8;
conf[QXYSeries::PointConfiguration::LabelVisibility] = true;

series->setPointConfiguration(4, conf);

conf.remove(QXYSeries::PointConfiguration::LabelVisibility);
series->setPointConfiguration(6, conf);

В этом примере вы видите стандартный QLineSeries с 10 точками и изменённой настройкой двух точек. Обе изменённые точки красные и заметно больше других с внешним видом, полученным от ряда. По умолчанию у точек нет меток, но у точки с индексом 4 есть метка благодаря значению конфигурации QXYSeries::PointConfiguration::LabelVisibility. Ниже приведен пример графика, созданного таким образом:

Эта функция была добавлена в Qt 6.2.

См. также pointConfiguration(), pointsConfiguration() и clearPointsConfiguration().

[since 6.2] void QXYSeries::setPointConfiguration(const int index, const QXYSeries::PointConfiguration key, const QVariant &value)

Позволяет настроить определённый аспект конфигурации точки.

Эта функция была добавлена в Qt 6.2.

См. также pointsConfiguration().

[since 6.2] void QXYSeries::setPointSelected(int index, bool selected)

Помечает точку с заданным index как выбранную или невыбранную в соответствии со значением selected.

Эта функция была добавлена в Qt 6.2.

См. также isPointSelected(), setPointSelected(), и setSelectedColor().

[since 6.2] void QXYSeries::setPointsConfiguration(const QHash<int, QHash<QXYSeries::PointConfiguration, QVariant> > &pointsConfiguration)

Разрешает настраивать конфигурацию нескольких точек, как указано в pointsConfiguration.

Эта функция была добавлена в Qt 6.2.

См. также pointsConfiguration().

[since 6.2] void QXYSeries::setSelectedLightMarker(const QImage &selectedLightMarker)

Устанавливает изображение, используемое для рисования маркеров на выбранных точках ряда, в selectedLightMarker.

Значение по умолчанию — QImage(), что означает, что будет нарисована обычная метка lightMarker().

Это эквивалент selectedColor, если вы предпочитаете световые маркеры вместо обычных точек, но всё ещё хотите различать выбранные точки.

Эта функция была добавлена в Qt 6.2.

См. также selectedLightMarker(), lightMarker(), selectedColor и setPointSelected().

[since 6.2] void QXYSeries::sizeBy(const QList<qreal> &sourceData, const qreal minSize, const qreal maxSize)

Устанавливает размеры точек в соответствии с переданным списком значений. Значения из sourceData сортируются и отображаются в размере точки, который находится между minSize и maxSize.

Эта функция была добавлена в Qt 6.2.

См. также setPointConfiguration() и pointConfiguration().

[since 6.2] void QXYSeries::toggleSelection(const QList<int> &indexes)

Изменяет состояние выделения точек с указанными indexes на противоположное. Делает

Эта функция была добавлена в Qt 6.2.

См. также setPointSelected().

QXYSeries &QXYSeries::operator<<(const QPointF &point)

Оператор потока для добавления точки данных point в ряд.

См. также append().

QXYSeries &QXYSeries::operator<<(const QList<QPointF> &points)

Оператор потока для добавления списка точек данных, указанных в points, в ряд.

См. также append().