macro ListView_MapIDToIndex (commctrl.h)

Mappe l’ID d’un élément à un index. Vous pouvez utiliser cette macro ou envoyer explicitement le message LVM_MAPIDTOINDEX.

Syntaxe

UINT ListView_MapIDToIndex(
   HWND hwnd,
   UINT id
);

Paramètres

hwnd

Type : HWND

Handle du contrôle list-view.

id

Type : UINT

Un UINT qui contient l’ID unique d’un élément.

Valeur de retour

Type : UINT

Retourne l’index le plus actuel.

Remarques

Les contrôles d’affichage de liste effectuent le suivi interne des éléments par index. Cela peut présenter des problèmes, car les index peuvent changer pendant l’existence du contrôle.

Vous pouvez utiliser cette macro pour baliser un élément avec un ID lorsque vous créez l’élément. Vous utilisez cet ID pour garantir l’unicité pendant l’existence du contrôle list-view.

Pour identifier un élément de manière unique, prenez l’index qui retourne à partir d’un appel, par exemple IComponent ::GetDisplayInfo, puis appelez LVM_MAPINDEXTOID. La valeur de retour est un ID unique.

Si vous devez connaître l’index d’un élément après avoir créé un ID, appelez LVM_MAPIDTOINDEX avec l’ID unique et retourne l’index le plus actuel.

Remarque Dans un environnement multithread, vous ne pouvez être sûr que l’index correct est retourné sur le thread qui héberge le contrôle d’affichage de liste, et non sur les threads d’arrière-plan.

 

Pour utiliser ListView_MapIDToIndex, spécifiez Comctl32.dll version 6 dans le manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.

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]
plateforme cible	Windows
d’en-tête	commctrl.h