DTBLCHECKBOX
适用于：Outlook 2013 | Outlook 2016
包含有关将在从显示表生成的对话框中使用的检查框的信息。
| 属性 | 值 |
|---|---|
| 标头文件： |
Mapidefs.h |
| 相关宏： |
SizedDtblCheckBox |
typedef struct _DTBLCHECKBOX
{
ULONG ulbLpszLabel;
ULONG ulFlags;
ULONG ulPRPropertyName;
} DTBLCHECKBOX, FAR *LPDTBLCHECKBOX;
Members
ulbLpszLabel
在检查框中显示的字符串的内存中的位置。
ulFlags
用于指定检查框标签格式的标志的位掩码。 可以设置以下标志：
MAPI_UNICODE
标签采用 Unicode 格式。 如果未设置MAPI_UNICODE标志，则标签采用 ANSI 格式。
ulPRPropertyName
PT_BOOLEAN 类型的属性的属性标记。 此属性的值受检查框的状态影响。
备注
DTBLCHECKBOX 结构描述一个检查框，该控件反映了两种状态之一：启用 (复选框) 或禁用 (空框) 。
ulPRPropertyName 成员描述通过更改检查框的状态操作其值的布尔属性。 首次显示检查框时，MAPI 调用与显示表关联的 IMAPIProp 实现的 GetProps 方法，以检索一组默认属性。 如果其中一个属性映射到 DTBLCHECKBOX 结构中的属性标记，该属性的值将显示为检查框的初始值。
复选框控件可修改。 这允许用户更改其状态。 可修改检查框在其 DTCTL 结构的 ulCtlFlags 成员及其PR_CONTROL_FLAGS (PidTagControlFlags) 属性中设置DT_EDITABLE标志。 当检查框更改其状态时，MAPI 会调用 IMAPIProp：：SetProps，将 DTBLCHECKBOX 结构的属性标记成员中标识的属性设置为新状态。
例如，通讯簿提供程序可以在其配置对话框中包括可修改检查框控件，以调整收件人PR_SEND_RICH_INFO (PidTagSendRichInfo) 属性的设置。 当用户选择“检查”框时，MAPI 会将此属性设置为 TRUE。 取消选中检查框时，属性设置为 FALSE。
有关显示表的概述，请参阅 显示表。 有关如何实现显示表的信息，请参阅 实现显示表。 有关属性类型的信息，请参阅 MAPI 属性类型概述。