QBar3DSeries Class
La classe `QBar3DSeries` représente une série de données dans un graphique à barres en 3D. En savoir plus...
| En-tête : | #include <QBar3DSeries> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake : | QT += graphs |
| En QML : | Bar3DSeries |
| Hérite de : | QAbstract3DSeries |
- Liste de tous les membres, y compris les membres hérités
- QBar3DSeries fait partie des classes C++ d'Qt Graphs pour la 3D.
Propriétés
|
|
Fonctions publiques
| QBar3DSeries(QObject *parent = nullptr) | |
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() override |
| void | clearArray() |
| void | clearRow(qsizetype rowIndex) |
| QCategory3DAxis * | columnAxis() const |
| QStringList | columnLabels() const |
| QStringList | customColumnLabels() const |
| QStringList | customRowLabels() const |
| const QBarDataArray & | dataArray() const & |
| QBarDataArray | dataArray() && |
| QBarDataProxy * | dataProxy() const |
| bool | isValueColoringEnabled() const |
| float | meshAngle() const |
| void | resetColumnAxis() |
| void | resetRowAxis() |
| void | resetValueAxis() |
| QCategory3DAxis * | rowAxis() const |
| QList<QColor> | rowColors() const |
| QStringList | rowLabels() const |
| QPoint | selectedBar() const |
| void | setColumnAxis(QCategory3DAxis *axis) |
| void | setColumnLabels(const QStringList &labels) |
| void | setCustomColumnLabels(const QStringList &labels) |
| void | setCustomRowLabels(const QStringList &labels) |
| void | setDataArray(const QBarDataArray &newDataArray) |
| void | setDataProxy(QBarDataProxy *proxy) |
| void | setMeshAngle(float angle) |
| void | setRowAxis(QCategory3DAxis *axis) |
| void | setRowColors(const QList<QColor> &colors) |
| void | setRowLabels(const QStringList &labels) |
| void | setSelectedBar(QPoint position) |
| void | setValueAxis(QValue3DAxis *axis) |
| void | setValueColoringEnabled(bool enabled) |
| QValue3DAxis * | valueAxis() const |
Signaux
| void | columnAxisChanged(QCategory3DAxis *axis) |
| void | columnLabelsChanged() |
| void | customColumnLabelsChanged(const QStringList &newCustomColumnLabels) |
| void | customRowLabelsChanged(const QStringList &newCustomRowLabels) |
| void | dataArrayChanged(const QBarDataArray &array) |
| void | dataProxyChanged(QBarDataProxy *proxy) |
| void | meshAngleChanged(float angle) |
| void | rowAxisChanged(QCategory3DAxis *axis) |
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
| void | rowLabelsChanged() |
| void | selectedBarChanged(QPoint position) |
| void | valueAxisChanged(QValue3DAxis *axis) |
| void | valueColoringEnabledChanged(bool enabled) |
Membres publics statiques
| QPoint | invalidSelectionPosition() |
Description détaillée
Cette classe gère les éléments visuels spécifiques à la série, ainsi que les données de la série (via un proxy de données).
En ce qui concerne la relation entre le proxy et la série, il est essentiel de souligner quelques points clés. Dans ce contexte, les données sont stockées dans des séries et les utilisateurs peuvent accéder au jeu de données via ces séries. Ces séries sont contrôlées ou représentées par un objet proxy. Ainsi, le proxy peut être utilisé pour gérer diverses opérations sur les données et mettre à jour le jeu de données réel. Cependant, il est nécessaire de créer une série associée à ce proxy pour modifier le jeu de données.
Si aucun proxy de données n’est défini explicitement pour la série, celle-ci crée un proxy par défaut. La définition d’un autre proxy détruira le proxy existant ainsi que toutes les données ajoutées à la série.
QBar3DSeries prend en charge les balises de format suivantes pour la fonction ` QAbstract3DSeries::setItemLabelFormat()` :
| @rowTitle | Titre de l’axe des lignes |
| @colTitle | Titre de l'axe des colonnes |
| @valueTitle | Titre de l'axe des valeurs |
| @rowIdx | Index de la ligne visible. Localisé selon les paramètres régionaux du graphique. |
| @colIdx | Indice de colonne visible. Localisé selon les paramètres régionaux du graphe. |
| @rowLabel | Étiquette de l'axe des lignes |
| @colLabel | Étiquette de l'axe des colonnes |
| @valueLabel | Valeur de l'élément formatée selon le format de l'axe des valeurs associé au graphique. Pour plus d'informations, consultez QValue3DAxis::labelFormat. |
| @seriesName | Nom de la série |
| %<spécification de format> | Valeur de l'élément au format spécifié. Mise en forme selon les mêmes règles que celles décrites à l'adresse QValue3DAxis::labelFormat. |
Par exemple :
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));Voir également Qt Graphs Gestion des données avec 3D et Q3DGraphsWidgetItem::locale.
Documentation sur les propriétés
[since 6.11] columnAxis : QCategory3DAxis*
Ajoute un axe de colonne supplémentaire pour la série
Remarque : l'axe supplémentaire n'affecte pas l'ajustement du graphique, mais permet d'afficher un jeu supplémentaire d'étiquettes et une grille d'axe.
Cette énumération a été introduite dans Qt 6.11.
Fonctions d'accès :
| QCategory3DAxis * | columnAxis() const |
| void | setColumnAxis(QCategory3DAxis *axis) |
| void | resetColumnAxis() |
Signal de notification :
| void | columnAxisChanged(QCategory3DAxis *axis) |
columnLabels : QStringList
Cette propriété contient les libellés de colonnes facultatifs pour le tableau.
Les indices de ce tableau correspondent aux indices des colonnes dans les lignes. Si la liste est plus courte que la ligne la plus longue, toutes les colonnes ne recevront pas d'étiquette.
Fonctions d'accès :
| QStringList | columnLabels() const |
| void | setColumnLabels(const QStringList &labels) |
Signal de notification :
| void | columnLabelsChanged() |
[since 6.11] customColumnLabels : QStringList
Cette propriété contient les libellés de colonnes personnalisés (facultatifs) pour le tableau.
Ces libellés remplaceront ceux générés par un proxy. Les indices de ce tableau correspondent aux indices des colonnes dans les lignes. Si la liste est plus courte que la ligne la plus longue, toutes les colonnes ne recevront pas de libellé.
Cette énumération a été introduite dans Qt 6.11.
Fonctions d'accès :
| QStringList | customColumnLabels() const |
| void | setCustomColumnLabels(const QStringList &labels) |
Signal de notification :
| void | customColumnLabelsChanged(const QStringList &newCustomColumnLabels) |
[since 6.11] customRowLabels : QStringList
Cette propriété contient les libellés de ligne personnalisés facultatifs pour le tableau.
Ces libellés remplaceront ceux générés par un proxy. Les indices de ce tableau correspondent aux indices des lignes du tableau de données. Si la liste est plus courte que le nombre de lignes, toutes les lignes ne recevront pas de libellé.
Cette énumération a été introduite dans Qt 6.11.
Fonctions d’accès :
| QStringList | customRowLabels() const |
| void | setCustomRowLabels(const QStringList &labels) |
Signal de notification :
| void | customRowLabelsChanged(const QStringList &newCustomRowLabels) |
dataArray : QBarDataArray
Tableau de données pour la série.
Contient la référence du tableau de données.
Le signal `dataArrayChanged` est émis lorsque le tableau de données est défini, sauf si ` newDataArray ` est identique à la valeur précédente.
Remarque : avant toute opération sur dataArray, une série doit être créée pour le proxy concerné.
Fonctions d'accès :
| const QBarDataArray & | dataArray() const & |
| QBarDataArray | dataArray() && |
| void | setDataArray(const QBarDataArray &newDataArray) |
Signal de notification :
| void | dataArrayChanged(const QBarDataArray &array) |
Voir également ` clearRow(qsizetype rowIndex)` et ` clearArray()`.
dataProxy : QBarDataProxy*
Cette propriété contient le proxy de données actif.
La série prend possession de tout proxy qui lui est attribué et supprime tout proxy précédemment défini lorsqu'un nouveau proxy est ajouté. Le proxy ne peut pas être nul ni attribué à une autre série.
Fonctions d'accès :
| QBarDataProxy * | dataProxy() const |
| void | setDataProxy(QBarDataProxy *proxy) |
Signal de notification :
| void | dataProxyChanged(QBarDataProxy *proxy) |
meshAngle : float
Cette propriété contient l'angle de rotation de la série, exprimé en degrés.
La définition de cette propriété équivaut à l'appel suivant :
setMeshRotation(QQuaternion::fromAxisAndAngle(0.0f, 1.0f, 0.0f, angle))Remarque : lors de la lecture de cette propriété, sa valeur est calculée à partir de la valeur « QAbstract3DSeries::meshRotation » (angle de rotation de la série) en utilisant la précision en virgule flottante et renvoie toujours une valeur comprise entre zéro et 360 degrés.
Fonctions d'accès :
| float | meshAngle() const |
| void | setMeshAngle(float angle) |
Signal de notification :
| void | meshAngleChanged(float angle) |
Voir également QAbstract3DSeries::meshRotation.
[since 6.11] rowAxis : QCategory3DAxis*
Ajoute un axe des lignes supplémentaire pour la série
Remarque : l'axe supplémentaire n'ajuste pas l'ajustement du graphique, mais permet d'afficher un jeu supplémentaire d'étiquettes et une grille d'axe.
Cette énumération a été introduite dans Qt 6.11.
Fonctions d'accès :
| QCategory3DAxis * | rowAxis() const |
| void | setRowAxis(QCategory3DAxis *axis) |
| void | resetRowAxis() |
Signal de notification :
| void | rowAxisChanged(QCategory3DAxis *axis) |
rowColors : QList<QColor>
Cette propriété contient la liste des couleurs des lignes de la série.
Cette propriété permet de colorer les lignes de la série dans différentes couleurs. Pour utiliser cette propriété, l'QGraphsTheme::ColorStyle e doit être défini sur « QGraphsTheme::ColorStyle::Uniform ».
Fonctions d'accès :
| QList<QColor> | rowColors() const |
| void | setRowColors(const QList<QColor> &colors) |
Signal de notification :
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
Voir également QGraphsTheme::ColorStyle::Uniform.
rowLabels : QStringList
Cette propriété contient les libellés de ligne facultatifs pour le tableau.
Les indices de ce tableau correspondent aux indices des lignes du tableau de données. Si la liste est plus courte que le nombre de lignes, toutes les lignes ne recevront pas d'étiquettes.
Fonctions d'accès :
| QStringList | rowLabels() const |
| void | setRowLabels(const QStringList &labels) |
Signal de notification :
| void | rowLabelsChanged() |
selectedBar : QPoint
Cette propriété contient la barre de la série sélectionnée.
Fonctions d’accès :
| QPoint | selectedBar() const |
| void | setSelectedBar(QPoint position) |
Signal de notification :
| void | selectedBarChanged(QPoint position) |
[since 6.11] valueAxis : QValue3DAxis*
Définit un axe de valeurs supplémentaire pour la série. Si un axe est spécifié, la série sera ajustée aux valeurs minimale et maximale de cet axe.
Cette énumération a été introduite dans Qt 6.11.
Fonctions d'accès :
| QValue3DAxis * | valueAxis() const |
| void | setValueAxis(QValue3DAxis *axis) |
| void | resetValueAxis() |
Signal de notification :
| void | valueAxisChanged(QValue3DAxis *axis) |
[since 6.9] valueColoringEnabled : bool
Utilisez la valeur indiquée pour colorer l'ensemble de la barre en fonction du dégradé défini
Cette propriété permet de colorer chaque barre séparément en fonction de sa valeur et du dégradé de plage spécifié. Pour utiliser cette propriété, la valeur de la propriété « QGraphsTheme::ColorStyle » doit être définie sur « QGraphsTheme::ColorStyle::RangeGradient ».
Cette énumération a été introduite dans Qt 6.9.
Fonctions d'accès :
| bool | isValueColoringEnabled() const |
| void | setValueColoringEnabled(bool enabled) |
Signal de notification :
| void | valueColoringEnabledChanged(bool enabled) |
Voir également QGraphsTheme::ColorStyle::RangeGradient.
Documentation des fonctions membres
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
Crée une série 3D de barres dont le parent est parent.
[explicit] QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
Crée une série de graphiques à barres en 3D à partir du proxy de données dataProxy et de son parent parent.
[override virtual noexcept] QBar3DSeries::~QBar3DSeries()
Supprime une série de barres 3D.
void QBar3DSeries::clearArray()
Efface le tableau existant.
void QBar3DSeries::clearRow(qsizetype rowIndex)
Efface la ligne existante du tableau en fonction de l'rowIndex s fournies.
[static] QPoint QBar3DSeries::invalidSelectionPosition()
Renvoie une position non valide pour la sélection. Cette position est attribuée à la propriété ` selectedBar ` afin de désélectionner cette série.
Voir également Q3DGraphsWidgetItem::clearSelection().
void QBar3DSeries::setSelectedBar(QPoint position)
Sélectionne la barre située à la position position, définie par une ligne et une colonne dans le tableau de données de la série.
Une seule barre peut être sélectionnée à la fois.
Pour effacer la sélection de cette série, la méthode ` invalidSelectionPosition()` est appelée avec l’argument ` position`.
Si cette série est ajoutée à un graphique, celui-ci peut ajuster la sélection en fonction des interactions de l’utilisateur ou si celle-ci devient invalide. La sélection d’une barre sur une autre série ajoutée effacera également la sélection.
La suppression ou l’insertion de lignes dans la série avant la ligne de la barre sélectionnée ajustera la sélection de manière à ce que la même barre reste sélectionnée.
Remarque : fonctionde définition de la propriété selectedBar.
Voir également selectedBar() et Q3DGraphsWidgetItem::clearSelection().
© 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.
