macro ListView_MapIDToIndex (commctrl.h)

Esegue il mapping dell'ID di un elemento a un indice. È possibile utilizzare questa macro o inviare il messaggio di LVM_MAPIDTOINDEX in modo esplicito.

Sintassi

UINT ListView_MapIDToIndex(
   HWND hwnd,
   UINT id
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione elenco.

id

Tipo: UINT

Oggetto UINT contenente l'ID univoco di un elemento.

Valore restituito

Tipo: UINT

Restituisce l'indice più recente.

Osservazioni

I controlli visualizzazione elenco tengono traccia internamente degli elementi in base all'indice. Ciò può presentare problemi perché gli indici possono cambiare durante l'esistenza del controllo.

È possibile utilizzare questa macro per contrassegnare un elemento con un ID quando si crea l'elemento. Questo ID viene usato per garantire l'univocità durante l'esistenza del controllo visualizzazione elenco.

Per identificare in modo univoco un elemento, accettare l'indice restituito da una chiamata, ad esempio IComponent::GetDisplayInfoe chiamare LVM_MAPINDEXTOID. Il valore restituito è un ID univoco.

Se è necessario conoscere l'indice di un elemento dopo aver creato un ID, chiamare LVM_MAPIDTOINDEX con l'ID univoco e restituisce l'indice più recente.

Nota In un ambiente multithreading, è possibile assicurarsi che solo l'indice corretto venga restituito nel thread che ospita il controllo visualizzazione elenco, non nei thread in background.

 

Per usare ListView_MapIDToIndex, specificare Comctl32.dll versione 6 nel manifesto. Per altre informazioni sui manifesti, vedere Abilitazione degli stili di visualizzazione.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commctrl.h