Bar3DSeries QML Type (Uncreatable)
Représente une série de données sous la forme d'un graphique à barres en 3D. En savoir plus...
| Import Statement: | import QtGraphs |
| In C++: | QBar3DSeries |
| Inherits: |
Remarque : il s'agit d'un type non instanciable. Il ne peut pas être instancié en QML.
- Liste de tous les membres, y compris les membres hérités
- Bar3DSeries fait partie des types QML 3D d'Qt Graphs .
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 | Index de la ligne visible. Localisé selon les paramètres régionaux du graphique. |
| @colIdx | Indice de colonne visible. Localisé selon les paramètres régionaux du graphe. |
| @rowLabel | Étiquette de l’axe des lignes |
| @colLabel | Étiquette de l'axe des colonnes |
| @valueLabel | Valeur de l'élément formatée selon le format de l'axe des valeurs associé au graphique. Pour plus d'informations, consultez labelFormat. |
| @seriesName | Nom de la série |
| %<spécification de format> | Valeur de l'élément dans le format spécifié. Formatée selon les mêmes règles que labelFormat. |
Pour une description plus complète, voir QBar3DSeries.
Voir également Qt Graphs Traitement des données avec 3D.
Documentation sur les propriétés
baseColor : color
La couleur de base de la série.
Voir également colorStyle et GraphsTheme.seriesColors.
baseGradient : Gradient
Le gradient de base de la série.
Voir aussi colorStyle.
colorStyle : GraphsTheme.ColorStyle
Le style de couleurs de la série.
Voir aussi GraphsTheme.ColorStyle.
columnLabels : list
Les libellés de colonnes facultatifs pour le tableau. Les indices de ce tableau correspondent aux indices des colonnes dans les lignes. Si la liste est plus courte que la ligne la plus longue, toutes les colonnes ne recevront pas de libellé.
dataArray : BarDataArray
Contient la référence du tableau de données.
dataArrayChanged Un signal est émis lorsque le tableau de données est défini, sauf si l'newDataArray e est identique à la précédente.
Remarque : avant toute opération sur dataArray, une série doit être créée pour le proxy concerné.
dataProxy : BarDataProxy
Le proxy de données actif. La série prend en charge tout proxy qui lui est attribué et supprime tout proxy précédemment défini lorsqu'un nouveau proxy est ajouté. Le proxy ne peut pas être nul ni pointer vers une autre série.
invalidSelectionPosition : point [read-only]
Propriété constante fournissant une position non valide pour la sélection. Cette position est attribuée à la propriété selectedBar afin d'effacer la sélection de cette série.
Voir également GraphsItem3D.clearSelection().
itemLabel : string [read-only]
L'étiquette de l'élément mis en forme. 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 des éléments de données de cette série. Ce format est utilisé pour les étiquettes d'élément unique, par exemple lorsqu'un élément est sélectionné. L'interprétation de ce format dépend du type de série.
Voir également Bar3DSeries, Scatter3DSeries et Surface3DSeries.
itemLabelVisible : bool
Si true, les libellés des éléments sont affichés sous forme de libellés flottants dans le graphique. Dans le cas contraire, ils ne sont pas affichés. Pour afficher le libellé d'un élément dans un contrôle externe, cette propriété doit être définie sur false. La valeur par défaut est true.
Voir également itemLabelFormat et itemLabel.
lightingMode : Abstract3DSeries.LightingMode [since 6.10]
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 également 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 de type Abstract3DSeries.Mesh.UserDefined, la propriété userDefinedMesh doit également être définie pour que les éléments s'affichent correctement. La valeur par défaut dépend du type de graphique.
Voir également QAbstract3DSeries::Mesh.
meshAngle : real
Propriété pratique permettant de définir l'angle de rotation de la série en degrés.
Remarque : lors de la lecture de cette propriété, celle-ci est calculée à partir de la valeur « Abstract3DSeries.meshRotation » en utilisant la précision en virgule flottante et renvoie toujours une valeur comprise entre 0 et 360 degrés.
Voir également Abstract3DSeries.meshRotation.
meshRotation : quaternion
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 prenant en charge une rotation spécifique à chaque élément, les rotations sont multipliées entre elles. Bar3DSeries ignore toute rotation qui ne s’effectue pas autour de l’axe y. Surface3DSeries applique la rotation uniquement au pointeur de sélection. Par défaut, aucune rotation n’est appliquée.
meshSmooth : bool
Si la valeur est « true », les versions lissées des maillages prédéfinis, définies via la propriété « mesh », sont utilisées. Cette propriété n'affecte pas les maillages personnalisés utilisés lorsque la propriété « mesh » est définie sur « Abstract3DSeries.Mesh.UserDefined ». La valeur par défaut est « false ».
multiHighlightColor : color
Couleur de mise en évidence des éléments multiples de la série.
Voir également colorStyle et GraphsTheme.multiHighlightColor.
multiHighlightGradient : Gradient
Le dégradé de mise en évidence de plusieurs éléments 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'élément avec la balise @seriesName.
Voir également itemLabelFormat.
rowColors : list<Color>
Cette propriété permet de dessiner les lignes de la série dans différentes couleurs. Pour utiliser cette propriété, la propriété « GraphsTheme.colorStyle » doit être définie sur « Uniform ».
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
Étiquettes de ligne facultatives pour le tableau. Les indices de ce tableau correspondent aux indices de ligne du tableau de données. Si la liste contient moins d’éléments que le nombre de lignes, toutes les lignes ne recevront pas d’étiquette.
selectedBar : point
La barre sélectionnée dans la série.
La position de la barre sélectionnée est spécifiée par une ligne et une colonne dans le tableau de données de la série.
Une seule barre peut être sélectionnée à la fois.
Pour désélectionner cette série, attribuez la valeur invalidSelectionPosition à la position.
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 celle-ci devient invalide. La sélection d'une barre dans 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
La couleur de mise en évidence d'un élément unique de la série.
Voir également colorStyle et GraphsTheme.singleHighlightColor.
singleHighlightGradient : Gradient
L'élément unique qui met en valeur le dégradé de la série.
Voir également colorStyle et GraphsTheme.singleHighlightGradient.
type : Abstract3DSeries.SeriesType [read-only]
Le type de la série. L'une des valeurs de l'QAbstract3DSeries::SeriesType.
userDefinedMesh : string
Le nom de fichier d'un maillage personnalisé défini par l'utilisateur pour les objets, utilisé lorsque l'option « mesh » est activée, 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 affichée.
Documentation de Signal
baseColorChanged(color color)
Ce signal est émis lorsque baseColor devient color.
Remarque : le gestionnaire correspondant est onBaseColorChanged.
baseGradientChanged(Gradient gradient)
Ce signal est émis lorsque baseGradient devient gradient.
Remarque : le gestionnaire correspondant est onBaseGradientChanged.
colorStyleChanged(GraphsTheme.ColorStyle style)
Ce signal est émis lorsque colorStyle devient style.
Remarque : le gestionnaire correspondant est onColorStyleChanged.
columnLabelsChanged()
Ce signal est émis lorsque les libellés des colonnes changent.
Remarque : le gestionnaire correspondant est onColumnLabelsChanged.
dataArrayChanged(BarDataArray array)
Ce signal est émis lorsque dataArray devient array.
Remarque : le gestionnaire correspondant est onDataArrayChanged.
dataProxyChanged(BarDataProxy proxy)
Ce signal est émis lorsque dataProxy devient proxy.
Remarque : le gestionnaire correspondant est onDataProxyChanged.
itemLabelChanged(string label)
Ce signal est émis lorsque itemLabel devient label.
Remarque : le gestionnaire correspondant est onItemLabelChanged.
itemLabelFormatChanged(string format)
Ce signal est émis lorsque itemLabelFormat devient format.
Remarque : le gestionnaire correspondant est onItemLabelFormatChanged.
itemLabelVisibilityChanged(bool visible)
Ce signal est émis lorsque la propriété `itemLabelVisibility` passe à la valeur ` visible`.
Remarque : le gestionnaire correspondant est « onItemLabelVisibilityChanged ».
[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
Ce signal est émis lorsque lightingMode devient lightingMode.
Remarque : 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.
Remarque : le gestionnaire correspondant est onMeshAngleChanged.
meshChanged(Abstract3DSeries.Mesh mesh)
Ce signal est émis lorsque mesh devient mesh.
Remarque : le gestionnaire correspondant est onMeshChanged.
meshRotationChanged(quaternion rotation)
Ce signal est émis lorsque meshRotation devient rotation.
Remarque : le gestionnaire correspondant est onMeshRotationChanged.
meshSmoothChanged(bool enabled)
Ce signal est émis lorsque meshSmooth devient enabled.
Remarque : le gestionnaire correspondant est onMeshSmoothChanged.
multiHighlightColorChanged(color color)
Ce signal est émis lorsque multiHighlightColor devient color.
Remarque : le gestionnaire correspondant est onMultiHighlightColorChanged.
multiHighlightGradientChanged(Gradient gradient)
Ce signal est émis lorsque multiHighlightGradient devient gradient.
Remarque : le gestionnaire correspondant est onMultiHighlightGradientChanged.
nameChanged(string name)
Ce signal est émis lorsque name devient name.
Remarque : le gestionnaire correspondant est onNameChanged.
rowColorsChanged(list<color> rowcolors)
Ce signal est émis lorsque rowColors devient rowcolors.
Remarque : le gestionnaire correspondant est onRowColorsChanged.
rowLabelsChanged()
Ce signal est émis lorsque les libellés des lignes changent.
Remarque : le gestionnaire correspondant est onRowLabelsChanged.
selectedBarChanged(point position)
Ce signal est émis lorsque selectedBar devient position.
Remarque : le gestionnaire correspondant est onSelectedBarChanged.
singleHighlightColorChanged(color color)
Ce signal est émis lorsque singleHighlightColor devient color.
Remarque : le gestionnaire correspondant est onSingleHighlightColorChanged.
singleHighlightGradientChanged(Gradient gradient)
Ce signal est émis lorsque singleHighlightGradient devient gradient.
Remarque : le gestionnaire correspondant est onSingleHighlightGradientChanged.
userDefinedMeshChanged(string fileName)
Ce signal est émis lorsque userDefinedMesh devient fileName.
Remarque : le gestionnaire correspondant est onUserDefinedMeshChanged.
visibilityChanged(bool visible)
Ce signal est émis lorsque la visibilité de la série passe à « visible ».
Remarque : le gestionnaire correspondant est onVisibilityChanged.
Documentation de la méthode
void setMeshAxisAndAngle(vector3d axis, real angle)
Une fonction pratique permettant de construire un quaternion de rotation de maillage à partir de axis et angle.
Voir également 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.
