建立 Outlook 表單區域

您可以使用表單區域自訂 Microsoft Office Outlook 表單。 Visual Studio 提供進階的工具,可讓您更方便地設計、開發和偵錯表單區域。

適用于: 本主題中的資訊適用于 Outlook 的 VSTO 新增 - 專案。 如需詳細資訊,請參閱 依 Office 應用程式和專案類型提供的功能

此主題提供下列資訊:

使用表單區域的優點

表單區域提供許多超越傳統 Outlook 表單開發的增強功能:

  • 自訂任何標準表單的預設頁面。

  • 在任何標準表單中加入額外的頁面,最多 12 頁。

  • 置換或增強任何標準表單。

  • 在 [讀取窗格] 和 [檢查] 中顯示自訂 UI。

    如需詳細資訊,請參閱 自訂表單頁面和表單區域

將 Outlook 表單區域新增至您的專案

您可以使用 [新增 Outlook 表單區域] wizard 來設計新的表單區域,或匯入 Outlook 所設計的表單區域。 此外,如果您在另一個 Outlook VSTO 增益集專案中使用表單區域,則可重複使用現有的表單區域。

使用 wizard 建立新的表單區域

若要建立表單區域,請將 Outlook 表單區域 專案加入至 Outlook VSTO 增益集專案。 這會啟動 新的 Outlook 表單區域 wizard。

使用此精靈指出您要設計新的表單區域,或匯入已在 Outlook 中設計的表單區域。 如需設計新表單區域的詳細資訊,請參閱 使用表單區域設計工具。 如需使用 Outlook 中所設計之表單區域的詳細資訊,請參閱匯入以 Outlook 設計的表單區域

使用此精靈指定要建立的表單區域類型。 下表將描述每一個表單區域類型。

區域類型 描述
獨立 加入表單區域,做為 Outlook 表單中的新頁面。
相鄰 附加表單區域至 Outlook 表單預設頁面的下方。
取代 加入表單區域,做為取代 Outlook 表單預設頁面的新頁面。
全部取代 以表單區域取代整個 Outlook 表單。

您也可以使用此精靈指定顯示條件以及選取要擴充的表單類型。 如需詳細資訊,請參閱如何:在 Outlook 的增益集專案中加入表單區域

您在精靈中所做的選擇會影響其他精靈頁面中提供的選項。 例如,如果您在 [建立新的 Outlook 表單區域] 頁面中選取 [相鄰] 或 [獨立],則 [提供描述文字] 和 [顯示喜好 設定] 頁面中的 [標題] 和 [描述] 欄位無法使用。 這是因為 Outlook 顯示相鄰或獨立表單區域時不會使用這些欄位。

表單區域檔案

當您完成 新的 Outlook 表單區域 wizard 時,Visual Studio 會自動將下列檔案新增至您的專案:

  • 表單區域程式碼檔案。 這個檔案具有您在 [加入新專案] 對話方塊中為 Outlook 表單區域 專案指定的名稱。 請將程式碼加入這個檔案以處理表單區域事件。

  • 表單區域設計工具程式碼檔案。 這個檔案包含表單區域設計工具所產生的程式碼,且不應直接編輯。

  • Outlook 格式儲存體 (.ofs) 檔。

    注意

    這個檔案只會在您匯入已在 Outlook 中設計的表單區域時加入專案。

表單區域 factory 類別

表單區域程式碼檔案包含一個部分類別,用來實作 IFormRegionFactory 介面。 也就是表單區域 Factory 類別。 表單區域 Factory 類別會負責建立表單區域的新執行個體。

您可以藉由展開 表單區域 Factory 區域來尋找此類別。

新的 Outlook 表單區域 wizard 會將屬性新增至這個類別,以指定表單區域的內部名稱,以及顯示表單區域的訊息類別。 您可以在將檔案加入專案之後,手動修改這些屬性。

