QBarDataProxy Class
La classe QBarDataProxy sert de proxy de données pour un graphique à barres en 3D. En savoir plus...
| 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 de : | QAbstractDataProxy |
| Hérédité : |
- Liste de tous les membres, y compris les membres hérités
- QBarDataProxy fait partie des classes C++ d'Qt Graphs pour la 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) |
Éléments non membres associés
Description détaillée
Un proxy de données de type « bar » 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 d'QBarDataItem. Chaque ligne peut contenir un nombre différent d'éléments, voire être nulle.
QBarDataProxy prend possession de tous les objets QtGraphs::QBarDataRow qui lui sont transmis, que ce soit directement ou via un conteneur QtGraphs::QBarDataArray. Si des pointeurs vers des lignes de données de barres sont utilisés pour modifier directement les données après l'ajout du tableau au proxy, le signal approprié doit être émis pour mettre à jour le graphique.
QBarDataProxy assure, de manière facultative, le suivi des libellés de lignes et de colonnes, que QCategory3DAxis peut utiliser pour afficher les libellés d’axes.
Les étiquettes de lignes et de colonnes sont stockées dans un tableau distinct de celui contenant les données de la série. Des méthodes de traitement des lignes sont disponibles dans le proxy et proposent des versions alternatives qui n’affectent pas les étiquettes de lignes. Cela permet d’avoir des étiquettes de lignes 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 ainsi que les étiquettes de lignes et de colonnes, il est nécessaire de créer une série associée au proxy avant de pouvoir utiliser ces fonctions.
Voir également « Gestion des données 3D » surQt Graphs .
Documentation sur les propriétés
[read-only] colCount : qsizetype
Cette propriété contient 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é contient 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 associé.
Fonctions d'accès :
| QBar3DSeries * | series() const |
Signal de notification :
| void | seriesChanged(QBar3DSeries *series) |
Documentation des fonctions membres
[explicit] QBarDataProxy::QBarDataProxy(QObject *parent = nullptr)
Crée un proxy de données de type « bar » à partir de l'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 libellés des lignes existantes ne sont pas modifiés.
Renvoie l'index de la ligne ajoutée.
qsizetype QBarDataProxy::addRow(QBarDataRow row, QString label)
Ajoute une nouvelle ligne « row » avec l'étiquette « label » à la fin d'un tableau.
Renvoie l'index de la ligne ajoutée.
qsizetype QBarDataProxy::addRows(QBarDataArray rows)
Ajoute la nouvelle étiquette de ligne « rows » à la fin d'un tableau. Les étiquettes de ligne existantes ne sont pas modifiées.
Renvoie l'index de la première ligne ajoutée.
qsizetype QBarDataProxy::addRows(QBarDataArray rows, QStringList labels)
Ajoute la nouvelle ligne « rows » avec l'adresse « 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 de l'ensemble du tableau est modifié sans appeler la fonction ` 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 modifiées.
Remarque : après cet appel,le tableau des libellés de lignes ne sera plus synchronisé avec le tableau des lignes s’il existait des lignes libellées situé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 le libellé 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 de nouvelles étiquettes de ligne ( rows ) dans le tableau d'étiquettes de ligne ( rowIndex). Si le nombre d'étiquettes de ligne ( rowIndex ) est égal à la taille du tableau, les lignes sont ajoutées à la fin du tableau. Les étiquettes de ligne existantes ne sont pas modifiées.
Remarque : le tableau des étiquettes de lignes ne sera plus synchronisé avec le tableau des lignes après cet appel s'il existait des lignes étiquetées au-delà des lignes insérées.
void QBarDataProxy::insertRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels)
Insère un nouvel élément 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 correspond à la ligne et la valeur y à la colonne. La validité de cet élément n'est garantie que 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é n'est garantie que jusqu'au prochain appel modifiant 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 la fonction 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`. Toute tentative de suppression de lignes situées au-delà de la fin du tableau n'a aucun effet. Si ` removeLabels ` est égal à ` true`, les étiquettes de ligne correspondantes sont également supprimées. Dans le cas contraire, les étiquettes de ligne ne sont pas affectées.
Remarque : si removeLabels est égal à false, le tableau des étiquettes de lignes ne sera plus synchronisé avec le tableau des lignes s’il existe des lignes étiquetées au-delà des lignes supprimées.
void QBarDataProxy::resetArray()
Efface le tableau existant ainsi que les libellés des lignes et des colonnes.
void QBarDataProxy::resetArray(QBarDataArray 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. Les étiquettes de lignes et de colonnes ne sont pas affectées.
void QBarDataProxy::resetArray(QBarDataArray newArray, QStringList rowLabels, QStringList columnLabels)
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.
Les listes ` rowLabels ` et ` columnLabels ` spécifient les nouvelles étiquettes pour les lignes et les colonnes.
const QBarDataRow &QBarDataProxy::rowAt(qsizetype rowIndex) const
Renvoie la référence à la ligne située à la position rowIndex. Sa validité n'est garantie que 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'index correspond à la taille actuelle du tableau si les lignes ont été supprimées à la fin de celui-ci. Si des lignes sont supprimées du tableau sans appeler la fonction ` removeRows()`, ce signal doit être émis pour mettre à jour le graphique.
void QBarDataProxy::setItem(QPoint position, QBarDataItem item)
Remplace un élément situé à la position position par l'élément item. La valeur x de position correspond à la ligne et la valeur y à la colonne.
void QBarDataProxy::setItem(qsizetype rowIndex, qsizetype columnIndex, QBarDataItem item)
Remplace un seul élément situé à l'emplacement spécifié 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 située à l'adresse 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 située à l'adresse 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. Modifie l'étiquette de la ligne en label.
void QBarDataProxy::setRows(qsizetype rowIndex, QBarDataArray rows)
Modifie les lignes existantes en remplaçant les lignes à partir de la position rowIndex par les nouvelles lignes spécifiées par rows. Les libellés des lignes existantes ne sont pas modifiés. Les lignes du tableau rows peuvent être identiques aux lignes existantes déjà stockées à l'adresse rowIndex.
void QBarDataProxy::setRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels)
Modifie les lignes existantes en remplaçant les lignes à partir de la position rowIndex par les nouvelles lignes spécifiées par rows. Les libellés des lignes sont remplacés par labels. Les lignes du tableau rows peuvent être identiques aux lignes existantes déjà stockées à l'adresse rowIndex.
Personnes non membres associées
[alias] QBarDataArray
Une liste de pointeurs vers des objets de type ` 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.