ChartView QML Type
Gestiona la representación gráfica de las series, las leyendas y los ejes del gráfico. Más...
| Import Statement: | import QtCharts 2.12 |
| Inherited By: | |
| Status: | Deprecated |
Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.
Propiedades
- animationDuration : int
- animationEasingCurve : easing
- animationOptions : enumeration
- axes : list<AbstractAxis>
- backgroundColor : color
- backgroundRoundness : real
- count : int
- dropShadowEnabled : bool
- legend : Legend
- locale : locale
(since QtCharts 2.0) - localizeNumbers : bool
(since QtCharts 2.0) - margins : Margins
- plotArea : rect
- plotAreaColor : color
- theme : enumeration
- title : string
- titleColor : color
- titleFont : font
Señales
- seriesAdded(AbstractSeries series)
- seriesRemoved(AbstractSeries series)
Métodos
- Axis axisX(AbstractSeries series)
- Axis axisY(AbstractSeries series)
- AbstractSeries createSeries(enumeration type, string name, AbstractAxis axisX, AbstractAxis axisY)
- bool isZoomed()
- point mapToPosition(point value, AbstractSeries series)
- point mapToValue(point position, AbstractSeries series)
- void removeAllSeries()
- void removeSeries(AbstractSeries series)
- void scrollDown(real pixels)
- void scrollLeft(real pixels)
- void scrollRight(real pixels)
- void scrollUp(real pixels)
- AbstractSeries series(int index)
- AbstractSeries series(string name)
- void setAxisX(AbstractAxis axis, AbstractSeries series)
- void setAxisY(AbstractAxis axis, AbstractSeries series)
- void zoom(real factor)
- void zoomIn()
- void zoomIn(rect rectangle)
- void zoomOut()
- void zoomReset()
Descripción detallada
El tipo ChartView muestra diferentes tipos de series en forma de gráficos.
Este ejemplo muestra cómo crear un gráfico de líneas sencillo:

