CheckedListBox.SetItemCheckState(Int32, CheckState) Método

Definição

Define o estado de seleção do item no índice especificado.Sets the check state of the item at the specified index.

public:
 void SetItemCheckState(int index, System::Windows::Forms::CheckState value);
public void SetItemCheckState (int index, System.Windows.Forms.CheckState value);
member this.SetItemCheckState : int * System.Windows.Forms.CheckState -> unit
Public Sub SetItemCheckState (index As Integer, value As CheckState)

Parâmetros

index
Int32

O índice do item para o qual o estado será definido.The index of the item to set the state for.

value
CheckState

Um dos valores de CheckState.One of the CheckState values.

Exceções

O index especificado é menor que zero.The index specified is less than zero.

-ou--or- O index é maior ou igual à contagem de itens na lista.The index is greater than or equal to the count of items in the list.

O value não é um dos valores CheckState.The value is not one of the CheckState values.

Exemplos

O exemplo a seguir enumera os itens no CheckedListBox e verifica todos os outros itens na lista.The following example enumerates the items in the CheckedListBox and checks every other item in the list. O exemplo demonstra como usar os métodos SetItemCheckState e SetItemChecked para definir o estado de verificação de um item.The example demonstrates using the SetItemCheckState and SetItemChecked methods to set the check state of an item. Para todos os outros itens a serem verificados, SetItemCheckState é chamado para definir a CheckState como Indeterminate, enquanto SetItemChecked é chamado no outro item para definir o estado marcado como Checked.For every other item that is to be checked, SetItemCheckState is called to set the CheckState to Indeterminate, while SetItemChecked is called on the other item to set the checked state to Checked.

O exemplo também demonstra o uso da propriedade Items para obter o CheckedListBox.ObjectCollection para obter a Count de itens.The example also demonstrates using the Items property to get the CheckedListBox.ObjectCollection to get the Count of items.

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;
}


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;
}
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

Comentários

O método SetItemCheckState gera o evento ItemCheck.The SetItemCheckState method raises the ItemCheck event.

Os itens cujo CheckState está definido como Indeterminate aparecem com uma marca de seleção na caixa de seleção, mas a caixa fica acinzentada para indicar o status indeterminado do item selecionado.Items whose CheckState is set to Indeterminate appear with a check mark in the check box, but the box is grayed to indicate the indeterminate status of the checked item.

Aplica-se a

Veja também