Represents a data series in a 3D bar graph. 更多...
| import 語句： |
import QtGraphs
|
| 在 C++： | QBar3DSeries |
| 繼承： |
(從 6.10 起)
(從 6.10 起)
This type manages the series specific visual elements, as well as the series data (via a data proxy).
Bar3DSeries supports the following format tags for itemLabelFormat:
| @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 labelFormat . |
| @seriesName | Name of the series |
| %<format spec> | Item value in the specified format. Formatted using the same rules as labelFormat . |
For a more complete description, see QBar3DSeries .
另請參閱 Qt Graphs Data Handling with 3D .
|
baseColor : color |
The base color of the series.
另請參閱 colorStyle and GraphsTheme.seriesColors .
|
baseGradient : 漸變 |
The base gradient of the series.
另請參閱 colorStyle .
|
colorStyle : GraphsTheme . ColorStyle |
The color style for the series.
另請參閱 GraphsTheme.ColorStyle .
|
columnLabels : list |
The optional column labels for the array. Indexes in this array match column indexes in rows. If the list is shorter than the longest row, all columns will not get labels.
|
dataArray : BarDataArray |
Holds the reference of the data array.
dataArrayChanged signal is emitted when data array is set, unless newDataArray is identical to the previous one.
注意： Before doing anything regarding the dataArray, a series must be created for the relevant proxy.
|
dataProxy : BarDataProxy |
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.
|
invalidSelectionPosition
:
point
|
A constant property providing an invalid position for selection. This position is assigned to the selectedBar property to clear the selection from this series.
另請參閱 GraphsItem3D.clearSelection ().
|
itemLabel
:
string
|
The formatted item label. If there is no selected item or the selected item is not visible, returns an empty string.
另請參閱 itemLabelFormat .
|
itemLabelFormat : string |
The label format for data items in this series. This format is used for single item labels, for example, when an item is selected. How the format is interpreted depends on series type.
另請參閱 Bar3DSeries , Scatter3DSeries ，和 Surface3DSeries .
|
itemLabelVisible : bool |
若
true
, item labels are drawn as floating labels in the graph. Otherwise, item labels are not drawn. To show the item label in an external control, this property is set to
false
。默認為
true
.
另請參閱 itemLabelFormat and itemLabel .
|
lightingMode
:
Abstract3DSeries
.
LightingMode
|
The lighting mode of the items in the series. The default value is QAbstract3DSeries::LightingMode::Shaded
此特性在 Qt 6.10 引入。
另請參閱 QAbstract3DSeries::LightingMode .
|
mesh : Abstract3DSeries . Mesh |
The mesh of the items in the series, or the selection pointer in case of Surface3DSeries . If the mesh is Abstract3DSeries.Mesh.UserDefined , then the userDefinedMesh property must also be set for items to render properly. The default value depends on the graph type.
另請參閱 QAbstract3DSeries::Mesh .
|
meshAngle : real |
A convenience property for defining the series rotation angle in degrees.
注意： When reading this property, it is calculated from the Abstract3DSeries.meshRotation value using floating point precision and always returns a value from zero to 360 degrees.
另請參閱 Abstract3DSeries.meshRotation .
|
meshRotation : quaternion |
The mesh rotation that is applied to all items of the series. The rotation should be a normalized quaternion. For those series types that support item specific rotation, the rotations are multiplied together. Bar3DSeries ignores any rotation that is not around the y-axis. Surface3DSeries applies the rotation only to the selection pointer. Defaults to no rotation.
|
meshSmooth : bool |
若
true
, smooth versions of predefined meshes set via the
mesh
property are used. This property does not affect custom meshes used when the mesh is set to
Abstract3DSeries.Mesh.UserDefined
。默認為
false
.
|
multiHighlightColor : color |
The multiple item highlight color of the series.
另請參閱 colorStyle and GraphsTheme.multiHighlightColor .
|
multiHighlightGradient : 漸變 |
The multiple item highlight gradient of the series.
另請參閱 colorStyle and GraphsTheme.multiHighlightGradient .
|
名稱 : string |
The series name. It can be used in item label format with the tag
@seriesName
.
另請參閱 itemLabelFormat .
|
rowColors : list < 顔色 > |
This property can be used to draw the rows of the series in different colors. The
GraphsTheme.colorStyle
must be set to
Uniform
to use this property.
注意： If the property is set and the theme is changed, the rowColors list is not cleared automatically.
另請參閱 QGraphsTheme::ColorStyle::Uniform .
|
rowLabels : list |
The optional row labels for the array. Indexes in this array match the row indexes in the data array. If the list is shorter than the number of rows, all rows will not get labels.
|
selectedBar : point |
The bar in the series that is selected.
The position of the selected bar is specified as a row and column in the data array of the series.
Only one bar can be selected at a time.
To clear the selection from this series, assign invalidSelectionPosition as the position.
If this series is added to a graph, the graph can adjust the selection according to user interaction or if it becomes invalid. Selecting a bar on another added series will also clear the selection.
Removing rows from or inserting rows into the series before the row of the selected bar will adjust the selection so that the same bar will stay selected.
另請參閱 GraphsItem3D.clearSelection ().
|
singleHighlightColor : color |
The single item highlight color of the series.
另請參閱 colorStyle and GraphsTheme.singleHighlightColor .
|
singleHighlightGradient : 漸變 |
The single item highlight gradient of the series.
另請參閱 colorStyle and GraphsTheme.singleHighlightGradient .
|
type
:
Abstract3DSeries
.
SeriesType
|
The type of the series. One of the QAbstract3DSeries::SeriesType 值。
|
userDefinedMesh : string |
The filename for a user defined custom mesh for objects that is used when mesh is Abstract3DSeries.Mesh.UserDefined .
注意：
The file needs to be in the
QtQuick3D
mesh format. Use the
balsam
conversion tool to create a mesh from other 3D model formats.
|
visible : bool |
The visibility of the series. If
false
, the series is not rendered.
|
baseColorChanged ( color color ) |
此信號發射，當 baseColor changes to color .
注意：
相應處理程序是
onBaseColorChanged
.
|
baseGradientChanged ( 漸變 gradient ) |
此信號發射，當 baseGradient changes to gradient .
注意：
相應處理程序是
onBaseGradientChanged
.
|
colorStyleChanged ( GraphsTheme . ColorStyle style ) |
此信號發射，當 colorStyle changes to style .
注意：
相應處理程序是
onColorStyleChanged
.
|
columnLabelsChanged () |
This signal is emitted when column labels change.
注意：
相應處理程序是
onColumnLabelsChanged
.
|
dataArrayChanged ( BarDataArray array ) |
此信號發射，當 dataArray changes to array .
注意：
相應處理程序是
onDataArrayChanged
.
|
dataProxyChanged ( BarDataProxy proxy ) |
此信號發射，當 dataProxy changes to proxy .
注意：
相應處理程序是
onDataProxyChanged
.
|
itemLabelChanged ( string label ) |
此信號發射，當 itemLabel changes to label .
注意：
相應處理程序是
onItemLabelChanged
.
|
itemLabelFormatChanged ( string format ) |
此信號發射，當 itemLabelFormat changes to format .
注意：
相應處理程序是
onItemLabelFormatChanged
.
|
itemLabelVisibilityChanged ( bool visible ) |
This signal is emitted when itemLabelVisibility changes to visible .
注意：
相應處理程序是
onItemLabelVisibilityChanged
.
|
|
此信號發射，當 lightingMode changes to lightingMode .
注意：
相應處理程序是
onLightingModeChanged
.
This signal was introduced in Qt 6.10.
|
meshAngleChanged ( real angle ) |
此信號發射，當 meshAngle changes to angle .
注意：
相應處理程序是
onMeshAngleChanged
.
|
meshChanged ( Abstract3DSeries . Mesh mesh ) |
此信號發射，當 mesh changes to mesh .
注意：
相應處理程序是
onMeshChanged
.
|
meshRotationChanged ( quaternion rotation ) |
此信號發射，當 meshRotation changes to rotation .
注意：
相應處理程序是
onMeshRotationChanged
.
|
meshSmoothChanged ( bool enabled ) |
此信號發射，當 meshSmooth changes to enabled .
注意：
相應處理程序是
onMeshSmoothChanged
.
|
multiHighlightColorChanged ( color color ) |
此信號發射，當 multiHighlightColor changes to color .
注意：
相應處理程序是
onMultiHighlightColorChanged
.
|
multiHighlightGradientChanged ( 漸變 gradient ) |
此信號發射，當 multiHighlightGradient changes to gradient .
注意：
相應處理程序是
onMultiHighlightGradientChanged
.
|
nameChanged ( string name ) |
此信號發射，當 name changes to name .
注意：
相應處理程序是
onNameChanged
.
此信號發射，當 rowColors changes to rowcolors .
注意：
相應處理程序是
onRowColorsChanged
.
|
rowLabelsChanged () |
This signal is emitted when row labels change.
注意：
相應處理程序是
onRowLabelsChanged
.
|
selectedBarChanged ( point position ) |
此信號發射，當 selectedBar changes to position .
注意：
相應處理程序是
onSelectedBarChanged
.
|
singleHighlightColorChanged ( color color ) |
此信號發射，當 singleHighlightColor changes to color .
注意：
相應處理程序是
onSingleHighlightColorChanged
.
|
singleHighlightGradientChanged ( 漸變 gradient ) |
此信號發射，當 singleHighlightGradient changes to gradient .
注意：
相應處理程序是
onSingleHighlightGradientChanged
.
|
userDefinedMeshChanged ( string fileName ) |
此信號發射，當 userDefinedMesh changes to fileName .
注意：
相應處理程序是
onUserDefinedMeshChanged
.
|
visibilityChanged ( bool visible ) |
This signal is emitted when the series visibility changes to visible .
注意：
相應處理程序是
onVisibilityChanged
.
A convenience function to construct a mesh rotation quaternion from axis and angle .
另請參閱 meshRotation .