Sur cette page

QScatterDataProxy Class

La classe QScatterDataProxy sert de proxy de données pour les graphiques de dispersion 3D. En savoir plus...

En-tête : #include <QScatterDataProxy>
CMake : find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake : QT += graphs
En QML : ScatterDataProxy
Hérite de : QAbstractDataProxy
Hérité par :

QItemModelScatterDataProxy

Propriétés

Fonctions publiques

QScatterDataProxy(QObject *parent = nullptr)
virtual ~QScatterDataProxy() override
qsizetype addItem(QScatterDataItem item)
qsizetype addItems(QScatterDataArray items)
void insertItem(qsizetype index, QScatterDataItem item)
void insertItems(qsizetype index, QScatterDataArray items)
const QScatterDataItem &itemAt(qsizetype index) const
qsizetype itemCount() const
void removeItems(qsizetype index, qsizetype removeCount)
void resetArray()
void resetArray(QScatterDataArray newArray)
void resetScaleArray(QList<QVector3D> newArray)
QVector3D scaleAt(qsizetype index) const
QScatter3DSeries *series() const
void setItem(qsizetype index, QScatterDataItem item)
void setItems(qsizetype index, QScatterDataArray items)

Signaux

void arrayReset()
void itemCountChanged(qsizetype count)
void itemsAdded(qsizetype startIndex, qsizetype count)
void itemsChanged(qsizetype startIndex, qsizetype count)
void itemsInserted(qsizetype startIndex, qsizetype count)
void itemsRemoved(qsizetype startIndex, qsizetype count)
void seriesChanged(QScatter3DSeries *series)

Description détaillée

Un proxy de données de nuage gère l'ajout, l'insertion, la modification et la suppression d'éléments de données. Les données étant stockées sous forme de séries, il est nécessaire de créer une série associée au proxy avant d'utiliser ces fonctions pour l'ensemble de données.

QScatterDataProxy prend possession de tous les objets QtGraphs::QScatterDataArray et QScatterDataItem qui lui sont transmis.

Voir également Gestion des données d'Qt Graphs s en 3D.

Documentation sur les propriétés

[read-only] itemCount : qsizetype

Cette propriété contient le nombre d'éléments du tableau.

Fonctions d'accès :

qsizetype itemCount() const

Signal de notification :

void itemCountChanged(qsizetype count)

[read-only] series : QScatter3DSeries*

Cette propriété contient la série à laquelle ce proxy est associé.

Fonctions d'accès :

QScatter3DSeries *series() const

Signal de notification :

void seriesChanged(QScatter3DSeries *series)

Documentation des fonctions membres

[explicit] QScatterDataProxy::QScatterDataProxy(QObject *parent = nullptr)

Crée un objet `QScatterDataProxy` à partir de l'parent` fournie.

[override virtual noexcept] QScatterDataProxy::~QScatterDataProxy()

Supprime le proxy de données dispersées.

qsizetype QScatterDataProxy::addItem(QScatterDataItem item)

Ajoute l'élément item à la fin du tableau.

Renvoie l'index de l'élément ajouté.

qsizetype QScatterDataProxy::addItems(QScatterDataArray items)

Ajoute les éléments spécifiés par ` items ` à la fin du tableau.

Renvoie l'index du premier élément ajouté.

[signal] void QScatterDataProxy::arrayReset()

Ce signal est émis lorsque le tableau de données est réinitialisé. Si le contenu de l'ensemble du tableau est modifié sans appeler la fonction ` resetArray()`, ce signal doit être émis pour mettre à jour le graphique.

void QScatterDataProxy::insertItem(qsizetype index, QScatterDataItem item)

Insère l'élément item à la position index. Si l'index est égal à la taille du tableau de données, l'élément est ajouté au tableau.

void QScatterDataProxy::insertItems(qsizetype index, QScatterDataArray items)

Insère les éléments spécifiés par « items » à l'index « index ». Si l'index est égal à la taille du tableau de données, les éléments sont ajoutés au tableau.

const QScatterDataItem &QScatterDataProxy::itemAt(qsizetype index) const

Renvoie le pointeur vers l'élément situé à l'index index. Sa validité n'est garantie que jusqu'au prochain appel modifiant les données.

[signal] void QScatterDataProxy::itemsAdded(qsizetype startIndex, qsizetype count)

Ce signal est émis lorsque le nombre d'éléments spécifié par ` count ` est ajouté, à partir de la position ` startIndex`. Si des éléments sont ajoutés au tableau sans appeler ` addItem()` ou ` addItems()`, ce signal doit être émis pour mettre à jour le graphe.

[signal] void QScatterDataProxy::itemsChanged(qsizetype startIndex, qsizetype count)

Ce signal est émis lorsque le nombre d'éléments spécifié par ` count ` est modifié, à partir de la position ` startIndex`. Si des éléments sont modifiés dans le tableau sans appeler ` setItem()` ou ` setItems()`, ce signal doit être émis pour mettre à jour le graphique.

[signal] void QScatterDataProxy::itemsInserted(qsizetype startIndex, qsizetype count)

Ce signal est émis lorsque le nombre d'éléments spécifié par ` count ` est inséré, à partir de la position ` startIndex`. Si des éléments sont insérés dans le tableau sans appeler ` insertItem()` ou ` insertItems()`, ce signal doit être émis pour mettre à jour le graphe.

[signal] void QScatterDataProxy::itemsRemoved(qsizetype startIndex, qsizetype count)

Ce signal est émis lorsque le nombre de lignes spécifié par ` count ` est supprimé, à partir de la position ` startIndex`. L'index peut être supérieur à la taille actuelle du tableau si les éléments sont supprimés à partir de la fin. Si des éléments sont supprimés du tableau sans appeler la fonction ` removeItems()`, ce signal doit être émis pour mettre à jour le graphe.

void QScatterDataProxy::removeItems(qsizetype index, qsizetype removeCount)

Supprime le nombre d'éléments spécifié par ` removeCount ` à partir de la position ` index`. Toute tentative de suppression d'éléments situés au-delà de la fin du tableau n'a aucun effet.

void QScatterDataProxy::resetArray()

Efface le tableau existant et déclenche le signal ` arrayReset()`.

void QScatterDataProxy::resetArray(QScatterDataArray newArray)

Définit le tableau à partir de newArray. Si le nouveau tableau est identique à celui existant, cette fonction déclenche simplement le signal arrayReset().

void QScatterDataProxy::resetScaleArray(QList<QVector3D> newArray)

Définit le tableau d'échelle à partir de newArray. Si le nouveau tableau est identique à celui existant, cette fonction déclenche simplement le signal scaleArrayReset().

QVector3D QScatterDataProxy::scaleAt(qsizetype index) const

Renvoie les données d'échelle à l'index index. Leur validité n'est garantie que jusqu'au prochain appel modifiant ces données.

void QScatterDataProxy::setItem(qsizetype index, QScatterDataItem item)

Remplace l'élément situé à l'adresse index par l'élément item.

void QScatterDataProxy::setItems(qsizetype index, QScatterDataArray items)

Remplace les éléments à partir de la position index par les éléments spécifiés par items.

Contenu associé pour les non-membres

[alias] QScatterDataArray

Une liste d'objets « QScatterDataItem ».

© 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.