MaskedTextBox.MaskInputRejected 事件

  • 参考

定义

命名空间:
System.Windows.Forms
程序集:
System.Windows.Forms.dll

当用户的输入或者分配的字符与输入掩码的对应格式元素不匹配时发生。

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

事件类型

MaskInputRejectedEventHandler

示例

下面的代码示例演示了此成员的用法。 在此示例中，事件处理程序报告事件的发生情况 MaskInputRejected 。 此报表可帮助你了解事件发生的时间，并可以帮助你进行调试。 若要报告多个事件或频繁发生的事件，请考虑将 MessageBox.Show 替换为 Console.WriteLine 或将消息追加到多行 TextBox。

若要运行示例代码，请将其粘贴到包含名为 MaskedTextBox1的 类型的MaskedTextBox实例的项目中。 然后，确保事件处理程序与 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" );
}

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

注解

MaskInputRejected 是 类的默认事件 MaskedTextBox 。

输入 MaskInputRejected 掩码拒绝字符时发生 该事件。 由 Mask 属性表示的输入掩码由与 控件关联的掩码文本提供程序通过 MaskedTextProvider 属性进行解释。 MaskInputRejected 在以下情况下引发 ：

  • 输入字符与相应的格式元素不匹配。 例如，当用户需要数字时输入字母字符。 这可能是引发此事件的最常见原因。

  • 用户尝试输入掩码末尾以外的无关字符，原因是掩码已填充，或者当前插入点位置已移到显示的输入掩码字符串的末尾。

  • 粘贴操作会插入与其关联的 format 元素不匹配的字符，或者如果该 IsOverwriteMode 属性为 false，则会将现有字符移动到与其格式元素不匹配的新位置。

  • 剪切操作将现有字符向左移动，并且一个或多个字符与其新关联的格式元素不匹配。

  • 对 属性进行了 Text 赋值，分配的字符串导致一个或多个掩码冲突。

如果将字符串分配给导致 MaskInputRejected 发生的控件，则字符串的一部分不会出现在 中 MaskedTextBox。

如果 BeepOnError 属性设置为 true，则 的默认MaskInputRejected处理将播放蜂鸣声。 处理此事件通常是为了实现自定义错误处理，例如，在掩码已满时移动到下一个用户输入控件，或者在输入字符无效时显示自定义错误对话框或工具提示。

适用于

另请参阅