Theme3D QML Type

Un style visuel pour les graphiques. Plus d'informations...

Import Statement: import QtDataVisualization 1.10
Since: QtDataVisualization 1.0
In C++: Q3DTheme

Propriétés

Description détaillée

Ce type est utilisé pour spécifier les propriétés visuelles qui affectent l'ensemble du graphique. Il existe plusieurs thèmes intégrés qui peuvent être utilisés tels quels ou modifiés librement.

Les propriétés suivantes peuvent être remplacées en utilisant les propriétés Abstract3DSeries pour les définir explicitement dans la série : baseColors, baseGradients, et colorStyle.

Les thèmes peuvent être créés à partir de zéro en utilisant la valeur de l'énumération Theme3D.ThemeUserDefined.

Thème par défaut

Le tableau suivant répertorie les propriétés contrôlées par les thèmes et les valeurs par défaut pour Theme3D.ThemeUserDefined.

PropriétéValeur par défaut
ambientLightStrength0.25
backgroundColor"noir". Pour plus d'informations, voir color.
backgroundEnabledtrue
baseColors"noir"
baseGradientsQLinearGradient. Essentiellement entièrement noir.
colorStyleColorStyleUniform
fontfont
gridEnabledtrue
gridLineColor"blanc" .
highlightLightStrength7.5
labelBackgroundColor"gris
labelBackgroundEnabledtrue
labelBorderEnabledtrue
labelTextColor"blanc"
lightColor"gris" 7,5 "blanc"
lightStrength5.0
multiHighlightColor"bleu"
multiHighlightGradientQLinearGradient. Essentiellement entièrement noir.
singleHighlightColor"rouge"
singleHighlightGradientQLinearGradient. Essentiellement entièrement noir.
windowColor"noir"

Exemples d'utilisation

Utilisation d'un thème intégré sans aucune modification :

Scatter3D {
    ...
    theme: Theme3D { type: Theme3D.ThemeRetro }
    ...
}

Utilisation d'un thème intégré et modification de certaines propriétés :

Bars3D {
    ...
    theme: Theme3D {
        type: Theme3D.ThemeRetro
        labelBorderEnabled: true
        font.pointSize: 35
        labelBackgroundEnabled: false
    }
    ...
}

Utilisation d'un thème défini par l'utilisateur :

Surface3D {
    ...
    theme: Theme3D {
        ambientLightStrength: 0.5
        backgroundColor: "red"
        backgroundEnabled: true
        baseColor: "blue"
        colorStyle: Theme3D.ColorStyleUniform
        font.family: "Lucida Handwriting"
        font.pointSize: 35
        gridEnabled: false
        gridLineColor: "black"
        highlightLightStrength: 0.5
        labelBackgroundColor: "black"
        labelBackgroundEnabled: true
        labelBorderEnabled: false
        labelTextColor: "white"
        lightColor: "yellow"
        lightStrength: 0.4
        multiHighlightColor: "green"
        singleHighlightColor: "darkRed"
        windowColor: "white"
    }
    ...
}

Pour les enums Theme3D, voir Q3DTheme::ColorStyle et Q3DTheme::Theme.

Propriété Documentation

ambientLightStrength : real

L'intensité de la lumière ambiante pour l'ensemble du graphique. Cette valeur détermine l'uniformité et la luminosité des couleurs sur l'ensemble du graphique, quelle que soit la position de la lumière. La valeur doit être comprise entre 0.0 et 1.0.


backgroundColor : color

La couleur de l'arrière-plan du graphique.


backgroundEnabled : bool

Définit si l'arrière-plan est dessiné en utilisant la valeur de backgroundColor.


baseColors : list<ThemeColor>

La liste des couleurs de base à utiliser pour tous les objets du graphique, série par série. S'il y a plus de séries que de couleurs, la liste des couleurs s'enroule et recommence avec la première couleur de la liste. N'a pas d'effet immédiat si colorStyle n'est pas Theme3D.ColorStyleUniform.

Il est possible de passer outre en définissant explicitement Abstract3DSeries.baseColor dans la série.


baseGradients : list<ColorGradient>

La liste des dégradés de base à utiliser pour tous les objets du graphique, série par série. S'il y a plus de séries que de gradients, la liste des gradients s'arrête et recommence avec le premier gradient de la liste.

N'a pas d'effet immédiat si colorStyle est Theme3D.ColorStyleUniform.

Cette valeur peut être remplacée en définissant explicitement Abstract3DSeries.baseGradient dans la série.


colorStyle : Theme3D.ColorStyle

Le style des couleurs du graphique. Une des valeurs de l'énumération Q3DTheme::ColorStyle.

Cette valeur peut être remplacée en définissant explicitement Abstract3DSeries.colorStyle dans la série.

Voir également Q3DTheme::ColorStyle.


font : font

Définit la police à utiliser pour les étiquettes.


gridEnabled : bool

Définit si les lignes de la grille sont dessinées. Cette valeur affecte toutes les lignes de la grille.


gridLineColor : color

Couleur des lignes de la grille.

Remarque : la transparence n'est pas prise en charge et entraînera un comportement indéfini.


highlightLightStrength : real

L'intensité de la lumière spéculaire pour les objets sélectionnés. La valeur doit être comprise entre 0.0 et 10.0.


labelBackgroundColor : color

La couleur de l'arrière-plan des étiquettes. N'a pas d'effet si labelBackgroundEnabled est false.


labelBackgroundEnabled : bool

Définit si l'étiquette est dessinée avec un arrière-plan qui utilise labelBackgroundColor (y compris alpha), ou avec un arrière-plan entièrement transparent. Les étiquettes avec arrière-plan sont dessinées à des tailles égales par axe sur la base de l'étiquette la plus longue, et le texte est centré dans ces étiquettes. Les étiquettes sans arrière-plan sont dessinées telles quelles et sont alignées à gauche ou à droite en fonction de leur position dans le graphique.


labelBorderEnabled : bool

Définit si les bordures des étiquettes sont dessinées pour les étiquettes qui ont un arrière-plan. Sans effet si labelBackgroundEnabled est false.


labelTextColor : color

La couleur de la police utilisée pour les étiquettes.


lightColor : color

La couleur de la lumière ambiante et spéculaire définie dans Scene3D.


lightStrength : real

L'intensité de la lumière spéculaire pour l'ensemble du graphique. La valeur doit être comprise entre 0.0 et 10.0.

Cette valeur affecte la lumière spécifiée dans Scene3D.


multiHighlightColor : color

La couleur de surbrillance pour les objets sélectionnés. Utilisée si selectionMode a le drapeau AbstractGraph3D.SelectionRow ou AbstractGraph3D.SelectionColumn activé.

Remarque : la transparence n'est pas prise en charge et entraînera un comportement indéfini.


multiHighlightGradient : ColorGradient

Le gradient de mise en évidence des objets sélectionnés. Utilisé si selectionMode a l'indicateur AbstractGraph3D.SelectionRow ou AbstractGraph3D.SelectionColumn activé.

Remarque : la transparence n'est pas prise en charge et entraînera un comportement indéfini.


singleHighlightColor : color

Couleur de mise en évidence d'un objet sélectionné. Utilisée si selectionMode a l'indicateur AbstractGraph3D.SelectionItem activé.

Remarque : la transparence n'est pas prise en charge et entraînera un comportement indéfini.


singleHighlightGradient : ColorGradient

Le gradient de mise en évidence d'un objet sélectionné. Utilisé si selectionMode a l'indicateur AbstractGraph3D.SelectionItem activé.

Remarque : la transparence n'est pas prise en charge et entraînera un comportement indéfini.


type : Theme3D.Theme

Le type de thème. Si aucun type n'est défini, le type est Theme3D.ThemeUserDefined. La modification du type de thème après la construction de l'élément aura pour effet de modifier toutes les autres propriétés du thème en fonction du thème prédéfini. La modification du type de thème du thème actif du graphique réinitialisera également toutes les séries attachées pour qu'elles utilisent le nouveau thème.


windowColor : color

La couleur de la fenêtre d'application dans laquelle le graphique est dessiné.


© 2025 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.