CheckedListBox.GetItemCheckState(Int32) 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

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

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.CheckedIndexCollection 를 가져오는 방법을 보여 줍니다CheckedListBox.CheckedItemCollectionCheckedItems.

첫 번째 루프를 사용 합니다 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