Macro ListView_MapIDToIndex (commctrl.h)

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

Sintassi

void ListView_MapIDToIndex(
   hwnd,
   id
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo di visualizzazione elenco.

id

Tipo: UINT

UINT contenente l'ID univoco di un elemento.

Valore restituito

nessuno

Osservazioni

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

È possibile usare 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 di visualizzazione elenco.

Per identificare in modo univoco un elemento, prendere l'indice restituito da una chiamata, ad esempio IComponent::GetDisplayInfo e 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ù corrente.

Nota In un ambiente multithreaded, è possibile assicurarsi che l'indice corretto venga restituito nel thread che ospita il controllo di 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.

Requisiti

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