CheckedListBox.SetItemChecked メソッド

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

CheckedListBox.SetItemChecked メソッド

指定したインデックスの位置にある項目の CheckState を Checked に設定します。

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

Visual Basic (宣言)

Public Sub SetItemChecked ( _
    index As Integer, _
    value As Boolean _
)

Visual Basic (使用法)

Dim instance As CheckedListBox
Dim index As Integer
Dim value As Boolean

instance.SetItemChecked(index, value)

C#

public void SetItemChecked (
    int index,
    bool value
)

C++

public:
void SetItemChecked (
    int index, 
    bool value
)

J#

public void SetItemChecked (
    int index, 
    boolean value
)

JScript

public function SetItemChecked (
    index : int, 
    value : boolean
)

パラメータ

index

チェックの状態を設定する対象となる項目のインデックス。

value

項目をチェックされている状態に設定する場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentException	指定されたインデックスが 0 未満です。 または インデックスが、リスト内の項目数を超える値です。

解説

true の値が渡されると、このメソッドによって CheckState の値が Checked に設定されます。値が false のときは、CheckState が Unchecked に設定されます。

使用例

CheckedListBox 内の項目を列挙し、リスト内の項目を 1 つおきにチェックする例を次に示します。この例では、SetItemCheckState メソッドおよび SetItemChecked メソッドを使用して、項目のチェック状態を設定しています。チェックする項目は 1 つおきに、SetItemCheckState が呼び出されて CheckState が Indeterminate に設定され、残りの項目については SetItemChecked が呼び出されてチェック状態が Checked に設定されます。

この例では、Items プロパティを使用して CheckedListBox.ObjectCollection を取得し、次に Count を取得する方法についても示します。

Visual Basic

Private Sub CheckEveryOther_Click(ByVal
 sender As System.Object, ByVal e As
 System.EventArgs) Handles CheckEveryOther.Click
    ' Cycle through every item and check every other.
    Dim i As Integer

    ' Set flag to true to know when this code is being executed. Used
 in the ItemCheck
    ' event handler.
    insideCheckEveryOther = True

    For i = 0 To CheckedListBox1.Items.Count
 - 1
        ' For every other item in the list, set as checked.

        If ((i Mod 2) = 0) Then
            ' But for each other item that is to be checked, set as
 being in an
            ' indeterminate checked state.

            If ((i Mod 4) = 0) Then
                CheckedListBox1.SetItemCheckState(i, CheckState.Indeterminate)
            Else
                CheckedListBox1.SetItemChecked(i, True)
            End If
        End If
    Next

    insideCheckEveryOther = False

End Sub

C#

private void CheckEveryOther_Click(object sender,
 System.EventArgs e) {
    // Cycle through every item and check every other.

    // Set flag to true to know when this code is being executed. Used
 in the ItemCheck
    // event handler.
    insideCheckEveryOther = true;

    for (int i = 0; i < checkedListBox1.Items.Count;
 i++) {
        // For every other item in the list, set as checked.
        if ((i % 2) == 0) {
            // But for each other item that is to be checked, set as
 being in an
            // indeterminate checked state.
            if ((i % 4) == 0)
                checkedListBox1.SetItemCheckState(i, CheckState.Indeterminate);
            else
                checkedListBox1.SetItemChecked(i, true);
        }
    }        

    insideCheckEveryOther = false;
}

C++

void CheckEveryOther_Click( Object^ /*sender*/, System::EventArgs^
 /*e*/ )
{
   
   // Cycle through every item and check every other.
   // Set flag to true to know when this code is being executed. Used
 in the ItemCheck
   // event handler.
   insideCheckEveryOther = true;
   for ( int i = 0; i < checkedListBox1->Items->Count;
 i++ )
   {
      
      // For every other item in the list, set as checked.
      if ( (i % 2) == 0 )
      {
         
         // But for each other item that is to be checked, set as being
 in an
         // indeterminate checked state.
         if ( (i % 4) == 0 )
                     checkedListBox1->SetItemCheckState( i, CheckState::Indeterminate
 );
         else
                     checkedListBox1->SetItemChecked( i, true
 );
      }

   }
   insideCheckEveryOther = false;
}

J#

private void checkEveryOther_Click(Object sender,
 System.EventArgs e)
{
    // Cycle through every item and check every other.
    // Set flag to true to know when this code is being executed. 
    // Used in the ItemCheck event handler.
    insidecheckEveryOther = true;
    for (int i = 0; i < checkedListBox1.get_Items().get_Count();
 i++) {
        // For every other item in the list, set as checked.
        if (i % 2 == 0) {
            // But for each other item that is to be checked, set as
 being 
            // in an indeterminate checked state.
            if (i % 4 == 0) {
                checkedListBox1.SetItemCheckState(i, 
                    CheckState.Indeterminate);
            }
            else {
                checkedListBox1.SetItemChecked(i, true);
            }
        }
    }
    insidecheckEveryOther = false;
} //checkEveryOther_Click

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
CheckedListBox クラス
CheckedListBox メンバ
System.Windows.Forms 名前空間