CheckedListBox.CheckedIndexCollection Clase

Definición

Encapsula la colección de índices de elementos activados (incluidos los elementos en un estado indeterminado) en un elemento CheckedListBox.Encapsulates the collection of indexes of checked items (including items in an indeterminate state) in a CheckedListBox.

public: ref class CheckedListBox::CheckedIndexCollection : System::Collections::IList
public class CheckedListBox.CheckedIndexCollection : System.Collections.IList
type CheckedListBox.CheckedIndexCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
Public Class CheckedListBox.CheckedIndexCollection
Implements IList
Herencia
CheckedListBox.CheckedIndexCollection
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 índices activados es un subconjunto de los índices de la colección de todos los elementos CheckedListBox del control.The checked indexes collection is a subset of the indexes into the collection of all items in the CheckedListBox control. Estos índices especifican los elementos en un estado desactivado o indeterminado.These indexes specify items 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 índices de elementos activados.Based on the previous example, the following table shows the indexed collection of indexes of checked items.

ÍndiceIndex Índice del elementoIndex of Item
00 11
11 33
22 44

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 un valor de 3.Based on the previous example, a call to the Item[Int32] property with a parameter value of 1 returns a value of 3. Una llamada a IndexOf con un parámetro de 3 devuelve un valor de 1.A call to IndexOf with a parameter of 3 returns a value of 1.

Propiedades

Count

Obtiene el número de elementos activados.Gets the number of checked items.

IsReadOnly

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

Item[Int32]

Obtiene el índice de un elemento activado del control CheckedListBox.Gets the index of a checked item in the CheckedListBox control.

Métodos

Contains(Int32)

Determina si el índice especificado se encuentra en la colección.Determines whether the specified index 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 CheckedIndices.Returns an enumerator that can be used to iterate through the CheckedIndices collection.

GetHashCode()

Sirve como 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(Int32)

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

MemberwiseClone()

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

(Heredado de Object)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

ICollection.IsSynchronized

Obtiene un valor que indica si el acceso a la interfaz CheckedListBox.CheckedIndexCollection está sincronizado (es seguro para subprocesos).Gets a value indicating whether access to the CheckedListBox.CheckedIndexCollection is synchronized (thread safe).

ICollection.SyncRoot

Obtiene un objeto que puede utilizarse para sincronizar el acceso a la colección de controles.Gets an object that can be used to synchronize access to the collection of controls. Para una descripción de este miembro, vea SyncRoot.For a description of this member, see SyncRoot.

IList.Add(Object)

Agrega un elemento a CheckedListBox.CheckedIndexCollection.Adds an item to the CheckedListBox.CheckedIndexCollection. Para una descripción de este miembro, vea Add(Object).For a description of this member, see Add(Object).

IList.Clear()

Quita todos los elementos de CheckedListBox.CheckedIndexCollection.Removes all items from the CheckedListBox.CheckedIndexCollection. Para obtener una descripción de este miembro, vea Clear().For a description of this member, see Clear().

IList.Contains(Object)

Determina si el índice especificado está ubicado en CheckedListBox.CheckedIndexCollection.Determines whether the specified index is located within the CheckedListBox.CheckedIndexCollection. Para una descripción de este miembro, vea Contains(Object).For a description of this member, see Contains(Object).

IList.IndexOf(Object)

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

IList.Insert(Int32, Object)

Para 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.Item[Int32]

Para una descripción de este miembro, vea Item[Int32].For a description of this member, see Item[Int32].

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)

o una descripción de este miembro, vea RemoveAt(Int32).or 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

Consulte también: