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

包含作为备用名称列出的属性的定义。

另请参阅

MAPI 属性

MAPI 规范属性

将规范属性名称映射到 MAPI 名称

将 MAPI 名称映射到规范属性名称