Theme3D QML Type

Un style visuel pour les graphiques. En savoir plus…

Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

• 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 permet de définir les propriétés visuelles qui s'appliquent à 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 redéfinies à l'aide des propriétés ` Abstract3DSeries ` pour les définir explicitement dans la série : ` baseColors`, ` baseGradients` et ` colorStyle`.

Il est possible de créer des thèmes à partir de zéro en utilisant la valeur d’é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 ».

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é avec 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 énumérations Theme3D, consultez 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é de l'affichage des couleurs sur l'ensemble du graphique, quelle que soit la position de la source lumineuse. 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étermine si l'arrière-plan est dessiné en utilisant la valeur de ` backgroundColor`.

baseColors : list<ThemeColor>

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 recommence depuis le début avec la première couleur de la liste. N’a aucun effet immédiat si ` colorStyle ` n’est pas défini sur ` Theme3D.ColorStyleUniform`.

Ce comportement peut être remplacé en définissant explicitement Abstract3DSeries.baseColor dans la série.

baseGradients : list<ColorGradient>

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 dégradés, la liste des dégradés recommence depuis le début en reprenant le premier dégradé de la liste.

N'a aucun effet immédiat si colorStyle est défini sur 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. L'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étermine si les lignes de la grille sont affichées. Cette valeur s'applique à 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

Couleur de l'arrière-plan des étiquettes. N'a aucun effet si la valeur de « labelBackgroundEnabled » est « false ».

labelBackgroundEnabled : bool

Détermine si l'étiquette est dessinée avec un arrière-plan utilisant l'labelBackgroundColor e (y compris l'alpha), ou avec un arrière-plan entièrement transparent. Les étiquettes dotées d'un arrière-plan sont dessinées à des tailles identiques pour chaque axe, en fonction de l'étiquette la plus longue, et le texte y est centré. 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étermine si les bordures des étiquettes sont dessinées pour les étiquettes comportant un arrière-plan. N'a aucun effet si le paramètre « labelBackgroundEnabled » est défini sur « 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

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 définie dans Scene3D.

multiHighlightColor : color

Couleur de mise en évidence des objets sélectionnés. Utilisée si la variable ` selectionMode ` est associée aux indicateurs ` AbstractGraph3D.SelectionRow ` ou ` AbstractGraph3D.SelectionColumn `.

multiHighlightGradient : ColorGradient

Le dégradé de mise en évidence des objets sélectionnés. Utilisé si la propriété « selectionMode » comporte le drapeau « AbstractGraph3D.SelectionRow » ou « AbstractGraph3D.SelectionColumn ».

singleHighlightColor : color

selectionMode Couleur de mise en évidence d'un objet sélectionné. Utilisée lorsque l'option « AbstractGraph3D.SelectionItem » est activée via le drapeau « ».

singleHighlightGradient : ColorGradient

Le dégradé de mise en évidence d'un objet sélectionné. Utilisé si l'selectionMode e a le drapeau « AbstractGraph3D.SelectionItem » activé.

type : Theme3D.Theme

Le type du thème. Si aucun type n'est défini, le type par défaut est « Theme3D.ThemeUserDefined ». La modification du type de thème après la création de l'élément entraînera la mise à jour de toutes les autres propriétés du thème conformément aux spécifications du thème prédéfini. La modification du type du thème actif du graphique entraînera également la réinitialisation de toutes les séries associées afin qu'elles utilisent le nouveau thème.

windowColor : color

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