En esta página

BoxPlotSeries QML Type

Presenta los datos en gráficos de cajas y bigotes. Más...

Import Statement: import QtCharts 2.11
In C++: QBoxPlotSeries
Inherits:

AbstractSeries

Propiedades

Señales

Métodos

  • void append(BoxSet box)
  • void append(string label, VariantList values)
  • BoxSet at(int index)
  • void clear()
  • void insert(int index, string label, VariantList values)
  • void remove(QBoxSet boxset)

Descripción detallada

Una serie de gráficos de caja actúa como contenedor de elementos de caja y bigotes. Los elementos de varias series se agrupan en categorías según su valor de índice.

La clase BarCategoryAxis se utiliza para añadir las categorías al eje del gráfico. Las etiquetas de categoría deben ser únicas. Si se define la misma etiqueta de categoría para varios elementos de caja y bigotes, sólo se dibuja la primera.

El siguiente fragmento de código QML muestra cómo crear un sencillo gráfico de cajas y bigotes:

import QtQuick 2.0
import QtCharts 2.0

ChartView {
    title: "Box Plot series"
    width: 400
    height: 300
    theme: ChartView.ChartThemeBrownSand
    legend.alignment: Qt.AlignBottom

    BoxPlotSeries {
        id: plotSeries
        name: "Income"
        BoxSet { label: "Jan"; values: [3, 4, 5.1, 6.2, 8.5] }
        BoxSet { label: "Feb"; values: [5, 6, 7.5, 8.6, 11.8] }
        BoxSet { label: "Mar"; values: [3.2, 5, 5.7, 8, 9.2] }
        BoxSet { label: "Apr"; values: [3.8, 5, 6.4, 7, 8] }
        BoxSet { label: "May"; values: [4, 5, 5.2, 6, 7] }
    }
}

Captura de pantalla de un gráfico de caja que muestra los ingresos de cinco meses, de enero a mayo.


Véase también BoxSet y BarCategoryAxis.

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.

Nota: Sólo puede proporcionar axisX o axisXTop, pero no ambos.

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 en la vista del gráfico.

Nota: Sólo puede proporcionar axisY o axisYRight, pero no ambos.

Véase también axisY.

boxOutlineVisible : bool

La visibilidad del contorno de la caja.

boxWidth : real

La anchura del elemento de caja y bigotes. El valor indica la anchura relativa del elemento dentro de su categoría. El valor puede estar comprendido entre 0,0 y 1,0. Los valores negativos se sustituyen por 0,0 y los valores superiores a 1,0 se sustituyen por 1,0.

brushFilename : string

El nombre del archivo utilizado como pincel para la serie.

count : int [read-only]

Número de elementos de caja y bigotes en una serie de gráficos de caja.

Documentación de señales

boxsetsAdded(list sets)

Esta señal se emite cuando los elementos de caja y bigotes especificados por sets se añaden a la serie.

El manejador de señal correspondiente es onBoxsetsAdded().

Nota: El manejador correspondiente es onBoxsetsAdded.

boxsetsRemoved(list sets)

Esta señal se emite cuando los elementos de caja y bigotes especificados por sets se eliminan de la serie.

El manejador de señal correspondiente es onBoxsetsRemoved().

Nota: El manejador correspondiente es onBoxsetsRemoved.

clicked(BoxSet boxset)

Esta señal se emite cuando el usuario hace clic en el elemento de caja y bigotes especificado por boxset en el gráfico.

El manejador de señal correspondiente es onClicked().

Nota: El manejador correspondiente es onClicked.

doubleClicked(BoxSet boxset)

Esta señal se emite cuando el usuario hace doble clic en el elemento de caja y bigotes especificado por boxset en el gráfico.

El manejador de señal correspondiente es onDoubleClicked().

Nota: El manejador correspondiente es onDoubleClicked.

hovered(bool status, BoxSet boxset)

Esta señal se emite cuando el ratón se sitúa sobre el elemento de caja y bigotes especificado por boxset en el gráfico. Cuando el ratón se mueve sobre el elemento, status se convierte en true, y cuando el ratón se aleja de nuevo, se convierte en false.

El controlador de señal correspondiente es onHovered().

Nota: El manejador correspondiente es onHovered.

pressed(BoxSet boxset)

Esta señal se emite cuando el usuario pulsa boxset en el gráfico.

El manejador de señal correspondiente es onPressed.

Nota: El manejador correspondiente es onPressed.

released(BoxSet boxset)

Esta señal se emite cuando el usuario suelta la presión del ratón sobre el elemento de caja y bigotes especificado por boxset en el gráfico.

El manejador de señal correspondiente es onReleased().

Nota: El manejador correspondiente es onReleased.

Documentación del método

void append(BoxSet box)

Añade a la serie el elemento de caja y bigotes especificado por box.

void append(string label, VariantList values)

Añade a la serie un nuevo elemento de caja y bigotes con la etiqueta especificada por label y los valores especificados por values.

BoxSet at(int index)

Devuelve el elemento de caja y bigotes en la posición especificada por index.

void clear()

Elimina todos los elementos de caja y bigotes de la serie y los borra permanentemente.

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

Inserta un nuevo elemento de caja y bigotes con la etiqueta especificada por label y los valores especificados por values en la serie en la posición especificada por index.

void remove(QBoxSet boxset)

Elimina de la serie el elemento de caja y bigotes especificado por boxset.

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