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

UINT ListView_MapIndexToID(
   HWND hwnd,
   UINT index
);

Parameter

hwnd

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

index

Typ: UINT-

Ein UINT-, das den Index eines Elements enthält.

Rückgabewert

Typ: UINT-

Gibt eine eindeutige ID zurück.

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 markieren, wenn Sie das Element erstellen. Sie verwenden diese ID, um die Eindeutigkeit während des Vorhandenseins des Listenansicht-Steuerelements 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_MAPINDEXTOIDauf. Der Rückgabewert ist eine eindeutige ID.

Hinweis In einer Multithreadumgebung können Sie nur sicherstellen, dass der richtige Index im Thread zurückgegeben wird, der das Listenansichtssteuerelement hostet, nicht in Hintergrundthreads.

 

Wenn Sie ListView_MapIndexToIDverwenden möchten, geben Sie Comctl32.dll Version 6 im Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h