En esta página

ValueAxis QML Type

Añade valores a los ejes de un gráfico. Más...

Import Statement: import QtGraphs
In C++: QValueAxis
Inherits:

AbstractAxis

Propiedades

Señales

Descripción detallada

El tipo ValueAxis se puede configurar para mostrar una línea de eje con marcas de escala, líneas de cuadrícula y sombreados. Los valores del eje se dibujan en las posiciones de las marcas de escala.

El siguiente código de ejemplo ilustra cómo utilizar el tipo ValueAxis:

GraphsView {
    axisX: ValueAxis {
        max: 10
        tickInterval: 1
    }
    axisY: ValueAxis {
        min -20
        max: 40
    }
    LineSeries {
        // Add a few XYPoint data...
    }
}

Documentación de propiedades

labelDecimals : int

El número de decimales que se utilizan para mostrar las etiquetas. Cuando se establece en -1, el número de decimales se ajusta automáticamente en función del rango de valores. El valor por defecto es -1.

labelFormat : string

La cadena de formato admite los siguientes especificadores de conversión, modificadores de longitud e indicadores proporcionados por printf() en la biblioteca estándar de C++: d, i, o, x, X, f, F, e, E, g, G, c. A continuación, la cadena formateada se procesa mediante ValueAxis::labelPostFormat.

El valor por defecto es vacío; en ese caso, se utiliza el formato «f».

ValueAxis {
    titleText: "Temperature °C"
    labelFormat: "%.2f"
    labelPostFormat: "%1 °C"
    // Results in "2.50 °C"
}

Véase también QString::asprintf().

labelPostFormat : string [since 6.12]

La etiqueta pasa primero por « ValueAxis::labelFormat » para dar formato al valor y, a continuación, pasa por esto.

El valor por defecto es «%1».

ValueAxis {
    titleText: "Temperature °C"
    labelFormat: "%.2f"
    labelPostFormat: "%1 °C"
    // Results in "2.50 °C"
}

Esta propiedad se introdujo en Qt 6.12.

Véase también QString::arg().

max : real

El valor máximo del eje.

Al configurar esta propiedad, el valor mínimo se ajusta si es necesario, para garantizar que el rango siga siendo válido. El valor por defecto es 10,0.

min : real

El valor mínimo del eje.

Al establecer esta propiedad, el valor máximo se ajusta si es necesario, para garantizar que el rango siga siendo válido. El valor por defecto es 0,0.

pan : real [since 6.9]

El valor de desplazamiento del eje.

El valor de desplazamiento desplaza el centro del eje sin afectar a los intervalos de la cuadrícula ni a las etiquetas. El valor por defecto es 0.

Esta propiedad se introdujo en Qt 6.9.

subTickCount : int

El número de subdivisiones en el eje. Indica cuántas subdivisiones se dibujan entre las líneas principales del gráfico. No se dibujan etiquetas para las subdivisiones. El valor por defecto es 0.

tickAnchor : real

El valor de referencia a partir del cual se colocan dinámicamente las marcas de escala y las etiquetas. El valor por defecto es 0.

tickInterval : real

El intervalo entre las marcas de escala y las etiquetas colocadas dinámicamente. El valor por defecto es 0, lo que significa que los intervalos se calculan automáticamente en función del rango mínimo y máximo.

visualMax : real [read-only, since 6.11]

El valor máximo visual del eje.

Esta propiedad contiene el valor máximo visual del eje cuando se ha desplazado o ampliado el eje. El valor por defecto es max

Esta propiedad se introdujo en Qt 6.11.

visualMin : real [read-only, since 6.11]

El valor mínimo visual del eje.

Esta propiedad contiene el valor mínimo visual del eje cuando se ha desplazado o ampliado el eje. El valor por defecto es min

Esta propiedad se introdujo en Qt 6.11.

zoom : real [since 6.9]

El valor de zoom del eje.

El valor de zoom amplía o reduce el eje y, por lo tanto, el gráfico, sin afectar a los intervalos de la cuadrícula ni a las etiquetas. El valor por defecto es 1.

Esta propiedad se introdujo en Qt 6.9.

Documentación de señales

labelDecimalsChanged(int decimals)

Esta señal se emite cuando el número de decimales de la etiqueta del eje cambia a decimals.

Nota: El controlador correspondiente es onLabelDecimalsChanged.

labelFormatChanged(string format)

Esta señal se emite cuando el formato de las etiquetas de los ejes cambia a format.

Nota: El controlador correspondiente es onLabelFormatChanged.

[since 6.12] labelPostFormatChanged(string format)

Esta señal se emite cuando el formato de las etiquetas de los ejes cambia a format.

Nota: El controlador correspondiente es onLabelPostFormatChanged.

Esta señal se introdujo en Qt 6.12.

maxChanged(real max)

Esta señal se emite cuando el valor máximo del eje cambia a max.

Nota: El controlador correspondiente es onMaxChanged.

minChanged(real min)

Esta señal se emite cuando el valor mínimo del eje cambia a min.

Nota: El controlador correspondiente es onMinChanged.

rangeChanged(real min, real max)

Esta señal se emite cuando el valor mínimo o máximo del eje cambia a min y max, respectivamente.

Nota: El controlador correspondiente es onRangeChanged.

subTickCountChanged(int subTickCount)

Esta señal se emite cuando cambia el número de subticks del eje, especificado por subTickCount.

Nota: El controlador correspondiente es onSubTickCountChanged.

tickAnchorChanged(real tickAnchor)

Esta señal se emite cuando el valor de anclaje del tick cambia a tickAnchor.

Nota: El controlador correspondiente es onTickAnchorChanged.

tickIntervalChanged(real tickInterval)

Esta señal se emite cuando el valor del intervalo de tick cambia a tickInterval.

Nota: El controlador correspondiente es onTickIntervalChanged.

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