CheckedListBox.CheckedIndexCollection Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

CheckedListBox.CheckedIndexCollection.cs

Zapouzdřuje kolekci indexů kontrolovaných položek (včetně položek v neurčitém stavu) v objektu CheckedListBox.

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

Dědičnost

Object

CheckedListBox.CheckedIndexCollection

Implementuje

ICollection IEnumerable IList

Příklady

Následující příklad vytvoří výčet vrácených položek se změnami a CheckedListBox.CheckedIndexCollection zjistí, v jakém stavu je položka. Příklad ukazuje použití GetItemCheckState metody k nastavení stavu kontroly položky. Příklad také ukazuje použití CheckedIndices vlastnosti získat CheckedListBox.CheckedIndexCollectiona CheckedItems vlastnost získat CheckedListBox.CheckedItemCollection.

První smyčka používá metodu GetItemCheckState k získání CheckState každé kontrolované 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 kontrolovaných indexů je podmnožinou indexů do kolekce všech položek v ovládacím CheckedListBox prvku. Tyto indexy určují položky v nezaškrtnutém nebo neurčité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 indexů kontrolovaných položek.

Index	Index položky
0	1
1	3
2	4

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[] vrátí volání vlastnosti s hodnotou parametru 1 hodnotu 3. Volání IndexOf s parametrem 3 vrátí hodnotu 1.

Vlastnosti

Name	Description
Count	Získá počet zaškrtnutých položek.
IsReadOnly	Získá hodnotu určující, zda kolekce je jen pro čtení.
Item[Int32]	Získá index zaškrtnuté položky v ovládacím CheckedListBox prvku.

Metody

Name	Description
Contains(Int32)	Určuje, zda je zadaný index umístěn v kolekci.
CopyTo(Array, Int32)	Zkopíruje celou kolekci do existujícího pole v zadaném umístění v rámci pole.
GetEnumerator()	Vrátí enumerátor, který lze použít k iteraci v kolekci CheckedIndices .
IndexOf(Int32)	Vrátí index do kolekce kontrolovaných indexů.

Explicitní implementace rozhraní

Name	Description
ICollection.IsSynchronized	Získá hodnotu označující, zda je přístup k CheckedListBox.CheckedIndexCollection této synchronizaci (bezpečné vlákno).
ICollection.SyncRoot	Získá objekt, který lze použít k synchronizaci přístupu k kolekci ovládacích prvků. Popis tohoto člena naleznete v tématu SyncRoot.
IList.Add(Object)	Toto rozhraní API podporuje produktovou infrastrukturu a není určené k použití přímo z uživatelského kódu. Přidá položku do objektu CheckedListBox.CheckedIndexCollection. Popis tohoto člena naleznete v tématu Add(Object).
IList.Clear()	Odebere všechny položky z objektu CheckedListBox.CheckedIndexCollection. Popis tohoto člena naleznete v tématu Clear().
IList.Contains(Object)	Určuje, zda je zadaný index umístěn v objektu CheckedListBox.CheckedIndexCollection. Popis tohoto člena naleznete v tématu Contains(Object).
IList.IndexOf(Object)	Popis tohoto člena naleznete v tématu IndexOf(Object).
IList.Insert(Int32, Object)	Popis tohoto člena naleznete v tématu Insert(Int32, Object).
IList.IsFixedSize	Popis tohoto člena naleznete v tématu IsFixedSize.
IList.Item[Int32]	Popis tohoto člena naleznete v tématu Item[Int32].
IList.Remove(Object)	Popis tohoto člena naleznete v tématu Remove(Object).
IList.RemoveAt(Int32)	nebo popis tohoto člena, viz RemoveAt(Int32).

Viz také

• CheckedIndices
• CheckedItems
• Items