共用方式為

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

  • 發行項

更新： 2008 年 7 月

適用於

本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。

專案類型

  • 文件層級專案

Microsoft Office 版本

  • Word 2007

  • Word 2003

如需詳細資訊，請參閱依應用程式和專案類型提供的功能。

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

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

  • 建立適用於 Word 2003 或 Word 2007 的 Word 文件專案。

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

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

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

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

注意事項：

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

必要條件

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

  • Visual Studio Tools for Office (Visual Studio 2008 Professional 和 Visual Studio Team System 的選擇性元件)。

  • Word 2003 或 Word 2007。

根據預設，Visual Studio Tools for Office 會與列出的 Visual Studio 版本一起安裝。若要檢查電腦上是否已安裝此元件，請參閱安裝 Visual Studio Tools for Office。

建立專案

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

  1. 啟動 Visual Studio。

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

  3. 在 [專案類型] 窗格中，展開 [Visual C#] 或 [Visual Basic]，然後再展開 [Office]。

  4. 如果您要開發 Word 2007 自訂，請選取 [2007] 資料夾，如果要開發 Word 2003 自訂，則請選取 [2003] 資料夾。

    注意事項：

    如果您要開發特定 Word 版本的文件層級自訂，開發電腦上必須安裝該版本。

  5. 在 [範本] 窗格中，選取 [Word 2003 文件] 或 [Word 2007 文件]。

  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 事件處理常式。在文件開啟和關閉時，都會呼叫這些事件處理常式。請使用這些事件處理常式，在文件開啟時初始化自訂，以及在文件關閉時清除自訂所用的資源。如需詳細資訊，請參閱 Visual Studio Tools for 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。如需詳細資訊，請參閱使用 Visual Basic 和 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 的基本文件層級自訂，可以從下列主題進一步了解如何開發自訂：

請參閱

概念

Office 方案開發概觀

Word 文件層級自訂開發

文件層級自訂程式設計

Word 物件模型概觀

使用擴充物件自動化 Word

Office UI 自訂

Visual Studio Tools for Office 專案範本概觀

參考

Word 文件專案範本

其他資源

建置和偵錯 Office 方案

部署 Office 方案

變更記錄

日期

記錄

原因

2008 年 7 月

加入主題。

資訊加強。