逐步解說：建立 Word 的第一個檔層級自定義

本入門逐步解說將示範如何建立 Microsoft Office Word 的文件層級自訂。 只有在特定的文件開啟時，才能使用您在這種解決方案中建立的功能。 您不能使用文件層級自訂來進行應用程式層級的變更，例如在任何文件開啟時顯示新功能區索引標籤。

適用於： 本主題中的資訊適用於 Word 的檔案層級專案。 如需詳細資訊，請參閱 Office 應用程式 lication 和項目類型所提供的功能。

本逐步解說將說明下列工作：

• 建立 Word 文件專案。

• 將文字加入 Visual Studio 設計工具裝載的文件。

• 撰寫可使用 Word 物件模型的程式碼，該程式碼會在自訂文件開啟時將文字加入此文件。

• 建置和執行專案來進行測試。

• 清除專案，將不需要的組建檔案和安全性設定從開發電腦上移除。

  注意

  在下列指示的某些 Visual Studio 使用者介面項目中，您的電腦可能會顯示不同的名稱或位置： 您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。 如需詳細資訊，請參閱將 IDE 個人化。

必要條件

您需要下列元件才能完成這個逐步解說：

• 此版 Visual Studio 包含 Microsoft Office Developer Tools。 如需詳細資訊，請參閱 設定計算機來開發 Office 解決方案。

• Microsoft Word

建立專案

在 Visual Studio 中建立新的 Word 文件專案

1. 啟動 Visual Studio。

2. 在 [檔案] 功能表上，指向 [開新檔案] ，然後按一下 [專案] 。

3. 在 [ 建立新專案 ] 對話框中，選取 Word VSTO 文件 專案。

   注意

   您也可以在 [建立新專案] 對話框頂端的 [搜尋] 文本框中輸入 Office 產品名稱來搜尋範本。 例如，輸入 Excel 會顯示 Excel 的所有項目範本。 您也可以選取 [項目類型] 下拉式方塊中的 [Office]，篩選範本清單，只顯示 Office 的範本。 如需詳細資訊，請參閱 在Visual Studio中建立新專案。

4. 按一下 [下一步] 。

5. 在 [設定新專案] 對話框的 [名稱] 方塊中輸入 FirstWorkbookCustomization，然後按兩下 [建立]。

6. 從 Visual Studio Tools for Office 專案精靈中選取 [建立新檔]，然後按兩下 [確定]。

   • Visual Studio 會建立 FirstDocumentCustomization 專案，並將 FirstDocumentCustomization 檔和 ThisDocument 程式代碼檔案新增至專案。 FirstDocumentCustomization 文件會自動在設計工具中開啟。

在設計工具中關閉並重新開啟檔

如果您在開發專案時故意或不小心關閉了設計工具中的文件，您都可以重新開啟它。

在設計工具中關閉並重新開啟文件

1. 按兩下設計工具視窗的 [關閉] 按鈕 （X），以關閉 檔案。

2. 在 方案總管 中，以滑鼠右鍵按兩下 ThisDocument 程式代碼檔案，然後按兩下 [檢視設計工具]。

   - 或 -

   在 方案總管 中，按兩下ThisDocument程式碼檔案。

將文字新增至設計工具中的檔

您可以修改設計工具中開啟的文件，藉此設計自訂的使用者介面 (UI)。 例如，您可以加入文字、表格或 Word 控制項。 如需如何使用設計工具的詳細資訊，請參閱 Visual Studio環境中的 Office 專案。

使用設計工具將文字加入文件

1. 在設計工具開啟的文件中，輸入下列文字。

   此文字是使用設計工具新增的。

以程序設計方式將文字新增至檔

接著，將程式碼加入 ThisDocument 程式碼檔。 新程式碼會使用 Word 物件模型，將第二段的文字加入文件。 ThisDocument 程式碼檔預設包含下列產生的程式碼：

• ThisDocument 類別的部分定義，此定義代表該文件的程式設計模型，而且會提供 Word 物件模型的存取。 如需詳細資訊，請參閱 檔主專案 和 Word 物件模型概觀。 ThisDocument 類別的其餘部分則定義於您不應修改的隱藏程式碼檔中。

• ThisDocument_Startup 和 ThisDocument_Shutdown 事件處理常式。 開啟和關閉文件時會呼叫這些事件處理常式。 請使用這些事件處理常式，在文件開啟時初始化自訂，以及在文件關閉時清除自訂所用的資源。 如需詳細資訊，請參閱 Office 專案中的事件。

使用程式碼將第二段文字加入文件

1. 在 [方案總管] 中，以滑鼠右鍵按兩下 [ThisDocument]，然後按兩下 [檢視程序代碼]。

   程式碼檔案隨即在 Visual Studio 中開啟。

2. 以下列程式碼取代 ThisDocument_Startup 事件處理常式。 開啟文件時，這段程式碼會將第二段文字加入文件。

   C#

   private void ThisDocument_Startup(object sender, System.EventArgs e)
   {
       this.Paragraphs[1].Range.InsertParagraphAfter();
       this.Paragraphs[2].Range.Text = "This text was added by using code.";
   }
   

   VB

   Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
       Me.Paragraphs(1).Range.InsertParagraphAfter()
       Me.Paragraphs(2).Range.Text = "This text was added by using code."
   End Sub
   

   注意

   這個程式碼會使用索引值 1 存取 Paragraphs 屬性的第一個段落。 雖然 Visual Basic 和 Visual C# 都是使用以 0 為起始的陣列，但是在 Word 物件模型中，大多數集合的陣列界限下限都是 1。 如需詳細資訊，請參閱 在 Office 方案中撰寫程式代碼。

測試專案

測試文件

1. 按 F5 建置及執行專案。

   當您建置專案時，程式碼會編譯為與文件相關聯的組件。 Visual Studio 會將文件複本和組件置於專案的建置輸出資料夾中，而且會設定開發電腦中的安全性設定以執行自訂。 如需詳細資訊，請參閱 建置 Office 解決方案。

2. 確認文件中出現下列文字。

   此文字是使用設計工具新增的。

   This text was added by using code.

3. 關閉文件。

清除專案

當您完成專案開發時，必須移除建置輸出資料夾中的檔案和建置程序建立的安全性設定。

清除開發電腦上已完成的專案

1. 在 Visual Studio 中，按一下 [建置] 功能表上的 [清除方案] 。

下一步

現在您已經建立 Word 的基本文件層級自訂，可以從下列主題進一步了解如何開發自訂：

• 您可以在檔案層級自定義中執行的一般程式設計工作： 程式檔層級自定義。

• Word 檔層級自定義專屬的程序設計工作： Word 解決方案。

• 使用 Word 的物件模型： Word 物件模型概觀。

• 例如，藉由將自定義索引標籤新增至功能區或建立您自己的動作窗格，來自定義 Word 的 UI： Office UI 自定義。

• 使用 Visual Studio 中 Office 解決方案提供的擴充 Word 物件來執行無法使用 Word 物件模型的工作（例如，在檔和使用 Windows Forms 數據系結模型將 Word 控件系結至數據上裝載 Managed 控件）： 使用擴充物件將 Word 自動化。

• 建置和偵錯 Word 的檔層級自定義： 建置 Office 解決方案。

• 部署 Word 的文件層級自定義： 部署 Office 解決方案。

相關內容

• Office 解決方案開發概觀 （VSTO）
• Word 解決方案
• 程式檔層級自定義
• Word 物件模型概觀
• 使用擴充物件將 Word 自動化
• Office UI 自定義
• 建置 Office 解決方案
• 部署 Office 解決方案
• Office 項目範本概觀