CheckedListBox.CheckedIndexCollection CheckedListBox.CheckedIndexCollection CheckedListBox.CheckedIndexCollection CheckedListBox.CheckedIndexCollection Class

Definição

Encapsula a coleção de índices de itens verificados (incluindo itens em um estado indeterminado) em um 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
Herança
CheckedListBox.CheckedIndexCollectionCheckedListBox.CheckedIndexCollectionCheckedListBox.CheckedIndexCollectionCheckedListBox.CheckedIndexCollection
Implementações

Exemplos

O exemplo a seguir enumera os itens marcados no CheckedListBox.CheckedIndexCollection para ver em que estado de verificação um item está.The following example enumerates the checked items in the CheckedListBox.CheckedIndexCollection to see what check state an item is in. O exemplo demonstra o uso GetItemCheckState do método para definir o estado de verificação de um item.The example demonstrates using the GetItemCheckState method to set the check state of an item. O exemplo também demonstra o uso CheckedIndices da propriedade para obter CheckedListBox.CheckedIndexCollectiono e a CheckedItems propriedade para obter o CheckedListBox.CheckedItemCollection.The example also demonstrates using the CheckedIndices property to get the CheckedListBox.CheckedIndexCollection, and the CheckedItems property to get the CheckedListBox.CheckedItemCollection.

O primeiro loop usa o GetItemCheckState método para obter o CheckState de cada item selecionado, dado o índice do item.The first loop uses the GetItemCheckState method to get the CheckState of each checked item, given the index of the item. O segundo loop também usa GetItemCheckState, mas usa o ListBox.ObjectCollection.IndexOf método para recuperar o índice do item.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

Comentários

A coleção de índices verificados é um subconjunto dos índices na coleção de todos os itens CheckedListBox no controle.The checked indexes collection is a subset of the indexes into the collection of all items in the CheckedListBox control. Esses índices especificam itens em um estado marcado ou indeterminado.These indexes specify items in a checked or indeterminate state.

A tabela a seguir é um exemplo da coleção indexada de itens no controle (todos os itens contidos no controle).The following table is an example of the indexed collection of items in the control (all items contained in the control).

ÍndiceIndex ItemItem Estado de verificaçãoCheck 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

Com base no exemplo anterior, a tabela a seguir mostra a coleção indexada de índices de itens marcados.Based on the previous example, the following table shows the indexed collection of indexes of checked items.

ÍndiceIndex Índice do itemIndex of Item
00 11
11 33
22 44

A CheckedListBox classe tem dois membros que permitem que você acesse os índices armazenados, Item[Int32] a propriedade e IndexOf o método.The CheckedListBox class has two members that allow you to access the stored indexes, the Item[Int32] property and the IndexOf method.

Com base no exemplo anterior, uma chamada para a Item[Int32] Propriedade com um valor de parâmetro de 1 retorna um 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. Uma chamada para IndexOf com um parâmetro de 3 retorna um valor de 1.A call to IndexOf with a parameter of 3 returns a value of 1.

Propriedades

Count Count Count Count

Obtém o número de itens selecionados.Gets the number of checked items.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Obtém um valor que indica se a coleção é somente leitura.Gets a value indicating whether the collection is read-only.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Obtém o índice de um item selecionado no controle CheckedListBox.Gets the index of a checked item in the CheckedListBox control.

Métodos

Contains(Int32) Contains(Int32) Contains(Int32) Contains(Int32)

Determina se o índice especificado está localizado na coleção.Determines whether the specified index is located in the collection.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Copia toda a coleção em uma matriz existente de um local especificado na matriz.Copies the entire collection into an existing array at a specified location within the array.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Retorna um enumerador que pode ser usado para iterar na coleção CheckedIndices.Returns an enumerator that can be used to iterate through the CheckedIndices collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(Int32) IndexOf(Int32) IndexOf(Int32) IndexOf(Int32)

Retorna um índice na coleção de índices selecionados.Returns an index into the collection of checked indexes.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)

Implantações explícitas de interface

ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Obtém um valor que indica se o acesso à CheckedListBox.CheckedIndexCollection é sincronizado (thread-safe).Gets a value indicating whether access to the CheckedListBox.CheckedIndexCollection is synchronized (thread safe).

ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso à coleção de controels.Gets an object that can be used to synchronize access to the collection of controls. Para obter uma descrição desse membro, consulte SyncRoot.For a description of this member, see SyncRoot.

IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)

Adiciona um item ao CheckedListBox.CheckedIndexCollection.Adds an item to the CheckedListBox.CheckedIndexCollection. Para obter uma descrição desse membro, consulte Add(Object).For a description of this member, see Add(Object).

IList.Clear() IList.Clear() IList.Clear() IList.Clear()

Remove todos os itens do CheckedListBox.CheckedIndexCollection.Removes all items from the CheckedListBox.CheckedIndexCollection. Para obter uma descrição desse membro, consulte Clear().For a description of this member, see Clear().

IList.Contains(Object) IList.Contains(Object) IList.Contains(Object) IList.Contains(Object)

Determina se o índice especificado está localizado dentro do CheckedListBox.CheckedIndexCollection.Determines whether the specified index is located within the CheckedListBox.CheckedIndexCollection. Para obter uma descrição desse membro, consulte Contains(Object).For a description of this member, see Contains(Object).

IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object)

Para obter uma descrição desse membro, consulte IndexOf(Object).For a description of this member, see IndexOf(Object).

IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)

Para obter uma descrição desse membro, consulte Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize

Para obter uma descrição desse membro, consulte IsFixedSize.For a description of this member, see IsFixedSize.

IList.Item[Int32] IList.Item[Int32] IList.Item[Int32] IList.Item[Int32]

Para obter uma descrição desse membro, consulte Item[Int32].For a description of this member, see Item[Int32].

IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

Para obter uma descrição desse membro, consulte Remove(Object).For a description of this member, see Remove(Object).

IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32)

Para obter uma descrição deste membro, consulte RemoveAt(Int32).or a description of this member, see RemoveAt(Int32).

Métodos de Extensão

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Veja também