연습: MaskedTextBox 컨트롤 사용

아티클
05/04/2023

이 연습에서 설명하는 작업은 다음과 같습니다.

MaskedTextBox 컨트롤 초기화
문자가 마스크를 준수하지 않는 경우 MaskInputRejected 이벤트 처리기를 사용하여 사용자에게 경고
ValidatingType 속성에 형식을 할당하고 TypeValidationCompleted 이벤트 처리기를 사용하여 커밋하려는 값이 형식에 유효하지 않은 경우 사용자에게 경고

프로젝트 만들기 및 컨트롤 추가

양식에 MaskedTextBox 컨트롤을 추가하려면

MaskedTextBox 컨트롤을 배치할 양식을 엽니다.
도구 상자에서 MaskedTextBox 컨트롤을 양식으로 끌어다 놓습니다.
컨트롤을 마우스 오른쪽 단추로 클릭하고 속성을 선택합니다. 속성 창에서 마스크 속성을 선택하고 속성 이름 옆에 있는 ...(줄임표) 단추를 클릭합니다.
입력 마스크 대화 상자에서 짧은 날짜 마스크를 선택하고 확인을 클릭합니다.
속성 창에서 BeepOnError 속성을 true로 설정합니다. 이 속성은 사용자가 마스크 정의를 위반하는 문자를 입력하려고 할 때마다 짧은 경고음을 울립니다.

마스크 속성이 지원하는 문자에 대한 요약은 Mask 속성의 설명 섹션을 참조하세요.

입력 오류에 대해 사용자에게 경고

거부된 마스크 입력에 대한 풍선 설명 추가

도구 상자로 돌아가서 양식에 ToolTip을 추가합니다.

입력 오류가 발생할 때 ToolTip을 발생하는 MaskInputRejected 이벤트에 대한 이벤트 처리기를 만듭니다. 풍선 설명은 5초 동안 또는 사용자가 클릭할 때까지 계속 표시됩니다.

public void Form1_Load(Object sender, EventArgs e)
{  
    ... // Other initialization code  
    maskedTextBox1.Mask = "00/00/0000";  
    maskedTextBox1.MaskInputRejected += new MaskInputRejectedEventHandler(maskedTextBox1_MaskInputRejected)  
}  

void maskedTextBox1_MaskInputRejected(object sender, MaskInputRejectedEventArgs e)  
{  
    toolTip1.ToolTipTitle = "Invalid Input";  
    toolTip1.Show("We're sorry, but only digits (0-9) are allowed in dates.", maskedTextBox1, maskedTextBox1.Location, 5000);  
}

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load  
    Me.ToolTip1.IsBalloon = True  
    Me.MaskedTextBox1.Mask = "00/00/0000"  
End Sub  

Private Sub MaskedTextBox1_MaskInputRejected(sender as Object, e as MaskInputRejectedEventArgs) Handles MaskedTextBox1.MaskInputRejected  
    ToolTip1.ToolTipTitle = "Invalid Input"  
    ToolTip1.Show("We're sorry, but only digits (0-9) are allowed in dates.", MaskedTextBox1, 5000)  
End Sub

사용자에게 유효하지 않은 형식에 대해 경고합니다.

잘못된 데이터 형식에 대한 풍선 설명을 추가합니다.

양식의 Load 이벤트 처리기에서 DateTime 형식을 나타내는 Type 개체를 MaskedTextBox 컨트롤의 ValidatingType 속성에 할당합니다.

private void Form1_Load(Object sender, EventArgs e)  
{  
    // Other code  
    maskedTextBox1.ValidatingType = typeof(System.DateTime);  
    maskedTextBox1.TypeValidationCompleted += new TypeValidationEventHandler(maskedTextBox1_TypeValidationCompleted);  
}

Private Sub Form1_Load(sender as Object, e as EventArgs)  
    // Other code  
    MaskedTextBox1.ValidatingType = GetType(System.DateTime)  
End Sub

TypeValidationCompleted 이벤트에 대한 이벤트 처리기를 추가합니다.

public void maskedTextBox1_TypeValidationCompleted(object sender, TypeValidationEventArgs e)  
{  
    if (!e.IsValidInput)  
    {  
       toolTip1.ToolTipTitle = "Invalid Date Value";  
       toolTip1.Show("We're sorry, but the value you entered is not a valid date. Please change the value.", maskedTextBox1, 5000);  
       e.Cancel = true;  
    }  
}

Public Sub MaskedTextBox1_TypeValidationCompleted(sender as Object, e as TypeValidationEventArgs)  
    If Not e.IsValidInput Then  
       ToolTip1.ToolTipTitle = "Invalid Date Value"  
       ToolTip1.Show("We're sorry, but the value you entered is not a valid date. Please change the value.", maskedTextBox1, 5000)  
       e.Cancel = True  
    End If  
End Sub