ListView_MapIDToIndex Makro (commctrl.h)

Ordnet die ID eines Elements einem Index zu. Sie können dieses Makro verwenden oder die LVM_MAPIDTOINDEX Nachricht explizit senden.

Syntax

UINT ListView_MapIDToIndex(
   HWND hwnd,
   UINT id
);

Parameter

hwnd

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

id

Typ: UINT-

Eine UINT-, die die eindeutige ID eines Elements enthält.

Rückgabewert

Typ: UINT-

Gibt den aktuellsten Index 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 zurückgegeben wird, z. B. IComponent::GetDisplayInfo, und rufen Sie LVM_MAPINDEXTOIDauf. Der Rückgabewert ist eine eindeutige ID.

Wenn Sie den Index eines Elements nach dem Erstellen einer ID kennen müssen, rufen Sie LVM_MAPIDTOINDEX mit der eindeutigen ID auf und gibt den aktuellsten Index zurück.

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_MapIDToIndexverwenden 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