CheckedListBox.ObjectCollection.Add Methode

Quelle:

CheckedListBox.ObjectCollection.cs

Quelle:

CheckedListBox.ObjectCollection.cs

Quelle:

CheckedListBox.ObjectCollection.cs

Quelle:

CheckedListBox.ObjectCollection.cs

Quelle:

CheckedListBox.ObjectCollection.cs

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

Gibt zurück

Der Index des neu hinzugefügten Elements.

Beispiele

Im folgenden Codebeispiel wird die Initialisierung eines CheckedListBox Steuerelements veranschaulicht, indem die CheckOnClickEigenschaften und ThreeDCheckBoxes Die Eigenschaften SelectionModefestgelegt werden. Das Beispiel füllt die CheckedListBox Steuerelemente auf und legt die DisplayMember Eigenschaft Control.Name des Steuerelements fest.

Zum Ausführen des Beispiels fügen Sie den folgenden Code in ein Formular mit dem CheckedListBox Namen CheckedListBox1 ein, 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. Ein SystemException Ereignis tritt auf, wenn nicht genügend Speicherplatz zum Speichern des neuen Elements verfügbar ist.

Quelle:

CheckedListBox.ObjectCollection.cs

Quelle:

CheckedListBox.ObjectCollection.cs

Quelle:

CheckedListBox.ObjectCollection.cs

Quelle:

CheckedListBox.ObjectCollection.cs

Quelle:

CheckedListBox.ObjectCollection.cs

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

Gibt zurück

Der Index des neu hinzugefügten Elements.

Ausnahmen

Hinweise

Mit dieser Methode wird dem aktivierten Listenfeld ein Element hinzugefügt. 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. Ein SystemException Ereignis tritt auf, wenn nicht genügend Speicherplatz zum Speichern des neuen Elements verfügbar ist.