ListBox.ObjectCollection.Add(Object) Yöntem

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Bir öğeyi bir öğe için ListBoxöğe listesine ekler.

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

public int Add (object item);

member this.Add : obj -> int

Public Function Add (item As Object) As Integer

Parametreler

item: Object

Koleksiyona eklenecek öğeyi temsil eden nesne.

Döndürülenler

Int32

Koleksiyondaki öğenin sıfır tabanlı dizini veya çağrıldıysa BeginUpdate() -1.

Özel durumlar

SystemException

Yeni öğeyi listeye eklemek için yeterli alan yok.

ArgumentNullException

item, null değeridir.

Örnekler

Aşağıdaki kod örneği, birden çok öğeyi sütunlarda görüntüleyen ve denetimin listesinde birden fazla öğe seçebilen bir ListBox denetimin nasıl oluşturulacağını gösterir. Örneğin kodu, sınıfının yöntemini ListBox.ObjectCollection kullanarak Add öğesine 50 öğe ListBox ekler ve ardından yöntemini kullanarak SetSelected listeden üç öğe seçer. Kod daha sonra koleksiyondaki ListBox.SelectedObjectCollection (özelliği aracılığıyla SelectedItems ) ve ListBox.SelectedIndexCollection (özelliği aracılığıyla SelectedIndices ) değerleri görüntüler. Bu örnek, kodun içinde bulunması ve dosyasından Formçağrıldığını gerektirir.

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

Açıklamalar

öğesinin Sorted ListBox özelliği olarak ayarlanırsa true, öğe alfabetik olarak listeye eklenir. Aksi takdirde, öğe listenin sonuna eklenir. Liste kutusuna belirli bir konumda öğe eklemek için yöntemini kullanın Insert . Tek bir işlemde liste kutusuna öğe kümesi eklemek için yöntemini kullanın AddRange . Listeye çok sayıda öğe eklemek için yöntemini kullanmak Add istiyorsanız, tüm öğeler listeye eklenene kadar bir öğe listeye her eklendiğinde öğesinin yeniden boyanmasını önlemek ListBox için ve EndUpdate yöntemlerini kullanınBeginUpdate. öğesine ListBoxöğe eklerken, önce öğeleri sıralamak ve sonra yeni öğeler eklemek daha verimlidir.

Koleksiyona bir nesne eklendiğinde, ListBox ilk olarak sınıfın özelliğinin ListControl öğe metni alınırken başvurulmak üzere belirtilen nesneden bir üyenin adına sahip olup olmadığını DisplayMember denetler. Özelliğin DisplayMember belirtilen bir üyesi yoksa, ListBox nesnenin yöntemini çağırarak ToString listede görüntülenecek metni alır.

Şunlara uygulanır

Aracılığıyla paylaş