Document 主項目

Document 主項目是型別,會從 Word 的主要 Interop 組件擴充 Microsoft.Office.Interop.Word.Document 型別。 Document 主項目會提供與 Microsoft.Office.Interop.Word.Document 物件相同的所有屬性、方法和事件,但是也會公開其他事件並且做為主控制項和 Windows Form 控制項的容器使用。

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

文件層級專案中有代表專案中文件的預設 Document 主項目。 在應用程式層級專案中,您可以在執行階段產生 Document 主項目。

了解文件層級專案中的 Document 主項目

若要存取專案中的文件,請使用 ThisDocument 類別。 當您建立文件層級專案時,Visual Studio 會產生 ThisDocument 類別,做為 Word 和自訂程式碼之間的通訊連結。 ThisDocument 類別可讓您存取 Document 主項目的成員以在自訂中執行基本工作,例如在開啟或關閉文件時執行程式碼。 您也可以使用這個類別將控制項和智慧標籤加入至文件。 藉由合併不同組的控制項並撰寫程式碼,您可以將控制項繫結至資料、從使用者收集資訊,以及回應使用者動作。 如需詳細資訊,請參閱文件層級自訂程式設計

注意事項注意事項

智慧標籤在 Excel 2010 和 Word 2010 中已被取代。 如需詳細資訊,請參閱智慧標籤概觀

ThisDocument 提供一個位置,供您開始在專案中撰寫程式碼。 由於這個類別與 Word 主要 Interop 組件中的 Microsoft.Office.Interop.Word.Document 物件提供相同的屬性、方法和事件,因此您也可以使用 ThisDocument 存取 Word 的物件模型。 如需詳細資訊,請參閱 Word 物件模型概觀

文件層級專案中 Document 主項目的限制

文件層級專案只能包含一個 Document 主項目 (也就是 ThisDocument 類別)。 您無法在設計階段將新的 Document 主項目加入至專案,也無法在執行階段從文件層級自訂建立新的 Document 主項目。

如果您在執行階段建立新的 Word 文件,這個文件的型別將為 Microsoft.Office.Interop.Word.Document。 因為這不是主項目,所以無法包含任何主控制項或是 Windows Form 控制項。 如需在執行階段建立文件的詳細資訊,請參閱 HOW TO:建立新文件

了解應用程式層級專案中的 Document 主項目

在應用程式層級專案中,您可以在執行階段為 Word 中任何開啟的文件產生 Document 主項目。 您可以使用 Document 主項目將控制項和智慧標籤加入至相關聯的文件,或是處理無法在 Microsoft.Office.Interop.Word.Document 物件上使用的事件。

若要產生 Document 主項目,請使用 GetVstoObject 方法。 如需詳細資訊,請參閱在應用程式層級增益集的執行階段中擴充 Word 文件和 Excel 活頁簿

請參閱

概念

主項目和主控制項概觀

使用擴充物件自動化 Word

主項目和主控制項的程式設計限制

在應用程式層級增益集的執行階段中擴充 Word 文件和 Excel 活頁簿

其他資源

Word 物件模型概觀