ListView_SetItemIndexState宏 (commctrl.h)

设置指定列表视图项的状态。 使用此宏或显式发送 LVM_SETITEMINDEXSTATE 消息。

语法

HRESULT ListView_SetItemIndexState(
  [in] HWND        hwndLV,
  [in] LVITEMINDEX *plvii,
  [in] UINT        data,
  [in] UINT        mask
);

参数

[in] hwndLV

类型:HWND

列表视图控件的句柄。

[in] plvii

类型:LVITEMINDEX*

指向项 LVITEMINDEX 结构的指针。 调用方负责分配此结构并设置成员。

[in] data

类型:UINT

在项上设置为 List-View 项状态 标志的一个或多个(按位组合)的状态。

[in] mask

类型:UINT

参数 数据指定的状态的有效位。 有关详细信息,请参阅 LVITEM) 结构的 stateMask 成员。

返回值

类型:HRESULT

返回以下 HRESULT类型的值之一。

返回代码 描述
E_FAIL 无法设置状态。
E_UNEXPECTED 列表视图控件尚未准备好用于操作。
S_OK 操作成功。

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 窗户
标头 commctrl.h