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 會在下列情況下引發：

  • 輸入字元不符合對應的格式專案。 例如，使用者會在需要數位時輸入字母字元。 這可能是引發此事件最常見的原因。

  • 使用者嘗試輸入超出遮罩結尾的額外字元，因為遮罩已填滿，或目前的插入號位置已移至所顯示輸入遮罩字串的結尾。

  • 貼上作業會插入不符合其相關聯格式專案的字元，或者如果 IsOverwriteMode 屬性為 false ，則會將現有字元移入不符合其格式元素的新位置。

  • 剪下作業會將現有的字元向左移位，而一或多個字元不符合新相關聯的格式專案。

  • 已對 屬性進行 Text 指派，而指派的字串導致一或多個遮罩違規。

如果已將字串指派給導致 MaskInputRejected 發生的控制項，則字串中不會顯示 MaskedTextBox 任何部分。

如果 BeepOnError 屬性設定 true 為 ，則 的預設處理 MaskInputRejected 會播放嗶聲。 此事件通常會處理以實作自訂錯誤處理，例如，如果遮罩已滿，則移至下一個使用者輸入控制項，或者如果輸入字元無效，則會顯示自訂錯誤對話方塊或工具提示。

適用於

另請參閱