GraphsView QML Type
Tipo base para todas las vistas de Qt Graphs. Más...
| Import Statement: | import QtGraphs |
- Lista de todos los miembros, incluyendo los heredados
- GraphsView es parte de Qt Graphs QML Types for 2D.
Propiedades
- axisX : AbstractAxis
- axisXSmoothing : real
- axisY : AbstractAxis
- axisYSmoothing : real
- clipPlotArea : bool
(since 6.10) - gridSmoothing : real
- marginBottom : real
- marginLeft : real
- marginRight : real
- marginTop : real
- orientation : Qt.Orientation
- panStyle : enumeration
- plotArea : rect
(since 6.9) - seriesList : list
- shadowBarWidth : real
- shadowColor : color
- shadowSmoothing : real
- shadowVisible : bool
- shadowXOffset : real
- shadowYOffset : real
- theme : GraphsTheme
- zoomAreaDelegate : Component
- zoomAreaEnabled : bool
- zoomSensitivity : real
- zoomStyle : enumeration
Métodos
- void addSeries(AbstractSeries series)
- bool hasSeries(AbstractSeries series)
- void insertSeries(int index, AbstractSeries series)
- void removeSeries(AbstractSeries series)
- void removeSeries(int index)
Descripción detallada
Esta clase reúne las series y los temas y dibuja los gráficos. Necesitará importar el módulo Qt Graphs para utilizar esta clase:
import QtGraphsDespués de que usted puede utilizar GraphsView en sus archivos qml:
import QtQuick import QtGraphs GraphsView { anchors.fill: parent theme: GraphsTheme { colorScheme: GraphsTheme.ColorScheme.Dark seriesColors: ["#E0D080", "#B0A060"] borderColors: ["#807040", "#706030"] grid.mainColor: "#ccccff" grid.subColor: "#eeeeff" axisY.mainColor: "#ccccff" axisY.subColor: "#eeeeff" } axisX: BarCategoryAxis { categories: ["2023", "2024", "2025"] lineVisible: false } axisY: ValueAxis { min: 0 max: 10 subTickCount: 4 } BarSeries { BarSet { values: [7, 6, 9] } BarSet { values: [9, 8, 6] } } }

