TreeView_SetCheckState macro (commctrl.h)

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

Sintaxe

UINT TreeView_SetCheckState(
   HWND      hwndTV,
   HTREEITEM hti,
   BOOL      fCheck
);

Parâmetros

hwndTV

Tipo: HWND

Manipule 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 para TRUE para exibir a imagem de estado marcada ou FALSE para exibir a imagem desmarcada.

Valor de retorno

Tipo: UINT

O valor retornado não é usado.

Observações

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 Tree-View Listas de Imagens 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 da lista de imagens padrão: 1 para desmarcada e 2 para marcada.

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