大部分表單區域 Factory 類別是在表單區域設計工具檔案中實作。 不過,FormRegionInitializing 事件處理常式會在表單區域程式碼檔案中公開。 您可以使用這個事件處理常式指定 Outlook 是否應顯示表單區域。 如需詳細資訊,請參閱 處理表單區域事件

將現有的表單區域新增至您的專案

如果在其他 Outlook 專案中有您使用的 Outlook 表單區域,則可使用 [加入現有項目] 對話方塊在目前的 Outlook VSTO 增益集專案中重複使用該表單區域。

現有的表單區域必須有程式碼檔 (.vb.cs) ;您無法使用 [加入現有專案] 對話方塊,將 Outlook 表單新增儲存體 (.ofs) 檔。 不過,您可以藉由匯入 Outlook 表單儲存區檔案建立新的表單區域。 如需詳細資訊,請參閱如何:在 Outlook 的增益集專案中加入表單區域

使用表單區域設計工具

[表單區域設計工具] 可協助您設計表單區域的配置和外觀。 您可以將 managed 控制項拖曳至設計工具的介面,按兩下控制項開啟事件處理常式,並在 [ 屬性 ] 視窗中設定屬性。

注意

您可以在 [屬性] 視窗的 [資訊清單] 節點底下,找到會影響表單區域出現 Outlook 方式的屬性。

只有當您在 [新增 Outlook 表單區域] wizard 的 [選取您要如何建立表單區域] 頁面中選取 [設計新的表單區域] 時,才能使用 [表單區域設計工具]。

開啟 [表單區域設計工具] 的方式有三種:

  • 方案總管 中,按兩下表單區域程式碼檔案。

  • 方案總管 中,以滑鼠右鍵按一下表單區域程式碼檔案,然後按一下 [ 視圖設計 工具]。

  • 方案總管 中,選取表單區域程式碼檔案,然後在 [ View ] 功能表上,按一下 [ 設計 工具]。

    [表單區域設計工具] 只支援 Managed 控制項。 因此您無法加入原生 Outlook 控制項。

匯入 Outlook 中設計的表單區域

當您在 Outlook 中設計時,可將原生 Outlook 控制項加入表單區域。 原生 Outlook 控制項可讓您在設計階段時繫結至 Outlook 資料。 不過,之後您就無法使用 [表單區域設計工具] 加入 Managed 控制項,或是變更表單區域的設計。

您可以使用 新的 Outlook 表單區域 wizard,將表單區域匯入 Outlook 的 VSTO 增益集專案。 在 [選取您要如何建立表單區域] 頁面上,選取 [匯 入 Outlook 表單] 儲存體 ( .ofs) 檔。 然後,您可以流覽至 Outlook 格式儲存體檔案 (.ofs) 檔的位置。 (Outlook 會將表單區域儲存為 .ofs 檔案。 )

新的 Outlook 表單區域 wizard 會將 .ofs 檔案複製到專案目錄,並將控制項參考加入表單區域設計工具檔案中。 然後您就可以在表單區域程式碼檔案中處理控制項事件。

若要在 Visual Basic 專案中處理事件,請從 [程式碼編輯器] 頂端的方法名稱清單選取事件。

若要在 C# 專案中處理事件,請在 FormRegionShowing 方法中訂閱控制項事件。 如需詳細資訊,請參閱 如何:訂閱和取消訂閱事件 (C# 程式設計指南)

您可以在表單區域 Factory 類別的 InitializeManifest 方法中變更表單區域屬性。

注意

若要匯入表單區域,您必須在目標 Outlook 版本與開發電腦上所安裝版本相同的專案中進行。 例如,如果您已安裝 Outlook 2010,匯入表單區域只會在使用 [ Outlook 2010 增益集] 專案範本建立的專案中運作。

更新匯入的表單區域設計

您可以加入、移除或變更表單區域上的控制項。 在執行這些動作前,請先備份您加入表單區域程式碼檔案的任何程式碼。 然後,在 Outlook 中開啟 .ofs 檔案,修改表單區域,然後儲存變更。 使用 新的 Outlook 表單區域 wizard 匯入已修改的 .ofs 檔案。 然後您可以將程式碼貼入新的表單區域程式碼檔案。

