QTableWidgetItem Class
La classe `QTableWidgetItem` fournit un élément destiné à être utilisé avec la classe ` QTableWidget `. En savoir plus...
| En-tête : | #include <QTableWidgetItem> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
Types publics
| enum | ItemType { Type, UserType } |
Fonctions publiques
| QTableWidgetItem(int type = Type) | |
| QTableWidgetItem(const QString &text, int type = Type) | |
| QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type) | |
| QTableWidgetItem(const QTableWidgetItem &other) | |
| virtual | ~QTableWidgetItem() |
| QBrush | background() const |
| Qt::CheckState | checkState() const |
| virtual QTableWidgetItem * | clone() const |
| int | column() const |
| virtual QVariant | data(int role) const |
| Qt::ItemFlags | flags() const |
| QFont | font() const |
| QBrush | foreground() const |
| QIcon | icon() const |
| bool | isSelected() const |
| virtual void | read(QDataStream &in) |
| int | row() const |
| void | setBackground(const QBrush &brush) |
| void | setCheckState(Qt::CheckState state) |
| virtual void | setData(int role, const QVariant &value) |
| void | setFlags(Qt::ItemFlags flags) |
| void | setFont(const QFont &font) |
| void | setForeground(const QBrush &brush) |
| void | setIcon(const QIcon &icon) |
| void | setSelected(bool select) |
| void | setSizeHint(const QSize &size) |
| void | setStatusTip(const QString &statusTip) |
| void | setText(const QString &text) |
(since 6.4) void | setTextAlignment(Qt::Alignment alignment) |
| void | setToolTip(const QString &toolTip) |
| void | setWhatsThis(const QString &whatsThis) |
| QSize | sizeHint() const |
| QString | statusTip() const |
| QTableWidget * | tableWidget() const |
| QString | text() const |
| int | textAlignment() const |
| QString | toolTip() const |
| int | type() const |
| QString | whatsThis() const |
| virtual void | write(QDataStream &out) const |
| virtual bool | operator<(const QTableWidgetItem &other) const |
| QTableWidgetItem & | operator=(const QTableWidgetItem &other) |
Éléments non-membres associés
| QDataStream & | operator<<(QDataStream &out, const QTableWidgetItem &item) |
| QDataStream & | operator>>(QDataStream &in, QTableWidgetItem &item) |
Description détaillée
Les éléments de tableau servent à contenir des informations destinées aux widgets de tableau. Ils contiennent généralement du texte, des icônes ou des cases à cocher
La classe `QTableWidgetItem` est une classe de commodité qui remplace la classe ` QTableItem ` dans Qt 3. Elle fournit un élément destiné à être utilisé avec la classe ` QTableWidget `.
Les éléments de niveau supérieur sont créés sans parent, puis insérés à la position spécifiée par une paire de numéros de ligne et de colonne :
QTableWidgetItem *newItem = new QTableWidgetItem(tr("%1").arg(
pow(row, column+1)));
tableWidget->setItem(row, column, newItem);Chaque élément peut disposer de son propre pinceau d’arrière-plan, défini à l’aide de la fonction ` setBackground()`. Le pinceau d’arrière-plan actuel peut être récupéré via ` background()`. Le libellé de chaque élément peut être affiché avec sa propre police et son propre pinceau. Ceux-ci sont spécifiés à l’aide des fonctions ` setFont()` et ` setForeground()`, et récupérés via ` font()` et ` foreground()`.
Par défaut, les éléments sont activés, modifiables, sélectionnables, cochables et peuvent servir à la fois de source et de destination pour une opération de glisser-déposer. Les indicateurs de chaque élément peuvent être modifiés en appelant la fonction ` setFlags()` avec la valeur appropriée (voir ` Qt::ItemFlags`). Les éléments cochables peuvent être cochés ou décochés à l’aide de la fonction setCheckState(). La fonction correspondante checkState() indique si l’élément est actuellement coché.
Sous-classement
Lors de la création d'une sous-classe de `QTableWidgetItem` pour fournir des éléments personnalisés, il est possible de définir de nouveaux types pour ceux-ci afin de les distinguer des éléments standard. Les constructeurs des sous-classes qui nécessitent cette fonctionnalité doivent appeler le constructeur de la classe de base avec une valeur de type « new type » égale ou supérieure à ` UserType`.
Voir également QTableWidget, Programmation modèle-vue, QListWidgetItem et QTreeWidgetItem.
Documentation sur les types membres
enum QTableWidgetItem::ItemType
Cette énumération décrit les types utilisés pour définir les éléments du widget de tableau.
| Constante | Valeur | Description |
|---|---|---|
QTableWidgetItem::Type | 0 | Type par défaut des éléments du widget de tableau. |
QTableWidgetItem::UserType | 1000 | Valeur minimale pour les types personnalisés. Les valeurs inférieures à UserType sont réservées par Qt. |
Vous pouvez définir de nouveaux types utilisateur dans les sous-classes de ` QTableWidgetItem ` afin de garantir que les éléments personnalisés soient traités de manière spécifique.
Voir également type().
Documentation des fonctions membres
[explicit] QTableWidgetItem::QTableWidgetItem(int type = Type)
Crée un élément de table de l'type spécifiée qui n'appartient à aucune table.
Voir aussi type().
[explicit] QTableWidgetItem::QTableWidgetItem(const QString &text, int type = Type)
Crée un élément de tableau à partir de l'text on fournie.
Voir aussi type().
[explicit] QTableWidgetItem::QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type)
Crée un élément de tableau avec les paramètres icon et text fournis.
Voir également type().
QTableWidgetItem::QTableWidgetItem(const QTableWidgetItem &other)
Crée une copie de ` other`. Notez que ` type()` et ` tableWidget()` ne sont pas copiés.
Cette fonction est utile lors de la réimplémentation de clone().
Voir également data() et flags().
[virtual noexcept] QTableWidgetItem::~QTableWidgetItem()
Supprime l'élément du tableau.
QBrush QTableWidgetItem::background() const
Renvoie le pinceau utilisé pour dessiner l'arrière-plan de l'élément.
Voir également setBackground() et foreground().
Qt::CheckState QTableWidgetItem::checkState() const
Renvoie l'état de sélection de l'élément du tableau.
Voir également setCheckState() et flags().
[virtual] QTableWidgetItem *QTableWidgetItem::clone() const
Crée une copie de l'élément.
int QTableWidgetItem::column() const
Renvoie la colonne de l'élément dans le tableau. Si l'élément ne figure pas dans un tableau, cette fonction renvoie -1.
Voir également row().
[virtual] QVariant QTableWidgetItem::data(int role) const
Renvoie les données de l'élément correspondant à l'role donné.
Voir aussi setData().
Qt::ItemFlags QTableWidgetItem::flags() const
Renvoie les indicateurs utilisés pour décrire l'élément. Ceux-ci déterminent si l'élément peut être coché, modifié et sélectionné.
Voir également setFlags().
QFont QTableWidgetItem::font() const
Renvoie la police utilisée pour afficher le texte de l'élément.
Voir aussi setFont().
QBrush QTableWidgetItem::foreground() const
Renvoie le pinceau utilisé pour afficher le premier plan de l'élément (par exemple, du texte).
Voir également setForeground() et background().
QIcon QTableWidgetItem::icon() const
Renvoie l'icône de l'élément.
Voir également setIcon() et iconSize.
bool QTableWidgetItem::isSelected() const
Renvoie « true » si l'élément est sélectionné, sinon renvoie « false ».
Voir aussi setSelected().
[virtual] void QTableWidgetItem::read(QDataStream &in)
Lit l'élément à partir du flux in.
Voir également write().
int QTableWidgetItem::row() const
Renvoie le numéro de ligne de l'élément dans le tableau. Si l'élément ne figure pas dans un tableau, cette fonction renvoie -1.
Voir également column().
void QTableWidgetItem::setBackground(const QBrush &brush)
Définit le pinceau d'arrière-plan de l'élément sur l'brush spécifié. La définition d'un pinceau créé par défaut permettra à la vue d'utiliser la couleur par défaut du style.
Voir également ` background()` et ` setForeground()`.
void QTableWidgetItem::setCheckState(Qt::CheckState state)
Définit l'état de sélection de l'élément du tableau sur « state ».
Voir aussi checkState().
[virtual] void QTableWidgetItem::setData(int role, const QVariant &value)
Définit les données de l'élément correspondant à l'role fournie sur la valeur spécifiée value.
Remarque : L'implémentation par défaut considère que Qt::EditRole et Qt::DisplayRole font référence aux mêmes données.
Voir également Qt::ItemDataRole et data().
void QTableWidgetItem::setFlags(Qt::ItemFlags flags)
Définit les indicateurs de l'élément selon les valeurs fournies dans ` flags`. Ceux-ci déterminent si l'élément peut être sélectionné ou modifié.
Voir également flags().
void QTableWidgetItem::setFont(const QFont &font)
Définit la police utilisée pour afficher le texte de l'élément sur la police spécifiée font.
Voir également font(), setText() et setForeground().
void QTableWidgetItem::setForeground(const QBrush &brush)
Définit le pinceau de premier plan de l'élément sur l'brush spécifié. La définition d'un pinceau construit par défaut permettra à la vue d'utiliser la couleur par défaut du style.
Voir également foreground() et setBackground().
void QTableWidgetItem::setIcon(const QIcon &icon)
Définit l'icône de l'élément sur l'icon spécifiée.
Voir également icon(), setText() et iconSize.
void QTableWidgetItem::setSelected(bool select)
Définit l'état sélectionné de l'élément sur « select ».
Voir également isSelected().
void QTableWidgetItem::setSizeHint(const QSize &size)
Définit l'indication de taille de l'élément de tableau sur size. Si aucune indication de taille n'est définie ou si size n'est pas valide, le délégué de l'élément calculera l'indication de taille en fonction des données de l'élément.
Voir également sizeHint().
void QTableWidgetItem::setStatusTip(const QString &statusTip)
Définit l'info-bulle de l'élément du tableau sur le texte spécifié par statusTip. QTableWidget Le suivi de la souris doit être activé pour que cette fonctionnalité fonctionne.
Voir également statusTip(), setToolTip() et setWhatsThis().
void QTableWidgetItem::setText(const QString &text)
Définit le texte de l'élément sur la valeur spécifiée dans text.
Voir également text(), setFont() et setForeground().
[since 6.4] void QTableWidgetItem::setTextAlignment(Qt::Alignment alignment)
Définit l'alignement du texte de l'élément selon l'alignment e spécifiée.
Cette fonction a été introduite dans Qt 6.4.
Voir aussi textAlignment().
void QTableWidgetItem::setToolTip(const QString &toolTip)
Définit l'info-bulle de l'élément sur la chaîne spécifiée par toolTip.
Voir également toolTip(), setStatusTip() et setWhatsThis().
void QTableWidgetItem::setWhatsThis(const QString &whatsThis)
Définit l'aide « Qu'est-ce que c'est ? » de l'élément sur la chaîne spécifiée par whatsThis.
Voir également whatsThis(), setStatusTip() et setToolTip().
QSize QTableWidgetItem::sizeHint() const
Renvoie la valeur de taille définie pour l'élément de tableau.
Voir aussi : `setSizeHint()`
QString QTableWidgetItem::statusTip() const
Renvoie l'info-bulle relative au statut de l'élément.
Voir aussi setStatusTip().
QTableWidget *QTableWidgetItem::tableWidget() const
Renvoie le widget de tableau contenant l'élément.
QString QTableWidgetItem::text() const
Renvoie le texte de l'élément.
Voir aussi setText().
int QTableWidgetItem::textAlignment() const
Renvoie l'alignement du texte de l'élément.
Remarque : pour des raisons historiques,cette fonction renvoie un entier (int). Cela sera corrigé dans Qt 7 pour qu'elle renvoie Qt::Alignment.
Voir également ` setTextAlignment()` et ` Qt::Alignment`.
QString QTableWidgetItem::toolTip() const
Renvoie l'infobulle de l'élément.
Voir aussi setToolTip().
int QTableWidgetItem::type() const
Renvoie le type passé au constructeur ` QTableWidgetItem `.
QString QTableWidgetItem::whatsThis() const
Renvoie l'aide « Qu'est-ce que c'est ? » de l'élément.
Voir aussi setWhatsThis().
[virtual] void QTableWidgetItem::write(QDataStream &out) const
Écrit l'élément dans le flux out.
Voir également read().
[virtual] bool QTableWidgetItem::operator<(const QTableWidgetItem &other) const
Renvoie « true » si l’élément est inférieur à l’élément « other » ; sinon, renvoie « false ».
QTableWidgetItem &QTableWidgetItem::operator=(const QTableWidgetItem &other)
Attribue les données et les indicateurs de ` other` à cet élément. Notez que ` type()` et ` tableWidget()` ne sont pas copiés.
Cette fonction est utile lors de la réimplémentation de ` clone()`.
Éléments non membres associés
QDataStream &operator<<(QDataStream &out, const QTableWidgetItem &item)
Écrit les données de l'élément du widget de tableau item vers le flux out.
Cet opérateur utilise la fonction QTableWidgetItem::write().
Voir également Sérialisation des types de données Qt.
QDataStream &operator>>(QDataStream &in, QTableWidgetItem &item)
Lit un élément du widget « table » à partir du flux in et le stocke dans item.
Cet opérateur utilise la fonction QTableWidgetItem::read().
Voir également Sérialisation des types de données Qt.
© 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.