QAbstract3DSeries Class
La classe `QAbstract3DSeries` est une classe de base pour toutes les séries de données. En savoir plus...
| 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 de : | QObject |
| Hérité par : | |
| Statut : | Obsolète |
Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
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, consultez la section « Traitement des données » deQt Data Visualization .
Documentation sur les types de membres
enum QAbstract3DSeries::Mesh
Types de maillage prédéfinis. Tous les styles ne sont pas compatibles avec tous les types de visualisation.
| Constante | Valeur | Description |
|---|---|---|
QAbstract3DSeries::MeshUserDefined | 0 | Maillage défini par l'utilisateur, configuré 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'ont aucun effet sur ce style. L'Q3DTheme::ColorStyleObjectGradient s de style de couleur n'est pas prise en charge par ce style. |
enum QAbstract3DSeries::SeriesType
Type de la série.
| Constante | Valeur | Description |
|---|---|---|
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 également colorStyle et Q3DTheme::baseColors.
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 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 le libellé formaté de l'élément.
Si aucun élément n'est sélectionné ou si l'élément sélectionné n'est pas visible, renvoie une chaîne vide.
Cette énumération a été introduite dans QtDataVisualization 1.1.
Fonctions d’accès :
| QString | itemLabel() const |
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éments individuels, 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étermine la visibilité des libellés des éléments dans le graphique.
Si la valeur est « true », les étiquettes des éléments sont affichées 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 ».
Cette énumération a été introduite dans QtDataVisualization 1.1.
Fonctions d'accès :
| bool | isItemLabelVisible() const |
| void | setItemLabelVisible(bool visible) |
Signal de notification :
| 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 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 graphe.
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 l'option « true » est activée, 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 l’option « 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(const QColor &color) |
Signal de notification :
| void | multiHighlightColorChanged(const QColor &color) |
Voir également colorStyle et Q3DTheme::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 Q3DTheme::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(const QColor &color) |
Signal de notification :
| void | singleHighlightColorChanged(const QColor &color) |
Voir également colorStyle et Q3DTheme::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 Q3DTheme::singleHighlightGradient.
[read-only] type : const 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 l'option « mesh » (Maillage personnalisé) est définie sur « MeshUserDefined » (Fichier).
Remarque : le fichier doit être au format Wavefront OBJ et inclure les sommets, les normales et les coordonnées UV. Il doit également être composé de 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é est définie sur « 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 | visibilityChanged(bool visible) |
Documentation des fonctions membres
[virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()
Supprime la série 3D abstraite.
[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(const 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.
