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

  • 發行項

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

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

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

  • 建立 Word 文件專案。

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

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

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

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

注意事項注意事項

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

必要條件

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

-

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

建立專案

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

  1. 啟動 Visual Studio。

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

  3. 在範本窗格中，展開 Visual C# 或 [ Visual Basic]，然後展開 [Office SharePoint/]。

  4. 在展開的 Office SharePoint/ 節點下，選取 [Office 增益集] 節點。

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

  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 方案中的程式碼。

測試專案

若要測試您的文件

  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 自訂。

  • 使用擴充 Word 物件由 Visual Studio 中的 Office 方案提供執行例如不可能使用 Word 物件模型的工作 (例如，在文件裝載 Managed 控制項和繫結 Word 控制對資料使用 Windows Form 資料繫結模型): 使用擴充物件自動化 Word。

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

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

請參閱

概念

Office 方案開發概觀

使用擴充物件自動化 Word

其他資源

Word 方案

文件層級自訂程式設計

Word 物件模型概觀

Office UI 自訂

建置 Office 方案

部署 Office 方案

Office 專案範本概觀