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 Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake : | QT += graphs |
| En QML : | Scatter3DSeries |
| Hérite : | QAbstract3DSeries |
| Hérité par : |
- Liste de tous les membres, y compris les membres hérités
- QScatter3DSeries fait partie de Qt Graphs C++ Classes for 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 proxy-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 par l'intermédiaire de la série. Cette série est contrôlée ou représentée 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 éditer le jeu de données.
Si aucun proxy de données n'est défini explicitement pour la série, la série crée un proxy par défaut. La définition d'un autre proxy détruira le proxy existant et toutes les données ajoutées à la série.
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::labelFormat. |
| @yLabel | Valeur de l'élément formatée selon le format de l'axe des y. Pour plus d'informations, voir QValue3DAxis::labelFormat. |
| @zLabel | Valeur de l'élément formatée en utilisant le format de l'axe des z. Pour plus d'informations, voir QValue3DAxis::labelFormat. |
| @seriesName | Nom de la série |
Par exemple, le nom de la série :
proxy->setItemLabelFormat(QStringLiteral("@yTitle for (@xLabel, @zLabel): %.1f"));
Voir également Qt Graphs Data Handling with 3D.
Documentation sur les propriétés
[since 6.11] axisX : QValue3DAxis*
Détient un axe X supplémentaire pour la série Si un axe est donné, la série sera ajustée aux valeurs minimales et maximales de l'axe.
Cette propriété a été introduite dans Qt 6.11.
Fonctions d'accès :
| QValue3DAxis * | axisX() const |
| void | setAxisX(QValue3DAxis *axis) |
| void | resetAxisX() |
Notifier signal :
| void | axisXChanged(QValue3DAxis *axis) |
[since 6.11] axisY : QValue3DAxis*
Détient un axe Y supplémentaire pour la série Si un axe est donné, la série sera ajustée aux valeurs minimales et maximales de l'axe.
Cette propriété a été introduite dans Qt 6.11.
Fonctions d'accès :
| QValue3DAxis * | axisY() const |
| void | setAxisY(QValue3DAxis *axis) |
| void | resetAxisY() |
Notifier signal :
| void | axisYChanged(QValue3DAxis *axis) |
[since 6.11] axisZ : QValue3DAxis*
Détient un axe Z supplémentaire pour la série Si un axe est donné, la série sera ajustée aux valeurs minimales et maximales de l'axe.
Cette propriété a été introduite dans Qt 6.11.
Fonctions d'accès :
| QValue3DAxis * | axisZ() const |
| void | setAxisZ(QValue3DAxis *axis) |
| void | resetAxisZ() |
Notifier signal :
| 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 modifié, sauf si newDataArray est identique au précédent.
Remarque : avant de faire quoi que ce soit concernant 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 Notifier :
| void | dataArrayChanged(const QScatterDataArray &array) |
Voir aussi clearArray().
dataProxy : QScatterDataProxy*
Cette propriété contient le proxy de données actif.
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.
Fonctions d'accès :
| QScatterDataProxy * | dataProxy() const |
| void | setDataProxy(QScatterDataProxy *proxy) |
Signal de notification :
| 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) |
scaleArray : QList<QVector3D>
Tableau d'échelle 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 de faire quoi que ce soit concernant le tableau d'échelle, une série doit être créée pour le proxy concerné.
Note : Si aucune échelle n'est spécifiée pour les données, une valeur par défaut de (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 aussi clearScaleArray().
selectedItem : qsizetype
Cette propriété contient l'élément sélectionné dans la série.
Elle 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 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é.
Fonctions d'accès :
| qsizetype | selectedItem() const |
| void | setSelectedItem(qsizetype index) |
Signal de notification :
| void | selectedItemChanged(qsizetype index) |
Voir aussi Q3DGraphsWidgetItem::clearSelection().
Documentation sur les fonctions membres
[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.
[override virtual noexcept] QScatter3DSeries::~QScatter3DSeries()
Supprime la série de scatter 3D.
void QScatter3DSeries::clearArray()
Efface le tableau de données.
void QScatter3DSeries::clearScaleArray()
Efface le tableau d'échelle.
[static] qsizetype 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 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.
