MaskedTextBox.SkipLiterals 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置一个值,该值指示是否允许用户重新输入原义字符值。
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
,则只允许有效的数据输入,在此示例中为数字。