CheckedListBox.CheckedIndexCollection Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Kapselt die Auflistung der Indizes der aktivierten Elemente in einem CheckedListBox (einschließlich der Elemente in unbestimmtem Zustand).

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

Vererbung: Object
CheckedListBox.CheckedIndexCollection

Implementiert: ICollection IEnumerable IList

Beispiele

Im folgenden Beispiel werden die eingecheckten Elemente im CheckedListBox.CheckedIndexCollection folgenden Beispiel aufgezählt, um zu sehen, in welchem Zustand ein Element vorhanden ist. Das Beispiel veranschaulicht die Verwendung der GetItemCheckState Methode zum Festlegen des Prüfzustands eines Elements. Im Beispiel wird auch die Verwendung der Eigenschaft veranschaulicht, um die CheckedIndices CheckedListBox.CheckedIndexCollectionEigenschaft abzurufen, und die CheckedItems Eigenschaft zum Abrufen der CheckedListBox.CheckedItemCollectionEigenschaft .

Die erste Schleife verwendet die Methode, um die GetItemCheckState einzelnen überprüften Elemente abzurufen, da der CheckState Index des Elements angegeben ist. Die zweite Schleife verwendet GetItemCheckStateauch ListBox.ObjectCollection.IndexOf die Methode, um den Index für das Element abzurufen.

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

Hinweise

Die überprüfte Indexsammlung ist eine Teilmenge der Indizes in der Auflistung aller Elemente im CheckedListBox Steuerelement. Diese Indizes geben Elemente in einem überprüften oder unbestimmten Zustand an.

Die folgende Tabelle ist ein Beispiel für die indizierte Auflistung von Elementen im Steuerelement (alle Elemente, die im Steuerelement enthalten sind).

Index	Artikel	Status überprüfen
0	Objekt 1	Unchecked
1	Objekt 2	Checked
2	Objekt 3	Unchecked
3	Objekt 4	Indeterminate
4	Objekt 5	Checked

Basierend auf dem vorherigen Beispiel zeigt die folgende Tabelle die indizierte Auflistung von Indizes von überprüften Elementen.

Index	Index des Elements
0	1
1	3
2	4

Die CheckedListBox Klasse verfügt über zwei Elemente, mit denen Sie auf die gespeicherten Indizes, Item[] die Eigenschaft und die IndexOf Methode zugreifen können.

Basierend auf dem vorherigen Beispiel gibt ein Aufruf der Item[] Eigenschaft mit einem Parameterwert von 1 einen Wert von 3 zurück. Ein Aufruf mit IndexOf einem Parameter von 3 gibt einen Wert von 1 zurück.

Eigenschaften

Count	Ruft die Anzahl aktivierter Elemente ab.
IsReadOnly	Ruft einen Wert ab, der angibt, ob die Auflistung schreibgeschützt ist.
Item[Int32]	Ruft den Index eines aktivierten Elements im CheckedListBox-Steuerelement ab.

Methoden

Contains(Int32)	Bestimmt, ob der angegebene Index in der Auflistung enthalten ist.
CopyTo(Array, Int32)	Kopiert die gesamte Auflistung an eine angegebene Position in einem vorhandenen Array.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetEnumerator()	Gibt einen Enumerator zurück, mit dem die CheckedIndices-Auflistung durchlaufen werden kann.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IndexOf(Int32)	Gibt einen Index in der Auflistung von Indizes markierter Elemente zurück.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICollection.IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die CheckedListBox.CheckedIndexCollection synchronisiert (threadsicher) ist.
ICollection.SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf die Steuerelementauflistung synchronisiert werden kann Eine Beschreibung dieses Elements finden Sie unter SyncRoot.
IList.Add(Object)	Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht. Fügt der CheckedListBox.CheckedIndexCollection ein Element hinzu. Eine Beschreibung dieses Elements finden Sie unter Add(Object).
IList.Clear()	Entfernt alle Elemente aus CheckedListBox.CheckedIndexCollection. Eine Beschreibung dieses Elements finden Sie unter Clear().
IList.Contains(Object)	Bestimmt, ob der angegebene Index in der CheckedListBox.CheckedIndexCollection enthalten ist. Eine Beschreibung dieses Elements finden Sie unter Contains(Object).
IList.IndexOf(Object)	Eine Beschreibung dieses Elements finden Sie unter IndexOf(Object).
IList.Insert(Int32, Object)	Eine Beschreibung dieses Elements finden Sie unter Insert(Int32, Object).
IList.IsFixedSize	Eine Beschreibung dieses Elements finden Sie unter IsFixedSize.
IList.Item[Int32]	Eine Beschreibung dieses Elements finden Sie unter Item[Int32].
IList.Remove(Object)	Eine Beschreibung dieses Elements finden Sie unter Remove(Object).
IList.RemoveAt(Int32)	Eine Beschreibung dieses Members finden Sie unter RemoveAt(Int32).

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Gilt für

Freigeben über