Auf dieser Seite

QXYSeries Class

Die Klasse „QXYSeries“ ist eine Basisklasse für Linien-, Spline- und Streudiagramme. Mehr...

Header: #include <QXYSeries>
In QML: XYSeries
Inherits: QAbstractSeries
Inherited By:

QLineSeries and QScatterSeries

Status: Deprecated

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Öffentliche Typen

(since 6.2) enum class PointConfiguration { Color, Size, Visibility, LabelVisibility, LabelFormat }

Eigenschaften

Öffentliche Funktionen

virtual ~QXYSeries()
void append(qreal x, qreal y)
void append(const QList<QPointF> &points)
void append(const QPointF &point)
const QPointF &at(int index) const
QColor bestFitLineColor() const
(since 6.2) QPair<qreal, qreal> bestFitLineEquation(bool &ok) const
bool bestFitLineVisible() const
QBrush brush() const
void clear()
(since 6.2) void clearPointConfiguration(const int index)
(since 6.2) void clearPointConfiguration(const int index, const QXYSeries::PointConfiguration key)
(since 6.2) void clearPointsConfiguration()
(since 6.2) void clearPointsConfiguration(const QXYSeries::PointConfiguration key)
virtual QColor color() const
(since 6.2) void colorBy(const QList<qreal> &sourceData, const QLinearGradient &gradient = QLinearGradient())
int count() const
(since 6.2) void deselectAllPoints()
(since 6.2) void deselectPoint(int index)
(since 6.2) void deselectPoints(const QList<int> &indexes)
void insert(int index, const QPointF &point)
(since 6.2) bool isPointSelected(int index)
(since 6.2) const QImage &lightMarker() const
(since 6.2) qreal markerSize() const
QPen pen() const
(since 6.2) QHash<QXYSeries::PointConfiguration, QVariant> pointConfiguration(const int index) const
bool pointLabelsClipping() const
QColor pointLabelsColor() const
QFont pointLabelsFont() const
QString pointLabelsFormat() const
bool pointLabelsVisible() const
QList<QPointF> points() const
(since 6.2) QXYSeries::PointsConfigurationHash pointsConfiguration() const
bool pointsVisible() const
void remove(const QPointF &point)
void remove(int index)
void remove(qreal x, qreal y)
void removePoints(int index, int count)
void replace(const QList<QPointF> &points)
void replace(const QPointF &oldPoint, const QPointF &newPoint)
void replace(int index, const QPointF &newPoint)
void replace(int index, qreal newX, qreal newY)
void replace(qreal oldX, qreal oldY, qreal newX, qreal newY)
(since 6.2) void selectAllPoints()
(since 6.2) void selectPoint(int index)
(since 6.2) void selectPoints(const QList<int> &indexes)
(since 6.2) const QImage &selectedLightMarker() const
(since 6.2) QList<int> selectedPoints() const
void setBestFitLineColor(const QColor &color)
void setBestFitLineVisible(bool visible = true)
virtual void setBrush(const QBrush &brush)
virtual void setColor(const QColor &color)
(since 6.2) void setLightMarker(const QImage &lightMarker)
(since 6.2) void setMarkerSize(qreal size)
virtual void setPen(const QPen &pen)
(since 6.2) void setPointConfiguration(const int index, const QHash<QXYSeries::PointConfiguration, QVariant> &configuration)
(since 6.2) void setPointConfiguration(const int index, const QXYSeries::PointConfiguration key, const QVariant &value)
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)
(since 6.2) void setPointSelected(int index, bool selected)
(since 6.2) void setPointsConfiguration(const QHash<int, QHash<QXYSeries::PointConfiguration, QVariant>> &pointsConfiguration)
void setPointsVisible(bool visible = true)
void setSelectedColor(const QColor &color)
(since 6.2) void setSelectedLightMarker(const QImage &selectedLightMarker)
(since 6.2) void sizeBy(const QList<qreal> &sourceData, const qreal minSize, const qreal maxSize)
(since 6.2) void toggleSelection(const QList<int> &indexes)
QXYSeries &operator<<(const QList<QPointF> &points)
QXYSeries &operator<<(const QPointF &point)

