QXYSeries Class

Dokumentation der Mitgliedsfunktionen

[virtual noexcept] QXYSeries::~QXYSeries()

Löscht die Serie. Serien, die zu QChart Instanzen hinzugefügt werden, sind deren Eigentum und werden gelöscht, wenn die QChart Instanzen gelöscht werden.

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

Fügt den Datenpunkt mit den Koordinaten x und y zu der Reihe hinzu.

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

Dies ist eine überladene Funktion.

Fügt die durch points angegebene Liste von Datenpunkten zu der Reihe hinzu.

void QXYSeries::append(const QPointF &point)

Dies ist eine überladene Funktion.

Fügt den Datenpunkt point zu der Reihe hinzu.

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

Gibt den Datenpunkt an der durch index angegebenen Position in der internen Punktreihe zurück.

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

Dieses Signal wird ausgegeben, wenn sich die Farbe für die Linie der besten Anpassung in color ändert.

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

Gibt ein Zahlenpaar zurück, bei dem die erste Zahl ein Steigungsfaktor und die zweite Zahl der Achsenabschnitt einer linearen Funktion für eine Best-Fit-Linie ist.

Diese Faktoren werden mit der Methode der kleinsten Quadrate auf der Grundlage der an die Reihe übergebenen Punkte berechnet.

Der Parameter ok wird verwendet, um einen Fehler zu melden, indem sein Wert auf false gesetzt wird, und um einen Erfolg zu melden, indem sein Wert auf true gesetzt wird.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch QXYSeries::bestFitLineVisible().

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

Dieses Signal wird ausgegeben, wenn die Sichtbarkeit der Best-Fit-Linie auf visible wechselt.

QBrush QXYSeries::brush() const

Gibt den Pinsel zurück, der zum Füllen der Datenpunkte für die Serie verwendet wird.

Siehe auch setBrush().

void QXYSeries::clear()

Entfernt alle Punkte aus der Serie.

Siehe auch pointsRemoved().

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

Entfernt die Konfiguration eines Punktes, der sich auf index befindet, und stellt das Standardaussehen wieder her, das sich aus den Einstellungen der Serie ergibt.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch clearPointsConfiguration() und setPointConfiguration().

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

Entfernt die durch key identifizierte Konfigurationseigenschaft von dem Punkt index und stellt das aus den Einstellungen der Serie abgeleitete Standardaussehen wieder her.

Entfernt den durch key angegebenen Konfigurationstyp (z. B. Farbe oder Größe) aus dem Punkt index mit Konfigurationsanpassungen, so dass diese Konfigurationseigenschaft als die in den Eigenschaften der Serie angegebene Standardeinstellung wiedergegeben wird.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch clearPointsConfiguration() und setPointConfiguration().

[since 6.2] void QXYSeries::clearPointsConfiguration()

Entfernt die Konfiguration aller Punkte in der Serie und stellt das aus den Einstellungen der Serie abgeleitete Standardaussehen wieder her.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointConfiguration().

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

Entfernt die durch key identifizierte Konfigurationseigenschaft von allen Punkten und stellt das von den Einstellungen der Serie abgeleitete Standardaussehen wieder her.

Entfernt den durch key angegebenen Konfigurationstyp, wie z.B. Farbe oder Größe, von allen Punkten mit Konfigurationsanpassungen, so dass diese Konfigurationseigenschaft als die in den Serieneigenschaften angegebene Standardeinstellung wiedergegeben wird.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch clearPointsConfiguration() und setPointConfiguration().

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

Dieses Signal wird ausgegeben, wenn der Benutzer ein Mausereignis auslöst, indem er den Punkt point im Diagramm anklickt.

Siehe auch pressed(), released(), und doubleClicked().

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

Setzt die Farbe der Punkte entsprechend einer übergebenen Liste von Werten. Die Werte von sourceData werden sortiert und auf gradient abgebildet.

Wenn die Serie eine QColorAxis angehängt hat, dann wird ein Gradient von der Achse verwendet.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointConfiguration(), pointConfiguration(), und QColorAxis.

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

Dieses Signal wird ausgegeben, wenn die Farbe der Linie (des Stifts) auf color wechselt.

int QXYSeries::count() const

Gibt die Anzahl der Datenpunkte in einer Reihe zurück.

[since 6.2] void QXYSeries::deselectAllPoints()

Deselektiert alle Punkte in der Serie.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointSelected().

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

Deselektiert den Punkt auf der angegebenen index.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointSelected().

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

Markiert mehrere in einer Liste indexes übergebene Punkte als abgewählt.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointSelected().

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

Dieses Signal wird ausgegeben, wenn der Benutzer einen Doppelklick auf den Datenpunkt point im Diagramm ausführt. Der point ist der Punkt, an dem der erste Druck ausgelöst wurde.

Siehe auch pressed(), released(), und clicked().

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

Dieses Signal wird ausgegeben, wenn der Mauszeiger über den Punkt point im Diagramm bewegt wird. Wenn sich die Maus über den Punkt bewegt, wird state zu true, und wenn sich die Maus wieder entfernt, wird sie zu false.

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

Fügt den Datenpunkt point in die Reihe an der durch index angegebenen Position ein.

Siehe auch pointAdded().

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

Gibt true zurück, wenn der Punkt auf der angegebenen Seite index zu den ausgewählten Punkten gehört, andernfalls false.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch selectedPoints(), setPointSelected(), und setSelectedColor().

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

Ermittelt das Bild, das zum Zeichnen von Markierungen an jedem Punkt der Serie verwendet wird.

Der Standardwert ist QImage(), was bedeutet, dass keine Lichtmarkierung gezeichnet wird.

Die Lichtmarkierungen visualisieren die Datenpunkte dieser Reihe und sind somit eine Alternative zu setPointsVisible(true). Beide Funktionen können unabhängig voneinander aktiviert werden.

Im Gegensatz zu den Elementen von QScatterSeries werden die Lichtmarkierungen nicht von QGraphicsItem dargestellt, sondern nur gezeichnet (keine Objekte erzeugt). Die Maus-Ereignissignale von QXYSeries verhalten sich jedoch gleich, d.h. Sie erhalten den exakten Domain-Wert des Punktes, wenn Sie den Lichtmarker anklicken/drücken/schwenken. Wenn Sie auf die Linie klicken, erhalten Sie immer noch den dazwischen liegenden Bereichswert. Die Lichtmarkierungen stehen sowohl in Bezug auf das Malen als auch auf die Ereignisse über der Linie.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch QXYSeries::setLightMarker().

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

Dieses Signal wird ausgegeben, wenn das Bild der Leuchtmarkierung auf lightMarker wechselt.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch QXYSeries::setLightMarker().

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

Ruft die Größe der Markierung ab, die zur Darstellung von Punkten in der Serie verwendet wird.

Die Standardgröße hängt von dem spezifischen QXYSeries Typ ab. QScatterSeries hat einen Standardwert von 15.0 QLineSeries hat einen Standardwert von der Stiftgröße der Serie * 1.5

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setMarkerSize() und QScatterSeries::markerSize.

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

Dieses Signal wird ausgegeben, wenn sich die Markergröße auf size ändert.

QPen QXYSeries::pen() const

Gibt den Stift zurück, der zum Zeichnen des Umrisses der Datenpunkte für die Reihe verwendet wurde.

Siehe auch setPen().

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

Dieses Signal wird ausgegeben, wenn der Stift auf pen wechselt.

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

Dieses Signal wird ausgegeben, wenn ein Punkt an der durch index angegebenen Position hinzugefügt wird.

Siehe auch append() und insert().

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

Gibt eine Karte zurück, die die Konfiguration eines Punktes auf index darstellt.

Mit der Punktkonfiguration können Sie verschiedene Aspekte des Aussehens jedes Punktes ändern.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointConfiguration().

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

Dieses Signal wird ausgegeben, wenn sich die Beschneidung der Datenpunktbeschriftungen auf clipping ändert.

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

Dieses Signal wird ausgegeben, wenn die Farbe der Datenpunktbeschriftung auf color wechselt.

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

Dieses Signal wird ausgegeben, wenn die Schriftart für Datenpunktbeschriftungen auf font wechselt.

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

Dieses Signal wird ausgegeben, wenn sich das Format der Datenpunktbeschriftungen in format ändert.

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

Dieses Signal wird ausgegeben, wenn die Sichtbarkeit der Datenpunktbeschriftungen auf visible wechselt.

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

Dieses Signal wird ausgegeben, wenn ein Punkt von der durch index angegebenen Position entfernt wird.

Siehe auch remove().

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

Dieses Signal wird ausgegeben, wenn ein Punkt an der durch index angegebenen Position ersetzt wird.

Siehe auch replace().

QList<QPointF> QXYSeries::points() const

Gibt die Punkte der Serie zurück.

[since 6.2] QXYSeries::PointsConfigurationHash QXYSeries::pointsConfiguration() const