ChartView {
title: "Line Chart"
anchors.fill: parent
antialiasing: true
LineSeries {
name: "Line"
XYPoint { x: 0; y: 0 }
XYPoint { x: 1.1; y: 2.1 }
XYPoint { x: 1.9; y: 3.3 }
XYPoint { x: 2.1; y: 2.1 }
XYPoint { x: 2.9; y: 4.9 }
XYPoint { x: 3.4; y: 3.0 }
XYPoint { x: 4.1; y: 3.3 }
}
}Documentación de propiedades
animationDuration : int
La duración de la animación del gráfico.
animationEasingCurve : easing
La curva de aceleración de la animación del gráfico.
animationOptions : enumeration
Las animaciones activadas en el gráfico:
| Constante | Descripción |
|---|---|
ChartView.NoAnimation | La animación está desactivada en el gráfico. Este es el valor por defecto. |
ChartView.GridAxisAnimations | La animación del eje de cuadrícula está activada en el gráfico. |
ChartView.SeriesAnimations | La animación de series está activada en el gráfico. |
ChartView.AllAnimations | Todos los tipos de animación están habilitados en el gráfico. |
axes : list<AbstractAxis>
Los ejes del gráfico.
backgroundColor : color
El color de fondo del gráfico. Por defecto, el color de fondo viene determinado por el tema del gráfico.
Véase también theme.
backgroundRoundness : real
El diámetro del círculo de redondeo en las esquinas del fondo del gráfico.
count : int
El número de series añadidas a la tabla.
dropShadowEnabled : bool
Si está activado el efecto de sombra de fondo.
Si se establece en « true », el efecto de sombra de fondo está activado. Si se establece en « false », está desactivado.
legend : Legend
La leyenda del gráfico. La leyenda muestra todas las series, porciones del gráfico circular y conjuntos de barras añadidos al gráfico.
locale : locale [since QtCharts 2.0]
La configuración regional utilizada para dar formato a las distintas etiquetas de los gráficos.
Las etiquetas se localizan únicamente cuando ` localizeNumbers ` es ` true`, salvo en el caso de las etiquetas de los ejes de fecha y hora, que siempre utilizan la configuración de ` QLocale ` establecida con esta propiedad.
Por defecto, se establece en la configuración regional predeterminada de la aplicación en el momento en que se crea el gráfico.
Esta propiedad se introdujo en QtCharts 2.0.
Véase también localizeNumbers.
localizeNumbers : bool [since QtCharts 2.0]
Si los números están localizados.
Cuando se establece true, todos los números generados que aparecen en las distintas series y en las etiquetas de los ejes se localizarán utilizando el formato de fecha y hora ( QLocale ) definido con la propiedad locale. Cuando se establece false, siempre se utiliza la configuración regional C. El valor predeterminado es false.
Nota: Esta propiedad no afecta a las etiquetas de DateTimeAxis, que siempre utilizan el valor « QLocale » establecido mediante la propiedad «locale».
Esta propiedad se introdujo en QtCharts 2.0.
Véase también locale.
margins : Margins
Los márgenes mínimos permitidos entre el borde del rectángulo del gráfico y el área de representación. Los márgenes se utilizan para dibujar el título, los ejes y la leyenda.
plotArea : rect
El rectángulo en el que se dibuja el gráfico.
El área de trazado no incluye el área definida por los márgenes. Por defecto, su tamaño se ajustará si se encuentra dentro de un ` ChartView`. Si se establece explícitamente un rectángulo para el área de trazado, se respetará dicho valor; para volver al comportamiento por defecto, basta con establecerlo en ` Qt.rect(0, 0, 0, 0) `.
Véase también ` margins`.
plotAreaColor : color
El color del fondo del área de trazado del gráfico. De forma predeterminada, el fondo del área de trazado utiliza el color de fondo del gráfico, que viene determinado por el tema del gráfico.
Véase también backgroundColor y theme.
theme : enumeration
El tema utilizado por el gráfico.
Un tema es una colección integrada de ajustes relacionados con el estilo de la interfaz de usuario que se aplica a todos los elementos visuales de un gráfico, como los colores, los trazos, los pinceles y las fuentes de las series, así como a los ejes, el título y la leyenda. El ejemplo «Qml Oscilloscope» ilustra cómo configurar un tema.
Nota: Al cambiar el tema se sobrescribirán todas las personalizaciones aplicadas anteriormente a las series.
Se admiten los siguientes valores:
| Constante | Descripción |
|---|---|
ChartView.ChartThemeLight | El tema claro, que es el tema predeterminado. |
ChartView.ChartThemeBlueCerulean | El tema azul cerúleo. |
ChartView.ChartThemeDark | El tema oscuro. |
ChartView.ChartThemeBrownSand | El tema marrón arena. |
ChartView.ChartThemeBlueNcs | El tema azul del sistema de colores naturales (NCS). |
ChartView.ChartThemeHighContrast | El tema de alto contraste. |
ChartView.ChartThemeBlueIcy | El tema azul hielo. |
ChartView.ChartThemeQt | El tema Qt. |
title : string
El título aparece como un encabezado en la parte superior del gráfico. Los títulos de los gráficos admiten formato HTML.
Véase también titleColor.
titleColor : color
El color del texto del título.
titleFont : font
La fuente del título del gráfico.
Para obtener más información, consulta font.
Documentación de Signal
seriesAdded(AbstractSeries series)
Esta señal se emite cuando se añade al gráfico la serie series.
Nota: El controlador correspondiente es onSeriesAdded.
seriesRemoved(AbstractSeries series)
Esta señal se emite cuando la serie « series » se elimina del gráfico. El objeto de serie deja de ser válido cuando finaliza el controlador de señales.
Nota: El controlador correspondiente es ` onSeriesRemoved`.
Documentación del método
Axis axisX(AbstractSeries series)
El eje x del series.
Véase también setAxisX().
Axis axisY(AbstractSeries series)
El eje y de series.
Véase también setAxisY().
AbstractSeries createSeries(enumeration type, string name, AbstractAxis axisX, AbstractAxis axisY)
Añade una serie del tipo « type » al gráfico con el nombre « name » y, opcionalmente, los ejes « axisX » y « axisY ». Por ejemplo:
// lineSeries is a LineSeries object that has already been added to the ChartView; re-use its axes
var myAxisX = chartView.axisX(lineSeries);
var myAxisY = chartView.axisY(lineSeries);
var scatter = chartView.createSeries(ChartView.SeriesTypeScatter, "scatter series", myAxisX, myAxisY);Se pueden utilizar los siguientes valores de enumeración como valores de type:
| Constante | Descripción |
|---|---|
ChartView.SeriesTypeLine | Una serie de líneas. |
ChartView.SeriesTypeArea | Una serie de área. |
ChartView.SeriesTypeBar | Una serie de barras. |
ChartView.SeriesTypeStackedBar | Una serie de barras apiladas. |
ChartView.SeriesTypePercentBar | Una serie de barras porcentuales. |
ChartView.SeriesTypeBoxPlot | Una serie de diagramas de caja. |
ChartView.SeriesTypeCandlestick | Una serie de velas japonesas. |
ChartView.SeriesTypePie | Una serie de gráficos circulares. |
ChartView.SeriesTypeScatter | Una serie de puntos dispersos. |
ChartView.SeriesTypeSpline | Una serie de splines. |
ChartView.SeriesTypeHorizontalBar | Una serie de barras horizontales. |
ChartView.SeriesTypeHorizontalStackedBar | Una serie de barras apiladas horizontales. |
ChartView.SeriesTypeHorizontalPercentBar | Una serie de barras de porcentaje horizontales. |
bool isZoomed()
Devuelve ` true ` si alguna serie tiene un dominio ampliado.
point mapToPosition(point value, AbstractSeries series)
Devuelve la posición en el gráfico del valor value en la serie series.
point mapToValue(point position, AbstractSeries series)
Devuelve el valor de la serie « series » situado en la posición « position » del gráfico.
void removeAllSeries()
Elimina todas las series del gráfico y borra definitivamente todos los objetos de las series.
void removeSeries(AbstractSeries series)
Elimina la serie « series » del gráfico y borra definitivamente el objeto de la serie.
void scrollDown(real pixels)
Desplaza la pantalla hacia abajo el número de píxeles especificado por ` pixels`. Se trata de un método práctico, adecuado, por ejemplo, para la navegación mediante teclas.
void scrollLeft(real pixels)
Desplaza hacia la izquierda el número de píxeles especificado por ` pixels`. Se trata de un método práctico, adecuado, por ejemplo, para la navegación mediante teclas.
void scrollRight(real pixels)
Desplaza hacia la derecha el número de píxeles especificado por ` pixels`. Se trata de un método práctico adecuado, por ejemplo, para la navegación mediante teclas.
void scrollUp(real pixels)
Desplaza la pantalla hacia arriba el número de píxeles especificado por ` pixels`. Se trata de un método práctico, adecuado, por ejemplo, para la navegación mediante teclas.
AbstractSeries series(int index)
Devuelve la serie con el índice index en el gráfico. Junto con la propiedad count del gráfico, esto permite recorrer las series de un gráfico.
Véase también count.
AbstractSeries series(string name)
Devuelve la primera serie del gráfico con el nombre « name ». Si no hay ninguna serie con ese nombre, devuelve «null».
void setAxisX(AbstractAxis axis, AbstractSeries series)
Establece el eje X de series en axis.
Véase también axisX().
void setAxisY(AbstractAxis axis, AbstractSeries series)
Establece el eje Y de series en axis.
Véase también axisY().
void zoom(real factor)
Amplía el gráfico según el factor personalizado factor.
Un factor superior a 1,0 amplía la vista y un factor comprendido entre 0,0 y 1,0 la reduce.
void zoomIn()
Amplía la vista al doble.
void zoomIn(rect rectangle)
Amplía la vista hasta el nivel máximo en el que el rectángulo rectangle sigue siendo totalmente visible.
Nota: Esta función no está disponible para los gráficos polares.
void zoomOut()
Aleja la vista en un factor de dos.
Nota: Esto no tendrá ningún efecto si el resultado contuviera un rango de eje logarítmico no válido.
void zoomReset()
Restablece los dominios de la serie a los valores que tenían antes de que se llamara a cualquier método de zoom.
Nota: Esto también restablecerá la configuración de desplazamiento y de rangos de ejes explícitos especificada entre la primera operación de zoom y la llamada a este método. Si no se ha realizado ninguna operación de zoom, este método no realiza ninguna acción.
© 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.