ListViewItem.ListViewSubItemCollection.Add Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ajoute un sous-élément à la collection de sous-éléments.

Surcharges

Add(String)

Ajoute un sous-élément à la collection avec le texte spécifié.
Add(ListViewItem+ListViewSubItem)

Ajoute un ListViewItem.ListViewSubItem existant à la collection.
Add(String, Color, Color, Font)

Ajoute un sous-élément à la collection avec les paramètres de texte, de couleur de premier plan, de couleur d'arrière-plan et de police spécifiés.

Add(String)

Ajoute un sous-élément à la collection avec le texte spécifié.

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

Paramètres

text
String

Texte à afficher pour le sous-élément.

Retours

ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem ajouté à la collection.

Exemples

L’exemple de code suivant crée un ListView contrôle avec trois objets spécifiés et trois ListViewItem ListViewItem.ListViewSubItem objets spécifiés pour chaque élément. L’exemple crée également des ColumnHeader objets pour afficher les sous-éléments en mode Détails. Deux ImageList objets sont également créés dans l’exemple de code pour fournir des images pour les ListViewItem objets. Ces ImageList objets sont ajoutés aux propriétés et SmallImageList aux LargeImageList propriétés. L’exemple utilise les propriétés suivantes pour créer le ListView contrôle :

Cet exemple nécessite que vous ayez ajouté le code à une Form méthode et que vous appelez la méthode créée dans l’exemple à partir du constructeur ou d’une autre méthode sur le formulaire. L’exemple nécessite également que les images nommées MySmallImage1, MySmallImage2, et MyLargeImage1``MyLargeImage2 se trouvent dans le répertoire racine du lecteur 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

Remarques

Cette version de la Add méthode vous permet d’ajouter un sous-élément à la collection en spécifiant le texte du sous-élément. Lorsque cette méthode est appelée, une nouvelle ListViewItem.ListViewSubItem est créée avec le texte spécifié. Vous pouvez ensuite utiliser ce ListViewItem.ListViewSubItem qui est retourné par cette méthode pour définir des propriétés et appeler des méthodes pour manipuler le sous-élément. Si vous disposez déjà d’un élément existant ListViewItem.ListViewSubItem que vous souhaitez ajouter à la collection, vous pouvez utiliser la version de la Add méthode qui accepte un ListViewItem.ListViewSubItem paramètre ou utiliser la méthode si vous souhaitez ajouter le Insert sous-élément à une position spécifique dans la collection.

Voir aussi

S’applique à

Add(ListViewItem+ListViewSubItem)

Ajoute un ListViewItem.ListViewSubItem existant à la collection.

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

Paramètres

item
ListViewItem.ListViewSubItem

Objet ListViewItem.ListViewSubItem à ajouter à la collection.

Retours

ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem ajouté à la collection.

Remarques

Vous pouvez utiliser cette version de la Add méthode pour ajouter un élément existant ListViewItem.ListViewSubItem à la collection. Cette méthode est généralement utilisée pour réutiliser des sous-éléments existants à partir d’autres ListViewItem objets. Les éléments ajoutés à la collection sont insérés à la fin de la liste. Pour insérer un élément dans la collection à une position spécifique, utilisez la Insert méthode. Si vous souhaitez ajouter un tableau d’objets existants ListViewItem.ListViewSubItem , vous pouvez utiliser la version de la AddRange méthode qui accepte un tableau d’objets ListViewItem.ListViewSubItem en tant que paramètre.

Voir aussi

S’applique à

Add(String, Color, Color, Font)

Ajoute un sous-élément à la collection avec les paramètres de texte, de couleur de premier plan, de couleur d'arrière-plan et de police spécifiés.

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

Paramètres

text
String

Texte à afficher pour le sous-élément.

foreColor
Color

Color représentant la couleur de premier plan du sous-élément.

backColor
Color

Color représentant la couleur d'arrière-plan du sous-élément.

font
Font

Font représentant la police d'affichage du texte du sous-élément.

Retours

ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem ajouté à la collection.

Remarques

Cette version de la Add méthode vous permet d’ajouter un sous-élément à la collection en spécifiant le texte du sous-élément. En outre, cette version de la Add méthode vous permet de spécifier la couleur de premier plan initiale, la couleur d’arrière-plan et la police du texte sous-élément. Lorsque cette méthode est appelée, une nouvelle ListViewItem.ListViewSubItem est créée avec le texte spécifié. Vous pouvez ensuite utiliser ce ListViewItem.ListViewSubItem qui est retourné par cette méthode pour définir des propriétés et appeler des méthodes pour manipuler le sous-élément. Si vous disposez déjà d’un élément existant ListViewItem.ListViewSubItem que vous souhaitez ajouter à la collection, vous pouvez utiliser la version de la Add méthode qui accepte un ListViewItem.ListViewSubItem paramètre ou utiliser la méthode si vous souhaitez ajouter le Insert sous-élément à une position spécifique dans la collection.

Notes

Par défaut, les sous-éléments utilisent la couleur de premier plan, la couleur d’arrière-plan et la police spécifiées pour l’élément parent. Définissez la ListViewItem.UseItemStyleForSubItems propriété pour false empêcher les styles d’élément parent de remplacer les styles sous-éléments.

Voir aussi

S’applique à