ItemCheckEventArgs.NewValue Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica si se va a establecer la casilla del elemento para que esté activada, desactivada o indeterminada.
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, setPublic Property NewValue As CheckStateValor de propiedad
Uno de los valores de CheckState.
Ejemplos
En el ejemplo de código siguiente se muestra el uso de este miembro. En el ejemplo, un controlador de eventos informa sobre la aparición del CheckedListBox.ItemCheck evento. Este informe le ayuda a aprender cuándo se produce el evento y puede ayudarle a depurar. Para informar sobre varios eventos o eventos que se producen con frecuencia, considere la posibilidad de reemplazar MessageBox.Show por Console.WriteLine o anexar el mensaje a una línea TextBoxmúltiple.
Para ejecutar el código de ejemplo, péguelo en un proyecto que contenga una instancia de tipo CheckedListBox denominada CheckedListBox1. A continuación, asegúrese de que el controlador de eventos está asociado al CheckedListBox.ItemCheck evento.
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
Comentarios
Esta propiedad permite determinar el nuevo estado de comprobación del elemento especificado antes de que el control cambie el CheckedListBox estado de comprobación. Además de determinar el nuevo estado de comprobación, puede usar esta propiedad en un controlador de eventos para que el ItemCheck evento cambie el estado a un estado de comprobación diferente al especificado. Por ejemplo, si el usuario colocó una marca de verificación junto a un elemento en el CheckedListBox que ha determinado que no debe comprobarse en función del estado de la aplicación, puede invalidar el cambio en el estado de la marca de verificación estableciendo esta propiedad en su configuración anterior o en un estado de comprobación diferente.
