QCustom3DLabel Class
La classe QCustom3DLabel ajoute une étiquette personnalisée à un graphique. Plus d'informations...
| En-tête : | #include <QCustom3DLabel> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake : | QT += graphs |
| En QML : | Custom3DLabel |
| Héritages : | QCustom3DItem |
- Liste de tous les membres, y compris les membres hérités
- QCustom3DLabel fait partie de Qt Graphs C++ Classes for 3D.
Propriétés
|
Fonctions publiques
| 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 |
Signaux
| 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) |
Description détaillée
Le texte, la police, la position, l'échelle, la rotation et les couleurs d'une étiquette personnalisée peuvent être définis. En outre, la visibilité des bordures et de l'arrière-plan de l'étiquette peut être modifiée. Les couleurs, les bordures et l'arrière-plan sont déterminés par le thème actif, à moins qu'ils ne soient définis explicitement.
Remarque : lors de la mise à l'échelle, la coordonnée z n'a aucun effet. Le fait de définir les mêmes coordonnées x et y permet de conserver les dimensions originales de la police.
Voir également Q3DGraphsWidgetItem::addCustomItem().
Documentation sur les propriétés
backgroundColor : QColor
Cette propriété définit la couleur de l'arrière-plan de l'étiquette, si elle est activée.
La valeur par défaut est Qt::gray.
Fonctions d'accès :
| QColor | backgroundColor() const |
| void | setBackgroundColor(QColor color) |
Signal de notification :
| void | backgroundColorChanged(QColor color) |
Voir aussi backgroundVisible.
backgroundVisible : bool
Cette propriété indique si l'arrière-plan de l'étiquette est visible.
Si elle vaut false, backgroundColor() n'a aucun effet. La valeur par défaut est true.
Fonctions d'accès :
| bool | isBackgroundVisible() const |
| void | setBackgroundVisible(bool visible) |
Signal de notification :
| void | backgroundVisibleChanged(bool visible) |
borderVisible : bool
Cette propriété indique si les bordures des étiquettes sont visibles.
La valeur par défaut est true.
Fonctions d'accès :
| bool | isBorderVisible() const |
| void | setBorderVisible(bool visible) |
Signal de notification :
| void | borderVisibleChanged(bool visible) |
facingCamera : bool
Cette propriété indique si l'étiquette doit toujours faire face à la caméra.
La valeur par défaut est false. Si la valeur est true, rotation() n'a pas d'effet.
Fonctions d'accès :
| bool | isFacingCamera() const |
| void | setFacingCamera(bool enabled) |
Signal de notification :
| void | facingCameraChanged(bool enabled) |
font : QFont
Cette propriété contient la police à utiliser pour l'étiquette.
La valeur par défaut est QFont("Arial", 20). Les formats spéciaux (par exemple, les contours) ne sont pas pris en charge.
Fonctions d'accès :
| QFont | font() const |
| void | setFont(const QFont &font) |
Signal de notification :
| void | fontChanged(const QFont &font) |
text : QString
Cette propriété contient le texte de l'étiquette.
Le texte enrichi n'est pas pris en charge.
Fonctions d'accès :
| QString | text() const |
| void | setText(const QString &text) |
Signal de notification :
| void | textChanged(const QString &text) |
textColor : QColor
Cette propriété définit la couleur du texte de l'étiquette.
Elle affecte également la bordure de l'étiquette, si elle est activée. La valeur par défaut est Qt::white.
Fonctions d'accès :
| QColor | textColor() const |
| void | setTextColor(QColor color) |
Signal du notificateur :
| void | textColorChanged(QColor color) |
Voir également borderVisible.
Documentation des fonctions membres
[explicit] QCustom3DLabel::QCustom3DLabel(QObject *parent = nullptr)
Construit une étiquette 3D personnalisée avec l'adresse parent.
[explicit] QCustom3DLabel::QCustom3DLabel(const QString &text, const QFont &font, QVector3D position, QVector3D scaling, const QQuaternion &rotation, QObject *parent = nullptr)
Construit une étiquette 3D personnalisée avec les données text, font, position, scaling, rotation, et optionnellement parent.
Remarque : le fait de définir les mêmes coordonnées x et y pour scaling permet de conserver les dimensions originales de la police.
[override virtual noexcept] QCustom3DLabel::~QCustom3DLabel()
Supprime l'étiquette 3D personnalisée.
© 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.