Signale

void bestFitLineColorChanged(const QColor &color)
void bestFitLineVisibilityChanged(bool visible)
void clicked(const QPointF &point)
void colorChanged(QColor color)
void doubleClicked(const QPointF &point)
void hovered(const QPointF &point, bool state)
(since 6.2) void lightMarkerChanged(const QImage &lightMarker)
void markerSizeChanged(qreal size)
void penChanged(const QPen &pen)
void pointAdded(int index)
void pointLabelsClippingChanged(bool clipping)
void pointLabelsColorChanged(const QColor &color)
void pointLabelsFontChanged(const QFont &font)
void pointLabelsFormatChanged(const QString &format)
void pointLabelsVisibilityChanged(bool visible)
void pointRemoved(int index)
void pointReplaced(int index)
void pointsRemoved(int index, int count)
void pointsReplaced()
void pressed(const QPointF &point)
void released(const QPointF &point)
void selectedColorChanged(const QColor &color)
void selectedPointsChanged()

Ausführliche Beschreibung

Die QXY-Serie unterstützt die Darstellung einer Regressionsgeraden in einem Diagramm. Eine Regressionsgerade ist eine Linie, die durch ein Diagramm verläuft und die Beziehung zwischen den Punkten darstellt.

Dokumentation zum Mitgliedstyp

[since 6.2] enum class QXYSeries::PointConfiguration

Dieser Enum-Wert beschreibt die jeweilige Konfiguration eines Punktes.

KonstanteWertBeschreibung
QXYSeries::PointConfiguration::Color0Dieser Enum-Wert kann verwendet werden, um die Farbe eines Punktes zu ändern. Bei Verwendung zusammen mit „ QXYSeries::setPointConfiguration “ sollte der Wert der Konfiguration ein gültiges „ QColor “ sein.
QXYSeries::PointConfiguration::Size1Dieser Enum-Wert kann verwendet werden, um die Größe eines Punktes zu ändern. Bei Verwendung zusammen mit „ QXYSeries::setPointConfiguration “ sollte der Wert der Konfiguration eine Zahl sein, wie beispielsweise „ qreal “ oder „ int “.
QXYSeries::PointConfiguration::Visibility2Dieser Enum-Wert kann verwendet werden, um den Punkt auszublenden oder einzublenden. Bei Verwendung zusammen mit „ QXYSeries::setPointConfiguration “ sollte der Wert der Konfiguration ein boolescher Wert sein.
QXYSeries::PointConfiguration::LabelVisibility3Dieser Enum-Wert kann verwendet werden, um die Beschriftung des Punktes auszublenden oder einzublenden. Bei Verwendung zusammen mit „ QXYSeries::setPointConfiguration “ sollte der Wert der Konfiguration ein boolescher Wert sein.
QXYSeries::PointConfiguration::LabelFormat (since Qt 6.5)4Dieser Enum-Wert kann verwendet werden, um pro Punkt einen benutzerdefinierten Beschriftungstext festzulegen. Bei Verwendung zusammen mit „ QXYSeries::setPointConfiguration “ sollte der Wert der Konfiguration eine Zeichenkette sein.

Hinweis: Wird als „LabelFormat“ eine leere Zeichenkette festgelegt, wird diese ignoriert und stattdessen die Serie „ pointLabelsFormat “ verwendet.

Diese Enumeration wurde in Qt 6.2 eingeführt.

Siehe auch „ pointLabelsFormat “ und „ setPointConfiguration()“.

Dokumentation zur Eigenschaft

[since 6.2] bestFitLineColor : QColor

Diese Eigenschaft enthält die Farbe der besten Passgeraden.

Diese Aufzählung wurde in Qt 6.2 eingeführt.

Zugriffsfunktionen:

QColor bestFitLineColor() const
void setBestFitLineColor(const QColor &color)

Notifier-Signal:

void bestFitLineColorChanged(const QColor &color)

Siehe auch bestFitLineEquation und bestFitLineVisible.

[since 6.2] bestFitLineVisible : bool

Diese Eigenschaft legt die Sichtbarkeit der Regressionsgeraden fest.

Diese Eigenschaft ist standard false.

Diese Aufzählung wurde in Qt 6.2 eingeführt.

Zugriffsfunktionen:

bool bestFitLineVisible() const
void setBestFitLineVisible(bool visible = true)

Notifier-Signal:

void bestFitLineVisibilityChanged(bool visible)

Siehe auch „ bestFitLineEquation “.

color : QColor

Diese Eigenschaft gibt die Farbe der Reihe an.

Dies ist die Linienfarbe (Stiftfarbe) bei QLineSeries oder QSplineSeries und die Füllfarbe (Pinsel) bei QScatterSeries oder QAreaSeries.

Zugriffsfunktionen:

virtual QColor color() const
virtual void setColor(const QColor &color)

Notifier-Signal:

void colorChanged(QColor color)

Siehe auch „ pen()“ und „ brush()“.

pointLabelsClipping : bool

Diese Eigenschaft legt fest, ob die Beschriftungen der Datenpunkte beschnitten werden.

Diese Eigenschaft ist standardmäßig auf „ true “ gesetzt. Die Beschriftungen am Rand des Diagrammbereichs werden abgeschnitten, wenn das Beschneiden aktiviert ist.

Zugriffsfunktionen:

bool pointLabelsClipping() const
void setPointLabelsClipping(bool enabled = true)

Benachrichtigungssignal:

void pointLabelsClippingChanged(bool clipping)

Siehe auch „ pointLabelsVisible “.

pointLabelsColor : QColor

Diese Eigenschaft legt die Farbe fest, die für die Beschriftungen der Datenpunkte verwendet wird. Standardmäßig entspricht die Farbe der im Design für Beschriftungen definierten Pinselfarbe.

Zugriffsfunktionen:

QColor pointLabelsColor() const
void setPointLabelsColor(const QColor &color)

Benachrichtigungssignal:

void pointLabelsColorChanged(const QColor &color)

Siehe auch „ pointLabelsFormat “.

pointLabelsFont : QFont

Diese Eigenschaft gibt die Schriftart an, die für die Beschriftungen der Datenpunkte verwendet wird.

Zugriffsfunktionen:

QFont pointLabelsFont() const
void setPointLabelsFont(const QFont &font)

Benachrichtigungssignal:

void pointLabelsFontChanged(const QFont &font)

Siehe auch „ pointLabelsFormat “.

pointLabelsFormat : QString

Diese Eigenschaft enthält das Format, das für die Anzeige von Beschriftungen bei Datenpunkten verwendet wird.

QXYSeries Unterstützt die folgenden Format-Tags:

@indexDer Index des Datenpunkts in der Reihe. [seit 6.5]
@xPointDie x-Koordinate des Datenpunkts.
@yPointDie y-Koordinate des Datenpunkts.

Beispielsweise würde die folgende Verwendung der Format-Tags Beschriftungen erzeugen, die den Datenpunkt in Klammern und durch ein Komma getrennt anzeigen (x, y):

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

Standardmäßig ist das Format der Beschriftungen auf „ @xPoint, @yPoint “ eingestellt. Die Beschriftungen werden im Darstellungsbereich angezeigt, wobei die Beschriftungen am Rand des Darstellungsbereichs abgeschnitten werden. Liegen die Punkte dicht beieinander, können sich die Beschriftungen überlappen.

Zugriffsfunktionen:

QString pointLabelsFormat() const
void setPointLabelsFormat(const QString &format)

Benachrichtigungssignal:

void pointLabelsFormatChanged(const QString &format)

Siehe auch „ pointLabelsVisible “, „ pointLabelsFont “ und „ pointLabelsColor “.

pointLabelsVisible : bool

Diese Eigenschaft legt die Sichtbarkeit der Beschriftungen der Datenpunkte fest.

Diese Eigenschaft ist standardmäßig auf „ false “ gesetzt.

Zugriffsfunktionen:

bool pointLabelsVisible() const
void setPointLabelsVisible(bool visible = true)

Benachrichtigungssignal:

void pointLabelsVisibilityChanged(bool visible)

Siehe auch „ pointLabelsFormat “ und „ pointLabelsClipping “.

pointsVisible : bool

Diese Eigenschaft gibt an, ob die Datenpunkte sichtbar sind und gezeichnet werden sollen.

Zugriffsfunktionen:

bool pointsVisible() const
void setPointsVisible(bool visible = true)

[since 6.2] selectedColor : QColor

Diese Eigenschaft enthält die Farbe der ausgewählten Punkte.

Dies ist die Füllfarbe (Pinsel-Farbe) der als ausgewählt markierten Punkte. Wenn kein Wert angegeben wird, wird standardmäßig der Wert „ QXYSeries::color “ verwendet.

Diese Aufzählung wurde in Qt 6.2 eingeführt.

Zugriffsfunktionen:

virtual QColor color() const
void setSelectedColor(const QColor &color)

Notifier-Signal:

void selectedColorChanged(const QColor &color)

Siehe auch „ color “.

Dokumentation der Mitgliedsfunktionen

[virtual noexcept] QXYSeries::~QXYSeries()

Löscht die Reihe. Reihen, die zu QChart-Instanzen hinzugefügt wurden, gehören diesen 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 zur Reihe hinzu.

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

Fügt die durch ` points ` angegebene Liste von Datenpunkten zur Reihe hinzu.

Dies ist eine überladene Funktion.

void QXYSeries::append(const QPointF &point)

Fügt den Datenpunkt „ point “ zur Reihe hinzu.

Dies ist eine überladene Funktion.

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 ausgelöst, wenn sich die Farbe der Regressionsgeraden in „ color “ ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft „ bestFitLineColor “.

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

Gibt ein Zahlenpaar zurück, wobei die erste Zahl den Steigungsfaktor und die zweite Zahl den Achsenabschnitt einer linearen Funktion für eine Best-Fit-Gerade darstellt.

Diese Faktoren werden mithilfe 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 sich die Sichtbarkeit der Best-Fit-Geraden auf „ visible “ ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft „ bestFitLineVisible “.

QBrush QXYSeries::brush() const

Gibt den Pinsel zurück, der zum Ausfüllen der Datenpunkte der Reihe verwendet wurde.

Siehe auch „ setBrush()“.

void QXYSeries::clear()

Entfernt alle Punkte aus der Reihe.

Siehe auch „ pointsRemoved()“.

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

Entfernt die Konfiguration eines Punktes unter index und stellt das Standarddesign wieder her, das sich aus den Einstellungen der Reihe ergibt.

Hinweis: Die Konfiguration anderer Punkte bleibtdavon unberührt.

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 der Stelle unter index und stellt das Standardaussehen wieder her, das sich aus den Einstellungen der Reihe ergibt.

Entfernt den durch „ key “ angegebenen Konfigurationstyp (z. B. Farbe oder Größe) aus dem Punkt unter „ index “ mit benutzerdefinierten Konfigurationen, sodass diese Konfigurationseigenschaft gemäß der in den Eigenschaften der Reihe festgelegten Standardeinstellung dargestellt wird.

Hinweis: Die Konfiguration anderer Punkte wirddavon nicht beeinflusst.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch clearPointsConfiguration() und setPointConfiguration().

[since 6.2] void QXYSeries::clearPointsConfiguration()

Löscht die Konfiguration aller Punkte in der Reihe und stellt das Standardaussehen wieder her, das sich aus den Einstellungen der Reihe ergibt.

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 aus allen Punkten und stellt das Standardaussehen wieder her, das sich aus den Einstellungen der Reihe ergibt.

Entfernt den durch „ key “ angegebenen Konfigurationstyp (z. B. Farbe oder Größe) aus allen Punkten mit benutzerdefinierten Konfigurationen, sodass diese Konfigurationseigenschaft gemäß der in den Serieneigenschaften festgelegten Standardeinstellung dargestellt 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 ausgelöst, wenn der Benutzer durch Klicken auf den Punkt point im Diagramm ein Mausereignis auslöst.

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

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

Legt die Farbe der Punkte entsprechend einer übergebenen Liste von Werten fest. Die Werte aus „ sourceData “ werden sortiert und der Liste „ gradient “ zugeordnet.

Wenn der Serie eine QColorAxis zugeordnet ist, wird ein Farbverlauf aus dieser 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 ausgelöst, wenn sich die Linienfarbe (Stiftfarbe) auf „ color “ ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ color “.

int QXYSeries::count() const

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

[since 6.2] void QXYSeries::deselectAllPoints()

Hebt die Auswahl aller Punkte in der Reihe auf.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch „ setPointSelected()“.

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

Hebt die Auswahl des Punktes an der angegebenen Koordinaten index auf.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointSelected().

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

Markiert mehrere bereits durchlaufene Punkte in einer „ indexes “-Liste 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 ausgelöst, wenn der Benutzer im Diagramm auf den Datenpunkt point doppelklickt. Die Koordinate „ point “ ist der Punkt, an dem der erste Klick ausgelöst wurde.

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

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

Dieses Signal wird ausgelöst, wenn der Mauszeiger über den Punkt point im Diagramm bewegt wird. Wenn der Mauszeiger über den Punkt bewegt wird, wechselt die Farbe von state zu true, und wenn der Mauszeiger wieder wegbewegt wird, wechselt sie zu false.

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

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

Siehe auch pointAdded().

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

Gibt „true“ zurück, wenn der Punkt unter der angegebenen Koordinaten index e zu den ausgewählten Punkten gehört, andernfalls „false“.

Hinweis: Ausgewählte Punkte werden mit der ausgewählten Farbe gezeichnet, sofern diese angegeben wurde.

Diese Funktion wurde in Qt 6.2 eingeführt.

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

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

Ruft das Bild ab, das zum Zeichnen von Markierungen an jedem Punkt der Reihe verwendet wird.

Der Standardwert ist QImage(), was bedeutet, dass keine hellen Markierungen gezeichnet werden.

Die hellen Markierungen visualisieren die Datenpunkte dieser Reihe und stellen somit eine Alternative zu „ setPointsVisible “ (true) dar. Beide Funktionen können unabhängig voneinander aktiviert werden.

Im Gegensatz zu den Elementen von „ QScatterSeries “ werden die hellen Markierungen nicht durch „ QGraphicsItem “ dargestellt, sondern lediglich gezeichnet (es werden keine Objekte erstellt). Die Mausereignissignale von „ QXYSeries “ verhalten sich jedoch genauso, d. h., du erhältst den exakten Domänenwert des Punktes, wenn du auf die helle Markierung klickst, sie drückst oder mit der Maus darüber fährst. Wenn Sie auf die Linie klicken, erhalten Sie weiterhin den dazwischenliegenden Domänenwert. Die hellen Markierungen befinden sich sowohl hinsichtlich der Darstellung als auch der Ereignisse oberhalb 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 ausgelöst, wenn sich das Bild des Lichtmarkers in „ lightMarker “ ändert.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch ` QXYSeries::setLightMarker()`.

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

Ruft die Größe des Markers ab, der zum Darstellen der Punkte in der Reihe verwendet wird.

Die Standardgröße hängt vom jeweiligen Typ der „ QXYSeries “ ab. Bei „QScatterSeries“ beträgt der Standardwert 15,0, bei „QLineSeries“ der Standardwert der Stiftgröße der Serie multipliziert mit 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 ausgelöst, wenn sich die Markergröße auf „ size “ ändert.

QPen QXYSeries::pen() const

Gibt den Stift zurück, mit dem die Umrisse der Datenpunkte der Reihe gezeichnet wurden.

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 ausgelöst, wenn an der durch index angegebenen Position ein Punkt hinzugefügt wird.

Siehe auch append() und insert().

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

Gibt ein Map zurück, das die Konfiguration eines Punktes unter index darstellt.

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

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointConfiguration().

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

Dieses Signal wird ausgelöst, wenn sich die Beschneidung der Datenpunktbeschriftungen auf „ clipping “ ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft „ pointLabelsClipping “.

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

Dieses Signal wird ausgelöst, wenn sich die für Datenpunktbeschriftungen verwendete Farbe auf „ color “ ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ pointLabelsColor “.

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

