En esta página

QAbstract3DAxis Class

La clase QAbstract3DAxis es una clase base para los ejes de un gráfico 3D. Más...

Cabecera: #include <QAbstract3DAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: Abstract3DAxis
Hereda de: QObject
Heredado por:

QCategory3DAxis y QValue3DAxis

Tipos Públicos

enum class AxisOrientation { None, X, Y, Z }
enum class AxisType { None, Category, Value }

Propiedades

Funciones públicas

virtual ~QAbstract3DAxis() override
bool isAutoAdjustRange() const
bool isScaleLabelsByCount() const
bool isTitleFixed() const
bool isTitleVisible() const
float labelAutoAngle() const
qreal labelSize() const
QStringList labels() const
bool labelsVisible() const
float max() const
float min() const
QAbstract3DAxis::AxisOrientation orientation() const
void setAutoAdjustRange(bool autoAdjust)
void setLabelAutoAngle(float degree)
void setLabelSize(qreal size)
void setLabels(const QStringList &labels)
void setLabelsVisible(bool visible)
void setMax(float max)
void setMin(float min)
void setRange(float min, float max)
void setScaleLabelsByCount(bool adjust)
void setTitle(const QString &title)
void setTitleFixed(bool fixed)
void setTitleOffset(float offset)
void setTitleVisible(bool visible)
QString title() const
float titleOffset() const
QAbstract3DAxis::AxisType type() const

Señales

void autoAdjustRangeChanged(bool autoAdjust)
void labelAutoAngleChanged(float angle)
void labelSizeChanged(qreal size)
void labelVisibleChanged(bool visible)
void labelsChanged()
void maxChanged(float value)
void minChanged(float value)
void orientationChanged(QAbstract3DAxis::AxisOrientation orientation)
void rangeChanged(float min, float max)
void scaleLabelsByCountChanged(bool adjust)
void titleChanged(const QString &newTitle)
void titleFixedChanged(bool fixed)
void titleOffsetChanged(float offset)
void titleVisibleChanged(bool visible)

Descripción detallada

Esta clase especifica las enumeraciones, propiedades y funciones compartidas por los ejes gráficos. No debe utilizarse directamente, sino una de sus subclases.

Véase también QCategory3DAxis y QValue3DAxis.

Documentación de tipos de miembros

enum class QAbstract3DAxis::AxisOrientation

La orientación del objeto eje.

ConstanteValor
QAbstract3DAxis::AxisOrientation::None0
QAbstract3DAxis::AxisOrientation::X1
QAbstract3DAxis::AxisOrientation::Y2
QAbstract3DAxis::AxisOrientation::Z3

enum class QAbstract3DAxis::AxisType

Tipo del objeto eje.

ConstanteValor
QAbstract3DAxis::AxisType::None0
QAbstract3DAxis::AxisType::Category1
QAbstract3DAxis::AxisType::Value2

Propiedad Documentación

autoAdjustRange : bool

Esta propiedad mantiene si el eje ajustará automáticamente el rango para que todos los datos quepan en él.

Funciones de acceso:

bool isAutoAdjustRange() const
void setAutoAdjustRange(bool autoAdjust)

Señal notificador:

void autoAdjustRangeChanged(bool autoAdjust)

Véase también setRange(), setMin(), y setMax().

labelAutoAngle : float

Esta propiedad contiene el ángulo máximo que las etiquetas pueden autorotar cuando cambia el ángulo de la cámara.

El ángulo puede estar entre 0 y 90, ambos inclusive. El valor por defecto es 0. Si el valor es 0, las etiquetas de los ejes no rotan automáticamente. Si el valor es mayor que cero, las etiquetas intentan orientarse hacia la cámara, hasta el ángulo especificado.

Funciones de acceso:

float labelAutoAngle() const
void setLabelAutoAngle(float degree)

Señal del notificador:

void labelAutoAngleChanged(float angle)

[since 6.9] labelSize : qreal

Tamaño de la etiqueta

Tamaño de la etiqueta. El valor por defecto es 1.0.

Esta propiedad se introdujo en Qt 6.9.

Funciones de acceso:

qreal labelSize() const
void setLabelSize(qreal size)

Señal del notificador:

void labelSizeChanged(qreal size)

Véase también scaleLabelsByCount.

labels : QStringList

Esta propiedad contiene las etiquetas para el eje.

