CheckedListBox.SetItemCheckState(Int32, CheckState) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Legt den Aktivierungszustand des Elements am angegebenen Index fest.
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 -> unitPublic Sub SetItemCheckState (index As Integer, value As CheckState)Parameter
- index
- Int32
Der Index des Elements, dessen Zustand festgelegt werden soll.
- value
- CheckState
Einer der CheckState-Werte.
Ausnahmen
Der angegebene index ist kleiner als 0.
- oder -
Der index ist größer oder gleich der Anzahl der Elemente in der Liste.
Der value ist keiner der CheckState-Werte.
Beispiele
Im folgenden Beispiel werden die Elemente im CheckedListBox aufgelistet und jedes andere Element in der Liste überprüft. Das Beispiel veranschaulicht die Verwendung der SetItemCheckState Methoden und SetItemChecked zum Festlegen des Überprüfungszustands eines Elements. Für jedes andere Element, das überprüft werden soll, wird aufgerufen, SetItemCheckState um auf CheckStateIndeterminatefestzulegen, während SetItemChecked für das andere Element aufgerufen wird, um den überprüften Zustand auf Checkedfestzulegen.
Das Beispiel veranschaulicht auch die Verwendung der Items -Eigenschaft, um die CheckedListBox.ObjectCollection von Elementen abzurufen Count .
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
Hinweise
Die SetItemCheckState-Methode löst das ItemCheck-Ereignis aus.
Elemente, deren CheckState Einstellung mit einem Häkchen im Kontrollkästchen angezeigt Indeterminate wird, das Kontrollkästchen ist jedoch abgeblendet, um die unbestimmte status des aktivierten Elements anzugeben.
