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

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 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. Se trazan líneas de cuadrícula entre cada segmento y cada subsegmento.

Nota: Si son visibles, 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

[since QtDataVisualization 1.1] formatter : QValue3DAxisFormatter*

Esta propiedad contiene el formateador de ejes a utilizar.

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

Esta propiedad se introdujo en QtDataVisualization 1.1.

Funciones de acceso:

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

Señal de 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 QAbstract3DGraph::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 QAbstract3DGraph::locale.

[since QtDataVisualization 1.1] reversed : bool

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

Si true, el eje se representará al revés, es decir, 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ínimos y máximos del eje.

Esta propiedad se introdujo en QtDataVisualization 1.1.

Funciones de acceso:

bool reversed() const
void setReversed(bool enable)

Señal del notificador:

void reversedChanged(bool enable)

segmentCount : int

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:

int segmentCount() const
void setSegmentCount(int count)

Señal del notificador:

void segmentCountChanged(int count)

Véase también setSubSegmentCount().

subSegmentCount : int

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:

int subSegmentCount() const
void setSubSegmentCount(int count)

Señal del notificador:

void subSegmentCountChanged(int 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.

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