ListView_GetItemState macro (commctrl.h)

Obtém o estado de um item de exibição de lista. Você pode usar essa macro ou enviar a mensagem LVM_GETITEMSTATE explicitamente.

Sintaxe

UINT ListView_GetItemState(
   HWND hwndLV,
   int  i,
   UINT mask
);

Parâmetros

hwndLV

Tipo: HWND

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

i

Tipo: int

O índice do item de exibição de lista.

mask

Tipo: UINT

As informações de estado a serem recuperadas. Esse parâmetro pode ser uma combinação dos seguintes valores:

Valor	Significado
LVIS_CUT	O item é marcado para uma operação de recortar e colar.
LVIS_DROPHILITED	O item é realçado como um destino de arrastar e soltar.
LVIS_FOCUSED	O item tem o foco, portanto, ele é cercado por um retângulo de foco padrão. Embora mais de um item possa ser selecionado, apenas um item pode ter o foco.
LVIS_SELECTED	O item está selecionado. A aparência de um item selecionado depende se ele tem o foco e também as cores do sistema usadas para seleção.
LVIS_OVERLAYMASK	Use essa máscara para recuperar o índice de imagem de sobreposição do item.
LVIS_STATEIMAGEMASK	Use essa máscara para recuperar o índice de imagem de estado do item.

Valor de retorno

Tipo: UINT

Retorna o estado atual do item especificado. Os únicos bits válidos no valor retornado são aqueles que correspondem aos bits definidos no parâmetro de máscara de .

Observações

As informações de estado de um item incluem um conjunto de sinalizadores de bits, bem como índices de lista de imagens que indicam a imagem de estado do item e a imagem de sobreposição.

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

Consulte também

ListView_SetItemState