C# 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 系列支持）

①Details视图：

this.listView1.SmallImageList = this.imageList1;  //将listView的图标集与imageList1绑定

（1）列表头创建（记得，需要先创建列表头）

1. ColumnHeader  ch= new ColumnHeader();
2. nbsp;ch.Text = "列标题1";   //设置列标题
3. ch.Width = 120;    //设置列宽度
4. ch.TextAlign = HorizontalAlignment.Left;   //设置列的对齐方式
5. this.listView1.Columns.Add(ch);   //将列头添加到ListView控件。

1. ColumnHeader  ch= new ColumnHeader();
2. ch.Text = "列标题1";   //设置列标题
3. ch.Width = 120;    //设置列宽度
4. ch.TextAlign = HorizontalAlignment.Left;   //设置列的对齐方式
5. this.listView1.Columns.Add(ch);    //将列头添加到ListView控件。

1. ColumnHeader  ch= new ColumnHeader();
2. ch.Text = "列标题1";   //设置列标题
3. ch.Width = 120;    //设置列宽度
4. ch.TextAlign = HorizontalAlignment.Left;   //设置列的对齐方式
5. this.listView1.Columns.Add(ch);    //将列头添加到ListView控件。

或者

1. this.listView1.Columns.Add("列标题1", 120,  HorizontalAlignment.Left);//一步添加

1. this.listView1.Columns.Add("列标题1", 120,  HorizontalAlignment.Left); //一步添加

1. this.listView1.Columns.Add("列标题1", 120,  HorizontalAlignment.Left); //一步添加

（2）添加数据项

1. this.listView1.BeginUpdate();  //数据更新，UI暂时挂起，直到EndUpdate绘制控件，可以有效避免闪烁并大大提高加载速度
2. for (int i = 0; i < 10; i++)  //添加10行数据
3. {
4. ListViewItem lvi = new ListViewItem();
5. lvi.ImageIndex = i;     //通过与imageList绑定，显示imageList中第i项图标
6. lvi.Text = "subitem" + i;
7. lvi.SubItems.Add("第2列,第"+i+"行");
8. lvi.SubItems.Add("第3列,第"+i+"行");
9. this.listView1.Items.Add(lvi);
10. }
11. this.listView1.EndUpdate();  //结束数据处理，UI界面一次性绘制。

1. this.listView1.BeginUpdate();   //数据更新，UI暂时挂起，直到EndUpdate绘制控件，可以有效避免闪烁并大大提高加载速度
2. for (int i = 0; i < 10; i++)   //添加10行数据
3. {
4. ListViewItem lvi = new ListViewItem();
5. lvi.ImageIndex = i;     //通过与imageList绑定，显示imageList中第i项图标
6. lvi.Text = "subitem" + i;
7. lvi.SubItems.Add("第2列,第"+i+"行");
8. lvi.SubItems.Add("第3列,第"+i+"行");
9. this.listView1.Items.Add(lvi);
10. }
11. this.listView1.EndUpdate();  //结束数据处理，UI界面一次性绘制。

1. this.listView1.BeginUpdate();   //数据更新，UI暂时挂起，直到EndUpdate绘制控件，可以有效避免闪烁并大大提高加载速度
2. for (int i = 0; i < 10; i++)   //添加10行数据
3. {
4. ListViewItem lvi = new ListViewItem();
5. lvi.ImageIndex = i;     //通过与imageList绑定，显示imageList中第i项图标
6. lvi.Text = "subitem" + i;
7. lvi.SubItems.Add("第2列,第"+i+"行");
8. lvi.SubItems.Add("第3列,第"+i+"行");
9. this.listView1.Items.Add(lvi);
10. }
11. this.listView1.EndUpdate();  //结束数据处理，UI界面一次性绘制。

（3）显示项

1. foreach (ListViewItem itemin this.listView1.Items)
2. {
3. for (int i = 0; i < item.SubItems.Count; i++)
4. {
5. MessageBox.Show(item.SubItems[i].Text);
6. }
7. }

1. foreach (ListViewItem item in this.listView1.Items)
2. {
3. for (int i = 0; i < item.SubItems.Count; i++)
4. {
5. MessageBox.Show(item.SubItems[i].Text);
6. }
7. }

