CheckedListBox.CheckedItems Vlastnost
Definice
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í.
Kolekce zaškrtnutých položek v tomto CheckedListBoxsouboru
public:
property System::Windows::Forms::CheckedListBox::CheckedItemCollection ^ CheckedItems { System::Windows::Forms::CheckedListBox::CheckedItemCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.CheckedListBox.CheckedItemCollection CheckedItems { get; }
[<System.ComponentModel.Browsable(false)>]
member this.CheckedItems : System.Windows.Forms.CheckedListBox.CheckedItemCollection
Public ReadOnly Property CheckedItems As CheckedListBox.CheckedItemCollection
Hodnota vlastnosti
Kolekce CheckedListBox.CheckedItemCollection pro CheckedListBox.
- Atributy
Příklady
Následující příklad obsahuje výčet zaškrtnutých položek v objektu CheckedListBox.CheckedIndexCollection , abyste zjistili, v jakém stavu kontroly je položka. Příklad ukazuje použití CheckedIndices vlastnosti k získání CheckedListBox.CheckedIndexCollectionvlastnosti , a CheckedItems vlastnost pro získání CheckedListBox.CheckedItemCollection.
První smyčka používá metodu GetItemCheckState k získání CheckState jednotlivých kontrolovaných položek 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.
Pokud chcete spustit tento příklad, proveďte následující kroky:
Vytvořte novou aplikaci model Windows Forms.
Přidejte do CheckedListBox formuláře a Button .
Pojmenujte tlačítko
WhatIsChecked
, přidejte obslužnou rutinu pro jeho Click událost a zkopírujte kód z těla následující obslužné rutiny.Přidejte do CheckedListBoxsouboru některé položky.
Spusťte příklad a zaškrtněte některá políčka v seznamu.
Klikněte na tlačítko.
Zobrazí se řada polí se zprávami, která označují, které položky byly zaškrtnuté.
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 je podmnožinou objektů v kolekci Items , která představuje pouze ty položky, jejichž System.Windows.Forms.CheckState je Checked
nebo Indeterminate
. Indexy v této kolekci jsou ve vzestupném pořadí.