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 Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake : | QT += graphs |
| En QML : | Scatter3DSeries |
| Hérite de : | QAbstract3DSeries |
| Hérédité : |
- Liste de tous les membres, y compris les membres hérités
- QScatter3DSeries fait partie des classes C++ d'Qt Graphs pour la 3D.
Propriétés
|
Fonctions publiques
| QScatter3DSeries(QObject *parent = nullptr) | |
| QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QScatter3DSeries() override |
| QValue3DAxis * | axisX() const |
| QValue3DAxis * | axisY() const |
| QValue3DAxis * | axisZ() const |
| void | clearArray() |
| void | clearScaleArray() |
| const QScatterDataArray & | dataArray() const & |
| QScatterDataArray | dataArray() && |
| QScatterDataProxy * | dataProxy() const |
| float | itemSize() const |
| void | resetAxisX() |
| void | resetAxisY() |
| void | resetAxisZ() |
| const QList<QVector3D> & | scaleArray() const & |
| QList<QVector3D> | scaleArray() && |
| qsizetype | selectedItem() const |
| void | setAxisX(QValue3DAxis *axis) |
| void | setAxisY(QValue3DAxis *axis) |
| void | setAxisZ(QValue3DAxis *axis) |
| void | setDataArray(const QScatterDataArray &newDataArray) |
| void | setDataProxy(QScatterDataProxy *proxy) |
| void | setItemSize(float size) |
| void | setScaleArray(const QList<QVector3D> &newScaleArray) |
| void | setSelectedItem(qsizetype index) |
Signaux
| void | axisXChanged(QValue3DAxis *axis) |
| void | axisYChanged(QValue3DAxis *axis) |
| void | axisZChanged(QValue3DAxis *axis) |
| void | dataArrayChanged(const QScatterDataArray &array) |
| void | dataProxyChanged(QScatterDataProxy *proxy) |
| void | itemSizeChanged(float size) |
| void | scaleArrayChanged(const QList<QVector3D> &scaleArray) |
| void | selectedItemChanged(qsizetype index) |
Membres publics statiques
| qsizetype | 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).
En ce qui concerne la relation entre le proxy et la série, il est essentiel de souligner quelques points clés. Dans ce contexte, les données sont stockées dans des séries et les utilisateurs peuvent accéder à l'ensemble de données via ces séries. Ces séries sont contrôlées ou représentées par un objet proxy. Ainsi, le proxy peut être utilisé pour gérer diverses opérations sur les données et mettre à jour l'ensemble de données réel. Cependant, il est nécessaire de créer une série associée à ce proxy pour modifier l'ensemble 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 ajoutées à la série.
QScatter3DSeries prend en charge les balises de format suivantes pour la fonction ` QAbstract3DSeries::setItemLabelFormat()` :
| @xTitle | Titre de l’axe des x |
| @yTitle | Titre de l'axe y |
| @zTitle | Titre de l'axe z |
| @xLabel | Valeur de l'élément formatée selon le format de l'axe x. Pour plus d'informations, consultez QValue3DAxis::labelFormat. |
| @yLabel | Valeur de l'élément mise en forme selon le format de l'axe y. Pour plus d'informations, consultez QValue3DAxis::labelFormat. |
| @zLabel | Valeur de l'élément formatée selon le format de l'axe z. Pour plus d'informations, consultez QValue3DAxis::labelFormat. |
| @seriesName | Nom de la série |
Par exemple :
proxy->setItemLabelFormat(QStringLiteral("@yTitle for (@xLabel, @zLabel): %.1f"));Voir également Qt Graphs Traitement des données en 3D.
Documentation sur les propriétés
[since 6.11] axisX : QValue3DAxis*
Prend en charge un axe X supplémentaire pour la série. Si un axe est spécifié, la série sera ajustée aux valeurs minimale et maximale de cet axe.
Cette énumération a été introduite dans Qt 6.11.
Fonctions d'accès :
| QValue3DAxis * | axisX() const |
| void | setAxisX(QValue3DAxis *axis) |
| void | resetAxisX() |
Signal de notification :
| void | axisXChanged(QValue3DAxis *axis) |
[since 6.11] axisY : QValue3DAxis*
Définit un axe Y supplémentaire pour la série. Si un axe est spécifié, la série sera ajustée aux valeurs minimale et maximale de cet axe.
Cette énumération a été introduite dans Qt 6.11.
Fonctions d'accès :
| QValue3DAxis * | axisY() const |
| void | setAxisY(QValue3DAxis *axis) |
| void | resetAxisY() |
Signal de notification :
| void | axisYChanged(QValue3DAxis *axis) |
[since 6.11] axisZ : QValue3DAxis*
Prend en charge un axe Z supplémentaire pour la série. Si un axe est spécifié, la série sera ajustée aux valeurs minimale et maximale de cet axe.
Cette énumération a été introduite dans Qt 6.11.
Fonctions d'accès :
| QValue3DAxis * | axisZ() const |
| void | setAxisZ(QValue3DAxis *axis) |
| void | resetAxisZ() |
Signal de notification :
| void | axisZChanged(QValue3DAxis *axis) |
dataArray : QScatterDataArray
Tableau de données pour la série.
Contient la référence au tableau de données.
Le signal `dataArrayChanged` est émis lorsque le tableau de données est défini, sauf si ` newDataArray ` est identique au précédent.
Remarque : avant toute opération sur le tableau de données, une série doit être créée pour le proxy concerné.
Fonctions d'accès :
| const QScatterDataArray & | dataArray() const & |
| QScatterDataArray | dataArray() && |
| void | setDataArray(const QScatterDataArray &newDataArray) |
Signal de notification :
| void | dataArrayChanged(const QScatterDataArray &array) |
Voir également ` clearArray()` ().
dataProxy : QScatterDataProxy*
Cette propriété contient le proxy de données actif.
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 pas être nul ni définir une autre série.
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) |
scaleArray : QList<QVector3D>
Tableau d'échelles pour la série.
Contient la référence au tableau d'échelle.
Le signal `scaleArrayChanged` est émis lorsque le tableau d'échelle est défini, sauf si ` newScaleArray ` est identique au précédent.
Remarque : avant toute opération sur le tableau de mise à l'échelle, une série doit être créée pour le proxy concerné.
Remarque : si aucune échelle n’est spécifiée pour les données, la valeur par défaut (1,0 ; 1,0 ; 1,0) sera utilisée.
Fonctions d’accès :
| const QList<QVector3D> & | scaleArray() const & |
| QList<QVector3D> | scaleArray() && |
| void | setScaleArray(const QList<QVector3D> &newScaleArray) |
Signal de notification :
| void | scaleArrayChanged(const QList<QVector3D> &scaleArray) |
Voir également ` clearScaleArray()`.
selectedItem : qsizetype
Cette propriété contient l'élément sélectionné dans la série.
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 méthode invalidSelectionIndex() est définie sur index. Si cette série est ajoutée à un graphique, celui-ci peut ajuster la sélection en fonction des interactions 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é.
Fonctions d'accès :
| qsizetype | selectedItem() const |
| void | setSelectedItem(qsizetype index) |
Signal de notification :
| void | selectedItemChanged(qsizetype index) |
Voir également Q3DGraphsWidgetItem::clearSelection().
Documentation des fonctions membres
[explicit] QScatter3DSeries::QScatter3DSeries(QObject *parent = nullptr)
Crée une série de nuages de points en 3D à partir de l'objet parent « 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 dossier parent parent.
[override virtual noexcept] QScatter3DSeries::~QScatter3DSeries()
Supprime la série de données 3D de type « scatter ».
void QScatter3DSeries::clearArray()
Efface le tableau de données.
void QScatter3DSeries::clearScaleArray()
Efface le tableau « scale ».
[static] qsizetype 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 Q3DGraphsWidgetItem::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.
