CheckedListBox.CheckedItemCollection Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Encapsula a coleção de itens verificados, incluindo itens em um estado indeterminado, em um controle CheckedListBox.

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

Object

CheckedListBox.CheckedItemCollection

Implementações

ICollection IEnumerable IList

Exemplos

O exemplo a seguir enumera os itens verificados no CheckedListBox.CheckedIndexCollection para ver em qual estado de verificação um item está. O exemplo demonstra o uso do GetItemCheckState método para definir o estado de verificação de um item. O exemplo também demonstra o uso da CheckedIndices propriedade para obter o CheckedListBox.CheckedIndexCollectione a CheckedItems propriedade para obter o CheckedListBox.CheckedItemCollection.

O primeiro loop usa o GetItemCheckState método para obter o CheckState de cada item verificado, considerando o índice do item. O segundo loop também usa GetItemCheckState, mas usa o ListBox.ObjectCollection.IndexOf método para recuperar o índice do 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 itens verificados é um subconjunto de todos os itens no CheckedListBox controle; ela contém apenas os itens que estão em um estado verificado ou indeterminado.

A tabela a seguir é um exemplo da coleção indexada de itens no controle (todos os itens contidos no controle).

Índice	Item	Estado de verificação
0	objeto 1	Unchecked
1	objeto 2	Checked
2	objeto 3	Unchecked
3	objeto 4	Indeterminate
4	objeto 5	Checked

Com base no exemplo anterior, a tabela a seguir mostra a coleção indexada dos itens verificados.

Índice	Item
0	objeto 2
1	objeto 4
2	objeto 5

A CheckedListBox classe tem dois membros que permitem acessar os índices armazenados, a Item[] propriedade e o IndexOf método .

Com base no exemplo anterior, uma chamada para a Item[] propriedade com um valor de parâmetro de 1 retorna o objeto 4. Uma chamada para IndexOf com um parâmetro do objeto 4 retorna um valor de 1.

Propriedades

Count	Obtém o número de itens na coleção.
IsReadOnly	Obtém um valor que indica se a coleção é somente leitura.
Item[Int32]	Obtém um objeto na coleção de itens marcados.

Métodos

Contains(Object)	Determina se o item especificado está localizado na coleção.
CopyTo(Array, Int32)	Copia toda a coleção em uma matriz existente de um local especificado na matriz.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Retorna um enumerador que pode ser usado para iterar na coleção CheckedItems.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(Object)	Retorna um índice na coleção de itens selecionados.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

ICollection.IsSynchronized	Para obter uma descrição desse membro, confira IsSynchronized.
ICollection.SyncRoot	Para obter uma descrição desse membro, confira SyncRoot.
IList.Add(Object)	Para obter uma descrição desse membro, confira Add(Object).
IList.Clear()	Para obter uma descrição desse membro, confira Clear().
IList.Insert(Int32, Object)	Para obter uma descrição desse membro, confira Insert(Int32, Object).
IList.IsFixedSize	Para obter uma descrição desse membro, confira IsFixedSize.
IList.Remove(Object)	Para obter uma descrição desse membro, confira Remove(Object).
IList.RemoveAt(Int32)	Para obter uma descrição desse membro, confira RemoveAt(Int32).

Métodos de Extensão