CTreeCtrl::SetCheck

更新 : 2007 年 11 月

ツリー ビュー コントロールのアイテムのチェック状態を設定します。

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

パラメータ

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

  • fCheck
    ツリー ビュー コントロールのアイテムをチェック状態またはチェック解除状態にするかどうかを指定します。SetCheck の既定では、アイテムをチェック状態にします。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

ツリー ビュー コントロールのアイテムをチェック状態にすると (fCheck を TRUE に設定)、アイテムの隣にチェック マークが表示されます。

使用例

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

その他の技術情報

CTreeCtrl のメンバ