CheckedListBox.SetItemChecked(Int32, Boolean) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

CheckedListBox.cs

Sets CheckState for the item at the specified index to 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)

Parameter

index

Int32

Der Index des Elements, für das der Überprüfungsstatus festgelegt werden soll.

value

Boolean

trueum das Element als überprüft festzulegen; andernfalls . false

Ausnahmen

ArgumentException

Der angegebene Index ist kleiner als Null.

- oder -

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

Beispiele

Im folgenden Beispiel werden die Elemente in der CheckedListBox Liste aufgelistet und alle anderen Elemente in der Liste überprüft. Das Beispiel veranschaulicht die Verwendung der SetItemCheckState Methoden zum SetItemChecked Festlegen des Überprüfungszustands eines Elements. Für jedes andere Element, das überprüft werden soll, wird aufgerufen, SetItemCheckState um den CheckStateIndeterminateBetreffenden festzulegen, während SetItemChecked das andere Element aufgerufen wird, um den aktivierten Zustand auf festzulegen Checked.

Das Beispiel veranschaulicht auch die Verwendung der Items Eigenschaft zum Abrufen der CheckedListBox.ObjectCollectionCount Elemente.

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 übergeben true wird, legt diese Methode den CheckState Wert auf Checked. Ein Wert von false Sätzen CheckState auf Unchecked.