En esta página

QValueAxis Class

La clase QValueAxis añade valores a los ejes de un gráfico. Más información...

Encabezado: #include <QValueAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: ValueAxis
Heredan de: QAbstractAxis

Propiedades

Funciones públicas

QValueAxis(QObject *parent = nullptr)
virtual ~QValueAxis() override
int labelDecimals() const
QString labelFormat() const
QString labelPostFormat() const
qreal max() const
qreal min() const
qreal pan() const
void setLabelDecimals(int decimals)
void setLabelFormat(const QString &format)
void setLabelPostFormat(const QString &format)
void setMax(qreal max)
void setMin(qreal min)
void setPan(qreal pan)
void setRange(qreal min, qreal max)
void setSubTickCount(qsizetype count)
void setTickAnchor(qreal anchor)
void setTickInterval(qreal interval)
void setZoom(qreal zoom)
qsizetype subTickCount() const
qreal tickAnchor() const
qreal tickInterval() const
qreal visualMax() const
qreal visualMin() const
qreal zoom() const

Funciones públicas reimplementadas

virtual QAbstractAxis::AxisType type() const override

Señales

void labelDecimalsChanged(int decimals)
void labelFormatChanged(const QString &format)
void labelPostFormatChanged(const QString &format)
void maxChanged(qreal max)
void minChanged(qreal min)
void panChanged(qreal pan)
void subTickCountChanged(qsizetype subTickCount)
void tickAnchorChanged(qreal tickAnchor)
void tickIntervalChanged(qreal tickInterval)
void visualMaxChanged(qreal newVisualMax)
void visualMinChanged(qreal newVisualMin)
void zoomChanged(qreal zoom)

Descripción detallada

Se puede configurar un eje de valores para que muestre una línea de eje con marcas de graduación, líneas de cuadrícula y sombreados. Los valores del eje se dibujan en las posiciones de las marcas de graduación.

Documentación de propiedades

labelDecimals : int

Esta propiedad indica 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.

Funciones de acceso:

int labelDecimals() const
void setLabelDecimals(int decimals)

Señal de notificación:

void labelDecimalsChanged(int decimals)

labelFormat : QString

Esta propiedad contiene el formato de las etiquetas del eje.

La cadena de formato admite los siguientes especificadores de conversión, modificadores de longitud y 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 ` QValueAxis::labelPostFormat`.

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

Funciones de acceso:

QString labelFormat() const
void setLabelFormat(const QString &format)

Señal de notificador:

void labelFormatChanged(const QString &format)

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

[since 6.12] labelPostFormat : QString

Esta propiedad contiene el formato de etiqueta de los datos del eje.

La etiqueta pasa primero por QValueAxis::labelFormat para dar formato al valor y, a continuación, pasa por esta propiedad.

El valor por defecto es «%1».

Esta enumeración se introdujo en Qt 6.12.

Funciones de acceso:

QString labelPostFormat() const
void setLabelPostFormat(const QString &format)

Señal de notificación:

void labelPostFormatChanged(const QString &format)

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

max : qreal

Esta propiedad contiene 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

Funciones de acceso:

qreal max() const
void setMax(qreal max)

Señal de notificación:

void maxChanged(qreal max)

min : qreal

Esta propiedad contiene el valor mínimo del eje.

Al configurar 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

Funciones de acceso:

qreal min() const
void setMin(qreal min)

Señal de notificación:

void minChanged(qreal min)

[since 6.9] pan : qreal

Esta propiedad almacena el valor de panorámica del eje.

El valor «pan» 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 enumeración se introdujo en Qt 6.9.

Funciones de acceso:

qreal pan() const
void setPan(qreal pan)

Señal de notificación:

void panChanged(qreal pan)

subTickCount : qsizetype

Esta propiedad contiene el número de subdivisiones del 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.

Funciones de acceso:

qsizetype subTickCount() const
void setSubTickCount(qsizetype count)

Señal de notificación:

void subTickCountChanged(qsizetype subTickCount)

tickAnchor : qreal

Esta propiedad contiene el valor base desde el que se inician las marcas de escala y las etiquetas colocadas dinámicamente. El valor por defecto es 0.

Funciones de acceso:

qreal tickAnchor() const
void setTickAnchor(qreal anchor)

Señal de notificación:

void tickAnchorChanged(qreal tickAnchor)

tickInterval : qreal

Esta propiedad define 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.

Funciones de acceso:

qreal tickInterval() const
void setTickInterval(qreal interval)

Señal de notificación:

void tickIntervalChanged(qreal tickInterval)

[read-only, since 6.11] visualMax : qreal

Esta propiedad almacena 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 QValueAxis::max

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

qreal visualMax() const

Señal de notificador:

void visualMaxChanged(qreal newVisualMax)

[read-only, since 6.11] visualMin : qreal

Esta propiedad contiene el valor mínimo visual del eje.

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

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

qreal visualMin() const

Señal de notificador:

void visualMinChanged(qreal newVisualMin)

[since 6.9] zoom : qreal

Esta propiedad contiene 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 enumeración se introdujo en Qt 6.9.

Funciones de acceso:

qreal zoom() const
void setZoom(qreal zoom)

Señal de notificador:

void zoomChanged(qreal zoom)

Documentación de funciones miembro

[explicit] QValueAxis::QValueAxis(QObject *parent = nullptr)

Crea un objeto de eje que es un elemento secundario de parent.

[override virtual noexcept] QValueAxis::~QValueAxis()

Destruye el objeto.

void QValueAxis::setRange(qreal min, qreal max)

Establece el intervalo de min a max en el eje. Si min es mayor que max, esta función finaliza sin realizar ningún cambio.

[override virtual] QAbstractAxis::AxisType QValueAxis::type() const

Reimplementa: ` QAbstractAxis::type()` const.

Devuelve el tipo del eje.

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