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: | |
| 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
| 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
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.
| Constante | Valor | Descripción |
|---|---|---|
QValueAxis::TicksDynamic | 0 | Las marcas se colocan según los valores de « tickAnchor » y « tickInterval ». |
QValueAxis::TicksFixed | 1 | Las 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.