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
out 包含新項目屬性的 TVITEM 結構的指標 Windows SDK，如中所述。hItem
屬性 (Property) 會設定項目的控制代碼。 請參閱 TVITEM 結構的 hItem 成員在 Windows SDK的。nMask
指定哪些屬性的整數陣列。 請參閱 TVITEM 結構的 遮罩 成員。lpszItem
包含項目的文字字串的位址。nImage
項目的影像索引在樹狀檢視控制項的影像清單的。 請參閱 TVITEM 結構的 iImage 成員。nSelectedImage
項目已選取的影像索引在樹狀檢視控制項的影像清單的。 請參閱 TVITEM 結構的 iSelectedImage 成員。nState
為項目狀態指定值。 請參閱 TVITEM 結構的 狀態 成員。nStateMask
指定哪些狀態要設定屬性。 請參閱 TVITEM 結構的 stateMask 成員。lParam
32 位元的應用程式專屬值與項目。
傳回值
如果不是零，則成功，則為 0。
備註
在 TVITEM 結構， hItem 成員找出項目，並 遮罩 成員，指定要設定的哪些屬性。
如果 遮罩 成員或 nMask 參數指定 TVIF_TEXT 值， pszText 成員或 lpszItem 是 null 結尾字串的位址，並 cchTextMax 成員會被略過。 如果 遮罩 (或 nMask) 指定 TVIF_STATE 值， stateMask 成員或 nStateMask 參數指定哪些項目狀態變更和 state 成員或 nState 參數包含這些狀態的值。
範例
// 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);
}
需求
Header: afxcmn.h