DTBLLBX

适用于:Outlook 2013 | Outlook 2016

描述将在从显示表生成的对话框中使用的列表。

属性
标头文件:
Mapidefs.h
typedef struct _DTBLLBX
{
  ULONG ulFlags;
  ULONG ulPRSetProperty;
  ULONG ulPRTableName;
} DTBLLBX, FAR *LPDTBLLBX

Members

ulFlags

用于从列表中消除水平或垂直滚动条的标志的位掩码。 可以设置以下标志:

MAPI_NO_HBAR

列表不应显示水平滚动条。

MAPI_NO_VBAR

列表不应显示垂直滚动条。

ulPRSetProperty

任何类型的属性的属性标记。 此属性是由 ulPRTableTable 成员标识的表中的列之一。

ulPRTableName

PT_OBJECT类型的表属性的属性标记,可以使用 OpenProperty 调用打开。 表应具有的列数取决于列表是单选列表还是多个选择列表。 如果将 ulPRSetProperty 成员设置为 PR_NULL (PidTagNull) ,则列表允许进行多重选择。

备注

DTBLLBX 结构描述用于显示多个项并允许用户选择一个或多个项的控件的列表。

ulPRSetProperty 成员和 ulPRTableName 成员协同工作;当从表中选择一个值时,当对话框被关闭时,该值将写回到 ulPRSetProperty

标志值指示应随列表一起显示水平滚动条还是垂直滚动条。 默认值是在需要时显示滚动条类型。 服务提供商可以设置MAPI_NO_HBAR来取消水平滚动条,MAPI_NO_VBAR来取消垂直滚动条。

这两个属性标记成员协同工作,以在列表中选择某个项时显示列表中的值并设置相应的属性。 当 MAPI 首次显示列表时,它会调用 IMAPIProp 实现的 OpenProperty 方法,以检索 ulPRTableName 成员中标识的表。 表中的列数取决于 ulPRSetProperty 成员的值。 如果将 ulPRSetProperty 设置为 PR_NULL,则列表是基于包含收件人的对象(例如通讯簿容器、邮件的收件人表或通讯组列表内容表)的多重选择列表。

多选列表的表必须包含以下列:

PR_DISPLAY_NAME (PidTagDisplayName)

PR_ENTRYID (PidTagEntryId)

PR_INSTANCE_KEY (PidTagInstanceKey)

PR_DISPLAY_TYPE (PidTagDisplayType) ,最多还可以显示五个其他多值字符串属性以及三个必需列。

如果 ulPRSetProperty 成员未设置为 PR_NULL,则列表是单个选择列表。 ulPRSetProperty 的初始值确定第一个选定行。 当用户选择其中一行时, ulPRSetProperty 成员将设置为所选值,并且此值通过调用 IMAPIProp::SetProps 写回到属性接口实现中。

有关显示表的概述,请参阅 显示表。 有关如何实现显示表的信息,请参阅 实现显示表

另请参阅

DTCTL

MAPI 结构