CheckedListBox.ObjectCollection.Add Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

öğeyi öğe listesine CheckedListBoxekler.

Aşırı Yüklemeler

Name	Description
Add(Object, Boolean)	Öğesini, eklenecek nesneyi ve işaretli olup olmadığını belirterek öğeleri listesine CheckedListBoxekler.
Add(Object, CheckState)	bir öğesini öğesi için CheckedListBoxöğe listesine ekler ve eklenecek nesneyi ve ilk denetlenen değeri belirtir.

Add(Object, Boolean)

Kaynak:

CheckedListBox.ObjectCollection.cs

Öğesini, eklenecek nesneyi ve işaretli olup olmadığını belirterek öğeleri listesine CheckedListBoxekler.

public:
 int Add(System::Object ^ item, bool isChecked);

public int Add(object item, bool isChecked);

override this.Add : obj * bool -> int

Public Function Add (item As Object, isChecked As Boolean) As Integer

Parametreler

item

Object

Koleksiyona eklenecek öğeyi temsil eden nesne.

isChecked

Boolean

true öğeyi denetlemek için; aksi takdirde , false.

Döndürülenler

Int32

Yeni eklenen öğenin dizini.

Örnekler

Aşağıdaki kod örneği, , SelectionModeve ThreeDCheckBoxes özelliklerini ayarlayarak bir CheckedListBox denetimi başlatmayı CheckOnClickgösterir. Örnek, öğesini CheckedListBox denetimlerle doldurur ve öğesini denetimin Control.Name özelliğine ayarlarDisplayMember.

Örneği çalıştırmak için aşağıdaki kodu CheckedListBox1 adlı bir CheckedListBox forma yapıştırın ve formun InitializeCheckListBox oluşturucusundan veya Load yönteminden yöntemini çağırın.

   // This method initializes CheckedListBox1 with a list of all 
   // the controls on the form. It sets the selection mode
   // to single selection and allows selection with a single click.
   // It adds itself to the list before adding itself to the form.
internal:
   System::Windows::Forms::CheckedListBox^ CheckedListBox1;

private:
   void InitializeCheckedListBox()
   {
      this->CheckedListBox1 = gcnew CheckedListBox;
      this->CheckedListBox1->Location = System::Drawing::Point( 40, 90 );
      this->CheckedListBox1->CheckOnClick = true;
      this->CheckedListBox1->Name = "CheckedListBox1";
      this->CheckedListBox1->Size = System::Drawing::Size( 120, 94 );
      this->CheckedListBox1->TabIndex = 1;
      this->CheckedListBox1->SelectionMode = SelectionMode::One;
      this->CheckedListBox1->ThreeDCheckBoxes = true;
      System::Collections::IEnumerator^ myEnum = this->Controls->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         Control^ aControl = safe_cast<Control^>(myEnum->Current);
         this->CheckedListBox1->Items->Add( aControl, false );
      }

      this->CheckedListBox1->DisplayMember = "Name";
      this->CheckedListBox1->Items->Add( CheckedListBox1 );
      this->Controls->Add( this->CheckedListBox1 );
   }

// This method initializes CheckedListBox1 with a list of all 
// the controls on the form. It sets the selection mode
// to single selection and allows selection with a single click.
// It adds itself to the list before adding itself to the form.

internal System.Windows.Forms.CheckedListBox CheckedListBox1;

private void InitializeCheckedListBox()
{
    this.CheckedListBox1 = new CheckedListBox();
    this.CheckedListBox1.Location = new System.Drawing.Point(40, 90);
    this.CheckedListBox1.CheckOnClick = true;
    this.CheckedListBox1.Name = "CheckedListBox1";
    this.CheckedListBox1.Size = new System.Drawing.Size(120, 94);
    this.CheckedListBox1.TabIndex = 1;
    this.CheckedListBox1.SelectionMode = SelectionMode.One;
    this.CheckedListBox1.ThreeDCheckBoxes = true;

    foreach ( Control aControl in this.Controls )
    {
        this.CheckedListBox1.Items.Add(aControl, false);
    }

    this.CheckedListBox1.DisplayMember = "Name";
    this.CheckedListBox1.Items.Add(CheckedListBox1);
    this.Controls.Add(this.CheckedListBox1);
}

' This method initializes CheckedListBox1 with a list of all the controls
' on the form. It sets the selection mode to single selection and
' allows selection with a single click. It adds itself to the list before 
' adding itself to the form.
Friend WithEvents CheckedListBox1 As System.Windows.Forms.CheckedListBox

Private Sub InitializeCheckedListBox()
    Me.CheckedListBox1 = New CheckedListBox
    Me.CheckedListBox1.Location = New System.Drawing.Point(40, 90)
    Me.CheckedListBox1.CheckOnClick = True
    Me.CheckedListBox1.Name = "CheckedListBox1"
    Me.CheckedListBox1.Size = New System.Drawing.Size(120, 94)
    Me.CheckedListBox1.TabIndex = 1
    Me.CheckedListBox1.SelectionMode = SelectionMode.One
    Me.CheckedListBox1.ThreeDCheckBoxes = True

    Dim aControl As Control
    For Each aControl In Me.Controls
        Me.CheckedListBox1.Items.Add(aControl, False)
    Next

    Me.CheckedListBox1.DisplayMember = "Name"
    Me.CheckedListBox1.Items.Add(CheckedListBox1)
    Me.Controls.Add(Me.CheckedListBox1)
End Sub

Açıklamalar

Bu yöntem listeye bir öğe ekler. Liste için, öğe var olan öğe listesinin sonuna eklenir. Sıralanmış işaretli liste kutusu için, öğe sıralanmış konumuna göre listeye eklenir. SystemException Yeni öğeyi depolamak için yeterli alan yoksa bir oluşur.

Add(Object, CheckState)

Kaynak:

CheckedListBox.ObjectCollection.cs

bir öğesini öğesi için CheckedListBoxöğe listesine ekler ve eklenecek nesneyi ve ilk denetlenen değeri belirtir.

public:
 int Add(System::Object ^ item, System::Windows::Forms::CheckState check);

public int Add(object item, System.Windows.Forms.CheckState check);

override this.Add : obj * System.Windows.Forms.CheckState -> int

Public Function Add (item As Object, check As CheckState) As Integer

Parametreler

item

Object

Koleksiyona eklenecek öğeyi temsil eden nesne.

check

CheckState

Öğenin denetlenen bölümünün baş harfi CheckState .

Döndürülenler

Int32

Yeni eklenen öğenin dizini.

Özel durumlar

InvalidEnumArgumentException

check parametresi geçerli CheckState değerlerden biri değildir.

Açıklamalar

Bu yöntem, işaretli liste kutusuna bir öğe ekler. Sıralanmamış işaretli liste kutusu için, öğe var olan öğe listesinin sonuna eklenir. Sıralanmış işaretli liste kutusu için, öğe sıralanmış konumuna göre listeye eklenir. SystemException Yeni öğeyi depolamak için yeterli alan yoksa bir oluşur.