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 |
- Lista de todos los miembros, incluidos los heredados
- QValueAxis forma parte de las clases C++ deQt Graphs para 2D.
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.