QCustom3DLabel Class
The QCustom3DLabel class adds a custom label to a graph. More...
| Header: | #include <QCustom3DLabel> |
| Since: | QtDataVisualization 1.1 |
| Instantiated By: | Custom3DLabel |
| Inherits: | QCustom3DItem |
Properties
|
- 9 properties inherited from QCustom3DItem
- 1 property inherited from QObject
Public Functions
| 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 |
- 20 public functions inherited from QCustom3DItem
- 31 public functions inherited from QObject
Signals
| 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) |
- 9 signals inherited from QCustom3DItem
- 2 signals inherited from QObject
Static Public Members
| const QMetaObject | staticMetaObject |
- 9 static public members inherited from QObject
Additional Inherited Members
Detailed Description
The QCustom3DLabel class adds a custom label to a graph.
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.
Note: In scaling, the z-coordinate has no effect. Setting the same x- and y-coordinates retains the original font dimensions.
See also QAbstract3DGraph::addCustomItem().
Property Documentation
backgroundColor : QColor
This property holds the color for the label background, if enabled.
Defaults to Qt::gray.
Access functions:
| QColor | backgroundColor() const |
| void | setBackgroundColor(const QColor &color) |
Notifier signal:
| void | backgroundColorChanged(const QColor &color) |
See also backgroundEnabled.
backgroundEnabled : bool
This property holds whether the label background is enabled.
If set to false, backgroundColor() has no effect. Defaults to true.
Access functions:
| bool | isBackgroundEnabled() const |
| void | setBackgroundEnabled(bool enabled) |
Notifier signal:
| void | backgroundEnabledChanged(bool enabled) |
borderEnabled : bool
This property holds whether label borders are enabled.
Defaults to true.
Access functions:
| bool | isBorderEnabled() const |
| void | setBorderEnabled(bool enabled) |
Notifier signal:
| void | borderEnabledChanged(bool enabled) |
facingCamera : bool
This property holds whether the label will always face the camera.
Defaults to false. If set to true, rotation() has no effect.
Access functions:
| bool | isFacingCamera() const |
| void | setFacingCamera(bool enabled) |
Notifier signal:
| void | facingCameraChanged(bool enabled) |
font : QFont
This property holds the font to be used for the label.
Defaults to QFont("Arial", 20). Special formatting (for example, outlined) is not supported.
Access functions:
| QFont | font() const |
| void | setFont(const QFont &font) |
Notifier signal:
| void | fontChanged(const QFont &font) |
text : QString
This property holds the text for the label.
Rich text is not supported.
Access functions:
| QString | text() const |
| void | setText(const QString &text) |
Notifier signal:
| 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.
Access functions:
| QColor | textColor() const |
| void | setTextColor(const QColor &color) |
Notifier signal:
| void | textColorChanged(const QColor &color) |
See also borderEnabled.
Member Function Documentation
QCustom3DLabel::QCustom3DLabel(QObject *parent = nullptr)
Constructs a custom 3D label with the given parent.
QCustom3DLabel::QCustom3DLabel(const QString &text, const QFont &font, const QVector3D &position, const QVector3D &scaling, const QQuaternion &rotation, QObject *parent = nullptr)
Constructs a custom 3D label with the given text, font, position, scaling, rotation, and optional parent.
Note: Setting the same x- and y-coordinates for scaling retains the original font dimensions.
[virtual] QCustom3DLabel::~QCustom3DLabel()
Deletes the custom 3D label.
© 2021 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.