macro ListView_MapIndexToID (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

void ListView_MapIndexToID(
   hwnd,
   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 retornado

Nenhum

Comentários

Os controles de exibição de lista controlam internamente os 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. Você usa 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.

Nota Em um ambiente multithread, 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

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	commctrl.h