다음을 통해 공유


MaskedTextBox.SkipLiterals 속성

정의

사용자가 리터럴 값을 다시 입력할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.

public:
 property bool SkipLiterals { bool get(); void set(bool value); };
public bool SkipLiterals { get; set; }
member this.SkipLiterals : bool with get, set
Public Property SkipLiterals As Boolean

속성 값

리터럴을 다시 입력할 수 있게 하려면 true이고, 사용자가 리터럴 문자를 덮어쓰지 못하게 하려면 false입니다. 기본값은 true입니다.

설명

입력 마스크에는 일반적으로 리터럴이 포함됩니다. 사용자가 런타임에 에 문자를 MaskedTextBox 입력하면 현재 문자 위치가 리터럴에 속하는 경우가 있습니다. 속성은 SkipLiterals 다음과 같이 다음 문자에 대한 사용자 입력을 처리하는 방법을 설명합니다.

  • 이 속성이 인 true경우 사용자는 현재 위치에서 리터럴과 동일한 문자를 중복으로 입력하거나 다음 편집 가능한 문자를 입력하여 현재 위치를 해당 위치로 점프할 수 있습니다.

  • 이 속성이 이 false면 사용자는 다음 편집 가능한 문자만 입력할 수 있습니다. 마스크의 다음 위치가 리터럴 문자를 허용하지 않는 경우(예: 사용자가 "/"를 입력하고 다음 위치가 숫자만 허용) 컨트롤이 이벤트를 발생 MaskInputRejected 시킵니다.

예를 들어 "90/90/0000" 날짜 입력 마스크에서 슬래시 문자는 리터럴입니다. 사용자가 두 개의 초기 숫자 "11"을 입력했기 때문에 마스크의 현재 위치가 첫 번째 슬래시(/) 리터럴에 있다고 가정합니다. 이 이trueSkipLiterals 사용자에게 다음과 같은 유효한 선택 항목이 있습니다.

  • 사용자는 "/" 문자를 입력할 수 있습니다. 그러면 위치가 다음 문자로 이동됩니다. 이 예제에서는 네 번째 위치인 9 마스킹 요소입니다.

  • 사용자는 다음 편집 가능한 문자를 입력할 수 있습니다. 이 예제에서는 숫자입니다. 숫자의 유효성이 검사되고 현재 위치가 0 마스킹 요소인 다섯 번째 위치로 자동으로 이동됩니다.

이 이falseSkipLiterals 유효한 데이터 입력만 허용됩니다. 이 예제에서는 숫자가 됩니다.

적용 대상

추가 정보