Элемент управления XMLNodes

Обновлен: Ноябрь 2007

Применение
Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Тип проекта Проекты уровня документа Версия Microsoft Office Word 2007 Word 2003 Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

Элемент управления XMLNodes представляет собой коллекцию сопоставленных объектов-узлов XML с событиями. Элемент управления XMLNodes создается только при сопоставлении повторяющегося элемента схемы документу Microsoft Office Word. Если повторяющийся элемент содержит дочерние элементы, каждый из дочерних элементов также создается как элемент управления XMLNodes.

После создания Visual Studio Tools for Office коллекции узлов XML элемент управления можно программировать непосредственно, не обращаясь к объектной модели Word. Удалить элемент управления XMLNodes можно только путем удаления из документа сопоставления элементов.

Примечание.
При доступе к дочернему элементу элемента управления XMLNodes через свойство Item это свойство возвращает объект Microsoft.Office.Interop.Word.XMLNode, а не элемент управления Microsoft.Office.Tools.Word.XMLNode. Дополнительные сведения см. в разделе Программные ограничения ведущих элементов и элементов управления ведущего приложения.

Связывание данных с элементом управления

Элемент управления XMLNodes не поддерживает привязку данных. Причина заключается в том, что элемент управления XMLNodes не обладает возможностями привязки к сложным данным, а при простой привязке данных невозможно представить повторяющиеся данные.

Форматирование

К элементу управления XMLNodes можно применить любые параметры форматирования, применяемые к тексту документа.

События

Ниже перечислены события, доступные для элемента управления XMLNodes:

• AfterInsert

• BeforeDelete

• ContextEnter

• ContextLeave

• Deselect

• Disposed

• Select

• ValidationError

Сравнение событий

Перехватить событие можно в тот момент, когда пользователь перемещает курсор внутрь контекста конкретного элемента управления XMLNodes. Например, ниже приведена следующая ситуация: имеется элемент управления XMLNodes с именем Customer, у которого имеется дочерний элемент управления XMLNodes с именем Company, а элемент управления Company имеет два дочерних элемента управления XMLNodes с именами CompanyName и CompanyRegion.

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

Если необходимо отображать элемент управления в панели действий при каждом перемещении курсора в узел Company, не имеет значения, находится ли курсор в узле CompanyName или в узле CompanyRegion, поскольку оба они находятся в контексте узла Company. В этом случае код следует писать в обработчике событий ContextEnter элемента управления Company.

В большинстве случаев при перемещении курсора внутрь элемента управления XMLNodes возникает и событие Select, и событие ContextEnter. В приведенной ниже таблице показаны различия между этими двумя событиями.

Событие Select	Событие ContextEnter
Происходит при перемещении курсора внутрь одного из узлов коллекции XMLNodes.	Происходит при перемещении курсора внутрь одного из узлов или узлов-потомков коллекции XMLNodes из области за пределами контекста узла. Другими словами, это событие возникает только при изменении контекста и может возникать для нескольких вложенных элементов управления XMLNodes.

Например, при перемещении курсора извне элемента управления Customer внутрь элемента управления CompanyName события ContextEnter возникают для элементов управления Customer, Company и CompanyName. Если после этого переместить курсор из элемента управления CompanyName в элемент управления CompanyRegion, событие ContextEnter возникнет только для элемента управления CompanyRegion, поскольку для элементов управления Company и Customer контекст не изменится. В документе может быть несколько узлов Company. При перемещении курсора из узла CompanyName одного элемента управления Company в узел CompanyName другого элемента управления Company контекст не изменится, поэтому возникнет только событие Select.

Аналогичным образом отличаются события ContextLeave и Deselect.

См. также

Задачи

Практическое руководство. Добавление элементов управления XMLNodes в документы Word

Практическое руководство. Сопоставление схем и документов Word в Visual Studio

Основные понятия

Общие сведения о ведущих элементах и элементах управления ведущего приложения

Элемент управления XMLNode

Программные ограничения ведущих элементов и элементов управления ведущего приложения

Другие ресурсы

Элементы управления ведущего приложения Word

Элементы управления ведущего приложения Excel