通过

MaskedEdit 控件

  • 项目

MaskedEdit 控件是一个编辑字段控件，包含控件的文本找到中的掩码。 可以通过在 Control 表的 Property 列中输入属性名称，将该控件与某个字符串值属性相关联。

可以使用 MaskedEdit 控件为用户输入信息（如电话号码或产品 ID 代码）创建模板。 例如，用户可以通过 MaskedEdit 控件输入 PIDKEY 属性，该控件是通过将 PIDTemplate 属性设置为如下所示的字符串而指定的：

12345<### -%%%%%%%>@@@@@

字符串定义用户 PIDKEY 属性条目的掩码模板。 字符串的可见部分由一对括号 (<>) 字符括起来。

下表标识了掩码的语法。

字符 含义
< 模板的可见段的左端。 此字符及其左侧的所有内容都将在用户界面中隐藏。 模板中不应多次出现此字符。
> 模板的可见段的右端。 此字符及其右侧的所有内容都将在用户界面中隐藏。 验证期间，此字符将替换为短划线。 如果可见段以 < 开头，则必须使用匹配的 > 来终止。
# 此字符可以是数字。
% 此字符可以是备用数字（数值），使掩码能够控制自定义操作区分字段的方式。
@ 此字符可以是随机数字（数值）。此字符不应出现在模板的可见部分。
& 此字符可以是任意字符。
^ 此字符可以是备用字符，使掩码能够控制自定义操作区分字段的方式。
? 此字符可以是备用字符，使掩码能够控制自定义操作区分字段的方式。
` 重音标记 ' (ASCII 值 96) 可以表示备用字符，使掩码能够控制自定义操作区分字段的方式。
_ 此字符是文本下划线字符。
= 此字符是字段终止符。 后面必须带有 #、%、^ 或 `。 这会创建一个与上述位置类型相同的多一个输入位置，并使用“-”分隔符终止字段。

 

任何其他字符都被视为文本常量。

对于可以编辑的字符，控件会为同一类连续字符的每个块创建单独的编辑窗口。

控件属性

若要使用事件更改属性的值，请在 EventMapping 表中将该控件订阅到一个 Control 事件，并在 Attribute 列中列出该属性标识符。 在 Event 列中输入 Control 事件的标识符。 可以将以下属性用于 MaskedEdit 控件。

Attribute 十六进制位 说明
IndirectPropertyName 这是与控件关联的间接属性的名称。 如果设置了 Indirect 属性位，控件将显示或更改具有此名称的属性的值。 如果设置了 Indirect 属性位，此名称也是 Control 表的 Property 列中列出的属性的值。
位置 控件在对话框中的位置。 在 Control 表的 Width、Height、X 和 Y 列中分别输入控件的宽度、高度和控件左角的坐标。 使用安装程序单位表示长度和距离。
PropertyName 这是与此控件关联的属性的名称。 如果未设置 Indirect 属性位，控件将显示或更改具有此名称的属性的值。 此属性在 Control 表的 Property 列中指定。
PropertyValue 此控件显示或更改的属性的当前值。 如果未设置 Indirect 属性位，则这是 PropertyName 的值。 如果设置了 Indirect 属性位，则这是 IndirectPropertyName 的值。 如果属性发生更改，控件将反映新值。
文本 若要设置文本字符串的字体和字体样式，请在显示的字符串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 表的 Style 列中列出的标识符。 如果这两者都不存在，但 DefaultUIFont 属性定义为有效的文本样式，则会使用该字体。 指定掩码模板的字符串遵循此前缀，并使用本主题前面所述的语法。
Visible 0x00000000 0x00000001
 隐藏的控件。 可见控件。
将此位包含在 Control 表中 Attributes 列的位字中，以使控件在创建后可见或隐藏。
还可使用 ControlCondition 表隐藏或显示控件。
已启用 0x00000000 0x00000002
 处于禁用状态的控件。 处于启用状态的控件。
将此位包含在 Control 表的 Attributes 列中的位字中，以便在创建控件时启用该控件。
还可使用 ControlCondition 表启用或禁用控件。
Sunken 0x00000000 0x00000004
 显示默认视觉样式。 显示呈凹陷三维外观的控件。
将这些位包含在 Control 表的 Attributes 列中的位字中。
间接 0x00000000 0x00000008
 控件显示或更改 Control 表的 Property 列中的属性的值。 控件显示或更改 Control 表的 Property 列中列出了其标识符的属性的值。
确定是否间接引用与此控件关联的属性。

 

备注

MaskedEdit 控件使用 BS_OWNERDRAW 和 WS_EX_CONTROLPARENT 样式创建 BUTTON 类的一个父窗口。 此控件为此窗口创建多个子窗口。

  • 对于常量文本部分，它会创建具有 SS_LEFT 和 WS_CHILD 样式的 STATIC 窗口。
  • 对于可编辑字段，此控件会创建一个包含 WS_CHILD、WS_BORDER和 WS_TABSTOP样式的 EDIT 窗口。
  • 对于数值字段，窗口还具有 ES_NUMBER 样式。

替代数字、% 和替代字母数字字符、^、? 和 ` 字段允许自定义操作以掩码控制的方式区分字段，例如，^ 可用于应为大写的字段。