QBarDataProxy Class
La classe QBarDataProxy est le proxy de données pour un graphique à barres 3D. Plus d'informations...
| En-tête : | #include <QBarDataProxy> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake : | QT += graphs |
| En QML : | BarDataProxy |
| Hérite : | QAbstractDataProxy |
| Hérité par : |
- Liste de tous les membres, y compris les membres hérités
- QBarDataProxy fait partie de Qt Graphs C++ Classes for 3D.
Propriétés
Fonctions publiques
| QBarDataProxy(QObject *parent = nullptr) | |
| virtual | ~QBarDataProxy() override |
| qsizetype | addRow(QBarDataRow row) |
| qsizetype | addRow(QBarDataRow row, QString label) |
| qsizetype | addRows(QBarDataArray rows) |
| qsizetype | addRows(QBarDataArray rows, QStringList labels) |
| qsizetype | colCount() const |
| void | insertRow(qsizetype rowIndex, QBarDataRow row) |
| void | insertRow(qsizetype rowIndex, QBarDataRow row, QString label) |
| void | insertRows(qsizetype rowIndex, QBarDataArray rows) |
| void | insertRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels) |
| const QBarDataItem & | itemAt(QPoint position) const |
| const QBarDataItem & | itemAt(qsizetype rowIndex, qsizetype columnIndex) const |
| void | removeRows(qsizetype rowIndex, qsizetype removeCount, QBarDataProxy::RemoveLabels removeLabels = RemoveLabels::No) |
| void | resetArray() |
| void | resetArray(QBarDataArray newArray) |
| void | resetArray(QBarDataArray newArray, QStringList rowLabels, QStringList columnLabels) |
| const QBarDataRow & | rowAt(qsizetype rowIndex) const |
| qsizetype | rowCount() const |
| QBar3DSeries * | series() const |
| void | setItem(QPoint position, QBarDataItem item) |
| void | setItem(qsizetype rowIndex, qsizetype columnIndex, QBarDataItem item) |
| void | setRow(qsizetype rowIndex, QBarDataRow row) |
| void | setRow(qsizetype rowIndex, QBarDataRow row, QString label) |
| void | setRows(qsizetype rowIndex, QBarDataArray rows) |
| void | setRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels) |
Signaux
| void | arrayReset() |
| void | colCountChanged(qsizetype count) |
| void | itemChanged(qsizetype rowIndex, qsizetype columnIndex) |
| void | rowCountChanged(qsizetype count) |
| void | rowsAdded(qsizetype startIndex, qsizetype count) |
| void | rowsChanged(qsizetype startIndex, qsizetype count) |
| void | rowsInserted(qsizetype startIndex, qsizetype count) |
| void | rowsRemoved(qsizetype startIndex, qsizetype count) |
| void | seriesChanged(QBar3DSeries *series) |
Non-membres apparentés
Description détaillée
Un proxy de données de barres gère l'ajout, l'insertion, la modification et la suppression de lignes de données.
Le tableau de données est une liste de vecteurs (lignes) d'instances QBarDataItem. Chaque ligne peut contenir un nombre différent d'éléments ou même être nulle.
QBarDataProxy est propriétaire de tous les objets QtGraphs::QBarDataRow qui lui sont transmis, que ce soit directement ou dans un conteneur QtGraphs::QBarDataArray. Si les pointeurs de lignes de données de barres sont utilisés pour modifier directement les données après avoir ajouté le tableau au proxy, le signal approprié doit être émis pour mettre à jour le graphique.
QBarDataProxy conserve facultativement les étiquettes des lignes et des colonnes, que QCategory3DAxis peut utiliser pour afficher les étiquettes des axes.
Les étiquettes des lignes et des colonnes sont stockées dans un tableau distinct des données de la série. Les méthodes de traitement des lignes sont disponibles dans le proxy et fournissent des versions alternatives qui n'affectent pas les étiquettes des lignes. Cela permet d'avoir des étiquettes de ligne qui se rapportent à la position des données dans le tableau plutôt qu'aux données elles-mêmes. Étant donné que la série contient les données et les étiquettes de ligne et de colonne, il est nécessaire de créer une série associée au proxy avant d'utiliser ces fonctions pour elles.
Voir aussi Qt Graphs Manipulation de données avec 3D.
Documentation sur les propriétés
[read-only] colCount : qsizetype
Cette propriété indique le nombre de colonnes du tableau.
Fonctions d'accès :
| qsizetype | colCount() const |
Signal de notification :
| void | colCountChanged(qsizetype count) |
[read-only] rowCount : qsizetype
Cette propriété indique le nombre de lignes du tableau.
Fonctions d'accès :
| qsizetype | rowCount() const |
Signal de notification :
| void | rowCountChanged(qsizetype count) |
[read-only] series : QBar3DSeries*
Cette propriété contient la série à laquelle ce proxy est attaché.
Fonctions d'accès :
| QBar3DSeries * | series() const |
Signal du notificateur :
| void | seriesChanged(QBar3DSeries *series) |
Fonction membre Documentation
[explicit] QBarDataProxy::QBarDataProxy(QObject *parent = nullptr)
Construit un proxy de données de barres avec la valeur donnée parent.
[override virtual noexcept] QBarDataProxy::~QBarDataProxy()
Supprime le proxy de données de la barre.
qsizetype QBarDataProxy::addRow(QBarDataRow row)
Ajoute la nouvelle ligne row à la fin d'un tableau. Les étiquettes des lignes existantes ne sont pas affectées.
Renvoie l'index de la ligne ajoutée.
qsizetype QBarDataProxy::addRow(QBarDataRow row, QString label)
Ajoute une nouvelle ligne row avec le libellé label à la fin d'un tableau.
Renvoie l'index de la ligne ajoutée.
qsizetype QBarDataProxy::addRows(QBarDataArray rows)
Ajoute le nouveau rows à la fin d'un tableau. Les étiquettes des lignes existantes ne sont pas affectées.
Renvoie l'index de la première ligne ajoutée.
qsizetype QBarDataProxy::addRows(QBarDataArray rows, QStringList labels)
Ajoute le nouveau rows avec labels à la fin du tableau.
Renvoie l'index de la première ligne ajoutée.
[signal] void QBarDataProxy::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 QBarDataProxy::insertRow(qsizetype rowIndex, QBarDataRow row)
Insère la nouvelle ligne row dans rowIndex. Si rowIndex est égal à la taille du tableau, les lignes sont ajoutées à la fin du tableau. Les étiquettes de ligne existantes ne sont pas affectées.
Note : Le tableau des étiquettes de ligne sera désynchronisé avec le tableau des lignes après cet appel s'il y avait des lignes étiquetées au-delà de la ligne insérée.
void QBarDataProxy::insertRow(qsizetype rowIndex, QBarDataRow row, QString label)
Insère la nouvelle ligne row avec l'étiquette label dans rowIndex. Si rowIndex est égal à la taille du tableau, les lignes sont ajoutées à la fin du tableau.
void QBarDataProxy::insertRows(qsizetype rowIndex, QBarDataArray rows)
Insère le nouveau rows dans rowIndex. Si rowIndex est égal à la taille du tableau, les lignes sont ajoutées à la fin du tableau. Les étiquettes de ligne existantes ne sont pas affectées.
Note : Le tableau des étiquettes de ligne sera désynchronisé avec le tableau des lignes après cet appel s'il y avait des lignes étiquetées au-delà des lignes insérées.
void QBarDataProxy::insertRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels)
Insère le nouveau rows avec labels dans rowIndex. Si rowIndex est égal à la taille du tableau, les lignes sont ajoutées à la fin du tableau.
const QBarDataItem &QBarDataProxy::itemAt(QPoint position) const
Renvoie la référence à l'élément situé à la position position. La valeur x de position indique la ligne et la valeur y indique la colonne. La validité de l'élément est garantie jusqu'au prochain appel modifiant les données.
const QBarDataItem &QBarDataProxy::itemAt(qsizetype rowIndex, qsizetype columnIndex) const
Renvoie la référence à l'élément situé à la position spécifiée par rowIndex et columnIndex. Sa validité est garantie jusqu'au prochain appel qui modifie les données.
[signal] void QBarDataProxy::itemChanged(qsizetype rowIndex, qsizetype columnIndex)
Ce signal est émis lorsque l'élément situé à la position spécifiée par rowIndex et columnIndex change. Si l'élément est modifié dans le tableau sans appeler setItem(), ce signal doit être émis pour mettre à jour le graphique.
void QBarDataProxy::removeRows(qsizetype rowIndex, qsizetype removeCount, QBarDataProxy::RemoveLabels removeLabels = RemoveLabels::No)
Supprime le nombre de lignes spécifié par removeCount à partir de la position rowIndex. Tenter de supprimer des lignes au-delà de la fin du tableau n'aboutit à rien. Si removeLabels est true, les étiquettes de ligne correspondantes sont également supprimées. Dans le cas contraire, les étiquettes des lignes ne sont pas affectées.
Remarque : si removeLabels est false, le tableau des étiquettes de ligne sera désynchronisé avec le tableau des lignes s'il y a des lignes étiquetées au-delà des lignes supprimées.
void QBarDataProxy::resetArray()
Efface le tableau existant et les étiquettes des lignes et des colonnes.
void QBarDataProxy::resetArray(QBarDataArray newArray)
Prend possession du tableau newArray. Elle efface le tableau existant si le nouveau tableau en diffère. 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. Les étiquettes des lignes et des colonnes ne sont pas affectées.
void QBarDataProxy::resetArray(QBarDataArray newArray, QStringList rowLabels, QStringList columnLabels)
Prend possession du tableau newArray. Elle efface le tableau existant si le nouveau tableau en diffère. 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.
Les listes rowLabels et columnLabels indiquent les nouvelles étiquettes pour les lignes et les colonnes.
const QBarDataRow &QBarDataProxy::rowAt(qsizetype rowIndex) const
Renvoie la référence à la ligne à la position rowIndex. La validité de cette référence est garantie jusqu'au prochain appel modifiant les données.
[signal] void QBarDataProxy::rowsAdded(qsizetype startIndex, qsizetype count)
Ce signal est émis lorsque le nombre de lignes spécifié par count est ajouté, à partir de la position startIndex. Si des lignes sont ajoutées au tableau sans appeler addRow() ou addRows(), ce signal doit être émis pour mettre à jour le graphique.
[signal] void QBarDataProxy::rowsChanged(qsizetype startIndex, qsizetype count)
Ce signal est émis lorsque le nombre de lignes spécifié par count est modifié, à partir de la position startIndex. Si des lignes sont modifiées dans le tableau sans appeler setRow() ou setRows(), ce signal doit être émis pour mettre à jour le graphique.
[signal] void QBarDataProxy::rowsInserted(qsizetype startIndex, qsizetype count)
Ce signal est émis lorsque le nombre de lignes spécifié par count est inséré à la position startIndex.
Si des lignes sont insérées dans le tableau sans appeler insertRow() ou insertRows(), ce signal doit être émis pour mettre à jour le graphique.
[signal] void QBarDataProxy::rowsRemoved(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'indice est la taille actuelle du tableau si les lignes ont été supprimées à la fin du tableau. Si des lignes sont retirées du tableau sans appeler removeRows(), ce signal doit être émis pour mettre à jour le graphique.
void QBarDataProxy::setItem(QPoint position, QBarDataItem item)
Remplace un élément unique à la position position par l'élément item. La valeur x de position indique la ligne et la valeur y indique la colonne.
void QBarDataProxy::setItem(qsizetype rowIndex, qsizetype columnIndex, QBarDataItem item)
Remplace un élément unique à la position spécifiée par rowIndex et columnIndex par l'élément item.
void QBarDataProxy::setRow(qsizetype rowIndex, QBarDataRow row)
Modifie une ligne existante en remplaçant la ligne à la position rowIndex par la nouvelle ligne spécifiée par row. La nouvelle ligne peut être identique à la ligne existante déjà stockée à l'adresse rowIndex. Les libellés des lignes existantes ne sont pas affectés.
void QBarDataProxy::setRow(qsizetype rowIndex, QBarDataRow row, QString label)
Modifie une ligne existante en remplaçant la ligne à la position rowIndex par la nouvelle ligne spécifiée par row. La nouvelle ligne peut être la même que la ligne existante déjà stockée à l'adresse rowIndex. Modifie l'étiquette de la ligne en la remplaçant par label.
void QBarDataProxy::setRows(qsizetype rowIndex, QBarDataArray rows)
Modifie les lignes existantes en remplaçant les lignes commençant à la position rowIndex par les nouvelles lignes spécifiées par rows. Les étiquettes des lignes existantes ne sont pas affectées. Les lignes du tableau rows peuvent être les mêmes que les lignes existantes déjà stockées à rowIndex.
void QBarDataProxy::setRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels)
Modifie les lignes existantes en remplaçant les lignes commençant à la position rowIndex par les nouvelles lignes spécifiées par rows. Les étiquettes des lignes sont remplacées par labels. Les lignes du tableau rows peuvent être les mêmes que les lignes existantes déjà stockées à rowIndex.
Non-membres apparentés
[alias] QBarDataArray
Une liste de pointeurs vers des objets QBarDataRow.
[alias] QBarDataRow
Une liste d'objets QBarDataItem.
© 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.