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 cómo usar la CheckedIndices propiedad para obtener CheckedListBox.CheckedIndexCollection y la CheckedItems propiedad para obtener CheckedListBox.CheckedItemCollection .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 del CheckedListBox 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 la Item[] propiedad y al IndexOf método.The CheckedListBox class has two members that allow you to access the stored indexes, the Item[] property and the IndexOf method.
Según el ejemplo anterior, una llamada a la Item[] propiedad con un valor de parámetro de 1 devuelve un valor de 3.Based on the previous example, a call to the Item[] 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 que el 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 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(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 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 |
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 obtener una descripción de este miembro, vea SyncRoot.For a description of this member, see 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.Adds an item to the CheckedListBox.CheckedIndexCollection. Para obtener 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 obtener una descripción de este miembro, vea Contains(Object).For a description of this member, see Contains(Object). |
IList.IndexOf(Object) |
Para obtener una descripción de este miembro, vea IndexOf(Object).For a description of this member, see IndexOf(Object). |
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.Item[Int32] |
Para obtener una descripción de este miembro, vea Item[Int32].For a description of this member, see Item[Int32]. |
IList.Remove(Object) |
Para obtener 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. |