En esta página

QValueAxis Class

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

Header: #include <QValueAxis>
In QML: ValueAxis
Inherits: QAbstractAxis
Inherited By:

QCategoryAxis

Status: Deprecated

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Tipos públicos

enum TickType { TicksDynamic, TicksFixed }

Propiedades

Funciones públicas

QValueAxis(QObject *parent = nullptr)
virtual ~QValueAxis()
QString labelFormat() const
qreal max() const
qreal min() const
int minorTickCount() const
void setLabelFormat(const QString &format)
void setMax(qreal max)
void setMin(qreal min)
void setMinorTickCount(int count)
void setRange(qreal min, qreal max)
void setTickAnchor(qreal anchor)
void setTickCount(int count)
void setTickInterval(qreal insterval)
void setTickType(QValueAxis::TickType type)
qreal tickAnchor() const
int tickCount() const
qreal tickInterval() const
QValueAxis::TickType tickType() const

Funciones públicas reimplementadas

virtual QAbstractAxis::AxisType type() const override

Ranuras públicas

Señales

void labelFormatChanged(const QString &format)
void maxChanged(qreal max)
void minChanged(qreal min)
void minorTickCountChanged(int minorTickCount)
void rangeChanged(qreal min, qreal max)
void tickAnchorChanged(qreal anchor)
void tickCountChanged(int tickCount)
void tickIntervalChanged(qreal interval)
void tickTypeChanged(QValueAxis::TickType type)

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.

El siguiente código de ejemplo ilustra cómo utilizar la clase QValueAxis:

QChartView *chartView = new QChartView;
QLineSeries *series = new QLineSeries;
// ...
chartView->chart()->addSeries(series);

QValueAxis *axisX = new QValueAxis;
axisX->setRange(10, 20.5);
axisX->setTickCount(10);
axisX->setLabelFormat("%.2f");
chartView->chart()->setAxisX(axisX, series);

Documentación sobre los tipos de miembros

enum QValueAxis::TickType

Esta enumeración describe cómo se colocan las marcas y las etiquetas en el eje.

ConstanteValorDescripción
QValueAxis::TicksDynamic0Las marcas se colocan según los valores de « tickAnchor » y « tickInterval ».
QValueAxis::TicksFixed1Las marcas se distribuyen de manera uniforme a lo largo del rango del eje. El valor de « tickCount » especifica el número de marcas.

Documentación de la propiedad

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.

Si QChart::localizeNumbers es true, los especificadores admitidos se limitan a: d, e, E, f, g, G e i. Además, solo se admite el modificador de precisión. El resto del formato proviene de la configuración predeterminada QLocale de la aplicación.

Funciones de acceso:

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

Señal del notificador:

void labelFormatChanged(const QString &format)

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

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.

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.

Funciones de acceso:

qreal min() const
void setMin(qreal min)

Señal de notificación:

void minChanged(qreal min)

minorTickCount : int

Esta propiedad indica el número de marcas secundarias en el eje. Esto indica cuántas líneas de cuadrícula se dibujan entre las marcas principales del gráfico. No se dibujan etiquetas para las marcas secundarias. El valor por defecto es 0.

Funciones de acceso:

int minorTickCount() const
void setMinorTickCount(int count)

Señal de notificación:

void minorTickCountChanged(int minorTickCount)

tickAnchor : qreal

Esta propiedad establece el valor de referencia a partir del cual se colocan dinámicamente las marcas de escala y las etiquetas.

Funciones de acceso:

qreal tickAnchor() const
void setTickAnchor(qreal anchor)

Señal de notificación:

void tickAnchorChanged(qreal anchor)

tickCount : int

Esta propiedad indica el número de marcas de escala en el eje. Esto indica cuántas líneas de cuadrícula se dibujan en el gráfico. El valor por defecto es 5, y el número no puede ser inferior a 2.

Funciones de acceso:

int tickCount() const
void setTickCount(int count)

Señal de notificación:

void tickCountChanged(int tickCount)

tickInterval : qreal

Esta propiedad define el intervalo entre las marcas de escala y las etiquetas colocadas dinámicamente.

Funciones de acceso:

qreal tickInterval() const
void setTickInterval(qreal insterval)

Señal de notificación:

void tickIntervalChanged(qreal interval)

tickType : TickType

Esta propiedad define el método de posicionamiento de las marcas y las etiquetas.

Funciones de acceso:

QValueAxis::TickType tickType() const
void setTickType(QValueAxis::TickType type)

Señal de notificador:

void tickTypeChanged(QValueAxis::TickType type)

Documentación de las funciones de miembro

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

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

[virtual noexcept] QValueAxis::~QValueAxis()

Destruye el objeto.

[slot] void QValueAxis::applyNiceNumbers()

Modifica el intervalo actual y el número de marcas de escala del eje para que el resultado sea atractivo. El algoritmo considera que los números que pueden expresarse como 1*10^n, 2*10^n o 5*10^n son números «bonitos». Estos números se utilizan para establecer el espaciado entre las marcas de escala.

Véase también setRange() y setTickCount().

[signal] void QValueAxis::labelFormatChanged(const QString &format)

Esta señal se emite cuando cambia la propiedad « format » de las etiquetas de los ejes.

Nota: Señalde notificación para la propiedad « labelFormat ».

[signal] void QValueAxis::maxChanged(qreal max)

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

Nota: Señalde notificación para la propiedad max.

[signal] void QValueAxis::minChanged(qreal min)

Esta señal se emite cuando cambia el valor mínimo del eje, especificado por « min ».

Nota: Señalde notificación para la propiedad min.

[signal] void QValueAxis::minorTickCountChanged(int minorTickCount)

Esta señal se emite cuando cambia el número de marcas de graduación secundarias del eje, especificado por minorTickCount.

Nota: Señalde notificación para la propiedad minorTickCount.

[signal] void QValueAxis::rangeChanged(qreal min, qreal max)

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

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

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

[signal] void QValueAxis::tickCountChanged(int tickCount)

Esta señal se emite cuando cambia el número de marcas de escala del eje, especificado por ` tickCount`.

Nota: Señalde notificador para la propiedad tickCount.

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