ListViewItem.ListViewSubItemCollection.Add Metode

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menambahkan subitem ke kumpulan subitem.

Overload

Nama	Deskripsi
Add(String)	Menambahkan subitem ke koleksi dengan teks tertentu.
Add(ListViewItem+ListViewSubItem)	Menambahkan yang sudah ada ListViewItem.ListViewSubItem ke koleksi.
Add(String, Color, Color, Font)	Menambahkan subitem ke koleksi dengan teks tertentu, warna latar depan, warna latar belakang, dan pengaturan font.

Add(String)

Sumber:: ListViewItem.ListViewSubItemCollection.cs

Sumber:: ListViewItem.ListViewSubItemCollection.cs

Sumber:: ListViewItem.ListViewSubItemCollection.cs

Sumber:: ListViewItem.ListViewSubItemCollection.cs

Sumber:: ListViewItem.ListViewSubItemCollection.cs

Menambahkan subitem ke koleksi dengan teks tertentu.

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

Parameter

text: String

Teks yang ditampilkan untuk subitem.

Mengembalikan

ListViewItem.ListViewSubItem

Yang ListViewItem.ListViewSubItem ditambahkan ke koleksi.

Contoh

Contoh kode berikut membuat ListView kontrol dengan tiga ListViewItem objek yang ditentukan dan tiga ListViewItem.ListViewSubItem objek yang ditentukan untuk setiap item. Contoh ini juga membuat ColumnHeader objek untuk menampilkan subitem dalam tampilan detail. Dua ImageList objek juga dibuat dalam contoh kode untuk menyediakan gambar untuk ListViewItem objek. Objek ini ImageList ditambahkan ke LargeImageList properti dan SmallImageList . Contoh menggunakan properti berikut dalam membuat ListView kontrol:

Contoh ini mengharuskan Anda telah menambahkan kode ke dan memanggil metode yang Form dibuat dalam contoh dari konstruktor atau metode lain pada formulir. Contohnya juga mengharuskan gambar bernama MySmallImage1, MySmallImage2, MyLargeImage1, dan MyLargeImage2 terletak di direktori akar drive 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

Keterangan

Versi Add metode ini memungkinkan Anda menambahkan subitem ke koleksi dengan menentukan teks subitem. Ketika metode ini dipanggil, baru ListViewItem.ListViewSubItem dibuat dengan teks yang ditentukan. Anda kemudian dapat menggunakan ListViewItem.ListViewSubItem yang dikembalikan oleh metode ini untuk mengatur properti dan metode panggilan untuk memanipulasi subitem. Jika Anda sudah memiliki yang ListViewItem.ListViewSubItem ingin Anda tambahkan ke koleksi, Anda dapat menggunakan versi Add metode yang menerima ListViewItem.ListViewSubItem sebagai parameter, atau menggunakan Insert metode jika Anda ingin menambahkan subitem pada posisi tertentu dalam koleksi.

Lihat juga

Insert(Int32, ListViewItem+ListViewSubItem)

Berlaku untuk

Add(ListViewItem+ListViewSubItem)

Sumber:: ListViewItem.ListViewSubItemCollection.cs

Sumber:: ListViewItem.ListViewSubItemCollection.cs

Sumber:: ListViewItem.ListViewSubItemCollection.cs

Sumber:: ListViewItem.ListViewSubItemCollection.cs

Sumber:: ListViewItem.ListViewSubItemCollection.cs

Menambahkan yang sudah ada ListViewItem.ListViewSubItem ke koleksi.

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

Parameter

item: ListViewItem.ListViewSubItem

untuk ListViewItem.ListViewSubItem ditambahkan ke koleksi.

Mengembalikan

ListViewItem.ListViewSubItem

Yang ListViewItem.ListViewSubItem ditambahkan ke koleksi.

Keterangan

Anda dapat menggunakan versi Add metode ini untuk menambahkan yang sudah ada ListViewItem.ListViewSubItem ke koleksi. Metode ini biasanya digunakan untuk menggunakan kembali subitem yang ada dari objek lain ListViewItem . Item yang ditambahkan ke koleksi disisipkan di akhir daftar. Untuk menyisipkan item ke dalam koleksi pada posisi tertentu, gunakan metode .Insert Jika Anda ingin menambahkan array objek yang ada ListViewItem.ListViewSubItem , Anda dapat menggunakan versi AddRange metode yang menerima array ListViewItem.ListViewSubItem objek sebagai parameter.

Lihat juga

Berlaku untuk

Add(String, Color, Color, Font)

Sumber:: ListViewItem.ListViewSubItemCollection.cs

Sumber:: ListViewItem.ListViewSubItemCollection.cs

Sumber:: ListViewItem.ListViewSubItemCollection.cs

Sumber:: ListViewItem.ListViewSubItemCollection.cs

Sumber:: ListViewItem.ListViewSubItemCollection.cs

Menambahkan subitem ke koleksi dengan teks tertentu, warna latar depan, warna latar belakang, dan pengaturan 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

Parameter

text: String

Teks yang ditampilkan untuk subitem.

foreColor: Color

Color yang mewakili warna latar depan subitem.

backColor: Color

Color yang mewakili warna latar belakang subitem.

font: Font

Font yang mewakili typeface untuk menampilkan teks subitem.

Mengembalikan

ListViewItem.ListViewSubItem

Yang ListViewItem.ListViewSubItem ditambahkan ke koleksi.

Keterangan

Versi Add metode ini memungkinkan Anda menambahkan subitem ke koleksi dengan menentukan teks subitem. Selain itu, versi Add metode ini memungkinkan Anda menentukan warna latar depan awal, warna latar belakang, dan font teks subitem. Ketika metode ini dipanggil, baru ListViewItem.ListViewSubItem dibuat dengan teks yang ditentukan. Anda kemudian dapat menggunakan ListViewItem.ListViewSubItem yang dikembalikan oleh metode ini untuk mengatur properti dan metode panggilan untuk memanipulasi subitem. Jika Anda sudah memiliki yang ListViewItem.ListViewSubItem ingin Anda tambahkan ke koleksi, Anda dapat menggunakan versi Add metode yang menerima ListViewItem.ListViewSubItem sebagai parameter, atau menggunakan Insert metode jika Anda ingin menambahkan subitem pada posisi tertentu dalam koleksi.

Nota

Secara default, subitem menggunakan warna latar depan, warna latar belakang, dan font yang ditentukan untuk item induk. Atur ListViewItem.UseItemStyleForSubItems properti ke false untuk mencegah gaya item induk mengesampingkan gaya subitem.

Lihat juga

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?

Bagikan melalui

ListViewItem.ListViewSubItemCollection.Add Metode

Definisi

Overload

Add(String)

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

Add(ListViewItem+ListViewSubItem)

Parameter

Mengembalikan

Keterangan

Lihat juga

Berlaku untuk

Add(String, Color, Color, Font)

Parameter

Mengembalikan

Keterangan

Lihat juga

Berlaku untuk

Saran dan Komentar