ListBox.ObjectCollection.Add(Object) Método

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Agrega un elemento a la lista de elementos de un control ListBox.

public:
 int Add(System::Object ^ item);

public int Add (object item);

member this.Add : obj -> int

Public Function Add (item As Object) As Integer

Parámetros

item: Object

Objeto que representa el elemento que se va a agregar a la colección.

Devoluciones

Int32

Índice de base cero del elemento en la colección, o -1 si se ha llamado a BeginUpdate().

Excepciones

SystemException

No hay suficiente espacio disponible para agregar el nuevo elemento a la lista.

ArgumentNullException

item es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un ListBox control que muestra varios elementos en columnas y puede tener más de un elemento seleccionado en la lista del control. El código del ejemplo agrega 50 elementos al ListBox mediante el Add método de la ListBox.ObjectCollection clase y, a continuación, selecciona tres elementos de la lista mediante el SetSelected método . A continuación, el código muestra los valores de la ListBox.SelectedObjectCollection colección (a través de la SelectedItems propiedad ) y ( ListBox.SelectedIndexCollection a través de la SelectedIndices propiedad ). En este ejemplo se requiere que el código se encuentre en y se llame desde .Form

void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   
   // Create an instance of the ListBox.
   ListBox^ listBox1 = gcnew ListBox;
   
   // Set the size and location of the ListBox.
   listBox1->Size = System::Drawing::Size( 200, 100 );
   listBox1->Location = System::Drawing::Point( 10, 10 );
   
   // Add the ListBox to the form.
   this->Controls->Add( listBox1 );
   
   // Set the ListBox to display items in multiple columns.
   listBox1->MultiColumn = true;
   
   // Set the selection mode to multiple and extended.
   listBox1->SelectionMode = SelectionMode::MultiExtended;
   
   // Shutdown the painting of the ListBox as items are added.
   listBox1->BeginUpdate();
   
   // Loop through and add 50 items to the ListBox.
   for ( int x = 1; x <= 50; x++ )
   {
      listBox1->Items->Add( String::Format( "Item {0}", x ) );

   }
   listBox1->EndUpdate();
   
   // Select three items from the ListBox.
   listBox1->SetSelected( 1, true );
   listBox1->SetSelected( 3, true );
   listBox1->SetSelected( 5, true );
   
   #if defined(DEBUG)
   // Display the second selected item in the ListBox to the console.
   System::Diagnostics::Debug::WriteLine( listBox1->SelectedItems[ 1 ] );
   
   // Display the index of the first selected item in the ListBox.
   System::Diagnostics::Debug::WriteLine( listBox1->SelectedIndices[ 0 ] );
   #endif
}

private void button1_Click(object sender, System.EventArgs e)
{
   // Create an instance of the ListBox.
   ListBox listBox1 = new ListBox();
   // Set the size and location of the ListBox.
   listBox1.Size = new System.Drawing.Size(200, 100);
   listBox1.Location = new System.Drawing.Point(10,10);
   // Add the ListBox to the form.
   this.Controls.Add(listBox1);
   // Set the ListBox to display items in multiple columns.
   listBox1.MultiColumn = true;
   // Set the selection mode to multiple and extended.
   listBox1.SelectionMode = SelectionMode.MultiExtended;
 
   // Shutdown the painting of the ListBox as items are added.
   listBox1.BeginUpdate();
   // Loop through and add 50 items to the ListBox.
   for (int x = 1; x <= 50; x++)
   {
      listBox1.Items.Add("Item " + x.ToString());
   }
   // Allow the ListBox to repaint and display the new items.
   listBox1.EndUpdate();
      
   // Select three items from the ListBox.
   listBox1.SetSelected(1, true);
   listBox1.SetSelected(3, true);
   listBox1.SetSelected(5, true);

   // Display the second selected item in the ListBox to the console.
   System.Diagnostics.Debug.WriteLine(listBox1.SelectedItems[1].ToString());
   // Display the index of the first selected item in the ListBox.
   System.Diagnostics.Debug.WriteLine(listBox1.SelectedIndices[0].ToString());             
}

Private Sub button1_Click(sender As Object, e As System.EventArgs)
    ' Create an instance of the ListBox.
    Dim listBox1 As New ListBox()
    ' Set the size and location of the ListBox.
    listBox1.Size = New System.Drawing.Size(200, 100)
    listBox1.Location = New System.Drawing.Point(10, 10)
    ' Add the ListBox to the form.
    Me.Controls.Add(listBox1)
    ' Set the ListBox to display items in multiple columns.
    listBox1.MultiColumn = True
    ' Set the selection mode to multiple and extended.
    listBox1.SelectionMode = SelectionMode.MultiExtended
    
    ' Shutdown the painting of the ListBox as items are added.
    listBox1.BeginUpdate()
    ' Loop through and add 50 items to the ListBox.
    Dim x As Integer
    For x = 1 To 50
        listBox1.Items.Add("Item " & x.ToString())
    Next x
    ' Allow the ListBox to repaint and display the new items.
    listBox1.EndUpdate()
    
    ' Select three items from the ListBox.
    listBox1.SetSelected(1, True)
    listBox1.SetSelected(3, True)
    listBox1.SetSelected(5, True)
       
    ' Display the second selected item in the ListBox to the console.
    System.Diagnostics.Debug.WriteLine(listBox1.SelectedItems(1).ToString())
    ' Display the index of the first selected item in the ListBox.
    System.Diagnostics.Debug.WriteLine(listBox1.SelectedIndices(0).ToString())
End Sub

Comentarios

Si la Sorted propiedad de ListBox se establece trueen , el elemento se inserta en la lista alfabéticamente. De lo contrario, el elemento se inserta al final de la lista. Para insertar un elemento en el cuadro de lista en una posición específica, use el Insert método . Para agregar un conjunto de elementos al cuadro de lista en una sola operación, use el AddRange método . Si desea usar el Add método para agregar un gran número de elementos a la lista, use los BeginUpdate métodos y EndUpdate para evitar ListBox que vuelva a pintar cada vez que se agregue un elemento a la lista hasta que se agreguen todos los elementos a la lista. Al agregar elementos a , ListBoxes más eficaz ordenar primero los elementos y, a continuación, agregar nuevos elementos.

Cuando se agrega un objeto a la colección, la ListBox primera comprueba si la DisplayMember propiedad de la ListControl clase tiene el nombre de un miembro del objeto especificado para hacer referencia al obtener el texto del elemento. Si la DisplayMember propiedad no tiene un miembro especificado, ListBox llama al ToString método del objeto para obtener el texto que se va a mostrar en la lista.

Se aplica a