En esta página

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:

PolarChartView

Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

Señales

Métodos

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:

Gráfico lineal con una única línea ascendente que alcanza su punto máximo y luego se estabiliza

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:

ConstanteDescripción
ChartView.NoAnimationLa animación está desactivada en el gráfico. Este es el valor por defecto.
ChartView.GridAxisAnimationsLa animación del eje de cuadrícula está activada en el gráfico.
ChartView.SeriesAnimationsLa animación de series está activada en el gráfico.
ChartView.AllAnimationsTodos 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:

ConstanteDescripción
ChartView.ChartThemeLightEl tema claro, que es el tema predeterminado.
ChartView.ChartThemeBlueCeruleanEl tema azul cerúleo.
ChartView.ChartThemeDarkEl tema oscuro.
ChartView.ChartThemeBrownSandEl tema marrón arena.
ChartView.ChartThemeBlueNcsEl tema azul del sistema de colores naturales (NCS).
ChartView.ChartThemeHighContrastEl tema de alto contraste.
ChartView.ChartThemeBlueIcyEl tema azul hielo.
ChartView.ChartThemeQtEl 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:

ConstanteDescripción
ChartView.SeriesTypeLineUna serie de líneas.
ChartView.SeriesTypeAreaUna serie de área.
ChartView.SeriesTypeBarUna serie de barras.
ChartView.SeriesTypeStackedBarUna serie de barras apiladas.
ChartView.SeriesTypePercentBarUna serie de barras porcentuales.
ChartView.SeriesTypeBoxPlotUna serie de diagramas de caja.
ChartView.SeriesTypeCandlestickUna serie de velas japonesas.
ChartView.SeriesTypePieUna serie de gráficos circulares.
ChartView.SeriesTypeScatterUna serie de puntos dispersos.
ChartView.SeriesTypeSplineUna serie de splines.
ChartView.SeriesTypeHorizontalBarUna serie de barras horizontales.
ChartView.SeriesTypeHorizontalStackedBarUna serie de barras apiladas horizontales.
ChartView.SeriesTypeHorizontalPercentBarUna 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.