ListView.ColumnHeaderCollection 类

参考

定义

命名空间:: System.Windows.Forms

程序集:: System.Windows.Forms.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

表示 ListView 控件中的列标题的集合。

public: ref class ListView::ColumnHeaderCollection : System::Collections::IList

public class ListView.ColumnHeaderCollection : System.Collections.IList

[System.ComponentModel.ListBindable(false)]
public class ListView.ColumnHeaderCollection : System.Collections.IList

type ListView.ColumnHeaderCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

[<System.ComponentModel.ListBindable(false)>]
type ListView.ColumnHeaderCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public Class ListView.ColumnHeaderCollection
Implements IList

继承: Object
ListView.ColumnHeaderCollection

属性: ListBindableAttribute

实现: ICollection IEnumerable IList

示例

下面的代码示例创建一个窗体，该窗体包含一个 ListView 控件，该控件在单击控件中的 ListView 列时手动对项进行排序。该示例定义一个名为 ListViewItemComparer 的类， System.Collections.IComparer 该类实现执行比较的 ListViewItem 接口。该示例创建的 ListViewItemComparer 实例，并使用它来设置 ListViewItemSorter 控件的 ListView 属性。 Sort事件处理程序中ColumnClick的方法调用使用中ListViewItemComparer定义的方法根据单击的列执行项的排序。

#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;
using namespace System::Drawing;
using namespace System::Collections;

// Implements the manual sorting of items by columns.
ref class ListViewItemComparer: public IComparer
{
private:
   int col;

public:
   ListViewItemComparer()
   {
      col = 0;
   }

   ListViewItemComparer( int column )
   {
      col = column;
   }

   virtual int Compare( Object^ x, Object^ y )
   {
      return String::Compare( (dynamic_cast<ListViewItem^>(x))->SubItems[ col ]->Text,
                              (dynamic_cast<ListViewItem^>(y))->SubItems[ col ]->Text );
   }
};

public ref class ListViewSortForm: public Form
{
private:
   ListView^ listView1;

public:
   ListViewSortForm()
   {
      // Create ListView items to add to the control.
      array<String^>^temp0 = {"Banana","a","b","c"};
      ListViewItem^ listViewItem1 = gcnew ListViewItem( temp0,-1,Color::Empty,Color::Yellow,nullptr );
      array<String^>^temp1 = {"Cherry","v","g","t"};
      ListViewItem^ listViewItem2 = gcnew ListViewItem( temp1,-1,Color::Empty,Color::Red,
                 gcnew System::Drawing::Font( "Microsoft Sans Serif",8.25F,FontStyle::Regular,GraphicsUnit::Point,0 ) );
      array<String^>^temp2 = {"Apple","h","j","n"};
      ListViewItem^ listViewItem3 = gcnew ListViewItem( temp2,-1,Color::Empty,Color::Lime,nullptr );
      array<String^>^temp3 = {"Pear","y","u","i"};
      ListViewItem^ listViewItem4 = gcnew ListViewItem( temp3,-1,Color::Empty,Color::FromArgb( 192, 128, 156 ),nullptr );

      //Initialize the ListView control and add columns to it.
      this->listView1 = gcnew ListView;

      // Set the initial sorting type for the ListView.
      this->listView1->Sorting = SortOrder::None;

      // Disable automatic sorting to enable manual sorting.
      this->listView1->View = View::Details;

      // Add columns and set their text.
      this->listView1->Columns->Add( gcnew ColumnHeader );
      this->listView1->Columns[ 0 ]->Text = "Column 1";
      this->listView1->Columns[ 0 ]->Width = 100;
      listView1->Columns->Add( gcnew ColumnHeader );
      listView1->Columns[ 1 ]->Text = "Column 2";
      listView1->Columns->Add( gcnew ColumnHeader );
      listView1->Columns[ 2 ]->Text = "Column 3";
      listView1->Columns->Add( gcnew ColumnHeader );
      listView1->Columns[ 3 ]->Text = "Column 4";

      // Suspend control logic until form is done configuring form.
      this->SuspendLayout();

      // Add Items to the ListView control.
      array<ListViewItem^>^temp4 = {listViewItem1,listViewItem2,listViewItem3,listViewItem4};
      this->listView1->Items->AddRange( temp4 );

      // Set the location and size of the ListView control.
      this->listView1->Location = Point(10,10);
      this->listView1->Name = "listView1";
      this->listView1->Size = System::Drawing::Size( 300, 100 );
      this->listView1->TabIndex = 0;

      // Enable editing of the items in the ListView.
      this->listView1->LabelEdit = true;

      // Connect the ListView::ColumnClick event to the ColumnClick event handler.
      this->listView1->ColumnClick += gcnew ColumnClickEventHandler( this, &ListViewSortForm::ColumnClick );

      // Initialize the form.
      this->ClientSize = System::Drawing::Size( 400, 400 );
      array<Control^>^temp5 = {this->listView1};
      this->Controls->AddRange( temp5 );
      this->Name = "ListViewSortForm";
      this->Text = "Sorted ListView Control";

      // Resume lay[Out] of* the form.
      this->ResumeLayout( false );
   }

private:

   // ColumnClick event handler.
   void ColumnClick( Object^ /*o*/, ColumnClickEventArgs^ e )
   {
      // Set the ListViewItemSorter property to a new ListViewItemComparer 
      // object. Setting this property immediately sorts the 
      // ListView using the ListViewItemComparer object.
      this->listView1->ListViewItemSorter = gcnew ListViewItemComparer( e->Column );
   }
};

