ListView.ColumnHeaderCollection.Add 方法

定義

命名空間:: System.Windows.Forms

組件:: System.Windows.Forms.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

為集合新增欄位標頭。

多載

名稱	Description
Add(String)	建立並新增包含指定文字的欄位到集合中。
Add(ColumnHeader)	新增一個現有 ColumnHeader 的收藏。
Add(String, Int32)	建立並新增一欄，內容為指定的文字與寬度。
Add(String, String)	建立並新增包含指定文字與鍵的欄位至集合。
Add(String, String, Int32)	建立並新增一欄，包含指定的文字、鍵和寬度到集合中。
Add(String, Int32, HorizontalAlignment)	為集合新增欄位標頭，並設定文字、寬度與對齊。
Add(String, String, Int32, HorizontalAlignment, Int32)	建立並新增一欄，包含指定的鍵、對齊的文字、寬度及圖片索引到集合中。
Add(String, String, Int32, HorizontalAlignment, String)	建立並新增欄位，包含指定的鍵、對齊的文字、寬度及圖片鍵到集合中。

Add(String)

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

建立並新增包含指定文字的欄位到集合中。

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ text);

public virtual System.Windows.Forms.ColumnHeader Add(string text);

public virtual System.Windows.Forms.ColumnHeader Add(string? text);

abstract member Add : string -> System.Windows.Forms.ColumnHeader
override this.Add : string -> System.Windows.Forms.ColumnHeader

Public Overridable Function Add (text As String) As ColumnHeader

參數

text: String

欄位標題中顯示的文字。

傳回

ColumnHeader

該 ColumnHeader 與新增 ListView.ColumnHeaderCollection的指定文字相符。

備註

欄位標頭會被加到集合的末尾。

適用於

Add(ColumnHeader)

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

新增一個現有 ColumnHeader 的收藏。

public:
 virtual int Add(System::Windows::Forms::ColumnHeader ^ value);

public virtual int Add(System.Windows.Forms.ColumnHeader value);

abstract member Add : System.Windows.Forms.ColumnHeader -> int
override this.Add : System.Windows.Forms.ColumnHeader -> int

Public Overridable Function Add (value As ColumnHeader) As Integer

參數

value: ColumnHeader

ColumnHeader加入收藏。

傳回

Int32

以零為基礎的索引，指向該項目加入的集合。

範例

以下程式碼範例建立一個表單，包含 ListView 一個控制項，當點擊控制項欄位 ListView 時，手動排序項目。範例定義了一個稱為ListViewItemComparer實作執行比較介面ListViewItem的System.Collections.IComparer類別。範例建立一個實 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

備註

你可以用這個版本 Add 的方法把現有 ColumnHeader 的檔案加入收藏。如果你想在加入收藏時建立新 ColumnHeader 版本，可以使用另一種 Add 版本的方法。

當欄位標題被加入時，會被加到集合的末尾。若要在集合中特定位置插入欄位標頭，請使用該 Insert 方法。若要在單一操作中將一組欄位標頭加入集合，請使用該 AddRange 方法。

另請參閱

適用於

Add(String, Int32)

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

建立並新增一欄，內容為指定的文字與寬度。

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ text, int width);

public virtual System.Windows.Forms.ColumnHeader Add(string text, int width);

public virtual System.Windows.Forms.ColumnHeader Add(string? text, int width);

abstract member Add : string * int -> System.Windows.Forms.ColumnHeader
override this.Add : string * int -> System.Windows.Forms.ColumnHeader

Public Overridable Function Add (text As String, width As Integer) As ColumnHeader

參數

text: String

內容將 ColumnHeader 加入收藏。

width: Int32

增加收藏的寬度 ColumnHeader 。

傳回

ColumnHeader

該以ColumnHeader指定的文字和寬度加到。ListView.ColumnHeaderCollection

備註

該欄會加在集合的最後。

適用於

Add(String, String)

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

建立並新增包含指定文字與鍵的欄位至集合。

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ key, System::String ^ text);

public virtual System.Windows.Forms.ColumnHeader Add(string key, string text);

