En esta página

QCustom3DLabel Class

La clase QCustom3DLabel añade una etiqueta personalizada a un gráfico. Más información...

Encabezado: #include <QCustom3DLabel>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Desde: QtDataVisualization 1.1
En QML: Custom3DLabel
Heredado de: QCustom3DItem
Estado: Obsoleta

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Propiedades

Funciones públicas

QCustom3DLabel(QObject *parent = nullptr)
QCustom3DLabel(const QString &text, const QFont &font, const QVector3D &position, const QVector3D &scaling, const QQuaternion &rotation, QObject *parent = nullptr)
virtual ~QCustom3DLabel()
QColor backgroundColor() const
QFont font() const
bool isBackgroundEnabled() const
bool isBorderEnabled() const
bool isFacingCamera() const
void setBackgroundColor(const QColor &color)
void setBackgroundEnabled(bool enabled)
void setBorderEnabled(bool enabled)
void setFacingCamera(bool enabled)
void setFont(const QFont &font)
void setText(const QString &text)
void setTextColor(const QColor &color)
QString text() const
QColor textColor() const

Señales

void backgroundColorChanged(const QColor &color)
void backgroundEnabledChanged(bool enabled)
void borderEnabledChanged(bool enabled)
void facingCameraChanged(bool enabled)
void fontChanged(const QFont &font)
void textChanged(const QString &text)
void textColorChanged(const QColor &color)

Descripción detallada

Se pueden configurar el texto, la fuente, la posición, la escala, la rotación y los colores de una etiqueta personalizada. Además, se puede activar o desactivar la visibilidad de los bordes y el fondo de la etiqueta. Los colores, los bordes y el fondo vienen determinados por el tema activo, a menos que se especifiquen explícitamente.

Nota: En el escalado, la coordenada z no tiene ningún efecto. Al establecer las mismas coordenadas x e y, se conservan las dimensiones originales de la fuente.

Véase también QAbstract3DGraph::addCustomItem().

Documentación de propiedades

backgroundColor : QColor

Esta propiedad establece el color del fondo de la etiqueta, si está activada.

El valor predeterminado es Qt::gray.

Funciones de acceso:

QColor backgroundColor() const
void setBackgroundColor(const QColor &color)

Señal de notificación:

void backgroundColorChanged(const QColor &color)

Véase también backgroundEnabled.

backgroundEnabled : bool

Esta propiedad determina si el fondo de la etiqueta está activado.

Si se establece en « false », la función « backgroundColor()» no tiene ningún efecto. El valor por defecto es « true ».

Funciones de acceso:

bool isBackgroundEnabled() const
void setBackgroundEnabled(bool enabled)

Señal de notificación:

void backgroundEnabledChanged(bool enabled)

borderEnabled : bool

Esta propiedad determina si los bordes de las etiquetas están activados.

El valor predeterminado es « true ».

Funciones de acceso:

bool isBorderEnabled() const
void setBorderEnabled(bool enabled)

Señal de notificación:

void borderEnabledChanged(bool enabled)

facingCamera : bool

Esta propiedad determina si la etiqueta estará siempre orientada hacia la cámara.

El valor por defecto es false. Si se establece en true, rotation() no tiene ningún efecto.

Funciones de acceso:

bool isFacingCamera() const
void setFacingCamera(bool enabled)

Señal de notificación:

void facingCameraChanged(bool enabled)

font : QFont

Esta propiedad especifica la fuente que se utilizará para la etiqueta.

El valor predeterminado es « QFont("Arial", 20) ». No se admite el formato especial (por ejemplo, con contorno).

Funciones de acceso:

QFont font() const
void setFont(const QFont &font)

Señal de notificación:

void fontChanged(const QFont &font)

text : QString

Esta propiedad contiene el texto de la etiqueta.

No se admite texto con formato.

Funciones de acceso:

QString text() const
void setText(const QString &text)

Señal de notificación:

void textChanged(const QString &text)

textColor : QColor

Esta propiedad define el color del texto de la etiqueta.

También afecta al borde de la etiqueta, si está activado. El valor predeterminado es « Qt::white ».

Funciones de acceso:

QColor textColor() const
void setTextColor(const QColor &color)

Señal de notificación:

void textColorChanged(const QColor &color)

Véase también borderEnabled.

Documentación de funciones de miembro

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

Crea una etiqueta 3D personalizada con el archivo « parent » proporcionado.

[explicit] QCustom3DLabel::QCustom3DLabel(const QString &text, const QFont &font, const QVector3D &position, const QVector3D &scaling, const QQuaternion &rotation, QObject *parent = nullptr)

Crea una etiqueta 3D personalizada con los valores proporcionados para « text », « font », « position », « scaling », « rotation » y el valor opcional « parent ».

Nota: Al establecer las mismas coordenadas x e y para scaling, se conservan las dimensiones originales de la fuente.

[virtual noexcept] QCustom3DLabel::~QCustom3DLabel()

Elimina la etiqueta 3D personalizada.

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