ListViewItem.ListViewSubItemCollection.Add Yöntem

Tanım

Ad Alanı:: System.Windows.Forms

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

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Alt öğeleri koleksiyonuna bir altitem ekler.

Aşırı Yüklemeler

Name	Description
Add(String)	Belirtilen metinle koleksiyona bir alt bölüm ekler.
Add(ListViewItem+ListViewSubItem)	Koleksiyona var olan ListViewItem.ListViewSubItem bir ekler.
Add(String, Color, Color, Font)	Koleksiyona, belirtilen metin, ön plan rengi, arka plan rengi ve yazı tipi ayarlarıyla bir alt bölüm ekler.

Add(String)

Kaynak:: ListViewItem.ListViewSubItemCollection.cs

Kaynak:: ListViewItem.ListViewSubItemCollection.cs

Kaynak:: ListViewItem.ListViewSubItemCollection.cs

Kaynak:: ListViewItem.ListViewSubItemCollection.cs

Kaynak:: ListViewItem.ListViewSubItemCollection.cs

Belirtilen metinle koleksiyona bir alt bölüm 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, belirtilen üç ListViewItem nesne ve her öğe için üç ListViewItem.ListViewSubItem nesne belirtilen 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 . Ayrıca kod örneğinde nesnelere yönelik görüntüler sağlamak için ListViewItem iki ImageList nesne oluşturulur. Bu ImageList nesneler ve SmallImageList özelliklerine LargeImageList eklenir. Örnek, denetimi oluştururken ListView aşağıdaki özellikleri kullanır:

Bu örnek, kodu bir Form öğesine eklemenizi ve örnekte oluşturulan yöntemi oluşturucudan veya formdaki başka bir yöntemden çağırmanızı gerektirir. Örnek ayrıca , , MySmallImage2MyLargeImage1ve 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 öğesinin metnini belirterek koleksiyona bir alt bölüm eklemenize olanak tanır. Bu yöntem çağrıldığında, belirtilen metinle yeni ListViewItem.ListViewSubItem bir oluşturulur. Ardından bu yöntem tarafından döndürülen öğesini kullanarak ListViewItem.ListViewSubItem özellikleri ayarlayabilir ve alt öğesini işlemek için yöntemleri çağırabilirsiniz. Koleksiyona eklemek istediğiniz mevcut ListViewItem.ListViewSubItem bir dosyanız varsa, yöntemin Add parametre olarak kabul ListViewItem.ListViewSubItem eden sürümünü kullanabilir veya alt öğeyi Insert koleksiyon içinde belirli bir konuma eklemek istiyorsanız yöntemini kullanabilirsiniz.

Ayrıca bkz.

Insert(Int32, ListViewItem+ListViewSubItem)

Şunlara uygulanır

Add(ListViewItem+ListViewSubItem)

Kaynak:: ListViewItem.ListViewSubItemCollection.cs

Kaynak:: ListViewItem.ListViewSubItemCollection.cs

Kaynak:: ListViewItem.ListViewSubItemCollection.cs

Kaynak:: ListViewItem.ListViewSubItemCollection.cs

Kaynak:: ListViewItem.ListViewSubItemCollection.cs

Koleksiyona var olan ListViewItem.ListViewSubItem bir 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.

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 . Var olan ListViewItem.ListViewSubItem bir nesne dizisi eklemek istiyorsanız, yöntemin bir nesne dizisini AddRange ListViewItem.ListViewSubItem parametre olarak kabul eden sürümünü kullanabilirsiniz.

Ayrıca bkz.

Şunlara uygulanır

Add(String, Color, Color, Font)

Kaynak:: ListViewItem.ListViewSubItemCollection.cs

Kaynak:: ListViewItem.ListViewSubItemCollection.cs

Kaynak:: ListViewItem.ListViewSubItemCollection.cs

Kaynak:: ListViewItem.ListViewSubItemCollection.cs

Kaynak:: ListViewItem.ListViewSubItemCollection.cs

Koleksiyona, belirtilen metin, ön plan rengi, arka plan rengi ve yazı tipi ayarlarıyla bir alt bölüm 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

Alt Color öğesinin ön plan rengini temsil eden bir.

backColor: Color

Alt Color öğesinin 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 öğesinin metnini belirterek koleksiyona bir alt bölüm 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 bu yöntem tarafından döndürülen öğesini kullanarak ListViewItem.ListViewSubItem özellikleri ayarlayabilir ve alt öğesini işlemek için yöntemleri çağırabilirsiniz. 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.

Uyarı

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

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Aracılığıyla paylaş

ListViewItem.ListViewSubItemCollection.Add Yöntem

Tanım

Aşırı Yüklemeler

Add(String)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Add(ListViewItem+ListViewSubItem)

Parametreler

Döndürülenler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Add(String, Color, Color, Font)

Parametreler

Döndürülenler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim