共用方式為

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

請參閱

參考

CTreeCtrl 類別

階層架構圖

CTreeCtrl::GetItem