Vea también BarSeries, LineSeries, BarCategoryAxis, ValueAxis, y GraphsTheme.
Documentación de propiedades
axisX : AbstractAxis
El eje x utilizado para la serie dentro de esta vista.
Nota: No es posible asignar el mismo eje a varios GraphsViews.
Véase también axisY.
axisXSmoothing : real
Controla la cantidad de suavizado (antialiasing) del eje X del gráfico. Por defecto, el suavizado es 1.0.
axisY : AbstractAxis
El eje y utilizado para la serie dentro de esta vista.
Nota: No es posible asignar el mismo eje a varios GraphsViews.
Véase también axisX.
axisYSmoothing : real
Controla la cantidad de suavizado (antialiasing) del eje Y del gráfico. Por defecto, el suavizado es 1.0.
clipPlotArea : bool [since 6.10]
Controla si los elementos del gráfico deben recortarse si salen de un área de trazado. El valor por defecto es true.
Esta propiedad se introdujo en Qt 6.10.
Véase también plotArea.
gridSmoothing : real
Controla la cantidad de suavizado (antialiasing) de la rejilla gráfica. Por defecto, el suavizado es 1.0.
marginBottom : real
La cantidad de espacio vacío en la parte inferior del gráfico. Por defecto, el margen es de 20.
marginLeft : real
La cantidad de espacio vacío a la izquierda del gráfico. Por defecto, el margen es 20.
marginRight : real
La cantidad de espacio vacío a la derecha del gráfico. Por defecto, el margen es de 20.
marginTop : real
La cantidad de espacio vacío en la parte superior del gráfico. Por defecto, el margen es de 20.
orientation : Qt.Orientation
Determina la orientación de GraphsView. Cuando la orientación es Qt.Horizontal, axisX y axisY cambiarán las posiciones de modo que axisX se renderice verticalmente y axisY horizontalmente. Esta propiedad es utilizada actualmente por BarSeries. El valor por defecto es Qt.Vertical.
panStyle : enumeration
Determina el estilo de panoramización de GraphsView. La panoramización funciona manipulando la propiedad de panoramización de ValueAxis. El valor por defecto es GraphsView.PanStyle.None.
| Constante | Descripción |
|---|---|
GraphsView.PanStyle.None | La panorámica está desactivada. |
GraphsView.PanStyle.Drag | El ratón y el arrastre táctil desplazan la vista. |
plotArea : rect [read-only, since 6.9]
El rectángulo dentro del cual se dibuja el gráfico. Es el área de GraphsView menos las áreas de los ejes y los márgenes.
Esta propiedad se introdujo en Qt 6.9.
Véase también marginTop, marginBottom, marginLeft, y marginRight.
seriesList : list [read-only]
Lista de series que son renderizadas por el GraphsView. Se rellena automáticamente con las series tipo hijas del GraphsView.
Esta es la propiedad por defecto, por lo que los elementos hijos se añaden automáticamente a la lista de series.
Véase también BarSeries, LineSeries, y ScatterSeries.
shadowBarWidth : real
Controla el ancho de la sombra de la rejilla del gráfico. Por defecto, el ancho de la sombra se establece en 2.0.
shadowColor : color
Controla el color de la sombra de la rejilla del gráfico. Por defecto, el color de la sombra es black.
shadowSmoothing : real
Controla la cantidad de suavizado de sombras (antialiasing) de la rejilla gráfica. Por defecto, el suavizado de sombras se establece en 4.0.
shadowVisible : bool
Controla si la sombra de la rejilla del gráfico es visible. Por defecto, la visibilidad de la sombra se establece en false.
shadowXOffset : real
Controla el desplazamiento X de la sombra de la rejilla gráfica. Por defecto, el desplazamiento X de la sombra se establece en 0.0.
shadowYOffset : real
Controla el desplazamiento Y de la sombra de la rejilla gráfica. Por defecto, el desplazamiento Y de la sombra se establece en 0.0.
theme : GraphsTheme
El tema utilizado por el gráfico. Determina el color, las líneas de los ejes, las fuentes, etc. Si no se ha establecido el tema, se utiliza el tema por defecto.
zoomAreaDelegate : Component
Determina el elemento QML que se dibuja cuando el usuario realiza un movimiento de arrastre para ampliar un área.
zoomAreaEnabled : bool
El área de zoom cambia al arrastrar con el ratón y el tacto para dibujar una caja determinada por zoomAreaDelegate. Al soltar, las propiedades de zoom y desplazamiento del gráfico ValueAxis cambian para que la vista cubra sólo el área intersectada por la caja dibujada.
Véase también zoomAreaDelegate.
zoomSensitivity : real
Determina la rapidez con la que cambia el valor del zoom al hacer zoom.
zoomStyle : enumeration
Determina el estilo de zoom de GraphsView. El zoom funciona manipulando la propiedad zoom de ValueAxis. El valor por defecto es GraphsView.ZoomStyle.None.
| Constante | Descripción |
|---|---|
GraphsView.ZoomStyle.None | El zoom está desactivado. |
GraphsView.ZoomStyle.Center | El zoom de pellizco y la rueda del ratón hacen zoom hacia el centro de la vista del gráfico. |
Documentación del método
void addSeries(AbstractSeries series)
Añade un series a GraphsView. Si series es nulo, no se añadirá. Si series ya pertenece al gráfico, se moverá al final.
bool hasSeries(AbstractSeries series)
Devuelve true si series está en el gráfico.
void insertSeries(int index, AbstractSeries series)
Inserta un series en la posición especificada por index. Si series es nulo, no se insertará. Si el series ya pertenece al gráfico, se moverá a index.
void removeSeries(AbstractSeries series)
Elimina la dirección series del gráfico.
void removeSeries(int index)
Elimina del gráfico la serie especificada por index.
© 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.