將自訂程式碼新增至表單區域

Microsoft.Office.Tools.Outlook 命名空間可讓您存取代表表單區域的類別、顯示表單區域的 Outlook 項目,以及其他實用的項目。 Outlook 表單區域 專案會自動將參考加入至專案中的這個元件,並在表單區域程式碼檔案的頂端插入適當的 usingImports 語句。

您可以使用 Microsoft.Office.Interop.Outlook 命名空間中的類別、方法和屬性來完成大部分 Outlook 程式設計工作。 如需 Outlook 物件模型的詳細資訊,請參閱Outlook 物件模型總覽。 如需使用 Outlook 物件模型的一般工作範例,請參閱Outlook 方案

處理表單區域事件

Outlook 表單區域 專案會自動將下列三個事件處理常式加入表單區域程式碼檔案中。

事件 描述
FormRegionInitializing 在表單區域初始化之前發生。 您可以檢查這個事件處理常式中的條件,以決定 Outlook 是否應顯示表單區域。 如需詳細資訊,請參閱如何:防止 Outlook 顯示表單區域
FormRegionShowing 發生於建立表單區域的執行個體之後,但在表單區域顯示之前。
FormRegionClosed 發生於關閉表單區域之前。

建立專案

當您建置包含表單區域的 Outlook VSTO 增益集專案時,Visual Studio 會在登錄中加入以下資訊:

  • 與一個或多個表單區域關聯之每個訊息類別的索引鍵。

  • 每個表單區域的項目,以及代表 Outlook VSTO 增益集名稱的關聯值。

    Outlook 會使用這項資訊來載入表單區域。

調試表單區域

您可以對包含表單區域的 Outlook VSTO 增益集進行偵錯,就如同您對其他 Visual Studio 專案進行偵錯一般。 當您啟動 Visual Studio 偵錯工具時,Visual Studio 會自動啟動 Outlook。

若要檢視表單區域,您必須開啟適當的 Outlook 項目。 例如,如果郵件項目底部附加了相鄰表單區域,則開啟郵件項目。

部署表單區域

表單區域會自動隨相關聯的 Outlook VSTO 增益集部署。 因此,您不需要執行任何特殊工作來部署表單區域。 如需部署 VSTO 增益集的詳細資訊,請參閱部署 Office 方案

標題 描述
建立 Outlook 表單區域的指導方針 提供資訊來協助您最佳化表單區域及避免發生可能的問題。
如何:在 Outlook 的增益集專案中加入表單區域 示範如何使用 新的 Outlook 表單區域 wizard,建立表單區域以延伸標準或自訂 Microsoft Office Outlook 表單。
建立表單區域與 Outlook message 類別的關聯 說明如何藉由將表單區域和每個 Microsoft Office Outlook 項目的訊息類別產生關聯,指定要顯示表單區域的 Microsoft Office Outlook 項目。
逐步解說:設計 Outlook 表單區域 示範如何設計自訂表單區域,該表單區域會在連絡人項目的 [檢查] 視窗中顯示為新頁面。
逐步解說:匯入在 Outlook 中設計的表單區域 示範如何在 Microsoft Office Outlook 中設計表單區域,然後使用 新的 Outlook 表單區域 wizard 將表單區域匯入 Outlook VSTO 增益集專案。
在執行時間存取表單區域 描述如何撰寫程式碼以顯示、隱藏或修改表單區域上的控制項,以及如何使用 Globals 類別讓使用者從您專案的其他區域執行程式碼。
如何:防止 Outlook 顯示表單區域 示範如何防止 Microsoft Office Outlook 針對特定項目顯示表單區域。
示範如何存取顯示表單區域的 Outlook 項目。
Outlook 表單區域中的自訂動作 描述如何讓使用者回應 Outlook 項目。