Sur cette page

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

ConstanteValeurDescription
QTableWidgetItem::Type0Type par défaut des éléments du widget de tableau.
QTableWidgetItem::UserType1000Valeur 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()`.

Voir également data() et flags().

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