En esta página

Bars3D QML Type

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

Import Statement: import QtDataVisualization 1.12
Since: QtDataVisualization 1.0
Inherits:

AbstractGraph3D

Status: Deprecated

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

Propiedades

Métodos

Descripción detallada

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

Para utilizar este tipo, tendrás que importar el módulo de visualización de datos:

import QtDataVisualization 1.2

A continuación, podrás utilizar Bars3D en tus 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"; }
    }
}

Consulta «Gráfico de barras sencillo » para ver un ejemplo de uso más detallado.

Véanse 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 una serie en las dimensiones X y Z. El valor predeterminado es « (0.0, 0.0) ». Los valores recomendados se encuentran en el intervalo [0,1).

Esta propiedad se introdujo en Qt 6.3.

barSpacing : size

Espaciado entre barras en las dimensiones X y Z.

El valor predeterminado es « (1.0, 1.0) ». La separación se ve afectada por la propiedad « barSpacingRelative ».

barSpacingRelative : bool

Si el espaciado es absoluto o relativo al grosor de la barra.

Si se establece en « true », el valor « 0.0 » significa que las barras se colocan una al lado de la otra, « 1.0 » significa que se deja un espacio entre las barras del mismo ancho que el grosor de una barra, y así sucesivamente. El valor predeterminado es « true ».

barThickness : real

La relación entre el grosor de la barra en las dimensiones X y Z. El valor « 1.0 » significa que las barras tienen la misma anchura que profundidad, mientras que « 0.5 » indica que su profundidad es el doble de su anchura.

columnAxis : CategoryAxis3D

El eje de columna activo.

Si no se especifica ningún eje, se crea un eje predeterminado temporal sin etiquetas. Este eje temporal se elimina si se establece explícitamente otro eje con la misma orientación.

floorLevel : real

El nivel mínimo del gráfico de barras en las coordenadas de datos del eje Y.

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

multiSeriesUniform : bool

Define si las barras deben escalarse manteniendo las proporciones de una sola barra de la serie, incluso si se muestran varias series. Si se establece en « true », la opción « bar spacing » se aplicará correctamente solo al eje X. El valor predeterminado es « false ».

primarySeries : Bar3DSeries

La serie principal del gráfico. Se utiliza para determinar las etiquetas de los ejes de filas y columnas cuando estas no se han establecido explícitamente en los ejes.

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

Si la propia serie principal se elimina del gráfico, esta propiedad vuelve a su valor por defecto.

Si la serie es nula, esta propiedad vuelve a su valor por defecto. El valor por defecto es la primera serie añadida o cero si no se ha añadido ninguna serie al gráfico.

rowAxis : CategoryAxis3D

El eje de fila activo.

Si no se especifica ningún eje, se crea un eje predeterminado temporal sin etiquetas. Este eje temporal se elimina 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, utiliza la función ` addSeries()` o defínelas como elementos secundarios del gráfico.

valueAxis : ValueAxis3D

El eje de valores activo.

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

Documentación del método

void addSeries(Bar3DSeries series)

Añade la serie « series » al gráfico. Un gráfico puede contener varias series, pero solo 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 varias series visibles, solo 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, esta se resaltará y se borrará cualquier selección existente. Solo una de las series añadidas 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 el series ya se ha añadido a la lista, se desplaza a la nueva index.

Nota: Al mover una serie a un nuevo index posterior a su índice anterior, la nueva posición en la lista se calcula como si la serie siguiera en su índice anterior, por lo que el índice final es, en realidad, el index disminuido en uno.

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

void removeSeries(Bar3DSeries series)

Elimina el « series » del gráfico.

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

© 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.