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

Nazwa	Opis
Add(Object, Boolean)	Dodaje element do listy elementów obiektu CheckedListBox, określając obiekt do dodania i czy jest zaznaczony.
Add(Object, CheckState)	Dodaje element do listy elementów dla CheckedListBoxobiektu , określając obiekt do dodania i początkową wartość zaznaczoną.

Add(Object, Boolean)

Źródło:

CheckedListBox.ObjectCollection.cs

Dodaje element do listy elementów obiektu CheckedListBox, określając obiekt do dodania 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 . Przykład wypełnia kontrolki CheckedListBox kontrolką i ustawia DisplayMember właściwość na Control.Name 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. W przypadku 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 posortowaną pozycją. Występuje SystemException , jeśli do przechowywania nowego elementu jest za mało miejsca.

Add(Object, CheckState)

Źródło:

CheckedListBox.ObjectCollection.cs

Dodaje element do listy elementów dla CheckedListBoxobiektu , 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 niezasortowanego 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 posortowaną pozycją. Występuje SystemException , jeśli do przechowywania nowego elementu jest za mało miejsca.