QCustomSeries Class
La classe QCustomSeries permet d'afficher des types de graphiques personnalisés. En savoir plus...
| En-tête : | #include <QCustomSeries> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake : | QT += graphs |
| Depuis : | Qt 6.11 |
| En QML : | CustomSeries |
| Hérite de : | QAbstractSeries |
Propriétés
- delegate : QQmlComponent*
Fonctions publiques
| 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) |
Emplacements publics
| void | clear() |
Signaux
| void | delegateChanged() |
Fonctions protégées
| virtual void | updateDelegate(QQuickItem *item, qsizetype index) |
Description détaillée
Utilisez QCustomSeries pour créer des graphiques personnalisés. Considérez-le comme un nuage de points qui vous permet d’accéder à des données personnalisées pour chaque élément.
QCustomSeries définit un délégué utilisé pour afficher chaque élément ajouté au graphique. Chaque élément comprend des données définies par l’utilisateur et stockées dans une carte de données ( QVariantMap). L’index de l’élément dans le graphique est également ajouté automatiquement à cette carte. La série transmet cette carte à chaque élément créé à partir du délégué. Le délégué détermine comment utiliser ces données.
Pour mapper les données aux coordonnées de rendu définies par les axes de l’ QGraphsView, utilisez les fonctions ` mapX ` et ` mapY `.
Remarque : Actuellement , les éléments individuels d’une série personnalisée ne partagent pas d’informations entre eux. Pour cette raison, vous ne pouvez pas implémenter de série de lignes personnalisée.
Documentation sur les propriétés
delegate : QQmlComponent*
Le délégué sert à insérer dans le code QML des éléments correspondant aux données personnalisées fournies. Ces données sont définies dans l'CustomSeries e lui-même et transmises aux éléments délégués via la propriété « data ».
Fonctions d'accès :
| QQmlComponent * | delegate() const |
| void | setDelegate(QQmlComponent *newDelegate) |
Signal de notification :
| void | delegateChanged() |
Documentation des fonctions membres
[invokable] void QCustomSeries::append()
Ajoute un élément de données vide à la série.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QCustomSeries::append(const QVariantMap &data)
Ajoute à la série un élément de données défini par data.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[slot] void QCustomSeries::clear()
Effacer toutes les données.
[invokable] void QCustomSeries::insert(qsizetype index)
Ajoute un élément de données vide à la série à la position index.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QCustomSeries::insert(qsizetype index, const QVariantMap &data)
Ajoute un élément de données défini par data à la série à la position index.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] qreal QCustomSeries::mapX(qreal x)
Renvoie la coordonnée de l'espace d'axe x convertie en coordonnée de l'espace de rendu.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] qreal QCustomSeries::mapY(qreal y)
Renvoie la coordonnée de l'espace d'axe y convertie en coordonnée de l'espace de rendu.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QCustomSeries::remove(qsizetype index)
Supprime un élément de données situé à la position index.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
void QCustomSeries::setCustomSeriesPainter(QCustomSeriesCanvasRenderer *painter)
Définit ` painter ` comme moteur de rendu « canvas painter » utilisé pour dessiner cette série lorsque le backend « canvas painter » haute performance est activé.
QCustomSeries Prend possession de ` painter`. Il est adopté par le moteur de rendu `CanvasPainter-backend` lors de la prochaine synchronisation de cette série, après quoi il n’est détruit que par le moteur de rendu, sur le thread de rendu – jamais directement par ` QCustomSeries `. Si ` painter ` est remplacé ou effacé avant cette première synchronisation, ou si cette série est détruite avant celle-ci, ` QCustomSeries ` le supprime lui-même.
[virtual protected] void QCustomSeries::updateDelegate(QQuickItem *item, qsizetype index)
Appelée par le moteur de rendu graphique pour donner accès à l’ item représentant les données, ainsi qu’à l’ index correspondant à l’élément de données.
À redéfinir pour implémenter des valeurs de propriété personnalisées pour les instances d’ QQuickItem.
© 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.
