PidTagControlFlags Canonical 屬性
適用於：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
包含列為替代名稱的屬性定義。