ListView_MapIndexToID macro (commctrl.h)

Mapeia o índice de um item para uma ID exclusiva. Você pode usar essa macro ou enviar a mensagem LVM_MAPINDEXTOID explicitamente.

Sintaxe

UINT ListView_MapIndexToID(
   HWND hwnd,
   UINT index
);

Parâmetros

hwnd

Tipo: HWND

Um identificador para o controle de exibição de lista.

index

Tipo: UINT

Um UINT que contém o índice de um item.

Valor de retorno

Tipo: UINT

Retorna uma ID exclusiva.

Observações

Controles de exibição de lista rastreiam internamente itens por índice. Isso pode apresentar problemas porque os índices podem ser alterados durante a existência do controle.

Você pode usar essa macro para marcar um item com uma ID ao criar o item. Use essa ID para garantir a exclusividade durante a existência do controle de exibição de lista.

Para identificar exclusivamente um item, pegue o índice retornado de uma chamada como IComponent::GetDisplayInfo e chame LVM_MAPINDEXTOID. O valor retornado é uma ID exclusiva.

Observação Em um ambiente multithreaded, você só pode ter certeza de que o índice correto é retornado no thread que hospeda o controle de exibição de lista, não em threads em segundo plano.
 
Para usar ListView_MapIndexToID, especifique Comctl32.dll versão 6 no manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho commctrl.h