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

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

QCategoryAxis

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

void applyNiceNumbers()

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

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 en el eje se dibujan en las posiciones de las marcas de tick.

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 del tipo de miembro

enum QValueAxis::TickType

Este enum describe cómo se colocan los ticks 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 colocan uniformemente a lo largo del eje. El valor tickCount especifica el número de ticks.

Documentación de la propiedad

labelFormat : QString

Esta propiedad contiene el formato de etiqueta del eje.

La cadena de formato soporta los siguientes especificadores de conversión, modificadores de longitud y flags 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, sólo se admite el modificador de precisión. El resto del formato procede del predeterminado QLocale de la aplicación.

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.

Al establecer esta propiedad, el valor mínimo se ajusta si es necesario, para garantizar que el rango sigue siendo válido.

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.

Al establecer esta propiedad, el valor máximo se ajusta si es necesario, para garantizar que el rango sigue siendo válido.

Funciones de acceso:

qreal min() const
void setMin(qreal min)

Señal del notificador:

void minChanged(qreal min)

minorTickCount : int

Esta propiedad contiene el número de marcas de graduación menores en el eje. Indica cuántas líneas de cuadrícula se dibujan entre los ticks mayores del gráfico. Las etiquetas no se dibujan para los ticks menores. El valor por defecto es 0.

Funciones de acceso:

int minorTickCount() const
void setMinorTickCount(int count)

Señal del notificador:

void minorTickCountChanged(int minorTickCount)

tickAnchor : qreal

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

Funciones de acceso:

qreal tickAnchor() const
void setTickAnchor(qreal anchor)

Señal del notificador:

void tickAnchorChanged(qreal anchor)

tickCount : int

Esta propiedad contiene el número de marcas de graduación en el eje. 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 del notificador:

void tickCountChanged(int tickCount)

tickInterval : qreal

Esta propiedad contiene el intervalo entre las marcas de graduación y las etiquetas colocadas dinámicamente.

Funciones de acceso:

qreal tickInterval() const
void setTickInterval(qreal insterval)

Señal del notificador:

void tickIntervalChanged(qreal interval)

tickType : TickType

Esta propiedad contiene el método de posicionamiento del tick y las etiquetas.

Funciones de acceso:

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

Señal del notificador:

void tickTypeChanged(QValueAxis::TickType type)

Documentación de funciones miembro

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

Construye un objeto eje hijo de parent.

[virtual noexcept] QValueAxis::~QValueAxis()

Destruye el objeto.

[slot] void QValueAxis::applyNiceNumbers()

Modifica el rango actual y el número de marcas de graduación en el eje para que tenga un aspecto agradable. El algoritmo considera que los números que se pueden expresar de forma 1*10^n, 2* 10^n, o 5*10^n son números bonitos. Estos números se utilizan para establecer el espaciado de las marcas de graduación.

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

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

Esta señal se emite cuando cambia la dirección format de las etiquetas de los ejes.

Nota: Señal notificadora para la propiedad labelFormat.

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

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

Nota: Señal notificadora para la propiedad max.

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

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

Nota: Señal notificadora de la propiedad min.

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

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

Nota: Señal notificadora 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 por min y max.

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.

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

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

Nota: Señal notificadora 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.