1. foreach (ListViewItem item in this.listView1.Items)
2. {
3. for (int i = 0; i < item.SubItems.Count; i++)
4. {
5. MessageBox.Show(item.SubItems[i].Text);
6. }
7. }

（4）移除某项

1. foreach (ListViewItem lviin listView1.SelectedItems)  //选中项遍历
2. {
3. listView1.Items.RemoveAt(lvi.Index); // 按索引移除
4. //listView1.Items.Remove(lvi);   //按项移除
5. }

1. foreach (ListViewItem lvi in listView1.SelectedItems)  //选中项遍历
2. {
3. listView1.Items.RemoveAt(lvi.Index); // 按索引移除
4. //listView1.Items.Remove(lvi);   //按项移除
5. }

1. foreach (ListViewItem lvi in listView1.SelectedItems)  //选中项遍历
2. {
3. listView1.Items.RemoveAt(lvi.Index); // 按索引移除
4. //listView1.Items.Remove(lvi);   //按项移除
5. }

（5）行高设置（利用imageList实现）

1. ImageList imgList = new ImageList();
2. imgList.ImageSize = new Size(1, 20);// 设置行高 20 //分别是宽和高
3. listView1.SmallImageList = imgList; //这里设置listView的SmallImageList ,用imgList将其撑大

1. ImageList imgList = new ImageList();
2. imgList.ImageSize = new Size(1, 20);// 设置行高 20 //分别是宽和高
3. listView1.SmallImageList = imgList; //这里设置listView的SmallImageList ,用imgList将其撑大

1. ImageList imgList = new ImageList();
2. imgList.ImageSize = new Size(1, 20);// 设置行高 20 //分别是宽和高
3. listView1.SmallImageList = imgList; //这里设置listView的SmallImageList ,用imgList将其撑大

（6）清空

1. this.listView1.Clear(); //从控件中移除所有项和列（包括列表头）。
2. this.listView1.Items.Clear(); //只移除所有的项。

1. this.listView1.Clear();  //从控件中移除所有项和列（包括列表头）。
2. this.listView1.Items.Clear();  //只移除所有的项。

1. this.listView1.Clear();  //从控件中移除所有项和列（包括列表头）。
2. this.listView1.Items.Clear();  //只移除所有的项。

运行效果：

②largeIcon视图：

1. this.listView1.View = View.LargeIcon;
2. this.listView1.LargeImageList =this.imageList2;
3. this.listView1.BeginUpdate();
4. for (int i = 0; i < 10; i++)
5. {
6. ListViewItem lvi = new ListViewItem();
7. lvi.ImageIndex = i;
8. lvi.Text = "item" + i;
9. this.listView1.Items.Add(lvi);
10. }
11. this.listView1.EndUpdate();

1. this.listView1.View = View.LargeIcon;
2. this.listView1.LargeImageList = this.imageList2;
3. this.listView1.BeginUpdate();
4. for (int i = 0; i < 10; i++)
5. {
6. ListViewItem lvi = new ListViewItem();
7. lvi.ImageIndex = i;
8. lvi.Text = "item" + i;
9. this.listView1.Items.Add(lvi);
10. }
11. this.listView1.EndUpdate();

1. this.listView1.View = View.LargeIcon;
2. this.listView1.LargeImageList = this.imageList2;
3. this.listView1.BeginUpdate();
4. for (int i = 0; i < 10; i++)
5. {
6. ListViewItem lvi = new ListViewItem();
7. lvi.ImageIndex = i;
8. lvi.Text = "item" + i;
9. this.listView1.Items.Add(lvi);
10. }
11. this.listView1.EndUpdate();

运行效果：

③SmallIcon视图：

1. this.listView1.View = View.SmallIcon;
2. this.listView1.SmallImageList=this.imageList1;
3. this.listView1.BeginUpdate();
4. for (int i = 0; i < 10; i++)
5. {
6. ListViewItem lvi = new ListViewItem();
7. lvi.ImageIndex = i;
8. lvi.Text = "item" + i;
9. this.listView1.Items.Add(lvi);
10. }
11. this.listView1.EndUpdate();

1. this.listView1.View = View.SmallIcon;
2. this.listView1.SmallImageList= this.imageList1;
3. this.listView1.BeginUpdate();
4. for (int i = 0; i < 10; i++)
5. {
6. ListViewItem lvi = new ListViewItem();
7. lvi.ImageIndex = i;
8. lvi.Text = "item" + i;
9. this.listView1.Items.Add(lvi);
10. }
11. this.listView1.EndUpdate();

