ItemCheckEventArgs.NewValue Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ItemCheckEventArgs.cs

Získá nebo nastaví hodnotu označující, zda má být nastaveno 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 člena. V tomto 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 při ladění. Chcete-li 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 do víceřádkového řetězce TextBox.

Pokud chcete spustit ukázkový kód, vložte ho do projektu, který obsahuje instanci typu CheckedListBox s názvem CheckedListBox1. Potom 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 k ItemCheck 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, CheckedListBox kterou jste určili, 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 předchozí nastavení nebo na jiný stav kontroly.

Viz také

• CurrentValue