ChartView QML Type

Gestiona la representación gráfica de las series, leyendas y ejes del gráfico. Más...

• Lista de todos los miembros, incluidos los heredados

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 como gráficos.

Este ejemplo muestra cómo crear un simple gráfico de líneas:

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 para el gráfico.

animationEasingCurve : easing

La curva de relajación de la animación para el gráfico.

animationOptions : enumeration

Las animaciones activadas en el gráfico:

axes : list<AbstractAxis>

Los ejes del gráfico.

backgroundColor : color

Color del fondo del gráfico. Por defecto, el color de fondo viene especificado por el tema del gráfico.

Véase también theme.

backgroundRoundness : real

El diámetro del círculo redondeado en las esquinas del fondo del gráfico.

count : int

El número de series añadidas al gráfico.

dropShadowEnabled : bool

Indica si está activado el efecto de sombra de fondo.

Si se establece en true, se activa el efecto de sombra de fondo. Si se establece en false, se desactiva.

legend : Legend

La leyenda del gráfico. La leyenda enumera todas las series, sectores circulares y conjuntos de barras añadidos al gráfico.

locale : locale [since QtCharts 2.0]

La configuración regional utilizada para dar formato a varias etiquetas de gráficos.

Las etiquetas se localizan sólo cuando localizeNumbers es true, excepto las etiquetas DateTimeAxis, que siempre utilizan la QLocale establecida con esta propiedad.

La configuración regional predeterminada es la de la aplicación en el momento en que se construye 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 true, todos los números generados que aparezcan en varias series y etiquetas de ejes se localizarán utilizando la configuración QLocale con la propiedad locale. En false, siempre se utiliza la localización C. Por defecto es false.

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 trazado. Los márgenes se utilizan para dibujar el título, los ejes y la leyenda.

plotArea : rect

El rectángulo dentro del cual se dibuja el gráfico.

El área de trazado no incluye el área definida por los márgenes. Por defecto, se redimensionará si está dentro de ChartView. Si se establece un rectángulo explícito para el área de trazado, lo respetará. Para volver al comportamiento por defecto, establezca Qt.rect(0, 0, 0, 0).

Véase también margins.

plotAreaColor : color

Color del fondo del área de trazado del gráfico. Por defecto, el fondo del área de trazado utiliza el color de fondo del gráfico, especificado 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 aplican a todos los elementos visuales de un gráfico, como los colores, plumas, pinceles y fuentes de las series, así como los ejes, el título y la leyenda. El ejemplo Osciloscopio Qml ilustra cómo establecer un tema.

Se admiten los siguientes valores:

title : string

El título se muestra 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

Fuente del título del gráfico.

Para más información, consulte font.

Documentación de señales

seriesAdded(AbstractSeries series)

Esta señal se emite cuando la serie series se añade al gráfico.

seriesRemoved(AbstractSeries series)

Esta señal se emite cuando la serie series se elimina del gráfico. El objeto serie deja de ser válido cuando finaliza el manejador de la señal.

Documentación del método

Axis axisX(AbstractSeries series)

El eje x del sitio series.

Véase también setAxisX().

Axis axisY(AbstractSeries series)

El eje y de la página 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);

Los siguientes valores de enumeración pueden utilizarse como valores de type:

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 permanentemente todos los objetos serie.

void removeSeries(AbstractSeries series)

Elimina la serie series del gráfico y borra permanentemente el objeto serie.

void scrollDown(real pixels)

Se desplaza hacia abajo el número de píxeles especificado en pixels. Se trata de un método práctico adecuado para la navegación por teclas, por ejemplo.

void scrollLeft(real pixels)

Se desplaza hacia la izquierda el número de píxeles especificado en pixels. Se trata de un método práctico adecuado para la navegación por teclas, por ejemplo.

void scrollRight(real pixels)

Se desplaza hacia la derecha el número de píxeles especificado en pixels. Se trata de un método práctico adecuado para la navegación por teclas, por ejemplo.

void scrollUp(real pixels)

Se desplaza hacia arriba el número de píxeles especificado en pixels. Se trata de un método práctico adecuado para la navegación por teclas, por ejemplo.

AbstractSeries series(int index)

Devuelve la serie con el índice index en el gráfico. Junto con la propiedad count del gráfico, permite recorrer en bucle 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 entre 0,0 y 1,0 la reduce.

void zoomIn()

Amplía la vista en un factor de dos.

void zoomIn(rect rectangle)

Amplía la vista hasta un nivel máximo en el que el rectángulo rectangle sigue siendo totalmente visible.

void zoomOut()

Aleja la vista en un factor de dos.

void zoomReset()

Restablece los dominios de las series a lo que eran antes de llamar a cualquier método de zoom.