本文档描述了使用 Simple 掩码类型来创建掩码的语法。 这些掩码十分简单,因此不允许实现精致的数据输入模式。 但是当编辑器接受有固定格式及固定长度的字符串 (例如电话号码、邮政编码等) 时,它们是有用的。
关于其他掩码模式的总说明信息,请参阅 掩码编辑器概述 文档。
在本主题中:
Simple 掩码模式
要启用 Simple 掩码模式,则把 MaskProperties.MaskType 属性 (属于 RepositoryItemTextEdit.Mask 对象) 设置为 MaskType.Simple。 此掩码自身应该通过 MaskProperties.EditMask 属性被指定。
一个掩码表示一个可以由元字符、特殊字符和原义字符组成的字符串。元字符
元字符用于表示符号的范围。 最终用户只能在与元字符对应的位置中输入文本。 在掩码中特定位置上有元字符时,最终用户可以在编辑框中输入与该位置相关范围内的任何字符。 下表列出了可用的元字符:
字符 | 含义 |
---|---|
L | L 字符要求在其位置输入字母字符。 美国的字母字符是 A-Z、a-z。 |
l | l 字符仅允许在其位置输入字母字符,但是不强求。 |
A | A 字符要求在其位置输入字母或数字字符。 美国的字母或数字字符是 A-Z、a-z、0-9。 |
a | a 字符只允许在其位置输入字母或数字字符,但是不强求。 |
C | C 字符要求在其位置输入任意字符。 |
c | c 字符允许在其位置输入任意字符,但是不强求。 |
0 | 0 字符要求在其位置输入数字字符。 |
9 | 9 字符只允许在其位置输入数字字符,但是不强求。 |
# | # 字符只允许在其位置输入数字字符、正号或负号,但是不强求。 |
特殊字符
下表列出了可用的特殊字符,它们用于控制输入字符串的大小写,以及呈现多种定界符和货币符号。
字符 | 含义 |
---|---|
> | 如果在掩码中出现 > 字符,则在它后面的所有字符都转换为大写,直至到达掩码末或遇到 < 字符。 |
< | 如果在掩码中出现 < 字符,则在它后面的所有字符都转换为小写,直至到达掩码末或遇到 > 字符。 |
<> | 如果这两个字符一起出现在掩码中,则不执行大小写检查,并且使用由最终用户输入的大小写来格式化数据。 |
/ | / 字符用于分隔日期中的月份、日和年份。 如果分隔月份、日和年份的字符与应用程序运行的系统的区域设置不同,则此字符被替换为区域设置中指定的字符。 |
: | : 字符用于分隔时间值中的小时、分钟和秒。 如果分隔小时、分钟和秒的字符与应用程序运行的系统的区域设置不同,则此字符被替换为区域设置中指定的字符。 |
$ | $ 字符用于指示货币值。 如果指示货币值的字符与应用程序运行的系统的区域设置不同,则它被替换为区域设置中指定的字符。 |
原义字符
不是元字符、也不是特殊字符的字符被称为原义字符。 原义字符被自动原样插入到编辑框中的由掩码定义的指定位置。 最终用户不需要输入原义字符。 在编辑时光标会跳过原义字符。
如果以反斜杠 (\) 前导,则元字符和特殊字符也可以出现为原义字符。
示例
1. 输入电话号码的掩码: (000)000-00-00。
此掩码中的每个元字符“0” 都要求在相应位置输入数字字符。 不能省略字符。 在掩码中的“-”、“(”和“)” 字符是原义字符。
下面是使用了此掩码的编辑器的插图:(没有输入值)
(输入了值)
2. 输入有可选区号的电话号码的掩码: (999)000-00-00
此掩码中的元字符 “9” 允许最终用户省略电话号码的区号部分。(无区号部分的有效电话号码)
3. 输入字母-数字序列的掩码: \A>LL-00
此掩码中的 “\A” 代表原义字符“A”。 因为“A”被用作元字符,因此必须使用反斜杠来使得“A”出现为原义字符。 “>” 命令指明后面的文本应该转换为大写。 “LL” 子串指明在此位置应该插入两个字母字符。 “00” 子串是两位数字的占位符。(没有输入值)
(输入了值)