Gibt eine Map mit den Indexen der Punkte als Schlüssel und der Konfiguration der Punkte als Werte zurück.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointsConfiguration(), setPointConfiguration(), und pointConfiguration().

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

Dieses Signal wird ausgegeben, wenn die durch count angegebene Anzahl von Punkten ab der durch index angegebenen Position entfernt wird.

Siehe auch removePoints() und clear().

[signal] void QXYSeries::pointsReplaced()

Dieses Signal wird ausgesendet, wenn alle Punkte durch andere Punkte ersetzt werden.

Siehe auch replace().

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

Dieses Signal wird ausgegeben, wenn der Benutzer auf den Datenpunkt point im Diagramm drückt und die Maustaste gedrückt hält.

Siehe auch clicked(), released(), und doubleClicked().

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

Dieses Signal wird ausgegeben, wenn der Benutzer die Maustaste auf dem durch point angegebenen Datenpunkt loslässt.

Siehe auch pressed(), clicked(), und doubleClicked().

void QXYSeries::remove(const QPointF &point)

Entfernt den Datenpunkt point aus der Reihe.

Siehe auch pointRemoved().

void QXYSeries::remove(int index)

Entfernt den Punkt an der durch index angegebenen Position aus der Reihe.

Siehe auch pointRemoved().

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

Entfernt den Punkt mit den Koordinaten x und y aus der Reihe.

Siehe auch pointRemoved().

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

Entfernt die durch count angegebene Anzahl von Punkten aus der Reihe, beginnend an der durch index angegebenen Position.

Siehe auch pointsRemoved().

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

Ersetzt die aktuellen Punkte durch die in points angegebenen Punkte.

Siehe auch pointsReplaced().

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

Ersetzt den durch oldPoint angegebenen Punkt durch den durch newPoint angegebenen.

Siehe auch pointReplaced().

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

Ersetzt den Punkt an der durch index angegebenen Position durch den durch newPoint angegebenen Punkt.

Siehe auch pointReplaced().

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

Ersetzt den Punkt an der durch index angegebenen Position durch den Punkt mit den Koordinaten newX und newY.

Siehe auch pointReplaced().

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

Ersetzt den Punkt mit den Koordinaten oldX und oldY durch den Punkt mit den Koordinaten newX und newY. Führt nichts aus, wenn der alte Punkt nicht existiert.

Siehe auch pointReplaced().

[since 6.2] void QXYSeries::selectAllPoints()

Markiert alle Punkte in der Serie als ausgewählt,

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointSelected().

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

Markiert den Punkt auf index als ausgewählt.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointSelected().

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

Markiert mehrere in einer Liste indexes übergebene Punkte als ausgewählt.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointSelected().

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

Gibt das Bild zurück, das zum Zeichnen von Markierungen an den Punkten der ausgewählten Serie verwendet wird.

Der Standardwert ist QImage(), was bedeutet, dass das übliche lightMarker() gezeichnet wird.

Dies ist äquivalent zu selectedColor, wenn Sie helle Markierungen gegenüber normalen Punkten bevorzugen, aber dennoch ausgewählte Punkte unterscheiden wollen.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setSelectedLightMarker(), lightMarker(), selectedColor, und setPointSelected().

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

Gibt eine Liste von Punktindizes zurück, die als ausgewählt markiert sind. Ausgewählte Punkte sind unabhängig von der Sichtbarkeit der Punkte sichtbar.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointSelected() und pointsVisible().

[signal] void QXYSeries::selectedPointsChanged()

Dieses Signal wird ausgegeben, wenn sich die Punktauswahl ändert.

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

Setzt den Pinsel, der zum Zeichnen von Punkten auf dem Diagramm verwendet wird, auf brush. Wenn der Pinsel nicht definiert ist, wird der Pinsel aus der Einstellung des Diagrammthemas verwendet.

Siehe auch brush() und QChart::setTheme().

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

Legt das Bild, das zum Zeichnen von Markierungen an jedem Punkt der Reihe verwendet wird, als Wert von lightMarker fest.

Der Standardwert ist ein Standard-QImage() (QImage::isNull() == true), was bedeutet, dass keine Lichtmarkierung gezeichnet wird. Sie können die Standardeinstellung (deaktiviert) wiederherstellen, indem Sie diese Funktion mit einem Nullwert QImage (QImage()) aufrufen.

Die Lichtmarkierungen visualisieren die Datenpunkte dieser Reihe und sind somit eine Alternative zu setPointsVisible(true). Wenn eine Lichtmarkierung mit dieser Methode gesetzt wird, werden die sichtbaren Punkte, die mit setPointsVisible(true) gesetzt wurden, nicht angezeigt.

