CheckedListBox.ObjectCollection.Add Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Dodaje element do listy elementów dla elementu CheckedListBox.

Przeciążenia

Add(Object, Boolean)	Dodaje element do listy elementów obiektu CheckedListBox, określając obiekt, który ma zostać dodany i czy jest zaznaczony.
Add(Object, CheckState)	Dodaje element do listy elementów obiektu CheckedListBox, określając obiekt do dodania i początkową wartość zaznaczoną.

Add(Object, Boolean)

Dodaje element do listy elementów obiektu CheckedListBox, określając obiekt, który ma zostać dodany i czy jest zaznaczony.

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

Parametry

item

Object

Obiekt reprezentujący element do dodania do kolekcji.

isChecked

Boolean

true aby sprawdzić element; w przeciwnym razie , false.

Zwraca

Int32

Indeks nowo dodanego elementu.

Przykłady

W poniższym przykładzie kodu pokazano inicjowanie kontrolki CheckedListBox przez ustawienie CheckOnClickwłaściwości , SelectionModei ThreeDCheckBoxes . W przykładzie obiekt CheckedListBox jest wypełniany kontrolkami i ustawia DisplayMember Control.Name właściwość na właściwość kontrolki.

Aby uruchomić przykład, wklej następujący kod w formularzu zawierającym CheckedListBox nazwę CheckedListBox1 i wywołaj InitializeCheckListBox metodę z konstruktora lub Load metody formularza.

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

Uwagi

Ta metoda dodaje element do listy. Dla listy element jest dodawany na końcu istniejącej listy elementów. W przypadku posortowanego pola listy zaznaczonej element jest wstawiany do listy zgodnie z jego posortowaną pozycją. Występuje SystemException , jeśli za mało dostępnego miejsca do przechowywania nowego elementu.

Add(Object, CheckState)

Dodaje element do listy elementów obiektu CheckedListBox, określając obiekt do dodania i początkową wartość zaznaczoną.

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

Parametry

item

Object

Obiekt reprezentujący element do dodania do kolekcji.

check

CheckState

Początkowy CheckState dla zaznaczonej części elementu.

Zwraca

Int32

Indeks nowo dodanego elementu.

Wyjątki

InvalidEnumArgumentException

Parametr check nie jest jedną z prawidłowych CheckState wartości.

Uwagi

Ta metoda dodaje element do pola listy zaznaczonej. W przypadku niesortowanego pola listy zaznaczonej element jest dodawany na końcu istniejącej listy elementów. W przypadku posortowanego pola listy zaznaczonej element jest wstawiany do listy zgodnie z jego posortowaną pozycją. Występuje SystemException , jeśli za mało dostępnego miejsca do przechowywania nowego elementu.