输入掩码属性
“输入掩码”属性用于指定掩码,该掩码将应用到要输入到组件的文字(例如,电话号码)。可将掩码作为文字模板或模式。
掩码字符
字符 | 说明 |
---|---|
> | 数字占位符 (0-9)。提示符为空白。适用于数字数据类型。 |
9 | 数字占位符 (0-9)。提示符为 0。适用于数字数据类型。包含 9 的掩码不支持空值(参见用法备注)。 |
Z | 数字占位符 (0-9)。提示符为空白,且不适用千位分隔符。适用于数字数据类型。 |
< | 小数位置的数字占位符 (0-9)。提示符为空白。删除无意义的尾部零。适用于数字数据类型。 |
# | 数字占位符 (0-9)。提示符为空白。适用于数字数据类型。
注意:该选项仅可用于向后兼容,且通常不使用。
|
- | 负号占位符。适用于数字数据类型。 |
。 | 小数占位符。该字符在掩码中视为文字。适用于数字数据类型。
使用的实际字符为区域设置中指定的字符(参见用法备注)。 |
, | 千位分隔符。该字符在掩码中视为文字。适用于数字数据类型。
使用的实际字符为区域设置中指定的字符。不需要指定千位分隔符。 |
: | 时间分隔符。该字符在掩码中视为文字。适用于 DATE 数据类型。
使用的实际字符为区域设置中指定为分隔符的字符。 |
A | 字母数字字符占位符(0-9 和 a-Z)。适用于 CHAR 数据类型。 |
? | 字母占位符 (a-Z)。适用于 CHAR 数据类型。 |
X | 强制字符使用大写字母的字母占位符 (A-Z)。适用于 CHAR 数据类型。 |
x | 强制字符使用小写字母的字母占位符 (a-z)。适用于 CHAR 数据类型。 |
& | 字符占位符。该占位符的有效值为以下范围内的 ANSI 字符:32-126 和 128-255。适用于 CHAR 数据类型。 |
\ | 文字转义。
要将任何上述字符视为文字,请在字符前使用反斜线。 |
[无] | 不适用于掩码。 |
用法备注
-
“空值”:包含“9”的数字掩码不支持空值;必须将某个值传递至组件。掩码将空值作为 0 进行查询。删除组件中的值将产生 0。从剪贴板粘贴将产生 0。如果包含掩码的组件不是必填项且没有缺省值,则新行中的组件值最初显示为 0,如果未输入值,则可以保存为 0。
不包含 9 的数字掩码支持空值,可以使用空值或空白值更新组件。掩码将空值作为空字符串进行查询。删除值或从剪贴板粘贴将产生空字符串。如果包含掩码的组件不是必填项且没有缺省值,则新行中未在组件中输入值的组件值可以保存为空值。
- “[无]”:[无] 设置将删除从组件类、属性类扩展或继承层次结构中的其他对象继承的任何掩码。
- 千位分隔符:掩码定义不需要指定千位分隔符(例如,逗号)。系统将使用 Windows 控制面板“区域选项”对话框中的十进制符号和数字分组符号定义自动设置这些分隔符。
- “货币”:在系统中代表货币数据的类将使用 Windows 控制面板“区域选项”对话框中为数字指定的值(而不是为货币指定的值)作为缺省值。
- “舍入”:如果“舍入”属性为“真”,则 WinStudio 将使用小数位数的掩码定义进行舍入。
- “忽略尾部零”:对于掩码包括 < 字符的小数值,显示该值时将删除无意义的尾部零。
例如
如果掩码设置为 >>>>>9.99<<< 且用户输入 12345.125000,则该值显示为 12,345.125。在光标离开该字段后进行此格式设置。