1. this.listView1.View = View.SmallIcon;
2. this.listView1.SmallImageList= this.imageList1;
3. this.listView1.BeginUpdate();
4. for (int i = 0; i < 10; i++)
5. {
6. ListViewItem lvi = new ListViewItem();
7. lvi.ImageIndex = i;
8. lvi.Text = "item" + i;
9. this.listView1.Items.Add(lvi);
10. }
11. this.listView1.EndUpdate();

运行效果：

④List视图：

1. this.listView1.View = View.List;
2. this.listView1.SmallImageList=this.imageList1;
3. this.listView1.BeginUpdate();
4. for (int i = 0; i < 10; i++)
5. {
6. ListViewItem lvi = new ListViewItem();
7. lvi.ImageIndex = i;
8. lvi.Text = "item" + i;
9. this.listView1.Items.Add(lvi);
10. }
11. this.listView1.EndUpdate();

1. this.listView1.View = View.List;
2. this.listView1.SmallImageList= this.imageList1;
3. this.listView1.BeginUpdate();
4. for (int i = 0; i < 10; i++)
5. {
6. ListViewItem lvi = new ListViewItem();
7. lvi.ImageIndex = i;
8. lvi.Text = "item" + i;
9. this.listView1.Items.Add(lvi);
10. }
11. this.listView1.EndUpdate();

1. this.listView1.View = View.List;
2. this.listView1.SmallImageList= this.imageList1;
3. this.listView1.BeginUpdate();
4. for (int i = 0; i < 10; i++)
5. {
6. ListViewItem lvi = new ListViewItem();
7. lvi.ImageIndex = i;
8. lvi.Text = "item" + i;
9. this.listView1.Items.Add(lvi);
10. }
11. this.listView1.EndUpdate();

运行效果：

     三、其它应用

1、分组：

1. ListViewGroup man_lvg = new ListViewGroup(); //创建男生分组
2. man_lvg.Header = "男生";  //设置组的标题。
3. //man_lvg.Name = "man";   //设置组的名称。
4. man_lvg.HeaderAlignment = HorizontalAlignment.Left;   //设置组标题文本的对齐方式。（默认为Left）
5. ListViewGroup women_lvg = new ListViewGroup(); //创建女生分组
6. women_lvg.Header = "女生";
7. //women_lvg.Name = "women";
8. women_lvg.HeaderAlignment = HorizontalAlignment.Center;   //组标题居中对齐
9. this.listView1.Groups.Add(man_lvg);   //把男生分组添加到listview中
10. this.listView1.Groups.Add(women_lvg);  //把男生分组添加到listview中
11. this.listView1.ShowGroups =true;  //记得要设置ShowGroups属性为true（默认是false），否则显示不出分组
12. for (int i = 0; i < 5; i++)
13. {
14. ListViewItem lvi = new ListViewItem();
15. lvi.ImageIndex = i;
16. lvi.Text = "item"+i;
17. lvi.ForeColor = Color.Blue;  //设置行颜色
18. lvi.SubItems.Add("第2列,第"+i+"行");
19. lvi.SubItems.Add("第3列,第"+i+"行");
20. man_lvg.Items.Add(lvi);   //分组添加子项
21. // 或 lvi.Group = man_lvg;  //分组添加子项
22. this.listView1.Items.Add(lvi);
23. }

1. ListViewGroup man_lvg = new ListViewGroup();  //创建男生分组
2. man_lvg.Header = "男生";  //设置组的标题。
3. //man_lvg.Name = "man";   //设置组的名称。
4. man_lvg.HeaderAlignment = HorizontalAlignment.Left;   //设置组标题文本的对齐方式。（默认为Left）
5. ListViewGroup women_lvg = new ListViewGroup();  //创建女生分组
6. women_lvg.Header = "女生";
7. //women_lvg.Name = "women";
8. women_lvg.HeaderAlignment = HorizontalAlignment.Center;   //组标题居中对齐
9. this.listView1.Groups.Add(man_lvg);    //把男生分组添加到listview中
10. this.listView1.Groups.Add(women_lvg);   //把男生分组添加到listview中
11. this.listView1.ShowGroups = true;  //记得要设置ShowGroups属性为true（默认是false），否则显示不出分组
12. for (int i = 0; i < 5; i++)
13. {
14. ListViewItem lvi = new ListViewItem();
15. lvi.ImageIndex = i;
16. lvi.Text = "item"+i;
17. lvi.ForeColor = Color.Blue;  //设置行颜色
18. lvi.SubItems.Add("第2列,第"+i+"行");
19. lvi.SubItems.Add("第3列,第"+i+"行");
20. man_lvg.Items.Add(lvi);   //分组添加子项
21. // 或 lvi.Group = man_lvg;  //分组添加子项
22. this.listView1.Items.Add(lvi);
23. }

