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”,因此掩码中的当前位置是 /) 文本的第一个正斜杠 (。 如果 SkipLiteralstrue,则用户具有以下有效选项:

  • 用户可以输入“/”字符。 这会导致位置移动到下一个字符,在此示例中为第四个位置,一个 9 掩码元素。

  • 用户可以输入下一个可编辑字符,在此示例中为数字。 将验证数字,当前位置将自动移动到第五个位置,即 0 掩码元素。

如果 SkipLiteralsfalse,则只允许有效的数据输入,在此示例中为数字。

适用于

另请参阅