GraphsTheme QML Type
Un style visuel pour les graphiques. Plus d'informations...
| Import Statement: | import QtGraphs |
| In C++: | QGraphsTheme |
- Liste de tous les membres, y compris les membres hérités
- GraphsTheme fait partie de Qt Graphs QML Common Types.
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 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 thèmes peuvent être créés à partir de zéro en utilisant la valeur de l'enum 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 et les valeurs par défaut pour QGraphsTheme.Theme.UserDefined.
| Propriété | Valeur par défaut |
|---|---|
| backgroundVisible | true |
| seriesColors | Qt::black |
| baseGradients | QLinearGradient. Essentiellement entièrement noir. |
| colorStyle | Uniforme |
| labelFont | QFont |
| gridVisible | true |
| labelBackgroundVisible | true |
| labelBorderVisible | true |
| labelsVisible | true |
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 enums GraphsTheme, voir GraphsTheme::colorStyle et GraphsTheme::theme.
Documentation sur les propriétés
GraphsLine.labelTextColor : color
La couleur du texte utilisé pour les étiquettes. La valeur par défaut dépend de 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 elle est définie pour les lignes de la grille, elle n'a d'effet que si la valeur de GraphsItem3D::gridLineType est Graphs3D.GridLineType.Shader
Voir aussi 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 elle est définie pour les lignes de la grille, elle n'a d'effet que si la valeur de GraphsItem3D::gridLineType est Graphs3D.GridLineType.Shader
Voir aussi Graphs3D.GridLineType.
axisX : GraphsLine
Contient l'adresse GraphsLine 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 étiquettes sur axisX.
axisY : GraphsLine
Contient l'adresse GraphsLine 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 étiquettes sur axisY.
axisZ : GraphsLine
Contient l'adresse GraphsLine 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 étiquettes sur axisZ.
backgroundColor : color
La couleur de la vue dans laquelle le graphique est dessiné. La valeur par défaut dépend de colorScheme.
backgroundVisible : bool
Définit 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]
La 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 s'enroule et recommence avec la première couleur de la liste. N'a pas d'effet immédiat si colorStyle n'est pas GraphsTheme.ColorStyle.Uniform.
Exemple d'utilisation :
baseColors: [ Color { color: "red" } ]Ceci peut être surchargé en définissant explicitement Abstract3DSeries.baseColor dans la série.
baseGradients : list<Gradient> [read-only]
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 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>
La liste des couleurs de bordure à 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 Uniform.
colorScheme : QGraphsTheme::ColorScheme
Le schéma de couleurs du graphique utilisé.
Voir aussi QGraphsTheme::ColorScheme.
colorStyle : GraphsTheme.ColorStyle
Le style des couleurs du graphique. 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.
Remarque : cette propriété n'a pas d'effet sur Qt Graphs for 2D.
Voir également QGraphsTheme::ColorStyle.
grid : GraphsLine
Contient le site GraphsLine du thème.
Voir aussi GraphsLine.mainColor, GraphsLine.subColor, GraphsLine.mainWidth, GraphsLine.subWidth, et GraphsLine.labelTextColor.
gridVisible : bool
Définit si les lignes de la grille sont dessinées. Cette valeur affecte toutes les lignes de la grille. La valeur par défaut est true.
labelBackgroundColor : color
La couleur de l'arrière-plan des étiquettes. N'a aucun effet si labelBackgroundVisible est false. La valeur par défaut dépend de colorScheme.
labelBackgroundVisible : 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. La valeur par défaut est true.
labelBorderVisible : bool
Définit si les bordures des étiquettes sont dessinées pour les étiquettes qui ont un arrière-plan. N'a aucun effet si labelBackgroundVisible est 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 un axe a spécifié explicitement labelTextColor, cela n'a aucun effet.
La valeur par défaut dépend de colorScheme.
labelsVisible : bool
Définit si les étiquettes sont dessinées ou non. Si la valeur est false, toutes les autres propriétés de l'étiquette n'ont aucun effet. La valeur par défaut est true.
multiHighlightColor : color
La couleur de surbrillance des objets sélectionnés. Utilisée si selectionMode a le drapeau Graphs3D.SelectionFlag.Row ou Graphs3D.SelectionFlag.Column activé. La valeur par défaut dépend de colorScheme.
Voir également Graphs3D.SelectionFlag.
multiHighlightGradient : Gradient
Le gradient de mise en évidence des objets sélectionnés. Utilisé si selectionMode a le drapeau Graphs3D.SelectionFlag.Row ou Graphs3D.SelectionFlag.Column activé. La valeur par défaut dépend de colorScheme.
Voir également Graphs3D.SelectionFlag.
plotAreaBackgroundColor : color
La 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éfinit si l'arrière-plan de la zone de tracé est dessiné en utilisant la valeur de plotAreaBackgroundColor. La valeur par défaut est true.
seriesColors : list<color>
La 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 s'enroule et recommence avec la première couleur de la liste. N'a pas d'effet immédiat si colorStyle n'est pas GraphsTheme.ColorStyle.Uniform.
Exemple d'utilisation :
seriesColors: [ "red" ]
Ceci peut être surchargé en définissant explicitement Abstract3DSeries.baseColor dans la série.
singleHighlightColor : color
La couleur de surbrillance d'un objet sélectionné. Utilisée si selectionMode a le drapeau Graphs3D.SelectionFlag.Item activé. La valeur par défaut dépend de colorScheme.
Voir également Graphs3D.SelectionFlag.
singleHighlightGradient : Gradient
Le gradient de mise en évidence d'un objet sélectionné. Utilisé si selectionMode a le drapeau Graphs3D.SelectionFlag.Item activé. 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 est GraphsTheme.Theme.QtGreen. 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.
© 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.