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", поэтому текущая позиция в маске находится в первом литерале косой черты (/). Если SkipLiterals имеет значение true, пользователь имеет следующие допустимые варианты:

  • Пользователь может ввести символ "/". Это приводит к перемещению позиции в следующий символ, который в данном примере является четвертой позицией, маскируя элемент 9.

  • Пользователь может ввести следующий редактируемый символ, который в этом примере является цифрой. Цифра будет проверена, а текущая позиция будет автоматически перемещена на пятую позицию, которая является элементом маскирования 0.

Если SkipLiterals имеет значение false, то допускается только допустимый ввод данных, который в этом примере будет цифрой.

Применяется к

См. также раздел