共用方式為


DTBLLBX

適用於:Outlook 2013 |Outlook 2016

描述將用於從顯示資料表建置之對話框中的清單。

屬性
標頭檔:
Mapidefs.h
typedef struct _DTBLLBX
{
  ULONG ulFlags;
  ULONG ulPRSetProperty;
  ULONG ulPRTableName;
} DTBLLBX, FAR *LPDTBLLBX

成員

ulFlags

旗標的位掩碼,用來排除清單中的水準或垂直滾動條。 您可以設定下列旗標:

MAPI_NO_HBAR

清單中不應該顯示任何水準滾動條。

MAPI_NO_VBAR

清單中不應該顯示任何垂直滾動條。

ulPRSetProperty

任何類型之屬性的屬性標記。 這個屬性是 ulPRTableTable 成員所識別之數據表中的其中一個數據行。

ulPRTableName

可使用 OpenProperty 呼叫開啟之類型PT_OBJECT之數據表屬性的屬性標記。 數據表應該擁有的數據行數目取決於清單是單一或多個選取清單。 如果 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 結構