TreeView_GetCheckState macro (commctrl.h)

Obtém o estado de verificação do item especificado. Você também pode usar a mensagem TVM_GETITEMSTATE diretamente.

Sintaxe

UINT TreeView_GetCheckState(
   HWND      hwndTV,
   HTREEITEM hti
);

Parâmetros

hwndTV

Tipo: HWND

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

hti

Tipo: HTREEITEM

Manipule para o item.

Valor de retorno

Tipo: UINT

Retorna:

Código de retorno	Descrição
Verificado	1
Desmarcada	0
Imagem sem caixa de seleção	-1

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