Theme3D QML Type

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

• Liste de tous les membres, y compris les membres hérités

Propriétés

• ambientLightStrength : real
• backgroundColor : color
• backgroundEnabled : bool
• baseColors : list<ThemeColor>
• baseGradients : list<ColorGradient>
• colorStyle : Theme3D.ColorStyle
• font : font
• gridEnabled : bool
• gridLineColor : color
• highlightLightStrength : real
• labelBackgroundColor : color
• labelBackgroundEnabled : bool
• labelBorderEnabled : bool
• labelTextColor : color
• lightColor : color
• lightStrength : real
• multiHighlightColor : color
• multiHighlightGradient : ColorGradient
• singleHighlightColor : color
• singleHighlightGradient : ColorGradient
• type : Theme3D.Theme
• windowColor : color

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 énumère les propriétés contrôlées par les thèmes et les valeurs par défaut pour Theme3D.ThemeUserDefined.

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.

Documentation sur les propriétés

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 gradients 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

La couleur des lignes de la grille.

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. Sans 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 un arrière-plan sont dessinées à des tailles égales par axe en fonction 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 des objets sélectionnés. Utilisée si selectionMode a le drapeau AbstractGraph3D.SelectionRow ou AbstractGraph3D.SelectionColumn activé.

multiHighlightGradient : ColorGradient

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

singleHighlightColor : color

La couleur de surbrillance d'un objet sélectionné. Utilisée si selectionMode a le drapeau AbstractGraph3D.SelectionItem activé.

singleHighlightGradient : ColorGradient

Le gradient de mise en évidence d'un objet sélectionné. Utilisé si l'option AbstractGraph3D.SelectionItem est activée sur selectionMode.

type : Theme3D.Theme

Le type du 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é.