ListView_GetItemState宏 (commctrl.h)

获取列表视图项的状态。 可以使用此宏或显式发送 LVM_GETITEMSTATE 消息。

语法

UINT ListView_GetItemState(
   HWND hwndLV,
   int  i,
   UINT mask
);

参数

hwndLV

类型:HWND

列表视图控件的句柄。

i

类型:int

列表视图项的索引。

mask

类型:UINT

要检索的状态信息。 此参数可以是以下值的组合:

价值 意义
LVIS_CUT
该项标记为剪切和粘贴操作。
LVIS_DROPHILITED
该项突出显示为拖放目标。
LVIS_FOCUSED
该项具有焦点,因此它被标准焦点矩形包围。 虽然可以选择多个项目,但只有一个项目可以具有焦点。
LVIS_SELECTED
已选择该项。 所选项目的外观取决于它是否具有焦点,以及用于选择的系统颜色。
LVIS_OVERLAYMASK
使用此掩码检索项的覆盖图像索引。
LVIS_STATEIMAGEMASK
使用此掩码检索项的状态图像索引。

返回值

类型:UINT

返回指定项的当前状态。 返回值中唯一有效的位与 掩码 参数中设置的位相对应。

言论

项的状态信息包括一组位标志以及指示项的状态图像和覆盖图像的图像列表索引。

要求

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

另请参阅

ListView_SetItemState