CheckedListBox.CheckedItemCollection Třída

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zapouzdřuje kolekci zaškrtnutých položek, včetně položek v nedeterminovaném stavu, v ovládacím CheckedListBox prvku.

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

Dědičnost: Object
CheckedListBox.CheckedItemCollection

Implementuje: ICollection IEnumerable IList

Příklady

Následující příklad uvádí zaškrtnuté položky v seznamu CheckedListBox.CheckedIndexCollection , abyste zjistili, v jakém stavu je položka zaškrtnutá. Příklad ukazuje použití GetItemCheckState metody k nastavení stavu kontroly položky. Příklad také ukazuje použití CheckedIndices vlastnosti získat CheckedListBox.CheckedIndexCollection, a CheckedItems vlastnost získat CheckedListBox.CheckedItemCollection.

První smyčka používá metodu GetItemCheckState k získání CheckState každé zaškrtnuté položky vzhledem k indexu položky. Druhá smyčka také používá GetItemCheckState, ale používá metodu ListBox.ObjectCollection.IndexOf k načtení indexu pro položku.

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

Poznámky

Kolekce zaškrtnutých položek je podmnožinou všech položek v ovládacím CheckedListBox prvku. Obsahuje pouze ty položky, které jsou v zaškrtnutém nebo nedeterminativním stavu.

Následující tabulka je příkladem indexované kolekce položek v ovládacím prvku (všechny položky obsažené v ovládacím prvku).

Index	Položka	Zkontrolovat stav
0	objekt 1	Unchecked
1	objekt 2	Checked
2	objekt 3	Unchecked
3	objekt 4	Indeterminate
4	objekt 5	Checked

Na základě předchozího příkladu následující tabulka zobrazuje indexovanou kolekci zaškrtnutých položek.

Index	Položka
0	objekt 2
1	objekt 4
2	objekt 5

Třída CheckedListBox má dva členy, které umožňují přístup k uloženým indexům, Item[] vlastnosti a IndexOf metodě.

Na základě předchozího příkladu Item[] volání vlastnosti s hodnotou parametru 1 vrátí objekt 4. Volání IndexOf s parametrem objektu 4 vrátí hodnotu 1.

Vlastnosti

Count	Získá počet prvků v kolekci.
IsReadOnly	Získá hodnotu označující, jestli je kolekce určená jen pro čtení.
Item[Int32]	Získá objekt v kolekci zaškrtnutých položek.

Metody

Contains(Object)	Určuje, zda se zadaná položka nachází v kolekci.
CopyTo(Array, Int32)	Zkopíruje celou kolekci do existujícího pole v zadaném umístění v rámci pole.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetEnumerator()	Vrátí enumerátor, který lze použít k iteraci v kolekci CheckedItems .
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
IndexOf(Object)	Vrátí index do kolekce zaškrtnutých položek.
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

ICollection.IsSynchronized	Popis tohoto člena najdete v tématu IsSynchronized.
ICollection.SyncRoot	Popis tohoto člena najdete v tématu SyncRoot.
IList.Add(Object)	Popis tohoto člena najdete v tématu Add(Object).
IList.Clear()	Popis tohoto člena najdete v tématu Clear().
IList.Insert(Int32, Object)	Popis tohoto člena najdete v tématu Insert(Int32, Object).
IList.IsFixedSize	Popis tohoto člena najdete v tématu IsFixedSize.
IList.Remove(Object)	Popis tohoto člena najdete v tématu Remove(Object).
IList.RemoveAt(Int32)	Popis tohoto člena najdete v tématu RemoveAt(Int32).

Metody rozšíření

Cast<TResult>(IEnumerable)	Přetypuje prvky zadaného IEnumerable typu.
OfType<TResult>(IEnumerable)	Filtruje prvky IEnumerable založené na zadaném typu.
AsParallel(IEnumerable)	Umožňuje paralelizaci dotazu.
AsQueryable(IEnumerable)	Převede na IEnumerable IQueryable.

Platí pro

Sdílet prostřednictvím