GraphsTheme QML Type
Un estilo visual para gráficos. Más...
| Import Statement: | import QtGraphs |
| In C++: | QGraphsTheme |
- Lista de todos los miembros, incluidos los heredados
- GraphsTheme es parte de Qt Graphs QML Common Types.
Propiedades
- 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
Descripción detallada
Este tipo se utiliza para especificar propiedades visuales que afectan a todo el gráfico. Existen varios temas incorporados que pueden utilizarse tal cual o modificarse libremente.
Los temas pueden crearse desde cero utilizando el valor enum GraphsTheme.Theme.UserDefined.
Personalización del tema
El tema por defecto es QtGreen, pero es posible personalizar cada propiedad.
La siguiente tabla lista las propiedades controladas por un tema y los valores por defecto para QGraphsTheme.Theme.UserDefined.
| Propiedad | Valor por defecto |
|---|---|
| backgroundVisible | true |
| seriesColors | Qt::black |
| baseGradients | QLinearGradient. Esencialmente negro. |
| colorStyle | Uniforme |
| labelFont | QFont |
| gridVisible | true |
| labelBackgroundVisible | true |
| labelBorderVisible | true |
| labelsVisible | true |
Ejemplos de uso
Utilizando un tema incorporado sin ninguna modificación:
Scatter3D { theme: GraphsTheme { theme: GraphsTheme.Theme.YellowSeries } ...
Utilizando un tema incorporado y modificando algunas propiedades:
Bars3D { theme: GraphsTheme { theme: GraphsTheme.Theme.QtGreenNeon labelBorderVisible: true labelFont.pointSize: 35 labelBackgroundVisible: false } ...
Utilizar un tema definido por el usuario:
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" } ...
Para los enums de GraphsTheme, véase GraphsTheme::colorStyle y GraphsTheme::theme.
Documentación de propiedades
GraphsLine.labelTextColor : color
El color del texto utilizado para las etiquetas. El valor por defecto depende de colorScheme.
GraphsLine.mainColor : color
El color de las líneas principales. El valor por defecto depende de colorScheme.
GraphsLine.mainWidth : real
La anchura de las líneas principales. El valor por defecto es 2.0.
Si se establece para las líneas de la cuadrícula, sólo tiene efecto si GraphsItem3D::gridLineType es Graphs3D.GridLineType.Shader
Véase también Graphs3D.GridLineType.
GraphsLine.subColor : color
El color de las sublíneas. El valor por defecto depende de colorScheme.
GraphsLine.subWidth : real
La anchura de las sublíneas. El valor por defecto es 1.0.
Si se establece para líneas de cuadrícula, sólo tiene efecto si GraphsItem3D::gridLineType es Graphs3D.GridLineType.Shader
Véase también Graphs3D.GridLineType.
axisX : GraphsLine
Contiene la dirección GraphsLine del eje X.
Véase también GraphsLine.mainColor, GraphsLine.subColor, GraphsLine.mainWidth, GraphsLine.subWidth, y GraphsLine.labelTextColor.
axisXLabelFont : font
Establece el tipo de letra que se utilizará para las etiquetas en axisX.
axisY : GraphsLine
Contiene la dirección GraphsLine del eje Y.
Véase también GraphsLine.mainColor, GraphsLine.subColor, GraphsLine.mainWidth, GraphsLine.subWidth, y GraphsLine.labelTextColor.
axisYLabelFont : font
Establece el tipo de letra que se utilizará para las etiquetas en axisY.
axisZ : GraphsLine
Contiene el GraphsLine del eje Z.
Véase también GraphsLine.mainColor, GraphsLine.subColor, GraphsLine.mainWidth, GraphsLine.subWidth, y GraphsLine.labelTextColor.
axisZLabelFont : font
Establece el tipo de letra que se utilizará para las etiquetas en axisZ.
backgroundColor : color
El color de la vista en la que se dibuja el gráfico. El valor por defecto depende de colorScheme.
backgroundVisible : bool
Define si el fondo de la vista se dibuja utilizando el valor de backgroundColor. El valor por defecto es true.
baseColors : list<Color> [read-only]
La lista de colores base de tipo Color a utilizar para todos los objetos del gráfico, serie por serie. Si hay más series que colores, la lista de colores se envuelve y comienza de nuevo con el primer color de la lista. No tiene efecto inmediato si colorStyle no es GraphsTheme.ColorStyle.Uniform.
Ejemplo de uso:
baseColors: [ Color { color: "red" } ]Esto puede anularse estableciendo Abstract3DSeries.baseColor explícitamente en la serie.
baseGradients : list<Gradient> [read-only]
La lista de degradados base que se utilizará para todos los objetos del gráfico, serie por serie. Si hay más series que gradientes, la lista de gradientes se envuelve y comienza de nuevo con el primer gradiente de la lista.
No tiene efecto inmediato si colorStyle es GraphsTheme.ColorStyle.Uniform.
Ejemplo de uso:
baseGradients: [ Gradient {
GradientStop { position: 1.0; color: "#DBEB00" }
GradientStop { position: 0.0; color: "#373F26" }
} ]Este valor puede anularse estableciendo Abstract3DSeries.baseGradient explícitamente en la serie.
borderColors : list<color>
La lista de colores de borde que se utilizará para todos los objetos del gráfico, serie por serie.
Si hay más series que colores, la lista de colores se envuelve y comienza de nuevo con el primer color de la lista.
No tiene efecto inmediato si colorStyle no es Uniforme.
colorScheme : QGraphsTheme::ColorScheme
La combinación de colores del gráfico en uso.
Véase también QGraphsTheme::ColorScheme.
colorStyle : GraphsTheme.ColorStyle
El estilo de los colores del gráfico. Uno de los valores del enum QGraphsTheme::ColorStyle.
Este valor puede anularse configurando Abstract3DSeries.colorStyle explícitamente en la serie.
Nota: Esta propiedad no tiene efecto en Qt Graphs para 2D.
Véase también QGraphsTheme::ColorStyle.
grid : GraphsLine
Contiene el GraphsLine del tema.
Véase también GraphsLine.mainColor, GraphsLine.subColor, GraphsLine.mainWidth, GraphsLine.subWidth, y GraphsLine.labelTextColor.
gridVisible : bool
Define si se dibujan las líneas de la cuadrícula. Este valor afecta a todas las líneas de la cuadrícula. El valor por defecto es true.
labelBackgroundColor : color
El color del fondo de las etiquetas. No tiene efecto si labelBackgroundVisible es false. El valor por defecto depende de colorScheme.
labelBackgroundVisible : bool
Define si la etiqueta se dibuja con un fondo que utiliza labelBackgroundColor (incluyendo alfa), o con un fondo totalmente transparente. Las etiquetas con fondo se dibujan con tamaños iguales por eje en función de la etiqueta más larga, y el texto se centra en ellas. Las etiquetas sin fondo se dibujan tal cual y se alinean a la izquierda o a la derecha en función de su posición en el gráfico. El valor por defecto es true.
labelBorderVisible : bool
Define si se dibujan los bordes de las etiquetas que tienen fondo. No tiene efecto si labelBackgroundVisible es false. El valor por defecto es true.
labelFont : font
Establece la fuente que se utilizará para las etiquetas.
labelTextColor : color
El color de la fuente utilizada para las etiquetas.
Si un eje ha especificado labelTextColor explícitamente, esto no tiene ningún efecto.
El valor por defecto depende de colorScheme.
labelsVisible : bool
Define si las etiquetas se dibujan o no. Si es false, el resto de propiedades de las etiquetas no tienen ningún efecto. El valor por defecto es true.
multiHighlightColor : color
Color de realce de los objetos seleccionados. Se utiliza si selectionMode tiene activada la bandera Graphs3D.SelectionFlag.Row o Graphs3D.SelectionFlag.Column. El valor por defecto depende de colorScheme.
Véase también Graphs3D.SelectionFlag.
multiHighlightGradient : Gradient
El gradiente de resaltado de los objetos seleccionados. Se utiliza si selectionMode tiene activada la bandera Graphs3D.SelectionFlag.Row o Graphs3D.SelectionFlag.Column. El valor por defecto depende de colorScheme.
Véase también Graphs3D.SelectionFlag.
plotAreaBackgroundColor : color
El color del fondo del área del gráfico. El valor por defecto depende de colorScheme.
plotAreaBackgroundVisible : bool
Define si el fondo del área de trazado se dibuja utilizando el valor de plotAreaBackgroundColor. El valor por defecto es true.
seriesColors : list<color>
La lista de colores a utilizar para todos los objetos del gráfico, serie por serie. Si hay más series que colores, la lista de colores se envuelve y comienza de nuevo con el primer color de la lista. No tiene efecto inmediato si colorStyle no es GraphsTheme.ColorStyle.Uniform.
Ejemplo de uso:
seriesColors: [ "red" ]
Esto puede anularse estableciendo Abstract3DSeries.baseColor explícitamente en la serie.
singleHighlightColor : color
El color de resaltado de un objeto seleccionado. Se utiliza si selectionMode tiene activada la bandera Graphs3D.SelectionFlag.Item. El valor por defecto depende de colorScheme.
Véase también Graphs3D.SelectionFlag.
singleHighlightGradient : Gradient
El gradiente de resaltado de un objeto seleccionado. Se utiliza si selectionMode tiene activada la bandera Graphs3D.SelectionFlag.Item. El valor por defecto depende de colorScheme.
Véase también Graphs3D.SelectionFlag.
theme : GraphsTheme.Theme
Tipo del tema. Si no se define ningún tipo, el tipo es GraphsTheme.Theme.QtGreen. Si se cambia el tipo de tema una vez construido el elemento, todas las demás propiedades del tema cambiarán a lo que especifique el tema predefinido. Al cambiar el tipo de tema del tema activo del gráfico también se restablecerán todas las series adjuntas para que utilicen el nuevo tema.
© 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.