abstract member Add : string * string -> System.Windows.Forms.ColumnHeader
override this.Add : string * string -> System.Windows.Forms.ColumnHeader

Public Overridable Function Add (key As String, text As String) As ColumnHeader

參數

key: String

ColumnHeader將鑰匙加入收藏。

text: String

內容將 ColumnHeader 加入收藏。

傳回

ColumnHeader

該以ColumnHeader指定的鍵和新增的文字。ListView.ColumnHeaderCollection

備註

屬性 Name 對應於中某欄 ListView.ColumnHeaderCollection的鍵值。

該欄會加在集合的最後。

適用於

Add(String, String, Int32)

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

建立並新增一欄，包含指定的文字、鍵和寬度到集合中。

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ key, System::String ^ text, int width);

public virtual System.Windows.Forms.ColumnHeader Add(string key, string text, int width);

abstract member Add : string * string * int -> System.Windows.Forms.ColumnHeader
override this.Add : string * string * int -> System.Windows.Forms.ColumnHeader

Public Overridable Function Add (key As String, text As String, width As Integer) As ColumnHeader

參數

key: String

欄位標頭的鍵。

text: String

欄位標題中顯示的文字。

width: Int32

.的 ColumnHeader初始寬度。

傳回

ColumnHeader

這個 ColumnHeader 包含了新增到收藏中的文字、鍵和寬度。

備註

屬性 Name 對應於中某欄 ListView.ColumnHeaderCollection的鍵值。

該欄會加在集合的最後。

適用於

Add(String, Int32, HorizontalAlignment)

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

為集合新增欄位標頭，並設定文字、寬度與對齊。

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ str, int width, System::Windows::Forms::HorizontalAlignment textAlign);

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ text, int width, System::Windows::Forms::HorizontalAlignment textAlign);

public virtual System.Windows.Forms.ColumnHeader Add(string str, int width, System.Windows.Forms.HorizontalAlignment textAlign);

public virtual System.Windows.Forms.ColumnHeader Add(string text, int width, System.Windows.Forms.HorizontalAlignment textAlign);

public virtual System.Windows.Forms.ColumnHeader Add(string? text, int width, System.Windows.Forms.HorizontalAlignment textAlign);

abstract member Add : string * int * System.Windows.Forms.HorizontalAlignment -> System.Windows.Forms.ColumnHeader
override this.Add : string * int * System.Windows.Forms.HorizontalAlignment -> System.Windows.Forms.ColumnHeader

abstract member Add : string * int * System.Windows.Forms.HorizontalAlignment -> System.Windows.Forms.ColumnHeader
override this.Add : string * int * System.Windows.Forms.HorizontalAlignment -> System.Windows.Forms.ColumnHeader

Public Overridable Function Add (str As String, width As Integer, textAlign As HorizontalAlignment) As ColumnHeader

Public Overridable Function Add (text As String, width As Integer, textAlign As HorizontalAlignment) As ColumnHeader

參數

strtext: String

欄位標題中顯示的文字。

width: Int32

欄位標頭的初始寬度。

textAlign: HorizontalAlignment

這是其中一項 HorizontalAlignment 價值。

傳回

ColumnHeader

那個 ColumnHeader 被創建並加入收藏。

範例

以下程式碼範例建立一個 ListView 控制項，每個項目指定三個 ListViewItem 物件與三個 ListViewItem.ListViewSubItem 物件。範例中也會建立 ColumnHeader 物件，在詳細檢視中顯示子項目。程式碼範例中也建立了兩個 ImageList 物件，以提供物件 ListViewItem 的影像。這些 ImageList 物件會被 LargeImageList 加入到和 SmallImageList 屬性中。範例中在建立控制項 ListView 時使用了以下屬性：

這個範例需要你已經將程式碼加入 a Form ，並從建構子或其他表單中的方法呼叫範例中建立的方法。範例也要求名為 MySmallImage1、 MySmallImage2、 MyLargeImage1和 MyLargeImage2 的映像檔必須位於磁碟 C 的根目錄中。

