2024年3月30日发(作者:)

编辑掩码

使用C1Input控件>编辑掩码

当您设置EditMask属性为一个掩码字符串时,C1Input控件支持掩码输入。如果你定义了一个

编辑掩码,在控件中每一个字符位置将映射到一个特殊的占位符或者文本字符。文本字符,或者

说文本,可以对所使用的数据类型起到提示作用。例如,在一个电话号码的格式中,包围电话号

码区号的圆括号以及短线就是文本字符:(412)-123-4567.编辑掩码阻止您输入无效字符,并提供

了对用户界面的其它增强。

为了启用掩码输入,设置EditMask属性的值为一个由占位符和文本字符组成的掩码字符串,

可用的占位符如下表所示:您也可以通过CustomPlaceholders集合定义您自己的占位符。

尽管在简单情况下设置EditMask就已经足够,同时还提供了一个包含一组用来控制掩码输入各

种重要方面子属性的MaskInfo属性。其中一个就是上面所提到的CustomPlaceholders集合。

其他一些属性为:

属性 描述

AutoTabWhenFilled

如果为True,当掩码填充满时,焦点将自动移动到下一个控件。默认

值:False。

PromptChar

SaveBlanks

在空白输入位置显示的提示字符。默认值:'_'。

如果为True,则存储文本包含空白位置,使用StoredEmptyChar定

义的值。默认值:False。

SaveLiterals

ShowLiterals

如果为True(默认值),存储的文本(StoredContent)将包含文本字符。

控制当用户输入时,文本字符出现方式的枚举设置。文本字符可以始终

出现,从不出现,或者当用户输入位置到达某个文本字符时出现。

SkipOptional

如果为True(默认),可选地掩码位置可以被自动跳过,直至到达第一

个允许该字符的输入位置。

存储在空白掩码位置的字符。默认值:'_'。

StoredEmptyChar

关于掩码相关属性的完整列表,请参见MaskInfo类。

如果ShowLiterals属性设置为FreeFormatEntry,则可选掩码位置可以完全被忽略;不需要填充

这些空白字符。

C1Input中使用的掩码字符(占位符)和Microsoft Access以及Microsoft ActiveX MaskEdit控

件中使用的占位符类似(使用CustomPlaceholders集合可以定义更多的占位符):

占位符

#

描述

数字占位符表示该位置允许一位数字或加减号(是否输入为可

选)。

.

小数点占位符。实际使用的字符是您的国际化设置所指定

的小数点占位符。该字符作为掩码处理为文本字符。

,

千位分隔符。实际使用的字符是您的国际化设置所指定的

千位分隔符。该字符作为掩码处理为文本字符。

:

时间分隔符。实际使用的字符是您的国际化设置所指定的时间分

隔符。该字符作为掩码处理为文本字符。

/

日期分隔符。实际使用的字符是您的国际化设置所指定的日期分

隔符。该字符作为掩码处理为文本字符。

转义符号,将掩码字符串中的下一个字符作为文本字符。这可以

让您在掩码中包含#,&,A,…等字符。该字符作为掩码处理为

文本字符。

&

字符占位符(必须输入)。允许输入任何字符。

>

将之后所有的字符转换为大写形式。