QModelRoleData Class
La classe QModelRoleData contient un rôle et les données associées à ce rôle. En savoir plus…
| En-tête : | #include <QModelRoleData> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
| Depuis : | Qt 6.0 |
Fonctions publiques
| QModelRoleData(int role) | |
| void | clearData() |
| QVariant & | data() |
| const QVariant & | data() const |
| int | role() const |
| void | setData(T &&value) |
Description détaillée
Les objets QModelRoleData stockent un rôle d’élément (qui est une valeur issue de l’énumération Qt::ItemDataRole, ou un entier arbitraire pour un rôle personnalisé) ainsi que les données associées à ce rôle.
Un objet QModelRoleData est généralement créé par des vues ou des délégués, qui spécifient le rôle pour lequel ils souhaitent récupérer les données. L'objet est ensuite transmis aux modèles (voir QAbstractItemModel::multiData()), qui remplissent les données correspondant au rôle stocké. Enfin, la vue affiche les données récupérées depuis le modèle.
Voir également Programmation modèle/vue et QModelRoleDataSpan.
Documentation des fonctions membres
[explicit noexcept] QModelRoleData::QModelRoleData(int role)
Crée un objet `QModelRoleData` pour l'role` donné.
Voir également Qt::ItemDataRole.
[noexcept] void QModelRoleData::clearData()
Efface les données contenues dans cet objet. Notez que le rôle reste inchangé ; seules les données sont effacées.
Voir également data().
[constexpr noexcept] QVariant &QModelRoleData::data()
Renvoie les données contenues dans cet objet sous la forme d'une référence modifiable.
Voir également setData().
[constexpr noexcept] const QVariant &QModelRoleData::data() const
Renvoie les données contenues dans cet objet.
Voir aussi setData().
[constexpr noexcept] int QModelRoleData::role() const
Renvoie le rôle associé à cet objet.
Voir aussi Qt::ItemDataRole.
[constexpr noexcept(...)] template <typename T> void QModelRoleData::setData(T &&value)
Définit les données contenues dans cet objet à la valeur value. value doit être d'un type de données pouvant être stocké dans un QVariant.
Remarque : cette fonction est de type « noexcept » lorsque ` noexcept(m_data.setValue(std::forward<T>(value))) ` est de type ` true`.
Voir également data(), clearData() et Q_DECLARE_METATYPE.
© 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.