1. ListViewGroup man_lvg = new ListViewGroup();  //创建男生分组
2. man_lvg.Header = "男生";  //设置组的标题。
3. //man_lvg.Name = "man";   //设置组的名称。
4. man_lvg.HeaderAlignment = HorizontalAlignment.Left;   //设置组标题文本的对齐方式。（默认为Left）
5. ListViewGroup women_lvg = new ListViewGroup();  //创建女生分组
6. women_lvg.Header = "女生";
7. //women_lvg.Name = "women";
8. women_lvg.HeaderAlignment = HorizontalAlignment.Center;   //组标题居中对齐
9. this.listView1.Groups.Add(man_lvg);    //把男生分组添加到listview中
10. this.listView1.Groups.Add(women_lvg);   //把男生分组添加到listview中
11. this.listView1.ShowGroups = true;  //记得要设置ShowGroups属性为true（默认是false），否则显示不出分组
12. for (int i = 0; i < 5; i++)
13. {
14. ListViewItem lvi = new ListViewItem();
15. lvi.ImageIndex = i;
16. lvi.Text = "item"+i;
17. lvi.ForeColor = Color.Blue;  //设置行颜色
18. lvi.SubItems.Add("第2列,第"+i+"行");
19. lvi.SubItems.Add("第3列,第"+i+"行");
20. man_lvg.Items.Add(lvi);   //分组添加子项
21. // 或 lvi.Group = man_lvg;  //分组添加子项
22. this.listView1.Items.Add(lvi);
23. }

运行效果:

2、查找文本（只能查找到匹配前缀的文本且只能找出第一个符合的项）：

1. ListViewItem foundItem= this.listView1.FindItemWithText(this.textBox1.Text,true,0);   //参数1：要查找的文本；参数2：是否子项也要查找；参数3：开始查找位置
2. if (foundItem != null)
3. {
4. this.listView1.TopItem = foundItem; //定位到该项
5. foundItem.ForeColor = Color.Red;
6. }

二、

1.定义

 

把它拽进来，系统会自动在Designer.cs里添加一个  this.listView1 = new System.Windows.Forms.ListView();

 

2.初始化，确定模式，确定列

 

 

InitializeComponent()里系统首先自动完成对它的初始化操作

而用户自定义的初始化操作我建议写在Form构造函数里跟在InitializeComponent()后面。

原因是一旦listView有变动，系统自动调整InitializeComponent()内容，可能会自动删除掉用户写的部分。

 

 

this.listView1.Columns.Add("学生序号");

this.listView1.Columns.Add("学生姓名");

this.listView1.Columns.Add("学生学号");

 

这些是主要的，确定一共几个列

 

this.listView1.View = System.Windows.Forms.View.Details;

如果不写这句，那么加的列压根显示不出来。必须写。

 

我们先研究Details模式下的ListView用法，要这样对listView的View属性赋值。

 

很多教程都直接写this.listView1.View =View.Details;

 

尽管using System.Windows.Forms 但不管用。还是写全吧。

 

System.Windows.Forms.View是个枚举 public enum View;

 

LargeIcon 每个项都显示为一个最大化图标，在它的下面有一个标签。

Details 每个项显示在不同的行上，并带有关于列中所排列的各项的进一步信息。最左边的列包含一个小图标和标签，后面的列包含应用程序指定的子项。列显示一个标头，它可以显示列的标题。用户可以在运行时调整各列的大小。

SmallIcon 每个项都显示为一个小图标，在它的右边带一个标签。

List 每个项都显示为一个小图标，在它的右边带一个标签。各项排列在列中，没有列标头。

