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 DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake : | QT += datavisualization |
| Depuis : | QtDataVisualization 1.0 |
| En QML : | Bar3DSeries |
| Hérite de : | QAbstract3DSeries |
| Statut : | Obsolète |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Propriétés
- dataProxy : QBarDataProxy*
- meshAngle : float
(since 6.3)rowColors : QList<QColor>- selectedBar : QPoint
Fonctions publiques
| QBar3DSeries(QObject *parent = nullptr) | |
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() |
| QBarDataProxy * | dataProxy() const |
| float | meshAngle() const |
| QList<QColor> | rowColors() const |
| QPoint | selectedBar() const |
| void | setDataProxy(QBarDataProxy *proxy) |
| void | setMeshAngle(float angle) |
| void | setRowColors(const QList<QColor> &colors) |
| void | setSelectedBar(const QPoint &position) |
Signaux
| void | dataProxyChanged(QBarDataProxy *proxy) |
| void | meshAngleChanged(float angle) |
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
| void | selectedBarChanged(const QPoint &position) |
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).
Si aucun proxy de données n’est explicitement défini 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 qui y ont été ajoutées.
QBar3DSeries prend en charge les balises de format suivantes pour la méthode ` 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 graphique. |
| @rowLabel | Étiquette de l'axe des lignes |
| @colLabel | Étiquette de l'axe des colonnes |
| @valueLabel | Valeur de l'élément mise en forme 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 dans le format spécifié. Formatée selon les mêmes règles que QValue3DAxis::labelFormat. |
Par exemple :
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));Voir également «Gestion des données »( Qt Data Visualization ) et «Gestion des propriétés » ( QAbstract3DGraph::locale).
Documentation sur les propriétés
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) 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.3] 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'Q3DTheme::ColorStyle doit être défini sur « Q3DTheme::ColorStyleUniform ».
Cette énumération a été introduite dans Qt 6.3.
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 Q3DTheme::ColorStyleUniform.
selectedBar : QPoint
Cette propriété contient la barre de la série sélectionnée.
Fonctions d'accès :
| QPoint | selectedBar() const |
| void | setSelectedBar(const QPoint &position) |
Signal de notification :
| void | selectedBarChanged(const QPoint &position) |
Documentation des fonctions membres
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
Crée une série de barres 3D dont l'parent-parent est .
[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 du parent parent.
[virtual noexcept] QBar3DSeries::~QBar3DSeries()
Supprime une série de barres 3D.
[static] QPoint QBar3DSeries::invalidSelectionPosition()
Renvoie une position non valide pour la sélection. Cette position est attribuée à la propriété ` selectedBar ` afin d’effacer la sélection de cette série.
Voir également QAbstract3DGraph::clearSelection().
void QBar3DSeries::setSelectedBar(const QPoint &position)
Sélectionne la barre située à la position position, spécifiée 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 désélectionner cette série, la fonction ` invalidSelectionPosition()` est définie comme suit : ` 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 cette même barre reste sélectionnée.
Remarque : fonctionde définition de la propriété selectedBar.
Voir également selectedBar() et QAbstract3DGraph::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.
