Sur cette page

QTableWidgetItem Class

La classe QTableWidgetItem fournit un élément à utiliser avec la classe QTableWidget. Plus d'informations...

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 sont utilisés pour contenir des éléments d'information pour les widgets de tableau. Les éléments 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 à utiliser avec la classe QTableWidget.

Les éléments de premier niveau sont construits 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 avoir sa propre brosse d'arrière-plan qui est définie avec la fonction setBackground(). La fonction background() permet de connaître la brosse d'arrière-plan actuelle. Le texte de l'étiquette de chaque élément peut être rendu avec sa propre police et sa propre brosse. Ceux-ci sont spécifiés avec les fonctions setFont() et setForeground(), et lus avec font() et foreground().

Par défaut, les éléments sont activés, modifiables, sélectionnables, vérifiables et peuvent être utilisés à la fois comme source d'une opération de glisser-déposer et comme cible de dépôt. Les drapeaux de chaque élément peuvent être modifiés en appelant setFlags() avec la valeur appropriée (voir Qt::ItemFlags). Les éléments à cocher peuvent être cochés et décochés à l'aide de la fonction setCheckState(). La fonction checkState() correspondante indique si l'élément est actuellement coché.

Sous-classement

Lorsque l'on sous-classe QTableWidgetItem pour fournir des éléments personnalisés, il est possible de définir de nouveaux types afin de les distinguer des éléments standard. Les constructeurs des sous-classes qui requièrent cette fonctionnalité doivent appeler le constructeur de la classe de base avec une valeur de nouveau type égale ou supérieure à UserType.

Voir également QTableWidget, Model/View Programming, QListWidgetItem, et QTreeWidgetItem.

Documentation sur les types de membres

enum QTableWidgetItem::ItemType

Cette énumération décrit les types utilisés pour décrire les éléments des widgets de table.

ConstanteValeurDescription
QTableWidgetItem::Type0Type par défaut des éléments de 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 d'utilisateurs dans les sous-classes de QTableWidgetItem pour garantir un traitement spécial des éléments personnalisés.

Voir également type().

Documentation des fonctions membres

[explicit] QTableWidgetItem::QTableWidgetItem(int type = Type)

Construit un élément de table du type spécifié type qui n'appartient à aucune table.

Voir aussi type().

[explicit] QTableWidgetItem::QTableWidgetItem(const QString &text, int type = Type)

Construit un élément de tableau avec l'adresse text.

Voir aussi type().

[explicit] QTableWidgetItem::QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type)

Construit un élément de tableau avec les données icon et text.

Voir aussi type().

QTableWidgetItem::QTableWidgetItem(const QTableWidgetItem &other)

Construit une copie de other. Notez que type() et tableWidget() ne sont pas copiés.

Cette fonction est utile pour réimplémenter clone().

Voir aussi data() et flags().

[virtual noexcept] QTableWidgetItem::~QTableWidgetItem()

Détruit l'élément du tableau.

QBrush QTableWidgetItem::background() const

Renvoie la brosse utilisée pour rendre l'arrière-plan de l'élément.

Voir aussi setBackground() et foreground().

Qt::CheckState QTableWidgetItem::checkState() const

Renvoie l'état vérifié de l'élément du tableau.

Voir aussi 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 n'est 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 pour l'adresse role.

Voir aussi setData().

Qt::ItemFlags QTableWidgetItem::flags() const

Renvoie les drapeaux utilisés pour décrire l'élément. Ils déterminent si l'élément peut être vérifié, édité et sélectionné.

Voir également setFlags().

QFont QTableWidgetItem::font() const

Renvoie la police utilisée pour rendre le texte de l'élément.

Voir aussi setFont().

QBrush QTableWidgetItem::foreground() const

Renvoie la brosse utilisée pour rendre l'avant-plan de l'élément (par exemple, le texte).

Voir aussi setForeground() et background().

