逐步解說：建立 Word 的第一個文件層級自訂

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

**適用於：**本主題中的資訊適用於 Word 2007 和 Word 2010 的文件層級專案。如需詳細資訊，請參閱依 Office 應用程式和專案類型提供的功能。

這個逐步解說將說明下列工作：

• 建立 Word 文件專案。

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

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

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

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

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

必要條件

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

-

包含 Microsoft Office 開發者工具的 Visual Studio 2010 版本。 如需詳細資訊，請參閱[設定電腦以開發 Office 方案](bb398242\(v=vs.100\).md)。

• Word 2007 或 Word 2010。

建立專案

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

1. 啟動 Visual Studio。

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

3. 在範本窗格中，展開 [Visual C#] 或 [Visual Basic]，接著展開 [Office]。

4. 在展開的 [Office] 節點底下，選取 [2007] (如果您已安裝 Word 2007) 或選取 [2010] 節點 (如果您已安裝 Word 2010)。

5. 在專案範本的清單中，選取 [Word 2007 文件] 或 [Word 2010 文件]。

6. 在 [名稱] 方塊中，輸入 FirstDocumentCustomization。

7. 按一下 [確定]。

   [Visual Studio Tools for Office 專案精靈] 便會開啟。

8. 選取 [建立新文件]，然後按一下 [確定]。

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

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

如果您在開發專案時有意或無意地關閉設計工具中的文件，都可以將它重新開啟。

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

1. 按一下設計工具視窗的 [關閉] 按鈕 (X)，關閉文件。

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

   -或-

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

在設計工具中將文字加入至文件

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

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

• 在設計工具中開啟的文件內輸入下列文字：

  This text was added by using the designer.

以程式設計的方式將文字加入至文件

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

• ThisDocument 類別的部分定義，表示文件的程式撰寫模型並提供 Word 物件模型的存取。 如需詳細資訊，請參閱 Document 主項目和Word 物件模型概觀。 ThisDocument 類別的其餘部分則定義於您不應修改的隱藏程式碼檔中。

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

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

1. 以滑鼠右鍵按一下 [方案總管] 中的 [ThisDocument]，然後按一下 [檢視程式碼]。

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

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

   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
   

   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.";
   }
   

   注意事項
   此程式碼會使用索引值 1 來存取 Paragraphs 屬性中的第一個段落。 雖然 Visual Basic 和 Visual C# 都是使用以 0 為基底的陣列，但是在 Word 物件模型中，大多數集合的陣列下限都是 1。 如需詳細資訊，請參閱 在 Office 方案中使用 Visual Basic 或 Visual C# 進行程式設計。

測試專案

若要測試您的文件

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

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

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

   This text was added by using the designer.

   This text was added by using code.

3. 關閉文件。

清除專案

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

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

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

後續步驟

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

• 您可以在文件層級自訂中執行的一般程式設計工作：文件層級自訂程式設計。

• Word 文件層級自訂的特定程式設計工作：Word 方案。

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

• 自訂 Word 的 UI，例如，透過將自訂索引標籤加入至功能區，或建立您專屬執行窗格的方式：Office UI 自訂。

• 使用 Visual Studio Tools for Office 提供的擴充 Word 物件，執行無法透過 Word 物件模型完成的工作 (例如，在文件裝載 Managed 控制項，以及使用 Windows Form 資料繫結模型將 Word 控制項繫結至資料)：使用擴充物件自動化 Word。

• 建置及偵錯 Word 文件層級自訂：建置和偵錯 Office 方案。

• 部署 Word 文件層級自訂：部署 Office 方案。

請參閱

概念

Office 方案開發概觀

使用擴充物件自動化 Word

其他資源

Word 方案

文件層級自訂程式設計

Word 物件模型概觀

Office UI 自訂

建置和偵錯 Office 方案

部署 Office 方案

Office 專案範本概觀