逐步解說:建立 Word 的第一個文件層級自訂
更新: 2008 年 7 月
適用於 |
---|
本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。 專案類型
Microsoft Office 版本
如需詳細資訊,請參閱依應用程式和專案類型提供的功能。 |
本入門逐步解說將示範如何建立 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 文件專案
啟動 Visual Studio。
在 [檔案] 功能表上,指向 [新增],然後按一下 [專案]。
在 [專案類型] 窗格中,展開 [Visual C#] 或 [Visual Basic],然後再展開 [Office]。
如果您要開發 Word 2007 自訂,請選取 [2007] 資料夾,如果要開發 Word 2003 自訂,則請選取 [2003] 資料夾。
注意事項: 如果您要開發特定 Word 版本的文件層級自訂,開發電腦上必須安裝該版本。
在 [範本] 窗格中,選取 [Word 2003 文件] 或 [Word 2007 文件]。
在 [名稱] 方塊中,輸入 FirstDocumentCustomization。
按一下 [確定]。
[Visual Studio Tools for Office 專案精靈] 便會開啟。
選取 [建立新文件],然後按一下 [確定]。
Visual Studio 就會建立 FirstDocumentCustomization 專案,並將 FirstDocumentCustomization 文件和 ThisDocument 程式碼檔加入至專案。FirstDocumentCustomization 文件會在設計工具中自動開啟。
在設計工具中關閉並重新開啟文件
如果您在開發專案時有意或無意地關閉設計工具中的文件,都可以將它重新開啟。
若要在設計工具中關閉並重新開啟文件
按一下設計工具視窗的 [關閉] 按鈕 (X),關閉文件。
在 [方案總管] 中,以滑鼠右鍵按一下 [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 專案事件。
若要使用程式碼將第二段文字加入至文件
以滑鼠右鍵按一下 [方案總管] 中的 [ThisDocument],然後按一下 [檢視程式碼]。
程式碼檔隨即在 Visual Studio 中開啟。
以下列程式碼取代 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# 進行程式設計的比較。
測試專案
若要測試您的文件
按 F5 建置及執行專案。
當您建置專案時,程式碼會編譯為與文件關聯的組件。Visual Studio 會將文件複本和組件置於專案的建置輸出資料夾中,而且會設定開發電腦中的安全性設定以執行自訂。如需詳細資訊,請參閱 Office 方案建置程序概觀。
確認文件中出現下列文字:
This text was added by using the designer.
This text was added by using code.
關閉文件。
清除專案
當您完成專案開發時,必須移除建置輸出資料夾中的檔案和建置程序建立的安全性設定。
若要清除開發電腦上已完成的專案
- 在 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 方案。
請參閱
概念
Visual Studio Tools for Office 專案範本概觀
參考
其他資源
變更記錄
日期 |
記錄 |
原因 |
---|---|---|
2008 年 7 月 |
加入主題。 |
資訊加強。 |