GraphsView QML Type
Tipo base para todas las vistas de « Qt Graphs ». Más...
| Import Statement: | import QtGraphs |
- Lista de todos los miembros, incluidos los miembros heredados
- GraphsView forma parte de los tipos QML deQt Graphs para 2D.
Propiedades
- axisX : AbstractAxis
- axisXSmoothing : real
- axisY : AbstractAxis
- axisYSmoothing : real
- clipPlotArea : bool
(since 6.10) - dynamicLabelMargins : bool
- gridSmoothing : real
- marginBottom : real
- marginLeft : real
- marginRight : real
- marginTop : real
- orientation : Qt.Orientation
- panStyle : enumeration
(since 6.9) - plotArea : rect
(since 6.9) - seriesList : list
- shadowBarWidth : real
- shadowColor : color
- shadowSmoothing : real
- shadowVisible : bool
- shadowXOffset : real
- shadowYOffset : real
- theme : GraphsTheme
- zoomAreaDelegate : Component
(since 6.9) - zoomAreaEnabled : bool
(since 6.9) - zoomSensitivity : real
(since 6.9) - zoomStyle : enumeration
(since 6.9)
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 agrupa las series y los temas, y dibuja los gráficos. Para utilizar este tipo, tendrás que importar el módulo Qt Graphs:
import QtGraphsA continuación, podrás utilizar GraphsView en tus 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]
}
}
}
Véase también BarSeries, LineSeries, BarCategoryAxis, ValueAxis y GraphsTheme.
Documentación de propiedades
axisX : AbstractAxis
El eje x utilizado para las series de esta vista.
Nota: No se admitela configuración del mismo eje para varias vistas GraphsView.
Véase también axisY.
axisXSmoothing : real
Controla el nivel de suavizado (antialiasing) del eje X del gráfico. Por defecto, el suavizado es de 1.0.
axisY : AbstractAxis
El eje Y utilizado para las series de esta vista.
Nota: No se admitela configuración del mismo eje para varias vistas GraphsView.
Véase también axisX.
axisYSmoothing : real
Controla el grado de suavizado (antialiasing) del eje Y del gráfico. Por defecto, el suavizado es de 1.0.
clipPlotArea : bool [since 6.10]
Determina si los elementos del gráfico deben recortarse si se salen del área de trazado. El valor por defecto es « true ».
Esta propiedad se introdujo en Qt 6.10.
Véase también plotArea.
dynamicLabelMargins : bool
Esta propiedad determina si los márgenes de las etiquetas se ajustan dinámicamente.
Por defecto, las etiquetas más anchas que el margen asignado se superponen a otros elementos del gráfico. Cuando está activada, el renderizador reserva espacio adicional para dichas etiquetas y reposiciona los ejes para evitar la superposición.
gridSmoothing : real
Controla el nivel de suavizado (antialiasing) de la cuadrícula del gráfico. Por defecto, el suavizado es de 1.0.
marginBottom : real
El espacio libre que hay en la parte inferior del gráfico. Por defecto, el margen es de 20.
marginLeft : real
El espacio en blanco a la izquierda del gráfico. Por defecto, el margen es de 20.
marginRight : real
La cantidad de espacio en blanco a la derecha del gráfico. Por defecto, el margen es de 20.
marginTop : real
El espacio libre 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 intercambiarán sus posiciones, de modo que axisX se muestre en vertical y axisY en horizontal. Actualmente, esta propiedad la utiliza BarSeries. El valor por defecto es Qt.Vertical.
panStyle : enumeration [since 6.9]
Determina el estilo de desplazamiento del elemento « GraphsView ». El desplazamiento se realiza manipulando la propiedad «pan» de un elemento « ValueAxis ». El valor por defecto es « GraphsView.PanStyle.None ».
| Constante | Descripción |
|---|---|
GraphsView.PanStyle.None | El desplazamiento está desactivado. |
GraphsView.PanStyle.Drag | El arrastre con el ratón o con el tacto permite desplazar la vista. |
Esta propiedad se introdujo en Qt 6.9.
plotArea : rect [read-only, since 6.9]
El rectángulo dentro del cual se dibuja el gráfico. Se trata del área « 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 se muestran mediante el control « GraphsView ». Se rellena automáticamente con los elementos secundarios del tipo «serie» del control « GraphsView ».
Esta es la propiedad por defecto, por lo que los elementos secundarios 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 cuadrícula del gráfico. Por defecto, el ancho de la sombra está establecido en « 2.0 ».
shadowColor : color
Controla el color de la sombra de la cuadrícula del gráfico. Por defecto, el color de la sombra está establecido en black.
shadowSmoothing : real
Controla el nivel de suavizado de las sombras (antialiasing) de la cuadrícula del gráfico. Por defecto, el suavizado de las sombras está establecido en « 4.0 ».
shadowVisible : bool
Determina si la sombra de la cuadrícula del gráfico está visible. Por defecto, la visibilidad de la sombra está configurada en « false ».
shadowXOffset : real
Controla el desplazamiento en X de la sombra de la cuadrícula del gráfico. Por defecto, el desplazamiento en X de la sombra está establecido en « 0.0 ».
shadowYOffset : real
Controla el desplazamiento en Y de la sombra de la cuadrícula del gráfico. Por defecto, el desplazamiento en Y de la sombra está establecido en 0.0.
theme : GraphsTheme
El tema utilizado por el gráfico. Determina los colores, las líneas de los ejes, las fuentes, etc. Si no se ha establecido ningún tema, se utiliza el tema predeterminado.
zoomAreaDelegate : Component [since 6.9]
Determina el elemento QML que se dibuja cuando el usuario realiza un movimiento de arrastre para ampliar una zona.
Esta propiedad se introdujo en Qt 6.9.
zoomAreaEnabled : bool [since 6.9]
La función «Zoom area» transforma el arrastre con el ratón o el tacto en el trazado de un rectángulo determinado por zoomAreaDelegate. Al soltar el ratón, se modifican las propiedades de zoom y desplazamiento del gráfico ValueAxis, de modo que la vista cubra únicamente el área que se cruza con el rectángulo trazado.
Esta propiedad se introdujo en Qt 6.9.
Véase también zoomAreaDelegate.
zoomSensitivity : real [since 6.9]
Determina la rapidez con la que cambia el valor del zoom al ampliar o reducir la imagen.
Esta propiedad se introdujo en Qt 6.9.
zoomStyle : enumeration [since 6.9]
Determina el estilo de zoom de ` GraphsView`. El zoom funciona mediante la manipulación de la propiedad ` ValueAxis ` de zoom. El valor por defecto es ` GraphsView.ZoomStyle.None`.
| Constante | Descripción |
|---|---|
GraphsView.ZoomStyle.None | El zoom está desactivado. |
GraphsView.ZoomStyle.Center | El zoom por pellizco y el zoom con la rueda del ratón se realizan hacia el centro de la vista del gráfico. |
Esta propiedad se introdujo en Qt 6.9.
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 forma parte del grafo, se trasladará al final.
bool hasSeries(AbstractSeries series)
Devuelve « true » si « series » está en el grafo.
void insertSeries(int index, AbstractSeries series)
Inserta un « series » en la posición especificada por « index ». Si « series » es nulo, no se insertará. Si « series » ya forma parte del grafo, se trasladará a « index ».
void removeSeries(AbstractSeries series)
Elimina el « series » del gráfico.
void removeSeries(int index)
Elimina del gráfico la serie especificada mediante ` 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.