MaskedTextBox.SkipLiterals Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее, разрешен ли пользователь повторно ввести литеральные значения.
public:
property bool SkipLiterals { bool get(); void set(bool value); };public bool SkipLiterals { get; set; }member this.SkipLiterals : bool with get, setPublic Property SkipLiterals As BooleanЗначение свойства
true разрешение повторного ввода литерала; в противном случае, false чтобы запретить пользователю перезаписывать литеральные символы. Значение по умолчанию — true.
Комментарии
Маски ввода обычно содержат литералы. Когда пользователь вводит символы в MaskedTextBox среду выполнения, текущее положение символов иногда попадает на литерал. Свойство SkipLiterals описывает, как обрабатывать входные данные пользователя для следующего символа следующим образом:
Если это свойство имеется
true, пользователь может либо избыточно ввести тот же символ, что и литерал в текущей позиции, либо ввести следующий редактируемый символ, тем самым перепрыгнув текущую позицию в эту позицию.Если это свойство имеется
false, пользователь может ввести только следующий редактируемый символ. Если следующая позиция в маске не принимает литеральный символ (например, пользователь вводит "/" и следующую позицию принимает только цифры), элемент управления вызовет MaskInputRejected событие.
Например, в маске записи даты 90/90/0000 символы косой черты являются литералами. Предположим, что пользователь ввел две начальные цифры :11, поэтому текущая позиция в маске находится в первом литерале косой черты (/). Если SkipLiterals есть true, то у пользователя есть следующие допустимые варианты:
Пользователь может ввести символ "/". Это приводит к перемещению позиции на следующий символ, который в этом примере является четвертой позицией, элементом маскирования 9.
Пользователь может ввести следующий редактируемый символ, который в этом примере является цифрой. Цифра будет проверена, и текущая позиция будет автоматически перемещена в пятую позицию, которая является элементом маскирования 0.
SkipLiteralsВ противном false случае допускается только допустимый вход данных, который в этом примере будет цифрой.
