CheckedListBox.SetItemCheckState(Int32, CheckState) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee stelt u de controlestatus van het item in op de opgegeven 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 -> unitPublic Sub SetItemCheckState (index As Integer, value As CheckState)Parameters
- index
- Int32
De index van het item waarvoor de status moet worden ingesteld.
- value
- CheckState
Een van de CheckState waarden.
Uitzonderingen
De index opgegeven waarde is kleiner dan nul.
– of –
De index waarde is groter dan of gelijk aan het aantal items in de lijst.
Het value is geen van de CheckState waarden.
Voorbeelden
In het volgende voorbeeld worden de items in de CheckedListBox lijst opgesomd en wordt elk ander item in de lijst gecontroleerd. In het voorbeeld ziet u hoe u de controlestatus van een item instelt met behulp van de SetItemCheckState en SetItemChecked methoden. Voor elk ander item dat moet worden gecontroleerd, SetItemCheckState wordt aangeroepen om het CheckState in Indeterminatete stellen op , terwijl SetItemChecked het andere item wordt aangeroepen om de status gecontroleerd Checkedin te stellen op .
In het voorbeeld ziet u ook hoe u de Items eigenschap gebruikt om de CheckedListBox.ObjectCollectionCount items op te halen.
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
Opmerkingen
Met SetItemCheckState de methode wordt de ItemCheck gebeurtenis gegenereerd.
Items waarvan CheckState het selectievakje is ingesteld op Indeterminate weergeven met een vinkje in het selectievakje, maar het vak wordt grijs weergegeven om de onbepaalde status van het ingeschakelde item aan te geven.
