Freigeben über


CTreeCtrl::SetCheck

Rufen Sie die Memberfunktion auf, um den Aktivierungszustand für ein Strukturansicht-Steuerelement-Element festzulegen.

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

Parameter

  • hItem
    HTREEITEM, um die Aktivierungszustandsänderung zu empfangen.

  • fCheck
    Gibt an, ob das Strukturansicht-Steuerelement-Element überprüft oder deaktiviert werden soll.Standardmäßig legt SetCheck das überprüft werden, Element fest.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls.

Hinweise

Wenn das Strukturansicht-Steuerelement-Element (fCheck festgelegt TRUE) überprüft wird, wird das Element mit einem benachbarten Häkchen.

Beispiel

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);
}

Um Kontrollkästchen zu verwenden, legen Sie fest TVS_CHECKBOXES bevor Sie die Strukturansicht auffüllten.

m_TreeCtrl.ModifyStyle(0, TVS_CHECKBOXES);

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

Anforderungen

Header: afxcmn.h

Siehe auch

Referenz

CTreeCtrl-Klasse

Hierarchien-Diagramm

CTreeCtrl::GetCheck