macro ListView_GetItem (commctrl.h)

Obtém alguns ou todos os atributos de um item de exibição de lista. Você pode usar essa macro ou enviar a mensagem LVM_GETITEM explicitamente.

Sintaxe

void ListView_GetItem(
   hwnd,
   pitem
);

Parâmetros

hwnd

Tipo: HWND

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

pitem

Tipo: LPLVITEM

Um ponteiro para uma estrutura LVITEM que especifica as informações a serem recuperadas e recebe informações sobre o item de exibição de lista.

Valor retornado

Nenhum

Comentários

Quando a mensagem LVM_GETITEM é enviada, os membros iItem e iSubItem identificam o item ou subitem para recuperar informações e o membro da máscara especifica quais atributos recuperar. Para obter uma lista de valores possíveis, consulte a descrição da estrutura LVITEM .

Se o sinalizador LVIF_TEXT estiver definido no membro de máscara da estrutura LVITEM , o membro pszText deverá apontar para um buffer válido e o membro cchTextMax deverá ser definido como o número de caracteres nesse buffer. Os aplicativos não devem assumir que o texto será necessariamente colocado no buffer especificado. Em vez disso, o controle pode alterar o membro pszText da estrutura para apontar para o novo texto em vez de colocá-lo no buffer.

Se o membro da máscara especificar o valor LVIF_STATE, o membro stateMask deverá especificar os bits de estado do item a serem recuperados. Na saída, o membro de estado contém os valores dos bits de estado especificados.

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