通过

CListCtrl::SetItem

  • 项目

设置某些或所有列表视图项目的属性。

BOOL SetItem(
   const LVITEM* pItem 
);
BOOL SetItem(
   int nItem,
   int nSubItem,
   UINT nMask,
   LPCTSTR lpszItem,
   int nImage,
   UINT nState,
   UINT nStateMask,
   LPARAM lParam 
);
BOOL SetItem(
   int nItem,
   int nSubItem,
   UINT nMask,
   LPCTSTR lpszItem,
   int nImage,
   UINT nState,
   UINT nStateMask,
   LPARAM lParam,
   int nIndent 
);

参数

  • pItem
    一个包含新项目属性的 LVITEM 结构的地址，如 Windows SDK所述。 结构的 iItem 和 iSubItem 成员识别项目或子项，并且，结构的 mask 成员指定设置的哪些属性。 有关 mask 成员的更多信息，请参见 Remarks。

  • nItem
    属性将设置项的索引。

  • nSubItem
    属性将被设置为子项的索引。

  • nMask
    指定哪些属性将设置为(请参见"备注"）。

  • lpszItem
    指定项的标签的一个Null终止的字符串的地址。

  • nImage
    项目的图像的索引在图像中的列表。

  • nState
    指定值。要更改的状态(请参见"备注"）。

  • nStateMask
    指定要更改的状态(请参见"备注"）。

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

  • nIndent
    宽度，以像素，缩进。 如果 nIndent 与该SYSTEM中定义的最小宽度小于，新的宽度设置为SYSTEM中定义的最小值

返回值

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

备注

LVITEM 结构和 nItem 和 nSubItem 参数的 iItem 和 iSubItem 成员属性标识要设置的项目和子项。

LVITEM 结构的 mask 成员和 nMask 参数指定项的属性将被设置为:

  • LVIF_TEXTpszText 成员或 lpszItem 参数是一个Null终止的字符串的地址; cchTextMax 成员被忽略。

  • LVIF_STATEstateMask 成员或 nStateMask 参数指定哪些项状态更改和 state 成员或 nState 参数包含这些状态中的值。

示例

为 CListCtrl::HitTest参见示例。

要求

Header: afxcmn.h

请参见

参考

CListCtrl选件类

层次结构图

CListCtrl::GetItem