CheckedListBox.CheckedItems Propriedade

public:
 property System::Windows::Forms::CheckedListBox::CheckedItemCollection ^ CheckedItems { System::Windows::Forms::CheckedListBox::CheckedItemCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.CheckedListBox.CheckedItemCollection CheckedItems { get; }

[<System.ComponentModel.Browsable(false)>]
member this.CheckedItems : System.Windows.Forms.CheckedListBox.CheckedItemCollection

Public ReadOnly Property CheckedItems As CheckedListBox.CheckedItemCollection

Valor de Propriedade

A CheckedListBox.CheckedItemCollection coleção para o CheckedListBox.

Atributos

BrowsableAttribute

Exemplos

O exemplo seguinte enumera os itens verificados para CheckedListBox.CheckedIndexCollection ver em que estado de verificação um item está. O exemplo demonstra o uso da CheckedIndices propriedade para obter o CheckedListBox.CheckedIndexCollection, e da CheckedItems propriedade para obter o CheckedListBox.CheckedItemCollection.

O primeiro ciclo utiliza o GetItemCheckState método para obter o CheckState de cada item verificado, dado o índice do item. O segundo ciclo também usa GetItemCheckState, mas usa o ListBox.ObjectCollection.IndexOf método para recuperar o índice do item.

Para executar este exemplo, execute os seguintes passos:

1. Crie um novo aplicativo do Windows Forms.

2. Adicione a CheckedListBox e a Button ao formulário.

3. Dá nome ao botão WhatIsChecked, adiciona um handler para o seu Click evento e copia o código do corpo do handler seguinte.

4. Adicione alguns itens ao CheckedListBox.

5. Executa o exemplo e assinala algumas das caixas de seleção na caixa da lista.

6. Clique no botão.

   Verá uma série de caixas de mensagens que indicam quais os itens que foram assinalados.

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

Observações

A coleção é um subconjunto dos objetos da coleção Items, representando apenas aqueles itens cujo System.Windows.Forms.CheckState é Checked ou Indeterminate. Os índices desta coleção estão por ordem crescente.

Ver também

• CheckedListBox.CheckedItemCollection