CTreeCtrl::SetCheck

呼叫此成員函式將樹狀目錄控制項項目的選取狀態。

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

參數

  • hItem
    接收檢查狀態變更的 HTREEITEM

  • fCheck
    表示樹狀目錄控制項項目是否已核取或取消核取。 根據預設, SetCheck 設定要簽出項目。

傳回值

如果不是零,則成功,則為 0。

備註

在樹狀目錄控制項項目核取 (fCheck 設為 ) 時,項目會顯示相鄰核取記號。

範例

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

若要使用核取方塊,請在填入樹狀目錄控制項之前設定 TVS_CHECKBOXES。

m_TreeCtrl.ModifyStyle(0, TVS_CHECKBOXES);

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

需求

Header: afxcmn.h

請參閱

參考

CTreeCtrl 類別

階層架構圖

CTreeCtrl::GetCheck