Partager via

TVINSERTSTRUCTA, structure (commctrl.h)

  • Article

Contient des 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 tree-view.

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. TVITEMEX structure qui contient des informations sur l’élément à ajouter.

DUMMYUNIONNAME.item

type : TVITEM

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

Remarques

Les syndicats de cette structure ont été mis à jour pour travailler avec les 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 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 entraîne l’arrêt de réponse de l’application jusqu’à ce que l’opération d’insertion se termine.
 

Note

L’en-tête commctrl.h définit TVINSERTSTRUCT comme 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. Le mélange 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.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
d’en-tête commctrl.h