En esta página

Gráfico de barras sencillo

Uso de Bars3D en una aplicación QML.

El gráfico de barras sencillo muestra cómo crear un gráfico de barras 3D sencillo utilizando Bars3D y QML.

Gráfico de barras en 3D en el que se comparan los ingresos y gastos mensuales a lo largo de varios años

En las siguientes secciones se describe cómo cambiar de serie y mostrar más de una serie a la vez. Para obtener más información sobre las funciones básicas de las aplicaciones QML, consulta «Gráfico de dispersión sencillo».

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Datos

El conjunto de datos de ejemplo corresponde a los ingresos y gastos mensuales de una empresa ficticia a lo largo de varios años. Los datos se definen en un modelo de lista en Data.qml de la siguiente manera:

ListModel {
    id: dataModel
    ListElement{ timestamp: "2016-01"; expenses: "-4";  income: "5" }
    ListElement{ timestamp: "2016-02"; expenses: "-5";  income: "6" }
    ListElement{ timestamp: "2016-03"; expenses: "-7";  income: "4" }
    ...

Cada elemento de datos tiene tres roles: marca de tiempo, ingresos y gastos. El valor de la marca de tiempo tiene el siguiente formato: <four digit year>-<two digit month>. Normalmente, se asignarían los años y los meses a las filas y columnas de un gráfico de barras, pero solo se puede mostrar como valor los ingresos o los gastos.

Ahora, añade los datos al gráfico Bars3D. Crea dos Bar3DSeries en su interior, empezando por una serie para los ingresos:

Bar3DSeries {
    id: barSeries
    itemLabelFormat: "Income, @colLabel, @rowLabel: @valueLabel"
    baseGradient: barGradient

    ItemModelBarDataProxy {
        id: modelProxy
        itemModel: graphData.model
        rowRole: "timestamp"
        columnRole: "timestamp"
        valueRole: "income"
        rowRolePattern: /^(\d\d\d\d).*$/
        columnRolePattern: /^.*-(\d\d)$/
        rowRoleReplace: "\\1"
        columnRoleReplace: "\\1"
        multiMatchBehavior: ItemModelBarDataProxy.MMBCumulative
    }
    ...

Los datos se asocian a la propiedad « itemModel » del «ItemModelBarDataProxy» dentro de la serie. Para « valueRole », especifica el campo « income », ya que contiene el valor que deseas. Obtener los años y los meses es un poco más complicado, ya que ambos se encuentran en el mismo campo. Para extraer esos valores, especifica el campo timestamp tanto para rowRole como para columnRole, y, además, especifica un patrón de búsqueda y una regla de sustitución para esas funciones, con el fin de extraer la parte correcta del contenido del campo para cada una de ellas. El patrón de búsqueda es una expresión regular de JavaScript estándar y la regla de sustitución especifica por qué se sustituye el contenido del campo que coincide con la expresión regular. En este caso, sustituya todo el contenido del campo únicamente por el año o el mes, que es la primera subcadena capturada tanto para las filas como para las columnas. Para obtener más información sobre la funcionalidad de sustitución con expresiones regulares, consulte la documentación de la función ` QString::replace(const QRegExp &rx, const QString &after)`.

La propiedad « multiMatchBehavior » especifica qué hacer en caso de que varios elementos del modelo de elementos coincidan con la misma combinación de fila y columna. En este caso, suma sus valores. Esta propiedad no tiene ningún efecto al mostrar los valores de cada mes, ya que no hay meses duplicados en nuestro modelo de elementos, pero cobra relevancia más adelante, cuando se quieran mostrar los totales anuales.

A continuación, añade otra serie para los gastos:

Bar3DSeries {
    id: secondarySeries
    visible: false
    itemLabelFormat: "Expenses, @colLabel, @rowLabel: -@valueLabel"
    baseGradient: secondaryGradient

    ItemModelBarDataProxy {
        id: secondaryProxy
        itemModel: graphData.model
        rowRole: "timestamp"
        columnRole: "timestamp"
        valueRole: "expenses"
        rowRolePattern: /^(\d\d\d\d).*$/
        columnRolePattern: /^.*-(\d\d)$/
        valueRolePattern: /-/
        rowRoleReplace: "\\1"
        columnRoleReplace: "\\1"
        multiMatchBehavior: ItemModelBarDataProxy.MMBCumulative
    }
    ...

El modelo contiene los gastos como valores negativos, pero quieres mostrarlos como barras positivas, para que se puedan comparar fácilmente con las barras de ingresos. Para ello, utiliza la propiedad ` valueRolePattern ` para eliminar el signo menos. No es necesario especificar ninguna cadena de sustitución, ya que la sustitución predeterminada es una cadena vacía.

Utiliza la propiedad « visible » de la serie para ocultar la segunda serie por ahora.

Etiquetas de eje personalizadas

Axes.qml Redefine las etiquetas de categoría del eje de columnas, ya que los datos contienen números correspondientes a los meses, lo que saturaría las etiquetas:

CategoryAxis3D {
    id: columnAxis
    labels: ["January", "February", "March", "April", "May", "June",
        "July", "August", "September", "October", "November", "December"]
    labelAutoRotation: 30
}

Para que las etiquetas de los ejes sean más legibles con ángulos de cámara bajos, configura la rotación automática de las etiquetas de los ejes.

Cambio de serie

En ` main.qml`, configura el gráfico y diversos elementos de la interfaz de usuario. Hay tres bloques de código interesantes que cabe destacar aquí. El primero muestra cómo cambiar los datos visualizados entre ingresos, gastos y ambos, simplemente cambiando la visibilidad de las dos series:

onClicked: {
    if (text === "Show Expenses") {
        barSeries.visible = false;
        secondarySeries.visible = true;
        barGraph.valueAxis.labelFormat = "-%.2f M\u20AC";
        secondarySeries.itemLabelFormat = "Expenses, @colLabel, @rowLabel: @valueLabel";
        text = "Show Both";
    } else if (text === "Show Both") {
        barSeries.visible = true;
        barGraph.valueAxis.labelFormat = "%.2f M\u20AC";
        secondarySeries.itemLabelFormat = "Expenses, @colLabel, @rowLabel: -@valueLabel";
        text = "Show Income";
    } else { // text === "Show Income"
        secondarySeries.visible = false;
        text = "Show Expenses";
    }
}

Se han ajustado el formato de las etiquetas de los ejes y el de las etiquetas de selección de elementos para que el signo negativo se muestre correctamente en los gastos, que en realidad se habían resuelto como valores positivos.

El segundo bloque interesante es aquel en el que se cambian los datos visualizados ajustando las propiedades del proxy:

onClicked: {
    if (text === "Show yearly totals") {
        modelProxy.autoRowCategories = true;
        secondaryProxy.autoRowCategories = true;
        modelProxy.columnRolePattern = /^.*$/;
        secondaryProxy.columnRolePattern = /^.*$/;
        graphAxes.value.autoAdjustRange = true;
        barGraph.columnAxis = graphAxes.total;
        text = "Show all years";
    } else if (text === "Show all years") {
        modelProxy.autoRowCategories = true;
        secondaryProxy.autoRowCategories = true;
        modelProxy.columnRolePattern = /^.*-(\d\d)$/;
        secondaryProxy.columnRolePattern = /^.*-(\d\d)$/;
        graphAxes.value.min = 0;
        graphAxes.value.max = 35;
        barGraph.columnAxis = graphAxes.column;
        text = "Show 2020 - 2022";
    } else { // text === "Show 2020 - 2022"
        // Explicitly defining row categories, since we do not want to show data for
        // all years in the model, just for the selected ones.
        modelProxy.autoRowCategories = false;
        secondaryProxy.autoRowCategories = false;
        modelProxy.rowCategories = ["2020", "2021", "2022"];
        secondaryProxy.rowCategories = ["2020", "2021", "2022"];
        text = "Show yearly totals";
    }
}

Para mostrar los totales anuales, se combinan los doce meses de cada año en una sola barra. Esto se consigue especificando un « columnRolePattern » que coincida con todos los elementos del modelo. De este modo, el proxy de datos solo tendrá una única columna. El « multiMatchBehavior » acumulativo especificado anteriormente para el proxy cobra relevancia ahora, lo que hace que los valores de los doce meses de cada año se sumen en una sola barra.

Para mostrar solo un subconjunto de años, establece autoRowCategories en «false» en el elemento ItemModelBarDataProxy y define las categorías de filas de forma explícita. De este modo, solo se visualizan los elementos de las categorías de filas especificadas.

El tercer bloque interesante muestra cómo obtener el índice de fila y columna de un elemento si se conocen los valores de fila y columna utilizando los métodos de `ItemModelBarDataProxy` ` rowCategoryIndex() ` y ` columnCategoryIndex()`:

onCurrentRowChanged: {
    var timestamp = graphData.model.get(mainview.currentRow).timestamp;
    var pattern = /(\d\d\d\d)-(\d\d)/;
    var matches = pattern.exec(timestamp);
    var rowIndex = modelProxy.rowCategoryIndex(matches[1]);
    var colIndex;
    if (barGraph.columnAxis == graphAxes.total)
        colIndex = 0 ;// Just one column when showing yearly totals
    else
        colIndex = modelProxy.columnCategoryIndex(matches[2]);
    if (selectedSeries.visible)
        mainview.selectedSeries.selectedBar = Qt.point(rowIndex, colIndex);
    else if (barSeries.visible)
        barSeries.selectedBar = Qt.point(rowIndex, colIndex);
    else
        secondarySeries.selectedBar = Qt.point(rowIndex, colIndex);
}

Proyecto de ejemplo en @code.qt.io

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