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 Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| En QML: | Custom3DLabel |
| Heredan de: | QCustom3DItem |
- Lista de todos los miembros, incluidos los heredados
- QCustom3DLabel forma parte de las clases C++ deQt Graphs para 3D.
Propiedades
|
Funciones públicas
| QCustom3DLabel(QObject *parent = nullptr) | |
| QCustom3DLabel(const QString &text, const QFont &font, QVector3D position, QVector3D scaling, const QQuaternion &rotation, QObject *parent = nullptr) | |
| virtual | ~QCustom3DLabel() override |
| QColor | backgroundColor() const |
| QFont | font() const |
| bool | isBackgroundVisible() const |
| bool | isBorderVisible() const |
| bool | isFacingCamera() const |
| void | setBackgroundColor(QColor color) |
| void | setBackgroundVisible(bool visible) |
| void | setBorderVisible(bool visible) |
| void | setFacingCamera(bool enabled) |
| void | setFont(const QFont &font) |
| void | setText(const QString &text) |
| void | setTextColor(QColor color) |
| QString | text() const |
| QColor | textColor() const |
Señales
| void | backgroundColorChanged(QColor color) |
| void | backgroundVisibleChanged(bool visible) |
| void | borderVisibleChanged(bool visible) |
| void | facingCameraChanged(bool enabled) |
| void | fontChanged(const QFont &font) |
| void | textChanged(const QString &text) |
| void | textColorChanged(QColor color) |
Descripción detallada
Se pueden configurar el texto, la fuente, la posición, el escalado, 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 Q3DGraphsWidgetItem::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(QColor color) |
Señal de notificación:
| void | backgroundColorChanged(QColor color) |
Véase también backgroundVisible.
backgroundVisible : bool
Esta propiedad determina si el fondo de la etiqueta es visible.
Si se establece en « false », la función « backgroundColor()» no tiene ningún efecto. El valor por defecto es « true ».
Funciones de acceso:
| bool | isBackgroundVisible() const |
| void | setBackgroundVisible(bool visible) |
Señal del notificador:
| void | backgroundVisibleChanged(bool visible) |
borderVisible : bool
Esta propiedad determina si los bordes de las etiquetas son visibles.
El valor por defecto es « true ».
Funciones de acceso:
| bool | isBorderVisible() const |
| void | setBorderVisible(bool visible) |
Señal de notificador:
| void | borderVisibleChanged(bool visible) |
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 », la función « 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 por defecto es Qt::white.
Funciones de acceso:
| QColor | textColor() const |
| void | setTextColor(QColor color) |
Señal de notificación:
| void | textColorChanged(QColor color) |
Véase también borderVisible.
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, QVector3D position, QVector3D scaling, const QQuaternion &rotation, QObject *parent = nullptr)
Crea una etiqueta 3D personalizada con los valores indicados para « text », « font », « position », « scaling », « rotation » y, opcionalmente, « parent ».
Nota: Al establecer las mismas coordenadas x e y para scaling, se conservan las dimensiones originales de la fuente.
[override 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.