En esta página

GraphsView QML Type

Tipo base para todas las vistas de Qt Graphs. Más...

Import Statement: import QtGraphs

Propiedades

Métodos

Descripción detallada

Esta clase reúne las series y los temas y dibuja los gráficos. Necesitará importar el módulo Qt Graphs para utilizar esta clase:

import QtGraphs

Después de que usted puede utilizar GraphsView en sus archivos qml:

import QtQuick
import QtGraphs

GraphsView {
    anchors.fill: parent
    theme: GraphsTheme {
        colorScheme: GraphsTheme.ColorScheme.Dark
        seriesColors: ["#E0D080", "#B0A060"]
        borderColors: ["#807040", "#706030"]
        grid.mainColor: "#ccccff"
        grid.subColor: "#eeeeff"
        axisY.mainColor: "#ccccff"
        axisY.subColor: "#eeeeff"
    }
    axisX: BarCategoryAxis {
        categories: ["2023", "2024", "2025"]
        lineVisible: false
    }
    axisY: ValueAxis {
        min: 0
        max: 10
        subTickCount: 4
    }
    BarSeries {
        BarSet {
            values: [7, 6, 9]
        }
        BarSet {
            values: [9, 8, 6]
        }
    }
}

Vea también BarSeries, LineSeries, BarCategoryAxis, ValueAxis, y GraphsTheme.

Documentación de propiedades

axisX : AbstractAxis

El eje x utilizado para la serie dentro de esta vista.

Nota: No es posible asignar el mismo eje a varios GraphsViews.

Véase también axisY.

axisXSmoothing : real

Controla la cantidad de suavizado (antialiasing) del eje X del gráfico. Por defecto, el suavizado es 1.0.

axisY : AbstractAxis

El eje y utilizado para la serie dentro de esta vista.

Nota: No es posible asignar el mismo eje a varios GraphsViews.

Véase también axisX.

axisYSmoothing : real

Controla la cantidad de suavizado (antialiasing) del eje Y del gráfico. Por defecto, el suavizado es 1.0.

clipPlotArea : bool [since 6.10]

Controla si los elementos del gráfico deben recortarse si salen de un área de trazado. El valor por defecto es true.

Esta propiedad se introdujo en Qt 6.10.

Véase también plotArea.

gridSmoothing : real

Controla la cantidad de suavizado (antialiasing) de la rejilla gráfica. Por defecto, el suavizado es 1.0.

marginBottom : real

La cantidad de espacio vacío en la parte inferior del gráfico. Por defecto, el margen es de 20.

marginLeft : real

La cantidad de espacio vacío a la izquierda del gráfico. Por defecto, el margen es 20.

marginRight : real

La cantidad de espacio vacío a la derecha del gráfico. Por defecto, el margen es de 20.

marginTop : real

La cantidad de espacio vacío en la parte superior del gráfico. Por defecto, el margen es de 20.

orientation : Qt.Orientation

Determina la orientación de GraphsView. Cuando la orientación es Qt.Horizontal, axisX y axisY cambiarán las posiciones de modo que axisX se renderice verticalmente y axisY horizontalmente. Esta propiedad es utilizada actualmente por BarSeries. El valor por defecto es Qt.Vertical.

panStyle : enumeration

Determina el estilo de panoramización de GraphsView. La panoramización funciona manipulando la propiedad de panoramización de ValueAxis. El valor por defecto es GraphsView.PanStyle.None.

ConstanteDescripción
GraphsView.PanStyle.NoneLa panorámica está desactivada.
GraphsView.PanStyle.DragEl ratón y el arrastre táctil desplazan la vista.

plotArea : rect [read-only, since 6.9]

El rectángulo dentro del cual se dibuja el gráfico. Es el área de GraphsView menos las áreas de los ejes y los márgenes.

Esta propiedad se introdujo en Qt 6.9.

Véase también marginTop, marginBottom, marginLeft, y marginRight.

seriesList : list [read-only]

Lista de series que son renderizadas por el GraphsView. Se rellena automáticamente con las series tipo hijas del GraphsView.

Esta es la propiedad por defecto, por lo que los elementos hijos se añaden automáticamente a la lista de series.

Véase también BarSeries, LineSeries, y ScatterSeries.

shadowBarWidth : real

Controla el ancho de la sombra de la rejilla del gráfico. Por defecto, el ancho de la sombra se establece en 2.0.

shadowColor : color

Controla el color de la sombra de la rejilla del gráfico. Por defecto, el color de la sombra es black.

shadowSmoothing : real

Controla la cantidad de suavizado de sombras (antialiasing) de la rejilla gráfica. Por defecto, el suavizado de sombras se establece en 4.0.

shadowVisible : bool

Controla si la sombra de la rejilla del gráfico es visible. Por defecto, la visibilidad de la sombra se establece en false.

shadowXOffset : real

Controla el desplazamiento X de la sombra de la rejilla gráfica. Por defecto, el desplazamiento X de la sombra se establece en 0.0.

shadowYOffset : real

Controla el desplazamiento Y de la sombra de la rejilla gráfica. Por defecto, el desplazamiento Y de la sombra se establece en 0.0.

theme : GraphsTheme

El tema utilizado por el gráfico. Determina el color, las líneas de los ejes, las fuentes, etc. Si no se ha establecido el tema, se utiliza el tema por defecto.

zoomAreaDelegate : Component

Determina el elemento QML que se dibuja cuando el usuario realiza un movimiento de arrastre para ampliar un área.

zoomAreaEnabled : bool

El área de zoom cambia al arrastrar con el ratón y el tacto para dibujar una caja determinada por zoomAreaDelegate. Al soltar, las propiedades de zoom y desplazamiento del gráfico ValueAxis cambian para que la vista cubra sólo el área intersectada por la caja dibujada.

Véase también zoomAreaDelegate.

zoomSensitivity : real

Determina la rapidez con la que cambia el valor del zoom al hacer zoom.

zoomStyle : enumeration

Determina el estilo de zoom de GraphsView. El zoom funciona manipulando la propiedad zoom de ValueAxis. El valor por defecto es GraphsView.ZoomStyle.None.

ConstanteDescripción
GraphsView.ZoomStyle.NoneEl zoom está desactivado.
GraphsView.ZoomStyle.CenterEl zoom de pellizco y la rueda del ratón hacen zoom hacia el centro de la vista del gráfico.

Documentación del método

void addSeries(AbstractSeries series)

Añade un series a GraphsView. Si series es nulo, no se añadirá. Si series ya pertenece al gráfico, se moverá al final.

bool hasSeries(AbstractSeries series)

Devuelve true si series está en el gráfico.

void insertSeries(int index, AbstractSeries series)

Inserta un series en la posición especificada por index. Si series es nulo, no se insertará. Si el series ya pertenece al gráfico, se moverá a index.

void removeSeries(AbstractSeries series)

Elimina la dirección series del gráfico.

void removeSeries(int index)

Elimina del gráfico la serie especificada por index.

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