CTreeCtrl::SetItem
指定されたツリー ビュー アイテムの属性を設定するには、この関数を呼び出します。
BOOL SetItem(
TVITEM* pItem
);
BOOL SetItem(
HTREEITEM hItem,
UINT nMask,
LPCTSTR lpszItem,
int nImage,
int nSelectedImage,
UINT nState,
UINT nStateMask,
LPARAM lParam
);
パラメーター
pItem
新しいアイテムの属性を含む Windows SDKに説明されているように TVITEM の構造体へのポインター。hItem
属性が設定されている項目のハンドル。Windows SDKの TVITEM の構造体の hItem のメンバーを参照してください。nMask
セットにすべての属性を指定する整数。TVITEM の構造体の mask のメンバーを参照してください。lpszItem
項目のテキストを含む文字列のアドレス。nImage
ツリー ビュー コントロールのイメージ リスト項目のイメージのインデックス。TVITEM 構造体の iImage メンバーを参照してください。nSelectedImage
ツリー ビュー コントロールのイメージ リスト項目の選択されたイメージのインデックス。TVITEM の構造体の iSelectedImage のメンバーを参照してください。nState
項目の状態の値を指定します。TVITEM の構造体の [状態] のメンバーを参照してください。nStateMask
どの状態を設定する必要があるかを指定します。TVITEM の構造体の stateMask のメンバーを参照してください。lParam
項目に関連付けられた 32 ビット アプリケーション固有の値。
戻り値
正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。
解説
TVITEM の構造体には、hItem のメンバーは、項目を識別し、設定する属性 mask のメンバーを指定します。
mask のメンバーか nMask のパラメーターが TVIF_TEXT の値を指定した場合、pszText のメンバーか lpszItem は null で終わる文字列のアドレスであり、cchTextMax のメンバーは無視されます。mask (または) nMaskTVIF_STATE の値を指定した場合、変更した項目の状態と nState の state のメンバーまたはパラメーターがそれらの状態の値を含むこと stateMask のメンバーか nStateMask のパラメーターを指定します。
使用例
// Show the item at the point myPoint in bold.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);
if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
m_TreeCtrl.SetItem(hItem, TVIF_STATE, NULL, 0, 0, TVIS_BOLD,
TVIS_BOLD, 0);
}
必要条件
ヘッダー: afxcmn.h