1. 简介
和ListBox的外观类似,都可以多列显示,但 ListView 功能更强大,提供了5种不同的显示方式
2. 属性
属性 | 解释 |
---|---|
(Name) | 控件ID,在代码里引用的时候会用到 |
Enabled | 控件是否启用 |
CheckBoxes | 复选框是否显示在项旁边 |
ContextMenuStrip | 当用户右键该控件时显示的快捷菜单 |
Dock | 定义要绑定到容器的控件边框 |
Items | ListView中的项的集合 |
Alignment | ListView中各项的对齐方式:Default、Left、Top(默认)、SnapToGrid |
View | 显示项的5种不同视图: LargeIcon:大图标,添加项的时候,默认是多列显示的 SmallIcon:小图标 Details:详细信息 List:列表 Tile: |
Columns | “详细信息” 视图中显示的列 |
AllowColumnReorder | 是否允许用户重新排列 ”详细信息“视图中各列的顺序 |
FullRowSelect | 当项被选中时,其所有子项是否同该项一起突出显示 |
GridLines | 在项和子项周围显示网格线。仅在”详细信息“视图中显示 |
HeaderStyle | ”详细信息“视图中列标头的样式:Clickable、NonClickable、None |
AutoArrange | 在 大图标 和小图标 视图中,项是否自动进行排列,默认true |
LargeImageList | 大图标、Tile视图中,用于显示的大图标图像集合(ImageList) |
SmallImageList | 除大图标、Tile视图外所有视图中,用于显示的图标图像集合(ImageList) |
Groups | ListView中的组,集合 |
LabelEdit | 是否允许用户就地编辑项标签 |
labelWrap | 确定标签文本是否可以换到新行 |
MultiSelect | 是否允许选择多项 |
Scrollable | 如果控件包含的项过多,超出工作区的范围时,该控件是否显示滚动条 |
ShowGroups | 指示控件是否以组的形式显示项 |
ShowItemToolTips | 允许ListViewItems显示工具提示 |
Sorting | 对项进行排序的方式:None、Ascending、Descending |
StateImageList | ListView为自定义状态所使用的ImageList控件 |
CheckedIndices | 所有勾选了复选框的项的索引集合 |
CheckedItems | 所有勾选了复选框的项的集合 |
SelectedIndices | 所有选中的项的索引集合 |
SelectedIndex | 所选中的单个项的索引 |
SelectedItems | 所有选定的项 |
3. 方法
方法 | 解释 |
---|---|
BeginUpdate()和 EndUpdate() | 在大量通过Items方法加载项的时候,在加载项的语句前后分别加上 BeginUpdate() 和 EndUpdate() 语句,可以避免控件出现闪烁 |
Clear() | 清空项 |
EnsureVisible | 确保指定项在控件中是可见的,必要时滚动控件内容 |
FindItemWithText | 找到第一个指定文本开头的项 |
FindNearestItem | 按照指定的搜索方向,从指定点开始查找下一个项 |
4. 事件
事件 | 解释 |
---|---|
SelectedIndexChanged | 每当此ListView的 ”SelectedIndex“属性更改时发生 |
ColumnClick | 在单击列标头时发生 |
AfterLabelEdit | 在用户已编辑项文本时发生 |
BeforeLabelEdit | 在用户将要编辑项文本时发生 |
ItemCheck | 指示某项的选中状态将要更改,直到事件发生后,该值才会更新 |
ItemChecked | 当ListView项的Checked属性更改时引发的事件 |
ItemSelectionChanged | 当某项的选定状态更改时引发的事件 |
5. 列的集合的操作
操作 | 方法 |
---|---|
访问列 | 从集合中获取具有指定键值 / 索引值的列标题 |
添加列 | Add方法,可以指定键名,列名,宽度,对齐方式,图标索引 |
列的数量 | Count方法 |
设置列只读 | IsReadOnly方法 |
添加单列 | Add(ColumnHeader value) |
添加多列 | AddRange(ColumnHeader[] values) |
清空所有列 | Clear() |
判断列是否存在 | Contains(ColumnHeader value) ContainsKey(string key) |
获取列的索引 | IndexOf(ColumnHeader value) IndexOfKey(string key) |
插入列 | Insert |
移除列 | Remove(ColumnHeader column) RemoveAt(int index) RemoveByKey(string key) |
6. 项的集合的操作
操作 | 方法 |
---|---|
访问项 | 从集合中获取具有指定键值 / 索引值的项 |
设置项只读 | IsReadOnly |
项的数量 | Count |
添加项 | Add方法,可以指定键名,文本,图标索引/图标键值 |
添加项的集合 | AddRange方法 |
清除项 | Clear方法 |
判断项是否存在 | Contains(ListViewItem item) ContainsKey(string key) |
复制项 | CopyTo(Array dest, int index) |
查找项 | Find(string key, bool searchAllSubItems) |
获取项的索引 | IndexOf(ListViewItem item) IndexOfKey(string key) |
插入项 | Insert,可以设置输入项的索引、键值、文本、图像索引/图像键值 |
移除项 | Remove(ListViewItem item) RemoveAt(int index) RemoveByKey(string key) |
7. 组的集合的操作
操作 | 方法 |
---|---|
访问组 | 通过指定键值 / 索引值访问 |
组的数量 | Count |
添加组 | Add, AddRange |
清除组 | Clear |
判断组是否存在 | Contains(ListViewGroup value) |
复制组 | CopyTo(Array array, int index) |
获取组的索引 | IndexOf(ListViewGroup value) |
插入组 | Insert |
移除组 | Remove(ListViewGroup group) RemoveAt(int index) |
8. 不同的视图
- 拖控件
- 加载图像到 ImageList 组件
private void FrmListView2_Load(object sender, EventArgs e)
{
// 加载 Form 的时候,默认显示 大图标
LoadImgList(); //加载图片
lvList.Items.Clear();
lvList.ShowGroups = false; // 不分组显示
if (largeList != null && largeList.Images.Count > 0)
{
for (int i=0; i<lareList.Images.Count; i++) // 对于 lareList 中的每张图
{
string iText = largeList.Images.Keys[i]; // 图的名字
// 添加ListView控件中的项
ListViewItem li = new ListViewItem();
li.Text = iText;
li.ImageIndex = i;
LvList.Items.Add(li);
}
}
lvList.View = View.LargeIcon; // 指定 大图标显示
lvList.largeImageList = largeList; // 大图标、Tile视图 使用的ImageList
lvList.SmallImageList = smallList; // 除大图标、Tile视图以外,所有视图使用的ImageList
}
Dictionary<int, string> dic = new Dictionary<int, string>;
private void LoadImgList() // 加载图片集合
{
string path = @"D:\课件\录制课件\WF\WFFormUse\WFFormUse\Imgs";
if (Directory.Exists(path))
{
string[] files = Directory.GetFiles(path);
if (files.Length > 0)
{
largeList.Images.Clear();
smallList.Images.Clear();
int index = 0;
string[] fileType = {".jpg", ".png"};
foreach (string fpath in files)
{
if (fileType.Contains(Path.GetExtension(fpath)))
{
Image img = Image.FromFile(fpath);
string key = Path.GetFileNameWithoutExtension(fpath);
largeList.Images.Add(key, img);
smallList.Images.Add(key, img);
dic.Add(index, fpath);
index++;
}
}
// 指定图片尺寸
largeList.ImageSize = new Size(50, 50);
smallList.ImageSize = new Size(20, 20);
}
}
}
-
运行
大图标的样式:最大化图标,下面显示文本标签
-
点击 “大图标”按钮,以大图标的样式显示
- 点击 “小图标”按钮,以小图标的样式显示
小图标的样式:小图标,右边显示文本标签
- 点击 “List”按钮,以列表的样式显示:小图标,右边显示文本标签,各项排列在列中,没有列标头
- 点击 "Tile”按钮,以 Tile 的样式显示:大图标, 关联的是largeList,右边显示文本标签,如果还有其他SubItems信息,也显示在右边
- “详细信息”视图:分列显示,第一列显示小图标,右边显示文本,其他列只显示文本,有列标头
private void btnDetails_Click(object sender, EventArgs e)
{
lvList.Items.Clear();
lvList.Column.Clear();
lvList.ShowGroups = false;
lvList.View = View.Details;
// 列的添加
lvList.Columns.Add("文件名", 100, HorizontalAlignment.Left); // 设置列名,列宽,对齐方式
lvList.Columns.Add("修改日期", 150, HorizontalAlignment.Left);
lvList.Columns.Add("类型", 80, HorizontalAlignment.Left);
lvList.Columns.Add("大小", 60, HorizontalAlignment.Left);
// 项
for (int i = 0; i < dic.Count; i++)
{
ListViewItem li = new ListViewItem();
li.ImageIndex = i;
li.Text = smallList.Images.Keys[i]; // 文件名
li.SubItems.Add(File.getCreationTime(dic[i]).ToString()); // 修改日期
li.SubItems.Add(Path.getExtension(dic[i])); // 类型
long length = new FileInfo(dic[i]).Length; // 获取文件大小,以字节为单位
li.SubItems.Add((length/1024).ToString()); // 文件大小, kb为单位
lvList.Items.Add(li);
}
lvList.GridLines = true; // 显示网格
}
再点击“Tile”按钮时:
- 分组功能
private void btnGroup_Click(object sender, EventArgs e)
{
lvList.ShowGroups = true;
//添加组
lvList.Groups.Clear();
lvList.Groups.Add(new ListViewGroup("花", HorizontalAlignment.Center));
lvList.Groups.Add(new ListViewGroup("动物", HorizontalAlignment.Center));
lvList.Groups.Add(new ListViewGroup("人物", HorizontalAlignment.Center));
lvList.Groups.Add(new ListViewGroup("风景", HorizontalAlignment.Center));
// 组名--图片名称中包含了分组信息
Dictionary<string, string> dicGroup = new Dictionary<string, string>();
dicGroup.Add("花", "04");
dicGroup.Add("动物", "01");
dicGroup.Add("人物", "02");
dicGroup.Add("风景", "03");
// 分组
for (int i = 0; i < lvList.Items.Count; i++)
{
foreach(ListViewGroup lvg in lvList.Groups)
{
// 判断项文本的前两个字符是否与组所对应的编号一致,如果一致,就将该项分到这一组
if (lvList.Items[i].Text.Substring(0,2) == dicGroup[lvg.Header])
{
lvList.Items[i].Group = lvg; // 设置项所属的组
break;
}
}
}
}
运行,点击 “分组显示” 按钮,大图标视图:
小图标视图:
List视图 不支持分组显示
先点 “分组显示” ,再点 “详细信息”,因为点击 “详细信息”的时候,清空了ListView控件中的信息后重新添加项和列的,所以没有分组信息:
先点 “详细信息”,再点 “分组显示”:
Tile视图:
参考:2023年C#之WinForm零基础教程50讲