MaskedTextBox.MaskInputRejected Evento

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

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;

member this.MaskInputRejected : System.Windows.Forms.MaskInputRejectedEventHandler 

Public Custom Event MaskInputRejected As MaskInputRejectedEventHandler 

Tipo de evento

MaskInputRejectedEventHandler

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.

Consulte también

• Text
• Mask
• MaskedTextProvider
• MaskInputRejectedEventArgs
• IsOverwriteMode
• BeepOnError