CheckedListBox.GetItemCheckState(Int32) 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Source:

CheckedListBox.cs

현재 항목의 확인 상태를 나타내는 값을 반환합니다.

public:
 System::Windows::Forms::CheckState GetItemCheckState(int index);

public System.Windows.Forms.CheckState GetItemCheckState(int index);

member this.GetItemCheckState : int -> System.Windows.Forms.CheckState

Public Function GetItemCheckState (index As Integer) As CheckState

매개 변수

index

Int32

선택한 값을 가져올 항목의 인덱스입니다.

반환

CheckState

값 중 CheckState 하나입니다.

예외

ArgumentOutOfRangeException

index 지정된 값이 0보다 작습니다.

-또는-

index 지정된 항목이 목록의 항목 수보다 크거나 같습니다.

예제

다음 예제에서는 선택한 항목을 열거하여 항목이 CheckedListBox.CheckedIndexCollection 있는 확인 상태를 확인합니다. 이 예제에서는 메서드를 GetItemCheckState 사용하여 항목의 확인 상태를 설정하는 방법을 보여 줍니다. 또한 이 예제에서는 속성을 사용하여 CheckedIndices 속성을 가져와 CheckedListBox.CheckedIndexCollectionCheckedItems 서 가져오는 방법을 CheckedListBox.CheckedItemCollection보여 줍니다.

첫 번째 루프는 항목의 GetItemCheckState 인덱스가 CheckState 지정된 경우 메서드를 사용하여 확인된 각 항목의 항목을 가져옵니다. 두 번째 루프도 사용 GetItemCheckState하지만 메서드를 ListBox.ObjectCollection.IndexOf 사용하여 항목의 인덱스도 검색합니다.

void WhatIsChecked_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   
   // Display in a message box all the items that are checked.
   // First show the index and check state of all selected items.
   IEnumerator^ myEnum1 = checkedListBox1->CheckedIndices->GetEnumerator();
   while ( myEnum1->MoveNext() )
   {
      Int32 indexChecked =  *safe_cast<Int32^>(myEnum1->Current);
      
      // The indexChecked variable contains the index of the item.
      MessageBox::Show( String::Concat( "Index#: ", indexChecked, ", is checked. Checked state is: ", checkedListBox1->GetItemCheckState( indexChecked ), "." ) );
   }

   
   // Next show the Object* title and check state for each item selected.
   IEnumerator^ myEnum2 = checkedListBox1->CheckedItems->GetEnumerator();
   while ( myEnum2->MoveNext() )
   {
      Object^ itemChecked = safe_cast<Object^>(myEnum2->Current);
      
      // Use the IndexOf method to get the index of an item.
      MessageBox::Show( String::Concat( "Item with title: \"", itemChecked, "\", is checked. Checked state is: ", checkedListBox1->GetItemCheckState( checkedListBox1->Items->IndexOf( itemChecked ) ), "." ) );
   }
}

private void WhatIsChecked_Click(object sender, System.EventArgs e) {
    // Display in a message box all the items that are checked.

    // First show the index and check state of all selected items.
    foreach(int indexChecked in checkedListBox1.CheckedIndices) {
        // The indexChecked variable contains the index of the item.
        MessageBox.Show("Index#: " + indexChecked.ToString() + ", is checked. Checked state is:" +
                        checkedListBox1.GetItemCheckState(indexChecked).ToString() + ".");
    }

    // Next show the object title and check state for each item selected.
    foreach(object itemChecked in checkedListBox1.CheckedItems) {

        // Use the IndexOf method to get the index of an item.
        MessageBox.Show("Item with title: \"" + itemChecked.ToString() +
                        "\", is checked. Checked state is: " +
                        checkedListBox1.GetItemCheckState(checkedListBox1.Items.IndexOf(itemChecked)).ToString() + ".");
    }
}

Private Sub WhatIsChecked_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles WhatIsChecked.Click
    ' Display in a message box all the items that are checked.
    Dim indexChecked As Integer
    Dim itemChecked As Object
    Const quote As String = """"

    ' First show the index and check state of all selected items.
    For Each indexChecked In CheckedListBox1.CheckedIndices
        ' The indexChecked variable contains the index of the item.
        MessageBox.Show("Index#: " + indexChecked.ToString() + ", is checked. Checked state is:" + _
                        CheckedListBox1.GetItemCheckState(indexChecked).ToString() + ".")
    Next

    ' Next show the object title and check state for each item selected.
    For Each itemChecked In CheckedListBox1.CheckedItems

        ' Use the IndexOf method to get the index of an item.
        MessageBox.Show("Item with title: " + quote + itemChecked.ToString() + quote + _
                        ", is checked. Checked state is: " + _
                        CheckedListBox1.GetItemCheckState(CheckedListBox1.Items.IndexOf(itemChecked)).ToString() + ".")
    Next

End Sub

설명

이 메서드는 GetItemCheckState 인덱스가 지정된 경우 항목의 값을 가져오는 CheckState 기능을 제공합니다. 항목 Indeterminate의 확인 상태를 설정하지 않으면 메서드를 GetItemChecked 사용합니다.

추가 정보

• GetItemChecked(Int32)
• CheckState