Esta documentación está archivada y no tiene mantenimiento.

MaskedTextBox.MaskInputRejected (Evento)

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.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public event MaskInputRejectedEventHandler MaskInputRejected
/** @event */
public void add_MaskInputRejected (MaskInputRejectedEventHandler value)

/** @event */
public void remove_MaskInputRejected (MaskInputRejectedEventHandler value)

En JScript, se pueden controlar los eventos que define una clase, pero no se pueden definir unos propios.
No aplicable.

MaskInputRejected es el evento predeterminado para la clase MaskedTextBox.

El evento MaskInputRejected se produce cuando la máscara de entrada rechaza un carácter. El proveedor de texto enmascarado asociado al control a través de la propiedad MaskedTextProvider interpreta la máscara de entrada, representada por la propiedad Mask. MaskInputRejected se produce 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. Ésta es probablemente la causa más frecuente por la que se produce este evento.

  • El usuario está intentando escribir caracteres extraños más allá del final de la máscara porque la máscara ya está llena o porque la posición del símbolo de intercalación actual se ha desplazado hasta el final de la cadena de la 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 propiedad IsOverwriteMode 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 más caracteres no coinciden con sus elementos de formato recién asociados.

  • Se hizo una asignación a la propiedad Text y la cadena asignada produjo una o más infracciones de la máscara.

Si se asignó al control una cadena que hace que se produzca MaskInputRejected, no aparecerá ninguna parte de la cadena en MaskedTextBox.

El control predeterminado para MaskInputRejected reproducirá un sonido si la propiedad BeepOnError se ha establecido en true. Este evento suele controlarse para implementar el control de errores personalizado, por ejemplo para desplazarse al siguiente control de entrada de datos del usuario si la máscara está llena, o para mostrar un cuadro de diálogo de error o información sobre herramientas personalizados si el carácter de entrada es no válido.

En el ejemplo de código siguiente se muestra el uso de este miembro. En el ejemplo, un controlador de eventos notifica que se ha producido el evento MaskInputRejected. Este informe es útil para saber cuándo se produce el evento y puede servir de ayuda en la depuración. Para informar sobre varios eventos o sobre eventos que se producen frecuentemente, considere la posibilidad de reemplazar System.Windows.Forms.MessageBox.Show por System.Console.WriteLine o de agregar el mensaje a un TextBox de varias líneas.

Para ejecutar el código de ejemplo, péguelo en un proyecto que contenga una instancia de tipo MaskedTextBox con la denominación MaskedTextBox1. A continuación, asegúrese de que el controlador de eventos esté asociado al evento MaskInputRejected.

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" );
}

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar: