CheckedListBox.CheckedItems Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Коллекция отмеченных элементов в данном элементе управления CheckedListBox.
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
Значение свойства
Коллекция CheckedListBox.CheckedItemCollection для объекта CheckedListBox.
- Атрибуты
Примеры
В следующем примере перечисляются флажки в , CheckedListBox.CheckedIndexCollection чтобы увидеть, в каком проверка состоянии находится элемент. В примере показано использование свойства для CheckedIndices получения CheckedListBox.CheckedIndexCollectionи CheckedItems свойства для получения CheckedListBox.CheckedItemCollection.
Первый цикл использует GetItemCheckState метод для получения CheckState каждого проверенного элемента с учетом индекса элемента. Во втором цикле также используется GetItemCheckState, но для получения индекса для элемента используется ListBox.ObjectCollection.IndexOf метод .
Чтобы запустить этот пример, выполните следующие действия.
Создайте новое приложение Windows Forms.
Добавьте в форму CheckedListBox и Button .
Присвойте кнопке
WhatIsChecked
имя , добавьте обработчик для ее Click события и скопируйте в код из текста следующего обработчика.Добавьте некоторые элементы в .CheckedListBox
Запустите пример и проверка некоторые поля проверка в списке.
Нажмите кнопку.
Вы увидите ряд полей сообщений, указывающих, какие элементы были отмечены.
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
Комментарии
Коллекция представляет собой подмножество объектов в Items коллекции, представляющее только те элементы, для которых System.Windows.Forms.CheckState имеет значение Checked
или Indeterminate
. Индексы в этой коллекции находятся в порядке возрастания.