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

BOOL ListView_GetItem(
   HWND     hwnd,
   LPLVITEM 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 de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

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 de LVITEM .

Se o sinalizador LVIF_TEXT estiver definido na máscara membro da estrutura LVITEM , o membro pszText deverá apontar para um buffer válido e o membro cchTextMax deve 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 pszText membro da estrutura para apontar para o novo texto em vez de colocá-lo no buffer.

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

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