CheckedListBox.SetItemChecked(Int32, Boolean) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Establece CheckState para el elemento situado en el índice especificado en Checked.

public:
 void SetItemChecked(int index, bool value);

public void SetItemChecked (int index, bool value);

member this.SetItemChecked : int * bool -> unit

Public Sub SetItemChecked (index As Integer, value As Boolean)

Parámetros

index

Int32

Índice del elemento para el que se establecerá el estado de activación.

value

Boolean

Es true para establecer el elemento como activado; de lo contrario, es false.

Excepciones

ArgumentException

El índice especificado es menor que cero.

o bien

El índice es mayor que el recuento de elementos de la lista.

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 Count CheckedListBox.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

Cuando se pasa un valor de true , este método establece el CheckState valor Checkeden . Valor de false establece en CheckState Unchecked.