Delphi(TListView)列表视图组件详解
2020-12-26 18:27
标签:value repo 目录 otto 添加 开头 add 上下 first Delphi(TListView)列表视图组件详解 标签:value repo 目录 otto 添加 开头 add 上下 first 原文地址:https://www.cnblogs.com/KK3228911/p/10026866.htmlDelphi(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 个用户可选值。
(14)ViewStyle 属性
此属性用于设置什么情况下列表视图中的项将重新排列。它设定了如下4 个用户可选值。
三.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,此参数用于指定图标的排列方式,其取值及功能如下。
(3)FindCaption 方法
此方法的调用可以搜索并返回一个TListItem 类型的项。FindCaption 方法中有5 个参数,功能如下。
FindCaption 方法返回的是第1 个被找到的符合条件的项,如果没找到符合条件的,则返回列表中的第1 项。(4)Scroll 方法
此方法可以使列表视图滚动。Scroll 方法有两个Integer 类型的参数。
(5)StringWidth 方法
此方法用于返回字符串的宽度。StringWidth 方法中用到一个String 类型的参数S,StringWidth 方法是根据当前TListView 组件的字体、字号返回参数S 指定的字符串宽度的像素数。(6)UpdateItems 方法
此方法可以重画指定范围内的项。UpdateItems 有两个Integer 类型的参数:
文章标题:Delphi(TListView)列表视图组件详解
文章链接:http://soscw.com/index.php/essay/38407.html