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 DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake : | QT += datavisualization |
| Depuis : | QtDataVisualization 1.0 |
| En QML : | Bar3DSeries |
| Hérites : | QAbstract3DSeries |
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 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 et toutes les données qui y ont été ajoutées.
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 Data Visualization Data Handling et QAbstract3DGraph::locale.
Documentation sur les propriétés
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.3] 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 Q3DTheme::ColorStyle doit être définie sur Q3DTheme::ColorStyleUniform pour pouvoir utiliser cette propriété.
Cette propriété a été introduite dans Qt 6.3.
Fonctions d'accès :
| QList<QColor> | rowColors() const |
| void | setRowColors(const QList<QColor> &colors) |
Notifier signal :
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
Voir aussi Q3DTheme::ColorStyleUniform.
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(const QPoint &position) |
Signal de notification :
| void | selectedBarChanged(const QPoint &position) |
Member Function Documentation
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
Construit une barre en série 3D avec la barre mère 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.
[virtual noexcept] QBar3DSeries::~QBar3DSeries()
Supprime une série de barres 3D.
[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 QAbstract3DGraph::clearSelection().
void QBar3DSeries::setSelectedBar(const 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 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.
