ListView_MapIDToIndex macro (commctrl.h)

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

Sintaxe

UINT ListView_MapIDToIndex(
   HWND hwnd,
   UINT id
);

Parâmetros

hwnd

Tipo: HWND

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

id

Tipo: UINT

Um UINT que contém a ID exclusiva de um item.

Valor de retorno

Tipo: UINT

Retorna o índice mais atual.

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 que retorna de uma chamada, como IComponent::GetDisplayInfo e chame LVM_MAPINDEXTOID. O valor retornado é uma ID exclusiva.

Se você precisar saber o índice de um item depois de criar uma ID, chame LVM_MAPIDTOINDEX com a ID exclusiva e retornará o índice mais atual.

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