CheckedListBox.GetItemCheckState メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

CheckedListBox.GetItemCheckState メソッド

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

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Function GetItemCheckState ( _
    index As Integer _
) As CheckState

Visual Basic (使用法)

Dim instance As CheckedListBox
Dim index As Integer
Dim returnValue As CheckState

returnValue = instance.GetItemCheckState(index)

public CheckState GetItemCheckState (
    int index
)

C++

public:
CheckState GetItemCheckState (
    int index
)

public CheckState GetItemCheckState (
    int index
)

JScript

public function GetItemCheckState (
    index : int
) : CheckState

パラメータ

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

戻り値
CheckState 値の 1 つ。

例外

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

例外の種類

条件

ArgumentOutOfRangeException

指定された index が 0 未満です。

または

指定された index がリスト内の項目数以上の値です。

解説

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

使用例

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

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

Visual Basic

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

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

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.
    IEnumerator objEnum = checkedListBox1.get_CheckedIndices().
        GetEnumerator();

    while (objEnum.MoveNext()) {
        int indexChecked = (int)(Int32)(objEnum.get_Current());

        // The indexChecked variable contains the index of the item.
        MessageBox.Show("Index#: " + (Int32)indexChecked 
            + ", is checked. Checked state is:" 
            + checkedListBox1.GetItemCheckState(indexChecked).ToString() 
            + ".");
    }

    // Next show the object title and check state for each item selected.
    for (int iCtr = 0; 
        iCtr < checkedListBox1.get_CheckedItems().get_Count(); 
        iCtr++) {
        Object itemChecked = 
            checkedListBox1.get_CheckedItems().get_Item(iCtr);

        // 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.get_Items().IndexOf(itemChecked)).ToString() 
            + ".");
    }
} //whatIsChecked_Click