private:
   void CreateMyListView()
   {
      // Create a new ListView control.
      ListView^ listView1 = gcnew ListView;
      listView1->Bounds = Rectangle(Point(10,10),System::Drawing::Size( 300, 200 ));

      // Set the view to show details.
      listView1->View = View::Details;

      // Allow the user to edit item text.
      listView1->LabelEdit = true;

      // Allow the user to rearrange columns.
      listView1->AllowColumnReorder = true;

      // Display check boxes.
      listView1->CheckBoxes = true;

      // Select the item and subitems when selection is made.
      listView1->FullRowSelect = true;

      // Display grid lines.
      listView1->GridLines = true;

      // Sort the items in the list in ascending order.
      listView1->Sorting = SortOrder::Ascending;

      // Create three items and three sets of subitems for each item.
      ListViewItem^ item1 = gcnew ListViewItem( "item1",0 );

      // Place a check mark next to the item.
      item1->Checked = true;
      item1->SubItems->Add( "1" );
      item1->SubItems->Add( "2" );
      item1->SubItems->Add( "3" );
      ListViewItem^ item2 = gcnew ListViewItem( "item2",1 );
      item2->SubItems->Add( "4" );
      item2->SubItems->Add( "5" );
      item2->SubItems->Add( "6" );
      ListViewItem^ item3 = gcnew ListViewItem( "item3",0 );

      // Place a check mark next to the item.
      item3->Checked = true;
      item3->SubItems->Add( "7" );
      item3->SubItems->Add( "8" );
      item3->SubItems->Add( "9" );

      // Create columns for the items and subitems.
      // Width of -2 indicates auto-size.
      listView1->Columns->Add( "Item Column", -2, HorizontalAlignment::Left );
      listView1->Columns->Add( "Column 2", -2, HorizontalAlignment::Left );
      listView1->Columns->Add( "Column 3", -2, HorizontalAlignment::Left );
      listView1->Columns->Add( "Column 4", -2, HorizontalAlignment::Center );

      //Add the items to the ListView.
      array<ListViewItem^>^temp1 = {item1,item2,item3};
      listView1->Items->AddRange( temp1 );

      // Create two ImageList objects.
      ImageList^ imageListSmall = gcnew ImageList;
      ImageList^ imageListLarge = gcnew ImageList;

      // Initialize the ImageList objects with bitmaps.
      imageListSmall->Images->Add( Bitmap::FromFile( "C:\\MySmallImage1.bmp" ) );
      imageListSmall->Images->Add( Bitmap::FromFile( "C:\\MySmallImage2.bmp" ) );
      imageListLarge->Images->Add( Bitmap::FromFile( "C:\\MyLargeImage1.bmp" ) );
      imageListLarge->Images->Add( Bitmap::FromFile( "C:\\MyLargeImage2.bmp" ) );

      //Assign the ImageList objects to the ListView.
      listView1->LargeImageList = imageListLarge;
      listView1->SmallImageList = imageListSmall;
      
      // Add the ListView to the control collection.
      this->Controls->Add( listView1 );
   }

