QCustom3DLabel 类

QCustom3DLabel 类向图形添加自定义标签。 更多...

头: #include <QCustom3DLabel>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
在 QML: Custom3DLabel
继承: QCustom3DItem

特性

公共函数

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

信号

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 )

详细描述

The text, font, position, scaling, rotation, and colors of a custom label can be set. In addition, the visibility of the borders and background of the label can be toggled. Colors, borders, and background are determined by the active theme unless set explicitly.

注意: In scaling, the z-coordinate has no effect. Setting the same x- and y-coordinates retains the original font dimensions.

另请参阅 Q3DGraphsWidgetItem::addCustomItem ().

特性文档编制

backgroundColor : QColor

This property holds the color for the label background, if enabled.

默认为 Qt::gray .

访问函数:

QColor backgroundColor () const
void setBackgroundColor (QColor color )

通知程序信号:

void backgroundColorChanged (QColor color )

另请参阅 backgroundVisible .

backgroundVisible : bool

This property holds whether the label background is visible.

若设为 false , backgroundColor () 不起作用。默认为 true .

访问函数:

bool isBackgroundVisible () const
void setBackgroundVisible (bool visible )

通知程序信号:

void backgroundVisibleChanged (bool visible )

borderVisible : bool

This property holds whether label borders are visible.

默认为 true .

访问函数:

bool isBorderVisible () const
void setBorderVisible (bool visible )

通知程序信号:

void borderVisibleChanged (bool visible )

facingCamera : bool

This property holds whether the label will always face the camera.

默认为 false 。若设为 true , rotation () has no effect.

访问函数:

bool isFacingCamera () const
void setFacingCamera (bool enabled )

通知程序信号:

void facingCameraChanged (bool enabled )

font : QFont

This property holds the font to be used for the label.

默认为 QFont("Arial", 20) . Special formatting (for example, outlined) is not supported.

访问函数:

QFont font () const
void setFont (const QFont & font )

通知程序信号:

void fontChanged (const QFont & font )

text : QString

This property holds the text for the label.

Rich text is not supported.

访问函数:

QString text () const
void setText (const QString & text )

通知程序信号:

void textChanged (const QString & text )

textColor : QColor

This property holds the color for the label text.

Also affects the label border, if enabled. Defaults to Qt::white .

访问函数:

QColor textColor () const
void setTextColor (QColor color )

通知程序信号:

void textColorChanged (QColor color )

另请参阅 borderVisible .

成员函数文档编制

[explicit] QCustom3DLabel:: QCustom3DLabel ( QObject * parent = nullptr)

Constructs a custom 3D label with the given parent .

[explicit] QCustom3DLabel:: QCustom3DLabel (const QString & text , const QFont & font , QVector3D position , QVector3D scaling , const QQuaternion & rotation , QObject * parent = nullptr)

Constructs a custom 3D label with the given text , font , position , scaling , rotation , and optional parent .

注意: Setting the same x- and y-coordinates for scaling retains the original font dimensions.

[override virtual noexcept] QCustom3DLabel:: ~QCustom3DLabel ()

Deletes the custom 3D label.