CheckedListBox.SetItemCheckState(Int32, CheckState) Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Nastaví stav kontroly položky v zadaném indexu.

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)

Parametry

index

Int32

Index položky, pro kterou chcete nastavit stav.

value

CheckState

Jedna z CheckState hodnot.

Výjimky

ArgumentOutOfRangeException

Zadaná index hodnota je menší než nula.

-nebo-

Hodnota index je větší než nebo rovna počtu položek v seznamu.

InvalidEnumArgumentException

Hodnota value není jednou z CheckState hodnot.

Příklady

Následující příklad vytvoří výčet položek v a zkontroluje CheckedListBox všechny ostatní položky v seznamu. Příklad ukazuje použití SetItemCheckState metod a SetItemChecked k nastavení stavu kontroly položky. Pro každou další položku, která má být zkontrolována, SetItemCheckState je volána k nastavení CheckState na Indeterminate, zatímco SetItemChecked je volána na druhé položce, aby se stav zaškrtnutí nastavil na Checked.

Příklad také ukazuje použití Items vlastnosti k získání CheckedListBox.ObjectCollectionCount položky .

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

Poznámky

Metoda SetItemCheckState vyvolá ItemCheck událost.

Položky, jejichž CheckState zaškrtávací políčko je nastavené tak, aby Indeterminate se zobrazovalo se značkou zaškrtnutí, ale toto políčko je šedě, což označuje neurčitý stav zaškrtnuté položky.

Viz také

• CheckState