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

Definizione

Incapsula la raccolta di elementi controllati, inclusi gli elementi in uno stato indeterminato, in un controllo 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
Ereditarietà
CheckedListBox.CheckedItemCollectionCheckedListBox.CheckedItemCollectionCheckedListBox.CheckedItemCollectionCheckedListBox.CheckedItemCollection
Implementazioni

Esempi

Nell'esempio seguente enumera gli elementi selezionati nel CheckedListBox.CheckedIndexCollection per vedere cosa verificare lo stato di un elemento si trova.The following example enumerates the checked items in the CheckedListBox.CheckedIndexCollection to see what check state an item is in. Nell'esempio viene illustrato l'utilizzo di GetItemCheckState metodo per impostare lo stato di selezione di un elemento.The example demonstrates using the GetItemCheckState method to set the check state of an item. Nell'esempio viene inoltre illustrato l'utilizzo di CheckedIndices proprietà da ottenere il CheckedListBox.CheckedIndexCollectione il CheckedItems proprietà da ottenere la CheckedListBox.CheckedItemCollection.The example also demonstrates using the CheckedIndices property to get the CheckedListBox.CheckedIndexCollection, and the CheckedItems property to get the CheckedListBox.CheckedItemCollection.

Il primo ciclo viene utilizzato il GetItemCheckState metodo per ottenere il CheckState di ogni elementi selezionati in base all'indice dell'elemento.The first loop uses the GetItemCheckState method to get the CheckState of each checked item, given the index of the item. Il secondo ciclo anche utilizzi GetItemCheckState, ma usa il ListBox.ObjectCollection.IndexOf metodo per recuperare l'indice dell'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

Commenti

La raccolta di elementi controllati è un subset di tutti gli elementi di CheckedListBox controllare; contiene solo gli elementi che si trovano nello stato selezionato o indeterminato.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.

Nella tabella seguente è riportato un esempio della raccolta indicizzata di elementi nel controllo (tutti gli elementi contenuti nel controllo).The following table is an example of the indexed collection of items in the control (all items contained in the control).

IndiceIndex ElementoItem Controllo dello statoCheck State
00 Oggetto 1object 1 Unchecked
11 Oggetto 2object 2 Checked
22 Oggetto 3object 3 Unchecked
33 Oggetto 4object 4 Indeterminate
44 Oggetto 5object 5 Checked

Basato sull'esempio precedente, nella tabella seguente mostra la raccolta indicizzata di elementi selezionati.Based on the previous example, the following table shows the indexed collection of the checked items.

IndiceIndex ElementoItem
00 Oggetto 2object 2
11 Oggetto 4object 4
22 Oggetto 5object 5

Il CheckedListBox classe contiene due membri che consentono di accedere agli indici, stored il Item[Int32] proprietà e il IndexOf (metodo).The CheckedListBox class has two members that allow you to access the stored indexes, the Item[Int32] property and the IndexOf method.

In base all'esempio precedente, una chiamata al Item[Int32] proprietà con un valore del parametro 1 restituisce l'oggetto 4.Based on the previous example, a call to the Item[Int32] property with a parameter value of 1 returns object 4. Una chiamata a IndexOf con un parametro dell'oggetto 4 restituisce un valore pari a 1.A call to IndexOf with a parameter of object 4 returns a value of 1.

Proprietà

Count Count Count Count

Ottiene il numero di elementi nella raccolta.Gets the number of items in the collection.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Ottiene un valore che indica se l'insieme è in sola lettura.Gets a value indicating if the collection is read-only.

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

Ottiene un oggetto nell'insieme di elementi selezionati.Gets an object in the checked items collection.

Metodi

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

Consente di determinare se l'elemento specificato è contenuto nell'insieme.Determines whether the specified item is located in the collection.

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

Copia l'intero insieme in una posizione specifica all'interno di una matrice esistente.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 l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

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

Restituisce un enumeratore che può essere utilizzato per scorrere l'insieme CheckedItems.Returns an enumerator that can be used to iterate through the CheckedItems collection.

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

Funge da funzione hash predefinita.Serves as the default hash function.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

Restituisce un indice nell'insieme di elementi selezionati.Returns an index into the collection of checked items.

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

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

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

Per una descrizione di questo membro, vedere IsSynchronized.For a description of this member, see IsSynchronized.

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

Per una descrizione di questo membro, vedere SyncRoot.For a description of this member, see SyncRoot.

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

Per una descrizione di questo membro, vedere Add(Object).For a description of this member, see Add(Object).

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

Per una descrizione di questo membro, vedere 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)

Per una descrizione di questo membro, vedere Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

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

Per una descrizione di questo membro, vedere IsFixedSize.For a description of this member, see IsFixedSize.

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

Per una descrizione di questo membro, vedere Remove(Object).For a description of this member, see Remove(Object).

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

Per una descrizione di questo membro, vedere RemoveAt(Int32).For a description of this member, see RemoveAt(Int32).

Extension Methods

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

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

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

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

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

Consente la parallelizzazione di una query.Enables parallelization of a query.

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

Converte un' IEnumerable a un IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a