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）列表头创建（记得，需要先创建列表头）       

ColumnHeader  ch= new ColumnHeader();

nbsp;ch.Text = "列标题1";   //设置列标题

ch.Width = 120;    //设置列宽度

ch.TextAlign = HorizontalAlignment.Left;   //设置列的对齐方式

this.listView1.Columns.Add(ch);   //将列头添加到ListView控件。

ColumnHeader  ch= new ColumnHeader();

ch.Text = "列标题1";   //设置列标题

ch.Width = 120;    //设置列宽度

ch.TextAlign = HorizontalAlignment.Left;   //设置列的对齐方式

this.listView1.Columns.Add(ch);    //将列头添加到ListView控件。

ColumnHeader  ch= new ColumnHeader();

ch.Text = "列标题1";   //设置列标题

ch.Width = 120;    //设置列宽度

ch.TextAlign = HorizontalAlignment.Left;   //设置列的对齐方式

this.listView1.Columns.Add(ch);    //将列头添加到ListView控件。

                          或者

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

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

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

       （2）添加数据项       

this.listView1.BeginUpdate();  //数据更新，UI暂时挂起，直到EndUpdate绘制控件，可以有效避免闪烁并大大提高加载速度

for (int i = 0; i < 10; i++)  //添加10行数据
{
     ListViewItem lvi = new ListViewItem();

     lvi.ImageIndex = i;     //通过与imageList绑定，显示imageList中第i项图标

     lvi.Text = "subitem" + i;

     lvi.SubItems.Add("第2列,第"+i+"行");

     lvi.SubItems.Add("第3列,第"+i+"行");

     this.listView1.Items.Add(lvi);
}

this.listView1.EndUpdate();  //结束数据处理，UI界面一次性绘制。

this.listView1.BeginUpdate();   //数据更新，UI暂时挂起，直到EndUpdate绘制控件，可以有效避免闪烁并大大提高加载速度

for (int i = 0; i < 10; i++)   //添加10行数据
{
    ListViewItem lvi = new ListViewItem();

    lvi.ImageIndex = i;     //通过与imageList绑定，显示imageList中第i项图标

    lvi.Text = "subitem" + i;

    lvi.SubItems.Add("第2列,第"+i+"行");

    lvi.SubItems.Add("第3列,第"+i+"行");

    this.listView1.Items.Add(lvi);
}

this.listView1.EndUpdate();  //结束数据处理，UI界面一次性绘制。

this.listView1.BeginUpdate();   //数据更新，UI暂时挂起，直到EndUpdate绘制控件，可以有效避免闪烁并大大提高加载速度

for (int i = 0; i < 10; i++)   //添加10行数据
{
    ListViewItem lvi = new ListViewItem();

    lvi.ImageIndex = i;     //通过与imageList绑定，显示imageList中第i项图标

    lvi.Text = "subitem" + i;

    lvi.SubItems.Add("第2列,第"+i+"行");

    lvi.SubItems.Add("第3列,第"+i+"行");

    this.listView1.Items.Add(lvi);
}

this.listView1.EndUpdate();  //结束数据处理，UI界面一次性绘制。

          （3）显示项

foreach (ListViewItem itemin this.listView1.Items)
{
      for (int i = 0; i < item.SubItems.Count; i++)
      {
          MessageBox.Show(item.SubItems[i].Text);
      }
}

foreach (ListViewItem item in this.listView1.Items)
{
      for (int i = 0; i < item.SubItems.Count; i++)
      {
          MessageBox.Show(item.SubItems[i].Text);
      }
}

foreach (ListViewItem item in this.listView1.Items)
{
      for (int i = 0; i < item.SubItems.Count; i++)
      {
          MessageBox.Show(item.SubItems[i].Text);
      }
}

           （4）移除某项

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

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

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

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

ImageList imgList = new ImageList();

imgList.ImageSize = new Size(1, 20);// 设置行高 20 //分别是宽和高

listView1.SmallImageList = imgList; //这里设置listView的SmallImageList ,用imgList将其撑大

ImageList imgList = new ImageList();

imgList.ImageSize = new Size(1, 20);// 设置行高 20 //分别是宽和高

listView1.SmallImageList = imgList; //这里设置listView的SmallImageList ,用imgList将其撑大

ImageList imgList = new ImageList();

imgList.ImageSize = new Size(1, 20);// 设置行高 20 //分别是宽和高

