CheckedListBox.CheckedItemCollection CheckedListBox.CheckedItemCollection CheckedListBox.CheckedItemCollection CheckedListBox.CheckedItemCollection Class

Definição

Encapsula a coleção de itens verificados, incluindo itens em um estado indeterminado, em um controle 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
Herança
CheckedListBox.CheckedItemCollectionCheckedListBox.CheckedItemCollectionCheckedListBox.CheckedItemCollectionCheckedListBox.CheckedItemCollection
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 itens marcados é um subconjunto de todos os itens CheckedListBox no controle; ele contém somente os itens que estão em um estado marcado ou 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.

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 dos itens marcados.Based on the previous example, the following table shows the indexed collection of the checked items.

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

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 o objeto 4.Based on the previous example, a call to the Item[Int32] property with a parameter value of 1 returns object 4. Uma chamada para IndexOf com um parâmetro de objeto 4 retorna um valor de 1.A call to IndexOf with a parameter of object 4 returns a value of 1.

Propriedades

Count Count Count Count

Obtém o número de itens na coleção.Gets the number of items in the collection.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

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

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

Obtém um objeto na coleção de itens marcados.Gets an object in the checked items collection.

Métodos

Contains(Object) Contains(Object) Contains(Object) Contains(Object)

Determina se o item especificado está localizado na coleção.Determines whether the specified item 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 CheckedItems.Returns an enumerator that can be used to iterate through the CheckedItems 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(Object) IndexOf(Object) IndexOf(Object) IndexOf(Object)

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

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

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

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

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)

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()

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

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.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 desse membro, consulte RemoveAt(Int32).For 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