CheckedListBox.ObjectCollection.Add Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

Overload

Add(Object, Boolean)

Consente di aggiungere un elemento all'elenco di elementi di un controllo CheckedListBox, specificando l'oggetto da aggiungere e se è selezionato.
Add(Object, CheckState)

Consente di aggiungere un elemento all'elenco di elementi di un controllo CheckedListBox, specificando l'oggetto da aggiungere e il valore di selezione iniziale.

Add(Object, Boolean)

Consente di aggiungere un elemento all'elenco di elementi di un controllo CheckedListBox, 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 selezionare l'elemento; in caso contrario, false.

Restituisce

Int32

Indice dell'elemento appena aggiunto.

Esempio

Nell'esempio di codice seguente viene illustrato l'inizializzazione di un CheckedListBox controllo impostando le CheckOnClickproprietà , SelectionModee ThreeDCheckBoxes . L'esempio popola l'oggetto CheckedListBox con i controlli e imposta l'oggetto DisplayMember sulla Control.Name proprietà del controllo.

Per eseguire l'esempio, incollare il codice seguente in un modulo contenente un CheckedListBox oggetto CheckedListBox1 e chiamare il metodo dal costruttore o Load dal InitializeCheckListBox 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 esistente di elementi. Per una casella di riepilogo ordinata, l'elemento viene inserito nell'elenco in base alla posizione ordinata. Si SystemException verifica se non è disponibile spazio sufficiente per archiviare il nuovo elemento.

Si applica a

Add(Object, CheckState)

Consente di aggiungere un elemento all'elenco di elementi di un controllo CheckedListBox, specificando l'oggetto da aggiungere e il valore di selezione 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

Oggetto CheckState iniziale della parte selezionata dell'elemento.

Restituisce

Int32

Indice dell'elemento appena aggiunto.

Eccezioni

InvalidEnumArgumentException

Il parametro check non è uno dei valori validi di CheckState.

Commenti

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

Si applica a