QBar3DSeries Class
The QBar3DSeries class represents a data series in a 3D bar graph. More...
Header: | #include <QBar3DSeries> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
qmake: | QT += datavisualization |
Since: | QtDataVisualization 1.0 |
Instantiated By: | Bar3DSeries |
Inherits: | QAbstract3DSeries |
Properties
- dataProxy : QBarDataProxy*
- meshAngle : float
- rowColors : QList<QColor>
- selectedBar : QPoint
Public Functions
virtual | ~QBar3DSeries() |
QBarDataProxy * | dataProxy() const |
float | meshAngle() const |
QList<QColor> | rowColors() const |
QPoint | selectedBar() const |
void | setDataProxy() |
void | setMeshAngle() |
void | setRowColors() |
void | setSelectedBar() |
Signals
void | dataProxyChanged() |
void | meshAngleChanged() |
void | rowColorsChanged() |
void | selectedBarChanged() |
Static Public Members
QPoint | invalidSelectionPosition() |
Detailed Description
This class manages the series specific visual elements, as well as the series data (via a data proxy).
If no data proxy is set explicitly for the series, the series creates a default proxy. Setting another proxy will destroy the existing proxy and all data added to it.
QBar3DSeries supports the following format tags for QAbstract3DSeries::setItemLabelFormat():
@rowTitle | Title from row axis |
@colTitle | Title from column axis |
@valueTitle | Title from value axis |
@rowIdx | Visible row index. Localized using the graph locale. |
@colIdx | Visible column index. Localized using the graph locale. |
@rowLabel | Label from row axis |
@colLabel | Label from column axis |
@valueLabel | Item value formatted using the format of the value axis attached to the graph. For more information, see QValue3DAxis::labelFormat. |
@seriesName | Name of the series |
%<format spec> | Item value in the specified format. Formatted using the same rules as QValue3DAxis::labelFormat. |
For example:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
See also Qt Data Visualization Data Handling and QAbstract3DGraph::locale.
Property Documentation
dataProxy : QBarDataProxy*
This property holds the active data proxy.
The series assumes ownership of any proxy set to it and deletes any previously set proxy when a new one is added. The proxy cannot be null or set to another series.
Access functions:
QBarDataProxy * | dataProxy() const |
void | setDataProxy() |
Notifier signal:
void | dataProxyChanged() |
meshAngle : float
This property holds the series rotation angle in degrees.
Setting this property is equivalent to the following call:
setMeshRotation(QQuaternion::fromAxisAndAngle(0.0f, 1.0f, 0.0f, angle))
Note: When reading this property, it is calculated from the QAbstract3DSeries::meshRotation value using floating point precision and always returns a value from zero to 360 degrees.
Access functions:
float | meshAngle() const |
void | setMeshAngle() |
Notifier signal:
void | meshAngleChanged() |
See also QAbstract3DSeries::meshRotation.
[since 6.3]
rowColors : QList<QColor>
This property holds the list of row colors in the series.
This property can be used to color the rows of the series in different colors. The Q3DTheme::ColorStyle must be set to Q3DTheme::ColorStyleUniform to use this property.
This property was introduced in Qt 6.3.
Access functions:
QList<QColor> | rowColors() const |
void | setRowColors() |
Notifier signal:
void | rowColorsChanged() |
See also Q3DTheme::ColorStyleUniform.
selectedBar : QPoint
This property holds the bar in the series that is selected.
Access functions:
QPoint | selectedBar() const |
void | setSelectedBar() |
Notifier signal:
void | selectedBarChanged() |
Member Function Documentation
[virtual]
QBar3DSeries::~QBar3DSeries()
Deletes a bar 3D series.
[static]
QPoint QBar3DSeries::invalidSelectionPosition()
Returns an invalid position for selection. This position is set to the selectedBar property to clear the selection from this series.
See also QAbstract3DGraph::clearSelection().