CheckedListBox.SetItemCheckState(Int32, CheckState) Método
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í.
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 -> unitPublic 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
El parámetro index especificado es menor que cero.
o bien
index es mayor o igual que el recuento de elementos de la lista.
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.
