CheckedListBox.GetItemCheckState メソッド

現在の項目のチェックの状態を示す値を返します。

Public Function GetItemCheckState( _
   ByVal index As Integer _) As CheckState
[C#]
public CheckState GetItemCheckState(intindex);
[C++]
public: CheckState GetItemCheckState(intindex);
[JScript]
public function GetItemCheckState(
   index : int) : CheckState;

パラメータ

• index
  チェックされている値を取得する項目のインデックス。

戻り値

CheckState 値の 1 つ。

例外

例外の種類	条件
ArgumentException	指定された index が 0 未満です。 または 指定された index がリスト内の項目数以上の値です。

解説

GetItemCheckState メソッドを使用すると、指定したインデックスの項目の CheckState の値を取得できます。項目のチェック状態を Indeterminate に設定することがない場合は、 GetItemChecked メソッドを使用してください。

使用例

[Visual Basic, C#, C++] CheckedListBox.CheckedIndexCollection 内のチェック項目を列挙して各項目のチェック状態を調べる方法を次の例に示します。この例では、 GetItemCheckState メソッドを使用して項目のチェック状態を取得します。この例では、 CheckedIndices プロパティを使用して CheckedListBox.CheckedIndexCollection を取得し、 CheckedItems プロパティを使用して CheckedListBox.CheckedItemCollection を取得する方法についても示します。

[Visual Basic, C#, C++] 最初のループでは、項目のインデックスを基に、 GetItemCheckState メソッドを使用して、各チェック項目の CheckState を取得します。2 番目のループでは GetItemCheckState も使用しますが、項目のインデックスの取得には ObjectCollection.IndexOf メソッドを使用します。

 
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

[C#] 
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() + ".");
    }

}

[C++] 
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.
        IEnumerator* myEnum1 = checkedListBox1->CheckedIndices->GetEnumerator();
        while (myEnum1->MoveNext()) {
            Int32 indexChecked =  *__try_cast<__box Int32*>(myEnum1->Current);

            // The indexChecked variable contains the index of the item.
            MessageBox::Show(String::Concat(S"Index#: ", __box(indexChecked), S", is checked. Checked state is: ", 
                __box(checkedListBox1->GetItemCheckState(indexChecked)), S"."));
        }

        // Next show the Object* title and check state for each item selected.
        IEnumerator* myEnum2 = checkedListBox1->CheckedItems->GetEnumerator();
        while (myEnum2->MoveNext()) {
            Object* itemChecked = __try_cast<Object*>(myEnum2->Current);

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

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

CheckedListBox クラス | CheckedListBox メンバ | System.Windows.Forms 名前空間 | GetItemChecked | CheckState