CheckedListBox.CheckedItemCollection Classe
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Encapsula a coleção de itens verificados, incluindo itens em um estado indeterminado, em um controle 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
- Herança
-
CheckedListBox.CheckedItemCollection
- Implementações
O exemplo a seguir enumera os itens verificados no CheckedListBox.CheckedIndexCollection para ver em qual estado de verificação um item está. O exemplo demonstra o uso do GetItemCheckState método para definir o estado de verificação de um item. O exemplo também demonstra o uso da CheckedIndices propriedade para obter o CheckedListBox.CheckedIndexCollectione a CheckedItems propriedade para obter o CheckedListBox.CheckedItemCollection.
O primeiro loop usa o GetItemCheckState método para obter o CheckState de cada item verificado, considerando o índice do item. O segundo loop também usa GetItemCheckState, mas usa o ListBox.ObjectCollection.IndexOf método para recuperar o índice do item.
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
A coleção de itens verificados é um subconjunto de todos os itens no CheckedListBox controle; ela contém apenas os itens que estão em um estado verificado ou indeterminado.
A tabela a seguir é um exemplo da coleção indexada de itens no controle (todos os itens contidos no controle).
Índice | Item | Estado de verificação |
---|---|---|
0 | objeto 1 | Unchecked |
1 | objeto 2 | Checked |
2 | objeto 3 | Unchecked |
3 | objeto 4 | Indeterminate |
4 | objeto 5 | Checked |
Com base no exemplo anterior, a tabela a seguir mostra a coleção indexada dos itens verificados.
Índice | Item |
---|---|
0 | objeto 2 |
1 | objeto 4 |
2 | objeto 5 |
A CheckedListBox classe tem dois membros que permitem acessar os índices armazenados, a Item[] propriedade e o IndexOf método .
Com base no exemplo anterior, uma chamada para a Item[] propriedade com um valor de parâmetro de 1 retorna o objeto 4. Uma chamada para IndexOf com um parâmetro do objeto 4 retorna um valor de 1.
Count |
Obtém o número de itens na coleção. |
Is |
Obtém um valor que indica se a coleção é somente leitura. |
Item[Int32] |
Obtém um objeto na coleção de itens marcados. |
Contains(Object) |
Determina se o item especificado está localizado na coleção. |
Copy |
Copia toda a coleção em uma matriz existente de um local especificado na matriz. |
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
Get |
Retorna um enumerador que pode ser usado para iterar na coleção CheckedItems. |
Get |
Serve como a função de hash padrão. (Herdado de Object) |
Get |
Obtém o Type da instância atual. (Herdado de Object) |
Index |
Retorna um índice na coleção de itens selecionados. |
Memberwise |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
To |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
ICollection. |
Para obter uma descrição desse membro, confira IsSynchronized. |
ICollection. |
Para obter uma descrição desse membro, confira SyncRoot. |
IList. |
Para obter uma descrição desse membro, confira Add(Object). |
IList. |
Para obter uma descrição desse membro, confira Clear(). |
IList. |
Para obter uma descrição desse membro, confira Insert(Int32, Object). |
IList. |
Para obter uma descrição desse membro, confira IsFixedSize. |
IList. |
Para obter uma descrição desse membro, confira Remove(Object). |
IList. |
Para obter uma descrição desse membro, confira RemoveAt(Int32). |
Cast<TResult>(IEnumerable) |
Converte os elementos de um IEnumerable para o tipo especificado. |
Of |
Filtra os elementos de um IEnumerable com base em um tipo especificado. |
As |
Habilita a paralelização de uma consulta. |
As |
Converte um IEnumerable em um IQueryable. |
Produto | Versões |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: