CheckedListBox.CheckedItemCollection Clase

Definición

Encapsula la colección de elementos activados, incluidos los elementos en un estado indeterminado, en un control CheckedListBox.Encapsulates the collection of checked items, including items in an indeterminate state, in a CheckedListBox control.

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
CheckedListBox.CheckedItemCollection
Implementaciones

Ejemplos

En el ejemplo siguiente se enumeran los elementos activados en 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 GetItemCheckState cómo utilizar el método para establecer el estado de comprobación de un elemento.The example demonstrates using the GetItemCheckState method to set the check state of an item. En el ejemplo también se muestra CheckedIndices cómo usar la propiedad CheckedListBox.CheckedIndexCollectionpara obtener y CheckedItems CheckedListBox.CheckedItemCollectionla propiedad para obtener.The example also demonstrates using the CheckedIndices property to get the CheckedListBox.CheckedIndexCollection, and the CheckedItems property to get the CheckedListBox.CheckedItemCollection.

El primer bucle usa el GetItemCheckState método 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 ListBox.ObjectCollection.IndexOf método 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.

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 activados es un subconjunto de todos CheckedListBox los elementos del control; contiene solo los elementos que se encuentran en un estado desactivado o indeterminado.The checked items collection is a subset of all items in the CheckedListBox control; it contains only those items that are in a checked or indeterminate state.

La tabla siguiente es un ejemplo de la colección indizada de elementos del control (todos los elementos contenidos en el control).The following table is an example of the indexed collection of items in the control (all items contained in the control).

ÍndiceIndex ElementoItem Comprobar estadoCheck State
00 objeto 1object 1 Unchecked
11 objeto 2object 2 Checked
22 objeto 3object 3 Unchecked
33 objeto 4object 4 Indeterminate
44 objeto 5object 5 Checked

Según el ejemplo anterior, en la tabla siguiente se muestra la colección indizada de los elementos activados.Based on the previous example, the following table shows the indexed collection of the checked items.

ÍndiceIndex ElementoItem
00 objeto 2object 2
11 objeto 4object 4
22 objeto 5object 5

La CheckedListBox clase tiene dos miembros que le permiten tener acceso a los índices almacenados, a Item[Int32] la propiedad y IndexOf al método.The CheckedListBox class has two members that allow you to access the stored indexes, the Item[Int32] property and the IndexOf method.

Según el ejemplo anterior, una llamada a la Item[Int32] propiedad con un valor de parámetro de 1 devuelve el objeto 4.Based on the previous example, a call to the Item[Int32] property with a parameter value of 1 returns object 4. Una llamada a IndexOf con un parámetro de Object 4 devuelve un valor de 1.A call to IndexOf with a parameter of object 4 returns a value of 1.

Propiedades

Count

Obtiene el número de elementos de la colección.Gets the number of items in the collection.

IsReadOnly

Obtiene un valor que indica si la colección es de sólo lectura.Gets a value indicating if the collection is read-only.

Item[Int32]

Obtiene un objeto de la colección de elementos activados.Gets an object in the checked items collection.

Métodos

Contains(Object)

Determina si el elemento especificado se encuentra en la colección.Determines whether the specified item is located in the collection.

CopyTo(Array, Int32)

Copia toda la colección en una matriz existente, en un lugar especificado de la matriz.Copies the entire collection into an existing array at a specified location within the array.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetEnumerator()

Devuelve un enumerador que puede utilizarse para recorrer en iteración en la colección CheckedItems.Returns an enumerator that can be used to iterate through the CheckedItems collection.

GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IndexOf(Object)

Devuelve un índice de la colección de elementos activados.Returns an index into the collection of checked items.

MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

ICollection.IsSynchronized

Para una descripción de este miembro, vea IsSynchronized.For a description of this member, see IsSynchronized.

ICollection.SyncRoot

Para una descripción de este miembro, vea SyncRoot.For a description of this member, see SyncRoot.

IList.Add(Object)

Para una descripción de este miembro, vea Add(Object).For a description of this member, see Add(Object).

IList.Clear()

Para una descripción de este miembro, vea Clear().For a description of this member, see Clear().

IList.Insert(Int32, Object)

Para obtener una descripción de este miembro, vea Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

IList.IsFixedSize

Para obtener una descripción de este miembro, vea IsFixedSize.For a description of this member, see IsFixedSize.

IList.Remove(Object)

Para una descripción de este miembro, vea Remove(Object).For a description of this member, see Remove(Object).

IList.RemoveAt(Int32)

Para obtener una descripción de este miembro, vea RemoveAt(Int32).For a description of this member, see RemoveAt(Int32).

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a