Bar3DSeries QML Type
Représente une série de données dans un graphique à barres 3D. Plus d'informations...
| Import Statement: | import QtGraphs |
| In C++: | QBar3DSeries |
| Inherits: |
- Liste de tous les membres, y compris les membres hérités
- Bar3DSeries fait partie de Qt Graphs QML Types for 3D.
Propriétés
- baseColor : color
- baseGradient : Gradient
- colorStyle : GraphsTheme.ColorStyle
- columnLabels : list
- dataArray : BarDataArray
- dataProxy : BarDataProxy
- invalidSelectionPosition : point
- itemLabel : string
- itemLabelFormat : string
- itemLabelVisible : bool
- lightingMode : Abstract3DSeries.LightingMode
(since 6.10) - mesh : Abstract3DSeries.Mesh
- meshAngle : real
- meshRotation : quaternion
- meshSmooth : bool
- multiHighlightColor : color
- multiHighlightGradient : Gradient
- name : string
- rowColors : list<Color>
- rowLabels : list
- selectedBar : point
- singleHighlightColor : color
- singleHighlightGradient : Gradient
- type : Abstract3DSeries.SeriesType
- userDefinedMesh : string
- visible : bool
Signaux
- baseColorChanged(color color)
- baseGradientChanged(Gradient gradient)
- colorStyleChanged(GraphsTheme.ColorStyle style)
- columnLabelsChanged()
- dataArrayChanged(BarDataArray array)
- dataProxyChanged(BarDataProxy proxy)
- itemLabelChanged(string label)
- itemLabelFormatChanged(string format)
- itemLabelVisibilityChanged(bool visible)
- lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
(since 6.10) - meshAngleChanged(real angle)
- meshChanged(Abstract3DSeries.Mesh mesh)
- meshRotationChanged(quaternion rotation)
- meshSmoothChanged(bool enabled)
- multiHighlightColorChanged(color color)
- multiHighlightGradientChanged(Gradient gradient)
- nameChanged(string name)
- rowColorsChanged(list<color> rowcolors)
- rowLabelsChanged()
- selectedBarChanged(point position)
- singleHighlightColorChanged(color color)
- singleHighlightGradientChanged(Gradient gradient)
- userDefinedMeshChanged(string fileName)
- visibilityChanged(bool visible)
Méthodes
- void setMeshAxisAndAngle(vector3d axis, real angle)
Description détaillée
Ce type gère les éléments visuels spécifiques à la série, ainsi que les données de la série (via un proxy de données).
Bar3DSeries prend en charge les balises de format suivantes pour itemLabelFormat :
| @rowTitle | Titre de l'axe des lignes |
| @colTitle | Titre de l'axe des colonnes |
| @valueTitle | Titre de l'axe des valeurs |
| @rowIdx | Indice de ligne visible. Localisé à l'aide de la locale du graphique. |
| @colIdx | Indice de colonne visible. Localisé à l'aide de la locale du graphique. |
| @rowLabel | Etiquette de l'axe des lignes |
| @colLabel | Etiquette de l'axe des colonnes |
| @valueLabel | Valeur de l'élément formatée selon le format de l'axe des valeurs attaché au graphique. Pour plus d'informations, voir labelFormat. |
| @seriesName | Nom de la série |
| %<format spec> | Valeur de l'élément dans le format spécifié. Formatage selon les mêmes règles que labelFormat. |
Pour une description plus complète, voir QBar3DSeries.
Voir également Qt Graphs Data Handling with 3D.
Documentation sur les propriétés
baseColor : color
La couleur de base de la série.
Voir aussi colorStyle et GraphsTheme.seriesColors.
baseGradient : Gradient
Le gradient de base de la série.
Voir également colorStyle.
colorStyle : GraphsTheme.ColorStyle
Le style de couleur de la série.
Voir aussi GraphsTheme.ColorStyle.
columnLabels : list
Les libellés facultatifs des colonnes du tableau. Les index de ce tableau correspondent aux index des colonnes des lignes. Si la liste est plus courte que la ligne la plus longue, toutes les colonnes n'auront pas d'étiquettes.
dataArray : BarDataArray
Contient la référence du tableau de données.
dataArrayChanged Le signal est émis lorsque le tableau de données est défini, sauf si newDataArray est identique au précédent.
Remarque : avant de faire quoi que ce soit concernant le tableau de données, une série doit être créée pour le proxy concerné.
dataProxy : BarDataProxy
Le proxy de données actif. La série assume la propriété de tout proxy qui lui est attribué et supprime tout proxy précédemment attribué lorsqu'un nouveau proxy est ajouté. Le proxy ne peut pas être nul ou associé à une autre série.
invalidSelectionPosition : point [read-only]
Une propriété constante fournissant une position invalide pour la sélection. Cette position est affectée à la propriété selectedBar pour effacer la sélection de cette série.
Voir aussi GraphsItem3D.clearSelection().
itemLabel : string [read-only]
L'étiquette formatée de l'élément. S'il n'y a pas d'élément sélectionné ou si l'élément sélectionné n'est pas visible, renvoie une chaîne vide.
Voir aussi itemLabelFormat.
itemLabelFormat : string
Format d'étiquette pour les éléments de données de cette série. Ce format est utilisé pour les étiquettes d'un seul élément, par exemple lorsqu'un élément est sélectionné. L'interprétation du format dépend du type de série.
Voir également Bar3DSeries, Scatter3DSeries, et Surface3DSeries.
itemLabelVisible : bool
Si true, les étiquettes des éléments sont dessinées comme des étiquettes flottantes dans le graphique. Dans le cas contraire, les étiquettes d'éléments ne sont pas affichées. Pour afficher l'étiquette de l'élément dans un contrôle externe, cette propriété est définie sur false. La valeur par défaut est true.
Voir également itemLabelFormat et itemLabel.
lightingMode : Abstract3DSeries.LightingMode [since 6.10]
Le mode d'éclairage des éléments de la série. La valeur par défaut est QAbstract3DSeries::LightingMode::Shaded
Cette propriété a été introduite dans Qt 6.10.
Voir aussi QAbstract3DSeries::LightingMode.
mesh : Abstract3DSeries.Mesh
Le maillage des éléments de la série, ou le pointeur de sélection dans le cas de Surface3DSeries. Si le maillage est Abstract3DSeries.Mesh.UserDefined, la propriété userDefinedMesh doit également être définie pour que les éléments soient rendus correctement. La valeur par défaut dépend du type de graphique.
Voir également QAbstract3DSeries::Mesh.
meshAngle : real
Une propriété de commodité pour définir l'angle de rotation de la série en degrés.
Remarque : lors de la lecture de cette propriété, elle est calculée à partir de la valeur Abstract3DSeries.meshRotation en utilisant la précision de la virgule flottante et renvoie toujours une valeur comprise entre zéro et 360 degrés.
Voir aussi Abstract3DSeries.meshRotation.
meshRotation : quaternion
La rotation du maillage appliquée à tous les éléments de la série. La rotation doit être un quaternion normalisé. Pour les types de séries qui prennent en charge la rotation spécifique à un élément, les rotations sont multipliées ensemble. Bar3DSeries ignore toute rotation qui n'est pas autour de l'axe des y. Surface3DSeries applique la rotation uniquement au pointeur de sélection. La valeur par défaut est "pas de rotation".
meshSmooth : bool
Si true, des versions lisses des maillages prédéfinis définis via la propriété mesh sont utilisées. Cette propriété n'affecte pas les maillages personnalisés utilisés lorsque le maillage est défini sur Abstract3DSeries.Mesh.UserDefined. La valeur par défaut est false.
multiHighlightColor : color
La couleur de mise en évidence des éléments multiples de la série.
Voir également colorStyle et GraphsTheme.multiHighlightColor.
multiHighlightGradient : Gradient
Le gradient de mise en évidence des éléments multiples de la série.
Voir également colorStyle et GraphsTheme.multiHighlightGradient.
name : string
Le nom de la série. Il peut être utilisé sous forme d'étiquette d'article avec la balise @seriesName.
Voir également itemLabelFormat.
rowColors : list<Color>
Cette propriété peut être utilisée pour dessiner les lignes de la série en différentes couleurs. Le site GraphsTheme.colorStyle doit être défini sur Uniform pour utiliser cette propriété.
Remarque : si la propriété est définie et que le thème est modifié, la liste rowColors n'est pas effacée automatiquement.
Voir également QGraphsTheme::ColorStyle::Uniform.
rowLabels : list
Les étiquettes de ligne facultatives pour le tableau. Les index de ce tableau correspondent aux index des lignes du tableau de données. Si la liste est plus courte que le nombre de lignes, toutes les lignes ne seront pas étiquetées.
selectedBar : point
La barre de la série qui est sélectionnée.
La position de la barre sélectionnée est spécifiée sous la forme d'une ligne et d'une colonne dans le tableau de données de la série.
Une seule barre peut être sélectionnée à la fois.
Pour effacer la sélection de cette série, attribuez la position invalidSelectionPosition.
Si cette série est ajoutée à un graphique, celui-ci peut ajuster la sélection en fonction de l'interaction de l'utilisateur ou si elle devient invalide. La sélection d'une barre sur une autre série ajoutée effacera également la sélection.
La suppression ou l'insertion de lignes dans la série avant la ligne de la barre sélectionnée ajustera la sélection de manière à ce que la même barre reste sélectionnée.
Voir également GraphsItem3D.clearSelection().
singleHighlightColor : color
Couleur de mise en évidence d'un seul élément de la série.
Voir également colorStyle et GraphsTheme.singleHighlightColor.
singleHighlightGradient : Gradient
Le gradient de mise en évidence d'un seul élément de la série.
Voir également colorStyle et GraphsTheme.singleHighlightGradient.
type : Abstract3DSeries.SeriesType [read-only]
Le type de la série. Une des valeurs de QAbstract3DSeries::SeriesType.
userDefinedMesh : string
Le nom de fichier pour un maillage personnalisé défini par l'utilisateur pour les objets qui est utilisé lorsque mesh est Abstract3DSeries.Mesh.UserDefined.
Remarque : le fichier doit être au format de maillage QtQuick3D. Utilisez l'outil de conversion balsam pour créer un maillage à partir d'autres formats de modèles 3D.
visible : bool
La visibilité de la série. Si false, la série n'est pas rendue.
Documentation sur le signal
baseColorChanged(color color)
Ce signal est émis lorsque baseColor devient color.
Note : Le gestionnaire correspondant est onBaseColorChanged.
baseGradientChanged(Gradient gradient)
Ce signal est émis lorsque baseGradient devient gradient.
Note : Le gestionnaire correspondant est onBaseGradientChanged.
colorStyleChanged(GraphsTheme.ColorStyle style)
Ce signal est émis lorsque colorStyle devient style.
Note : Le gestionnaire correspondant est onColorStyleChanged.
columnLabelsChanged()
Ce signal est émis lorsque les étiquettes des colonnes changent.
Remarque : le gestionnaire correspondant est onColumnLabelsChanged.
dataArrayChanged(BarDataArray array)
Ce signal est émis lorsque dataArray devient array.
Note : Le gestionnaire correspondant est onDataArrayChanged.
dataProxyChanged(BarDataProxy proxy)
Ce signal est émis lorsque dataProxy devient proxy.
Note : Le gestionnaire correspondant est onDataProxyChanged.
itemLabelChanged(string label)
Ce signal est émis lorsque itemLabel devient label.
Note : Le gestionnaire correspondant est onItemLabelChanged.
itemLabelFormatChanged(string format)
Ce signal est émis lorsque itemLabelFormat devient format.
Note : Le gestionnaire correspondant est onItemLabelFormatChanged.
itemLabelVisibilityChanged(bool visible)
Ce signal est émis lorsque la valeur de itemLabelVisibility passe à visible.
Note : Le gestionnaire correspondant est onItemLabelVisibilityChanged.
[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
Ce signal est émis lorsque lightingMode devient lightingMode.
Note : Le gestionnaire correspondant est onLightingModeChanged.
Ce signal a été introduit dans Qt 6.10.
meshAngleChanged(real angle)
Ce signal est émis lorsque meshAngle devient angle.
Note : Le gestionnaire correspondant est onMeshAngleChanged.
meshChanged(Abstract3DSeries.Mesh mesh)
Ce signal est émis lorsque mesh devient mesh.
Note : Le gestionnaire correspondant est onMeshChanged.
meshRotationChanged(quaternion rotation)
Ce signal est émis lorsque meshRotation devient rotation.
Note : Le gestionnaire correspondant est onMeshRotationChanged.
meshSmoothChanged(bool enabled)
Ce signal est émis lorsque meshSmooth devient enabled.
Note : Le gestionnaire correspondant est onMeshSmoothChanged.
multiHighlightColorChanged(color color)
Ce signal est émis lorsque multiHighlightColor devient color.
Note : Le gestionnaire correspondant est onMultiHighlightColorChanged.
multiHighlightGradientChanged(Gradient gradient)
Ce signal est émis lorsque multiHighlightGradient devient gradient.
Note : Le gestionnaire correspondant est onMultiHighlightGradientChanged.
nameChanged(string name)
Ce signal est émis lorsque name devient name.
Note : Le gestionnaire correspondant est onNameChanged.
rowColorsChanged(list<color> rowcolors)
Ce signal est émis lorsque rowColors devient rowcolors.
Note : Le gestionnaire correspondant est onRowColorsChanged.
rowLabelsChanged()
Ce signal est émis lorsque les étiquettes des lignes changent.
Remarque : le gestionnaire correspondant est onRowLabelsChanged.
selectedBarChanged(point position)
Ce signal est émis lorsque selectedBar devient position.
Note : Le gestionnaire correspondant est onSelectedBarChanged.
singleHighlightColorChanged(color color)
Ce signal est émis lorsque singleHighlightColor devient color.
Note : Le gestionnaire correspondant est onSingleHighlightColorChanged.
singleHighlightGradientChanged(Gradient gradient)
Ce signal est émis lorsque singleHighlightGradient devient gradient.
Note : Le gestionnaire correspondant est onSingleHighlightGradientChanged.
userDefinedMeshChanged(string fileName)
Ce signal est émis lorsque userDefinedMesh devient fileName.
Note : Le gestionnaire correspondant est onUserDefinedMeshChanged.
visibilityChanged(bool visible)
Ce signal est émis lorsque la visibilité de la série passe à visible.
Note : Le gestionnaire correspondant est onVisibilityChanged.
Documentation de la méthode
void setMeshAxisAndAngle(vector3d axis, real angle)
Une fonction de commodité pour construire un quaternion de rotation de maillage à partir de axis et angle.
Voir aussi meshRotation.
© 2026 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.
