AbstractBarSeries QML Type

Un tipo padre abstracto para todos los tipos de series de barras. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• axisX : AbstractAxis
• axisXTop : AbstractAxis
• axisY : AbstractAxis
• axisYRight : AbstractAxis
• barWidth : real
• count : int
• labelsAngle : real
• labelsFormat : string
• labelsPosition : enumeration
• labelsPrecision : real
• labelsVisible : bool

Señales

• barsetsAdded()
• barsetsRemoved()
• clicked(int index, BarSet barset)
• doubleClicked(int index, BarSet barset)
• hovered(bool status, int index, BarSet barset)
• pressed(int index, BarSet barset)
• released(int index, BarSet barset)

Métodos

• BarSet append(string label, VariantList values)
• BarSet at(int index)
• void clear()
• BarSet insert(int index, string label, VariantList values)
• bool remove(BarSet barset)

Descripción detallada

En los gráficos de barras, las barras se definen como conjuntos de barras que contienen un valor de datos por cada categoría. La posición de una barra viene especificada por la categoría y su altura por el valor de los datos. Las series de barras que contienen varios conjuntos de barras agrupan barras que pertenecen a la misma categoría. La forma en que se muestran las barras viene determinada por el tipo elegido para crear el gráfico de barras: BarSeries, StackedBarSeries, PercentBarSeries, HorizontalBarSeries, HorizontalStackedBarSeries, o HorizontalPercentBarSeries.

Si se utiliza un tipo ValueAxis en lugar de BarCategoryAxis para el eje de barras principal, las barras se agrupan en torno al valor del índice de la categoría.

El siguiente fragmento de código QML muestra cómo utilizar los tipos BarSeries y BarCategoryAxis para crear un gráfico de barras sencillo:

ChartView {
    title: "Bar Chart"
    anchors.fill: parent
    legend.alignment: Qt.AlignBottom
    antialiasing: true

    BarSeries {
        id: mySeries
        axisX: BarCategoryAxis { categories: ["2007", "2008", "2009", "2010", "2011", "2012" ] }
        BarSet { label: "Bob"; values: [2, 2, 3, 4, 5, 6] }
        BarSet { label: "Susan"; values: [5, 1, 2, 4, 1, 7] }
        BarSet { label: "James"; values: [3, 5, 8, 13, 5, 8] }
    }
}

Documentación de propiedades

axisX : AbstractAxis

El eje x utilizado para la serie. Si deja axisX y axisXTop sin definir, se crea un BarCategoryAxis para la serie.

Véase también axisXTop.

axisXTop : AbstractAxis

El eje x utilizado para la serie, dibujado en la parte superior de la vista del gráfico.

Véase también axisX.

axisY : AbstractAxis

El eje y utilizado para la serie. Si deja ambos axisY y axisYRight sin definir, se crea un ValueAxis para la serie.

Véase también axisYRight.

axisYRight : AbstractAxis

El eje Y utilizado para la serie, dibujado a la derecha de la vista del gráfico.

Véase también axisY.

barWidth : real

La unidad de anchura es la unidad del eje x. La anchura mínima para las barras es cero, y los valores negativos se tratan como cero. Establecer la anchura a cero significa que la anchura de la barra en la pantalla es de un píxel independientemente de la escala del eje x. Las barras más anchas que cero se escalan utilizando la escala del eje x.

count : int [read-only]

El número de juegos de compases de una serie de compases.

labelsAngle : real

El ángulo de las etiquetas de valor en grados.

labelsFormat : string

Formato utilizado para mostrar etiquetas en una serie de barras.

Véase también QAbstractBarSeries::labelsFormat, labelsVisible, y labelsPosition.

labelsPosition : enumeration

Posición de las etiquetas de los valores de los datos:

Véase también labelsVisible y labelsFormat.

labelsPrecision : real

La cantidad máxima de dígitos significativos mostrados en las etiquetas de valor.

El valor por defecto es 6.

labelsVisible : bool

La visibilidad de las etiquetas en una serie de barras.

Documentación de señales

barsetsAdded()

Esta señal se emite cuando se añaden conjuntos de barras a la serie.

El manejador de señal correspondiente es onBarsetsAdded.

barsetsRemoved()

Esta señal se emite cuando se eliminan conjuntos de barras de la serie.

El manejador de señal correspondiente es onBarsetsRemoved.

clicked(int index, BarSet barset)

Esta señal se emite cuando el usuario hace clic en la barra especificada por index en el conjunto de barras especificado por barset.

El manejador de señal correspondiente es onClicked.

doubleClicked(int index, BarSet barset)

Esta señal se emite cuando el usuario hace doble clic en la barra especificada por index en el conjunto de barras especificado por barset.

El manejador de señal correspondiente es onDoubleClicked.

hovered(bool status, int index, BarSet barset)

Esta señal se emite cuando se pasa el ratón por encima de la barra especificada por index en el conjunto de barras especificado por barset. Cuando el ratón se mueve sobre la barra, status se convierte en true, y cuando el ratón se aleja de nuevo, se convierte en false.

El manejador de señal correspondiente es onHovered.

pressed(int index, BarSet barset)

Esta señal se emite cuando el usuario hace clic en la barra especificada por index en el conjunto de barras especificado por barset y mantiene pulsado el botón del ratón.

El manejador de señal correspondiente es onPressed.

released(int index, BarSet barset)

Esta señal se emite cuando el usuario suelta la presión del ratón sobre la barra especificada por index en el conjunto de barras especificado por barset.

El manejador de señal correspondiente es onReleased.

Documentación del método

BarSet append(string label, VariantList values)

Añade un nuevo conjunto de barras con label y values al índice. values es una lista de valores reales.

Por ejemplo:

myBarSeries.append("set 1", [0, 0.2, 0.2, 0.5, 0.4, 1.5, 0.9]);

BarSet at(int index)

Devuelve la barra establecida en index. Devuelve null si el índice no es válido.

void clear()

Elimina todos los conjuntos de compases de la serie.

BarSet insert(int index, string label, VariantList values)

Añade un nuevo conjunto de barras con label y values a index. values puede ser una lista de valores reales o una lista de tipos XYPoint.

Si el valor del índice es igual o menor que cero, el nuevo conjunto de compases se añade a la serie de compases. Si el valor del índice es igual o mayor que el número de conjuntos de compases de la serie de compases, el nuevo conjunto de compases se añade a la serie de compases.

Véase también append().

bool remove(BarSet barset)

Elimina de la serie el conjunto de barras especificado por barset. Devuelve true si tiene éxito, false en caso contrario.