Sur cette page

QTreeWidgetItem Class

La classe QTreeWidgetItem fournit un élément à utiliser avec la classe de commodité QTreeWidget. Plus d'informations...

En-tête : #include <QTreeWidgetItem>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets

Types publics

enum ChildIndicatorPolicy { ShowIndicator, DontShowIndicator, DontShowIndicatorWhenChildless }
enum ItemType { Type, UserType }

Fonctions publiques

QTreeWidgetItem(int type = Type)
QTreeWidgetItem(QTreeWidget *parent, int type = Type)
QTreeWidgetItem(QTreeWidgetItem *parent, int type = Type)
QTreeWidgetItem(const QStringList &strings, int type = Type)
QTreeWidgetItem(QTreeWidget *parent, QTreeWidgetItem *preceding, int type = Type)
QTreeWidgetItem(QTreeWidget *parent, const QStringList &strings, int type = Type)
QTreeWidgetItem(QTreeWidgetItem *parent, QTreeWidgetItem *preceding, int type = Type)
QTreeWidgetItem(QTreeWidgetItem *parent, const QStringList &strings, int type = Type)
QTreeWidgetItem(const QTreeWidgetItem &other)
virtual ~QTreeWidgetItem()
void addChild(QTreeWidgetItem *child)
void addChildren(const QList<QTreeWidgetItem *> &children)
QBrush background(int column) const
Qt::CheckState checkState(int column) const
QTreeWidgetItem *child(int index) const
int childCount() const
QTreeWidgetItem::ChildIndicatorPolicy childIndicatorPolicy() const
virtual QTreeWidgetItem *clone() const
int columnCount() const
virtual QVariant data(int column, int role) const
Qt::ItemFlags flags() const
QFont font(int column) const
QBrush foreground(int column) const
QIcon icon(int column) const
int indexOfChild(QTreeWidgetItem *child) const
void insertChild(int index, QTreeWidgetItem *child)
void insertChildren(int index, const QList<QTreeWidgetItem *> &children)
bool isDisabled() const
bool isExpanded() const
bool isFirstColumnSpanned() const
bool isHidden() const
bool isSelected() const
QTreeWidgetItem *parent() const
virtual void read(QDataStream &in)
void removeChild(QTreeWidgetItem *child)
void setBackground(int column, const QBrush &brush)
void setCheckState(int column, Qt::CheckState state)
void setChildIndicatorPolicy(QTreeWidgetItem::ChildIndicatorPolicy policy)
virtual void setData(int column, int role, const QVariant &value)
void setDisabled(bool disabled)
void setExpanded(bool expand)
void setFirstColumnSpanned(bool span)
void setFlags(Qt::ItemFlags flags)
void setFont(int column, const QFont &font)
void setForeground(int column, const QBrush &brush)
void setHidden(bool hide)
void setIcon(int column, const QIcon &icon)
void setSelected(bool select)
void setSizeHint(int column, const QSize &size)
void setStatusTip(int column, const QString &statusTip)
void setText(int column, const QString &text)
(since 6.4) void setTextAlignment(int column, Qt::Alignment alignment)
void setToolTip(int column, const QString &toolTip)
void setWhatsThis(int column, const QString &whatsThis)
QSize sizeHint(int column) const
void sortChildren(int column, Qt::SortOrder order)
QString statusTip(int column) const
QTreeWidgetItem *takeChild(int index)
QList<QTreeWidgetItem *> takeChildren()
QString text(int column) const
int textAlignment(int column) const
QString toolTip(int column) const
QTreeWidget *treeWidget() const
int type() const
QString whatsThis(int column) const
virtual void write(QDataStream &out) const
virtual bool operator<(const QTreeWidgetItem &other) const
QTreeWidgetItem &operator=(const QTreeWidgetItem &other)

Fonctions protégées

QDataStream &operator<<(QDataStream &out, const QTreeWidgetItem &item)
QDataStream &operator>>(QDataStream &in, QTreeWidgetItem &item)

Description détaillée

Les éléments de widget d'arbre sont utilisés pour contenir des lignes d'informations pour les widgets d'arbre. Les lignes contiennent généralement plusieurs colonnes de données, chacune pouvant contenir une étiquette de texte et une icône.

La classe QTreeWidgetItem est une classe de commodité qui remplace la classe QListViewItem dans Qt 3. Elle fournit un élément à utiliser avec la classe QTreeWidget.

