CheckedListBox.ObjectCollection.Add Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Agrega un elemento a la lista de elementos de un CheckedListBox.

Sobrecargas

Nombre	Description
Add(Object, Boolean)	Agrega un elemento a la lista de elementos de , CheckedListBoxespecificando el objeto que se va a agregar y si está activado.
Add(Object, CheckState)	Agrega un elemento a la lista de elementos de , CheckedListBoxespecificando el objeto que se va a agregar y el valor comprobado inicial.

Add(Object, Boolean)

Source:

CheckedListBox.ObjectCollection.cs

Agrega un elemento a la lista de elementos de , CheckedListBoxespecificando el objeto que se va a agregar y si está activado.

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

Parámetros

item

Object

Objeto que representa el elemento que se va a agregar a la colección.

isChecked

Boolean

true para comprobar el elemento; de lo contrario, false.

Devoluciones

Int32

Índice del elemento recién agregado.

Ejemplos

En el ejemplo de código siguiente se muestra cómo inicializar un CheckedListBox control estableciendo las CheckOnClickpropiedades , SelectionModey ThreeDCheckBoxes . En el ejemplo se rellenan los CheckedListBox controles con y se establece en DisplayMember la Control.Name propiedad del control .

Para ejecutar el ejemplo, pegue el código siguiente en un formulario que contiene un CheckedListBox elemento denominado CheckedListBox1 y llame al InitializeCheckListBox método desde el constructor o Load método del formulario.

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

Comentarios

Este método agrega un elemento a la lista. Para una lista, el elemento se agrega al final de la lista de elementos existente. Para un cuadro de lista ordenado, el elemento se inserta en la lista según su posición ordenada. Se SystemException produce si no hay espacio suficiente disponible para almacenar el nuevo elemento.

Add(Object, CheckState)

Source:

CheckedListBox.ObjectCollection.cs

Agrega un elemento a la lista de elementos de , CheckedListBoxespecificando el objeto que se va a agregar y el valor comprobado inicial.

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

Parámetros

item

Object

Objeto que representa el elemento que se va a agregar a la colección.

check

CheckState

Inicial CheckState de la parte seleccionada del elemento.

Devoluciones

Int32

Índice del elemento recién agregado.

Excepciones

InvalidEnumArgumentException

El check parámetro no es uno de los valores válidos CheckState .

Comentarios

Este método agrega un elemento a la casilla de lista activada. Para un cuadro de lista no ordenado, el elemento se agrega al final de la lista de elementos existente. Para un cuadro de lista ordenado, el elemento se inserta en la lista según su posición ordenada. Se SystemException produce si no hay espacio suficiente disponible para almacenar el nuevo elemento.