MaskedTextBox.MaskInputRejected 이벤트

정의

사용자 입력 또는 할당된 문자가 입력 마스크의 해당 서식 요소와 일치하지 않으면 발생합니다.

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 

이벤트 유형

예제

다음 코드 예제에서는이 멤버를 사용 하는 방법을 보여 줍니다. 예제에서는 이벤트 처리기에서 보고서를 MaskInputRejected 이벤트입니다. 이 보고서를 통해 이벤트 발생 하 고 도움이 될 수 있습니다 디버깅 하는 경우를 학습할 수 있습니다. 자주 발생 하는 이벤트 또는 여러 이벤트를 보고 하려면 바꾸는 것이 좋습니다 MessageBox.Show 사용 하 여 Console.WriteLine 줄에 메시지를 추가 또는 TextBox합니다.

예제 코드를 실행 하려면 형식의 인스턴스를 포함 하는 프로젝트에 붙여넣습니다 MaskedTextBox 라는 MaskedTextBox1합니다. 연결 된 이벤트 처리기는 확인 된 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 은 다음과 같은 상황에서 발생합니다.

  • 입력 문자가 해당 형식 요소와 일치하지 않습니다. 예를 들어 사용자는 숫자가 필요할 때 알파벳 문자를 입력합니다. 이 이벤트가 발생하는 가장 일반적인 이유일 수 있습니다.

  • 마스크가 이미 채워졌거나 현재 caret 위치가 표시된 입력 마스크 문자열의 맨 끝으로 이동되었기 때문에 사용자가 마스크의 끝을 넘어 불필요한 문자를 입력하려고 합니다.

  • 붙여넣기 작업은 연결된 서식 요소와 일치하지 않는 문자를 삽입하거나 속성이 false인 경우 IsOverwriteMode 기존 문자를 해당 서식 요소와 일치하지 않는 새 위치로 이동합니다.

  • 잘라내기 작업은 기존 문자를 왼쪽으로 이동하고 하나 이상의 문자가 새로 연결된 서식 요소와 일치하지 않습니다.

  • 속성에 Text 할당되었고 할당된 문자열로 인해 하나 이상의 마스크 위반이 발생했습니다.

문자열이 발생하게 하는 MaskInputRejected 컨트롤에 할당된 경우 문자열의 일부가 에 MaskedTextBox표시되지 않습니다.

에 대한 MaskInputRejected 기본 처리는 속성이 로 설정된 경우 BeepOnError 비프음 소리를 재생합니다 true. 이 이벤트는 마스크가 가득 찬 경우 다음 사용자 입력 컨트롤로 이동하거나 입력 문자가 잘못된 경우 사용자 지정 오류 대화 상자 또는 도구 설명을 표시하기 위해 사용자 지정 오류 처리를 구현하기 위해 처리되는 경우가 많습니다.

적용 대상

추가 정보