文件主項目

  • 發行項

Document 主項目是一種類型，其會從 Word 的主要 Interop 組件擴充 Document 類型。 Document 主項目除了提供與 Document 物件相同的所有屬性、方法和事件之外，也會公開其他事件，並做為主控制項和 Windows Forms 控制項的容器。

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

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

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

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

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

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

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

如果您在執行階段建立新的 Word 文件，這個文件的類型將為 Document。 由於這不是主項目，因此無法包含任何主控制項或 Windows Forms 控制項。 如需在執行階段建立文件的詳細資訊，請參閱如何：以程式設計方式建立新文件。

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

在 VSTO 增益集專案中，您可以在執行階段為使用 Word 開啟的任何文件產生 Document 主項目。 您可以使用 Document 主項目將控制項加入相關聯的文件，或處理 Document 物件上沒有的事件。

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

相關內容