Macro ListView_MapIDToIndex (commctrl.h)

  • Artigo

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

Sintaxe

void ListView_MapIDToIndex(
   hwnd,
   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.

Retornar valor

Nenhum

Comentários

Os controles de exibição de lista acompanham 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 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 ela retornará o índice mais atual.

Nota 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
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