QCustom3DLabel Class
La classe QCustom3DLabel permet d'ajouter une étiquette personnalisée à un graphique. En savoir plus...
| 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érite de : | QCustom3DItem |
- Liste de tous les membres, y compris les membres hérités
- QCustom3DLabel fait partie des classes C++ «Qt Graphs » pour la 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
Il est possible de définir le texte, la police, la position, le redimensionnement, la rotation et les couleurs d'une étiquette personnalisée. De plus, il est possible d'activer ou de désactiver l'affichage des bordures et de l'arrière-plan de l'étiquette. Les couleurs, les bordures et l'arrière-plan sont déterminés par le thème actif, sauf s'ils sont définis explicitement.
Remarque : lors du redimensionnement, la coordonnée z n'a aucun effet. En définissant les mêmes coordonnées x et y, les dimensions d'origine de la police sont conservées.
Voir également Q3DGraphsWidgetItem::addCustomItem().
Documentation sur les propriétés
backgroundColor : QColor
Cette propriété définit la couleur d'arrière-plan de l'étiquette, si cette option 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 également backgroundVisible.
backgroundVisible : bool
Cette propriété détermine si l'arrière-plan de l'étiquette est visible.
Si elle est définie sur « false », la fonction « 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é détermine 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é détermine si l'étiquette sera toujours orientée vers la caméra.
La valeur par défaut est « false ». Si la valeur est définie sur « true », la fonction rotation() n'a aucun effet.
Fonctions d'accès :
| bool | isFacingCamera() const |
| void | setFacingCamera(bool enabled) |
Signal de notification :
| void | facingCameraChanged(bool enabled) |
font : QFont
Cette propriété définit la police à utiliser pour l'étiquette.
La valeur par défaut est « QFont("Arial", 20) ». Les mises en forme spéciales (par exemple, les contours) ne sont pas prises 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 s'applique également à la bordure de l'étiquette, si celle-ci est activée. La valeur par défaut est « Qt::white ».
Fonctions d'accès :
| QColor | textColor() const |
| void | setTextColor(QColor color) |
Signal de notification :
| void | textColorChanged(QColor color) |
Voir également borderVisible.
Documentation des fonctions membres
[explicit] QCustom3DLabel::QCustom3DLabel(QObject *parent = nullptr)
Crée une étiquette 3D personnalisée à partir de l'parent on fournie.
[explicit] QCustom3DLabel::QCustom3DLabel(const QString &text, const QFont &font, QVector3D position, QVector3D scaling, const QQuaternion &rotation, QObject *parent = nullptr)
Crée une étiquette 3D personnalisée avec les paramètres suivants : ` text`, ` font`, ` position`, ` scaling`, ` rotation` et, en option, ` parent`.
Remarque : en définissant les mêmes coordonnées x et y pour ` scaling `, les dimensions d'origine de la police sont conservées.
[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.
