ListView_MapIndexToID Makro (commctrl.h)

Ordnet den Index eines Elements einer eindeutigen ID zu. Sie können dieses Makro verwenden oder die LVM_MAPINDEXTOID Nachricht explizit senden.

Syntax

void ListView_MapIndexToID(
   hwnd,
   index
);

Parameter

hwnd

Typ: HWND

Ein Handle für das Listenansichtssteuerelement.

index

Typ: UINT

Ein UINT , der den Index eines Elements enthält.

Rückgabewert

Keine

Bemerkungen

Listenansichtssteuerelemente verfolgen Elemente intern nach Index. Dies kann Probleme verursachen, da sich Indizes während des Vorhandenseins des Steuerelements ändern können.

Sie können dieses Makro verwenden, um ein Element mit einer ID zu kennzeichnen, wenn Sie das Element erstellen. Sie verwenden diese ID, um die Eindeutigkeit während des Vorhandenseins des Listenansichtssteuerelements zu gewährleisten.

Um ein Element eindeutig zu identifizieren, nehmen Sie den Index, der von einem Aufruf wie IComponent::GetDisplayInfo zurückgegeben wird, und rufen Sie LVM_MAPINDEXTOID auf. Der Rückgabewert ist eine eindeutige ID.

Hinweis In einer Multithreadumgebung können Sie nur sicherstellen, dass der richtige Index für den Thread zurückgegeben wird, der das Listenansichtssteuerelement hostet, nicht für Hintergrundthreads.
 
Um ListView_MapIndexToID zu verwenden, geben Sie Comctl32.dll Version 6 im Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile commctrl.h