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 值。One of the CheckState values.

例外狀況

指定的 index 小於零。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.CheckedIndexCollectionCheckedItems 屬性,以取得 CheckedListBox.CheckedItemCollectionThe 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. 第二個迴圈也會使用 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.

適用於

另請參閱