QBar3DSeries Class
La classe QBar3DSeries représente une série de données dans un graphique à barres 3D. Plus d'informations...
| 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éritages : | QAbstract3DSeries |
- Liste de tous les membres, y compris les membres hérités
- QBar3DSeries fait partie de Qt Graphs C++ Classes for 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 proxy-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 à l'ensemble de données par l'intermédiaire de la série. Cette série est contrôlée ou représentée par un objet proxy. Ainsi, le proxy peut être utilisé pour gérer diverses opérations sur les données et mettre à jour l'ensemble de données réel. Cependant, il est nécessaire de créer une série associée à ce proxy pour éditer le jeu de données.
Si aucun proxy de données n'est défini explicitement pour la série, la série crée un proxy par défaut. La définition d'un autre proxy détruira le proxy existant et toutes les données ajoutées à la série.
QBar3DSeries prend en charge les balises de format suivantes pour QAbstract3DSeries::setItemLabelFormat() :
| @rowTitle | Titre de l'axe des lignes |
| @colTitle | Titre de l'axe des colonnes |
| @valueTitle | Titre de l'axe des valeurs |
| @rowIdx | Indice de ligne visible. Localisé à l'aide de la locale du graphique. |
| @colIdx | Indice de colonne visible. Localisé à l'aide de la locale du graphique. |
| @rowLabel | Etiquette de l'axe des lignes |
| @colLabel | Etiquette de l'axe des colonnes |
| @valueLabel | Valeur de l'élément formatée selon le format de l'axe des valeurs attaché au graphique. Pour plus d'informations, voir QValue3DAxis::labelFormat. |
| @seriesName | Nom de la série |
| %<format spec> | Valeur de l'élément dans le format spécifié. Le formatage s'effectue selon les mêmes règles que celles énoncées à l'adresse QValue3DAxis::labelFormat. |
Par exemple :
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
Voir également Qt Graphs Data Handling with 3D et Q3DGraphsWidgetItem::locale.
Documentation sur les propriétés
[since 6.11] columnAxis : QCategory3DAxis*
Contient un axe de colonne supplémentaire pour la série
Note : L'axe supplémentaire n'ajuste pas l'ajustement du graphique, mais permet un ensemble supplémentaire d'étiquettes et une grille d'axe.
Cette propriété a été introduite dans Qt 6.11.
Fonctions d'accès :
| QCategory3DAxis * | columnAxis() const |
| void | setColumnAxis(QCategory3DAxis *axis) |
| void | resetColumnAxis() |
Notifier signal :
| void | columnAxisChanged(QCategory3DAxis *axis) |
columnLabels : QStringList
Cette propriété contient les libellés facultatifs des colonnes du tableau.
Les index de ce tableau correspondent aux index des colonnes dans les lignes. Si la liste est plus courte que la ligne la plus longue, toutes les colonnes ne seront pas étiquetées.
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 étiquettes de colonnes personnalisées facultatives pour le tableau.
Ces libellés remplacent les libellés générés par un proxy. Les index de ce tableau correspondent aux index des colonnes dans les lignes. Si la liste est plus courte que la ligne la plus longue, toutes les colonnes n'auront pas d'étiquettes.
Cette propriété a été introduite dans Qt 6.11.
Fonctions d'accès :
| QStringList | customColumnLabels() const |
| void | setCustomColumnLabels(const QStringList &labels) |
Signal Notifier :
| void | customColumnLabelsChanged(const QStringList &newCustomColumnLabels) |
[since 6.11] customRowLabels : QStringList
Cette propriété contient les étiquettes de ligne personnalisées facultatives pour le tableau.
Ces libellés remplacent les libellés générés par un proxy. Les index de ce tableau correspondent aux index des lignes du tableau de données. Si la liste est plus courte que le nombre de lignes, toutes les lignes n'auront pas d'étiquettes.
Cette propriété a été introduite dans Qt 6.11.
Fonctions d'accès :
| QStringList | customRowLabels() const |
| void | setCustomRowLabels(const QStringList &labels) |
Signal Notifier :
| 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 modifié, sauf si newDataArray est identique au précédent.
Remarque : avant de faire quoi que ce soit concernant le tableau de données, 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 Notifier :
| void | dataArrayChanged(const QBarDataArray &array) |
Voir aussi clearRow(qsizetype rowIndex) et clearArray().
dataProxy : QBarDataProxy*
Cette propriété contient le proxy de données actif.
La série assume la propriété de tout proxy qui lui est associé et supprime tout proxy précédemment défini lorsqu'un nouveau proxy est ajouté. Le proxy ne peut pas être nul ou associé à 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 en degrés.
La définition de cette propriété est équivalente à l'appel suivant :
setMeshRotation(QQuaternion::fromAxisAndAngle(0.0f, 1.0f, 0.0f, angle))
Remarque : lors de la lecture de cette propriété, elle est calculée à partir de la valeur QAbstract3DSeries::meshRotation en utilisant une précision à 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 du notificateur :
| void | meshAngleChanged(float angle) |
Voir aussi QAbstract3DSeries::meshRotation.
[since 6.11] rowAxis : QCategory3DAxis*
Contient un axe de ligne supplémentaire pour la série
Note : L'axe supplémentaire n'ajuste pas l'ajustement du graphique, mais permet un ensemble supplémentaire d'étiquettes et une grille d'axe.
Cette propriété a été introduite dans Qt 6.11.
Fonctions d'accès :
| QCategory3DAxis * | rowAxis() const |
| void | setRowAxis(QCategory3DAxis *axis) |
| void | resetRowAxis() |
Notifier signal :
| void | rowAxisChanged(QCategory3DAxis *axis) |
rowColors : QList<QColor>
Cette propriété contient la liste des couleurs des lignes de la série.
Cette propriété peut être utilisée pour colorer les lignes de la série en différentes couleurs. L'adresse QGraphsTheme::ColorStyle doit être définie sur QGraphsTheme::ColorStyle::Uniform pour pouvoir utiliser cette propriété.
Fonctions d'accès :
| QList<QColor> | rowColors() const |
| void | setRowColors(const QList<QColor> &colors) |
Notifier signal :
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
Voir aussi QGraphsTheme::ColorStyle::Uniform.
rowLabels : QStringList
Cette propriété contient les étiquettes facultatives des lignes du tableau.
Les index de ce tableau correspondent aux index des lignes du tableau de données. Si la liste est plus courte que le nombre de lignes, toutes les lignes ne seront pas étiquetées.
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 qui est 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étient un axe de valeur supplémentaire pour la série Si un axe est donné, la série sera ajustée aux valeurs minimales et maximales de l'axe.
Cette propriété a été introduite dans Qt 6.11.
Fonctions d'accès :
| QValue3DAxis * | valueAxis() const |
| void | setValueAxis(QValue3DAxis *axis) |
| void | resetValueAxis() |
Notificateur signal :
| void | valueAxisChanged(QValue3DAxis *axis) |
[since 6.9] valueColoringEnabled : bool
Utiliser la valeur donnée pour colorer l'ensemble de la barre en fonction du gradient de la plage
Cette propriété peut être utilisée pour colorer chaque barre séparément en fonction de sa valeur et du gradient de plage donné. L'adresse QGraphsTheme::ColorStyle doit être définie sur QGraphsTheme::ColorStyle::RangeGradient pour utiliser cette propriété.
Cette propriété a été introduite dans Qt 6.9.
Fonctions d'accès :
| bool | isValueColoringEnabled() const |
| void | setValueColoringEnabled(bool enabled) |
Signal Notifier :
| void | valueColoringEnabledChanged(bool enabled) |
Voir aussi QGraphsTheme::ColorStyle::RangeGradient.
Documentation des fonctions membres
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
Construit une série 3D de barres avec le parent parent.
[explicit] QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
Construit une série 3D de barres avec le proxy de données dataProxy et le 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 dans le tableau en fonction de l'adresse rowIndex.
[static] QPoint QBar3DSeries::invalidSelectionPosition()
Renvoie une position invalide pour la sélection. Cette position est définie dans la propriété selectedBar pour effacer la sélection de cette série.
Voir aussi Q3DGraphsWidgetItem::clearSelection().
void QBar3DSeries::setSelectedBar(QPoint position)
Sélectionne la barre à la position position, spécifiée comme 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, invalidSelectionPosition() est défini comme position.
Si cette série est ajoutée à un graphique, celui-ci peut ajuster la sélection en fonction de l'interaction de l'utilisateur ou si elle 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 : fonction de 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.
