Sur cette page

QScatterDataProxy Class

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

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

QItemModelScatterDataProxy

Statut : Obsolète

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Fonctions publiques

QScatterDataProxy(QObject *parent = nullptr)
virtual ~QScatterDataProxy()
int addItem(const QScatterDataItem &item)
int addItems(const QScatterDataArray &items)
const QScatterDataArray *array() const
void insertItem(int index, const QScatterDataItem &item)
void insertItems(int index, const QScatterDataArray &items)
const QScatterDataItem *itemAt(int index) const
int itemCount() const
void removeItems(int index, int removeCount)
void resetArray(QScatterDataArray *newArray)
QScatter3DSeries *series() const
void setItem(int index, const QScatterDataItem &item)
void setItems(int index, const QScatterDataArray &items)

Signaux

void arrayReset()
void itemCountChanged(int count)
void itemsAdded(int startIndex, int count)
void itemsChanged(int startIndex, int count)
void itemsInserted(int startIndex, int count)
void itemsRemoved(int startIndex, int 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.

QScatterDataProxy prend en charge tous les objets QtDataVisualization::QScatterDataArray et QScatterDataItem qui lui sont transmis.

Voir également Gestion des données d'Qt Data Visualization .

Documentation des propriétés

[read-only] itemCount : int

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

Fonctions d'accès :

int itemCount() const

Signal de notification :

void itemCountChanged(int 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.

[virtual noexcept] QScatterDataProxy::~QScatterDataProxy()

Supprime le proxy de données dispersées.

int QScatterDataProxy::addItem(const QScatterDataItem &item)

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

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

int QScatterDataProxy::addItems(const QScatterDataArray &items)

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

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

const QScatterDataArray *QScatterDataProxy::array() const

Renvoie le pointeur vers le tableau de données.

[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(int index, const 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(int index, const QScatterDataArray &items)

Insère les éléments spécifiés par ` items ` à la position ` 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(int 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(int startIndex, int 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(int startIndex, int 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(int startIndex, int 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(int startIndex, int 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(int index, int 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(QScatterDataArray *newArray)

Prend en charge le tableau newArray. Efface le tableau existant si le nouveau tableau diffère de celui-ci. Si les tableaux sont identiques, cette fonction déclenche simplement le signal arrayReset().

Le passage d'un tableau nul supprime l'ancien tableau et crée un nouveau tableau vide.

void QScatterDataProxy::setItem(int index, const QScatterDataItem &item)

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

void QScatterDataProxy::setItems(int index, const 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

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.