GraphsTheme QML Type

Un style visuel pour les graphiques. En savoir plus...

• Liste de tous les membres, y compris les membres hérités
• GraphsTheme fait partie des types communs QML d'Qt Graphs .

Propriétés

• GraphsLine.labelTextColor : color
• GraphsLine.mainColor : color
• GraphsLine.mainWidth : real
• GraphsLine.subColor : color
• GraphsLine.subWidth : real
• axisX : GraphsLine
• axisXLabelFont : font
• axisY : GraphsLine
• axisYLabelFont : font
• axisZ : GraphsLine
• axisZLabelFont : font
• backgroundColor : color
• backgroundVisible : bool
• baseColors : list<Color>
• baseGradients : list<Gradient>
• borderColors : list<color>
• colorScheme : QGraphsTheme::ColorScheme
• colorStyle : GraphsTheme.ColorStyle
• grid : GraphsLine
• gridVisible : bool
• labelBackgroundColor : color
• labelBackgroundVisible : bool
• labelBorderVisible : bool
• labelFont : font
• labelTextColor : color
• labelsVisible : bool
• multiHighlightColor : color
• multiHighlightGradient : Gradient
• plotAreaBackgroundColor : color
• plotAreaBackgroundVisible : bool
• seriesColors : list<color>
• singleHighlightColor : color
• singleHighlightGradient : Gradient
• theme : GraphsTheme.Theme

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.

Il est possible de créer des thèmes à partir de zéro à l'aide de la valeur d'énumération ` GraphsTheme.Theme.UserDefined `.

Personnalisation du thème

Le thème par défaut est QtGreen, mais il est possible de personnaliser chaque propriété.

Le tableau suivant répertorie les propriétés contrôlées par un thème ainsi que les valeurs par défaut pour ` QGraphsTheme.Theme.UserDefined`.

Exemples d'utilisation

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

Scatter3D {
    theme: GraphsTheme { theme: GraphsTheme.Theme.YellowSeries }
    ...

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

Bars3D {
    theme: GraphsTheme {
        theme: GraphsTheme.Theme.QtGreenNeon
        labelBorderVisible: true
        labelFont.pointSize: 35
        labelBackgroundVisible: false
    }
    ...

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

Surface3D {
    theme: GraphsTheme {
        theme: GraphsTheme.Theme.UserDefined
        backgroundColor: "red"
        backgroundVisible: true
        seriesColors: ["blue"]
        colorStyle: GraphsTheme.ColorStyle.Uniform
        labelFont.family: "Lucida Handwriting"
        labelFont.pointSize: 35
        gridVisible: false
        grid.mainColor: "red"
        grid.subColor: "blue"
        labelBackgroundColor: "black"
        labelBackgroundVisible: true
        labelBorderVisible: false
        labelTextColor: "white"
        multiHighlightColor: "green"
        singleHighlightColor: "darkRed"
    }
    ...

Pour les énumérations GraphsTheme, voir GraphsTheme::colorStyle et GraphsTheme::theme.

Documentation sur les propriétés

GraphsLine.labelTextColor : color

Couleur du texte utilisé pour les étiquettes. La valeur par défaut dépend de l'option « colorScheme ».

GraphsLine.mainColor : color

La couleur des lignes principales. La valeur par défaut dépend de colorScheme.

GraphsLine.mainWidth : real

La largeur des lignes principales. La valeur par défaut est 2.0.

Si ce paramètre est défini pour les lignes de la grille, il n'a d'effet que si GraphsItem3D::gridLineType est Graphs3D.GridLineType.Shader

Voir également Graphs3D.GridLineType.

GraphsLine.subColor : color

La couleur des sous-lignes. La valeur par défaut dépend de colorScheme.

GraphsLine.subWidth : real

La largeur des sous-lignes. La valeur par défaut est « 1.0 ».

Si ce paramètre est défini pour les lignes de la grille, il n'a d'effet que si GraphsItem3D::gridLineType est Graphs3D.GridLineType.Shader

Voir également Graphs3D.GridLineType.

axisX : GraphsLine

Contient l'GraphsLine e de l'axe X.

Voir également GraphsLine.mainColor, GraphsLine.subColor, GraphsLine.mainWidth, GraphsLine.subWidth et GraphsLine.labelTextColor.

axisXLabelFont : font

Définit la police à utiliser pour les libellés sur axisX.

axisY : GraphsLine

Contient l'GraphsLine e de l'axe Y.

Voir également GraphsLine.mainColor, GraphsLine.subColor, GraphsLine.mainWidth, GraphsLine.subWidth et GraphsLine.labelTextColor.

axisYLabelFont : font

Définit la police à utiliser pour les libellés sur axisY.

axisZ : GraphsLine

Contient l'GraphsLine e de l'axe Z.

Voir également GraphsLine.mainColor, GraphsLine.subColor, GraphsLine.mainWidth, GraphsLine.subWidth et GraphsLine.labelTextColor.

axisZLabelFont : font

Définit la police à utiliser pour les libellés sur axisZ.

backgroundColor : color

Couleur de la vue dans laquelle le graphique est tracé. La valeur par défaut dépend de l'colorScheme.

backgroundVisible : bool

Détermine si l'arrière-plan de la vue est dessiné en utilisant la valeur de ` backgroundColor`. La valeur par défaut est ` true`.

baseColors : list<Color> [read-only]

Liste des couleurs de base de type Color à 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 se répète et recommence par la première couleur de la liste. N’a aucun effet immédiat si ` colorStyle ` n’est pas défini sur ` GraphsTheme.ColorStyle.Uniform`.

Exemple d'utilisation :

baseColors: [ Color { color: "red" } ]

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

baseGradients : list<Gradient> [read-only]

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 premier dégradé de la liste.

N'a aucun effet immédiat si ` colorStyle ` est défini sur ` GraphsTheme.ColorStyle.Uniform`.

Exemple d'utilisation :

baseGradients: [ Gradient {
    GradientStop { position: 1.0; color: "#DBEB00" }
    GradientStop { position: 0.0; color: "#373F26" }
} ]

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

borderColors : list<color>

Liste des couleurs de contour à 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 se répète et recommence par la première couleur de la liste.

N'a aucun effet immédiat si la propriété « colorStyle » n'est pas définie sur «Uniform».

colorScheme : QGraphsTheme::ColorScheme

La palette de couleurs du graphique utilisé.

Voir également QGraphsTheme::ColorScheme.

colorStyle : GraphsTheme.ColorStyle

Le style des couleurs du graphique. L'une des valeurs de l'énumération QGraphsTheme::ColorStyle.

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

Voir également QGraphsTheme::ColorStyle.

grid : GraphsLine

Contient l'GraphsLine du thème.

Voir également GraphsLine.mainColor, GraphsLine.subColor, GraphsLine.mainWidth, GraphsLine.subWidth et GraphsLine.labelTextColor.

gridVisible : bool

Détermine si les lignes de la grille sont affichées. Cette valeur s'applique à toutes les lignes de la grille. La valeur par défaut est « true ».

labelBackgroundColor : color

Couleur de l'arrière-plan des étiquettes. N'a aucun effet si la valeur de « labelBackgroundVisible » est « false ». La valeur par défaut dépend de « colorScheme ».

labelBackgroundVisible : 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 avec 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. La valeur par défaut est « true ».

labelBorderVisible : bool

Détermine si les bordures des étiquettes sont affichées pour celles qui possèdent un arrière-plan. N'a aucun effet si la propriété « labelBackgroundVisible » est définie sur « false ». La valeur par défaut est « true ».

labelFont : font

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

labelTextColor : color

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

Si la propriété « labelTextColor » a été explicitement définie pour un axe, cette option n'a aucun effet.

La valeur par défaut dépend de l'colorScheme.

labelsVisible : bool

Détermine si les étiquettes doivent être affichées ou non. Si cette option est définie sur « false », toutes les autres propriétés des étiquettes n'ont aucun effet. La valeur par défaut est « true ».

multiHighlightColor : color

Couleur de mise en évidence des objets sélectionnés. Utilisée si la propriété « selectionMode » est associée aux indicateurs « Graphs3D.SelectionFlag.Row » ou « Graphs3D.SelectionFlag.Column ». La valeur par défaut dépend de la propriété « colorScheme ».

Voir également Graphs3D.SelectionFlag.

multiHighlightGradient : Gradient

Le dégradé de surbrillance des objets sélectionnés. Utilisé si la propriété ` selectionMode ` est associée au drapeau ` Graphs3D.SelectionFlag.Row ` ou ` Graphs3D.SelectionFlag.Column `. La valeur par défaut dépend de la propriété ` colorScheme`.

Voir également Graphs3D.SelectionFlag.

plotAreaBackgroundColor : color

Couleur de l'arrière-plan de la zone de tracé du graphique. La valeur par défaut dépend de colorScheme.

plotAreaBackgroundVisible : bool

Détermine si l'arrière-plan de la zone de tracé est dessiné à l'aide de la valeur de ` plotAreaBackgroundColor`. La valeur par défaut est ` true`.

seriesColors : list<color>

Liste des couleurs à 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 revient au début et recommence avec la première couleur de la liste. N’a aucun effet immédiat si la propriété ` colorStyle ` n’est pas définie sur ` GraphsTheme.ColorStyle.Uniform`.

Exemple d'utilisation :

seriesColors: [ "red" ]

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

singleHighlightColor : color

Couleur de mise en évidence d'un objet sélectionné. Utilisée si l'option « selectionMode » est activée avec le drapeau « Graphs3D.SelectionFlag.Item ». La valeur par défaut dépend de « colorScheme ».

Voir également Graphs3D.SelectionFlag.

singleHighlightGradient : Gradient

Le dégradé de mise en évidence d'un objet sélectionné. Utilisé si selectionMode comporte le drapeau Graphs3D.SelectionFlag.Item. La valeur par défaut dépend de colorScheme.

Voir également Graphs3D.SelectionFlag.

theme : GraphsTheme.Theme

Le type du thème. Si aucun type n'est défini, le type par défaut est « GraphsTheme.Theme.QtGreen ». 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 de 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.