MaskedTextBox.MaskInputRejected Evento
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í.
Se produce cuando la entrada del usuario o el carácter asignado no coincide con el elemento de formato correspondiente de la máscara de entrada.
public:
event System::Windows::Forms::MaskInputRejectedEventHandler ^ MaskInputRejected;public event System.Windows.Forms.MaskInputRejectedEventHandler MaskInputRejected;public event System.Windows.Forms.MaskInputRejectedEventHandler? MaskInputRejected;member this.MaskInputRejected : System.Windows.Forms.MaskInputRejectedEventHandler Public Custom Event MaskInputRejected As MaskInputRejectedEventHandler Tipo de evento
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 MaskInputRejected 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 MaskedTextBox denominada MaskedTextBox1. A continuación, asegúrese de que el controlador de eventos está asociado al MaskInputRejected evento.
private void MaskedTextBox1_MaskInputRejected(Object sender, MaskInputRejectedEventArgs e) {
System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Position", e.Position );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "RejectionHint", e.RejectionHint );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "MaskInputRejected Event" );
}
Private Sub MaskedTextBox1_MaskInputRejected(sender as Object, e as MaskInputRejectedEventArgs) _
Handles MaskedTextBox1.MaskInputRejected
Dim messageBoxVB as New System.Text.StringBuilder()
messageBoxVB.AppendFormat("{0} = {1}", "Position", e.Position)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "RejectionHint", e.RejectionHint)
messageBoxVB.AppendLine()
MessageBox.Show(messageBoxVB.ToString(),"MaskInputRejected Event")
End Sub
Comentarios
MaskInputRejected es el evento predeterminado de la MaskedTextBox clase .
El MaskInputRejected evento se produce cuando la máscara de entrada rechaza un carácter. La máscara de entrada, representada por la Mask propiedad , se interpreta mediante el proveedor de texto enmascarado asociado al control a través de la MaskedTextProvider propiedad . MaskInputRejected se genera en las situaciones siguientes:
Un carácter de entrada no coincide con el elemento de formato correspondiente. Por ejemplo, el usuario escribe un carácter alfabético cuando se requiere un dígito. Esta es probablemente la razón más común por la que se genera este evento.
El usuario está intentando introducir caracteres extraños más allá del final de la máscara, ya sea porque la máscara ya se ha rellenado o la posición del símbolo de intercalación actual se ha movido al final de la cadena de máscara de entrada mostrada.
Una operación de pegado inserta un carácter que no coincide con su elemento de formato asociado o, si la IsOverwriteMode propiedad es
false, desplaza los caracteres existentes a nuevas posiciones donde no coinciden con sus elementos de formato.Una operación de corte desplaza los caracteres existentes a la izquierda y uno o varios caracteres no coinciden con sus elementos de formato recién asociados.
Se realizó una asignación a la Text propiedad y la cadena asignada produjo una o varias infracciones de máscara.
Si se asignó una cadena al control que hace MaskInputRejected que se produzca, no aparecerá ninguna parte de la cadena en MaskedTextBox.
El control predeterminado para MaskInputRejected reproducirá un sonido de pitido si la BeepOnError propiedad está establecida trueen . Este evento suele controlarse para implementar el control de errores personalizado, por ejemplo, para pasar al siguiente control de entrada de usuario si la máscara está llena o para mostrar un cuadro de diálogo de error personalizado o información sobre herramientas si el carácter de entrada no es válido.
