CheckedListBox.SetItemChecked(Int32, Boolean) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Legt CheckState für das Element am angegebenen Index auf Checked fest.

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)

Parameter

index

Int32

Der Index des Elements, dessen Aktivierungszustand festgelegt werden soll.

value

Boolean

true, um das Element als aktiviert festzulegen, andernfalls false.

Ausnahmen

ArgumentException

Der angegebene Index ist kleiner als 0.

- oder -

Der Index ist größer als die Anzahl der Elemente in der Liste.

Beispiele

Im folgenden Beispiel werden die Elemente in der Liste aufgezählt und alle anderen Elemente in der CheckedListBox Liste überprüft. Das Beispiel veranschaulicht die Verwendung der SetItemCheckState SetItemChecked Methoden und Methoden zum Festlegen des Prüfzustands eines Elements. Für jedes andere Element, das überprüft werden soll, wird aufgerufen, um die CheckState IndeterminateOption auf festzulegen, während SetItemChecked das andere Element aufgerufen wird, SetItemCheckState um den überprüften Zustand Checkedauf festzulegen.

Im Beispiel wird auch die Verwendung der Items Eigenschaft veranschaulicht, um die CheckedListBox.ObjectCollection Count Elemente abzurufen.

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

Hinweise

Wenn ein Wert true übergeben wird, legt diese Methode den CheckState Wert auf Checked. Ein Wert von false Sätzen CheckState auf Unchecked.