Dieses Signal wird ausgelöst, wenn sich die für Datenpunktbeschriftungen verwendete Schriftart auf „ font “ ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ pointLabelsFont “.

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

Dieses Signal wird ausgelöst, wenn sich das Format der Datenpunktbezeichnungen auf „ format “ ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft „ pointLabelsFormat “.

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

Dieses Signal wird ausgelöst, wenn sich die Sichtbarkeit der Datenpunktbeschriftungen auf „ visible “ ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ pointLabelsVisible “.

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

Dieses Signal wird ausgelöst, wenn ein Punkt aus der durch ` index` angegebenen Position entfernt wird.

Siehe auch remove().

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

Dieses Signal wird ausgelöst, wenn ein Punkt an der durch ` index` angegebenen Position ersetzt wird.

Siehe auch replace().

QList<QPointF> QXYSeries::points() const

Gibt die Punkte der Reihe zurück.

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

Gibt ein Map zurück, bei dem die Indizes der Punkte als Schlüssel und deren Konfiguration als Werte dienen.

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 ausgelöst, wenn die durch count angegebene Anzahl von Punkten beginnend an der durch index angegebenen Position entfernt wird.

Siehe auch removePoints() und clear().

[signal] void QXYSeries::pointsReplaced()

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

Siehe auch replace().

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

Dieses Signal wird ausgelöst, wenn der Benutzer im Diagramm auf den Datenpunkt point klickt und die Maustaste gedrückt hält.

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

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

Dieses Signal wird ausgelöst, wenn der Benutzer den Mausklick auf den durch point angegebenen Datenpunkt löst.

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 Datenpunkt 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.

Hinweis: Dies ist wesentlich schneller, als die Datenpunkte einzeln zu ersetzen oder zunächst alle Daten zu löschen und anschließend die neuen Daten anzuhängen. Löst „ QXYSeries::pointsReplaced()“ aus, sobald die Punkte ersetzt wurden.

Siehe auch pointsReplaced().

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

Ersetzt den unter oldPoint angegebenen Punkt durch den unter 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 keine Aktion aus, wenn der alte Punkt nicht existiert.

Siehe auch pointReplaced().

[since 6.2] void QXYSeries::selectAllPoints()

Markiert alle Punkte der Reihe als ausgewählt,

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setPointSelected().

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

Markiert „ 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 Punkte, die in einer „ indexes “-Liste überflogen wurden, als ausgewählt.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch ` setPointSelected()`.

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

Dieses Signal wird ausgelöst, wenn sich die Farbe der ausgewählten Punkte zu „ color “ ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ selectedColor “.

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

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

Der Standardwert ist QImage(), was bedeutet, dass die üblichen „ lightMarker “ () gezeichnet werden.

Dies entspricht ` selectedColor `, wenn Sie helle Markierungen anstelle von normalen Punkten bevorzugen, aber dennoch ausgewählte Punkte hervorheben möchten.

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 der Indizes der als ausgewählt markierten Punkte zurück. 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 Auswahl der Punkte ändert.

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

Legt den Pinsel fest, der zum Zeichnen von Punkten im Diagramm verwendet wird, auf „ brush “. Wenn kein Pinsel definiert ist, wird der Pinsel aus den Diagramm-Design-Einstellungen verwendet.

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

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

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

Der Standardwert ist ein `default-QImage()` (`QImage::isNull()` == `true`), was bedeutet, dass keine hellen Markierungen gezeichnet werden. Sie können den Standardwert (deaktiviert) wiederherstellen, indem Sie diese Funktion mit einem Null- QImage en (`QImage()`) aufrufen.

Die Lichtmarker visualisieren die Datenpunkte dieser Reihe und stellen somit eine Alternative zu ` setPointsVisible(true)` dar. Wird mit dieser Methode ein Lichtmarker gesetzt, werden die mit ` setPointsVisible(true) ` festgelegten sichtbaren Punkte nicht angezeigt.

