macro ListView_SetItemState (commctrl.h)

Altera o estado de um item em um controle de exibição de lista. Você pode usar essa macro ou enviar a mensagem LVM_SETITEMSTATE explicitamente.

Sintaxe

void ListView_SetItemState(
   hwndLV,
   i,
   data,
   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. Se esse parâmetro for -1, a alteração de estado será aplicada a todos os itens.

data

Tipo: UINT

Novos bits de estado para o item. O parâmetro mask indica os bits válidos do parâmetro state . A macro ignorará bits no parâmetro de estado se o bit correspondente não estiver definido no parâmetro mask . O byte de baixa ordem contém um conjunto de sinalizadores de bits que indicam o estado do item. Esse byte 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. Os itens só serão exibidos como selecionados se o controle de exibição de lista tiver foco ou o estilo de LVS_SHOWSELALWAYS for usado.

mask

Tipo: UINT

Bits do parâmetro de estado que você deseja definir ou limpar. Você pode usar ListView_SetItemState para definir e limpar bits. Para definir o índice de imagem de sobreposição de um item, defina o LVIS_OVERLAYMASK bits. Para definir o índice de imagem de estado de um item, defina os bits de LVIS_STATEIMAGEMASK .

Retornar valor

Nenhum

Comentários

O valor de estado de um item inclui um conjunto de sinalizadores de bits que indicam o estado do item. O valor de estado também pode incluir índices de lista de imagens que indicam a imagem de estado do item e a imagem de sobreposição.

O parâmetro mask especifica os bits de estado que você deseja modificar e o parâmetro de estado especifica o novo valor para esses bits. Para definir um bit no estado interno do item, defina-o nos parâmetros mask e state . Para limpar um pouco no estado interno do item, defina-o no parâmetro mask e limpe-o no parâmetro state . Para deixar um pouco inalterado no estado interno do item, desmarque-o no parâmetro mask .

Os bits 8 a 11 do parâmetro de estado especificam o índice baseado em um de uma imagem de sobreposição nas listas de imagens do controle. A lista de imagens de ícone de tamanho completo e a lista de imagens de ícone pequeno podem ter imagens de sobreposição. A imagem de sobreposição é sobreposta sobre a imagem de ícone do item. Se esses bits forem zero, o item não terá nenhuma imagem de sobreposição. Para isolar esses bits, use a máscara de LVIS_OVERLAYMASK . Para especificar um índice de sobreposição, use a macro INDEXTOOVERLAYMASK .

Os bits 12 a 15 do parâmetro de estado especificam o índice baseado em uma imagem na lista de imagens de estado do controle. A imagem de estado é exibida ao lado do ícone de um item para indicar um estado definido pelo aplicativo. Se esses bits forem zero, o item não terá nenhuma imagem de estado. Para isolar esses bits, use a máscara LVIS_STATEIMAGEMASK . Para especificar um índice de imagem de estado, use a macro INDEXTOSTATEIMAGEMASK .

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

Confira também

ListView_GetItemState