ListViewItem.ListViewSubItemCollection.Add 方法

定義

命名空間:: System.Windows.Forms

組件:: System.Windows.Forms.dll

重要

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

在子項目集合中新增一個子項目。

多載

名稱	Description
Add(String)	在集合中新增一個子項目，並包含指定的文字。
Add(ListViewItem+ListViewSubItem)	新增一個現有 ListViewItem.ListViewSubItem 的收藏。
Add(String, Color, Color, Font)	為收藏新增一個子項目，包含指定的文字、前景色、背景色及字型設定。

Add(String)

來源:: ListViewItem.ListViewSubItemCollection.cs

來源:: ListViewItem.ListViewSubItemCollection.cs

來源:: ListViewItem.ListViewSubItemCollection.cs

來源:: ListViewItem.ListViewSubItemCollection.cs

來源:: ListViewItem.ListViewSubItemCollection.cs

在集合中新增一個子項目，並包含指定的文字。

public:
 System::Windows::Forms::ListViewItem::ListViewSubItem ^ Add(System::String ^ text);

public System.Windows.Forms.ListViewItem.ListViewSubItem Add(string text);

public System.Windows.Forms.ListViewItem.ListViewSubItem Add(string? text);

member this.Add : string -> System.Windows.Forms.ListViewItem.ListViewSubItem

Public Function Add (text As String) As ListViewItem.ListViewSubItem

參數

text: String

子項目要顯示的文字。

傳回

ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem那個被加入了收藏。

範例

以下程式碼範例建立一個 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 允許你透過指定子項目的文本，將子項目加入該集合。當呼叫此方法時， ListViewItem.ListViewSubItem 會建立一個包含指定文字的新方法。你可以利用 ListViewItem.ListViewSubItem 這個方法回傳的 that 來設定屬性，並呼叫方法來操作子項目。如果你已經有 ListViewItem.ListViewSubItem 想加入集合的現有項目，可以使用 Add 接受 a ListViewItem.ListViewSubItem 作為參數的方法版本，或者如果你想在集合中特定位置加入子項目，則使用該 Insert 方法。

另請參閱

Insert(Int32, ListViewItem+ListViewSubItem)

適用於

Add(ListViewItem+ListViewSubItem)

來源:: ListViewItem.ListViewSubItemCollection.cs

來源:: ListViewItem.ListViewSubItemCollection.cs

來源:: ListViewItem.ListViewSubItemCollection.cs

來源:: ListViewItem.ListViewSubItemCollection.cs

來源:: ListViewItem.ListViewSubItemCollection.cs

新增一個現有 ListViewItem.ListViewSubItem 的收藏。

public:
 System::Windows::Forms::ListViewItem::ListViewSubItem ^ Add(System::Windows::Forms::ListViewItem::ListViewSubItem ^ item);

public System.Windows.Forms.ListViewItem.ListViewSubItem Add(System.Windows.Forms.ListViewItem.ListViewSubItem item);

member this.Add : System.Windows.Forms.ListViewItem.ListViewSubItem -> System.Windows.Forms.ListViewItem.ListViewSubItem

Public Function Add (item As ListViewItem.ListViewSubItem) As ListViewItem.ListViewSubItem

參數

item: ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem加入收藏。

傳回

ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem那個被加入了收藏。

備註

你可以用這個版本 Add 的方法把現有 ListViewItem.ListViewSubItem 的檔案加入收藏。此方法通常用於重複利用其他 ListViewItem 物件的現有子項目。新增到收藏的項目會入清單末尾。若要將項目插入特定位置，請使用該 Insert 方法。如果你想加入一個ListViewItem.ListViewSubItem現有物件陣列，可以使用接受物件陣列ListViewItem.ListViewSubItem作為參數的方法版本AddRange。

另請參閱

適用於

Add(String, Color, Color, Font)

來源:: ListViewItem.ListViewSubItemCollection.cs

來源:: ListViewItem.ListViewSubItemCollection.cs

來源:: ListViewItem.ListViewSubItemCollection.cs

來源:: ListViewItem.ListViewSubItemCollection.cs

來源:: ListViewItem.ListViewSubItemCollection.cs

為收藏新增一個子項目，包含指定的文字、前景色、背景色及字型設定。

public:
 System::Windows::Forms::ListViewItem::ListViewSubItem ^ Add(System::String ^ text, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font);

public System.Windows.Forms.ListViewItem.ListViewSubItem Add(string text, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);

public System.Windows.Forms.ListViewItem.ListViewSubItem Add(string? text, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);

member this.Add : string * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font -> System.Windows.Forms.ListViewItem.ListViewSubItem

Public Function Add (text As String, foreColor As Color, backColor As Color, font As Font) As ListViewItem.ListViewSubItem

參數

text: String

子項目要顯示的文字。

foreColor: Color

A Color 代表子項目的前景顏色。

backColor: Color

A Color 代表子項目的背景色。

font: Font

代表 Font 子項目文字的字體。

傳回

ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem那個被加入了收藏。

備註

此版本 Add 允許你透過指定子項目的文本，將子項目加入該集合。此外，此版本 Add 的方法允許你指定子項目文字的初始前景色、背景色和字型。當呼叫此方法時， ListViewItem.ListViewSubItem 會建立一個包含指定文字的新方法。你可以利用 ListViewItem.ListViewSubItem 這個方法回傳的 that 來設定屬性，並呼叫方法來操作子項目。如果你已經有 ListViewItem.ListViewSubItem 想加入集合的現有資料，可以使用 Add 接受 a ListViewItem.ListViewSubItem 作為參數的方法版本，或是用該 Insert 方法在集合中特定位置新增子項目。

備註

預設情況下，子項目使用父項目指定的前景色、背景色和字型。將屬性設定 ListViewItem.UseItemStyleForSubItems 為， false 以防止父項目樣式覆蓋子項目樣式。

另請參閱

適用於

意見反應

此頁面對您有幫助嗎？

共用方式為

ListViewItem.ListViewSubItemCollection.Add 方法

定義

多載

Add(String)

參數

傳回

範例

備註

另請參閱

適用於

Add(ListViewItem+ListViewSubItem)

參數

傳回

備註

另請參閱

適用於

Add(String, Color, Color, Font)

參數

傳回

備註

另請參閱

適用於

意見反應