연습: MaskedTextBox 컨트롤 사용
업데이트: 2010년 9월
이 연습에서 수행할 작업은 다음과 같습니다.
MaskedTextBox 컨트롤 초기화
문자가 마스크에 맞지 않을 경우 MaskInputRejected 이벤트 처리기를 사용하여 사용자에게 경고 보내기
ValidatingType 속성에 형식을 할당한 다음 커밋하려는 값이 형식에 유효하지 않은 경우 TypeValidationCompleted 이벤트 처리기를 사용하여 사용자에게 경고 보내기
프로젝트 만들기 및 컨트롤 추가
MaskedTextBox 컨트롤을 폼에 추가하려면
MaskedTextBox 컨트롤을 배치할 폼을 엽니다.
도구 상자에서 MaskedTextBox 컨트롤을 폼으로 끌어 옵니다.
컨트롤을 마우스 오른쪽 단추로 클릭하고 속성을 선택합니다. 속성 창에서 마스크 속성을 선택한 다음 속성 이름 옆의 ...(줄임표) 단추를 클릭합니다.
입력 마스크 대화 상자에서 간단한 날짜 마스크를 선택하고 확인을 클릭합니다.
속성 창에서 BeepOnError 속성을 true로 설정합니다. 이 속성은 사용자가 마스크 정의에 위반되는 문자를 입력할 때마다 짧은 경고음을 울립니다.
Mask 속성이 지원하는 문자에 대한 요약은 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
참고 항목
참조
기타 리소스
MaskedTextBox 컨트롤(Windows Forms)
변경 기록
날짜 |
변경 내용 |
이유 |
---|---|---|
2010년 9월 |
Mask 속성이 지원하는 문자를 요약하는 Mask 속성에 대한 링크가 추가되었습니다. |
고객 의견 |