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

void ListView_MapIndexToID(
   hwnd,
   index
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione elenco.

index

Tipo: UINT

UINT che contiene l'indice di un elemento.

Valore restituito

nessuno

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 l'indice corretto venga restituito solo 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.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commctrl.h