CheckedListBox.SetItemCheckState(Int32, CheckState) 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

지정된 인덱스에 위치한 항목의 선택 상태를 설정합니다.

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)

매개 변수

index

Int32

상태를 설정할 대상이 되는 항목의 인덱스입니다.

value

CheckState

CheckState 값 중 하나입니다.

예외

ArgumentOutOfRangeException

지정된 index가 0보다 작은 경우

또는

index가 목록에 포함된 항목 수보다 크거나 같은 경우

InvalidEnumArgumentException

value가 CheckState 값이 아닌 경우

예제

항목을 열거 하는 다음 예제는 CheckedListBox 목록의 다른 모든 항목을 확인 합니다. 이 예제에서는 및 SetItemChecked 메서드를 SetItemCheckState 사용하여 항목의 검사 상태를 설정하는 방법을 보여 줍니다. 선택 해야 하는 다른 모든 항목에 대 한 SetItemCheckState 설정 하기 위해 호출 됩니다 합니다 CheckState 하 Indeterminate, 하는 동안 SetItemChecked 선택된 상태 설정 하려면 다른 항목에서 호출 됩니다 Checked.

또한 이 예제에서는 속성을 사용하여 Items 를 가져와 CheckedListBox.ObjectCollection 항목의 을 Count 가져오는 방법을 보여 줍니다.

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

설명

SetItemCheckState 메서드는 ItemCheck 이벤트를 발생시킵니다.

CheckState 검사 상자에 검사 표시와 함께 표시되도록 Indeterminate 설정되어 있지만 확인란이 회색으로 표시되어 선택한 항목의 확정되지 않은 상태 나타내는 항목입니다.

추가 정보

• CheckState