CheckedListBox.CheckedItems Propiedad

Definición

Colección de elementos activados en CheckedListBox.Collection of checked items in this CheckedListBox.

public:
 property System::Windows::Forms::CheckedListBox::CheckedItemCollection ^ CheckedItems { System::Windows::Forms::CheckedListBox::CheckedItemCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.CheckedListBox.CheckedItemCollection CheckedItems { get; }
member this.CheckedItems : System.Windows.Forms.CheckedListBox.CheckedItemCollection
Public ReadOnly Property CheckedItems As CheckedListBox.CheckedItemCollection

Valor de propiedad

Atributos

Ejemplos

En el ejemplo siguiente se enumeran los elementos activados en la CheckedListBox.CheckedIndexCollection para ver en qué estado de activación está un elemento.The following example enumerates the checked items in the CheckedListBox.CheckedIndexCollection to see what check state an item is in. En el ejemplo se muestra el uso de la propiedad CheckedIndices para obtener el CheckedListBox.CheckedIndexCollectiony la propiedad CheckedItems para obtener el CheckedListBox.CheckedItemCollection.The example demonstrates using the CheckedIndices property to get the CheckedListBox.CheckedIndexCollection, and the CheckedItems property to get the CheckedListBox.CheckedItemCollection.

El primer bucle usa el método GetItemCheckState para obtener el CheckState de cada elemento activado, dado el índice del elemento.The first loop uses the GetItemCheckState method to get the CheckState of each checked item, given the index of the item. El segundo bucle también utiliza GetItemCheckState, pero usa el método ListBox.ObjectCollection.IndexOf para recuperar el índice del elemento.The second loop also uses GetItemCheckState, but uses the ListBox.ObjectCollection.IndexOf method to retrieve the index for the item.

Para ejecutar este ejemplo, realice los pasos siguientes:To run this example, perform the following steps:

  1. Cree una nueva aplicación de Windows Forms.Create a new Windows Forms application.

  2. Agregue un CheckedListBox y un Button al formulario.Add a CheckedListBox and a Button to the form.

  3. Asigne al botón el nombre WhatIsChecked, agregue un controlador para su evento Click y copie en el código del cuerpo del siguiente controlador.Name the button WhatIsChecked, add a handler for its Click event, and copy in the code from the body of the following handler.

  4. Agregue algunos elementos a la CheckedListBox.Add some items to the CheckedListBox.

  5. Ejecute el ejemplo y active algunas de las casillas de verificación del cuadro de lista.Run the example and check some of the check boxes in the list box.

  6. Haga clic en el botón.Click the button.

    Verá una serie de cuadros de mensaje que indican qué elementos se comprobó.You will see a series of message boxes that indicate which items were checked.

void WhatIsChecked_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   
   // Display in a message box all the items that are checked.
   // First show the index and check state of all selected items.
   IEnumerator^ myEnum1 = checkedListBox1->CheckedIndices->GetEnumerator();
   while ( myEnum1->MoveNext() )
   {
      Int32 indexChecked =  *safe_cast<Int32^>(myEnum1->Current);
      
      // The indexChecked variable contains the index of the item.
      MessageBox::Show( String::Concat( "Index#: ", indexChecked, ", is checked. Checked state is: ", checkedListBox1->GetItemCheckState( indexChecked ), "." ) );
   }

   
   // Next show the Object* title and check state for each item selected.
   IEnumerator^ myEnum2 = checkedListBox1->CheckedItems->GetEnumerator();
   while ( myEnum2->MoveNext() )
   {
      Object^ itemChecked = safe_cast<Object^>(myEnum2->Current);
      
      // Use the IndexOf method to get the index of an item.
      MessageBox::Show( String::Concat( "Item with title: \"", itemChecked, "\", is checked. Checked state is: ", checkedListBox1->GetItemCheckState( checkedListBox1->Items->IndexOf( itemChecked ) ), "." ) );
   }
}


private void WhatIsChecked_Click(object sender, System.EventArgs e) {
    // Display in a message box all the items that are checked.

    // First show the index and check state of all selected items.
    foreach(int indexChecked in checkedListBox1.CheckedIndices) {
        // The indexChecked variable contains the index of the item.
        MessageBox.Show("Index#: " + indexChecked.ToString() + ", is checked. Checked state is:" +
                        checkedListBox1.GetItemCheckState(indexChecked).ToString() + ".");
    }

    // Next show the object title and check state for each item selected.
    foreach(object itemChecked in checkedListBox1.CheckedItems) {

        // Use the IndexOf method to get the index of an item.
        MessageBox.Show("Item with title: \"" + itemChecked.ToString() + 
                        "\", is checked. Checked state is: " + 
                        checkedListBox1.GetItemCheckState(checkedListBox1.Items.IndexOf(itemChecked)).ToString() + ".");
    }

}
Private Sub WhatIsChecked_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles WhatIsChecked.Click
    ' Display in a message box all the items that are checked.
    Dim indexChecked As Integer
    Dim itemChecked As Object
    Const quote As String = """"

    ' First show the index and check state of all selected items.
    For Each indexChecked In CheckedListBox1.CheckedIndices
        ' The indexChecked variable contains the index of the item.
        MessageBox.Show("Index#: " + indexChecked.ToString() + ", is checked. Checked state is:" + _
                        CheckedListBox1.GetItemCheckState(indexChecked).ToString() + ".")
    Next

    ' Next show the object title and check state for each item selected.
    For Each itemChecked In CheckedListBox1.CheckedItems

        ' Use the IndexOf method to get the index of an item.
        MessageBox.Show("Item with title: " + quote + itemChecked.ToString() + quote + _
                        ", is checked. Checked state is: " + _
                        CheckedListBox1.GetItemCheckState(CheckedListBox1.Items.IndexOf(itemChecked)).ToString() + ".")
    Next

End Sub

Comentarios

La colección es un subconjunto de los objetos de la colección Items, que representan solo los elementos cuyo System.Windows.Forms.CheckState es Checked o Indeterminate.The collection is a subset of the objects in the Items collection, representing only those items whose System.Windows.Forms.CheckState is Checked or Indeterminate. Los índices de esta colección están en orden ascendente.The indexes in this collection are in ascending order.

Se aplica a

Consulte también: