ListView控件的属性

Posted 2023-05-11

参考技术A

下面按字母顺序列出了ListView控件的所有属性，可以按Ctrl+F查找。 AllowColumnReorder属性：返回或设置一个值，决定用户是否可以用鼠标对列进行重新排列。
语法：Object.AllowColumnReorder [ = Boolean]
Appearance属性：返回或设置对象的绘图风格，在运行时是只读的。
语法：Object.Appearance Appearance属性设置值值 描述 0 平面，控件没有可视化效果。 1 （缺省值）带有三维效果的控件。 Arrange属性：返回或设置一个值，此值决定如何排列ListView控件中的图标或小图标视图。
语法：Object.Arrange [ = Value] Arrange属性中Value设置值常数 值 描述 lvwNone 0 （缺省）无。 lvwAutoLeft 1 左对齐。项目自动沿控件左侧对齐。 lvwAutoTop 2 顶对齐。项目自动沿控件顶端对齐。 BackColor属性：返回或设置对象的背景颜色。
语法：Object.BackColor [ = Color]
BorderStyle属性：返回或设置对象的边框样式。0表示无边框，1表示有边框。
语法：Object.BorderStyle [ = Value]
CheckBoxes属性：返回或设置一个值，确定是否显示复选框。
语法：Object.Checkboxes [ = Boolean]
ColumnHeaderIcons属性：返回或者设置Imagelist控件，该控件为ColumnHeaders集合提供图标。
语法：Object.ColumnHeaderIcons [ = ImageList]
ColumnHeaders属性：返回ColumnHeader对象集合的引用。
语法：Object.ColumnHeaders
Container属性：返回或设置Form上控件的容器。在设计时不能使用。
语法：Set Object.Container [ = Container]
DragIcon属性：返回或设置图标，它将在拖放操作中作为指针显示。
语法：Object.DragIcon [ = Icon]
DragMode属性：返回或设置一个值，确定在拖放操作中所用的是手动还是自动拖动方式。
语法：Object.DragMode [ = Number] DragMode属性中Number设置值常数 值 描述 vbManual 0 （缺省值）手动方式，需要在源控件中用Drag方法来启动拖放操作。 vbAutomatic 1 自动方式，单击源控件自动启动拖放操作。只有在OLE容器控件没有焦点时，它才能自动地被拖动。 DropHighlight属性：返回或设置对Node或ListItem对象的引用，在光标移动到该对象上时，它就被突出显示为系统的突出颜色。
语法：Object.DropHighlight [ = Node / ListItem]
Enabled属性：返回或设置一个值，用来决定窗体或控件是否能够对用户产生的事件作出反应。
语法：Object.Enabled [ = Boolean]
FlatScrollBar属性：返回或设置一个值，确定对象中滚动条的外观。
语法：Object.FlatScrollBar [ = Boolean]
Font属性：返回一个Font对象。
语法：Object.Font
ForeColor属性：返回或设置在对象里显示图片和文本的前景颜色。
语法：Object.ForeColor [ = Color]
FullRowSelect属性：返回或设置一个值，决定是否选择整行。
语法：Object.FullRowSelect [ = Boolean]
GridLines属性：返回或设置一个值，决定在报表视图中ListView控件是否显示网格线。
语法：Object.GridLines [ = Boolean] Height属性：返回或设置对象的高度。
语法：Object.Height [ = Number]
HelpContextID属性：为一个对象返回或设置一个相关联上下文的编号。它被用来为应用程序提供上下文有关的帮助。
语法：Object.HelpContextID [ = Number]
HideColumnHeaders属性：返回或设置是否在报表视图中隐藏ListView控件的ColumnHeader对象。
语法：Object.HideColumnHeaders [ = Boolean]
HideSelection属性：返回一个值，以决定当控件失去焦点时选择文本是否加亮显示。
语法：Object.HideSelection
HotTracking属性：该属性的返回值确定是否使用灵敏的鼠标高亮度显示功能。
语法：Object.HotTracking
HoverSelection属性：返回或设置一个值，确定当鼠标指针在ListItem对象上停留时，对象是否被选中。
语法：Object.HoverSelection [ = Boolean]
hWnd属性：返回窗体或控件的句柄。
语法：Object.hWnd
Icons属性：返回或设置与ListView控件中图标视图关联的ImageList控件。
语法：Object.Icons [ = Imagelist]
Index属性：返回控件在控件数组中的标识号。
语法：Object.Index
LabelEdit属性：返回或设置一个值，决定是否可以编辑在控件中的ListItem对象的标签。
语法：Object.LabelEdit [ = Integer] LabelEdit属性中Integer设置值常数值描述lvwAutomatic0（缺省）自动的。BeforeLabelEdit事件发生在单击选中的节点的标签时。lvwManual1手动的。BeforeLabelEdit事件只发生在调用StartLabelEdit方法时。 LabelWrap属性：返回或设置一个值，此值决定当ListView控件为图标视图时标签是否可换行。
语法：Object.LabelWrap [ = Boolean]
Left属性：返回或设置对象内部的左边与它的容器的左边之间的距离。
语法：Object.Left [ = Value]
ListItems属性：返回控件中ListItem对象集合的引用。
语法：Object.ListItems
MouseIcon属性：返回或设置自定义的鼠标图标。
语法：Object.MouseIcon = LoadPicture(Pathname)或Object.MouseIcon [ = Picture]
MousePointer属性：返回或设置一个值，该值指示在运行时当鼠标移动到对象的一个特定部分时，被显示的鼠标指针的类型。
语法：Object.MousePointer [ = Value]
MultiSelect属性：返回或设置用户是否可以在控件中做多重选择。
语法：Object.MultiSelect [ = Boolean]
Name属性：返回用于标识控件的名字，在运行时是只读的。
语法： Object属性：返回对象与对象的方法或属性的设置。
语法：Object.Object [.Property | .Method]
OLEDragMode属性：返回或设置是由部件还是由程序员来处理OLE拖放操作。
语法：Object.OLEDragMode [ = Mode] OLEDragMode属性中Mode设置值常数 值 描述 vbOLEDragManual 0 （缺省）人工。程序员处理所有的OLE拖放操作。 vbOLEDragAutomatic 1 自动。部件处理所有的OLE拖放操作。 OLEDropMode属性：返回或设置目标部件如何处理放操作。
语法：Object.OLEDropMode [ = Mode] OLEDropMode属性中Mode设置值常数 值 描述 vbOLEDropNone 0 无。目标部件不接受OLE放操作，并且显示No Drop图标。 vbOLEDropManual 1 人工。目标部件触发OLE放事件，允许程序员用代码处理OLE放操作。 vbOLEDropAutomatic 2 自动。如果DataObject对象包含目标部件能识别的格式的数据，则自动接受OLE拖放操作。当OLEDropMode设为vbOLEDropAutomatic时，在目标上鼠标事件和OLE拖放事件都不会发生。 Parent属性：返回包含控件、或其它对象或者集合的窗体、对象、或集合。
语法：Object.Parent
Picture属性：返回或设置控件中要显示的图片。
语法：Object.Picture [ = Picture]
PictureAlignment属性：返回或设置一个值，确定对象中图片的对齐方式。
语法：Object.PictureAlignment [ = Integer] PictureAlignment属性中Integer设置值常数 值 描述 lvwTopLeft 0 左顶部对齐。 lvwTopRight 1 右顶部对齐。 lvwBottomLeft 2 左底部对齐。 lvwBottomRight 3 右底部对齐。 lvwCenter 4 居中。 lvwTile 5 （缺省）平铺。 SelectedItem属性：返回对所选ListItem的引用。
语法：Object.SelectedItem
SmallIcons属性：返回或设置与ListView控件中小图标视图关联的ImageList控件。
语法：Object.SmallIcons[ = Imagelist]
Sorted属性：返回或设置集合中的项目是否排序。
语法：Object.Sorted [ = Boolean]
SortKey属性：返回或设置一个值，决定控件中的ListItem对象如何排序。
语法：Object.SortKey [ = Integer] SortKey属性中Integer设置值设置值 描述 0 使用ListItem对象的Text属性排序。 ≥1 使用子项目排序。 SortOrder属性：返回或设置一个值，此值决定控件中的ListItem对象以升序或降序排列。
语法：Object.SortOrder [ = Integer] SortOrder属性中Integer设置值常数 值 描述 lvwAscending 0 （缺省）升序。从字母表首部（A～Z）或最早的日期开始排序。数字以字符串的形式排序，第一个数位决定排序的起始位置，其后的数位决定子排序。 lvwDescending 1 降序。从字母表尾部（Z～A）或最晚的日期开始排序。同上。 TabIndex属性：返回或设置父窗体中控件的Tab键次序。
语法：Object.TabIndex [ = Index]
TabStop属性：返回或设置一个值，决定是否能够使用Tab键来将焦点移至该控件。
语法：Object.TabStop [ = Boolean]
Tag属性：返回或设置一个表达式用来存储程序中需要的额外数据。
语法：Object.Tag [ = Expression]
TextBackground属性：返回或设置ListItem对象的背景是透明的还是不透明的。
语法：Object.TextBackground [ = Integer]
ToolTipText属性：返回或设置一个工具提示。
语法：Object.ToolTipText [ = String]
Top属性：返回或设置对象的内顶部和它的容器的顶边之间的距离。
语法：Object.Top [ = Value] View属性：返回或设置控件中ListItem对象的外观。
语法：Object.View [ = Value] View属性中Value设置值常数 值 描述 lvwIcon 0 （缺省）图标。每个ListItem对象由标准的图标和文本标签代表。 lvwSmallIcon 1 小图标。每个ListItem对象由小图标及其右侧的文本标签代表。项目水平排列。 lvwList 2 列表。每个ListItem对象由小图标及其右侧的文本标签代表。ListItem对象及其相关的信息在列中垂直排列。 lvwReport 3 报表。每个ListItem对象显示为小图标和文本标签。可在子项目中提供关于每个ListItem对象的附加信息。图标、文本标签和信息显示在列中，其中最左侧一列包含小图标和文本标签。附加列显示每个项目的子项目的文本。 Width属性：返回或设置对象的宽度。
语法：Object.Width [ = Number]

ListView控件的基本属性

一、ListView类

1、常用的基本属性：

（1）FullRowSelect：设置是否行选择模式。(默认为false) 提示：只有在Details视图该属性才有意义。

（2）GridLines：设置行和列之间是否显示网格线。（默认为false）提示：只有在Details视图该属性才有意义。

（3）AllowColumnReorder：设置是否可拖动列标头来对改变列的顺序。（默认为false）提示：只有在Details视图该属性才有意义。

（4）View：获取或设置项在控件中的显示方式，包括Details、LargeIcon、List、SmallIcon、Tile（默认为 LargeIcon）

（5）MultiSelect：设置是否可以选择多个项。（默认为false）

（6）HeaderStyle：获取或设置列标头样式。

Clickable：列标头的作用类似于按钮，单击时可以执行操作（例如排序）。

NonClickable：列标头不响应鼠标单击。

None：不显示列标头。

（7）LabelEdit：设置用户是否可以编辑控件中项的标签，对于Detail视图，只能编辑行第一列的内容。（默认为false）

（8）CheckBoxes：设置控件中各项的旁边是否显示复选框。（默认为false）

（9）LargeImageList：大图标集。提示：只在LargeIcon视图使用。

（10）SmallImageList：小图标集。提示：只有在SmallIcon视图使用。

