PidTagControlFlags 规范属性
适用于:Outlook 2013 | Outlook 2016
包含标志的位掩码,这些标志控制从显示表生成的对话框中使用的控件的行为。
属性 | 值 |
---|---|
相关属性: |
PR_CONTROL_FLAGS |
标识符: |
0x3F00 |
数据类型: |
PT_LONG |
区域: |
MAPI 显示表 |
备注
可以为此属性设置以下一个或多个标志:
DT_ACCEPT_DBCS
控件可以具有 Double-Byte 字符集 (DBCS) 字符集。 此标志用于编辑控件。 它允许使用多字节字符集。
DT_EDITABLE
控件可以编辑;可以更改与控件关联的值。 如果未设置此标志,则控件为只读。 在标签、组框、标准按钮、多值下拉列表框和列表框控件上忽略此值。
DT_MULTILINE
编辑控件可以包含多行。 这意味着可以在控件中输入返回字符。 此标志仅对编辑控件有效。
DT_PASSWORD_EDIT
适用于编辑控件。 编辑控件被视为密码。 该值使用星号显示,而不是回显输入的实际字符。
DT_REQUIRED
如果控件允许 (DT_EDITABLE) 更改,则调用 IMAPIProp::SaveChanges 之前,它必须具有一个值。
DT_SET_IMMEDIATE
启用值的即时设置;只要控件中的值发生更改,MAPI 就会为与该控件关联的属性调用 SetProps 方法。 如果未设置此标志,则会在关闭对话框时设置值。
DT_SET_SELECTION
在列表框中进行选择时,该列表框的索引列设置为属性。 始终与 DT_SET_IMMEDIATE 一起使用。
此属性存储在控件 的 DTCTL 结构的 ulCtlFlags 成员中。 大多数控件标志适用于允许用户输入的所有控件;一些仅适用于编辑控件。 不允许用户输入的控件(如按钮或标签)为其控件标志设置 0。
许多标志值都是不言而喻的。 例如,当为控件设置DT_REQUIRED时,它必须包含一个值,然后才允许关闭对话框。 服务提供商可以通过其 IMAPIProp 实现提供值,或者用户可以输入值。 DT_EDITABLE指示可以修改控件的值。 DT_MULTILINE允许编辑控件的值跨多行。
某些控件标志的含义并不那么明显。 当控件设置DT_SET_IMMEDIATE标志时,一旦用户移动到新控件,对其值的任何更改都会生效。 MAPI 对控件属性的属性接口的 IMAPIProp::SetProps 方法进行单个调用。 这与默认行为不同,默认行为是推迟控制值更改生效,直到用户选择 “确定 ”按钮或关闭对话框。 DT_SET_IMMEDIATE标志通常与显示表通知结合使用。
下表列出了控件的类型以及可为每种类型设置的所有标志值。
Control | 此属性的有效值 |
---|---|
按钮 |
必须为零 |
复选框 |
DT_EDITABLE、DT_SET_IMMEDIATE |
组合框 |
DT_EDITABLE、DT_REQUIRED、DT_SET_IMMEDIATE |
下拉列表框 |
DT_EDITABLE、DT_SET_IMMEDIATE |
编辑 |
DT_ACCEPT_DBCS、DT_MULTILINE、DT_EDITABLE、DT_PASSWORD_EDIT、DT_REQUIRED、DT_SET_IMMEDIATE |
分组框 |
必须为零 |
标签 |
必须为零 |
列表框 |
必须为零 |
多值下拉列表框 |
必须为零 |
多值列表框 |
必须为零 |
选项卡式页面 |
必须为零 |
单选按钮 |
必须为零 |
相关资源
头文件
Mapidefs.h
提供数据类型定义。
Mapitags.h
包含作为备用名称列出的属性的定义。