QAbstract3DSeries Class
La classe `QAbstract3DSeries` est une classe de base pour toutes les séries de données 3D. En savoir plus...
| En-tête : | #include <QAbstract3DSeries> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake : | QT += graphs |
| En QML : | Abstract3DSeries |
| Hérite de : | QObject |
| Hérité par : |
- Liste de tous les membres, y compris les membres hérités
- QAbstract3DSeries fait partie des classes C++ d'Qt Graphs pour la 3D.
Types publics
| enum class | LightingMode { Shaded, Unshaded } |
| enum class | Mesh { UserDefined, Bar, Cube, Pyramid, Cone, …, Point } |
| enum class | SeriesType { None, Bar, Scatter, Surface } |
Propriétés
|
|
Fonctions publiques
| virtual | ~QAbstract3DSeries() override |
| QColor | baseColor() const |
| QLinearGradient | baseGradient() const |
| QGraphsTheme::ColorStyle | colorStyle() const |
| bool | isItemLabelVisible() const |
| bool | isMeshSmooth() const |
| bool | isVisible() const |
| QString | itemLabel() |
| QString | itemLabelFormat() const |
| QAbstract3DSeries::LightingMode | lightingMode() const |
| QAbstract3DSeries::Mesh | mesh() const |
| QQuaternion | meshRotation() const |
| QColor | multiHighlightColor() const |
| QLinearGradient | multiHighlightGradient() const |
| QString | name() const |
| void | setBaseColor(QColor color) |
| void | setBaseGradient(const QLinearGradient &gradient) |
| void | setColorStyle(QGraphsTheme::ColorStyle style) |
| void | setItemLabelFormat(const QString &format) |
| void | setItemLabelVisible(bool visible) |
| void | setLightingMode(QAbstract3DSeries::LightingMode lightingMode) |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
| void | setMeshAxisAndAngle(QVector3D axis, float angle) |
| void | setMeshRotation(const QQuaternion &rotation) |
| void | setMeshSmooth(bool enable) |
| void | setMultiHighlightColor(QColor color) |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
| void | setName(const QString &name) |
| void | setSingleHighlightColor(QColor color) |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
| void | setUserDefinedMesh(const QString &fileName) |
| void | setVisible(bool visible) |
| QColor | singleHighlightColor() const |
| QLinearGradient | singleHighlightGradient() const |
| QAbstract3DSeries::SeriesType | type() const |
| QString | userDefinedMesh() const |
Signaux
| void | baseColorChanged(QColor color) |
| void | baseGradientChanged(const QLinearGradient &gradient) |
| void | colorStyleChanged(QGraphsTheme::ColorStyle style) |
| void | itemLabelChanged(const QString &label) |
| void | itemLabelFormatChanged(const QString &format) |
| void | itemLabelVisibleChanged(bool visible) |
| void | lightingModeChanged(QAbstract3DSeries::LightingMode lightingMode) |
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
| void | meshRotationChanged(const QQuaternion &rotation) |
| void | meshSmoothChanged(bool enabled) |
| void | multiHighlightColorChanged(QColor color) |
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
| void | nameChanged(const QString &name) |
| void | singleHighlightColorChanged(QColor color) |
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
| void | userDefinedMeshChanged(const QString &fileName) |
| void | visibleChanged(bool visible) |
Description détaillée
Il existe des classes héritées pour chaque type de série pris en charge : QBar3DSeries, QScatter3DSeries et QSurface3DSeries.
Pour plus d’informations, consultez la section « Traitement des donnéesQt Graphs en 3D ».
Documentation sur les types de membres
enum class QAbstract3DSeries::LightingMode
Modes d'éclairage prédéfinis
| Constant | Valeur | Description |
|---|---|---|
QAbstract3DSeries::LightingMode::Shaded | 0 | Les graphiques réagissent à l'éclairage en temps réel |
QAbstract3DSeries::LightingMode::Unshaded | -1 | Les graphiques ne réagissent pas à l'éclairage en temps réel |
enum class QAbstract3DSeries::Mesh
Types de maillage prédéfinis. Tous les styles ne sont pas compatibles avec tous les types de graphiques.
| Constante | Valeur | Description |
|---|---|---|
QAbstract3DSeries::Mesh::UserDefined | 0 | Maillage défini par l'utilisateur, configuré via la propriété « QAbstract3DSeries::userDefinedMesh ». |
QAbstract3DSeries::Mesh::Bar | 1 | Barre rectangulaire de base. |
QAbstract3DSeries::Mesh::Cube | 2 | Cube de base. |
QAbstract3DSeries::Mesh::Pyramid | 3 | Pyramide à quatre faces. |
QAbstract3DSeries::Mesh::Cone | 4 | Cône de base. |
QAbstract3DSeries::Mesh::Cylinder | 5 | Cylindre de base. |
QAbstract3DSeries::Mesh::BevelBar | 6 | Barre rectangulaire légèrement biseautée (arrondie). |
QAbstract3DSeries::Mesh::BevelCube | 7 | Cube légèrement biseauté (arrondi). |
QAbstract3DSeries::Mesh::Sphere | 8 | Sphère. |
QAbstract3DSeries::Mesh::Minimal | 9 | Le maillage 3D minimal : une pyramide triangulaire. Utilisable uniquement avec Q3DScatterWidgetItem. |
QAbstract3DSeries::Mesh::Arrow | 10 | Flèche pointant vers le haut. |
QAbstract3DSeries::Mesh::Point | 11 | Point en 2D. Utilisable uniquement avec Q3DScatterWidgetItem. Les ombres n'ont aucun effet sur ce style. Le style de couleur « QGraphsTheme::ColorStyle::ObjectGradient » n'est pas pris en charge par ce style. |
enum class QAbstract3DSeries::SeriesType
Type de la série.
| Constante | Valeur | Description |
|---|---|---|
QAbstract3DSeries::SeriesType::None | 0 | Aucun type de série. |
QAbstract3DSeries::SeriesType::Bar | 1 | Type de série pour Q3DBarsWidgetItem. |
QAbstract3DSeries::SeriesType::Scatter | 2 | Type de série pour Q3DScatterWidgetItem. |
QAbstract3DSeries::SeriesType::Surface | 3 | Type de série pour Q3DSurfaceWidgetItem. |
Documentation sur les propriétés
baseColor : QColor
Cette propriété définit la couleur de base de la série.
Fonctions d'accès :
| QColor | baseColor() const |
| void | setBaseColor(QColor color) |
Signal de notification :
| void | baseColorChanged(QColor color) |
Voir également colorStyle et QGraphsTheme::seriesColors.
baseGradient : QLinearGradient
Cette propriété définit le dégradé de base de la série.
Fonctions d'accès :
| QLinearGradient | baseGradient() const |
| void | setBaseGradient(const QLinearGradient &gradient) |
Signal de notification :
| void | baseGradientChanged(const QLinearGradient &gradient) |
Voir également colorStyle et QGraphsTheme::seriesGradients.
colorStyle : QGraphsTheme::ColorStyle
Cette propriété définit le style de couleur de la série.
Fonctions d'accès :
| QGraphsTheme::ColorStyle | colorStyle() const |
| void | setColorStyle(QGraphsTheme::ColorStyle style) |
Signal de notification :
| void | colorStyleChanged(QGraphsTheme::ColorStyle style) |
Voir aussi QGraphsTheme::ColorStyle.
[read-only] itemLabel : QString
Cette propriété contient le libellé formaté de l'élément.
S'il n'y a pas d'élément sélectionné ou si l'élément sélectionné n'est pas visible, elle renvoie une chaîne vide.
Fonctions d'accès :
| QString | itemLabel() |
Signal de notification :
| void | itemLabelChanged(const QString &label) |
Voir également itemLabelFormat.
itemLabelFormat : QString
Cette propriété définit le format d'étiquette des éléments de données de cette série.
Ce format est utilisé pour les étiquettes d'élément unique, par exemple lorsqu'un élément est sélectionné. L'interprétation du format dépend du type de série.
Fonctions d'accès :
| QString | itemLabelFormat() const |
| void | setItemLabelFormat(const QString &format) |
Signal de notification :
| void | itemLabelFormatChanged(const QString &format) |
Voir également QBar3DSeries, QScatter3DSeries et QSurface3DSeries.
itemLabelVisible : bool
Cette propriété détermine la visibilité des libellés des éléments dans le graphique.
Si la valeur est « true », les étiquettes des éléments s’affichent sous forme d’étiquettes flottantes dans le graphique. Dans le cas contraire, elles ne s’affichent pas. Pour afficher l’étiquette d’un élément dans un contrôle externe, cette propriété doit être définie sur « false ». La valeur par défaut est « true ».
Fonctions d’accès :
| bool | isItemLabelVisible() const |
| void | setItemLabelVisible(bool visible) |
Signal de notification :
| void | itemLabelVisibleChanged(bool visible) |
Voir également itemLabelFormat et itemLabel.
[since 6.10] lightingMode : QAbstract3DSeries::LightingMode
Cette propriété définit le mode d'éclairage de la série
Cette énumération a été introduite dans Qt 6.10.
Fonctions d'accès :
| QAbstract3DSeries::LightingMode | lightingMode() const |
| void | setLightingMode(QAbstract3DSeries::LightingMode lightingMode) |
Signal de notification :
| void | lightingModeChanged(QAbstract3DSeries::LightingMode lightingMode) |
Voir aussi LightingMode.
mesh : QAbstract3DSeries::Mesh
Cette propriété contient le maillage des éléments de la série.
Pour « QSurface3DSeries », cette propriété contient le pointeur de sélection.
Si le maillage est de type MeshUserDefined, la propriété « userDefinedMesh » doit également être définie pour que les éléments s'affichent correctement. La valeur par défaut dépend du type de graphique.
Fonctions d'accès :
| QAbstract3DSeries::Mesh | mesh() const |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
Signal de notification :
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
meshRotation : QQuaternion
Cette propriété contient la rotation du maillage appliquée à tous les éléments de la série.
La rotation doit être une valeur normalisée de type ` QQuaternion`. Pour les types de séries prenant en charge une rotation spécifique à chaque élément, les rotations sont multipliées entre elles. ` QBar3DSeries ` ignore toute rotation qui ne s'effectue pas autour de l'axe y. ` QSurface3DSeries ` applique la rotation uniquement au pointeur de sélection. Par défaut, aucune rotation n'est appliquée.
Fonctions d’accès :
| QQuaternion | meshRotation() const |
| void | setMeshRotation(const QQuaternion &rotation) |
Signal de notification :
| void | meshRotationChanged(const QQuaternion &rotation) |
meshSmooth : bool
Cette propriété détermine si les versions lissées des maillages prédéfinis sont utilisées.
Si la valeur est « true », les versions lissées définies via la propriété « mesh » sont utilisées. Cette propriété n’affecte pas les maillages personnalisés utilisés lorsque la propriété «Mesh» est définie sur «MeshUserDefined». La valeur par défaut est « false ».
Fonctions d'accès :
| bool | isMeshSmooth() const |
| void | setMeshSmooth(bool enable) |
Signal de notification :
| void | meshSmoothChanged(bool enabled) |
multiHighlightColor : QColor
Cette propriété définit la couleur de mise en évidence des éléments multiples de la série.
Fonctions d'accès :
| QColor | multiHighlightColor() const |
| void | setMultiHighlightColor(QColor color) |
Signal de notification :
| void | multiHighlightColorChanged(QColor color) |
Voir également colorStyle et QGraphsTheme::multiHighlightColor.
multiHighlightGradient : QLinearGradient
Cette propriété définit le dégradé de mise en évidence des éléments multiples de la série.
Fonctions d'accès :
| QLinearGradient | multiHighlightGradient() const |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
Signal de notification :
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
Voir également colorStyle et QGraphsTheme::multiHighlightGradient.
name : QString
Cette propriété contient le nom de la série.
Le nom de la série peut être utilisé dans le format d'étiquette d'élément avec la balise @seriesName.
Fonctions d'accès :
| QString | name() const |
| void | setName(const QString &name) |
Signal de notification :
| void | nameChanged(const QString &name) |
Voir également itemLabelFormat.
singleHighlightColor : QColor
Cette propriété définit la couleur de mise en évidence d'un élément unique de la série.
Fonctions d'accès :
| QColor | singleHighlightColor() const |
| void | setSingleHighlightColor(QColor color) |
Signal de notification :
| void | singleHighlightColorChanged(QColor color) |
Voir également colorStyle et QGraphsTheme::singleHighlightColor.
singleHighlightGradient : QLinearGradient
Cette propriété définit le dégradé de mise en évidence d'un élément unique de la série.
Fonctions d'accès :
| QLinearGradient | singleHighlightGradient() const |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
Signal de notification :
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
Voir également colorStyle et QGraphsTheme::singleHighlightGradient.
[read-only] type : const QAbstract3DSeries::SeriesType
Cette propriété indique le type de la série.
Fonctions d'accès :
| QAbstract3DSeries::SeriesType | type() const |
userDefinedMesh : QString
Cette propriété contient le nom de fichier d'un maillage personnalisé défini par l'utilisateur pour les objets.
Le maillage personnalisé est utilisé lorsque la propriété « mesh » est définie sur « MeshUserDefined ».
Remarque : le fichier doit être au format de maillage « QtQuick3D ». Utilisez l'outil de conversion « balsam » pour créer un maillage à partir d'autres formats de modèles 3D.
Fonctions d’accès :
| QString | userDefinedMesh() const |
| void | setUserDefinedMesh(const QString &fileName) |
Signal de notification :
| void | userDefinedMeshChanged(const QString &fileName) |
visible : bool
Cette propriété définit la visibilité de la série.
Si cette propriété prend la valeur « false », la série n'est pas affichée. La valeur par défaut est « true ».
Fonctions d'accès :
| bool | isVisible() const |
| void | setVisible(bool visible) |
Signal de notification :
| void | visibleChanged(bool visible) |
Documentation des fonctions membres
[override virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()
Supprime la série 3D abstraite.
[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(QVector3D axis, float angle)
Une fonction pratique permettant de construire un quaternion de rotation de maillage à partir de axis et angle.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Voir également meshRotation.
© 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.