Les éléments sont généralement construits avec un parent qui est soit QTreeWidget (pour les éléments de niveau supérieur), soit un QTreeWidgetItem (pour les éléments situés à des niveaux inférieurs de l'arbre). Par exemple, le code suivant construit un élément de premier niveau pour représenter les villes du monde et ajoute une entrée pour Oslo en tant qu'élément enfant :

QTreeWidgetItem *cities = new QTreeWidgetItem(treeWidget);
cities->setText(0, tr("Cities"));
QTreeWidgetItem *osloItem = new QTreeWidgetItem(cities);
osloItem->setText(0, tr("Oslo"));
osloItem->setText(1, tr("Yes"));

Les éléments peuvent être ajoutés dans un ordre particulier en spécifiant l'élément qu'ils suivent lorsqu'ils sont construits :

QTreeWidgetItem *planets = new QTreeWidgetItem(treeWidget, cities);
planets->setText(0, tr("Planets"));

Chaque colonne d'un élément peut avoir sa propre brosse d'arrière-plan, qui est définie à l'aide de la fonction setBackground(). La fonction background() permet de connaître la brosse d'arrière-plan actuelle. Le texte de l'étiquette de chaque colonne peut être rendu avec sa propre police et sa propre brosse. Celles-ci sont spécifiées avec les fonctions setFont() et setForeground(), et lues avec font() et foreground().

La principale différence entre les éléments de premier niveau et ceux des niveaux inférieurs de l'arbre est qu'un élément de premier niveau n'a pas de parent(). Cette information peut être utilisée pour faire la différence entre les éléments et est utile à connaître lors de l'insertion et de la suppression d'éléments dans l'arbre. Les enfants d'un élément peuvent être supprimés à l'aide de la fonction takeChild() et insérés à un indice donné dans la liste des enfants à l'aide de la fonction insertChild().

Par défaut, les éléments sont activés, sélectionnables, vérifiables et peuvent être la source d'une opération de glisser-déposer. Les drapeaux de chaque élément peuvent être modifiés en appelant la fonction setFlags() avec la valeur appropriée (voir Qt::ItemFlags). Les éléments vérifiables peuvent être vérifié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 QTreeWidgetItem 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 QTreeWidget, QTreeWidgetItemIterator, Model/View Programming, QListWidgetItem, et QTableWidgetItem.

Documentation sur les types de membres

enum QTreeWidgetItem::ChildIndicatorPolicy

ConstanteValeurDescription
QTreeWidgetItem::ShowIndicator0Les commandes d'agrandissement et de réduction seront affichées pour cet élément même s'il n'y a pas d'enfants.
QTreeWidgetItem::DontShowIndicator1Les commandes de développement et de réduction ne seront jamais affichées, même s'il y a des enfants. Si le nœud est ouvert de force, l'utilisateur ne pourra pas développer ou réduire l'élément.
QTreeWidgetItem::DontShowIndicatorWhenChildless2Les commandes de développement et de réduction seront affichées si l'élément contient des enfants.

enum QTreeWidgetItem::ItemType

Cette énumération décrit les types utilisés pour décrire les éléments du widget de l'arbre.

ConstanteValeurDescription
QTreeWidgetItem::Type0Type par défaut pour les éléments du widget de l'arbre.
QTreeWidgetItem::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 QTreeWidgetItem pour garantir un traitement spécial des éléments personnalisés, par exemple lorsque les éléments sont triés.

Voir aussi type().

Documentation des fonctions membres

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

Construit un élément de widget d'arbre du type spécifié type. L'élément doit être inséré dans un widget d'arbre.

Voir aussi type().

[explicit] QTreeWidgetItem::QTreeWidgetItem(QTreeWidget *parent, int type = Type)

Construit un élément de widget d'arbre de l'adresse type spécifiée et l'ajoute aux éléments de l'adresse parent donnée.

Voir aussi type().

[explicit] QTreeWidgetItem::QTreeWidgetItem(QTreeWidgetItem *parent, int type = Type)

Construit un élément de widget d'arbre et l'ajoute à l'adresse parent.

Voir aussi type().

[explicit] QTreeWidgetItem::QTreeWidgetItem(const QStringList &strings, int type = Type)

Construit un élément de widget d'arbre du type spécifié type. L'élément doit être inséré dans un widget d'arbre. La liste donnée de strings sera définie comme texte de l'élément pour chaque colonne de l'élément.

Voir aussi type().

QTreeWidgetItem::QTreeWidgetItem(QTreeWidget *parent, QTreeWidgetItem *preceding, int type = Type)

Construit un élément de widget d'arbre de l'adresse type spécifiée et l'insère dans l'adresse parent donnée après l'article preceding.

Voir aussi type().

QTreeWidgetItem::QTreeWidgetItem(QTreeWidget *parent, const QStringList &strings, int type = Type)

Construit un élément de widget d'arbre de l'adresse type spécifiée et l'ajoute aux éléments de l'adresse parent donnée. La liste donnée de strings sera définie comme texte de l'élément pour chaque colonne de l'élément.

Voir aussi type().

QTreeWidgetItem::QTreeWidgetItem(QTreeWidgetItem *parent, QTreeWidgetItem *preceding, int type = Type)

Construit un élément de widget d'arbre de l'adresse type spécifiée qui est inséré dans l'adresse parent après l'élément enfant preceding.

Voir aussi type().

QTreeWidgetItem::QTreeWidgetItem(QTreeWidgetItem *parent, const QStringList &strings, int type = Type)

Construit un élément de widget d'arbre et l'ajoute à l'adresse parent. La liste donnée de strings sera définie comme texte de l'élément pour chaque colonne de l'élément.

Voir aussi type().

QTreeWidgetItem::QTreeWidgetItem(const QTreeWidgetItem &other)

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

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

Voir aussi data() et flags().

[virtual noexcept] QTreeWidgetItem::~QTreeWidgetItem()

Détruit cet élément de widget d'arbre.

L'élément sera supprimé de QTreeWidgets auquel il a été ajouté. Cela permet de supprimer un élément à tout moment en toute sécurité.

void QTreeWidgetItem::addChild(QTreeWidgetItem *child)

Ajoute l'élément child à la liste des enfants.

Voir aussi insertChild() et takeChild().

void QTreeWidgetItem::addChildren(const QList<QTreeWidgetItem *> &children)

Ajoute la liste donnée de children à l'élément.

Voir aussi insertChildren() et takeChildren().

QBrush QTreeWidgetItem::background(int column) const

Renvoie la brosse utilisée pour rendre l'arrière-plan de la page column spécifiée.

Voir aussi setBackground() et foreground().

Qt::CheckState QTreeWidgetItem::checkState(int column) const

Renvoie l'état de vérification de l'étiquette dans l'adresse column.

Voir aussi setCheckState() et Qt::CheckState.

QTreeWidgetItem *QTreeWidgetItem::child(int index) const

Renvoie l'élément situé à l'adresse index dans la liste des enfants de l'élément.

Voir aussi parent().

int QTreeWidgetItem::childCount() const

Renvoie le nombre d'éléments enfants.

QTreeWidgetItem::ChildIndicatorPolicy QTreeWidgetItem::childIndicatorPolicy() const

Renvoie la politique de l'indicateur d'élément. Cette politique détermine quand l'indicateur d'expansion/réduction de la branche de l'arbre est affiché.

Voir également setChildIndicatorPolicy().

[virtual] QTreeWidgetItem *QTreeWidgetItem::clone() const

Crée une copie profonde de l'élément et de ses enfants.

int QTreeWidgetItem::columnCount() const

Renvoie le nombre de colonnes de l'élément.

[virtual] QVariant QTreeWidgetItem::data(int column, int role) const

Renvoie la valeur des éléments column et role.

Voir aussi setData().

[protected] void QTreeWidgetItem::emitDataChanged()

Demande au modèle associé à cet élément d'émettre un signal dataChanged() pour cet élément.

Vous ne devez normalement appeler cette fonction que si vous avez sous-classé QTreeWidgetItem et réimplémenté data() et/ou setData().

Voir également setData().

Qt::ItemFlags QTreeWidgetItem::flags() const

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

La valeur par défaut des indicateurs est Qt::ItemIsSelectable | Qt::ItemIsUserCheckable | Qt::ItemIsEnabled | Qt::ItemIsDragEnabled | Qt::ItemIsDropEnabled.

Voir également setFlags().

QFont QTreeWidgetItem::font(int column) const

Renvoie la police utilisée pour rendre le texte dans l'adresse column.

Voir aussi setFont().

QBrush QTreeWidgetItem::foreground(int column) const

Renvoie la brosse utilisée pour le rendu de l'avant-plan (par exemple, le texte) de la page column spécifiée. La définition d'une brosse construite par défaut permet à la vue d'utiliser la couleur par défaut du style.

Voir également setForeground() et background().

QIcon QTreeWidgetItem::icon(int column) const

Renvoie l'icône qui est affichée dans le site column spécifié.

Voir aussi setIcon() et iconSize.

int QTreeWidgetItem::indexOfChild(QTreeWidgetItem *child) const

Renvoie l'index de l'adresse child dans la liste des enfants de l'élément.

void QTreeWidgetItem::insertChild(int index, QTreeWidgetItem *child)

Insère l'élément child à l'adresse index dans la liste des enfants.

Si l'enfant a déjà été inséré ailleurs, il ne sera pas réinséré.

void QTreeWidgetItem::insertChildren(int index, const QList<QTreeWidgetItem *> &children)

Insère la liste donnée de children dans la liste des enfants de l'élément à index.

Les enfants qui ont déjà été insérés ailleurs ne seront pas insérés.

bool QTreeWidgetItem::isDisabled() const

Renvoie true si l'élément est désactivé ; sinon, renvoie false.

Voir aussi setFlags().

bool QTreeWidgetItem::isExpanded() const

Renvoie true si l'élément est développé, sinon renvoie false.

Voir aussi setExpanded().

bool QTreeWidgetItem::isFirstColumnSpanned() const

Renvoie true si l'élément couvre toutes les colonnes d'une ligne ; sinon, renvoie false.

Voir aussi setFirstColumnSpanned().

bool QTreeWidgetItem::isHidden() const

Renvoie true si l'élément est caché, sinon renvoie false.

Voir aussi setHidden().

bool QTreeWidgetItem::isSelected() const

Renvoie true si l'élément est sélectionné, sinon renvoie false.

Voir aussi setSelected().

QTreeWidgetItem *QTreeWidgetItem::parent() const

Renvoie le parent de l'élément.

Voir également child().

[virtual] void QTreeWidgetItem::read(QDataStream &in)

Lit l'élément dans le flux in. Cette fonction ne lit que les données d'un seul élément.

Voir également write().

void QTreeWidgetItem::removeChild(QTreeWidgetItem *child)

Supprime l'élément indiqué par child. L'élément retiré ne sera pas supprimé.

void QTreeWidgetItem::setBackground(int column, const QBrush &brush)

Définit la brosse d'arrière-plan de l'étiquette de l'adresse column donnée à l'adresse brush spécifiée. Définir une brosse construite par défaut permettra à la vue d'utiliser la couleur par défaut du style.

Note : Si les feuilles de style Qt sont utilisées sur le même widget que setBackground(), les feuilles de style auront la priorité si les paramètres sont en conflit.

Voir aussi background() et setForeground().

void QTreeWidgetItem::setCheckState(int column, Qt::CheckState state)

Définit l'élément dans l'état de vérification column donné comme étant state.

Voir aussi checkState().

void QTreeWidgetItem::setChildIndicatorPolicy(QTreeWidgetItem::ChildIndicatorPolicy policy)

Définit l'indicateur d'élément policy. Cette stratégie détermine quand l'indicateur d'expansion/réduction de la branche de l'arbre est affiché. La valeur par défaut est DontShowIndicatorWhenChildless.

Voir aussi childIndicatorPolicy().

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

Fixe la valeur des éléments column et role à la valeur donnée value.

role décrit le type de données spécifié par value et est défini par l'enum Qt::ItemDataRole.

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

void QTreeWidgetItem::setDisabled(bool disabled)

Désactive l'élément si disabled est vrai ; sinon, active l'élément.

Voir également isDisabled() et setFlags().

void QTreeWidgetItem::setExpanded(bool expand)

Développe l'élément si expand est vrai, sinon réduit l'élément.

Attention : L'élément QTreeWidgetItem doit être ajouté à l'élément QTreeWidget avant d'appeler cette fonction.

Voir aussi isExpanded().

void QTreeWidgetItem::setFirstColumnSpanned(bool span)

Définit la première section pour qu'elle s'étende sur toutes les colonnes si span est vrai ; sinon, toutes les sections des éléments sont affichées.

Voir également isFirstColumnSpanned().

void QTreeWidgetItem::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é. Cette fonction est souvent utilisée pour désactiver un élément.

Voir également flags().

void QTreeWidgetItem::setFont(int column, const QFont &font)

Définit la police utilisée pour afficher le texte dans l'adresse column donnée à l'adresse font donnée.

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

void QTreeWidgetItem::setForeground(int column, const QBrush &brush)

Définit la brosse d'avant-plan de l'étiquette dans l'adresse column donnée à l'adresse brush spécifiée.

Voir aussi foreground() et setBackground().

void QTreeWidgetItem::setHidden(bool hide)

Cache l'élément si hide est vrai, sinon affiche l'élément.

Remarque : l'appel à cette fonction n'a aucun effet si l'élément ne se trouve pas actuellement dans une vue. En particulier, si vous appelez setHidden(true) sur un élément et que vous l'ajoutez ensuite à une vue, vous obtiendrez un élément visible.

Voir également isHidden().

void QTreeWidgetItem::setIcon(int column, const QIcon &icon)

Définit l'icône à afficher dans le site column ou icon.

Voir aussi icon(), setText(), et iconSize.

void QTreeWidgetItem::setSelected(bool select)

Définit l'état sélectionné de l'élément à select.

Voir aussi isSelected().

void QTreeWidgetItem::setSizeHint(int column, const QSize &size)

Définit l'indice de taille pour l'élément de l'arbre dans l'adresse column donnée comme étant 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 aussi sizeHint().

void QTreeWidgetItem::setStatusTip(int column, const QString &statusTip)

Définit l'info-bulle de l'état de column à statusTip. Le suivi de la souris de QTreeWidget doit être activé pour que cette fonction fonctionne.

Voir aussi statusTip(), setToolTip(), et setWhatsThis().

void QTreeWidgetItem::setText(int column, const QString &text)

Définit le texte à afficher dans l'adresse column en fonction de l'adresse text.

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

[since 6.4] void QTreeWidgetItem::setTextAlignment(int column, Qt::Alignment alignment)

Définit l'alignement du texte pour l'étiquette dans l'adresse column donnée à l'adresse alignment spécifiée.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi textAlignment().

void QTreeWidgetItem::setToolTip(int column, const QString &toolTip)

Définit l'infobulle de la page column à toolTip.

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

void QTreeWidgetItem::setWhatsThis(int column, const QString &whatsThis)

Définit l'aide "Qu'est-ce que c'est ?" pour le site column donné à whatsThis.

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

QSize QTreeWidgetItem::sizeHint(int column) const

Renvoie le jeu d'indices de taille pour l'élément de l'arbre dans l'adresse column donnée (voir QSize).

Voir aussi setSizeHint().

void QTreeWidgetItem::sortChildren(int column, Qt::SortOrder order)

Trie les enfants de l'élément à l'aide de l'adresse order, selon les valeurs de l'adresse column.

Remarque : cette fonction ne fait rien si l'élément n'est pas associé à un QTreeWidget.

QString QTreeWidgetItem::statusTip(int column) const

Renvoie l'astuce d'état pour le contenu de l'adresse column.

Voir aussi setStatusTip().

QTreeWidgetItem *QTreeWidgetItem::takeChild(int index)

Supprime l'élément situé à l'adresse index et le renvoie, sinon renvoie 0.

QList<QTreeWidgetItem *> QTreeWidgetItem::takeChildren()

Supprime la liste des enfants et la renvoie, sinon renvoie une liste vide.

QString QTreeWidgetItem::text(int column) const

Renvoie le texte dans l'adresse column spécifiée.

Voir aussi setText().

int QTreeWidgetItem::textAlignment(int column) const

Renvoie l'alignement du texte de l'étiquette dans l'adresse column.

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 QTreeWidgetItem::toolTip(int column) const

Renvoie l'info-bulle pour l'adresse column donnée.

Voir aussi setToolTip().

QTreeWidget *QTreeWidgetItem::treeWidget() const

Renvoie le widget de l'arbre qui contient l'élément.

int QTreeWidgetItem::type() const

Renvoie le type transmis au constructeur de QTreeWidgetItem.

QString QTreeWidgetItem::whatsThis(int column) const

Renvoie l'aide "Qu'est-ce que c'est ?" pour le contenu de l'adresse column.

Voir aussi setWhatsThis().

[virtual] void QTreeWidgetItem::write(QDataStream &out) const

Écrit l'élément dans le flux out. Cela ne permet d'écrire que les données d'un seul élément.

Voir également read().

[virtual] bool QTreeWidgetItem::operator<(const QTreeWidgetItem &other) const

Renvoie true si le texte de l'élément est inférieur au texte de l'élément other, sinon renvoie false.

QTreeWidgetItem &QTreeWidgetItem::operator=(const QTreeWidgetItem &other)

Attribue les données et les drapeaux de other à cet élément. Notez que type() et treeWidget() 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 QTreeWidgetItem &item)

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

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

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

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

Lit un élément de widget d'arbre du flux in dans item.

Cet opérateur utilise QTreeWidgetItem::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.