CheckedListBox.GetItemCheckState(Int32) CheckedListBox.GetItemCheckState(Int32) CheckedListBox.GetItemCheckState(Int32) CheckedListBox.GetItemCheckState(Int32) Method

定義

現在の項目のチェックの状態を示す値を返します。Returns a value indicating the check state of the current item.

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 Int32 Int32 Int32

チェックされている値を取得する項目のインデックス。The index of the item to get the checked value of.

戻り値

CheckState 値のいずれか 1 つ。One of the CheckState values.

例外

指定された index が 0 未満です。The index specified is less than zero.

- または --or- 指定された index がリスト内の項目数以上の値です。The index specified is greater than or equal to the count of items in the list.

次の例では、内のチェックCheckedListBox.CheckedIndexCollectionされた項目を列挙して、項目がどのような状態であるかを確認します。The following example enumerates the checked items in the CheckedListBox.CheckedIndexCollection to see what check state an item is in. この例では、 GetItemCheckStateメソッドを使用して項目のチェック状態を設定する方法を示します。The example demonstrates using the GetItemCheckState method to set the check state of an item. また、この例ではCheckedIndices 、プロパティCheckedListBox.CheckedIndexCollection CheckedItemsを使用してを取得し、 CheckedListBox.CheckedItemCollectionプロパティを取得してを取得する方法も示しています。The example also demonstrates using the CheckedIndices property to get the CheckedListBox.CheckedIndexCollection and the CheckedItems property to get the CheckedListBox.CheckedItemCollection.

最初のループではGetItemCheckState 、メソッドを使用CheckStateして、項目のインデックスを指定して、チェックされた各項目のを取得します。The first loop uses the GetItemCheckState method to get the CheckState of each checked item, given the index of the item. 2番目のループGetItemCheckStateでは、もListBox.ObjectCollection.IndexOf使用しますが、メソッドを使用して項目のインデックスを取得します。The second loop also uses GetItemCheckState, but uses the ListBox.ObjectCollection.IndexOf method to retrieve the index for the item.

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 、項目の値を取得する機能を提供します。The GetItemCheckState method provides the ability to get the CheckState value of an item, given the index. 項目のチェック状態をにIndeterminate設定していない場合は、 GetItemCheckedメソッドを使用します。If you never set the check state of an item to Indeterminate, then use the GetItemChecked method.

適用対象

こちらもご覧ください