ListViewItem.ListViewSubItemCollection.Add Metoda

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přidá dílčí položku do kolekce dílčích položek.

Přetížení

Name	Description
Add(String)	Přidá subitem do kolekce se zadaným textem.
Add(ListViewItem+ListViewSubItem)	Přidá existující ListViewItem.ListViewSubItem kolekci.
Add(String, Color, Color, Font)	Přidá do kolekce podnabídku se zadaným textem, barvou popředí, barvou pozadí a nastavením písma.

Add(String)

Zdroj:: ListViewItem.ListViewSubItemCollection.cs

Zdroj:: ListViewItem.ListViewSubItemCollection.cs

Zdroj:: ListViewItem.ListViewSubItemCollection.cs

Zdroj:: ListViewItem.ListViewSubItemCollection.cs

Zdroj:: ListViewItem.ListViewSubItemCollection.cs

Přidá subitem do kolekce se zadaným textem.

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

Parametry

text: String

Text, který se má zobrazit pro dílčí položku.

Návraty

ListViewItem.ListViewSubItem

Ta ListViewItem.ListViewSubItem byla přidána do kolekce.

Příklady

Následující příklad kódu vytvoří ListView ovládací prvek se třemi ListViewItem objekty zadanými a třemi ListViewItem.ListViewSubItem objekty zadanými pro každou položku. Příklad také vytvoří ColumnHeader objekty pro zobrazení dílčích položek v zobrazení podrobností. V příkladu kódu se vytvoří také dva ImageList objekty, které poskytují obrázky pro ListViewItem objekty. Tyto ImageList objekty jsou přidány do LargeImageList a SmallImageList vlastnosti. V příkladu ListView se při vytváření ovládacího prvku používají následující vlastnosti:

Tento příklad vyžaduje přidání kódu do Form a volání metody vytvořené v příkladu z konstruktoru nebo jiné metody ve formuláři. Příklad také vyžaduje, aby image s názvem MySmallImage1, MyLargeImage1MySmallImage2a MyLargeImage2 jsou umístěny v kořenovém adresáři jednotky 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

Poznámky

Tato verze Add metody umožňuje přidat subitem do kolekce zadáním textu subitem. Při zavolání této metody se vytvoří nový ListViewItem.ListViewSubItem se zadaným textem. Pak můžete použít metodu ListViewItem.ListViewSubItem vrácenou touto metodou k nastavení vlastností a volání metod pro manipulaci s dílčím objektem. Pokud již máte existující ListViewItem.ListViewSubItem , který chcete přidat do kolekce, můžete použít verzi Add metody, která přijímá ListViewItem.ListViewSubItem jako parametr, nebo použít Insert metodu, pokud chcete přidat dílčí položku na konkrétní pozici v kolekci.

Viz také

Insert(Int32, ListViewItem+ListViewSubItem)

Platí pro

Add(ListViewItem+ListViewSubItem)

Zdroj:: ListViewItem.ListViewSubItemCollection.cs

Zdroj:: ListViewItem.ListViewSubItemCollection.cs

Zdroj:: ListViewItem.ListViewSubItemCollection.cs

Zdroj:: ListViewItem.ListViewSubItemCollection.cs

Zdroj:: ListViewItem.ListViewSubItemCollection.cs

Přidá existující ListViewItem.ListViewSubItem kolekci.

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

Parametry

item: ListViewItem.ListViewSubItem

Přidání ListViewItem.ListViewSubItem do kolekce.

Návraty

ListViewItem.ListViewSubItem

Ta ListViewItem.ListViewSubItem byla přidána do kolekce.

Poznámky

Tuto verzi Add metody můžete použít k přidání existující ListViewItem.ListViewSubItem do kolekce. Tato metoda se obvykle používá k opakovanému použití existujících dílčích položek z jiných ListViewItem objektů. Položky přidané do kolekce se vloží na konec seznamu. Chcete-li vložit položku do kolekce na konkrétní pozici, použijte metodu Insert . Pokud chcete přidat pole existujících ListViewItem.ListViewSubItem objektů, můžete použít verzi AddRange metody, která přijímá pole ListViewItem.ListViewSubItem objektů jako parametr.

Viz také

Platí pro

Add(String, Color, Color, Font)

Zdroj:: ListViewItem.ListViewSubItemCollection.cs

Zdroj:: ListViewItem.ListViewSubItemCollection.cs

Zdroj:: ListViewItem.ListViewSubItemCollection.cs

Zdroj:: ListViewItem.ListViewSubItemCollection.cs

Zdroj:: ListViewItem.ListViewSubItemCollection.cs

Přidá do kolekce podnabídku se zadaným textem, barvou popředí, barvou pozadí a nastavením písma.

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

Parametry

text: String

Text, který se má zobrazit pro dílčí položku.

foreColor: Color

A Color , který představuje barvu popředí dílčí položky.

backColor: Color

A Color , který představuje barvu pozadí dílčí položky.

font: Font

A Font , který představuje typ písma pro zobrazení textu v podsítě.

Návraty

ListViewItem.ListViewSubItem

Ta ListViewItem.ListViewSubItem byla přidána do kolekce.

Poznámky

Tato verze Add metody umožňuje přidat subitem do kolekce zadáním textu subitem. Kromě toho tato verze Add metody umožňuje zadat počáteční barvu popředí, barvu pozadí a písmo textu dílčího textu. Při zavolání této metody se vytvoří nový ListViewItem.ListViewSubItem se zadaným textem. Pak můžete použít metodu ListViewItem.ListViewSubItem vrácenou touto metodou k nastavení vlastností a volání metod pro manipulaci s dílčím objektem. Pokud již máte existující ListViewItem.ListViewSubItem , který chcete přidat do kolekce, můžete použít verzi Add metody, která přijímá ListViewItem.ListViewSubItem jako parametr, nebo použít Insert metodu, pokud chcete přidat dílčí položku na konkrétní pozici v kolekci.

Poznámka:

Ve výchozím nastavení subitems používají barvu popředí, barvu pozadí a písmo určené pro nadřazenou položku. ListViewItem.UseItemStyleForSubItems Nastavte vlastnost tak, aby false se zabránilo přepsání stylů podřízených položek.

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

ListViewItem.ListViewSubItemCollection.Add Metoda

Definice

Přetížení

Add(String)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

Add(ListViewItem+ListViewSubItem)

Parametry

Návraty

Poznámky

Viz také

Platí pro

Add(String, Color, Color, Font)

Parametry

Návraty

Poznámky

Viz také

Platí pro

Váš názor