CheckedListBox.GetItemCheckState(Int32) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Devuelve un valor que indica el estado de activación del elemento actual.

public:
 System::Windows::Forms::CheckState GetItemCheckState(int index);

public System.Windows.Forms.CheckState GetItemCheckState (int index);

member this.GetItemCheckState : int -> System.Windows.Forms.CheckState

Public Function GetItemCheckState (index As Integer) As CheckState

Parámetros

index

Int32

Índice del elemento del que se obtendrá el valor de activación.

Devoluciones

CheckState

Uno de los valores de CheckState.

Excepciones

ArgumentOutOfRangeException

El parámetro index especificado es menor que cero.

o bien

El parámetro index especificado es mayor o igual que el recuento de elementos de la lista.

Ejemplos

En el ejemplo siguiente se enumeran los elementos protegidos en CheckedListBox.CheckedIndexCollection para ver en qué estado de comprobación está un elemento. En el ejemplo se muestra cómo usar el GetItemCheckState método para establecer el estado de comprobación de un elemento. En el ejemplo también se muestra el uso de la CheckedIndices propiedad para obtener y CheckedListBox.CheckedIndexCollection la 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

El GetItemCheckState método proporciona la capacidad de obtener el CheckState valor de un elemento, dado el índice. Si nunca establece el estado de comprobación de un elemento Indeterminateen , use el GetItemChecked método .

Consulte también

• GetItemChecked(Int32)
• CheckState