QIcon QTableWidgetItem::icon() const

Renvoie l'icône de l'élément.

Voir aussi 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 dans le flux in.

Voir aussi write().

int QTableWidgetItem::row() const

Renvoie la ligne de l'élément dans le tableau. Si l'élément n'est pas dans un tableau, cette fonction renvoie -1.

Voir également column().

void QTableWidgetItem::setBackground(const QBrush &brush)

Définit la brosse d'arrière-plan de l'élément à la valeur spécifiée brush. La définition d'une brosse construite par défaut permet à 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 vérification de l'élément de tableau à state.

Voir aussi checkState().

[virtual] void QTableWidgetItem::setData(int role, const QVariant &value)

Définit les données de l'élément pour l'adresse role donnée en fonction de l'adresse value spécifiée.

Remarque : l'implémentation par défaut considère que Qt::EditRole et Qt::DisplayRole renvoient aux mêmes données.

Voir aussi Qt::ItemDataRole et data().

void QTableWidgetItem::setFlags(Qt::ItemFlags flags)

Définit les drapeaux de l'élément à l'adresse flags. Ces drapeaux 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 à la police donnée font.

Voir aussi font(), setText() et setForeground().

void QTableWidgetItem::setForeground(const QBrush &brush)

Définit la brosse d'avant-plan de l'élément à la valeur spécifiée brush. La définition d'une brosse construite par défaut permet à 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 à l'adresse 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 à select.

Voir aussi isSelected().

void QTableWidgetItem::setSizeHint(const QSize &size)

Définit l'indice de taille de l'élément de table à size. Si aucun indice de taille n'est défini ou si size n'est pas valide, le délégué de l'élément calculera l'indice de taille en fonction des données de l'élément.

Voir également sizeHint().

void QTableWidgetItem::setStatusTip(const QString &statusTip)

Définit l'astuce d'état pour l'élément de tableau avec 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 à l'adresse text spécifiée.

Voir aussi text(), setFont() et setForeground().

[since 6.4] void QTableWidgetItem::setTextAlignment(Qt::Alignment alignment)

Définit l'alignement du texte de l'élément à l'adresse alignment 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 à la chaîne spécifiée par toolTip.

Voir aussi toolTip(), setStatusTip() et setWhatsThis().

void QTableWidgetItem::setWhatsThis(const QString &whatsThis)

Définit l'aide "Qu'est-ce que c'est ?" de l'élément à la chaîne spécifiée par whatsThis.

Voir aussi whatsThis(), setStatusTip() et setToolTip().

QSize QTableWidgetItem::sizeHint() const

Renvoie le jeu d'indices de taille pour l'élément de tableau.

Voir également setSizeHint().

QString QTableWidgetItem::statusTip() const

Renvoie l'info sur l'état de l'élément.

Voir aussi setStatusTip().

QTableWidget *QTableWidgetItem::tableWidget() const

Renvoie le widget de tableau qui contient 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.

Note : Cette fonction renvoie un int pour des raisons historiques. Elle sera corrigée pour retourner Qt::Alignment dans Qt 7.

Voir aussi 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 transmis au constructeur de QTableWidgetItem.

QString QTableWidgetItem::whatsThis() const

Renvoie l'aide "Qu'est-ce que c'est ?" de l'article.

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 drapeaux 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 aussi data() et flags().

Non-membres apparentés

QDataStream &operator<<(QDataStream &out, const QTableWidgetItem &item)

Écrit l'élément du widget de tableau item dans le flux out.

Cet opérateur utilise QTableWidgetItem::write().

Voir aussi Serializing Qt Data Types (Sérialisation des types de données Qt).

QDataStream &operator>>(QDataStream &in, QTableWidgetItem &item)

Lit un élément de widget de tableau du flux in dans item.

Cet opérateur utilise QTableWidgetItem::read().

Voir aussi Serializing Qt Data Types (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.