CheckedListBox.SetItemCheckState(Int32, CheckState) Metodo

Definizione

Imposta lo stato di selezione dell'elemento in corrispondenza dell'indice specificato.

public void SetItemCheckState (int index, System.Windows.Forms.CheckState value);

Parametri

index
Int32

Indice dell'elemento per il quale impostare lo stato.

value
CheckState

Uno dei valori di CheckState.

Eccezioni

Il parametro index specificato è minore di zero.

-oppure-

Il parametro index è maggiore o uguale al numero di elementi contenuti nell'elenco.

Il parametro value non è uno dei valori di CheckState.

Esempio

Nell'esempio seguente vengono enumerati gli elementi nell'oggetto CheckedListBox e vengono controllati tutti gli altri elementi dell'elenco. Nell'esempio viene illustrato l'utilizzo dei SetItemCheckState metodi e SetItemChecked per impostare lo stato di controllo di un elemento. Per ogni altro elemento da controllare, SetItemCheckState viene chiamato per impostare su CheckStateIndeterminate, mentre SetItemChecked viene chiamato sull'altro elemento per impostare lo stato selezionato su Checked.

L'esempio illustra anche l'uso della Items proprietà per ottenere l'oggetto CheckedListBox.ObjectCollection per ottenere l'oggetto Count degli elementi.

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

Commenti

Il metodo SetItemCheckState genera l'evento ItemCheck.

Elementi il cui CheckState valore è impostato per Indeterminate essere visualizzato con un segno di spunta nella casella di controllo, ma la casella è disattivata per indicare lo stato indeterminato dell'elemento selezionato.

Si applica a

Prodotto Versioni
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Vedi anche