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().