QAbstract3DSeries Class
La classe QAbstract3DSeries est une classe de base pour toutes les séries de données. Plus d'informations...
| En-tête : | #include <QAbstract3DSeries> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake : | QT += datavisualization |
| Depuis : | QtDataVisualization 1.0 |
| En QML : | Abstract3DSeries |
| Hérite : | QObject |
| Hérité par : |
Types publics
| enum | Mesh { MeshUserDefined, MeshBar, MeshCube, MeshPyramid, MeshCone, …, MeshPoint } |
| enum | SeriesType { SeriesTypeNone, SeriesTypeBar, SeriesTypeScatter, SeriesTypeSurface } |
Propriétés
|
|
Fonctions publiques
| virtual | ~QAbstract3DSeries() |
| QColor | baseColor() const |
| QLinearGradient | baseGradient() const |
| Q3DTheme::ColorStyle | colorStyle() const |
| bool | isItemLabelVisible() const |
| bool | isMeshSmooth() const |
| bool | isVisible() const |
| QString | itemLabel() const |
| QString | itemLabelFormat() const |
| QAbstract3DSeries::Mesh | mesh() const |
| QQuaternion | meshRotation() const |
| QColor | multiHighlightColor() const |
| QLinearGradient | multiHighlightGradient() const |
| QString | name() const |
| void | setBaseColor(const QColor &color) |
| void | setBaseGradient(const QLinearGradient &gradient) |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
| void | setItemLabelFormat(const QString &format) |
| void | setItemLabelVisible(bool visible) |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
| void | setMeshAxisAndAngle(const QVector3D &axis, float angle) |
| void | setMeshRotation(const QQuaternion &rotation) |
| void | setMeshSmooth(bool enable) |
| void | setMultiHighlightColor(const QColor &color) |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
| void | setName(const QString &name) |
| void | setSingleHighlightColor(const 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(const QColor &color) |
| void | baseGradientChanged(const QLinearGradient &gradient) |
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
| void | itemLabelChanged(const QString &label) |
| void | itemLabelFormatChanged(const QString &format) |
| void | itemLabelVisibilityChanged(bool visible) |
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
| void | meshRotationChanged(const QQuaternion &rotation) |
| void | meshSmoothChanged(bool enabled) |
| void | multiHighlightColorChanged(const QColor &color) |
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
| void | nameChanged(const QString &name) |
| void | singleHighlightColorChanged(const QColor &color) |
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
| void | userDefinedMeshChanged(const QString &fileName) |
| void | visibilityChanged(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 Data Visualization Data Handling.
Documentation sur les types de membres
enum QAbstract3DSeries::Mesh
Types de maillage prédéfinis. Tous les styles ne sont pas utilisables avec tous les types de visualisation.
| Constante | Valeur | Description |
|---|---|---|
QAbstract3DSeries::MeshUserDefined | 0 | Maillage défini par l'utilisateur, via la propriété QAbstract3DSeries::userDefinedMesh. |
QAbstract3DSeries::MeshBar | 1 | Barre rectangulaire de base. |
QAbstract3DSeries::MeshCube | 2 | Cube de base. |
QAbstract3DSeries::MeshPyramid | 3 | Pyramide à quatre faces. |
QAbstract3DSeries::MeshCone | 4 | Cône de base. |
QAbstract3DSeries::MeshCylinder | 5 | Cylindre de base. |
QAbstract3DSeries::MeshBevelBar | 6 | Barre rectangulaire légèrement biseautée (arrondie). |
QAbstract3DSeries::MeshBevelCube | 7 | Cube légèrement biseauté (arrondi). |
QAbstract3DSeries::MeshSphere | 8 | Sphère. |
QAbstract3DSeries::MeshMinimal | 9 | Le maillage 3D minimal : une pyramide triangulaire. Utilisable uniquement avec Q3DScatter. |
QAbstract3DSeries::MeshArrow | 10 | Flèche pointant vers le haut. |
QAbstract3DSeries::MeshPoint | 11 | Point 2D. Utilisable uniquement avec Q3DScatter. Les ombres n'affectent pas ce style. Le style de couleur Q3DTheme::ColorStyleObjectGradient n'est pas pris en charge par ce style. |
enum QAbstract3DSeries::SeriesType
Type de série.
| Constante | Valeur | Description de la série |
|---|---|---|
QAbstract3DSeries::SeriesTypeNone | 0 | Pas de type de série. |
QAbstract3DSeries::SeriesTypeBar | 1 | Type de série pour Q3DBars. |
QAbstract3DSeries::SeriesTypeScatter | 2 | Type de série pour Q3DScatter. |
QAbstract3DSeries::SeriesTypeSurface | 4 | Type de série pour Q3DSurface. |
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(const QColor &color) |
Signal de notification :
| void | baseColorChanged(const QColor &color) |
Voir aussi colorStyle et Q3DTheme::baseColors.
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 Q3DTheme::baseGradients.
colorStyle : Q3DTheme::ColorStyle
Cette propriété définit le style de couleur de la série.
Fonctions d'accès :
| Q3DTheme::ColorStyle | colorStyle() const |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
Signal de notification :
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
Voir aussi Q3DTheme::ColorStyle.
[read-only, since QtDataVisualization 1.1] 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.
Cette propriété a été introduite dans QtDataVisualization 1.1.
Fonctions d'accès :
| QString | itemLabel() const |
Signal Notifier :
| 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 : QBar3DSeries, QScatter3DSeries, QSurface3DSeries.
Fonctions d'accès :
| QString | itemLabelFormat() const |
| void | setItemLabelFormat(const QString &format) |
Signal de notification :
| void | itemLabelFormatChanged(const QString &format) |
[since QtDataVisualization 1.1] 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.
Cette propriété a été introduite dans QtDataVisualization 1.1.
Fonctions d'accès :
| bool | isItemLabelVisible() const |
| void | setItemLabelVisible(bool visible) |
Signal Notifier :
| void | itemLabelVisibilityChanged(bool visible) |
Voir également itemLabelFormat et itemLabel.
mesh : 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 la maille 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 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 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(const QColor &color) |
Signal de notification :
| void | multiHighlightColorChanged(const QColor &color) |
Voir aussi colorStyle et Q3DTheme::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 Q3DTheme::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(const QColor &color) |
Signal de notification :
| void | singleHighlightColorChanged(const QColor &color) |
Voir aussi colorStyle et Q3DTheme::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 Q3DTheme::singleHighlightGradient.
[read-only] type : const 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.
Note : Le fichier doit être au format Wavefront OBJ et inclure les vertices, les normales et les UVs. Il doit également être en triangles.
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 | visibilityChanged(bool visible) |
Member Function Documentation
[virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()
Supprime la série 3D abstraite.
[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(const 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.
