CheckedListBox.SetItemCheckState(Int32, CheckState) Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

CheckedListBox.cs

Belirtilen dizinde öğenin denetim durumunu ayarlar.

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)

Parametreler

index

Int32

Durumunun ayarlanacağı öğenin dizini.

value

CheckState

Değerlerden CheckState biri.

Özel durumlar

ArgumentOutOfRangeException

Belirtilen index sıfırdan küçük.

-veya-

index, listedeki öğelerin sayısına eşit veya daha büyüktür.

InvalidEnumArgumentException

value değerlerinden CheckState biri değildir.

Örnekler

Aşağıdaki örnek içindeki CheckedListBox öğeleri numaralandırır ve listedeki diğer tüm öğeleri denetler. Örnekte, bir öğenin denetim durumunu ayarlamak için ve SetItemChecked yöntemlerinin kullanılması SetItemCheckState gösterilmektedir. denetlenecek diğer tüm öğeler için, öğesini olarak ayarlamak SetItemCheckedCheckStateIndeterminateiçin çağrılırken, SetItemCheckState denetlenen durumu olarak ayarlamak için diğer öğede çağrılır.Checked

Örnekte ayrıca öğesini almak CheckedListBox.ObjectCollectionCount için özelliğinin kullanılması Items gösterilmektedir.

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

Açıklamalar

SetItemCheckState yöntemi olayı tetiklerItemCheck.

CheckState Onay kutusunda onay işareti olacak şekilde Indeterminate ayarlanmış, ancak işaretli öğenin belirsiz durumunu belirtmek için kutu gri renktedir.

Ayrıca bkz.

• CheckState