CheckedListBox.CheckedIndexCollection Clase

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Encapsula la colección de índices de elementos activados (incluidos los elementos en un estado indeterminado) en un elemento 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: Object
CheckedListBox.CheckedIndexCollection

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 índices comprobados es un subconjunto de los índices en la colección de todos los elementos del CheckedListBox control. Estos índices especifican elementos 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 índices de elementos comprobados.

Índice	Índice de elemento
0	1
1	3
2	4

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 un valor de 3. Una llamada a IndexOf con un parámetro de 3 devuelve un valor de 1.

Propiedades

Count	Obtiene el número de elementos activados.
IsReadOnly	Obtiene un valor que indica si la colección es de solo lectura.
Item[Int32]	Obtiene el índice de un elemento activado del control CheckedListBox.

Métodos

Contains(Int32)	Determina si el índice 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 CheckedIndices.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IndexOf(Int32)	Devuelve un índice de la colección de índices 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	Obtiene un valor que indica si el acceso a la interfaz CheckedListBox.CheckedIndexCollection está sincronizado (es seguro para subprocesos).
ICollection.SyncRoot	Obtiene un objeto que puede utilizarse para sincronizar el acceso a la colección de controles. Para obtener una descripción de este miembro, vea SyncRoot.
IList.Add(Object)	Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código. Agrega un elemento a CheckedListBox.CheckedIndexCollection. Para obtener una descripción de este miembro, vea Add(Object).
IList.Clear()	Quita todos los elementos de CheckedListBox.CheckedIndexCollection. Para obtener una descripción de este miembro, vea Clear().
IList.Contains(Object)	Determina si el índice especificado está ubicado en CheckedListBox.CheckedIndexCollection. Para obtener una descripción de este miembro, vea Contains(Object).
IList.IndexOf(Object)	Para obtener una descripción de este miembro, vea IndexOf(Object).
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.Item[Int32]	Para obtener una descripción de este miembro, vea Item[Int32].
IList.Remove(Object)	Para obtener una descripción de este miembro, vea Remove(Object).
IList.RemoveAt(Int32)	o una descripción de este miembro, vea RemoveAt(Int32).

Métodos de extensión

Cast<TResult>(IEnumerable)	Convierte los elementos de IEnumerable en el tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de IEnumerable en función de un tipo especificado.
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte una interfaz IEnumerable en IQueryable.

Se aplica a