（11）StateImageList：图像蒙板。这些图像蒙板可用作LargeImageList和SmallImageList图像的覆盖图，这些图像可用于指示项的应用程序定义的状态。（暂时不大懂）

（12）SelectedItems：获取在控件中选定的项。

（13）CheckedItems：获取控件中当前复选框选中的项。

（14）Soritng：对列表视图的项进行排序。(默认为None)

Ascending：项按递增顺序排序。

Descending：项按递减顺序排序。

None：项未排序。

（15）Scrollable：设置当没有足够空间来显示所有项时是否显示滚动条。（默认为true)

（16）HoverSelection：设置当鼠标指针悬停于项上时是否自动选择项。（默认为false）

（17）HotTracking：设置当鼠标指针经过项文本时，其外观是否变为超链接的形式。（默认为false）

（18）HideSelection：设置选定项在控件没焦点时是否仍突出显示。（默认为false）

（19）ShowGroups：设置是否以分组方式显示项。（默认为false);

（20）Groups：设置分组的对象集合。

（21）TopItem：获取或设置控件中的第一个可见项，可用于定位。（效果类似于EnsureVisible方法）

2、常用方法：

（1）BeginUpdate：避免在调用EndUpdate方法之前描述控件。当插入大量数据时，可以有效地避免控件闪烁，并能大大提高速度。

（2）EndUpdate：在BeginUpdate方法挂起描述后，继续描述列表视图控件。（结束更新）

（3）EnsureVisible：列表视图滚动定位到指定索引项的选项行。（效果类似于TopItem属性）

（4）FindItemWithText：查找以给定文本值开头的第一个 ListViewItem。

（5）FindNearestItem：按照指定的搜索方向，从给定点开始查找下一个项。提示：只有在LargeIcon或SmallIcon视图才能使用该方法。

3、常用事件：

（1）AfterLabelEdit：当用户编辑完项的标签时发生，需要LabelEdit属性为true。

（2）BeforeLabelEdit：当用户开始编辑项的标签时发生。

（3）ColumnClick：当用户在列表视图控件中单击列标头时发生。

 

二、ListView的五种视图：

1、LargeIcon：每个项都显示为一个最大化图标，在它的下面有一个标签。（效果见下图）

2、SmallIcon：每个项都显示为一个小图标，在它的右边带一个标签。（效果见下图）

3、List：每个项都显示为一个小图标，在它的右边带一个标签。各项排列在列中，没有列标头。（效果见下图）

4、Details：可以显示任意的列，但只有第一列可以包含一个小图标和标签，其它的列项只能显示文字信息，有列表头。（效果见下图）

5、Tile：每个项都显示为一个完整大小的图标，在它的右边带项标签和子项信息。（只有Windows XP 和 Windows Server 2003 系列支持）