CheckedListBox.CheckedItemCollection Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Hermetyzuje kolekcję zaznaczonych elementów, w tym elementy w stanie nieokreślonym, w kontrolce CheckedListBox .
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
- Dziedziczenie
-
CheckedListBox.CheckedItemCollection
- Implementuje
Przykłady
Poniższy przykład wylicza zaewidencjonowane elementy w elemencie CheckedListBox.CheckedIndexCollection , aby zobaczyć stan sprawdzania, w jakim stanie znajduje się element. W przykładzie GetItemCheckState pokazano użycie metody w celu ustawienia stanu sprawdzania elementu. W przykładzie pokazano również użycie CheckedIndices właściwości w celu pobrania CheckedListBox.CheckedIndexCollectionwłaściwości i CheckedItems właściwości w celu pobrania obiektu CheckedListBox.CheckedItemCollection.
Pierwsza pętla używa GetItemCheckState metody w celu pobrania CheckState każdego zaznaczonego elementu, biorąc pod uwagę indeks elementu. Druga pętla używa GetItemCheckStaterównież metody , ale używa ListBox.ObjectCollection.IndexOf metody w celu pobrania indeksu dla elementu.
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
Uwagi
Kolekcja elementów zaznaczonych jest podzbiorem wszystkich elementów w kontrolce CheckedListBox ; zawiera tylko te elementy, które są w stanie zaewidencjonowany lub nieokreślony.
Poniższa tabela jest przykładem indeksowanej kolekcji elementów w kontrolce (wszystkie elementy zawarte w kontrolce).
Indeks | Element | Sprawdź stan |
---|---|---|
0 | obiekt 1 | Unchecked |
1 | obiekt 2 | Checked |
2 | obiekt 3 | Unchecked |
3 | obiekt 4 | Indeterminate |
4 | obiekt 5 | Checked |
Na podstawie poprzedniego przykładu poniższa tabela przedstawia indeksowaną kolekcję zaznaczonych elementów.
Indeks | Element |
---|---|
0 | obiekt 2 |
1 | obiekt 4 |
2 | obiekt 5 |
Klasa CheckedListBox ma dwa elementy członkowskie, które umożliwiają dostęp do przechowywanych indeksów, Item[] właściwość i metodę IndexOf .
Na podstawie poprzedniego przykładu Item[] wywołanie właściwości z wartością parametru 1 zwraca obiekt 4. Wywołanie metody IndexOf z parametrem obiektu 4 zwraca wartość 1.
Właściwości
Count |
Pobiera liczbę elementów w kolekcji. |
IsReadOnly |
Pobiera wartość wskazującą, czy kolekcja jest tylko do odczytu. |
Item[Int32] |
Pobiera obiekt w kolekcji zaznaczonych elementów. |
Metody
Contains(Object) |
Określa, czy określony element znajduje się w kolekcji. |
CopyTo(Array, Int32) |
Kopiuje całą kolekcję do istniejącej tablicy w określonej lokalizacji w tablicy. |
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
GetEnumerator() |
Zwraca moduł wyliczający, który może służyć do iterowania po kolekcji CheckedItems . |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
IndexOf(Object) |
Zwraca indeks do kolekcji zaznaczonych elementów. |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Jawne implementacje interfejsu
ICollection.IsSynchronized |
Aby uzyskać opis tego członka, zobacz IsSynchronized. |
ICollection.SyncRoot |
Aby uzyskać opis tego członka, zobacz SyncRoot. |
IList.Add(Object) |
Aby uzyskać opis tego członka, zobacz Add(Object). |
IList.Clear() |
Aby uzyskać opis tego członka, zobacz Clear(). |
IList.Insert(Int32, Object) |
Aby uzyskać opis tego członka, zobacz Insert(Int32, Object). |
IList.IsFixedSize |
Aby uzyskać opis tego członka, zobacz IsFixedSize. |
IList.Remove(Object) |
Aby uzyskać opis tego członka, zobacz Remove(Object). |
IList.RemoveAt(Int32) |
Aby uzyskać opis tego członka, zobacz RemoveAt(Int32). |
Metody rozszerzania
Cast<TResult>(IEnumerable) |
Rzutuje elementy elementu IEnumerable na określony typ. |
OfType<TResult>(IEnumerable) |
Filtruje elementy IEnumerable elementu na podstawie określonego typu. |
AsParallel(IEnumerable) |
Umożliwia równoległość zapytania. |
AsQueryable(IEnumerable) |
Konwertuje element IEnumerable na .IQueryable |