QScatter3DSeries Class
La classe QScatter3DSeries représente une série de données dans un nuage de points en 3D. En savoir plus...
| En-tête : | #include <QScatter3DSeries> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake : | QT += datavisualization |
| Depuis : | QtDataVisualization 1.0 |
| En QML : | Scatter3DSeries |
| Hérite de : | QAbstract3DSeries |
| Statut : | Obsolète |
Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Propriétés
- dataProxy : QScatterDataProxy*
- itemSize : float
- selectedItem : int
Fonctions publiques
| QScatter3DSeries(QObject *parent = nullptr) | |
| QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QScatter3DSeries() |
| QScatterDataProxy * | dataProxy() const |
| float | itemSize() const |
| int | selectedItem() const |
| void | setDataProxy(QScatterDataProxy *proxy) |
| void | setItemSize(float size) |
| void | setSelectedItem(int index) |
Signaux
| void | dataProxyChanged(QScatterDataProxy *proxy) |
| void | itemSizeChanged(float size) |
| void | selectedItemChanged(int index) |
Membres publics statiques
| int | invalidSelectionIndex() |
Description détaillée
Cette classe gère les éléments visuels spécifiques à la série, ainsi que les données de la série (via un proxy de données).
Si aucun proxy de données n’est explicitement défini pour la série, celle-ci crée un proxy par défaut. La définition d’un autre proxy détruira le proxy existant ainsi que toutes les données qui y ont été ajoutées.
QScatter3DSeries prend en charge les balises de format suivantes pour la méthode ` QAbstract3DSeries::setItemLabelFormat()` :
| @xTitle | Titre de l’axe x |
| @yTitle | Titre de l'axe y |
| @zTitle | Titre de l'axe z |
| @xLabel | Valeur de l'élément mise en forme selon le format de l'axe des x. Pour plus d'informations, consultez QValue3DAxis::setLabelFormat(). |
| @yLabel | Valeur de l'élément mise en forme selon le format de l'axe y. Pour plus d'informations, consultez QValue3DAxis::setLabelFormat(). |
| @zLabel | Valeur de l'élément mise en forme selon le format de l'axe z. Pour plus d'informations, consultez QValue3DAxis::setLabelFormat(). |
| @seriesName | Nom de la série |
Par exemple :
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));Voir également «Gestion des données »sur Qt Data Visualization .
Documentation sur les propriétés
dataProxy : QScatterDataProxy*
Cette propriété contient le proxy de données actif.
Fonctions d'accès :
| QScatterDataProxy * | dataProxy() const |
| void | setDataProxy(QScatterDataProxy *proxy) |
Signal de notification :
| void | dataProxyChanged(QScatterDataProxy *proxy) |
itemSize : float
Taille des éléments de la série.
La taille doit être comprise entre 0.0f et 1.0f. Si vous définissez la taille sur 0.0f, la taille des éléments sera automatiquement mise à l'échelle en fonction du nombre total d'éléments de toutes les séries du graphique.
La valeur par défaut est 0.0f.
Fonctions d’accès :
| float | itemSize() const |
| void | setItemSize(float size) |
Signal de notification :
| void | itemSizeChanged(float size) |
selectedItem : int
Cette propriété contient l'élément sélectionné dans la série.
Fonctions d'accès :
| int | selectedItem() const |
| void | setSelectedItem(int index) |
Signal de notification :
| void | selectedItemChanged(int index) |
Documentation des fonctions membres
[explicit] QScatter3DSeries::QScatter3DSeries(QObject *parent = nullptr)
Crée une série de nuages de points en 3D dont l’élément parent est parent.
[explicit] QScatter3DSeries::QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr)
Crée une série de nuages de points en 3D à partir du proxy de données dataProxy et du parent parent.
[virtual noexcept] QScatter3DSeries::~QScatter3DSeries()
Supprime la série de données 3D de type « scatter ».
[static] int QScatter3DSeries::invalidSelectionIndex()
Renvoie un index non valide pour la sélection. Cet index est attribué à la propriété selectedItem afin d'effacer la sélection de cette série.
Voir également QAbstract3DGraph::clearSelection().
void QScatter3DSeries::setDataProxy(QScatterDataProxy *proxy)
Définit le proxy de données actif de la série sur proxy. La série prend en charge tout proxy qui lui est attribué et supprime tout proxy précédemment défini lorsqu’un nouveau proxy est ajouté. L’argument proxy ne peut être ni nul ni défini sur une autre série.
Remarque : fonctionde définition de la propriété dataProxy.
Voir aussi ` dataProxy()`.
void QScatter3DSeries::setSelectedItem(int index)
Sélectionne l'élément situé à l'index index dans le tableau de données de la série. Un seul élément peut être sélectionné à la fois.
Pour effacer la sélection de cette série, la fonction invalidSelectionIndex() est définie comme suit : index. Si cette série est ajoutée à un graphique, celui-ci peut ajuster la sélection en fonction de l'interaction de l'utilisateur ou si celle-ci devient invalide. La sélection d'un élément sur une autre série ajoutée effacera également la sélection.
La suppression d’éléments de la série ou l’insertion d’éléments avant l’élément sélectionné ajustera la sélection de manière à ce que ce même élément reste sélectionné.
Remarque : fonctionde définition pour la propriété selectedItem.
Voir également selectedItem() et QAbstract3DGraph::clearSelection().
© 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.
