导航:  Windows Controls Procedures > List View Control > Wrappers >

ListView_SetItemState

上一页返回章节概述下一页

描述

 

更改列表视图控件中的项的状态.您可以使用此程序或明确的LVM_SETITEMSTATE发送消息.

 

FreeBASIC 语法

#macro ListView_SetItemState(hwndLV, i, data, mask)

 

参数

hwndLV

[in]句柄ListView控件.

i

[in]的列表视图项的索引.如果这个参数是-1,然后状态更改应用于所有项目.

state

新的项目[in]状态位.的mask参数表示的状态参数的有效位.该方法忽略了位在状态参数若有相应设置不在mask参数.低位字节包含一组位标志,指示项目的状态.这个字节可以是以下值的组合:

 

LVIS_CUT

该项目标记为剪切和粘贴操作.

LVIS_DROPHILITED

该项目突出显示为拖放目标.

LVIS_FOCUSED

该项目有重点,所以它是由一个标准的焦点矩形包围.虽然可以选择多个项目,只有一个项目可以有重点.

LVIS_SELECTED

选择项目.选定项的外观取决于它是否具有焦点,也取决于用于选择的系统颜色.项目将只显示如果列表视图控件有焦点或LVS_SHOWSELALWAYS风格选择.

mask

[in]比特的状态参数要设置或清除.你可以使用ListView_SetItemState都设置和清除位.设置项的叠加图像索引,设置LVIS_OVERLAYMASK位.设置一个项的状态图像索引,设置LVIS_STATEIMAGEMASK位.

 

备注

 

一个项目的状态值包括一组指示该项目状态的位标志.状态值还可以包括显示项目状态图像和覆盖图像的图像列表索引.

 

掩码参数指定要修改的状态位,状态参数指定这些位的新值.若要在该项目的内部状态中设置一个位,请将其设置为掩码和状态参数.若要清除项目内部状态中的某个位,请将其设置在掩码参数中,并在状态参数中清除它.要在项目的内部状态中保持一点不变,请在掩码参数中清除它.

位8到状态参数的11指定控件图像列表中的叠加图像的一个索引.全尺寸图标图像列表和小图标图像列表都可以覆盖图像.叠加图像叠加在该项目的图标图像.如果这些位为零,则该项目没有覆盖图像.隔离这些位,使用LVIS_OVERLAYMASK面具.一种覆盖指定索引,使用INDEXTOOVERLAYMASK ]程序.

位12到状态参数的15指定控件状态图像列表中的图像的一个索引.状态图像显示在项目图标旁边以表示应用程序定义的状态.如果这些位为零,则该项没有状态图像.隔离这些位,使用LVIS_STATEIMAGEMASK面具.一个国家指定图像索引,使用INDEXTOSTATEIMAGEMASK功能.

 

引用文件

 

COmmCtrl.bi