[System::STAThreadAttribute]
int main()
{
   Application::Run( gcnew ListViewSortForm );
}

using System;
using System.Windows.Forms;
using System.Drawing;
using System.Collections;

namespace ListViewSortFormNamespace
{

    public class ListViewSortForm : Form
    {
        private ListView listView1;
       
        public ListViewSortForm()
        {
            // Create ListView items to add to the control.
            ListViewItem listViewItem1 = new ListViewItem(new string[] {"Banana","a","b","c"}, -1, Color.Empty, Color.Yellow, null);
            ListViewItem listViewItem2 = new ListViewItem(new string[] {"Cherry","v","g","t"}, -1, Color.Empty, Color.Red, new Font("Microsoft Sans Serif", 8.25F, FontStyle.Regular, GraphicsUnit.Point, ((System.Byte)(0))));
            ListViewItem listViewItem3 = new ListViewItem(new string[] {"Apple","h","j","n"}, -1, Color.Empty, Color.Lime, null);
            ListViewItem listViewItem4 = new ListViewItem(new string[] {"Pear","y","u","i"}, -1, Color.Empty, Color.FromArgb(((System.Byte)(192)), ((System.Byte)(128)), ((System.Byte)(156))), null);
     
            //Initialize the ListView control and add columns to it.
            this.listView1 = new ListView();

            // Set the initial sorting type for the ListView.
            this.listView1.Sorting = SortOrder.None;
            // Disable automatic sorting to enable manual sorting.
            this.listView1.View = View.Details;
            // Add columns and set their text.
            this.listView1.Columns.Add(new ColumnHeader());
            this.listView1.Columns[0].Text = "Column 1";
            this.listView1.Columns[0].Width = 100;
            listView1.Columns.Add(new ColumnHeader());
            listView1.Columns[1].Text = "Column 2";
            listView1.Columns.Add(new ColumnHeader());
            listView1.Columns[2].Text = "Column 3";
            listView1.Columns.Add(new ColumnHeader());
            listView1.Columns[3].Text = "Column 4";
            // Suspend control logic until form is done configuring form.
            this.SuspendLayout();
            // Add Items to the ListView control.
            this.listView1.Items.AddRange(new ListViewItem[] {listViewItem1,
                listViewItem2,
                listViewItem3,
                listViewItem4});
            // Set the location and size of the ListView control.
            this.listView1.Location = new Point(10, 10);
            this.listView1.Name = "listView1";
            this.listView1.Size = new Size(300, 100);
            this.listView1.TabIndex = 0;
            // Enable editing of the items in the ListView.
            this.listView1.LabelEdit = true;
            // Connect the ListView.ColumnClick event to the ColumnClick event handler.
            this.listView1.ColumnClick += new ColumnClickEventHandler(ColumnClick);
            
            // Initialize the form.
            this.ClientSize = new Size(400, 400);
            this.Controls.AddRange(new Control[] {this.listView1});
            this.Name = "ListViewSortForm";
            this.Text = "Sorted ListView Control";
            // Resume layout of the form.
            this.ResumeLayout(false);
        }

        // ColumnClick event handler.
        private void ColumnClick(object o, ColumnClickEventArgs e)
        {
            // Set the ListViewItemSorter property to a new ListViewItemComparer 
            // object. Setting this property immediately sorts the 
            // ListView using the ListViewItemComparer object.
            this.listView1.ListViewItemSorter = new ListViewItemComparer(e.Column);
        }

        [System.STAThreadAttribute()]
        public static void Main()
        {
            Application.Run(new ListViewSortForm());
        }
    }

    // Implements the manual sorting of items by columns.
    class ListViewItemComparer : IComparer
    {
        private int col;
        public ListViewItemComparer()
        {
            col = 0;
        }
        public ListViewItemComparer(int column)
        {
            col = column;
        }
        public int Compare(object x, object y)
        {
            return String.Compare(((ListViewItem)x).SubItems[col].Text, ((ListViewItem)y).SubItems[col].Text);
        }
    }
}

