CheckedListBox.Items 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í.
Obtiene la colección de elementos de CheckedListBox.
public:
property System::Windows::Forms::CheckedListBox::ObjectCollection ^ Items { System::Windows::Forms::CheckedListBox::ObjectCollection ^ get(); };
public System.Windows.Forms.CheckedListBox.ObjectCollection Items { get; }
member this.Items : System.Windows.Forms.CheckedListBox.ObjectCollection
Public ReadOnly Property Items As CheckedListBox.ObjectCollection
Valor de propiedad
Colección CheckedListBox.ObjectCollection que representa a los elementos de CheckedListBox.
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 usa la Items propiedad para obtener para CheckedListBox.ObjectCollection recuperar el índice de un elemento mediante el ListBox.ObjectCollection.IndexOf método . En el ejemplo también 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.
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 Items propiedad permite obtener una referencia a la lista de elementos almacenados actualmente en un CheckedListBox control . Con esta referencia, puede agregar elementos, quitar elementos y obtener un recuento de los elementos de la colección. Para obtener más información sobre las tareas que se pueden realizar con la colección de elementos, vea los CheckedListBox.ObjectCollection temas de referencia de clase.