En esta página

QValue3DAxis Class

La clase QValue3DAxis manipula un eje de un gráfico. Más...

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

Propiedades

Funciones públicas

QValue3DAxis(QObject *parent = nullptr)
virtual ~QValue3DAxis() override
QValue3DAxisFormatter *formatter() const
QString labelFormat() const
bool reversed() const
qsizetype segmentCount() const
void setFormatter(QValue3DAxisFormatter *formatter)
void setLabelFormat(const QString &format)
void setReversed(bool enable)
void setSegmentCount(qsizetype count)
void setSubSegmentCount(qsizetype count)
qsizetype subSegmentCount() const

Señales

void formatterChanged(QValue3DAxisFormatter *formatter)
void labelFormatChanged(const QString &format)
void reversedChanged(bool enable)
void segmentCountChanged(qsizetype count)
void subSegmentCountChanged(qsizetype count)

Descripción detallada

A un eje de valores se le puede dar un rango de valores y un número de segmentos y subsegmentos en los que dividir el rango.

Se dibujan etiquetas entre cada segmento y líneas de cuadrícula entre cada segmento y cada subsegmento.

Nota: Si es visible, siempre habrá al menos dos líneas de cuadrícula y etiquetas que indiquen los valores mínimo y máximo del intervalo, ya que siempre hay al menos un segmento.

Documentación de propiedades

formatter : QValue3DAxisFormatter*

Esta propiedad contiene el formateador de ejes a utilizar.

Cualquier formateador existente se elimina cuando se establece un nuevo formateador.

Funciones de acceso:

QValue3DAxisFormatter *formatter() const
void setFormatter(QValue3DAxisFormatter *formatter)

Señal del notificador:

void formatterChanged(QValue3DAxisFormatter *formatter)

labelFormat : QString

Esta propiedad contiene el formato de etiqueta que se utilizará para las etiquetas de este 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.

Si Q3DGraphsWidgetItem::locale es cualquier otra cosa que "C", los especificadores soportados se limitan a: d, e, E, f, g, G, e i. Además, sólo se soporta el modificador de precisión. El resto del formato proviene del predeterminado QLocale de la aplicación.

Ejemplo de uso:

axis->setLabelFormat("%.2f mm");

Funciones de acceso:

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

Señal de notificador:

void labelFormatChanged(const QString &format)

Véase también formatter y Q3DGraphsWidgetItem::locale.

reversed : bool

Esta propiedad indica si el eje se representa al revés.

Si true, el eje se representará al revés, lo que significa que las posiciones de los valores mínimo y máximo se intercambian cuando se representa el gráfico. Esta propiedad no afecta a los valores máximos y mínimos del eje.

Funciones de acceso:

bool reversed() const
void setReversed(bool enable)

Señal del notificador:

void reversedChanged(bool enable)

segmentCount : qsizetype

Esta propiedad contiene el número de segmentos del eje.

Indica cuántas etiquetas se dibujan. El número de líneas de la rejilla a dibujar se calcula con la fórmula: segments * subsegments + 1. El valor predeterminado es 5. El valor no puede ser inferior a 1.

Funciones de acceso:

qsizetype segmentCount() const
void setSegmentCount(qsizetype count)

Señal del notificador:

void segmentCountChanged(qsizetype count)

Véase también setSubSegmentCount().

subSegmentCount : qsizetype

Esta propiedad contiene el número de subsegmentos dentro de cada segmento del eje.

Las líneas de la cuadrícula se dibujan entre cada subsegmento, además de cada segmento. El valor predeterminado es 1. El valor no puede ser inferior a 1.

Funciones de acceso:

qsizetype subSegmentCount() const
void setSubSegmentCount(qsizetype count)

Señal del notificador:

void subSegmentCountChanged(qsizetype count)

Véase también setSegmentCount().

Documentación de las funciones miembro

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

Construye QValue3DAxis con la dirección parent.

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

Destruye QValue3DAxis.

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