CheckedListBox.CheckedItemCollection Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Encapsula la colección de elementos activados, incluidos los elementos en un estado indeterminado, en un control CheckedListBox.

public: ref class CheckedListBox::CheckedItemCollection : System::Collections::IList

public class CheckedListBox.CheckedItemCollection : System.Collections.IList

type CheckedListBox.CheckedItemCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public Class CheckedListBox.CheckedItemCollection
Implements IList

Herencia

Object

CheckedListBox.CheckedItemCollection

Implementaciones

ICollection IEnumerable IList

Ejemplos

En el ejemplo siguiente se enumeran los elementos comprobados en CheckedListBox.CheckedIndexCollection para ver en qué estado de comprobación se encuentra un elemento. En el ejemplo se muestra cómo usar el GetItemCheckState método para establecer el estado de comprobación de un elemento. En el ejemplo también se muestra el uso de la CheckedIndices propiedad para obtener y CheckedListBox.CheckedIndexCollectionla CheckedItems propiedad para obtener .CheckedListBox.CheckedItemCollection

El primer bucle usa el GetItemCheckState método para obtener el CheckState de cada elemento comprobado, dado el índice del elemento. El segundo bucle también usa GetItemCheckState, pero usa el ListBox.ObjectCollection.IndexOf método para recuperar el índice del elemento.

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 de elementos comprobados es un subconjunto de todos los elementos del CheckedListBox control; solo contiene los elementos que están en un estado comprobado o indeterminado.

La tabla siguiente es un ejemplo de la colección indizada de elementos del control (todos los elementos contenidos en el control).

Índice	Elemento	Comprobar estado
0	objeto 1	Unchecked
1	objeto 2	Checked
2	objeto 3	Unchecked
3	objeto 4	Indeterminate
4	objeto 5	Checked

En función del ejemplo anterior, en la tabla siguiente se muestra la colección indizada de los elementos comprobados.

Índice	Elemento
0	objeto 2
1	objeto 4
2	objeto 5

La CheckedListBox clase tiene dos miembros que permiten acceder a los índices almacenados, la Item[] propiedad y el IndexOf método .

Según el ejemplo anterior, una llamada a la Item[] propiedad con un valor de parámetro de 1 devuelve el objeto 4. Una llamada a IndexOf con un parámetro del objeto 4 devuelve un valor de 1.

Propiedades

Count	Obtiene el número de elementos de la colección.
IsReadOnly	Obtiene un valor que indica si la colección es de sólo lectura.
Item[Int32]	Obtiene un objeto de la colección de elementos activados.

Métodos

Contains(Object)	Determina si el elemento especificado se encuentra en la colección.
CopyTo(Array, Int32)	Copia toda la colección en una matriz existente, en un lugar especificado de la matriz.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetEnumerator()	Devuelve un enumerador que puede utilizarse para recorrer en iteración en la colección CheckedItems.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IndexOf(Object)	Devuelve un índice de la colección de elementos activados.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

ICollection.IsSynchronized	Para obtener una descripción de este miembro, vea IsSynchronized.
ICollection.SyncRoot	Para obtener una descripción de este miembro, vea SyncRoot.
IList.Add(Object)	Para obtener una descripción de este miembro, vea Add(Object).
IList.Clear()	Para obtener una descripción de este miembro, vea Clear().
IList.Insert(Int32, Object)	Para obtener una descripción de este miembro, vea Insert(Int32, Object).
IList.IsFixedSize	Para obtener una descripción de este miembro, vea IsFixedSize.
IList.Remove(Object)	Para obtener una descripción de este miembro, vea Remove(Object).
IList.RemoveAt(Int32)	Para obtener una descripción de este miembro, vea RemoveAt(Int32).

Métodos de extensión