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 DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Desde: QtDataVisualization 1.0
En QML: ValueAxis3D
Heredado de: QAbstract3DAxis
Estado: Obsoleta

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Propiedades

Funciones públicas

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

Señales

void formatterChanged(QValue3DAxisFormatter *formatter)
void labelFormatChanged(const QString &format)
void reversedChanged(bool enable)
void segmentCountChanged(int count)
void subSegmentCountChanged(int 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. 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

[since QtDataVisualization 1.1] formatter : QValue3DAxisFormatter*

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

Cualquier formateador existente se elimina cuando se establece uno nuevo.

Esta enumeración se introdujo en QtDataVisualization 1.1.

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 indicadores proporcionados por printf() en la biblioteca estándar de C++: d, i, o, x, X, f, F, e, E, g, G, c.

Si QAbstract3DGraph::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 QAbstract3DGraph::locale.

[since QtDataVisualization 1.1] reversed : bool

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

Si se establece en « true », el eje se representará en orden inverso, es decir, 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.

Esta enumeración se introdujo en QtDataVisualization 1.1.

Funciones de acceso:

bool reversed() const
void setReversed(bool enable)

Señal de notificador:

void reversedChanged(bool enable)

segmentCount : int

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 dibujarán 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:

int segmentCount() const
void setSegmentCount(int count)

Señal de notificación:

void segmentCountChanged(int count)

Véase también setSubSegmentCount().

subSegmentCount : int

Esta propiedad indica el número de subsegmentos que hay dentro de cada segmento del 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:

int subSegmentCount() const
void setSubSegmentCount(int count)

Señal de notificación:

void subSegmentCountChanged(int count)

Véase también setSegmentCount().

Documentación de funciones de miembro

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

Crea un objeto `QValue3DAxis` con el valor ` parent` proporcionado.

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