Back to Qt.io
Contact Us Blog Download Qt
En esta página

QValueAxis Class

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

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

Propiedades

Funciones públicas

QValueAxis(QObject *parent = nullptr)
virtual ~QValueAxis() override
int labelDecimals() const
QString labelFormat() const
qreal max() const
qreal min() const
qreal pan() const
void setLabelDecimals(int decimals)
void setLabelFormat(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 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

Un eje de valores puede configurarse para mostrar una línea de eje con marcas de graduación, líneas de cuadrícula y sombras. Los valores del eje se dibujan en las posiciones de las marcas de graduación.

Documentación de Propiedades

labelDecimals : int

Esta propiedad contiene el número de decimales utilizados para mostrar las etiquetas. Cuando se establece a -1, la cantidad de decimales se ajusta automáticamente basándose en el rango de valores. El valor por defecto es -1.

Funciones de acceso:

int labelDecimals() const
void setLabelDecimals(int decimals)

Señal del notificador:

void labelDecimalsChanged(int decimals)

labelFormat : QString

Esta propiedad contiene el formato de etiqueta del eje.

La cadena de formato admite los siguientes especificadores de conversión, modificadores de longitud y banderas proporcionados por printf() en la biblioteca estándar de C++: d, i, o, x, X, f, F, e, E, g, G, c.

El valor por defecto es vacío, en cuyo 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().

max : qreal

Esta propiedad contiene el valor máximo del eje.

Cuando se establece esta propiedad, el valor mínimo se ajusta si es necesario, para asegurar que el rango sigue siendo válido. El valor por defecto es 10.0

Funciones de acceso:

qreal max() const
void setMax(qreal max)

Señal del notificador:

void maxChanged(qreal max)

min : qreal

Esta propiedad contiene el valor mínimo del eje.

Cuando se establece esta propiedad, el valor máximo se ajusta si es necesario, para asegurar que el rango sigue siendo válido. El valor por defecto es 0.0

Funciones de acceso:

qreal min() const
void setMin(qreal min)

Señal del notificador:

void minChanged(qreal min)

[since 6.9] pan : qreal

Esta propiedad contiene el valor panorámico del eje.

El valor de paneo mueve el centro del eje sin afectar a los intervalos de rejilla y etiquetas. El valor por defecto es 0.

Esta propiedad se introdujo en Qt 6.9.

Funciones de acceso:

qreal pan() const
void setPan(qreal pan)

Notificador de señal:

void panChanged(qreal pan)

subTickCount : qsizetype

Esta propiedad contiene el número de subpuntos en el eje. Indica cuántos subpuntos se dibujan entre las líneas principales del gráfico. Las etiquetas no se dibujan para los subticks. El valor por defecto es 0.

Funciones de acceso:

qsizetype subTickCount() const
void setSubTickCount(qsizetype count)

Señal del notificador:

void subTickCountChanged(qsizetype subTickCount)

tickAnchor : qreal

Esta propiedad contiene el valor base del que parten las marcas de graduación y etiquetas colocadas dinámicamente. El valor por defecto es 0.

Funciones de acceso:

qreal tickAnchor() const
void setTickAnchor(qreal anchor)

Señal del notificador:

void tickAnchorChanged(qreal tickAnchor)

tickInterval : qreal

Esta propiedad contiene el intervalo entre las marcas de graduación y las etiquetas colocadas dinámicamente. El valor por defecto es 0, lo que significa que los intervalos se calculan automáticamente basándose en el rango mínimo y máximo.

Funciones de acceso:

qreal tickInterval() const
void setTickInterval(qreal interval)

Señal del notificador:

void tickIntervalChanged(qreal tickInterval)

[read-only, since 6.11] visualMax : qreal

Esta propiedad contiene el valor máximo visual del eje.

Esta propiedad contiene un valor máximo visual del eje cuando éste ha sido desplazado o ampliado. El valor por defecto es QValueAxis::max

Esta propiedad se introdujo en Qt 6.11.

Funciones de acceso:

qreal visualMax() const

Señal notificadora:

void visualMaxChanged(qreal newVisualMax)

[read-only, since 6.11] visualMin : qreal

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

Esta propiedad mantiene un valor mínimo visual del eje cuando éste ha sido desplazado o ampliado. El valor por defecto es QValueAxis::min

Esta propiedad se introdujo en Qt 6.11.

Funciones de acceso:

qreal visualMin() const

Señal notificadora:

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 tanto, el gráfico sin afectar a los intervalos de la rejilla y las etiquetas. El valor por defecto es 1.

Esta propiedad se introdujo en Qt 6.9.

Funciones de acceso:

qreal zoom() const
void setZoom(qreal zoom)

Señal del notificador:

void zoomChanged(qreal zoom)

Documentación de funciones miembro

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

Construye un objeto eje hijo de parent.

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

Destruye el objeto.

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

Establece el rango de min a max en el eje. Si min es mayor que max, esta función vuelve 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.