En esta página

QValue3DAxis Class

La clase QValue3DAxis permite manipular un eje de un gráfico. Más información...

Encabezado: #include <QValue3DAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: Value3DAxis
Heredan: 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 asignar un rango de valores y un número de segmentos y subsegmentos en los que dividir dicho rango.

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

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

Documentación de propiedades

formatter : QValue3DAxisFormatter*

Esta propiedad contiene el formateador de ejes que se va a utilizar.

Cualquier formateador existente se elimina cuando se establece uno nuevo.

Funciones de acceso:

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

Señal de notificación:

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 e indicadores 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 distinto de "C", 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.

Ejemplo de uso:

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

Funciones de acceso:

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

Señal del notificador:

void labelFormatChanged(const QString &format)

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

reversed : bool

Esta propiedad determina si el eje se representa en orden inverso.

Si se establece en « true », el eje se representará en orden inverso, lo que significa que las posiciones de los valores mínimo y máximo se intercambian al representar el gráfico. Esta propiedad no afecta a los valores mínimo y máximo reales del eje.

Funciones de acceso:

bool reversed() const
void setReversed(bool enable)

Señal de notificación:

void reversedChanged(bool enable)

segmentCount : qsizetype

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

Esto indica cuántas etiquetas se dibujan. El número de líneas de cuadrícula que se van 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 de notificación:

void segmentCountChanged(qsizetype count)

Véase también setSubSegmentCount().

subSegmentCount : qsizetype

Esta propiedad indica el número de subsegmentos que hay dentro de cada segmento en el eje.

Se trazan líneas de cuadrícula entre cada subsegmento, además de entre 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 de notificación:

void subSegmentCountChanged(qsizetype count)

Véase también setSegmentCount().

Documentación de funciones de miembro

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

Crea un objeto `QValue3DAxis` con el ` parent` indicado.

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