Udostępnij za pośrednictwem


ListViewItem.ListViewSubItemCollection.Add Metoda

Definicja

Dodaje element podrzędny do kolekcji elementów podrzędnych.

Przeciążenia

Add(String)

Dodaje element podrzędny do kolekcji z określonym tekstem.

Add(ListViewItem+ListViewSubItem)

Dodaje istniejący ListViewItem.ListViewSubItem element do kolekcji.

Add(String, Color, Color, Font)

Dodaje element podrzędny do kolekcji z określonym tekstem, kolorem pierwszego planu, kolorem tła i ustawieniami czcionki.

Add(String)

Dodaje element podrzędny do kolekcji z określonym tekstem.

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

Tekst, który ma być wyświetlany dla podzwytu.

Zwraca

ListViewItem.ListViewSubItem

Element ListViewItem.ListViewSubItem , który został dodany do kolekcji.

Przykłady

Poniższy przykład kodu tworzy kontrolkę ListView z trzema ListViewItem określonymi obiektami i trzema ListViewItem.ListViewSubItem obiektami określonymi dla każdego elementu. W przykładzie są również tworzone ColumnHeader obiekty do wyświetlania podwitemów w widoku szczegółów. Dwa ImageList obiekty są również tworzone w przykładzie kodu w celu udostępnienia obrazów dla ListViewItem obiektów. Te ImageList obiekty są dodawane do LargeImageList właściwości i SmallImageList . W przykładzie użyto następujących właściwości podczas tworzenia kontrolki ListView :

Ten przykład wymaga dodania kodu do obiektu Form i wywołania metody utworzonej w przykładzie z konstruktora lub innej metody w formularzu. Przykład wymaga również, aby obrazy o nazwie MySmallImage1, MySmallImage2, MyLargeImage1i MyLargeImage2 znajdowały się w katalogu głównym dysku 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

Uwagi

Ta wersja Add metody umożliwia dodanie subitemu do kolekcji przez określenie tekstu subitem. Po wywołaniu tej metody zostanie utworzona nowa ListViewItem.ListViewSubItem z określonym tekstem. Następnie możesz użyć elementu ListViewItem.ListViewSubItem , który jest zwracany przez tę metodę, aby ustawić właściwości i wywołać metody w celu manipulowania podzwytem. Jeśli masz już istniejący ListViewItem.ListViewSubItem element, który chcesz dodać do kolekcji, możesz użyć wersji Add metody akceptującej ListViewItem.ListViewSubItem jako parametr lub użyć Insert metody , jeśli chcesz dodać element podrzędny w określonej pozycji w kolekcji.

Zobacz też

Dotyczy

Add(ListViewItem+ListViewSubItem)

Dodaje istniejący ListViewItem.ListViewSubItem element do kolekcji.

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

Element ListViewItem.ListViewSubItem do dodania do kolekcji.

Zwraca

ListViewItem.ListViewSubItem

Element ListViewItem.ListViewSubItem , który został dodany do kolekcji.

Uwagi

Możesz użyć tej wersji Add metody, aby dodać istniejący ListViewItem.ListViewSubItem element do kolekcji. Ta metoda jest zwykle używana do ponownego używania istniejących podwitemów z innych ListViewItem obiektów. Elementy dodawane do kolekcji są wstawiane na końcu listy. Aby wstawić element do kolekcji w określonej pozycji, użyj Insert metody . Jeśli chcesz dodać tablicę istniejących ListViewItem.ListViewSubItem obiektów, możesz użyć wersji AddRange metody, która akceptuje tablicę ListViewItem.ListViewSubItem obiektów jako parametr.

Zobacz też

Dotyczy

Add(String, Color, Color, Font)

Dodaje element podrzędny do kolekcji z określonym tekstem, kolorem pierwszego planu, kolorem tła i ustawieniami czcionki.

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

Tekst, który ma być wyświetlany dla podzwytu.

foreColor
Color

Element Color , który reprezentuje kolor pierwszego planu elementu podrzędnego.

backColor
Color

Element Color , który reprezentuje kolor tła elementu podrzędnego.

font
Font

Element Font reprezentujący krój typów, w ramach którego będzie wyświetlany tekst subitem.

Zwraca

ListViewItem.ListViewSubItem

Element ListViewItem.ListViewSubItem , który został dodany do kolekcji.

Uwagi

Ta wersja Add metody umożliwia dodanie subitemu do kolekcji przez określenie tekstu subitem. Ponadto ta wersja metody umożliwia określenie początkowego Add koloru pierwszego planu, koloru tła i czcionki tekstu podrzędnego. Po wywołaniu tej metody zostanie utworzona nowa ListViewItem.ListViewSubItem z określonym tekstem. Następnie możesz użyć elementu ListViewItem.ListViewSubItem , który jest zwracany przez tę metodę, aby ustawić właściwości i wywołać metody w celu manipulowania podzwytem. Jeśli masz już istniejący ListViewItem.ListViewSubItem element, który chcesz dodać do kolekcji, możesz użyć wersji Add metody, która akceptuje ListViewItem.ListViewSubItem element jako parametr, lub użyć Insert metody , jeśli chcesz dodać element podrzędny w określonej pozycji w kolekcji.

Uwaga

Domyślnie elementy podrzędne używają koloru pierwszego planu, koloru tła i czcionki określonej dla elementu nadrzędnego. ListViewItem.UseItemStyleForSubItems Ustaw właściwość , aby false uniemożliwić stylom elementu nadrzędnego zastępowanie stylów subitem.

Zobacz też

Dotyczy