Imports System.Windows.Forms
Imports System.Drawing
Imports System.Collections


Namespace ListViewSortFormNamespace

    Public Class ListViewSortForm
        Inherits Form

        Private listView1 As ListView

        Public Sub New()
            ' Create ListView items to add to the control.
            Dim listViewItem1 As New ListViewItem(New String() {"Banana", "a", "b", "c"}, -1, Color.Empty, Color.Yellow, Nothing)
            Dim listViewItem2 As New ListViewItem(New String() {"Cherry", "v", "g", "t"}, -1, Color.Empty, Color.Red, New Font("Microsoft Sans Serif", 8.25F, FontStyle.Regular, GraphicsUnit.Point, CType(0, System.Byte)))
            Dim listViewItem3 As New ListViewItem(New String() {"Apple", "h", "j", "n"}, -1, Color.Empty, Color.Lime, Nothing)
            Dim listViewItem4 As New ListViewItem(New String() {"Pear", "y", "u", "i"}, -1, Color.Empty, Color.FromArgb(CType(192, System.Byte), CType(128, System.Byte), CType(156, System.Byte)), Nothing)

            'Initialize the ListView control and add columns to it.
            Me.listView1 = New ListView

            ' Set the initial sorting type for the ListView.
            Me.listView1.Sorting = SortOrder.None
            ' Disable automatic sorting to enable manual sorting.
            Me.listView1.View = View.Details
            ' Add columns and set their text.
            Me.listView1.Columns.Add(New ColumnHeader)
            Me.listView1.Columns(0).Text = "Column 1"
            Me.listView1.Columns(0).Width = 100
            listView1.Columns.Add(New ColumnHeader)
            listView1.Columns(1).Text = "Column 2"
            listView1.Columns.Add(New ColumnHeader)
            listView1.Columns(2).Text = "Column 3"
            listView1.Columns.Add(New ColumnHeader)
            listView1.Columns(3).Text = "Column 4"
            ' Suspend control logic until form is done configuring form.
            Me.SuspendLayout()
            ' Add Items to the ListView control.
            Me.listView1.Items.AddRange(New ListViewItem() {listViewItem1, listViewItem2, listViewItem3, listViewItem4})
            ' Set the location and size of the ListView control.
            Me.listView1.Location = New Point(10, 10)
            Me.listView1.Name = "listView1"
            Me.listView1.Size = New Size(300, 100)
            Me.listView1.TabIndex = 0
            ' Enable editing of the items in the ListView.
            Me.listView1.LabelEdit = True
            ' Connect the ListView.ColumnClick event to the ColumnClick event handler.
            AddHandler Me.listView1.ColumnClick, AddressOf ColumnClick

            ' Initialize the form.
            Me.ClientSize = New Size(400, 400)
            Me.Controls.AddRange(New Control() {Me.listView1})
            Me.Name = "ListViewSortForm"
            Me.Text = "Sorted ListView Control"
            ' Resume layout of the form.
            Me.ResumeLayout(False)
        End Sub


        ' ColumnClick event handler.
        Private Sub ColumnClick(ByVal o As Object, ByVal e As ColumnClickEventArgs)
            ' Set the ListViewItemSorter property to a new ListViewItemComparer 
            ' object. Setting this property immediately sorts the 
            ' ListView using the ListViewItemComparer object.
            Me.listView1.ListViewItemSorter = New ListViewItemComparer(e.Column)
        End Sub

    End Class

    ' Implements the manual sorting of items by columns.
    Class ListViewItemComparer
        Implements IComparer

        Private col As Integer

        Public Sub New()
            col = 0
        End Sub

        Public Sub New(ByVal column As Integer)
            col = column
        End Sub

        Public Function Compare(ByVal x As Object, ByVal y As Object) As Integer _
           Implements IComparer.Compare
            Return [String].Compare(CType(x, ListViewItem).SubItems(col).Text, CType(y, ListViewItem).SubItems(col).Text)
        End Function
    End Class
End Namespace

注解

类ListView.ColumnHeaderCollection存储当属性设置为 Details时View控件中显示的ListView列标题。存储ListView.ColumnHeaderCollection ColumnHeader对象，这些对象定义要为列显示的文本，以及显示列时列标题在控件中的ListView显示方式。 ListView当显示列时，项及其子项将显示在其自己的列中。若要指定显示哪些列子项数据，请参阅 ListViewItem.ListViewSubItemCollection 类。

可通过多种方式将列标题添加到集合中。方法 Add 将单个列标题添加到集合中。若要向集合添加多个列标题，请创建对象的数组 ColumnHeader 并将其传递给 AddRange 方法。如果要在集合中的特定位置插入列标题，可以使用 Insert 方法。若要删除列标题，如果知道列标题在集合中的位置，则可以使用 Remove 方法或 RemoveAt 方法。方法 Clear 允许从集合中删除所有列标题，而不是使用 Remove 方法一次删除单个列标题。

