QCustomSeries Class
Die Klasse QCustomSeries ermöglicht die Darstellung angepasster 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 |
| Vererbt: | QAbstractSeries |
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 | setDelegate(QQmlComponent *newDelegate) |
Öffentliche Slots
| void | clear() |
Signale
| void | delegateChanged() |
Geschützte Funktionen
| virtual void | updateDelegate(QQuickItem *item, qsizetype index) |
Detaillierte Beschreibung
Verwenden Sie QCustomSeries, um benutzerdefinierte Diagramme zu erstellen. Stellen Sie es sich als ein Streudiagramm vor, mit dem Sie auf benutzerdefinierte Daten für jedes Element zugreifen können.
QCustomSeries definiert einen Delegaten, der verwendet wird, um jedes dem Diagramm hinzugefügte Element zu rendern. Jedes Element enthält benutzerdefinierte Daten, die in einer QVariantMap gespeichert sind. Der Index des Elements im Diagramm wird auch automatisch zur Datenkarte hinzugefügt. Die Serie übergibt diese Karte an jedes Element, das auf der Grundlage des Delegaten erstellt wird. Der Delegat bestimmt, wie die Daten zu verwenden sind.
Um Daten den durch die Achsen von QGraphsView definierten Render-Koordinaten zuzuordnen, verwenden Sie die Funktionen mapX und mapY.
Hinweis: Derzeit tauschen einzelne Elemente in einer benutzerdefinierten Serie keine Informationen untereinander aus. Aus diesem Grund können Sie keine benutzerdefinierten Linienreihen implementieren.
Dokumentation der Eigenschaft
delegate : QQmlComponent*
Der Delegat wird verwendet, um Elemente in QML einzufügen, die den bereitgestellten benutzerdefinierten Daten entsprechen. Die Daten werden in CustomSeries selbst definiert und den delegierten Elementen über die Eigenschaft "data" übergeben.
Zugriffsfunktionen:
| QQmlComponent * | delegate() const |
| void | setDelegate(QQmlComponent *newDelegate) |
Benachrichtigungssignal:
| void | delegateChanged() |
Member Function Dokumentation
[invokable] void QCustomSeries::append()
Hängt ein leeres Datenelement an die Serie an.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QCustomSeries::append(const QVariantMap &data)
Hängt ein durch data definiertes Datenelement an die Serie an.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[slot] void QCustomSeries::clear()
Löschen Sie alle Datenelemente.
[invokable] void QCustomSeries::insert(qsizetype index)
Fügt ein leeres Datenelement an der Position index an die Serie an.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QCustomSeries::insert(qsizetype index, const QVariantMap &data)
Fügt ein durch data definiertes Datenelement an der Position index an die Serie an.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] qreal QCustomSeries::mapX(qreal x)
Liefert x Achsen-Raum-Koordinate umgerechnet in Render-Raum.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] qreal QCustomSeries::mapY(qreal y)
Liefert y Achsen-Raum-Koordinate umgerechnet in Render-Raum.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QCustomSeries::remove(qsizetype index)
Entfernt ein Datenelement an der Position index.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[virtual protected] void QCustomSeries::updateDelegate(QQuickItem *item, qsizetype index)
Wird vom Diagramm-Renderer aufgerufen, um den Zugriff auf die item, die die Daten repräsentiert, und die index, die dem Datenelement entspricht, zu ermöglichen.
Überschreiben, um benutzerdefinierte Eigenschaftswerte für QQuickItem Instanz(en) 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.