private void CreateMyListView()
{
    // Create a new ListView control.
    ListView listView1 = new ListView();
    listView1.Bounds = new Rectangle(new Point(10,10), new Size(300,200));

    // Set the view to show details.
    listView1.View = View.Details;
    // Allow the user to edit item text.
    listView1.LabelEdit = true;
    // Allow the user to rearrange columns.
    listView1.AllowColumnReorder = true;
    // Display check boxes.
    listView1.CheckBoxes = true;
    // Select the item and subitems when selection is made.
    listView1.FullRowSelect = true;
    // Display grid lines.
    listView1.GridLines = true;
    // Sort the items in the list in ascending order.
    listView1.Sorting = SortOrder.Ascending;
                
    // Create three items and three sets of subitems for each item.
    ListViewItem item1 = new ListViewItem("item1",0);
    // Place a check mark next to the item.
    item1.Checked = true;
    item1.SubItems.Add("1");
    item1.SubItems.Add("2");
    item1.SubItems.Add("3");
    ListViewItem item2 = new ListViewItem("item2",1);
    item2.SubItems.Add("4");
    item2.SubItems.Add("5");
    item2.SubItems.Add("6");
    ListViewItem item3 = new ListViewItem("item3",0);
    // Place a check mark next to the item.
    item3.Checked = true;
    item3.SubItems.Add("7");
    item3.SubItems.Add("8");
    item3.SubItems.Add("9");

    // Create columns for the items and subitems.
    // Width of -2 indicates auto-size.
    listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left);
    listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left);
    listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left);
    listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center);

    //Add the items to the ListView.
    listView1.Items.AddRange(new ListViewItem[]{item1,item2,item3});

    // Create two ImageList objects.
    ImageList imageListSmall = new ImageList();
    ImageList imageListLarge = new ImageList();

    // Initialize the ImageList objects with bitmaps.
    imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage1.bmp"));
    imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage2.bmp"));
    imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage1.bmp"));
    imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage2.bmp"));

    //Assign the ImageList objects to the ListView.
    listView1.LargeImageList = imageListLarge;
    listView1.SmallImageList = imageListSmall;

    // Add the ListView to the control collection.
    this.Controls.Add(listView1);
}

Private Sub CreateMyListView()
    ' Create a new ListView control.
    Dim listView1 As New ListView()
    listView1.Bounds = New Rectangle(New Point(10, 10), New Size(300, 200))

    ' Set the view to show details.
    listView1.View = View.Details
    ' Allow the user to edit item text.
    listView1.LabelEdit = True
    ' Allow the user to rearrange columns.
    listView1.AllowColumnReorder = True
    ' Display check boxes.
    listView1.CheckBoxes = True
    ' Select the item and subitems when selection is made.
    listView1.FullRowSelect = True
    ' Display grid lines.
    listView1.GridLines = True
    ' Sort the items in the list in ascending order.
    listView1.Sorting = SortOrder.Ascending

    ' Create three items and three sets of subitems for each item.
    Dim item1 As New ListViewItem("item1", 0)
    ' Place a check mark next to the item.
    item1.Checked = True
    item1.SubItems.Add("1")
    item1.SubItems.Add("2")
    item1.SubItems.Add("3")
    Dim item2 As New ListViewItem("item2", 1)
    item2.SubItems.Add("4")
    item2.SubItems.Add("5")
    item2.SubItems.Add("6")
    Dim item3 As New ListViewItem("item3", 0)
    ' Place a check mark next to the item.
    item3.Checked = True
    item3.SubItems.Add("7")
    item3.SubItems.Add("8")
    item3.SubItems.Add("9")

    ' Create columns for the items and subitems.
    ' Width of -2 indicates auto-size.
    listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left)
    listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left)
    listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left)
    listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center)

    'Add the items to the ListView.
    listView1.Items.AddRange(New ListViewItem() {item1, item2, item3})

    ' Create two ImageList objects.
    Dim imageListSmall As New ImageList()
    Dim imageListLarge As New ImageList()

    ' Initialize the ImageList objects with bitmaps.
    imageListSmall.Images.Add(Bitmap.FromFile("C:\MySmallImage1.bmp"))
    imageListSmall.Images.Add(Bitmap.FromFile("C:\MySmallImage2.bmp"))
    imageListLarge.Images.Add(Bitmap.FromFile("C:\MyLargeImage1.bmp"))
    imageListLarge.Images.Add(Bitmap.FromFile("C:\MyLargeImage2.bmp"))

    'Assign the ImageList objects to the ListView.
    listView1.LargeImageList = imageListLarge
    listView1.SmallImageList = imageListSmall

    ' Add the ListView to the control collection.
    Me.Controls.Add(listView1)
End Sub

備註

你可以用這個版本 Add 的方法建立一個 ColumnHeader 新的，然後加入收藏。新增控制項的文字 ColumnHeader 是根據參數 text 而定。這個版本 Add 的方法也允許你指定欄位寬度和欄位標頭文字的對齊。如果你有ColumnHeader現有的參數想加入集合，請使用接受 a ColumnHeader 作為參數的方法版本Add。