除了用于添加和删除列标题的方法和属性外， ListView.ColumnHeaderCollection 还提供了在集合中查找列标题的方法。使用 Contains 方法可以确定列标题是否为集合的成员。知道列标题位于集合中后，可以使用 IndexOf 方法确定列标题在集合中的位置。

注意

当所有列的总宽度超过 32，768 像素时，可能会导致意外行为。

构造函数

ListView.ColumnHeaderCollection(ListView)

初始化 ListView.ColumnHeaderCollection 类的新实例。

属性

Count	获取集合中的项数。
IsReadOnly	获取一个值，该值指示集合是否为只读。
Item[Int32]	获取集合中指定索引处的列标题。
Item[String]	获取集合中具有指定键的列标题。

方法

Add(ColumnHeader)	将现有的 ColumnHeader 添加到集合中。
Add(String)	创建具有指定文本的列并将其添加到集合。
Add(String, Int32)	创建具有指定的文本和宽度的列并将其添加到集合。
Add(String, Int32, HorizontalAlignment)	将列标题添至具有指定文本、宽度和对齐方式设置的集合。
Add(String, String)	创建具有指定的文本和键的列并将其添加到集合。
Add(String, String, Int32)	创建具有指定的文本、键和宽度的列并将其添加到集合。
Add(String, String, Int32, HorizontalAlignment, Int32)	创建具有指定键、对齐文本、宽度和图像索引的列并将其添加到集合。
Add(String, String, Int32, HorizontalAlignment, String)	创建具有指定键、对齐文本、宽度和图像键的列并将其添加到集合。
AddRange(ColumnHeader[])	给集合添加列标题数组。
Clear()	从集合中移除所有列标题。
Contains(ColumnHeader)	确定指定列标题是否位于集合内。
ContainsKey(String)	确定具有指定键的列是否包含在集合中。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetEnumerator()	返回要用于循环访问列标题集合的枚举数。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
IndexOf(ColumnHeader)	返回指定的列标题在集合中的索引。
IndexOfKey(String)	确定具有指定键的列的索引。
Insert(Int32, ColumnHeader)	将现有的列标题插入到集合中的指定索引位置。
Insert(Int32, String)	创建具有指定文本的新列标题，并将其插入到集合中指定索引处。
Insert(Int32, String, Int32)	创建具有指定文本和初始宽度的新列标题，并将其插入到集合中指定索引处。
Insert(Int32, String, Int32, HorizontalAlignment)	新建列标题并将它插入集合中的指定索引位置。
Insert(Int32, String, String)	创建具有指定的文本和键的新列标题，并将其插入到集合中指定索引处。
Insert(Int32, String, String, Int32)	创建具有指定的文本、键和宽度的新列标题，并将其插入到集合中指定索引处。
Insert(Int32, String, String, Int32, HorizontalAlignment, Int32)	创建具有指定的对齐文本、键、宽度和图像索引的新列标题，并将其插入到集合中指定索引处。
Insert(Int32, String, String, Int32, HorizontalAlignment, String)	创建具有指定的对齐文本、键、宽度和图像键的新列标题，并将其插入到集合中指定索引处。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Remove(ColumnHeader)	从集合中移除指定的列标题。
RemoveAt(Int32)	移除集合中指定索引处的列标题。
RemoveByKey(String)	从集合中移除具有指定键的列。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

ICollection.CopyTo(Array, Int32)	将 ColumnHeader 中的 ListView.ColumnHeaderCollection 对象复制到一个数组中从特定的数组索引开始的位置。
ICollection.IsSynchronized	获取一个值，该值指示是否同步对 ListView.ColumnHeaderCollection 的访问（线程安全）。
ICollection.SyncRoot	获取可用于同步控件集合访问的对象。
IList.Add(Object)	向 ColumnHeader 中添加一个 ListView。
IList.Contains(Object)	确定指定列标题是否位于集合内。
IList.IndexOf(Object)	此 API 支持产品基础结构，不能在代码中直接使用。返回指定的列标题在集合中的索引。
IList.Insert(Int32, Object)	将现有的列标题插入到集合中的指定索引位置。
IList.IsFixedSize	获取一个值，该值指示 ListView.ColumnHeaderCollection 是否具有固定大小。
IList.Item[Int32]	在集合中的指定索引处获取或设置列标题。
IList.Remove(Object)	从集合中移除指定的列标题。

扩展方法

Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定的类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。

适用于

通过

ListView.ColumnHeaderCollection 类

定义

示例

注解

构造函数

属性

方法

显式接口实现

扩展方法

适用于

其他资源