macro ListView_MapIndexToID (commctrl.h)

Article
10/24/2024

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

Syntaxe

UINT ListView_MapIndexToID(
   HWND hwnd,
   UINT index
);

Paramètres

hwnd

Type : HWND

Handle du contrôle list-view.

index

Type : UINT

Un UINT qui contient l’index d’un élément.

Valeur de retour

Type : UINT

Retourne un ID unique.

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 retourné à partir d’un appel tel que IComponent ::GetDisplayInfo et appelez LVM_MAPINDEXTOID. La valeur de retour est un ID unique.

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_MapIndexToID, 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

Partager via