XMLNode 控制項

更新:2007 年 11 月

適用於

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

專案類型

  • 文件層級專案

Microsoft Office 版本

  • Word 2007

  • Word 2003

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

XMLNode 控制項是一個對應 XML 節點物件,會公開事件,且可以繫結至資料。只有當有不重複的結構描述項目對應至 Microsoft Office Word 文件時,才會建立 XMLNode 控制項。在 Visual Studio Tools for Office 建立 XML 節點之後,您可以直接對其進行程式設計,而不必周遊 Word 物件模型 (Object Model)。

只有移除 Word 中的項目對應,才能刪除 XMLNode 控制項。

將資料繫結至控制項

XMLNode 控制項支援簡單的資料繫結 (Data Binding)。XML 節點應該透過 DataBindings 屬性繫結至資料來源。如果繫結資料集中的資料受到更新,XMLNode 控制項就會反映這些變更。

格式

可套用至 Microsoft.Office.Interop.Word.XMLNode 物件的格式同樣可以套用至 Microsoft.Office.Tools.Word.XMLNode 控制項。這包括字型、底線樣式以及字元樣式。

事件

下列事件適用於 XMLNode 控制項:

比較事件

當使用者在特定 XMLNode 控制項內容中移動游標時,您可以擷取該事件。例如,您可能有名為 Customer 的 XMLNode 控制項,該控制項有名為 Company 的 XMLNode 子控制項,而 Company 有名為 CompanyName 和 CompanyRegion 的兩個 XMLNode 子控制項,如下所示:

<Customer>
    <Company>
        <CompanyName>
        <CompanyRegion>

如果每當游標移至 Company 節點內,您就要在執行窗格上顯示控制項,則游標是否放在 CompanyName 或 CompanyRegion 中都應該無關,因為這兩者都是在 Company 的內容中。此時,您可以在 Company 的 ContextEnter 事件中撰寫程式碼。

在大部分情況下,當游標進入 XMLNode 控制項時,會同時引發 SelectContextEnter 事件,下表顯示這些事件之間的差異。

選取事件

ContextEnter 事件

當游標放入 XMLNode 時發生。

當游標從節點內容以外的區域,放到 XMLNode 或其中一個子代節點時發生。也就是說,它只會在內容變更時引發。

例如,當您將游標從 Customer 外部移至 CompanyName 內時,會引發 Customer、Company 和 CompanyName 的 ContextEnter 事件。如果您接著將游標從 CompanyName 移到 CompanyRegion,則只會引發 CompanyRegion 的 ContextEnter 事件,因為游標還在 Company 和 Customer 的內容中。

ContextLeave 事件和 Deselect 事件之間也存在相同的差異。

請參閱

工作

HOW TO:將 XMLNode 控制項加入至 Word 文件

HOW TO:在 Visual Studio 內將結構描述對應至 Word 文件

逐步解說:根據使用者內容變更執行窗格

概念

主項目和主控制項概觀

XMLNodes 控制項

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

其他資源

Word 主控制項

Excel 主控制項