Sur cette page

QScatterDataProxy Class

La classe QScatterDataProxy est le proxy de données pour les graphiques de dispersion 3D. Plus d'informations...

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 : 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 diffusion gère l'ajout, l'insertion, la modification et la suppression d'éléments de données. Comme les données sont stockées dans des séries, il est nécessaire de créer une série associée au proxy avant d'utiliser ces fonctions pour le jeu de données.

QScatterDataProxy est propriétaire de tous les objets QtGraphs::QScatterDataArray et QScatterDataItem qui lui sont transmis.

Voir également Qt Graphs Data Handling with 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 du notificateur :

void itemCountChanged(qsizetype count)

[read-only] series : QScatter3DSeries*

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

Fonctions d'accès :

QScatter3DSeries *series() const

Signal du notificateur :

void seriesChanged(QScatter3DSeries *series)

Fonction membre Documentation

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

Construit QScatterDataProxy avec l'adresse parent.

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

Supprime le proxy de données de diffusion.

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 du tableau entier est modifié sans appeler 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 à 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(qsizetype index) const

Renvoie le pointeur sur l'élément à l'index index. Sa validité est garantie jusqu'au prochain appel qui modifie 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 graphique.

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

Ce signal est émis lorsque le nombre d'éléments spécifiés 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 graphique.

[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 plus grand que la taille actuelle du tableau si des éléments sont retirés à la fin. Si des éléments sont retirés du tableau sans appeler 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és par removeCount à partir de la position index. Tenter de supprimer des éléments au-delà de la fin du tableau ne donne rien.

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 égal au tableau 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 égal au tableau existant, cette fonction déclenche simplement le signal scaleArrayReset().

QVector3D QScatterDataProxy::scaleAt(qsizetype index) const

Renvoie les données d'échelle à l'index index. La validité de ces données est garantie jusqu'au prochain appel qui les modifie.

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

Remplace l'élément à la position 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.

Non-membres apparentés

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