macro TreeView_SetCheckState (commctrl.h)

Define a imagem de estado do item como "marcada" ou "desmarcada". Você também pode usar a mensagem TVM_SETITEM diretamente.

Sintaxe

void TreeView_SetCheckState(
   hwndTV,
   hti,
   fCheck
);

Parâmetros

hwndTV

Tipo: HWND

Identificador para o controle de exibição de árvore.

hti

Tipo: HTREEITEM

Manipule para o item.

fCheck

Tipo: BOOL

Valor que indica qual imagem de estado é exibida. Defina fCheck como TRUE para exibir a imagem de estado marcada ou FALSE para exibir a imagem desmarcada.

Retornar valor

Nenhum

Comentários

Um controle de exibição de árvore pode ter duas listas de imagens. A lista de imagens normais armazena as imagens selecionadas, não selecionadas e sobrepostas. As caixas de seleção são armazenadas na lista de imagens de estado e exibidas à esquerda da imagem normal correspondente. As imagens de estado são especificadas por um índice baseado em um. Um índice de zero indica que não há nenhuma imagem de estado. Consulte Listas de Imagem de Exibição de Árvore para obter uma discussão sobre como lidar com imagens de exibição de árvore.

Se você quiser definir suas próprias imagens de estado, essa macro pressupõe que as imagens marcadas e desmarcadas tenham os mesmos índices que a lista de imagens padrão: 1 para desmarcada e 2 para marcada.

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