CheckedListBox.SetItemCheckState(Int32, CheckState) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Establece el estado de activación del elemento en el índice especificado.

public:
 void SetItemCheckState(int index, System::Windows::Forms::CheckState value);

public void SetItemCheckState (int index, System.Windows.Forms.CheckState value);

member this.SetItemCheckState : int * System.Windows.Forms.CheckState -> unit

Public Sub SetItemCheckState (index As Integer, value As CheckState)

Parámetros

index

Int32

Índice del elemento para el que se establecerá el estado.

value

CheckState

Uno de los valores de CheckState.

Excepciones

ArgumentOutOfRangeException

El parámetro index especificado es menor que cero.

o bien

index es mayor o igual que el recuento de elementos de la lista.

InvalidEnumArgumentException

value no es uno de los valores de CheckState.

Ejemplos

En el ejemplo siguiente se enumeran los elementos de CheckedListBox y se comprueban todos los demás elementos de la lista. En el ejemplo se muestra el uso de los SetItemCheckState métodos y SetItemChecked para establecer el estado de comprobación de un elemento. Para cada otro elemento que se va a comprobar, SetItemCheckState se llama a para establecer en IndeterminateCheckState , mientras SetItemChecked se llama a en el otro elemento para establecer el estado comprobado en Checked.

En el ejemplo también se muestra el uso de la Items propiedad para obtener los CountCheckedListBox.ObjectCollection elementos de .

void CheckEveryOther_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   
   // Cycle through every item and check every other.
   // Set flag to true to know when this code is being executed. Used in the ItemCheck
   // event handler.
   insideCheckEveryOther = true;
   for ( int i = 0; i < checkedListBox1->Items->Count; i++ )
   {
      
      // For every other item in the list, set as checked.
      if ( (i % 2) == 0 )
      {
         
         // But for each other item that is to be checked, set as being in an
         // indeterminate checked state.
         if ( (i % 4) == 0 )
                     checkedListBox1->SetItemCheckState( i, CheckState::Indeterminate );
         else
                     checkedListBox1->SetItemChecked( i, true );
      }

   }
   insideCheckEveryOther = false;
}

private void CheckEveryOther_Click(object sender, System.EventArgs e) {
    // Cycle through every item and check every other.

    // Set flag to true to know when this code is being executed. Used in the ItemCheck
    // event handler.
    insideCheckEveryOther = true;

    for (int i = 0; i < checkedListBox1.Items.Count; i++) {
        // For every other item in the list, set as checked.
        if ((i % 2) == 0) {
            // But for each other item that is to be checked, set as being in an
            // indeterminate checked state.
            if ((i % 4) == 0)
                checkedListBox1.SetItemCheckState(i, CheckState.Indeterminate);
            else
                checkedListBox1.SetItemChecked(i, true);
        }
    }

    insideCheckEveryOther = false;
}

Private Sub CheckEveryOther_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles CheckEveryOther.Click
    ' Cycle through every item and check every other.
    Dim i As Integer

    ' Set flag to true to know when this code is being executed. Used in the ItemCheck
    ' event handler.
    insideCheckEveryOther = True

    For i = 0 To CheckedListBox1.Items.Count - 1
        ' For every other item in the list, set as checked.

        If ((i Mod 2) = 0) Then
            ' But for each other item that is to be checked, set as being in an
            ' indeterminate checked state.

            If ((i Mod 4) = 0) Then
                CheckedListBox1.SetItemCheckState(i, CheckState.Indeterminate)
            Else
                CheckedListBox1.SetItemChecked(i, True)
            End If
        End If
    Next

    insideCheckEveryOther = False

End Sub

Comentarios

El método SetItemCheckState genera el evento ItemCheck.

Elementos cuyo CheckState conjunto aparece Indeterminate con una marca de verificación en la casilla, pero la casilla está atenuada para indicar el estado indeterminado del elemento activado.

Consulte también

• CheckState