QCustomSeries Class

Die Klasse „QCustomSeries“ ermöglicht die Darstellung benutzerdefinierter Diagrammtypen. Mehr...

Kopfzeile:	`#include <QCustomSeries>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS Graphs)` `target_link_libraries(mytarget PRIVATE Qt6::Graphs)`
qmake:	`QT += graphs`
Seit:	Qt 6.11
In QML:	CustomSeries
Erbt von:	QAbstractSeries

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

delegate : QQmlComponent*

Öffentliche Funktionen

void	append()
void	append(const QVariantMap &data)
QQmlComponent *	delegate() const
void	insert(qsizetype index)
void	insert(qsizetype index, const QVariantMap &data)
qreal	mapX(qreal x)
qreal	mapY(qreal y)
void	remove(qsizetype index)
void	setCustomSeriesPainter(QCustomSeriesCanvasRenderer *painter)
void	setDelegate(QQmlComponent *newDelegate)

Öffentliche Slots

void	clear()

Signale

void	delegateChanged()

Geschützte Funktionen

virtual void updateDelegate(QQuickItem *item, qsizetype index)

Ausführliche Beschreibung

Verwenden Sie QCustomSeries, um benutzerdefinierte Diagramme zu erstellen. Stellen Sie sich dies als ein Streudiagramm vor, mit dem Sie auf benutzerdefinierte Daten für jedes Element zugreifen können.

QCustomSeries definiert einen Delegaten, der zum Rendern jedes zum Diagramm hinzugefügten Elements verwendet wird. Jedes Element enthält benutzerdefinierte Daten, die in einer „ QVariantMap “ gespeichert sind. Der Index des Elements im Diagramm wird ebenfalls automatisch zur Datenzuordnung hinzugefügt. Die Serie übergibt diese Zuordnung an jedes Element, das auf der Grundlage des Delegaten erstellt wird. Der Delegat legt fest, wie die Daten verwendet werden.

Um Daten den durch die Achsen von „ QGraphsView “ definierten Darstellungskoordinaten zuzuordnen, verwenden Sie die Funktionen „ mapX “ und „ mapY “.

Hinweis: Derzeit tauschen einzelne Elemente einer benutzerdefinierten Reihe keine Informationen untereinander aus. Aus diesem Grund können Sie keine benutzerdefinierte Linienreihe implementieren.

Dokumentation zu den Eigenschaften

delegate : QQmlComponent*

Der Delegat dient dazu, Elemente entsprechend den bereitgestellten benutzerdefinierten Daten in QML einzufügen. Die Daten werden im „ CustomSeries “ selbst definiert und über die Eigenschaft „data“ an die delegierten Elemente übergeben.

Zugriffsfunktionen:

QQmlComponent *	delegate() const
void	setDelegate(QQmlComponent *newDelegate)

Notifier-Signal:

void	delegateChanged()

Dokumentation der Mitgliedsfunktionen

`[invokable]` void QCustomSeries::append()

Fügt der Reihe ein leeres Datenelement an.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

`[invokable]` void QCustomSeries::append(const QVariantMap &data)

Fügt der Reihe ein Datenelement hinzu, das durch data definiert ist.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

`[slot]` void QCustomSeries::clear()

Alle Datenelemente löschen.

`[invokable]` void QCustomSeries::insert(qsizetype index)

Fügt der Reihe an der Position index ein leeres Datenelement an.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

`[invokable]` void QCustomSeries::insert(qsizetype index, const QVariantMap &data)

Fügt der Reihe an der Position index ein Datenelement hinzu, das durch data definiert ist.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

`[invokable]` qreal QCustomSeries::mapX(qreal x)

Gibt eine in den Render-Raum umgerechnete Koordinate aus dem x -Achsenraum zurück.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

`[invokable]` qreal QCustomSeries::mapY(qreal y)

Gibt eine in den Render-Raum umgewandelte Koordinate aus dem Achsen-Raum ( y ) zurück.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

`[invokable]` void QCustomSeries::remove(qsizetype index)

Ein Datenelement an der Position „ index “ entfernen.

Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

void QCustomSeries::setCustomSeriesPainter(QCustomSeriesCanvasRenderer **painter*)

Legt „ painter “ als Canvas-Painter-Renderer fest, der zum Zeichnen dieser Serie verwendet wird, wenn das leistungsstarke Canvas-Painter-Backend im Einsatz ist.

QCustomSeries Übernimmt die Eigentümerschaft an ` painter`. Es wird beim nächsten Synchronisieren dieser Serie vom CanvasPainter-Backend-Renderer übernommen und danach ausschließlich vom Renderer im Render-Thread zerstört – niemals direkt von ` QCustomSeries `. Wird ` painter ` vor dieser ersten Synchronisierung ersetzt oder gelöscht oder wird diese Serie zuvor zerstört, löscht ` QCustomSeries ` sie selbst.

`[virtual protected]` void QCustomSeries::updateDelegate(QQuickItem **item, qsizetype index*)

Wird vom Grafik-Renderer aufgerufen, um Zugriff auf die „ item “, die die Daten repräsentiert, und die „ index “, die dem Datenelement entspricht, zu gewähren.

Überschreiben Sie diese Methode, um benutzerdefinierte Eigenschaftswerte für eine oder mehrere Instanzen von ` QQuickItem ` zu implementieren.

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