QCustom3DLabel Class
Die Klasse QCustom3DLabel fügt einem Diagramm eine benutzerdefinierte Beschriftung hinzu. Mehr...
| Kopfzeile: | #include <QCustom3DLabel> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Since: | QtDataVisualization 1.1 |
| In QML: | Custom3DLabel |
| Vererbt: | QCustom3DItem |
Eigenschaften
|
Öffentliche Funktionen
| 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 |
Signale
| 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) |
Detaillierte Beschreibung
Der Text, die Schriftart, die Position, die Skalierung, die Drehung und die Farben eines benutzerdefinierten Etiketts können eingestellt werden. Darüber hinaus kann die Sichtbarkeit der Ränder und des Hintergrunds des Etiketts umgeschaltet werden. Farben, Ränder und Hintergrund werden durch das aktive Thema bestimmt, sofern sie nicht explizit festgelegt werden.
Hinweis: Bei der Skalierung hat die z-Koordinate keine Auswirkung. Wenn Sie die gleichen x- und y-Koordinaten einstellen, bleiben die ursprünglichen Schriftgrößen erhalten.
Siehe auch QAbstract3DGraph::addCustomItem().
Dokumentation der Eigenschaft
backgroundColor : QColor
Diese Eigenschaft enthält die Farbe für den Etikettenhintergrund, falls aktiviert.
Der Standardwert ist Qt::gray.
Zugriffsfunktionen:
| QColor | backgroundColor() const |
| void | setBackgroundColor(const QColor &color) |
Benachrichtigungssignal:
| void | backgroundColorChanged(const QColor &color) |
Siehe auch backgroundEnabled.
backgroundEnabled : bool
Diese Eigenschaft gibt an, ob der Etikettenhintergrund aktiviert ist.
Wenn sie auf false gesetzt ist, hat backgroundColor() keine Wirkung. Die Voreinstellung ist true.
Zugriffsfunktionen:
| bool | isBackgroundEnabled() const |
| void | setBackgroundEnabled(bool enabled) |
Benachrichtigungssignal:
| void | backgroundEnabledChanged(bool enabled) |
borderEnabled : bool
Diese Eigenschaft gibt an, ob Etikettenränder aktiviert sind.
Der Standardwert ist true.
Zugriffsfunktionen:
| bool | isBorderEnabled() const |
| void | setBorderEnabled(bool enabled) |
Benachrichtigungssignal:
| void | borderEnabledChanged(bool enabled) |
facingCamera : bool
Diese Eigenschaft legt fest, ob die Beschriftung immer in Richtung der Kamera zeigen soll.
Die Standardeinstellung ist false. Wenn sie auf true gesetzt ist, hat rotation() keine Wirkung.
Zugriffsfunktionen:
| bool | isFacingCamera() const |
| void | setFacingCamera(bool enabled) |
Benachrichtigungssignal:
| void | facingCameraChanged(bool enabled) |
font : QFont
Diese Eigenschaft enthält die Schriftart, die für die Beschriftung verwendet werden soll.
Der Standardwert ist QFont("Arial", 20). Spezielle Formatierungen (z. B. umrandet) werden nicht unterstützt.
Zugriffsfunktionen:
| QFont | font() const |
| void | setFont(const QFont &font) |
Melder-Signal:
| void | fontChanged(const QFont &font) |
text : QString
Diese Eigenschaft enthält den Text für die Beschriftung.
Rich Text wird nicht unterstützt.
Zugriffsfunktionen:
| QString | text() const |
| void | setText(const QString &text) |
Melder-Signal:
| void | textChanged(const QString &text) |
textColor : QColor
Diese Eigenschaft enthält die Farbe für den Beschriftungstext.
Sie wirkt sich auch auf die Umrandung des Etiketts aus, sofern sie aktiviert ist. Die Standardeinstellung ist Qt::white.
Zugriffsfunktionen:
| QColor | textColor() const |
| void | setTextColor(const QColor &color) |
Benachrichtigungssignal:
| void | textColorChanged(const QColor &color) |
Siehe auch borderEnabled.
Dokumentation der Mitgliedsfunktionen
[explicit] QCustom3DLabel::QCustom3DLabel(QObject *parent = nullptr)
Konstruiert ein benutzerdefiniertes 3D-Etikett mit dem angegebenen parent.
[explicit] QCustom3DLabel::QCustom3DLabel(const QString &text, const QFont &font, const QVector3D &position, const QVector3D &scaling, const QQuaternion &rotation, QObject *parent = nullptr)
Konstruiert ein benutzerdefiniertes 3D-Etikett mit den angegebenen text, font, position, scaling, rotation und optional parent.
Hinweis: Wenn Sie die gleichen x- und y-Koordinaten für scaling festlegen, bleiben die ursprünglichen Schriftabmessungen erhalten.
[virtual noexcept] QCustom3DLabel::~QCustom3DLabel()
Löscht die benutzerdefinierte 3D-Beschriftung.
© 2025 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.
