Share via

ListViewItem.ListViewSubItemCollection.Add Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Alt öğeleri koleksiyonuna bir alt öğesi ekler.

Aşırı Yüklemeler

Add(String)

Belirtilen metinle koleksiyona bir alt öğesi ekler.
Add(ListViewItem+ListViewSubItem)

Var olanı ListViewItem.ListViewSubItem koleksiyona ekler.
Add(String, Color, Color, Font)

Koleksiyona, belirtilen metin, ön plan rengi, arka plan rengi ve yazı tipi ayarlarıyla bir alt öğesi ekler.

Add(String)

Belirtilen metinle koleksiyona bir alt öğesi ekler.

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

Parametreler

text
String

Alt öğesi için görüntülenecek metin.

Döndürülenler

ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem Koleksiyona eklenen.

Örnekler

Aşağıdaki kod örneği, üç ListViewItem nesne ve her öğe için üç ListViewItem.ListViewSubItem nesne belirtilmiş bir ListView denetim oluşturur. Örnek ayrıca alt öğeleri ayrıntılar görünümünde görüntülemek için nesneler oluşturur ColumnHeader . Kod örneğinde, nesnelere görüntü sağlamak için ListViewItem iki ImageList nesne de oluşturulur. Bu ImageList nesneler ve SmallImageList özelliklerine LargeImageList eklenir. Örnek, denetimi oluştururken ListView aşağıdaki özellikleri kullanır:

Bu örnek için kodu bir Form öğesine eklemiş olmanız ve örnekte oluşturulan yöntemi oluşturucudan veya formdaki başka bir yöntemden çağırmanız gerekir. Örnek ayrıca , , MySmallImage2``MyLargeImage1ve MyLargeImage2 adlı MySmallImage1görüntülerin C sürücüsünün kök dizininde yer almalarını gerektirir.

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

Açıklamalar

Yönteminin Add bu sürümü, alt dizinin metnini belirterek koleksiyona bir alt öğesi eklemenize olanak tanır. Bu yöntem çağrıldığında, belirtilen metinle yeni ListViewItem.ListViewSubItem bir oluşturulur. Ardından, alt öğesini işlemek üzere özellikleri ve çağrı yöntemlerini ayarlamak için bu yöntem tarafından döndürülen öğesini kullanabilirsiniz ListViewItem.ListViewSubItem . Koleksiyona eklemek istediğiniz zaten bir var olan ListViewItem.ListViewSubItem varsa, yöntemin Add parametre olarak kabul ListViewItem.ListViewSubItem eden sürümünü kullanabilir veya alt öğeyi koleksiyon içinde belirli bir konuma eklemek istiyorsanız yöntemini kullanabilirsiniz Insert .

Ayrıca bkz.

Şunlara uygulanır

Add(ListViewItem+ListViewSubItem)

Var olanı ListViewItem.ListViewSubItem koleksiyona ekler.

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

Parametreler

item
ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem koleksiyonuna eklenecek öğesini seçin.

Döndürülenler

ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem Koleksiyona eklenen.

Açıklamalar

Yöntemin Add bu sürümünü kullanarak koleksiyona var olan ListViewItem.ListViewSubItem bir öğeyi ekleyebilirsiniz. Bu yöntem genellikle diğer ListViewItem nesnelerdeki mevcut alt öğeleri yeniden kullanmak için kullanılır. Koleksiyona eklenen öğeler listenin sonuna eklenir. Koleksiyona belirli bir konumda öğe eklemek için yöntemini kullanın Insert . Mevcut ListViewItem.ListViewSubItem nesnelerin dizisini eklemek istiyorsanız, bir nesne dizisini parametre olarak kabul eden yönteminin ListViewItem.ListViewSubItem sürümünü AddRange kullanabilirsiniz.

Ayrıca bkz.

Şunlara uygulanır

Add(String, Color, Color, Font)

Koleksiyona, belirtilen metin, ön plan rengi, arka plan rengi ve yazı tipi ayarlarıyla bir alt öğesi ekler.

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

Parametreler

text
String

Alt öğesi için görüntülenecek metin.

foreColor
Color

Color Alt dizinin ön plan rengini temsil eden bir.

backColor
Color

Color Alt dizinin arka plan rengini temsil eden bir.

font
Font

Font Alt dizinin metninin görüntüleneceği yazı biçimini temsil eden bir.

Döndürülenler

ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem Koleksiyona eklenen.

Açıklamalar

Yönteminin Add bu sürümü, alt dizinin metnini belirterek koleksiyona bir alt öğesi eklemenize olanak tanır. Ayrıca, yöntemin Add bu sürümü alt metnin ilk ön plan rengini, arka plan rengini ve yazı tipini belirtmenize olanak tanır. Bu yöntem çağrıldığında, belirtilen metinle yeni ListViewItem.ListViewSubItem bir oluşturulur. Ardından, alt öğesini işlemek üzere özellikleri ve çağrı yöntemlerini ayarlamak için bu yöntem tarafından döndürülen öğesini kullanabilirsiniz ListViewItem.ListViewSubItem . Koleksiyona eklemek istediğiniz zaten bir var olan ListViewItem.ListViewSubItem varsa, yöntemin Add parametre olarak kabul ListViewItem.ListViewSubItem eden sürümünü kullanabilir veya alt öğeyi Insert koleksiyonda belirli bir konuma eklemek istiyorsanız yöntemini kullanabilirsiniz.

Not

Alt öğeler varsayılan olarak üst öğe için belirtilen ön plan rengini, arka plan rengini ve yazı tipini kullanır. ListViewItem.UseItemStyleForSubItems Üst öğe stillerinin alt öğe stillerini geçersiz kılmasını önlemek için özelliğini false olarak ayarlayın.

Ayrıca bkz.

Şunlara uygulanır