共用方式為


文件主機項目

Document主機項目是一種類型,從 Word 的主要互通組件擴展Document類型。 Document主機項目提供與物件相同的Document所有屬性、方法和事件,但它也會公開其他事件,並做為主控項和 Windows Forms 控制項的容器。

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

在文件層級專案中,有一個預設 Document 主項目代表專案中的文件。 在 VSTO 增益集專案中,您可以在執行階段產生 Document 主機項目。

瞭解文件層級專案中的文件主機元素

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

ThisDocument 類提供了一個位置,您可以在其中開始在項目中編寫代碼。 因為類別提供與 Word 主要互通元件中物件相同的 Document 所有屬性、方法和事件,所以您也可以用來 ThisDocument 存取 Word 的物件模型。 如需詳細資訊,請參閱 Word 物件模型概觀

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

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

如果您在執行階段建立新的 Word 文檔,它將屬於 Document類型。 因為它不是主機項目,所以它不能包含任何主機控制項或 Windows Forms 控制項。 如需在執行階段建立文件的詳細資訊,請參閱 如何:以程式設計方式建立新文件

瞭解應用程式層級專案中的文件主機項目

在 VSTO 增益集專案中,您可以在執行階段為 Word 中開啟的任何文件產生 Document 主機項目。 您可以使用 Document 主機項目將控制項新增至關聯的文件,或處理物件上 Document 無法使用的事件。

若要產生 Document 主機項目,請使用方法 GetVstoObject 。 如需詳細資訊,請參閱 在執行時間於 VSTO 外掛程式中擴充 Word 文件和 Excel 活頁簿