Partager via


Structure TVINSERTSTRUCTW (commctrl.h)

Contient les informations utilisées pour ajouter un nouvel élément à un contrôle d’arborescence. Cette structure est utilisée avec le message TVM_INSERTITEM . La structure est identique à la structure TV_INSERTSTRUCT , mais elle a été renommée pour suivre les conventions d’affectation de noms actuelles.

Syntaxe

typedef struct tagTVINSERTSTRUCTW {
  HTREEITEM hParent;
  HTREEITEM hInsertAfter;
  union {
    TVITEMEXW itemex;
    TV_ITEMW  item;
  } DUMMYUNIONNAME;
} TVINSERTSTRUCTW, *LPTVINSERTSTRUCTW;

Membres

hParent

Type : HTREEITEM

Gérer l’élément parent. Si ce membre est la valeur TVI_ROOT ou NULL, l’élément est inséré à la racine du contrôle arborescence.

hInsertAfter

Type : HTREEITEM

Gérez l’élément après lequel le nouvel élément doit être inséré, ou l’une des valeurs suivantes :

Valeur Signification
TVI_FIRST
Insère l’élément au début de la liste.
TVI_LAST
Insère l’élément à la fin de la liste.
TVI_ROOT
Ajoutez l’élément en tant qu’élément racine.
TVI_SORT
Insère l’élément dans la liste par ordre alphabétique.

DUMMYUNIONNAME

DUMMYUNIONNAME.itemex

Type : TVITEMEX

Version 4.71. Structure TVITEMEX qui contient des informations sur l’élément à ajouter.

DUMMYUNIONNAME.item

Type : TVITEM

Structure TVITEM qui contient des informations sur l’élément à ajouter.

Remarques

Les syndicats de cette structure ont été mis à jour pour fonctionner avec des compilateurs qui ne prennent pas en charge les unions sans nom. Si votre compilateur ne prend pas en charge les unions sans nom, définissez le jeton NONAMELESSUNION avant d’inclure le fichier d’en-tête commctrl.h.

Important L’utilisation de TVI_LAST pour insérer un élément dans un nœud d’arborescence qui contient déjà un grand nombre d’éléments peut prendre beaucoup de temps, ce qui peut entraîner l’arrêt de la réponse de l’application jusqu’à ce que l’opération d’insertion se termine.
 

Notes

L’en-tête commctrl.h définit TVINSERTSTRUCT en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête commctrl.h