ListView_MapIndexToID macro (commctrl.h)

Article
08/22/2023

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

Syntaxe

void ListView_MapIndexToID(
   hwnd,
   index
);

Paramètres

hwnd

Type : HWND

Handle pour le contrôle d’affichage de liste.

index

Type : UINT

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

Valeur de retour

None

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 étiqueter 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 d’affichage de liste.

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.

Note Dans un environnement multithread, vous pouvez uniquement ê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.

Configuration requise


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

Partager via