ItemCheckEventArgs.NewValue Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá nebo nastaví hodnotu označující, zda chcete nastavit zaškrtávací políčko pro položku, která má být zaškrtnutá, nezaškrtnuta nebo neurčitá.

public:
 property System::Windows::Forms::CheckState NewValue { System::Windows::Forms::CheckState get(); void set(System::Windows::Forms::CheckState value); };

public System.Windows.Forms.CheckState NewValue { get; set; }

member this.NewValue : System.Windows.Forms.CheckState with get, set

Public Property NewValue As CheckState

Hodnota vlastnosti

CheckState

Jedna z CheckState hodnot.

Příklady

Následující příklad kódu ukazuje použití tohoto členu. V příkladu obslužná rutina události hlásí výskyt CheckedListBox.ItemCheck události. Tato sestava vám pomůže zjistit, kdy k události dojde, a může vám pomoct s laděním. Pokud chcete hlásit více událostí nebo událostí, ke kterým dochází často, zvažte nahrazení MessageBox.ShowConsole.WriteLine nebo připojení zprávy k víceřádkovému TextBoxobjektu .

Pokud chcete spustit ukázkový kód, vložte ho do projektu, který obsahuje instanci typu CheckedListBox s názvem CheckedListBox1. Pak se ujistěte, že je obslužná rutina události přidružená k CheckedListBox.ItemCheck události.

private void CheckedListBox1_ItemCheck(Object sender, ItemCheckEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Index", e.Index );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "NewValue", e.NewValue );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "CurrentValue", e.CurrentValue );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "ItemCheck Event" );
}

Private Sub CheckedListBox1_ItemCheck(sender as Object, e as ItemCheckEventArgs) _ 
     Handles CheckedListBox1.ItemCheck

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Index", e.Index)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "NewValue", e.NewValue)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "CurrentValue", e.CurrentValue)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"ItemCheck Event")

End Sub

Poznámky

Tato vlastnost umožňuje určit nový stav kontroly pro zadanou položku před změnou stavu kontroly ovládacím CheckedListBox prvku. Kromě určení nového stavu kontroly můžete tuto vlastnost použít v obslužné rutině události pro ItemCheck událost ke změně stavu na jiný stav kontroly, než je zadaný stav. Pokud například uživatel umístil značku zaškrtnutí vedle položky v objektu CheckedListBox , který jste určili, že by neměla být zaškrtnutá na základě stavu vaší aplikace, můžete změnu stavu zaškrtnutí přepsat nastavením této vlastnosti na její předchozí nastavení nebo na jiný stav kontroly.

Viz také

• CurrentValue