通过

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
    到包含新项目属性的一 TVITEM 结构的指针，如 Windows SDK所述。

  • hItem
    属性将设置项目的句柄。 请参见 TVITEM 结构的 hItem 成员。Windows SDK的。

  • nMask
    指定哪些属性的整数设置。 请参见 TVITEM 结构的 mask 成员。

  • lpszItem
    包含项目文本的字符串的地址。

  • nImage
    项目的图像的索引在树视图控件图形的列表。 请参见 TVITEM 结构的 iImage 成员。

  • nSelectedImage
    项目中的选定图像的索引在树视图控件图形的列表。 请参见 TVITEM 结构的 iSelectedImage 成员。

  • nState
    为项目的状态指定值。 请参见 TVITEM 结构的 State 成员。

  • nStateMask
    指定的状态将被设置为。 请参见 TVITEM 结构的 stateMask 成员。

  • lParam
    32位特定的值与项目。

返回值

非零，如果成功;否则为0。

备注

在 TVITEM 结构，hItem 成员识别该项目，因此，mask 成员指定设置的哪些属性。

如果 mask 成员或 nMask 参数指定 TVIF_TEXT 值，pszText 成员或 lpszItem 是一个Null终止的字符串的地址，然后 cchTextMax 成员被忽略。 如果 mask (或 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