CheckedListBox.ObjectCollection.Add Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Aggiunge un elemento all'elenco di elementi per un oggetto CheckedListBox.

Overload

Nome	Descrizione
Add(Object, Boolean)	Aggiunge un elemento all'elenco di elementi per un CheckedListBoxoggetto , specificando l'oggetto da aggiungere e se è selezionato.
Add(Object, CheckState)	Aggiunge un elemento all'elenco di elementi per un CheckedListBoxoggetto , specificando l'oggetto da aggiungere e il valore selezionato iniziale.

Add(Object, Boolean)

Origine:

CheckedListBox.ObjectCollection.cs

Aggiunge un elemento all'elenco di elementi per un CheckedListBoxoggetto , specificando l'oggetto da aggiungere e se è selezionato.

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

Parametri

item

Object

Oggetto che rappresenta l'elemento da aggiungere all'insieme.

isChecked

Boolean

true per controllare l'elemento; in caso contrario, false.

Restituisce

Int32

Indice dell'elemento appena aggiunto.

Esempio

Nell'esempio di codice seguente viene illustrata l'inizializzazione di un CheckedListBox controllo impostando le CheckOnClickproprietà , SelectionModee ThreeDCheckBoxes . Nell'esempio viene popolato CheckedListBox con controlli e l'oggetto viene DisplayMember impostato sulla Control.Name proprietà del controllo .

Per eseguire l'esempio, incollare il codice seguente in un modulo contenente un CheckedListBox controllo CheckedListBox1 e chiamare il InitializeCheckListBox metodo dal costruttore o Load dal metodo del modulo.

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

Commenti

Questo metodo aggiunge un elemento all'elenco. Per un elenco, l'elemento viene aggiunto alla fine dell'elenco di elementi esistente. Per una casella di riepilogo ordinata, l'elemento viene inserito nell'elenco in base alla posizione ordinata. Si SystemException verifica se lo spazio disponibile non è sufficiente per archiviare il nuovo elemento.

Add(Object, CheckState)

Origine:

CheckedListBox.ObjectCollection.cs

Aggiunge un elemento all'elenco di elementi per un CheckedListBoxoggetto , specificando l'oggetto da aggiungere e il valore selezionato iniziale.

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

Parametri

item

Object

Oggetto che rappresenta l'elemento da aggiungere all'insieme.

check

CheckState

CheckState Iniziale per la parte selezionata dell'elemento.

Restituisce

Int32

Indice dell'elemento appena aggiunto.

Eccezioni

InvalidEnumArgumentException

Il check parametro non è uno dei valori validi CheckState .

Commenti

Questo metodo aggiunge un elemento alla casella di riepilogo selezionata. Per una casella di riepilogo non ordinato, l'elemento viene aggiunto alla fine dell'elenco di elementi esistente. Per una casella di riepilogo ordinata, l'elemento viene inserito nell'elenco in base alla posizione ordinata. Si SystemException verifica se lo spazio disponibile non è sufficiente per archiviare il nuovo elemento.