CheckedListBox.CheckedItems Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Colección de elementos activados en 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.CheckedItemCollectionPublic ReadOnly Property CheckedItems As CheckedListBox.CheckedItemCollectionValor de propiedad
La colección de CheckedListBox.CheckedItemCollection para CheckedListBox.
- Atributos
Ejemplos
En el ejemplo siguiente se enumeran los elementos comprobados en CheckedListBox.CheckedIndexCollection para ver en qué estado de comprobación se encuentra un elemento. En el ejemplo se muestra el uso de la CheckedIndices propiedad para obtener y CheckedListBox.CheckedIndexCollectionla CheckedItems propiedad para obtener .CheckedListBox.CheckedItemCollection
El primer bucle usa el GetItemCheckState método para obtener el CheckState de cada elemento comprobado, dado el índice del elemento. El segundo bucle también usa GetItemCheckState, pero usa el ListBox.ObjectCollection.IndexOf método para recuperar el índice del elemento.
Para ejecutar este ejemplo, realice los pasos siguientes:
Cree una nueva aplicación Windows Forms.
Agregue un CheckedListBox y un Button al formulario.
Asigne un nombre al botón
WhatIsChecked, agregue un controlador para su Click evento y copie en el código del cuerpo del controlador siguiente.Agregue algunos elementos a CheckedListBox.
Ejecute el ejemplo y active algunas de las casillas de la casilla de lista.
Haga clic en el botón.
Verá una serie de cuadros de mensaje que indican qué elementos se activaron.
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
Comentarios
La colección es un subconjunto de los objetos de la Items colección, que representa solo los elementos cuyos System.Windows.Forms.CheckState es Checked o Indeterminate. Los índices de esta colección están en orden ascendente.
