CheckedListBox.ObjectCollection.Add Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

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

Aşırı Yüklemeler

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

Add(Object, Boolean)

öğesinin öğe listesine, eklenecek nesneyi ve işaretli olup olmadığını belirterek bir öğe 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 ögesini 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 adlandırılmış CheckedListBox1 içeren 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ıralama konumuna göre listeye eklenir. Yeni SystemException öğeyi depolamak için yeterli alan yoksa oluşur.

Add(Object, CheckState)

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

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ıralama konumuna göre listeye eklenir. Yeni SystemException öğeyi depolamak için yeterli alan yoksa oluşur.