CheckedListBox.SetItemCheckState(Int32, CheckState) Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mengatur status pemeriksaan item pada indeks yang ditentukan.

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)

Parameter

index

Int32

Indeks item yang akan diatur statusnya.

value

CheckState

Salah CheckState satu nilai.

Pengecualian

ArgumentOutOfRangeException

Yang index ditentukan kurang dari nol.

-atau-

index lebih besar dari atau sama dengan jumlah item dalam daftar.

InvalidEnumArgumentException

value bukan salah CheckState satu nilai.

Contoh

Contoh berikut menghitung item dalam CheckedListBox dan memeriksa setiap item lain dalam daftar. Contoh menunjukkan menggunakan SetItemCheckState metode dan SetItemChecked untuk mengatur status pemeriksaan item. Untuk setiap item lain yang akan diperiksa, SetItemCheckState dipanggil untuk mengatur CheckState ke Indeterminate, sementara SetItemChecked dipanggil pada item lain untuk mengatur status diperiksa ke Checked.

Contohnya juga menunjukkan penggunaan Items properti untuk mendapatkan CheckedListBox.ObjectCollectionCount dari item.

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

Keterangan

Metode ini SetItemCheckState meningkatkan ItemCheck peristiwa.

Item yang CheckState diatur agar Indeterminate muncul dengan tanda centang dalam kotak centang, tetapi kotak berwarna abu-abu untuk menunjukkan status item yang tidak ditentukan dari item yang dicentang.

Lihat juga

• CheckState