另請參閱

適用於

Add(String, String, Int32, HorizontalAlignment, Int32)

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

建立並新增一欄，包含指定的鍵、對齊的文字、寬度及圖片索引到集合中。

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ key, System::String ^ text, int width, System::Windows::Forms::HorizontalAlignment textAlign, int imageIndex);

public virtual System.Windows.Forms.ColumnHeader Add(string key, string text, int width, System.Windows.Forms.HorizontalAlignment textAlign, int imageIndex);

abstract member Add : string * string * int * System.Windows.Forms.HorizontalAlignment * int -> System.Windows.Forms.ColumnHeader
override this.Add : string * string * int * System.Windows.Forms.HorizontalAlignment * int -> System.Windows.Forms.ColumnHeader

Public Overridable Function Add (key As String, text As String, width As Integer, textAlign As HorizontalAlignment, imageIndex As Integer) As ColumnHeader

參數

key: String

欄位標頭的鍵。

text: String

欄位標題中顯示的文字。

width: Int32

欄位標頭的初始寬度。

textAlign: HorizontalAlignment

這是其中一項 HorizontalAlignment 價值。

imageIndex: Int32

圖片的索引值，要顯示在欄位中。

傳回

ColumnHeader

這些 ColumnHeader 工具包含指定的鍵、對齊的文字、寬度，以及已加入收藏的圖片索引。

備註

屬性 Name 對應於中某欄 ListView.ColumnHeaderCollection的鍵值。

該欄會加在集合的最後。

適用於

Add(String, String, Int32, HorizontalAlignment, String)

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

來源:: ListView.ColumnHeaderCollection.cs

建立並新增欄位，包含指定的鍵、對齊的文字、寬度及圖片鍵到集合中。

public:
 virtual System::Windows::Forms::ColumnHeader ^ Add(System::String ^ key, System::String ^ text, int width, System::Windows::Forms::HorizontalAlignment textAlign, System::String ^ imageKey);

public virtual System.Windows.Forms.ColumnHeader Add(string key, string text, int width, System.Windows.Forms.HorizontalAlignment textAlign, string imageKey);

public virtual System.Windows.Forms.ColumnHeader Add(string? key, string? text, int width, System.Windows.Forms.HorizontalAlignment textAlign, string imageKey);

abstract member Add : string * string * int * System.Windows.Forms.HorizontalAlignment * string -> System.Windows.Forms.ColumnHeader
override this.Add : string * string * int * System.Windows.Forms.HorizontalAlignment * string -> System.Windows.Forms.ColumnHeader

Public Overridable Function Add (key As String, text As String, width As Integer, textAlign As HorizontalAlignment, imageKey As String) As ColumnHeader

參數

key: String

欄位標頭的鍵。

text: String

欄位標題中顯示的文字。

width: Int32

欄位標頭的初始寬度。

textAlign: HorizontalAlignment

這是其中一項 HorizontalAlignment 價值。

imageKey: String

圖片的鍵值，要顯示在欄標頭中。

傳回

ColumnHeader

該 ColumnHeader 鍵包含指定的鍵、對齊的文字、寬度及新增的圖片鍵。

備註

屬性 Name 對應於中某欄 ListView.ColumnHeaderCollection的鍵值。

該欄會加在集合的最後。

適用於

意見反應

此頁面對您有幫助嗎？

共用方式為

ListView.ColumnHeaderCollection.Add 方法

定義

多載

Add(String)

參數

傳回

備註

適用於

Add(ColumnHeader)

參數

傳回

範例

備註

另請參閱

適用於

Add(String, Int32)

參數

傳回

備註

適用於

Add(String, String)

參數

傳回

備註

適用於

Add(String, String, Int32)

參數

傳回

備註

適用於

Add(String, Int32, HorizontalAlignment)

參數

傳回

範例

備註

另請參閱

適用於

Add(String, String, Int32, HorizontalAlignment, Int32)

參數

傳回

備註

適用於

Add(String, String, Int32, HorizontalAlignment, String)

參數

傳回

備註

適用於

意見反應