输入掩码属性

“输入掩码”属性用于指定掩码,该掩码将应用到要输入到组件的文字(例如,电话号码)。可将掩码作为文字模板或模式。

掩码字符

字符 说明
> 数字占位符 (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。在光标离开该字段后进行此格式设置。

相关主题