Freigeben über


CheckedListBox.ObjectCollection.Add Methode

Definition

Fügt der Liste von Elementen für eine CheckedListBox ein Element hinzu.

Überlädt

Add(Object, Boolean)

Fügt der Liste von Elementen für eine CheckedListBox ein Element hinzu und gibt dabei das hinzuzufügende Objekt und dessen Aktivierungszustand an.

Add(Object, CheckState)

Fügt der Liste von Elementen für CheckedListBox ein Element hinzu und gibt so das hinzuzufügende Objekt und seinen anfänglichen Aktivierungswert an.

Add(Object, Boolean)

Fügt der Liste von Elementen für eine CheckedListBox ein Element hinzu und gibt dabei das hinzuzufügende Objekt und dessen Aktivierungszustand an.

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

Ein Objekt, das das der Auflistung hinzuzufügende Element darstellt.

isChecked
Boolean

true, um das Element zu aktivieren, andernfalls false.

Gibt zurück

Int32

Der Index des neu hinzugefügten Elements.

Beispiele

Im folgenden Codebeispiel wird die Initialisierung eines CheckedListBox Steuerelements veranschaulicht, indem sie die Eigenschaften SelectionModeund Die CheckOnClickThreeDCheckBoxes Eigenschaften festlegen. Das Beispiel füllt die CheckedListBox Steuerelemente auf und legt die DisplayMember Eigenschaft Control.Name des Steuerelements fest.

Fügen Sie zum Ausführen des Beispiels den folgenden Code in ein Formular ein, das einen CheckedListBox namen "CheckedListBox1" enthält, und rufen Sie die Methode aus dem Konstruktor oder Load der InitializeCheckListBox Methode des Formulars auf.

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

Hinweise

Diese Methode fügt der Liste ein Element hinzu. Für eine Liste wird das Element am Ende der vorhandenen Liste der Elemente hinzugefügt. Bei einem sortierten aktivierten Listenfeld wird das Element entsprechend seiner sortierten Position in die Liste eingefügt. Es SystemException tritt ein, wenn nicht genügend Speicherplatz zum Speichern des neuen Elements verfügbar ist.

Gilt für

Add(Object, CheckState)

Fügt der Liste von Elementen für CheckedListBox ein Element hinzu und gibt so das hinzuzufügende Objekt und seinen anfänglichen Aktivierungswert an.

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

Ein Objekt, das das der Auflistung hinzuzufügende Element darstellt.

check
CheckState

Der anfängliche CheckState für den aktivierten Teil des Elements.

Gibt zurück

Int32

Der Index des neu hinzugefügten Elements.

Ausnahmen

Der check-Parameter ist keiner der gültigen CheckState-Werte.

Hinweise

Diese Methode fügt dem aktivierten Listenfeld ein Element hinzu. Bei einem nicht sortierten aktivierten Listenfeld wird das Element am Ende der vorhandenen Liste der Elemente hinzugefügt. Bei einem sortierten aktivierten Listenfeld wird das Element entsprechend seiner sortierten Position in die Liste eingefügt. Es SystemException tritt ein, wenn nicht genügend Speicherplatz zum Speichern des neuen Elements verfügbar ist.

Gilt für