CheckedListBox.GetItemCheckState(Int32) メソッド

定義

現在の項目のチェックの状態を示す値を返します。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

チェックされている値を取得する項目のインデックス。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.

適用対象

こちらもご覧ください