Bars3D QML Type

Gráfico de barras en 3D. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• barSeriesMargin : size (since 6.3)
• barSpacing : size
• barSpacingRelative : bool
• barThickness : real
• columnAxis : CategoryAxis3D
• floorLevel : real
• multiSeriesUniform : bool
• primarySeries : Bar3DSeries
• rowAxis : CategoryAxis3D
• selectedSeries : Bar3DSeries
• seriesList : list<Bar3DSeries>
• valueAxis : ValueAxis3D

Métodos

• void addSeries(Bar3DSeries series)
• void insertSeries(int index, Bar3DSeries series)
• void removeSeries(Bar3DSeries series)

Descripción detallada

Este tipo permite a los desarrolladores representar gráficos de barras en 3D con Qt Quick.

Necesitará importar el módulo de visualización de datos para utilizar este tipo:

import QtDataVisualization 1.2

Después podrá utilizar Bars3D en sus archivos qml:

import QtQuick 2.0
import QtDataVisualization 1.2

Item {
    width: 640
    height: 480

    Bars3D {
        width: parent.width
        height: parent.height

        Bar3DSeries {
            itemLabelFormat: "@colLabel, @rowLabel: @valueLabel"

            ItemModelBarDataProxy {
                itemModel: dataModel
                // Mapping model roles to bar series rows, columns, and values.
                rowRole: "year"
                columnRole: "city"
                valueRole: "expenses"
            }
        }
    }

    ListModel {
        id: dataModel
        ListElement{ year: "2012"; city: "Oulu";     expenses: "4200"; }
        ListElement{ year: "2012"; city: "Rauma";    expenses: "2100"; }
        ListElement{ year: "2012"; city: "Helsinki"; expenses: "7040"; }
        ListElement{ year: "2012"; city: "Tampere";  expenses: "4330"; }
        ListElement{ year: "2013"; city: "Oulu";     expenses: "3960"; }
        ListElement{ year: "2013"; city: "Rauma";    expenses: "1990"; }
        ListElement{ year: "2013"; city: "Helsinki"; expenses: "7230"; }
        ListElement{ year: "2013"; city: "Tampere";  expenses: "4650"; }
    }
}

Vea Simple Bar Graph para un ejemplo de uso más detallado.

Véase también Bar3DSeries, ItemModelBarDataProxy, Scatter3D, Surface3D, y Qt Data Visualization C++ Classes.

Documentación de propiedades

barSeriesMargin : size [since 6.3]

Margen entre las columnas de la serie en las dimensiones X y Z. Preestablecido por defecto en (0.0, 0.0). Los valores sensibles están en el rango [0,1).

Esta propiedad se introdujo en Qt 6.3.

barSpacing : size

Espacio entre barras en las dimensiones X y Z.

Preestablecido en (1.0, 1.0) por defecto. El espaciado se ve afectado por la propiedad barSpacingRelative.

barSpacingRelative : bool

Si el espaciado es absoluto o relativo al grosor de las barras.

Si true, el valor de 0.0 significa que las barras se colocan de lado a lado, 1.0 significa que se deja entre las barras un espacio tan ancho como el grosor de una barra, y así sucesivamente. Preestablecido en true.

barThickness : real

La relación de grosor de las barras entre las dimensiones X y Z. El valor 1.0 significa que las barras son tan anchas como profundas, mientras que 0.5 hace que sean el doble de profundas que anchas.

columnAxis : CategoryAxis3D

El eje de columna activo.

Si no se indica un eje, se crea un eje temporal por defecto sin etiquetas. Este eje temporal se destruye si se establece explícitamente otro eje con la misma orientación.

floorLevel : real

El nivel del suelo para el gráfico de barras en coordenadas de datos del eje Y.

El nivel real del suelo estará restringido por los valores mínimo y máximo del eje Y. Por defecto es cero.

multiSeriesUniform : bool

Define si las barras deben escalarse con proporciones establecidas para una sola barra de serie aunque se muestren varias series. Si se establece en true, bar spacing se aplicará correctamente sólo al eje X. Preestablecido a false por defecto.

primarySeries : Bar3DSeries

La serie primaria del gráfico. Se utiliza para determinar las etiquetas de los ejes de fila y columna cuando las etiquetas no se establecen explícitamente en los ejes.

Si la serie especificada aún no se ha añadido al gráfico, al establecerla como serie primaria también se añadirá implícitamente al gráfico.

Si la serie primaria se elimina del gráfico, esta propiedad se restablece a su valor por defecto.

Si la serie es nula, esta propiedad se restablece por defecto. Por defecto es la primera serie añadida o cero si no se añade ninguna serie al gráfico.

rowAxis : CategoryAxis3D

El eje activo de la fila.

Si no se indica un eje, se crea un eje temporal por defecto sin etiquetas. Este eje temporal se destruye si se establece explícitamente otro eje con la misma orientación.

selectedSeries : Bar3DSeries

La serie seleccionada o null. Si selectionMode tiene activado el indicador SelectionMultiSeries, esta propiedad contiene la serie a la que pertenece la barra seleccionada.

seriesList : list<Bar3DSeries> [default]

Las series del gráfico. Por defecto, esta propiedad contiene una lista vacía. Para establecer las series, utilice la función addSeries() o defínalas como hijas del gráfico.

valueAxis : ValueAxis3D

El eje de valor activo.

Si no se indica un eje, se crea un eje temporal por defecto sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se destruye si se establece explícitamente otro eje con la misma orientación.

Documentación del método

void addSeries(Bar3DSeries series)

Añade series al gráfico. Un gráfico puede contener múltiples series, pero sólo un conjunto de ejes, por lo que las filas y columnas de todas las series deben coincidir para que los datos visualizados tengan sentido. Si el gráfico tiene múltiples series visibles, sólo la primera que se añada generará las etiquetas de fila o columna en los ejes en los casos en que las etiquetas no se hayan establecido explícitamente en los ejes. Si la serie recién añadida ha especificado una barra seleccionada, ésta se resaltará y se borrará cualquier selección existente. Sólo una serie añadida puede tener una selección activa.

Véase también AbstractGraph3D::hasSeries().

void insertSeries(int index, Bar3DSeries series)

Inserta el series en la posición index de la lista de series. Si la series ya ha sido añadida a la lista, se mueve a la nueva index.

Véase también AbstractGraph3D::hasSeries().

void removeSeries(Bar3DSeries series)

Elimina el series del gráfico.

Véase también AbstractGraph3D::hasSeries().