CTreeCtrl::SetCheck

ツリー ビュー コントロールのアイテムのチェック状態を設定するには、このメンバー関数を呼び出します。

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

パラメーター

  • hItem
    チェック状態の変更を受け取る HTREEITEM

  • fCheck
    ツリー ビュー コントロールのアイテムがオンまたはオフであるかどうかを示します。既定では、SetCheck はチェックする項目を設定します。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 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);

必要条件

ヘッダー: afxcmn.h

参照

関連項目

CTreeCtrl クラス

階層図

CTreeCtrl::GetCheck