CheckedListBox.SetItemCheckState(Int32, CheckState) Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Définit l'état d'activation de l'élément au niveau de l'index spécifié.

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)

Paramètres

index

Int32

Index de l'élément dont vous souhaitez définir l'état.

value

CheckState

Une des valeurs de l'objet CheckState.

Exceptions

ArgumentOutOfRangeException

Le index spécifié est inférieur à zéro.

- ou -

Le index est supérieur ou égal au nombre d'éléments dans la liste.

InvalidEnumArgumentException

value ne fait pas partie des valeurs CheckState.

Exemples

L’exemple suivant énumère les éléments du CheckedListBox et vérifie tous les autres éléments de la liste. L’exemple illustre l’utilisation des SetItemCheckState méthodes et SetItemChecked pour définir l’état case activée d’un élément. Pour chaque autre élément à vérifier, SetItemCheckState est appelé pour définir sur CheckStateIndeterminate, tandis que SetItemChecked est appelé sur l’autre élément pour définir l’état activé sur Checked.

L’exemple montre également l’utilisation de la Items propriété pour obtenir le CheckedListBox.ObjectCollection pour obtenir le Count d’éléments.

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

Remarques

La méthode SetItemCheckState déclenche l'événement ItemCheck.

Les éléments dont CheckState est défini pour Indeterminate apparaître avec une marque case activée dans la zone case activée, mais la zone est grisée pour indiquer la status indéterminée de l’élément activé.

Voir aussi

• CheckState