转换掩码子标记

<hx:convertMask> 标记定义将格式化字符串转换为 Java™ 值和逆向转换的方式。带掩码字符串在该字符串中的已定义位置包含字面值字符,并且限制了该字符串中其他位置所允许的字符。

父标记

此标记用作下列标记的子代:

呈示

此组件无可视呈示。不呈示任何 HTML 文件。

属性视图和全部属性视图

组件的“属性”视图显示可以对组件设置的最常见属性集,并且根据组件的不同,您还可以看到用于添加控件、操作或其他组件的选项。要打开“属性”视图,请单击窗口 > 显示视图 > 属性

以下是“转换掩码”子标记的常见属性:

“全部属性”视图显示可以对组件设置的全部属性的表,包含可以从“属性”视图访问的那些属性。要切换至“全部属性”视图,请单击“属性”视图右上角的全部属性图标 “全部属性”图标

表 1. 转换掩码属性

属性名称

描述

asis

指定是否除去除掩码输入以外的数据。缺省值为 false。

char1RegEx

该正则表达式描述在掩码模式中标有 # 字符的位置处所允许的字符。如果省略,则将使用表达式 [0-9],允许使用数字 0 至 9。

char2RegEx

该正则表达式描述在掩码模式中标有 ? 字符的位置处所允许的字符。如果省略,则将使用表达式 [a-zA-Z],允许使用 ASCII 字母字符。

char3RegEx

该正则表达式描述在掩码模式中标有 ! 字符的位置处所允许的字符。如果省略,则将 ! 字符视为模式中的文字。

char4RegEx

该正则表达式描述在掩码模式中标有 ~ 字符的位置处所允许的字符。如果省略,则将 ~ 字符视为模式中的文字。

掩码

描述值的文字和字符的模式。

protectMask

保护“标记”位置中的字符免遭更改(或验证),例如,您可以“保护”字符串中包含标记(#、?、! 和 ~)的位置以便用户不能输入此字符,取而代之的是按程序方式来设置该位置的值,该值通常在初始值中。这可以有效地将值中的字符转换为文字。仅当此掩码在 inputText 字段中使用并且该字段启用了输入辅助时,此属性才有用。如果提供了 protectMask,则它与掩码应该是长度相同的字符串。如果位置中有 X(大写 X),则此位置已标记为“受保护”。不保护没有 X 的位置。


反馈