Tile 每个项都显示为一个完整大小的图标，在它的右边带项标签和子项信息。显示的子项信息由应用程序指定。此视图仅在下面的平台上受支持：Windows XP 和 Windows Server 2003 系列。在之前的操作系统上，此值被忽略，并且 ListView 控件在 LargeIcon 视图中显示。

 

 

 

 

listView1.FullRowSelect = true;

this.listView1.GridLines = true;

listView1.LabelEdit = true;

// Allow the user to rearrange columns.

listView1.AllowColumnReorder = true;

// Display check boxes.

listView1.CheckBoxes = true;

listView1.Sorting = SortOrder.Ascending;

//Create three items and three sets of subitems for each item.

 

另外还有很多自定义属性可以配，什么选中啦，线条啦，自己试试吧

 

 

默认的列宽不大，标题头显示总不全

 

listView1.Columns[0].Width = 100;
listView1.Columns[1].Width = 100;

 

Columns数组本身可以引用每个列

 

 

3. 增加行

 

 

增加行操作主要分成两种，一种是直接字符串添加，一种是借助ListViewItem对象添加

 

 

一.直接添加法

 

this.listView1.Items.Add("A1");  

这是指给这个控件表添加一个新的行，同时把新行的第一列数据设为A1,此时这个新行内的元素集合就是this.listView1.Item[0]

this.listView1.Items[0].SubItems.Add("A2");

这是给刚添加的第一行，也就是this.listView1.Item[0]添加第二列数据A2.如果说Items在行的层次增加，Item[i].SubItems才真正对应单元格操作。

this.listView1.Items[0].SubItems.Add("A3");

 

此时第一行添加工作结束，白叔叔告你，第一行内容为 A1---A2---A3

 

this.listView1.Items.Add("B1");  此时再Add，相当于加了第二行数据，同时添加了第二行第一列的单元格内容。

this.listView1.Items[1].SubItems.Add("B2"); Items表示行，所以第二行就是Items[1]，行标从0起始。

this.listView1.Items[1].SubItems.Add("B3");

 

第二行结束，内容B1---B2---B3

 

 

二.ListViewItem间接添加法。

 

方法是先创建一个行对象

再把这个行对象添加给this.listView1.Items

 

 

ListViewItem li的初始化又有两种方法，大同小异

 

一种是

 

ListViewItem li=new ListViewItem("A1");

 

另一种是

 

ListViewItem li=new ListViewItem();

li.Text="A1";

 

作用是相同的，白叔叔不骗你。

 

都是初始化一个“行对象”，同时把这个行对象的第一列单元格初始化为"A1"

 

li.SubItems.Add("abc");

li.SubItems.Add("cde");

 

然后把第二列和第三列内容加上。

 

this.listView1.Items.Add(li); 这句话在前几句话之前也行，之后也行

 

可以先加进listView再添加子项，也可以都加全了子项再加进listView

 

li可以复用，不断初始化成新的行进行添加。

 

 

 

关于项的选取和数据的采集

 

首先，现阶段ListView项的选取分成两类

一种是用左键选取，适用的方法是SelectedItems和SelectedIndices

另一种是通过复选框勾选的选取CheckedItems我没用过，暂时不讨论，但事实上类同第一种

左键选取

1.首先要判断有没有项被选中变蓝，如果不判断那么用到SelectedItem[i]时会因为没有合适结果报错。

 if (this.listView1.SelectedItems.Count > 0)

2.  SelectedItems是获取选中的行的集合，也就是说支持多行选择，它是多行的集合。

this.textBox2.Text = this.listView1.SelectedItems[0].Text;

这里的索引[0]并不是指原列表的第一行，而是将全体被选中行当做一个集合，在被选中行中的第一被选行。

此时返回的是该行第一列的单元格内容。

this.textBox2.Text = this.listView1.SelectedItems[0].SubItems[0].Text;

用SubItems[0]两者得到的结果是一样的，也是第一被选行的第一列。

this.textBox2.Text = this.listView1.SelectedItems[0].SubItems[1].Text;

上面是第一被选行的第二列，以此类推。

3.  SelectedIndices是返回选中行的索引值int

this.listView1.SelectedIndices[i]也是将选中行当做整体，用i去定位。

 

如果只对选取单行做获取判断listView1.FocusedItem.Text估计效率更高