listView1.SmallImageList = imgList; //这里设置listView的SmallImageList ,用imgList将其撑大

          （6）清空

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

this.listView1.Items.Clear(); //只移除所有的项。

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

this.listView1.Items.Clear();  //只移除所有的项。

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

this.listView1.Items.Clear();  //只移除所有的项。

 

运行效果：

        ②largeIcon视图：

this.listView1.View = View.LargeIcon;

this.listView1.LargeImageList =this.imageList2;

this.listView1.BeginUpdate();

for (int i = 0; i < 10; i++)
{
      ListViewItem lvi = new ListViewItem();

      lvi.ImageIndex = i;

      lvi.Text = "item" + i;

      this.listView1.Items.Add(lvi);
}

this.listView1.EndUpdate();

this.listView1.View = View.LargeIcon;

this.listView1.LargeImageList = this.imageList2;

this.listView1.BeginUpdate();

 for (int i = 0; i < 10; i++)
 {
      ListViewItem lvi = new ListViewItem();

      lvi.ImageIndex = i;

      lvi.Text = "item" + i;

      this.listView1.Items.Add(lvi);
 }

 this.listView1.EndUpdate();

this.listView1.View = View.LargeIcon;

this.listView1.LargeImageList = this.imageList2;

this.listView1.BeginUpdate();

 for (int i = 0; i < 10; i++)
 {
      ListViewItem lvi = new ListViewItem();

      lvi.ImageIndex = i;

      lvi.Text = "item" + i;

      this.listView1.Items.Add(lvi);
 }

 this.listView1.EndUpdate();

运行效果：

          ③SmallIcon视图：

this.listView1.View = View.SmallIcon;

this.listView1.SmallImageList=this.imageList1;

this.listView1.BeginUpdate();

for (int i = 0; i < 10; i++)
{
     ListViewItem lvi = new ListViewItem();

      lvi.ImageIndex = i;

      lvi.Text = "item" + i;

      this.listView1.Items.Add(lvi);
}

this.listView1.EndUpdate();

this.listView1.View = View.SmallIcon;

this.listView1.SmallImageList= this.imageList1;

this.listView1.BeginUpdate();

for (int i = 0; i < 10; i++)
{
     ListViewItem lvi = new ListViewItem();

      lvi.ImageIndex = i;

      lvi.Text = "item" + i;

      this.listView1.Items.Add(lvi);
}

this.listView1.EndUpdate();

this.listView1.View = View.SmallIcon;

this.listView1.SmallImageList= this.imageList1;

this.listView1.BeginUpdate();

for (int i = 0; i < 10; i++)
{
     ListViewItem lvi = new ListViewItem();

      lvi.ImageIndex = i;

      lvi.Text = "item" + i;

      this.listView1.Items.Add(lvi);
}

this.listView1.EndUpdate();

运行效果：

           ④List视图：   

this.listView1.View = View.List;

this.listView1.SmallImageList=this.imageList1;

this.listView1.BeginUpdate();

for (int i = 0; i < 10; i++)
{
     ListViewItem lvi = new ListViewItem();

     lvi.ImageIndex = i;

     lvi.Text = "item" + i;

     this.listView1.Items.Add(lvi);
}

this.listView1.EndUpdate();

this.listView1.View = View.List;

this.listView1.SmallImageList= this.imageList1;

this.listView1.BeginUpdate();

for (int i = 0; i < 10; i++)
{
     ListViewItem lvi = new ListViewItem();

     lvi.ImageIndex = i;

     lvi.Text = "item" + i;

     this.listView1.Items.Add(lvi);
}

this.listView1.EndUpdate();

this.listView1.View = View.List;

this.listView1.SmallImageList= this.imageList1;

this.listView1.BeginUpdate();

for (int i = 0; i < 10; i++)
{
     ListViewItem lvi = new ListViewItem();

     lvi.ImageIndex = i;

     lvi.Text = "item" + i;

     this.listView1.Items.Add(lvi);
}

this.listView1.EndUpdate();

运行效果：

 

 

     三、其它应用

         1、分组：      

ListViewGroup man_lvg = new ListViewGroup(); //创建男生分组

man_lvg.Header = "男生";  //设置组的标题。

//man_lvg.Name = "man";   //设置组的名称。

man_lvg.HeaderAlignment = HorizontalAlignment.Left;   //设置组标题文本的对齐方式。（默认为Left）

