QCustom3DLabel Class

Die Klasse QCustom3DLabel fügt einem Diagramm eine benutzerdefinierte Beschriftung hinzu. Mehr...

Kopfzeile: #include <QCustom3DLabel>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
In QML: Custom3DLabel
Vererbt: QCustom3DItem

Eigenschaften

Öffentliche Funktionen

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

Signale

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)

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 Labels 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 Q3DGraphsWidgetItem::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(QColor color)

Benachrichtigungssignal:

void backgroundColorChanged(QColor color)

Siehe auch backgroundVisible.

backgroundVisible : bool

Diese Eigenschaft bestimmt, ob der Hintergrund des Etiketts sichtbar ist.

Wenn sie auf false gesetzt ist, hat backgroundColor() keine Wirkung. Die Voreinstellung ist true.

Zugriffsfunktionen:

bool isBackgroundVisible() const
void setBackgroundVisible(bool visible)

Benachrichtigungssignal:

void backgroundVisibleChanged(bool visible)

borderVisible : bool

Diese Eigenschaft legt fest, ob Etikettenränder sichtbar sind.

Der Standardwert ist true.

Zugriffsfunktionen:

bool isBorderVisible() const
void setBorderVisible(bool visible)

Benachrichtigungssignal:

void borderVisibleChanged(bool visible)

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. Der Standardwert ist Qt::white.

Zugriffsfunktionen:

QColor textColor() const
void setTextColor(QColor color)

Benachrichtigungssignal:

void textColorChanged(QColor color)

Siehe auch borderVisible.

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, QVector3D position, 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.

[override 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.