Delphi(TListView)列表视图组件详解
TListView 组件以多种形式显示列表的项目,如详细资料、小图标、大图标等形式表示列表中的项目。列表视图与用TListBox 组件实现的列表框非常相似。不同的是,列表视图可以让用户选择不同的显示方式,诸如大图标方式、小图标方式、简单列表方式和详细列表方式等。Windows XP 的资源管理器就是一个典型的列表视图。
一.TListView 组件的典型用法
列表视图的显示方式是通过ViewStyle 属性设置的。当ViewStyle 属性设为vsReport 时,列表视图将以详细列表的方式显示。以Windows XP 的资源管理器为例,当选中“查看”菜单上的“详细资料”命令时,列表视图中将显示文件或文件夹的图标、名称、字节数、类型和上次修改时间等信息。以详细列表方式显示时,需要把Columns 属性设为需要的栏数,如果要给每一栏显示一个表头,必须把ShowColumnHeaders 属性设为True。如果把ColumnClick 属性设为True,每一栏的表头就相当于一个按钮,单击这些按钮将触发OnColumnClick 事件。单击“名称”这一栏表头,目录中的文件将按文件名的字母进行排序。单击“大小”这个按钮,目录中的文件将以文件的字节数进行排序。
程序应当为列表视图中的每一项指定图标。因此需要建立两个图像列表,一个用于大图标显示方式,另一个用于小图标显示方式(因为这两种方式下的图标大小是不同的),然后分别设置LargeImages属性和SmallImages 属性指定这两个图像列表。
二.TListView 组件的重要属性
·BoundingRect | 返回一个能把列表视图中所有项包住的矩形 |
·CheckBoxed | 列表视图中项的旁边将显示复选框 |
·Column | 此属性可以访问列表视图中的每一栏 |
·ColumnClick | 此属性设为True时,将触发OnColumnClick事件 |
·Columns | 列表视图的每一项将分成很多栏 |
·FlatScrollBars | 列表视图的滚动条是平坦的 |
·FullDrag | 允许用户拖动表头 |
·GridLines | 此属性将显示栅格线 |
·HideSelection | 当输入焦点移走时,原先选择的节点是否处于被选择状态 |
·HotTrack | 当鼠标指向某个项时,该项的外观将与众不同 |
·HoverTime | 此属性用于设置鼠标必须停留多久才能选择一个项,1000代表1秒 |
·ItemFocused | 指定或返回列表视图中具有输入焦点的项 |
·Items | 代表列表视图中的所有项 |
·LargeImages | 此属性用于指定大图标显示方式下大图标所在的图像列表 |
·MultiSelect | 如果此属性设为True,用户可以同时选择多个项 |
·ReadOnly | 列表视图是只读的 |
·RowSelect | 用户可以一次选择一整行 |
·SelCount | 返回列表视图中被选择的项的数目 |
·Selected | 此属性用于设置返回列表视图中被选择的项 |
·SmallImages | 指定小图标显示方式下小图标所在的图像列表 |
·ShowWorkAreas | 通过定义工作区,可以把图标分组 |
·SortType | 此属性用于设置什么情况下列表视图中的项将重新排序 |
·StateImages | 此属性用于指定一个图像列表 |
·TopItem | 返回列表视图中当前可见的最顶端的项 |
·ViewStyle | 设置列表视图的显示方式 |
(1)BoundingRect 属性
此属性返回一个能把列表视图中所有项包住的矩形。此属性仅在ViewStyle 属性设为vsIcon 或vsSmallIcon 时有效。(2)CheckBoxed 属性
当ViewStyle 属性设为vsList 或vsReport 时,如果把CheckBoxes 属性设为True,列表视图中项的旁边将显示复选框,如同TCheckListBox 组件一样。(3)Column 属性
此属性可以访问列表视图中每一栏,Index 指定栏的序号。此属性仅当ViewStyle 属性设为vsReport时有效。(4)ColumnClick 属性
如果此属性设为True,栏的表头(如果有的话)将同时作为按钮用,按下这些按钮,将触发OnColumnClick 事件,通常用于对列表视图中的项进行重新排序。(5)Columns 属性
如果ViewStyle 属性设为vsReport,列表视图的每一项将分成多栏,每一栏都是一个TListColumn对象,所有的栏构成TListColumn 对象。在设计期,可以单击Columns 属性旁的省略号“ ”按钮打开“Editing Columns”窗口,然后建立和编辑栏的属性。
(6)HideSelection 属性
如果此属性设为True,当输入焦点从列表视图移到其他组件上时,原先选择的节点将不再处于被选择状态。如果此属性设为False,当输入焦点移走时仍然保持选择状态。(7)ItemFocused 属性
此属性指定或返回列表视图中具有输入焦点的项。一个列表视图中可以同时有多个项被选择,但只能有一个项具有输入焦点。(8)Items 属性
此属性代表列表视图中的所有项。列表视图中的每一项是一个TListItem 对象。在设计期,可以按下Items 属性旁的“...”按钮打开“ListView Items”编辑器,然后建立和编辑列表视图中的每一项.(9)MultiSelect 属性
如果此属性设为True,用户可以同时选择多个项。(10)RowSelect 属性
在ViewStyle 属性设为vsReport 的前提下,如果把此属性设为True,用户可以一次选择一整行。(11)Selected 属性
此属性用于设置返回列表视图中被选择的项。如果有多项被选择,返回的是当前有输入焦点的项。(12)ShowWorkAreas 属性
在ViewStyle 属性设为vsIcon 或vsSmallIcon 的情况下,通过定义工作区,可以把图标分组,如果ShowWorkAreas 属性设为True,列表视图将把客户区分成几个工作区,每个工作区的颜色由TWorkArea的Color 属性指定,标签由TWorkArea 的DisplayName 属性指定。(13)SortType 属性
此属性用于设置什么情况下列表视图中的项将重新排列。它设定了如下4 个用户可选值。- stNone:不重新排序。
- stData:项的Data 属性发生变化时重新排序。
- stText:项的Caption 属性发生变化时重新排序。
- stBoth:项的Data 属性或Caption 属性发生变化时重新排序。
(14)ViewStyle 属性
此属性用于设置什么情况下列表视图中的项将重新排列。它设定了如下4 个用户可选值。- vsIcon:以大图标方式显示。
- vsSmallIcon:以小图标方式显示。
- vsList:以简单列表方式显示,不能进行拖放操作。
- vsReport:以详细列表方式显示,最左边的栏显示项的图标和标签。
三.TListView 组件的重要事件
OnColumnClick | 当用户单击栏的表头时,将触发该事件 |
OnColumnDragged | 当用户用鼠标左键拖动某一栏到一个新的位置时,将触发该事件 |
OnEdited | 当用户直接编辑修改了项的标签后,将触发该事件 |
OnGetImageIndex | 当一个项将要在屏幕上刷新时,将触发这个事件 |
OnInfoTip | 通过这个事件给列表视图中的每一项加上提示 |
OnSelectItem | 当列表视图中一个项被选择时,将触发这个事件 |
下面介绍程序中TListView 组件的常用事件。
(1)OnColumnClick 事件
当用户单击栏的表头时,将触发该事件。这样就可以对项进行排序。在OnColumnClick 事件中有一个TListColumn 类型的参数Column,此参数返回用户单击的栏,利用Column 参数可以对用户选中的栏进行访问及设置。(2)OnColumnDragged 事件
当用户用鼠标左键拖动某一栏到一个新的位置时,将触发该事件。在使用此事件之前必须将TListView 组件的FullTrag 属性设置为True,表示可以拖动栏的位置,否则不能拖动,也就不能触发此事件。(3)OnEdited 事件
当用户直接编辑修改了项的标签后,将触发该事件。OnEdited 事件中有一个TListItem 类型的参数Item,利用此参数可以对用户编辑的项进行访问;OnEdited 事件中还有一个String 类型的参数S,它是用户更改项的标签后,显示标签的内容。(4)OnInfoTip 事件
通过这个事件可以为列表视图中的每一项加上提示。OnInfoTip 事件中有一个TListItem 类型的参数Item,利用此参数可以对用户编辑的项进行访问;OnInfoTip 事件中还有一个String 类型的参数InfoTip,更改它的值就可以为每一项加上提示。例如将每一项的提示设置为项的标签内容,就可以在OnInfoTip 事件中添加如下代码:
InfoTip:=Item.Caption;
如果要显示提示信息,必须将TListView 组件的ShowHind 属性设置为True。
(5)OnSelectItem 事件
当列表视图中一个项被选择时,将触发这个事件。OnSelectItem 事件中有一个TListItem 类型的参数Item,利用此参数可以对用户编辑的项进行访问;OnSelectItem 事件中还有一个Boolean 类型的参数Selected。每次选择一个新项时将两次触发此事件,一次是释放以前被选择的项,Selected 参数取值为False,代表释放Item 参数指定的项;另外一次是选择新的项,Selected 参数取值为True,代表选择Item 参数指定的项。四.TListView 组件的重要方法
AlphaSort | 将列表视图中的项按标签的字母顺序排序 |
Arrange | 此方法用于重排图标 |
FindCaption | 此方法用于搜索并返回一个项 |
Scroll | 此方法使列表视图滚动 |
StringWidth | 此方法返回字符串的宽度 |
UpdateItems | 此方法重画指定范围内的项 |
下面介绍程序中TListView 组件常用的方法。
(1)AlphaSort 方法
此方法可以将列表视图中的项按标签的字母顺序排序。例如使用下面的代码就能够将ListView1组件的项按标签的字母顺序排序:ListView1.AlphaSort;
(2)Arrange 方法
此方法用于重排图标。Arrange 方法只有在ViewStyle 属性为vsIcon 或vsSmallIcon 时才起作用。Arrange 方法中有一个TListArrangement 类型的参数Code,此参数用于指定图标的排列方式,其取值及功能如下。
- arAlignBottom:图标底部对齐排列。
- arAlignLeft:图标左侧对齐排列。
- arAlignRight:图标右侧对齐排列。
- arAlignTop:图标顶部对齐排列。
- arDefault:按照窗口刚建立时的风格将图标从顶部排列。
- arSnapToGrid:将图标对齐到最近的网格,此值不支持虚拟模式。
(3)FindCaption 方法
此方法的调用可以搜索并返回一个TListItem 类型的项。FindCaption 方法中有5 个参数,功能如下。- StartIndex:Integer 类型,用于指定开始搜索的起始位置。
- Value:String 类型,指定要搜索的项的标题符合的内容。
- Partial:Boolean 类型,取True 值,查找标题开头为Value 参数指定的项;取False 值,查找标题与Value 参数指定的内容相同的项。
- Inclusive:Boolean 类型,取True 值,被StartIndex 指定的项是第1 个被选中的;取False 值,开始查找的位置从StartIndex 拟定的下一个位置开始。
- Warp:Boolean 类型,取True 值,搜索将从开始找到最后;取False 值,搜索从StartIndex 位开始查找,找到最后。
(4)Scroll 方法
此方法可以使列表视图滚动。Scroll 方法有两个Integer 类型的参数。- DX:控制视图的左右一次移动的像素数,正数代表向右移动,负数代表向左移动。
- DY:控制视图的上下一次移动的像素数,正数代表向下移动,负数代表向上移动。
(5)StringWidth 方法
此方法用于返回字符串的宽度。StringWidth 方法中用到一个String 类型的参数S,StringWidth 方法是根据当前TListView 组件的字体、字号返回参数S 指定的字符串宽度的像素数。(6)UpdateItems 方法
此方法可以重画指定范围内的项。UpdateItems 有两个Integer 类型的参数:- FirstIndex:用于指定重画项的开始位置。
- LastIndex:用于指定重画项的最后位置。
内容来源于网络如有侵权请私信删除
文章来源: 博客园
- 还没有人评论,欢迎说说您的想法!