ListView_MapIDToIndex, macro (commctrl.h)

Article
03/01/2024

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

Syntaxe

void ListView_MapIDToIndex(
   hwnd,
   id
);

Paramètres

hwnd

Type : HWND

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

id

Type : UINT

UINT qui contient l’ID unique 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 qui retourne à partir d’un appel, tel que IComponent ::GetDisplayInfo, puis appelez LVM_MAPINDEXTOID. La valeur de retour est un ID unique.

Si vous avez besoin de 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.

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_MapIDToIndex, spécifiez Comctl32.dll version 6 dans le manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.

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]
Plateforme cible	Windows
En-tête	commctrl.h

Partager via