ListViewItem.ListViewSubItemCollection.Add Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Aggiunge un elemento secondario all'insieme.

Overload

Add(String)	Aggiunge un elemento secondario all'insieme con il testo specificato.
Add(ListViewItem+ListViewSubItem)	Aggiunge un oggetto ListViewItem.ListViewSubItem esistente all'insieme.
Add(String, Color, Color, Font)	Aggiunge all'insieme un elemento secondario con il testo specificato, in base alle impostazioni del carattere e dei colori di sfondo e di primo piano.

Add(String)

Aggiunge un elemento secondario all'insieme con il testo specificato.

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

Parametri

text: String

Testo associato all'elemento secondario.

Restituisce

ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem aggiunto all'insieme.

Esempio

Nell'esempio di codice seguente viene creato un ListView controllo con tre ListViewItem oggetti specificati e tre ListViewItem.ListViewSubItem oggetti specificati per ogni elemento. L'esempio crea ColumnHeader anche oggetti per visualizzare gli elementi secondari nella visualizzazione dettagli. Nell'esempio di codice vengono creati anche due ImageList oggetti per fornire immagini per gli ListViewItem oggetti . Questi ImageList oggetti vengono aggiunti alle LargeImageList proprietà e SmallImageList . Nell'esempio vengono utilizzate le proprietà seguenti per la creazione del ListView controllo :

In questo esempio è necessario aggiungere il codice a un Form oggetto e chiamare il metodo creato nell'esempio dal costruttore o da un altro metodo nel form. L'esempio richiede anche che le immagini denominate MySmallImage1, MySmallImage2``MyLargeImage1, e MyLargeImage2 si trovino nella directory radice dell'unità 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

Commenti

Questa versione del Add metodo consente di aggiungere un elemento secondario alla raccolta specificando il testo dell'elemento secondario. Quando viene chiamato questo metodo, viene creato un nuovo ListViewItem.ListViewSubItem oggetto con il testo specificato. È quindi possibile utilizzare l'oggetto ListViewItem.ListViewSubItem restituito da questo metodo per impostare le proprietà e chiamare i metodi per modificare l'elemento secondario. Se si dispone già di un oggetto che ListViewItem.ListViewSubItem si desidera aggiungere alla raccolta, è possibile utilizzare la versione del Add metodo che accetta come ListViewItem.ListViewSubItem parametro oppure usare il Insert metodo se si desidera aggiungere l'elemento secondario in una posizione specifica all'interno dell'insieme.

Vedi anche

Insert(Int32, ListViewItem+ListViewSubItem)

Si applica a

Add(ListViewItem+ListViewSubItem)

Aggiunge un oggetto ListViewItem.ListViewSubItem esistente all'insieme.

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

Parametri

item: ListViewItem.ListViewSubItem

Oggetto ListViewItem.ListViewSubItem da aggiungere alla raccolta.

Restituisce

ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem aggiunto all'insieme.

Commenti

È possibile utilizzare questa versione del Add metodo per aggiungere un oggetto esistente ListViewItem.ListViewSubItem alla raccolta. Questo metodo viene in genere usato per riutilizzare gli elementi secondari esistenti da altri ListViewItem oggetti. Gli elementi aggiunti alla raccolta vengono inseriti alla fine dell'elenco. Per inserire un elemento nella raccolta in una posizione specifica, utilizzare il Insert metodo . Se si desidera aggiungere una matrice di oggetti esistenti ListViewItem.ListViewSubItem , è possibile usare la versione del AddRange metodo che accetta una matrice di ListViewItem.ListViewSubItem oggetti come parametro.

Vedi anche

Si applica a

Add(String, Color, Color, Font)

Aggiunge all'insieme un elemento secondario con il testo specificato, in base alle impostazioni del carattere e dei colori di sfondo e di primo piano.

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

Parametri

text: String

Testo associato all'elemento secondario.

foreColor: Color

Oggetto Color che rappresenta il colore di primo piano dell'elemento secondario.

backColor: Color

Oggetto Color che rappresenta il colore di sfondo dell'elemento secondario.

font: Font

Oggetto Font che rappresenta il carattere da utilizzare per la visualizzazione del testo dell'elemento secondario.

Restituisce

ListViewItem.ListViewSubItem

ListViewItem.ListViewSubItem aggiunto all'insieme.

Commenti

Questa versione del Add metodo consente di aggiungere un elemento secondario alla raccolta specificando il testo dell'elemento secondario. Inoltre, questa versione del Add metodo consente di specificare il colore di primo piano iniziale, il colore di sfondo e il tipo di carattere del testo dell'elemento secondario. Quando viene chiamato questo metodo, viene creato un nuovo ListViewItem.ListViewSubItem oggetto con il testo specificato. È quindi possibile utilizzare l'oggetto ListViewItem.ListViewSubItem restituito da questo metodo per impostare le proprietà e chiamare i metodi per modificare l'elemento secondario. Se si dispone già di un ListViewItem.ListViewSubItem oggetto che si desidera aggiungere alla raccolta, è possibile utilizzare la versione del Add metodo che accetta un ListViewItem.ListViewSubItem oggetto come parametro oppure utilizzare il Insert metodo se si desidera aggiungere l'elemento secondario in una posizione specifica dell'insieme.

Nota

Per impostazione predefinita, gli elementi secondari usano il colore di primo piano, il colore di sfondo e il tipo di carattere specificati per l'elemento padre. Impostare la ListViewItem.UseItemStyleForSubItems proprietà su false per impedire agli stili degli elementi padre di eseguire l'override degli stili dell'elemento secondario.

Vedi anche

Si applica a

ListViewItem.ListViewSubItemCollection.Add Metodo

Definizione

Overload

Add(String)

Parametri

Restituisce

Esempio

Commenti

Vedi anche

Si applica a

Add(ListViewItem+ListViewSubItem)

Parametri

Restituisce

Commenti

Vedi anche

Si applica a

Add(String, Color, Color, Font)

Parametri

Restituisce

Commenti

Vedi anche

Si applica a

Risorse aggiuntive