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, то допускается только допустимый ввод данных, который в этом примере будет цифрой.
