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

void ListView_MapIDToIndex(
   hwnd,
   id
);

Parameter

hwnd

Typ: HWND

Ein Handle für das Listenansicht-Steuerelement.

id

Typ: UINT

Ein UINT , der die eindeutige ID 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 markieren, 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 zurückgegeben wird, z. B. IComponent::GetDisplayInfo, und rufen Sie LVM_MAPINDEXTOID auf. 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 es wird der aktuellste Index zurückgegeben.

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_MapIDToIndex zu verwenden, geben Sie Comctl32.dll Version 6 im Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

Anforderungen

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