ListViewItem.ListViewSubItemCollection.Add 方法

參考

定義

命名空間:: System.Windows.Forms

組件:: System.Windows.Forms.dll

重要

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

將子項目加入至子項目的集合。

多載

Add(String)	利用指定文字將子項目加入至集合中。
Add(ListViewItem+ListViewSubItem)	將現有的 ListViewItem.ListViewSubItem 加入至集合。
Add(String, Color, Color, Font)	使用指定文字、前景色彩、背景色彩和字型的設定，將子項目加入至集合中。

Add(String)

利用指定文字將子項目加入至集合中。

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。

範例

下列程式碼範例會建立控制項，其中指定三 ListViewItem 個物件，以及針對每個專案指定的三 ListViewItem.ListViewSubItem 個 ListView 物件。此範例也會建立 ColumnHeader 物件，以顯示詳細資料檢視中的子專案。程式碼範例中也會建立兩 ImageList 個物件，以提供物件的影像 ListViewItem 。這些 ImageList 物件會新增至 LargeImageList 和 SmallImageList 屬性。此範例會在建立 ListView 控制項時使用下列屬性：

這個範例會要求您將程式碼新增至， 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 ，您可以使用這個方法傳回的來設定屬性，並呼叫方法來操作子專案。如果您已經有 ListViewItem.ListViewSubItem 想要新增至集合的現有方法，則可以使用接受 ListViewItem.ListViewSubItem 做為參數的方法版本 Add ，或者如果您想要在集合內的特定位置新增子專案，請使用 Insert 方法。

另請參閱

Insert(Int32, ListViewItem+ListViewSubItem)

適用於

Add(ListViewItem+ListViewSubItem)

將現有的 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)

使用指定文字、前景色彩、背景色彩和字型的設定，將子項目加入至集合中。

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

Color，表示子項目的前景色彩。

backColor: Color

Color，表示子項目的背景色彩。

font: Font

Font，表示子項目文字所顯示的字樣。

傳回

ListViewItem.ListViewSubItem

已加入至集合中的 ListViewItem.ListViewSubItem。

備註

這個版本的 Add 方法可讓您藉由指定子專案的文字，將子專案新增至集合。此外，這個版本的 Add 方法可讓您指定子專案文字的初始前景色彩、背景色彩和字型。呼叫此方法時，會使用指定的文字建立新的 ListViewItem.ListViewSubItem 。然後 ListViewItem.ListViewSubItem ，您可以使用這個方法傳回的來設定屬性，並呼叫方法來操作子專案。如果您已經有 ListViewItem.ListViewSubItem 想要新增至集合的現有方法，則可以使用接受 ListViewItem.ListViewSubItem 做為參數的方法版本 Add ，或如果您想要將子專案新增至集合中特定位置，請使用 Insert 方法。

注意

根據預設，子專案會使用為父專案指定的前景色彩、背景色彩和字型。將 ListViewItem.UseItemStyleForSubItems 屬性設定為 false ，以防止父專案樣式覆寫子專案樣式。

另請參閱

適用於

共用方式為

ListViewItem.ListViewSubItemCollection.Add 方法

定義

多載

Add(String)

參數

傳回

範例

備註

另請參閱

適用於

Add(ListViewItem+ListViewSubItem)

參數

傳回

備註

另請參閱

適用於

Add(String, Color, Color, Font)

參數

傳回

備註

另請參閱

適用於

其他資源