Im Gegensatz zu den Elementen von QScatterSeries werden die Leuchtmarkierungen nicht durch QGraphicsItem dargestellt, sondern lediglich gezeichnet (es werden keine Objekte erstellt). Die Mausereignissignale von QXYSeries verhalten sich jedoch genauso, d. h., Sie erhalten den genauen Domänenwert des Punktes, wenn Sie auf die Leuchtmarkierung klicken, sie drücken oder mit der Maus darüberfahren. Wenn Sie auf die Linie klicken, erhalten Sie weiterhin den dazwischenliegenden Domänenwert. Die hellen Markierungen befinden sich sowohl hinsichtlich der Darstellung als auch der 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 “ des Markers fest, der zum Darstellen der Punkte in der Reihe verwendet wird.

Die Standardgröße beträgt 15,0.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch „ QScatterSeries::markerSize “.

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

Legt den Stift fest, der zum Zeichnen von Punkten im Diagramm verwendet wird, auf „ pen “. Ist kein Stift definiert, 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 Erscheinungsbilds eines Punktes unter index mit der gewünschten configuration.

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

Die Konfiguration eines Punktes wird als Hash-Map mit den Schlüsseln „ QXYSeries::pointConfiguration “ und den Werten „ QVariant “ dargestellt. Zum 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 eine standardmäßige QLineSeries mit 10 Punkten, bei der die Konfiguration von zwei Punkten geändert wurde. Beide geänderten Punkte sind sichtbar größer als die anderen und weisen ein Aussehen auf, das sich aus der Serienkonfiguration ableitet. Standardmäßig haben Punkte keine Beschriftungen, aber der Punkt am Index 4 verfügt dank der Konfigurationswerte „ QXYSeries::PointConfiguration::LabelVisibility “ und „ QXYSeries::PointConfiguration::LabelFormat “ über eine Beschriftung. Der Punkt am Index 6 hat dank des Konfigurationswerts „ QXYSeries::PointConfiguration::LabelFormat “ die benutzerdefinierte Beschriftung „This Point “. Nachfolgend sehen Sie ein Beispiel für ein auf diese Weise erstelltes Diagramm:

Screenshot, der ein Liniendiagramm mit zwei Punkten zeigt, von denen einer rot und der andere blau ist

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 die Anpassung eines bestimmten Aspekts der Konfiguration eines Punktes.

Hinweis: Das Konzeptder Punktkonfiguration bietet eine flexible Möglichkeit, verschiedene Aspekte des Erscheinungsbilds eines Punktes zu konfigurieren. Daher müssen die Werte einen elastischen Typ haben, wie z. B. „ QVariant “. Unter QXYSeries::PointConfiguration erfahren Sie, welche „ value “-Werte für bestimmte „ key “-Werte übergeben werden sollten.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch pointsConfiguration().

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

Markiert Punkte an der angegebenen Adresse index entweder als ausgewählt oder als nicht ausgewählt, wie unter selected angegeben.

Hinweis: Ausgewählte Punkte werden mit der ausgewählten Farbe gezeichnet, sofern diese angegeben wurde. Sendet QXYSeries::selectedPointsChanged

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 die Anpassung der Konfiguration mehrerer Punkte gemäß der Beschreibung unter pointsConfiguration.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch pointsConfiguration().

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

Legt das Bild fest, das zum Zeichnen von Markern auf den Punkten der ausgewählten Reihe verwendet wird: selectedLightMarker.

Der Standardwert ist „QImage()“, was bedeutet, dass die üblichen „ lightMarker()“ gezeichnet werden.

Dies ist eine Alternative zu „ selectedColor “, wenn Sie helle Markierungen anstelle von normalen Punkten bevorzugen, aber dennoch ausgewählte Punkte hervorheben möchten.

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 aus sourceData werden sortiert und einer Punktgröße zugeordnet, die zwischen minSize und maxSize liegt.

Hinweis: Ist die Länge von sourceData kleiner als die Anzahl der Punkte in der Reihe, bleibt die Größe der Punkte am Ende der Reihe unverändert.

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 Auswahlstatus der Punkte unter der angegebenen Koordinaten indexes, in den entgegengesetzten. Bewirkt

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 zur Reihe.

Siehe auch ` append()`.

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

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

Siehe auch append().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.