Nota: Establecer esta propiedad para QValue3DAxis no hace nada, ya que genera las etiquetas automáticamente.

Funciones de acceso:

QStringList labels() const
void setLabels(const QStringList &labels)

Señal del notificador:

void labelsChanged()

labelsVisible : bool

Esta propiedad mantiene si las etiquetas de los ejes son visibles en la vista del gráfico primario.

El valor por defecto es true.

Funciones de acceso:

bool labelsVisible() const
void setLabelsVisible(bool visible)

Señal del notificador:

void labelVisibleChanged(bool visible)

max : float

Esta propiedad contiene el valor máximo del eje.

Cuando se establece esta propiedad, el valor mínimo se ajusta si es necesario, para asegurar que el rango sigue siendo válido.

Nota: Para QCategory3DAxis, especifica el índice de la última fila o columna a mostrar.

Funciones de acceso:

float max() const
void setMax(float max)

Señal del notificador:

void maxChanged(float value)

min : float

Esta propiedad contiene el valor mínimo del eje.

Al establecer esta propiedad, el valor máximo se ajusta si es necesario, para asegurar que el rango sigue siendo válido.

Nota: Para QCategory3DAxis, especifica el índice de la primera fila o columna a mostrar.

Funciones de acceso:

float min() const
void setMin(float min)

Señal del notificador:

void minChanged(float value)

[read-only] orientation : QAbstract3DAxis::AxisOrientation

Esta propiedad contiene la orientación del eje.

El valor es uno de los valores de AxisOrientation.

Funciones de acceso:

QAbstract3DAxis::AxisOrientation orientation() const

Señal del notificador:

void orientationChanged(QAbstract3DAxis::AxisOrientation orientation)

[since 6.9] scaleLabelsByCount : bool

Esta propiedad mantiene si las etiquetas ajustarán automáticamente su tamaño basándose en la cantidad total de etiquetas

Esta propiedad se introdujo en Qt 6.9.

Funciones de acceso:

bool isScaleLabelsByCount() const
void setScaleLabelsByCount(bool adjust)

Señal de notificador:

void scaleLabelsByCountChanged(bool adjust)

Véase también labelSize().

title : QString

Esta propiedad contiene el título del eje.

Funciones de acceso:

QString title() const
void setTitle(const QString &title)

Señal del notificador:

void titleChanged(const QString &newTitle)

Véase también titleVisible y titleFixed.

titleFixed : bool

Esta propiedad contiene la rotación de los títulos de los ejes.

Si false, los títulos de los ejes en la vista del gráfico primario se rotarán hacia la cámara de forma similar a las etiquetas de los ejes. Si true, los títulos de los ejes sólo se rotan alrededor de su eje pero no se orientan hacia la cámara. Esta propiedad no tiene ningún efecto si el valor de la propiedad labelAutoAngle es cero. El valor por defecto es true.

Funciones de acceso:

bool isTitleFixed() const
void setTitleFixed(bool fixed)

Señal notificadora:

void titleFixedChanged(bool fixed)

Véase también labelAutoAngle, title, y titleVisible.

titleOffset : float

Posición del título del eje en el eje. El valor debe estar comprendido entre -1.0f y 1.0f

Funciones de acceso:

float titleOffset() const
void setTitleOffset(float offset)

Señal del notificador:

void titleOffsetChanged(float offset)

Véase también title y titleFixed.

titleVisible : bool

Esta propiedad indica si el título del eje es visible en la vista del gráfico primario.

El valor por defecto es false.

Funciones de acceso:

bool isTitleVisible() const
void setTitleVisible(bool visible)

Señal del notificador:

void titleVisibleChanged(bool visible)

Véase también title y titleFixed.

[read-only] type : const QAbstract3DAxis::AxisType

Esta propiedad contiene el tipo de eje.

El valor es uno de los valores de AxisType.

Funciones de acceso:

QAbstract3DAxis::AxisType type() const

Documentación de funciones miembro

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

Destruye QAbstract3DAxis.

[signal] void QAbstract3DAxis::rangeChanged(float min, float max)

Emite los valores mínimo y máximo del rango, min y max, cuando el rango cambia.

void QAbstract3DAxis::setRange(float min, float max)

Establece el rango de valores del eje de min a max. Al establecer el rango, el valor máximo se ajusta si es necesario, para garantizar que el rango sigue siendo válido.

Nota: Para QCategory3DAxis, especifica el rango de índice de filas o columnas a mostrar.

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