(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

CheckedListBox.CheckedItemCollection-Klasse

Kapselt die Auflistung markierter Elemente (einschließlich der Elemente in unbestimmtem Zustand) in einem CheckedListBox-Steuerelement.

System.Object
  System.Windows.Forms.CheckedListBox.CheckedItemCollection

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public class CheckedItemCollection : IList, 
	ICollection, IEnumerable

Der CheckedListBox.CheckedItemCollection-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche EigenschaftCountRuft die Anzahl der Elemente in der Auflistung ab.
Öffentliche EigenschaftIsReadOnlyRuft einen Wert ab, der angibt, ob die Auflistung schreibgeschützt ist.
Öffentliche EigenschaftItemRuft ein Objekt in der Auflistung markierter Elemente ab.
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeContainsBestimmt, ob das angegebene Element in der Auflistung enthalten ist.
Öffentliche MethodeCopyToKopiert die gesamte Auflistung an eine angegebene Position in einem vorhandenen Array.
Öffentliche MethodeEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Geschützte MethodeFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeGetEnumeratorGibt einen Enumerator zurück, mit dem die CheckedItems-Auflistung durchlaufen werden kann.
Öffentliche MethodeGetHashCodeFungiert als die Standardhashfunktion. (Von Object geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeIndexOfGibt einen Index in der Auflistung aktivierter Elemente zurück.
Geschützte MethodeMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang

  NameBeschreibung
Öffentliche ErweiterungsmethodeAsParallelErmöglicht die Parallelisierung einer Abfrage. (Durch ParallelEnumerable definiert.)
Öffentliche ErweiterungsmethodeAsQueryableKonvertiert ein IEnumerable in ein IQueryable. (Durch Queryable definiert.)
Öffentliche ErweiterungsmethodeCast<TResult>Wandelt die Elemente eines IEnumerable in den angegebenen Typ um. (Durch Enumerable definiert.)
Öffentliche ErweiterungsmethodeOfType<TResult>Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs. (Durch Enumerable definiert.)
Zum Seitenanfang

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate EigenschaftICollection.IsSynchronizedEine Beschreibung dieses Members finden Sie unter ICollection.IsSynchronized.
Explizite SchnittstellenimplementierungPrivate EigenschaftICollection.SyncRootEine Beschreibung dieses Members finden Sie unter ICollection.SyncRoot.
Explizite SchnittstellenimplementierungPrivate MethodeIList.AddEine Beschreibung dieses Members finden Sie unter IList.Add.
Explizite SchnittstellenimplementierungPrivate MethodeIList.ClearEine Beschreibung dieses Members finden Sie unter IList.Clear.
Explizite SchnittstellenimplementierungPrivate MethodeIList.InsertEine Beschreibung dieses Members finden Sie unter Insert.
Explizite SchnittstellenimplementierungPrivate EigenschaftIList.IsFixedSizeEine Beschreibung dieses Members finden Sie unter IList.IsFixedSize.
Explizite SchnittstellenimplementierungPrivate MethodeIList.RemoveEine Beschreibung dieses Members finden Sie unter Remove.
Explizite SchnittstellenimplementierungPrivate MethodeIList.RemoveAtEine Beschreibung dieses Members finden Sie unter RemoveAt.
Zum Seitenanfang

Die Auflistung markierter Elemente ist eine Teilmenge sämtlicher Elemente im CheckedListBox-Steuerelement. Sie enthält nur die Elemente in aktiviertem oder unbestimmtem Zustand.

Die folgende Tabelle enthält ein Beispiel für die indizierte Auflistung von Elementen im Steuerelement, d. h. sämtliche im Steuerelement enthaltenen Elemente.

Index

Element

Aktivierungszustand

0

Objekt 1

Unchecked

1

Objekt 2

Checked

2

Objekt 3

Unchecked

3

Objekt 4

Indeterminate

4

Objekt 5

Checked

Auf Grundlage des oben stehenden Beispiels veranschaulicht die folgende Tabelle die indizierte Auflistung der markierten Elemente.

Index

Element

0

Objekt 2

1

Objekt 4

2

Objekt 5

Die CheckedListBox-Klasse enthält zwei Member, mit denen Sie auf die gespeicherten Indizes zugreifen können, nämlich die Item-Eigenschaft und die IndexOf-Methode.

Auf Grundlage des oben stehenden Beispiels wird bei einem Aufruf der Item-Eigenschaft mit dem Parameterwert 1 das Objekt 4 zurückgegeben. Ein Aufruf von IndexOf mit einem Parameter von object 4 gibt den Wert 1 zurück.

Im folgenden Beispiel werden die überprüften Elemente im CheckedListBox.CheckedIndexCollection aufgelistet, um anzuzeigen, in welchem Aktivierungszustand ein Element darin ist. Im Beispiel wird die Verwendung der GetItemCheckState-Methode zum Festlegen des Aktivierungszustands eines Elements veranschaulicht. Das Beispiel veranschaulicht auch die Verwendung der CheckedIndices-Eigenschaft zum Abrufen der CheckedListBox.CheckedIndexCollection und der CheckedItems-Eigenschaft zum Abrufen der CheckedListBox.CheckedItemCollection.

Die erste Schleife verwendet die GetItemCheckState-Methode zum Abrufen des CheckState der einzelnen Elemente unter Angabe des Index des Elements. Die zweite Schleife verwendet ebenfalls GetItemCheckState, allerdings wird die ListBox.ObjectCollection.IndexOf-Methode verwendet, um den Index des Elements abzurufen.


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() + ".");
    }

}


.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft