Structure TVINSERTSTRUCTA (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 tagTVINSERTSTRUCTA {
  HTREEITEM hParent;
  HTREEITEM hInsertAfter;
  union {
    TVITEMEXA itemex;
    TV_ITEMA  item;
  } DUMMYUNIONNAME;
} TVINSERTSTRUCTA, *LPTVINSERTSTRUCTA;

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