ListViewGroup women_lvg = new ListViewGroup(); //创建女生分组

women_lvg.Header = "女生";

//women_lvg.Name = "women";

women_lvg.HeaderAlignment = HorizontalAlignment.Center;   //组标题居中对齐

this.listView1.Groups.Add(man_lvg);   //把男生分组添加到listview中

this.listView1.Groups.Add(women_lvg);  //把男生分组添加到listview中

this.listView1.ShowGroups =true;  //记得要设置ShowGroups属性为true（默认是false），否则显示不出分组

for (int i = 0; i < 5; i++)
{
     ListViewItem lvi = new ListViewItem();

     lvi.ImageIndex = i;

     lvi.Text = "item"+i;

     lvi.ForeColor = Color.Blue;  //设置行颜色

     lvi.SubItems.Add("第2列,第"+i+"行");

     lvi.SubItems.Add("第3列,第"+i+"行");

     man_lvg.Items.Add(lvi);   //分组添加子项

     // 或 lvi.Group = man_lvg;  //分组添加子项

     this.listView1.Items.Add(lvi);
}

 ListViewGroup man_lvg = new ListViewGroup();  //创建男生分组

 man_lvg.Header = "男生";  //设置组的标题。

 //man_lvg.Name = "man";   //设置组的名称。

 man_lvg.HeaderAlignment = HorizontalAlignment.Left;   //设置组标题文本的对齐方式。（默认为Left）

 ListViewGroup women_lvg = new ListViewGroup();  //创建女生分组

 women_lvg.Header = "女生";

 //women_lvg.Name = "women";

 women_lvg.HeaderAlignment = HorizontalAlignment.Center;   //组标题居中对齐

 this.listView1.Groups.Add(man_lvg);    //把男生分组添加到listview中

 this.listView1.Groups.Add(women_lvg);   //把男生分组添加到listview中

 this.listView1.ShowGroups = true;  //记得要设置ShowGroups属性为true（默认是false），否则显示不出分组

 for (int i = 0; i < 5; i++)
 {
     ListViewItem lvi = new ListViewItem();

     lvi.ImageIndex = i;

     lvi.Text = "item"+i;

     lvi.ForeColor = Color.Blue;  //设置行颜色

     lvi.SubItems.Add("第2列,第"+i+"行");

     lvi.SubItems.Add("第3列,第"+i+"行");

     man_lvg.Items.Add(lvi);   //分组添加子项

     // 或 lvi.Group = man_lvg;  //分组添加子项

     this.listView1.Items.Add(lvi);
}

 ListViewGroup man_lvg = new ListViewGroup();  //创建男生分组

 man_lvg.Header = "男生";  //设置组的标题。

 //man_lvg.Name = "man";   //设置组的名称。

 man_lvg.HeaderAlignment = HorizontalAlignment.Left;   //设置组标题文本的对齐方式。（默认为Left）

 ListViewGroup women_lvg = new ListViewGroup();  //创建女生分组

 women_lvg.Header = "女生";

 //women_lvg.Name = "women";

 women_lvg.HeaderAlignment = HorizontalAlignment.Center;   //组标题居中对齐

 this.listView1.Groups.Add(man_lvg);    //把男生分组添加到listview中

 this.listView1.Groups.Add(women_lvg);   //把男生分组添加到listview中

 this.listView1.ShowGroups = true;  //记得要设置ShowGroups属性为true（默认是false），否则显示不出分组

 for (int i = 0; i < 5; i++)
 {
     ListViewItem lvi = new ListViewItem();

     lvi.ImageIndex = i;

     lvi.Text = "item"+i;

     lvi.ForeColor = Color.Blue;  //设置行颜色

     lvi.SubItems.Add("第2列,第"+i+"行");

     lvi.SubItems.Add("第3列,第"+i+"行");

     man_lvg.Items.Add(lvi);   //分组添加子项

     // 或 lvi.Group = man_lvg;  //分组添加子项

     this.listView1.Items.Add(lvi);
}

运行效果:

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

[csharp] view plaincopyprint?

 

 

 

ListViewItem foundItem= this.listView1.FindItemWithText(this.textBox1.Text,true,0);   //参数1：要查找的文本；参数2：是否子项也要查找；参数3：开始查找位置

if (foundItem != null)
{

   this.listView1.TopItem = foundItem; //定位到该项

   foundItem.ForeColor = Color.Red;
}

 

二、

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估计效率更高