Partilhar via


CTreeCtrl::SetCheck

Chamar essa função de membro para definir o estado de verificação para um item de controle da árvore.

BOOL SetCheck(
   HTREEITEM hItem,
   BOOL fCheck = TRUE 
);

Parâmetros

  • hItem
    HTREEITEM para receber a alteração de estado de verificação.

  • fCheck
    Indica se o item de controle da árvore deve ser marcada ou desmarcada.Por padrão, SetCheck define o item a ser verificado.

Valor de retorno

Diferente de zero se com êxito; se não 0.

Comentários

Quando o item de controle tree é verificado (fCheck definido como Verdadeiro), o item aparecerá com uma marca de seleção adjacente.

Exemplo

UINT uCount = m_TreeCtrl.GetVisibleCount();
HTREEITEM hItem = m_TreeCtrl.GetFirstVisibleItem();

// Toggle the check state of all the visible items.
for (UINT i = 0; i < uCount; i++)
{
   ASSERT(hItem != NULL);
   m_TreeCtrl.SetCheck(hItem, !m_TreeCtrl.GetCheck(hItem));
   hItem = m_TreeCtrl.GetNextVisibleItem(hItem);
}

Para usar caixas de seleção, defina TVS_CHECKBOXES antes de preencher o controle da árvore.

m_TreeCtrl.ModifyStyle(0, TVS_CHECKBOXES);

HTREEITEM aItem = m_TreeCtrl.InsertItem(_T("AAA"));
m_TreeCtrl.SetCheck(aItem);

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe de CTreeCtrl

Gráfico de hierarquia

CTreeCtrl::GetCheck