Im Gegensatz zu den Elementen von QScatterSeries werden die Lichtmarker nicht durch QGraphicsItem repräsentiert, sondern nur gezeichnet (keine Objekte erzeugt). Die Maus-Ereignissignale von QXYSeries verhalten sich jedoch gleich, d.h. Sie erhalten den exakten Domain-Wert des Punktes, wenn Sie auf den Lichtmarker klicken/drücken/schwenken. Wenn Sie auf die Linie klicken, erhalten Sie immer noch den dazwischen liegenden Bereichswert. Die Lichtmarkierungen stehen sowohl in Bezug auf das Malen als auch auf die Ereignisse über der Linie.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch QXYSeries::lightMarker().

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

Legt die size der Markierung fest, die zum Rendern von Punkten in der Serie verwendet wird.

Die Standardgröße ist 15.0.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch QScatterSeries::markerSize.

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

Setzt den Stift, der zum Zeichnen von Punkten im Diagramm verwendet wird, auf pen. Wenn der Stift nicht definiert ist, wird der Stift aus dem Diagrammthema verwendet.

Siehe auch pen() und QChart::setTheme().

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

Ermöglicht die Anpassung des Aussehens eines Punktes auf index mit dem gewünschten configuration.

Mit der Punktkonfiguration können Sie verschiedene Aspekte des Erscheinungsbildes jedes Punktes ändern.

Die Konfiguration eines Punktes wird als eine Hash-Map mit QXYSeries::pointConfiguration Schlüsseln und QVariant Werten dargestellt. Ein Beispiel:

QLineSeries *series = new QLineSeries();
series->setName("Customized series");
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::Color);
conf[QXYSeries::PointConfiguration::LabelFormat] = "This Point";
series->setPointConfiguration(6, conf);

In diesem Beispiel sehen Sie einen Standard QLineSeries mit 10 Punkten und mit geänderter Konfiguration von zwei Punkten. Die beiden geänderten Punkte sind sichtbar größer als die anderen und haben ein von der Serienkonfiguration abgeleitetes Aussehen. Standardmäßig haben die Punkte keine Beschriftung, aber der Punkt bei Index 4 hat dank der Konfigurationswerte QXYSeries::PointConfiguration::LabelVisibility und QXYSeries::PointConfiguration::LabelFormat eine Beschriftung. Der Punkt bei Index 6 hat dank des Konfigurationswerts QXYSeries::PointConfiguration::LabelFormat eine benutzerdefinierte Bezeichnung Dieser Punkt. Nachfolgend sehen Sie ein Beispiel für ein auf diese Weise erstelltes Diagramm:

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch pointConfiguration(), pointsConfiguration(), und clearPointsConfiguration().

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

Ermöglicht das Anpassen eines bestimmten Aspekts der Konfiguration eines Punktes.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch pointsConfiguration().

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

Markiert den Punkt auf der angegebenen Seite index als ausgewählt oder abgewählt, wie durch selected angegeben.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch isPointSelected(), setPointSelected(), und setSelectedColor().

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

Ermöglicht das Anpassen der Konfiguration von mehreren Punkten, wie von pointsConfiguration angegeben.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch pointsConfiguration().

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

Setzt das Bild, das zum Zeichnen von Markierungen auf die Punkte der ausgewählten Serie verwendet wird, auf selectedLightMarker.

Der Standardwert ist QImage(), was bedeutet, dass das übliche lightMarker() gezeichnet wird.

Dies ist ein Äquivalent für selectedColor, wenn Sie helle Markierungen gegenüber normalen Punkten bevorzugen, aber dennoch ausgewählte Punkte unterscheiden wollen.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch selectedLightMarker(), lightMarker(), selectedColor, und setPointSelected().

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

Legt die Größe der Punkte entsprechend einer übergebenen Liste von Werten fest. Die Werte von sourceData werden sortiert und auf eine Punktgröße abgebildet, die zwischen minSize und maxSize liegt.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointConfiguration() und pointConfiguration().

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

Ändert den Auswahlzustand der Punkte auf indexes in den entgegengesetzten Zustand. Erzeugt

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointSelected().

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

Stream-Operator zum Hinzufügen der durch points angegebenen Liste von Datenpunkten zu der Reihe.

Siehe auch append().

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

Stream-Operator zum Hinzufügen des Datenpunkts point zur Reihe.

Siehe auch append().