DTBLCHECKBOX
適用於：Outlook 2013 |Outlook 2016
包含複選框的相關信息，該複選框將用於從顯示數據表建置的對話框中。
| 屬性 | 值 |
|---|---|
| 標頭檔： |
Mapidefs.h |
| 相關宏： |
SizedDtblCheckBox |
typedef struct _DTBLCHECKBOX
{
ULONG ulbLpszLabel;
ULONG ulFlags;
ULONG ulPRPropertyName;
} DTBLCHECKBOX, FAR *LPDTBLCHECKBOX;
成員
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 屬性類型概觀。