QCustomSeries Class
La classe QCustomSeries permet de présenter des types de graphiques personnalisés. Plus d'informations...
| 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 |
| Dans QML : | CustomSeries |
| Hérites : | 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 | 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 graphique de dispersion qui vous permet d'accéder à des données personnalisées pour chaque élément.
QCustomSeries définit un délégué qui est utilisé pour rendre 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 à la carte de données. La série transmet cette carte à chaque élément créé sur la base du délégué. Le délégué détermine comment utiliser les données.
Pour mapper les données aux coordonnées de rendu définies par les axes 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 mettre en œuvre une série de lignes personnalisées.
Documentation sur les propriétés
delegate : QQmlComponent*
Le délégué est utilisé pour insérer dans QML des éléments correspondant aux données personnalisées fournies. Les données sont définies dans le site CustomSeries lui-même et transmises aux éléments délégués par l'intermédiaire de la propriété "data".
Fonctions d'accès :
| QQmlComponent * | delegate() const |
| void | setDelegate(QQmlComponent *newDelegate) |
Signal Notifier :
| void | delegateChanged() |
Member Function Documentation
[invokable] void QCustomSeries::append()
Ajoute un élément de données vide à la série.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de 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.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[slot] void QCustomSeries::clear()
Efface tous les éléments de 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 invoquée via le système de méta-objets et à partir de 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.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] qreal QCustomSeries::mapX(qreal x)
Renvoie x les coordonnées de l'espace-axe converties dans l'espace de rendu.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] qreal QCustomSeries::mapY(qreal y)
Renvoie y les coordonnées de l'espace-axe converties dans l'espace de rendu.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QCustomSeries::remove(qsizetype index)
Supprime un élément de données à la position index.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[virtual protected] void QCustomSeries::updateDelegate(QQuickItem *item, qsizetype index)
Appelé par le moteur de rendu du graphique pour donner accès à item représentant les données et à index correspondant à l'élément de données.
Surcharge pour implémenter des valeurs de propriété personnalisées pour l'instance ou les instances 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.
