QScatter3DSeries Class
La classe QScatter3DSeries représente une série de données dans un graphique de dispersion 3D. Plus d'informations...
| 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érites : | QAbstract3DSeries |
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 défini explicitement 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 et toutes les données qui y ont été ajoutées.
QScatter3DSeries prend en charge les balises de format suivantes pour QAbstract3DSeries::setItemLabelFormat() :
| @xTitle | Titre de l'axe des x |
| @yTitle | Titre de l'axe des y |
| @zTitle | Titre de l'axe des z |
| @xLabel | Valeur de l'élément formatée selon le format de l'axe des x. Pour plus d'informations, voir QValue3DAxis::setLabelFormat(). |
| @yLabel | Valeur de l'élément formatée selon le format de l'axe des y. Pour plus d'informations, voir QValue3DAxis::setLabelFormat(). |
| @zLabel | Valeur de l'élément formatée en utilisant le format de l'axe des z. Pour plus d'informations, voir QValue3DAxis::setLabelFormat(). |
| @seriesName | Nom de la série |
Par exemple, le nom de la série :
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
Voir également Qt Data Visualization Data Handling.
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 du notificateur :
| void | dataProxyChanged(QScatterDataProxy *proxy) |
itemSize : float
Taille de l'article pour la série.
La taille doit être comprise entre 0.0f et 1.0f. Si la taille est fixée à 0.0f, la taille de l'élément est automatiquement mise à l'échelle en fonction du nombre total d'éléments dans 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) |
Member Function Documentation
[explicit] QScatter3DSeries::QScatter3DSeries(QObject *parent = nullptr)
Construit une série 3D de dispersion avec le parent parent.
[explicit] QScatter3DSeries::QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr)
Construit une série 3D de dispersion avec le proxy de données dataProxy et le parent parent.
[virtual noexcept] QScatter3DSeries::~QScatter3DSeries()
Supprime la série de scatter 3D.
[static] int QScatter3DSeries::invalidSelectionIndex()
Renvoie un index invalide pour la sélection. Cet indice est défini dans la propriété selectedItem pour effacer la sélection de cette série.
Voir aussi QAbstract3DGraph::clearSelection().
void QScatter3DSeries::setDataProxy(QScatterDataProxy *proxy)
Définit le proxy de données actif pour la série à proxy. La série assume la propriété de 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 pas être nul ni correspondre à une autre série.
Note : Fonction de définition de la propriété dataProxy.
Voir également dataProxy().
void QScatter3DSeries::setSelectedItem(int index)
Sélectionne l'élément à 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, invalidSelectionIndex() est défini comme 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 elle devient invalide. La sélection d'un élément dans 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 dans la série avant l'élément sélectionné ajustera la sélection de manière à ce que le même élément reste sélectionné.
Remarque : fonction de définition de 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.
