Sur cette page

QBarModelMapper Class

La classe `QBarModelMapper` est un mappeur de modèles destiné aux séries de barres. En savoir plus...

En-tête : #include <QBarModelMapper>
CMake : find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake : QT += graphs
En QML : BarModelMapper
Hérite de : QObject

Propriétés

Fonctions publiques

qsizetype count() const
qsizetype first() const
qsizetype firstBarSetSection() const
qsizetype lastBarSetSection() const
QAbstractItemModel *model() const
Qt::Orientation orientation() const
QBarSeries *series() const
void setCount(qsizetype newCount)
void setFirst(qsizetype newFirst)
void setFirstBarSetSection(qsizetype newFirstBarSetSection)
void setLastBarSetSection(qsizetype newLastBarSetSection)
void setModel(QAbstractItemModel *model)
void setOrientation(Qt::Orientation orientation)
void setSeries(QBarSeries *series)

Signaux

Description détaillée

Les mappeurs de modèles permettent d'utiliser un modèle de données dérivé de la classe ` QAbstractItemModel ` comme source de données pour un graphique. Un mappeur de modèle sert à établir une connexion entre un modèle de données et ` QBarSeries`.

Les propriétés du modèle et des séries de barres peuvent toutes deux être utilisées pour manipuler les données. Le mappeur de modèle assure la synchronisation entre les séries de barres et le modèle de données.

Le mappeur de modèle garantit que tous les ensembles de barres de la série de barres ont la même taille. Par conséquent, l'ajout ou la suppression d'une valeur dans un ensemble de barres entraîne la même modification dans tous les ensembles de barres de la série.

Documentation sur les propriétés

count : qsizetype

Cette propriété indique le nombre de lignes ou de colonnes du modèle qui sont mappées en tant que données pour la série de barres.

La valeur par défaut est -1, qui correspond également à la valeur minimale. Ce nombre est limité par le nombre de lignes/colonnes du modèle.

Fonctions d'accès :

qsizetype count() const
void setCount(qsizetype newCount)

Signal de notification :

void countChanged()

Voir également QBarModelMapper::orientation.

first : qsizetype

Cette propriété indique la ligne ou la colonne du modèle qui contient les premières valeurs des ensembles de barres de la série de barres.

La valeur minimale et par défaut est 0.

Fonctions d'accès :

qsizetype first() const
void setFirst(qsizetype newFirst)

Signal de notification :

void firstChanged()

Voir également QBarModelMapper::orientation.

firstBarSetSection : qsizetype

Cette propriété contient la section du modèle qui sert de source de données pour le premier ensemble de barres.

La valeur par défaut est -1 (mappage non valide).

Fonctions d'accès :

qsizetype firstBarSetSection() const
void setFirstBarSetSection(qsizetype newFirstBarSetSection)

Signal de notification :

void firstBarSetSectionChanged()

Voir également QBarModelMapper::orientation.

lastBarSetSection : qsizetype

Cette propriété contient la section du modèle qui sert de source de données pour le dernier ensemble de barres.

La valeur par défaut est -1 (mappage non valide).

Fonctions d'accès :

qsizetype lastBarSetSection() const
void setLastBarSetSection(qsizetype newLastBarSetSection)

Signal de notification :

void lastBarSetSectionChanged()

Voir également QBarModelMapper::orientation.

model : QAbstractItemModel*

Cette propriété contient le modèle de données utilisé par le mappeur.

Fonctions d'accès :

QAbstractItemModel *model() const
void setModel(QAbstractItemModel *model)

Signal de notification :

void modelChanged()

orientation : Qt::Orientation

Indique au ModelMapper comment mapper les données d'un modèle. Si l'option « Qt::Vertical » est utilisée, chaque colonne du modèle définit un ensemble de barres, et les lignes du modèle définissent les catégories. Lorsque l'orientation est définie sur « Qt::Horizontal », chaque ligne du modèle définit un ensemble de barres, et les colonnes du modèle définissent les catégories.

La valeur par défaut est Qt::Vertical

Fonctions d’accès :

Qt::Orientation orientation() const
void setOrientation(Qt::Orientation orientation)

Signal de notification :

void orientationChanged()

series : QBarSeries*

Cette propriété contient la série de barres utilisée par le mappeur.

Toutes les données de la série sont supprimées lorsqu'elle est attribuée au mappeur. Lorsqu'une nouvelle série est spécifiée, l'ancienne série est déconnectée, mais ses données sont conservées.

Fonctions d'accès :

QBarSeries *series() const
void setSeries(QBarSeries *series)

Signal de notification :

void seriesChanged()

© 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.