CheckedListBox.ObjectCollection.Add Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menambahkan item ke daftar item untuk CheckedListBox.

Overload

Nama	Deskripsi
Add(Object, Boolean)	Menambahkan item ke daftar item untuk CheckedListBox, menentukan objek yang akan ditambahkan dan apakah item tersebut dicentang.
Add(Object, CheckState)	Menambahkan item ke daftar item untuk CheckedListBox, menentukan objek yang akan ditambahkan dan nilai awal yang dicentang.

Add(Object, Boolean)

Sumber:

CheckedListBox.ObjectCollection.cs

Menambahkan item ke daftar item untuk CheckedListBox, menentukan objek yang akan ditambahkan dan apakah item tersebut dicentang.

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

Parameter

item

Object

Objek yang mewakili item untuk ditambahkan ke koleksi.

isChecked

Boolean

true untuk memeriksa item; jika tidak, false.

Mengembalikan

Int32

Indeks item yang baru ditambahkan.

Contoh

Contoh kode berikut menunjukkan inisialisasi CheckedListBox kontrol dengan mengatur CheckOnClickproperti , SelectionMode, dan ThreeDCheckBoxes . Contoh mengisi CheckedListBox dengan kontrol dan mengatur ke DisplayMemberControl.Name properti kontrol.

Untuk menjalankan contoh, tempelkan kode berikut dalam formulir yang CheckedListBox berisi checkedListBox1 dan panggil InitializeCheckListBox metode dari konstruktor atau Load metode formulir.

   // 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

Keterangan

Metode ini menambahkan item ke daftar. Untuk daftar, item ditambahkan ke akhir daftar item yang sudah ada. Untuk kotak daftar yang diurutkan, item disisipkan ke dalam daftar sesuai dengan posisinya yang diurutkan. SystemException Terjadi jika tidak ada cukup ruang yang tersedia untuk menyimpan item baru.

Add(Object, CheckState)

Sumber:

CheckedListBox.ObjectCollection.cs

Menambahkan item ke daftar item untuk CheckedListBox, menentukan objek yang akan ditambahkan dan nilai awal yang dicentang.

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

Parameter

item

Object

Objek yang mewakili item untuk ditambahkan ke koleksi.

check

CheckState

CheckState Awal untuk bagian item yang dicentang.

Mengembalikan

Int32

Indeks item yang baru ditambahkan.

Pengecualian

InvalidEnumArgumentException

Parameter check bukan salah satu nilai yang valid CheckState .

Keterangan

Metode ini menambahkan item ke kotak daftar yang dicentang. Untuk kotak daftar yang tidak diurutkan, item ditambahkan ke akhir daftar item yang sudah ada. Untuk kotak daftar yang diurutkan, item disisipkan ke dalam daftar sesuai dengan posisinya yang diurutkan. SystemException Terjadi jika tidak ada cukup ruang yang tersedia untuk menyimpan item baru.