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 DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake : | QT += datavisualization |
| Depuis : | QtDataVisualization 1.1 |
| En QML : | Custom3DLabel |
| Hérites : | QCustom3DItem |
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
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 QAbstract3DGraph::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(const QColor &color) |
Signal de notification :
| void | backgroundColorChanged(const QColor &color) |
Voir aussi backgroundEnabled.
backgroundEnabled : bool
Cette propriété indique si l'arrière-plan de l'étiquette est activé.
Si elle vaut false, 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é indique si les bordures des étiquettes sont activées.
La valeur par défaut est true.
Fonctions d'accès :
| bool | isBorderEnabled() const |
| void | setBorderEnabled(bool enabled) |
Signal de notification :
| void | borderEnabledChanged(bool enabled) |
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 du notificateur :
| 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(const QColor &color) |
Signal du notificateur :
| void | textColorChanged(const QColor &color) |
Voir également borderEnabled.
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, const QVector3D &position, const 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.
[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.
