macro ListView_MapIndexToID (commctrl.h)

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

Sintassi

UINT ListView_MapIndexToID(
   HWND hwnd,
   UINT index
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione elenco.

index

Tipo: UINT

UINT che contiene l'indice di un elemento.

Valore restituito

Tipo: UINT

Restituisce un ID univoco.

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::GetDisplayInfo e chiamare LVM_MAPINDEXTOID. Il valore restituito è un ID univoco.

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_MapIndexToID, 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