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 DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake : | QT += datavisualization |
| Depuis : | QtDataVisualization 1.1 |
| En QML : | Custom3DLabel |
| Hérite de : | QCustom3DItem |
| Statut : | Obsolète |
Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Propriétés
|
Fonctions publiques
| 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 |
Signaux
| 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) |
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, la visibilité des bordures et de l’arrière-plan de l’étiquette peut être activée ou désactivée. 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 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 d'origine de la police.
Voir également QAbstract3DGraph::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(const QColor &color) |
Signal de notification :
| void | backgroundColorChanged(const QColor &color) |
Voir également backgroundEnabled.
backgroundEnabled : bool
Cette propriété détermine si l’arrière-plan de l’étiquette est activé.
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 | isBackgroundEnabled() const |
| void | setBackgroundEnabled(bool enabled) |
Signal de notification :
| void | backgroundEnabledChanged(bool enabled) |
borderEnabled : bool
Cette propriété détermine si les bordures des étiquettes sont activées.
Valeur par défaut : « true ».
Fonctions d'accès :
| bool | isBorderEnabled() const |
| void | setBorderEnabled(bool enabled) |
Signal de notification :
| void | borderEnabledChanged(bool enabled) |
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 affecte é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(const QColor &color) |
Signal de notification :
| void | textColorChanged(const QColor &color) |
Voir également borderEnabled.
Documentation des fonctions membres
[explicit] QCustom3DLabel::QCustom3DLabel(QObject *parent = nullptr)
Crée une étiquette 3D personnalisée à l'aide de l'parent on fournie.
[explicit] QCustom3DLabel::QCustom3DLabel(const QString &text, const QFont &font, const QVector3D &position, const 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.
[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.
