QAbstract3DSeries Class
La classe QAbstract3DSeries est une classe de base pour toutes les séries de données 3D. Plus d'informations...
| 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 : | QObject |
| Héritée par : |
- Liste de tous les membres, y compris les membres hérités
- QAbstract3DSeries fait partie de Qt Graphs C++ Classes for 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, voir Qt Graphs Data Handling with 3D.
Documentation sur les types de membres
enum class QAbstract3DSeries::LightingMode
Modes d'éclairage prédéfinis
| Constante | Valeur | Description du mode d'éclairage |
|---|---|---|
QAbstract3DSeries::LightingMode::Shaded | 0 | Les graphiques répondent à l'éclairage en temps réel |
QAbstract3DSeries::LightingMode::Unshaded | -1 | Les graphiques ne répondent pas à l'éclairage en temps réel |
enum class QAbstract3DSeries::Mesh
Types de maillage prédéfinis. Tous les styles ne sont pas utilisables avec tous les types de graphes.
| Constante | Valeur | Description |
|---|---|---|
QAbstract3DSeries::Mesh::UserDefined | 0 | Maillage défini par l'utilisateur, 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 2D. Utilisable uniquement avec Q3DScatterWidgetItem. Les ombres n'affectent pas ce style. Le style de couleur QGraphsTheme::ColorStyle::ObjectGradient n'est pas pris en charge par ce style. |
enum class QAbstract3DSeries::SeriesType
Type de série.
| Constante | Valeur | Description de la série |
|---|---|---|
QAbstract3DSeries::SeriesType::None | 0 | Pas de 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 aussi colorStyle et QGraphsTheme::seriesColors.
baseGradient : QLinearGradient
Cette propriété contient le gradient 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 aussi 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 l'étiquette formatée 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 du notificateur :
| void | itemLabelChanged(const QString &label) |
Voir aussi itemLabelFormat.
itemLabelFormat : QString
Cette propriété définit le format de l'étiquette pour les éléments de données de cette série.
Ce format est utilisé pour les étiquettes d'un seul élément, 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éfinit la visibilité des étiquettes d'éléments dans le graphique.
Si true, les étiquettes d'éléments sont dessinées comme des étiquettes flottantes dans le graphique. Dans le cas contraire, les étiquettes d'éléments ne sont pas affichées. Pour afficher l'étiquette d'élément dans un contrôle externe, cette propriété est définie sur false. La valeur par défaut est true.
Fonctions d'accès :
| bool | isItemLabelVisible() const |
| void | setItemLabelVisible(bool visible) |
Signal Notifier :
| void | itemLabelVisibleChanged(bool visible) |
Voir également itemLabelFormat et itemLabel.
[since 6.10] lightingMode : QAbstract3DSeries::LightingMode
Cette propriété contient le mode d'éclairage de la série
Cette propriété a été introduite dans Qt 6.10.
Fonctions d'accès :
| QAbstract3DSeries::LightingMode | lightingMode() const |
| void | setLightingMode(QAbstract3DSeries::LightingMode lightingMode) |
Signal Notifier :
| 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 MeshUserDefined, la propriété userDefinedMesh doit également être définie pour que les éléments soient rendus 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 qui est appliquée à tous les éléments de la série.
La rotation doit être une valeur normalisée QQuaternion. Pour les types de séries qui prennent en charge la rotation spécifique à un élément, les rotations sont multipliées ensemble. QBar3DSeries ignore toute rotation qui n'est pas autour de l'axe des y. QSurface3DSeries applique la rotation uniquement au pointeur de sélection. Par défaut, il n'y a pas de rotation.
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é indique si les versions lisses des maillages prédéfinis sont utilisées.
Si true, les versions lisses définies par la propriété mesh sont utilisées. Cette propriété n'affecte pas les maillages personnalisés utilisés lorsque le maillage est défini comme MeshUserDefined. La valeur par défaut est false.
Fonctions d'accès :
| bool | isMeshSmooth() const |
| void | setMeshSmooth(bool enable) |
Notifier signal :
| 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 aussi colorStyle et QGraphsTheme::multiHighlightColor.
multiHighlightGradient : QLinearGradient
Cette propriété contient le gradient 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 aussi 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é sous forme d'étiquette d'article 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 aussi itemLabelFormat.
singleHighlightColor : QColor
Cette propriété définit la couleur de mise en évidence d'un seul élément de la série.
Fonctions d'accès :
| QColor | singleHighlightColor() const |
| void | setSingleHighlightColor(QColor color) |
Signal de notification :
| void | singleHighlightColorChanged(QColor color) |
Voir aussi colorStyle et QGraphsTheme::singleHighlightColor.
singleHighlightGradient : QLinearGradient
Cette propriété contient le gradient de mise en évidence d'un seul élément 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 aussi colorStyle et QGraphsTheme::singleHighlightGradient.
[read-only] type : const QAbstract3DSeries::SeriesType
Cette propriété contient 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 mesh est 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é vaut false, la série n'est pas rendue. La valeur par défaut est true.
Fonctions d'accès :
| bool | isVisible() const |
| void | setVisible(bool visible) |
Signal Notificateur :
| void | visibleChanged(bool visible) |
Member Function Documentation
[override virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()
Supprime la série 3D abstraite.
[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(QVector3D axis, float angle)
Une fonction de commodité pour construire un quaternion de rotation de maillage à partir de axis et angle.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de 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.
